Worum es geht
API-Tokens, Bot-Zugänge und Passwörter gehören regelmäßig erneuert, und spätestens nach einem Verdacht auf Missbrauch sofort. Bei einer Pipeline mit mehreren Komponenten ist das heikel: Collector, Klassifikation und Dispatcher nutzen womöglich denselben Schlüssel. Wird er getauscht, während ein Dienst noch den alten verwendet, schlägt dessen nächster Aufruf fehl.
Das Ziel ist eine Rotation, bei der zu keinem Zeitpunkt ein Dienst ohne gültigen Schlüssel dasteht.
Das Grundprinzip: zwei gültige Schlüssel
Der Trick ist eine Phase, in der alter und neuer Schlüssel gleichzeitig funktionieren. Die Reihenfolge lautet:
- Neuen Schlüssel beim Anbieter erzeugen, den alten noch nicht anfassen.
- Neuen Schlüssel an der zentralen Stelle ablegen, aus der die Dienste ihn lesen.
- Dienste umschalten, per Reload oder Neustart, und prüfen, dass sie mit dem neuen Schlüssel arbeiten.
- Erst danach den alten Schlüssel beim Anbieter widerrufen.
Nicht jeder Anbieter erlaubt zwei aktive Schlüssel. Wo das nicht geht, ist ein kurzes Fenster unvermeidlich, und du solltest es bewusst in eine ruhige Zeit legen und die Dienste für diese Minuten anhalten.
Secrets zentral und außerhalb des Codes ablegen
Damit ein Wechsel an einer Stelle reicht, gehören Secrets in eine Umgebungsdatei oder einen Secrets-Manager, nicht in den Quellcode und nicht in mehrere Kopien. Die Datei sollte nur für den ausführenden Benutzer lesbar sein.
install -m 600 -o pipeline -g pipeline /dev/null /etc/pipeline/env
Die Dienste lesen die Datei über EnvironmentFile= in der Unit oder beim Start des Skripts. Nach einer Änderung braucht es einen Neustart oder Reload, denn laufende Prozesse behalten ihre alten Umgebungsvariablen.
Beide Schlüssel im Code unterstützen
Eine robuste Variante ist ein Client, der einen primären und einen Ausweichschlüssel kennt. Fällt der primäre Schlüssel mit einem Authentifizierungsfehler durch, probiert er den zweiten.
import os
import logging
import requests
log = logging.getLogger("secrets")
def keys() -> list[str]:
found = [os.environ.get("API_KEY_NEW"), os.environ.get("API_KEY_OLD")]
return [k for k in found if k]
def call(url: str) -> requests.Response:
last = None
for key in keys():
r = requests.get(url, headers={"Authorization": f"Bearer {key}"},
timeout=10)
if r.status_code not in (401, 403):
return r
log.warning("Schlüssel abgelehnt, versuche den nächsten")
last = r
if last is None:
raise RuntimeError("Kein Schlüssel konfiguriert")
return last
Während der Rotation stehen beide Variablen in der Datei. Nach dem Widerruf des alten Schlüssels entfernst du API_KEY_OLD.
Prüfen, bevor du widerrufst
Widerrufe den alten Schlüssel erst, wenn du sicher bist, dass kein Dienst ihn noch braucht. Ein einfacher Test ist ein Request pro Komponente mit dem neuen Schlüssel und ein Blick ins Log auf Authentifizierungsfehler. Bei mehreren Diensten lohnt sich ein kleiner Prüfbefehl, der jeden Zugang einzeln testet und das Ergebnis ausgibt.
Auch der Heartbeat hilft: Bleibt die tägliche Statusmeldung nach dem Umschalten aus, hat ein Dienst den neuen Schlüssel nicht übernommen.
Häufige Fehler
- Nur eine Datei angepasst, während eine Kopie in einem anderen Verzeichnis weiterläuft. Suche nach dem alten Schlüsselwert, bevor du widerrufst.
- Dienst nicht neu gestartet und daher noch mit dem alten Wert unterwegs.
- Neuen Schlüssel in ein Git-Repository eingecheckt. Halte Secret-Dateien aus der Versionsverwaltung heraus.
- Alten Schlüssel vergessen zu widerrufen. Ein nicht widerrufener Schlüssel bleibt ein Risiko.
Wann sich das lohnt (und wann nicht)
Der Aufwand lohnt sich, sobald mehr als ein Dienst denselben Zugang nutzt oder ein Ausfall spürbar wäre. Eine feste Checkliste und zentral abgelegte Secrets machen jede spätere Rotation zur Routine.
Für ein einzelnes Skript mit einem Token, dessen kurzer Ausfall niemanden stört, genügt das einfache Verfahren: neuen Schlüssel eintragen, Dienst neu starten, alten widerrufen. Ein Ausweichschlüssel im Code wäre dort Überbau.