Contas e usuários
| Quem | Tem conta? | O que faz |
|---|---|---|
| Administrador | Sim (uma) | Configura o servidor em /admin, cria salas, gere as contas |
| Transmissor | Sim | Cria salas e transmite, mesmo sem o admin presente; não mexe nas configurações |
| Espectador | Não | Entra pelo link da sala, só com um nome |
No mínimo 12 caracteres, sem conter o usuário e fora das ~30 mil senhas vazadas mais comuns. Uma frase longa é mais fácil de lembrar e mais segura. As sessões duram até 12 horas, ou 2 horas sem uso.
Transmissores
Seção intitulada “Transmissores”O modo de cadastro fica em /admin › Geral:
- Só por convite: o admin gera um convite em
/admin› Convidar transmissor e manda o link. A pessoa escolhe o próprio usuário e senha; o admin nunca vê a senha. O link vale uma vez, por 48 horas. Nesse modo, a página inicial não mostra o formulário de login: diz que o servidor é particular e aponta o site do Overshoulder. Quem tem conta entra por/login. - Com aprovação (padrão): qualquer um pede uma conta em
/signup; a conta fica pendente até o admin aprovar em/admin› Transmissores. Há limite de pedidos por IP e um teto de contas esperando. - Livre: qualquer um cria conta em
/signupe já transmite. Use só em servidores para um grupo que você confia.
Em /admin › Transmissores:
- Revogar: desativa a conta e encerra na hora as sessões e as salas ao vivo dela.
- Reativar: devolve o acesso a uma conta revogada.
- Excluir: apaga a conta.
Verificação em duas etapas (2FA)
Seção intitulada “Verificação em duas etapas (2FA)”Cada pessoa ativa em /account (na página inicial, Configurações › Minha conta), com um app autenticador (Google Authenticator, Aegis, 1Password…). Ao ativar, recebe 10 códigos de recuperação, que valem uma vez cada. O admin pode exigir 2FA de todos em /admin › Geral.
Recuperar o acesso
Seção intitulada “Recuperar o acesso”O admin perdeu a senha ou o 2FA
Seção intitulada “O admin perdeu a senha ou o 2FA”Não existe “esqueci a senha” na página de login do admin, de propósito: só quem tem acesso ao servidor pode recuperar essa conta. O comando reset-admin mostra um link de uso único, válido por 15 minutos. Abra o link no navegador e escolha uma senha nova. O 2FA do admin é removido e todas as sessões abertas dele são encerradas. Rode o comando de novo se o link vencer.
Como rodar o comando depende de como o Overshoulder foi instalado:
| Instalação | Comando |
|---|---|
| Instalador de um comando | overshoulder reset-admin |
docker run ou Docker Compose (container overshoulder) |
docker exec overshoulder overshoulder reset-admin |
| Coolify, Dokploy, EasyPanel e similares | No painel, abra o Terminal do serviço (no Coolify, a aba Terminal do recurso, escolhendo o container overshoulder) e rode overshoulder reset-admin |
| Qualquer uma, pelo terminal do servidor | docker exec $(docker ps -qf name=overshoulder) overshoulder reset-admin |
Nas plataformas como o Coolify, o container não se chama só overshoulder (o nome ganha um sufixo), por isso a última linha procura o container pelo nome. Se aparecer mais de um, use docker ps para ver os nomes e escolha o certo.
O comando fala inglês, a não ser que o sistema esteja em português. Para escolher, acrescente -e OVERSHOULDER_LANG=pt (ou en) logo depois de docker exec. No instalador, use OVERSHOULDER_LANG=pt overshoulder reset-admin.
Se o servidor ainda não foi configurado, não há admin para recuperar: veja o código da primeira configuração.
Transmissores e a própria senha
Seção intitulada “Transmissores e a própria senha”- Transmissor perdeu o celular do 2FA: ele entra com um código de recuperação. Sem códigos, o admin, em
/admin› Transmissores, remove o 2FA da conta ou gera códigos novos (e entrega por um canal seguro). - Transmissor esqueceu a senha: em
/admin› Transmissores, clique em Link de nova senha e mande o link à pessoa por um canal seguro. Ele vale uma vez, por 24 horas; gerar outro invalida o anterior. A pessoa escolhe a senha nova em/new-password, as sessões abertas dela são encerradas e o 2FA continua como estava (se ela perdeu também o celular, use Remover 2FA). Não vale para contas revogadas, pendentes ou do login da empresa. - Trocar a própria senha: em
/account.
Login da empresa (SSO)
Seção intitulada “Login da empresa (SSO)”Opcional, por OpenID Connect (Google Workspace, Microsoft Entra ID, Keycloak, Authentik…), em /admin › Avançado:
- No provedor, cadastre um aplicativo “web” com o endereço de retorno mostrado no painel.
- Preencha o emissor (issuer), o Client ID, o Client secret e os domínios de e-mail permitidos.
- Defina quem transmite: um grupo (se o provedor enviar a lista de grupos) ou uma lista de e-mails. Essas pessoas viram transmissor no primeiro login.
Cada sala pode exigir o login da empresa para assistir, e aí o nome no chat é o nome real. O admin torna isso padrão ou obrigatório. O administrador sempre entra com usuário e senha, para não ficar trancado fora se o provedor cair.
O SSO foi testado com um provedor simulado; teste com o seu provedor antes de depender dele.