Obtenir les autorisations effectives d'un utilisateur

GET /v1/users/{user_id}/effective-permissions · autorisation users:read

Renvoie les autorisations dont l'utilisateur dispose effectivement, pour le support et le débogage : les autorisations des rôles d'environnement directs de l'utilisateur et, lorsque org_id est fourni, celles des rôles de son adhésion active à cette organisation. Chaque autorisation liste les rôles qui l'accordent. Les autorisations des API supprimées ne sont pas incluses. La liste n'est pas paginée et est ordonnée par API, puis par valeur d'autorisation.

Demande

Paramètre Dans Requis Description
user_id path oui ID utilisateur (usr_…).
org_id query non ID de l'organisation (org_…) ; inclut aussi les rôles de l'adhésion active de l'utilisateur dans cette organisation.
api_id query non ID de l'API (api_…) ; seulement les autorisations de cette API. Une API inconnue donne une liste vide.

Aucun corps de requête.

Réponse

200 OK avec les autorisations.

{
  "permissions": [
    {
      "permission_id": "perm_01j9xs0a2b4c6d8e0f2g4h6j8k",
      "api_id": "api_01j9xq1b3c5d7e9f1g3h5j7k9m",
      "value": "read:invoices",
      "role_ids": [
        "rol_01j9xr7s1t2w6x8y0z2a4b6c8e"
      ]
    }
  ]
}

Erreurs

HTTP code Quand
404 not_found L'utilisateur, ou l'organisation indiquée dans org_id, n'existe pas dans cet environnement.
422 validation_failed org_id ou api_id est mal formé ou répété.
401 unauthenticated Le justificatif est absent, invalide ou révoqué.
403 insufficient_permissions Le justificatif ne possède pas l'autorisation requise.
429 rate_limited La limite de débit a été dépassée ; réessayez après la durée indiquée par Retry-After.
503 service_unavailable Une dépendance est temporairement indisponible ; réessayez après la durée indiquée par Retry-After.

Exemple

curl -i -X GET "https://api.eu.keenauth.com/v1/users/usr_01j9xh2k6p7q1r3s5t7v9w1x3y/effective-permissions?org_id=org_01j9xk3m7q8r2s4t6v8w0y2z4a" \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"