OpenID Connect
Descoberta OpenID Connect do Clowk em /.well-known/openid-configuration, com o fluxo OAuth authorization code, scopes dos providers e tokens HS256.
GET /.well-known/openid-configuration
O Clowk expõe um endpoint básico de descoberta OpenID Connect. Assim, ferramentas compatíveis com OIDC descobrem os endpoints de autenticação do Clowk automaticamente.
Requisição
curl https://myapp.clowk.dev/.well-known/openid-configurationNão é preciso autenticação.
Resposta
{
"issuer": "https://myapp.clowk.dev",
"authorization_endpoint": "https://myapp.clowk.dev/oauth/authorize",
"token_endpoint": "https://myapp.clowk.dev/api/v1/tokens/verify",
"userinfo_endpoint": "https://myapp.clowk.dev/api/v1/users",
"response_types_supported": ["code"],
"subject_types_supported": ["public"],
"id_token_signing_alg_values_supported": ["HS256"]
}| Campo | Descrição |
|---|---|
issuer | A URL base do Clowk |
authorization_endpoint | Onde o fluxo OAuth começa |
token_endpoint | Onde verificar tokens |
userinfo_endpoint | Onde buscar dados do usuário |
response_types_supported | Só o fluxo authorization code é suportado |
id_token_signing_alg_values_supported | Os tokens são assinados com HS256 |
Fluxo OAuth
O Clowk usa o fluxo authorization code:
- Redirecione o usuário para
/oauth/authorizecom umprovidere umredirect_uri - O Clowk cuida da troca OAuth com o provedor (Google, GitHub, Twitter)
- Em caso de sucesso, o Clowk redireciona de volta para o seu
redirect_uricom o parâmetro de querytoken - Verifique o token com
POST /api/v1/tokens/verifyou decodifique-o localmente com a sua secret key
GET /oauth/authorize?provider=google&redirect_uri=https://app.example.com/auth/callbackProvedores suportados
| Provedor | Scopes |
|---|---|
openid, email, profile | |
| GitHub | user:email, read:user |
tweet.read, users.read, offline.access |
Parâmetro state
Cada requisição OAuth gera um valor state único para evitar ataques CSRF. O state expira em 10 minutos. Os fluxos do Twitter também usam PKCE (code challenge e verifier).
Operadores de pesquisa
Referência da linguagem de busca do Clowk usada na API de busca de usuários e sessões: correspondência exata, wildcards, negação, OR e comparação de datas.
Como funciona
Como funciona a autenticação do Clowk, do redirect ao JWT assinado: modelo broker, providers OAuth, credenciais próprias, entrega e verificação do token.