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

Web Service Consumer Connector バージョン 1.5

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

設定

デフォルト設定

デフォルト設定。

パラメーター

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

Name (名前)

String (文字列)

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

x

Connection (接続)

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

x

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

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

接続種別

Connection (接続)

WSC SOAP クライアントのインスタンスを返す接続プロバイダー。

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

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 (再接続)

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

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

署名 WSS 設定。

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

署名検証 WSS 設定。

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

ユーザー名トークンセキュリティ戦略の WSS 設定。

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

タイムスタンプ WSS 設定。

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

復号化 WSS 設定。

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

暗号化 WSS 設定。

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

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

Must Understand (理解が必要)

Boolean (ブール)

Web サービスセキュリティヘッダーの ​[Must understand (理解が必要)]​ 属性が ​true​ か、​false​ かを決定します。デフォルトは ​true​ です。

true

Actor (アクター)

String (文字列)

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

関連操作

操作

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 (オブジェクト)

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

Target Variable (対象変数)

String (文字列)

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

Target Value (対象値)

String (文字列)

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

#[payload]

Reconnection Strategy (再接続戦略)

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

次の設定の場合

スロー

  • WSC:SOAP_FAULT

  • WSC:TIMEOUT

  • WSC:BAD_RESPONSE

  • WSC:BAD_REQUEST

  • WSC:CONNECTIVITY

  • WSC:CANNOT_DISPATCH

  • WSC:RETRY_EXHAUSTED

  • WSC:ENCODING

  • WSC:INVALID_WSDL

Reconnection (再接続)

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

Fails Deployment (デプロイに失敗)

Boolean (ブール)

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

Reconnection Strategy (再接続戦略)

使用する再接続戦略。

Reconnect (再接続)

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

Frequency (頻度)

Number (数値)

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

Count (数)

Number (数値)

再接続の試行回数。

blocking (ブロック)

Boolean (ブール)

false​ の場合、再接続戦略が個別の非ブロックスレッドで実行されます。

true

Reconnect Forever (繰り返し再接続)

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

Frequency (頻度)

Number (数値)

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

blocking (ブロック)

Boolean (ブール)

false​ の場合、再接続戦略が個別の非ブロックスレッドで実行されます。

true

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

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

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

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

x

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

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

WSS Keystore 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 パート)

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

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 トラストストア設定)

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

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 (日)

[Time to live (存続期間)]​ のパラメーター。デフォルトは ​SECONDS​ です。

SECONDS

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

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

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

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

x

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

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

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

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

x

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

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 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 (日)

[Future time to live unit (将来の存続期間の単位)]​ のパラメーター。デフォルトは ​SECONDS​ です。

SECONDS

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

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

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

Number (数値)

有効期限の対象とみなされるまで、動的設定インスタンスがアイドル状態を維持できる最大時間のスカラー時間値。

Time Unit (時間単位)

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

  • NANOSECONDS (ナノ秒)

  • MICROSECONDS (マイクロ秒)

  • MILLISECONDS (ミリ秒)

  • SECONDS (秒)

  • MINUTES (分)

  • HOURS (時間)

  • DAYS (日)

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

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

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

Attachments (添付ファイル)

Object (オブジェクト)

Body (本文)

Binary (バイナリ)

Headers (ヘッダー)

Object (オブジェクト)

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