Verbindung herstellen

Nachdem Sie einen Endpunkt abgerufen haben, verwenden Sie die Connect-API, um eine WebSocket Verbindung zum Amazon Chime SDK-Backend-Server herzustellen und Nachrichten für einen zu empfangenAppInstanceUser. Sie müssenAWS Signature Version 4 zum Signieren von -Anfrages verwenden. Weitere Informationen zum Signieren einer Anfrage finden Sie unter Signieren vonAWS Anfragen mit Signatur Version 4.

Anmerkung

Um den Endpunkt abzurufen, können Sie die GetMessagingSessionEndpointAPI aufrufen. Sie können die WebSocket Client-Bibliothek Ihrer Wahl verwenden, um eine Verbindung zum Endpunkt herzustellen.

Anforderungssyntax

GET /connect
?X-Amz-Algorithm=AWS4-HMAC-SHA256
&X-Amz-Credential=AKIARALLEXAMPLE%2F20201214%2Fregion%2Fchime%2Faws4_request
&X-Amz-Date=20201214T171359Z
&X-Amz-Expires=10
&X-Amz-SignedHeaders=host
&sessionId={sessionId}
&userArn={appInstanceUserArn}
&X-Amz-Signature=db75397d79583EXAMPLE

URI-Anfrageparameter

Alle URI-Anforderungsabfrageparameter müssen URL-codiert sein.

X-Amz-Algorithmus

Identifiziert die Version vonAWS Signature und den Algorithmus, den Sie zur Berechnung der Signatur verwendet haben. Das Amazon Chime SDK unterstützt nur dieAWS Signature Version 4-Authentifizierung, der Wert ist alsoAWS4-HMAC-SHA256.

X-Amz-Zertifikat

Zusätzlich zu Ihrer Zugangsschlüssel-ID stellt dieser Parameter auch dieAWS Region und den Dienst — den Geltungsbereich — bereit, für die die Signatur gültig ist. Dieser Wert muss mit dem Umfang übereinstimmen, den Sie für Signaturberechnungen verwenden. Die allgemeine Form für diesen Parameterwert lautet:

<yourAccessKeyId>/<date>/<awsRegion>/<awsService >/aws4_request

Beispiel:

AKIAIOSFODNN7EXAMPLE/20201214/us-east-1/chime/aws4_request

X-Amz-Date

Das Datums- und Uhrzeitformat muss dem ISO 8601-Standard entsprechen, und Sie müssen es als formatierenyyyyMMddTHHmmssZ. Beispielsweise müssen Sie 08/01/2020 15:32:41 .982-700 in die koordinierte Weltzeit (UTC) umrechnen und als einreichen20200801T083241Z.

Mit X-Amz signierte Kopfzeilen

Listet die Header auf, die Sie zur Berechnung der Signatur verwendet haben. Die folgenden Header sind für die Signaturberechnungen erforderlich:

• Der HTTP-Host-Header.

• Alle x-amz-*-Header, die Sie der Anfrage hinzufügen möchten.

Anmerkung

Für zusätzliche Sicherheit signieren Sie alle Anforderungsheader, die Sie in Ihre Anfrage aufnehmen möchten.

X-Amz-Signaturen

Stellt die Signatur zur Authentifizierung Ihrer Anfrage bereit. Diese Signatur muss mit der Signatur übereinstimmen, die das Amazon Chime SDK berechnet. Ist dies nicht der Fall, lehnt Amazon Chime SDK die Anfrage ab. Zum Beispiel 733255ef022bec3f2a8701cd61d4b371f3f28c9f19EXAMPLEd48d5193d7.

X-Amz-Sicherheitstoken

Optionaler Anmeldeinformationsparameter, wenn Anmeldeinformationen verwendet werden, die vom Security Token Service stammen. Weitere Informationen zu dem Dienst finden Sie unter https://docs.aws.amazon.com/STS/latest/APIReference/.

SessionId

Zeigt eine eindeutige ID für die WebSocket hergestellte Verbindung an.

UserArn

Zeigt die Identität desAppInstanceUser Versuchs an, eine Verbindung herzustellen. Der Wert sollte der ARN von seinAppInstanceUser. Beispielsweise arn:aws:chime:us%2Deast%2D1:123456789012:app%2Dinstance/694d2099%2Dcb1e%2D463e%2D9d64%2D697ff5b8950e/user/johndoe