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

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,stateetnoncesont obligatoires dans la requête d'autorisation- L'
id_tokenet la réponse/userinfosont des JWT signés, dont la signature se vérifie- Le callback reçoit un paramètre
issen plus decodeetstate- 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_tokenet leuserinfoarrivent 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_namecontient tous les prénoms, séparés par des espaces ("Angela Claire Louise").given_name_arraydonne la même liste sous forme de tableau. Pour n'afficher que le premier prénom, prenez le premier élément du tableau.family_nameest le nom de naissance. Le nom d'usage arrive danspreferred_username, quand le fournisseur d'identité le connaît.birthplaceest vide pour une personne née à l'étranger. Le pays se lit dansbirthcountry(99100pour la France).birthdatepeut être présumée :YYYY-01-01ouYYYY-MM-01quand le jour ou le mois ne sont pas connus à l'état civil.emailest 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é :
- la signature de l'
id_token, avec les clés de/api/v2/jwks; - les claims
iss,audetnonce; - le niveau
acr, qui doit être au moins celui demandé ; - 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_tokenen 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. enableNonRepudiationChecksactive 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
stateet lenoncevivent en session, comme l'id_token. Il vous faut un middleware de session (express-sessionou équivalent) actif sur ces routes. openid-client6 est un module ES. Dans un projet NestJS compilé en CommonJS, il se charge avec Node 20.19 et TypeScript 5.9, enmodule: commonjscomme ennodenext. Le réglagenode16refuse 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_valuesprésent, et niveauacrdu jeton vérifié -
stateetnoncealéatoires, uniques par session et vérifiés : la connexion doit échouer si on les modifie dans l'URL - Erreurs renvoyées sur
redirect_urigé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,stateetpost_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.
- Documentation partenaires FranceConnect, DINUM : endpoints, scopes et claims, déconnexion
- Choisir entre FranceConnect et FranceConnect+ et conditions d'éligibilité, DINUM
- Qualification du fournisseur de service et étapes pour devenir fournisseur de service, DINUM
- Bac à sable FranceConnect et environnement de production, DINUM
- Modèle de facturation et résolution des erreurs courantes, DINUM
- Arrêté du 8 novembre 2018 relatif au téléservice FranceConnect
- Référentiel d'identification électronique des usagers, PGSSI-S, version 1.0, et arrêté du 28 mars 2022
- Projet d'arrêté modifiant l'arrêté du 28 mars 2022, notification TRIS 2026/0498/FR du 14 septembre 2026, consultée le 17 novembre 2026
- Pages « Migration de votre fournisseur de service » de la documentation partenaires, retirées depuis, consultées dans leur version archivée de mars 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.