Alles Wissenswerte, nichts Unwissendes.
Rotation ohne Ausfallzeiten
Generieren Sie im Dashboard (API-Schlüssel → Generieren) einen neuen Schlüssel, solange der aktuelle Schlüssel noch aktiv ist. Stellen Sie den neuen Schlüssel in Ihren Anwendungen bereit und prüfen Sie, ob der Datenverkehr darüber fließt. Widerrufen Sie anschließend den alten Schlüssel. Da beide Schlüssel während des Überschneidungszeitraums gültig sind, entsteht keine Serviceunterbrechung – dies ist das standardmäßige Rotationsverfahren ohne Ausfallzeiten.
Entzug eines Schlüssels
Das Widerrufen eines Schlüssels im Dashboard wird sofort wirksam: Anfragen mit dem widerrufenen Schlüssel werden abgelehnt. Da BroadNet niemals Rohdaten von Schlüsseln protokolliert, hinterlässt ein widerrufener Schlüssel keine Spuren, die offengelegt werden könnten. Widerrufen Sie den Schlüssel umgehend, wenn er möglicherweise in die Quellcodeverwaltung eingecheckt, in ein Ticket eingefügt oder anderweitig offengelegt wurde.
Behandeln Sie Test-Zugangsdaten wie Produktionsgeheimnisse
Test-Zugangsdaten arbeiten gegen den Produktions-Endpunkt, https://api.broadnet.me, daher müssen sie vom ersten Tag an wie ein Produktionsgeheimnis geschützt werden: Speichern Sie den Token in einer Umgebungsvariablen oder einem Secrets Manager, niemals in der Versionsverwaltung, im clientseitigen Code oder in gemeinsam genutzten Test-Fixtures, und rotieren Sie ihn, falls er exponiert worden sein könnte. Siehe /answers/what-is-sandbox-vs-production.
Wann drehen?
Rotieren Sie die Schlüssel regelmäßig (vierteljährlich ist ein üblicher Richtwert), damit kein Schlüssel dauerhaft im Besitz bleibt. Wechseln Sie die Schlüssel sofort, sobald ein Verdacht auf Gefährdung besteht oder ein Teammitglied mit Zugriff auf einen Schlüssel ausscheidet. Durch die regelmäßige Rotation wird der potenzielle Schaden durch einen Schlüssel, dessen Kompromittierung Ihnen zunächst unbekannt war, minimiert.
Keys sind widerrufbar
API-Keys können jederzeit widerrufen werden, was die routinemäßige Rotation sicher und kostengünstig macht. Kombinieren Sie die Rotation mit dem Prinzip der minimalen Rechtevergabe (Least Privilege), damit jede Anwendung nur die Zugangsdaten besitzt, die sie tatsächlich benötigt. Siehe /developers/authentication.