View a markdown version of this page

Le point de terminaison d'assertion SAML de l'IdP - Amazon Cognito
POSTE/saml2/idpresponse

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 SAML de l'IdP

Il /saml2/idpresponse reçoit des assertions SAML. Lors de la connexion initiée par un 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 à votre URL en saml2/idpresponse tant qu'URL ACS (Assertion Consumer Service). Pour plus d'informations sur le lancement de session, consultezLancement de séance SAML dans les groupes d'utilisateurs Amazon Cognito.

Lors de la IdP-initiated connexion, appelez des requêtes vers ce point de terminaison dans votre application après vous être connecté à l'aide de votre fournisseur SAML 2.0. Vos utilisateurs se connectent à l'aide de 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 composé d'un SAMLResponse paramètre et d'un Relaystate paramètre. Pour de plus amples informations, veuillez consulter Implémenter la IdP-initiated connexion SAML.

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

POSTE/saml2/idpresponse

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 de l'application auquel ils souhaitent se connecter.

  • L'URL de rappel à laquelle ils souhaitent se retrouver.

  • Les étendues OAuth 2.0 qu'ils souhaitent demander dans le jeton d'accès de votre utilisateur.

  • L'IdP qui a lancé la demande de connexion.

IdP-initiated paramètres du corps de la demande

Réponse SAML

Une assertion Base64-encoded SAML provenant d'un IdP associé à un client d'application et à une configuration IdP valides 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.

response_type

Type d'autorisation 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

Les étendues OAuth 2.0 que vous souhaitez que votre utilisateur demande au serveur d'autorisation.

Exemples de demandes avec réponses positives

Exemple : requête POST

La demande suivante concerne l'octroi d'un code d'autorisation à un utilisateur depuis le client 1example23456789 IdP MySAMLIdP in app. L'utilisateur est redirigé vers https://www.example.com avec son code d'autorisation, qui peut être échangé contre des jetons qui incluent 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%3DMySAMLIdP%26client_id%3D1example23456789%26redirect_uri%3Dhttps%3A%2F%2Fwww.example.com%26response_type%3Dcode%26scope%3Demail%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]