Aller au contenu

Résoudre les problèmes HDS

Les erreurs rencontrées en intégrant le module de données de santé, avec leur cause et leur solution.

DépannageDéveloppeur
Voir en Markdown

Cette page part de ce que vous observez à l'appel de /api/hds/*. Les messages sont cités tels que l'API les renvoie.

Symptômes

Tous les appels renvoient 403 faute de rôle HDS

Cause : l'appel ne porte aucun rôle HDS. Message : Rôle(s) HDS requis: HDS_ADMIN, HDS_HEALTHCARE, HDS_MEDICAL, HDS_PATIENT, HDS_STORAGE, HDS_DELETE (mode: any).

Solution :

  1. Vérifiez que vous appelez avec Authorization: Bearer <jeton de l'utilisateur>, et non avec une clé sk_…, qui ne porte jamais de rôle HDS.
  2. Vérifiez que l'utilisateur a des rôles HDS : lisez hdsRoles dans /me. Sinon, voir Attribuer les rôles.
  3. Si les rôles viennent d'être attribués, obtenez un nouveau jeton.

Une opération renvoie 403 alors que l'utilisateur a un rôle HDS

Cause : l'utilisateur a des rôles HDS, mais aucun ne permet cette opération. Exemple : un HDS_MEDICAL qui tente de déposer un document, un HDS_HEALTHCARE qui lit le journal d'audit.

Solution : consultez la matrice des permissions et ajoutez le rôle adapté.

Un coffre renvoie 404 alors qu'il existe

Cause : l'utilisateur n'en est ni propriétaire, ni destinataire d'un partage actif. Le module répond 404 Vault not found: vlt_… pour ne pas révéler l'existence du coffre. C'est aussi vrai pour un HDS_ADMIN.

Solution : demandez au propriétaire de partager le coffre. Voir Partager un coffre. Si le partage a été révoqué par une revue d'accès, recréez-le.

Pour vérifier : GET /api/hds/shares?vaultId=vlt_… avec le jeton du propriétaire.

La création de coffre renvoie 400 car l'espace est inactif

Cause : l'espace HDS du client de l'utilisateur n'existe pas ou n'est pas actif.

Solution :

  1. Vérifiez que le module est activé pour l'application et que le client y est rattaché. Voir Activer le module.
  2. Un administrateur HDS vérifie l'espace avec GET /api/hds/networks/{WID du client}.

Le dépôt renvoie 413

Cause : File too large si le fichier dépasse 100 Mo ; Storage quota exceeded si le quota de stockage de l'espace est atteint.

Solution : pour un fichier trop gros, demandez une version plus légère. Pour le quota, supprimez les documents inutiles (purgés 30 jours plus tard) ou contactez Wakastart pour l'augmenter.

Les appels renvoient 503

Cause : pour une application HDS, l'API refuse tout appel tant qu'elle ne peut pas vérifier que le jeton n'a pas été révoqué. Ce refus protège les données en cas d'incident.

Solution : réessayez après quelques secondes, avec un délai croissant. Si l'erreur persiste plus de quelques minutes, contactez le support.

Un patient ne voit pas son dossier

Cause : le coffre appartient au professionnel qui l'a créé. Le rôle HDS_PATIENT ne relie pas à lui seul un patient à son coffre.

Solution : partagez le coffre avec l'identifiant Keycloak du patient. Voir Partager un coffre.

L'attribution d'un rôle renvoie 403

Cause : vous tentez d'attribuer un rôle HDS que vous ne possédez pas. Message : Cannot assign hdsRole HDS_ADMIN: caller does not possess this role.

Solution : demandez à un administrateur qui possède ce rôle de l'attribuer.

Toujours bloqué ?

Contactez le support Wakastart avec :

  • l'identifiant de la ressource concernée (vlt_…, doc_…, shr_…) ;
  • l'heure de l'appel, la méthode, le chemin et le code HTTP ;
  • le corps de la réponse d'erreur.

N'envoyez jamais de jeton, de document ni de donnée de patient au support.