JWT
Richten Sie JWT für einen sicheren API-Zugriff ein und authentifizieren Sie sich damit.
JSON Web Tokens (JWT) ist eine kompakte und eigenständige Authentifizierungsmethode, mit der Informationen sicher als JSON-Objekt zwischen Parteien übertragen werden können.
Durch den Einsatz kryptografischer Signaturen gewährleistet JWT die Integrität und Authentizität von Daten und ist damit eine leistungsstarke Lösung für Web- und Mobilanwendungen.
Erleben Sie die Geschwindigkeit und Effizienz zustandsloser Authentifizierung: Jede Interaktion wird zum Kinderspiel, und Nutzer können nahtlos und ohne wiederholte Anmeldungen auf Ressourcen zugreifen.
JWT einrichten
Anfragen an die Ideanote API müssen ein Token enthalten.
- Navigieren Sie in Ihrem Workspace zu den Einstellungen und anschließend zu Authentifizierung
- Klicken Sie auf Hinzufügen und wählen Sie JWT
- Führen Sie den angezeigten Einrichtungsdialog durch
JWT-Datenfelder
Ideanote erwartet, dass die Struktur der JWT-Nutzlast dem folgenden Format entspricht:
- name: vollständiger Name des Nutzers (optional)
- avatarUrl: eine URL zum Avatar des Nutzers (optional)
- sub: Nutzer-ID in Ihrem System
- email: E-Mail-Adresse des Nutzers
- locale: Gebietsschema des Nutzers
- Subdomain: die Subdomain Ihres Ideanote Workspace
- Abteilung: Die Abteilung, in der der Nutzer arbeitet (unseres Wissens ist diese in den Daten, aus denen Sie das JWT generieren, in einer Nutzereigenschaft namens „User Site“ enthalten).
- Land: Das Land, in dem der Nutzer arbeitet (unseres Wissens ist diese in den Daten, aus denen Sie das JWT generieren, in einer Nutzereigenschaft namens „User Country“ enthalten.
Jeder Ihrer Workspaces ist mit einem gemeinsamen JWT-Geheimnis vorkonfiguriert, das Ihnen auf Anfrage zur Verfügung gestellt werden kann. Sie müssen die JWTs mit dem Geheimnis signieren, das dem jeweiligen Workspace zugeordnet ist.
Autorisierungsheader
Um API-Aufrufe zu authentifizieren, übermitteln Sie das signierte JWT über den Authorization-Header wie folgt:
Autorisierung: Bearer <JWT>