Requisitos para conectar o teu propio provedor de identidade ás contas de cliente

Antes de conectar o teu propio provedor de identidade ás contas de cliente, asegúrate de que o teu provedor cumpre con todos os requisitos técnicos; para iso, revisa a documentación ou ponte en contacto co soporte do teu provedor de identidade.

Requisitos para os provedores de identidade

Para a integración coa túa tenda de Shopify, o provedor de identidade debe cumprir cos seguintes requisitos:

  • O provedor de identidade é compatible co fluxo de código de autorización de OAuth 2.0. Os fluxos implícitos e híbridos non son compatibles. client_secret_basic é o método de autenticación de punto final de tokens predeterminado.
  • O provedor de identidade é compatible coa chave de proba para o cambio de código (PKCE) para clientes públicos.
  • O provedor de identidade cumpre co estándar OpenID Connect (OIDC) para a autenticación.
  • O provedor de identidade é compatible con OpenID Connect RP-Initiated Logout 1.0 para o peche de sesión. Os peches de sesión de canal posterior (Back-Channel) e de canal frontal (Front-Channel) non son compatibles.
  • O provedor de identidade admite o correo electrónico como identificador único para os usuarios e a verificación do correo electrónico forma parte do proceso de rexistro.

Requisitos de puntos finais

O provedor de identidade co que te conectes debe ser compatible con puntos finais específicos. Revisa a seguinte táboa para obter máis información sobre os puntos finais requiridos, as súas especificacións e exemplos.

Puntos finais requiridos do provedor de identidade
Punto final requiridoExemplo de dominio e rutaEspecificacións
Autorizaciónhttps://auth.provider.com/authorizeRFC 6749 sección 4.1
Tokenhttps://auth.provider.com/tokenRFC 6749 sección 4.1.3 e RFC 6749 sección 6
JWKShttps://auth.provider.com/.well-known/jwks.jsonRFC 7517 sección 5
Descubrimentohttps://auth.provider.com/.well-known/openid-configurationOpenID Discovery 1.0

Requisitos de tempo de resposta dos puntos finais

As solicitudes de Shopify aos puntos finais de tokens, descubrimento e información do usuario do teu provedor de identidade deben responder en 1 segundo. Se un punto final tarda máis de 1 segundo en responder, esgotarase o tempo de espera da solicitude e o fluxo de inicio de sesión fallará. Para evitar esgotar o tempo de espera, asegúrate de que o teu provedor de identidade estea aloxado nun ámbito de baixa latencia e con capacidade suficiente.

Requisitos móbiles

Se a túa tenda ten unha aplicación móbil, o punto final de autorización do provedor de identidade debe ser compatible cos seguintes parámetros:

  • code_challenge: verifica que o cliente que solicita o token é o mesmo cliente que iniciou a solicitude.
  • code_challenge_method: este punto final debe establecerse en S256.

Requisitos de tokens de ID

Un token de ID é unha proba de autenticación, emitida polo teu provedor de identidade despois de que un usuario inicie sesión correctamente. Revisa os seguintes requisitos de reclamacións e sinaturas para os tokens de ID.

Reclamacións requiridas

As reclamacións son declaracións que o teu provedor de identidade comparte sobre un usuario, as cales se usan para a autenticación. Ao conectar as contas de cliente ao teu propio provedor de identidade, as seguintes reclamacións son requiridas na configuración do token de ID:

  • sub: un identificador único para o usuario dentro do teu provedor de identidade.
  • nonce: unha cadea única incluída no token de ID para evitar ataques de repetición.
  • email: o enderezo de correo electrónico único do usuario usado para proporcionar a conta de cliente. Para as integracións con Entra ID e Azure AD, úsase a reclamación upn no canto de email e debe apuntar a un enderezo de correo electrónico válido que poida recibir os pedidos e as comunicacións relacionadas co cliente.
  • email_verified: un valor booleano que indica se o correo electrónico foi verificado polo provedor de identidade. O valor de email_verified debe ser true.
  • iss: o identificador do emisor para o teu provedor de identidade.
  • aud: o público ao que está destinado o token de ID, tamén coñecido como o teu ID de cliente.

Requisitos de sinatura do token

Os requisitos dos asinantes axudan ao teu provedor de identidade a verificar a identidade dun usuario durante o proceso de inicio de sesión. O teu provedor de identidade debe asinar os tokens de ID mediante un dos seguintes algoritmos compatibles:

  • RSA: RS256, RS384, RS512
  • Curva elíptica: ES256, ES384, ES512, ES256K
  • RSA-PSS: PS256, PS384, PS512
  • EdDSA: ED25519, EdDSA

Non se admiten os tokens asinados con HS256 (HMAC con segredo compartido).

Requisitos de sesión e token

Shopify usa tokens de actualización para manter as sesións dos clientes durante un máximo de 90 días. Se non hai un token de actualización, as sesións finalizarán cando caduque o token de acceso do teu provedor de identidade, algo que adoita ocorrer ao cabo de 1 hora.

Para admitir sesións de clientes de longa duración, o teu provedor de identidade debe cumprir os seguintes requisitos:

  • O provedor de identidade debe admitir a emisión de tokens de actualización tal e como se define na sección 1.5 de RFC 6749.
  • O provedor de identidade debe estar configurado para devolver tokens de actualización na resposta do token.

Recursos adicionais

Para obter máis información sobre os requisitos e os provedores de identidade que cumpren con OpenID Connect (OIDC), revisa os seguintes recursos de terceiros: