JWT

JSON Web Token (JWT) es un formato de token cifrado que transfiere de forma segura los datos de autenticación y autorización entre dos aplicaciones. En Document360, JWT se utiliza para autenticar los inicios de sesión de los lectores en tu sitio de base de conocimiento.

Document360 utiliza un enfoque similar al PKCE (Proof Key for Code Exchange, un método OAuth seguro) para generar el token JWT.

¿Cuándo NO usar JWT

JWT no es la elección adecuada si:

• Tu organización ya utiliza un Proveedor de Identidad centralizado (Okta, Microsoft Entra, Google Workspace) y quiere que los lectores se autentiquen a través de él. Usa SAML o OpenID Connect en su lugar. Para ello, lee Inicio de sesión único (SSO).
• Necesitas funciones como lectores SSO de registro automático, auto-registro del lector o saltarte la página común de inicio de sesión de Document360. Estas funciones no son compatibles con JWT.
• Necesitas autenticación de usuario (portal). JWT solo soporta autenticación por lectores en el sitio de la base de conocimiento.

JWT vs SAML vs OpenID Connect

Cómo funciona la autenticación JWT

El diagrama siguiente muestra el flujo completo de autenticación JWT entre tu aplicación, el servidor de identidad Document360 y el sitio de la base de conocimiento.

Terminología clave

Flujo de autenticación

1. El usuario accede a la base de conocimiento privada. Document360 detecta que JWT SSO está activado y redirige al usuario a la URL de inicio de sesión configurada en la configuración de JWT.
2. El usuario inicia sesión en tu aplicación. Si el usuario no está ya autenticado, tu página de inicio de sesión se encarga de su autenticación.
3. Tu backend solicita un código de autenticación de un solo uso. Tu backend envía una POST solicitud a la URL de generación de código con la identidad del usuario, opcional readerGroupIds, y tokenValidity en minutos. Esta solicitud debe estar autorizada usando HTTP Basic Auth con tu ID de cliente y secreto del cliente.

Cabecera de autorización de ejemplo

Authorization: Basic Base64Encode(clientId:clientSecret)

Ejemplo de carga útil JSON

{
  "username": "firstname + lastname",
  "firstName": "firstname",
  "lastName": "lastname",
  "emailId": "user email",
  "readerGroupIds": ["Obtain from Reader groups overview page in the Document360 portal (Optional)"],
  "tokenValidity": 15
}

4. El servidor de identidad de Document360 devuelve un código de autenticación. Si la solicitud es válida, el servidor de identidad de Document360 genera un código de autorización de un solo uso y lo envía de vuelta a tu backend.
5. Tu aplicación redirige al usuario de vuelta a Document360. Tu backend añade el código a la URL de Callback y redirige al usuario hacia ella. Por ejemplo: https://yourproject.document360.io/jwt/authorize?code=xyz

6. Document360 valida el código. Document360 lo envía al servidor de identidad a través de un canal de retorno para intercambiarlo por un token JWT.
7. Se crea la sesión de lectura. Document360 extrae información del usuario y reglas de acceso basadas en readerGroupIds el token. Se crea una sesión para el lector, dándole acceso a las categorías, idiomas o versiones permitidas.

Validez del token y comportamiento de la sesión

• Puedes definir la duración de la sesión usando el tokenValidity campo de la carga útil (mínimo: 5 minutos, máximo: 1440 minutos).
• Una vez que el token expira, el lector es redirigido de nuevo a tu URL de inicio de sesión.
• Si el usuario sigue autenticado en tu app, se genera un nuevo código y la sesión se restablece sin problemas.

Empieza con JWT

Preguntas frecuentes