Teste deine JWT-Konfiguration

Sobald Sie die JWT-SSO-Logik in Ihrem Backend implementiert haben, testen Sie die Integration, bevor Sie live gehen. Diese Tests simulieren, wie Ihr Backend mit dem Document360-Identitätsserver kommuniziert, um einen einmaligen Autorisierungscode abzurufen.

Testen Sie mit cURL
Führen Sie eine Kommandozeilenanfrage aus, um zu überprüfen, ob Ihre Client-Zugangsdaten und die Nutzlast vom Document360-Identitätsserver akzeptiert werden.
Springen Sie zu cURL →

Test mit Postman
Senden Sie eine manuelle POST-Anfrage in Postman, um zu bestätigen, dass ein einmaliger Autorisierungscode erfolgreich generiert wurde.
Springen Sie zum Postboten →

Testen Sie mit cURL

Um die JWT-Konfiguration mit cURL zu testen, muss die HTTP-Version als HTTP/2 über TLS angegeben werden, wobei die SSL-Version auf TLS 1.2 gesetzt ist. Ohne diese schlägt die cURL-Anfrage fehl.

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

Wenn die Konfiguration korrekt ist, erhalten Sie eine 200 OK Antwort mit einem einmaligen code. Verwenden Sie diesen Code, um den Leser auf die Knowledge Base-Seite umzuleiten und den SSO-Login-Flow abzuschließen.

Test mit Postman

Sie können Ihre JWT-SSO-Konfiguration mit Postman testen, indem Sie eine Anfrage manuell an die Code-Generierungs-URL senden. So können Sie überprüfen, ob Ihre Client-Zugangsdaten und die Nutzlast akzeptiert werden und dass ein einmaliger Autorisierungscode erfolgreich generiert wurde.

1. Öffnen Sie Postman und erstellen Sie eine neue Anfrage. Setzen Sie die Anfragemethode auf POST und geben Sie die Code-Generierungs-URL von der JWT-Konfigurationsseite im URL-Feld ein:

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

2. Gehe zum Reiter Autorisierung .

3. Setze den Typ auf Basic Auth.

4. Im Feld Benutzername geben Sie Ihre Client-ID ein.

5. Im Passwortfeld geben Sie Ihr Client Secret ein.

6. Navigiere zum Reiter "Leichen".

7. Wählen Sie die RAW-Option und setzen Sie das Format auf JSON.

8. Hier kommt die JSON-Nutzlast ins Spiel:

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

   Schließen Sie nur ein, providerName wenn Ihr Projekt mehrere JWT-Konfigurationen hat.

9. Klicken Sie auf Senden , um die Anfrage einzureichen.

Wenn die Konfiguration korrekt ist, erhalten Sie eine 200 OK einmalige codeAntwort . Sie können diesen Code dann verwenden, um den Leser auf die Knowledge Base-Seite umzuleiten und den SSO-Login-Flow abzuschließen.

Best Practices

• Verwenden Sie beim Testen immer Ihre tatsächlichen Zugangsdaten. Ersetzen Sie die Platzhalter-Client-ID, Client Secret- und Payload-Werte durch echte Werte von Ihrer JWT-Konfigurationsseite in Document360. Tests mit Platzhalterwerten erzeugen keinen gültigen Autorisierungscode.
• Setze TLS 1.2 explizit in cURL. HTTP/2 über TLS mit TLS 1.2 ist erforderlich. Das Weglassen der --http2-prior-knowledge und-Flags --tls-max 1.2 führt dazu, dass die Anfrage fehlschlägt.
• Passen Sie der korrekten JWT-Konfiguration zu. providerName Wenn Ihr Projekt mehrere JWT-Konfigurationen hat, testen Sie mit der Domain jeder Konfiguration, um sicherzustellen, dass die Leser nach Ablauf ihrer Sitzung zur korrekten Login-URL zurückkommen.
• Verwenden Sie den Autorisierungscode unmittelbar nach Erhalt davon. Der vom Identitätsserver zurückgegebene Code ist einmalig und kann nicht wiederverwendet werden. Wenn die Weiterleitung zur Wissensdatenbank nicht rechtzeitig abgeschlossen ist, muss ein neuer Code angefordert werden.
• Testen Sie mit einem echten Benutzerkonto aus Ihrer Anwendung. Leser benötigen kein separates Document360-Konto. Verwenden Sie ein Konto, das in Ihrer Client-Anwendung existiert, um den Leser-Login-Fluss genau zu simulieren.
• Kopieren Sie die Code-Generierungs-URL direkt aus Document360. Verwenden Sie die genaue URL, die auf der JWT-Konfigurationsseite angezeigt wird, anstatt sie manuell zu erstellen, um Endpunktfehler zu vermeiden.