Menu Docs
Página inicial do Docs
/
Manual do MongoDB
/ / /

db.changeUserPassword()

Nesta página

  • Definição
  • Acesso necessário
  • Comportamento
  • Exemplo
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â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.

Para modificar a senha de outro usuário em um banco de dados, você deve ter a changePassword ação neste banco de dados.

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.

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

Voltar

db.auth