Richtlinie für Signaturschlüssel abrufen

GET /v1/signing-keys/policy · Berechtigung signing-keys:read

Gibt die Signaturschlüssel-Richtlinie der Umgebung zurück: den Algorithmus neuer Schlüssel, das automatische Rotationsintervall und die Schlüsselspeicherung. Wurde die Richtlinie nie geschrieben, werden die Standardwerte (RS256, 180 Tage, wrapped) mit ETag: "0" und updated_at: null zurückgegeben. Der Antwort-Header ETag trägt die Version, die beim Aktualisieren der Richtlinie als If-Match zu senden ist.

Anfrage

Diese Operation nimmt keine Pfad-, Query- oder Body-Felder. Die Umgebung stammt aus den Anmeldedaten.

Antwort

200 OK mit der Richtlinie und dem ETag-Header. next_rotation_at ist die nächste automatische Rotation (Aktivierung des aktiven Schlüssels plus Intervall); ohne aktiven Schlüssel ist der Wert null.

{
  "algorithm": "RS256",
  "rotation_interval_days": 180,
  "storage": "wrapped",
  "next_rotation_at": "2027-03-04T09:30:00.123456Z",
  "updated_at": null
}

Fehler

HTTP	Code	Wann
401	`unauthenticated`	Die Anmeldedaten fehlen, sind ungültig oder wurden widerrufen.
403	`insufficient_permissions`	Die Anmeldedaten haben nicht die erforderliche Berechtigung.
429	`rate_limited`	Die Rate-Grenze wurde überschritten; Wiederhole nach dem `Retry-After`-Zeitraum.
501	`not_implemented`	Die Operation ist in dieser Bereitstellung noch nicht verfügbar; eine Wiederholung ändert das Ergebnis nicht.
503	`service_unavailable`	Eine Abhängigkeit ist vorübergehend nicht verfügbar; Wiederhole nach dem `Retry-After`-Zeitraum.

Beispiel

curl -i https://api.eu.keenauth.com/v1/signing-keys/policy \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"