========================================
Configuration DNS pour Mail API
========================================

Pour que votre domaine puisse recevoir des emails, vous devez configurer les enregistrements DNS suivants.

1. ENREGISTREMENT MX (Mail Exchange)
------------------------------------
Ajoutez un enregistrement MX pour diriger les emails vers votre serveur :

Type: MX
Host: @
Value: votre-serveur.com
Priority: 10

Remplacez "votre-serveur.com" par le nom d'hôte de votre serveur où Postfix est installé.

Exemple :
Type: MX
Host: @
Value: mail.example.com
Priority: 10


2. ENREGISTREMENT A (Optionnel)
-------------------------------
Si vous utilisez un sous-domaine pour le mail (ex: mail.example.com) :

Type: A
Host: mail
Value: VOTRE_IP_PUBLIQUE

Remplacez VOTRE_IP_PUBLIQUE par l'adresse IP de votre serveur.


3. ENREGREMENT TXT - SPF (Sender Policy Framework)
--------------------------------------------------
Pour améliorer la délivrabilité des emails et éviter le spam :

Type: TXT
Host: @
Value: v=spf1 mx -all

Cela indique que seul votre serveur MX est autorisé à envoyer des emails pour votre domaine.


4. ENREGREMENT TXT - DKIM (Optionnel mais recommandé)
------------------------------------------------------
Pour signer vos emails et améliorer la délivrabilité :

Note: DKIM nécessite une configuration supplémentaire sur votre serveur Postfix.
Générez une clé DKIM et ajoutez l'enregistrement TXT correspondant.

Type: TXT
Host: mail._domainkey
Value: v=DKIM1; k=rsa; p=VOTRE_CLE_PUBLIQUE_DKIM


5. ENREGREMENT TXT - DMARC (Optionnel mais recommandé)
-------------------------------------------------------
Pour indiquer comment traiter les emails qui échouent les vérifications SPF/DKIM :

Type: TXT
Host: _dmarc
Value: v=DMARC1; p=none; rua=mailto:admin@example.com

Options :
- p=none : Mode surveillance (recommandé au début)
- p=quarantine : Mettre en quarantaine les emails suspects
- p=reject : Rejeter les emails suspects
- rua=mailto:... : Email pour recevoir les rapports DMARC


EXEMPLE COMPLET POUR example.com
---------------------------------

Enregistrements à ajouter dans votre panel DNS :

1. MX Record:
   Type: MX
   Host: @
   Value: mail.example.com
   Priority: 10

2. A Record (si mail.example.com):
   Type: A
   Host: mail
   Value: 123.456.789.012

3. SPF TXT Record:
   Type: TXT
   Host: @
   Value: v=spf1 mx -all

4. DMARC TXT Record:
   Type: TXT
   Host: _dmarc
   Value: v=DMARC1; p=none; rua=mailto:admin@example.com


VERIFICATION DE LA CONFIGURATION
---------------------------------

Après avoir ajouté les enregistrements DNS, attendez la propagation (peut prendre jusqu'à 48h).

Vous pouvez vérifier avec ces outils :

1. Vérification MX :
   dig MX votre-domaine.com

2. Vérification SPF :
   dig TXT votre-domaine.com

3. Outils en ligne :
   - https://mxtoolbox.com/
   - https://www.dmarcanalyzer.com/


NOTES IMPORTANTES
-----------------

- La propagation DNS peut prendre de quelques minutes à 48 heures
- Vérifiez que votre serveur Postfix est configuré et fonctionne
- Assurez-vous que le port 25 est ouvert sur votre serveur (firewall)
- Testez l'envoi d'email après la propagation DNS

Pour tester l'envoi :
telnet votre-domaine.com 25

ou

echo "Test email" | mail -s "Test" test@votre-domaine.com


sudo bash setup-postfix.sh votre-domaine.fr