--- title: "Teste sua configuração do JWT" slug: "test-your-jwt-configuration" updated: 2026-10-12T08:21:03Z published: 2026-10-12T08:21:03Z canonical: "docs.document360.com/test-your-jwt-configuration" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.document360.com/llms.txt > Use this file to discover all available pages before exploring further. # 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](/docs/pt/test-your-jwt-configuration#test-using-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 →](/docs/pt/test-your-jwt-configuration#test-using-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 " \ -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" }' ``` NOTA - Substitua `<BASE64_OF_CLIENT_ID:CLIENT_SECRET>` pelo valor codificado em Base64 do seu ID de Cliente e do Secret do Cliente, acompanhado por dois dois. Substitua os campos de carga útil por informações do usuário do seu sistema. - Se seu projeto tiver múltiplas configurações de JWT, inclua `providerName` no payload e defina-o para o Domínio da configuração JWT correspondente, disponível em **Configurações** > **Usuários e Permissões** > **JWT**. Para mais informações, [veja Re-autenticar leitores com múltiplas configurações de JWT](https://docs.document360.com/docs/pt/implement-jwt-in-your-application#re-authenticating-readers-with-multiple-jwt-configurations). - Leitores não precisam de uma conta separada no Document360. Uma conta no aplicativo cliente é suficiente para acessar a base de conhecimento. 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.