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.
- Required access
- Rôle HDS_ADMIN
- Duration
- 20 min
This page has not been translated yet and is shown in French.
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
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) :
{
"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).
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
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=falseliste les partages révoqués.- Le journal d'audit contient
ACCESS_REVIEW_STARTEDpuisACCESS_REVIEW_COMPLETED, avec le nombre de révocations. GET /api/hds/access-reviewsliste vos campagnes, filtrables parstatus.
Dépannage
400Cannot modify completed review: la revue est close ; ouvrez-en une nouvelle.404Share not found in review: …: ce partage ne faisait pas partie du périmètre à l'ouverture.