🇫🇷 Français | 🇬🇧 English
Pivot Identity
Objective
Present the concept of pivot identity used by L’Identité Numérique La Poste.
👉 The pivot identity corresponds to the core set of trusted civil identity data used to reliably identify a user.
Definition
The pivot identity groups the main data used to represent a user’s civil identity.
It is composed of the information verified during the digital identity creation process.
👉 It forms the trusted foundation used during authentications.
Data Included in the Pivot Identity
| Data | Description | Example |
|---|---|---|
| family_name | Birth name | DUPONT |
| given_name | Given names | JEAN PIERRE |
| gender | Gender | Male |
| birthdate | Date of birth | 1990-05-10 |
| birthplace | Place of birth | 75109 |
| birthcountry | Country of birth | 99100 |
Purpose
The pivot identity allows partners to:
- identify a user without ambiguity
- populate a partner account
- match an existing user
- reduce impersonation risks
What Is Not Included
⚠️ The following data is not part of the pivot identity:
| Data | Reason |
|---|---|
| preferred_username | Declarative preferred name |
| Contact data | |
| phone_number | Contact data |
| nationality | Additional data |
| document metadata | Documentary data |
Focus: Preferred Name
⚠️ The `preferred_username` field is not part of the pivot identity.
👉 It is:
- declarative data
- freely entered by the user
- not verified by LINLP
It must therefore not be used as trusted reference data.
Recommended Usage
Partners may use pivot identity for:
- initial account creation
- user matching
- business controls
- identity justification
Attention Points
⚠️ Homonyms management Always cross-check several fields.
⚠️ Accents / uppercase / apostrophes / spaces Normalize internal processing rules.
Best Practices
⚠️ Use `sub` as the unique technical identifier
⚠️ Use pivot identity as business reference data
⚠️ Do not use preferred name as a reliable identifier
Example Use Case
LINLP User: Name: DUPONT Given names: JEAN PIERRE Date of birth: 1990-05-10 => automatic creation of partner account
Key Takeaways
- Pivot identity is the trusted identity foundation
- It contains verified civil identity data
- It does not include declarative data
- It should be prioritized for business processing
Next Step
👉 Understand available claims: