Articles on DevBox-Santé

Mise en place de ProSantéConnect

Tue, 04 Mar 2025 00:00:00 +0000

Comme il est écrit sur la page d’information de l’ANS, https://industriels.esante.gouv.fr/produits-et-services/pro-sante-connect :

“Pro Santé Connect (PSC) est le Fournisseur d’Identité (FI) de la santé. C’est un service standard (protocole OpenID) et gratuit, développé et maintenu par l’ANS

Grâce à Pro Santé Connect, vos utilisateurs professionnels du monde de la santé, recensés dans l’Annuaire Santé*, peuvent s’identifier de manière simple, sécurisée et unifiée. Ils se connectent aux services numériques en santé, en passant de l’un à l’autre de manière fluide.

InvariableId dans le Volet à Structuration Minimale

Wed, 06 Nov 2024 00:00:00 +0000

Afin de gérer dans des systèmes de plus en plus interopérables, dont les documents de santé transitent d’applications à applications. Le versionning de document dans le DMP et pour la MS-Santé est devenu importante.

Il faut donc pouvoir retrouver les différentes versions d’un même lot de documents.

MOS

Pour le modèle d’objets de santé on retrouve cette notion dans la Fiche (https://mos.esante.gouv.fr/19.html#_71e617d8-ae19-49b8-9346-924af8194a62) :

Donc si on reprend les termes du MOS :

Jongler avec les Jeux De Valeurs et Schematrons de l'ANS

Mon, 29 Jul 2024 00:00:00 +0000

Générer des documents HL7 - CDA (Clinical Document Architecture) conforme pour les différents schematrons des différents outils proposés par l’ANS ce n’est pas une mince affaire.

En effet, pour générer un document CDA conforme, il faut :

une syntaxe correcte
une sémantique correcte
un vocabulaire correct.

C’est simple, si vous remplissez ces trois critères vos documents sont bons.

Une syntaxe correcte

Ici, on commence tranquillement, le document généré doit être conforme au schéma cda.xsd fournit par HL7. Il y a une seule version de ce schéma et il est partagé par tous.

Vers un déploiement continue de la DevBox-Santé au sein d'Airmes

Tue, 25 Jun 2024 00:00:00 +0000

Avec les équipes d’Airmes, logiciel médico-social, client de la première heure de la DevBox-Santé, nous travaillons afin de raccourcir le délais entre la correction et la mise en production de la solution Airmes et notamment leur intégration des services socles du SEGUR. Nous avons chacun de notre côté automatisé un maximum les tâches de build/intégration/déploiement de nos produits.

Voici une description des différentes étapes, de la mise en place d’une correction/évolution vers un déploiement au sein de la solution Airmes.

Rétention des messages SOAP en cas d'incident de production DMP

Fri, 21 Jun 2024 00:00:00 +0000

Dorénavant depuis la prise en charge de la demande DMP-440 : pouvoir remonter la conversation soap à l’éditeur en réponse pour analyse, il est possible de récupérer l’échange SOAP grâce à deux nouveaux points d’entrée dans les APIs REST :

Le premier permet de récupérer la liste des erreurs survenues et qui sont sauvegardés sur le disque de la DevBox-Santé :

get {
  url: {{base_url}}/dmp/errors
  body: none
  auth: none
}

Retourne une Map de fichiers horodatés indexés par l’identifiant de l’échange SOAP (exchangeId), comme par exemple:

Pourquoi Bruno ? Mais c'est qui ?

Tue, 04 Jun 2024 00:00:00 +0000

Parceque, nous avons eu le même constat que les développeurs de Bruno : https://www.usebruno.com/manifesto

Parceque, nous voulons partager simplement nos exemples d’utilisation de nos apis.

En effet, voici les choix qui nous étaient offerts jusqu’à présent :

Donner des exemples curl dans la documentation, c’est fastidieux et difficile à maintenir.
Partager des collections via Postman, choix convenable mais avec les contraintes suivantes :
- modifications multiples fastidieuses
- nécessite un compte propriétaire
- risque de partage de login/mot de passe accidentel important
- non maitrise des modifications dans le temps
- gestion des forks obscurs.
- Les développeurs de Bruno l’explique mieux que moi : https://www.usebruno.com/compare/bruno-vs-postman

En clair, en tant que git addict nous devenons Bruno addict.

Intégrer la DevBox-Santé DMP-UI

Mon, 15 Jan 2024 00:00:00 +0000

Afin de transiter les documents entre le LPS intégrateur et la DMP_UI, on profite de la DevBox-Santé qui tourne pour ajouter des controllers.

Authentification passage de contexte

Échange de contexte PS / Patient entre le LPS intégrateur appelant et la DevBox-Santé DMP-UI

Diagramme de séquences

Exemple

Envoi vers le DMP via la DMP_UI

Diagramme de séquences

Exemple

lors de l’envoi d’une soumission de document au travers de la websocket par le LPS intégrateur une notification apparait dans la DMP-UI :

Installer l'IGC santé dans Acrobat reader

Fri, 13 Oct 2023 00:00:00 +0000

La DevBox-santé CPS permet la signature de document PDF en utilisant les clés fournies dans les cartes. Par contre, par défaut Acrobat Reader d’Adobe ne reconnaît pas l’IGC Santé comme étant une autorité de certification valide. De plus, l’installation de la cryptolib CPS, rajoute bien ces autorités dans les magasins systèmes telles que ceux de windows, ou Firefox, par exemple :

Mais rien dans les magasins d’Acrobat Reader. Il faut donc l’ajouter manuellement.

Migration TLSv1.3 dans les différents téléservices

Mon, 07 Aug 2023 00:00:00 +0000

L’accès aux différents TLSi exige désormais la version TLSv1.3, et impose des nouvelles suites cryptographiques acceptées pour le TLSv1.3 :

TLS13-AES128-GCM-SHA256
TLS13-AES256-GCM-SHA384
TLS13-CHACHA20-POLY1305-SHA256

La configuration de l’environnement java de la Devbox-santé va suivre ces nouvelles prérogatives dans les futures versions des tools IGC santé 1.3.0.

Néanmoins, la DevBox-santé est configurée par défaut pour utiliser le protocole TLSv1.2 mais utilise une JRE (Java Runtime Environnement) supportant le TLSv1.3.

Des tests forçant l’usage du protocole TLSv1.3 pour le composant INSi sur l’environnement de qualification ont été réalisés avec succès.

Les identifiants nationaux expliqués

Tue, 09 May 2023 00:00:00 +0000

La structure des différents Identifiants nationaux sont décrits dans le MOS.

Le Cadre d’Intéropérabilité des Systèmes d’Information de Santé a dédié une documentation pour définir toutes les méta données des structures et personnel de santé : https://esante.gouv.fr/annexe-sources-des-donnees-personnes-et-structures

Concernant l’IdNat_PS et l’IdNat_Struct, cette documentation fait dorénavant référence au MOS :

IdNat_Struct : https://mos.esante.gouv.fr/4.html#_88711c28-b4b0-41d6-abd5-bf4e3e9b2e6d
IdNat_PS : https://mos.esante.gouv.fr/2.html#_b1a86104-5f11-47d6-bd74-cab5b25a6e16

IdNat_Struct

Dont voici l’impression écran à la rédaction de cet article :

IdNat_PS

Dont voici l’impression écran à la rédaction de cet article :

INSi : Datamatrix dans Docker

Wed, 01 Mar 2023 00:00:00 +0000

Les datamatrix générées par nos outils, ne permettent pas d’accéder à l’environnement graphique et génère une erreur de chargement de FONT. En effet, un appel au ins datamatrix controller :

curl -X POST "http://localhost:8080/insi/v2/datamatrix/jpg?sizeInPx=128" -H "accept: */*" -H "Content-Type: application/json" \
-d "{ \"matriculeINS\": { \"valeur\": \"1010663220754\", \"cle\": \"60\", \"identifiantSysteme\": \"1.2.250.1.213.1.4.8\" }, \"traitsIdentite\": { \"nomFamille\": \"D'ARTAGNAN DE L'HERAULT\", \"prenomActeNaissance\": \"PIERRE-ALAIN GUNTHER\", \"sexeAdministratif\": \"M\", \"dateNaissance\": \"2001-06-17\", \"lieuNaissance\": \"63220\" }}"

Peut générer l’erreur décrite dans le stackoverflow : https://stackoverflow.com/questions/69814102/spring-boot-in-docker-build-by-buildpack-cannot-load-font

DMP : Homologation 2.6.1

Wed, 30 Nov 2022 00:00:00 +0000

Lors de notre dernier passage d’homologation, nous avons été fiers de cocher toutes les cases.

Mais ce n’est pas fini, nous apportons désormais une API permettant de générer facilement :

Les volets de CR-BIO
Les volets de Note de vaccination

SEGUR : la DevBox-Santé dans le référentiel d’exigences Hopital

Thu, 09 Jun 2022 00:00:00 +0000

Outils XDM

Scenario HOP-11

Dans le Référentiel d’exigences – Hôpital – DPI – Annexe 1 – Vague 1 (xlsx), on peut lire l’exigence HOP-11.

Le système DOIT proposer une interface pour intégrer, a minima de façon manuelle, voire de façon automatique, les documents en CDAR2 N1 reçus via MSSanté au format IHE_XDM.zip.

Cette exigence demande de pouvoir récupérer un fichier attaché au format XDM.zip d’un document reçu de la Messagerie Sécurisé de Santé. Récupérer ce fichier et l’interpréter via la DevBox-Santé rien de plus simple, il suffit de réaliser un POST HTTP à la boite à outils XDM :

Intégration de l’annexe CI-SIS INS dans la DevBox-santé DMP

Fri, 20 May 2022 00:00:00 +0000

La prise en charge de l’identifiant national de santé (INS) dans les standards d’interopérabilité et les volets du CI-SIS défini dans l’annexe CISIS de l’ANS a impliqué quelques changements dans la DevBox-Santé DMP (version 4.7.7).

Voici l’interprétation que nous avons faîtes de la gestion des noms et prénoms de l’annexe INS vers la génération CDA et XDS :

Supposons les informations du patient suivantes :

Nom de Famille : nomNaissance (origine TS INSi)
Prénoms de l’acte de naissance :  Prenom1 Prenom2 (origine TS INSi)
Premier Prénom de l’acte de naissance : Prenom1 (origine TS INSi)
Nom Utilisé : nomUtilise (origine CarteVitale / LPS)
Prénom Utilisé : PrenomUtilise (origine Carte Vitale / LPS)

Alors, le clinical document CDA contiendra : 

Vérification d’une signature CPS avec OpenSSL

Thu, 07 Apr 2022 00:00:00 +0000

La CPSFacade et son proxy REST Devbox-Santé-CPS expose un endpoint permettant de signer tout document. Mais une fois signé le contenu, comment en vérifier sa signature ?

Signature avec DevBox-Santé CPS

Supposons le texte à signer suivant stocker dans le fichier message.json:

{"message": "hello DevBox-Santé"}

Pour le signer vous allez utiliser le proxy cps de la DevBox-santé sur le port 9999, en CURL ça donne : 

curl -X POST "http://localhost:9999/cps/sign/for/SIGNATURE/with/SHA256WithRSA" -H  "accept: */*" -H  "Content-Type: application/json" --data @message.json --output signature.txt

C’est tout ce qu’il vous faut pour obtenir une signature et le fichier signature.txt contiendra la signature du message.json.

Discordance INS et pièce d'identité

Mon, 17 Jan 2022 00:00:00 +0000

Le GRIVES (Groupe Régional d’identitovigilance en santé) a sorti une fiche pratique en décembre 2021, pour expliquer comment gérer les discordances d’informations entre l’INS et l’identité présente sur une pièce d’identité. Elle informe sur l’origine des différentes discordances, leurs fréquences et donne la conduite à tenir en cas de discordance.

Comme par exemple, les discordances sur les dates de naissance :

Ou encore l’arbre décisionnel suivant :

Bien sur, ceci n’est qu’un petit exemple des informations que l’on peut trouver dans ce document.

DevBox-santé dans un environnement RDP/Citrix

Mon, 20 Sep 2021 00:00:00 +0000

Lors d’une session RDP / Citrix, il est possible qu’un executable installé puisse accéder aux différents ports USB d’un poste client. Pour celà, il faut réaliser un mapping des ports USB (https://superuser.com/questions/49285/access-local-usb-devices-from-a-remote-pc-via-remote-desktop, par exemple)

La DevBox-santé lancée dans un environnement Citrix/Windows RDP est accessible sur un numéro de port TCP commun à l’ensemble des sessions utilisateurs de ce serveur RDP.

Dans un environnement Citrix/RDP, il est donc important qu’une et une seule DevBox-santé soit lancée par poste utilisateur sur un numéro de port TCP différent, afin de faire le lien entre les lecteur branchés sur les ports USB du poste client et le port TCP utilisé :

Les métadonnées des documents du DMP

Thu, 10 Jun 2021 00:00:00 +0000

Pour comprendre comment les métadonnées des documents du DMP doivent être gérés, trois documents du Cadre d’intéropérabilité des Systèmes d’Information de Santé sont à étudier.

le [CI_PARTAGE] dont la version courante est 1.6 : décrit la manière d’intégrer le stantard XDS et XDM de l’IHE pour les données de santé en France
le [CI_STRU_ENTETE] dont la version courante est la 1.6 : décrit la manière d’intégrer le standard CDAr2 de HL7 international
le [CI_ANX_CDA] dont la version courante est la 1.4 : décrit les liens entre les métadonnées des deux standards.

Etude de cas

Event : l’acte médical à l’origine de la soumission d’un document

Les documents dans la DevBox-santé DMP sont représentés par un objet DMPCDocument. Dans ce DMPCDocument, nous allons nous intéresser à la propriété correspondant à l’acte médical à l’origine de la soumission dans le DMP : events.

eCPS > Intégration de ProSantéConnect

Tue, 01 Jun 2021 00:00:00 +0000

Lors de nos différentes intégrations, nous avons eu besoin de nous interfacer avec ProSantéConnect. En effet, ProSantéConnect fournit une bonne alternative à nos outils SSO basés sur la carte CPS et le standard PKCS11. J’ai donc voulu décrire un peu les mécanismes d’intégration dans spring-boot qui est notre framework de prédilection.

Or, nous n’avons que réaliser ce qui est déjà bien décrit par Patrice Blanchardie dans son blog. Nous vous invitons donc à lire son article.

Installation d'un lecteur PC/SC sous linux ubuntu

Tue, 01 Jun 2021 00:00:00 +0000

L’installation sous Linux, Ubuntu dans mon cas, d’un lecteur PC/SC.

En résumé, il faut installer les packages suivants :

J’ai récupéré les drivers spécifiques pour mon lecteur, un Liteo Olaqin dans mon cas : https://www.olaqin.fr/actualite-et-support-de-votre-liteo/

Télécharger le driver
Décompresser le driver
lire le Readme

Step 1 : Installation les librairies PC/SC. On trouve toutes les informations sur https://doc.ubuntu-fr.org/smartcards

sudo apt-get install pcscd
sudo apt-get install libpcsclite1
sudo apt-get install pcsc-tools

Check de l’installation : pcsc_scan

Installer > lancer la DevBox-Santé depuis un navigateur

Thu, 27 May 2021 00:00:00 +0000

Certains contextes nécessitent de lancer la DevBox-santé depuis le context client. Pour le faire nous nous servons des URI Scheme et de la possibilité d’enregistrer une application sur ce scheme. Exemple, dans Windows : https://docs.microsoft.com/en-us/previous-versions/windows/internet-explorer/ie-developer/platform-apis/aa767914(v=vs.85)?redirectedfrom=MSDN

Notre installer permet d’enregistrer un URI scheme à la DevBox-Santé, ainsi lorsque nous saisissons devboxsante:// dans notre navigateur :

Le navigateur nous propose de lancer l’exécutable sur le poste de l’utilisateur :

DMP > matrice habilitation

Thu, 20 May 2021 00:00:00 +0000

Les documents dans le DMP contient un certains nombres de métadata comme :

classCode
confidentialityCode
typeCode
formatCode
practiceSettingCode

La visibilité d’un document pour un acteur de santé dépend du typeCode, le typeCode est une spécialisation du classCode

Pour connaître les types de documents qui peuvent être accédés par un professionnel de santé, il faut suivre la matrice
des habilitations : https://www.dmp.fr/matrice-habilitation

Dans le guide d’intégration

Les conditions d’accès en lecture aux documents contenus dans le DMP d’un patient (sur lequel ils ont l’autorisation d’accès) dépendent des professions et spécialités des PS recueillies à partir de la carte CPS du PS. Ces règles sont définies dans la matrice d’habilitation [DMP-MHAB].

Diagnostiquer des problèmes d'accès aux lecteurs

Fri, 14 May 2021 00:00:00 +0000

Lors de l’utilisation de composants de lecteur CPS et de Carte Vitale de la DevBox-Santé, vous pouvez rencontrer des problèmes d’accés aux lecteurs.

Ces problèmes sont dues principalement à deux sources de problème.

La première, l’utilisation du galss qui nécessite d’être installé qu’une seule fois sur le poste et est très sensible aux différents ports physiques choisis pour connecter vos lecteurs.
La deuxième est que certains composants sont installés dans des versions anciennes.

Utiliser un lecteur homologué dans sa bonne version

Le GIE Sesam-Vitale tient une liste à jour des lecteurs homologués et dans quelle version applicative. Il vous faut repérer le lecteur et son application. Pour vous aider, voici le lien vers la liste des lecteurs en date de février 2021

Génération de la documentation de la DevBox-Santé

Wed, 12 May 2021 00:00:00 +0000

Ça y est nous avons pris le temps de regrouper la documentation disponible de la DevBox-Santé en un seul endroit. Cela donne ce site de documentation, qui pourra s’étoffer également d’articles parlant de sujet d’intégration de la DevBox-Santé d’une part, et d’intéropérabilité dans la santé d’autre part.

Les quelques sujets du moment (liste non exhaustive) :

Les Modèles d’Objets de Santé : https://esante.gouv.fr/interoperabilite/mos-nos
Les priorités du Ségur : https://solidarites-sante.gouv.fr/systeme-de-sante-et-medico-social/segur-de-la-sante-les-conclusions/ et comment les outils de la DevBox-Santé peuvent fournir des briques essentielles.

Si vous souhaitez générer un site de documentation similaire au notre, je ne peux que vous conseiller d’utiliser un thème Hugo. Le thème qui m’a paru le plus convaincant lors de la génération de ce site documentaire est Docsy.

Articles on DevBox-Santé

Mise en place de ProSantéConnect

InvariableId dans le Volet à Structuration Minimale

MOS

Jongler avec les Jeux De Valeurs et Schematrons de l'ANS

Une syntaxe correcte

Vers un déploiement continue de la DevBox-Santé au sein d'Airmes

Rétention des messages SOAP en cas d'incident de production DMP

Pourquoi Bruno ? Mais c'est qui ?

Intégrer la DevBox-Santé DMP-UI

Authentification passage de contexte

Diagramme de séquences

Exemple

Envoi vers le DMP via la DMP_UI

Diagramme de séquences

Exemple

Installer l'IGC santé dans Acrobat reader

Migration TLSv1.3 dans les différents téléservices

Les identifiants nationaux expliqués

IdNat_Struct

IdNat_PS

INSi : Datamatrix dans Docker

DMP : Homologation 2.6.1

SEGUR : la DevBox-Santé dans le référentiel d’exigences Hopital

Outils XDM

Scenario HOP-11

Intégration de l’annexe CI-SIS INS dans la DevBox-santé DMP

Vérification d’une signature CPS avec OpenSSL

Signature avec DevBox-Santé CPS

Discordance INS et pièce d'identité

DevBox-santé dans un environnement RDP/Citrix

Les métadonnées des documents du DMP

Etude de cas

Event : l’acte médical à l’origine de la soumission d’un document

eCPS > Intégration de ProSantéConnect

Installation d'un lecteur PC/SC sous linux ubuntu

Step 1 : Installation les librairies PC/SC. On trouve toutes les informations sur https://doc.ubuntu-fr.org/smartcards

Installer > lancer la DevBox-Santé depuis un navigateur

DMP > matrice habilitation

Dans le guide d’intégration

Diagnostiquer des problèmes d'accès aux lecteurs

Utiliser un lecteur homologué dans sa bonne version

Génération de la documentation de la DevBox-Santé

SEGUR : la DevBox-Santé dans le référentiel d’exigences Hopital

Intégration de l’annexe CI-SIS INS dans la DevBox-santé DMP

Vérification d’une signature CPS avec OpenSSL