Neu: Die KI-Firewall überwacht die gesamte Plattform und erklärt jeden Vorfall in einfachen Worten. So funktioniert es

Wie API-Schlüssel in Geräte- und Integrationscode sicher gespeichert werden

API-Schlüssel leaken über ihre Kopien: URLs in Logs, eingecheckte Konfigurationsdateien, Firmware auf jedem Gerät. Eine Regel für jeden Ort, mit den dahinterstehenden Standards.

Um API-Schlüssel sicher zu speichern, halten Sie sie aus allem heraus, was kopiert wird: Quellcode, Repositories, Firmware-Images, URLs und Logs. Lesen Sie jeden Schlüssel zur Laufzeit aus einem Secret Store oder aus einer Datei, die nur der Dienst lesen kann, vergeben Sie die kleinstmögliche Menge an Berechtigungen und seien Sie bereit, ihn zu widerrufen und zu ersetzen.

Ein Schlüssel leckt über seine Kopien, daher betrifft jede der folgenden Regeln die Frage, wo eine Kopie landet.

Wo der Schlüssel liegtWie er kopiert wirdRegel
Ein URL-Query-StringBrowserverlauf, Server- und Proxy-LogsIn einem Header senden, über TLS
Quellcode und RepositoriesJeder Clone und die HistorieZur Laufzeit lesen; widerrufen, falls er committet wurde
UmgebungsvariablenAndere Prozesse, Logs, SystemabbilderEinen Secret Store oder eine geschützte Datei bevorzugen
Firmware-ImagesJedes mit dem Image geflashte GerätEin Credential pro Gerät, keine externen API-Schlüssel

Ist es sicher, einen API-Schlüssel in eine URL zu schreiben?

Nein. Der Standard für OAuth-Bearer-Token, RFC 6750, besagt, dass Bearer-Token nicht in Seiten-URLs übergeben werden sollten, weil Browser, Webserver und andere Software URLs im Browserverlauf, in Server-Logs und in anderen Datenstrukturen möglicherweise nicht ausreichend schützen.

Ein API-Schlüssel im Query-String liegt an denselben Stellen offen, daher gilt für mich dieselbe Regel: Den Schlüssel in einen Request-Header legen und nur über TLS senden, was RFC 6750 für Bearer-Token vorschreibt. Akzeptiert ein Dienst seinen Schlüssel nur als Query-Parameter, betrachte ich diesen Schlüssel als halb offengelegt und vergebe die engsten verfügbaren Berechtigungen.

Sollten API-Schlüssel in Umgebungsvariablen stehen?

Sie sind besser als Quellcode, aber nur eine Notlösung. Das OWASP Secrets Management Cheat Sheet besagt, dass Umgebungsvariablen allgemein allen Prozessen zugänglich sind und in Logs oder Systemabbilder gelangen können, und empfiehlt sie nur, wenn andere Methoden nicht möglich sind.

In Integrationscode lese ich den Schlüssel beim Start aus einem Secret Store oder einer Datei, die nur das Dienstkonto lesen kann, und protokolliere die geladene Konfiguration niemals. Eine Entwicklungsdatei .env bleibt außerhalb des Repositories. Sobald ein Schlüssel committet ist, befindet er sich in jedem Clone und in der Historie.

Wie halten Sie Credentials aus der Firmware heraus?

Kompilieren Sie sie nicht ein. Die Basisnorm für Consumer-IoT, ETSI EN 303 645, besagt, dass fest codierte kritische Sicherheitsparameter im Quellcode der Gerätesoftware nicht verwendet werden dürfen, weil Reverse Engineering Credentials, einschließlich API-Schlüssel, leicht finden kann und einfache Verschleierung problemlos zu brechen ist.

Industriegeräte fallen nicht in den Geltungsbereich dieser Norm, doch das Argument gilt auch auf dem Shopfloor. Geben Sie jedem Gerät bei der Inbetriebnahme ein eigenes Credential, bewahren Sie es in geschütztem Speicher auf und liefern Sie ein einziges Firmware-Image aus, das kein Geheimnis enthält, sodass ein von einem Gerät entwendetes Credential nur dieses eine Gerät öffnet (mehr dazu: warum gemeinsame Passwörter nicht skalieren). Ein Sensor sollte überhaupt keinen Schlüssel für eine externe API besitzen: Er sendet Daten an Ihre Plattform, und der Server ruft das externe System auf (siehe wie ein anderes System von neuen Gerätedaten erfahren sollte).

Hermetry verbindet Feldgeräte mit Live-Dashboards, Regeln und Alarmen: IoT-Telemetrie und SCADA in einer Plattform. In seinen Automatisierungsabläufen kennt ein Block, der ein externes System aufruft, weder Adresse noch Passwort selbst; er verweist auf eine Verbindung, und der HTTP-Request-Block bezieht Schema, Host, Port, Authentifizierung und TLS ausschließlich aus dieser Verbindung, nie aus der Nachricht. Geheimnisse in Verbindungen werden verschlüsselt gespeichert, lassen sich nach dem Speichern nicht mehr auslesen und gelangen nie in Nachrichten, Ausführungsprotokolle, Logs, das Audit-Log oder Exporte, weshalb ein importierter Ablauf seine Geheimnisse erneut eingegeben bekommen muss.

Begrenzen Sie jeden Schlüssel auf eine Integration und einen Job (siehe Least Privilege für Personen, Programme und Geräte). Ein Schlüssel pro Integration zeigt, was ein Leck offenlegt, und erlaubt es, ihn zu widerrufen, ohne alles andere anzuhalten.

Häufig gestellte Fragen

Was sollte ich tun, wenn ein API-Schlüssel in einem Repository committet wurde?

Widerrufen Sie ihn zuerst. Das OWASP Secrets Management Cheat Sheet nennt als Reihenfolge der Eindämmung: Widerruf des offengelegten Schlüssels, dann Rotation auf ein neues Geheimnis, dann Entfernen des widerrufenen Geheimnisses aus Code und Logs. Die Historie allein umzuschreiben hilft nicht, weil Clones und Forks den alten Commit möglicherweise bereits enthalten.

Wie oft sollten API-Schlüssel rotiert werden?

OWASP empfiehlt, Geheimnisse regelmäßig zu rotieren, damit ein gestohlenes Credential nur kurze Zeit funktioniert, und die Rotation nach Möglichkeit zu automatisieren, da manuelle Rotation schwierig ist und zu Fehlern führen kann. Wählen Sie ein Intervall, das Ihre Integration ohne Ausfall verkraftet, und rotieren Sie sofort, wenn ein Schlüssel möglicherweise geleakt ist.

Reicht es, einen Schlüssel in der Firmware zu verschlüsseln?

Nein, wenn das Gerät ihn selbst entschlüsseln kann. ETSI EN 303 645 merkt an, dass einfache Verschleierungsmethoden, mit denen fest codierte Informationen verborgen oder verschlüsselt werden, problemlos zu brechen sind. Kann das Gerät den Schlüssel ohne fremde Hilfe wiederherstellen, kann ihn auch jeder, der seine Firmware extrahiert.

Teilen

Sehen Sie diese Woche Ihre Felddaten live

Starten Sie eine Testphase in Ihrer Region mit Ihren ersten Geräten oder buchen Sie eine Demo und bringen Sie Ihren eigenen Anwendungsfall mit.