Skip to content

Commit e688344

Browse files
Update README.md
Signed-off-by: Sebastian <sebastian@wiuwiu.de>
1 parent 214ec5c commit e688344

1 file changed

Lines changed: 28 additions & 0 deletions

File tree

README.md

Lines changed: 28 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -215,6 +215,34 @@ Add the following to your `config.php`:
215215
**⚠⚠ Warning:** If you need to set *5 (Hashed Password in Database)* to false, your Prosody Instance is storing passwords in plaintext. This is insecure and not recommended. We highly recommend that you change your Prosody configuration to protect the passwords of your Prosody users. ⚠⚠
216216

217217

218+
HTTP
219+
----
220+
Authenticate Nextcloud users against a generic HTTP interface.
221+
A user and password need to be given for the Nextcloud login. If the configured HTTP interface responds with HTTP Status Code *202*, the user is authenticated successfully.
222+
223+
224+
### Configuration
225+
Add the following to your `config.php`:
226+
227+
'user_backends' => array (
228+
0 => array (
229+
'class' => 'OC_User_HTTP',
230+
'arguments' => array (
231+
0 => 'https://example.com/authenticate.php',
232+
1 => 'sha1',
233+
2 => 'GbTESTexHJyWYs3Yr9WiUwIuJgH7zsJSax',
234+
),
235+
),
236+
),
237+
238+
0 - Authentication Endpoint
239+
(Required) This is the URL to your authentication endpoint. You are fully responsible for doing proper authentication on your authentication endpoint's side. If the authentication was successful, your authentication endpoint must respond with HTTP status code *202*, any other HTTP status code will be detected as unauthenticated.
240+
1 - Hash Algorithm
241+
(Optional) By default, the user's password is sent in plaintext your authentication endpoint. If you set a hash algorithm, only the hashed password is sent to your authentication endpoint. Supportet algorithms: https://www.php.net/manual/en/function.hash-algos.php
242+
2 - Access Key
243+
(Optional) If you have secured your authentication endpoint you can define an access key. This key is sent to your authentication endpoint when Nextcloud tries to send requests to your authentication endpoint.
244+
245+
218246
Alternatives
219247
------------
220248
Other extensions allow connecting to external user databases directly via SQL, which may be faster:

0 commit comments

Comments
 (0)