# Comment configurer mes DNS

🚨 Attention, cette configuration n'est à réaliser que lorsque vous souhaitez finaliser la migration de vos mails. Une fois cette configuration mise en place, il faudra attention ~24h pour qu'elle soit propagée sur le réseau.

#### Suppression des enregistrements qui dirigent vers votre ancien hébergeur

Chez Gandi:

<div id="bkmrk-%40-10800-in-mx-10-spo"><div>- @ 10800 IN MX 10 spool.mail.gandi.net.
- @ 10800 IN MX 50 fb.mail.gandi.net.
- @ 10800 IN TXT "v=spf1 include:\_mailcust.gandi.net ?all"
- et quelques autres dont la valeur contient "mail" et "gandi"... 
    - \_imap.\_tcp
    - \_imaps.\_tcp
    - \_pop3.\_tcp
    - \_pop3s.\_tcp
    - \_submission.\_tcp
    - gm1.\_domainkey
    - gm2.\_domainkey
    - gm3.\_domainkey
    - webmail

</div></div>[![image.png](https://docs.girofle.cloud/uploads/images/gallery/2023-11/scaled-1680-/KUwimage.png)](https://docs.girofle.cloud/uploads/images/gallery/2023-11/KUwimage.png)

<div id="bkmrk--5"></div>#### Ajout des enregistrements qui dirigent vers Girofle  


Voici la configuration à remplir (attention les points en fin de ligne sont importants et à conserver).

<table border="1" id="bkmrk-domaine-type-ttl-cib" style="border-collapse: collapse; width: 100%; height: 258.317px;"><colgroup><col style="width: 17.5507%;"></col><col style="width: 11.0001%;"></col><col style="width: 8.40457%;"></col><col style="width: 31.5172%;"></col><col style="width: 31.5172%;"></col></colgroup><tbody><tr style="height: 29.8px;"><td style="height: 29.8px;">**Nom ou Domaine**  
</td><td style="height: 29.8px;">**Type**  
</td><td style="height: 29.8px;">**TTL**  
</td><td style="height: 29.8px;">**Priorité / Poids / Port** </td><td style="height: 29.8px;">**Cible ou Nom d’hôte**  
</td></tr><tr style="height: 32.9167px;"><td style="height: 32.9167px;">ne rien mettre ici</td><td style="height: 32.9167px;">MX</td><td style="height: 32.9167px;">3600</td><td style="height: 32.9167px;">10  
</td><td style="height: 32.9167px;">mail.girofle.org.</td></tr><tr style="height: 29.8px;"><td style="height: 29.8px;">autodiscover</td><td style="height: 29.8px;">CNAME</td><td style="height: 29.8px;">3600  
</td><td style="height: 29.8px;">  
</td><td style="height: 29.8px;">mail.girofle.org.</td></tr><tr style="height: 29.8px;"><td style="height: 29.8px;">\_autodiscover.\_tcp</td><td style="height: 29.8px;">SRV</td><td style="height: 29.8px;">3600  
</td><td style="height: 29.8px;">0 / 0 / 443</td><td style="height: 29.8px;">mail.girofle.org.</td></tr><tr style="height: 29.8px;"><td style="height: 29.8px;">autoconfig</td><td style="height: 29.8px;">CNAME</td><td style="height: 29.8px;">3600</td><td style="height: 29.8px;">  
</td><td style="height: 29.8px;">mail.girofle.org.</td></tr><tr style="height: 46.6px;"><td style="height: 46.6px;">ne rien mettre ici  
</td><td style="height: 46.6px;">TXT  
</td><td style="height: 46.6px;">3600  
</td><td style="height: 46.6px;">  
</td><td style="height: 46.6px;">v=spf1 include:\_spf.girofle.org ~all</td></tr><tr style="height: 29.8px;"><td style="height: 29.8px;">\_dmarc</td><td style="height: 29.8px;">CNAME</td><td style="height: 29.8px;">3600  
</td><td style="height: 29.8px;">  
</td><td style="height: 29.8px;">dmarc2023.girofle.org.</td></tr><tr style="height: 29.8px;"><td style="height: 29.8px;">dkim.\_domainkey</td><td style="height: 29.8px;">TXT  
</td><td style="height: 29.8px;">3600  
</td><td style="height: 29.8px;">  
</td><td style="height: 29.8px;">\[a trouver dans MailCow, voir ci-dessous 🤓\]  
</td></tr><tr><td>mail  
</td><td>CNAME  
</td><td>3600  
</td><td>  
</td><td>mail.girofle.org.  
</td></tr></tbody></table>

MailCow, dans l'onglet Domaines, **donne l'état des DNS** : données attendues et données actuelles. Cela permet de voir l'avancée de la propagation sur le réseau.

- Attention pour l'enregistrement **\_dmarc**, MailCow demande un TXT mais c'est bien le CNAME si-dessus qu'il faut mettre, il pointe vers le TXT attendu.
- MailCow donne la valeur attendue pour l'enregistrement **dkim.\_domainkey** (le contenu du champ DKIM dépend de votre domaine).

### Comment avoir la détection du calendrier et des contacts ?  




Il faut rajouter les entrées DNS suivantes (attention les points en fin de ligne sont importants et à conserver):

<table border="1" id="bkmrk-domaine-type-ttl-pri" style="border-collapse: collapse; width: 100%; height: 89.1501px;"><colgroup><col style="width: 17.5496%;"></col><col style="width: 10.9994%;"></col><col style="width: 8.40405%;"></col><col style="width: 15.8194%;"></col><col style="width: 7.9097%;"></col><col style="width: 7.9097%;"></col><col style="width: 31.5152%;"></col></colgroup><tbody><tr style="height: 29.7167px;"><td style="height: 29.7167px;">**Nom ou Domaine**  
</td><td style="height: 29.7167px;">**Type**  
</td><td style="height: 29.7167px;">**TTL**  
</td><td style="height: 29.7167px;">**Priorité** </td><td style="height: 29.7167px;">**Poids** </td><td style="height: 29.7167px;">**Port** </td><td style="height: 29.7167px;">**Cible ou nom d’hôte**  
</td></tr><tr style="height: 29.7167px;"><td style="height: 29.7167px;">**\_carddavs.\_tcp** </td><td style="height: 29.7167px;">**SRV**</td><td style="height: 29.7167px;">**3600**</td><td style="height: 29.7167px;">**10** </td><td style="height: 29.7167px;">**1** </td><td style="height: 29.7167px;">**443** </td><td style="height: 29.7167px;">**mail.girofle.org.**</td></tr><tr style="height: 29.7167px;"><td style="height: 29.7167px;">**\_caldavs.\_tcp** </td><td style="height: 29.7167px;">**SRV**</td><td style="height: 29.7167px;">**3600**</td><td style="height: 29.7167px;">**10** </td><td style="height: 29.7167px;">**1** </td><td style="height: 29.7167px;">**443** </td><td style="height: 29.7167px;">**mail.girofle.org.**</td></tr></tbody></table>

Ou depuis le mode "expert":

```
_carddavs._tcp IN SRV 10 1 443 mail.girofle.org.
_caldavs._tcp IN SRV 10 1 443 mail.girofle.org.
```

### Validation

On peut ensuite vérifier que la configuration est bonne du point de vue de Mailcow.

Toutes les cases de la colonne "Etat courant" doivent avoir le symbole "valide" ✔, sauf la case relative au DMARC. Le champ TXT SPF Record Syntax peut parfois ne pas avoir de coche verte et commencer par un ?, ce n'est pas un problème, il faut bien s'assurer que le champ \_spf.girofle.org soit présent dans la valeur du champ.

Attention, la propagation des configurations DNS peut prendre plusieurs heures.

[![image.png](https://docs.girofle.cloud/uploads/images/gallery/2023-12/scaled-1680-/G3Himage.png)](https://docs.girofle.cloud/uploads/images/gallery/2023-12/G3Himage.png)

### Que dois-je configurer si j'utilise d'autres outils d'envoi de mail ?

Il est possible d'utiliser des outils d'envoi de mails, tout en hébergeant son domaine chez le Cloud Girofle. Cela est par exemple le cas si vous souhaitez utilisez des outils/plateformes de mailing-list tel que Mailjet, Brevo (ex SendingBlue), Mailchimp, etc...

Dans ce cas, vous allez devoir fusionner les configurations DNS du Cloud Girofle, avec les configurations DNS indiquées par votre autre fournisseur de mail.

<p class="callout warning">**Attention**  
- si vous faites pas ces modifications et que vous envoyez des mails depuis un autre fournisseur que le Cloud Girofle, il est fortement probable que les mails envoyés via cet autre fournisseur finissent classés en Spam/Pourriels.  
- il est possible de faire des bêtise lors de la configuration de vos DNS et de bloquer l'envoi et la réception de vos mails, attention donc à ce que vous faites.  
</p>

<p class="callout info">En cas de doute n'hésitez surtout pas à nous demander de l'aide sur la configuration de vos DNS.</p>

Prenons par exemple le domaine quelquechose.fr, configuré avec le Cloud Girofle pour les mail. Si vous voulez envoyer des mails depuis un autre service de mail que le Cloud Girofle, vous avez deux choix :

- Utiliser un sous domaine. Ex : liste.quelquechose.fr
- Configurer vos DNS pour indiquer que vos mails peuvent partir depuis les serveurs du Cloud Girofle, OU depuis un autre service.

Dans le cas ou vous utilisez un sous domaine, il vous suffit de suivre les configurations indiquez par votre autre fournisseur de service mail.

Dans le cas ou vous souhaitez envoyer tous vos mails depuis votre domaine principal (ex: quelquechose.fr), nous allons devoir modifier votre configuration DNS comme suit.

Nous allons devoir configurer 2 champs : le champ du `SPF` (qui est de type TXT), et le champ `DKIM` (qui est aussi de type TXT). Certaines documentations indiquent de configurer le champ DMARC, mais ce n'est pas nécessaire pour nous car nous pouvoir continuer à utiliser la configuration DMARC existante (celle indiquée ci-dessus).

##### Le champ SPF

Si vous avez suivi la configuration indiquée ci-dessus, votre champ dit `SPF` devrait avoir la valeur suivante

```
v=spf1 include:_spf.girofle.org ~all
```

Dans le cas ou vous souhaitez également envoyer des mails depuis un autre fournisseur, il faudra modifier cette valeur, pour y faire apparaître la configuration demandée par ce fournisseur. Généralement cela consiste à ajouter une balise `include`.

Voici un exemple pour un service fictif "moninfolettre.fr" :

```
v=spf1 include:_spf.girofle.org include:spf.moninfolettre.fr ~all
```

Voici quelques exemples pour certains fournisseurs connus :

<table border="1" id="bkmrk-fournisseur-valeur-d" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 14.7532%;"></col><col style="width: 85.3704%;"></col></colgroup><tbody><tr><td>**Fournisseur**  
</td><td>**Valeur du champ TXT**  
</td></tr><tr><td>Brevo  
</td><td>`v=spf1 include:_spf.girofle.org include=spf.brevo.com ~all`</td></tr><tr><td>Mailchimp  
</td><td>`v=spf1 include:_spf.girofle.org include:mandrillapp.com ~all`</td></tr><tr><td>Mailjet</td><td>`v=spf1 include:_spf.girofle.org include:include:spf.mailjet.com ~all`</td></tr></tbody></table>

**Documentation**

- [https://help.brevo.com/hc/fr/articles/4414335084434-Fusionner-des-enregistrements-SPF](https://help.brevo.com/hc/fr/articles/4414335084434-Fusionner-des-enregistrements-SPF)
- [https://mailchimp.com/fr/resources/what-is-sender-policy-framework/](https://mailchimp.com/fr/resources/what-is-sender-policy-framework/)
- [https://www.mailjet.com/fr/blog/delivrabilite/protocoles-spf-dkim-dmarc/https://documentation.mailjet.com/hc/fr/articles/360049641733-Guide-complet-d-authentification-des-domaines-avec-SPF-et-DKIM](https://www.mailjet.com/fr/blog/delivrabilite/protocoles-spf-dkim-dmarc/)

##### Les champs DKIM

Le mécanisme DKIM utilise une *clé de domaine* (ou *domain-key*). Chez le Cloud Girofle, nous utilisons une clef qui se nomme "dkim" (ça porte un peut à confusion). Pour d'autres, la clef se nomme parfois "mail".

Il est possible d'avoir plusieurs **valeurs** de clé DKIM, en utilisant différents **noms** de clef.  
Le nom de clef se défini dans la partie "source" (parfois nommée "hote") du champ DKIM, et préfixé par le texte `_domainkey`.

Voici par exemple les différentes nom de clef pour des fournisseurs connu :

<table border="1" id="bkmrk-fournisseur-nom-de-l" style="border-collapse: collapse; width: 100%; height: 119.2px;"><colgroup><col style="width: 19.1976%;"></col><col style="width: 80.926%;"></col></colgroup><tbody><tr style="height: 29.8px;"><td style="height: 29.8px;">**Fournisseur**  
</td><td style="height: 29.8px;">**Nom de la clef**  
</td></tr><tr style="height: 29.8px;"><td style="height: 29.8px;">Cloud Girofle  
</td><td style="height: 29.8px;">`dkim._domainkey.quelquechose.fr`</td></tr><tr style="height: 29.8px;"><td style="height: 29.8px;">Mailjet  
</td><td style="height: 29.8px;">`mailjet._domainkey.quelquechose.fr`</td></tr><tr style="height: 29.8px;"><td style="height: 29.8px;">Brevo  
</td><td style="height: 29.8px;">`brevo1._domainkey.quelquechose.fr` et `brevo2._domainkey.quelquechose.fr`  
</td></tr></tbody></table>

Pour faire fonctionner vos autres fournisseurs de mails, il vous faudra créer de nouveaux champs DKIM (généralement un ou deux), en utilisant les valeurs de clefs indiquées par votre fournisseur.

<p class="callout warning">Ne modifiez pas le champ DKIM du Cloud Girofle (`dkim._domainkey`) ou vos mails risquent de finir dans les Spams.</p>