Documentação
Guia para integrares "Entrar com Tchilo" na tua app ou no teu site.
Antes de começar
- Entra na consola e cria uma app. Guarda o
client_ide, se for confidencial, o segredo (só aparece uma vez). - Regista os endereços de retorno (
redirect_uri) exatos. Não há curingas, e em produção têm de serhttps. - Escolhe o tipo: pública (app móvel ou página sem servidor) ou confidencial (tem servidor e guarda o segredo).
Endereços
| Autorização | https://edgngwoxhdxcvyzpqjbj.supabase.co/auth/v1/oauth/authorize |
| Token | https://edgngwoxhdxcvyzpqjbj.supabase.co/auth/v1/oauth/token |
| Chaves públicas (JWKS) | https://edgngwoxhdxcvyzpqjbj.supabase.co/auth/v1/.well-known/jwks.json |
| Descoberta OIDC | https://edgngwoxhdxcvyzpqjbj.supabase.co/auth/v1/.well-known/openid-configuration |
Passo 1: pedir autorização
O fluxo é o código de autorização com PKCE, que é obrigatório. Gera um code_verifier aleatório, calcula o code_challenge (SHA-256) e envia o utilizador para:
https://edgngwoxhdxcvyzpqjbj.supabase.co/auth/v1/oauth/authorize
?response_type=code
&client_id=O_TEU_CLIENT_ID
&redirect_uri=https%3A%2F%2Fa-tua-app.com%2Fcallback
&scope=openid%20email%20profile
&state=VALOR_ALEATORIO
&code_challenge=CHALLENGE
&code_challenge_method=S256
Exemplo de PKCE no navegador:
const b64=b=>btoa(String.fromCharCode(...new Uint8Array(b))).replace(/\+/g,'-').replace(/\//g,'_').replace(/=+$/,'');
const verifier=b64(crypto.getRandomValues(new Uint8Array(32)));
const challenge=b64(await crypto.subtle.digest('SHA-256',new TextEncoder().encode(verifier)));
sessionStorage.setItem('pkce',verifier);
Guarda também o state e confirma-o quando o utilizador voltar à tua app.
Passo 2: trocar o código por tokens
O utilizador volta ao teu redirect_uri com ?code=...&state=.... Troca o código no endpoint de token.
curl -X POST 'https://edgngwoxhdxcvyzpqjbj.supabase.co/auth/v1/oauth/token' \
-u 'CLIENT_ID:CLIENT_SECRET' \
-d grant_type=authorization_code \
-d code=CODIGO \
-d redirect_uri=https://a-tua-app.com/callback \
-d code_verifier=VERIFIER
Apps públicas não têm segredo: em vez de -u, envia -d client_id=O_TEU_CLIENT_ID. Apps confidenciais também podem enviar client_id e client_secret no corpo, se a tua biblioteca o exigir.
Passo 3: ler o utilizador
Com o scope openid, a resposta inclui um ID token. O token de acesso é um JWT com user_id, role e client_id. Valida sempre a assinatura com as chaves públicas do endereço JWKS. Para renovar a sessão, usa grant_type=refresh_token no mesmo endpoint de token.
Scopes
| openid | Identificador do utilizador e ID token |
| E-mail da conta | |
| profile | Nome e foto |
| phone | Telefone, se existir |
O botão "Entrar com Tchilo"
Usa o texto "Entrar com Tchilo" e o logótipo de três círculos, sem setas.
<a class="tchilo-btn" href="URL_DE_AUTORIZACAO">Entrar com Tchilo</a>
Segurança
- Nunca coloques o segredo da app no código do navegador ou da app móvel.
- Usa sempre
statee PKCE, e valida os tokens. - Pede só os scopes de que precisas.
- O utilizador pode retirar o acesso à tua app. Quando isso acontecer, apaga os dados que já não precisas.
Dúvidas? Escreve para suporte@tchilopop.com.