MongoDBで既存ユーザーのパスワードを変更する方法【changeUserPasswordの使い方】

MongoDBでは、既存ユーザーのパスワードを変更したい場合、changeUserPassword() メソッドを使用します。このメソッドを使えば、コマンド一つで簡単にパスワードを更新できます。

基本構文

パスワード変更の基本的な構文は以下のとおりです。

db.changeUserPassword("既存のユーザー名", "新しいパスワード");

手順1：adminデータベースに切り替える

まず、対象のユーザーが登録されているデータベースに切り替える必要があります。ここでは例として admin データベースに移動します。

> use admin

実行すると、次のような出力が表示されます。

switched to db admin

手順2：既存ユーザーの一覧を確認する

続いて、データベースに登録されているユーザーを確認しましょう。以下のクエリを実行します。

> db.getUsers();

実行結果の例は次のとおりです。ここでは「John」というユーザーが存在することがわかります。

[
    {
        "_id" : "admin.John",
        "user" : "John",
        "db" : "admin",
        "roles" : [
            {
                "role" : "userAdminAnyDatabase",
                "db" : "admin"
            }
        ],
        "mechanisms" : [
            "SCRAM-SHA-1",
            "SCRAM-SHA-256"
        ]
    }
]

手順3：パスワードを変更する

ユーザー「John」のパスワードを変更するには、以下のクエリを実行します。

> db.changeUserPassword("John", "123456");

これで、ユーザー「John」のパスワードが「123456」に変更されました。エラーが表示されなければ、正常に更新されています。

注意点

• 権限が必要： パスワードを変更するには、対象ユーザーに対して userAdmin や userAdminAnyDatabase などの適切な管理権限を持つユーザーとして認証されている必要があります。
• 同じデータベース上で実行： changeUserPassword() は、そのユーザーが作成されたデータベース上で実行してください。別のデータベースで実行するとエラーになります。
• 安全なパスワードを設定： 例のように単純なパスワード（「123456」など）は本番環境では避け、推測されにくい強固なパスワードを使用することを推奨します。
• 認証方式について： 現在のMongoDBでは、認証には SCRAM-SHA-256 が標準的に使用されます。古いバージョンとの互換性が必要な場合は SCRAM-SHA-1 もサポートされています。

なお、ロールやその他の設定も同時に更新したい場合は、updateUser() メソッドを使用することで、パスワードと併せて柔軟にユーザー情報を変更できます。