Bob le développeur
Estimer

FranceConnect v2 : guide d'intégration pour les apps santé (2026)

Antoine Auffray

10/04/2026 · Mis à jour le 17/11/2026

FranceConnect v1 est arrêté. La DINUM avait programmé sa fin pour septembre 2025, au terme d'une migration ouverte un an plus tôt, et son hôte d'intégration ne répond plus. Toute intégration se fait désormais en v2. Pour un service de santé, elle commence par une question que la technique ne règle pas : FranceConnect, ou FranceConnect+ ?

Chez Bob le développeur, on utilise FranceConnect pour authentifier les patients sur des plateformes de téléconsultation. Cet article couvre l'intégration complète en v2 : le choix du niveau, les endpoints, les jetons signés, la déconnexion, une implémentation NestJS et les critères de qualification.

L'essentiel :

  • Sur un service de santé, FranceConnect seul ne suffit pas : il faut FranceConnect+ ou un second facteur
  • Une entreprise privée doit justifier d'un cadre juridique pour être habilitée
  • acr_values, state et nonce sont obligatoires dans la requête d'autorisation
  • L'id_token et la réponse /userinfo sont des JWT signés, dont la signature se vérifie
  • Le callback reçoit un paramètre iss en plus de code et state
  • La déconnexion passe par /api/v2/session/end, avec trois paramètres obligatoires

FranceConnect en 2 minutes : ce que les développeurs doivent savoir

FranceConnect est le fédérateur d'identité de l'État français, opéré par la DINUM. Il permet aux usagers de s'authentifier sur votre service avec un compte qu'ils ont déjà : impots.gouv.fr, Ameli.fr, MSA, L'Identité Numérique La Poste, France Identité ou TrustMe. Vous ne choisissez pas cette liste, et vous ne savez pas quel fournisseur d'identité l'usager a utilisé.

Le protocole est OpenID Connect 1.0 avec un Authorization Code Flow classique. L'utilisateur est redirigé vers FranceConnect, choisit son fournisseur d'identité, s'authentifie, puis revient sur votre service avec un code d'autorisation que votre backend échange contre des jetons.

Deux plateformes distinctes existent :

  • FranceConnect délivre des identités de niveau eIDAS faible (acr_values=eidas1). Les données d'identité transmises viennent du répertoire national d'identification des personnes physiques (RNIPP) : elles sont les mêmes quel que soit le fournisseur d'identité choisi.
  • FranceConnect+ délivre des identités de niveau substantiel ou élevé (eidas2, eidas3). Deux fournisseurs d'identité y sont disponibles : L'Identité Numérique La Poste (substantiel) et France Identité (élevé). Les données viennent cette fois du fournisseur d'identité.

Les médecins, eux, passent par Pro Santé Connect, le fédérateur sectoriel de la santé.


FranceConnect ou FranceConnect+ pour une app santé ?

C'est le point à trancher avant d'écrire du code, et deux textes y répondent dans le même sens.

Ce que dit FranceConnect

La documentation partenaires classe les services de santé parmi les démarches qui relèvent de FranceConnect+, avec les flux financiers sans contrôle et les données sensibles. FranceConnect, lui, vise les démarches peu sensibles.

Si vous intégrez quand même FranceConnect sur un service numérique en santé, les critères de qualification imposent un second facteur d'authentification, de type possession ou biométrie, géré par votre service. Le code envoyé par mail n'est pas accepté : il compte comme un facteur de connaissance.

Ce que dit le référentiel santé

Le référentiel d'identification électronique des usagers, volet de la PGSSI-S rendu opposable par l'arrêté du 28 mars 2022, s'applique aux services numériques en santé qui traitent des données de santé. Il cite la plateforme de téléconsultation parmi ses exemples, avec le portail patient et la prise de rendez-vous médicaux.

Son exigence 1 limite les moyens d'identification des usagers à deux familles :

  • les moyens certifiés eIDAS de niveau substantiel ou élevé ;
  • l'appli carte Vitale.

Les moyens dits « de transition », qui reposent sur deux facteurs de types différents, n'y étaient autorisés que jusqu'au 31 décembre 2025. Un projet d'arrêté, notifié à la Commission européenne le 14 septembre 2026, les prolonge jusqu'au 31 décembre 2028 et impose de proposer l'appli carte Vitale à la même date. Au 17 novembre 2026, il n'est pas encore adopté : la version 1.0 reste celle publiée comme opposable. Pour savoir ce que ces dates changent pour votre service, faites notre test authentification santé.

FranceConnect, de niveau faible, n'entre dans aucune des deux familles. FranceConnect+ correspond à la première.

Qui peut être habilité

L'arrêté du 8 novembre 2018 encadre l'usage de FranceConnect et de FranceConnect+. Une administration peut les intégrer librement. Une entreprise ou une association ne le peut que dans deux cas : un service lié au changement d'adresse, ou un service dont l'usage impose, selon un texte réglementaire, de vérifier l'identité des utilisateurs. L'obligation doit peser sur vos propres utilisateurs, pas sur ceux de vos clients.

Pour un service numérique en santé, la documentation indique que le cadre juridique à citer dans la demande est l'arrêté du 28 mars 2022. L'éligibilité est vérifiée à l'instruction du dossier.

Ce qu'on en retient

Pour authentifier des patients sur une plateforme de téléconsultation, la cible est FranceConnect+. Ce que cela change :

  • Le coût. FranceConnect est gratuit. FranceConnect+ l'est aujourd'hui pour les services publics, mais un fournisseur de service privé doit contractualiser avec les fournisseurs d'identité privés, qui peuvent facturer l'usage des identités.
  • La technique. FranceConnect+ a ses propres environnements et ajoute le chiffrement : l'id_token et le userinfo arrivent chiffrés avec une clé publique que vous exposez. Le reste du flux est celui décrit ici.
  • L'alternative. Dans la demande d'habilitation, vous attestez proposer un autre moyen d'accès, au même niveau de garantie, pour les usagers qui ne peuvent ou ne veulent pas utiliser FranceConnect.

La suite de l'article décrit FranceConnect v2. Les endpoints, les paramètres et la déconnexion sont communs aux deux plateformes.


Ce qui a changé entre v1 et v2

La v2 est ouverte aux fournisseurs de service depuis mai 2024. Si vous reprenez un code écrit pour la v1, ou une documentation datée, voici les différences listées par la DINUM.

Élément v1 (arrêtée) v2 (actuelle)
Base des URLs /api/v1/ /api/v2/
Signature des jetons Symétrique, secret partagé Asymétrique : ES256 (recommandé) ou RS256
Réponse /userinfo Objet JSON non signé JWT signé, signature à vérifier
acr_values Optionnel Obligatoire, valeur eidas1
Scopes address et phone Acceptés, sans données Refusés avec une erreur
preferred_username Inclus dans identite_pivot À demander à part, ou via profile
Paramètres du callback code, state code, state, iss
Déconnexion /api/v1/logout, GET ou POST, paramètres facultatifs /api/v2/session/end, GET, trois paramètres obligatoires
Erreurs de connexion L'usager reste bloqué côté FranceConnect Retour sur votre redirect_uri avec error
Méthode /authorize GET GET ou POST

Deux de ces changements cassent un client v1 sans prévenir.

Les signatures asymétriques. En v1, l'id_token était signé avec le secret partagé. En v2, FranceConnect signe avec une clé privée et publie les clés publiques sur /api/v2/jwks. Ces clés changent régulièrement : rechargez-les quand une vérification échoue au lieu de renvoyer une erreur à l'utilisateur.

Le userinfo signé. La réponse n'est plus du JSON mais un JWT (Content-Type: application/jwt). Un client qui fait JSON.parse sur le corps échoue, et un client qui décode le JWT sans vérifier sa signature accepte des données d'identité non authentifiées.


Endpoints FranceConnect v2 : bac à sable et production

Bac à sable

Endpoint URL
Discovery https://fcp-low.sbx.dev-franceconnect.fr/api/v2/.well-known/openid-configuration
Issuer https://fcp-low.sbx.dev-franceconnect.fr/api/v2
Authorize https://fcp-low.sbx.dev-franceconnect.fr/api/v2/authorize
Token https://fcp-low.sbx.dev-franceconnect.fr/api/v2/token
UserInfo https://fcp-low.sbx.dev-franceconnect.fr/api/v2/userinfo
Logout https://fcp-low.sbx.dev-franceconnect.fr/api/v2/session/end
JWKS https://fcp-low.sbx.dev-franceconnect.fr/api/v2/jwks

L'hôte documenté est fcp-low.sbx. L'ancien fcp-low.integ01 répond encore, mais la documentation ne le référence plus. L'hôte v1, fcp.integ01, ne se résout plus.

Production

Endpoint URL
Discovery https://oidc.franceconnect.gouv.fr/api/v2/.well-known/openid-configuration
Authorize https://oidc.franceconnect.gouv.fr/api/v2/authorize
Token https://oidc.franceconnect.gouv.fr/api/v2/token
UserInfo https://oidc.franceconnect.gouv.fr/api/v2/userinfo
Logout https://oidc.franceconnect.gouv.fr/api/v2/session/end
JWKS https://oidc.franceconnect.gouv.fr/api/v2/jwks

Les URLs de production sont publiques. Ce qui vous est remis après la qualification, ce sont les clés : le client_id par mail, le client_secret par SMS au responsable technique. Les clés du bac à sable ne fonctionnent pas en production, et celles de FranceConnect ne fonctionnent pas sur FranceConnect+.

La DINUM recommande de lire la configuration sur la discovery URL plutôt que de recopier les endpoints. Notez que l'issuer inclut /api/v2 : c'est la valeur exacte du claim iss des jetons.

Les paramètres de /authorize

Paramètre Statut Valeur
response_type Requis code
client_id Requis Identifiant remis par FranceConnect
redirect_uri Requis URL de retour déclarée pour votre service
acr_values Requis eidas1 sur FranceConnect
scope Requis Scopes séparés par des espaces, dont openid
state Requis Aléatoire, vérifié au retour
nonce Requis Aléatoire, vérifié dans l'id_token
claims Optionnel Claims supplémentaires, par exemple amr
prompt Optionnel login consent par défaut

Pour state et nonce, les critères de qualification demandent au moins 22 caractères, aléatoires et uniques à chaque session. Une table de la documentation indique 32. Générez-en 32 ou plus et la question ne se pose pas.


Scopes et claims : individuels et groupés

Scopes individuels

Scope Claims retournés
openid sub (obligatoire)
given_name given_name, given_name_array
family_name family_name
birthdate birthdate (YYYY-MM-DD)
gender gender (male ou female)
birthplace birthplace (code INSEE de la commune)
birthcountry birthcountry (code INSEE du pays)
preferred_username preferred_username (nom d'usage)
email email

Scopes groupés

Scope Claims inclus
profile family_name, given_name, preferred_username, gender, birthdate
birth birthplace, birthcountry
identite_pivot given_name, family_name, birthdate, gender, birthplace, birthcountry

Les deux notations se valent. Vous ne pouvez appeler que les scopes cochés dans votre habilitation : en demander un de plus déclenche une erreur côté FranceConnect.

Les détails qui comptent

  • given_name contient tous les prénoms, séparés par des espaces ("Angela Claire Louise"). given_name_array donne la même liste sous forme de tableau. Pour n'afficher que le premier prénom, prenez le premier élément du tableau.
  • family_name est le nom de naissance. Le nom d'usage arrive dans preferred_username, quand le fournisseur d'identité le connaît.
  • birthplace est vide pour une personne née à l'étranger. Le pays se lit dans birthcountry (99100 pour la France).
  • birthdate peut être présumée : YYYY-01-01 ou YYYY-MM-01 quand le jour ou le mois ne sont pas connus à l'état civil.
  • email est une donnée de contact, vérifiée par le fournisseur d'identité. Elle peut changer selon le fournisseur choisi par l'usager : ne vous en servez pas pour rapprocher des comptes.

Le claim sub

Le sub est un identifiant technique opaque, une longue chaîne hexadécimale terminée par v1 dans les exemples officiels. Il est propre à votre service : un même citoyen a un sub différent chez chaque fournisseur de service. Il ne dépend pas du fournisseur d'identité utilisé et reste stable, sauf cas exceptionnel comme une modification de l'état civil. C'est la bonne clé pour identifier vos utilisateurs.

Cet identifiant est calculé par secteur : toutes vos URLs de retour doivent partager le même domaine, sauf à déclarer un sector_identifier.


Jetons, signatures et durées de vie

La réponse de /api/v2/token contient l'access_token, l'id_token et les scopes consentis. L'id_token porte de quoi contrôler la cinématique : iss, aud, nonce, le niveau acr et la méthode d'authentification amr.

Quatre vérifications sont attendues de votre côté :

  1. la signature de l'id_token, avec les clés de /api/v2/jwks ;
  2. les claims iss, aud et nonce ;
  3. le niveau acr, qui doit être au moins celui demandé ;
  4. la signature de la réponse /userinfo.

Les délais sont serrés. Le code d'autorisation est valable 30 secondes et ne sert qu'une fois. L'access token vit une minute au plus (la documentation indique 30 ou 60 secondes selon les pages) : l'appel à /userinfo se fait dans la foulée de l'échange du code, jamais plus tard.


La déconnexion obligatoire

FranceConnect garde une session ouverte, qui permet à l'usager de passer d'un service à l'autre sans se réauthentifier, et il ne la ferme pas quand le navigateur se ferme. Quand un utilisateur se déconnecte de votre service, vous devez donc le déconnecter aussi de FranceConnect. C'est un critère de qualification : sans lui, pas de clés de production.

Le flow de déconnexion

1. L'utilisateur clique "Se déconnecter"
2. Votre backend le redirige vers FranceConnect :
   /api/v2/session/end?id_token_hint=...&state=...&post_logout_redirect_uri=...
3. FranceConnect ferme sa session et celle du fournisseur d'identité
4. FranceConnect redirige vers votre post_logout_redirect_uri, avec le state
5. Votre backend vérifie le state et détruit la session locale

L'URL de logout

GET https://<host>/api/v2/session/end
  ?id_token_hint=<id_token reçu au login>
  &state=<aléatoire>
  &post_logout_redirect_uri=<URL de retour déclarée>

Les trois paramètres sont obligatoires, et l'appel se fait par une redirection du navigateur. À prévoir :

  • vous devez conserver l'id_token en session dès la connexion. Si vous le jetez après avoir lu les claims, la déconnexion ne fonctionnera pas ;
  • l'URL de retour doit être déclarée parmi les URLs de redirection de déconnexion de votre service. Une URL non déclarée donne l'erreur Y04CFAEF.

Même règle si votre service permet de supprimer son compte ou de le dissocier de FranceConnect : l'usager doit être déconnecté de FranceConnect à ce moment-là.


Implémentation NestJS complète

Pour FranceConnect, on s'appuie sur openid-client, une librairie certifiée par la fondation OpenID. Elle lit la discovery URL, gère le userinfo signé et vérifie les signatures.

Le service

// auth/franceconnect.service.ts
import { Injectable, UnauthorizedException } from '@nestjs/common';
import { ConfigService } from '@nestjs/config';
import type { SessionData } from 'express-session';
import * as client from 'openid-client';

export interface FranceConnectIdentity {
  fcSub: string;
  firstName?: string;
  lastName?: string;
  birthdate?: string;
  email?: string;
}

declare module 'express-session' {
  interface SessionData {
    fcState?: string;
    fcNonce?: string;
    fcIdToken?: string;
    fcLogoutState?: string;
    patient?: FranceConnectIdentity;
  }
}

type FcSession = Partial<SessionData>;

@Injectable()
export class FranceConnectService {
  private config?: client.Configuration;

  constructor(private readonly configService: ConfigService) {}

  // Endpoints, clés et algorithmes sont lus sur la discovery URL
  private async getConfig(): Promise<client.Configuration> {
    if (!this.config) {
      const config = await client.discovery(
        new URL(this.configService.getOrThrow('FC_ISSUER')),
        this.configService.getOrThrow('FC_CLIENT_ID'),
        {
          id_token_signed_response_alg: 'ES256',
          userinfo_signed_response_alg: 'ES256',
        },
        client.ClientSecretPost(
          this.configService.getOrThrow('FC_CLIENT_SECRET'),
        ),
      );
      // Vérifie la signature de l'id_token et du userinfo avec les clés JWKS
      client.enableNonRepudiationChecks(config);
      this.config = config;
    }
    return this.config;
  }

  async buildLoginUrl(session: FcSession): Promise<string> {
    const config = await this.getConfig();
    session.fcState = client.randomState();
    session.fcNonce = client.randomNonce();

    return client.buildAuthorizationUrl(config, {
      redirect_uri: this.configService.getOrThrow('FC_CALLBACK_URL'),
      scope: 'openid given_name family_name birthdate email',
      acr_values: 'eidas1',
      state: session.fcState,
      nonce: session.fcNonce,
    }).href;
  }

  async handleCallback(
    query: Record<string, string>,
    session: FcSession,
  ): Promise<FranceConnectIdentity> {
    const config = await this.getConfig();
    // L'URL de retour est reconstruite à partir de l'URL déclarée :
    // elle doit rester strictement identique derrière un proxy
    const currentUrl = new URL(this.configService.getOrThrow('FC_CALLBACK_URL'));
    currentUrl.search = new URLSearchParams(query).toString();

    const tokens = await client.authorizationCodeGrant(config, currentUrl, {
      expectedState: session.fcState,
      expectedNonce: session.fcNonce,
      idTokenExpected: true,
    });
    const claims = tokens.claims();
    if (!claims || claims.acr !== 'eidas1') {
      throw new UnauthorizedException('Unexpected eIDAS level');
    }

    // L'access token expire en une minute : appel immédiat
    const identity = await client.fetchUserInfo(
      config,
      tokens.access_token,
      claims.sub,
    );

    delete session.fcState;
    delete session.fcNonce;
    // À garder jusqu'à la déconnexion (id_token_hint)
    session.fcIdToken = tokens.id_token;

    return {
      fcSub: identity.sub,
      firstName: identity.given_name,
      lastName: identity.family_name,
      birthdate: identity.birthdate,
      email: identity.email,
    };
  }

  async buildLogoutUrl(session: FcSession): Promise<string> {
    const config = await this.getConfig();
    if (!session.fcIdToken) {
      throw new UnauthorizedException('No FranceConnect session');
    }
    session.fcLogoutState = client.randomState();

    return client.buildEndSessionUrl(config, {
      id_token_hint: session.fcIdToken,
      state: session.fcLogoutState,
      post_logout_redirect_uri: this.configService.getOrThrow(
        'FC_POST_LOGOUT_REDIRECT_URI',
      ),
    }).href;
  }

  checkLogoutState(state: string | undefined, session: FcSession): void {
    if (!session.fcLogoutState || state !== session.fcLogoutState) {
      throw new UnauthorizedException('Invalid logout state');
    }
  }
}

Le controller

// auth/franceconnect.controller.ts
import { Controller, Get, Req, Res } from '@nestjs/common';
import type { Request, Response } from 'express';
import { FranceConnectService } from './franceconnect.service';

@Controller('auth/fc')
export class FranceConnectController {
  constructor(private readonly franceConnect: FranceConnectService) {}

  @Get('login')
  async login(@Req() req: Request, @Res() res: Response) {
    res.redirect(await this.franceConnect.buildLoginUrl(req.session));
  }

  @Get('callback')
  async callback(@Req() req: Request, @Res() res: Response) {
    try {
      req.session.patient = await this.franceConnect.handleCallback(
        req.query as Record<string, string>,
        req.session,
      );
      res.redirect('/espace-patient');
    } catch {
      // Abandon de l'usager, erreur renvoyée par FranceConnect, state invalide :
      // retour à la page de connexion avec un message et une alternative
      res.redirect('/connexion?erreur=franceconnect');
    }
  }

  @Get('logout')
  async logout(@Req() req: Request, @Res() res: Response) {
    const logoutUrl = await this.franceConnect.buildLogoutUrl(req.session);
    delete req.session.patient;
    res.redirect(logoutUrl);
  }

  @Get('logout/callback')
  logoutCallback(@Req() req: Request, @Res() res: Response) {
    this.franceConnect.checkLogoutState(
      req.query.state as string | undefined,
      req.session,
    );
    req.session.destroy(() => res.redirect('/'));
  }
}

Les variables d'environnement

# FranceConnect v2, bac à sable
FC_ISSUER=https://fcp-low.sbx.dev-franceconnect.fr/api/v2
FC_CLIENT_ID=your-client-id
FC_CLIENT_SECRET=your-client-secret
FC_CALLBACK_URL=https://your-app.example.com/auth/fc/callback
FC_POST_LOGOUT_REDIRECT_URI=https://your-app.example.com/auth/fc/logout/callback

En production, seul FC_ISSUER change d'hôte : https://oidc.franceconnect.gouv.fr/api/v2.

Ce qu'il faut savoir sur ce code

  • L'algorithme de signature se choisit dans l'espace partenaires, ES256 ou RS256. Le service ci-dessus attend ES256 : si vous avez retenu RS256, changez les deux valeurs dans l'appel à discovery.
  • enableNonRepudiationChecks active la vérification des signatures. Sans cet appel, la librairie contrôle les claims des jetons reçus du serveur mais pas leur signature.
  • Le state et le nonce vivent en session, comme l'id_token. Il vous faut un middleware de session (express-session ou équivalent) actif sur ces routes.
  • openid-client 6 est un module ES. Dans un projet NestJS compilé en CommonJS, il se charge avec Node 20.19 et TypeScript 5.9, en module: commonjs comme en nodenext. Le réglage node16 refuse l'import.

Ce code a été exécuté contre un serveur de test qui reproduit les réponses documentées de FranceConnect : jetons signés en ES256, userinfo en JWT, paramètre iss au retour. Il refuse un userinfo ou un id_token signé par une autre clé, un userinfo en JSON brut, un nonce ou un state altéré, un iss absent ou étranger. Il ne remplace pas la recette en bac à sable, que la qualification exige de toute façon.

Pourquoi pas passport-openidconnect, qu'on utilise pour Pro Santé Connect ? Parce qu'elle ne convient pas à FranceConnect v2 : elle lit le userinfo comme du JSON, ne vérifie pas la signature des jetons, et génère un nonce de 20 caractères, sous le minimum demandé.


Les 7 erreurs qui bloquent votre intégration FranceConnect

1. Mettre l'hôte seul dans l'issuer. L'issuer de FranceConnect est https://<hôte>/api/v2, pas https://<hôte>. Un client qui compare le claim iss à l'hôte seul rejette tous les jetons.

2. Oublier acr_values, state ou nonce. Les trois sont obligatoires en v2. Une requête mal formée s'arrête sur une page d'erreur côté FranceConnect, code Y030007.

3. Lire le userinfo comme du JSON. C'est un JWT signé. Décodez-le et vérifiez sa signature avec les clés de /api/v2/jwks.

4. Appeler /userinfo trop tard. Le code d'autorisation vit 30 secondes, l'access token une minute au plus. Enchaînez les deux appels dans le traitement du callback.

5. Jeter l'id_token après le login. Il est requis comme id_token_hint à la déconnexion. Stockez-le en session et ne le supprimez qu'à la déconnexion effective.

6. Demander des scopes hors habilitation. Les scopes de la requête doivent figurer dans votre demande Datapass. Vous pouvez en appeler moins, jamais plus : un scope en trop donne l'erreur Y044D706.

7. Avoir une URL de retour différente de celle déclarée. FranceConnect compare redirect_uri à la configuration de votre service. Un chemin, un port ou un sous-domaine différent donne l'erreur Y04C013C. Derrière un proxy, reconstruisez l'URL à partir de la valeur déclarée plutôt que de la requête reçue.


Checklist avant la demande de qualification

Avant la production, l'équipe FranceConnect qualifie votre intégration sur le bac à sable. Elle demande une recette interne préalable. Voici les critères qui font le plus souvent revenir un dossier.

Le bouton et la page de connexion

  • Bouton FranceConnect officiel, non déformé, en 209 x 56 pixels, avec son état au survol
  • Au-dessus du bouton, la phrase « FranceConnect est la solution proposée par l'État pour sécuriser et simplifier la connexion à vos services en ligne »
  • Sous le bouton, le lien « Qu'est-ce que FranceConnect ? » vers https://franceconnect.gouv.fr
  • Bouton en première position, séparé des autres modes de connexion par une ligne et la mention « OU »
  • Aucune connexion par réseau social ou autre service privé sur la page qui porte le bouton
  • Même dispositif sur la page d'inscription, si vous en avez une

Le protocole

  • TLS 1.2 ou 1.3
  • Scopes identiques à ceux de l'habilitation, ou moins nombreux
  • acr_values présent, et niveau acr du jeton vérifié
  • state et nonce aléatoires, uniques par session et vérifiés : la connexion doit échouer si on les modifie dans l'URL
  • Erreurs renvoyées sur redirect_uri gérées, avec une page fonctionnelle quand l'usager abandonne

Le service

  • Déconnexion de FranceConnect à la déconnexion du service, avec id_token_hint, state et post_logout_redirect_uri
  • Déconnexion de FranceConnect à la suppression ou à la dissociation du compte
  • Identité pivot non modifiable dans le profil (nom, prénoms, date et lieu de naissance, sexe)
  • Nom d'usage et email modifiables
  • Nom de l'utilisateur connecté visible en permanence
  • Ni pop-up ni iframe pendant la session
  • Rapprochement avec un compte existant fondé sur l'identité pivot, jamais sur l'email seul ni sur la saisie du mot de passe local
  • Second facteur d'authentification si le service est un service numérique en santé (possession ou biométrie, pas de code par mail)

Le parcours pour devenir fournisseur de service

L'habilitation FranceConnect se déroule en cinq étapes.

Étape Où Ce qu'il faut savoir
1. Vérifier l'éligibilité Arrêté du 8 novembre 2018 Cadre juridique à justifier pour un acteur privé
2. Demander l'habilitation Datapass, connexion ProConnect Délai moyen de 5 jours ouvrés, davantage si le dossier appelle une analyse juridique
3. Intégrer en bac à sable Espace partenaires Clés générées en autonomie
4. Faire qualifier l'intégration Démarche en ligne Durée liée au respect des critères
5. Passer en production Démarche en ligne client_id par mail, client_secret par SMS

Le bac à sable n'attend pas l'habilitation. L'espace partenaires est ouvert à toute personne qui s'y connecte avec ProConnect, et le numéro Datapass y est facultatif : vous pouvez créer une instance de test et commencer à développer pendant que le dossier est instruit. Vous y déclarez vos URLs de retour et de déconnexion, vos adresses IP de sortie et l'algorithme de signature. Trois fournisseurs d'identité de démonstration, un par niveau eIDAS, permettent de tester avec un jeu de données fictives. Les données réelles y sont interdites.

La demande Datapass couvre l'organisation, la description du projet (maquettes bienvenues), le traitement des données personnelles, le cadre juridique, le niveau de garantie choisi, les données demandées et quatre contacts : demandeur, responsable technique, responsable de traitement et délégué à la protection des données. Le responsable technique doit avoir un numéro de mobile, puisque le secret arrive par SMS.

Ne cochez que les données dont vous avez besoin. La minimisation est un principe du RGPD, et chaque scope coché est un scope que la qualification vérifiera.

Le bouton officiel

Le bouton FranceConnect est imposé : aucun autre visuel n'est accepté pour connecter les usagers. Il est fourni par le Système de Design de l'État, ou en téléchargement dans la documentation partenaires pour les sites qui n'utilisent pas ce système. Son design, ses couleurs et son label ne se modifient pas. Il se décline pour fond clair et fond sombre, et peut être agrandi à condition de garder ses proportions.


FAQ : les questions fréquentes sur FranceConnect v2

FranceConnect v1 fonctionne-t-il encore ?

Non. La DINUM avait programmé l'arrêt de la v1 pour septembre 2025, après une migration ouverte en septembre 2024. La v2 est disponible pour les fournisseurs de service depuis mai 2024, et c'est la seule sur laquelle on peut intégrer aujourd'hui.

FranceConnect est-il gratuit ?

Oui pour FranceConnect, pour les usagers comme pour les fournisseurs de service. FranceConnect+ ne donne lieu à aucune facturation par la DINUM, mais un fournisseur de service privé doit contractualiser avec les fournisseurs d'identité privés, qui peuvent facturer l'usage des identités.

Quelle différence entre FranceConnect et FranceConnect+ ?

Le niveau de garantie eIDAS. FranceConnect délivre des identités de niveau faible, même quand le fournisseur d'identité utilisé pourrait faire mieux. FranceConnect+ délivre des identités de niveau substantiel ou élevé, avec deux fournisseurs d'identité : L'Identité Numérique La Poste et France Identité. FranceConnect+ vise les services sensibles, dont les services de santé, et chiffre les jetons en plus de les signer.

FranceConnect suffit-il pour une app de téléconsultation ?

Pas seul. La documentation FranceConnect range les services de santé du côté de FranceConnect+, et impose un second facteur d'authentification à un service numérique en santé qui garderait FranceConnect. Le référentiel d'identification électronique des usagers va dans le même sens : il vise un niveau substantiel ou l'appli carte Vitale pour les patients.

Une startup privée peut-elle utiliser FranceConnect ?

Seulement si un texte lui impose de vérifier l'identité de ses propres utilisateurs, ou pour un service lié au changement d'adresse. Pour un service numérique en santé, le cadre à citer dans la demande d'habilitation est l'arrêté du 28 mars 2022 sur l'identification électronique. L'éligibilité est examinée à l'instruction du dossier.

Peut-on utiliser FranceConnect pour authentifier des médecins ?

Non. FranceConnect authentifie les citoyens, pas les professionnels de santé. Pour les médecins, vous devez utiliser Pro Santé Connect, le fédérateur d'identité sectoriel de l'ANS, qui s'appuie sur la carte CPS ou l'e-CPS et fournit le numéro RPPS.

Faut-il vérifier la signature du userinfo ?

Oui. En v2, la réponse de /api/v2/userinfo est un JWT signé par FranceConnect, et la vérification de cette signature fait partie de la cinématique documentée. Les clés publiques sont sur /api/v2/jwks et changent régulièrement.

Le bouton FranceConnect est-il personnalisable ?

Non. Le design, les couleurs et le label sont imposés, et le bouton doit apparaître en premier parmi les modes de connexion. Une phrase de présentation se place au-dessus et le lien « Qu'est-ce que FranceConnect ? » en dessous.


Conclusion

FranceConnect v2 reste de l'OpenID Connect classique. Ce qui le distingue tient en trois points : des paramètres obligatoires dans la requête d'autorisation, des jetons signés dont il faut vérifier la signature, et une déconnexion à propager.

Pour une application e-santé, la décision qui pèse le plus se prend avant le code : sur un service de santé, c'est FranceConnect+ qui correspond aux textes, ou à défaut FranceConnect doublé d'un second facteur. Les médecins, eux, passent par Pro Santé Connect, et les deux cohabitent dans le même backend.

Vous construisez une plateforme de téléconsultation ou une app santé ? Chez Bob le développeur, on intègre FranceConnect et Pro Santé Connect depuis plusieurs années. Contactez-nous pour discuter de votre projet.

Sources

Faits relevés le 13 octobre 2026.

Ce contenu vous a servi ? Ajoutez Bob le développeur à vos sources préférées sur Google.

E-santé

Un logiciel santé à développer ?

Applications médicales, télémédecine, medtech : on les conçoit et on les développe sur mesure, déployées chez un hébergeur certifié HDS.

  • Fondateurs dans l’e-santé depuis 2017
  • Référence AP-HP
  • Code 100 % à vous

30 min, gratuit, sans engagement.

La newsletter qu’on n’ignore pas

Abonnez-vous à notre newsletter pour recevoir nos derniers articles, retours d’expérience et conseils tech directement dans votre boîte mail.

Désinscription en un clic. Vos données restent privées.