API-Keys
API-Keys ist die Seite, auf der Sie die Bearer-Tokens erzeugen, die
Agenten, Integrationen und Custom Dashboards verwenden, um
api.saiku.bi aufzurufen. Sie kommen einmal für jede Integration
hierher, die Sie einrichten möchten, und danach regelmäßig für die
Rotation.
Die Seite listet jeden Key in Ihrem Tenant mit einem Label, einer partiellen Key-ID, dem Ersteller, dem Erstellungsdatum und einem „Last used”-Zeitstempel auf, der nahezu in Echtzeit aktualisiert wird. Nützlich, um Keys zu erkennen, die nicht mehr verwendet werden (widerrufen) und Keys, die viel verwendet werden (die richtigen Kandidaten für eine Rotations-Überprüfung).
Einen Key erzeugen
-
Klicken Sie auf Key erstellen und beschriften Sie ihn. Verwenden Sie einen Namen, der beschreibt, wofür er da ist:
production-billing-agent,staging-bot,client-acme-integration. Labels erscheinen im Audit-Log, also machen Sie sie wiedererkennbar. -
Klicken Sie auf Erstellen.
-
Kopieren Sie das Secret sofort. Es wird nur einmal angezeigt. Das Dashboard behält die Key-ID und das Label nach diesem Zeitpunkt, aber das tatsächliche Secret ist nicht mehr abrufbar — wir speichern es nicht in umkehrbarer Form.
-
Fügen Sie es in den Secret Store Ihrer Integration ein. Testen Sie end-to-end.
Den Key verwenden
Senden Sie das Secret im Authorization-Header:
curl https://api.saiku.bi/me/tenant \ -H "Authorization: Bearer sk_…"Die vollständige Referenz lebt unter Authentifizierung — Basis-URL, Rate-Limits, Fehlerformat, alles.
Rotation
Eine saubere Rotation hat keine Ausfallzeit, weil beide Keys während der Umschaltung gültig sind.
- Erstellen Sie einen neuen Key mit demselben Label wie dem alten
(hängen Sie
-v2,-v3an, damit Sie sie unterscheiden können). - Stellen Sie den neuen Key in Ihrer Integration bereit.
- Bestätigen Sie, dass der neue Key verwendet wird — die Spalte Last used auf der Seite aktualisiert sich innerhalb einer Minute oder zwei.
- Widerrufen Sie den alten Key, sobald Sie sicher sind.
Widerrufen
Mülleimer-Symbol in der Zeile, bestätigen. Der Key wird sofort
invalidiert — die nächste Anfrage, die ihn verwendet, erhält
401 Unauthorized. Es gibt keine Karenzfrist und kein Rückgängig,
also widerrufen Sie überlegt.
Ein Key pro Integration
Die Gewohnheit, die sich auszahlt: ein Key pro Ding, das Sie aufruft. Wird ein Agent kompromittiert, widerrufen Sie seinen Key, und sonst ändert sich nichts. Wenn Sie wissen wollen, welche Integration eine bestimmte Anfrage gestellt hat, beantwortet das die Key-Spalte im Audit-Log ohne Detektivarbeit. Und wenn der Scope eines Partners enger werden muss, bearbeiten Sie eine Allowlist, statt ein geteiltes Credential zu auditieren.
Keys sind kostenlos auszustellen, der einzige echte Preis ist also eine etwas längere Tabelle.
Verwandt
- Authentifizierung — Keys in Anfragen verwenden.
- Audit-Log — der Key jeder Anfrage wird protokolliert.
- Nutzung — Anfragevolumen pro Key.