Usuários e acesso

Funções

O acesso é baseado em funções:

Função	Escopo
Admin	Acesso total a tudo, incluindo configurações e gerenciamento de usuários
Operator	Por grupo: ver ao vivo/arquivo, exportar clipes e capturas de tela, controlar PTZ, ativar ou desativar a gravação, reconhecer eventos, gerenciar mapas e adicionar ou remover Viewers em seus grupos
Viewer	Por grupo: ver ao vivo/arquivo e navegar por eventos, clipes e capturas de tela das câmeras de seus grupos

Operator e Viewer são concedidos por grupo (consulte Grupos), de modo que você pode dar a um usuário acesso apenas às câmeras de que ele precisa. A interface oculta os controles para os quais o usuário não tem permissão, então os usuários nunca veem botões que não podem usar.

Gerenciar usuários

Em Settings → Users, um administrador pode convidar usuários, atribuir funções e ativar ou desativar contas. A primeira conta de administrador é criada automaticamente na instalação, com as credenciais que o instalador exibe.

Desativar um usuário ou alterar sua função encerra imediatamente todas as sessões desse usuário. Qualquer alteração na senha de um usuário — por ele mesmo ou por meio de um link de redefinição — tem o mesmo efeito.

Convidar um usuário e redefinir uma senha geram, ambos, um link de uso único para o administrador copiar e compartilhar diretamente com a pessoa — o Vision não envia credenciais por e-mail. O destinatário abre o link para definir a própria senha. Os links expiram após 7 dias, e desativar uma conta invalida seus links pendentes. O uso de um link é registrado no log de auditoria.

Seu perfil e senha

Qualquer usuário conectado pode alterar a própria senha no menu Profile (parte superior da barra lateral) — informe sua senha atual e uma nova (mínimo de 8 caracteres). Não é necessária a intervenção de um administrador. Alterar sua senha encerra suas outras sessões e invalida quaisquer links de redefinição pendentes da sua conta.

Recuperar uma senha esquecida

Perdeu o acesso à conta de administrador e não há outro administrador ativo para enviar um link de redefinição? Recupere-a a partir do host do servidor — um caminho de emergência que exige acesso ao shell da máquina, não uma sessão conectada.

O banco de dados e a configuração pertencem a root/vision, então execute-o com sudo:

sudo vision reset-password admin@localhost

Ele exibe um link de redefinição de uso único — nunca uma senha — e encerra imediatamente todas as sessões dessa conta:

Password reset link for admin@localhost:

  https://your-server/reset-password?token=…

Expires: 2026-07-28T12:00:00Z (7 days)
Existing sessions for this user were signed out.

Abra o link em um navegador para definir uma nova senha. Ele expira após 7 dias. A conta deve estar ativa — reative primeiro um usuário desativado. Nenhuma senha é digitada, gerada ou exibida, e a ação é registrada no log de auditoria.

Sessões

O login emite um token de acesso de curta duração (padrão de 15 minutos) que a interface renova silenciosamente em segundo plano. A sessão em si dura até o tempo de vida de renovação (refresh) (padrão de 7 dias) e é mantida em um cookie httpOnly; você só é enviado à página de login quando a sessão não puder mais ser renovada. Fazer logout invalida a sessão de forma durável — a reinicialização do servidor não a ressuscita. Os administradores podem ajustar os tempos de vida com auth.access_ttl e auth.refresh_ttl — consulte a referência de configuração.

Após 5 tentativas de login malsucedidas para um e-mail, esse e-mail fica bloqueado por 60 segundos; as outras contas não são afetadas. Recarregar a página nunca desconecta você — se muitos recarregamentos vierem de uma mesma rede ao mesmo tempo, a página espera alguns segundos em vez disso. Ajustável por meio de auth_rate_limit.* — consulte a referência de configuração.

Trilha de auditoria

Logins bem-sucedidos e com falha, logouts, alterações de senha, uso de links de redefinição, alterações de usuários e outras ações importantes são registrados no log de auditoria para prestação de contas — consulte Logs.