db.changeUserPassword() (método mongosh)

Definição

db.changeUserPassword(username, password)

Atualiza a senha de um usuário. Execute o método no banco de dados em que o usuário está definido, ou seja, o banco de dados em que você created o usuário.

Importante

Método mongosh

This page documents a mongosh method. This is not the documentation for database commands or language-specific drivers, such as 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âmetro	Tipo	Descrição
`username`	string	O nome do usuário cuja senha você deseja alterar.
`password`	string	A 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 shell `mongo`.
`writeConcern`	documento	Opcional. O nível da write concern para a operação. Consulte Especificação de write concern.

Compatibilidade

Esse método está disponível em implantações hospedadas nos seguintes ambientes:

Importante

Este comando não é aceito em clusters do MongoDB Atlas. Para obter informações sobre o suporte do Atlas a todos os comandos, consulte Comandos não suportados.

MongoDB Enterprise: a versão autogerenciada e baseada em assinatura do MongoDB
MongoDB Community: uma versão com código disponível, de uso gratuito e autogerenciada do MongoDB

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

By default, db.changeUserPassword() sends all specified data to the MongoDB instance in cleartext, even if using passwordPrompt(). Use TLS transport encryption to protect communications between clients and the server, including the password sent by db.changeUserPassword(). For instructions on enabling TLS transport encryption, see Configure MongoDB Instances for TLS/SSL Encryption.

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())

When prompted in mongosh for the password, enter the new password.

You can also pass the new password directly to db.changeUserPassword():

use products
db.changeUserPassword("accountUser", "SOh3TbYhx8ypJPxmt1oOfL")

Voltar

db.auth

db.createUser