Tchilo Developers

Documentação

Guia para integrares "Entrar com Tchilo" na tua app ou no teu site.

Antes de começar

  1. Entra na consola e cria uma app. Guarda o client_id e, se for confidencial, o segredo (só aparece uma vez).
  2. Regista os endereços de retorno (redirect_uri) exatos. Não há curingas, e em produção têm de ser https.
  3. Escolhe o tipo: pública (app móvel ou página sem servidor) ou confidencial (tem servidor e guarda o segredo).

Endereços

Autorizaçãohttps://edgngwoxhdxcvyzpqjbj.supabase.co/auth/v1/oauth/authorize
Tokenhttps://edgngwoxhdxcvyzpqjbj.supabase.co/auth/v1/oauth/token
Chaves públicas (JWKS)https://edgngwoxhdxcvyzpqjbj.supabase.co/auth/v1/.well-known/jwks.json
Descoberta OIDChttps://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

openidIdentificador do utilizador e ID token
emailE-mail da conta
profileNome e foto
phoneTelefone, 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.

Entrar com Tchilo

<a class="tchilo-btn" href="URL_DE_AUTORIZACAO">Entrar com Tchilo</a>

Segurança

Dúvidas? Escreve para suporte@tchilopop.com.