Richten Sie eine Eventbenachrichtigung für die Platzierung von Spielsitzungen ein

Mithilfe von Veranstaltungsbenachrichtigungen können Sie den Status einzelner Platzierungsanfragen überwachen. Wir empfehlen, für alle Spiele mit hoher Platzierungsaktivität Event-Benachrichtigungen einzurichten.

Es gibt zwei Möglichkeiten, Ereignisbenachrichtigungen einzurichten.

• Lassen Sie Amazon mithilfe einer Warteschlange Eventbenachrichtigungen zu einem Amazon Simple Notification Service (Amazon SNS) -Thema GameLift veröffentlichen.

• Verwenden Sie automatisch veröffentlichte EventBridge Amazon-Events und die zugehörigen Tools zur Verwaltung von Veranstaltungen.

Eine Liste der von Amazon GameLift ausgestrahlten Platzierungsereignisse für Spielsitzungen finden Sie unterPlatzierungsveranstaltungen für Spielsitzungen.

Ein SNS-Thema einrichten

Damit Amazon GameLift alle von einer Spielesitzungswarteschlange generierten Ereignisse zu einem Thema veröffentlichen kann, legen Sie das Benachrichtigungszielfeld auf ein Thema fest.

So richten Sie ein SNS-Thema für die GameLift Amazon-Eventbenachrichtigung ein

1. Melden Sie sich bei der AWS Management Console an und öffnen Sie die Amazon-SNS-Konsole unter https://console.aws.amazon.com/sns/v3/home.

2. Wählen Sie auf der Seite mit den SNS-Themen die Option Thema erstellen aus und folgen Sie den Anweisungen, um Ihr Thema zu erstellen.

3. Gehen Sie unter Zugriffsrichtlinie wie folgt vor:

   1. Wählen Sie die Methode „Erweitert“.

   2. Fügen Sie der vorhandenen Richtlinie den folgenden fett gedruckten Abschnitt des JSON-Objekts hinzu.

      {
        "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:your_region:your_account: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:your_region:your_account:your_topic_name",
            "Condition": {
              "ArnLike": {
                "aws:SourceArn": "arn:aws:gamelift:your_region:your_account:gamesessionqueue/your_queue_name"
              }
            }
          }
        ]
      }

   3. (Optional) Fügen Sie dem Thema zusätzliche Zugriffskontrolle hinzu, indem Sie der Ressourcenrichtlinie Bedingungen hinzufügen.

4. Wählen Sie Create topic (Thema erstellen) aus.

5. Nachdem Sie Ihr SNS-Thema erstellt haben, fügen Sie es bei der Erstellung der Warteschlange zu Warteschlangen hinzu oder bearbeiten Sie eine bestehende Warteschlange, um es hinzuzufügen.

Richten Sie ein SNS-Thema mit serverseitiger Verschlüsselung ein

Mit serverseitiger Verschlüsselung (SSE) können Sie vertrauliche Daten in verschlüsselten Themen speichern. SSE schützt den Inhalt von Nachrichten in Amazon SNS-Themen mithilfe von Schlüsseln, die in AWS Key Management Service (AWS KMS) verwaltet werden. Weitere Informationen zur serverseitigen Verschlüsselung mit Amazon SNS finden Sie unter Encryption at Rest im Amazon Simple Notification Service Developer Guide.

Lesen Sie die folgenden Themen, um ein SNS-Thema mit serverseitiger Verschlüsselung einzurichten:

• Schlüssel im AWS Key Management ServiceEntwicklerhandbuch erstellen

• SSE für ein Thema im Amazon Simple Notification Service Developer Guide aktivieren

Verwenden Sie beim Erstellen Ihres KMS-Schlüssels die folgende KMS-Schlüsselrichtlinie:

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

Einrichten von EventBridge

Amazon veröffentlicht GameLift automatisch alle Platzierungsereignisse für SpielsitzungenEventBridge. Mit können EventBridge Sie Regeln einrichten, damit Ereignisse zur Verarbeitung an Ziele weitergeleitet werden. Sie können beispielsweise eine Regel festlegen, um das Ereignis PlacementFulfilled an eine AWS Lambda Funktion weiterzuleiten, die Aufgaben bearbeitet, die vor dem Herstellen einer Verbindung zu einer Spielsitzung anfallen. Weitere Informationen zu EventBridge finden Sie unter Was ist AmazonEventBridge? im EventBridgeAmazon-Benutzerhandbuch.

Im Folgenden finden Sie einige Beispiele für EventBridge Regeln zur Verwendung mit GameLift Amazon-Warteschlangen:

Stimmt mit Ereignissen aus allen GameLift Amazon-Warteschlangen überein

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

Entspricht Ereignissen aus einer bestimmten Warteschlange

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