Sitio web a medida

Utilice una integración a medida si su plataforma no es WordPress o si necesita un control directo sobre las sesiones, el routing y el comportamiento basado en el perfil.

Requisitos previos

• Un backend capaz de mantener en secreto las credenciales y los tokens
• Callback Routes HTTPS
• Un mecanismo de sesión server-side
• Un cliente de DocID^® para cada entorno

Crear dos application routes

Su aplicación normalmente necesita:

1. una Login Route que genere state, nonce y los valores de PKCE antes de redirigir a DocID^®
2. una Callback Route que valide la response, intercambie el código, lea los claims autorizados y cree una sesión local

Guarde los datos temporales de autorización en una cookie firmada, HTTP-only, Secure y SameSite, o en un transaction store server-side.

Solicitar autorización

Redirija el navegador a /oauth2/authorize con:

Gestionar el callback

En el servidor:

1. rechace los callbacks cuando falte state o su valor no coincida.
2. gestione una response de OAuth error sin mostrar detalles técnicos al usuario.
3. intercambie el Authorization Code en /oauth2/token.
4. envíe el code_verifier original.
5. solicite /oauth2/userinfo con el Access Token.
6. asocie sub con la cuenta o sesión local.
7. elimine los datos temporales de la transacción OAuth.

Ver el flow OAuth 2.0 completo