From 71eb09546b4d31326bc049149e8f3bef930f0136 Mon Sep 17 00:00:00 2001 From: Lutz Freitag Date: Sun, 24 Feb 2019 18:27:08 -0500 Subject: [PATCH] added some README text to describe the basic auth feature Signed-off-by: Lutz Freitag --- README.md | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) diff --git a/README.md b/README.md index 377319d..5d2510f 100644 --- a/README.md +++ b/README.md @@ -133,6 +133,27 @@ Add the following to your `config.php`: ), +BasicAuth +------ + +Authenticate users by an [HTTP Basic access authentication][1] call. +HTTP server of your choice to authenticate. It should return HTTP 2xx for correct credentials and an appropriate other error code for wrong ones or refused access. + +### Configuration +The only supported parameter is the URL of the web server where the authentication happens. + +Add the following to your `config.php`: + + 'user_backends' => array( + array( + 'class' => '\OCA\User_External\BasicAuth', + 'arguments' => array('https://example.com/basic_auth'), + ), + ), + + +[1]: https://en.wikipedia.org/wiki/Basic_access_authentication + Alternatives ------------ Other extensions allow connecting to external user databases directly via SQL, which may be faster: