configuration des e-mails et migration depuis un autre fournisseur

6 files changed, 87 insertions, 56 deletions

diff --git a/content/operations/courantes.md b/content/operations/courantes.md
deleted file mode 100644
index d3da720..0000000
--- a/content/operations/courantes.md
+++ /dev/null
@@ -1,8 +0,0 @@
----
-title: "Opérations courantes"
-description: "Opérations courantes"
-weight: 35
-sort_by: "weight"
-extra:
-  parent: 'operations/_index.md'
----
diff --git a/content/operations/email.md b/content/operations/email.md
index d3b0fbe..190343e 100644
--- a/content/operations/email.md
+++ b/content/operations/email.md
@@ -1,53 +1,13 @@
 ---
-title: Emails
-description: Emails
+title: E-mails
+description: Comprendre le fonctionnement des e-mails
 weight: 10
 draft: false
 date: 2023-03-16
 extra:
-  parent: operations/courantes.md
+  parent: 'operations/_index.md'
 ---
 
-# Support d'un nom de domaine personnalisé
-
-Deuxfleurs peut héberger vos e-mails, même s'ils ne finissent pas en `@deuxfleurs.fr` ! Voilà comment faire.
-
-1. Communiquez lui votre nom de domaine pour qu'il l'ajoute dans `ou=domains,ou=groups,dc=deuxfleurs,dc=fr` et la [table de signature DKIM](https://git.deuxfleurs.fr/Deuxfleurs/nixcfg/src/branch/main/cluster/prod/app/email/config/dkim/signingtable)
-
-2. Communiquez lui l'adresse email que vous souhaitez pour qu'il change l'entrée `mail` dans votre profil utilisateur
-
-3. Vous devez ensuite rajouter les entrées pour votre nom de domaine en éditant votre zone :
-
-	1. L'entrée MX pour recevoir les emails
-
-	```
-	@  MX  10 smtp.deuxfleurs.fr.
-	```
-
-	2. L'entrée SPF pour autoriser notre IP à délivrer des emails en votre nom :
-
-	```
-	@  TXT  "v=spf1 include:deuxfleurs.fr -all"
-	```
-
-	3. L'entrée DKIM pour autoriser notre postfix+opendkim à délivrer des emails en votre nom :
-
-	```
-	smtp._domainkey CNAME smtp._domainkey.deuxfleurs.fr.
-	```
-
-	4. L'entrée DMARC pour indiquer le comportement à adopter si les contraintes précédentes ne sont pas satisfaites :
-
-	```
-	_dmarc CNAME _dmarc.deuxfleurs.fr.
-	```
-
-4. C'est tout ! Vous devrez probablement attendre 24/48h que les changements se propagent.
-
-
-
-# Comprendre le fonctionnement des e-mails
-
 ## Serveurs
 
 - SMTP: Postfix
@@ -229,4 +189,3 @@ mail, elle ne rentre pas dans le cadre défini par DMARC.
 206.118.187.37.in-addr.arpa. 86400 IN PTR shiki.adnab.me.
 ```
 
-
diff --git a/content/operations/email_personnalise.md b/content/operations/email_personnalise.md
new file mode 100644
index 0000000..5fd7b25
--- /dev/null
+++ b/content/operations/email_personnalise.md
@@ -0,0 +1,76 @@
+---
+title: Nom de domaine personnalisé
+description: Nom de domaine personnalisé (+ migration d'une boîte existante)
+
+weight: 10
+draft: false
+date: 2023-03-16
+extra:
+  parent: 'operations/email.md'
+---
+
+Deuxfleurs peut héberger vos e-mails, même s'ils ne finissent pas en `@deuxfleurs.fr` ! 
+
+Nous vous expliquons ici comment héberger une boîte mail avec un nom de domaine vous appartenant, en incluant la récupération (optionnelle) des e-mails existants chez votre ancien fournisseur vers les serveurs de Deuxfleurs.
+
+1. Si vous souhaitez rapatrier vos anciens e-mails de l'ancien fournisseur vers Deuxfleurs, sauvegardez vos e-mails sur votre machine :
+
+	> Nous présentons une méthode fiable ([cf. ce guide](https://github.com/joeyates/imap-backup/blob/main/docs/migrate-server-keep-address.md)), mais qui demande de bonnes connaissances en informatique. Vous pourriez avoir besoin de l'aide d'un⋅e administrateur⋅ice de Deuxfleurs.
+	>
+	> Si vous lui déléguez complètement l'opération, iel aura besoin de vos mots de passe chez votre ancien opérateur mail, chez Deuxfleurs, et manipulera votre sauvegarde d'e-mails. On vous recommande dans ce cas de changer vos mots de passe avant et après l'opération, et de vous armer de confiance.
+
+	* Faites de la place ! Chez votre fournisseur actuel, supprimez votre corbeille, vos vieux e-mails volumineux et inutiles, etc.
+
+	* Téléchargez l'outil [`imap-backup`](https://github.com/joeyates/imap-backup/).
+
+	* Utilisez `imap-backup setup` pour renseigner vos identifiants ainsi que le serveur IMAP de votre fournisseur mail actuel.
+
+	* Lancez `imap-backup backup --accounts=<votre_adresse_mail>`, ce qui va télécharger tous vos e-mails sur votre ordinateur (c'est long).
+	
+1. Communiquez votre nom de domaine à un⋅e administrateur⋅ice de Deuxfleurs pour qu'iel l'ajoute à :
+
+	* la liste des [domaines gérés par Deuxfleurs dans le LDAP](https://guichet.deuxfleurs.fr/admin/ldap/ou=domains,ou=groups,dc=deuxfleurs,dc=fr),
+	* et dans la [table de signature DKIM](https://git.deuxfleurs.fr/Deuxfleurs/nixcfg/src/branch/main/cluster/prod/app/email/config/dkim/signingtable).
+
+1. Communiquez-lui l'adresse e-mail que vous souhaitez utiliser. Vous pouvez ajouter autant d'alias que vous souhaitez, il seront reçus sur la même boîte mail. 
+
+	L'admin devra les ajouter ligne à ligne dans l'entrée `mail` dans votre profil utilisateur (en laissant votre adresse `@deuxfleurs.fr` en premier).
+
+1. Vous devez ensuite rajouter les entrées pour votre nom de domaine en éditant votre zone DNS (si vous n'y comprenez rien, faites-vous aider de l'admin) :
+
+	```
+	# L'entrée MX pour recevoir les e-mails
+	@  MX  10 smtp.deuxfleurs.fr.
+	# L'entrée SPF pour autoriser notre IP à délivrer des e-mails en votre nom 
+	@  TXT  "v=spf1 include:deuxfleurs.fr -all"
+	# L'entrée DKIM pour autoriser notre postfix+opendkim à délivrer des e-mails en votre nom
+	smtp._domainkey CNAME smtp._domainkey.deuxfleurs.fr.
+	# L'entrée DMARC pour indiquer le comportement à adopter si les contraintes précédentes ne sont pas satisfaites
+	_dmarc CNAME _dmarc.deuxfleurs.fr.
+	```
+
+1. À partir de ce point, vous pouvez envoyer et recevoir vos e-mails via notre infrastructure. [Suivez le Guide !](@/prise_en_main/email.md)
+
+	Il faudra par contre attendre 24/48h pour que les changements DNS se propagent dans le monde entier. Vous pourriez encore recevoir quelques e-mails chez votre ancien fournisseur dans l'intervalle. Passé ce délai, vérifiez dans l'interface e-mail de votre ancien fournisseur.
+
+1. Si vous avez sauvegardé vos e-mails sur votre machine, il est finalement temps de les envoyer sur les serveurs de Deuxfleurs (toujours avec l'aide optionnelle de l'admin, si vous êtes bloqué⋅e) :
+
+	* Assurez-vous d'avoir terminé la sauvegarde en étape 1.
+
+	* Trouvez sur votre machine le dossier contenant la configuration d'`imap-backup` et votre sauvegarde d'e-mails (`~/.imap-backup/` sur Linux). 
+
+	* Modifiez manuellement le fichier de configuration d'`imap-backup` et le nom du dossier de votre sauvegarde comme expliqué dans [le guide sus-cité](https://github.com/joeyates/imap-backup/blob/main/docs/migrate-server-keep-address.md). Imaginons que votre adresse mail est `moi@chezmoi.fr` :
+
+		* Remplacez à la ligne `username` votre e-mail par `moi-avant@chezmoi.fr` dans le fichier de configuration `config.json` d'`imap-backup`.
+		* Dans le même fichier, à la ligne `local_path`, remplacez le nom du dossier `moi_chezmoi.fr` par `moi-avant_chezmoi.fr`.
+		* Renommez le dossier `moi_chezmoi.fr` en `moi-avant_chezmoi.fr` dans le dossier d'`imap-backup`.
+
+	* Utilisez `imap-backup setup` pour renseigner vos identifiants Deuxfleurs (toujours le même e-mail, et votre mot de passe chez nous), ainsi que le serveur IMAP de Deuxfleurs (`imap.deuxfleurs.fr`).
+
+	* C'est le grand moment de la migration. Toujours en imaginant que votre adresse mail est `moi@chezmoi.fr`, lancez la commande suivante : 
+
+		```imap-backup migrate moi-avant@chezmoi.fr moi@chezmoi.fr --destination-delimiter "."```
+
+		La commande devrait produire peu de lignes, et vous devriez voir (par exemple sur [sogo.deuxfleurs.fr](https://sogo.deuxfleurs.fr)) vos anciens e-mails apparaître. Si ce n'est pas le cas, appelez à l'aide.
+
+		Une fois cette longue commande terminée, c'est terminé. Bienvenu⋅e chez nous :)
diff --git a/content/prise_en_main/_index.md b/content/prise_en_main/_index.md
index 901f641..a98f92c 100644
--- a/content/prise_en_main/_index.md
+++ b/content/prise_en_main/_index.md
@@ -35,7 +35,7 @@ Vous pouvez activer ou désactiver votre webcam ou votre microphone, inviter jus
 
 Pour prévenir tout le monde, envoyer un email
 
-[↣ Apprendre à utiliser les emails](@/prise_en_main/emails.md)
+[↣ Apprendre à utiliser les emails](@/prise_en_main/email.md)
 
 Pour planifier la réunion, utiliser l'outil "Formulaire" de Cryptpad.
 Marche aussi pour faire des votes.
diff --git a/content/prise_en_main/emails.md b/content/prise_en_main/email.md
index acdddb4..4793f15 100644
--- a/content/prise_en_main/emails.md
+++ b/content/prise_en_main/email.md
@@ -1,6 +1,6 @@
 ---
-title: "Emails"
-description: "Emails"
+title: "E-mails"
+description: "E-mails"
 weight: 20
 extra:
   parent: 'prise_en_main/_index.md'
@@ -34,5 +34,5 @@ La configuration peut changer à tout moment, certaines fonctionnalités peuvent
 # Utiliser un nom de domaine personnalisé (autre que @deuxfleurs.fr)
 
 La configuration d'un nom de domaine personnalisé (eg. @michu.fr) ne peut pas se faire directement depuis une interface.
-Veuillez sollicitez un·e opérateur·ice afin de vous accompagner dans la configuration.
+Veuillez sollicitez un·e opérateur·ice afin de vous accompagner dans la configuration. Plus d'informations sur [cette page du Guide](@/operations/email_personnalise.md).
 
diff --git a/sass/_markdown.scss b/sass/_markdown.scss
index 0d51c5c..99f14b2 100644
--- a/sass/_markdown.scss
+++ b/sass/_markdown.scss
@@ -32,6 +32,10 @@
 .content a {
   color: var(--primary-link-color);
 
+  code { 
+    color: var(--primary-link-color);
+  }
+
   &:hover {
     text-decoration: underline;
   }