View a markdown version of this page

O endpoint de declaração SAML do IdP - Amazon Cognito
PUBLICAR/saml2/idpresponse

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

O endpoint de declaração SAML do IdP

O /saml2/idpresponse recebe declarações de SAML. No login iniciado pelo provedor de serviços (SP-initiated), seu aplicativo não interage diretamente com esse endpoint. Seu provedor de identidade (IdP) do SAML 2.0 redireciona seu usuário aqui com a resposta do SAML. Para fazer SP-initiated login, configure seu IdP com o caminho para sua URL saml2/idpresponse como assertion consumer service (ACS). Para obter mais informações sobre o início da sessão, consulte Iniciação de sessão SAML em grupos de usuários do Amazon Cognito.

IdP-initiated No login, invoque solicitações para esse endpoint em seu aplicativo depois de fazer login como usuário com seu provedor SAML 2.0. Seus usuários fazem login com seu IdP no navegador e, em seguida, a aplicação coleta a declaração SAML e a envia para esse endpoint. Você deve enviar declarações SAML no corpo de uma solicitação HTTP POST por HTTPS. O corpo da sua solicitação POST deve ser um parâmetro SAMLResponse e um parâmetro Relaystate. Para obter mais informações, consulte Implemente o login com IdP-initiated SAML.

O endpoint saml2/idpresponse pode aceitar declarações SAML de até 100.000 caracteres.

PUBLICAR/saml2/idpresponse

Para usar o /saml2/idpresponse endpoint em um IdP-initiated login, gere uma solicitação POST com parâmetros que forneçam ao grupo de usuários informações sobre a sessão do usuário.

  • O cliente da aplicação no qual ele deseja fazer login.

  • O URL de retorno de chamada ao qual ele deseja chegar.

  • Os escopos do OAuth 2.0 que ele deseja solicitar no token de acesso do usuário.

  • O IdP que iniciou a solicitação de login.

IdP-initiated parâmetros do corpo da solicitação

SAMLResponse

Uma declaração Base64-encoded SAML de um IdP associada a um cliente de aplicativo válido e a uma configuração de IdP em seu grupo de usuários.

RelayState

Um parâmetro RelayState contém os parâmetros de solicitação que, de outra forma, você passaria para o endpoint oauth2/authorize. Para mais informações sobre esses parâmetros, consulte Autorizar endpoint.

response_type

O tipo de concessão OAuth 2.0.

client_id

O ID do cliente do aplicativo

redirect_uri

O URL para o qual o servidor de autenticação redireciona o navegador depois que o Amazon Cognito autoriza o usuário.

identity_provider

O nome do provedor de identidades para o qual você deseja redirecionar o usuário.

idp_identifier

O identificador do provedor de identidades para o qual você deseja redirecionar o usuário.

scope

Os escopos do OAuth 2.0 que você deseja que o usuário solicite do servidor de autorização.

Exemplos de solicitações com respostas positivas

Exemplo - solicitação POST

A solicitação a seguir é para uma concessão de código de autorização para um usuário do IdP MySAMLIdP no cliente de aplicação 1example23456789. O usuário redireciona para https://www.example.com com seu código de autorização, que pode ser trocado por tokens que incluem um token de acesso com os escopos do OAuth 2.0 openid, email e 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
Exemplo - resposta

Veja a seguir um exemplo de resposta para a solicitação anterior.

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]