Testez votre configuration JWT

Une fois que vous avez implémenté la logique SSO JWT dans votre backend, testez l’intégration avant de passer en ligne. Ces tests simulent la façon dont votre backend communique avec le serveur d’identité Document360 pour récupérer un code d’autorisation à usage unique.

Tester avec cURL
Lancez une requête en ligne de commande pour vérifier que vos identifiants et votre charge utile client sont acceptés par le serveur d’identité Document360.
Aller à la cURL →

Test avec Postman
Envoyez une requête POST manuelle dans Postman pour confirmer qu’un code d’autorisation à usage unique a été généré avec succès.
Passer à Postman →

Tester avec cURL

Pour tester la configuration JWT en utilisant cURL, la version HTTP doit être spécifiée comme HTTP/2 sur TLS avec la version SSL définie sur TLS 1.2. Sans cela, la requête cURL échouera.

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"
      }'

Si la configuration est correcte, vous recevrez une 200 OK réponse contenant un codefichier unique . Utilisez ce code pour rediriger le lecteur vers le site de la base de connaissances et compléter le flux de connexion SSO.

Test avec Postman

Vous pouvez tester votre configuration SSO JWT avec Postman en envoyant manuellement une requête à l’URL de génération de code. Cela vous permet de vérifier que vos identifiants clients et votre charge utile sont acceptés et qu’un code d’autorisation à usage unique est généré avec succès.

1. Ouvre Postman et crée une nouvelle requête. Définis la méthode de requête sur POST et saisi l’URL de génération de code depuis la page de configuration JWT dans le champ URL :

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

2. Allez dans l’onglet Autorisation .

3. Définissez le Type à Basic Auth.

4. Dans le champ Nom d’utilisateur , saisissez votre identifiant client.

5. Dans le champ Mot de passe , saisissez votre Secret Client.

6. Naviguez jusqu’à l’onglet Corps .

7. Sélectionnez l’option raw et réglez le format sur JSON.

8. Voici la charge utile JSON :

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

   Incluez providerName seulement si votre projet comporte plusieurs configurations JWT.

9. Cliquez sur Envoyer pour soumettre la demande.

Si la configuration est correcte, vous recevrez une 200 OK réponse avec un fichier codeunique . Vous pouvez alors utiliser ce code pour rediriger le lecteur vers le site de la base de connaissances et compléter le flux de connexion SSO.

Meilleures pratiques

• Utilisez toujours vos identifiants réels lors des tests. Remplacez les valeurs de l’identifiant client provisoire, du secret client et de la charge utile par des valeurs réelles de votre page de configuration JWT dans Document360. Les tests utilisant des valeurs de remplacement ne produiront pas de code d’autorisation valide.
• Définissez explicitement TLS 1.2 en cURL. HTTP/2 sur TLS avec TLS 1.2 est nécessaire. Omettre les --http2-prior-knowledge drapeaux et --tls-max 1.2 provoquera l’échec de la requête.
• Comparez providerName à la bonne configuration JWT. Si votre projet possède plusieurs configurations JWT, testez avec le domaine de chaque configuration pour confirmer que les lecteurs reviennent à la bonne URL de connexion lorsque leur session expire.
• Utilisez le code d’autorisation immédiatement après sa réception. Le code retourné par le serveur d’identité est à usage unique et ne peut pas être réutilisé. Si la redirection vers la base de connaissances n’est pas terminée à temps, un nouveau code doit être demandé.
• Testez avec un compte utilisateur réel de votre application. Les lecteurs n’ont pas besoin d’un compte Document360 séparé. Utilisez un compte existant dans votre application client pour simuler fidèlement le flux de connexion du lecteur.
• Copiez l’URL de génération de code directement depuis Document360. Utilisez l’URL exacte affichée dans la page de configuration JWT plutôt que de la construire manuellement, pour éviter les erreurs de point de terminaison.