PythonでMongoDBの認証・ユーザー管理を徹底解説！セキュリティの基本をマスター

PythonでMongoDBの認証・ユーザー管理を行う方法

先生と生徒の会話形式で理解しよう

生徒

「PythonでMongoDBを使っていますが、誰でもデータを見られる状態なのは怖いです。合言葉（パスワード）を設定する方法はありますか？」

先生

「その通りですね。大切なデータを守るために『認証（にんしょう）』と『ユーザー管理』の設定は欠かせません。」

生徒

「認証って難しそうですが、初心者でもPythonから設定できるのでしょうか？」

先生

「はい、PyMongoという道具を使えば、プログラムからユーザーを作ったり、合言葉を使って安全に接続したりできますよ。基本から丁寧に見ていきましょう！」

1. 認証とユーザー管理とは？セキュリティの重要性

データベースにおける認証（にんしょう）とは、簡単に言うと「あなたは誰ですか？」を確認する手続きのことです。パソコンを触ったことがない方に例えると、マンションの入り口にある「オートロック」のようなものです。鍵を持っている人（正しい名前と合言葉を知っている人）だけが中に入って、データを操作できるようにします。

そしてユーザー管理とは、その鍵を誰に渡すか、その人はマンションの中でどこまで入っていいかを決める作業です。例えば、「お掃除の人は共有スペースだけ」「住人は自分の部屋だけ」といったように、人によってできることを制限します。これをプログラミングの世界では「権限（けんげん）」と呼びます。MongoDBとPythonを組み合わせて、この防犯対策をしっかり行う方法を学んでいきましょう。

2. Pythonでユーザーを作成する方法：commandメソッド

まずは、データベースにアクセスするための「新しいユーザー（住人）」を登録してみましょう。MongoDBには、ユーザーを管理するための専用の命令が用意されています。Pythonからは db.command という命令を使って、データベースに「ユーザーを作って！」とお願いをします。

以下のコードは、新しく「admin_user」という名前のユーザーを作る例です。合言葉（パスワード）や、そのユーザーに与える役割（ロール）を指定して作成します。パソコン初心者の方は、まずは決まった形として真似して書いてみてください。


from pymongo import MongoClient

# 最初は認証なしで接続（設定用）
client = MongoClient('mongodb://localhost:27017/')
db = client['admin']

# 新しいユーザーを作る命令を送る
db.command("createUser", "admin_user",
           pwd="password123",
           roles=[{"role": "userAdminAnyDatabase", "db": "admin"}])

print("管理ユーザーを作成しました。")

ここで出てくる userAdminAnyDatabase というのは、「どのデータベースのユーザーも管理できる、一番偉い管理人さん」という特別な役割の名前です。

3. 認証を使ってデータベースに安全に接続する

ユーザーができたら、次からはその名前と合言葉を使って接続します。これをしないと、せっかく作ったオートロックを素通りして中に入ることができません。Pythonのコードでは、接続先の住所（URL）の中に、ユーザー名とパスワードを書き込みます。

住所の書き方は mongodb://名前:合言葉@場所/ という形式になります。これにより、PyMongoは接続する瞬間に「私は正当なユーザーです」と証明してくれるようになります。これがセキュリティの第一歩です。


# ユーザー名「admin_user」、合言葉「password123」で接続する例
uri = "mongodb://admin_user:password123@localhost:27017/"
client = MongoClient(uri)

# 接続できたか確認
print("認証に成功して接続できました！")

4. 役割（ロール）の考え方：できることを制限する

ユーザー管理で最も大切なのが、役割（ロール）の設定です。全員を「管理人」にしてしまうと、うっかりデータを全部消してしまう人が出るかもしれません。そこで、「読み取り専用（見るだけの人）」や「読み書き可能（修正もできる人）」といった制限をかけます。

例えば、read というロールを与えられたユーザーは、データを見ることはできますが、新しく追加したり消したりすることはできません。これは、銀行の通帳を「見るだけ」にするか「引き出しもできる」にするかの違いに似ています。Pythonからユーザーを作るときに、このロールを慎重に選ぶことで、より安全なシステムを作ることができます。

5. 既存のユーザー情報を確認する

「今、このデータベースにはどんなユーザーが登録されているんだろう？」と気になったときは、ユーザーの一覧を確認することができます。これには usersInfo という命令を使います。

自分以外の誰かが勝手にユーザーを作っていないか、あるいは設定した役割が間違っていないかを定期的にチェックすることは、セキュリティを守る上でとても重要です。Pythonの画面に、登録されている人の名前や権限がズラリと表示されます。


# 登録されているユーザーの情報を表示する
users_info = db.command("usersInfo")

for user in users_info['users']:
    print(f"ユーザー名: {user['user']}, 権限: {user['roles']}")

6. ユーザーのパスワードを変更する方法

合言葉は、定期的に変えたほうが安全です。また、「パスワードを忘れてしまった！」という人がいたときも、管理人が新しく設定し直してあげる必要があります。Pythonからは updateUser という命令を使って、特定のユーザーの情報を書き換えることができます。

これは、家の鍵を新しいものに取り替える作業と同じです。古い合言葉は使えなくなるので、接続しているプログラム側も新しいものに書き換える必要があります。セキュリティ意識を高めるために、この操作も覚えておきましょう。


# admin_user のパスワードを新しいものに変更する
db.command("updateUser", "admin_user", pwd="new_secure_password_456")

print("パスワードの変更が完了しました。")

7. 不要になったユーザーを削除する

プロジェクトを抜けた人のアカウントや、テスト用に作ったユーザーをそのままにしておくのは危険です。使わなくなった鍵は回収して、入り口を無効にしなければなりません。これには dropUser という命令を使います。

削除する際は、名前を間違えないように注意しましょう。一度消してしまうと、その名前では二度と入れなくなります。Pythonでスッキリと整理整頓することで、データベースの安全性を高く保つことができます。

8. 認証データベース（authSource）の理解

MongoDBには、少し特殊な仕組みがあります。それは「ユーザー情報がどこに保存されているか」という点です。通常、一番偉い管理者の情報は admin という名前のデータベースに保存されます。接続するときに、「私の情報は admin データベースに置いてあるよ」と教えてあげる必要があります。

これを authSource（オース・ソース）と呼びます。これの指定を忘れると、正しい名前と合言葉を入れていても「そんな人はいません」と追い返されてしまうことがあります。接続時の住所に ?authSource=admin と付け足すのがコツです。

9. 接続文字列（URI）を隠す重要性

プログラムの中に mongodb://admin:password123... と直接書いてしまうと、そのプログラムのファイルを見た人全員に合言葉がバレてしまいます。これは、玄関のドアに合言葉を書いたメモを貼っておくのと同じくらい危ないことです。

プロの世界では、「環境変数（かんきょうへんすう）」という別の場所に合言葉を隠しておき、Pythonが実行される瞬間にこっそり読み込むという方法をとります。初心者の方は、まずは「パスワードが書かれたファイルを人に見せない」ということから気をつけましょう。

10. セキュリティを強化するための次のステップ

ユーザー管理ができるようになったら、さらに防犯レベルを上げることができます。例えば、「特定のパソコンからしか接続できないようにする」といった設定や、通信の内容を暗号化して盗み見られないようにする設定などです。これらは「インフラ」や「ネットワーク」といった分野の知識になります。

まずは、今回学んだ「ユーザーを作って、適切な権限を与え、認証付きで接続する」という基本を確実にマスターしてください。これができれば、あなたは自分の大切なデータを守れる「セキュリティに強いプログラマー」への第一歩をしっかりと踏み出したことになります。安全第一で、楽しくプログラミングを続けていきましょう！

公的機関での指導実績【Python実務設計実践セミナー】