Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Le point de terminaison d'assertion IDP SAML
<a name="saml2-idpresponse-endpoint"></a>

Il `/saml2/idpresponse` reçoit des assertions SAML. Lors de la connexion initiée par le fournisseur de services (SP-initiated), votre application n'interagit pas directement avec ce point de terminaison : votre fournisseur d'identité (IdP) SAML 2.0 redirige votre utilisateur ici avec sa réponse SAML. Pour SP-initiated vous connecter, configurez votre IdP avec le chemin d'accès à `saml2/idpresponse` votre URL en tant qu'URL du service client d'assertions (ACS). Pour plus d'informations sur le lancement de session, consultez[Lancement de séance SAML dans les groupes d'utilisateurs Amazon Cognito](cognito-user-pools-SAML-session-initiation.md).

Lors de la IdP-initiated connexion, appelez des demandes adressées à ce point de terminaison dans votre application après avoir connecté un utilisateur auprès de votre fournisseur SAML 2.0. Vos utilisateurs se connectent avec votre IdP dans leur navigateur, puis votre application collecte l'assertion SAML et la soumet à ce point de terminaison. Vous devez soumettre des assertions SAML dans le corps d'une `HTTP POST` demande via HTTPS. Le corps de votre `POST` demande doit être un `SAMLResponse` paramètre et un `Relaystate` paramètre. Pour de plus amples informations, veuillez consulter [Mettre en œuvre la connexion SAML initiée par l'IdP](cognito-user-pools-SAML-session-initiation.md#cognito-user-pools-SAML-session-initiation-idp-initiation).

Le `saml2/idpresponse` point de terminaison peut accepter des assertions SAML d'une longueur maximale de 100 000 caractères.

## POSTER`/saml2/idpresponse`
<a name="saml2-idpresponse-endpoint-post"></a>

Pour utiliser le `/saml2/idpresponse` point de terminaison IdP-initiated lors d'une connexion, générez une requête POST avec des paramètres qui fournissent à votre groupe d'utilisateurs des informations sur la session de votre utilisateur.
+ Le client d'application auquel ils souhaitent se connecter.
+ L'URL de rappel à laquelle ils veulent se retrouver.
+ Le champ d'application OAuth 2.0 qu'ils souhaitent demander dans le jeton d'accès de votre utilisateur.
+ L'IdP à l'origine de la demande de connexion.

### IdP-initiated paramètres du corps de la demande
<a name="saml2-idpresponse-endpoint-post-request"></a>

*Réponse SAML*  
Une assertion Base64-encoded SAML provenant d'un IdP associé à un client d'application valide et à une configuration IdP dans votre groupe d'utilisateurs.

*RelayState*  
Un `RelayState` paramètre contient les paramètres de demande que vous transmettriez autrement au `oauth2/authorize` point de terminaison. Pour obtenir plus d’informations sur ces paramètres, consultez [Point de terminaison d’autorisation](authorization-endpoint.md).    
*response\_type*  
Type de subvention OAuth 2.0.  
*client\_id*  
ID du client d'application.  
*redirect\_uri*  
URL vers laquelle le serveur d’authentification redirige le navigateur une fois qu’Amazon Cognito a autorisé l’utilisateur.  
*identity\_provider*  
Le nom du fournisseur d'identité vers lequel vous souhaitez rediriger votre utilisateur.  
*idp\_identifier*  
L'identifiant du fournisseur d'identité vers lequel vous souhaitez rediriger votre utilisateur.  
*scope*  
Le champ d'application OAuth 2.0 que vous souhaitez que votre utilisateur demande au serveur d'autorisation.

### Exemples de demandes avec réponses positives
<a name="saml2-idpresponse-endpoint-post-example"></a>

**Exemple — requête POST**  
La demande suivante concerne l'octroi d'un code d'autorisation à un utilisateur depuis l'IdP `MySAMLIdP` dans le client de l'application. `1example23456789` L'utilisateur redirige vers `https://www.example.com` avec son code d'autorisation, qui peut être échangé contre des jetons incluant un jeton d'accès avec les champs d'application OAuth 2.0, et. `openid` `email` `phone`

```
POST /saml2/idpresponse HTTP/1.1
User-Agent: {{USER_AGENT}}
Accept: */*
Host: {{example.auth.us-east-1.amazoncognito.com}}
Content-Type: application/x-www-form-urlencoded

SAMLResponse={{[Base64-encoded SAML assertion]}}&RelayState=identity_provider%3D{{MySAMLIdP}}%26client_id%3D{{1example23456789}}%26redirect_uri%3D{{https%3A%2F%2Fwww.example.com}}%26response_type%3D{{code}}%26scope%3D{{email%2Bopenid%2Bphone}}
```

**Exemple — réponse**  
Voici la réponse à la demande précédente.

```
HTTP/1.1 302 Found
Date: Wed, 06 Dec 2023 00:15:29 GMT
Content-Length: 0
x-amz-cognito-request-id: 8aba6eb5-fb54-4bc6-9368-c3878434f0fb
Location: {{https://www.example.com}}?code={{[Authorization code]}}
```