====== ejabberd and prosody XMPP server with synchronized credentials ======

[[https://www.ejabberd.im/|Ejabberd]] 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.

===== ejabberd Installation =====

  * Change it’s owner to whichever user is running the server, ie. ejabberd<code>
  $ chown ejabberd:ejabberd /path/to/friendica/bin/auth_ejabberd.php
</code>
  * Change the access mode so it is readable only to the user ejabberd and has exec<code>
  $ chmod 700 /path/to/friendica/bin/auth_ejabberd.php
</code>
  * Edit your ejabberd.cfg file, comment out your auth_method and add:<code>
  {auth_method, external}.
  {extauth_program, "/path/to/friendica/bin/auth_ejabberd.php"}.
</code>
  * Disable the module “mod_register” and disable the registration:<code>
  {access, register, [{deny, all}]}.
</code>
  * Enable BOSH:
    * Enable the module “mod_http_bind”
    * Edit this line:<code>
{5280, ejabberd_http,    [captcha, http_poll, http_bind]}
</code>
    * In your apache configuration for your site add this line:<code>
ProxyPass /http-bind http://127.0.0.1:5280/http-bind retry=0
</code>
  * 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)”

===== Prosody Installation =====

If you want to use your Friendica installation for authentication with the [[https://prosody.im/|prosody]] XMPP server, you have to do the following.

  - Enable the ''auth_http_async'' module of prosody
  - Adopt the configuration file (''prosody.cfg.lua'') of your prosody server to use Friendica for authentication (use your Friendica nodes domain instead of example.com)

<code>
authentication = "http_async";
http_auth_url = "https://example.com/api/account/verify_credentials.json";
</code>

You can now use your Friendica account credentials to login to your prosody, there is no need to register a new account on the XMPP server.