--- title: "Teste deine JWT-Konfiguration" slug: "test-your-jwt-configuration" updated: 2026-10-12T08:20:30Z published: 2026-10-12T08:20:30Z 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 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 →](/docs/de/test-your-jwt-configuration#test-using-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 →](/docs/de/test-your-jwt-configuration#test-using-postman) --- ## 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 " \ -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" }' ``` HINWEIS - Ersetzen `<BASE64_OF_CLIENT_ID:CLIENT_SECRET>` Sie durch den Base64-codierten Wert Ihrer Client-ID und Ihres Client Secret, verbunden mit einem Doppelpunkt. Ersetzen Sie die Nutzlastfelder durch Benutzerinformationen aus Ihrem System. - Wenn Ihr Projekt mehrere JWT-Konfigurationen hat, fügen Sie sie in die Nutzlast ein `providerName` und setzen Sie sie auf die Domäne der passenden JWT-Konfiguration, **die in** **Settings > Users & Permissions** > **JWT** verfügbar ist. Weitere Informationen finden Sie [unter Re-authenticating readers with multiple JWT configurations](https://docs.document360.com/docs/de/implement-jwt-in-your-application#re-authenticating-readers-with-multiple-jwt-configurations). - Leser benötigen kein separates Konto auf Document360. Ein Konto in der Client-Anwendung reicht aus, um auf die Wissensdatenbank zuzugreifen. 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 `code`Antwort . 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.