AI エージェント向け: ドキュメントインデックスは https://www.mongodb.com/ja-jp/docs/llms.txt で利用できます。すべてのページの markdown バージョンは、いずれかの URL パスに .md を追加することで利用できます。

SQLインターフェイス認証

SQL インターフェースは、ユーザーの MongoDB 配置に接続するために複数の認証メカニズムをサポートしています。このページには、Atlas 専有クラスター、Atlas フェデレーティッドデータベースインスタンス、および自己管理型 MongoDB Enterprise 配置について、サポートされている認証方法、コンポーネントの互換性、および配置の可用性が記載されています。

次の表は、各SQL Interface コンポーネントでサポートされている認証メカニズムを示しています。

コンポーネント
SCRAM
x.509
LDAP
GSSAPI
AWS IAM
OIDC

MongoDB SQLスキーマ ビルダ

はい

はい

はい

はい

はい

はい

ODBC ドライバー

はい

はい

はい

はい

はい

はい

JDBC ドライバー

はい

はい

はい

はい

はい

はい

Power BI Desktop

はい

はい

はい

はい

はい

はい

Power BI Gateway

はい

No

No

No

No

No

Tableau Desktop

はい

はい

はい

はい

はい

はい

Tableau サーバー

はい

はい

No

No

No

No

Tableauクラウド

はい

No

No

No

No

No

注意

すべてのサードパーティ製BIツールが、MongoDBドライバーではサポートされているにもかかわらず、これらの認証オプションをサポートしているわけではありません。使用したい機能をテストし、お使いの特定の BI ツールで正常に動作するかどうかを確認します。

次の表は、各MongoDB配置タイプで使用できる認証メカニズムを示しています。

認証メカニズム
専用クラスター
フェデレーティッドデータベースインスタンス

SCRAM

はい

はい

はい

x.509

はい

はい

はい

LDAP

はい

No

はい

Kerberos (GSSAPI)

No

No

はい

AWS IAM

はい

はい

No

OIDC

はい

はい

はい

重要

MongoDB 8.0 以降では、LDAP 認証と承認は非推奨です。LDAP は引き続き利用可能であり、MongoDB 8 の期間中、変更なく動作し続けます。しかし、将来のメジャーリリースで廃止されます。OIDC またはサポートされている別の認証メカニズムに移行することを検討してください。詳細については、LDAP 非推奨化。を参照してください。

MongoDB JDBC ドライバーは、MongoDB がサポートしているすべての認証メカニズムをサポートします。詳細については、「認証メカニズム」を参照してください。設定すると、ドライバーは TLS/SSL 接続もサポートします。詳しくは、TLS/SSL 構成を参照してください。

以下のセクションでは、509 JDBC ドライバーの X. 、Kerberos (GSSAPI)、および OIDC 認証の構成に関する接続プロパティについて説明します。これらのプロパティは、Atlas と自己管理型 MongoDB Enterprise の両方の配置に適用されます。

MongoDB JDBC ドライバーは X.509 クライアント証明書認証をサポートしています。次のプロパティは、ドライバーがクライアント証明書と CA トラストをどのように構成するかを制御します。

プロパティ
目的

x509pempath

クライアント証明書と秘密キーを含む PEM ファイルへのパス。暗号化されていないまたは暗号化された PKCS #1 および PKCS #8 キーの場合に必要です。

tlscafile

任意。1 つ以上の信頼された X.509 証明書を含む PEM ファイルへのパス。設定されると、ドライバーはこれらの CA によって署名された証明書のみ受け付けます。

password

x509pempath を設定するかどうかによって用途が異なります。x509pempath を設定するとき、暗号化された PEM ファイルのパスフレーズは password です。x509pempath を設定しない場合、password には、暗号化されていない証明書と秘密キーで構成される生の PEM コンテンツ、または、暗号化された PEM データ用の {"pem": "...", "passphrase": "..."} という形式の JSON オブジェクトを含めることができます。

X.509 認証を設定する際は、次の動作を考慮してください。

  • x509pempath を設定すると、それは password プロパティの PEM コンテンツより優先されます。

  • tlscafile を設定しない場合、ドライバーはデフォルトの JVM トラストストアを使用します。

  • PEM コンテンツには、x509pempath を介して提供する場合でも、password プロパティで提供する場合でも、クライアント証明書とそれに対応する秘密キーの両方が含まれている必要があります。

MongoDB JDBC ドライバーは、Kerberos ベースの認証のために GSSAPI をサポートしています。このメカニズムでは、Kerberos および JAAS 設定をドライバーの外部で設定する必要があります。以下のプロパティは、ドライバーがその構成をどのように使用するかを制御します。

プロパティ
説明

jaasconfigpath

JAAS 構成ファイルへのパス。たとえば jaas.config など。このプロパティを設定しない場合、ドライバーはデフォルトの JVM JAAS 設定を使用します。

gssapilogincontextname

JAAS 構成で定義されているログイン コンテキスト名を指定します。

gssapiserverauth

true に設定すると、SASL ネゴシエーション中にサーバー認証が有効になります。

gssnativemode

ドライバーがネイティブ GSSAPI ライブラリを使用するかどうかを制御します。true または false を受け入れます。

MongoDB JDBC ドライバーは、設定した認証メカニズムのプロパティに基づいて、人間が開始する OIDC フローとマシンが自動化する OIDC フローを区別します。

  • 人の流れ:デフォルトの動作。ブラウザーでログインすることによるユーザー操作が必要です。

  • マシン フロー: GCP ワークロード アイデンティティ、Azure マネージド アイデンティティ、および Kubernetes などの自動化された環境で使用されます。マシン フローを有効にするには、ENVIRONMENT および TOKEN_RESOURCE パラメータを設定します。

SQLインターフェイスの認証を構成するときは、次のセキュリティ ベストプラクティスを考慮してください。

  • 強力な認証メカニズムを使用する: 可能な場合、パスワードベースの認証よりも X.509、OIDC、または Kerberos を優先します。

  • TLS暗号化を有効にする : 認証情報と転送中のデータを保護するために、常に TLS を使用します。

  • 最小権限の原則に従います。ユーザーには、タスクに必要な最小限の権限のみを付与します。

  • 認証情報ストレージを保護する : 接続文字列の認証情報をハードコードしないでください。環境変数、認証情報ファイル、または安全な認証情報管理システムを使用します。

  • 定期的な認証情報のローテーション: パスワードと証明書の定期的なローテーションを実装します。

  • 認証イベントのモニター:監査するログ を有効にして、認証試行と失敗を追跡します。