Configuración de la notificación de eventos para la ubicación de sesiones de juego. - Amazon GameLift Servers
Configuración de un tema de SNSConfiguración de un tema de SNS con cifrado del servidorConfiguración de EventBridge

Configuración de la notificación de eventos para la ubicación de sesiones de juego.

Puede utilizar notificaciones de eventos para supervisar el estado de las solicitudes de ubicación individuales. Le recomendamos configurar las notificaciones de eventos para todos los juegos con un gran volumen de actividad de ubicación.

Existen dos opciones para configurar las notificaciones de eventos.

  • Haga que Amazon GameLift Servers publique notificaciones de eventos en un tema de Amazon Simple Notification Service (Amazon SNS) mediante una cola.

  • Utilice los eventos de Amazon EventBridge publicados automáticamente y su conjunto de herramientas para administrar los eventos.

Para obtener una lista de los eventos de ubicación de sesiones de juego emitidos por Amazon GameLift Servers, consulte Eventos de ubicación de sesión de juego.

importante

Para los sistemas de ubicación de gran volumen, recomendamos utilizar temas estándar (no FIFO) de Amazon SNS en lugar de temas FIFO. Los temas FIFO tienen límites de publicación más bajos que los temas estándar, lo que puede provocar excepciones de limitación en periodos de mucha carga. Si experimenta limitación con los temas FIFO, es posible que pierdas las notificaciones de ubicación en colas.

Configuración de un tema de SNS

Para que Amazon GameLift Servers publique todos los eventos generados por una cola de sesiones de juego en un tema, defina el campo de destino de notificaciones en él.

Para configurar un tema de SNS para la notificación de eventos de Amazon GameLift Servers

  1. Inicie sesión en la Consola de administración de AWS y abra la consola de Amazon SNS en https://console.aws.amazon.com/sns/v3/home.

  2. En la página Temas de SNS, elija Crear tema y siga las instrucciones para crear el tema.

  3. En Política de acceso, haga lo siguiente:

    1. Elija el método Avanzado.

    2. Añada la siguiente sección en negrita del objeto JSON a la política existente.

      JSON
      {
  "Version":"2012-10-17",		 	 	 
  "Id": "__default_policy_ID",
  "Statement": [
    {
      "Sid": "__default_statement_ID",
      "Effect": "Allow",
      "Principal": {
        "AWS": "*"
      },
      "Action": [
        "SNS:GetTopicAttributes",
        "SNS:SetTopicAttributes",
        "SNS:AddPermission",
        "SNS:RemovePermission",
        "SNS:DeleteTopic",
        "SNS:Subscribe",
        "SNS:ListSubscriptionsByTopic",
        "SNS:Publish"
      ],
      "Resource": "arn:aws:sns:us-east-1:111122223333:your_topic_name",
      "Condition": {
        "StringEquals": {
          "AWS:SourceAccount": "your_account"
        }
      }
    },
    {
      "Sid": "__console_pub_0",
      "Effect": "Allow",
      "Principal": { 
        "Service": "gamelift.amazonaws.com" 
      },
      "Action": "sns:Publish",
      "Resource": "arn:aws:sns:us-east-1:111122223333:your_topic_name",
      "Condition": {
        "ArnLike": {
        "aws:SourceArn": "arn:aws:gamelift:us-east-1:111122223333:gamesessionqueue/your_queue_name"
        }
      }
    }
  ]
}

    3. Añada un control de acceso adicional al tema agregando condiciones a la política de recursos (opcional).

  4. Elija Crear nuevo tema.

  5. Una vez que haya creado su tema de SNS, añádalo a las colas durante la creación de las colas o edite una cola existente para agregarlo.

Configuración de un tema de SNS con cifrado del servidor

Con el cifrado del servidor (SSE), puede almacenar información confidencial en temas cifrados. SSE protege el contenido de los mensajes en temas de Amazon SNS mediante claves que se administran en AWS Key Management Service (AWS KMS). Para obtener más información sobre el cifrado del servidor con Amazon SNS, consulte Cifrado en reposo en la Guía para desarrolladores de Amazon Simple Notification Service.

Para configurar un tema de SNS con cifrado del servidor, revise los temas siguientes:

Al crear la clave de KMS, utilice la siguiente política de claves de KMS:

{ 
    "Effect": "Allow", 
    "Principal": { 
        "Service": "gamelift.amazonaws.com" 
     },
    "Action": [
        "kms:Decrypt",
        "kms:GenerateDataKey"
    ],
    "Resource": "*",
    "Condition": {
        "ArnLike": { 
            "aws:SourceArn": "arn:aws:gamelift:your_region:your_account:gamesessionqueue/your_queue_name" 
        },
        "StringEquals": { 
            "kms:EncryptionContext:aws:sns:topicArn": "arn:aws:sns:your_region:your_account:your_sns_topic_name" 
        }
    }
}

Configuración de EventBridge

Amazon GameLift Servers publica automáticamente todos los eventos de ubicación de las sesiones de juego en EventBridge. Con EventBridge, puede configurar reglas para que los eventos se envíen a los destinos para su procesamiento. Por ejemplo, puede establecer una regla para dirigir el evento PlacementFulfilled a una función AWS Lambda que se encargue de las tareas previas a la conexión a una sesión de juego. Para obtener más información acerca de EventBridge, consulte ¿Qué es Amazon EventBridge? en la Guía del usuario de Amazon EventBridge.

A continuación se muestran algunos ejemplos de reglas de EventBridge que se pueden utilizar con las colas de Amazon GameLift Servers:

Empareja eventos de todas las colas de Amazon GameLift Servers

{
    "source": [
        "aws.gamelift"
    ],
    "detail-type": [
        "GameLift Queue Placement Event"
    ]
}

Empareja eventos de una cola específica

{
    "source": [
        "aws.gamelift"
    ],
    "detail-type": [
        "GameLift Queue Placement Event"
    ],
    "resources": [
        "arn:aws:gamelift:your_region:your_account:gamesessionqueue/your_queue_name"
    ]
}