Projekte & Entwicklung
Geheimnisse im Entwicklungsteam: API-Schlüssel nicht im Code und Sperren bei einem Leak
Fortgeschrittene | 4 Whiteboard-Seiten · Aufgabenboard mit 5 Spalten (4 Hauptaufgaben, 12 Teilaufgaben)
Fortgeschrittene: Namen von Methoden kommen vor, die wichtigsten Punkte werden aber auf dem Whiteboard erklärt. Orientieren Sie sich an den Ausfüllbeispielen und füllen Sie es aus, während Sie überlegen, was zu Ihrer Situation passt.
Dieses Board hilft einem Entwicklungsteam, API-Schlüssel, Datenbankpasswörter und private Zertifikatsschlüssel aus Code, Chat und Tickets herauszuhalten. Dazu gehören ein Speicherort pro Umgebung und die Schritte zum Sperren und Ersetzen eines offengelegten Werts. Seite 2 prüft drei Fallen, nämlich Werte in der Commit-Historie, in Bildschirmfreigaben und Logs sowie in der Konfiguration privater Rechner. Ein einmal committeter Wert gilt als offengelegt und wird beim Herausgeber gesperrt, bevor man die Historie umschreibt. Die Ursachen suchen Sie mit der 5-Why-Methode, und ein Rotationsplan zeigt, wie Sie prüfen, was beim Wechsel ausfällt, damit kein alter Schlüssel aus Angst weiterläuft. Merkbare Login-Passwörter ändern Sie nicht nach Kalender, sondern nach einem Leak oder bei Zweifeln. Das Whiteboard hat 4 Seiten, das Aufgabenboard 5 Spalten mit 4 Hauptaufgaben und 12 Teilaufgaben.
Mit einem kostenlosen Konto können Sie diese Vorlage aus dem Marktplatz kopieren
Whiteboard-Vorschau
Whiteboard-Inhalt als Text lesen
Geheimnisse im Entwicklerteam
Anleitung (4 Seiten): ① Geheimnisse erfassen und Streuorte notieren (Bereiche①–⑤) → ② Ablageorte je Umgebung festlegen und Fallen prüfen (Bereiche⑥–⑨) → ③ Ursachen ergründen und Schutz festlegen (Bereiche⑩–⑭) → ④ Ablauf bei Leaks und Rotationsplan erstellen (Bereiche⑮–⑰)
1/4 Geheimnisse erfassen
① Ziel und Umfang (hier zuerst schreiben)
- Ziel z. B. API-Schlüssel und Passwörter aus Code und Chat entfernen und bei einem Leak binnen 30 Minuten sperren können
- Umfang z. B. Zahlung, Mailversand und Datenbank in 2 Repositories
- Zeitraum und Koordination z. B. 2 Wochen. Die Entwicklungsleitung koordiniert, geprüft wird im Team aufgeteilt
② Liste der Geheimnisse (eine Zeile je Geheimnis, nie der Wert selbst)
| Verwendung | Aktueller Ablageort | Verantwortlich | Zuletzt gewechselt | |
|---|---|---|---|---|
| Zahlungs-API-Schlüssel | z. B. Bestellabwicklung in Produktion | z. B. Umgebungsvariable auf dem Server | z. B. Entwicklungsleitung | z. B. unbekannt (nicht dokumentiert) |
| DB-Passwort | z. B. Produktions- und Test-App | z. B. fest in der Konfigurationsdatei | z. B. Infrastruktur-Team | z. B. über ein Jahr her |
| Privater Zertifikatsschlüssel | z. B. Produktions-Webserver | z. B. Datei auf dem Server | z. B. Infrastruktur-Team | z. B. vor Ablauf der letzten Frist erneuert |
| Mailversand-Schlüssel | z. B. Versand von Benachrichtigungen | z. B. im Chat stehen geblieben | z. B. nicht festgelegt | z. B. seit der Erstellung nie gewechselt |
③ Streuung: Code und Konfiguration
- z. B. Ein API-Schlüssel steht fest im Testcode
- z. B. Die Beispiel-Konfigurationsdatei enthält echte Werte
- Notieren Sie den Fund als „Dateiname, Art des Werts“
④ Streuung: Chat und Tickets
- z. B. In einem Ticket zu einer Anleitung steht ein Passwort
- z. B. Im Chat wurde ein Wert mit „nimm diesen Schlüssel“ eingefügt
- Notieren Sie Ort und ungefähren Zeitpunkt
⑤ Streuung: private Rechner
- z. B. Eine heruntergeladene Zertifikatsschlüssel-Datei liegt auf dem Desktop
- z. B. Das Zertifikatspasswort steht in einer Notiz-App
- Notieren Sie, wessen Rechner und welcher Wert
2/4 Ablageorte festlegen
⑥ Regeln je Umgebung (wohin die Geheimnisse aus ② ziehen)
| Entwicklung | Test | Produktion | |
|---|---|---|---|
| Ablageort | z. B. Konfigurationsdatei auf dem eigenen Rechner (nur Entwicklungswerte) | z. B. Dienst zur Verwaltung von Geheimnissen | z. B. Dienst zur Verwaltung von Geheimnissen |
| Wer darf lesen | z. B. Das ganze Entwicklungsteam | z. B. Entwicklungsteam und Testverantwortliche | z. B. Zwei Personen aus dem Betrieb und die Anwendung |
| Übergabe | z. B. Jeder holt es aus dem Verwaltungsdienst | z. B. Wird beim Deployment automatisch geladen | z. B. Wird zur Laufzeit geladen und nie angezeigt |
| Nie ablegen in | z. B. Code, Chat, Tickets | z. B. Code, Chat, Tickets | z. B. Code, Chat, Tickets, private Rechner |
⑦ Falle: Ein committeter Wert bleibt in der Historie
- Was passiert: z. B. Auch nach dem Löschen aus der Datei bleibt der Wert in alten Commits und jeder mit Zugriff aufs Repository kann ihn lesen
- Prüfen: z. B. Per Repository-Suche oder Secret-Scanner prüfen, ob ein Geheimnis aus ② schon einmal committet wurde
- Gegenmittel: z. B. Committete Werte als offengelegt behandeln und beim Herausgeber sperren und ersetzen, bevor man die Historie umschreibt
- Ergebnis: z. B. 2 Repositories geprüft, 1 Fund → nach dem Ablauf ⑮ ersetzt
⑧ Falle: Sichtbar auf dem Bildschirm und in Logs
- Was passiert: z. B. Bildschirmfreigabe, Screenshot, Fehlerlog oder Debug-Ausgabe zeigen den Wert im Klartext
- Prüfen: z. B. In den Einstellungen und in der Log-Ausgabe prüfen, ob geheime Felder maskiert sind
- Gegenmittel: z. B. Vor dem Schreiben ins Log maskieren und Konfigurationsdateien vor einer Freigabe schließen
- Ergebnis: z. B. Im Fehlerlog stand das Passwort neben dem Datenbank-Host → Maskierung ergänzt
⑨ Falle: Konfigurationsdatei auf privatem Rechner
- Was passiert: z. B. Ein Produktionswert bleibt in der Konfiguration eines privaten Rechners und ist nach Verlust oder Versetzung noch nutzbar
- Prüfen: z. B. Die Besitzer der Rechner aus ⑤ und die Verantwortlichen aus ② fragen, ob ein Produktionswert in einer Entwicklungsdatei liegt, und in der Konsole des Herausgebers Name, Notiz und Nutzungsprotokoll des Schlüssels ansehen (welche Angaben sichtbar sind, hängt vom Dienst ab)
- Gegenmittel: z. B. Auf privaten Rechnern nur Entwicklungswerte halten und Produktionswerte zur Laufzeit aus dem Verwaltungsdienst lesen
- Ergebnis: z. B. 2 Rechner mit Produktionsschlüssel → gelöscht und Schlüssel ersetzt
3/4 Ursachen ergründen
⑩ 5-Why-Methode (einen Fall aus ③ bis ⑤ und ⑦ bis ⑨ wählen, fünfmal nachfragen)
- Warum 1 z. B. Warum steht das Produktions-DB-Passwort fest in der Konfiguration? → Es sollte lokal schnell laufen
- Warum 2 z. B. Warum fest eingetragen, nur um schnell zu starten? → Es war nicht festgelegt, woher der Wert gelesen wird
- Warum 3 z. B. Warum war das nicht festgelegt? → Die Ablageorte waren nicht nach Umgebung getrennt
- Warum 4 z. B. Warum nicht getrennt? → Am Anfang entwickelte eine Person allein und es störte nicht
- Warum 5 z. B. Warum nicht überprüft, als das Team wuchs? → Niemand war für Geheimnisse zuständig
- Grundursache z. B. Es gibt keine Regeln zu Ablageort und Übergabe, und niemand ist als Verantwortlicher benannt
⑪ Geheimnisse aus ② einordnen (Schaden bei einem Leak × Wechselaufwand)
Senkrechte Achse: Schaden bei einem Leak (oben = größer) / Waagerechte Achse: Wechselaufwand (links = schwer zu wechseln, rechts = leicht)
- Großer Schaden, schwer zu wechseln Zuerst einen Ablauf ohne Ausfall bauen z. B. DB-Passwort (viele Anwendungen nutzen es)
- Großer Schaden, leicht zu wechseln Schnell in den Verwaltungsdienst verschieben und wechseln z. B. Zahlungs-API-Schlüssel (neuer Schlüssel in der Konsole erzeugbar)
- Kleiner Schaden, schwer zu wechseln Einplanen und nacheinander verschieben z. B. Zugangspasswort eines alten internen Tools
- Kleiner Schaden, leicht zu wechseln Beim nächsten Wechsel gleich mit verschieben z. B. Mailversand-Schlüssel für die Entwicklung
⑫ Verbot, Werte aufzuschreiben
- z. B. Keine Werte in Code, Chat oder Tickets, nur wo sie liegen
- z. B. In die Beispiel-Konfigurationsdatei kommen Platzhalterwerte
- Notieren Sie Zuständige und Starttermin der Regel
⑬ Verwaltungslösung
- z. B. Einen Dienst zur Verwaltung von Geheimnissen wählen und alle Ablageorte dort bündeln
- z. B. Leserechte nach Rolle trennen und Produktion auf 2 Personen beschränken
- Notieren Sie Zuständige und Starttermin der Lösung
⑭ Prüfung vor dem Commit
- z. B. Vor jedem Commit läuft auf allen Rechnern ein Secret-Scanner
- z. B. In die Code-Review-Checkliste kommt „Keine fest eingetragenen Werte?“
- Notieren Sie Zuständige und Starttermin der Prüfung
4/4 Schutz und Ablauf aufbauen
⑮ Die 5 Stufen bei einem Leak (an einem Geheimnis mit großem Schaden aus ⑪ durchspielen)
- Informieren Wer es bemerkt, meldet es sofort z. B. An die vereinbarte Stelle schreiben, was wo aufgetaucht ist, ohne Schuldzuweisung
- Sperren Den alten Wert beim Herausgeber stoppen z. B. Den offengelegten Schlüssel in der Konsole des Zahlungsdienstes deaktivieren
- Ersetzen Neuen Wert erzeugen und den Ablageort umstellen z. B. Neuen Schlüssel im Verwaltungsdienst ablegen und Produktion neu laden
- Spuren prüfen Nach Nutzungsspuren suchen z. B. Nutzungsprotokoll und Rechnung des Herausgebers auf unbekannte Nutzung prüfen
- Ursache festhalten Das Warum notieren und in die Regeln zurückspielen z. B. In ⑩ ergründen und Regeln in ⑫ bis ⑭ ergänzen
⑯ Rotationsplan (von oben rechts und oben links in ⑪ beginnend)
| Nächster Wechsel | Prüfung, was ausfällt | Zuständig | |
|---|---|---|---|
| Zahlungs-API-Schlüssel | z. B. Zweite Woche dieses Monats | z. B. Alten und neuen Schlüssel parallel laufen lassen, Bestellungen durchlaufen sehen, dann den alten stoppen | z. B. Entwicklungsleitung |
| DB-Passwort | z. B. Erste Woche des nächsten Monats | z. B. In ② die betroffenen Anwendungen zählen, erst im Test, dann in Produktion wechseln | z. B. Infrastruktur-Team |
| Privater Zertifikatsschlüssel | z. B. Einen Monat vor Ablauf | z. B. In ② die betroffenen Server zählen, im Test einspielen und Verbindung prüfen, dann Produktion | z. B. Infrastruktur-Team |
| Mailversand-Schlüssel | z. B. Noch diesen Monat (vorgezogen, weil im Chat eingefügt) | z. B. Im Test prüfen, ob die Benachrichtigungsmail ankommt | z. B. Ein Mitglied des Entwicklungsteams |
⑰ Hinweis für neue Mitglieder (am ersten Tag mitgeben)
- Wo nichts stehen darf und wo es liegt z. B. Werte nie in Code, Chat oder Tickets schreiben, sondern aus dem Ablageort in ⑥ lesen
- Falle: Aus Angst vor Ausfällen alte Schlüssel behalten Was passiert: z. B. Ein alter Schlüssel läuft jahrelang weiter und ein Leak fällt nicht auf Prüfen: z. B. Schauen, ob Zuständige und Termin in ⑯ ausgefüllt sind Gegenmittel: z. B. Alt und neu parallel laufen lassen, bevor man den alten stoppt
- Wenn Sie einen Leak vermuten z. B. Es wird niemand beschuldigt, melden Sie es sofort der Stelle aus Stufe 1 in ⑮
Inhalt des Aufgabenboards
Offen 16 Einträge
Geheimnisse listen
Halten Sie auf Seite 1 Ziel und Umfang fest und listen Sie die Geheimnisse samt Streuorten auf. Diese Liste ist die Grundlage, um auf den folgenden Seiten Ablageorte und Ursachen festzulegen. Mit Ctrl+F (auf dem Mac ⌘F) und der Eingabe „3/4“ springen Sie zu Seite 3.
Schlüssel notieren
Öffnen Sie in der Konsole jedes externen Dienstes (Zahlung, Mailversand, Cloud) die Liste der API-Schlüssel und übertragen Sie Name und Zweck in die Zeilen von Bereich ②. Etwa 15 Minuten, fertig sind Sie mit drei Namen. Den Wert selbst schreiben Sie nie auf.
Ziel und Umfang
Tragen Sie in Bereich ① Ziel, betroffene Dienste und Repositories, Zeitraum und Koordination ein. Fertig, wenn die drei Notizen ausgefüllt sind.
Streuorte notieren
Notieren Sie in den Bereichen ③ bis ⑤, wo Geheimnisse liegen, nämlich in Code und Konfiguration, in Chat und Tickets und auf privaten Rechnern. Fertig, wenn jeder Rahmen mindestens einen echten Fall enthält.
Ablage festlegen
Entscheiden Sie auf Seite 2, wo jedes Geheimnis aus Bereich ② je Umgebung liegt, und prüfen Sie die drei Fallen. Mit genau einem Ablageort fällt die Wahl der Schutzmaßnahmen auf Seite 3 leichter.
Regeln je Umgebung
Tragen Sie in die Tabelle von Bereich ⑥ für Entwicklung, Test und Produktion Ablageort, Leseberechtigte, Übergabe und verbotene Orte ein. Fertig, wenn alle 12 Felder gefüllt sind.
Historie und Logs
Prüfen Sie in den Bereichen ⑦ und ⑧, ob in alten Commits noch Werte stehen oder auf Bildschirm und Logs auftauchen, und halten Sie das Ergebnis auf der Prüfnotiz fest.
Rechner prüfen
Fragen Sie in Bereich ⑨ anhand der Rechner aus ⑤ die Besitzer, ob ein Produktionswert in einer Entwicklungsdatei liegt, und notieren Sie das Ergebnis. Wird einer gefunden, ersetzen Sie den Schlüssel nach dem Ablauf in Bereich ⑮.
Ursachen ergründen
Ergründen Sie auf Seite 3, warum Geheimnisse in Code und Chat landen, und legen Sie die vorrangigen Geheimnisse und den Schutz fest. Diese Entscheidungen sind die Grundlage für Ablauf und Plan auf Seite 4.
5-mal Warum fragen
Wählen Sie in Bereich ⑩ einen Fall aus ③ bis ⑤ und ⑦ bis ⑨, fragen Sie fünfmal nach dem Warum und schreiben Sie die Grundursache in die letzte Stufe.
Geheimnisse ordnen
Ordnen Sie in Bereich ⑪ die Geheimnisse aus ② nach Schaden bei einem Leak und Wechselaufwand in vier Gruppen ein. Was oben rechts und oben links liegt, kommt zuerst dran.
Schutz festlegen
Legen Sie in den Bereichen ⑫ bis ⑭ je eine Regel gegen das Aufschreiben von Werten, eine Verwaltungslösung und eine Prüfung vor dem Commit fest. Fertig, wenn Zuständige und Starttermin dabeistehen.
Schutz und Ablauf
Erarbeiten Sie auf Seite 4 den Ablauf zum Sperren und Ersetzen, den Rotationsplan und den Hinweis für neue Mitglieder. Übernehmen Sie das Ergebnis in die Teamdokumente und lassen Sie es in der Spalte Wartet auf Prüfung gegenlesen.
5 Schritte planen
Tragen Sie in die 5 Stufen von Bereich ⑮ ein, wen Sie informieren, wo Sie sperren und was Sie prüfen. Spielen Sie es an einem Geheimnis mit großem Schaden aus ⑪ durch. Fertig, wenn nichts offen bleibt.
Rotationsplan bauen
Notieren Sie in der Tabelle von Bereich ⑯ je Geheimnis den nächsten Wechsel, die Prüfung, was dabei ausfällt, und die zuständige Person. Fertig, wenn jede Zeile einen Termin hat.
Hinweis für Neue
Schreiben Sie in Bereich ⑰, wo nichts stehen darf, wo es liegt, warum alte Schlüssel nicht bleiben und wen man bei einem Verdacht informiert. Fertig, wenn Neue es am ersten Tag ganz lesen können.