Frontends und App-Typen
Was ein Frontend aus Sicht der Entwicklung ist und was Sie dafür von der Organisation bekommen.
Ein Frontend ist eine App, bei der sich die Menschen einer Organisation mit Login with appsolut anmelden. Im Studio ist jedes Frontend ein Eintrag unter „Frontends“, und jedes Frontend ist genau ein OAuth-Client.
Was bestimmt, wie ein Frontend funktioniert
Die Organisation legt das auf der Seite des Frontends im Studio fest:
- Art: „Intern“ (eine eigene Website oder mobile App der Organisation) oder „Extern“ (eine App eines Dritten, die die Organisation anbindet). Die Art wird beim Anlegen festgelegt.
- Community: Genau eine Community bedient das Frontend und entscheidet, welche Mitglieder es nutzen dürfen. Beim Pannoniqa Portal sind das „Gesamte Belegschaft“, bei der Pannoniqa App „Aktive Belegschaft“.
- Mitgliedschaft verpflichtend: standardmäßig eingeschaltet. Dann erhalten nur gültige Mitglieder der Community des Frontends ein Token; ohne diese Einstellung kann sich jeder mit einem Konto anmelden, und das Token sagt, ob er Mitglied ist.
- App-Typ: welche Art von App das Frontend ist. Er entscheidet, ob das Frontend ein Client-Secret aufbewahren kann und welche Redirect-URIs es verwenden darf.
| App-Typ | Im Studio | Was es ist |
|---|---|---|
web | „Web-App“ | Eine Website mit eigenem Backend, das das Client-Secret aufbewahrt |
spa | „Single-Page-App“ | Eine App, die nur im Browser läuft, ohne Backend |
mobile | „Mobile App“ | Eine App für iOS oder Android |
desktop | „Desktop-App“ | Eine auf einem Computer installierte App |
server | „Server“ | Ein Dienst, der sich ohne Benutzer anmeldet |
Derzeit können nur interne Web-Apps Benutzer anmelden. Das Studio zeigt die anderen App-Typen als „Später“, und die Karte „Anmeldung“ eines externen Frontends sagt, dass die Anmeldung für externe Frontends im Dezember folgt. Eine Web-App ist ein vertraulicher OAuth-Client: Sie bewahrt ihr Client-Secret und die Tokens ihrer Benutzer auf ihrem eigenen Server auf.
Was Sie von der Organisation bekommen
Ein Studio-Benutzer, der Frontends verwalten darf (die Studio-Rollen „Eigentümer“, „Administrator“ und „Frontend-Manager“), richtet das Frontend ein und übergibt Ihnen:
| Was | Woher | Wofür |
|---|---|---|
| Client-ID | Die Karte „Anmeldung“ des Frontends | Login with appsolut |
| Client-Secret | Einmal angezeigt, wenn der Anmelde-Client erstellt oder das Secret erneuert wird | Codes gegen Tokens eintauschen |
| Frontend-Schlüssel | Einmal angezeigt, wenn auf der Karte „Schlüssel“ des Frontends ein Schlüssel ausgestellt wird | Die Mitglieder-API aufrufen |
| Die ID der Organisation | Bei appsolut erfragen, mit der Client-ID; das Studio zeigt sie noch nicht an | tenant_id in Tokens prüfen |
Von Ihnen braucht die Organisation die Redirect-URIs und die Start-URL des Frontends: siehe Redirect-URIs und Start-URL.
Client-Secret und Frontend-Schlüssel sind verschiedene Geheimnisse für verschiedene Aufrufe: das Secret nur für den Token-Endpunkt, der Schlüssel nur für die Mitglieder-API. Verwenden Sie nie das eine an Stelle des anderen.
Ein abgeschaltetes Frontend
Eine Organisation kann ein Frontend trennen („Frontend trennen“). Ab dann meldet es niemanden mehr an, jede seiner Anmeldesitzungen endet, und seine Frontend-Schlüssel werden abgewiesen. Seine Einstellungen, Schlüssel und sein Anmelde-Client bleiben erhalten; wird es wieder verbunden, funktioniert beides wieder, und wer abgemeldet wurde, meldet sich erneut an. Siehe Widerruf.