This is an auto-generated translation

Visão geral de SSO do OpenID Connect

O OpenID Connect (OIDC) é um protocolo de autenticação com base no OAuth 2.0 que foi adotado por grandes empresas de tecnologia.

Saiba mais sobre o OIDC

SSO básico

Sejam quais forem as opções de recursos selecionadas, os requisitos de configuração do SSO básico são os mesmos. Adicionar implementações de cartão de crédito ou programa de fidelidade exige mais informações.

Requisitos de configuração

Para configurar o acesso de SSO do OIDC ao seu modelo de site, alguns elementos são necessários, incluindo:

  • APIs (autorizar, token, userProfile, JWKS)
  • ClientId
  • Segredo do cliente
  • ResponseMode
  • isNonceEnabled
  • customerDetailsAPIKey (se disponível)

Fluxos de Autorização

OIDC Authorization flows

Autorizar ponto final

O ponto de extremidade GET /authorize é usado para autenticação e autorização. Ele retorna uma concessão de autorização ou código para o cliente, caso o usuário seja logged-in. É um redirecionamento do navegador.

Parâmetros de solicitação

ParâmetroDescriçãoTipo de dadosExemplo do valorObrigatório?
client_idIdentifica o cliente. Deve corresponder ao valor pré-registrado no seu provedor de identidade (IDP). Obtido durante o registro manual do cliente ou por meio da API de registro dinâmico do cliente.Sequência Sim
nonceUsado para mitigar ataques de repetição. Esse valor é retornado no token de ID.Sequência Sim
promptO tipo de interação necessário para validação. Se "vazio", o usuário deverá efetuar login, caso ainda não esteja autenticado. Se "nenhum", o IDP não solicitará login, mas retornará um código de autorização se estiver conectado ou um erro caso contrário.SequênciaValores válidos:
Nenhum OU vazio
Não
redirect_uriLocal de callback para onde o código de autorização ou tokens devem ser enviados. Deve corresponder ao valor pré-registrado no seu IDP durante o registro do cliente.Sequência Sim
response_typeValor do code (IDP).Sequência Sim
response_modeComo a resposta de autorização deve ser retornada.SequênciaValor válido:
query
Não
scopeToken de acesso, usado para buscar detalhes de perfil. Obrigatório para solicitações de autenticação.SequênciaOpenID, profile e emailSim
stateO estado da interação. Esse valor é retornado no token e permite que o usuário clique, faça a autenticação e retorne à página em que estava interessado. O valor pode conter caracteres alfanuméricos, vírgula, ponto, sublinhado e hífen.Sequência Sim
ui_localesIdiomas e scripts preferidos do usuário para a interface do usuário.Sequênciaen_CA, fr_CANão
audienceO destinatário pretendido.SequênciaDefinido por ParceirosNão

Parâmetros de resposta

ParâmetroDescriçãoTipo de dadosObrigatório?
codeCódigo de autorização que identifica o cliente. Deve corresponder ao valor pré-registrado no seu IDP. Obtido durante o registro manual do cliente ou por meio da API de registro dinâmico do cliente.SequênciaSim
stateO estado da interação. Esse valor é retornado no token e permite que o usuário clique, faça a autenticação e retorne à página em que estava interessado. O valor pode conter caracteres alfanuméricos, vírgula, ponto, sublinhado e hífen.SequênciaSim

URL de autorização de amostra

https://example.com/authorize?client_id={clientID}&response_type=code&state=d6b93799-404b-4205-9bb3-c579b1180428&scope=openid email profile&nounce=234567687867&redirect_uri=https://{ExpediaDomain}/sso/auth

URL de retorno de chamada de exemplo

https://{ExpediaDomain}/sso/auth?code=12345678&state=d6b93799-404b-4205-9bb3-c579b1180428

Ponto final do token

O ponto de extremidade POST /token é uma chamada de API de backend que é usada para obter um token de acesso e um token de ID apresentando uma concessão de autorização ou código.

Parâmetros de solicitação

ParâmetroDescriçãoTipo de dadosObrigatório?
grant_typeO mecanismo que um IDP usa para autorizar a criação dos tokens. Valor: authorization_code.SequênciaSim
redirect_uriEspecifica o local de callback para onde a autorização foi enviada. Esse valor deve corresponder ao redirect_uri usado para gerar o authorization_code original, senão o ponto de extremidade do token falha.SequênciaSim
codeCódigo de identificação do cliente recebido na resposta da chamada de /authorize.SequênciaSim

Cabeçalhos de solicitação

CampoDescriçãoTipo de dadosExemplo do valorObrigatório?
acceptDeve ser "application/json".Sequênciaapplication/jsonSim
authorizationCodifica o ID e o segredo do cliente com Base64. Use as informações codificadas no cabeçalho de autorização HTTP.SequênciaBasic<Base64 encoded client ID and secret>Sim
Content-TypeDeve ser "application/x-www-form-urlencoded".Sequênciaapplication/x-www-form-urlencodedSim

Parâmetros de resposta

CampoDescriçãoTipo de dados
access_tokenUm token de acesso.Sequência
token_typeO público do token.Sequência
expires_inO tempo de expiração do token de acesso em segundos.Inteiro
scopeOs escopos contidos no token de acesso.Sequência
id_tokenUm identificador que é retornado se o escopo de OpenID for concedido.Sequência

ID_token

O ID_token é um JSON Web Token (JWT) que inclui partes de informações de autenticação chamadas de declarações. As soluções de modelo da Expedia usam as declarações header, payload e signature, conforme a tabela a seguir.

Declarações de cabeçalho

CampoDescriçãoTipo de dadosObrigatório?
algIdentifica o algoritmo de assinatura digital utilizado, que é sempre RS256.SequênciaNão
kidID da chave: identifica a chave pública usada para verificar o token de ID. A chave pública correspondente pode ser encontrada por meio do JSON Web Key Set (JWKS).SequênciaSim

Declarações de conteúdo

CampoDescriçãoTipo de dadosObrigatório?
amrMatriz JSON de sequências que são identificadores para métodos de autenticação.MatrizNão
audIdentifica o público ao qual o token de ID se destina, ou seja, um dos IDs de cliente do OAuth 2.0 do seu aplicativo.SequênciaSim
auth_timeO tempo em que o usuário final foi autenticado, representado em hora Unix (segundos).InteiroNão
expO tempo em que o token de ID expira, representado em hora Unix (segundos).InteiroSim
iatO tempo em que o token de ID foi emitido, representado em hora Unix (segundos).InteiroNão
idpUm indicador do provedor de identidade.SequênciaSim
issA URL do servidor de autorização que emitiu o token de ID.SequênciaNão
jtiUm identificador exclusivo do token de ID para fins de depuração e revogação.SequênciaSim
subUm identificador exclusivo do sujeito da chamada de autorização, ou seja, o usuário.SequênciaNão
verA versão semântica do token de ID.InteiroSim

Declarações de assinatura

Validação da assinatura: A assinatura será validada em relação à chave apropriada (recuperada usando JWKS endpoint) para aquele client_id e algoritmo.

Token de amostra CURL

curl --location 'https://example.com/token’ \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'Authorization: Basic {encoded ClientID:clientSecret}' \
--data-urlencode 'grant_type=authorization_code' \
--data-urlencode 'redirect_uri=https://{ExpediaDomain}/sso/auth’ \
--data-urlencode 'code={Authorization code after login as part of callback to Expedia /sso/auth endpoint}'

Resposta de token de amostra

{
    "access_token": "eyJhbGciOi.JSUzI1NiIsImtpZCI6Ilk1MkFDVXd3QV9SUzI1NiIsInBp.LmF0bSI6ImlrY20ifQ",
    "id_token": "eyJhbGciOiJSUzI1NiIsImtpZCI6.IllEQnJQdlllYlRwa1laODZoaGk1MkFDVX.d3QV9SUzI1NiJ9",
    "token_type": "Bearer",
    "expires_in": 1799
}

Ponto final do Userinfo

O ponto de extremidade GET /userinfo é uma chamada de API de backend que retorna declarações sobre o usuário autenticado com base no token de acesso fornecido.

Cabeçalhos de solicitação

CampoDescriçãoTipo de dadosExemplo do valorObrigatório?
ClientIdIdentifica o cliente. Deve corresponder ao valor pré-registrado no seu provedor de identidade (IDP). Obtido durante o registro manual do cliente ou por meio da API de registro dinâmico do cliente.Sequência Sim
AuthorizationCabeçalho HTTP usado para enviar credenciais ou tokens para autenticar um usuárioSequênciaPortador [access_token]Sim

Resposta

CampoDescriçãoTipo de dadosExemplo do valorObrigatório?
membershipIdIdentificador que identifica exclusivamente a conta do ClienteSequência Sim
optInSinalizador booleano se o cliente optar por receber e-mail de marketingBooleanoverdadeiro/falsoNão
languageIdIdioma preferido do usuárioSequênciaEn, frNão
channelTypeDiferentes plataformas através das quais um usuário interage com um aplicativoSequênciaWEB, CELULAR, TABLETNão
firstNameNome do ClienteSequência Sim
middleNameNome do meio do clienteSequência Não
lastNameSobrenome do ClienteSequência Não
emailEndereço de e-mail do clienteSequência Não
programAccountInformações sobre Loyalty-relatedprogramAccountConsulte a seção Add loyalty -> programAccount abaixo para obter detalhes do objetoNão
CardDetailsDetalhes do cartão de crédito do clienteCardDetailsConsulte a seção Restrict payment card -> Payload details abaixo para obter detalhes do objetoNão

Exemplo de informações do usuário CURL

curl --location 'https://example.com/userinfo' \
--header 'client_id: {clientId}' \
--header 'Authorization: Bearer {acess_token from token endpoint}'

Exemplo de resposta do Userinfo

{
  "membershipId": "12345678",
  "languageID": "en",
  "middleName": "MiddleName",
  "lastName": "LastName",
  "firstName": "FirstName",
  "email": "test@expediagroup.com",
  "programAccount": {
    "programId": "Gold",
    "loyaltyAccountBalance": {
      "value": "10000",
      "currency": "Points"
    }
  }
}

Inclusão de programas de fidelidade

Como parte do seu modelo de site, você pode oferecer aos seus clientes a capacidade de juntar pontos de fidelidade nas compras de viagens. Se você quiser, o seu modelo também pode permitir que clientes usem pontos de fidelidade acumulados para comprar viagens.

Os mesmos requisitos de configuração da implementação padrão se aplicam, assim como muitos dos valores. Somente os que são diferentes estão incluídos aqui.

Além do padrão user information, a configuração do programa de fidelidade incluirá os seguintes valores.

programAccount

CampoDescriçãoTipo de dadosObrigatório?
programIdIdentificador do programa de fidelidade ao qual o cliente é afiliado ou o nome do nível associado ao programa de fidelidade.SequênciaSim
loyaltyAccountNumberNúmero da conta do programa de fidelidade do cliente. Deve ser preenchido somente se um identificador secundário, diferente do membershipId exclusivo, for necessário para operações do programa de fidelidade.SequênciaNão
lastFourDigitsOfCreditCardÚltimos quatro dígitos do cartão de crédito que o cliente usou na reserva.InteiroNão
accountNameNome do programa (se diferente do nome do nível).SequênciaNão
loyaltyConversionRatioProporção usada para converter o pagamento em pontos ganhos, por exemplo, R$ 1 = 1 ponto.DuploNão
loyaltyAccountBalanceSaldo atual dos pontos de fidelidade ganhos pelo cliente.Valor
(consulte a seção Valor abaixo para obter detalhes do objeto)
Não

Valor

CampoDescriçãoTipo de dadosObrigatório?
valueSaldo do programa de fidelidade, aninhado em loyaltyAccountBalance.LongSim
currencyA moeda usada pelo programa de fidelidade, por exemplo, reais, dólares americanos, pontos ou milhas, aninhada em loyaltyAccountBalance.SequênciaSim

Restrição do cartão de pagamento

Podemos configurar o seu site para que clientes usem o cartão de crédito da sua organização para fazer reservas. Isso é opcional, pois todas as soluções de modelo podem aceitar todos os principais cartões de crédito ou débito (e, nos EUA, PayPal).

Segurança e armazenamento do cartão de crédito

Se você optar por exigir a compra usando o cartão de crédito personalizado da sua organização, queremos que sinta segurança. Lidamos com isso das seguintes maneiras:

  • As informações do cartão são armazenadas em um formato tokenizado que é vinculado ao perfil do cliente na Expedia. O armazenamento nunca é feito sem criptografia.
  • Nenhum ser humano tem acesso aos dados não criptografados do cartão, e a descriptografia só acontece com credenciais seguras do IAM.
  • Quando um cartão é pré-carregado na página de pagamento, somente a descrição do cartão fica visível, não o número.
  • O cliente deve inserir o código de segurança do cartão para concluir a reserva com o cartão armazenado.

Requisitos de configuração

Além dos requisitos de configuração da implementação padrão, adicionar o cartão de crédito significa que vamos precisar de:

  • Um ponto de extremidade a ser usado para o parâmetro AuthnRequest.
  • A sua chave pública para verificação de assinatura.

Vamos usar a chave privada da Expedia para assinar o conteúdo do AuthnRequest e a nossa chave pública para fornecer validação de assinatura para você.

Detalhes de conteúdo

Junto com os atributos descritos na implementação padrão, quando um cliente faz login no seu site, o SSO do cartão de crédito inicia o envio de dois parâmetros de transação para o ponto de extremidade seguro de SSO da Expedia:

  • API de informações do usuário: conteúdo de resposta codificado e assinado com asserções assinadas e criptografadas.
  • RelayState: um deep link para o URL da página de chegada.
Information

Observação

Se o seu modelo de site também está configurado para juntar pontos de fidelidade, você também precisa das informações de programAccount.

O conteúdo também vai conter os seguintes dados do cartão de crédito:

CampoDescriçãoObrigatório?
cardNumberO número do cartão a ser cobrado.Sim
cardTypeTipo de cartão usado (por exemplo, Visa, MasterCard, American Express).Sim
expirationDateData de validade do cartão usado.Sim
BillingAddressEndereço de cobrança associado ao cartão usado.Sim
addressCategoryCodeO tipo de endereço a ser cobrado (por exemplo, residencial ou comercial), aninhado em BillingAddress.Sim
firstAddressLinePrimeira linha do endereço de cobrança, aninhada em BillingAddress.Sim
secondAddressLineSegunda linha do endereço de cobrança, aninhada em BillingAddress.Não
thirdAddressLineTerceira linha do endereço de cobrança, aninhada em BillingAddress.Não
cityNameCidade do endereço de cobrança, aninhada em BillingAddress.Sim
provinceNameProvíncia do endereço de cobrança, aninhada em BillingAddress.Sim
postalCodeCódigo postal do endereço de cobrança, aninhado em BillingAddress.Sim
countryCodeCódigo do país do endereço de cobrança, aninhado em BillingAddress.Sim
Esta página foi útil?
Como podemos melhorar esse conteúdo?
Agradecemos por nos ajudar a melhorar.