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

認証

MongoDB Connector for BI は、MongoDB での認証と接続ユーザーの認証のために次の認証メカニズムをサポートしています。

  • SCRAM-SHA-1

  • SCRAM-SHA-256

  • PLAIN (LDAP)

  • GSSAPI (Kerberos)

BI Connector（ mongosqld ）は、管理者認証情報を使用して MongoDB で認証し、サンプル データを使用して BI Connector のスキーマを生成します。 クライアントが BI Connector に接続すると、 mongosqldは認証のために接続クライアントの認証情報を MongoDB に渡し、接続ユーザーの権限に従ってデータを表示および制限します。

次のセクションでは、MongoDB 配置で認証するように BI Connector を構成する方法、BI Connector に接続するユーザーの認証を構成する方法、および認証オプションを使用して BI ツールからユーザー名を形式する方法について説明します。

MongoDB 認証

If authentication is enabled on your MongoDB deployment, you must configure the BI Connector to use the required authentication mechanism and provide admin user credentials. The admin user credentials must be authorized to view the superset of data you wish to query using the BI Connector.

注意

For information on how to configure SCRAM on your MongoDB deployment, see SCRAM.

MongoDB の BI Connector 認証メカニズムとしてチャレンジとレスポンス（ SCRAM-SHA-1 ）を有効にするには、次の設定をmongosqld構成ファイルに追加する必要があります。

mongodb:
  net:
    auth:
      username: <admin-username>
      password: <admin-password>
      source: <auth-db-name>
      mechanism: "SCRAM-SHA-1"

MongoDB ホスト構成ファイル設定の詳細については、以下を参照してください。

注意

For information on how to configure LDAP on your MongoDB deployment, see LDAP Proxy Authentication.

MongoDB の BI Connector 認証メカニズムとしてLDAP （ PLAIN ）を有効にするには、次の設定をmongosqld構成ファイルに追加する必要があります。

mongodb:
  net:
    auth:
      username: <admin-username>
      password: <admin-password>
      mechanism: "PLAIN"

MongoDB ホスト構成ファイル設定の詳細については、以下を参照してください。

MongoDB の BI Connector 認証メカニズムとして Kerberos（ GSSAPI ）を有効にするには、次の設定をmongosqld構成ファイルに追加する必要があります。

mongodb:
  net:
    auth:
      username: <admin-username>
      password: <admin-password>
      mechanism: "GSSAPI"

MongoDB ホスト構成ファイル設定の詳細については、以下を参照してください。

Kerberos 構成の詳細については、「 BI Connector 用の Kerberos の構成 」を参照してください。

BI Connector 認証

BI Connector 認証メカニズムとしてチャレンジとレスポンス（ SCRAM-SHA-1 ）を有効にするには、 mongosqld構成ファイルにsecurity.enabled : trueを追加する必要があります。

security:
  enabled: true

SCRAM-SHA-1 is the default authentication mechanism when mechanism is not specified in the username and security is enabled. ユーザー名からsourceを省略するには、 を追加し、構成ファイルでsecurity.defaultSource : <authenticationDatabase>と設定します。

security:
  enabled: true
  defaultSource: "admin"

BI Connector の構成ファイル設定の詳細については、以下を参照してください。

BI Connector 認証メカニズムとして LDAP （PLAINsecurity.enabled: true ）を有効にするには、 mongosqld 構成ファイルに追加する必要があります。

security:
  enabled: true

ユーザー名にmechanismとsourceを追加するのを省略する場合は、これらのオプションと値のペアをmongosqld構成ファイルに追加して設定します。

mongosqld 構成ファイル内の セキュリティ ブロックは次のようになります。

security:
  enabled: true
  defaultMechanism: "PLAIN"
  defaultSource: "$external"

BI Connector の構成ファイル設定の詳細については、以下を参照してください。

BI Connector 認証メカニズムとして Kerberos（ GSSAPI ）を有効にするには、 mongosqld構成ファイルにsecurity.enabled : trueを追加する必要があります。

security:
  enabled: true

ユーザー名にmechanismとsourceを追加するのを省略する場合は、これらのオプションと値のペアをmongosqld構成ファイルに追加して設定します。

mongosqld 構成ファイル内の セキュリティ ブロックは次のようになります。

security:
  enabled: true
  defaultMechanism: "GSSAPI"
  defaultSource: "$external"
  gssapi:
    hostname: "<yourHostname>"
    serviceName: "mongosql"

BI Connector の構成ファイル設定の詳細については、以下を参照してください。

Kerberos 構成の詳細については、「 BI Connector 用の Kerberos の構成 」を参照してください。

クライアント認証

BI ツールがMongoDB BI Connector ODBC ドライバーを使用している場合は、ドライバーが認証を処理するため、認証プラグインをインストールする必要はありません。 MongoDB BI Connector ODBC ドライバー を使用しておらず、BI ツールを使用して認証する必要がある場合は、BI ツールと互換性があるに応じて C または JDBC 認証プラグインのいずれかをインストールします。

C 認証プラグイン

BI Connector とTableauやMySQL shell などの SQL クライアントとの間の認証を容易にする C 認証プラグインをインストールするための手順。

JDBC 認証プラグイン

JDBC 認証プラグインをインストールする手順。

BI ツールを BI Connector に接続する方法の詳細については、「 BI ツールの接続 」を参照してください。

重要

次のように、認証プラグインを使用するだけでなく、TLS/SSL を使用することをお勧めします。

  • SCRAM-SHA-1とSCRAM-SHA-256メカニズムは、クライアント プラグイン内のパスワードをハッシュします。 ただし、他のすべてのデータはクリアテキストです。

  • PLAINメカニズムでは、クリアテキストでパスワードが送信されます。

MongoDB Connector for BI は、 --authで実行する場合に認証を必要とします。 MongoDB Connector for BI は、クライアントから認証情報を持つ接続を受け取ると、それらの認証情報を基礎の MongoDB インスタンスに渡します。

認証オプション

ユーザー名の後に URI スタイルのクエリ パラメーターとして次の認証オプションを指定できます。

接続オプション
説明

source

ユーザーの認証情報をストアするデータベースの名前を指定します。このオプションを指定しない場合、MongoDB Connector for BI はデフォルトで MySQL 接続に関連付けられた現在のデータベースになります。

PLAIN（LDAP）や GSSAPI（Kerberos）など、認証情報ストレージを他のサービスに委任する認証メカニズムの場合は、source 値を $external に設定します。

MongoDB Connector for BI 構成ファイルで defaultSource が設定されている場合は必要ありません。

mechanism

MongoDB Connector for BI が接続の認証に使用するメカニズムを指定します。受け入れ可能な値は以下の通りです。

LDAP and Kerberos require MongoDB Enterprise. Set the source to $external when using LDAP or Kerberos.

MongoDB Connector for BI 構成ファイルで defaultMechanism が設定されている場合は必要ありません。

X.509 はサポートされていません。

例

次の例は、チャレンジとレスポンス（ユーザー名とパスワード）、 LDAP 、または Kerberos を使用して BI Connector で認証するためにユーザー名を形式する方法を示しています。

たとえば、 adminデータベースと Challenge および Response（ SCRAM-SHA-1 ）認証メカニズムを使用してユーザーgraceとして認証するには、次の形式でユーザー名を書き込みます。

grace?source=admin

たとえば、 LDAP （ PLAIN ）認証メカニズムを使用してユーザーgraceとして認証するには、次の形式でユーザー名を書き込みます。

grace?mechanism=PLAIN&source=$external

For example, to authenticate as user grace on the EXAMPLE.COM Kerberos realm with the Kerberos authentication mechanism, write the username in this format:

grace@EXAMPLE.COM?mechanism=GSSAPI&source=$external

Kerberos 構成の詳細については、「 BI Connector 用の Kerberos の構成 」を参照してください。

戻る

MySQL Shell Options

次へ

C 認証プラグイン

項目一覧