# Usuários

URL: /administrar/usuarios

Veja as contas, edite papéis, envie redefinição de senha, desative usuários e consulte a auditoria.

**Quem faz:** administrador.

Em **Configurações do Mira → Administração do Mira → Usuários**, a lista mostra nome e email juntos, o papel (**Administrador** ou **Usuário**) e o status. Ativos aparecem primeiro, e a busca filtra por nome ou email.

## Como uma conta nasce [#como-uma-conta-nasce]

O administrador não cria contas nem define senhas. Cada pessoa entra por um [convite a um projeto](/administrar/projetos#convidar-para-o-projeto): quem ainda não tem conta cria a sua pelo link do convite, com nome e senha ou com o Google. A conta nova tem o papel **Usuário** na instância. Para dar a uma pessoa o papel **Administrador**, abra **Editar** na linha dela.

O boot da instância cria o primeiro administrador a partir de `MIRA_ADMIN_EMAIL` e `MIRA_ADMIN_PASSWORD`.

## Editar, redefinir senha e desativar [#editar-redefinir-senha-e-desativar]

O menu de cada linha tem:

- **Editar**: nome e papel.
- **Enviar redefinição**: gera um link de uso único, válido por 1 hora, para a pessoa definir uma senha nova. A senha atual vale até o link ser usado.
- **Desativar** ou **Reativar**: desativar pede confirmação, porque encerra as sessões e revoga os tokens da pessoa.

<Figure src="/images/admin-users.png" alt="Menu de ações de um usuário aberto, com Editar, Enviar redefinição e Desativar" caption="O menu de cada linha da lista de usuários." />

### Enviar redefinição [#enviar-redefinição]

Com o envio de email configurado na instância, o link segue só para o email da pessoa e o administrador não o vê. Sem email, o diálogo mostra o **Link de redefinição** para você copiar e mandar por um canal seguro.

<Figure src="/images/admin-password-reset.png" alt="Diálogo Enviar redefinição de senha mostrando o campo Link de redefinição" caption="Numa instância sem email, o administrador copia o link." />

Quando a pessoa usa o link, o Mira encerra as sessões e revoga os tokens dela e manda o email "Sua senha foi redefinida". Quem entrou só pelo Google não tem senha, e o mesmo link permite definir uma.

<Callout type="tip" title="Desative, não exclua">
Desativar preserva a autoria dos reports e dos comentários. Você não consegue desativar a própria conta pela lista. O Mira também recusa desativar o último administrador ativo e a conta que é o último Mantenedor ativo de um projeto. Nesse caso, convide outro Mantenedor antes.
</Callout>

## Auditoria [#auditoria]

Em **Administração do Mira → Auditoria**, o administrador lê o registro de quem fez o quê, do mais novo para o mais antigo. Cada linha tem **Quando**, **Quem**, **Ação**, **Alvo** e **Projeto** (quando houver). **Carregar mais** traz os registros seguintes.

<Figure src="/images/admin-audit.png" alt="Página Auditoria com a tabela de registros e a coluna Ação em destaque" caption="A página Auditoria, só para administradores." />

As ações registradas são:

- **Convite criado**, **Convite aceito** e **Convite revogado**.
- **Membro adicionado**, **Membro removido** e **Papel no projeto alterado**.
- **Redefinição de senha enviada** e **Senha redefinida**.
- **Conta desativada** e **Conta reativada**.
- **Conta Google conectada**.

Ações feitas pelo próprio Mira aparecem como **Sistema**.

## Próximos passos [#próximos-passos]

- [Projetos](/administrar/projetos)
- [Chaves e tokens](/administrar/chaves)