1. Homepage
  2. A2A Connector (0.3)

  3. Anypoint Studio を使用した A2A Connector の設定

All Connectors

Anypoint Studio を使用した A2A Connector 0.3.0-BETA の設定

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

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

  1. Mule プロジェクトを作成します​。

  2. コネクタを Mule プロジェクトに追加します​。

  3. コネクタのフローのソースを設定します​。

  4. フローにコネクタの操作を追加します​。

  5. コネクタのグローバル要素を設定します​。

  6. その他のコネクタ項目を設定します​。

「アプリケーションログの表示」​で説明されているように、コネクタを実行するときに、リアルタイムでアプリケーションログを表示して問題を確認できます。

Studio で初めてコネクタを設定する場合は、​「Anypoint Studio を使用したコネクタの設定」​を参照してください。このトピックを参照した後、コネクタ項目についての詳細情報が必要な場合は、​「A2A Connector リファレンス」​を参照してください。

Mule プロジェクトを作成する

Studio で、A2A 用 Anypoint Connector (A2A Connector) を追加および設定する新しい Mule プロジェクトを作成します。

  1. Studio で、​[File (ファイル)] > [New (新規)] > [Mule Project (Mule プロジェクト)]​ を選択します。

  2. Mule プロジェクトの名前を入力して、​[Finish (完了)]​ をクリックします。

コネクタを Mule プロジェクトに追加する

A2A Connector を Mule プロジェクトに追加すると、コネクタの名前空間およびスキーマの場所が XML コードに自動的に入力され、必要な連動関係がプロジェクトの ​pom.xml​ ファイルに追加されます。

  1. [Mule Palette (Mule パレット)]​ で、​[(X) Search in Exchange ((X) Exchange 内を検索)]​ をクリックします。

  2. [Add Dependencies to Project (連動関係をプロジェクトに追加)]​ で、検索項目に ​a2a​ を入力します。

  3. [Available modules (使用可能なモジュール)]​ で、​A2A Connector​ をクリックします。

  4. [Add (追加)]​ をクリックします。

  5. [Finish (完了)]​ をクリックします。

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

ソースの設定

ソースは、指定された条件が満たされたときにフローを開始します。 次のソースのいずれかを A2A Connector で使用するように設定できます。

  • Task Listener

    このソースは HTTP リスナーの拡張です。メッセージや API コールなど、エージェントに向けられた受信タスクをリスンします。

  • [HTTP] > [Listener]

    設定されたホストとポートで要求を受信するたびにフローを開始する

  • Scheduler

たとえば、​[HTTP] > [Listener]​ ソースを設定する手順は、次のとおりです。

  1. [Mule Palette (Mule パレット)]​ で、​[HTTP] > [Listener]​ を選択します。

  2. [Listener]​ を Studio キャンバスにドラッグします。

  3. [Listener (リスナー)]​ 設定画面で、必要に応じて ​[Display Name (表示名)]​ 項目の値を変更します。

  4. [Path (パス)]​ 項目の値を指定します。

  5. [Connector configuration (コネクタ設定)]​ 項目の横にあるプラス記号 (​+​) をクリックして、アプリケーション内の ​[HTTP] > [Listener]​ ソースのすべてのインスタンスで使用できるグローバル要素を設定します。

  6. [General (一般)]​ タブで、コネクタの接続情報を指定します。

  7. [TLS]​ タブで、必要に応じてコネクタの TLS 情報を指定します。

  8. [Advanced (詳細)]​ タブで、必要に応じて再接続戦略を含む再接続情報を指定します。

  9. [Test Connection (接続をテスト)]​ をクリックして、Mule が指定されたサーバーに接続できることを確認します。

  10. [OK]​ をクリックします。

フローにコネクタの操作を追加する

フローにコネクタの操作を追加するときは、そのコネクタで実行するアクションを指定しています。

A2A Connector の操作を追加する手順は、次のとおりです。

  1. [Mule Palette (Mule パレット)]​ で、​[A2A]​ を選択し、目的の操作を選択します。

  2. その操作を Studio キャンバスのソースの横にドラッグします。

コネクタのグローバル要素を設定する

コネクタを設定する場合、アプリケーション内のそのコネクタのすべてのインスタンスで使用できるグローバル要素を設定します。グローバル要素を設定するには、コネクタが対象の A2A システムにアクセスするために必要な認証ログイン情報を指定する必要があります。

ANT スタイルのプロパティプレースホルダーを含む設定ファイルを参照するか (推奨)、グローバル設定プロパティに認証ログイン情報を入力できます。プロパティプレースホルダーを使用する利点とその設定方法については、​「Anypoint Connector 設定」​を参照してください。

A2A Connector のグローバル要素を設定する手順は、次のとおりです。

  1. Studio キャンバスで操作を選択します。

  2. 操作のプロパティ画面で、[Add (追加)] (​+​) アイコンをクリックして、グローバル要素設定項目にアクセスします。

  3. [General (一般)]​ タブの ​[Connection (接続)]​ で、設定する認証方式を選択します。

  1. [TLS]​ タブで、必要に応じてコネクタの TLS 情報を指定します。

  2. [Advanced (詳細)]​ タブで、必要に応じて再接続戦略を含む再接続情報を指定します。

  3. [Test Connection (接続をテスト)]​ をクリックして、Mule が指定されたサーバーに接続できることを確認します。

  4. [OK]​ をクリックします。

Expression or Bean Reference (式または bean 参照)

DataWeave 式または bean 参照を使用して、認証を定義します。

[Global Element Properties (グローバル要素のプロパティ)]​ 画面に認証情報を入力します。

  1. [General (一般)] > [Authentication (認証)] > [Expression or Bean reference (式または bean 参照)]​ を選択して、DataWeave 式を入力します。

  2. [OK]​ をクリックします。

基本認証

基本認証は、クライアントがユーザー名とパスワードを HTTP 認証ヘッダー内のプレーンテキスト (Base64 でエンコード) で送信するシンプルな (安全性が低い) 認証スキームです。

[Global Element Properties (グローバル要素のプロパティ)]​ 画面に基本認証情報を入力します。

  1. [General (一般)] > [Authentication (認証)] > [Basic authentication (基本認証)]​ を選択して、次の項目に入力するか設定します。

    項目 ユーザーアクション

    Username (ユーザー名)

    セッションの初期化に使用するユーザー名。

    Password (パスワード)

    ユーザーの認証に使用するパスワード。

    Preemptive (プリエンプティブ)

    true に設定すると、クライアントはサーバーがクライアントにチャレンジ (401 未承認) するのを待たずに、認証ログイン情報 (ユーザー名とパスワード) をサーバーへの初期 HTTP 要求と共に送信します。

  2. [OK]​ をクリックします。

ダイジェスト

ダイジェストは、チャレンジレスポンスメカニズムを使用してパスワードをプレーンテキストで送信することを回避する、HTTP 認証スキームです。

[Global Element Properties (グローバル要素のプロパティ)]​ 画面にダイジェスト認証情報を入力します。

  1. [General (一般)] > [Authentication (認証)] > [Digest authentication (ダイジェスト認証)]​ を選択して、次の項目に入力するか設定します。

    項目 ユーザーアクション

    Username (ユーザー名)

    セッションの初期化に使用するユーザー名。

    Password (パスワード)

    ユーザーの認証に使用するパスワード。

    Preemptive (プリエンプティブ)

    true に設定すると、クライアントはサーバーがクライアントにチャレンジ (401 未承認) するのを待たずに、認証ログイン情報 (ユーザー名とパスワード) をサーバーへの初期 HTTP 要求と共に送信します。

  2. [OK]​ をクリックします。

NTLM

NTLM 認証は、主に Windows 環境で使用される Microsoft 認証プロトコルです。チャレンジレスポンスメカニズムを使用し、ネットワーク認証で一般的に使用されます。

[Global Element Properties (グローバル要素のプロパティ)]​ 画面に NTLM 認証情報を入力します。

  1. [General (一般)] > [Authentication (認証)] > [Ntlm authentication (NTLM 認証)]​ を選択して、次の項目に入力するか設定します。

    項目 ユーザーアクション

    Domain (ドメイン)

    プロキシドメインの名前。

    Workstation (ワークステーション)

    プロキシワークステーションの名前。

    Username (ユーザー名)

    セッションの初期化に使用するユーザー名。

    Password (パスワード)

    ユーザーの認証に使用するパスワード。

    Preemptive (プリエンプティブ)

    true に設定すると、クライアントはサーバーがクライアントにチャレンジ (401 未承認) するのを待たずに、認証ログイン情報 (ユーザー名とパスワード) をサーバーへの初期 HTTP 要求と共に送信します。

  2. [OK]​ をクリックします。

その他のコネクタ項目の設定

A2A Connector のグローバル要素を設定したら、コネクタの他の必須項目を設定します。必須項目は、使用するコネクタ操作によって異なります。

アプリケーションログの表示

問題を確認するため、アプリケーションログを次の方法で表示できます。

  • アプリケーションを Anypoint Platform から実行している場合、アプリケーションログ出力は Anypoint Studio のコンソールウィンドウに表示されます。

  • コマンドラインから Mule を使用してアプリケーションを実行している場合、アプリケーションログ出力はオペレーティングシステムコンソールに表示されます。

アプリケーションのログファイル (​log4j2.xml​) でログファイルパスがカスタマイズされていない場合、デフォルトの場所 ​MULE_HOME/logs/<app-name>.log​ でアプリケーションログを表示することもできます。ログパスは、アプリケーションログファイル ​log4j2.xml​ で設定できます。

関連情報