Was sind Secrets? Passwörter und API-Keys sicher aufbewahren

Secrets · API-Keys · Sicherheit

Secrets sind die Passwörter deiner App. Wer sie kennt, kann in deinem Namen handeln und auf deine Rechnung einkaufen. Deshalb gehören sie nie in den Code.

Deine App hat mehr Passwörter, als du denkst

Deine App meldet sich bei vielen Diensten an. Für jeden braucht sie einen Schlüssel:

  • das Passwort für die Datenbank,
  • den Schlüssel für den Zahlungsdienst,
  • den Schlüssel für die KI-Schnittstelle.

Solche Schlüssel für Schnittstellen heißen API-Keys.

Im Code ist ein Schlüssel schnell gestohlen

Der häufigste Fehler: Der API-Key steht direkt im Code. Mit dem nächsten Push landet er im Repository.

Ist das Repository öffentlich, findet ein Bot den Schlüssel oft in wenigen Minuten. Diese Bots durchsuchen das Netz rund um die Uhr. Ein gestohlener KI-Key kann in Stunden eine hohe Rechnung erzeugen.

KI-Werkzeuge schreiben Schlüssel gern direkt in den Code. Prüfe das vor jedem Push. GitHub blockiert solche Pushes bei öffentlichen Repositories inzwischen oft automatisch. Verlass dich aber nicht darauf.

Manche Schlüssel dürfen sichtbar sein

Nicht jeder Schlüssel ist geheim. Stripe zum Beispiel gibt dir zwei:

  • Der öffentliche Schlüssel beginnt mit pk_. Er darf im Browser stehen.
  • Der geheime Schlüssel beginnt mit sk_. Er darf nur auf dem Server liegen.

Wenn du unsicher bist: Behandle jeden Schlüssel als geheim.

Umgebungsvariablen halten Schlüssel aus dem Code

Statt im Code stehen Secrets in Umgebungsvariablen. Der Code kennt dann nur einen Namen, zum Beispiel STRIPE_SECRET_KEY. Den Wert bekommt er erst beim Start.

Auf deinem Laptop liegen die Werte in einer Datei namens .env. Diese Datei schließt du von Git aus. Auf dem Server trägst du die Werte in der Oberfläche deines Anbieters ein.

Ein Secret-Manager hält Ordnung

Bei mehreren Apps oder mehreren Leuten wird es schnell unübersichtlich. Ein Secret-Manager wie Infisical oder HashiCorp Vault hilft dabei. Er erledigt drei Aufgaben:

  • Er bewahrt alle Secrets an einem Ort auf.
  • Er gibt sie deinen Apps beim Start, ohne dass sie irgendwo im Klartext stehen.
  • Er schreibt mit, wer wann welchen Schlüssel abgerufen hat.

Wird ein Schlüssel doch einmal bekannt, tauschst du ihn an einer Stelle aus. Alle Apps bekommen beim nächsten Start den neuen.

Ist ein Schlüssel öffentlich, zählt die Reihenfolge

Hast du einen Schlüssel aus Versehen veröffentlicht, geh so vor:

  1. Schlüssel sperren. Mach ihn beim Anbieter sofort ungültig.
  2. Neuen Schlüssel eintragen. Erzeuge einen neuen und trag ihn auf dem Server ein.
  3. Erst dann aufräumen. Entferne den alten Schlüssel aus dem Code.

Viele machen es andersherum und löschen zuerst den Commit. Das hilft nicht. Der Schlüssel ist längst kopiert, oft in den ersten Minuten.

Passende Anbieter findest du unter Secrets & Schlüssel.