# Connexions

Laissez les utilisateurs se connecter via un fournisseur d'identité externe (OIDC, SAML, Microsoft Entra, social), avec liaison de comptes et création JIT.

> **Remarque sur les plans :** Les fournisseurs sociaux (Google, Apple, GitHub et bien d'autres) font partie de tous les plans. Les fournisseurs entreprise (OIDC/SAML générique, Microsoft Entra, Okta, Auth0, Ping Identity, Keycloak, OneLogin, JumpCloud, DATEV, les agrégateurs d'identités électroniques Criipto et Signicat, ainsi que l'eID allemande) nécessitent la fonctionnalité **enterprise identity brokering**, incluse à partir du plan Advanced (ainsi qu'en Trial).

Une **connexion** permet à vos utilisateurs de se connecter avec un Identity Provider *externe*, sous la forme d'une option « Sign in with… » sur l'écran de connexion. La plateforme délègue l'authentification au fournisseur, reçoit en retour le profil de l'utilisateur et le lie soit à un compte existant, soit à un nouveau compte qu'elle crée. En termes de protocole, la plateforme agit comme Relying Party (OIDC) ou Service Provider (SAML) ; le fournisseur externe est l'Identity Provider.

Vous gérez les connexions dans l'Admin Console sous **Intégrations → Connexions**.

## Fournisseurs disponibles

Les connexions se répartissent en trois groupes.

**Génériques** (fondées sur les standards, configurables plusieurs fois) :

| Fournisseur | Protocole | Utilisation typique |
|---|---|---|
| **OpenID Connect (generic)** | OIDC | Tout Identity Provider OIDC conforme aux standards. |
| **SAML 2.0 (generic)** | SAML | Tout Identity Provider SAML 2.0. |

**Entreprise :**

| Fournisseur | Protocole | Utilisation typique |
|---|---|---|
| **Microsoft Entra** | OIDC | Connexion avec un tenant Microsoft Entra (professionnel ou scolaire). |
| **Okta** | OIDC | Connexion avec une org Okta Workforce. Nécessite votre domaine Okta. |
| **Auth0** | OIDC | Connexion avec un tenant Auth0. Nécessite votre domaine Auth0. |
| **Ping Identity (PingOne)** | OIDC | Connexion avec un environnement PingOne. Nécessite l'hôte PingOne et l'ID d'environnement. |
| **Keycloak** | OIDC | Connexion avec un realm Keycloak. Nécessite l'URL du serveur et le realm. |
| **OneLogin** | OIDC | Connexion avec un compte OneLogin. Nécessite votre domaine OneLogin. |
| **JumpCloud** | OIDC | Connexion avec un compte JumpCloud. |
| **DATEV** | OIDC | Connexion avec un compte DATEV (conseillers fiscaux et leurs clients). |
| **Criipto** | OIDC | Identités électroniques européennes (MitID, BankID, itsme et d'autres) via une connexion unique à votre tenant Criipto. |
| **Signicat** | OIDC | Identités électroniques européennes via une connexion unique à votre compte Signicat. |
| **German eID (Online-Ausweis)** | OIDC | Connexion avec la carte d'identité allemande via AusweisIDent. |

**Social et grand public** (chacun configuré une seule fois) : Amazon, Apple, Basecamp, Bitbucket, Box, DigitalOcean, Discord, Docusign, Dropbox, Facebook, Figma, Fitbit, FreshBooks, GitHub, GitLab, Google, Hugging Face, Intuit (QuickBooks), Kakao, Klarna, LINE, LinkedIn, Microsoft account, netID, PayPal, Salesforce, Slack, SoundCloud, Spotify, Strava, TikTok, Twitch, Vimeo, WordPress.com, X, Xero et Yahoo.

Les connexions OIDC et SAML génériques peuvent être configurées plusieurs fois (pour plusieurs fournisseurs différents) ; chaque fournisseur nommé est configuré une seule fois. De nouveaux fournisseurs sont ajoutés au fil du temps : l'écran de création fait donc foi.

La liste des connexions affiche une bannière lorsque vous atteignez le nombre de connexions autorisé par votre plan ; videz ou supprimez une connexion pour en ajouter une autre.

[Image: La liste des connexions avec trois Identity Providers configurés]

## Ajouter une connexion

1. Sur la page Connexions, choisissez **Créer une connexion** et sélectionnez un fournisseur.
2. Examinez les **prérequis** affichés par la connexion, par exemple l'enregistrement d'une application chez le fournisseur externe pour obtenir un client ID et un secret, puis confirmez.
3. Remplissez le formulaire de configuration (voir ci-dessous).
4. Enregistrez. Les nouvelles connexions démarrent à l'état **Jamais** ; activez une connexion lorsque vous souhaitez qu'elle apparaisse sur l'écran de connexion.

### Champs de configuration

Chaque connexion a besoin d'un **nom** et d'un **répertoire** cible, le répertoire dans lequel sont placés les nouveaux utilisateurs créés via cette connexion. Voir [Répertoires utilisateur](https://dts-identity.com/fr/docs/directories/user-directories.md).

Les champs propres à chaque protocole sont les suivants :

- **OIDC générique** : l'URL de discovery (configuration) du fournisseur, un client ID, un client secret et les scopes à demander (par défaut `openid profile email`). L'URL de discovery est lue à chaque fois, de sorte que la connexion reprend les points de terminaison et les clés du fournisseur sans que vous ayez à les ressaisir.
- **Microsoft Entra** : un client ID, un client secret et l'**ID de tenant** (ou `common` pour le multi-tenant). Les points de terminaison du fournisseur proviennent du document de discovery de Microsoft pour ce tenant.
- **Okta** : un client ID, un client secret et votre **domaine Okta** (par exemple `acme.okta.com`, une org de préversion ou un domaine personnalisé). Créez une OIDC Web Application dans l'Okta Admin Console et attribuez-la aux utilisateurs qui doivent pouvoir se connecter.
- **Auth0** : un client ID, un client secret et votre **domaine Auth0** (par exemple `acme.eu.auth0.com`, ou un domaine personnalisé). Créez une Regular Web Application dans l'Auth0 Dashboard.
- **Ping Identity (PingOne)** : un client ID, un client secret, l'**hôte PingOne** (l'hôte régional tel que `auth.pingone.com` ou `auth.pingone.eu`, ou un domaine personnalisé) et l'**ID d'environnement**.
- **Keycloak** : un client ID, un client secret, l'**URL du serveur** et le **realm**. Sur Keycloak 16 et versions antérieures, incluez le chemin de base `/auth` dans l'URL du serveur. Activez l'authentification du client pour que celui-ci soit confidentiel.
- **OneLogin** : un client ID, un client secret et votre **domaine OneLogin** (par exemple `acme.onelogin.com`). Réglez la méthode d'authentification du point de terminaison de jeton de l'application sur **POST**.
- **JumpCloud** : un client ID et un client secret issus d'une application OIDC personnalisée. Réglez son type d'authentification client sur **Client Secret Post**.
- **DATEV** : un client ID et un client secret issus d'une application du DATEV Developer Portal, abonnée au produit « Login with DATEV ». L'accès en production fait suite à une revue technique.
- **Criipto** : le domaine de votre tenant Criipto (par exemple `acme.criipto.id` ou un domaine personnalisé), un client ID, un client secret et l'identité électronique à utiliser. L'identité électronique étant fixe par connexion, ajoutez une connexion pour chaque identité électronique que vous souhaitez proposer.
- **Signicat** : le domaine de votre compte Signicat (par exemple `acme.signicat.com`), un client ID, un client secret et l'identité électronique à utiliser. Ajoutez une connexion par identité électronique.
- **German eID (Online-Ausweis)** : l'environnement (production ou référence), ainsi qu'un client ID et un client secret fournis par AusweisIDent. AusweisIDent exploite le serveur eID et détient le certificat d'autorisation : l'intégration se fait donc via OIDC standard.
- **Kakao** : une clé d'API REST (le client ID) et un client secret. Dans la console Kakao Developers, activez Kakao Login, activez OpenID Connect dans les paramètres avancés (nécessaire pour recevoir un ID token) et configurez les éléments de consentement. L'accès à l'adresse e-mail nécessite une Kakao Business App.
- **netID** : un client ID et un client secret issus d'un service que vous enregistrez dans le portail développeur netID. Un nouveau service démarre en bac à sable, réservé à des utilisateurs de test autorisés ; demandez sa validation pour un usage en production.
- **Intuit (QuickBooks)** : un client ID et un client secret issus d'une application du portail Intuit Developer. Les clés de production sont délivrées une fois qu'Intuit a terminé l'évaluation de l'application.
- **La plupart des fournisseurs sociaux** : un client ID (parfois nommé différemment, par exemple le client ID chez Slack, la key chez Bitbucket, l'application ID chez GitLab, l'integration key chez Docusign) et le secret correspondant. Suivez le guide de configuration de chaque fournisseur pour connaître les noms de champ exacts.
- **Les fournisseurs avec un hôte ou une région** : Salesforce, GitLab et Docusign ajoutent un champ **hôte** (par exemple un My Domain Salesforce, une instance GitLab auto-hébergée ou l'hôte Docusign de production par opposition à celui des développeurs), afin que la connexion vise la bonne instance.
- **Apple** : un Services ID (le client ID), votre team ID, le key ID et le contenu de la clé privée `.p8` que vous téléchargez depuis Apple. La clé privée est stockée chiffrée et n'est jamais réaffichée ; le client secret exigé par Apple en est généré automatiquement.
- **SAML générique** : l'URL de point d'entrée (connexion) du fournisseur, son Entity ID et son certificat de signature au format PEM, saisis directement. L'URL de callback (ACS) et l'Entity ID propres à la plateforme sont indiqués dans le guide de configuration de la connexion, afin que vous les enregistriez côté fournisseur.

Les secrets et les clés privées se saisissent dans des champs qui restent vides lorsque vous modifiez une connexion existante : laissez un champ de secret vide pour conserver la valeur stockée. Les secrets ne sont jamais réaffichés en clair ni écrits dans les journaux.

Lors de la configuration de la connexion, chaque guide indique également l'**URL de callback** à enregistrer chez le fournisseur, pour que celui-ci renvoie la réponse de connexion vers cette plateforme.

### Routage par domaine de messagerie (Home Realm Discovery)

Activez **Home Realm Discovery** sur une connexion et saisissez un ou plusieurs **domaines de messagerie**. Lorsqu'un utilisateur saisit une adresse e-mail dont le domaine correspond, il est envoyé directement vers ce fournisseur au lieu de l'écran de mot de passe : personne n'a donc à choisir le bon bouton « Sign in with… ». Saisissez les domaines sous forme de liste séparée par des virgules (par exemple `acme.com, acme.co.uk`).

- Une connexion pour laquelle des domaines de messagerie sont définis n'est **pas affichée comme bouton** sur la page de connexion ; elle n'est atteignable que par le routage de domaine (ou par un lien direct vers la connexion). L'écran de connexion reste ainsi épuré lorsque plusieurs fournisseurs entreprise sont configurés.
- Un domaine ne peut être attribué qu'à **une seule** connexion ; l'enregistrement d'une seconde connexion avec le même domaine est rejeté.
- Les utilisateurs dont le domaine de messagerie n'est pas routé, ainsi que ceux qui se connectent avec un nom d'utilisateur, poursuivent vers l'écran de mot de passe habituel.
- L'e-mail est transmis à un fournisseur OIDC sous forme de `login_hint`, afin que celui-ci puisse le préremplir et que l'utilisateur n'ait pas à saisir son e-mail une seconde fois. Les fournisseurs SAML ne le reçoivent pas (une SAML Request de connexion ne peut pas le transporter de façon fiable).
- Lorsqu'une application démarre la connexion avec une adresse e-mail connue (un `login_hint` OIDC) dans un domaine routé, l'utilisateur est envoyé directement vers le fournisseur, sans voir d'abord l'écran de connexion.
- Désactiver Home Realm Discovery (ou vider ses domaines) fait réapparaître le bouton de la connexion sur la page de connexion.

Si un fournisseur routé est temporairement mal configuré et que vous devez atteindre l'écran de mot de passe pour un compte de ce domaine, ajoutez `?noHrd=1` à l'URL de connexion afin d'ignorer le routage le temps de cette visite.

### Pourquoi enregistrer votre propre application chez le fournisseur

Pour chaque connexion (un fournisseur social tel que GitHub ou LinkedIn, ou un fournisseur entreprise tel qu'Okta ou Microsoft Entra), vous enregistrez une application OAuth *chez le fournisseur* et fournissez ici son client ID et son secret, plutôt que d'en utiliser un partagé. C'est délibéré :

- L'écran de consentement affiche **votre** nom et **votre** logo, pas des éléments génériques.
- L'application demande exactement les **scopes dont vous avez besoin**.
- Le callback est acheminé vers **votre propre domaine**, de sorte que la déconnexion et l'élévation MFA fonctionnent correctement.

L'écran des prérequis de la connexion indique ce qu'il faut enregistrer avant de commencer.

## Liaison de comptes

Lorsqu'un utilisateur revient via une connexion, la plateforme le reconnaît grâce à l'identifiant stable fourni par le fournisseur (et non par l'e-mail), le connecte à son compte lié et actualise son nom et son image depuis le fournisseur.

Pour empêcher les prises de contrôle de compte, si le fournisseur communique une adresse e-mail qui appartient déjà à un **autre** compte non lié à cette connexion, la connexion est **refusée** au lieu de fusionner les deux en silence : il n'existe aucune étape administrateur de « fusion de comptes », et un e-mail entrant (surtout non vérifié) ne prend jamais le contrôle d'un compte existant. L'e-mail de la connexion n'est repris sur un compte que lorsque la connexion est **de confiance**, que le fournisseur atteste l'e-mail comme vérifié et que le domaine de l'e-mail n'est pas réservé par un autre répertoire (voir la réservation de domaines de messagerie dans [Répertoires utilisateur](https://dts-identity.com/fr/docs/directories/user-directories.md)).

## Création d'utilisateurs just-in-time

Lorsqu'une personne se connecte pour la première fois via une connexion et qu'aucun compte correspondant n'existe, la plateforme en crée un **just in time** :

- Le nouvel utilisateur est placé dans le **répertoire** configuré sur la connexion.
- Son profil (nom, e-mail, image) est repris du fournisseur.
- Il n'a pas de mot de passe et se connecte uniquement via cette même connexion.

La façon dont le nouveau compte est activé dépend du réglage **Source de confiance** :

- Si la connexion est marquée comme **source de confiance** *et* que le fournisseur atteste que l'e-mail est vérifié, le compte est activé immédiatement.
- Sinon, l'utilisateur reçoit un e-mail d'activation et doit vérifier son adresse avant que le compte ne devienne actif.

Les fournisseurs sociaux sont de confiance par défaut ; les connexions OIDC et SAML génériques ne le sont pas, car il ne faut faire confiance à un claim d'e-mail que s'il provient d'un fournisseur que vous contrôlez ou que vous avez vérifié.

### Fournisseurs sans adresse e-mail

Certains fournisseurs ne communiquent pas d'adresse e-mail (par exemple X, Strava, Fitbit, SoundCloud, Vimeo et TikTok). Les connexions d'identité électronique (Criipto, Signicat et l'eID allemande) renvoient elles aussi un nom vérifié et un identifiant national plutôt qu'un e-mail. Une connexion par ce biais fonctionne malgré tout et crée bien un compte, mais ce compte n'a pas d'e-mail : aucun e-mail d'activation n'est envoyé et il ne peut pas être rapproché d'un compte existant par l'e-mail. L'utilisateur peut ajouter et vérifier un e-mail plus tard dans son portail de compte, ce qui active également la récupération par e-mail et toutes les options d'authentification multifacteur reposant sur l'e-mail.

Quelques fournisseurs renvoient un e-mail qu'ils ne vérifient pas (Spotify, par exemple). Cet e-mail est enregistré sur le nouveau compte, mais il est traité comme non vérifié et n'est jamais repris sur un autre compte existant : le compte suit donc vos règles de vérification habituelles.

### Apple

Apple ne renvoie le nom de l'utilisateur **qu'à la toute première connexion** : un utilisateur Apple qui revient conserve donc le nom capté à ce moment-là. Les utilisateurs qui choisissent l'option **Hide My Email** d'Apple se connectent avec une adresse de relais privée, ce qui fonctionne normalement. La clé privée `.p8` que vous saisissez est stockée chiffrée et sert uniquement à générer le client secret de courte durée exigé par Apple.

## Réglages par connexion

| Réglage | Effet |
|---|---|
| **Nom** | Le libellé affiché dans l'Admin Console et dans le journal d'audit. |
| **Répertoire** | L'endroit où les utilisateurs just-in-time sont créés. |
| **Home Realm Discovery** | Lorsque l'option est activée, les domaines de messagerie routés vers cette connexion. Un utilisateur qui saisit un e-mail portant l'un de ces domaines est envoyé directement vers ce fournisseur, et la connexion n'est pas affichée comme bouton sur la page de connexion. Un domaine ne peut appartenir qu'à une seule connexion. |
| **Source de confiance** | Contrôle l'activation automatique et la reprise ou non de l'e-mail du fournisseur. |
| **Activé** | Seules les connexions activées apparaissent sur l'écran de connexion. |

Vous pouvez désactiver une connexion pour la retirer de l'écran de connexion sans la supprimer, ou la supprimer entièrement. Les deux actions demandent une confirmation par la saisie du nom de la connexion.

## Référence

| Terme | Signification |
|---|---|
| Connexion | Une délégation de la connexion à un Identity Provider externe. |
| Liaison de comptes | Le rapprochement d'une identité fédérée de retour avec un compte existant. |
| Création just-in-time (JIT) | La création d'un compte lors de la première connexion fédérée d'un utilisateur. |
| Source de confiance | Une connexion dont la plateforme considère le claim d'e-mail vérifié comme fiable pour l'activation automatique. |
| Home Realm Discovery | Le routage automatique d'une connexion vers un fournisseur, d'après le domaine de messagerie saisi par l'utilisateur. |

## Dépannage

- **Le fournisseur renvoie une erreur sur le callback.** La cause la plus fréquente est une URL de redirection (callback) non enregistrée chez le fournisseur externe, ou un client ID / secret qui ne correspond pas. Enregistrez l'URL de callback exacte affichée lors de la création de la connexion et revérifiez les informations d'identification.
- **L'échange de jetons échoue avec une erreur `invalid_client`.** Certains fournisseurs (par exemple OneLogin et JumpCloud) règlent par défaut la méthode d'authentification du point de terminaison de jeton de l'application sur Basic. Réglez-la sur **POST** (client secret post) dans les paramètres de l'application chez le fournisseur.
- **Les utilisateurs d'un certain domaine de messagerie sont envoyés directement vers un fournisseur externe.** Ce domaine est attribué aux domaines de messagerie d'une connexion, ce qui active le routage par domaine (Home Realm Discovery). Retirez le domaine de la connexion pour cesser de le router. Pour atteindre l'écran de mot de passe une seule fois (par exemple lorsque le fournisseur est mal configuré), ajoutez `?noHrd=1` à l'URL de connexion.
- **La connexion Kakao échoue ou ne renvoie aucun ID token.** Kakao n'émet un ID token que lorsque OpenID Connect est activé dans les paramètres avancés Kakao Login de l'application. Un élément de consentement manquant interrompt également la connexion ; configurez les éléments de consentement demandés (pseudonyme, image de profil) dans la console Kakao.
- **Un utilisateur qui revient arrive sur un nouveau compte vide.** La liaison de comptes rapproche une identité fédérée d'un compte existant par l'e-mail vérifié. Si le fournisseur ne renvoie pas d'e-mail vérifié, ou si l'e-mail diffère de celui qui est enregistré, aucune correspondance n'est trouvée et un compte distinct est créé. Vérifiez que le fournisseur communique bien un claim d'e-mail vérifié.
- **La première connexion via une connexion est refusée avec une erreur de domaine.** Le domaine de l'e-mail est réservé par un autre répertoire. Un domaine listé sur un répertoire ne peut pas être revendiqué par des utilisateurs créés ailleurs, y compris par une connexion fédérée just-in-time. Déplacez la réservation ou utilisez une adresse dans un domaine non réservé.
- **Un utilisateur fédéré est créé mais reste inactif.** Les nouveaux comptes ne sont activés automatiquement que pour une connexion de confiance qui renvoie un e-mail vérifié. Pour les autres connexions, le compte suit vos règles habituelles de vérification et de cycle de vie.

Voir aussi le [glossaire](https://dts-identity.com/fr/docs/reference/glossary.md).
