---
title: "Améliorer la sécurité des e-mails via un enregistrement DKIM"
description: "Découvrez comment configurer un enregistrement DKIM sur votre nom de domaine et votre plateforme e-mail OVHcloud"
url: https://docs.ovhcloud.com/fr/guides/web-cloud/domains/dns-zone-dkim
lang: fr
lastUpdated: 2026-06-08
---
# Améliorer la sécurité des e-mails via un enregistrement DKIM

## Objectif

L’enregistrement DKIM (**D**omain**K**eys **I**dentified **M**ail) permet de signer les e-mails pour éviter l’usurpation d’identité. Cette signature fonctionne sur le principe du hachage combiné à une cryptographie asymétrique.

**Découvrez comment fonctionne DKIM et comment le mettre en place pour votre service e-mail.**

## Prérequis

- Avoir souscrit à l’une des offres e-mail ci-dessous :
  <Region zones={['eu']}>
    - MX Plan OVHcloud (disponible via une [offre d’hébergement web](https://www.ovhcloud.com/fr/web-hosting/), un [hébergement gratuit](https://www.ovhcloud.com/fr/domains/free-web-hosting/) ou une offre MX Plan commandée séparément).
  </Region>
  <Region zones={['ca', 'apac']}>
    - MX Plan OVHcloud (disponible via une [offre d’hébergement web](https://www.ovhcloud.com/fr/web-hosting/) ou une offre MX Plan commandée séparément).
  </Region>
  <Region zones={['eu', 'ca']}>
    - [Exchange](https://www.ovhcloud.com/fr/emails/hosted-exchange/) ou [Private Exchange](https://www.ovhcloud.com/fr/emails/hosted-exchange/).
  </Region>
  <Region zones={['eu']}>
    - [E-mail Pro](https://www.ovhcloud.com/fr/emails/email-pro/).
  </Region>
  <Region zones={['eu']}>
    - [Zimbra](https://www.ovhcloud.com/fr/emails/zimbra-emails/).
  </Region>
  - Une offre e-mail hors OVHcloud disposant du DKIM.


***

### Accès à l’espace client OVHcloud

- **Lien direct :** <ManagerLink to="/#/web/zone">Zones DNS</ManagerLink>
- **Pour accéder à vos services :** <code className="action">Web Cloud</code> > <code className="action">Zones DNS</code> > Sélectionnez votre nom de domaine

***


:::warning
Si votre nom de domaine n’utilise pas les serveurs DNS d’OVHcloud, vous devez réaliser la modification du DKIM depuis l’interface du prestataire gérant la configuration de votre nom de domaine.

Si votre nom de domaine est déposé chez OVHcloud, vous pouvez vérifier si ce dernier utilise notre configuration OVHcloud dans votre espace client
 depuis l’onglet `Zone DNS
`, une fois le domaine concerné sélectionné.
:::
## En pratique

**Sommaire**

- [Comment le DKIM fonctionne-t-il ?](#how-dkim-work)
  - [Le hachage](#hash)
  - [Le chiffrement asymétrique](#encrypt)
  - [Comment le hachage et le chiffrement asymétrique sont-ils utilisés pour le DKIM ?](#encrypt-and-hash)
  - [Pourquoi a-t-on besoin de configurer les serveurs DNS ?](#dns-and-dkim)
  - [Exemple d’un e-mail envoyé en utilisant le DKIM](#example)
  - [Qu’est-ce qu’un sélecteur DKIM ?](#selector)
- [Configurer le DKIM automatiquement pour une offre e-mail OVHcloud](#auto-dkim)
- [Configurer le DKIM par API pour une offre e-mail OVHcloud](#internal-dkim)
  - [API - Configuration complète du DKIM](#firststep)
    - [Pour MX Plan et Zimbra](#confemail)
    <Region zones={['eu', 'ca']}>
      * [Pour Exchange](#confex)
    </Region>
    <Region zones={['eu']}>
      - [Pour E-mail Pro](#confemp)
    </Region>
  - [API - Les différents états du DKIM](#dkim-status)
  - [API - Activer ou changer un sélecteur DKIM](#enable-switch)
  - [API - Désactiver et supprimer le DKIM](#disable-switch)
- [Configurer DKIM pour une offre e-mail hors de votre compte OVHcloud](#external-dkim)
  - [Enregistrement DKIM](#dkim-record)
  - [Enregistrement TXT](#txt-record)
  - [Enregistrement CNAME](#cname-record)
- [Tester votre DKIM](#test-dkim)
- [Cas d’usages](#usecases)
  - [Comment changer sa paire de clé DKIM ?](#2selectors)
  - [Pourquoi l’icône DKIM apparait en rouge dans l’espace client ?](#reddkim)
  - [Depuis l’interface API OVHcloud, comment comprendre l’état du DKIM qui ne fonctionne pas ?](#api-error)

### Comment le DKIM fonctionne-t-il ? [](#)
Pour bien comprendre pourquoi le DKIM permet de sécuriser vos échanges d’e-mails, il est nécessaire de comprendre comment il fonctionne. Le DKIM fait appel au « **hachage** » et au « **chiffrement asymétrique** » pour créer une signature sécurisée. La **plateforme e-mail** et la **zone DNS** de votre nom de domaine vont aider à transmettre les informations du DKIM à vos destinataires.


Le hachage 
[](#)

Le principe d’une **fonction de hachage** est de générer une **signature** (aussi appelée empreinte) à partir d’une donnée d’entrée. Son intérêt est de créer en sortie une suite de caractères fixe, quelle que soit la quantité de données en entrée.
Sur le diagramme suivant, vous pouvez constater que la sortie (Output) sera toujours composée de 32 caractères en utilisant un algorithme de hachage MD5 (**M**essage **D**igest **5**), alors que le texte d’entrée (Input) peut varier en taille. La moindre variation de caractère dans la donnée d’entrée change complètement le hachage en sortie, ce qui rend la signature en sortie imprévisible et infalsifiable. Dans l’exemple ci-dessous, la valeur d’entrée (Input) est passée dans l’algorithme de hachage MD5 et présente en sortie (Output) sa valeur de hachage.
![hash](/images/assets/schemas/emails/dns-dkim-hash01.png)La fonction de hachage est utile lorsque vous souhaitez vérifier l’intégrité d’un message. En effet, deux données qui peuvent sembler très similaires présentent en réalité une valeur de hachage complètement différente, avec une longueur de caractères égale en sortie, quelle que soit la longueur d’entrée.


Le chiffrement asymétrique 
[](#)

Le **chiffrement**, comme son nom l’indique, a pour but de chiffrer les données qu’on lui donne. Il est « **asymétrique** » car la clé de chiffrement n’est pas la même que la clé de déchiffrement, contrairement à un chiffrement symétrique qui utilisera la même clé pour chiffrer et déchiffrer.
Dans le chiffrement asymétrique, on utilise une **clé publique** et une **clé privée**. La clé publique est visible et utilisable par tous. La clé privée est uniquement utilisée par le titulaire et n’est pas visible de tous.
Il existe deux utilisations du chiffrement asymétrique :
- **La donnée d’entrée est chiffrée avec la clé publique et déchiffrée par celui qui possède la clé privée**. Par exemple, vous souhaitez qu’un tiers vous transmette des données de manière sécurisée. Vous transmettez votre clé publique sans vous soucier que quelqu’un la récupère, ce tiers chiffrera ses données avec votre clé publique. Les données chiffrées ne pourront être déchiffrées que par le titulaire de la clé privée.
![hash](/images/assets/schemas/emails/dns-dkim-crypto01.png)- **La donnée d’entrée est chiffrée par le titulaire de la clé privée et déchiffrée par la clé publique**. Cette utilisation s’applique pour authentifier un échange de donnée. Par exemple, vos destinataires souhaitent s’assurer que vous êtes bien l’auteur du message que vous leur transmettez. Dans ce cas, vous allez chiffrer votre message avec votre clé privée. Ce message ne pourra être déchiffré que par la clé publique que vous aurez transmise à tout le monde, ce qui garantit à vos destinataires l’authenticité de votre message. En effet, un message déchiffré par la clé publique ne peut provenir uniquement que du titulaire de la clé privée.
![hash](/images/assets/schemas/emails/dns-dkim-crypto02.png)


Comment le hachage et le chiffrement asymétrique sont-ils utilisés pour le DKIM ? 
[](#)

Depuis la plateforme e-mail, le DKIM va utiliser le hachage pour créer une signature à partir de certains éléments de [l’en-tête de l’e-mail](/fr/guides/web-cloud/email-and-collaborative-solutions/troubleshooting/diagnostic-headers.md) et du corps de l’e-mail (contenu de l’e-mail).
La signature est ensuite chiffrée avec la clé privée en utilisant le chiffrement asymétrique.


Pourquoi a-t-on besoin de configurer les serveurs DNS ? 
[](#)

Pour que le destinataire puisse vérifier la signature DKIM de l’expéditeur, il aura besoin des paramètres DKIM et surtout de la clé publique pour la déchiffrer. La [zone DNS](/fr/guides/web-cloud/domains/dns-zone-general-information.md) d’un nom de domaine est publique, c’est pourquoi un enregistrement DNS est ajouté pour transmettre la clé publique et les paramètres DKIM au destinataire.


Qu’est-ce qu’un sélecteur DKIM ? 
[](#)

Lorsque vous activez le DKIM, celui-ci fonctionne avec une paire de clé publique / clé privée. Il est possible d’attribuer plusieurs paires de clés à votre nom de domaine, dans le cadre d’une rotation par exemple. En effet, lorsque vous changez de paire de clés, l’ancienne paire doit rester active le temps que l’ensemble des e-mails que vous avez envoyé avec l’ancienne clé ne rencontre pas d’échec dans la vérification du DKIM sur le serveur de réception.
Pour que ce principe de rotation fonctionne, on va utiliser ce qu’on appelle les **sélecteurs DKIM**. Un sélecteur DKIM comprend une paire de clé privée/clé publique. Il est visible sous la forme d’une chaîne de caractère dans la signature DKIM d’un e-mail par l’argument `s=`. Cette signature est visible dans [l’en-tête de l’e-mail](/fr/guides/web-cloud/email-and-collaborative-solutions/troubleshooting/diagnostic-headers.md).
**Exemple d’une partie de signature DKIM**
```
DKIM-Signature: v=1; a=rsa-sha256; d=mydomain.ovh; s=ovhex123456-selector1; c=relaxed/relaxed; t=1681877341;
```
La valeur du sélecteur est ici `s=ovhex123456-selector1`.


Exemple d’un e-mail envoyé en utilisant le DKIM 
[](#)

Lorsque vous envoyez un e-mail depuis **[contact@mydomain.ovh](mailto:contact@mydomain.ovh)**, une signature chiffrée à l’aide d’une clé privée (private key) est ajoutée dans l’en-tête de l’e-mail.
Le destinataire **[recipient@otherdomain.ovh](mailto:recipient@otherdomain.ovh)** pourra déchiffrer cette signature avec la clé publique (Public key) visible dans la zone DNS de **mydomain.ovh**. La signature est créée à partir du contenu de l’e-mail envoyé. Cela signifie que si l’e-mail est modifié lors du transit, la signature ne correspondra pas avec le contenu et cela provoquera donc l’échec de la vérification DKIM sur le serveur destinataire.

### Configurer le DKIM automatiquement pour une offre e-mail OVHcloud [](#)
La configuration automatique du DKIM est accessible pour toutes nos offres e-mail :

- MX Plan incluse avec un [hébergement web](https://www.ovhcloud.com/fr/web-hosting/), un [hébergement gratuit](https://www.ovhcloud.com/fr/domains/free-web-hosting/) ou commandée séparément.


- [Exchange](https://www.ovhcloud.com/fr/emails-exchange/).

- [E-mail Pro](https://www.ovhcloud.com/fr/emails/email-pro/).

- [Zimbra](https://www.ovhcloud.com/fr/emails/zimbra-emails/).

Lorsque vous configurez votre nom de domaine sur une solution e-mail OVHcloud, la configuration automatique du DKIM est proposée et réalisée par défaut si vous ne la désactivez pas.

Si le DKIM n’a pas été activé lorsque vous avez ajouté un nom de domaine à votre plateforme e-mail, vous devrez lancer le processus de configuration automatique via l’espace client.

Cliquez sur l’onglet ci-dessous correspondant à votre offre.


**MX Plan**

1. Connectez-vous à votre <ManagerLink to="/">espace client OVHcloud</ManagerLink>.
2. Rendez-vous dans la partie <code className="action">Web Cloud</code>.
3. Cliquez sur <code className="action">MX Plan</code>.
4. Sélectionnez le domaine concerné.
5. Enfin, allez dans l’onglet <code className="action">Informations générales</code>.
Dans le cadre **Informations générales**, vous pouvez observer que la pastille `DKIM` est rouge sous la mention **Diagnostique**.
![email](/images/assets/screens/control-panel/product-selection/web-cloud/emails/general-information/dkim-auto01.png)Pour activer le DKIM, il vous suffit maintenant de cliquer sur la pastille `DKIM` rouge puis sur <code className="action">Activer</code> depuis la fenêtre d’activation qui apparaît.
![email](/images/assets/screens/control-panel/product-selection/web-cloud/microsoft/exchange/associated-domains/dkim-auto02.png)Dans le cas où votre nom de domaine n’est pas géré dans le même espace client OVHcloud que votre plateforme e-mail ou enregistré hors OVHcloud, vous obtenez la fenêtre ci-dessous :
![email](/images/assets/screens/control-panel/product-selection/web-cloud/emails/general-information/dkim-auto02.png)Celle-ci vous invite à saisir deux valeurs CNAME dans la zone DNS du nom de domaine, ce qui permet de lier ce nom de domaine aux sélecteurs DKIM de votre service e-mail. Il est nécessaire de saisir ces valeurs et de vous assurer qu’elles soient propagées avant de cliquer sur <code className="action">Activer</code>.


**Exchange**

1. Connectez-vous à votre <ManagerLink to="/">espace client OVHcloud</ManagerLink>.
2. Rendez-vous dans la partie <code className="action">Web Cloud</code>.
3. Dans la rubrique `MICROSOFT`, cliquez sur <code className="action">Exchange</code>.
4. Sélectionnez la plateforme concernée.
5. Enfin, allez dans l’onglet <code className="action">Domaines associés</code>.
À droite du nom de domaine concerné, vous pouvez observer que la pastille `DKIM` est rouge.
![email](/images/assets/screens/control-panel/product-selection/web-cloud/microsoft/exchange/associated-domains/dkim-auto01.png)Pour activer le DKIM, il vous suffit maintenant de cliquer sur la pastille `DKIM` rouge puis sur <code className="action">Activer</code> depuis la fenêtre d’activation qui apparaît.
![email](/images/assets/screens/control-panel/product-selection/web-cloud/microsoft/exchange/associated-domains/dkim-auto02.png)

**E-mail Pro**

1. Connectez-vous à votre <ManagerLink to="/">espace client OVHcloud</ManagerLink>.
2. Rendez-vous dans la partie <code className="action">Web Cloud</code>.
3. Cliquez sur <code className="action">Email Pro</code>.
4. Sélectionnez la plateforme concernée.
5. Enfin, allez dans l’onglet <code className="action">Domaines associés</code>.
À droite du nom de domaine concerné, vous pouvez observer que la pastille `DKIM` est rouge.
![email](/images/assets/screens/control-panel/product-selection/web-cloud/microsoft/exchange/associated-domains/dkim-auto01.png)Pour activer le DKIM, il vous suffit maintenant de cliquer sur la pastille `DKIM` rouge puis sur <code className="action">Activer</code> depuis la fenêtre d’activation qui apparaît.
![email](/images/assets/screens/control-panel/product-selection/web-cloud/microsoft/exchange/associated-domains/dkim-auto02.png)

**Zimbra**

1. Connectez-vous à votre <ManagerLink to="/">espace client OVHcloud</ManagerLink>.
2. Rendez-vous dans la partie <code className="action">Web Cloud</code>.
3. Cliquez sur <code className="action">Zimbra Mail</code>.
4. Enfin, allez dans l’onglet <code className="action">Domaine</code>.
5. À droite du domaine concerné, cliquez sur <code className="action">⁝</code>, puis sur <code className="action">Diagnostics</code>.
![email](/images/assets/screens/control-panel/product-selection/web-cloud/zimbra/domain/diagnostics/access.png)À droite de la mention `DKIM` sur l’onglet correspondant, vous devriez observer un avertissement indiquant que le DKIM est en défaut. Cliquez sur l’onglet <code className="action">DKIM</code> pour accéder au statut de la configuration DKIM. Pour corriger l’erreur, vous devez ajouter ou modifier deux entrées DNS de type CNAME dans la zone DNS du nom de domaine associé, selon les informations visible depuis cet onglet.
![email](/images/assets/screens/control-panel/product-selection/web-cloud/zimbra/domain/diagnostics/dkim-cname-conf.png):::info
**Astuce pour créer un enregistrement CNAME**
Depuis <ManagerLink to="/">l’espace client OVHcloud</ManagerLink> où est hébergé le nom de domaine de votre service e-mail, dans la partie <code className="action">Web Cloud</code>, cliquez sur <code className="action">Noms de domaine</code> dans la colonne de gauche et sélectionnez le nom de domaine concerné.<br />
Sélectionnez l’onglet <code className="action">Zone DNS</code> puis cliquez sur <code className="action">Ajouter une entrée</code> dans la fenêtre qui s’affiche. Choisissez `CNAME` puis complétez selon les valeurs que vous avez relevées.
:::


L’activation automatique du DKIM dure entre 30 minutes et 24 heures maximum. Pour vérifier que votre DKIM est fonctionnel, il vous suffit de retourner dans la rubrique de gestion du domaine mentionnée dans les onglet ci-dessus et de vérifier que la pastille `DKIM` est verte ou, pour une offre Zimbra, que l’onglet `DKIM` ne présente plus l’icône d’avertissement.

![email](/images/assets/screens/control-panel/product-selection/web-cloud/microsoft/exchange/associated-domains/dkim-auto03.png)
Au-delà des 24 heures, si votre pastille `DKIM` est rouge, consultez la rubrique « [Pourquoi le DKIM n’est pas fonctionnel et apparait en rouge dans l’espace client ?](#reddkim) » de ce guide.

### Configurer le DKIM par API pour une e-mail OVHcloud <a name="internal-dkim" />

Pour une plateforme Exchange ou E-mail Pro, vous devez d’abord récupérer la référence de votre plateforme pour configurer votre DKIM.


Cliquez sur l’onglet ci-dessous correspondant à votre offre.


**Exchange**

1. Connectez-vous à votre <ManagerLink to="/">espace client OVHcloud</ManagerLink>.
2. Rendez-vous dans la partie <code className="action">Web Cloud</code>.
3. Dans la rubrique `MICROSOFT`, cliquez sur <code className="action">Exchange</code>.
4. Sélectionnez la plateforme concernée.
Par défaut, le nom de votre plateforme correspond à sa référence ou celle-ci sera visible sous le nom que vous lui avez attribué (voir l’image ci-dessous).
![email](/images/assets/screens/control-panel/product-selection/web-cloud/microsoft/exchange/general-information/dns-dkim-platform-exchange.png)

**E-mail Pro**

1. Connectez-vous à votre <ManagerLink to="/">espace client OVHcloud</ManagerLink>.
2. Rendez-vous dans la partie <code className="action">Web Cloud</code>.
3. Cliquez sur <code className="action">Email Pro</code>.
4. Sélectionnez la plateforme concernée.
Par défaut, le nom de votre plateforme correspond à sa référence ou celle-ci sera visible sous le nom que vous lui avez attribué (voir l’image ci-dessous).
![email](/images/assets/screens/control-panel/product-selection/web-cloud/email-pro/general-information/dns-dkim-platform-emailpro.png)

Assurez-vous également que le nom de domaine que vous souhaitez utiliser pour vos e-mails soit bien actif dans la rubrique `Domaines associés
`.
![email](/images/assets/screens/control-panel/product-selection/web-cloud/microsoft/exchange/associated-domains/dns-dkim-domain.png)
#### API - Configuration complète du DKIM [](#)
Pour configurer le DKIM, rendez-vous sur la [page des API OVHcloud](https://eu.api.ovh.com/) et connectez-vous :

1. Cliquez sur <code className="action">Authentication</code> en haut à gauche.
2. Cliquez ensuite sur <code className="action">Login with OVHcloud SSO</code>.
3. Saisissez vos identifiants OVHcloud.
4. Cliquez sur le bouton <code className="action">Authorize</code> pour autoriser les appels aux API depuis ce site.

:::info
Appuyez-vous sur notre guide « [Premiers pas avec les API OVHcloud](/fr/guides/manage-and-operate/api/first-steps.md) » si vous n’avez jamais utilisé les API.
:::

Dirigez-vous vers la section `/email/domain/` (offres MX Plan et Zimbra), `/email/exchange` (offre Exchange) ou `/email/pro` (offre E-mail Pro) des API et renseignez « dkim » dans le champ `Filter` pour faire apparaître uniquement les fonctions API relatives au DKIM.

Cliquez sur l’onglet correspondant à votre offre :


**MX Plan et Zimbra**

![email](/images/assets/screens/api/get-email-domain-domain-dkim.png)

**Exchange**

![email](/images/assets/screens/api/get-email-exchange-organizationname-service-exchangeservice-domain-domainname-dkim.png)

**E-mail Pro**

![email](/images/assets/screens/api/get-email-pro-service-domain-domainname-dkim.png)

##### **Pour MX Plan et Zimbra**
 [](#)
Suivez les **5 étapes** en cliquant successivement sur chacun des 5 onglets ci-dessous :


**1. Activer le DKIM sur votre nom de domaine**

Pour activer le DKIM sur votre nom de domaine, utilisez l’appel API suivant :<br />

🇪🇺EU▾

[PUT/email/domain/{domain}/dkim/enable](https://eu.api.ovh.com/console/?section=/email/domain/&branch=v1#put-/email/domain/-domain-/dkim/enable)

- `domain` : saisissez le nom de domaine attaché à votre service E-mail sur lequel vous souhaitez activer DKIM.
Cliquez sur <code className="action">EXECUTE</code> pour lancer l’activation.<br />
_Exemple de résultat:_
```console
{
 "domain": "mydomain.ovh",
 "id": 123455789,
 "function": "domain/enableDKIM",
 "status": "todo"
}
```
Vous devriez obtenir le même résultat que dans l’exemple ci-dessus avec la mention `"status": "todo"` indiquant que le DKIM va être installé.


**2. Vérifier l’état de l’opération DKIM**

Après avoir lancé le processus d’activation du DKIM, suivez l’état de l’installation pour vous assurer que l’installation se termine ou pour récupérer les enregistrements DNS si votre zone DNS est gérée en dehors de votre espace client OVHcloud.<br />
Pour cela, utilisez l’appel API suivant :<br />

🇪🇺EU▾

[GET/email/domain/{domain}/dkim](https://eu.api.ovh.com/console/?section=/email/domain/&branch=v1#get-/email/domain/-domain-/dkim)

- `domain` : saisissez le nom de domaine attaché à votre service E-mail.<br />

Cliquez sur <code className="action">EXECUTE</code> pour visualiser le résultat.<br />
_Exemple de résultat :_
```console
{
 "activeSelector": null,
 "autoconfig": true,
 "selectors": [
   {
     "selectorName": "ovhmo3456789-selector2",
     "status": "set",
     "cname": "ovhmo3456789-selector2._domainkey.mydomain.ovh CNAME ovhmo3456789-selector2._domainkey.123402.aj.dkim.mail.ovh.net."
   },
   {
     "selectorName": "ovhmo3456789-selector1",
     "cname": "ovhmo3456789-selector1._domainkey.mydomain.ovh CNAME ovhmo3456789-selector1._domainkey.123403.aj.dkim.mail.ovh.net.",
     "status": "set"
   }
 ],
 "status": "modifying"
}
```

Dans l’exemple ci-dessus, la dernière ligne d’état `"status": "modifying"` signifie que la configuration est en cours. Patientez environ **10 minutes** et relancez l’appel API.
- si la valeur est `"status": "enabled"`, votre configuration est terminée et fonctionnelle.
- si la valeur est `"status": "disabled"`, votre configuration doit être complétée manuellement, passez à l’étape suivante.


**3. Récupérer l’enregistrement DNS**

Vous devez configurer manuellement la zone DNS de votre nom de domaine **dans les cas suivants** :
- votre service E-mail est lié à un nom de domaine qui est géré dans un autre compte client OVHcloud ;
- votre service E-mail est lié à un nom de domaine qui est géré dans un autre bureau d’enregistrement.
Pour configurer votre zone DNS, vous devez récupérer les valeurs de l’enregistrement DNS **des deux sélecteurs**. Pour cela, utilisez le résultat de l’appel API de l’étape précédente :

🇪🇺EU▾

[GET/email/domain/{domain}/dkim](https://eu.api.ovh.com/console/?section=/email/domain/&branch=v1#get-/email/domain/-domain-/dkim)

- `domain` : saisissez le nom de domaine attaché à votre service E-mail.
Cliquez sur <code className="action">EXECUTE</code> pour visualiser le résultat.
_Exemple de résultat :_
```console
{
 "activeSelector": null,
 "status": "disabled",
 "autoconfig": false,
 "selectors": [
   {
     "cname": "ovhmo3456789-selector1._domainkey.mydomain.ovh CNAME ovhmo3456789-selector1._domainkey.123403.aj.dkim.mail.ovh.net."
     "status": "toSet",
     "selectorName": "ovhmo4287928-selector1"
   },
   {
     "selectorName": "ovhmo4287928-selector2",
     "cname": "ovhmo3456789-selector2._domainkey.mydomain.ovh CNAME ovhmo3456789-selector2._domainkey.123402.aj.dkim.mail.ovh.net.",
     "status": "toSet"
   }
 ]
}
```
Les valeurs `"status": "toSet"` et `"status": "disabled"` signifient que les enregistrements CNAME sont à configurer. Récupérez les 2 valeurs `cname` dans un fichier texte et passez à l’étape suivante.


**4. Configurer l’enregistrement DNS**

Depuis <ManagerLink to="/">l’espace client OVHcloud</ManagerLink> où est hébergé le nom de domaine de votre service e-mail, dans l’onglet <code className="action">Web Cloud</code>, cliquez sur <code className="action">Noms de domaine</code> dans la colonne de gauche et sélectionnez le nom de domaine concerné.<br />
Dirigez-vous vers l’onglet <code className="action">Zone DNS</code> puis cliquez sur <code className="action">Ajouter une entrée</code> dans la fenêtre qui s’affiche. Choisissez `CNAME` puis complétez selon les valeurs que vous avez relevées.
Si on décompose les valeurs de l’exemple à l’étape "**3. Récupérer l’enregistrement DNS**" :
- `ovhmo3456789-selector1._domainkey.mydomain.ovh` correspond au sous-domaine de l’enregistrement CNAME. On garde seulement `ovhmo3456789-selector1._domainkey` car le `.mydomain.ovh` est déjà prérempli. <br />
- `ovhmo3456789-selector1._domainkey.123403.aj.dkim.mail.ovh.net."` correspond à la cible de l’enregistrement. Il faut bien conserver le point à la fin pour ponctuer la valeur.<br />
![email](/images/assets/screens/control-panel/product-selection/web-cloud/domain-dns/dns-zone/dns-dkim-api022.png)Une fois les valeurs saisies, cliquez sur <code className="action">Suivant</code> puis sur <code className="action">Valider</code>.
:::info
**Répétez cette opération pour le deuxième sélecteur.**
:::
Si vous configurez votre zone DNS dans une interface tierce hors OVHcloud, votre enregistrement CNAME doit avoir la forme suivante :
```console
ovhmo3456789-selector1._domainkey IN CNAME ovhmo3456789-selector1._domainkey.123403.aj.dkim.mail.ovh.net.
```
:::warning
N’oubliez pas qu’une modification dans une zone DNS est soumise à un délai de propagation. Il est généralement court mais peut s’étendre jusqu’à 24 heures.
:::


**5. Activation du DKIM**

Après la propagation de votre configuration DNS, utilisez à nouveau l’appel API suivant pour activer le DKIM :<br />

🇪🇺EU▾

[PUT/email/domain/{domain}/dkim/enable](https://eu.api.ovh.com/console/?section=/email/domain/&branch=v1#put-/email/domain/-domain-/dkim/enable)

- `domain` : saisissez le nom de domaine attaché à votre service e-mail sur lequel vous souhaitez activer DKIM.
Cliquez sur <code className="action">EXECUTE</code> pour lancer l’activation.<br />
_Exemple de résultat :_
```console
{
 "selectors": [
   {
     "selectorName": "ovhmo3465680-selector2",
     "cname": "ovhmo3456789-selector2._domainkey.mydomain.ovh CNAME ovhmo3456789-selector2._domainkey.123402.aj.dkim.mail.ovh.net.",
     "status": "set"
   },
   {
     "status": "set",
     "cname": "ovhmo3456789-selector1._domainkey.mydomain.ovh CNAME ovhmo3456789-selector1._domainkey.123403.aj.dkim.mail.ovh.net."
     "selectorName": "ovhmo3465680-selector1"
   }
 ],
 "activeSelector": "ovhmo3465680-selector1",
 "autoconfig": true,
 "status": "enabled"
}
```
- Si vous constatez bien les valeurs `"status": "set"` sur les 2 sélecteurs, cela signifie qu’ils sont bien configurés.
- Si vous constatez les valeurs `"status": "toSet"` sur les 2 sélecteurs, cela signifie que vos modifications DNS ne sont pas visibles. Reprenez à l’onglet « **4. Configurer l’enregistrement DNS** ».
- Si vous constatez bien les valeurs `"status": "toFix"` sur les 2 sélecteurs, cela signifie que les enregistrements CNAME ont bien été détectés dans la zone DNS de votre nom de domaine mais que les valeurs sont incorrectes. Reprenez à l’onglet « **4. Configurer l’enregistrement DNS** ».
:::tip
Vous avez maintenant effectué toutes les manipulations pour activer le DKIM. Pour s’assurer que celui-ci est bien activé, vérifiez son état en retournant à l’onglet de l’étape « **2. Vérifier l’état de l’opération DKIM** » pour vérifier que la valeur `status:` est bien en `enabled`. Si c’est bien le cas, votre DKIM est désormais actif.
:::


##### **Pour Exchange** <a name="confex" />
Suivez les **5 étapes** ci-dessous en cliquant sur chacun des onglets.

**1. Liste des sélecteurs**

Avant de créer un des sélecteurs pour votre nom de domaine, vous devez récupérer le nom qui leur est attribué automatiquement par la plateforme Exchange.<br />

Pour cela, utilisez l’appel API suivant :<br />

🇪🇺EU▾

[GET/email/exchange/{organizationName}/service/{exchangeService}/domain/{domainName}/dkimSelector](https://eu.api.ovh.com/console/?section=/email/exchange&branch=v1#get-/email/exchange/-organizationName-/service/-exchangeService-/domain/-domainName-/dkimSelector)

- `domainName` : saisissez le nom de domaine attaché à votre plateforme Exchange sur lequel vous souhaitez activer DKIM. <br />
- `exchangeService` : saisissez le nom de votre plateforme Exchange se présentant sous la forme « hosted-zz111111-1 » ou « private-zz111111-1 ». <br />
- `organizationName` : saisissez le nom de votre plateforme Exchange se présentant sous la forme « hosted-zz111111-1 » ou « private-zz111111-1 ». <br />
_Exemple de résultat :_
```console
"ovhex123456-selector1"
"ovhex123456-selector2"
```


**2. Créer un sélecteur**

Vous allez maintenant créer un sélecteur, générer sa paire de clés et l’enregistrement DNS associé au nom de domaine.<br />

Pour cela, utilisez l’appel API suivant :<br />

🇪🇺EU▾

[POST/email/exchange/{organizationName}/service/{exchangeService}/domain/{domainName}/dkim](https://eu.api.ovh.com/console/?section=/email/exchange&branch=v1#post-/email/exchange/-organizationName-/service/-exchangeService-/domain/-domainName-/dkim)

- `domainName` : saisissez le nom de domaine attaché à votre plateforme Exchange sur lequel vous souhaitez activer le DKIM.
- `exchangeService` : saisissez le nom de votre plateforme Exchange se présentant sous la forme « hosted-zz111111-1 » ou « private-zz111111-1 ».
- `organizationName` : saisissez le nom de votre plateforme Exchange se présentant sous la forme « hosted-zz111111-1 » ou « private-zz111111-1 ».
- `"selectorName"` : dans l’onglet **EXAMPLE** de la section **REQUEST BODY**, saisissez le nom d’un sélecteur que vous avez relevé à l’étape précédente (exemple: « ovhex123456-selector1 »).
_Exemple de saisie :_
```console
{
   "autoEnableDKIM": false,
   "configureDkim": false,
   "selectorName": "ovhex123456-selector1"
}
```
Cliquez sur <code className="action">EXECUTE</code> pour lancer la création du sélecteur.<br />
:::info
Nous vous conseillons de réaliser cette opération à deux reprises pour chacun des sélecteurs précédemment listés. Le deuxième sélecteur vous permettra d’effectuer un changement de paire de clés lorsque cela sera nécessaire. Nous vous invitons à consulter notre cas d’usage « [Comment changer sa paire de clés DKIM](#2selectors) » lorsque vous souhaiterez basculer sur le deuxième sélecteur.
:::

_Exemple de résultat :_
```console
status: "todo",
function: "addExchangeDomainDKIM",
id : 107924143,
"finishDate": null,
"todoDate": "2023-05-05T11:32:07+02:00"
```


**3. Récupérer l’enregistrement DNS**

Vous devez configurer manuellement la zone DNS de votre nom de domaine **dans les cas suivants** :
- votre plateforme Exchange est liée à un nom de domaine qui est géré dans un autre compte client OVHcloud ;<br />
- votre plateforme Exchange est liée à un nom de domaine qui est géré dans un autre bureau d’enregistrement ;<br />
Pour configurez votre zone DNS, vous devez récupérer les valeurs de l’enregistrement DNS **pour chaque sélecteur si vous en avez créé deux**. Pour cela, utilisez l’appel API suivant :

🇪🇺EU▾

[GET/email/exchange/{organizationName}/service/{exchangeService}/domain/{domainName}/dkim/{selectorName}](https://eu.api.ovh.com/console/?section=/email/exchange&branch=v1#get-/email/exchange/-organizationName-/service/-exchangeService-/domain/-domainName-/dkim/-selectorName-)

- `domainName` : saisissez le nom de domaine attaché à votre plateforme Exchange sur lequel vous souhaitez configurer le DKIM.
- `exchangeService` : saisissez le nom de votre plateforme Exchange se présentant sous la forme « hosted-zz111111-1 » ou « private-zz111111-1 ».
- `organizationName` : saisissez le nom de votre plateforme Exchange se présentant sous la forme « hosted-zz111111-1 » ou « private-zz111111-1 ».
- `selectorName` : saisissez le nom du sélecteur que vous avez créé à l’étape précédente.
_Exemple de résultat :_
```console
targetRecord: "ovhex123456-selector1._domainkey.1675.ac.dkim.mail.ovh.net"
recordType: "CNAME"
header: "from;to;subject;date"
taskPendingId: 108712689
status: "waitingRecord"
cnameIsValid: false
lastUpdate: "1970-01-01T00:00:00+01:00"
customerRecord: "ovhex123456-selector1._domainkey.mydomain.ovh"
selectorName: "ovhex1234565-selector1"
```
Récupérez les valeurs `customerRecord` et `targetRecord` dans un fichier texte. Passez à l’étape suivante.
:::info
Il est possible que le `status:` soit en `todo`, cela n’a pas d’incidence sur la configuration de votre zone DNS.
:::


**4. Configurer l’enregistrement DNS**

Depuis <ManagerLink to="/">l’espace client OVHcloud</ManagerLink> où est hébergé le nom de domaine de votre plateforme Exchange, dans l’onglet <code className="action">Web Cloud</code>, cliquez sur <code className="action">Noms de domaine</code> dans la colonne de gauche et sélectionnez le nom de domaine concerné.<br />
Dirigez-vous vers l’onglet <code className="action">Zone DNS</code> puis cliquez sur <code className="action">Ajouter une entrée</code> dans la fenêtre qui s’affiche. Choisissez `CNAME` puis complétez selon les valeurs que vous avez relevées.<br />
Si on prend les valeurs de l’exemple à l’étape "**3.Récupérer l’enregistrement DNS**":
- `customerRecord: "ovhex123456-selector1._domainkey.mydomain.ovh"` correspond au sous-domaine de l’enregistrement CNAME. On garde seulement `ovhex123456-selector1._domainkey` car le `.mydomain.ovh` est déjà prérempli. <br />
- `targetRecord: "ovhex123456-selector1._domainkey.1500.ab.dkim.mail.ovh.net"` correspond à la cible de l’enregistrement. On y rajoute un point à la fin pour ponctuer la valeur. Cela donne `ovhex123456-selector1._domainkey.1500.ab.dkim.mail.ovh.net.`<br />
![email](/images/assets/screens/control-panel/product-selection/web-cloud/domain-dns/dns-zone/dns-dkim-api02.png)
Une fois les valeurs saisies, cliquez sur <code className="action">Suivant</code> puis sur <code className="action">Valider</code>.<br />
**Répétez cette opération pour le deuxième sélecteur si vous l’avez créé.**<br />
Si vous configurez votre zone DNS dans une interface tierce hors OVHcloud, votre enregistrement CNAME doit avoir la forme suivante :
```console
ovhex123456-selector1._domainkey IN CNAME ovhex123456-selector1._domainkey.1500.ab.dkim.mail.ovh.net.
```
:::warning
N’oubliez pas qu’une modification dans une zone DNS est soumise à un délai de propagation. Il est généralement court mais peut s’étendre jusqu’à 24 heures.
:::


**5. Activation du DKIM**

:::warning
Depuis la section « [API - Les différents états du DKIM](#dkim-status) » de ce guide, vérifiez que la valeur `status:` est bien en `ready` avant de pouvoir activer le DKIM.
:::
Pour activer le DKIM, utilisez l’appel API suivant :

🇪🇺EU▾

[POST/email/exchange/{organizationName}/service/{exchangeService}/domain/{domainName}/dkim/{selectorName}/enable](https://eu.api.ovh.com/console/?section=/email/exchange&branch=v1#post-/email/exchange/-organizationName-/service/-exchangeService-/domain/-domainName-/dkim/-selectorName-/enable)

- `domainName` : saisissez le nom de domaine attaché à votre plateforme Exchange sur lequel vous souhaitez activer le DKIM.
- `exchangeService` : saisissez le nom de votre plateforme Exchange se présentant sous la forme « hosted-zz111111-1 » ou « private-zz111111-1 ».
- `organizationName` : saisissez le nom de votre plateforme Exchange se présentant sous la forme « hosted-zz111111-1 » ou « private-zz111111-1 ».
- `selectorName` : saisissez le nom du sélecteur que vous avez créé.
_Exemple de résultat :_
```console
id: 108716876
todoDate: "2023-05-05T11:30:11+02:00"
finishDate: null
status: "todo"
function: "enableExchangeDKIM"
```
:::tip
Vous avez maintenant effectué toutes les manipulations pour activer le DKIM. Pour s’assurer que celui-ci est bien activé, consultez la section « [API - Les différents états du DKIM](#dkim-status) » de ce guide pour vérifier que la valeur `status:` est bien en `inProduction`. Si c’est bien le cas, votre DKIM est désormais actif.<br /><br /> **Si vous avez créé deux sélecteurs**, le deuxième sélecteur devrait être en `status: "ready"`.
:::


##### **Pour E-mail Pro** <a name="confemp" />
Suivez les **5 étapes** ci-dessous en cliquant sur chacun des onglets.

**1. Liste des sélecteurs**

Avant de créer un des sélecteurs pour votre nom de domaine, vous devez récupérer le nom qui leur est attribué automatiquement par la plateforme E-mail Pro.<br />

Pour cela, utilisez l’appel API suivant :<br />

🇪🇺EU▾

[GET/email/pro/{service}/domain/{domainName}/dkim](https://eu.api.ovh.com/console/?section=/email/pro&branch=v1#get-/email/pro/-service-/domain/-domainName-/dkim)

- `service` : saisissez le nom de votre plateforme E-mail Pro se présentant sous la forme « emailpro-zz111111-1 » . <br />
- `domainName` : saisissez le nom de domaine attaché à votre plateforme E-mail Pro sur lequel vous souhaitez activer DKIM. <br />
_Exemple de résultat :_
```console
"ovhemp123456-selector1"
"ovhemp123456-selector2"
```


**2. Créer un sélecteur**

Vous allez maintenant créer un sélecteur, générer sa paire de clés et l’enregistrement DNS associé au nom de domaine.<br />
:::info
Nous vous conseillons de réaliser cette opération à deux reprises pour chacun des sélecteurs précédemment listés. Le deuxième sélecteur vous permettra d’effectuer un changement de paire de clés lorsque cela sera nécessaire. Nous vous invitons à consulter notre cas d’usage « [Comment changer sa paire de clés DKIM](#2selectors) ».
:::

Pour cela, utilisez l’appel API suivant :<br />

🇪🇺EU▾

[POST/email/pro/{service}/domain/{domainName}/dkim](https://eu.api.ovh.com/console/?section=/email/pro&branch=v1#post-/email/pro/-service-/domain/-domainName-/dkim)

- `domainName` : saisissez le nom de domaine attaché à votre plateforme E-mail Pro sur lequel vous souhaitez activer le DKIM.
- `service` : saisissez le nom de votre plateforme E-mail Pro se présentant sous la forme « emailpro-zz111111-1 » . <br />
- `"selectorName"` : Dans l’onglet **EXAMPLE** de la section **REQUEST BODY**, saisissez le nom d’un sélecteur que vous avez relevé à l’étape précédente. (exemple: « ovhemp123456-selector1 »).
_Exemple de saisie :_
```console
{
   "autoEnableDKIM": false,
   "configureDkim": false,
   "selectorName": "ovhemp123456-selector1"
}
```
Cliquez sur <code className="action">EXECUTE</code> pour lancer la création du sélecteur.<br />
:::info
Nous vous conseillons de réaliser cette opération à deux reprises pour chacun des sélecteurs précédemment listés. Le deuxième sélecteur vous permettra d’effectuer un changement de paire de clés lorsque cela sera nécessaire. Nous vous invitons à consulter notre cas d’usage « [Comment changer sa paire de clés DKIM](#2selectors) » lorsque vous souhaiterez basculer sur le deuxième sélecteur.
:::
_Exemple de résultat :_
```console
status: "todo",
function: "addDomainDKIM",
id : 107924143,
"finishDate": null,
"todoDate": "2023-05-05T11:32:07+02:00"
```


**3. Récupérer l’enregistrement DNS**

Vous devez configurer manuellement la zone DNS de votre nom de domaine **dans les cas suivants** :
- votre plateforme E-mail Pro est liée à un nom de domaine qui est géré dans un autre compte client OVHcloud ;<br />
- votre plateforme E-mail Pro est liée à un nom de domaine qui est géré dans un autre bureau d’enregistrement ;<br />
Pour configurer votre zone DNS, vous devez récupérer les valeurs de l’enregistrement DNS **pour chaque sélecteur si vous en avez créé deux**. Pour cela, utilisez l’appel API suivant :

🇪🇺EU▾

[GET/email/pro/{service}/domain/{domainName}/dkim/{selectorName}](https://eu.api.ovh.com/console/?section=/email/pro&branch=v1#get-/email/pro/-service-/domain/-domainName-/dkim/-selectorName-)

- `service` : saisissez le nom de votre plateforme E-mail Pro se présentant sous la forme « emailpro-zz111111-1 » .
- `domainName` : saisissez le nom de domaine attaché à votre plateforme E-mail Proe sur lequel vous souhaitez configurer le DKIM.
- `selectorName` : saisissez le nom du sélecteur que vous avez créé à l’étape précédente.
_Exemple de résultat :_
```console
targetRecord: "ovhemp123456-selector1._domainkey.1675.ac.dkim.mail.ovh.net"
recordType: "CNAME"
header: "from;to;subject;date"
taskPendingId: 108712689
status: "waitingRecord"
cnameIsValid: false
lastUpdate: "1970-01-01T00:00:00+01:00"
customerRecord: "ovhemp123456-selector1._domainkey.mydomain.ovh"
selectorName: "ovhemp1234565-selector1"
```
Récupérez les valeurs `customerRecord` et `targetRecord` dans un fichier texte. Passez à l’étape suivante.
:::info
Il est possible que le `status:` soit en `todo`, cela n’a pas d’incidence sur la configuration de votre zone DNS.
:::


**4. Configurer l’enregistrement DNS**

Depuis <ManagerLink to="/">l’espace client OVHcloud</ManagerLink> où est hébergé le nom de domaine de votre plateforme E-mail Pro, dans l’onglet <code className="action">Web Cloud</code>, cliquez sur <code className="action">Noms de domaine</code> dans la colonne de gauche et sélectionnez le nom de domaine concerné.<br />
Dirigez-vous vers l’onglet <code className="action">Zone DNS</code> puis cliquez sur <code className="action">Ajouter une entrée</code> dans la fenêtre qui s’affiche. Choisissez `CNAME` puis complétez selon les valeurs que vous avez relevées.<br />
Si on prend les valeurs de l’exemple à l’étape "**3.Récupérer l’enregistrement DNS**":
- `customerRecord: "ovhemp123456-selector1._domainkey.mydomain.ovh"` correspond au sous-domaine de l’enregistrement CNAME. On garde seulement `ovhemp123456-selector1._domainkey` car le `.mydomain.ovh` est déjà prérempli. <br />
- `targetRecord: "ovhemp123456-selector1._domainkey.1500.ab.dkim.mail.ovh.net"` correspond à la cible de l’enregistrement. On y rajoute un point à la fin pour ponctuer la valeur. Cela donne `ovhemp123456-selector1._domainkey.1500.ab.dkim.mail.ovh.net.`<br />
![email](/images/assets/screens/control-panel/product-selection/web-cloud/domain-dns/dns-zone/dns-dkim-api02.png)
Une fois les valeurs saisies, cliquez sur <code className="action">Suivant</code> puis sur <code className="action">Valider</code>.<br />
**Répétez cette opération pour le deuxième sélecteur si vous l’avez créé.**<br />
Si vous configurez votre zone DNS dans une interface tierce hors OVHcloud, votre enregistrement CNAME doit avoir la forme suivante :
```console
ovhemp123456-selector1._domainkey IN CNAME ovhemp123456-selector1._domainkey.1500.ab.dkim.mail.ovh.net.
```
:::warning
N’oubliez pas qu’une modification dans une zone DNS est soumise à un délai de propagation. Il est généralement court mais peut s’étendre jusqu’à 24 heures.
:::


**5. Activation du DKIM**

:::warning
Depuis la section « [API - Les différents états du DKIM](#dkim-status) » de ce guide, vérifiez que la valeur `status:` est bien en `ready` avant de pouvoir activer le DKIM.
:::
Pour activer le DKIM, utilisez l’appel API suivant :

🇪🇺EU▾

[GET/email/pro/{service}/domain/{domainName}/dkim/{selectorName}](https://eu.api.ovh.com/console/?section=/email/pro&branch=v1#get-/email/pro/-service-/domain/-domainName-/dkim/-selectorName-)

- `service` : saisissez le nom de votre plateforme E-mail Pro se présentant sous la forme « emailpro-zz111111-1 » .
- `domainName` : saisissez le nom de domaine attaché à votre plateforme E-mail Pro sur lequel vous souhaitez activer le DKIM.
- `selectorName` : saisissez le nom du sélecteur que vous avez créé.
_Exemple de résultat :_
```console
id: 108716876
todoDate: "2023-05-05T11:30:11+02:00"
finishDate: null
status: "todo"
function: "enableDKIM"
```
:::tip
Vous avez maintenant effectué toutes les manipulations pour activer le DKIM. Pour s’assurer que celui-ci est bien activé, consultez la section « [API - Les différents états du DKIM](#dkim-status) » de ce guide pour vérifier que la valeur `status:` est bien en `inProduction`. Si c’est bien le cas, votre DKIM est désormais actif.<br /><br /> **Si vous avez créé deux sélecteurs**, le deuxième sélecteur devrait être en `status: "ready"`.
:::


#### API - Les différents états du DKIM [](#)
Sélectionnez l’offre e-mail concernée dans les onglets suivants :


**MX Plan et Zimbra**

Lors de vos opérations sur le DKIM de votre plateforme E-mail, utilisez l’appel API ci-dessous pour vérifier le statut actuel du DKIM.

🇪🇺EU▾

[GET/email/domain/{domain}/dkim](https://eu.api.ovh.com/console/?section=/email/domain/&branch=v1#get-/email/domain/-domain-/dkim)

- `domain` : saisissez le nom de domaine attaché à votre service E-mail sur lequel le DKIM doit être présent.
Regardez ensuite la valeur `status:` générale dans le résultat :
- `disabled` : le DKIM est désactivé, il n’a pas encore été configuré ou il a été désactivé par API. <br />
- `modifying` : la configuration du DKIM est en cours, il est nécessaire de patienter jusqu’à la fin du processus.<br />
- `toConfigure` : la configuration du DKIM est en attente des paramètres DNS du nom de domaine. Vous devez renseigner manuellement les enregistrements DNS dans la zone du nom de domaine. Pour cela, appuyez-vous sur [l’étape 4 de « la configuration complète du DKIM » pour MX Plan et Zimbra](#confemail).<br />
- `enabled` : le DKIM est configuré et fonctionnel.<br />
- `error` : Le processus d’installation a rencontré une erreur. Nous vous invitons à ouvrir un [ticket auprès du support](https://help.ovhcloud.com/csm?id=csm_get_help) en précisant le nom de domaine concerné.<br />
Au niveau des sélecteurs vous avez également 3 états possibles:
- `set` : le sélecteur est bien configuré et actif.
- `toSet` : le sélecteur n’est pas configuré dans la zone DNS du nom de domaine. Appuyez-vous sur [l’étape 4 de « la configuration complète du DKIM » pour MX Plan et Zimbra](#confemail).
- `toFix` : le sélecteur a bien été configuré dans la zone DNS du nom de domaine mais les valeurs sont incorrectes. Appuyez-vous sur [l’étape 4 de « la configuration complète du DKIM » pour MX Plan et Zimbra](#confemail).


**Exchange**

Lors de vos opérations sur le DKIM de votre plateforme Exchange, utilisez l’appel API ci-dessous pour vérifier le statut actuel du DKIM.

🇪🇺EU▾

[GET/email/exchange/{organizationName}/service/{exchangeService}/domain/{domainName}/dkim/{selectorName}](https://eu.api.ovh.com/console/?section=/email/exchange&branch=v1#get-/email/exchange/-organizationName-/service/-exchangeService-/domain/-domainName-/dkim/-selectorName-)

- `domainName` : saisissez le nom de domaine attaché à votre plateforme Exchange sur lequel le DKIM doit être présent. <br />
- `exchangeService` : saisissez le nom de votre plateforme Exchange se présentant sous la forme « hosted-zz111111-1 » ou « private-zz111111-1 ». <br />
- `organizationName` : saisissez le nom de votre plateforme Exchange se présentant sous la forme « hosted-zz111111-1 » ou « private-zz111111-1 ». <br />
- `selectorName` : saisissez le nom du sélecteur que vous avez créé. <br />
Regardez ensuite la valeur `status:` dans le résultat :
- `todo` : la tâche a été initialisée, elle va se lancer. <br />
- `WaitingRecord` : les enregistrements DNS sont en attente de configuration ou en cours de validation dans la zone DNS du nom de domaine. Une vérification automatique régulière est faite pour constater si l’enregistrement DNS est présent et correctement renseigné.
- `ready` : les enregistrements DNS sont présents dans la zone. Le DKIM peut maintenant être activé. <br />
- `inProduction` : le DKIM est bien configuré et activé, il est donc pleinement opérationnel. <br />
- `disabling` : le DKIM est en cours de désactivation. <br />
- `deleting` : le DKIM est en cours de suppression. <br />
Si vous rencontrez l’erreur suivante lorsque vous lancez l’appel API, cela signifie que le sélecteur n’existe pas ou a été supprimé. Il faudra le créer.
```console
Not Found (404)
{ "message": "The requested object (selectorName = ovhemp123456-selector1) does not exist" }
```


**E-mail Pro**

Lors de vos opérations sur le DKIM de votre plateforme E-mail Pro, utilisez l’appel API ci-dessous pour vérifier le statut actuel du DKIM.

🇪🇺EU▾

[GET/email/pro/{service}/domain/{domainName}/dkim/{selectorName}](https://eu.api.ovh.com/console/?section=/email/pro&branch=v1#get-/email/pro/-service-/domain/-domainName-/dkim/-selectorName-)

- `service` : saisissez le nom de votre plateforme E-mail Pro se présentant sous la forme « emailpro-zz111111-1 » . <br />
- `domainName` : saisissez le nom de domaine attaché à votre plateforme E-mail Pro sur lequel le DKIM doit être présent. <br />
- `selectorName` : saisissez le nom du sélecteur que vous avez créé . <br />
Regardez ensuite la valeur `status:` dans le résultat :
- `todo` : la tâche a été initialisée, elle va se lancer. <br />
- `WaitingRecord` : les enregistrements DNS sont en attente de configuration ou en cours de validation dans la zone DNS du nom de domaine. Une vérification automatique régulière est faite pour constater si l’enregistrement DNS est présent et correctement renseigné. <br />
- `ready` : les enregistrements DNS sont présents dans la zone. Le DKIM peut maintenant être activé. <br />
- `inProduction` : le DKIM est bien configuré et activé, il est donc pleinement opérationnel. <br />
- `disabling` : le DKIM est en cours de désactivation. <br />
- `deleting` : le DKIM est en cours de suppression. <br />
Si vous rencontrez l’erreur suivante lorsque vous lancez l’appel API, cela signifie que le sélecteur n’existe pas ou a été supprimé. Il faudra le créer.
```console
Not Found (404)
{ "message": "The requested object (selectorName = ovhemp123456-selector1) does not exist" }
```


#### API - Activer ou changer un sélecteur DKIM [](#)
:::warning
Le sélecteur DKIM doit être en statut `ready` avant de pouvoir être activé.
:::

Sélectionnez l’offre e-mail concernée parmi les onglets suivants :


**MX Plan et Zimbra**

Pour activer le DKIM, utilisez l’appel API suivant :

🇪🇺EU▾

[PUT/email/domain/{domain}/dkim/enable](https://eu.api.ovh.com/console/?section=/email/domain/&branch=v1#put-/email/domain/-domain-/dkim/enable)

- `domain` : saisissez le nom de domaine attaché à votre service E-mail sur lequel le DKIM doit être présent. <br />
_Exemple de résultat :_
```console
{
 "function": "domain/enableDKIM",
 "id": 123456789,
 "domain": "guidesteam.ovh",
 "status": "todo"
}
```


**Exchange**

Pour activer le DKIM sur un sélecteur, utilisez l’appel API suivant :

🇪🇺EU▾

[POST/email/exchange/{organizationName}/service/{exchangeService}/domain/{domainName}/dkim/{selectorName}/enable](https://eu.api.ovh.com/console/?section=/email/exchange&branch=v1#post-/email/exchange/-organizationName-/service/-exchangeService-/domain/-domainName-/dkim/-selectorName-/enable)

- `domainName` : saisissez le nom de domaine attaché à votre plateforme Exchange sur lequel vous souhaitez activer le DKIM.<br />
- `exchangeService` : saisissez le nom de votre plateforme Exchange se présentant sous la forme « hosted-zz111111-1 » ou « private-zz111111-1 ».<br />
- `organizationName` : saisissez le nom de votre plateforme Exchange se présentant sous la forme « hosted-zz111111-1 » ou « private-zz111111-1 ».<br />
- `selectorName` : saisissez le nom d’un sélecteur existant.<br />


**E-mail Pro**

Pour activer le DKIM sur un sélecteur, utilisez l’appel API suivant :

🇪🇺EU▾

[POST/email/pro/{service}/domain/{domainName}/dkim/{selectorName}/enable](https://eu.api.ovh.com/console/?section=/email/pro&branch=v1#post-/email/pro/-service-/domain/-domainName-/dkim/-selectorName-/enable)

- `domainName` : saisissez le nom de domaine attaché à votre plateforme E-mail Pro sur lequel le DKIM doit être présent.<br />
- `selectorName` : saisissez le nom du sélecteur que vous avez créé .<br />
- `service` : saisissez le nom de votre plateforme E-mail Pro se présentant sous la forme « emailpro-zz111111-1 » . <br />


:::info
Lors d’une rotation de sélecteur DKIM, vous pouvez directement activer le deuxième sélecteur que vous avez créé afin de basculer dessus, tout en conservant le premier sélecteur qui restera actif le temps que tous les e-mails délivrés avec celui-ci soient bien analysés par leur destinataire.
:::

#### API - Désactiver et supprimer le DKIM [](#)
:::warning
**Pour les offres Exchange et E-mail Pro**
 

Le sélecteur DKIM doit être en statut `inProduction` ou `ready` avant de pouvoir être désactivé.
:::

Sélectionnez l’offre e-mail concernée parmi les onglets suivants :


**MX Plan et Zimbra**

Si vous souhaitez désactiver le DKIM sans supprimer les sélecteurs et leur paire de clés, utilisez l’appel API suivant :

🇪🇺EU▾

[PUT/email/domain/{domain}/dkim/disable](https://eu.api.ovh.com/console/?section=/email/domain/&branch=v1#put-/email/domain/-domain-/dkim/disable)

- `domain` : saisissez le nom de domaine attaché à votre service E-mail sur lequel le DKIM doit être présent. <br />
_Exemple de résultat :_
```console
{
 "domain": "guidesteam.ovh",
 "id": 174219594,
 "function": "domain/disableDKIM",
 "status": "todo"
}
```


**Exchange**

Si vous souhaitez désactiver le DKIM sans supprimer le sélecteur et sa paire de clés, utilisez l’appel API suivant:

🇪🇺EU▾

[POST/email/exchange/{organizationName}/service/{exchangeService}/domain/{domainName}/dkim/{selectorName}/disable](https://eu.api.ovh.com/console/?section=/email/exchange&branch=v1#post-/email/exchange/-organizationName-/service/-exchangeService-/domain/-domainName-/dkim/-selectorName-/disable)

- `domainName` : saisissez le nom de domaine attaché à votre plateforme Exchange. <br />
- `exchangeService` : saisissez le nom de votre plateforme Exchange se présentant sous la forme « hosted-zz111111-1 » ou « private-zz111111-1 ». <br />
- `organizationName` : saisissez le nom de votre plateforme Exchange se présentant sous la forme « hosted-zz111111-1 » ou « private-zz111111-1 ». <br />
- `selectorName` : saisissez le nom du sélecteur que vous souhaitez désactiver. <br />
Si vous souhaitez supprimer le sélecteur DKIM et sa paire de clés, utilisez l’appel API suivant :

🇪🇺EU▾

[DELETE/email/exchange/{organizationName}/service/{exchangeService}/domain/{domainName}/dkim/{selectorName}](https://eu.api.ovh.com/console/?section=/email/exchange&branch=v1#delete-/email/exchange/-organizationName-/service/-exchangeService-/domain/-domainName-/dkim/-selectorName-)

- `domainName` : saisissez le nom de domaine attaché à votre plateforme Exchange. <br />
- `exchangeService` : saisissez le nom de votre plateforme Exchange se présentant sous la forme « hosted-zz111111-1 » ou « private-zz111111-1 ». <br />
- `organizationName` : saisissez le nom de votre plateforme Exchange se présentant sous la forme « hosted-zz111111-1 » ou « >> private-zz111111-1 ». <br />
- `selectorName` : saisissez le nom du sélecteur que vous souhaitez supprimer. <br />


**E-mail Pro**

Si vous souhaitez désactiver le DKIM sans supprimer le sélecteur et sa paire de clés, utilisez l’appel API suivant :

🇪🇺EU▾

[POST/email/pro/{service}/domain/{domainName}/dkim/{selectorName}/disable](https://eu.api.ovh.com/console/?section=/email/pro&branch=v1#post-/email/pro/-service-/domain/-domainName-/dkim/-selectorName-/disable)

- `domainName` : saisissez le nom de domaine attaché à votre plateforme E-mail Pro. <br />
- `selectorName` : saisissez le nom du sélecteur que vous souhaitez désactiver. <br />
- `service` : saisissez le nom de votre plateforme E-mail Pro se présentant sous la forme « emailpro-zz111111-1 » . <br />
Si vous souhaitez supprimer le sélecteur DKIM et sa paire de clés, utilisez l’appel API suivant :

🇪🇺EU▾

[DELETE/email/pro/{service}/domain/{domainName}/dkim/{selectorName}](https://eu.api.ovh.com/console/?section=/email/pro&branch=v1#delete-/email/pro/-service-/domain/-domainName-/dkim/-selectorName-)

- `domainName` : saisissez le nom de domaine attaché à votre plateforme E-mail Pro. <br />
- `selectorName` : saisissez le nom du sélecteur que vous souhaitez supprimer. <br />
- `service` : saisissez le nom de votre plateforme E-mail Pro se présentant sous la forme « emailpro-zz111111-1 » . <br />


### Configurer le DKIM pour une offre e-mail hors de votre compte OVHcloud [](#)
Si vous souhaitez configurer votre zone DNS afin d’y ajouter un enregistrement DKIM pour votre offre, suivez les instructions ci-dessous.

Depuis l’espace client OVHcloud
, cliquez sur l’onglet `Web Cloud
` puis sur `Noms de domaine
` dans la colonne de gauche et sélectionnez le nom de domaine concerné.
Cliquez sur l’onglet `Zone DNS
` puis sur `Ajouter une entrée
`. Il existe 3 manières d’ajouter un enregistrement pour paramétrer le DKIM dans votre zone DNS :
- [un enregistrement DKIM](#dkim-record) : configuration permettant de visualiser l’ensemble des paramètres d’un enregistrement DKIM.
- [un enregistrement TXT](#txt-record) : enregistrement à utiliser lorsque l’ensemble des paramètres DKIM vous ont été fournis.
- [un enregistrement CNAME](#cname-record) : enregistrement utilisé pour une offre e-mail OVHcloud ou un serveur e-mail Microsoft.

#### Enregistrement DKIM [](#)
Cet enregistrement est nommé DKIM sur l’interface mais il s’agit en réalité d’un enregistrement TXT en sortie. L’enregistrement DKIM a pour but de faciliter la lecture des différents éléments de paramétrage du DKIM en les présentant sous forme de cases indépendantes.

![email](/images/assets/screens/control-panel/product-selection/web-cloud/domain-dns/dns-zone/dns-dkim-add.png)
- **Sous-domaine** : renseignez le nom du sélecteur DKIM et ajoutez `._domainkey` en suffixe, votre nom de domaine s’ajoutera automatiquement à la fin.

_exemple:_

```console
  selector-name._domainkey.mydomain.ovh.
```

- **Version (v=)** : sert à indiquer la version du DKIM. Il est recommandé de l’utiliser et sa valeur par défaut est `DKIM1`.<br />
  Si spécifié, ce tag doit être placé en premier dans l’enregistrement et doit être égal à "DKIM1" (sans les guillemets). Les enregistrements qui commencent par un tag "v=" avec une autre valeur doivent être ignorés.

- **Granularité (g=)** : permet de spécifier la partie « local-part » d’une adresse e-mail, c’est-à-dire la partie située avant le « @ ».<br />
  Elle permet de spécifier l’adresse e-mail ou les adresses e-mail qui sont autorisées à signer un message électronique avec la clé DKIM du sélecteur.<br />
  La valeur par défaut de "g=" est "\*", ce qui signifie que toutes les adresses e-mail sont autorisées à utiliser la clé de signature DKIM.<br />
  En indiquant une valeur spécifique pour "g=", on peut limiter l’utilisation de la clé à une partie locale d’adresse e-mail spécifique ou à une plage d’adresses e-mail spécifiques en utilisant des caractères génériques (par exemple : "\*-group").

- **Algorithme (hash) (h=)** : permet de spécifier les algorithmes de hachage utilisés pour signer les en-têtes d’e-mail. Cette balise permet de définir une liste d’algorithmes de hachage qui seront utilisés pour générer une signature DKIM pour un message donné.

- **Type de clé (k=)** : spécifie l’algorithme de signature utilisé pour signer les messages électroniques sortants. Il permet aux destinataires de savoir comment le message a été signé et quelle est la méthode utilisée pour vérifier son authenticité.<br />
  Les valeurs possibles pour le tag "k=" comprennent "rsa" pour l’algorithme de signature RSA et "ed25519" pour l’algorithme de signature Ed25519. Le choix de l’algorithme dépend de la politique de sécurité de l’expéditeur et de la prise en charge par le destinataire.

- **Notes (n=)** : sert à inclure des notes d’intérêt pour les administrateurs qui gèrent le système de clés DKIM.<br />
  Ces notes peuvent être utiles pour des raisons de documentation ou pour aider les administrateurs à comprendre ou à gérer le fonctionnement de DKIM. Les notes incluses dans n= ne sont pas interprétées par les programmes et n’affectent pas le fonctionnement du DKIM.

- **Clé publique (base64) (p=)** : utilisée pour renseigner les données de clé publique DKIM, qui sont encodées en base64.<br />
  Ce tag est obligatoire dans la signature DKIM et permet aux destinataires de la signature de récupérer la clé publique nécessaire pour vérifier l’authenticité du message signé.

- **Révoquer la clé publique** : si une clé publique DKIM a été révoquée (par exemple en cas de compromission de la clé privée), une valeur vide doit être utilisée pour le tag "p=", indiquant que cette clé publique n’est plus valide. Les destinataires doivent alors retourner une erreur pour toute signature DKIM faisant référence à une clé révoquée.

- **Type de service (s=)**: La balise "s=" (Service Type) est optionnelle et n’est pas présente par défaut. Elle permet de spécifier le ou les types de services au(x)quel(s) cet enregistrement DKIM s’applique.<br />
  Les types de services sont définis en utilisant une liste de mots-clés séparés par des deux-points ":".<br />
  Le destinataire doit ignorer cet enregistrement si le type de service approprié n’est pas répertorié.<br />
  La balise "s=" est destinée à restreindre l’utilisation des clés pour d’autres fins, dans le cas où l’utilisation du DKIM serait définie pour d’autres services à l’avenir.<br />
  Les types de services actuellement définis sont "\*" (tous les types de services), "email" (courrier électronique).

- **Mode test (t=y)** : permet aux titulaires du nom de domaine de tester la mise en place du DKIM sans risquer de voir les messages rejetés ou marqués comme SPAM si la vérification de signature DKIM échoue.<br />
  Lorsque le flag "t=y" est utilisé, le destinataire ne doit pas traiter différemment les messages signés en mode de test et les messages non signés. Cependant, le destinataire peut suivre le résultat du mode de test pour aider les signataires.

- **Sous-domaines (t=s)** : permet de restreindre l’utilisation de la signature DKIM au nom de domaine uniquement (par exemple : @mydomain.ovh) ou de permettre l’envoi depuis le nom de domaine et ses sous-domaines (par exemple : @mydomain.ovh, @test.mydomain.ovh, @other.mydomain.ovh, etc.).

#### Enregistrement TXT [](#)
Il s’agit du type d’enregistrement natif utilisé pour paramétrer le DKIM dans la zone DNS de votre nom de domaine. Il est nécessaire de bien maitriser sa syntaxe pour le compléter.

Ce type de paramétrage DKIM est conseillé lorsque les informations à saisir vous ont été communiquées par le fournisseur du service e-mail.

Pour bien comprendre la composition de l’enregistrement DKIM, consultez la partie précédente de ce guide intitulée « [Enregistrement DKIM](#dkim-record) ».

**Exemple d’un enregistrement DKIM**

- sous-domaine :

```console
selector-name._domainkey.mydomain.ovh.
```

- cible :

```console
v=DKIM1;t=s;p= MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA77VDAIfyhjtoF0DIE5V7 rev1EKk4L0nxdBpD5O/jPrM4KP0kukeuB6IMpVplkkq52MSDeRcjoO50h0DmwZOr RUkyGjQwOnAh0VhY3fqkuwBYftEX7vWo8C2E1ylzimABkwPpSL62jZ1DheoXcil9 1M35wWBKtlYdXVedKjCQKOEnwTo+0hdNe38rU9NMgq6nbTIMjDntvxoVI+yF3kcx q/VpAY8BIYbcAXkVFvUyfUBABnnKpf0SfblsfcLW0Koy/FRxPDFOvnjNxXeOxMFR UI6K6PaW2WvtbJG2v+gHLY5M4tB0+/FNJU9emZfkPOk3DmRhZ8ENi7+oZa2ivUDj OQIDAQAB
```

#### Enregistrement CNAME [](#)
L’enregistrement CNAME est un alias. Cela signifie que la valeur cible renvoie vers une URL qui fournira elle-même l’enregistrement DKIM au serveur qui interrogera l’enregistrement CNAME. Ce type d’enregistrement CNAME pour paramétrer le DKIM est fréquent dans le cadre de l’utilisation d’un serveur e-mail Microsoft.

Il s’agit précisément du type d’enregistrement utilisé pour activer le DKIM sur un nom de domaine déclaré pour une offre Exchange OVHcloud. Ce procédé permet à votre fournisseur de solution e-mail de gérer pour vous la sécurité et la mise à jour du DKIM.

### Tester votre DKIM [](#)
Nous vous conseillons d’envoyer un e-mail depuis un compte de votre plateforme Exchange vers une adresse e-mail qui vérifie la signature DKIM lors de la réception.

Voici ce que vous pourrez trouver dans l’en-tête de l’e-mail reçu :

```
ARC-Authentication-Results: i=1; mx.example.com;
       dkim=pass header.i=@mydomain.ovh header.s=ovhex123456-selector1 header.b=KUdGjiMs;
       spf=pass (example.com: domain of test-dkim@mydomain.ovh designates 54.36.141.6 as permitted sender) smtp.mailfrom=test-dkim@mydomain.ovh
Return-Path: <test-dkim@mydomain.ovh>
```

Pour récupérer l’en-tête d’un e-mail, consulter notre guide « [Récupérer l’en-tête d’un e-mail](/fr/guides/web-cloud/email-and-collaborative-solutions/troubleshooting/diagnostic-headers.md) ».

### Cas d’usages [](#)
#### Comment et pourquoi changer la paire de clés DKIM sur mon offre ? [](#)
:::warning
Cette question concerne uniquement les offres Exchange et E-mail Pro.
:::

Lorsque vous activez pour la première fois le DKIM sur votre service e-mail, il est possible de créer 2 sélecteurs qui contiennent chacun une paire de clés. Le deuxième sélecteur sert de successeur à celui qui est en cours d’utilisation.

Pour éviter les tentatives de déchiffrement de la clé DKIM, il est conseillé de changer régulièrement de paire de clés. Pour cela, assurez-vous d’avoir bien configuré vos 2 sélecteurs en vérifiant que le premier est en status `inProduction`et le second en status `ready`. Vous pouvez vérifier cet état en vous référant à la section « [API - Les différents états du DKIM](#dkim-status) ».

Cliquez sur l’onglet ci-dessous correspondant à votre offre.


**Exchange**

Pour basculer sur le deuxième sélecteur, utilisez l’appel API suivant :

🇪🇺EU▾

[POST/email/exchange/{organizationName}/service/{exchangeService}/domain/{domainName}/dkim/{selectorName}/enable](https://eu.api.ovh.com/console/?section=/email/exchange&branch=v1#post-/email/exchange/-organizationName-/service/-exchangeService-/domain/-domainName-/dkim/-selectorName-/enable)

- `domainName` : saisissez le nom de domaine attaché à votre plateforme Exchange. <br />
- `exchangeService` : saisissez le nom de votre plateforme Exchange se présentant sous la forme « hosted-zz111111-1 » ou « private-zz111111-1 ». <br />
- `organizationName` : saisissez le nom de votre plateforme Exchange se présentant sous la forme « hosted-zz111111-1 » ou « private-zz111111-1 ». <br />
- `selectorName` : saisissez le nom du sélecteur sur lequel vous souhaitez basculer. <br />


**E-mail Pro**

Pour basculer sur le deuxième sélecteur, utilisez l’appel API suivant :

🇪🇺EU▾

[POST/email/pro/{service}/domain/{domainName}/dkim/{selectorName}/enable](https://eu.api.ovh.com/console/?section=/email/pro&branch=v1#post-/email/pro/-service-/domain/-domainName-/dkim/-selectorName-/enable)

- `domainName` : saisissez le nom de domaine attaché à votre plateforme E-mail Pro sur lequel le DKIM doit être présent.<br />
- `selectorName` : saisissez le nom du sélecteur sur lequel vous souhaitez basculer. <br />
- `service` : saisissez le nom de votre plateforme E-mail Pro se présentant sous la forme « emailpro-zz111111-1 ». <br />


Après avoir basculé sur le nouveau sélecteur, conservez l’ancien durant 7 jours avant de le supprimer et d’en créer un nouveau.

#### Pourquoi le DKIM n’est pas fonctionnel et apparait en rouge dans l’espace client ? [](#)
:::warning
Cette question concerne uniquement les offres Exchange et E-mail Pro.
:::

Vous constatez que vos e-mails ne sont pas signés par le DKIM, malgré son activation ou son paramétrage. Dans un premier temps, connectez-vous à votre espace client pour vérifier l’état du DKIM.

Cliquez sur l’onglet ci-dessous correspondant à votre offre, pour constater l’état du DKIM sur votre plateforme e-mail.


**Exchange**

1. Connectez-vous à votre <ManagerLink to="/">espace client OVHcloud</ManagerLink>.
2. Rendez-vous dans la partie <code className="action">Web Cloud</code>.
3. Dans la rubrique `MICROSOFT`, cliquez sur <code className="action">Exchange</code>.
4. Sélectionnez la plateforme concernée.
5. Enfin, allez dans l’onglet <code className="action">Domaines associés</code>.
Dans la rubrique <code className="action">Domaines associés</code>, vérifiez la couleur de l’icône `DKIM` à droite du nom de domaine concerné (voir l’image ci-dessous).
![email](/images/assets/screens/control-panel/product-selection/web-cloud/microsoft/exchange/associated-domains/red-dkim.png)

**E-mail Pro**

1. Connectez-vous à votre <ManagerLink to="/">espace client OVHcloud</ManagerLink>.
2. Rendez-vous dans la partie <code className="action">Web Cloud</code>.
3. Cliquez sur <code className="action">Email Pro</code>.
4. Sélectionnez la plateforme concernée.
5. Enfin, allez dans l’onglet <code className="action">Domaines associés</code>.
Dans la rubrique <code className="action">Domaines associés</code>, vérifiez la couleur de l’icône `DKIM` à droite du nom de domaine concerné (voir l’image ci-dessous).
![email](/images/assets/screens/control-panel/product-selection/web-cloud/microsoft/exchange/associated-domains/red-dkim.png)

Voici les 4 états ayant pour résultat l’icône DKIM en rouge dans votre espace client, Cliquez sur l’onglet correspondant à votre code erreur :


**501**

« **Only one dkim selector has been initialized** »<br /><br />
Seul un sélecteur DKIM est présent dans votre configuration. Pour nous permettre la bascule vers une nouvelle clé lorsque cela est nécessaire, il est demandé de configurer les 2 sélecteurs fournis par le service.<br /><br />
Pour corriger cette erreur :
- Vérifiez l’état des sélecteurs DKIM pour identifier celui qui doit être configuré. Pour cela, aidez-vous de la partie « [API - Les différents états du DKIM](#dkim-status) » de ce guide.
- Une fois que vous avez identifié le sélecteur à configurer, suivez les étapes de la partie « [API - Configuration complète du DKIM](#firststep) » sur ce guide, selon votre offre (Exchange ou E-mail Pro), en l’appliquant uniquement au sélecteur concerné.
  Patientez maximum 24 heures après configuration du sélecteur.


**502**

« **One DKIM configuration task is in error** »<br /><br />
Une erreur est survenue lors de la configuration du DKIM. Au-delà de 24 heures, si votre configuration est toujours dans cet état, nous vous invitons à ouvrir un [ticket auprès du support](https://help.ovhcloud.com/csm?id=csm_get_help).


**503**

« **CNAME record is wrong** »<br /><br />
La valeur de l’enregistrement CNAME nécessaire à la configuration du DKIM n’a pas été saisie correctement. Vous devez configurer correctement la zone DNS du nom de domaine attaché.
Pour configurer votre zone DNS, récupérez les valeurs de l’enregistrement CNAME qui s’affiche :
![email](/images/assets/screens/control-panel/product-selection/web-cloud/microsoft/exchange/associated-domains/dkim-503.png)Si on prend l’exemple de la capture ci-dessus, le nom de domaine est « **mydomain.ovh** » et il est demandé de configurer le sélecteur « **2** ». Ici, il faut ajouter un enregistrement CNAME ayant pour sous-domaine la valeur `ovhex1234567-selector2.domainkey.mydomain.ovh` et comme cible `ovhex1234567-selector2.domainkey.7890.dkim.mail.ovh.net`.<br /><br />
Une fois votre zone DNS configurée, patientez le temps de la propagation DNS (24h maximum)


**504**

« **One CNAME record is missing** »<br /><br />
La valeur de l’enregistrement CNAME nécessaire à la configuration du DKIM est manquante. Vous devez configurer la zone DNS du nom de domaine attaché.
Pour configurer votre zone DNS, récupérez les valeurs de l’enregistrement CNAME qui s’affiche :
![email](/images/assets/screens/control-panel/product-selection/web-cloud/microsoft/exchange/associated-domains/dkim-503.png)Si on prend l’exemple de la capture ci-dessus, le nom de domaine est « **mydomain.ovh** » et il est demandé de configurer le sélecteur « **2** ». Ici, il faut ajouter un enregistrement CNAME ayant pour sous-domaine la valeur `ovhex1234567-selector2.domainkey.mydomain.ovh` et comme cible `ovhex1234567-selector2.domainkey.890123.dkim.mail.ovh.net`.<br /><br />
Une fois votre zone DNS configurée, patientez le temps de la propagation DNS (24h maximum)


#### Depuis l’interface API OVHcloud, comment comprendre l’état du DKIM qui ne fonctionne pas ? [](#)
Si vous utilisez les API OVHcloud pour configurer votre DKIM et que celui-ci n’est pas fonctionnel aidez-vous de la rubrique « [API - Les différents états du DKIM](#dkim-status) » de ce guide pour identifier l’état de vos sélecteurs.

Retrouvez ci-dessous les états qui peuvent bloquer le fonctionnement de votre DKIM et la solution appropriée à chaque situation.


**Exchange et E-mail Pro**

- `WaitingRecord` : Les enregistrements DNS sont en attente de configuration ou en cours de validation dans la zone DNS du nom de domaine. Une vérification automatique régulière est faite pour constater si l’enregistrement DNS est présent et correctement renseigné. Selon vote offre, suivez **l’étape 5** dans la section « [API - Configuration complète du DKIM](#firststep) » pour configurer correctement la zone DNS du nom de domaine concerné.
- `ready` : Les enregistrements DNS sont présents dans la zone. Le DKIM peut maintenant être activé. Il vous suffira d’activer le sélecteur en vous appuyant sur la section « [API - Activer ou changer un sélecteur DKIM](#enable-switch) ».
- `deleting` : Le DKIM est en cours de suppression. Après suppression, il vous faudra suivre la section « [API - Configuration complète du DKIM](#firststep) ».
- `disabling` : Le DKIM est en cours de désactivation. Après cette opération, vous pourrez activer le sélecteur en vous appuyant sur la section « [API - Activer ou changer un sélecteur DKIM](#enable-switch) ».
- `todo` : La tâche a été initialisée, elle doit se lancer. Au-delà de 24 heures, si votre sélecteur est toujours dans cet état, nous vous invitons à ouvrir un [ticket auprès du support](https://help.ovhcloud.com/csm?id=csm_get_help) en précisant le numéro du sélecteur concerné.


**MX Plan et Zimbra**

- `disabled` : Le DKIM est désactivé, il n’a pas encore été configuré ou il a été désactivé par API. <br />
- `modifying` : La configuration du DKIM est en cours, il est nécessaire de patienter jusqu’à la fin du processus.<br />
- `toConfigure` : La configuration du DKIM est en attente des paramètres DNS du nom de domaine. Vous devez renseigner manuellement les enregistrements DNS dans la zone du nom de domaine. Pour cela; appuyez-vous sur l’étape « [Configuration complète du DKIM](#confemail) » de ce guide. <br />
- `error` : Le processus d’installation a rencontré une erreur. Nous vous invitons à ouvrir un [ticket auprès du support](https://help.ovhcloud.com/csm?id=csm_get_help) en précisant le nom de domaine concerné.
Au niveau des sélecteurs vous avez également 2 états relatifs à une erreur:
- `toSet` : Le sélecteur n’est pas configuré dans la zone DNS du nom de domaine. Appuyez-vous sur [l’étape 4 de « la configuration complète du DKIM » pour MX Plan et Zimbra](#confemail).
- `toFix` : Le sélecteur a bien été configuré dans la zone DNS du nom de domaine mais les valeurs sont incorrectes. Appuyez-vous sur [l’étape 4 de « la configuration complète du DKIM » pour MX Plan et Zimbra](#confemail).


## Aller plus loin

Échangez avec notre [communauté d’utilisateurs](https://community.ovhcloud.com/).
