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

Redirect-URIs und Start-URL

Wohin eine Anmeldung zurückführt und wohin die Anmeldeseiten Benutzer ohne laufende Anmeldung schicken.

Redirect-URIs

Nach der Anmeldung kehren Frontend-Benutzer mit dem Autorisierungscode zu einer der „Redirect-URIs“ des Frontends zurück. Ein Frontend hat 1 bis 10, eingetragen auf der Karte „Anmeldung“ („Redirect-URI hinzufügen“ fügt eine hinzu). Die Regeln:

  • Schema: https:// mit einem Hostnamen, oder http nur auf localhost oder 127.0.0.1 (beliebiger Port) für die lokale Entwicklung.
  • Exakt: Das Frontend muss die Adresse Zeichen für Zeichen so senden, wie sie im Studio eingetragen ist. Keine Platzhalter.
  • Zeichen: kein Fragment (#), kein *, keine Kommas und keine Leerzeichen; % nur als %XX-Escape.
  • Jede Redirect-URI nur einmal.

Die redirect_uri Ihrer Autorisierungsanfrage muss exakt einer davon entsprechen, und die Token-Anfrage muss dieselbe wiederholen. Eine Anfrage mit einer nicht eingetragenen Redirect-URI kommt nie zu Ihnen zurück: Sie endet auf einer neutralen Fehlerseite der Anmeldeseiten.

Das Portal von Pannoniqa trägt etwa https://portal.pannoniqa.example/auth/callback für die Produktion und http://localhost:3000/auth/callback für die Entwicklung ein.

Start-URL

Die „Start-URL“ ist die Seite Ihres Frontends, zu der die Anmeldeseiten einen Frontend-Benutzer schicken, der ohne eine von Ihrem Frontend begonnene Anmeldung kommt:

  • nach dem Zurücksetzen des Passworts;
  • nach der Abmeldeseite;
  • wenn eine abgelaufene Anmeldeanfrage nicht neu gestartet werden kann.

Ihr Ursprung (Schema, Host und Port) muss mit einer der Redirect-URIs übereinstimmen, und für sie gelten dieselben Schema- und Zeichenregeln. Wählen Sie eine Seite, die für abgemeldete Besucher funktioniert und „Anmelden“ anbietet oder die Anmeldung selbst startet: bei Pannoniqa https://portal.pannoniqa.example/.

Änderungen

Eine Änderung gilt, sobald der Studio-Benutzer auf „Anmeldeeinstellungen speichern“ klickt. Client-ID und Secret bleiben gleich. Stellen Sie einen neuen Callback bereit, bevor Sie die alte Redirect-URI entfernen, sonst schlagen laufende Anmeldungen fehl.