Prerequisites

List the prerequisites required to integrate L’Identité Numérique La Poste.

👉 This page helps prepare the technical, functional, and organizational aspects of the integration.

The partner must have:

• a backend capable of calling secure APIs
• support for HTTPS redirections (browser / application)
• the ability to process JWT tokens

👉 The integration is based on the OpenID Connect standard.

The partner must define:

• use cases (authentication, account creation, re-authentication, etc.)
• required data (scopes / claims)
• user journeys
• messages displayed to users
• internal business rules (account creation, user matching, session management, etc.)

The partner must be able to:

• secure token storage
• verify JWT signatures (`id_token`)
• secure exchanges through HTTPS
• manage user sessions
• log authentication events

⚠️ The id_token must be retained as proof of authentication.

The partner must submit a request to the L’Identité Numérique team with the following information:

• email address of the account owner
• phone number of the account owner
• list of authorized `redirect_uri`:
  • test environment
  • production
• list of requested scopes / data
• project context / use case

👉 The designated owner must be authorized to receive the credentials.

After account creation, the LINLP team provides:

• `client_id`
• `client_secret`

⚠️ These elements are confidential and must never be exposed on the frontend.

The partner must identify:

• the data strictly required for the service
• optional data

👉 See: Scopes and Claims

Before going live:

• use the Sandbox environment
• create test identities
• validate user journeys
• validate returned data
• test error handling

👉 See: Create a Test Identity

The partner should provide:

• a Sign in with L’Identité Numérique La Poste button
• journey continuation after authentication

• LINLP integration is based on OpenID Connect
• A secure backend is required
• Data is controlled through scopes
• Credentials must be protected
• Proper preparation significantly speeds up integration

👉 Understand the protocol:

OpenID Connect