Equipe e plataformaGuia

Formas de entrar

Toda conta pode entrar com e-mail e senha. No waiso.dev você também pode Continuar com Google ou Continuar com GitHub, e empresas podem direcionar as pessoas para o próprio provedor de identidade (login único).

4 min de leituraAbrir no Waiso
O que você vai aprender
  • Criar uma conta ou entrar com GitHub
  • Conectar o GitHub a uma conta que você já tem
  • Oferecer a entrada com GitHub em uma instalação self-hosted

As portas de uma conta

A página de entrada sempre oferece seu e-mail e senha. Abaixo, quando este site os oferece, vêm Continuar com Google e Continuar com GitHub. Cada um leva à mesma conta depois de conectado, e cada um pede seu código de duas etapas em seguida se você ativou a verificação em duas etapas.

waisoEntrarouContinuar com GoogleContinuar com GitHub
A página de entrada: e-mail e senha primeiro, depois Google e GitHub.
  • Senha. Esqueceu? Esqueceu a senha? envia um link que funciona uma vez, por uma hora, e encerra suas sessões em todo lugar. Troque quando quiser em Configurações → Perfil.
  • Google e GitHub. Crie uma conta em um passo, ou conecte um deles à conta que você já tem.
  • Entrada da empresa. Se a sua empresa configurou o login único, digitar o e-mail do trabalho mostra Continuar com e o nome dela — veja o guia de login único.

Entrar com GitHub

Na página de entrada ou de cadastro clique em Continuar com GitHub e aprove. Um e-mail novo ganha uma conta nova. O waiso lê só quem você é e seu e-mail principal verificado — nunca age no GitHub por você.

O que o waiso lê do GitHub

Só o número da sua conta no GitHub, seu login, seu nome, sua foto e seu e-mail principal verificado. O waiso não lê seus repositórios, não guarda um token do GitHub e não pode agir no GitHub em seu nome. Mudar seu e-mail no GitHub depois não muda sua conta no waiso: a conexão é com a própria conta do GitHub, não com um endereço.

Conecte o GitHub à sua conta

  1. Abra Contas conectadas

    Configurações → Perfil, cartão Contas conectadas.

  2. Conecte

    Clique em Conectar na linha do GitHub e aprove no GitHub. A partir daí qualquer uma das portas leva à mesma conta.

Desconectar remove a conexão. Isso é recusado quando o GitHub é sua única forma de entrar — defina uma senha antes.

Em uma instalação self-hosted

A entrada com GitHub só aparece quando a instalação tem o próprio app OAuth do GitHub. Crie um no GitHub (Settings → Developer settings → OAuth Apps) com o callback https://<seu endereço>/api/users/auth/github/callback, depois adicione ao .env da instalação e reinicie:

Shell.env
GITHUB_CLIENT_ID=...
GITHUB_CLIENT_SECRET=...
  • Sem ALLOW_SIGNUP=true, o GitHub só deixa entrar quem o conectou — não cria contas.
  • Se o único administrador perdeu o celular e os códigos de recuperação, quem opera o servidor pode remover a verificação: docker compose exec api waiso-api --reset-2fa admin@example.com. De propósito, não existe página web para isso.