Révoquer les jetons d'une application
POST /v1/applications/{application_id}/tokens:revoke · autorisation sessions:write
Révoque toutes les familles de jetons d'actualisation actives émises à l'application, pour l'ensemble des utilisateurs. Les jetons d'accès émis à l'application avant l'appel cessent d'être acceptés par l'introspection et par la vérification de révocation. Utilisez-le lorsque les jetons émis à l'application ont pu fuir : l'application doit alors obtenir de nouveaux jetons par une nouvelle demande d'autorisation.
Les sessions, les consentements des utilisateurs et les identifiants de l'application ne sont pas modifiés : les sessions de connexion des utilisateurs restent ouvertes, de sorte qu'une nouvelle demande d'autorisation peut réussir sans nouvelle connexion, et le consentement n'est pas demandé de nouveau. Pour empêcher un secret client divulgué de générer de nouveaux jetons, faites aussi tourner les identifiants de l'application. La demande n'a pas de corps. Un appel répété réussit avec un compteur à zéro. La révocation est écrite dans le journal d'audit de gestion. Envoyez un en-tête Idempotency-Key pour rendre les nouvelles tentatives sûres.
Demande
| Paramètre | Dans | Obligatoire | Description |
|---|---|---|---|
application_id |
chemin | oui | Identifiant d'application, préfixé app_. |
Réponse
200 OK.
{
"revoked_token_families": 318
}
revoked_token_families est le nombre de familles de jetons d'actualisation révoquées par cet appel.
Erreurs
Chaque erreur est un corps application/problem+json accompagné d'un code stable.
| HTTP | code |
Quand |
|---|---|---|
| 400 | malformed_request, unknown_field |
Un corps a été envoyé et ce n'est pas un objet JSON vide. |
| 404 | not_found |
L'application n'existe pas dans cet environnement. |
| 401 | unauthenticated |
La clé d'API est absente, invalide ou révoquée. |
| 403 | insufficient_permissions |
La clé ne dispose pas de l'autorisation sessions:write. |
| 429 | rate_limited |
La limite de débit a été dépassée ; respectez l'en-tête Retry-After. |
| 503 | service_unavailable |
Une dépendance est temporairement indisponible ; réessayez plus tard. |
Exemple
curl -X POST https://api.eu.keenauth.com/v1/applications/app_0a1b2c3d4e5f6g7h8j9k0m1n2p/tokens:revoke \
-H "Authorization: Bearer $KEENAUTH_SECRET_KEY" \
-H "Idempotency-Key: $(uuidgen)"
CLI : keenauth applications tokens revoke app_0a1b2c3d4e5f6g7h8j9k0m1n2p --yes