Autenticação e usuários no MongoDB
O controle de acesso do MongoDB libera cada ação de uma conexão conforme os papéis do usuário autenticado, que o servidor identifica pelo nome e pelo banco onde ele foi criado. Num mongod instalado por você, a opção security.authorization vem como disabled, por isso qualquer conexão que alcance a porta 27017 lê, altera e apaga qualquer banco até você ligar a autenticação.
Ficha e sumário da página
- Referência técnica
- MongoDB Community 9.0.8
- Revisão
- 13 de novembro de 2026
- Conteúdo
- Documentação oficial consultada
O mongod começa sem controle de acesso
A opção security.authorization liga o controle de acesso baseado em papéis. O valor padrão é disabled, que faz o servidor aceitar a conexão sem usuário nem senha. Segundo a documentação oficial, qualquer conexão acessa qualquer banco e executa qualquer ação nesse estado. Com o valor enabled, ou com o mongod iniciado pela opção --auth, cada conexão precisa se autenticar e só executa as ações liberadas pelos papéis do usuário.
O padrão de rede compensa parte dessa abertura num servidor instalado pelos pacotes oficiais. O mongod escuta só em localhost até você mudar a opção net.bindIp, então outra máquina não alcança a porta 27017. A imagem mongo do Docker Hub muda esse padrão: o script de entrada da imagem acrescenta --bind_ip_all quando você não informa endereço de escuta. Com isso, o mongod dentro do container atende em todas as interfaces.
Como a imagem oficial cria o primeiro usuário
A imagem oficial trata o primeiro usuário com variáveis de ambiente lidas na primeira inicialização. Com as duas variáveis do usuário root definidas, o script cria esse usuário no banco admin com o papel root. Na mesma subida, o mongod inicia com autenticação ligada. O .env do Compose de estudo reúne essas chaves:
.env do Compose de estudo do MongoDB
Usuário administrador
MONGO_INITDB_ROOT_USERNAME=- Nome do usuário criado no banco admin com o papel root.
MONGO_INITDB_ROOT_PASSWORD=- Senha desse usuário. Com as duas chaves, o mongod sobe com --auth.
Inicialização
MONGO_INITDB_DATABASE=- Banco usado pelos scripts .js de /docker-entrypoint-initdb.d, test quando ausente.
MONGO_INITDB_ROOT_PASSWORD_FILE=- Caminho de um Docker secret com a senha, no lugar da variável em texto.
As duas variáveis do root só têm efeito com a pasta /data/db vazia. Quando o volume já guarda um banco, a imagem deixa esse banco intocado e ignora as variáveis, de modo que trocar a senha no .env depois da primeira subida não altera a senha gravada. A senha nova entra por um comando dentro do banco, executado por um usuário com permissão para administrar usuários.
Fora do Docker, o primeiro usuário entra pela exceção de localhost. Com o controle de acesso ligado e nenhum usuário nem papel criado, uma conexão vinda da própria máquina pode criar o primeiro usuário no banco admin. Esse usuário precisa de permissão para criar os demais, como a que os papéis userAdmin e userAdminAnyDatabase dão. A exceção termina quando db.createUser() grava esse primeiro usuário.
Usuário e banco de autenticação
Um usuário do MongoDB é identificado pelo nome e pelo banco de autenticação, o banco onde ele foi criado. No exemplo oficial, o usuário appUser é criado no banco admin com o papel readWrite no banco myDB. Um segundo appUser criado dentro de myDB seria outro usuário, com senha e papéis próprios. Todos ficam guardados na coleção admin.system.users, que a documentação manda administrar só pelos comandos de usuário, sem edição direta.
Na hora da conexão, o driver informa o nome, a senha e o banco de autenticação, este último pela opção authSource da URI de conexão. O servidor confere a senha com o SCRAM, o mecanismo padrão do MongoDB, que usa sal aleatório por usuário e autenticação nos dois sentidos, do cliente para o servidor e do servidor para o cliente. O appUser do exemplo vive em admin. Um app que conecta com /myDB na URI e sem authSource=admin recebe erro de autenticação, porque, sem a opção, o driver usa o banco da URI como banco de autenticação e o servidor procura o usuário em myDB.
Os privilégios de um usuário podem alcançar vários bancos. Em vez de criar um usuário por banco, você cria um usuário só, com um papel em cada banco que ele precisa usar.
O que cada papel libera
O papel define as ações permitidas e o banco onde elas valem. Os papéis embutidos cobrem os casos mais comuns de um app e da administração do servidor:
readLê as coleções do banco, fora as coleções de sistema.readWriteTudo de read, mais inserir, alterar e apagar documentos.dbAdminÍndices, estatísticas e tarefas de esquema, sem gerir usuários.userAdminCria e altera usuários e papéis no banco atual.backupO mínimo para ler o banco numa cópia de segurança.rootSuperusuário: soma os privilégios de administração de todo o servidor.
O app costuma receber readWrite no banco dele e nada mais. Esse papel deixa o app gravar os próprios documentos, mas não criar usuários, não ler outros bancos e não derrubar o servidor. O usuário root da imagem fica reservado para administrar o servidor pelo mongosh, fora do código do app.
A documentação registra que o userAdmin permite conceder qualquer privilégio a qualquer usuário, inclusive ao próprio. Por isso um usuário com esse papel chega, de forma indireta, ao acesso de superusuário do banco, ou do servidor inteiro quando o papel está no banco admin. O userAdminAnyDatabase dá o mesmo poder de administrar usuários em todos os bancos menos local e config.
Com os usuários definidos, o próximo assunto é manter o banco no ar quando um servidor falha, com três processos e a mesma cópia em cada um, na página Replica set.