add notes about pre_auth tokens to dev docs
Signed-off-by: Robin Appelman <robin@icewind.nl>
This commit is contained in:
Родитель
f202e0436f
Коммит
430c5813c7
|
@ -29,7 +29,7 @@ Desktop and other clients that don't run in the Nextcloud web interface can use
|
|||
to `https://cloud.example.com/ocs/v2.php/cloud/capabilities`
|
||||
- Open a websocket connection to the provided websocket url
|
||||
- Send the username over the websocket connection
|
||||
- Send the password over the websocket connection
|
||||
- Send the password over the websocket connection (see also [pre-authenticated tokens])
|
||||
- If the credentials are correct, the server will return with "authenticated"
|
||||
- The server will send the following notifications
|
||||
- "notify_file" when a file for the user has been changed
|
||||
|
@ -77,6 +77,17 @@ discover_endpoint(nextcloud_url, username, password).then((endpoint) => {
|
|||
|
||||
```
|
||||
|
||||
## Pre-authenticated tokens
|
||||
|
||||
In situations where you don't have the user credentials but you can send authenticated requests to nextcloud(such as when you have authenticated cookies)
|
||||
you can use "pre-authenticated tokens" instead of the username and password.
|
||||
|
||||
- Get the `pre_auth` endpoint from the ocs capabilities request
|
||||
- Send an authenticated request to the endpoint, a token will be returned.
|
||||
- Open the websocket as normal
|
||||
- Send an empty string as username over the websocket
|
||||
- Send the token from the `pre_auth` request as passwor
|
||||
|
||||
## Sending custom events
|
||||
|
||||
You can send custom events from a nextcloud app using the methods provided by `OCA\NotifyPush\IQueue`.
|
||||
|
|
Загрузка…
Ссылка в новой задаче