gmunguia / auth-service

πŸ‘¨β€πŸ« example auth service

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Authentication service

A simple authentication service.

Why?

Educational purposes.

API

Sign up

Create a new user.

Example

How to sign up a user with username johndoe:

POST /users/johndoe HTTP/1.1
[...]

{
  "firstName": "John",
  "password": "correcthorsebatterystaple"
}

Log in

Exchange client credentials for a session token.

Example

How to sign in using johndoe's credentials:

POST /users/johndoe/sessions HTTP/1.1
[...]

{
  "password": "correcthorsebatterystaple"
}

Log out

Invalidate a session token.

Example

How to invalidate session with id 12tndiu2t3hudicau.

DELETE /sessions/12tndiu2t3hudicau HTTP/1.1
[...]
Authorization: 12tndiu2t3hudicau

Read current user attributes

Retrieve current user attributes.

Example

How to retrieve attributes of currently logged in user. 12tndiu2t3hudicau is a valid session token obtained through log in.

GET /user HTTP/1.1
[...]
Authorization: 12tndiu2t3hudicau

About

πŸ‘¨β€πŸ« example auth service


Languages

Language:JavaScript 100.0%