Cartes CPS de test, e-CPS BAS et kits intégrateurs : préparer une recette Pro Santé Connect
Une intégration Pro Santé Connect ne se valide pas avec un unique compte de démonstration. Il faut des identités représentatives, des scénarios de connexion, un environnement de test et, selon les parcours, des cartes CPx de test, une e-CPS de Bac à Sable, des profils créés dans EDIT et des certificats logiciels de test.
La carte de test n’est pas toujours indispensable. Pour de nombreux parcours web ou mobiles, une identité créée dans EDIT puis activée en e-CPS BAS permet de recetter l’authentification sans lecteur de carte. En revanche, un kit intégrateur ou une carte CPx devient nécessaire quand vous devez reproduire un parcours physique, vérifier la compatibilité d’un poste équipé, couvrir plusieurs profils prédéfinis ou tester les contraintes d’un logiciel métier historique.
Vous n’avez pas encore déterminé si PSC est obligatoire ou requis par vos raccordements ? Commencez par Intégrer Pro Santé Connect : obligations, périmètre et méthode pour une medtech. Cet article explique le cadre de qualification, la différence entre PSC et certificats, et les implications d’architecture.
Pourquoi les moyens de test sont une dépendance de projet
Le même scénario se répète dans de nombreuses équipes : le flux OpenID Connect est développé, l’IHM affiche le bouton de connexion, le callback fonctionne avec un compte de développement, puis la recette réelle est reportée car il manque une identité de test, une e-CPS, un lecteur, une carte CPx, les droits nécessaires ou un certificat logiciel.
Ce retard est évitable. Les moyens de test doivent figurer dans le backlog initial, au même titre que la configuration OIDC, la gestion des sessions, les secrets, les règles de rapprochement de comptes et les tests automatisés.
Ils permettent de valider :
- la connexion par carte CPx ou e-CPS ;
- les informations d’identité reçues dans les jetons ;
- la création et le rapprochement du compte local ;
- les contextes d’exercice et droits appliqués par votre produit ;
- les annulations, erreurs, expirations et reprises de session ;
- les scénarios d’identifiants multiples ou historiques ;
- les appels applicatifs qui nécessitent des certificats logiciels de test ;
- les dépendances avec INS, MSSanté, Annuaire Santé ou DMP / Mon espace santé.
Un environnement de test ne remplace pas une stratégie de recette. Il fournit les éléments nécessaires pour exécuter cette stratégie.
Les moyens de test disponibles
L’ANS propose, dans le cadre du socle technique CPS, des produits de test utilisables pour tester et recetter des applications et systèmes d’information : cartes CPx de test et certificats de test. La démarche officielle F414 permet de commander des kits intégrateurs, des cartes individuelles ou des jeux de cartes, ainsi que des certificats logiciels de test.
| Moyen de test | Rôle | Cas d’usage typique |
|---|---|---|
| Kit intégrateur | Ensemble de cartes CPx de test couvrant plusieurs profils | Éditeur, LPS, DPI, DUI ou équipe devant couvrir plusieurs rôles professionnels |
| Carte CPx individuelle | Carte physique pour un parcours ciblé | Test carte + lecteur sur un poste ou un navigateur donné |
| Jeu de cartes de test | Cartes pour les scénarios multi-profils et multi-contextes | Produit gérant plusieurs professions, structures ou rôles |
| e-CPS BAS | Moyen mobile d’authentification dans le Bac à Sable PSC | Recette récurrente d’un SaaS web ou d’une application mobile |
| Identité fictive EDIT | Profil de test sur mesure dans une organisation cloisonnée | Simulation d’exercices, activités, lieux et identifiants spécifiques |
| Certificat logiciel de test | Identité applicative ou organisationnelle dans les environnements de test | Flux serveur, téléservices et échanges nécessitant un certificat |
La démarche F414 couvre les cartes de test sous forme de kits intégrateurs, de cartes individuelles et de jeux de cartes. Elle prévoit également des certificats logiciels de test et propose CPS3 ou CPS4 selon le besoin.
Carte CPx, e-CPS BAS et EDIT : qui sert à quoi ?
La carte CPx de test : couvrir un parcours physique
Une carte CPx de test est utile si votre logiciel doit être validé avec la chaîne physique complète : carte, lecteur, middleware, système d’exploitation, navigateur ou application cliente. Elle peut servir à s’authentifier sur les services raccordés au Bac à Sable PSC et à initier certains parcours d’activation e-CPS BAS.
Prévoyez-la notamment pour :
- un logiciel métier installé sur un poste de travail ;
- un contexte hospitalier où les lecteurs restent un composant important du poste utilisateur ;
- une vérification de compatibilité avec une génération de carte et un lecteur donnés ;
- une recette où l’utilisateur final utilisera réellement une carte physique ;
- un besoin de reproduire un dysfonctionnement spécifique lié au poste ou au middleware.
L’e-CPS BAS : industrialiser les tests de connexion
L’e-CPS BAS est le moyen le plus pratique pour rejouer fréquemment des parcours de connexion sur un produit web ou mobile. Elle évite de partager un lecteur de carte et réduit la friction pour les développeurs, QA et product owners qui doivent exécuter des tests de non-régression.
L’ANS indique que les identités fictives créées dans EDIT peuvent activer une e-CPS de test. L’identité doit être active : l’adresse email et le numéro de téléphone associés doivent être validés.
L’e-CPS BAS n’élimine pas le besoin de carte dans tous les projets. Elle complète la couverture : utilisez-la pour les tests quotidiens, et conservez les cartes CPx pour les parcours physiques, les postes équipés et les contrôles de compatibilité.
EDIT : construire les identités qui correspondent à votre produit
EDIT est l’outil de gestion des identités de test du Bac à Sable Pro Santé Connect. Il permet à une organisation de créer et de gérer ses propres professionnels fictifs dans un environnement cloisonné.
EDIT propose trois niveaux de création :
- Mode rapide : profils proches des familles de professionnels disponibles via les cartes de test.
- Mode avancé : définition d’un professionnel, de ses exercices, activités et lieux d’exercice.
- Mode expert : édition du profil d’identité au format JSON.
L’intérêt d’EDIT est de sortir du test « utilisateur unique ». Vous pouvez tester une situation professionnelle représentative de votre produit : professionnel exerçant dans plusieurs structures, plusieurs activités, contexte établissement et libéral, attributs spécifiques, ou scénario de migration d’identifiants.
Une identité fictive ne devient active qu’après validation de l’email et du mobile. Utilisez donc des coordonnées de test pérennes, accessibles à l’équipe, pas l’adresse personnelle ou le téléphone d’un unique prestataire.
Choisir votre dispositif de recette
| Situation produit | Dispositif recommandé | Ce qu’il faut vérifier |
|---|---|---|
| SaaS web pour professionnels | EDIT + e-CPS BAS ; une carte CPx en complément | Claims reçus, création/rapprochement de compte, droits locaux |
| Application mobile professionnelle | EDIT + e-CPS BAS | Activation, changement d’appareil, annulation, reprise et déconnexion |
| LPS, DPI, DUI ou poste équipé | Carte CPx de test + lecteur compatible ; EDIT pour compléter les profils | Compatibilité OS, middleware, navigateur/application et conditions réelles de déploiement |
| Produit multi-profils / multi-structures | Kit intégrateur ou jeu de cartes + identités EDIT | Matrice rôle × exercice × droits × résultat attendu |
| Migration de comptes historiques | EDIT avec identifiants secondaires otherIds | Rapprochement sans doublon et maintien de l’historique/droits |
| Appels vers INS, DMP / Mon espace santé ou messageries | Certificats logiciels de test, plus PSC si un professionnel intervient | Séparation par environnement, coffre de secrets, rotation et autorisations |
Commander cartes et certificats : la démarche F414
La commande des moyens d’identification électronique de test s’effectue via la démarche en ligne F414. Elle couvre :
- les kits intégrateurs ;
- les cartes CPS de test individuelles ;
- les jeux de cartes de test ;
- les certificats logiciels de test.
La demande permet de choisir des CPS3 ou CPS4. Le choix doit être justifié par vos contraintes de compatibilité : génération de carte supportée par le logiciel, lecteurs disponibles, middleware, systèmes d’exploitation, parc client et calendrier de migration.
L’ANS affiche sur F414 des délais indicatifs d’instruction : environ 23 heures dans le meilleur cas, environ 4 jours lorsque des échanges sont nécessaires, et jusqu’à environ 3 mois pour les dossiers incomplets ou demandant de nombreux échanges. Prévoyez les moyens de test avant le sprint de recette ; ne construisez pas le planning sur le délai minimal.
Informations à préparer avant la commande
- L’organisation porteuse du produit et le responsable opérationnel.
- Les environnements de test concernés.
- Les profils professionnels et situations d’exercice à couvrir.
- Les scénarios nécessitant une carte physique.
- Les scénarios suffisants avec une e-CPS BAS.
- Les besoins de certificats logiciels et les téléservices associés.
- Les administrateurs habilités à recevoir, installer et gérer les certificats.
- Les postes, lecteurs, navigateurs, systèmes d’exploitation et appareils mobiles testés.
- Les coordonnées de test pérennes et contrôlées par l’organisation.
Commander un kit ou une carte est donc le démarrage d’un lot de recette, pas son aboutissement : installation, gouvernance des supports, création des identités, activation e-CPS, jeux de données, exécution des scénarios et gestion des anomalies restent à réaliser.
Mettre en place votre organisation EDIT
Pour créer des identités de test dans EDIT, il faut disposer d’un compte actif et appartenir à une organisation. Cette organisation cloisonne les identités et les coordonnées associées : seuls ses membres y ont accès. Elle dispose d’un ou plusieurs managers qui gèrent les demandes d’adhésion et les membres.
Procédure initiale
- Créez un compte EDIT et validez l’adresse email.
- Créez l’organisation de test du fournisseur de service, ou rejoignez l’organisation existante.
- Désignez au moins deux managers : évitez qu’un départ ou une indisponibilité bloque la gestion des identités.
- Créez une identité simple en mode rapide afin de valider le parcours complet avant de modéliser tous les cas complexes.
- Associez et validez une adresse email et un numéro de mobile de test : sans cela, l’identité reste inactive.
- Activez l’e-CPS BAS avec l’identifiant national de cette identité.
- Créez ensuite les profils avancés nécessaires à vos scénarios métier.
- Versionnez la matrice des identités de test et les scénarios associés dans votre documentation projet.
Tester les identifiants multiples et les comptes historiques
Un vrai risque de production est la création d’un second compte local pour un professionnel déjà connu de votre application sous un identifiant différent. Ce risque est fréquent durant les transitions d’identifiants ou lorsque l’application a été déployée avant le raccordement PSC.
EDIT permet d’ajouter des identifiants secondaires avec otherIds. Vous pouvez ainsi tester une bascule ADELI/RPPS ou d’autres situations où votre politique de rapprochement doit reconnaître plusieurs identifiants pour une même personne.
Dans le Bac à Sable, l’e-CPS BAS est activée avec l’identifiant principal. Les identifiants secondaires deviennent utilisables pour l’authentification après activation de l’e-CPS ; lorsqu’ils évoluent, il faut désactiver puis réactiver l’e-CPS BAS pour prendre en compte le changement.
Couvrez au minimum les scénarios suivants :
- première connexion et création contrôlée du compte local ;
- reconnexion avec l’identifiant principal ;
- reconnexion avec un identifiant secondaire lorsque le produit gère les comptes historiques ;
- absence de doublon et conservation de l’historique ;
- changement de contexte d’exercice ;
- contrôle des droits après rapprochement.
Enregistrer une carte de test dans EDIT
Une carte CPx de test peut être utilisée pour l’authentification sur le portail e-CPS BAS et les services raccordés au Bac à Sable PSC. Elle peut aussi être ajoutée dans une organisation EDIT afin de lui associer des coordonnées de contact.
Après validation des coordonnées, l’e-CPS de test associée à cette carte peut être activée sans lecteur. Cette combinaison est utile : vous gardez la carte pour les tests physiques et vous facilitez les tests récurrents de l’équipe via e-CPS BAS.
Procédure pratique :
- Ouvrez l’organisation EDIT, puis l’onglet « Cartes de test ».
- Ajoutez la carte à partir de son identifiant national.
- Associez une adresse email et un numéro mobile de test contrôlés par l’organisation.
- Validez les deux coordonnées avec les codes transmis.
- Activez l’e-CPS BAS associée, si le scénario le nécessite.
Une carte déjà enregistrée dans une autre organisation ne peut pas être enregistrée une seconde fois. Attribuez donc clairement la propriété de la carte, les coordonnées associées et la responsabilité opérationnelle : une carte associée au téléphone d’un prestataire externe peut devenir un blocage de recette au moment le moins opportun.
Ne pas réduire la recette à PSC
PSC authentifie le professionnel ; il ne remplace ni l’identité patient, ni les certificats applicatifs, ni l’annuaire des professionnels, ni les exigences de contenu ou de transport propres aux autres services socles.
Exemple : un professionnel connecté à une application doit envoyer un document médical via MSSanté.
- PSC authentifie le professionnel et permet de créer sa session applicative.
- Annuaire Santé permet de rechercher l’adresse MSSanté du destinataire si elle n’est pas déjà connue.
- MSSanté API LPS transporte le message ; la BAL
PERouORGutilise le jeton PSC, tandis qu’une BALAPPutilise un certificatORG AUTH_CLI. - INS est indispensable si l’envoi concerne un usager de Mon espace santé : l’adresse patient est construite à partir d’une INS qualifiée.
- IHE_XDM et les règles documentaires s’appliquent aux documents de santé transmis.
Checklist de recette
- Le besoin PSC est qualifié à partir du périmètre réglementaire et des services cibles.
- Les parcours à couvrir sont listés : première connexion, reconnexion, changement de contexte, annulation, erreur, expiration et déconnexion.
- Les profils professionnels, identifiants et contextes d’exercice nécessaires sont définis.
- Le bon dispositif est choisi : e-CPS BAS, carte CPx, kit intégrateur, jeu de cartes, EDIT et/ou certificat logiciel.
- Les cartes ou certificats nécessaires ont été commandés via F414 suffisamment tôt.
- Les lecteurs, middlewares, postes, navigateurs et appareils mobiles sont disponibles.
- L’organisation EDIT existe, avec au moins deux managers.
- Les identités EDIT sont actives : email et mobile validés.
- Les e-CPS BAS sont activées et attribuées à des coordonnées de test pérennes.
- Les scénarios
otherIdssont exécutés si des comptes historiques ou une transition ADELI/RPPS existent. - Les certificats, secrets, PIN et accès sont stockés dans un coffre adapté, hors dépôt de code.
- Les dépendances INS, MSSanté, Annuaire Santé, DMP / Mon espace santé et autres services socles figurent dans le plan de recette.
- Les critères d’acceptation fonctionnels, techniques et de sécurité sont versionnés avant la campagne de recette.
Les erreurs à éviter
- Commander les cartes au démarrage de la recette. Les délais dépendent de la complétude de la demande et des échanges éventuels.
- N’utiliser qu’un seul profil “happy path”. Vous ne couvrirez ni les différents rôles, ni les exercices multiples, ni les comptes historiques.
- Oublier la validation email/mobile dans EDIT. L’identité demeure inactive et l’e-CPS ne peut pas être utilisée.
- Associer les moyens de test à un individu plutôt qu’à l’organisation. Les départs, absences ou changements de prestataire deviennent alors des incidents de recette.
- Tester uniquement l’écran de connexion. Les risques se situent aussi dans les claims, le rapprochement des comptes, les autorisations et les reprises de session.
- Confondre carte CPx et certificat logiciel. La carte/e-CPS couvre une identité professionnelle ; le certificat couvre un usage applicatif ou organisationnel selon le service cible.
- Conclure que PSC valide les autres services socles. Il faut recetter séparément INS, Annuaire Santé, MSSanté, documents et téléservices concernés.
Conclusion : industrialiser les prérequis de recette
Les cartes CPx, e-CPS BAS, identités EDIT et certificats logiciels ne sont pas des accessoires de démonstration. Ce sont des composants d’un environnement de recette qui doit être disponible avant que le développement ne soit terminé.
Préparez-les comme vous préparez une base de données de test, un environnement d’intégration ou un pipeline CI : avec une propriété organisationnelle claire, un inventaire, une politique de renouvellement, des accès maîtrisés et des scénarios versionnés.
Pour revenir au cadre de qualification et vérifier si PSC est réellement obligatoire ou requis dans votre cas, consultez Intégrer Pro Santé Connect : obligations, périmètre et méthode pour une medtech.
FAQ
Faut-il obligatoirement commander une carte CPS de test pour intégrer PSC ?
Non. Une identité créée dans EDIT avec une e-CPS BAS est suffisante pour de nombreux parcours de recette web et mobile. Une carte CPx de test est nécessaire lorsque vous devez couvrir un parcours physique avec carte, lecteur et poste, ou lorsqu’un scénario de compatibilité l’exige.
Quelle est la différence entre un kit intégrateur et une carte individuelle ?
Un kit intégrateur regroupe des cartes de test permettant de couvrir plusieurs profils ou scénarios. Une carte individuelle sert à tester un cas précis. Le bon choix dépend de la diversité des professionnels, des structures et des parcours que votre application doit prendre en charge.
EDIT remplace-t-il les cartes de test ?
Non. EDIT permet de créer des identités fictives et d’activer une e-CPS BAS pour des scénarios de test flexibles. Il ne remplace pas une carte physique lorsqu’il faut valider un lecteur, un middleware ou un parcours réellement basé sur carte CPx.
À quoi servent les certificats logiciels de test ?
Ils couvrent les flux applicatifs ou organisationnels qui exigent un certificat dans les environnements de test. Ils sont distincts de PSC, qui authentifie un professionnel personne physique. Le certificat précis à demander dépend du service cible et de son référentiel de raccordement.
Quel délai prévoir pour commander des moyens de test ?
L’ANS affiche des délais indicatifs allant d’environ 23 heures pour le meilleur cas à environ quatre jours si des échanges sont nécessaires, et jusqu’à trois mois pour un dossier incomplet ou demandant de nombreux échanges. Il faut donc anticiper la demande et ajouter une marge de planning.
Comment le sujet PSC se relie-t-il à MSSanté ?
Pour une BAL MSSanté personnelle ou organisationnelle, le professionnel s’authentifie avec PSC et le jeton est utilisé dans le mécanisme XOAUTH2 de l’API LPS. Cela ne couvre toutefois pas l’annuaire, le choix de BAL, les usages patients liés à l’INS, ni les contraintes documentaires. Voir le guide MSSanté et Annuaire Santé FHIR.
Sources officielles
- ANS – Socle technique CPS : https://esante.gouv.fr/produits-services/socle-technique-cps
- Démarche F414 – Commande de moyens d’identification électronique de test : https://demarche.numerique.gouv.fr/commencer/f414
- ANS – EDIT, gestion des identités pour l’e-CPS de test : https://esante.gouv.fr/ens/offre/pro-sante-connect/edit-gestion-identites
- ANS – Pro Santé Connect : https://esante.gouv.fr/produits-services/pro-sante-connect