db.changeUserPassword()

Nesta página

Definição

Compatibilidade
Acesso necessário
Comportamento
Exemplo

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â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. Dica Você pode usar o método `passwordPrompt()` em conjunto com vários métodos/comandos de autenticação/gerenciamento de usuário para solicitar a senha em vez de especificar a senha diretamente na chamada de método/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 é suportado em clusters MongoDB Atlas . Para obter informações sobre o suporte do Atlas para 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

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/comandos de autenticação/gerenciamento de usuário para solicitar a senha em vez de especificar a senha diretamente na chamada de método/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

db.createUser