Anmeldeeinstellungen

Studio-Rollen: „Eigentümer“, „Administrator“ und „Frontend-Manager“.

Mit den Anmeldeeinstellungen meldet ein Frontend seine Benutzer mit Login with appsolut an. Beim ersten Speichern richtet das Studio den Anmelde-Client des Frontends ein und zeigt seine Client-ID und sein Client-Secret, die das Backend des Frontends braucht.

Vorerst können nur interne Frontends, die Web-Apps sind, Benutzer anmelden. Ein externes Frontend zeigt „Externe Frontends können noch keine Benutzer anmelden“: Die Anmeldung für externe Frontends folgt im Dezember. Die anderen App-Typen („Single-Page-App“, „Mobile App“, „Desktop-App“ und „Server“) sind mit „Später“ markiert.

Die Anmeldung einrichten

1. Öffnen Sie „Frontends“ und wählen Sie das Frontend, zum Beispiel „Pannoniqa Portal“.
2. Wählen Sie unter „Anmeldung“ den „App-Typ“ „Web-App“: eine Website mit eigenem Backend, das das Client-Secret aufbewahrt.
3. Geben Sie unter „Redirect-URIs“ die Adresse ein, die Ihnen die Entwickler des Frontends nennen, zum Beispiel https://portal.pannoniqa.example/api/auth/callback. Nach der Anmeldung kehren Frontend-Benutzer zu einer dieser Adressen zurück. Mit „Redirect-URI hinzufügen“ fügen Sie weitere hinzu, bis zu 10.
4. Geben Sie unter „Start-URL“ die Seite ein, auf die Frontend-Benutzer gelangen, wenn es keine Anmeldung gibt, zu der sie zurückkehren können, etwa nach dem Zurücksetzen ihres Passworts, zum Beispiel https://portal.pannoniqa.example/.
5. Wählen Sie „Anmeldeeinstellungen speichern“.
6. Der Dialog „Der Anmelde-Client Ihres Frontends“ zeigt die „Client-ID“ und das „Client-Secret“. Kopieren Sie beides und geben Sie es den Entwicklern des Frontends, die es in seinem Backend hinterlegen.
7. Wählen Sie „Ich habe das Secret gespeichert“.

Das Secret wird nur einmal angezeigt: Das Studio speichert es nicht. Die Client-ID bleibt unter „Anmeldung“ sichtbar; sie ist nicht geheim.

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

Regeln für die Adressen

• Eine Redirect-URI verwendet https, oder http nur auf localhost oder 127.0.0.1 für die lokale Entwicklung.
• Sie ist exakt: Das Frontend muss die Adresse Zeichen für Zeichen so senden, wie sie hier eingetragen ist. Platzhalter gibt es nicht.
• Sie hat kein Fragment (#), kein *, keine Kommas und keine Leerzeichen.
• Für die Start-URL gelten dieselben Regeln, und ihr Ursprung (Schema, Host und Port) muss mit einer der Redirect-URIs übereinstimmen.

Das Client-Secret erneuern

Ist das Secret verloren gegangen oder womöglich bekannt geworden, stellen Sie ein neues aus.

1. Wählen Sie unter „Anmeldung“ die Option „Secret erneuern“.
2. Lesen Sie den Hinweis „Das alte Secret funktioniert sofort nicht mehr“ und wählen Sie „Secret erneuern“.
3. Kopieren Sie das neue Secret aus „Ihr neues Client-Secret“ und wählen Sie „Ich habe das Secret gespeichert“.

Es gibt keine Übergangszeit: Das Frontend lässt jede Anmeldung fehlschlagen, bis das neue Secret in seinem Backend hinterlegt ist. Erneuern Sie es, wenn die Entwickler es sofort hinterlegen können.

Wenn der Anmelde-Client fehlt

• „Dieses Frontend hat noch keinen Anmelde-Client“: Die Einstellungen sind gespeichert, aber der Client konnte nicht eingerichtet werden. Speichern Sie die Einstellungen erneut.
• „Der Anmelde-Client existiert nicht mehr“: Wählen Sie „Client neu erstellen“. Der neue Client hat eine neue Client-ID und ein neues Secret, die die Entwickler im Backend des Frontends hinterlegen.
• „Die Anmeldung ist derzeit nicht verfügbar“: Der Anmeldedienst antwortet nicht. Versuchen Sie es später erneut.

Wie die Entwickler des Frontends Client-ID und Secret verwenden, steht in der Entwicklerdokumentation.