Saltar para o conteúdo principal

Criar um usuário administrador

Implantações com o Overleaf Toolkit:
Overleaf Toolkit
Implantações legadas com docker-compose.yml:
Legacy docker-compose
O comando criará um usuário com o endereço de e-mail fornecido, caso ainda não exista, e o tornará administrador. A saída do comando inclui uma URL que você deve visitar para definir a senha deste usuário e entrar pela primeira vez.
Para uma abordagem programática, você pode usar o mesmo script para criar usuários comuns, além de administradores. Para usuários comuns, omita a flag —admin.
Se você usa contas internas para autenticação e precisa promover um usuário existente a administrador da instância ou revogar permissões de administrador, faça o seguinte:
1

Pela interface de administração

  • Entre como um administrador existente.
  • Clique em Admin -> Manage Users.
  • Pesquise o usuário e clique no nome dele.
  • Clique no ícone de lápis.
  • Ative ou desative Admin.
  • Clique em Save para concluir.

Excluir usuários

Em geral, é recomendável não excluir contas, a menos que não sejam mais necessárias. Excluir uma conta remove a conta e faz com que os colaboradores percam o acesso aos projetos. Para impedir que um usuário faça login e manter os dados dele, desative a conta em vez disso. Por padrão, as contas são excluídas de forma reversível (soft delete). Para informações sobre como remover usuários permanentemente da sua instância, consulte ENABLE_CRON_RESOURCE_DELETION no guia de Variáveis de ambiente.
Por padrão, as contas são excluídas de forma reversível. Consulte ENABLE_CRON_RESOURCE_DELETION para o comportamento de exclusão permanente.

Através de Admin -> Manage Users

1
  • Entre como administrador.
  • Clique em Admin -> Manage Users.
  • Pesquise o usuário e marque a caixa ao lado do nome dele.
  • Clique no ícone da lixeira.
  • Clique em Delete account para confirmar.

Pela linha de comando

As contas de usuário (e os seus projetos) podem ser excluídas usando os seguintes comandos. Implantações com o Overleaf Toolkit:
Overleaf Toolkit
Implantações legadas com docker-compose.yml:
Legacy docker-compose
O script de exclusão usa uma opção de força fixa no código que garante que a exclusão prossiga mesmo que o e-mail de exclusão da conta não seja enviado (por exemplo, quando o e-mail do usuário não está mais em uso).
A opção —skip-email pode ser usada para evitar o envio de um e-mail informativo ao usuário excluído.

Restaurar um usuário excluído de forma reversível

Se um usuário foi apenas excluído de forma reversível (soft delete), você pode restaurar a conta dele e os projetos excluídos com ela. Os projetos que o próprio usuário havia excluído continuam excluídos.
1
  • Entre como administrador.
  • Clique em Admin -> Manage Users.
  • Pesquise o usuário que deseja restaurar.
  • Clique em Display deleted users.
  • Clique no ícone de seta na linha do usuário.
  • Clique em Restore para confirmar.
Quando ENABLE_CRON_RESOURCE_DELETION está definido como true, as contas excluídas de forma reversível podem ser restauradas dentro de um prazo de 90 dias. Após 90 dias, não é possível recuperar a conta.

Contar usuários

Você pode obter a contagem de usuários pela interface de administração em https://you-instance-url/admin/user#license. Para verificações e exportações programáticas, os exemplos a seguir podem ajudar. Número total de usuários:
Total number of users
Número total de usuários usando o endpoint de métricas:
Num active users from metrics
Número total de usuários ativos (exemplo: usuários ativos nos últimos 365 dias):
Total number of active users

Atualizar as informações da conta de usuário

A forma de atualizar as contas depende de o SSO estar ativado ou não.
  • Se o SSO não for usado:
    • Os administradores podem modificar as informações da conta de usuário em Admin -> Manage Users (e-mail, nome, sobrenome e gerar um link de redefinição de senha).
    • Os usuários comuns podem atualizar os seus próprios dados em Account -> Account Settings (incluindo alterar a senha e gerar tokens de autenticação do Git).
  • Se o SSO for usado:
    • O Ayakaleaf Pro pode ser configurado para atualizar o nome e o sobrenome de um usuário durante o login com base no sistema de autenticação.
    • Quando OVERLEAF_SAML_UPDATE_USER_DETAILS_ON_LOGIN ou OVERLEAF_LDAP_UPDATE_USER_DETAILS_ON_LOGIN estão definidos como true, o formulário de dados do usuário em https://your-instance-url/user/settings fica desativado e o nome/sobrenome só podem ser definidos no seu sistema de gerenciamento de identidades.
Para mais detalhes, consulte:

Perguntas e respostas

Resposta: Não há API HTTP para isso. Crie a conta com o script create-user acima (sem --admin) ou em Admin → Manage Users com Create account. Quando EXTERNAL_AUTH está definido, esse formulário tem a opção Log in with SSO, que cria a conta sem senha local e sem e-mail ou link de ativação: a caixa de diálogo fecha após Create. No primeiro login LDAP, SAML ou OIDC, o usuário recebe a conta existente com o mesmo e-mail em vez de uma nova; veja Contas e senhas.
Resposta: Não. Não há exportação nem importação de contas de usuário, nem em Admin → Manage Users nem por script. As contas são armazenadas no MongoDB, portanto faça backup delas e restaure-as com um backup do MongoDB. O script export-user-projects.mjs exporta os projetos dos usuários como arquivos zip, não as contas; consulte Exportando projetos.

Última atualização há 4 meses Esta página de documentação contém links para guias e páginas de configuração externos. Todos os links e parâmetros de consulta são preservados como no conteúdo original.
Última modificação em 13 de novembro de 2026