From cbae0874d6b40a7e636e923244495ec9b1391271 Mon Sep 17 00:00:00 2001 From: Michael Vogel Date: Thu, 19 Nov 2015 23:56:56 +0100 Subject: [PATCH] Documentation for installing a synchronized ejabberd --- doc/Home.md | 1 + doc/de/Home.md | 1 + doc/install-ejabberd.md | 33 +++++++++++++++++++++++++++++++++ doc/readme.md | 1 + 4 files changed, 36 insertions(+) create mode 100644 doc/install-ejabberd.md diff --git a/doc/Home.md b/doc/Home.md index d1194a2b6..e797f2129 100644 --- a/doc/Home.md +++ b/doc/Home.md @@ -30,6 +30,7 @@ Friendica Documentation and Resources * [Install](help/Install) * [Settings](help/Settings) * [Installing Connectors (Twitter/GNU Social)](help/Installing-Connectors) +* [Install an ejabberd with synchronized credentials](help/install-ejabberd.md) * [Message Flow](help/Message-Flow) * [Using SSL with Friendica](help/SSL) * [Twitter/GNU Social API Functions](help/api) diff --git a/doc/de/Home.md b/doc/de/Home.md index 17e4b7dc2..758b8ef7a 100644 --- a/doc/de/Home.md +++ b/doc/de/Home.md @@ -32,6 +32,7 @@ Friendica - Dokumentation und Ressourcen * [Konfigurationen](help/Settings) * [Plugins](help/Plugins) * [Konnektoren (Connectors) installieren (Twitter/GNU Social)](help/Installing-Connectors) +* [Installation eines ejabberd Servers mit synchronisierten Anmeldedaten](help/install-ejabberd.md) (EN) * [Nachrichtenfluss](help/Message-Flow) * [Betreibe deine Seite mit einem SSL-Zertifikat](help/SSL) * [Entwickler](help/Developers) diff --git a/doc/install-ejabberd.md b/doc/install-ejabberd.md new file mode 100644 index 000000000..a5b9469ab --- /dev/null +++ b/doc/install-ejabberd.md @@ -0,0 +1,33 @@ +Install an ejabberd with synchronized credentials +================================================= + +* [Home](help) + +Installation +------------ + +- Change it's owner to whichever user is running the server, ie. ejabberd + + $ chown ejabberd:ejabberd /path/to/friendica/include/auth_ejabberd.php + +- Change the access mode so it is readable only to the user ejabberd and has exec + + $ chmod 700 /path/to/friendica/include/auth_ejabberd.php + +- Edit your ejabberd.cfg file, comment out your auth_method and add: + + {auth_method, external}. + {extauth_program, "/path/to/friendica/include/auth_ejabberd.php"}. + +- Disable the module "mod_register" and disable the registration: + + {access, register, [{deny, all}]}. + +- Restart your ejabberd service, you should be able to login with your friendica credentials + +Other hints +----------- +- if a user has a space or a @ in the nickname, the user has to replace these characters: + - " " (space) is replaced with "%20" + - "@" is replaced with "(a)" + diff --git a/doc/readme.md b/doc/readme.md index a5eeb5451..27603612f 100644 --- a/doc/readme.md +++ b/doc/readme.md @@ -30,6 +30,7 @@ Friendica Documentation and Resources * [Settings](help/Settings) * [Plugins](help/Plugins) * [Installing Connectors (Twitter/GNU Social)](help/Installing-Connectors) +* [Install an ejabberd with synchronized credentials](help/install-ejabberd.md) * [Message Flow](help/Message-Flow) * [Using SSL with Friendica](help/SSL) * [Developers](help/Developers)