Individuelle Website

Verwenden Sie eine individuelle Integration, wenn Ihre Plattform nicht auf WordPress basiert oder Sie direkte Kontrolle über Sessions, Routing und profilbasiertes Verhalten benötigen.

Voraussetzungen

• Ein Backend, das Credentials und Tokens geheim halten kann
• HTTPS Callback Routes
• Ein serverseitiger Session-Mechanismus
• Ein DocID^® Client für jede Umgebung

Zwei Application Routes erstellen

Ihre Anwendung benötigt in der Regel:

1. eine Login Route, die state, nonce und die PKCE-Werte erzeugt, bevor sie zu DocID^® weiterleitet
2. eine Callback Route, die die Response validiert, den Code austauscht, die freigegebenen Claims liest und eine lokale Session erstellt

Speichern Sie temporäre Authorization-Daten in einem signierten, HTTP-only, Secure, SameSite Cookie oder in einem serverseitigen Transaction Store.

Authorization anfordern

Leiten Sie den Browser zu /oauth2/authorize weiter und übergeben Sie:

Callback verarbeiten

Auf dem Server:

1. Callbacks mit fehlendem oder abweichendem state ablehnen.
2. Eine OAuth error Response behandeln, ohne dem Nutzer technische Details offenzulegen.
3. Den Authorization Code bei /oauth2/token austauschen.
4. Den ursprünglichen code_verifier mitsenden.
5. Mit dem Access Token /oauth2/userinfo aufrufen.
6. sub dem lokalen Konto oder der Session zuordnen.
7. Die temporären OAuth Transaction Data entfernen.

Vollständigen OAuth-2.0-Flow ansehen