Dokumentation/Entwickler
Zurück
  • Erste Schritte
    • Frontends und App-Typen
    • Umgebungen und Endpunkte
  • OAuth-Clients
    • Client-ID und Client-Secret
    • Redirect-URIs und Start-URL
    • Secret erneuern
  • Login with appsolut
    • Authorization-Code-Flow
    • Tokens und Claims
    • Frontend-Rolle
    • Abmeldung
    • Widerruf und ausgestellte Tokens
    • Fehler des Token-Endpunkts
  • Frontend-Schlüssel
    • Einen Schlüssel ausstellen und aufbewahren
    • Einen Schlüssel senden
    • Wechseln und widerrufen
  • Mitglieder-API
    • Berechtigung aus einem Backend
    • Das angemeldete Mitglied
    • Ergebnisse, Ratenlimits und Fehler
    • Ist ein Antragsteller ein berechtigtes Mitglied?
    • Die Mitgliedschaft des angemeldeten Frontend-Benutzers
  • appsolut Register-API
    • Die API umsetzen
    • Anbinden und testen
    • Ein Mitglied mit seinem Prüfcode verifizieren
    • Alle Mitglieder auflisten
    • Der Status mehrerer Mitglieder
    • Der Status eines Mitglieds
    • Die Personendaten mehrerer Mitglieder
    • Die Personendaten eines Mitglieds
    • Die Claims mehrerer Mitglieder
    • Die Claims eines Mitglieds
    • Health-Check

OAuth-Clients

Wie ein Frontend den OAuth-Client bekommt, mit dem es Benutzer anmeldet.

Jedes Frontend ist ein OAuth-Client des OAuth-2.1-Servers des Studios. Das Studio verwaltet den Client für Sie: Es gibt keine eigene Registrierung, und der Eintrag des Frontends im Studio ist dafür maßgeblich.

Wann ein Frontend seinen Client bekommt

Der Client wird erstellt, wenn ein Studio-Benutzer die Anmeldeeinstellungen des Frontends zum ersten Mal speichert, auf der Karte „Anmeldung“ der Frontend-Seite:

  1. Er wählt den „App-Typ“ (derzeit „Web-App“).
  2. Er trägt die „Redirect-URIs“ und die „Start-URL“ des Frontends ein (siehe Redirect-URIs und Start-URL).
  3. Er klickt auf „Anmeldeeinstellungen speichern“.

Das Studio erstellt dann den Client und zeigt den Dialog „Der Anmelde-Client Ihres Frontends“ mit Client-ID und Client-Secret. Das Secret wird nur dieses eine Mal angezeigt. Jedes spätere Speichern ändert denselben Client; die Client-ID bleibt.

Frontend-Benutzer sehen auf den Anmeldeseiten den Namen des Frontends. Einen eigenen Anzeigenamen gibt es nicht: Um ihn zu ändern, benennt die Organisation das Frontend unter „Einstellungen“ um.

Wer ihn einrichtet

Studio-Benutzer mit der Studio-Rolle „Eigentümer“, „Administrator“ oder „Frontend-Manager“. Als Entwickler liefern Sie die Redirect-URIs und die Start-URL und erhalten Client-ID und Secret, die Sie direkt in der Konfiguration Ihres Backends hinterlegen.

Vorerst nur interne Web-Apps

Das Studio erstellt einen Client nur für ein internes Frontend mit dem App-Typ „Web-App“. Der Auth-Server und die Anmeldeseiten weisen jede andere Art von Client ab, ein vertraulicher Client mit Backend ist also derzeit die einzige Form. Öffentliche Clients (Single-Page-Apps, mobile und Desktop-Apps) und externe Frontends folgen später.

In diesem Abschnitt

  • Client-ID und Client-Secret: wofür beide da sind und wie Ihr Backend sie sendet.
  • Redirect-URIs und Start-URL: die Regeln für beide.
  • Secret erneuern: das Secret erneuern und einen verlorenen Client neu erstellen.