Table des matières

🇫🇷 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:


What Is Not Included

⚠️ The following data is not part of the pivot identity:

Data Reason
preferred_username Declarative preferred name
email 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:

It must therefore not be used as trusted reference data.


Partners may use pivot identity for:


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


Next Step

👉 Understand available claims:

Scopes and Claims