aicp-auth-python

aicp-auth-python

Biblioteca de autenticação e autorização para Keycloak - Python

Instalação

Instalação Básica

pip install aicp-auth-python

Isso instala apenas as dependências básicas. Para usar com Flask ou FastAPI, instale as dependências extras:

Com Flask

pip install aicp-auth-python[flask]

Com FastAPI

pip install aicp-auth-python[fastapi]

Uso

Importação Básica

# Funciona sempre, mesmo sem Flask/FastAPI
from aicp_auth import KeycloakClient, AuthConfig, User

Flask

# Certifique-se de ter instalado: pip install aicp-auth-python[flask]
from aicp_auth import flask_auth_middleware, AuthConfig

config = AuthConfig(
    url="https://keycloak.example.com",
    realm="my-realm",
    client_id="my-client"
)

@app.route('/api/protected')
@flask_auth_middleware(config)
def protected_route():
    return {'user': g.user.__dict__}

FastAPI

# Certifique-se de ter instalado: pip install aicp-auth-python[fastapi]
from aicp_auth import fastapi_auth_middleware, AuthConfig, User

config = AuthConfig(
    url="https://keycloak.example.com",
    realm="my-realm",
    client_id="my-client"
)

get_current_user = fastapi_auth_middleware(config)

@app.get('/api/protected')
def protected_route(user: User = Depends(get_current_user)):
    return {'user': user.__dict__}

Documentação Completa

Veja a documentação principal para mais detalhes.