---
schema_version: "1"
id: 6c4acdfd5a55d108a25cb18ad86a22eed5c2964a0371a2021c08d31b36d45bf0
title: LDAP Connector 3.3
collection: mulesoft
version: current
locale: ja-jp
portal_url: https://docs.salesforce.com/mulesoft/current/ja-jp/ldap-connector/3.3/index.md
canonical_url: https://docs.mulesoft.com/jp/ldap-connector/3.3/
source_site: docs.mulesoft.com
content_type: documentation
content_hash: a3abd83cbe0ba95c286362ca3bfacd8a50bc985946bfd2da85109f388fa9bebf
description: MuleSoft Documentation Site
release: "3.3"
latest: false
---
# LDAP Connector 3.3

Lightweight Directory Access Protocol (LDAP) 用 Anypoint Connector は、インターネットプロトコル (IP) ネットワーク上の分散ディレクトリ (ネットワークユーザー権限情報など) のメンテナンスとアクセスを促進するために公開されている標準です。

無料で使用できるオープンソースのプロジェクトやパッケージに多くの LDAP サーバーが含まれています。LDAP サーバーのインストール、実行、設定の詳細については、このドキュメントでは説明しません。

このドキュメントでは、シンプルな LDAP Connector の設定例を紹介し、基本的なインストール手順と LDAP Connector を使用した LDAP サーバーへの接続手順について説明します。

互換性と解決された問題に関する情報は、「LDAP Connector リリースノート」を参照してください。

<table><tbody><tr><td class="icon"><i class="fa icon-note" title="Note"></i></td><td class="content">このバージョンのコネクタでは、TLS 経由の LDAP のみがサポートされます。</td></tr></tbody></table>

## [](#prerequisites)始める前に

LDAP Connector を使用するには、次のものが必要です。

- OpenLDAP、Apache Directory、Microsoft Active Directory インスタンスのいずれかへのアクセス。
- Anypoint Studio バージョン 7.0 (以上)。

LDAP Connector を本番環境で使用するには、次のいずれかが必要です。

- Mule を使用するための Enterprise ライセンス。
- CloudHub Starter、Professional、Enterprise のいずれかのアカウント。

この情報を使用するには、LDAP、Mule Runtime Engine (Mule)、Anypoint Connector、Anypoint Studio の基礎、Mule フローの要素、グローバル要素に精通している必要があります。

## [](#pom-ファイル情報)POM ファイル情報

```xml
<dependency>
  <groupId>com.mulesoft.connectors</groupId>
  <artifactId>mule-ldap-connector</artifactId>
  <version>x.x.x</version>
  <classifier>mule-plugin</classifier>
</dependency>
```

`x.x.x`​ を使用しているコネクタに対応するバージョンに置き換えます。

最新の ​`pom.xml`​ ファイル情報を取得する手順は、次のとおりです。

1. [Anypoint Exchange](https://www.mulesoft.com/exchange/)​ に移動します。
2. Exchange で、​**\[Login (ログイン)\]**​ をクリックし、Anypoint Platform のユーザー名とパスワードを指定します。
3. Exchange で、「​`ldap`​」を検索します。
4. コネクタを選択します。
5. 画面の右上付近にある ​**\[Dependency Snippets (連動関係スニペット)\]**​ をクリックします。

### [](#compatibility)互換性

LDAP Connector は、以下と互換性があります。

<table class="tableblock frame-all grid-all" style="width: 70%;">
<colgroup>
<col style="width: 20%;">
<col style="width: 80%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">アプリケーション/サービス</th>
<th class="tableblock halign-left valign-top">バージョン</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Mule Runtime</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>4.1.1 以降</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Java</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>1.8.0_x 以上</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Anypoint Studio</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>7.0 以上</p>
</div></div></td>
</tr>
</tbody>
</table>

## [](#install)Studio プロジェクトへのコネクタの追加

Anypoint Studio (Studio) エディターは、Mule アプリケーション、プロパティ、および設定ファイルの設計と更新に役立ちます。

Studio でコネクタを追加および設定する手順は、次のとおりです。

1. Studio で Mule プロジェクトを作成します。
2. **\[Mule Palette (Mule パレット)\]**​ ビューで、​**\[(X) Search in Exchange ((X) Exchange 内を検索)\]**​ をクリックします。
3. **\[Add Dependencies to Project (連動関係をプロジェクトに追加)\]**​ ウィンドウで、検索項目に「​`ldap`​」と入力します。
4. **\[Available modules (使用可能なモジュール)\]**​ で ​**\[LDAP Connector\]**​ をクリックします。
5. **\[Add (追加)\]**​ をクリックします。
6. **\[Finish (完了)\]**​ をクリックします。

Studio でコネクタを Mule プロジェクトに追加しても、Studio ワークスペースの他のプロジェクトはそのコネクタを使用できません。

## [](#config)LDAP Connector のグローバル要素を設定する

Mule アプリケーションで LDAP Connector を使用するには、グローバル LDAP 設定要素を設定する必要があります。グローバル要素は、アプリケーションで必要となる任意の数の LDAP Connector で使用できます。このコネクタは、基本設定ではサーバー側のプーリングをサポートします。これは、\[Pooling (プーリング)\] セクションで設定できます。

1. キャンバスの下部にある ​**\[Global Elements (グローバル要素)\]**​ タブをクリックします。
2. \[Global Configuration Elements (グローバル設定要素)\] 画面で、​**\[Create (作成)\]**​ をクリックします。  
    次のウィンドウが表示されます。
    
    ![「Global Element Configuration (グローバル要素設定)」 ウィザード](/mulesoft/current/ja-jp/ldap-connector/3.3/_images/ldap-config-global-wizard.png)
3. \[Choose Global Type (グローバル型の選択)\] ウィザードで、​**\[Connector Configuration (コネクタ設定)\]**​ を展開し、​**\[LDAP Configuration (LDAP 設定)\]**​ を選択し、​**\[OK\]**​ をクリックします。  
    次のウィンドウが表示されます。
    
    ![「Global Element Properties (グローバル要素のプロパティ)」](/mulesoft/current/ja-jp/ldap-connector/3.3/_images/ldap-configs.png)
4. ドロップダウンリストから \[Basic configuration (基本設定)\] または \[TLS configuration (TLS 設定)\] を選択し、そのプロパティを設定します。
    
    <table class="tableblock frame-all grid-all" style="width: 80%;">
<colgroup>
<col style="width: 30%;">
<col style="width: 70%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">パラメーター</th>
<th class="tableblock halign-left valign-top">説明</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Name (名前)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>コネクタの参照に使用される名前。</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Principal DN (プリンシパル DN)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>ユーザーの DN (識別名)</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Password (パスワード)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>ユーザーのパスワード</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Authentication (認証)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>使用する認証メカニズムを指定します。デフォルト値は ​<code>Simple</code>​ です。</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>URL</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>LDAP サーバーへの接続 URL</p>
</div></div></td>
</tr>
</tbody>
</table>
    
    上の画像では、プレースホルダーの値は、プロジェクトの ​`src/main/resources`​ フォルダーにある設定ファイル ​`mule-artifact.properties`​ を参照します。 ログイン情報をグローバル設定プロパティに入力するか、それらの値を含む設定ファイルを参照することができます。
    
    ログイン情報をグローバル設定プロパティにハードコードすることもできますが、その値が含まれる設定ファイルを代わりに参照した場合、メンテナンスを簡略化し、プロジェクトの再利用性を向上できます。これらの値を別個のファイルに保存しておくと、アクセスログイン情報が異なるさまざまな環境 (本番、開発、QA など) にデプロイする必要がある場合に便利です。
5. \[Advanced (詳細)\] タブと \[Pooling (プーリング)\] タブのデフォルトエントリを保持します。  
    \[Pooling (プーリング)\] タブは、\[Basic configuration (基本設定)\] でのみ使用できます。
6. **\[Test Connection (接続をテスト)\]**​ をクリックして、グローバル設定のパラメーターが正確であることと、Mule が LDAP サーバーのインスタンスに正常に接続できることを確認します。
7. **\[OK\]**​ をクリックして、グローバルコネクタ設定を保存します。

## [](#xml-エディターまたはスタンドアロンで設定する)XML エディターまたはスタンドアロンで設定する

1. 設定ファイルに LDAP 名前空間が含まれていることを確認します。
    
    ```xml
    <mule xmlns:ldap="http://www.mulesoft.org/schema/mule/ldap"
    	xmlns="http://www.mulesoft.org/schema/mule/core"
    	xmlns:doc="http://www.mulesoft.org/schema/mule/documentation"
    	xmlns:spring="http://www.springframework.org/schema/beans"
    	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    	xsi:schemaLocation="http://www.springframework.org/schema/beans
    	http://www.springframework.org/schema/beans/spring-beans-current.xsd
    	http://www.mulesoft.org/schema/mule/core
    	http://www.mulesoft.org/schema/mule/core/current/mule.xsd
    	http://www.mulesoft.org/schema/mule/ldap
    	http://www.mulesoft.org/schema/mule/ldap/current/mule-ldap.xsd">
    
    <!-- Put your flows and configuration elements here -->
    </mule>
    ```
2. 次の設定コードを使用して、LDAP の基本設定のグローバル要素を作成します。
    
    ```xml
    	<ldap:config name="LDAP_Configuration" doc:name="LDAP Configuration">
    		<ldap:basic-connection authDn="${config.principal.dn}"
    			authPassword="${config.password}" url="${config.url}">
    			<ldap:extended-configurations>
             <ldap:extended-configuration key="key.name" value="key.value" />
             </ldap:extended-configuration>
          </ldap:extended-configurations>
    		</ldap:basic-connection>
    	</ldap:config>
    ```
3. XML ファイルに対する変更を保存します。

## [](#using-the-connector)コネクタの使用

LDAP Connector は次の操作をサポートしています。

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 30%;">
<col style="width: 70%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">操作</th>
<th class="tableblock halign-left valign-top">説明</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Bind</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>LDAP サーバーに対して認証します。これは、各操作の前に自動的に行われますが、要求に応じて実行することもできます。</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Search</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>指定された検索条件を使用して、ベース DN で LDAP 検索を実行します。</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Search one</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>一意の結果を返すことが想定される LDAP 検索を実行します。</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Paged result search</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>LDAP 検索を実行し、結果をフローの残りの部分に流し込みます。</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Lookup</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>一意の LDAP エントリを取得します。</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Exists</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>LDAP エントリが LDAP サーバーに存在するかどうかを確認します。</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Add</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>新しい LDAP エントリを作成します。</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Add single-valued attribute</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>特定の単一値属性を既存の LDAP エントリに追加します。</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Add multi-valued attribute (複数値属性を追加)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>特定の複数値属性を既存の LDAP エントリに追加します。</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Modify</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>既存の LDAP エントリを更新します。</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Modify single-valued attribute (単一値属性を変更)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>既存の LDAP エントリの特定の単一値属性を更新します。</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Modify multi-valued attribute (複数値属性を変更)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>既存の LDAP エントリの特定の複数値属性を更新します。</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Delete (削除)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>既存の LDAP エントリを削除します。</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Delete single-valued attribute (単一値属性を削除)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>既存の LDAP エントリの特定の単一値属性を削除します。</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Delete multi-valued attribute (複数値属性を削除)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>既存の LDAP エントリの特定の複数値属性を削除します。</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Rename</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>既存の LDAP エントリの名前を変更します。</p>
</div></div></td>
</tr>
</tbody>
</table>

### [](#namespace-schema)コネクタの名前空間とスキーマ

Studio でアプリケーションを設計するときに、コネクタをパレットから Anypoint Studio キャンバスにドラッグすると、XML コードにコネクタの名前空間とスキーマの場所が自動的に入力されます。

名前空間: `http://www.mulesoft.org/schema/mule/ldap`

スキーマの場所: `http://www.mulesoft.org/schema/mule/ldap/current/mule-ldap.xsd`

<table><tbody><tr><td class="icon"><i class="fa icon-tip" title="Tip"></i></td><td class="content">Studio の XML エディターまたはその他のテキストエディターで手動でコーディングを行う場合は、これらを設定 XML の ​<code>&lt;mule&gt;</code>​ タグの内部に貼り付けてください。</td></tr></tbody></table>

```xml
<mule xmlns:ldap="http://www.mulesoft.org/schema/mule/ldap" xmlns="http://www.mulesoft.org/schema/mule/core"
	xmlns:doc="http://www.mulesoft.org/schema/mule/documentation"
	xmlns:spring="http://www.springframework.org/schema/beans"
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-current.xsd
http://www.mulesoft.org/schema/mule/core http://www.mulesoft.org/schema/mule/core/current/mule.xsd
http://www.mulesoft.org/schema/mule/ldap http://www.mulesoft.org/schema/mule/ldap/current/mule-ldap.xsd">

      <!-- put your global configuration elements and flows here -->

</mule>
```

## [](#use-cases-and-demos)ユースケースとデモ

LDAP Connector の最も一般的なユースケースとデモアプリケーションウォークスルーを次に示します。

<table class="tableblock frame-all grid-all fit-content">
<colgroup>
<col>
<col>
</colgroup>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Active Directory へのユーザーアカウントの追加</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">ビジネスユーザーアカウントをベース DN で定義された Active Directory グループに追加できます。</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">ユーザー属性の取得</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">ビジネスユーザーの基本属性を 1 つ以上の目的のために取得できます (メールや電話など)。</p></td>
</tr>
</tbody>
</table>

### [](#adding-to-a-flow)フローを追加する

1. Anypoint Studio で新しい Mule プロジェクトを作成します。
2. 適切な Mule インバウンドエンドポイント (HTTP リスナーなど) をフローの先頭に追加します。
3. LDAP Connector の任意の操作 (Add entry 操作など) をドラッグしてキャンバスにドロップします。
4. コネクタをクリックして、プロパティエディターを開きます。
    
    ![フローの設定](/mulesoft/current/ja-jp/ldap-connector/3.3/_images/ldap-usecase-settings.png)
5. 次のパラメーターを設定します。
    
    <table class="tableblock frame-all grid-all fit-content">
<colgroup>
<col>
<col>
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">説明</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Display Name (表示名)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">アプリケーションでの LDAP 操作の一意の表示ラベルを入力します。</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top" colspan="2"><p class="tableblock">Basic Settings (基本設定)</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Connector configuration (コネクタ設定)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">このコネクタにリンクされているグローバル要素に接続します。グローバル要素は、対象リソースまたはサービスへの接続に関する再利用可能なデータをカプセル化します。作成したグローバル LDAP Connector 要素を選択します。</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top" colspan="2"><p class="tableblock">General (一般)</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Entry (エントリ)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">#[payload]。これは、前のコンポーネント (通常は DataWeave コンポーネント) で作成され、このプロセッサーへの入力ペイロードとして変換された LDAPEntry オブジェクトを参照します。</p></td>
</tr>
</tbody>
</table>
6. \[Structural object class (構造オブジェクトクラス)\] テキスト項目の直後にある更新ボタンをクリックして、構造オブジェクトクラスに基づくメタデータを取得します。これによって、ディレクトリ情報ツリーがトラバースされ、階層とそれが継承するすべてのプロパティが取得されます。

### [](#example-use-case)LDAP Connector を使用したユースケース例 1

組織の個人を組織の部署に追加または削除します。

![ユーザーエントリ追加フロー](/mulesoft/current/ja-jp/ldap-connector/3.3/_images/ldap-usecase-flow.png)

1. Anypoint Studio で新しい Mule プロジェクトを作成します。
2. 次のプロパティを ​`mule-artifact.properties`​ ファイルに追加して LDAP ログイン情報を保持し、このファイルをプロジェクトの ​`src/main/resources`​ ディレクトリに置きます。
    
    ```text
    config.principal.dn=<DN>
    config.password=<Password>
    config.url=<URL>
    ```
3. \[HTTP Listener (HTTP リスナー)\] をキャンバスにドラッグし、次のパラメーターを設定します。
    
    <table class="tableblock frame-all grid-all fit-content">
<colgroup>
<col>
<col>
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">パラメーター</th>
<th class="tableblock halign-left valign-top">値</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Display Name (表示名)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">HTTP</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Connector configuration (コネクタ設定)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">まだ HTTP 要素が作成されていない場合、プラス記号をクリックして新しい HTTP リスナー設定を追加し、​<strong>[OK]</strong>​ をクリックします。デフォルトのままにします。</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Path (パス)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">/</p></td>
</tr>
</tbody>
</table>
4. DataWeave コンポーネントを使用して組織の部署エントリを作成します。\[DataWeave\] コンポーネントを \[HTTP Listener (HTTP リスナー)\] の横にドラッグし、次のスクリプトを使用します。
    
    ```java
    %dw 2.0
    output application/java
    ---
    {
    	dn : "ou=DevOpsGroup," ++ attributes.queryParams.dn,
    	ou : "DevOpsGroup",
    	objectclass : ["top", "organizationalUnit"]
    }
    ```
5. LDAP Connector の \[Add entry\] 操作を \[DataWeave\] コンポーネントの横にドラッグして、LDAP エントリを追加します。
6. 新しい LDAP グローバル要素を追加することで LDAP Connector を設定します。\[Connector Configuration (コネクタ設定)\] 項目の横にあるプラス記号をクリックします。
    
    1. 以下の表に従ってグローバル要素を設定します。
        
        <table class="tableblock frame-all grid-all fit-content">
<colgroup>
<col>
<col>
<col>
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">パラメーター</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">Value (値)</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">名前</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">参照する設定の名前を入力します。</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">&lt;Configuration_Name&gt;</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Principal DN (プリンシパル DN)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">ユーザーの DN (識別名)。</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>${config.principal.dn}</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Password (パスワード)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">ユーザーのパスワード。</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>${config.password}</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">URL</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">LDAP サーバーへの接続 URL。</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>${config.url}</code></p></td>
</tr>
</tbody>
</table>
    2. 対応する XML 設定は次のようになります。
        
        ```xml
        	<ldap:config name="LDAP_Configuration" doc:name="LDAP Configuration">
        		<ldap:basic-connection authDn="${config.principal.dn}"
        			authPassword="${config.password}" url="${config.url}">
              <ldap:extended-configurations>
                 <ldap:extended-configuration key="key.name" value="key.value" />
                 </ldap:extended-configuration>
              </ldap:extended-configurations>
        		</ldap:basic-connection>
        	</ldap:config>
        ```
7. **\[Test Connection (接続をテスト)\]**​ をクリックして、Mule が LDAP サーバーインスタンスに接続できることを確認します。
8. 正常に接続できた場合は、​**\[OK\]**​ をクリックして設定を保存します。  
    そうでない場合は、見直して、誤ったパラメーターを修正してからもう一度テストします。
9. LDAP Connector のプロパティエディターに戻り、Add entry 操作に必要なパラメーターを設定します。
    
    <table class="tableblock frame-all grid-all fit-content">
<colgroup>
<col>
<col>
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">パラメーター</th>
<th class="tableblock halign-left valign-top">値</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Display Name (表示名)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Add Group Entry to LDAP Directory (LDAP ディレクトリへのグループエントリの追加)</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top" colspan="2"><p class="tableblock">Basic Settings (基本設定)</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Connector configuration (コネクタ設定)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">作成したグローバル LDAP Connector 要素を選択します。</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top" colspan="2"><p class="tableblock">General (一般)</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Entry (エントリ)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">#[payload]。デフォルト値です。</p></td>
</tr>
</tbody>
</table>
10. DataWeave コンポーネントを使用して組織の個人エントリを作成します。\[DataWeave\] コンポーネントを \[LDAP Connector\] の横にドラッグし、次のスクリプトを使用します。
    
    ```java
    %dw 2.0
    output application/java
    ---
    {
    	dn : "cn=Test User,ou=DevOpsGroup," ++ attributes.queryParams.dn,
    	uid : "testUser",
    	cn : "Test User",
    	sn : "User",
    	userPassword : "test1234",
    	objectclass : ["top", "person", "organizationalPerson", "inetOrgPerson"]
    }
    ```
11. LDAP Connector の ​**\[Add entry\]**​ 操作を \[DataWeave\] コンポーネントの横にドラッグして、LDAP ユーザーエントリを追加します。
12. LDAP Connector のプロパティエディターで、次のようにパラメーターを設定します。
    
    <table class="tableblock frame-all grid-all fit-content">
<colgroup>
<col>
<col>
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">パラメーター</th>
<th class="tableblock halign-left valign-top">値</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Display Name (表示名)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Add User Entry to LDAP Directory (LDAP ディレクトリへのユーザーエントリの追加)</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top" colspan="2"><p class="tableblock">Basic Settings (基本設定)</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Connector configuration (コネクタ設定)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">作成したグローバル LDAP Connector 要素を選択します。</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top" colspan="2"><p class="tableblock">General (一般)</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Entry (エントリ)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">#[payload]。デフォルト値です。</p></td>
</tr>
</tbody>
</table>
13. これでエントリを正常に追加できたので、LDAP Connector を使用してエントリを削除してみましょう。
14. **\[Delete entry (エントリの削除)\]**​ 操作を \[LDAP Connector\] の横にドラッグして、LDAP ユーザーエントリを削除します。
15. LDAP Connector のプロパティエディターで、次のようにパラメーターを設定します。
    
    <table class="tableblock frame-all grid-all fit-content">
<colgroup>
<col>
<col>
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">パラメーター</th>
<th class="tableblock halign-left valign-top">値</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Display Name (表示名)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Delete User Entry from LDAP Directory (LDAP ディレクトリからのユーザーエントリの削除)</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top" colspan="2"><p class="tableblock">Basic Settings (基本設定)</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Connector configuration (コネクタ設定)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">作成したグローバル LDAP Connector 要素を選択します。</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top" colspan="2"><p class="tableblock">General (一般)</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">DN</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>#['cn=Test User,ou=DevOpsGroup,' ++ attributes.queryParams.dn]</code></p></td>
</tr>
</tbody>
</table>
16. もう 1 つの ​**\[Delete entry (エントリの削除)\]**​ 操作を \[LDAP Connector\] の横にドラッグして、LDAP グループエントリを削除します。
    
    <table class="tableblock frame-all grid-all fit-content">
<colgroup>
<col>
<col>
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">パラメーター</th>
<th class="tableblock halign-left valign-top">値</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Display Name (表示名)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Delete Group Entry From LDAP Directory (LDAP ディレクトリからのグループエントリの削除)</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top" colspan="2"><p class="tableblock">Basic Settings (基本設定)</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Connector configuration (コネクタ設定)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">作成したグローバル LDAP Connector 要素を選択します。</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top" colspan="2"><p class="tableblock">General (一般)</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">DN</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>#['ou=DevOpsGroup,' ++ attributes.queryParams.dn]</code></p></td>
</tr>
</tbody>
</table>
17. \[DataWeave\] コンポーネントを \[LDAP Connector\] の横にドラッグし、ペイロードを「Flow Successfully Completed」 (フロー正常完了) に設定します。

### [](#example-code)ユースケース 1 のコード

このユースケース例のフローをすばやく Mule アプリケーションに読み込むには、次のコードを XML エディターに貼り付けます。

```xml
<?xml version="1.0" encoding="UTF-8"?>

<mule xmlns:ee="http://www.mulesoft.org/schema/mule/ee/core"
	xmlns:ldap="http://www.mulesoft.org/schema/mule/ldap"
	xmlns:http="http://www.mulesoft.org/schema/mule/http"
	xmlns="http://www.mulesoft.org/schema/mule/core"
	xmlns:doc="http://www.mulesoft.org/schema/mule/documentation"
	xmlns:spring="http://www.springframework.org/schema/beans"
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xsi:schemaLocation="http://www.springframework.org/schema/beans
	http://www.springframework.org/schema/beans/spring-beans-current.xsd
	http://www.mulesoft.org/schema/mule/core
	http://www.mulesoft.org/schema/mule/core/current/mule.xsd
	http://www.mulesoft.org/schema/mule/http
	http://www.mulesoft.org/schema/mule/http/current/mule-http.xsd
	http://www.mulesoft.org/schema/mule/ldap
	http://www.mulesoft.org/schema/mule/ldap/current/mule-ldap.xsd
	http://www.mulesoft.org/schema/mule/ee/core
	http://www.mulesoft.org/schema/mule/ee/core/current/mule-ee.xsd">


	<http:listener-config name="HTTP_Listener_config"
		doc:name="HTTP Listener config">
		<http:listener-connection host="127.0.0.1"
			port="8081" />
	</http:listener-config>

	<ldap:config name="LDAP_Configuration" doc:name="LDAP Configuration">
		<ldap:basic-connection authDn="${config.principal.dn}"
			authPassword="${config.password}" url="${config.url}">
      <ldap:extended-configurations>
         <ldap:extended-configuration key="key.name" value="key.value" />
         </ldap:extended-configuration>
      </ldap:extended-configurations>
		</ldap:basic-connection>
	</ldap:config>

	<flow name="ldap-add-entry-flow">
		<http:listener config-ref="HTTP_Listener_config" path="/"
			doc:name="HTTP" />

		<ee:transform doc:name="DataWeave to Create DevOps Group Object">
			<ee:message>
				<ee:set-payload><![CDATA[%dw 2.0
output application/java
---
{
	dn : "ou=DevOpsGroup," ++ attributes.queryParams.dn,
	ou : "DevOpsGroup",
	objectclass : ["top", "organizationalUnit"]
}
]]></ee:set-payload>
			</ee:message>
		</ee:transform>

		<ldap:add config-ref="LDAP_Configuration"
			doc:name="Add Group Entry to LDAP Directory" />


		<ee:transform doc:name="DataWeave to Create User Object">
			<ee:message>
				<ee:set-payload><![CDATA[%dw 2.0
output application/java
---
{
	dn : "cn=Test User,ou=DevOpsGroup," ++ attributes.queryParams.dn,
	uid : "testUser",
	cn : "Test User",
	sn : "User",
	userPassword : "test1234",
	objectclass : ["top", "person", "organizationalPerson", "inetOrgPerson"]
}
]]></ee:set-payload>
			</ee:message>
		</ee:transform>


		<ldap:add config-ref="LDAP_Configuration"
			doc:name="Add User Entry to LDAP Directory" />

		<ldap:delete config-ref="LDAP_Configuration"
			dn="#['cn=Test User,ou=DevOpsGroup,' ++ attributes.queryParams.dn]"
			doc:name="Delete User Entry from LDAP Directory" />

		<ldap:delete config-ref="LDAP_Configuration"
			dn="#['ou=DevOpsGroup,' ++ attributes.queryParams.dn]"
			doc:name="Delete Group Entry from LDAP Directory" />

		<ee:transform doc:name="DataWeave to set Payload indicating flow completed">
			<ee:message>
				<ee:set-payload><![CDATA[%dw 2.0
output application/json
---
{
	result : "Flow Successfully Completed"
}
]]></ee:set-payload>
			</ee:message>
		</ee:transform>
	</flow>


</mule>
```

### [](#example-use-case2)LDAP Connector を使用したユースケース例 2

カスタムトラストストアを設定することで、どのサーバーへの通信が許可されるかを識別できます。

そのために、拡張設定パラメーターを使用してカスタムトラストストアを指定できます。

上のユースケース 1 と同じものを使用してこれを実行できますが、LDAP Connector の設定部分に TLS 設定を使用するということが異なります。

次の LDAP Connector 用の XML 設定スニペットでは TLS 設定を使用しています。これを使用して上のユースケース 1 の XML ファイルを更新します。

```xml
<ldap:config name="LDAP_Configuration" doc:name="LDAP Configuration">
<ldap:tls-connection authDn="${config.principal.dn}"
        authPassword="${config.password}" url="${config.url}">
    <ldap:extended-configurations>
        <ldap:extended-configuration
        	key="org.mule.module.ldap.trustStorePath"
        	value="the_path_to_trust_store_jks_file" />
        <ldap:extended-configuration
        	key="org.mule.module.ldap.trustStorePassword"
        	value="changeit" />
    </ldap:extended-configurations>
</ldap:tls-connection>
</ldap:config>
```

### [](#run-time)デモアプリケーションの実行

1. プロジェクトを保存し、Mule アプリケーションとして実行します。
2. Web ブラウザーを開き、次の URL を入力して応答を確認します。
    
    `http://localhost:8081/?dn=dc=mulesoft,dc=org`​。

## [](#関連情報)関連情報

[MuleSoft ヘルプセンター](https://help.mulesoft.com)