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.
Nesta páxina
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.
| Punto final requirido | Exemplo de dominio e ruta | Especificacións |
|---|---|---|
| Autorización | https://auth.provider.com/authorize | RFC 6749 sección 4.1 |
| Token | https://auth.provider.com/token | RFC 6749 sección 4.1.3 e RFC 6749 sección 6 |
| JWKS | https://auth.provider.com/.well-known/jwks.json | RFC 7517 sección 5 |
| Descubrimento | https://auth.provider.com/.well-known/openid-configuration | OpenID 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 enS256.
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ónupnno canto deemaile 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 deemail_verifieddebe sertrue.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: