Eine Anwendungsbescheinigung erstellen

POST /v1/applications/{application_id}/credentials · Berechtigung applications:write · Idempotency-Key optional

Fügt eine Bescheinigung zu einer Anwendung hinzu: ein plattformgeneriertes Client-Geheimnis (type: client_secret) oder einen registrierten öffentlichen Schlüssel für private_key_jwt (type: public_key).

Client-Geheimnis. Die Antwort trägt client_secret einmal. Es kann nicht erneut abgerufen werden; speichern Sie es sofort. Eine Anwendung enthält höchstens 2 aktive Geheimnisse, sodass ein Geheimnis ohne Ausfallzeiten rotiert werden kann.
Öffentlicher Schlüssel. Senden Sie die öffentliche JWK in jwk. Eine JWK mit privaten Mitgliedern (d, p, q, dp, dq, qi, oth, k) oder größer als 16 KiB wird abgelehnt. Eine Anwendung enthält höchstens 5 Schlüssel.
Idempotente Wiedergabe. Das Wiederholen der Anfrage mit demselben Idempotency-Key gibt die gespeicherte Antwort ohne Geheimnis wieder: Der Text hat secret_redacted: true und kein client_secret. Erstellen Sie eine neue Bescheinigung, wenn das Geheimnis verloren gegangen ist.

Anfrage

Parameter	In	Beschreibung
`application_id`	yol	Application id (`app_…`).

Body:

Feld	Typ	Beschreibung
`type`	string	Required. `client_secret` or `public_key`.
`expires_at`	string (date-time)	Optional, `client_secret` only; must be in the future.
`jwk`	object	Required for `public_key`; a public JWK, at most 16 KiB.

Antwort

201 Created with Cache-Control: no-store. The credential object as in the list response; for client_secret it also has client_secret.

{
  "id": "cred_0000000000000000000000001z",
  "type": "client_secret",
  "secret_last4": "abcd",
  "client_secret": "<shown once>",
  "expires_at": null
}

Fehler

HTTP	`code`	Wann
401	`unauthenticated`	The key is missing, invalid or revoked.
403	`insufficient_permissions`	The key lacks the required permission.
404	`not_found`	The application does not exist in this environment.
409	`credential_limit_reached`	The application already has the maximum number of active secrets (2) or keys (5).
409	`conflict`	The same public key is already registered for the application.
422	`validation_failed`	The body is invalid: unknown `type`, missing `jwk`, private JWK members, JWK too large, `expires_at` in the past or sent with `public_key`, or a credential type the application type does not allow (`/type: not_allowed`: `client_secret` only for `web` and `m2m`; `public_key` for `web`, `m2m`, `device` and `management`; `spa` and `native` are public clients and take no credentials).
503	`service_unavailable`	The credential registry is temporarily unavailable; retry after the `Retry-After` delay.

Beispiel

curl -X POST https://api.eu.keenauth.com/v1/applications/app_6f8d0cjgbmf0gtn2rg6pscp3cg/credentials \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"type":"client_secret"}'