spf-dkim-dmarc-demo/README.md

55 lines
2.4 KiB
Markdown
Raw Normal View History

# Démonstrateur SPF, DKIM et DMARC
2023-10-25 15:50:32 +02:00
Ce démonstrateur est un support pédagogique pour apprendre à sécuriser ses courriels avec [SPF], [DKIM] et [DMARC]. Le but est dillustrer le fonctionnement de ces protocoles, de proposer un cas pratique de déploiement et montrer comment ils peuvent éventuellement être contournés.
Ce système est conçu pour pouvoir alterner entre trois points de vue:
* dune entreprise qui cherche à se protéger contre lusurpation didentité dans les courriels;
2023-10-25 15:50:32 +02:00
* dune «personne lambda» qui reçoit à la fois des courriels de cette entreprise mais aussi des tentatives de hameçonnage;
2023-10-25 15:50:32 +02:00
* dun attaquant, muni doutils pour envoyer des courriels frauduleux convaincants.
2023-10-25 15:50:32 +02:00
## Prise en main
Munissez-vous dune machine sous Linux dotée de Docker qui soit accessible en SSH.
Clonez le dépôt. Placez-vous dans le répertoire racine du dépôt, puis générez ensuite les conteneurs Docker avec la commande:
$ docker compose build
Démarrez ensuite le démonstrateur avec:
$ docker compose up
Suivez ensuite les [instructions détaillées].
Linfrastructure est conçue pour que toute modification qui y est apportée soit éphémère. Pour réinitialiser la plate-forme à létat dorigine, tapez les deux commandes suivantes:
$ docker compose down
$ docker compose up
## Architecture
Ce démonstrateur est composé de six conteneurs Docker:
* **frontend**: un simple proxy inversé donnant laccès à linterface Web du démonstrateur;
* **console**: contient linterface Web du démonstrateur proprement dite;
* **dns**: contient un résolveur DNS (unbound) et un serveur faisant autorité (nsd), dont les fichiers de zone peuvent être édités pour introduire SPF, DKIM et DMARC
* **sender**: le système mail de lentreprise, émetteur de mails authentiques;
* **attacker**: le système mail de lattaquant;
2023-10-25 15:50:32 +02:00
* **recipient**: le système mail destinataire des mails de lentreprise et de lattaquant;
2023-10-25 15:50:32 +02:00
Hormis le conteneur **frontend**, aucun de ces conteneurs na accès à Internet.
2023-10-25 15:50:32 +02:00
[DKIM]: https://www.rfc-editor.org/rfc/rfc6376.html
[DMARC]: https://www.rfc-editor.org/rfc/rfc7489
[instructions détaillées]: INSTRUCTIONS.md
2023-10-25 15:50:32 +02:00
[SPF]: https://www.rfc-editor.org/rfc/rfc7208