From cbae0874d6b40a7e636e923244495ec9b1391271 Mon Sep 17 00:00:00 2001 From: Michael Vogel Date: Thu, 19 Nov 2015 23:56:56 +0100 Subject: [PATCH 1/4] 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 d1194a2b6e..e797f2129d 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 17e4b7dc29..758b8ef7a7 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 0000000000..a5b9469ab2 --- /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 a5eeb54511..27603612f3 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) From 5eb6f9add91bbac4afe9c487a2ed11a2f04d7647 Mon Sep 17 00:00:00 2001 From: Michael Vogel Date: Fri, 20 Nov 2015 00:20:32 +0100 Subject: [PATCH 2/4] Documentation: Configure bosh --- doc/Home.md | 2 +- doc/de/Home.md | 2 +- doc/install-ejabberd.md | 10 ++++++++++ doc/readme.md | 2 +- 4 files changed, 13 insertions(+), 3 deletions(-) diff --git a/doc/Home.md b/doc/Home.md index e797f2129d..955b179054 100644 --- a/doc/Home.md +++ b/doc/Home.md @@ -30,7 +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) +* [Install an ejabberd with synchronized credentials](help/install-ejabberd) * [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 758b8ef7a7..4f39cf3eed 100644 --- a/doc/de/Home.md +++ b/doc/de/Home.md @@ -32,7 +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) +* [Installation eines ejabberd Servers mit synchronisierten Anmeldedaten](help/install-ejabberd) (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 index a5b9469ab2..73636c1d84 100644 --- a/doc/install-ejabberd.md +++ b/doc/install-ejabberd.md @@ -23,6 +23,16 @@ Installation {access, register, [{deny, all}]}. +- Enable BOSH: + - Enable the module "mod_http_bind" + - Edit this line: + + {5280, ejabberd_http, [captcha, http_poll, http_bind]} + + - In your apache configuration for your site add this line: + + ProxyPass /http-bind http://127.0.0.1:5280/http-bind retry=0 + - Restart your ejabberd service, you should be able to login with your friendica credentials Other hints diff --git a/doc/readme.md b/doc/readme.md index 27603612f3..579e7b373a 100644 --- a/doc/readme.md +++ b/doc/readme.md @@ -30,7 +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) +* [Install an ejabberd with synchronized credentials](help/install-ejabberd) * [Message Flow](help/Message-Flow) * [Using SSL with Friendica](help/SSL) * [Developers](help/Developers) From b1ad63cbce362fe322c960833f035f2e187ba28f Mon Sep 17 00:00:00 2001 From: Michael Vogel Date: Sat, 21 Nov 2015 00:09:39 +0100 Subject: [PATCH 3/4] Added some more explanations about ejabberd --- doc/Home.md | 2 +- doc/install-ejabberd.md | 4 +++- doc/readme.md | 2 +- 3 files changed, 5 insertions(+), 3 deletions(-) diff --git a/doc/Home.md b/doc/Home.md index 955b179054..cd8752c1ef 100644 --- a/doc/Home.md +++ b/doc/Home.md @@ -30,7 +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) +* [Install an ejabberd server (XMPP chat) with synchronized credentials](help/install-ejabberd) * [Message Flow](help/Message-Flow) * [Using SSL with Friendica](help/SSL) * [Twitter/GNU Social API Functions](help/api) diff --git a/doc/install-ejabberd.md b/doc/install-ejabberd.md index 73636c1d84..c99a845500 100644 --- a/doc/install-ejabberd.md +++ b/doc/install-ejabberd.md @@ -3,6 +3,9 @@ Install an ejabberd with synchronized credentials * [Home](help) +[Ejabberd](https://www.ejabberd.im/) is a chat server that uses XMPP as messaging protocol that you can use with a large amount of clients. In conjunction +with the "xmpp" addon it can be used for a web based chat solution for your users. + Installation ------------ @@ -40,4 +43,3 @@ 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 579e7b373a..068d0c9c5c 100644 --- a/doc/readme.md +++ b/doc/readme.md @@ -30,7 +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) +* [Install an ejabberd server (XMPP chat) with synchronized credentials](help/install-ejabberd) * [Message Flow](help/Message-Flow) * [Using SSL with Friendica](help/SSL) * [Developers](help/Developers) From 63ec2bb9aad481cfa8f9dbe32c94c4d15356e50b Mon Sep 17 00:00:00 2001 From: Michael Vogel Date: Sat, 21 Nov 2015 00:11:29 +0100 Subject: [PATCH 4/4] Added the german explanation --- doc/de/Home.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/de/Home.md b/doc/de/Home.md index 4f39cf3eed..2a9ea091ed 100644 --- a/doc/de/Home.md +++ b/doc/de/Home.md @@ -32,7 +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) (EN) +* [Installation eines ejabberd Servers (XMPP-Chat) mit synchronisierten Anmeldedaten](help/install-ejabberd) (EN) * [Nachrichtenfluss](help/Message-Flow) * [Betreibe deine Seite mit einem SSL-Zertifikat](help/SSL) * [Entwickler](help/Developers)