This is an auto-generated translation

Información general sobre el SSO de OpenID Connect

OpenID Connect (OIDC) es un protocolo de autenticación basado en OAuth 2.0 que han adoptado las principales empresas tecnológicas.

Más información sobre OIDC

SSO básico

Independientemente de las funciones que hayas seleccionado, los requisitos de configuración del SSO básico son los mismos. Para añadir implementaciones de fidelidad o tarjetas de crédito, se pedirá más información.

Requisitos de configuración

Para configurar correctamente el acceso SSO de OIDC a tu sitio web creado a partir de una plantilla, necesitaremos varios datos, como los siguientes:

  • APIs (autorizar, token, userProfile, JWKS)
  • ID de cliente
  • Secreto de cliente
  • ResponseMode
  • isNounceEnabled
  • customerDetailsAPIKey (si está disponible)

Flujos de autorización

OIDC Authorization flows

Autorizar punto final

El punto de conexión GET /authorize se utiliza para la autenticación y la autorización. Devuelve una concesión o código de autorización al cliente post usuario es logged-in. Es una redirección del navegador.

Parámetros de solicitud

ParámetroDescripciónTipo de datosEjemplo de valor¿Obligatorio?
client_idIdentifica al cliente. Debe coincidir con el valor prerregistrado en tu proveedor de identidad (IDP). Se obtiene durante el registro manual del cliente o a través de la API de registro dinámico de clientes.Cadena 
nonceSe utiliza para mitigar los ataques de repetición. Este valor se devuelve en el ID de token.Cadena 
promptEl tipo de interacción necesaria para validar. Si está "vacío", el usuario debe identificarse si aún no se ha autentificado. Si es "ninguno", el IDP no solicitará el inicio de sesión, pero devolverá un código de autorización si se ha iniciado sesión, o un error en caso contrario.CadenaValores válidos:
Ninguno O vacío
No
redirect_uriLugar de devolución de llamada donde se debe enviar el código de autorización o los tokens. Debe coincidir con el valor prerregistrado en tu IDP durante el registro del cliente.Cadena 
response_typeValor code (IDP).Cadena 
response_modeCómo debe devolverse la respuesta de autorización.CadenaValor válido:
consulta
No
scopeIdentificador de acceso, utilizado para obtener los detalles del perfil. Necesario para las solicitudes de autenticación.CadenaOpenID, perfil y correo electrónico
stateEl estado de la interacción. Este valor se devuelve en el token y permite al usuario hacer clic, autenticarse y volver a la página que le interesaba originalmente. El valor puede contener caracteres alfanuméricos, comas, puntos, guiones bajos y guiones.Cadena 
ui_localesLenguas y scripts preferidos por el usuario para la interfaz de usuario.Cadenaen_CA, fr_CANo
audienceEl destinatario previsto.CadenaDefinido por los sociosNo

Parámetros de respuesta

ParámetroDescripciónTipo de datos¿Obligatorio?
codeCódigo de autorización que identifica al cliente. Debe coincidir con el valor prerregistrado en tu IDP. Se obtiene durante el registro manual del cliente o a través de la API de registro dinámico de clientes.Cadena
stateEl estado de la interacción. Este valor se devuelve en el token y permite al usuario hacer clic, autenticarse y volver a la página que le interesaba originalmente. El valor puede contener caracteres alfanuméricos, comas, puntos, guiones bajos y guiones.Cadena

Ejemplo de URL de autorización

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

Ejemplo de URL de devolución de llamada

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

Punto final del token

El punto final POST /token es una llamada a la API backend que se utiliza para obtener un token de acceso y un token de identificación presentando una concesión o código de autorización.

Parámetros de solicitud

ParámetroDescripciónTipo de datos¿Obligatorio?
grant_typeEl mecanismo que utiliza IDP para autorizar la creación de tokens. Valor: authorization_codeCadena
redirect_uriEspecifica la ubicación de la llamada de retorno donde se ha enviado la autorización. Este valor debe coincidir con el redirect_uri utilizado para generar el authorization_code original o el punto de conexión del token fallará.Cadena
codeCódigo de identificación del cliente recibido en la respuesta a la llamada /authorize.Cadena

Encabezados de solicitud

CampoDescripciónTipo de datosEjemplo de valor¿Obligatorio?
acceptDebe ser "application/json"Cadenaapplication/json
authorizationCodifica el ID y el secreto del cliente con Base64. Utiliza la información codificada en el encabezado de autorización HTTP.CadenaBasic<ID y secreto del cliente cifrados con Base64>
Content-TypeDebe ser "application/x-www-form-urlencoded"Cadenaapplication/x-www-form-urlencoded

Parámetros de respuesta

CampoDescripciónTipo de datos
access_tokenUn token de accesoCadena
token_typeEl público del tokenCadena
expires_inEl tiempo de expiración del token de acceso en segundosEntero
scopeLos ámbitos contenidos en el token de accesoCadena
id_tokenUn identificador que se devuelve si se concede el ámbito OpenIDCadena

ID_token

ID_token es un token web JSON (JWT) que incluye fragmentos de información de autenticación llamados reclamaciones. Las soluciones de plantilla de Expedia utilizan las reclamaciones header, payload y signature com en la tabla siguiente.

Reclamaciones de encabezado

CampoDescripciónTipo de datos¿Obligatorio?
algIdentifica el algoritmo utilizado de firma digital (siempre RS256)CadenaNo
kidID de la clave: identifica la clave pública utilizada para verificar el token de identificación; la clave pública correspondiente se puede encontrar a través del conjunto de claves web JSON (JWKS)Cadena

Reclamaciones de carga

CampoDescripciónTipo de datos¿Obligatorio?
amrMatriz JSON de cadenas que son identificadores para los métodos de autenticaciónMatrizNo
audIdentifica el público al que va dirigido este token de identificación (uno de los ID de cliente OAuth 2.0 de tu aplicación)Cadena
auth_timeLa hora a la que se ha verificado el usuario final, representada en tiempo Unix (segundos)EnteroNo
expLa hora a la que caduca el ID de token, representada en tiempo Unix (segundos)Entero
iatLa hora a la que se ha emitido el ID de token, representada en tiempo Unix (segundos)EnteroNo
idpUn indicador del proveedor de identidadCadena
issLa URL del servidor de autorización que ha emitido este token de identificaciónCadenaNo
jtiUn identificador único para este ID de token con fines de depuración y revocaciónCadena
subUn identificador único para el sujeto de la llamada de autorización (el usuario)CadenaNo
verLa versión semántica del ID de tokenEntero

Reclamaciones de firma

Validación de la firma: La firma se validará con la clave apropiada (obtenida mediante JWKS endpoint) para ese client_id y algoritmo.

Muestra de token 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}'

Ejemplo de respuesta de token

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

Punto final Userinfo

El punto final GET /userinfo es una llamada a la API backend que devuelve afirmaciones sobre el usuario autenticado basadas en el token de acceso proporcionado.

Encabezados de solicitud

CampoDescripciónTipo de datosEjemplo de valor¿Obligatorio?
ClientIdIdentifica al cliente. Debe coincidir con el valor prerregistrado en tu proveedor de identidad (IDP). Se obtiene durante el registro manual del cliente o a través de la API de registro dinámico de clientes.Cadena 
AuthorizationCabecera HTTP utilizada para enviar credenciales o tokens para autenticar a un usuarioCadenaPortador [access_token]

Respuesta

CampoDescripciónTipo de datosEjemplo de valor¿Obligatorio?
membershipIdIdentificador que identifica de forma única la cuenta del ClienteCadena 
optInIndicador booleano si el cliente opta por recibir correos electrónicos de marketingBooleanoverdadero/falsoNo
languageIdLengua preferida por el usuarioCadenaEn, frNo
channelTypeDiferentes plataformas a través de las cuales un usuario interactúa con una aplicaciónCadenaWEB, MÓVIL, TABLETNo
firstNameNombre del ClienteCadena 
middleNameSegundo nombre del ClienteCadena No
lastNameApellidos del ClienteCadena No
emailDirección de correo electrónico del ClienteCadena No
programAccountLoyalty-related informaciónprogramAccountConsulta la sección Add loyalty -> programAccount para más detalles sobre los Objetos.No
CardDetailsDatos de la tarjeta de crédito del clienteCardDetailsConsulta la sección Restrict payment card -> Payload details para más detalles sobre los Objetos.No

Ejemplo de Userinfo CURL

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

Ejemplo de respuesta de Userinfo

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

Añadir programa de fidelidad

Como parte de tu sitio web creado a partir de una plantilla, puedes incluir la posibilidad de que tus clientes ganen puntos de fidelidad en sus compras de viajes. Si quieres, la plantilla también puede permitir a tus clientes utilizar sus puntos de fidelidad acumulados para comprar viajes.

Se aplican los mismos requisitos de configuración que en la implementación estándar, así como muchos de los valores. Aquí solo se incluyen los que son diferentes.

Además del estándar user information, la configuración del programa de fidelización incluirá los siguientes valores.

programAccount

CampoDescripciónTipo de datos¿Obligatorio?
programIdIdentificador del programa de fidelidad al que está afiliado el cliente o el nombre del nivel asociado al programa de fidelidadCadena
loyaltyAccountNumberEl número de la cuenta de fidelidad del cliente; solo debería rellenarse si se requiere un identificador secundario (que no sea el membershipId único) para operaciones de fidelidadCadenaNo
lastFourDigitsOfCreditCardLos cuatro últimos dígitos de la tarjeta de crédito utilizada en la reservaEnteroNo
accountNameNombre del programa (si no coincide con el nombre del nivel)CadenaNo
loyaltyConversionRatioRatio de cómo se convierten los puntos obtenidos en el pago (por ejemplo, 1 EUR = 1 punto)DobleNo
loyaltyAccountBalanceSaldo actual de puntos de fidelidad obtenidos por el clienteImporte
(consulta la sección Importe más abajo para conocer los detalles del Objeto)
No

Importe

CampoDescripciónTipo de datos¿Obligatorio?
valueSaldo de fidelidad; anidado bajo loyaltyAccountBalanceLargo
currencyLa moneda de recompensa que se utiliza en el programa de fidelidad, como CAD, USD, PUNTOS, MILLAS; anidado bajo loyaltyAccountBalanceCadena

Restringir tarjeta de pago

Podemos configurar tu sitio web para que los clientes deban usar la tarjeta de crédito de tu organización en las reservas. Es opcional, ya que todas las soluciones de plantilla pueden aceptar cualquier tarjeta de crédito o débito de las entidades principales y (en EE. UU.) PayPal.

Almacenamiento y seguridad de tarjetas de crédito

Si decides obligar a utilizar la tarjeta de crédito personalizada de tu organización en las compras, queremos que sea con seguridad. Así es como lo gestionamos.

  • La información de la tarjeta se almacena en un formato de token que está vinculado al perfil del cliente en Expedia. Nunca se almacena sin cifrar.
  • Ningún ser humano tiene acceso a los datos de tarjetas cifrados, y solo se descifran con las credenciales de IAM seguras.
  • Cuando se precarga una tarjeta en la página de pago, solo se muestra la descripción de la tarjeta, pero no el número.
  • El cliente debe introducir el CVV de la tarjeta para completar la reserva con la tarjeta almacenada.

Requisitos de configuración

Además de los requisitos de configuración de la implementación estándar, cuando introduzcas tu tarjeta de crédito tendremos que añadir lo siguiente:

  • Un punto de conexión para utilizar con el parámetro AuthnRequest.
  • Tu clave pública para la verificación de firma.

Utilizaremos la clave privada de Expedia para firmar la carga AuthnRequest y nuestra clave pública para que valides la firma.

Detalles de carga

Junto con los atributos descritos en la implementación estándar, cuando un cliente inicia sesión en tu sitio web, el SSO de tarjeta de crédito inicia el envío de dos parámetros de transacción al punto de conexión seguro de SSO de Expedia:

  • API de información del usuario: carga de respuesta codificada y firmada con afirmaciones firmadas y cifradas.
  • RelayState: un enlace profundo a la URL de la página de destino.
Information

Nota

Si tu sitio web creado con plantilla está configurado para obtener puntos de fidelidad, también necesitarás la información programAccount.

La carga también incluirá los siguientes datos de la tarjeta de crédito:

CampoDescripción¿Obligatorio?
cardNumberEl número de la tarjeta en la que se debe cobrar
cardTypeTipo de tarjeta utilizada (por ejemplo, Visa, MasterCard, American Express)
expirationDateFecha de caducidad de la tarjeta utilizada
BillingAddressDirección de facturación asociada a la tarjeta utilizada
addressCategoryCodeEl tipo de dirección de facturación, por ejemplo, casa u oficina; anidado bajo BillingAddress
firstAddressLinePrimera línea de la dirección de facturación; anidado bajo BillingAddress
secondAddressLineSegunda línea de la dirección de facturación; anidado bajo BillingAddressNo
thirdAddressLineTercera línea de la dirección de facturación; anidado bajo BillingAddressNo
cityNameCiudad de la dirección de facturación; anidado bajo BillingAddress
provinceNameProvincia de la dirección de facturación; anidado bajo BillingAddress
postalCodeCódigo postal de la dirección de facturación; anidado bajo BillingAddress
countryCodeCódigo de país de la dirección de facturación; anidado bajo BillingAddress
¿Te ha resultado útil esta página?
¿Cómo podemos mejorar este contenido?
¡Gracias por ayudarnos a mejorar!