io.continual.iam.apiserver.authRoutes.conf Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of continualIamApiService Show documentation

An API server for the Continual IAM library

The newest version!

package io.continual.iam.apiserver.endpoints

###############################################################################
#
#	Login (really just retrieve an authentication token, since this is a
#	sessionless API server).
#
#	POST:
#		{ "username": "[email protected]", "password": "myPassword" }
#	RECV:
#		200 { "status": "ok", "token": "" }
#		401 Unauthorized
#
# 	Then use the token as a header in subsequent API calls with RFC-6750 /
#	RFC-7519 style presentation:
#
#		Authorization: Bearer 
#
POST	/auth/login			AuthApiHandler.login

#
#	Logout (invalidate the JWT token provided)
#
POST	/auth/logout		AuthApiHandler.logout

#
#	change password
#
#	For the currently authenticated user,
#
#	POST:
#		
#		{ "currentPassword": "myPassword", "newPassword": "myNewPassword" }
#
#	RECV:
#		200 { "status": "ok" }
#		400 { "status": "bad request", "reason": "..." }
#		401 - current password is incorrect (authenication step failed)
#
POST	/auth/password		AuthApiHandler.changePassword