1. Homepage
  2. Web Service Consumer Connector (1.10)

  3. Web Service Consumer Connector リファレンス

All Connectors

Web Service Consumer Connector リファレンス - Mule 4

Web Service Consumer Connector バージョン 1.10

Web サービスコンシューマー用 Anypoint Connector (Web Service Consumer Connector) は、SOAP Web サービスをコンシュームして外部ソースからデータを取得します。

リリースノート: Web サービスコンシューマーリリースノート

設定

設定

デフォルト設定

パラメーター

名前 型 説明 デフォルト値 必須

Name (名前)

String (文字列)

この設定の名前。コネクタはこの名前の設定を参照します。

x

Connection (接続)

Connection (接続)

この設定に指定する接続型。

x

Expiration Policy (有効期限ポリシー)

Expiration Policy (有効期限ポリシー)

動的設定インスタンスがアイドル状態を続けられる最小時間を設定します。この時間が経過すると、Mule Runtime で期限切れに相当するとみなされます。

接続種別

Connection (接続)

WscSoapClient のインスタンスを返す ConnectionProvider。

パラメーター
名前 型 説明 デフォルト値 必須

Soap Version (SOAP バージョン)

Enumeration (列挙)。次のいずれかになります。

  • SOAP11

  • SOAP12

WSDL の SOAP バージョン。

SOAP11

Mtom Enabled (MTOM 有効)

Boolean (ブール)

MTOM プロトコルを使用して添付ファイルを管理する必要があるかどうか。

false

Encoding (エンコード)

String (文字列)

すべてのメッセージで使用するデフォルトの文字エンコード。指定しない場合、Mule 設定のデフォルトの文字セットが使用されます。

Transport Configuration (トランスポート設定)

次のいずれかになります。

SOAP メッセージのディスパッチに使用されるトランスポート設定。

Wsdl Location (WSDL の場所)

String (文字列)

WSDL ファイルの URL、リモートまたはローカル。

x

API を使用した

String (文字列)

サービス名。

x

Port (ポート)

String (文字列)

ポート名。

x

Address (住所)

String (文字列)

Web サービスのアドレス。

Reconnection (再接続)

[Reconnection]

アプリケーションがデプロイされると、すべてのコネクタで接続テストが実行されます。true に設定されている場合、関連する再接続戦略をすべて実行した後にテストに合格しないと、デプロイメントが失敗します。

Sign Security Strategy (署名セキュリティ戦略)

WSS Sign Security Strategy Adapter (WSS 署名セキュリティ戦略アダプター)

署名 WSS 設定

Verify Signature Security Strategy (署名検証セキュリティ戦略)

WSS Verify Signature Security Strategy Adapter (WSS 署名検証セキュリティ戦略アダプター)

署名検証 WSS 設定

Username Token Security Strategy (ユーザー名トークンセキュリティ戦略)

Wss Username Token Security Strategy Adapter (WSS ユーザー名トークンセキュリティ戦略アダプター)

usernameToken WSS 設定

Outgoing Timestamp Security Strategy (送信タイムスタンプセキュリティ戦略)

WSS Timestamp Security Strategy Adapter (WSS タイムスタンプセキュリティ戦略アダプター)

タイムスタンプ WSS 設定

Decrypt Security Strategy (復号化セキュリティ戦略)

WSS Decrypt Security Strategy (WSS 復号化セキュリティ戦略)

復号化 WSS 設定

Encrypt Security Strategy (暗号化セキュリティ戦略)

WSS Encrypt Security Strategy Adapter (WSS 暗号化セキュリティ戦略アダプター)

暗号化 WSS 設定

Incoming Timestamp Security Strategy (受信タイムスタンプセキュリティ戦略)

WSS Incoming Timestamp Security Strategy Adapter (WSS 受信タイムスタンプセキュリティ戦略アダプター)

タイムスタンプ検証 WSS 設定

Must Understand (理解が必要)

Boolean (ブール)

wsse:Security ヘッダーの mustUnderstand 属性が true であるか false であるか。 デフォルトは true です。TODO (W-11800462): 次回のメジャー (v2.0.0) では、SOAP プロトコル標準に合わせてデフォルト値を false にする必要があります。

true

Actor (アクター)

String (文字列)

メッセージパスと共に異なるエンドポイントを渡して、SOAP メッセージを送信者から受信者に転送できます。SOAP の [actor (アクター)] 属性を使用して、wsse:Security ヘッダーのアドレスを特定のエンドポイントに設定できます。 このパラメーターの値は URI である必要があります。

Security Headers Order (セキュリティヘッダーの順序)

Enumeration (列挙)。次のいずれかになります。

  • TimestampAtEnd

  • TimestampAtStart

送信 WS-Security タグの順序を選択します。

サポートされている操作

操作

Consume

<wsc:consume>

SOAP Web サービスから操作をコンシュームします。

パラメーター

名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Operation (操作)

String (文字列)

呼び出す Web サービス操作の名前。

x

Body (本文)

Binary (バイナリ)

SOAP メッセージに含める XML 本文。必要なパラメーターをすべて含みます。パラメーターが必要でない場合は null。

#[payload]

Headers (ヘッダー)

Binary (バイナリ)

SOAP メッセージに含める XML ヘッダー。

Attachments (添付ファイル)

Object (オブジェクト)

SOAP 要求に含める添付ファイル。

Headers (ヘッダー)

Object (オブジェクト)

トランスポート要求にバインドされるトランスポートヘッダーのグループ。

Force XML Prolog into body (本文への XML Prolog の強制)

Boolean (ブール)

true の場合、XML Prolog ステートメントが要求の本文に追加されます。

false

Target Variable (対象変数)

String (文字列)

storesoperation の出力が配置される変数の名前

Target Value (対象値)

String (文字列)

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

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。

出力

型

SOAP Output Envelope (SOAP 出力エンベロープ)

Attributes Type (属性型)

SOAP Attributes (SOAP 属性)

次の設定の場合

スロー

  • WSC:SOAP_FAULT​

  • WSC:EMPTY_RESPONSE​

  • WSC:TIMEOUT

  • WSC:BAD_RESPONSE​

  • WSC:BAD_REQUEST​

  • WSC:CONNECTIVITY

  • WSC:CANNOT_DISPATCH​

  • WSC:RETRY_EXHAUSTED​

  • WSC:INVALID_WSDL​

  • WSC:ENCODING

型

Reconnection (再接続)

操作の再接続戦略を設定します。

項目 型 説明 デフォルト値 必須

Fails Deployment (デプロイに失敗)

Boolean (ブール)

アプリケーションがデプロイされると、すべてのコネクタで接続テストが実行されます。true に設定されている場合、関連する再接続戦略をすべて実行した後にテストに合格しないと、デプロイが失敗します。

Reconnection Strategy (再接続戦略)

使用する再接続戦略。

Reconnect (再接続)

項目 型 説明 デフォルト値 必須

Frequency (頻度)

Number (数値)

再接続を試行する頻度 (ミリ秒)。

Count (数)

Number (数値)

Mule アプリケーションで実行できる再接続の試行回数。

Reconnect Forever (繰り返し再接続)

項目 型 説明 デフォルト値 必須

Frequency (頻度)

Number (数値)

再接続を試行する頻度 (ミリ秒)。

WSS Sign Security Strategy Adapter (WSS 署名セキュリティ戦略アダプター)

項目 型 説明 デフォルト値 必須

Key Store Configuration (キーストア設定)

WSS Key Store Configuration (Wss キーストア設定)

メッセージに署名するときに使用するキーストア。

x

Sign Algorithm Configuration (署名アルゴリズム設定)

WSS Sign Configuration Adapter (WSS 署名設定アダプター)

署名に使用するアルゴリズム。

WSS Key Store Configuration (Wss キーストア設定)

項目 型 説明 デフォルト値 必須

Key Store Path (キーストアのパス)

String (文字列)

x

Alias (別名)

String (文字列)

x

Password (パスワード)

String (文字列)

プロキシサーバーに対して認証するパスワード。

x

Key Password (キーパスワード)

String (文字列)

Type (型)

String (文字列)

jks

WSS Sign Configuration Adapter (WSS 署名設定アダプター)

項目 型 説明 デフォルト値 必須

Signature Key Identifier (署名キー識別子)

Enumeration (列挙)。次のいずれかになります。

  • ISSUER_SERIAL​

  • DIRECT_REFERENCE​

  • X509_KEY_IDENTIFIER​

  • THUMBPRINT

  • SKI_KEY_IDENTIFIER​

  • KEY_VALUE

ISSUER_SERIAL

Signature Algorithm (署名アルゴリズム)

Enumeration (列挙)。次のいずれかになります。

  • RSAwithSHA256

  • ECDSAwithSHA256

  • DSAwithSHA1

  • RSAwithSHA1

  • RSAwithSHA224

  • RSAwithSHA384

  • RSAwithSHA512

  • ECDSAwithSHA1

  • ECDSAwithSHA224

  • ECDSAwithSHA384

  • ECDSAwithSHA512

  • DSAwithSHA256

Signature Digest Algorithm (署名ダイジェストアルゴリズム)

Enumeration (列挙)。次のいずれかになります。

  • SHA1

  • SHA256

  • SHA224

  • SHA384

  • SHA512

SHA1

Signature C14n Algorithm (署名 C14n アルゴリズム)

Enumeration (列挙)。次のいずれかになります。

  • Canonical​XML_1_0​

  • Canonical​XML_1_1​

  • ExclusiveXMLCanonicalization_​1_0

ExclusiveXMLCanonicalization_​1_0

Wss Parts (WSS パート)

WSS Part (WSS パート)​ の配列

WSS Part (WSS パート)

項目 型 説明 デフォルト値 必須

Encode (エンコード)

Enumeration (列挙)。次のいずれかになります。

  • ELEMENT

  • CONTENT

CONTENT

Namespace (名前空間)

String (文字列)

x

Localname (ローカル名)

String (文字列)

x

WSS Verify Signature Security Strategy Adapter (WSS 署名検証セキュリティ戦略アダプター)

項目 型 説明 デフォルト値 必須

Trust Store Configuration (トラストストア設定)

WSS Trust Store Configuration (WSS トラストストア設定)

署名の検証に使用するトラストストア。

WSS Trust Store Configuration (WSS トラストストア設定)

項目 型 説明 デフォルト値 必須

Trust Store Path (トラストストアのパス)

String (文字列)

x

Password (パスワード)

String (文字列)

プロキシサーバーに対して認証するパスワード。

x

Type (型)

String (文字列)

jks

Wss Username Token Security Strategy Adapter (WSS ユーザー名トークンセキュリティ戦略アダプター)

項目 型 説明 デフォルト値 必須

Username (ユーザー名)

String (文字列)

サービスに対する認証に必要なユーザー名。

x

Password (パスワード)

String (文字列)

サービスに対する認証に必要な提供されたユーザー名のパスワード。

x

Password Type (パスワードの種類)

Enumeration (列挙)。次のいずれかになります。

  • DIGEST

  • TEXT

#password パラメーター。

TEXT

Add Nonce (ノンスを追加)

Boolean (ブール)

暗号化されたランダムノンスをメッセージに追加するかどうかを指定。

false

Add Created (Created を追加)

Boolean (ブール)

メッセージの作成時刻を示すためにタイムスタンプを作成するかどうかを指定。

false

WSS Timestamp Security Strategy Adapter (WSS タイムスタンプセキュリティ戦略アダプター)

項目 型 説明 デフォルト値 必須

Time To Live (存続期間)

Number (数値)

timeToLiveUnit で指定された時間単位での作成時刻と有効期間の時間差。この期間が経過すると、メッセージは無効になります。

このパラメーター値は 1 秒以上である必要があります (他の単位の場合と同様)。値が 1 秒未満の場合、1 秒のタイムスタンプになります。

60

Time To Live Unit (存続期間単位)

Enumeration (列挙)。次のいずれかになります。

  • NANOSECONDS (ナノ秒)

  • MICROSECONDS (マイクロ秒)

  • MILLISECONDS (ミリ秒)

  • SECONDS (秒)

  • MINUTES (分)

  • HOURS (時間)

  • DAYS (日)

#timeToLive パラメーター。

デフォルトは SECONDS (秒) です。

SECONDS (秒)

WSS Decrypt Security Strategy (WSS 復号化セキュリティ戦略)

項目 型 説明 デフォルト値 必須

Key Store Configuration (キーストア設定)

WSS Key Store Configuration (Wss キーストア設定)

メッセージを復号化するときに使用するキーストア。

x

WSS Encrypt Security Strategy Adapter (WSS 暗号化セキュリティ戦略アダプター)

項目 型 説明 デフォルト値 必須

Key Store Configuration (キーストア設定)

WSS Key Store Configuration (Wss キーストア設定)

メッセージを暗号化するときに使用するキーストア。

x

Encryption Algorithms Configuration (暗号化アルゴリズム設定)

WSS Encryption Algorithms Configuration (WSS 暗号化アルゴリズム設定)

WSS Encryption Algorithms Configuration (WSS 暗号化アルゴリズム設定)

項目 型 説明 デフォルト値 必須

Encryption Key Identifier (暗号化キー識別子)

Enumeration (列挙)。次のいずれかになります。

  • ISSUER_SERIAL​

  • DIRECT_REFERENCE​

  • X509_KEY_IDENTIFIER​

  • THUMBPRINT

  • SKI_KEY_IDENTIFIER​

  • ENCRYPTED_KEY_SHA1​

  • EMBEDDED_KEY_NAME

ISSUER_SERIAL

Encryption Sym Algorithm (暗号化シンボル設定)

Enumeration (列挙)。次のいずれかになります。

  • TRIPLE_DES​

  • AES_128​

  • AES_256​

  • AES_192​

  • AES_128_GCM​

  • AES_192_GCM​

  • AES_256_GCM

AES_128

Encryption Key Transport Algorithm (暗号化キー転送アルゴリズム)

Enumeration (列挙)。次のいずれかになります。

  • KEYTRANSPORT_RSA15​

  • KEYTRANSPORT_RSAOAEP​

  • KEYTRANSPORT_RSAOAEP_XENC11

KEYTRANSPORT_RSAOAEP

Encryption Digest Algorithm (暗号化ダイジェストアルゴリズム)

Enumeration (列挙)。次のいずれかになります。

  • SHA1

  • SHA256

  • SHA384

  • SHA512

SHA1

Wss Part Adapters (WSS パートアダプター)

WSS Part (WSS パート)​ の配列

WSS Incoming Timestamp Security Strategy Adapter (WSS 受信タイムスタンプセキュリティ戦略アダプター)

項目 型 説明 デフォルト値 必須

Future Time To Live (将来の存続期間)

Number (数値)

受信タイムスタンプの作成時刻が有効な将来の時間を指定します。時間が少しずれる問題を回避するために、デフォルト値は「60」になっています。将来作成されるタイムスタンプをすべて拒否するには、この値を「0」に設定します。

60

Future Time To Live Unit (将来の存続期間の単位)

Enumeration (列挙)。次のいずれかになります。

  • NANOSECONDS (ナノ秒)

  • MICROSECONDS (マイクロ秒)

  • MILLISECONDS (ミリ秒)

  • SECONDS (秒)

  • MINUTES (分)

  • HOURS (時間)

  • DAYS (日)

#futureTimeToLive パラメーター。

デフォルトは SECONDS (秒) です。

SECONDS (秒)

Expiration Policy (有効期限ポリシー)

有効期限ポリシー戦略を設定します。

項目 型 説明 デフォルト値 必須

Max Idle Time (最大アイドル時間)

Number (数値)

動的設定インスタンスがアイドル状態を続けられる最大時間を設定します。この時間が経過すると、Mule Runtime で期限切れに相当するとみなされます。

Time Unit (時間単位)

Enumeration (列挙)。次のいずれかになります。

  • NANOSECONDS (ナノ秒)

  • MICROSECONDS (マイクロ秒)

  • MILLISECONDS (ミリ秒)

  • SECONDS (秒)

  • MINUTES (分)

  • HOURS (時間)

  • DAYS (日)

[Max Idle Time (最大アイドル時間)]​ 項目の時間単位。

SOAP Output Envelope (SOAP 出力エンベロープ)

項目 型 説明 デフォルト値 必須

Attachments (添付ファイル)

Object (オブジェクト)

Body (本文)

Binary (バイナリ)

Headers (ヘッダー)

Object (オブジェクト)

メッセージ内の HTTP ヘッダーのマッピング。

SOAP Attributes (SOAP 属性)

項目 型 説明 デフォルト値 必須

Protocol Headers (プロトコルヘッダー)

Object (オブジェクト)

応答にバンドルされるプロトコルヘッダー。

x

Additional Transport Data (追加トランスポートデータ)

Object (オブジェクト)

応答にバンドルされる追加トランスポートデータ。

x

HTTP Transport Configuration (HTTP トランスポート設定)

項目 型 説明 デフォルト値 必須

Requester Config (リクエスター設定)

String (文字列)

x

Default HTTP Transport Configuration (デフォルト HTTP トランスポート設定)

項目 型 説明 デフォルト値 必須

Timeout (タイムアウト)

Number (数値)

5000