Ein Dienst-Zugang lässt eine eigene Anwendung in deinem Namen in Aktenplatz arbeiten – mit deinen Rechten, bis zu einem Ablaufdatum, das du selbst setzt. Gedacht ist das für ein Programm, das du oder dein Haus betreibt: eine Zeiterfassung in der Werkstatt, ein Auswertungsskript, eine Anbindung an eigene Software. Du findest ihn unter Profil → Dienst-Zugänge.
Nicht zu verwechseln mit dem Schlüssel für einen KI-Assistenten: Das ist eine eigene Seite mit eigenem Zweck.
Nur für Konten mit zentraler Anmeldung
Dienst-Zugänge gibt es nur für Konten, die sich über die zentrale Anmeldung (Keycloak) anmelden. Wer sich mit Passwort anmeldet, hat dort kein Konto und bekommt keinen Dienst-Zugang. Welcher Fall bei dir gilt, erkennst du an deiner Profilseite – siehe Passwort und MFA anpassen.
1. Einen Zugang anlegen
Öffne dein Profil, wähle links Dienst-Zugänge und fülle unter Neuen Zugang anlegen drei Felder:
- Name – woran du den Zugang später wiedererkennst, zum Beispiel „Zeiterfassung Werkstatt".
- Läuft ab am – das Ablaufdatum. Vorgeschlagen sind 90 Tage; ein Datum in der Vergangenheit nimmt Aktenplatz nicht an.
- Umfang – siehe nächster Abschnitt.
Mit Zugang anlegen wirst du einmal zur Anmeldestelle geschickt und kommst danach hierher zurück. Dieser Umweg ist Absicht: Hinter dem Schlüssel steht so eine echte Anmeldung von dir, und wird dein Konto dort gesperrt, hört jeder Zugang sofort auf zu arbeiten.
2. Den Umfang wählen
- Alles, was ich darf – der Dienst kann im Rahmen deiner Rechte lesen, ändern und löschen. Ein kopierter Schlüssel ist bis zum Ablaufdatum ein vollständiger Zugang zu deinem Konto.
- Eingeschränkt – der Dienst erreicht nur einen kleinen, festgelegten Teil der Schnittstelle.
Nimm Eingeschränkt, wenn es reicht. Und setze das Ablaufdatum so kurz, wie es für den Zweck geht.
3. Den Schlüssel kopieren – nur jetzt
Nach der Rückkehr erscheint der Schlüssel in einem orangen Kasten. Er wird genau einmal angezeigt und lässt sich später nicht mehr anzeigen, auch nicht von uns. Ist er weg, legst du einen neuen an und widerrufst den alten.
Der Schlüssel gehört nicht in den Quelltext, sondern in eine Umgebungsvariable des Dienstes. Die passende Zeile dafür steht neben dem Schlüssel zum Kopieren bereit.
4. Anmeldung im eigenen Dienst
Der Dienst braucht nur zwei Angaben: die Adresse von dieser Seite und den Schlüssel. Die Anmeldestelle taucht in seiner Konfiguration überhaupt nicht auf – den Tausch erledigt Aktenplatz.
Auf der Seite stehen alle Angaben zum Kopieren: die Adresse, der Aufruf für die Anmeldung, die Kopfzeile Authorization: Bearer für jeden weiteren Aufruf und ein fertiges Beispiel für Node.js. Das Beispiel ist bewusst so gebaut, wie es gehört: Es hält das kurzlebige Token und erneuert es erst kurz vor Ablauf, statt sich bei jedem Aufruf neu anzumelden.
Diese Angaben stehen immer da, nicht nur direkt nach dem Anlegen – wer die Adresse nachschlagen will, muss dafür keinen neuen Schlüssel erzeugen.
5. Vorhandene Zugänge
Unten listet die Seite alle Zugänge deines Kontos, je Eintrag mit Name, Umfang, Ablaufdatum und „zuletzt benutzt". Dazu der Zustand:
- aktiv – arbeitet.
- abgelaufen – das Ablaufdatum ist vorbei.
- widerrufen – von dir beendet.
- von Keycloak abgelehnt – die Anmeldestelle nimmt den Zugang nicht mehr an, etwa weil dein Konto dort gesperrt wurde.
Mit dem Papierkorb-Symbol widerrufst du einen Zugang. Das beendet auch die Sitzung bei der Anmeldestelle, nicht nur den Eintrag hier.
Gut zu wissen
- Wird dein Konto gesperrt, hört jeder deiner Zugänge sofort auf zu arbeiten.
- Der Schlüssel wird genau einmal angezeigt. Geht er verloren, legst du einen neuen an.
- Sieh die Liste ab und zu durch: Ein Zugang, der nie benutzt wurde, gehört widerrufen.
