Quickstart

Get started with GL IAM in minutes. Choose a quickstart based on your identity provider.

Not sure which provider to use? See Choosing a Provider for a detailed comparison.

Choose Your Quickstart

Target

Quickstart: PostgreSQL

Target

Quickstart: Stack Auth

Target

Quickstart: Keycloak

Quick Comparison

Provider	Setup Time	Best For
PostgreSQL	~2 min	Prototypes, internal tools, full data control
Stack Auth	~5 min	SaaS apps, managed auth, social login
Keycloak	~5 min	Enterprise SSO, SAML, user federation

What You'll Learn

1

Setup

Install GL IAM and configure the provider.

2

Authentication

Validate tokens and get user info.

3

Authorization

Protect endpoints with role-based access.

4

Complete Example

A working FastAPI application.

Provider-Agnostic Code

All quickstarts use the same application code - only the provider configuration differs:

app.py

# Same code works with any provider
from fastapi import Depends
from gl_iam import User
from gl_iam.fastapi import get_current_user, require_org_admin

@app.get("/me")
async def get_me(user: User = Depends(get_current_user)):
    return {"email": user.email, "roles": user.roles}

@app.get("/admin")
async def admin_only(
    user: User = Depends(get_current_user),
    _: None = Depends(require_org_admin()),
):
    return {"message": f"Welcome, Admin {user.display_name}!"}

Learn more about this pattern in Provider-Agnostic Code.