API-Schlüssel für KI-Integrationen mit Inventarisierung und Widerrufsprüfung rotieren

Consumer vor dem Austausch inventarisieren

Beginnen Sie mit einem Anmeldedaten-Inventar, das Schlüssel-ID oder sicheres Präfix, Inhaber, Arbeitsbereich, vorgesehenen Consumer, Scopes, Ablaufdatum, Speicherort-Referenz und betrieblichen Ansprechpartner erfasst. Dokumentieren Sie den Speicherort eines Secrets, niemals dessen Wert. Unterscheiden Sie zwischen einem Schlüssel für einen Berichts-Job und einem interaktiv genutzten Schlüssel. Ein Schlüssel ohne identifizierten Consumer ist ein ungelöster Inventareintrag und nicht automatisch sicher, um aktiv zu bleiben. Nachweise über kürzliche Nutzung können helfen, aber fehlende Nutzung ist kein vollständiges Abbild aller Abhängigkeiten.

AdAce Ads speichert einen Schlüssel-Hash, zeigt den vollständigen Schlüssel nur bei der Erstellung an und prüft dessen Scopes zusammen mit den aktuellen Berechtigungen des Inhabers. Eine Rotation sollte den erforderlichen Rahmen beibehalten oder reduzieren und keinen Propose-Scope hinzufügen, nur weil ein neuer Schlüssel ausgestellt wird. Nutzen Sie für reine Berichtsaufgaben die vorgesehene Lese-Berechtigung. Ein API-Schlüssel und eine OAuth-Autorisierung sind unterschiedliche Anmeldedaten; das Ersetzen des einen ersetzt oder widerruft das andere nicht. Identifizieren Sie den tatsächlichen Authentifizierungspfad, bevor Sie beginnen.

Ein Lehrbeispiel umfasst zwei Consumer: ein Skript zur Berichtsvorbereitung und eine temporäre Analysten-Sitzung. Das Skript benötigt einen geplanten Austausch; die temporäre Sitzung ist beendet und sollte geschlossen statt migriert werden. Das Runbook dokumentiert eine Umstellung und eine Entfernung. Es kopiert denselben Ersatzschlüssel nicht auf jedes bekannte Gerät. Ein nicht identifizierter Consumer, der nach der Umstellung die alte Identität nutzt, ist ein Grund zur Untersuchung – nicht dazu, den alten Schlüssel aus Bequemlichkeit dauerhaft wiederherzustellen.

Umstellung und Widerruf erfordern separate Prüfungen

• Wählen Sie den Rotationsmodus anhand des Anlasses. Ein Routineaustausch kann eine kurze kontrollierte Überschneidung erlauben, sofern unterstützt; bei Verdacht auf Kompromittierung kann ein sofortiger Widerruf und eine vorübergehende Dienstunterbrechung erforderlich sein. Gehen Sie nicht davon aus, dass Kontinuität wichtiger ist als Schadensbegrenzung.
• Verwenden Sie eine Verifizierungsmatrix mit alten Anmeldedaten, Ersatz-Anmeldedaten und betroffenen Consumern. Ein erfolgreicher Leseabruf mit dem neuen Schlüssel belegt nur diesen Lesepfad. Er beweist weder, dass die alten Anmeldedaten widerrufen wurden, noch dass jeder geplante Consumer aktualisiert wurde.
• Halten Sie Kennungen und Zeitstempel im Runbook fest, keine Screenshots von Secret-Feldern oder Authentifizierungs-Headern. Ein Rotationsbericht sollte für andere Administratoren nützlich sein, ohne zu einem neuen Verbreitungskanal für Anmeldedaten zu werden.

Ersetzen, verifizieren und abschließen

1. Identifizieren Sie den Inhaber und alle dokumentierten Consumer. Überprüfen Sie erforderliche Scopes sowie Kundenzugriffe und wählen Sie dann zwischen Routine- oder Notfallabwicklung. Halten Sie den autorisierten Umstellungsverantwortlichen und die Bedingung für das Beenden einer Überschneidungsphase fest.
2. Stellen Sie bei Bedarf einen Ersatzschlüssel über den bestehenden, autorisierten Schlüssel-Workflow bereit. Prüfen Sie aktuelle Kontolimits und Berechtigungen, anstatt sie im Runbook fest zu hinterlegen. Speichern Sie den neuen Wert direkt am freigegebenen Speicherort für Secrets, ohne ihn in Notizen, Chats oder Protokolle einzufügen.
3. Aktualisieren Sie einen kontrollierten Consumer und verifizieren Sie einen unbedenklichen, zulässigen Leseabruf im gewünschten Arbeitsbereich. Bestätigen Sie, dass er den richtigen Scope liest und weder propose_change noch ein Schreib-Tool aufruft. Wiederholen Sie die consumerspezifische Prüfung überall dort, wo sich Anmeldedaten oder Ausführungsumgebungen unterscheiden.
4. Widerrufen Sie den alten Schlüssel über das autorisierte Steuerelement und bestätigen Sie, dass ein isolierter Leseabruf mit den alten Anmeldedaten abgelehnt wird. Verwenden Sie sichere Tools, die Anforderungs-Header und das Secret verbergen. Fügen Sie die Anmeldedaten nicht in Shell-Befehle, URLs, Screenshots oder exportierte Testberichte ein.
5. Schließen Sie die Rotation mit sicheren Nachweisen ab: Ersatz-ID, alte ID, Consumer-Prüfungen, Widerrufsergebnis, prüfende Person und Uhrzeit. Achten Sie auf fehlerhafte Consumer, die noch die früheren Anmeldedaten nutzen, und lösen Sie dies durch saubere Migration oder Stilllegung. Ein widerrufenes Secret darf nicht als Wiederherstellungsmechanismus dienen.

Verstehen, welche Anmeldedaten-Grenze sich geändert hat

Quellen und weiterführende Literatur

• AdAce Ads API-Schlüsselverhalten
• AdAce Ads Verbindungsaktivität
• AdAce Ads Audit-Log