doc: added some rough documentation.
This commit is contained in:
parent
25ad5ca62c
commit
115f5a5c31
1 changed files with 78 additions and 0 deletions
78
README.md
Normal file
78
README.md
Normal file
|
@ -0,0 +1,78 @@
|
|||
# Skynet LDAP backend
|
||||
|
||||
Basic information on the Skynet ldap backend for use on <https://sso.skynet.ie>
|
||||
|
||||
|
||||
### Error: HTTP 500
|
||||
No indication of the issue is returned to teh frontend.
|
||||
|
||||
## Routes
|
||||
Base URL: <https://api.sso.skynet.ie>
|
||||
|
||||
|
||||
### POST /ldap/update
|
||||
Fields:
|
||||
* userPassword
|
||||
* mail
|
||||
* sshPublicKey
|
||||
* cn
|
||||
* sn
|
||||
* skDiscord
|
||||
|
||||
```json
|
||||
{
|
||||
"user" : "username",
|
||||
"pass" : "password",
|
||||
"field": "field to change",
|
||||
"value": "new value of field"
|
||||
}
|
||||
```
|
||||
|
||||
Changing ``userPassword`` requires the existing password in teh apssword field and the new one in teh value field.
|
||||
|
||||
### POST /ldap/new
|
||||
|
||||
```json
|
||||
{
|
||||
"user" : "username the user wants",
|
||||
"mail" : "An email account that matches what is on wolves",
|
||||
"name_first": "Firstname",
|
||||
"name_second": "Surname"
|
||||
}
|
||||
```
|
||||
|
||||
Username taken:
|
||||
```json
|
||||
{"result": "error", "error": "username not available"}
|
||||
```
|
||||
|
||||
Email used:
|
||||
```json
|
||||
{"result": "error", "error": "email in use"}
|
||||
```
|
||||
|
||||
### POST /ldap/new/verify
|
||||
|
||||
```json
|
||||
{
|
||||
"auth_code": "Auth code that got send in the email",
|
||||
"password": "Password the user wants to use"
|
||||
}
|
||||
```
|
||||
|
||||
Auth code non existent:
|
||||
```json
|
||||
{"result": "error"}
|
||||
```
|
||||
|
||||
|
||||
## Responses
|
||||
|
||||
Generic responses which is used unless otherwise specified above.
|
||||
|
||||
### Success: HTTP 200
|
||||
```json
|
||||
{
|
||||
"result": "success"
|
||||
}
|
||||
```
|
Loading…
Reference in a new issue