Pular para o conteúdo

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.

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 /signup e 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.

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.

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.

  • 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.

Opcional, por OpenID Connect (Google Workspace, Microsoft Entra ID, Keycloak, Authentik…), em /admin › Avançado:

  1. No provedor, cadastre um aplicativo “web” com o endereço de retorno mostrado no painel.
  2. Preencha o emissor (issuer), o Client ID, o Client secret e os domínios de e-mail permitidos.
  3. 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.