Anypoint Code Builder を使用した HTTP Connector の設定

Unresolved include directive in modules/ROOT/pages/http-connector-config-acb.adoc - include::connectors::partial$configure-acb-connectors-partial.adoc[]

新しいインテグレーションプロジェクトの作成

Unresolved include directive in modules/ROOT/pages/http-connector-config-acb.adoc - include::connectors::partial$configure-acb-connectors-partial.adoc[]

インテグレーションプロジェクトへのコネクタの追加

Unresolved include directive in modules/ROOT/pages/http-connector-config-acb.adoc - include::connectors::partial$configure-acb-connectors-partial.adoc[]

フローのトリガーの設定

Unresolved include directive in modules/ROOT/pages/http-connector-config-acb.adoc - include::connectors::partial$configure-acb-connectors-partial.adoc[]

XML でのコネクタの設定

Unresolved include directive in modules/ROOT/pages/http-connector-config-acb.adoc - include::connectors::partial$acb-xml-maven-partial.adoc[] Unresolved include directive in modules/ROOT/pages/http-connector-config-acb.adoc - include::connectors::partial$acb-xml-maven-partial.adoc[] Unresolved include directive in modules/ROOT/pages/http-connector-config-acb.adoc - include::connectors::partial$acb-xml-maven-partial.adoc[]

プロジェクトへのコンポーネントの追加

Unresolved include directive in modules/ROOT/pages/http-connector-config-acb.adoc - include::connectors::partial$configure-acb-connectors-partial.adoc[]

グローバル設定の追加

Unresolved include directive in modules/ROOT/pages/http-connector-config-acb.adoc - include::connectors::partial$configure-acb-connectors-partial.adoc[]

コネクタの認証の設定

HTTP 用 Anypoint Connector (HTTP Connector) の ​Request​ 操作は、Mule クライアントアプリケーションと、次のいずれかの種別の認証が必要なサービスとの接続をサポートします。

  • 基本認証

  • ダイジェスト認証

  • NTLM 認証

  • OAuth2 認証コード許可種別認証

HTTP XML 認証のセットアップ

XML エディターで HTTP Connector の認証を設定します。以下は、HTTP Connector の認証の XML 値です。

認証種別 XML 値

基本認証

<http:authentication >
  <http:basic-authentication
  username="UN" password="PW"/>
</http:authentication>

NTLM Authentication

<http:authentication >
  <http:ntlm-authentication
  domain="DM" workstation="WS"
  username="UN" password="PW" />
</http:authentication>

ダイジェスト認証

<http:authentication >
  <http:digest-authentication
  username="UN" password="PW"/>
</http:authentication>

OAuth 2.0

<http:listener-config name="HTTP_Listener_Configuration"
                      host="0.0.0.0" port="8081" basePath="/github"/>
<http:request-config name="HTTP_Request_Configuration"
                     protocol="HTTPS" host="api.github.com" port="443">
    <http:authentication>
        <oauth:authorization-code-grant-type
        externalCallbackUrl="http://myapp.mycompany.com:8082/callback"
        localAuthorizationUrl="http://localhost:8082/login"
        authorizationUrl="https://github.com/login/oauth/authorize"
        clientId="CLIENT_ID"
        clientSecret="CLIENT_SECRET"
        tokenUrl="https://github.com/login/oauth/access_token" />
    </http:authentication>
</http:request-config>

コンポーネント属性の設定

Unresolved include directive in modules/ROOT/pages/http-connector-config-acb.adoc - include::connectors::partial$configure-acb-connectors-partial.adoc[]

HTTP リスナーの設定

HTTP 用 Anypoint Connector (HTTP Connector) の ​Listener​ コンポーネントでは、HTTP サーバーをセットアップして、HTTP 要求を受信したらフローをトリガーすることができます。

UI で HTTP の ​Listener​ 属性を設定するには、​「フローのトリガーの設定」​を参照してください。

基本セキュリティ検索条件を設定する

Basic security filter​ コンポーネントは受信した HTTP 要求を認証します。このコンポーネントはインテグレーションフローの ​Listener​ コンポーネントの後で使用します。

  1. キャンバスで ​[Basic security filter]​ コンポーネントをクリックします。

  2. [General (一般)]​ タブで、次の属性を設定します。

    UI 項目 説明 必須

    Realm (レルム)

    認証レルム。

    はい

    Security Provider (セキュリティプロバイダー)

    この属性は現在設定 UI で有効になっていません。XML エディターで設定してください。​「基本セキュリティ検索条件」​を参照してください。

    いいえ

    Attributes (属性)

    Authorization​ ヘッダーを確認するための HTTP ​Listener​ ソースで定義された HTTP 要求属性。

    いいえ

HTTP 要求を設定する

HTTP 用 Anypoint Connector (HTTP Connector) の ​Request​ 操作を使用すると、デフォルトの ​GET​ メソッドを使用して外部 HTTP サービスをコンシュームできます。それ以外の場合は、操作が受け入れるメソッドを選択できます。

Anypoint Code Builder UI で HTTP ​Request​ の属性を設定する手順は、次のとおりです。

  1. キャンバスで ​[Request]​ コンポーネントをクリックします。

  2. [General (一般)]​ タブで、次の属性を設定します。

    UI 項目 説明 必須

    Method (メソッド)

    すべての HTTP メソッドを許可する (デフォルト) 場合は、この属性を定義しないでください。特定のメソッドを制限するには、許可するすべての HTTP メソッドを ​GET, POST​ のようにカンマ区切りリストとして指定してください。

    いいえ

    URI Settings URL (URI 設定 URL)

    要求の送信先となる URL。

    いいえ

    URI Settings Path (URI 設定パス)

    要求を送信するパス。

    いいえ

    Request Body (リクエストボディ)

    要求応答メッセージの本文。

    いいえ

    Request Headers (リクエストヘッダー)

    応答メッセージに含めるヘッダー。

    いいえ

    URI パラメーター

    要求の作成に使用する URI パラメーター。

    いいえ

    Query Parameters (クエリパラメーター)

    要求に含めるクエリパラメーター。

    いいえ

    Correlations ID (相関 ID)

    要求にアウトバウンド相関 ID を含めるかどうかが定義されます。

    いいえ

  3. [Advanced (詳細)]​ タブを選択して、次の属性を設定します。

    UI 項目 説明 必須

    Output MIME type (出力 MIME タイプ)

    このコンポーネントで出力されるペイロードの MIME タイプ。

    いいえ

    パラメーター

    リーダープロパティのキー-値ペアが出力 MIME 属性に追加されます。複数のキーと値のペアが許可されます。

    いいえ

    Output encoding (出力エンコード)

    このコンポーネントで出力されるペイロードのエンコード。

    いいえ

    Streaming Strategy (ストリーミング戦略)

    この属性は現在設定 UI で有効になっていません。XML エディターで設定してください。​XML でのストリーミング戦略の設定​を参照してください。

    いいえ

    Follow redirects (リダイレクトをフォロー)

    リダイレクトをフォローするかどうかを示します。

    いいえ

    Send body mode (本文送信モード)

    要求に本文を含めるかどうかが指定されます。動作が定義済みの許可する HTTP メソッドによって決定されるように指定するには ​[Auto (自動)]​ を選択します (​GET​、​HEAD​、​OPTIONS​ では本文が送信されません)。

    いいえ

    Request streaming mode (要求ストリーミングモード)

    要求がストリーミングを使用して送信されるかどうかが定義されます。

    いいえ

    Response timeout (応答タイムアウト)

    要求要素が HTTP 応答を待機中のフローの実行をブロックする最大時間 (ミリ秒) が指定されます。

    いいえ

    Response validator (応答バリデーター)

    要求のデフォルトのエラー処理が設定されます。この属性は現在設定 UI で有効になっていません。XML エディターで設定してください。​「Success Status Code Validator (成功状況コードバリデーター)」​および​「Failure Status Code Validator (失敗状況コードバリデーター)」​を参照してください。

    いいえ

    Target Variable (対象変数)

    操作の出力が配置される変数の名前。

    いいえ

    Target Value (対象値)

    操作の出力に対して評価される式。この式の出力は対象変数に保存されます。

    いいえ

    エラーのマッピング

    この属性は現在有効ではありません。

    いいえ

    Reconnection Strategy (再接続戦略)

    この属性は現在設定 UI で有効になっていません。XML エディターで設定してください。​「Reconnect (再接続)」​、​「Reconnect Forever (繰り返し再接続)」​、および​XML での再接続戦略の設定​を参照してください。

    いいえ

Load Static Resource の設定

この静的リソースにより、HTTP で使用する静的コンテンツが提供されます。要求パスはリソースの検索に使用されます。

Anypoint Code Builder UI で HTTP ​Load static resource​ の属性を設定する手順は、次のとおりです。

  1. キャンバスで ​[Load static resource]​ コンポーネントをクリックします。

  2. [General (一般)]​ タブで、次の属性を設定します。

    UI 項目 説明 必須

    Resource base path (リソースベースパス)

    コンテンツを提供するリソースのベースパス (例えば、​/Users/maxthemule/​ リソース)。

    はい

    Default file (デフォルトファイル)

    ディレクトリが指定されたときに提供するデフォルトファイル。デフォルトは ​index.html​ です。

    いいえ

    Attributes (属性)

    Authorization ヘッダーを確認するための HTTP Listener ソースで定義された HTTP 要求属性。

    いいえ

  3. [Advanced (詳細)]​ タブを選択して、次の属性を設定します。

    UI 項目 説明 必須

    Output MIME type (出力 MIME タイプ)

    このコンポーネントで出力されるペイロードの MIME タイプ。

    いいえ

    パラメーター

    リーダープロパティのキー-値ペアが出力 MIME 属性に追加されます。複数のキーと値のペアが許可されます。

    いいえ

    Output encoding (出力エンコード)

    このコンポーネントで出力されるペイロードのエンコード。

    いいえ

    Target Variable (対象変数)

    操作の出力を保存する変数の名前。

    いいえ

    Target Value (対象値)

    操作の出力を評価する式。式の結果は対象変数に保存されます。

    いいえ

    エラーのマッピング

    この属性は現在有効ではありません。

    いいえ

XML の例

XML での再接続戦略の設定

Unresolved include directive in modules/ROOT/pages/http-connector-config-acb.adoc - include::connectors::partial$acb-xml-examples.adoc[]

XML でのストリーミング戦略の設定

ストリーミング戦略を使用して、Mule によるストリームの処理方法を設定できます。

Unresolved include directive in modules/ROOT/pages/http-connector-config-acb.adoc - include::connectors::partial$acb-xml-examples.adoc[]

HTTP リスナー接続のテスト

Unresolved include directive in modules/ROOT/pages/http-connector-config-acb.adoc - include::connectors::partial$configure-acb-connectors-partial.adoc[]

新しい設定 XML ファイルの作成

Unresolved include directive in modules/ROOT/pages/http-connector-config-acb.adoc - include::connectors::partial$configure-acb-connectors-partial.adoc[]

関連情報

Unresolved include directive in modules/ROOT/pages/http-connector-config-acb.adoc - include::connectors::partial$configure-acb-connectors-partial.adoc[] * HTTP Connector リファレンス * ストリーミング戦略の設定