Service-Accounts
Wenn ein anderes Programm über die Schnittstelle von fepli arbeiten soll, etwa ein Anmeldeportal Ihrer Kommune, braucht es einen eigenen Zugang. Diesen Zugang nennt fepli Service-Account.
Super-Admins finden die Zugänge unter Einstellungen > Integrationen. Die Schnittstelle selbst schaltet die App API ein. Wie ein Programm angebunden wird, zeigt das Tutorial API anbinden.
Zugang anlegen und verwalten
Ein Zugang gehört keiner Person. Er hat Rollen wie ein Konto des Teams und einen oder mehrere Schlüssel, mit denen sich das Programm anmeldet.
| Element | Wirkung |
|---|---|
| Seite | In der App API führt auch Service-Accounts verwalten hierher. |
| Zugang | Jeder Zugang hat eine eigene Seite mit seinen Schlüsseln und Aktionen. |
| Neuer Service-Account | Legt einen Zugang an, mit Name, Beschreibung, Rollen und Zugriff. |
| Rollen | Admin, Super-Admin, Teilnehmer:innen, Zahlungen, Veranstalter:innen; mindestens eine, vorgewählt ist Admin. Teilnehmer:innen und Zahlungen brauchen dazu Admin oder Super-Admin. |
| Zugriff | Nur lesen oder Lesen und schreiben, vorgewählt ist Nur lesen. Bei Nur lesen darf auch kein Schlüssel des Zugangs schreiben. |
| Neuer API-Token | Ein Schlüssel für das Programm, mit Bezeichnung, Gültig bis und Zugriff. Ohne Datum gilt er unbefristet. fepli zeigt ihn nur einmal. |
| Aktionen | Bearbeiten, Deaktivieren und Aktivieren, Widerrufen je Schlüssel, Löschen unter Service-Account löschen |
| Deaktiviert | fepli weist die Schlüssel des Zugangs ab. Neue Schlüssel lassen sich erst nach Aktivieren anlegen. |
| Gelöscht | Der Zugang und alle seine Schlüssel sind gelöscht. Programme verlieren sofort den Zugang. |
| Namen im Verlauf | Ändert ein Programm Angebote, Anmeldungen oder Belege, steht im Verlauf „{Name} (Service-Account)“ mit dem Namen von damals. Legt es eine Anmeldung an, gilt sie als vom Team angelegt. |
| Erklärung der Veranstalter:innen | Ein Programm kann die Erklärung nicht bestätigen. Verlangt die Saison sie, lehnt fepli seine Einladungen an neue Veranstalter:innen ab. |
Verschlüsselte Daten
Bei einer Instanz mit Verschlüsselung sieht ein Programm die Namen der Teilnehmer:innen nur als Pseudonym, also als Ersatznamen aus 4 Zeichen. Die echten Namen liest es erst mit einem eigenen Schlüssel, den ein Super-Admin bestätigt.
Dafür zeigt die Seite eines Zugangs mit der Rolle Teilnehmer:innen den Abschnitt Verschlüsselung. Wie das Programm seinen Schlüssel anmeldet, beschreiben die fepli developers.
| Element | Wirkung |
|---|---|
| Status | Nur Pseudonyme: Das Programm hat keinen eigenen Schlüssel. Wartet: Der Schlüssel ist angemeldet, aber noch nicht bestätigt. Aktiv: Der Schlüssel ist bestätigt. |
| Fingerabdruck | Kennung des Schlüssels, mit dem das Programm unterschreibt, in 6 Blöcken |
| Schlüssel-ID | Kennung, die das Programm für seinen Schlüssel gewählt hat |
| Freigeben für | Alle Teilnehmenden oder Kinder von {Veranstalter-Profil}. Ist der Schlüssel bestätigt, stehen dort Liest und Bestätigt von mit dem Namen des Super-Admins. |
| Emojis vergleichen | Startet den Vergleich. Wer das Programm betreut, startet dort zur selben Zeit seinen Teil. Beide prüfen, ob dieselben Emojis in derselben Reihenfolge erscheinen. |
| Schlüssel widerrufen | Das Programm verliert sofort den Zugang zu allen Namen. Was es schon gelesen hat, kann es behalten. Ein neuer Schlüssel braucht einen neuen Vergleich. |
- Bis zum Emoji-Vergleich verschlüsselt fepli nichts für den Schlüssel.
- Ist er bestätigt, gibt ein entsperrter Browser des Teams neue Datensätze im Hintergrund für ihn frei.
- Löschen des Zugangs widerruft den Schlüssel ebenso.
- Das Protokoll der Betroffenenrechte verzeichnet Schlüssel einer Integration freigegeben und Schlüssel einer Integration widerrufen.
Die Schritte stehen unter Integration Zugang zu verschlüsselten Daten geben.
Meldungen
| Meldung | Bedeutung |
|---|---|
| „Teilnehmer:innen und Zahlungen setzen die Rolle Admin voraus. Wählen Sie auch Admin.“ | Wählen Sie zu Teilnehmer:innen oder Zahlungen auch Admin oder Super-Admin. |
| „Der Service-Account ist deaktiviert.“ | Das Programm kann sich nicht anmelden, bis Sie Aktivieren wählen. |