fepli
HandbuchReferenzSystem und DatenschutzAdmins

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.

ElementWirkung
SeiteIn der App API führt auch Service-Accounts verwalten hierher.
ZugangJeder Zugang hat eine eigene Seite mit seinen Schlüsseln und Aktionen.
Neuer Service-AccountLegt einen Zugang an, mit Name, Beschreibung, Rollen und Zugriff.
RollenAdmin, Super-Admin, Teilnehmer:innen, Zahlungen, Veranstalter:innen; mindestens eine, vorgewählt ist Admin. Teilnehmer:innen und Zahlungen brauchen dazu Admin oder Super-Admin.
ZugriffNur lesen oder Lesen und schreiben, vorgewählt ist Nur lesen. Bei Nur lesen darf auch kein Schlüssel des Zugangs schreiben.
Neuer API-TokenEin Schlüssel für das Programm, mit Bezeichnung, Gültig bis und Zugriff. Ohne Datum gilt er unbefristet. fepli zeigt ihn nur einmal.
AktionenBearbeiten, Deaktivieren und Aktivieren, Widerrufen je Schlüssel, Löschen unter Service-Account löschen
Deaktiviertfepli weist die Schlüssel des Zugangs ab. Neue Schlüssel lassen sich erst nach Aktivieren anlegen.
GelöschtDer 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:innenEin 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.

ElementWirkung
StatusNur 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.
FingerabdruckKennung des Schlüssels, mit dem das Programm unterschreibt, in 6 Blöcken
Schlüssel-IDKennung, die das Programm für seinen Schlüssel gewählt hat
Freigeben fürAlle 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 vergleichenStartet 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 widerrufenDas 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

MeldungBedeutung
„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.