# 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.

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

- [Partager un coffre](/v1.0/hds/partager-un-coffre)
- [Référence : revue d'accès](/v1.0/hds/reference#revue-daccès)
