From 643a9bd1633778268a57c9de57eed3ed7600081b Mon Sep 17 00:00:00 2001 From: Marcel Waldvogel Date: Sat, 14 Jul 2018 16:50:00 +0200 Subject: [PATCH] Made socket interface more prominent --- doc/Installation.md | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-) diff --git a/doc/Installation.md b/doc/Installation.md index cd4e2b5..07b92d1 100644 --- a/doc/Installation.md +++ b/doc/Installation.md @@ -61,7 +61,7 @@ This cache interferes with multiple valid passwords (app passwords, tokens) and thus needs to be deactivated with `auth_use_cache: false`. ### Prosody -Install *lua-lpty* (not necessary when using the new (experimental) *socket mode*): +Install *lua-lpty* (not necessary when using the [*socket mode*](#socket-interface): ``` apt install lua-lpty ``` @@ -79,6 +79,9 @@ All parameters must therefore be set in the configuration file. This fixes a bug with treating an echo of the request as the answer ([xmpp-cloud-auth#21](https://github.com/jsxc/xmpp-cloud-auth/issues/21), [Prosody#855](https://prosody.im/issues/issue/855)). +Even then, several users report problems with `lua-lpty`, [such as +processes not dying and still occupying sockets](https://github.com/jsxc/xmpp-cloud-auth/issues/63). Please look at the [socket mode](#socket-interface) for an alternative. + ## Options ``` $ ./xcauth.py --help @@ -172,7 +175,7 @@ If Conversations cannot connect and complains about "Downgrade attack", see the [No (obvious?) way to accept SASL downgrade (Conversations#2498)](https://github.com/siacs/Conversations/issues/2498). Current workaround: Delete the account in Conversations and then add it again. -### Experimental socket interface +### Socket interface If you see unreliable behavior with *Prosody*, you might want to try the experimental socket interface. When using the `mod_auth_external.lua` bundled here (together with `pseudolpty.lua`), you can use