Teste sua configuração do JWT

Depois de implementar a lógica SSO do JWT no backend, teste a integração antes de entrar em funcionamento. Esses testes simulam como seu backend se comunica com o servidor de identidade do Document360 para recuperar um código de autorização único.

Teste usando cURL
Execute uma requisição de linha de comando para verificar se as credenciais e a carga útil do cliente foram aceitas pelo servidor de identidade do Document360.
Pular para a → cURL

Teste usando o Postman
Envie uma solicitação manual POST no Postman para confirmar que um código de autorização única foi gerado com sucesso.
Pular para o Postman →

Teste usando cURL

Para testar a configuração JWT usando cURL, a versão HTTP deve ser especificada como HTTP/2 sobre TLS com a versão SSL definida como TLS 1.2. Sem isso, a requisição cURL falhará.

curl -X POST https://identity.document360.io/api/jwt/generate-code \
  -H "Authorization: Basic <BASE64_OF_CLIENT_ID:CLIENT_SECRET>" \
  -H "Content-Type: application/json" \
  --http2-prior-knowledge \
  --tls-max 1.2 \
  -d '{
        "username": "john.doe",
        "firstName": "John",
        "lastName": "Doe",
        "emailId": "john.doe@example.com",
        "readerGroupIds": ["group1", "group2"],
        "tokenValidity": 3600,
        "providerName": "app.example.com"
      }'

Se a configuração estiver correta, você receberá uma 200 OK resposta contendo um único code. Use este código para redirecionar o leitor para o site da base de conhecimento e completar o fluxo de login SSO.

Teste usando o Postman

Você pode testar sua configuração SSO do JWT usando o Postman enviando manualmente uma requisição para a URL de geração de código. Isso permite verificar se suas credenciais e payload do cliente foram aceitos e se um código de autorização única foi gerado com sucesso.

1. Abra o Postman e crie uma nova solicitação. Defina o método de requisição para POST e insira a URL de geração de código da página de configuração do JWT no campo URL:

   https://identity.document360.io/api/jwt/generate-code
   

2. Vá para a aba Autorização .

3. Defina o Tipo para Basic Auth.

4. No campo Nome de Usuário , insira seu ID de Cliente.

5. No campo Senha , insira seu Segredo do Cliente.

6. Navegue até a aba Corpo .

7. Selecione a opção raw e defina o formato para JSON.

8. Entra em cena a carga útil JSON:

   {
     "username": "john.doe",
     "firstName": "John",
     "lastName": "Doe",
     "emailId": "john.doe@example.com",
     "readerGroupIds": ["group1", "group2"],
     "tokenValidity": 3600,
     "providerName": "app.example.com"
   }
   

   Inclua providerName apenas se seu projeto tiver múltiplas configurações de JWT.

9. Clique em Enviar para enviar para enviar o pedido.

Se a configuração estiver correta, você receberá uma 200 OK resposta com um único code. Você pode então usar esse código para redirecionar o leitor ao site da base de conhecimento e completar o fluxo de login do SSO.

Melhores práticas

• Sempre use suas credenciais reais ao testar. Substitua o ID do Cliente, o Segredo do Cliente e os valores do payload por valores reais da sua página de configuração do JWT no Document360. Testes usando valores provisórios não produzirão um código de autorização válido.
• Defina explicitamente o TLS 1.2 em cURL. HTTP/2 sobre TLS com TLS 1.2 é necessário. Omitir as --http2-prior-knowledge flags e --tls-max 1.2 fará a solicitação falhar.
• Compare providerName com a configuração correta do JWT. Se seu projeto tiver múltiplas configurações de JWT, teste com o domínio de cada configuração para confirmar que os leitores retornam à URL correta de login quando a sessão expirar.
• Use o código de autorização imediatamente após recebê-lo. O código devolvido pelo servidor de identidade é de uso único e não pode ser reutilizado. Se o redirecionamento para a base de conhecimento não for concluído a tempo, um novo código deve ser solicitado.
• Teste com uma conta de usuário real do seu aplicativo. Leitores não precisam de uma conta separada no Document360. Use uma conta que exista no seu aplicativo cliente para simular com precisão o fluxo de login do leitor.
• Copie a URL de geração de código diretamente do Document360. Use a URL exata mostrada na página de configuração do JWT em vez de construí-la manualmente, para evitar erros no endpoint.