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

Frontend-Rolle

Was frontend_role über den angemeldeten Benutzer sagt und wann sie sich ändert.

frontend_role sagt, was Sie über den angemeldeten Benutzer auf Ihrem Frontend annehmen dürfen:

  • member: Die Organisationsmitgliedschaft des Benutzers ist gültig, und er gehört zur Community Ihres Frontends.
  • authenticated: angemeldet, aber nicht (oder derzeit nicht) Mitglied der Community Ihres Frontends.

Pannoniqas Pensionistinnen und Pensionisten erhalten etwa auf dem Pannoniqa Portal (Community „Gesamte Belegschaft“) member und, falls sie sich dort überhaupt anmelden, auf der Pannoniqa App (Community „Aktive Belegschaft“) authenticated.

Wann sie berechnet wird

Bei jedem Code-Tausch und bei jedem Refresh, aus dem, was das Studio gespeichert hat; sie ist keine Live-Antwort:

  • Bei einer Anmeldung führen die Anmeldeseiten die Mitgliedschaftsprüfung im Prüfmodus Anmeldung gegen die Register der Organisation durch, und das Studio speichert das Ergebnis.
  • Bei einem Refresh wird kein Register gefragt. Die Rolle bleibt nur member, solange die Mitgliedschaft aktiv und gültig ist, ihre letzte gültige Prüfung weniger als 7 Tage alt ist und ihre gespeicherten Angaben die Community-Filter Ihres Frontends noch erfüllen. Sonst ist sie authenticated.
  • Ein Zugriffstoken behält die Rolle, mit der es ausgestellt wurde, bis es abläuft; eine Änderung erreicht Sie also innerhalb einer Stunde.

Bei einem Frontend mit verpflichtender Mitgliedschaft

Dort gibt es kein Token mit authenticated. Ein Benutzer, der kein Mitglied ist, erhält beim Code-Tausch kein Token, und ein Refresh für jemanden, der keines mehr ist, wird mit 403 „The frontend is for members only“ abgewiesen (siehe Fehler des Token-Endpunkts). Verwerfen Sie die Sitzung und schicken Sie den Benutzer erneut durch die Anmeldung: Die Anmeldeprüfung läuft, und die Anmeldeseiten sagen ihm, was er tun kann, wenn er immer noch kein Mitglied ist.

Für mehr als die Rolle

Für die gespeicherte Mitgliedschaft selbst (Status, Communities, Register und die Mitgliedsdaten) fragt Ihr Backend die Mitglieder-API: GET /api/v1/members/me (siehe Das angemeldete Mitglied). Auch sie antwortet aus dem gespeicherten letzten Ergebnis und wendet die 7 Tage nur an, wenn eine spätere Prüfung das Register nicht erreicht hat (die Kulanzregel); anders als die Rolle verfällt sie nicht 7 Tage nach der letzten Anmeldung.