Conifer

Example authentication API using Python + Starlette + Sqlalchemy.

Dependencies

• Install Docker
• Install make

Quick Start

Build the project:

make build

Run the app:

make run

Get a shell:

make shell

Endpoints

Application is available at http://localhost:8000

Health Check

Request:

GET /health

Response: 200 OK

OK

Create an Account

Request:

POST /account

Request body:

{
    "email": "ollie@example.com",
    "password": "goldenretriever123"
}

Response: 201 CREATED
No content

Login

POST /login

Request body:

{
    "email": "ollie@example.com",
    "password": "goldenretriever123"
}

Response: 201 CREATED

{
    "session": "8b10a24e5cf54908acb5bfd288b56b0d",
    "expires_at": "2023-08-05T00:40:12.848103+00:00"
}

Resources

• Poetry - Python dependency management
• Starlette - Fast async Python web framework
• Sqlalchemy - Python database ORM
• OWASP Password Guidelines - Best practices for secure password storage