Différences

Ci-dessous, les différences entre deux révisions de la page.

--- donnees:scopes_et_claims [2026/04/07 00:00] – mkessabi
+++ donnees:scopes_et_claims [2026/04/07 00:29] (Version actuelle) – mkessabi
@@ Ligne 31: / Ligne 31: @@
 | id_token | Contient des claims |
 | /userinfo | Retourne des claims |
+-----
+===== ⚠️ Donnée non vérifiée : nom d’usage =====
+⚠️ **Le champ `preferred_username` (nom d’usage) n’est pas une donnée vérifiée par LINLP.**
+  * Cette donnée est **saisie librement par l’utilisateur**
+  * Elle **n’est pas contrôlée** lors de la vérification d’identité
+  * Elle est **souvent absente ou non à jour** sur les pièces d’identité
+👉 En conséquence :
+  * elle **ne doit pas être utilisée comme donnée d’identité de référence**
+  * elle doit être considérée comme **indicative uniquement**
 -----
@@ Ligne 38: / Ligne 52: @@
 ===== Scope openid =====
-^ Claim ^ Description ^ Format ^
+^ Claim ^ Description ^ Format ^ Exemple ^
-| sub | Identifiant unique utilisateur | UUID |
+| sub | Identifiant unique utilisateur | UUID | 075ccece-6699-4c08-80ca-27a6af136b68 |
 -----
@@ Ligne 45: / Ligne 59: @@
 ===== Scope profile =====
-^ Claim ^ Description ^ Format ^
+^ Claim ^ Description ^ Format ^ Exemple ^
-| given_name | Prénoms | String |
+| given_name | Prénoms | String | Jean Pierre |
-| family_name | Nom de naissance | String |
+| family_name | Nom de naissance | String | DUPONT |
-| preferred_username | Nom d’usage | String |
+| preferred_username | Nom d’usage **(non vérifié)** | String | MARTIN |
-| gender | Sexe (Male / Female) | String |
+| gender | Sexe (Male / Female) | String | Male |
 -----
@@ Ligne 55: / Ligne 69: @@
 ===== Scope birth =====
-^ Claim ^ Description ^ Format ^
+^ Claim ^ Description ^ Format ^ Exemple ^
-| birthdate | Date de naissance | YYYY-MM-DD |
+| birthdate | Date de naissance | YYYY-MM-DD | 1990-05-10 |
-| birthplace | Code INSEE commune | String (5) |
+| birthplace | Code INSEE commune | String (5) | 75109 |
-| birthdepartment | Département | String |
+| birthdepartment | Département | String | 75 |
-| birthcountry | Pays de naissance | String (5) |
+| birthcountry | Pays de naissance | String (5) | 99100 |
-| birthplacelabel | Libellé de la commune | String |
-| birthcountrylabel | Libellé du pays | String |
-| birthcountry_iso | Pays (format ISO) | JSON |
 -----
@@ Ligne 68: / Ligne 79: @@
 ===== Scope email =====
-^ Claim ^ Description ^ Format ^
+^ Claim ^ Description ^ Format ^ Exemple ^
-| email | Adresse email | email |
+| email | Adresse email | email | jean.dupont@mail.com |
-| email_verified | Email vérifié | boolean |
+| email_verified | Email vérifié | boolean | true |
 -----
@@ Ligne 76: / Ligne 87: @@
 ===== Scope phone =====
-^ Claim ^ Description ^ Format ^
+^ Claim ^ Description ^ Format ^ Exemple ^
-| phone_number | Numéro de téléphone | +33XXXXXXXXX |
+| phone_number | Numéro de téléphone | +33XXXXXXXXX | +33601020304 |
-| phone_number_verified | Téléphone vérifié | boolean |
+| phone_number_verified | Téléphone vérifié | boolean | true |
 -----
@@ Ligne 84: / Ligne 95: @@
 ===== Scope nationality =====
-^ Claim ^ Description ^ Format ^
+^ Claim ^ Description ^ Format ^ Exemple ^
-| nationality | Nationalité | JSON {code, label} |
+| nationality | Nationalité | JSON {code, label} | {"code":"FRA","label":"Française"} |
+-----
+===== Scope digital_identity_metadata =====
+^ Claim ^ Description ^ Format ^ Exemple ^
+| digital_identity_creation_date | Date de création identité | datetime | 2025-01-17T08:23:27.000Z |
+| digital_identity_expiration_date | Date d’expiration | datetime | 2030-01-17T08:23:27.000Z |
+-----
+===== Scope identity_document_metadata =====
+^ Claim ^ Description ^ Format ^ Exemple ^
+| identity_document_mrz | Bande MRZ de la pièce d'identité | String | IDFRAXXXXXXX005<<<<<<<<<<<<<<<999999XXXXXXXXFRA<<<<<<<<<<<9XXXXXX<<XXXXX<<<<<<<<<<<<<<<<< |
+| identity_document_type | Type de pièce | String | ID_CARD |
+| identity_document_expiration_date | Date d'expiration de la pièce | Date | 2030-01-18 |
+| identity_document_emitting_country | Pays d'emission | String | FRA |
+| identity_document_emitting_date | Date d'emission | Date | 2020-01-18 |
 -----
@@ Ligne 93: / Ligne 123: @@
 Certaines données peuvent être retournées en complément des scopes :
-^ Claim ^ Description ^ Format ^
+^ Claim ^ Description ^ Format ^ Exemple ^
-| ccu_id | Identifiant interne La Poste | String (13) |
+| ccu_id | Identifiant interne La Poste | String (13) | 5572916534921 |
-| splitted_given_name | Prénoms séparés | JSON |
+| splitted_given_name | Prénoms séparés | JSON | {"first_name":"Jean","middle_name":"Pierre"} |
-| majority | Statut majeur | boolean |
+| majority | Statut majeur | boolean | true |
-| digital_identity_creation_date | Date de création identité | datetime |
-| digital_identity_expiration_date | Date d’expiration | datetime |
 -----
@@ Ligne 132: / Ligne 160: @@
 <code>
 "splitted_given_name": {
-  "first_name": "Martin",
+  "first_name": "Jean",
-  "middle_name": "Didier Marc"
+  "middle_name": "Pierre Louis"
 }
 </code>
@@ Ligne 144: / Ligne 172: @@
 {
   "sub": "5577832670193",
-  "given_name": "Claire Marie",
+  "given_name": "Jean Pierre",
   "family_name": "Dupont",
-  "birthdate": "1965-12-06",
+  "preferred_username": "Martin",
-  "email": "test@mail.com",
+  "birthdate": "1990-05-10",
-  "phone_number": "+33600000000"
+  "email": "jean.dupont@mail.com",
+  "phone_number": "+33601020304"
 }
 </code>
------
-===== Recommandation par cas d’usage =====
-^ Cas d’usage ^ Scopes recommandés ^
-| Authentification simple | openid email |
-| Création de compte | openid profile email |
-| Vérification d’identité (KYC) | openid profile birth nationality |
-| Sécurité renforcée | openid phone |
 -----
@@ Ligne 169: / Ligne 188: @@
 Respect du principe de minimisation.
-⚠️ Anticiper les données absentes
+⚠️ Ne pas utiliser le nom d’usage comme donnée fiable
-Certains champs peuvent être vides.
+Utiliser `family_name` comme référence.
-⚠️ Gérer les consentements
-L’utilisateur peut refuser certaines données.
-⚠️ Ne pas dépendre d’un seul claim
-Toujours prévoir fallback.
 -----
@@ Ligne 184: / Ligne 197: @@
 ⚠️ Les scopes doivent être validés en amont
 Impossible de demander un scope non autorisé.
-⚠️ Différence id_token vs userinfo
-Les données peuvent différer selon le endpoint.
 ⚠️ Les formats sont normalisés
@@ Ligne 196: / Ligne 206: @@
 💡 Toutes les données :
-  * sont certifiées par LINLP
   * sont transmises uniquement après consentement utilisateur
   * peuvent évoluer selon le paramétrage du partenaire
@@ Ligne 206: / Ligne 215: @@
   * Les données sont pilotées par les scopes
   * Les claims sont les données individuelles
-  * Les données sont retournées via JWT ou API
+  * Les données sont retournées aux formats JWT et JSON
-  * L’utilisateur garde le contrôle via consentement
+  * Le nom d’usage est une donnée déclarative non vérifiée
 -----