Analytics-API-Tokens Sind Zugangsdaten, Keine Kennungen
Ein API-Token gewährt Datenzugriff. Behandle es als Geheimnis mit Lebenszyklus: einmal anzeigen, einen Prüfwert speichern, Rechte begrenzen und Widerruf ermöglichen.
Ein API-Token ist kein Label für einen Benutzer oder eine Site. Es ist ein Zugangsschlüssel: Wer ein gültiges Token erhält, kann möglicherweise als dessen Inhaber handeln. Wer es wie eine Kennung behandelt, findet es bald in Logs, URLs, Support-Screenshots und langlebigen Konfigurationen, die sich niemand zu widerrufen traut.
Die Best Current Practice für OAuth-2.0-Sicherheit der IETF aktualisiert seit Januar 2025 das Bedrohungsmodell und die Sicherheitsempfehlungen für OAuth-Deployments. Ein persönliches API-Token ist nicht zwangsläufig ein OAuth-Access-Token, doch dasselbe Grundprinzip gilt: Zugangsdaten, deren Besitz genügt, müssen bei der Übertragung geschützt, auf den vorgesehenen Dienst beschränkt und auf die nötigen Rechte begrenzt werden.
Das Geheimnis nur einmal anzeigen
Erzeuge Tokens mit einem kryptografisch sicheren Zufallszahlengenerator und genügend Entropie, um praktische Rateversuche zu verhindern. Gib das vollständige Token nur bei der Erstellung zurück und speichere danach ein nicht geheimes Präfix zur Identifikation sowie einen Einweg-Prüfwert für spätere Vergleiche. Wird die Datenbank kopiert, ist ein Prüfwert sicherer als ein wiederverwendbares Klartext-Geheimnis. Verwechsle einen allgemeinen Hash nicht mit einem Passwort-Hash: API-Tokens brauchen hohe Zufälligkeit, während menschliche Passwörter eine bewusst langsame Hashfunktion erfordern.
Mache in der Oberfläche und API-Antwort deutlich, dass das Token nur einmal angezeigt wird. Nach dem Verlassen der Erstellungsseite sollte der Nutzer es widerrufen und neu ausstellen können, statt das ursprüngliche Geheimnis abzurufen. Tokens gehören niemals in Query-Parameter, Seiten-URLs, Analytics-Ereignisse, Fehlerberichte oder Screenshots. URLs landen leichter als Authorization-Header im Browserverlauf, Referrer, Proxy-Logs und Support-Tickets.
Zugangsdaten an der richtigen Stelle senden
Akzeptiere Tokens für HTTP-APIs im Authorization-Header über TLS. RFC 6750 beschreibt Bearer-Tokens als von jeder Person nutzbar, die sie besitzt, und warnt vor Offenlegung bei Speicherung oder Übertragung. Die Spezifikation rät außerdem davon ab, Bearer-Zugangsdaten in URI-Query-Parametern zu senden, weil URLs häufig protokolliert werden. Weise Tokens in Query-Strings und Request-Bodies zurück, sofern kein Protokoll einen anderen Transport verlangt und ein dokumentiertes Bedrohungsmodell vorliegt.
Validiere das Token serverseitig, bevor du die angeforderte Aktion verarbeitest. Ermittle Inhaber und Berechtigungen aus vertrauenswürdigem Speicher; übernimm keinen Benutzer oder Site-Inhaber aus der Anfrage als maßgebliche Berechtigung. Halte Geheimnisse aus Anwendungslogs, Traces und Exception-Meldungen heraus. Wenn eine operative Zuordnung nötig ist, protokolliere eine nicht geheime Token-ID oder ein Präfix, niemals das Token selbst.
Rechte begrenzen, Ablauf festlegen, widerrufen
Ein Token sollte die kleinste sinnvolle Menge an Berechtigungen vergeben. Wenn das Produkt es unterstützt, sollte der Nutzer es auf ausgewählte Sites sowie Lesezugriff oder bestimmte Aktionen beschränken können. Ein Automatisierungsskript, das einen Bericht abruft, sollte nicht stillschweigend Schreibzugriff auf das ganze Konto erhalten. Die OAuth-Sicherheitsleitlinien behandeln die Beschränkung von Token-Rechten und Zielgruppen; das ist auch dann eine nützliche Designreferenz, wenn eine API ihr eigenes opakes Format verwendet.
Biete Ablauf und Widerruf als zentrale Kontrollen an. Kürzere Laufzeiten verkleinern den Zeitraum, in dem ein geleaktes Token nützlich ist; Widerruf deckt Vorfälle und Änderungen bei Mitarbeitenden oder Integrationen ab. Falls Rotation eine Überschneidung erfordert, begrenze deren Dauer und zeige, welches Token aktiv ist. Der Widerruf muss an der API-Grenze wirksam werden und darf das Token nicht nur im Dashboard verbergen.
In Monoids programmierbarer API sind benutzererstellte mnd_live_…-Tokens opak, werden einmalig im Klartext zurückgegeben und als SHA-256-Hashes mit optionalem Ablaufdatum und logischem Widerruf gespeichert. Dadurch ist der ursprüngliche Wert bei einem Datenbankzugriff geschützt; ein offengelegtes aktives Token bleibt dennoch nutzbar. Halte es aus Versionsverwaltung, CI-Ausgaben, Browser-Bundles und gemeinsam genutztem Terminalverlauf heraus. Bei vermuteter Offenlegung: Ersatz ausstellen und das alte Token widerrufen.
Den Lebenszyklus testbar machen
Teste den vollständigen Ablauf: erstellen, mit den vorgesehenen Rechten verwenden, ungültige oder abgelaufene Tokens ablehnen, widerrufen und anschließend bestätigen, dass dasselbe Token nicht mehr funktioniert. Prüfe, dass ein Token nicht konto- oder siteübergreifend wirkt und alle Endpunkte dieselben Authentifizierungs- und Autorisierungsregeln anwenden. Ergänze Betriebskontrollen, die Geheimnisse in Logs schwärzen und verhindern, dass API-Antworten gespeichertes Tokenmaterial zurückgeben.
Zum Lebenszyklus von Geheimnissen gehören Erstellung, Zugriffskontrolle, Rotation, Audit und Widerruf – nicht nur sichere Speicherung. Ein API-Token bleibt nur dann geschützt, wenn das System seinen Inhaber identifizieren, seine Rechte begrenzen, Offenlegung ohne Protokollierung des Geheimnisses erkennen und es schnell deaktivieren kann.
Comments
Loading comments…