JWT

JSON Web Token (JWT) é um formato de token criptografado que transfere de forma segura dados de autenticação e autorização entre dois aplicativos. No Document360, o JWT é usado para autenticar logins de leitores no seu site de base de conhecimento.

O Document360 utiliza uma abordagem semelhante ao PKCE (Proof Key for Code Exchange, um método OAuth seguro) para gerar o token JWT.

Quando NÃO usar JWT

JWT não é a escolha certa se:

• Sua organização já utiliza um Provedor de Identidade centralizado (Okta, Microsoft Entra, Google Workspace) e quer que os leitores se autentiquem por meio dele. Use SAML ou OpenID Connect em vez disso. Para isso, leia Single Sign-On (SSO).
• Você precisa de recursos como leitores SSO de registro automático, auto-registro do leitor ou pular a página comum de login do Document360. Esses recursos não são suportados pelo JWT.
• Você precisa da autenticação do usuário (portal). O JWT só suporta autenticação de leitores no site da base de conhecimento.

JWT vs SAML vs OpenID Connect

Como funciona a autenticação JWT

O diagrama abaixo mostra o fluxo completo de autenticação JWT entre sua aplicação, o servidor de identidade Document360 e o site da base de conhecimento.

Terminologia chave

Fluxo de autenticação

1. O usuário acessa a base de conhecimento privada. O Document360 detecta que o SSO do JWT está ativado e redireciona o usuário para a URL de Login configurada nas configurações do JWT.
2. O usuário faz login na sua aplicação. Se o usuário ainda não estiver autenticado, sua página de login cuida da autenticação dele.
3. Seu backend solicita um código de autenticação único. Seu backend envia uma POST solicitação para a URL de geração de código com a identidade do usuário, opcional readerGroupIds, e tokenValidity em minutos. Essa solicitação deve ser autorizada usando HTTP Basic Auth com seu ID de Cliente e Secret do Cliente.

Cabeçalho de Autorização de Exemplo

Authorization: Basic Base64Encode(clientId:clientSecret)

Exemplo 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. O servidor Document360 Identity retorna um código de autenticação. Se a solicitação for válida, o servidor de identidade do Document360 gera um código de autorização de uso único e o envia de volta para o seu backend.
5. Seu app redireciona o usuário de volta para o Document360. Seu backend adiciona o código à URL de Callback e redireciona o usuário para ele. Por exemplo: https://yourproject.document360.io/jwt/authorize?code=xyz

6. O Document360 valida o código. O Document360 envia para o servidor de identidade via backchannel para trocá-lo por um token JWT.
7. A sessão de leitura é criada. O Document360 extrai informações do usuário e regras de acesso baseadas readerGroupIds no token. Uma sessão é criada para o leitor, concedendo-lhe acesso às categorias, idiomas ou versões permitidas.

Validade do token e comportamento de sessão

• Você pode definir a duração da sessão usando o tokenValidity campo na carga útil (mínimo: 5 minutos, máximo: 1440 minutos).
• Assim que o token expira, o leitor é redirecionado de volta para sua URL de login.
• Se o usuário ainda estiver autenticado no seu app, um novo código é gerado e a sessão é restabeleceda de forma fluida.

Comece com o JWT

FAQ