User Authentication

Routes

Resource	Operation	Description
User	GET /ivoryos/auth/login	Login user
	POST /ivoryos/auth/login
	GET /ivoryos/auth/signup	Signup for a new account
	POST /ivoryos/auth/signup
	GET /ivoryos/auth/change-password	Change password
	POST /ivoryos/auth/change-password
	GET /ivoryos/auth/logout	Logout the user

Docs

GET /ivoryos/auth/login

Login

GET /auth/login: Load the user login form.

POST /auth/login

Form Parameters:

username – username
password – password

Status Codes:

302 Found – and then redirects to homepage
401 Unauthorized – incorrect password, redirects to GET /ivoryos/auth/login

POST /ivoryos/auth/login

Login

GET /auth/login: Load the user login form.

POST /auth/login

Form Parameters:

username – username
password – password

Status Codes:

302 Found – and then redirects to homepage
401 Unauthorized – incorrect password, redirects to GET /ivoryos/auth/login

GET /ivoryos/auth/signup

Signup

GET /auth/signup: Load the user signup form.

POST /auth/signup

Form Parameters:

username – username
password – password

Status Codes:

302 Found – and then redirects to GET /ivoryos/auth/login
409 Conflict – when user already exists, redirects to GET /ivoryos/auth/signup

POST /ivoryos/auth/signup

Signup

GET /auth/signup: Load the user signup form.

POST /auth/signup

Form Parameters:

username – username
password – password

Status Codes:

302 Found – and then redirects to GET /ivoryos/auth/login
409 Conflict – when user already exists, redirects to GET /ivoryos/auth/signup

GET /ivoryos/auth/change-password

Change Password

GET /auth/change-password: Load the password change form.

POST /auth/change-password: Update the current user’s password.

Form Parameters:

old_password – The user’s current password.
new_password – The new password to set.

Status Codes:

302 Found – Redirects to the homepage on success.

POST /ivoryos/auth/change-password

Change Password

GET /auth/change-password: Load the password change form.

POST /auth/change-password: Update the current user’s password.

Form Parameters:

old_password – The user’s current password.
new_password – The new password to set.

Status Codes:

302 Found – Redirects to the homepage on success.

GET /ivoryos/auth/logout

Logout

GET /auth/logout

Terminate the current user session and redirect to the login page.

Status Codes:

302 Found – Redirects to the login page.