Obtenir la politique des clés de signature
GET /v1/signing-keys/policy · permission signing-keys:read
Renvoie la politique des clés de signature de l'environnement : l'algorithme des nouvelles clés, l'intervalle de rotation automatique et le stockage des clés. Si la politique n'a jamais été écrite, les valeurs par défaut sont renvoyées (RS256, 180 jours, wrapped) avec ETag: "0" et updated_at: null. L'en-tête de réponse ETag porte la version à envoyer comme If-Match lors de la mise à jour de la politique.
Requête
Cette opération ne prend aucun paramètre de chemin, de requête ni de corps. L'environnement provient de l'authentification.
Réponse
200 OK avec la politique et l'en-tête ETag. next_rotation_at est la prochaine rotation automatique (activation de la clé active plus l'intervalle) ; il vaut null s'il n'y a pas de clé active.
{
"algorithm": "RS256",
"rotation_interval_days": 180,
"storage": "wrapped",
"next_rotation_at": "2027-03-04T09:30:00.123456Z",
"updated_at": null
}
Erreurs
| HTTP | code | Quand |
|---|---|---|
| 401 | unauthenticated |
L'authentification est manquante, invalide ou révoquée. |
| 403 | insufficient_permissions |
L'authentification manque la permission requise. |
| 429 | rate_limited |
La limite de débit a été dépassée ; réessayez après la période Retry-After. |
| 501 | not_implemented |
L'opération n'est pas encore disponible dans ce déploiement ; réessayer ne change pas le résultat. |
| 503 | service_unavailable |
Une dépendance est temporairement indisponible ; réessayez après la période Retry-After. |
Exemple
curl -i https://api.eu.keenauth.com/v1/signing-keys/policy \
-H "Authorization: Bearer $KEENAUTH_SECRET_KEY"