Aller au contenu

Mener une revue des accès

Passez en revue les partages actifs d'un espace HDS, décidez de leur maintien et révoquez en une fois ceux qui n'ont plus lieu d'être.

GuideDéveloppeurAdministrateur
Accès requis
Rôle HDS_ADMIN
Durée
20 min
Voir en Markdown

Une revue d'accès est une campagne : le module photographie les partages actifs d'un périmètre, vous décidez pour chacun de le garder ou de le révoquer, puis la clôture applique vos décisions. Menez-en une régulièrement, par exemple chaque trimestre.

Avant de commencer

  • Vous portez le rôle HDS_ADMIN.
  • Vous avez défini le périmètre : tout l'espace, certains coffres ou certains utilisateurs.

Ouvrir la revue

Bash
curl -X POST "https://api.wakastart.app/api/hds/access-reviews" \
  -H "Authorization: Bearer $USER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Revue T4 2026 - cardiologie",
    "description": "Partages des dossiers suivis en cardiologie",
    "vaultIds": ["vlt_a1B2c3D4", "vlt_K9m3Np7Q"]
  }'

Sans vaultIds ni userIds, la revue porte sur tous les partages actifs de l'espace. Réponse attendue (201 Created, extrait) :

JSON
{
  "reviewId": "rev_Bn5Mk8Lp",
  "name": "Revue T4 2026 - cardiologie",
  "status": "PENDING",
  "scope": { "vaultIds": ["vlt_a1B2c3D4", "vlt_K9m3Np7Q"], "userIds": [] },
  "findings": [
    { "shareId": "shr_Wq2Ez5Rt", "vaultId": "vlt_a1B2c3D4" },
    { "shareId": "shr_Ty6Ui9Op", "vaultId": "vlt_a1B2c3D4" }
  ]
}

Chaque élément de findings est un partage à examiner.

Décider pour chaque partage

Pour chaque shareId, enregistrez une recommandation : KEEP (garder), REVOKE (révoquer) ou DOWNGRADE (réduire, consignée à titre de décision).

Bash
curl -X POST "https://api.wakastart.app/api/hds/access-reviews/rev_Bn5Mk8Lp/findings" \
  -H "Authorization: Bearer $USER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "shareId": "shr_Ty6Ui9Op", "recommendation": "REVOKE" }'

La réponse renvoie la revue, avec reviewedBy et reviewedAt renseignés sur l'élément traité. Vous pouvez changer d'avis tant que la revue n'est pas close.

Clore la revue

Bash
curl -X POST "https://api.wakastart.app/api/hds/access-reviews/rev_Bn5Mk8Lp/complete" \
  -H "Authorization: Bearer $USER_TOKEN"

À la clôture, le module révoque tous les partages marqués REVOKE et passe la revue au statut COMPLETED. Seules les recommandations REVOKE modifient des partages. Une revue close ne peut plus être modifiée.

Vérifier le résultat

  • GET /api/hds/shares?vaultId=vlt_a1B2c3D4&active=false liste les partages révoqués.
  • Le journal d'audit contient ACCESS_REVIEW_STARTED puis ACCESS_REVIEW_COMPLETED, avec le nombre de révocations.
  • GET /api/hds/access-reviews liste vos campagnes, filtrables par status.

Dépannage

  • 400 Cannot modify completed review : la revue est close ; ouvrez-en une nouvelle.
  • 404 Share not found in review: … : ce partage ne faisait pas partie du périmètre à l'ouverture.

Voir aussi