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.

• Haz que Amazon GameLift Servers publiques las notificaciones de eventos en un tema del Amazon Simple Notification Service (Amazon SNS) mediante una cola.

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

Para ver una lista de los eventos de ubicación de las sesiones de juego emitidos porAmazon GameLift Servers, consultaEventos 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 de FIFO tienen límites de publicación más bajos que los temas estándar, lo que puede provocar que se limiten las excepciones cuando hay mucha carga. Si tienes problemas con los temas de FIFO, es posible que pierdas las notificaciones de ubicación de las colas.

Configuración de un tema de SNS

Amazon GameLift ServersPara publicar todos los eventos generados por la cola de una sesión de juego en un tema, establece el campo de destino de las notificaciones en un tema.

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

1. Inicie sesión en la consola Amazon SNS en la v3/home AWS Management Console y ábrala. https://console.aws.amazon.com/sns/

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": "2008-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. Seleccione Crear 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:

• Creación de claves en la Guía para desarrolladores de AWS Key Management Service .

• Habilitación de SSE para un tema en la Guía para desarrolladores de Amazon Simple Notification Service

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" 
        }
    }
}

Configure EventBridge

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

Los siguientes son algunos ejemplos de EventBridge reglas que se pueden usar con las Amazon GameLift Servers colas:

Coincide con los eventos de todas las colas Amazon GameLift Servers

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

Coincidencia de 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"
    ]
}