Intégrer TrustMe avec OpenID Connect
Permettez à vos utilisateurs de partager des données d'identité vérifiées et des justificatifs avec votre service, en toute maîtrise de leurs informations.
TrustMe est une identité numérique qui permet aux utilisateurs de partager des données vérifiées avec les services de leur choix. Grâce à OpenID Connect (OIDC), votre service peut intégrer ce parcours, recevoir les informations autorisées par l’utilisateur et récupérer les documents qu’il a partagés.
Cette documentation s’adresse aux équipes techniques qui souhaitent intégrer TrustMe à leur service en tant que Relying Party (RP). Elle décrit l’environnement sandbox ; la production utilise la même interface, avec sa propre configuration.
Ce que TrustMe vous permet de faire
- Connecter un utilisateur avec une identité vérifiée : vous lancez un parcours TrustMe et recevez des informations d’identité contrôlées par TrustMe, pas seulement déclarées par l’utilisateur.
- Recevoir des données vérifiées : état civil, e-mail, téléphone, adresse, coordonnées bancaires, numéro de sécurité sociale, selon les scopes que vous demandez et que l’utilisateur accepte.
- Récupérer des justificatifs : pièce d’identité, justificatifs de domicile ou bancaires, via l’API document.
- Compléter un partage plus tard : avec le partage différé, vous accédez aux informations dont la validation n’était pas terminée au moment de la connexion.
Comment fonctionne l’intégration ?
TrustMe utilise le flux OpenID Connect Authorization Code. Concrètement :
- votre service redirige l’utilisateur vers TrustMe en précisant les informations demandées (les scopes) ;
- l’utilisateur s’authentifie et donne son consentement dans l’application mobile TrustMe, par saisie d’un identifiant ou scan d’un QR code ;
- il revient sur votre site avec un code à usage unique ;
- votre serveur échange ce code contre un
id_token, qui contient les informations partagées (les claims), et unaccess_token, qui permet de télécharger les documents.
L’intégration repose sur les mécanismes standards d’OIDC, complétés par les fonctionnalités propres à TrustMe : partage de documents, partage différé et webhooks.
Vocabulaire
| Terme | Signification |
|---|---|
| Identity Provider (IdP) | Le service qui connaît l’utilisateur et expose l’interface OIDC. Ici : TrustMe. |
| Relying Party (RP) | Votre service, qui souhaite accéder aux informations de l’utilisateur. |
| Claim | Une information d’identité (given_name, email…). |
| Scope | Un ensemble de claims que vous demandez, ou une option de parcours. |
| Jeton (token) | Une preuve délivrée par TrustMe : id_token (informations partagées) ou access_token (accès aux documents). |
| Document | Un fichier partageable par l’utilisateur (image ou PDF). |
Avant de commencer
TrustMe est opéré sur la plateforme A3BC. L’interface OIDC est commune, mais chaque entité émettrice (tenant) est cloisonnée : il vous faut un client_id et un client_secret propres à chaque entité à laquelle vous vous connectez.
- Comprendre OIDC : lisez les notions clés.
- Préparer et demander un accès : déterminez vos scopes, enregistrez votre URI de redirection, puis suivez les prérequis et l’onboarding.
- Faire un premier appel : jouez le démarrage rapide ou lisez l’exemple de bout en bout.