Connecter Hospitalidée à Pro Santé Connect avec un rapprochement par RPPS

Hospitalidée est une plateforme française d’avis patients, utilisée par les professionnels et établissements de santé pour gérer leur présence en ligne et répondre aux avis.

Une connexion par email et mot de passe n’apportait pas le niveau d’assurance attendu pour cet espace professionnel. Pro Santé Connect vérifie l’identité à partir de données issues de l’Annuaire Santé et laisse l’utilisateur choisir entre une carte CPS physique et l’application mobile e-CPS. La plateforme peut ainsi s’appuyer sur une identité professionnelle déjà vérifiée sans mettre en place son propre contrôle de justificatifs.

OpenID Connect fournit un claim sub qui identifie techniquement l’utilisateur auprès du fournisseur d’identité. Hospitalidée avait toutefois besoin d’un identifiant professionnel stable, déjà présent sur les comptes concernés et pertinent pour son métier. Le RPPS a donc été retenu pour rapprocher l’identité PSC du compte applicatif.

Pro Santé Connect vérifie l’identité et renvoie les attributs professionnels de la personne authentifiée. Hospitalidée retrouve ensuite le compte correspondant, crée sa propre session et applique ses règles d’autorisation.

En mars 2026, l’ANS a remplacé la valeur du claim sub par un UUID purement technique, décorrélé de l’identifiant métier. Aucun compte Hospitalidée n’a dû être migré : le rapprochement reposait déjà sur le RPPS.

Le raccordement utilise OpenID Connect, la couche d’identité construite sur OAuth 2.0. L’application redirige le navigateur vers PSC. Le professionnel choisit une carte CPS avec son lecteur ou confirme la demande dans l’application e-CPS.

Une fois l’authentification validée, PSC redirige le navigateur vers l’URL de callback déclarée avec un code d’autorisation. Un client OIDC éprouvé vérifie state, échange le code, puis contrôle la signature, les claims iss et aud, l’expiration et le nonce de l’ID Token avant de normaliser les attributs professionnels reçus. Le serveur utilise ensuite le RPPS pour retrouver le compte et ouvrir la session applicative.

type Rpps = string & { readonly __brand: 'Rpps' }

type NormalizedPscIdentity = {
    rpps: Rpps
}

async function openProfessionalSession(
    identity: NormalizedPscIdentity,
) {
    const account = await professionalAccounts.findUniqueByRpps(identity.rpps)
    if (!account) throw new Error('Unknown RPPS')

    return sessions.create({
        accountId: account.id,
        authenticatedBy: 'psc',
    })
}

Ce type représente l’identité normalisée après validation des jetons OIDC. Seule une valeur RPPS préalablement validée reçoit ce type brandé ; le compte est ensuite retrouvé via un index unique sur le RPPS. Le rapprochement ne dépend pas du format du claim sub.

La mission de référent technique a couvert les échanges avec l’ANS, la configuration des environnements et la validation des deux modes de connexion. Les essais ne se sont pas limités à des réponses OIDC simulées : ils ont inclus des cartes CPS, leurs lecteurs et des identités e-CPS de test.

1. 01

   Obtenir l’accès à l’environnement d’intégration

   Le service est enregistré auprès de l’ANS, qui fournit l’accès et les paramètres nécessaires aux premiers tests d’intégration.

2. 02

   Configurer le client OpenID Connect

   Les URL de callback et la configuration du client sont isolées par environnement avec les valeurs fournies lors du raccordement.

3. 03

   Vérifier le parcours carte CPS

   Les cartes CPS de test et leurs lecteurs permettent de contrôler la mire de connexion, la lecture de la carte et la saisie du code confidentiel.

4. 04

   Vérifier le parcours e-CPS

   Des identités e-CPS de test dans l’environnement bac à sable et l’application mobile permettent de reproduire la confirmation de connexion sans carte physique.

5. 05

   Conserver une capacité de test

   Le contrat Éditeurs & Intégrateurs de Byrds Consulting avec l’ANS, les cartes de test et les lecteurs associés permettent de poursuivre ces intégrations sur d’autres produits de santé.

Cette recette couvre la redirection vers PSC, les deux modes de connexion et le retour vers Hospitalidée, en complément des échanges HTTP simulés.

Le parcours livré permet aux professionnels de santé d’accéder à leur compte Hospitalidée avec une carte CPS ou une e-CPS. La plateforme délègue la vérification de leur identité à Pro Santé Connect et évite de demander puis de contrôler elle-même des justificatifs professionnels.

À partir du RPPS renvoyé par PSC, Hospitalidée retrouve le compte existant. La session et les autorisations restent gérées dans l’application.