> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Pages de connexion personnalisées, e-mails de connexion et domaine d'authentification personnalisé

> Personnalisez les pages et e-mails de connexion hébergés par Didit : votre marque, textes en cinq langues, liens CGU et confidentialité, et votre domaine.

Les pages de connexion hébergées de Didit Authentication et les e-mails de connexion utilisent votre marque, la même que celle de votre parcours de vérification.
Vous définissez les textes des pages et les liens juridiques pour Authentication, et vous pouvez faire passer la connexion sur votre propre domaine, par exemple `auth.example.com`.

Gérez cela dans la console, sous **Authentication > Branding and emails**, qui affiche un aperçu en direct de la page de connexion hébergée en mode clair et en mode sombre.

![La page Branding and emails de la Didit Business Console pour une application sandbox, avec la marque issue de Customization, les textes de la page et un aperçu de la page hébergée](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/console-branding.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=9653e0d5b5556cec809139cfa6eaf055)

Authentication > Branding and emails, avec un aperçu de la page hébergée.

## Votre marque

Le logo, la couleur de marque, l'arrière-plan, le rayon des angles et la police proviennent des paramètres **Customization** de votre application dans la console, et les pages hébergées ainsi que les e-mails les suivent.
Sélectionnez **Edit in Customization** pour les modifier : une seule modification met à jour à la fois le flux de vérification et les pages de connexion.

* Les pages suivent le mode clair ou sombre de l'appareil de la personne, et la couleur de marque est adaptée aux arrière-plans sombres.
* Les pages affichent le nom de votre application.
* Sur le forfait Free, les pages hébergées affichent un badge **Secured by Didit**.

![Page de connexion hébergée par Didit pour une application sandbox en mode clair et sombre, avec un bouton de clé d'accès et des champs e-mail et mot de passe](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/hosted-sign-in-light-dark.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=835219dfc253b7bfcb830255aff8ff93)

La page de connexion hébergée suit le mode clair ou sombre de l'appareil de la personne.

## Textes des pages et liens juridiques

| Champ | Limite | Où il s'affiche |
| - | - | - |
| **Titre de connexion** | 120 caractères | Le titre de la page de connexion. |
| **Sous-titre** | 160 caractères | La ligne sous le titre. |
| **Titre d'inscription** | 120 caractères | Le titre de la page d'inscription. |
| **URL des conditions d'utilisation** | 500 caractères | Un lien sur les pages. Lorsqu'elle est définie, le formulaire d'inscription demande à la personne d'accepter vos conditions d'utilisation. |
| **URL de la politique de confidentialité** | 500 caractères | Un lien sur les pages, à côté de vos conditions d'utilisation. |

Les pages hébergées sont traduites en anglais, espagnol, français, allemand et japonais. La langue est choisie selon le navigateur de la personne, ou selon `ui_locales` dans l'URL de connexion.
Définissez vos propres textes pour chaque langue : une langue sans texte personnalisé conserve la valeur par défaut traduite par Didit.

Via l'API, `PATCH branding/` de l'[API de gestion de l'authentification](https://docs.didit.me/fr/authentication/set-up-by-api.md) définit les mêmes champs :

```bash theme={null}
curl --fail-with-body --request PATCH "${MANAGEMENT_BASE}branding/" \
  -H "x-api-key: $DIDIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "texts": {
      "en": {"sign_in_title": "Welcome back", "subtitle": "Sign in to manage your account.", "sign_up_title": "Open your account"},
      "es": {"sign_in_title": "Hola de nuevo"}
    },
    "terms_url": "https://example.com/legal/terms",
    "privacy_url": "https://example.com/legal/privacy"
  }'
```

Un texte envoyé vide revient à la valeur par défaut.

## E-mails de connexion

La vue des e-mails de **Branding and emails** affiche les e-mails de connexion de votre application, avec un aperçu de chacun et le bouton **Send a test** :

| E-mail | Envoyé lorsque |
| - | - |
| Code par e-mail | Une personne se connecte ou s'inscrit avec un code par e-mail. |
| Lien magique | Une personne demande un lien de connexion. |
| Réinitialisation du mot de passe | Une personne lance une procédure [mot de passe oublié](https://docs.didit.me/fr/authentication/sign-in-methods.md#mot-de-passe-oublié-et-réinitialisation). |
| Connexion depuis un nouvel appareil | Une personne se connecte depuis un nouvel appareil. |
| Invitation | Vous invitez une personne à s'inscrire, avec la politique d'inscription `invited`. |
| Invitation à une organisation | Vous invitez une personne à rejoindre l'une de vos [organisations](https://docs.didit.me/fr/authentication/organizations.md#invitations). |
| Agent approuvé, Accès de l'agent terminé | Un [agent IA](https://docs.didit.me/fr/authentication/agent-access.md) d'une personne obtient ou perd l'accès. |

Chaque e-mail est marqué **On** ou **Off** pour votre application.
Les e-mails sont envoyés depuis votre domaine d'e-mail vérifié si vous en configurez un dans Personnalisation, et depuis `Didit <no-reply@didit.me>` dans le cas contraire.

## Domaine personnalisé

Par défaut, votre application connecte les utilisateurs sur `https://<slug>.auth.didit.me`.
Un domaine personnalisé déplace les pages hébergées, l'API d'exécution et l'émetteur des tokens vers un sous-domaine qui vous appartient, par exemple `auth.example.com`.
Les domaines personnalisés sont destinés aux applications en production : une application sandbox se connecte toujours sur le domaine Didit.

> [!WARNING]
>
> Les clés d'accès sont liées au domaine sur lequel les utilisateurs se connectent.
> Activer un domaine personnalisé impose de réenregistrer les clés d'accès existantes. Ajoutez donc votre domaine avant que les utilisateurs ne commencent à créer des clés d'accès.

### Mise en place

1. Sous **Custom domain**, saisissez **Your domain**, par exemple `auth.example.com`, puis choisissez **Add domain**. Utilisez un sous-domaine : un CNAME ne peut pas se trouver à la racine de votre domaine.
2. Créez l'enregistrement DNS affiché par la console : un `CNAME` pointant de votre domaine vers l'hôte Didit de votre application.
3. Choisissez **Check DNS now**. Un nouvel enregistrement peut mettre jusqu'à une heure à apparaître. Dès que Didit le détecte, il émet un certificat pour votre domaine, qui se renouvelle automatiquement.
4. Lorsque le domaine affiche **Verified**, choisissez **Use this domain** pour en faire l'origine de connexion de votre application.

| Statut | Signification |
| - | - |
| Waiting for DNS | Didit n'a pas encore trouvé l'enregistrement `CNAME`. |
| Issuing certificate | L'enregistrement est en place, et le certificat est en cours d'émission. |
| Verified | Votre domaine sert les pages hébergées. Il n'est pas votre origine de connexion tant que vous ne l'avez pas activé. |
| Active | Votre domaine est l'origine de connexion et l'émetteur. |
| Not found | La vérification a échoué. Corrigez l'enregistrement, puis vérifiez à nouveau. |

Par API, `PUT domain/` avec `{"domain": "auth.example.com"}` ajoute le domaine, `POST domain/verify/` le vérifie, `POST domain/activate/` l'active et `DELETE domain/` le supprime.

### Ce qui change à l'activation

* **L'émetteur.** Les nouveaux tokens indiquent votre domaine dans `iss`, et la découverte ainsi que le JWKS passent sur ce domaine. Mettez à jour l'émetteur que votre backend vérifie, ou acceptez les deux émetteurs jusqu'à l'expiration des anciens tokens. Voir [tokens et JWKS](https://docs.didit.me/fr/authentication/tokens-and-jwks.md).
* **La clé publiable.** Elle encode l'émetteur, elle change donc : copiez la nouvelle clé depuis **Authentication > Developers** dans votre application.
* **Les sessions et les tokens** associés à l'ancien domaine prennent fin dans les 5 minutes.
* **Les clés d'accès** doivent être réenregistrées sur le nouveau domaine.
* **Les URL de redirection, les paramètres et les personnes inscrites** restent inchangés.

Conservez la clé publiable dans un seul paramètre de votre application, afin que la bascule ne demande qu'une seule modification.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.