BaseAuth

BaseAuth is a simple auth server, which is not meant to be usable in production environments.

---

API

The API uses HTTP and runs by default on port 8080. All requests to endpoints are POST. The Content-Type is always application/json, all payloads are JSON strings.

endpoints

/register

Registers a new account.

Content / Payload

Field	Description
username	The username of the account
password	The accounts' clear text password

Responses

Response	Description
200	User created successfully
400	Formal error in the request
403	Rejected for security reasons (sql injection protection)
409	The requested username is already in use
500	Internal server error

/authenticate

Authenticates using an existing account.

Content / Payload

Field	Description
username	The username of the account
password	The accounts' clear text password

Responses

Response	Description
200	Authenticated successfully
400	Formal error in the request
401	Authentication failure (wrong password)
403	Rejected for security reasons (sql injection production)
404	There was no account found with the specified name
500	Internal server error

---

CLI

Arguments

Argument	Description
-D / --daemon <port>	Starts the server in daemon mode, to await api requests on the specified port, etc.
-d / --delete <user,user>	Deletes the account(s) associated with the specified username(s).
-l / --list	Lists all registered accounts
-w / --dir <path>	Specifies the working dir that will be used. This dir contains stuff like the database.