db.changeUserPassword()
Nesta página
Definição
db.changeUserPassword(username, password)
Atualiza a senha de um usuário. Execute o método no banco de dados de dados em que o usuário está definido, ou seja, o banco de dados de dados em que você
created
usuário.Importante
Método mongosh
Esta página documenta um método
mongosh
. Esta não é a documentação de comandos de banco de dados nem drivers específicos de linguagem, como Node.js.Para o comando do banco de dados, consulte o comando
updateUser
.Para drivers de API do MongoDB, consulte a documentação do driver do MongoDB específica da linguagem.
ParâmetroTipoDescriçãousername
stringO nome do usuário cuja senha você deseja alterar.password
stringA senha do usuário. O valor pode ser:
a senha do usuário em string de texto não criptografado ou
passwordPrompt()
para solicitar a senha do usuário.Você pode usar o método
passwordPrompt()
em conjunto com vários métodos e comandos de gerenciamento de autenticação de usuário para solicitar a senha em vez de especificar a senha diretamente na chamada de método ou comando. No entanto, você ainda pode especificar a senha diretamente como faria com versões anteriores do shellmongo
.
writeConcern
documentoOpcional. O nível da write concern para a operação. Consulte Especificação de write concern.
Acesso necessário
Para modificar a senha de outro usuário em um banco de dados, você deve ter a changePassword
ação neste banco de dados.
Comportamento
Aviso
Por padrão, db.changeUserPassword()
envia todos os dados especificados para a instância do MongoDB em texto não criptografado, mesmo se estiver usando passwordPrompt()
. Use a criptografia de transporte TLS para proteger as comunicações entre clientes e o servidor, incluindo a senha enviada pelo db.changeUserPassword()
. Para obter instruções sobre como habilitar a criptografia de transporte TLS, consulte Configurar mongod
e mongos
para TLS/SSL.
O MongoDB não armazena a senha no cleartext. A senha só estará vulnerável em trânsito entre o cliente e o servidor e somente se a criptografia de transporte TLS não estiver habilitada.
Exemplo
A seguinte operação altera a senha do usuário denominado accountUser
no banco de dados do products
para SOh3TbYhx8ypJPxmt1oOfL
:
Dica
Você pode usar o método passwordPrompt()
em conjunto com vários métodos e comandos de gerenciamento de autenticação de usuário para solicitar a senha em vez de especificar a senha diretamente na chamada de método ou comando. No entanto, você ainda pode especificar a senha diretamente como faria com versões anteriores do shell mongo
.
use products db.changeUserPassword("accountUser", passwordPrompt())
Quando solicitado em mongosh
para a senha, insira a nova senha.
Você também pode passar a nova senha diretamente para db.changeUserPassword()
:
use products db.changeUserPassword("accountUser", "SOh3TbYhx8ypJPxmt1oOfL")