InnerWeb
Zum Inhalt springen

Maschinen-Token der Integration: Empfehlungen für den Administrator

Der Maschinen-Token der Integration mit dem Qualifizierungsportal ist der Schlüssel zur Personensuche. Ist die Registrierung über den QR-Aushang aktiv, kann derselbe Token zusätzlich Konten und Firmen anlegen und Zutrittskarten ausstellen. Ein solcher Schlüssel braucht eine eigene Richtlinie mit Eigentümer, Umfang, Rotation und Überwachung. Im Folgenden die Empfehlungen für den Administrator der IT.

3
Mindestanzahl Zeichen der Suchabfrage
Quelle: Karte
8
Höchstzahl der Treffer in der Suchantwort
Quelle: Karte

Warum der Maschinen-Token eigene Aufmerksamkeit braucht

Die API für das Qualifizierungsportal verlangt einen Maschinen-Token im Header. Fehlt der Token oder ist er falsch, antwortet die API mit 401. Suchabfragen benötigen mindestens 3 Buchstaben oder Ziffern und liefern höchstens 8 Treffer. Diese Grenzen erschweren das Durchsuchen der gesamten Personendatenbank, ersetzen aber nicht den Schutz des Schlüssels selbst.

Der Token steht für keinen Menschen, deshalb gibt es keinen zweiten Faktor und keinen Anmeldebildschirm. Wer ihn besitzt, nutzt die Berechtigungen der Integration. Die Risikobewertung für den Token ist daher strenger als die für ein gewöhnliches Konto.

Empfehlung 1: den Schadensradius berechnen

Ist die Registrierung über den QR-Aushang aktiv, legt derselbe Maschinen-Token Konten und Firmen an und stellt Zutrittskarten aus. Halten Sie vor dem Einschalten dieser Funktion fest, was der Token im ungünstigsten Fall tun kann: wie viele Konten angelegt, welche Zutrittskarten ausgestellt und welche Daten gelesen werden können.

Tragen Sie das Ergebnis in das Risikoregister der IT des Werks ein. Benötigt das Werk die Registrierung über den QR-Aushang nicht, schalten Sie sie nicht nur deshalb ein, weil sie verfügbar ist: Eine kleinere Funktion bedeutet einen kleineren Schadensradius.

Grenzen der Personensuche

Grenzen der PersonensucheDiagramm: mindestens 3 Zeichen in der Suchabfrage und höchstens 8 Treffer in der Antwort02468AnzahlMindestanzahl Zeichen derSucheMindestanzahl Zeichen der Suche: 3 Anzahl3Höchstzahl Treffer in derAntwortHöchstzahl Treffer in der Antwort: 8 Anzahl8
Quelle: Karte der Zelle: Beschreibung der API für das Qualifizierungsportal

Empfehlung 2: den Schlüssel außerhalb des Browsers und des Repositorys aufbewahren

Das System folgt dem Grundsatz, dass Integrationsschlüssel nie in den Browser gelangen. Das SSO-Panel zeigt die Einstellungen nur lesend an, und das Annehmen, Ablehnen und erneute Entscheiden über einen Antrag ist auf eine einzige Verwaltungsrolle beschränkt. Wenden Sie auf Seite des Werks denselben Grundsatz an: Der Schlüssel gehört in den Geheimnisspeicher, nicht in ein Skript, eine Nachricht oder ein Projektdokument.

  • Ein Eigentümer des Tokens mit Namen und eine Vertretung.
  • Aufbewahrung im Geheimnisspeicher mit Zugriff nach Rolle.
  • Verbot, den Token per E-Mail oder Messenger zu übermitteln.
  • Rotation nach Kalender und nach jedem Wechsel einer Person mit Zugriff.

Empfehlung 3: Rollen für die Annahme von Anträgen trennen

Entscheidungen über Zugriffsanträge trifft eine einzige Verwaltungsrolle. Weisen Sie ihr eine kleine, benannte Gruppe von Personen zu und prüfen Sie diese jedes Quartal. Die Trennung zwischen der Person, die den Token verwaltet, und der Person, die Anträge annimmt, verringert das Risiko, dass ein einziges Konto die gesamte Kette kontrolliert.

Empfehlung 4: das Austauschprotokoll überwachen

Das Austauschprotokoll mit dem Portal erfasst Richtung, Ereignis, Person, Ergebnis, HTTP-Code und Uhrzeit. Das Schreiben in das Protokoll unterbricht die Hauptoperation nie. So erkennen Sie eine Serie von 401-Antworten, ungewöhnliche Abrufzeiten oder einen plötzlichen Anstieg der Suchabfragen.

Legen Sie die Alarmschwellen in Ihrem Überwachungswerkzeug fest und prüfen Sie das Protokoll nach jeder Rotation des Tokens. Ein korrektes Bild nach der Rotation ist eine kurze Serie von 401-Antworten vom alten Schlüssel, gefolgt von einer stabilen Serie an Erfolgen.

Empfehlung 5: die Rotation ohne Unterbrechung des Dienstes planen

Planen Sie die Rotation außerhalb der Spitzenzeiten der Zutritte von Fremdfirmen. Stimmen Sie mit dem Administrator des Portals den Zeitpunkt des Schlüsselwechsels und das Verfahren für den Rückzug ab. Führen Sie nach der Rotation einen Test durch: Person suchen, Antrag stellen und das Protokoll lesen.

Halten Sie den Wechsel des Schlüssels und seinen Termin im Änderungsprotokoll fest. Besteht der Verdacht auf ein Leck, tauschen Sie den Schlüssel sofort aus und beschreiben Sie das Ereignis im Vorfallprotokoll des Werks.

Videomaterial

Häufig gestellte Fragen

Was antwortet die API bei einem falschen Token?

Die Antwort 401. Ein solcher Eintrag erscheint im Austauschprotokoll mit HTTP-Code, Richtung und Uhrzeit.

Kann der Integrationsschlüssel im Panel eingesehen werden?

Nein. Schlüssel gelangen nicht in den Browser, und das SSO-Panel zeigt die Einstellungen nur lesend an.

Wer darf einen Zugriffsantrag annehmen?

Annehmen, Ablehnen und erneutes Entscheiden übernimmt eine einzige Verwaltungsrolle, die das Werk ausgewählten Personen zuweist.

Ordnen wir die Schlüssel der Integration

Gemeinsam mit Ihrer IT halten wir Umfang des Tokens, Eigentümer und Rotationsplan fest, bevor die Integration in den Produktivbetrieb geht.

Sprechen wir