Für wen diese Empfehlungen gedacht sind
Die Empfehlungen richten sich an die IT- oder OT-Administration des Werks, die für die Installation von InnerWeb und ihre Integrationen verantwortlich ist. Sie betreffen drei Elemente: den Maschinen-Token, der den Endpunkt der Arbeitshistorie schützt, die Schlüssel zur Prüfung der Identität und den Identitäts-Token aus dem Portal bei der Anmeldung.
Jedes Element hat eine andere Rolle. Der Maschinen-Token öffnet den Lesezugriff auf die Arbeitshistorie für das Portal. Der Satz öffentlicher Schlüssel des Ausstellers erlaubt die Prüfung der Signatur. Der Identitäts-Token belegt, dass das Portal die Person bestätigt hat. Werden diese Rollen verwechselt, entsteht eine Lücke, die im Funktionstest nicht sichtbar ist.
Empfehlung 1: ein leerer Token bedeutet einen geschlossenen Endpunkt
Der Endpunkt der Arbeitshistorie ist ausschließlich durch den Maschinen-Token im Header geschützt. Ein leerer Token auf der Serverseite bedeutet, dass eine Installation ohne aktivierte Integration nichts freigibt. Das ist eine gute Nachricht für Werke, die sich dem Portal noch nicht öffnen: Fehlt die Konfiguration, ist der Zustand sicher.
Wir empfehlen daher, den Token nicht vorsorglich einzutragen. Setzen Sie ihn erst am Tag der Inbetriebnahme der Integration und notieren Sie das Datum, damit sich die Rotation planen lässt. Prüfen Sie vor dem Start, dass ein Aufruf ohne Token abgewiesen wird.
Empfehlung 2: der Token nur im Header, niemals in der Adresse
Der Maschinen-Token wird nicht in der URL angenommen, weil Adressen in Zugriffsprotokolle des Servers, in Proxys und in Überwachungswerkzeuge gelangen. Ein Token im Protokoll ist ein Token, der jedem mit Zugriff auf die Protokolle bekannt ist.
Stellen Sie bei der Konfiguration auf Seite des Portals sicher, dass die Aufrufe den Token im Header senden. Nehmen Sie in die Checkliste eine Prüfung der Zugriffsprotokolle nach der ersten Arbeitswoche auf: Darin darf kein Parameter mit dem Token stehen.
Empfehlung 3: die Prüfung des Identitäts-Tokens vollständig durchführen
Der Identitäts-Token aus dem Portal wird mit einer RS256-Signatur geprüft. Der Schlüssel wird ausschließlich aus dem öffentlichen Schlüsselsatz des Ausstellers bezogen, und geprüft werden außerdem Aussteller, Empfänger, Gültigkeitszeitraum und ein einmalig verwendeter Nonce-Wert. Keines dieser Elemente darf für Testkomfort im Produktivbetrieb abgeschaltet werden.
Für die IT bedeutet das zwei Dinge. Sorgen Sie dafür, dass der Server des Werks Zugriff auf den öffentlichen Schlüsselsatz des Ausstellers hat, und dass die Uhrzeit auf dem Server synchronisiert ist, denn die Gültigkeitsprüfung hängt von der Uhr ab. Eine Abweichung von wenigen Minuten kann korrekte Anmeldungen ablehnen und wird häufig mit einem Ausfall des Portals verwechselt.
- RS256-Signatur mit einem Schlüssel aus dem öffentlichen Satz des Ausstellers.
- Prüfung von Aussteller und Empfänger.
- Prüfung des Gültigkeitszeitraums.
- Einmalig verwendeter Nonce-Wert.
Empfehlung 4: die Rotation des Tokens umfasst die Registrierung per Plakat
Bei aktivierter Registrierung per Plakat kann der Maschinen-Token des Portals Konten und Firmen anlegen und Zugangskarten ausstellen. Das ist ein größerer Umfang als das bloße Lesen der Arbeitshistorie. Rotation des Tokens und Risikobewertung müssen daher auch diesen Umfang abdecken.
Wir empfehlen, den Token wie einen Schlüssel mit Administratorrechten im Bereich der Auftragnehmer zu behandeln: im Geheimnisspeicher aufbewahren, den Kreis der Personen mit Zugriff begrenzen und eine regelmäßige Rotation zusammen mit einem Notfallverfahren nach einem vermuteten Leck planen. Über die Rotationsfristen entscheidet der Verantwortliche für Sicherheit im Werk.
Empfehlung 5 und 6: Anmeldung über den Standardweg und Nachweise in den Protokollen
Die Anmeldung über das Portal läuft über den Standardweg des Werks. Daher wirkt die Zwei-Faktor-Prüfung, und gesperrte, deaktivierte, gelöschte oder abgelaufene Konten werden genauso abgewiesen wie bei einer Anmeldung mit Passwort. Legen Sie keine Ausnahmen für Auftragnehmer an und umgehen Sie diesen Weg nicht aus Bequemlichkeit.
Bewahren Sie für die Prüfung Nachweise auf: das Datum der Token-Einrichtung, das Datum der letzten Rotation, das Ergebnis des Tests mit abgewiesenem Aufruf ohne Token und den Eintrag über die Durchsicht der Protokolle. Das Panel der Integration zeigt Fehler der letzten 7 Tage, was hilft, Auffälligkeiten zu erkennen, die Durchsicht der Serverprotokolle aber nicht ersetzt.
Empfehlung 7: Test vor der Öffnung
Führen Sie vor der Öffnung des Werks für das Portal einen kurzen Abschlusstest durch: einen Aufruf ohne Token, mit falschem Token und mit gültigem Token, eine Anmeldung mit einer Person, deren Konto gesperrt ist, sowie eine Anmeldung mit abgelaufenem Identitäts-Token. Jeder der fünf Fälle muss die erwartete Ablehnung oder Zustimmung liefern.
Halten Sie die Ergebnisse im Inbetriebnahmeprotokoll fest. Dasselbe Dokument zeigt in einem Jahr dem Prüfer, dass die Zugriffskontrolle der Integration geprüft und nicht nur behauptet wurde.
Checkliste
Videomaterial
Häufig gestellte Fragen
Darf ich den Token in der Adresse übergeben, wenn das Portal das so möchte?
Nein. Der Token wird nicht in der Adresse angenommen, weil Adressen in die Zugriffsprotokolle gelangen. Senden Sie ihn im Header.
Was prüft der Server beim Identitäts-Token?
Die RS256-Signatur mit dem Schlüssel aus dem öffentlichen Satz des Ausstellers, den Aussteller, den Empfänger, den Gültigkeitszeitraum und den einmalig verwendeten Nonce-Wert.
Wer entscheidet über den Rotationszeitraum des Tokens?
Der Verantwortliche für Sicherheit im Werk. Die Dokumentation beschreibt den Umfang des Risikos, der Zeitraum ergibt sich aber aus der Richtlinie des Werks.
Quellen
Sprechen wir über das Auftragnehmerportal in Ihrem Werk
Wir zeigen an einem Live-Beispiel, wie der Antrag eines Auftragnehmers beim Bediener ankommt und wie das Werk die volle Kontrolle über den Zutritt zum Gelände behält.
Sprechen wir