InnerWeb
Zum Inhalt springen

Technisches Konto der Integration und Rechte: Empfehlungen

Ein Integrator, der Daten aus dem System abrufen soll, sollte kein Mitarbeiterkonto verwenden. Ein technisches Konto mit klar begrenztem Umfang ist sicherer, leichter zu prüfen und verschwindet nicht mit dem Weggang einer Person. Im Folgenden sechs Empfehlungen für die IT-Abteilung und den Administrator der Anwendung, begründet mit der Funktionsweise der Maschinen-Tokens in den Integrationen von InnerWeb.

4
Antwortcodes der Schnittstelle für Anträge auf Zugang
Quelle: karta
30 Tage
Zeitfenster des Status expiring für Unterweisungen
Quelle: karta

Warum kein Mitarbeiterkonto

Ein Mitarbeiterkonto ist an die Person gebunden: an ihre Rolle, ihr Passwort, den zweiten Faktor der Anmeldung und den Zyklus des Arbeitsverhältnisses. Eine Integration, die auf einem solchen Konto beruht, funktioniert am Tag des Weggangs der Person oder bei einer Passwortänderung nicht mehr, und im Ereignisprotokoll lässt sich kaum unterscheiden, ob ein Mensch oder ein Automat gehandelt hat.

Ein technisches Konto löst diese drei Probleme gleichzeitig. Es hat einen Verantwortlichen auf Seiten der IT, einen begrenzten Umfang und eine eigene Spur im Protokoll. Die Integrationen von InnerWeb (Personen-API, Anträge auf Zugang, Poller der Webhooks) verwenden Maschinen-Tokens und unterstützen dieses Modell daher von selbst.

Empfehlungen 1 bis 3: Umfang und Trennung

Die ersten drei Empfehlungen betreffen, was das Konto tun darf und wofür es dient.

1. Ein Konto je Integration

Poller der Webhooks, Portal der Zugangsanträge und die API der Person sollten getrennte Zugangsdaten haben. Ein Leck oder die Rotation eines einzelnen Tokens stoppt die übrigen Integrationen nicht, und das Protokoll zeigt eindeutig, welche Integration den Aufruf ausgeführt hat.

2. Kleinstmöglicher Umfang

Der Poller braucht nur das Abrufen wartender Einträge und das Bestätigen von Zustellungen, nichts darüber hinaus. Das Portal der Anträge sendet Anträge und empfängt Entscheidungen. Daten zu Berechtigungen, Unterweisungen und Untersuchungen werden nur übernommen, wenn der Umfang der Einwilligung sie abdeckt. Der Umfang sollte sich daher aus der Einwilligung der Person ergeben und nicht aus der Bequemlichkeit des Integrators.

3. Konto der Integration von der Entscheidungsrolle trennen

Annahme, Ablehnung und erneute Entscheidung bei Anträgen auf Zugang stehen ausschließlich der Rolle des Dienstadministrators zur Verfügung. Das Panel sehen außerdem der Administrator und die Arbeitssicherheit. Das technische Konto sollte diese Rolle nicht tragen. Entscheidungen über den Zugang bleiben bei einem Menschen.

Empfehlungen 4 bis 6: Lebenszyklus und Aufsicht

Vierte Empfehlung: Benennen Sie auf Seiten des Werks einen IT-Verantwortlichen für das Konto. Der Verantwortliche entscheidet über Rotation, Außerbetriebnahme und die Überprüfung des Umfangs einmal im Jahr oder bei einem Wechsel des Integrators. Ein Konto ohne Verantwortlichen ist die häufigste Ursache für vergessene Zugänge.

Fünfte: Planen Sie die Reaktion auf Antwortcodes. Ein Antrag auf Zugang wird über die Schnittstelle mit einem Maschinen-Token entgegengenommen und liefert 201 für einen neuen Antrag, 200 für die Wiederholung derselben Kennung, 400 für fehlerhafte Daten und 401 bei fehlendem oder falschem Token. Der Integrator sollte bei einer Serie von 401-Codes Alarm schlagen, denn das bedeutet ein abgelaufenes oder entwertetes Token. Ein in der API der Person gelöschtes Konto liefert 404.

Sechste: Übertragen Sie Schlüssel weder in den Browser noch in Skripte der Administratoren. Im SSO-Panel sind die Einstellungen nur lesbar, und Schlüssel gelangen nicht in den Browser. Dasselbe Muster gilt auf Seiten des Integrators: Zugangsdaten im Geheimnis-Manager, nicht in einer Datei auf dem Desktop.

Wie eine gute Übergabe des Kontos an den Integrator aussieht

Die Übergabe sollte die Form eines kurzen Protokolls haben: Name der Integration, Umfang, Verantwortlicher auf Seiten der IT, Datum der Überprüfung und Verfahren für die Außerbetriebnahme. So bleibt der Integrator nach Projektende nicht mit einem unbefristeten Zugang zurück.

Bei der Abnahme prüfen Sie im Protokoll des Austauschs, dass die Aufrufe die erwartete Richtung, das Ergebnis und den HTTP-Code haben. Das Protokoll erfasst die Ereignisse des Austauschs, und sein Schreiben wirft nie eine Ausnahme. Ein Ausfall des Protokolls stoppt die Integration daher nicht, es sollte aber regelmäßig durchgesehen werden.

Videomaterial

Häufig gestellte Fragen

Kann das technische Konto Anträge auf Zugang annehmen?

Es sollte das nicht können. Annahme, Ablehnung und erneute Entscheidung sind ausschließlich der Rolle des Dienstadministrators vorbehalten. Entscheidungen über den Zugang bleiben bei einem Menschen.

Was bedeutet eine Serie von Antworten 401?

Ein fehlendes oder falsches Token. Meist ist es abgelaufen oder wurde entwertet, daher sollte der Integrator dies dem Verantwortlichen des Kontos melden.

Wie oft sollte der Umfang des Kontos geprüft werden?

Einmal im Jahr und bei jedem Wechsel des Integrators oder des Umfangs der Integration.

Übergabe der Integration ohne Risiko

Fragen Sie nach der Vorlage des Übergabeprotokolls für das technische Konto und nach der Liste der Umfänge für Ihre Integration.

Sprechen wir