Établissement de la connexion

Après avoir récupéré un point de terminaison, vous utilisez l'API de WebSocket connexion pour établir une connexion au serveur principal du SDK Amazon Chime et recevoir des messages pour unAppInstanceUser. Vous devez utiliserAWS la version 4 de Signature pour signer les demandes. Pour plus d'informations sur la signature d'une demande, voir Signature de AWSdemandes avec signature, version 4.

Note

Pour récupérer le point de terminaison, vous pouvez appeler l' GetMessagingSessionEndpointAPI. Vous pouvez utiliser la bibliothèque WebSocket client de votre choix pour vous connecter au terminal.

Syntaxe de la demande

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

Paramètres de demande : Paramètres de demande

Tous les paramètres de requête d'URI doivent être codés en URL.

Algorithme X-Amz

Identifie la version deAWS Signature et l'algorithme que vous avez utilisé pour calculer la signature. Le SDK Amazon Chime prend uniquement en charge l'authentificationAWS Signature version 4, donc la valeur de cette solution est la suivanteAWS4-HMAC-SHA256.

Certificat X-Amz

Outre l'ID de votre clé d'accès, ce paramètre indique également laAWS région et le service (l'étendue) pour lesquels la signature est valide. Cette valeur doit correspondre à l'étendue de portée de demande des calculs de signature. La forme générale de cette valeur de paramètre est la suivante :

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

Par exemple :

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

X-Amz-Date

Le format de date et d'heure doit respecter la norme ISO 8601 et vous devez le formater comme suityyyyMMddTHHmmssZ. Par exemple, vous devez convertir le 08/01/2020 15:32:41 .982-700 en temps universel coordonné (UTC) et le soumettre au format20200801T083241Z.

En-têtes signés X-Amz

Répertorie les en-têtes que vous avez utilisés pour calculer la signature. Les en-têtes suivants sont requis dans les calculs de signature :

• L'en-tête de l'hôte HTTP.

• Tous les en-têtes x-amz-* que vous prévoyez d'ajouter à la demande.

Note

Pour plus de sécurité, signez tous les en-têtes de demande que vous prévoyez d'inclure dans votre demande.

Signatures X-Amz

Fournit la signature permettant d'authentifier votre demande. Cette signature doit correspondre à la signature calculée par le SDK Amazon Chime. Si ce n'est pas le cas, le SDK Amazon Chime refuse la demande. Par exemple, 733255ef022bec3f2a8701cd61d4b371f3f28c9f19EXAMPLEd48d5193d7.

Jeton de sécurité X-Amz

Paramètre d'identification facultatif si vous utilisez des informations d'identification provenant du Security Token Service. Pour de plus amples informations sur le service, consultez https://docs.aws.amazon.com/STS/latest/APIReference/.

SessionId

Indique un identifiant unique pour la WebSocket connexion en cours d'établissement.

UserArn

Indique l'identité de laAppInstanceUser personne qui essaie d'établir une connexion. La valeur doit être l'ARN duAppInstanceUser. Par exemple, arn:aws:chime:us%2Deast%2D1:123456789012:app%2Dinstance/694d2099%2Dcb1e%2D463e%2D9d64%2D697ff5b8950e/user/johndoe