GitHub
Configure o login com GitHub no Clowk: crie um GitHub OAuth App, defina a callback URL, informe o client ID e o secret e veja o JWT que seu app recebe.
Visão geral
O Clowk cuida do fluxo OAuth 2.0 do GitHub. Os usuários autorizam com a conta do GitHub e o Clowk retorna um JWT com os dados do perfil.
Configuração
1. Ative o GitHub no Clowk
Abra o dashboard do Clowk e ative o provedor GitHub na sua instância.
2. Crie um OAuth App no GitHub
- Acesse o GitHub Developer Settings
- Clique em New OAuth App
- Defina a URL de callback de autorização como:
https://clowk.in/oauth/github/callback - Copie o Client ID e o Client Secret para o dashboard do Clowk
3. Scopes
O Clowk pede estes scopes:
| Scope | Finalidade |
|---|---|
user:email | Ler os endereços de email do usuário |
read:user | Ler os dados do perfil do usuário |
Fluxo OAuth
1. Seu app → Clowk:
GET https://yourapp.clowk.in/sign-in?redirect_uri=https://yourapp.com/auth/callback
2. Clowk → GitHub:
GET https://github.com/login/oauth/authorize?
client_id=...&
scope=user:email+read:user&
state=...&
redirect_uri=https://clowk.in/oauth/github/callback
3. GitHub → Clowk:
GET https://clowk.in/oauth/github/callback?code=...&state=...
4. O Clowk troca o code por tokens e cria/encontra o usuário
5. Clowk → Seu app:
GET https://yourapp.com/auth/callback?token=eyJ...Payload do JWT
{
"iss": "clowk",
"sub": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"email": "[email protected]",
"name": "Jane Doe",
"avatar_url": "https://avatars.githubusercontent.com/u/...",
"provider": "github",
"instance_id": "inst_abc123",
"app_id": "app_xyz789",
"iat": 1711152000,
"exp": 1711155600
}Usuários do GitHub têm o email_verified_at preenchido automaticamente.
Configure o login com Twitter (X) no Clowk usando OAuth 2.0 com PKCE: portal de desenvolvedor, callback URL, scopes e o caso de usuários sem email.
Apple
O login com Apple no Clowk chega em breve. Veja o que a integração com Apple ID fará e quais providers (Google, GitHub, Twitter, email) já funcionam hoje.