aboutsummaryrefslogtreecommitdiff
path: root/content/operations/courantes
diff options
context:
space:
mode:
authorAlex Auvolat <alex@adnab.me>2022-12-22 17:56:58 +0100
committerAlex Auvolat <alex@adnab.me>2022-12-22 17:56:58 +0100
commitfe27af7a16d9bc56b0767f63d8f0490fcd2f13d1 (patch)
treeaa2545893bc1ca9f973cc45adcc0dcd2d68aef77 /content/operations/courantes
parent4831ac27871e44064dc55946c5ae10b8cda32b37 (diff)
downloadguide.deuxfleurs.fr-fe27af7a16d9bc56b0767f63d8f0490fcd2f13d1.tar.gz
guide.deuxfleurs.fr-fe27af7a16d9bc56b0767f63d8f0490fcd2f13d1.zip
Migration des derniers documents depuis op_guide (dépôt infrastructure)
Diffstat (limited to 'content/operations/courantes')
-rw-r--r--content/operations/courantes/_index.md6
-rw-r--r--content/operations/courantes/email.md31
-rw-r--r--content/operations/courantes/plume.md52
3 files changed, 89 insertions, 0 deletions
diff --git a/content/operations/courantes/_index.md b/content/operations/courantes/_index.md
new file mode 100644
index 0000000..1cf3b95
--- /dev/null
+++ b/content/operations/courantes/_index.md
@@ -0,0 +1,6 @@
++++
+title = "Opérations courantes"
+description = "Opérations courantes"
+weight = 15
+sort_by = "weight"
++++
diff --git a/content/operations/courantes/email.md b/content/operations/courantes/email.md
new file mode 100644
index 0000000..d28608e
--- /dev/null
+++ b/content/operations/courantes/email.md
@@ -0,0 +1,31 @@
++++
+title = "Emails"
+description = "Emails"
+weight = 10
++++
+
+# Support d'un nom de domaine personnalisé
+
+ 1. xxx
+ 1. Communiquez lui votre nom de domaine pour qu'il l'ajoute dans `ou=domains,ou=groups,dc=deuxfleurs,dc=fr`
+ 2. Communiquez lui l'adresse email que vous souhaitez pour qu'il change l'entrée `mail` dans votre profil utilisateur
+ 3. Si vous souhaitez avoir une boite mais plusieurs alias, demandez un champs `uid` dans votre profil utilisateur
+
+ 2. 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
+```bind
+@ MX 10 email-in.deuxfleurs.fr
+```
+ 2. L'entrée SPF pour autoriser notre IP à délivrer des emails en votre nom :
+```bind
+@ TXT "v=spf1 mx:out.deuxfleurs.fr -all"
+```
+ 3. L'entrée DKIM pour autoriser notre postfix+opendkim à délivrer des emails en votre nom :
+```
+smtp._domainkey TXT "v=DKIM1; h=sha256; k=rsa; p=MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAtdZp4qrgZR+6R7HeAkuLGJ/3L/6Ungvf5zwrMq6T8Tu931j2G4lYuPtsxyn9fZkT4y7DlX0waktLDBOCwf7X78nLEWjAFWiJTeWGRGhRdYRUFpscs9NUN0P+46jKlabibG3XTKd1DeAmywTu6o1oO03yiolrgKD1zgyDRFeUTfSwZIdPrdbcBSA1arda4WFtcBIrSygM9b4jtlqfQwGDrsMLbCBfVHDn4WfmDWyNg0gDAkuLrYClNETk6aqIyj9fC8srKri0Qp3cRagCn+fjBvuxP35qWWJH7Rnnh/tuEDr1ufuNYO2KgJZ7JdMidUotxXE8cfU+OrEWQf4mIYeJ4wIDAQAB"
+```
+ 4. L'entrée DMARC pour indiquer le comportement à adopter si les contraintes précédentes ne sont pas satisfaites :
+```
+_dmarc TXT "v=DMARC1; p=reject; sp=reject; adkim=s; aspf=s; rua=mailto:contact@deuxfleurs.fr!10m; ruf=mailto:contact@deuxfleurs.fr!10m; rf=afrf; pct=100; ri=86400"
+```
+ 3. C'est tout ! Vous devrez probablement attendre 24/48h que les changements se propagent.
diff --git a/content/operations/courantes/plume.md b/content/operations/courantes/plume.md
new file mode 100644
index 0000000..03e47c5
--- /dev/null
+++ b/content/operations/courantes/plume.md
@@ -0,0 +1,52 @@
++++
+title = "Plume"
+description = "Plume"
+date = 2022-12-22
+dateCreated = 2022-12-22
+weight = 11
++++
+
+## Creating a new Plume user
+
+ 1. Bind nomad on your machine with SSH (check the README file at the root of this repo)
+ 2. Go to http://127.0.0.1:4646
+ 3. Select `plume` -> click `exec` button (top right)
+ 4. Select `plume` on the left panel
+ 5. Press `enter` to get a bash shell
+ 6. Run:
+
+```bash
+plm users new \
+ --username alice \
+ --display-name Alice \
+ --bio Just an internet user \
+ --email alice@example.com \
+ --password s3cr3t
+```
+
+That's all folks, now you can use your new account at https://plume.deuxfleurs.fr
+
+## Bug and debug
+
+If you can't follow a new user and have this error:
+
+```
+2022-04-23T19:26:12.639285Z WARN plume::routes::errors: Db(DatabaseError(UniqueViolation, "duplicate key value violates unique constraint \"follows_unique_ap_url\""))
+```
+
+You might have an empty field in your database:
+
+```
+plume=> select * from follows where ap_url='';
+ id | follower_id | following_id | ap_url
+------+-------------+--------------+--------
+ 2118 | 20 | 238 |
+(1 row)
+```
+
+Simply set the `ap_url` as follows:
+
+```
+plume=> update follows set ap_url='https://plume.deuxfleurs.fr/follows/2118' where id=2118;
+UPDATE 1
+```