ナビゲーションをスキップ

eDocs ホーム > BEA AquaLogic Service Bus 2.1 ドキュメント > AquaLogic Service Bus Console の使い方 > プロキシ サービス

AquaLogic Service Bus Console の使い方

  前 次 前/次ボタンと目次ボタンとの区切り線 目次  

プロキシ サービス

この節の内容は以下のとおりです。

 

プロキシ サービスの概要

この節の内容は以下のとおりです。

プロキシ サービスとは、WebLogic Server 上にローカルに実装される Web サービスの AquaLogic Service Bus 定義です。プロキシ サービスは、WSDL、パイプライン、ポリシーの観点で定義します。プロキシ サービスでセキュリティ資格が必要な場合は、そのセキュリティ資格を管理するプロキシ サービス プロバイダを AquaLogic Service Bus Console で作成できます。プロキシ サービス プロバイダのコンフィグレーション方法については、「プロキシ サービス プロバイダの追加」を参照してください。プロキシ サービスのアクセス制御ポリシーをコンフィグレーションすることができます。詳細については、「アクセス制御ポリシーの表示と検索」、「転送認可ポリシーの編集」、および「サービス認可ポリシーの編集」を参照してください。

プロキシ サービスは、メッセージ フローをコンフィグレーションすることで実装します。メッセージ フローには、パイプライン ペア、および、開始ノード、ルート ノード、ブランチ ノードを入れることができます。詳細については、「プロキシ サービスの概要」および「メッセージ フローの表示と変更」を参照してください。

以下の表は [プロジェクト エクスプローラ] モジュールと [リソース ブラウザ] モジュールでアクセスできるページをまとめたものです。各ページに関連するタスクとヘルプ トピックを確認できます。

表 14-1 [プロジェクト エクスプローラ] モジュールおよび [リソース ブラウザ] モジュールからアクセスするページ

ページ

関連タスク

ヘルプ トピック

プロキシ サービスの概要

プロキシ サービスのリストの表示。サービス名とアラートが表示される。

プロキシ サービスの表示と検索

リストのフィルタ

プロキシ サービスの削除

プロキシ サービスの削除

プロキシ サービスの編集

プロキシ サービスの追加

プロキシ サービスの追加

プロキシ サービスの詳細

特定のプロキシ サービスの詳細の表示と編集

プロキシ サービスの表示と変更

メッセージ フローの編集

メッセージ フローの表示

メッセージ フローの表示と変更

メッセージ フローの変更

パイプライン ペア ノードの追加

パイプライン ペア ノードの追加

条件付きブランチ ノードの追加

条件付きブランチ ノードの追加

オペレーション ブランチ ノードの追加

オペレーション ブランチ ノードの追加

ルート ノードの追加

ルート ノードの追加

ステージの追加

ステージの追加

ブランチ ノードの編集

ブランチの詳細の変更とブランチ定義の追加

条件付きブランチの詳細の表示と変更

ステージ コンフィグレーションの編集

アクションの追加

アクションの追加

エラー ハンドラの編集

プロキシ サービスに関するエラー ハンドラの追加

プロキシ サービスへのエラー処理の追加

パイプライン エラー ハンドラの追加

パイプラインへのエラー処理の追加

ステージ エラー ハンドラの追加

ステージへのエラー処理の追加

ルート ノードへのエラー ハンドラの追加

ルート ノードへのエラー処理の追加

XQuery 式エディタ

XQuery 式の編集

インライン XQuery 式エディタの使用

XQuery 条件エディタ

XQuery 条件の編集

XQuery 条件エディタの使用

XPath 式エディタ

XPath 式の編集

XPath 式エディタの使用


 

サービス タイプ

サービス タイプはそれぞれ同じパターンに従って作成されます。サービス タイプのコンフィグレーションは、共通の部分とサービス タイプ固有の部分で構成されます。

共通のコンフィグレーションは、以下のプロパティで構成されます。

表 14-2 サービス タイプのコンフィグレーション


 

プロパティ

説明

リソース定義

リソース定義は、以下のもので構成される。

  • サービス名 (プロジェクト名、パス名、およびローカル名)

  • サービスの説明 (省略可能)

  • サービス タイプ (読み込み専用)

全般的なコンフィグレーション

このコンフィグレーションは、以下のもので構成される。

  • プロキシ サービスのサービス プロバイダ

注意 : サービス プロバイダが必要になるのは、プロキシ サービスから、クライアント証明書認証を必要とする HTTPS サービスにメッセージをルーティングする場合、または一部のメッセージレベルのセキュリティのシナリオに限られる。

転送コンフィグレーション

各プロキシ サービスに以下のパラメータをコンフィグレーションできる。

  • エンドポイント URI - 次のような文字列。
    /proxy1
    または
    jms://localhost:7001/QueueConnectionFactory/DestName (必須)

    JMS 送り先を複数のサーバにするには、次の URI 形式を使用する。
    jms://host1:port,host2:port/QueueConnectionFactory/DestName

  • [すべてのヘッダを取得] - ブール型の値で、デフォルト値は [はい]。

  • ユーザ指定のヘッダ - ヘッダ名の文字列のリスト。[すべてのヘッダを取得] オプションで [いいえ] を選択した場合にのみ適用可能。

選択する転送方式は、バインディング定義により必要とされる転送モード (要求/応答、一方向、または両方) をサポートする必要があり、それに従ってコンフィグレーションする。

両方のモードでメッセージを交換するサービスでは、(要求/応答を 2 つの非同期呼び出しとして実装する、JMS などの任意の転送に) 場合に応じて転送モードを選択できるようにバインディング レイヤをコンフィグレーションする必要がある。サービスが具象型である場合、この選択は、バインディング定義の記述に従って自動的に行われる。サービスが具象型でない場合、バインディング レイヤをコンフィグレーションするには、$outbound 変数でモードを設定する必要がある。

転送方式と WSDL に基づいて、転送モードが自動的に選択されるが、$inbound や $outbound で上書きできる。


 

各サービス タイプでは、以下のコンフィグレーションを定義する必要があります。

サービス タイプと転送方式

AquaLogic Service Bus では、以下のサービス タイプと転送方式をサポートしています。

表 14-4 AquaLogic Service Bus でサポートされるサービス タイプと転送方式

サービス タイプ

転送プロトコル

SOAP または XML WSDL

JMS1

HTTP(S)

SOAP (WSDL なし)

JMS

HTTP(S)

XML (WSDL なし)2

HTTP(S)

JMS

電子メール

ファイル

FTP

メッセージ タイプ (バイナリ、テキスト、MFL、XML)

HTTP(S)

JMS

電子メール

ファイル

FTP

1. Web サービス セキュリティ (WSS) は、着信および発信時に一方向の JMS でのみサポートされます。JMS 要求/応答を使用して WSS をコンフィグレーションすると、セッションの衝突が発生します。


2. HTTP GET は、WSDL がない XML でのみサポートされます。


 

関連トピック

ビジネス サービスの概要

 

プロキシ サービスの追加

[プロキシ サービスの編集 - 全般的なコンフィグレーション] ページでは、プロキシ サービスを追加できます。

プロキシ サービスとは、WebLogic Server 上にローカルに実装される Web サービスの AquaLogic Service Bus 定義です。プロキシ サービスは、WSDL、パイプライン、ポリシーの観点で定義します。詳細については、「プロキシ サービスの概要」を参照してください。

プロキシ サービスを追加するには、まずサービスの全般的な情報をコンフィグレーションしたうえで、そのサービスについて、全般的な転送情報とプロトコルに依存する転送情報をコンフィグレーションし、さらに、サービスに操作が含まれる場合は、サービスの操作選択アルゴリズムをコンフィグレーションする必要があります。これがメッセージング サービスである場合は、メッセージ タイプもコンフィグレーションする必要があります。コンフィグレーションはプロキシ サービスを作成する前に確認できます。

この手順には以下のタスクが含まれます。

プロキシ サービスを追加するには - 全般的なコンフィグレーション

  1. まだセッションを作成していない場合は、左側のナビゲーション ペインで、[Change Center] の下にある [作成] をクリックして、現在のコンフィグレーションに変更を加えるための新しいセッションを作成します。詳細については、「Change Center の使用」を参照してください。
  2. 左側のナビゲーション ペインで、[プロジェクト エクスプローラ] を選択します。プロジェクト ビュー ページが表示されます。
  3. プロキシ サービスの追加先となるプロジェクトを選択します。プロキシ サービスは直接プロジェクトに追加することも、選択したフォルダに対して追加することもできます。

    4. 注意 : フォルダを選択するには、フォルダ名をクリックします。フォルダ ビュー ページが表示されます。

  4. プロジェクト ビュー ページまたはフォルダ ビュー ページの [リソースの作成] フィールドで、[サービス] の下にある [プロキシ サービス] を選択します。[プロキシ サービスの編集 - 全般的なコンフィグレーション] ページが表示されます。
  5. [サービス名] フィールドにユニークなプロキシ サービス名を入力します。
  6. [説明] フィールドに、プロキシ サービスの説明を入力します。
  7. [サービスの種類] フィールドで、以下のいずれか 1 つを実行します。

    8. 注意 : サービス タイプにより、そのサービスで交換されるメッセージ タイプとパッケージ化が決定されます。このフィールドは必須です。

    表 14-5 [サービスの種類] フィールド

    処理

    手順

    WSDL ポートからのサービスの作成

      1. [新しいサービスの作成] の下にある [WSDL ポート] を選択する。

      2. [参照] をクリックする。[WSDL ブラウザ] が表示される。

      3. [WSDL ブラウザ] で、WSDL リソースを選択してから、[WSDL 定義] ペインでポートを選択する。

      4. [送信] をクリックしてダイアログ ボックスを閉じ、全般的なコンフィグレーション ページに戻る。

    注意 : WSDL では、WSDL ポートまたは WSDL バインディングのみが定義可能であるため、WSDL を基にしてビジネス サービスまたはプロキシ サービスを作成するときには、これらのエンティティのいずれかのみを選択できる。WSDL ポートは、実際の転送アドレスを表す。WSDL ポートは、具象インタフェースに使用する。

    このサービス タイプの詳細については、「プロキシ サービスの概要」の「サービス タイプ」と「サービス タイプと転送方式」を参照。また、このトピックにある「プロキシ サービスからの WSDL の生成」も参照。

    WSDL バインディングからのサービスの作成

      1. [新しいサービスの作成] の下にある [WSDL バインディング] を選択する。

      2. [参照] をクリックする。[WSDL ブラウザ] が表示される。

      3. [WSDL ブラウザ] で、WSDL リソースを選択してから、[WSDL 定義] ペインでバインディングを選択する。

      4. [送信] をクリックしてダイアログ ボックスを閉じ、全般的なコンフィグレーション ページに戻る。

    注意 : WSDL では、WSDL ポートまたは WSDL バインディングのみが定義可能であるため、WSDL を基にしてビジネス サービスまたはプロキシ サービスを作成するときには、これらのエンティティのいずれかのみを選択できる。WSDL バインディングは、インタフェースの構造とパッケージ化の方法を表す。WSDL バインディングは、転送アドレスのマップに使用する。

    このサービス タイプの詳細については、「プロキシ サービスの概要」の「サービス タイプ」と「サービス タイプと転送方式」を参照。また、このトピックにある「プロキシ サービスからの WSDL の生成」も参照。

    メッセージング サービスの作成

    あるデータ型のメッセージを受信し、別のデータ型のメッセージで応答できるサービスを作成するには、[メッセージング サービス] を選択する。このようなメッセージ交換は、要求/応答または一方向にすることができる。Web サービスとは異なり、要求と応答のコンテンツ タイプは同じでなくてもかまわない。

    このサービス タイプの詳細については、「プロキシ サービスの概要」の「サービス タイプ」と「サービス タイプと転送方式」を参照。

    明示的に定義された具象インタフェースを持たない SOAP サービスの作成

    明示的に定義された具象インタフェースを持たない SOAP サービスを作成するには、[任意の SOAP サービス] を選択する。

    このサービス タイプの詳細については、「プロキシ サービスの概要」の「サービス タイプ」と「サービス タイプと転送方式」を参照。

    明示的に定義された具象インタフェースを持たない XML サービスの作成

    明示的に定義された具象インタフェースを持たない XML サービスを作成するには、[任意の XML サービス] を選択する。

    注意 : HTTP GET に対応しているサービス タイプは、[任意の XML サービス] のみ。

    このサービス タイプの詳細については、「プロキシ サービスの概要」の「サービス タイプ」と「サービス タイプと転送方式」を参照。

    既存のビジネス サービスからのプロキシ サービスの作成

      1. [既存のサービスから作成] の下にある [ビジネス サービス] を選択する。

      2. [参照] をクリックする。[サービス ブラウザ] が表示される。

      3. [サービス ブラウザ] でビジネス サービスを選択する。

      4. [送信] をクリックしてダイアログ ボックスを閉じ、全般的なコンフィグレーション ページに戻る。

    これにより、選択したビジネス サービスにルーティングするルート ノードを備えたプロキシ サービスを作成できる。ビジネス サービスの詳細については、「ビジネス サービスの概要」を参照。

    既存のプロキシ サービスからのプロキシ サービスの作成

      1. [既存のサービスから作成] の下にある [プロキシ サービス] を選択する。

      2. [参照] をクリックする。[サービス ブラウザ] が表示される。

      3. [サービス ブラウザ] でプロキシ サービスを選択する。

      4. [送信] をクリックしてダイアログ ボックスを閉じ、全般的なコンフィグレーション ページに戻る。

    これにより、選択したプロキシ サービスのクローンを新しいプロキシ サービスとして作成できる。


     
  8. [プロキシ サービス プロバイダ] フィールドで、プロキシ サービス プロバイダの名前を選択します。
    1. [参照] をクリックします。[プロキシ サービス プロバイダ ブラウザ] が表示されます。
    2. [プロキシ サービス プロバイダ ブラウザ] で、プロキシ サービス プロバイダを選択します。
    3. [送信] をクリックしてダイアログ ボックスを閉じ、全般的なコンフィグレーション ページに戻ります。

      4. プロキシ サービス プロバイダは特定の場合だけに必要とされます。たとえば、双方向発信 TLS/SSL でクライアント証明書認証を必要とする HTTPS サービスに対してプロキシ サービスからメッセージをルーティングする場合や、一部の Web サービス セキュリティのシナリオ (プロキシ サービスでメッセージの暗号化を必要とする場合など) に限定されます。プロキシ サービス プロバイダの詳細については、「プロキシ サービス プロバイダの概要」を参照してください。プロキシ サービス プロバイダの作成方法については、「プロキシ サービス プロバイダの追加」を参照してください。

      注意 : Web サービス セキュリティ対応のプロキシ サービスを追加するには、WS-Policy が付加された WSDL (ポートまたはバインディング) からプロキシ サービスを作成する必要があります。

      JMS 上の SOAP/WSS の場合、Web サービス セキュリティ (WSS) は、着信および発信時に一方向の JMS でのみサポートされます。JMS 要求/応答を使用した WSS はサポートされません。

  9. [次へ] をクリックします。

    10. [サービスの種類] フィールドで [メッセージング サービス] を選択した場合は、[プロキシ サービスの編集 - メッセージの種類のコンフィグレーション] ページが表示されます。「プロキシ サービスを追加するには - メッセージ タイプのコンフィグレーション」に進みます。

    その他のサービス タイプを選択した場合は、[プロキシ サービスの編集 - 転送コンフィグレーション] ページが表示されます。「プロキシ サービスを追加するには - 転送コンフィグレーション」に進みます。

プロキシ サービスを追加するには - メッセージ タイプのコンフィグレーション

[サービスの種類] フィールドで [メッセージング サービス] を選択した場合は、[プロキシ サービスの編集 - 全般的なコンフィグレーション] ページで [次へ] をクリックすると、[プロキシ サービスの編集 - メッセージの種類のコンフィグレーション] ページが表示されます。

メッセージング サービス用のバインディング定義は、交換されるメッセージのコンテンツ タイプのコンフィグレーションで構成されています。応答のコンテンツ タイプは、要求のコンテンツ タイプと同じである必要はありません。そのため、応答は個別にコンフィグレーションされます (たとえば、サービスで MFL メッセージを受信し、XML の受信確認を返すことも可能です)。

  1. 要求メッセージと応答メッセージのメッセージ タイプを選択します。
    1. [要求メッセージの種類] フィールドで、要求メッセージのメッセージ タイプを選択します。

      2. 表 14-6 [要求メッセージの種類] フィールド

      メッセージの種類

      説明

      なし

      メッセージにコンテンツ タイプがない場合、[なし] を選択する。

      バイナリ

      メッセージのコンテンツ タイプが不明か、重要でない場合は、[バイナリ] を選択する。

      テキスト

      メッセージをテキストに限定できる場合は、[テキスト] を選択する。

      MFL

      メッセージが MFL 定義に準拠したバイナリ ドキュメントの場合は、[MFL] を選択する。MFL ファイルは、1 つのみコンフィグレーションできる。

      注意 : MFL の場合は、[参照] をクリックし、[MFL ファイル ブラウザ] で MFL を選択してから、[送信] をクリックすることができる。

      XML

      メッセージが XML ドキュメントの場合は、[XML] を選択する。一部の型情報を指定するために、交換される XML ドキュメントの XML スキーマ型を宣言できる。


       
    2. [応答メッセージの種類] フィールドで、応答メッセージのメッセージ タイプを選択します。

      3. 表 14-7 [応答メッセージの種類] フィールド

      メッセージの種類

      説明

      なし

      メッセージにコンテンツ タイプがない場合、[なし] を選択する。

      バイナリ

      メッセージのコンテンツ タイプが不明か、重要でない場合は、[バイナリ] を選択する。

      テキスト

      メッセージをテキストに限定できる場合は、[テキスト] を選択する。

      MFL

      メッセージが MFL 定義に準拠したバイナリ ドキュメントの場合は、[MFL] を選択する。MFL ファイルは、1 つのみコンフィグレーションできる。

      注意 : MFL の場合は、[参照] をクリックし、[MFL ファイル ブラウザ] で MFL を選択してから、[送信] をクリックすることができる。

      XML

      メッセージが XML ドキュメントの場合は、[XML] を選択する。一部の型情報を指定するために、交換される XML ドキュメントの XML スキーマ型を宣言できる。


       
  2. [次へ] をクリックします。

    3. 転送コンフィグレーション ページが表示されます。「プロキシ サービスを追加するには - 転送コンフィグレーション」に進みます。

プロキシ サービスを追加するには - 転送コンフィグレーション

[プロキシ サービスの編集 - 全般的なコンフィグレーション] ページで [次へ] をクリックすると、転送コンフィグレーション ページが表示されます。メッセージング サービスの場合、[プロキシ サービスの編集 - メッセージの種類のコンフィグレーション] ページで [次へ] をクリックすると、このページが表示されます。

このページでは、プロキシ サービスの転送情報をコンフィグレーションできます。AquaLogic Service Bus でサポートしているサービス タイプと転送方式の種類については、「サービス タイプと転送方式」を参照してください。

注意 : 着信転送レベルのセキュリティは、クライアント アプリケーションと AquaLogic Service Bus プロキシ サービスに適用されます。発信転送レベルのセキュリティは、AquaLogic Service Bus のプロキシ サービスとビジネス サービスの間の接続に適用されます。転送レベルセキュリティの詳細については、BEA AquaLogic Service Bus の『ユーザーズ ガイド』の「着信メッセージおよび発信メッセージの保護」で「転送レベルのセキュリティ」を参照してください。

  1. [プロトコル] フィールドで、以下の転送プロトコルを 1 つ選択します。
  2. [エンドポイント URI] フィールドに、[プロトコル] フィールドで選択した転送プロトコルに基づく形式のエンドポイント URI を入力してから、[Add] をクリックします。

    3. 表 14-8 [エンドポイント URI] フィールド

    転送プロトコル

    形式

    Email

    mailfrom:mail-server-hostname:mail-server-port

    File

    file:///drivename:/somename

    FTP

    ftp://hostname:port/directory

    HTTP

    /someName

    HTTPS

    /someName

    JMS

    jms://host:port/factoryJndiName/destJndiName

    JMS 送り先として複数のサーバを指定するには、次の URI 形式を使用する。

    jms://host1:port,host2:port/QueueConnectionFactory/DestName

    プロキシ サービスを作成するとき、エンドポイントのサーバが使用可能でない場合でも、JMS エンドポイントの URI をコンフィグレーションできる。ただし、JMS の場合は、セッションをアクティブ化する時点でエンドポイントが使用可能でなければならない。詳細については、「セッションのアクティブ化には JMS エンドポイントの URI が使用可能であることが必要」を参照。


     

    注意 : 複数の URL をコンフィグレーションできます。[アクション] カラムで [削除] をクリックすると、いつでも URL を削除できます。実行時に、[ロード バランシング アルゴリズム] フィールドで選択したロード バランシング アルゴリズムに基づいて URL が選択されます。

  3. [すべてのヘッダを取得] フィールドで、転送からすべてのヘッダを取り出す場合は [はい] を、定義に該当するヘッダを取り出す場合は [いいえ] を選択します。[いいえ] を選択した場合は、[ヘッダ] フィールドに一連のヘッダを入力してから、[Add] をクリックします。
  4. [次へ] をクリックします。

    5. 新しい転送コンフィグレーション ページが表示されます。このページでは、プロキシ サービスのプロトコルに依存する転送情報をコンフィグレーションできます。「プロキシ サービスを追加するには - プロトコル依存の転送コンフィグレーション」に進みます。

プロキシ サービスを追加するには - プロトコル依存の転送コンフィグレーション

[プロキシ サービスの編集 - 転送コンフィグレーション] ページで [次へ] をクリックすると、プロトコル依存の転送コンフィグレーション ページが表示されます。このページでは、プロキシ サービスについて、[プロトコル] フィールドで選択した転送プロトコルに基づき追加的な転送情報をコンフィグレーションできます。

  1. [プロトコル] フィールドで選択した転送プロトコルに基づき、以下のいずれか 1 つを実行します。

    2. 表 14-9 [プロトコル] フィールド

    転送プロトコル

    手順

    HTTP

      1. [基本認証が必要] チェック ボックスを選択して、このサービスにアクセスするための基本認証を必須とするか、このフィールドを空白のままにして基本認証を不要とする。基本認証では、WebLogic Server でユーザ名とパスワードを使用し、セキュリティ レルム (Lightweight Directory Access Protocol (LDAP) ディレクトリ サービスや Windows Active Directory など) でコンフィグレーションされた認証プロバイダに対してクライアントの認証が行われる。クライアントは、HTTP 要求ヘッダでユーザ名とパスワードを送信する必要がある。

    注意 : HTTP での基本認証は、パスワードがクリア テキストで送信されるため推奨されない。HTTPS では暗号化されたチャネルが提供されるため、パスワードは HTTPS で送信するのが安全。

    警告 : 基本認証を必要とする HTTP プロキシ サービスのエンドポイントを作成する場合、転送認可ポリシーは着信エンドポイント URI に自動的には関連付けられない。基本認証を強制するには、エンドポイントの転送認証ポリシーを定義する必要がある。詳細については、BEA AquaLogic Service Bus の『ユーザーズ ガイド』の「着信メッセージおよび発信メッセージの保護」を参照。

      2. [ディスパッチ ポリシー] フィールドで、このエンドポイントのディスパッチ ポリシーを選択する。デフォルトのディスパッチ ポリシーを使用するには、[default] のままにする。

    ディスパッチ ポリシーは、サービスのエンドポイントに使用する WLS 9.0 ワーク マネージャのインスタンスを参照する。たとえば、プロキシ サービスが JMS 転送プロトコルに対応している場合、サービスのエンドポイントは、そのディスパッチ ポリシーに関連付けることのできる MDB (メッセージ駆動型 Bean) の JAR ファイルになる。

      3. [要求エンコーディング] フィールドで、以下を実行する。

    HTTP 着信転送の場合、クライアント要求で Content-Type ヘッダの文字セット エンコーディング パラメータが指定されていないときは、このフィールドに文字セット エンコーディング パラメータを入力する。値を入力しない場合は、このフィールドにデフォルトの iso-8859-1 が設定される。

    HTTP 発信転送の場合、要求エンコーディングをコンフィグレーションしていないときは、AquaLogic Service Bus ランタイムがビジネス サービスに要求を行う際に最適なエンコーディングが決定される。パススルー以外のシナリオでは、実行時のデフォルトの文字セット エンコーディングは utf-8 となる。ただし、パススルーのシナリオでは、ランタイムは発信応答で受信したエンコーディングのパススルーを行う。

    HTTP (続き)

      4. [応答エンコーディング] フィールドで、以下を実行する。

    HTTP 着信転送の場合は、応答エンコーディングを入力する必要はない。バインディング レイヤがクライアントに応答を送り返すときに、最適なエンコーディングが決定される。パススルー以外のシナリオでは、実行時のデフォルトの文字セット エンコーディングは utf-8 となる。ただし、パススルーのシナリオの場合、ランタイムは発信応答で受信したエンコーディングのパススルーを行う。

    HTTP 発信転送の場合、バック エンド サービス応答に Content-Type ヘッダの文字セット エンコーディング パラメータが指定されていないときは、このフィールドに文字セット エンコーディング パラメータを入力する。値を入力しない場合は、このフィールドにデフォルトの iso-8859-1 が設定される。

    HTTPS

      1. [クライアント認証] フィールドで、クライアント認証方式として [なし]、[基本]、または [クライアント証明書] を選択する。

    警告 : 基本認証を必要とする HTTPS プロキシ サービスのエンドポイントを作成する場合、転送認可ポリシーは着信エンドポイント URI に自動的には関連付けられない。基本認証を強制するには、エンドポイントの転送認証ポリシーを定義する必要がある。詳細については、BEA AquaLogic Service Bus の『ユーザーズ ガイド』の「着信メッセージおよび発信メッセージの保護」を参照。

      2. [ディスパッチ ポリシー] フィールドで、このエンドポイントのディスパッチ ポリシーを選択する。デフォルトのディスパッチ ポリシーを使用するには、[default] のままにする。

    ディスパッチ ポリシーは、サービスのエンドポイントに使用する WLS 9.0 ワーク マネージャのインスタンスを参照する。たとえば、プロキシ サービスが JMS 転送プロトコルに対応している場合、サービスのエンドポイントは、そのディスパッチ ポリシーに関連付けることのできる MDB (メッセージ駆動型 Bean) の JAR ファイルになる。

      3. [要求エンコーディング] フィールドで、HTTPS 転送における要求の文字セット エンコーディングとして、デフォルトの iso-8859-1 を受け入れるか、別の文字セット エンコーディングを入力する。

      4. [応答エンコーディング] フィールドで、HTTPS 転送における応答の文字セット エンコーディングとして、デフォルトの iso-8859-1 を受け入れるか、別の文字セット エンコーディングを入力する。

    JMS

      1. [送り先の種類] フィールドで [キュー] または [トピック] を選択する。

      2. [送り先の種類] フィールドで [キュー] を選択した場合は、[応答が必要] チェック ボックスを選択する。それ以外の場合は、このフィールドを空白のままにする。このチェック ボックスにより、メッセージの送信後に応答を受け取るか受け取らないかが決まる。このチェック ボックスを選択した場合は、[応答 URI] フィールドへの入力が必要。

      3. [応答 URI] フィールドに、jms://host:port/MyFactory/MyQueue という形式で URI を入力する。[応答が必要] を選択した場合は、このフィールドは必須。
      複数のサーバを送り先にするには、次の URI 形式を使用する。
      jms://host1:port,host2:port/QueueConnectionFactory/DestName

      4. [応答メッセージの種類] フィールドで、[バイト] または [テキスト] を選択する ([応答が必要] フィールドを選択した場合)。

      5. [要求エンコーディング] フィールドで、JMS 転送における要求の文字セット エンコーディングとして、デフォルトの utf-8 を受け入れるか、別の文字セット エンコーディングを入力する。

      6. [応答エンコーディング] フィールドで、JMS 転送における応答の文字セット エンコーディングとして、デフォルトの utf-8 を受け入れるか、別の文字セット エンコーディングを入力する。

      7. [クライアント応答のタイムアウト] フィールドに、応答の待ち時間を秒単位で入力する。

      8. [ディスパッチ ポリシー] フィールドで、このエンドポイントのディスパッチ ポリシーを選択する。[default] は、デフォルトのディスパッチ ポリシーを示す。

    ディスパッチ ポリシーは、サービスのエンドポイントに使用する WLS 9.0 ワーク マネージャのインスタンスを参照する。たとえば、プロキシ サービスが JMS 転送プロトコルに対応している場合、サービスのエンドポイントは、そのディスパッチ ポリシーに関連付けることのできる MDB (メッセージ駆動型 Bean) の JAR ファイルになる。

    JMS (続き)

      9. [詳細設定] をクリックして追加のフィールドを表示する。

      10. 要求を TSL/SSL 接続で行う場合は、[SSL を使用] チェック ボックスを選択する。それ以外の場合は、このフィールドを空白のままにする。TLS/SSL (セキュア ソケット レイヤ) では、ネットワークで接続される 2 つのアプリケーションが互いの ID を認証し、アプリケーション間で交換されるデータを暗号化できるようにすることによって、安全な接続が可能になる。認証を使用すると、サーバ (および必要に応じてクライアント) はネットワーク接続の相手側アプリケーションの ID を検証できる。また、送り先の JNDI エントリに対してアクセス制御が設定されていることにより、管理者から個々の JMS 送り先 (キューまたはトピック) へのアクセスが制限されている場合、JNDI ツリー内でのルックアップ時に、ビジネス サービスでユーザ名とパスワードを使用して認証を行う必要がある。

      11. [メッセージ セレクタ] フィールドにメッセージ セレクタ式を入力する。式に一致するプロパティを持つメッセージのみが処理される。

      12. サブスクリプションが恒久である場合は [恒久サブスクリプション] チェックボックスを選択する。サブスクリプションが恒久でない場合は、このチェックボックスにチェックを入れない。

      13. [再試行回数] フィールドに、メッセージがエラー送り先に移されるまでに許可される配信の再試行回数を入力する。このフィールドは、WebLogic Server JMS 送り先にのみ適用される。

      14. [再試行間隔] フィールドに、ロールバックまたは復元されたメッセージが再配信されるまでの時間をミリ秒単位で入力する。このフィールドは、WebLogic Server JMS 送り先にのみ適用される。

      15. [エラー送り先] フィールドに、再配信制限に達したメッセージの送り先の名前を入力する。このフィールドは、WebLogic Server JMS 送り先にのみ適用される。

      16. [JMS サービス アカウント] フィールドで、JMS サーバによる JMS リソース管理に使用するサービス アカウントを選択する。サービス アカウントは、ユーザ ID とそれに関連付けられたパスワードのエリアス リソースである。サービス アカウントの詳細については、「サービス アカウントの概要」を参照。

    Email

      1. [サービス アカウント] フィールドにサービス アカウントを入力する。[参照] をクリックし、サービス アカウントを参照して選択できる。このフィールドは必須。

      2. [ポーリング間隔] フィールドにポーリング間隔を秒数で入力する。このフィールドは必須。

      3. [電子メール プロトコル] フィールドで、電子メール アカウントのサーバ タイプとして [pop3] または [IMAP] を選択する。このフィールドは必須。

      4. [読み込み制限] フィールドに、ポーリング スイープあたりの読み込みメッセージ最大数を指定する。無制限にするには 0 と入力する。このフィールドは必須。

      5. アーカイブ ディレクトリにファイルをステージングして、それをヘッダに参照として渡す場合は、[参照として渡す] フィールドを選択する。それ以外の場合は、このフィールドを空白のままにする。

      6. [読み込み後のアクション] フィールドで、メッセージ読み込み後の動作を選択する。

    [アーカイブ] - メッセージがアーカイブ化される。

    [削除] - メッセージが削除される。

    [移動] - メッセージが移動される。[移動] は、IMAP プロトコルでのみ使用可能。

    注意 : このフィールドは必須。

      7. [添付ファイル] フィールドで添付ファイルの処理方法を選択する。

    [アーカイブ] - 添付ファイルがアーカイブ ディレクトリに保存される。

    [無視] - 添付ファイルが無視される。

    このフィールドは必須。

      8. [読み込み後のアクション] フィールドで [移動] を選択した場合は、[IMAP 移動先フォルダ] フィールドにメッセージの移動先フォルダを入力する。

      9. [ダウンロード ディレクトリ] フィールドに、電子メールのダウンロード先となる一時保存先を入力する。このフィールドは必須。

      10. [読み込み後のアクション] フィールドで [アーカイブ] を選択した場合は、[アーカイブ ディレクトリ] フィールドにアーカイブ保存先のパスを入力する。[アーカイブ ディレクトリ] フィールドは、[参照として渡す] フィールドを選択した場合も必須。

      11. [エラー ディレクトリ] フィールドに、問題が生じたときにメッセージと添付ファイルを書き込むファイル システム ディレクトリへのパスを入力する。このフィールドは必須。

      12. [要求エンコーディング] フィールドで、電子メール転送における要求の文字セット エンコーディングとして、デフォルトの iso-8859-1 を受け入れるか、別の文字セット エンコーディングを入力する。

    File

      1. [ファイル マスク] フィールドに、選択するファイルの正規表現を入力する。デフォルト値は *.*。このフィールドは必須。

      2. [ポーリング間隔] フィールドにポーリング間隔を秒数で入力する。デフォルト値は 60。このフィールドは必須。

      3. [読み込み制限] フィールドに、ポーリング スイープあたりの読み込みメッセージ最大数を指定する。無制限にするには 0 と入力する。デフォルト値は 10。このフィールドは必須。

      4. イベントが受信順に配信されるように指定する場合は、[到着順にソート] チェックボックスを選択し、それ以外の場合は空白のままにする。

    クラスタ環境で実行されるプロキシ サービスに対して [到着順にソート] オプションを選択すると、メッセージは常に同じサーバに送信される。つまり、このオプションを選択した場合、サーバ全体のロード バランシングは無視される。

      5. すべてのディレクトリを再帰的にスキャンする場合は、[サブディレクトリのスキャン] チェックボックスを選択し、それ以外の場合はこのフィールドを空白のままにする。

      6. アーカイブ ディレクトリにファイルをステージングして、それをヘッダに参照として渡す場合は、[参照として渡す] チェックボックスを選択する。それ以外の場合は、このフィールドを空白のままにする。

      7. [読み込み後のアクション] フィールドで、メッセージ読み込み後の動作を選択する。

    [アーカイブ] - メッセージがアーカイブ化される。

    [削除] - メッセージが削除される。

    このフィールドは必須。

      8. [ステージ ディレクトリ] フィールドに、ファイルの処理中に一時的にファイルをステージングする中間ディレクトリを入力する。このフィールドは必須。

      9. [読み込み後のアクション] フィールドで [アーカイブ] を選択した場合は、[アーカイブ ディレクトリ] フィールドにアーカイブ保存先のパスを入力する。[アーカイブ ディレクトリ] フィールドは、[参照として渡す] フィールドを選択した場合も必須。

      10. [エラー ディレクトリ] フィールドに、問題が生じたときにメッセージと添付ファイルを書き込む場所を入力する。このフィールドは必須。

      11. [要求エンコーディング] フィールドで、ファイル転送における要求の文字セット エンコーディングとして、デフォルトの utf-8 を受け入れるか、別の文字セット エンコーディングを入力する。

    FTP

      1. FTP サーバのユーザが匿名の場合は、[ユーザ認証] フィールドで [匿名] を選択し、FTP サーバが外部的にコンフィグレーションされたアカウントの場合は [外部ユーザ] を選択する。

      2. [ID (電子メール ID)] フィールドまたは [サービス アカウント] フィールドに、匿名ユーザのメール ID を入力するか ([ユーザ認証] フィールドで [匿名] を選択した場合)、またはサービス アカウントを入力する ([ユーザ認証] フィールドで [外部ユーザ] を選択した場合)。[外部ユーザ] を選択した場合、このフィールドへの入力は必須。

      3. アーカイブ ディレクトリにファイルをステージングして、それをヘッダに参照として渡す場合は、[参照として渡す] チェック ボックスを選択する。

      4. 処理時にリモート サーバから FTP ファイルを直接ストリーミングする場合は、[リモート ストリーミング] チェックボックスを選択する。それ以外の場合は、このフィールドを空白のままにする。[リモート ストリーミング] を選択した場合、アーカイブ ディレクトリはリモートの FTP サーバ マシン上のリモート ディレクトリになる。そのため、FTP ユーザ ディレクトリを基準にした相対パスでアーカイブ ディレクトリを指定する必要がある。

      5. [ファイル マスク] フィールドに、選択するファイルの正規表現を入力する。デフォルト値は *.*。このフィールドは必須。

      6. [ポーリング間隔] フィールドにポーリング間隔を秒数で入力する。デフォルト値は 60。このフィールドは必須。

      7. [読み込み制限] フィールドに、ポーリング スイープあたりの読み込みメッセージ最大数を指定する。無制限にするには 0 と入力する。デフォルト値は 10。このフィールドは必須。

      8. [読み込み後のアクション] フィールドで、メッセージ読み込み後の動作を選択する。このフィールドは必須。

    [アーカイブ] - メッセージがアーカイブ化される。

    [削除] - メッセージが削除される。

      9. [転送モード] フィールドで転送モードとして [ascii] または [binary] を選択する。

      10. [ダウンロード ディレクトリ] フィールドに、ファイル転送中にファイルをダウンロードするローカルのディレクトリを入力する。このフィールドは必須。

      11. [読み込み後のアクション] フィールドで [アーカイブ] を選択した場合は、[アーカイブ ディレクトリ] フィールドにアーカイブ保存先のパスを入力する。[アーカイブ ディレクトリ] フィールドは、[参照として渡す] フィールドを選択した場合も必須。

      12. [エラー ディレクトリ] フィールドに、問題が生じたときにメッセージを書き込む場所を入力する。このフィールドは必須。

    注意 : アーカイブ ディレクトリ、ダウンロード ディレクトリ、およびエラー ディレクトリは絶対パスであり、自動的に作成される。相対パスを指定すると、ファイルは WebLogic Server を起動した Java プロセスを基準にした相対的な位置に作成される。

      13. [要求エンコーディング] フィールドで、FTP 転送における要求の文字セット エンコーディングとして、デフォルトの utf-8 を受け入れるか、別の文字セット エンコーディングを入力する。

    FTP (続き)

      14. [詳細設定] をクリックして追加のフィールドを表示する。

      15. すべてのディレクトリを再帰的にスキャンする場合は、[サブディレクトリのスキャン] チェック ボックスを選択し、それ以外の場合はこのフィールドを空白のままにする。

      16. イベントの配信を受信順にする場合は、[到着順にソート] チェック ボックスを選択する。

      17. [タイムアウト] フィールドに、接続が切断されるまでのソケット タイムアウト間隔を秒数で入力する。0 と入力した場合、タイムアウトは発生しない。

      18. [再試行回数] フィールドに FTP 接続失敗時の再試行回数を指定する。


     
  2. [次へ] をクリックします。

    3. このサービスに操作が含まれる場合は、[プロキシ サービスの編集 - 操作選択コンフィグレーション] ページが表示されます。「プロキシ サービスを追加するには - 操作選択コンフィグレーション」に進みます。

    このサービスに操作が含まれない場合は、全般的なコンフィグレーションの確認ページが表示されます。「プロキシ サービスを追加するには - 全般的なコンフィグレーションの確認」に進みます。

プロキシ サービスを追加するには - 操作選択コンフィグレーション

このサービスに操作が含まれる場合は、プロトコル依存の転送コンフィグレーション ページで [次へ] をクリックすると、操作選択コンフィグレーション ページが表示されます。このページでは、WS-I を適用し、このプロキシ サービスによって呼び出される操作の決定に使用される選択アルゴリズムを選択できます。このオプションは、WSDL に基づいて定義された SOAP サービスまたは XML サービスでのみ使用できます。

WSDL 仕様では、受信する SOAP メッセージのタイプに基づいて呼び出す操作を計算するデフォルトのアルゴリズムが定義されています。ただし、その他の手段に基づいて操作を選択しなければならない場合もあります (パフォーマンスや、署名および暗号化に問題があったり、デフォルトのアルゴリズムが使用できない場合など)。

AquaLogic Service Bus には、アルゴリズムが追加で用意されています。これらはそれぞれ同じパターンに従っており、式の評価に基づいて値を取得し、その値を使用して静的なテーブルから対応する操作をルックアップします。

  1. AquaLogic Service Bus Console でサービスが WS-I 準拠であるかどうかを指定する場合は、[WS-I 準拠の適用] チェックボックスを選択します。サービス コールアウト アクション、ルート ノード アクション、またはプロキシ サービス要求パイプラインで呼び出したサービスからの応答としてプロキシ サービスがメッセージを受信したときに確認が行われます。呼び出したサービスの WS-I 準拠テストを指定した場合は、パイプラインによって応答エラーが生成されます。
  2. [選択アルゴリズム] フィールドで、以下のいずれか 1 つを選択します。

    3. 表 14-10 [選択アルゴリズム] フィールド

    選択アルゴリズム

    説明

    転送ヘッダ

    この選択アルゴリズムを選択すると、ルックアップ値を含む転送ヘッダを定義できる。

    SOAP アクション ヘッダ

    この選択アルゴリズムを選択すると、このプロキシ サービスに関連付けられた WSDL から自動的に操作のマッピングが行われる。

    WS-Addressing

    この選択アルゴリズムを選択すると、ルックアップ値は SOAP メッセージの SOAP ヘッダ内の WS-Addressing Action タグに入る。

    SOAP ヘッダ

    この選択アルゴリズムを選択すると、SOAP ヘッダに対して評価される XPath 式を定義して、ルックアップ値を取得できる。

    SOAP 本体の種類

    WSDL 仕様で定義されたデフォルトのアルゴリズム。受信する SOAP メッセージのタイプに基づいて呼び出す操作が計算される。

    注意 : プロキシ サービスをコンフィグレーションする Web サービス セキュリティのパススルー シナリオで本体が暗号化されている場合は、選択アルゴリズムとして [SOAP 本体の種類] を選択することはできない。SOAP ヘッダが暗号化されたパススルー シナリオについても同様。


     

    注意 : WSDL ポートまたは WSDL バインディングに基づく XML サービスを作成する場合は、[転送ヘッダ] と [ペイロードの種類] という選択アルゴリズムがこのページに表示されます。

    注意 : 選択した選択アルゴリズムに応じて、さらに別のフィールドが表示されます。

  3. [選択アルゴリズム] フィールドで選択した選択アルゴリズムに基づき、以下のいずれか 1 つを実行します。

    4. 表 14-11 [選択アルゴリズム] フィールド

    選択アルゴリズム

    手順

    転送ヘッダ

      1. [ヘッダ名] フィールドに、呼び出される操作を選択するキーとして使用される値を抽出する転送ヘッダを入力する。

      2. [操作のマッピング] フィールドの [値] フィールドに、各処理の値を指定する。この値が操作のキーとして使用される。このフィールドは必須。

    SOAP アクション ヘッダ

    この選択アルゴリズムを選択した場合は、追加のフィールドが表示されない。

    WS-Addressing

    [操作のマッピング] フィールドの [値] フィールドに、各操作の値を指定する。この値が操作のキーとして使用される。このフィールドは必須。

    SOAP ヘッダ

      1. [XPath 式] フィールドに、呼び出される操作を選択するためのキーとして使用される値を抽出する XPath 式を指定する。

      2. [操作のマッピング] フィールドの [値] フィールドに、各操作の値を指定する。この値が操作のキーとして使用される。このフィールドは必須。

    SOAP 本体の種類

    この選択アルゴリズムを選択した場合は、追加のフィールドが表示されない。

    ペイロードの種類

    この選択アルゴリズムを選択した場合は、追加のフィールドが表示されない。


     
  4. [次へ] をクリックします。

    5. 全般的なコンフィグレーションの確認ページが表示されます。「プロキシ サービスを追加するには - 全般的なコンフィグレーションの確認」に進みます。

注意 : WS-Policy が付加された WSDL (ポートまたはバインディング) からプロキシ サービスを作成する場合は、[次へ] をクリックすると、Web サービス セキュリティ コンフィグレーション ページが表示されます。このページには、すべての操作について効果的な要求/応答の WS-Policy の読み込み専用ビューが表示されます。

以下のいずれか 1 つを実行します。

詳細については、BEA AquaLogic Service Bus の『ユーザーズ ガイド』の「着信メッセージおよび発信メッセージの保護」を参照してください。

プロキシ サービスを追加するには - 全般的なコンフィグレーションの確認

操作選択コンフィグレーション ページで [次へ] をクリックすると、全般的なコンフィグレーションの確認ページが表示されます。このページでは、このプロキシ サービスについてこれまでに入力したコンフィグレーション データを確認できます。必要であれば、[編集] をクリックしコンフィグレーションを変更してから、プロキシ サービスを保存できます。

注意 : プロキシ サービス作成後の次の手順では、メッセージ フローをコンフィグレーションします。メッセージ フローは、プロキシ サービスの実装を定義します。メッセージ フローには、パイプライン ペア、および、開始ノード、ルート ノード、ブランチ ノードを入れることができます。詳細については、「メッセージ フローの概要」および「メッセージ フローの表示と変更」を参照してください。

注意 : 新しいプロキシ サービスは現在のセッションに保存されます。コンフィグレーションに対する変更が完了したら、左側のナビゲーション ペインで、[Change Center] の下にある [アクティブ化] をクリックします。セッションが終了し、コア コンフィグレーションが更新されます。または、セッション中の任意の時点で [破棄] をクリックして、現在のセッションでそれまでに行った変更内容を削除します。

プロキシ サービスからの WSDL の生成

AquaLogic Service Bus では、WSDL バインディングに基づいてプロキシ サービスを作成すると、そのプロキシ サービス用に生成された WSDL に新しいサービスとポートの定義が設定されます。WSDL ポートと WSDL バインディングのどちらに基づいてプロキシ サービスを定義するかに関わらず、そのプロキシ サービス用として生成された WSDL で定義されるポートは 1 つだけです。サービスがテンプレート WSDL のポート X から生成された場合、生成される WSDL でもポート X が定義されます。テンプレート WSDL に定義されているその他のポートはいずれも、生成される WSDL には含まれません。さらに、WSDL ポートに基づいてプロキシ サービスを作成した場合、生成される WSDL ではそのポート名が使用され、そのポートに関連付けられたすべての WS-Policy が保持されます。バインディングはポートから決定され、ポート タイプはバインディングから決定されます。

サービスがテンプレート WSDL のバインディング Y から生成された場合、生成される WSDL では新しいサービスとポートが定義されます (<service-name>QSService および <port-name>QSPort)。テンプレート WSDL に定義されたポートはいずれも、生成される WSDL には含まれません。

WSDL バインディング テンプレートに基づいてサービスを作成した場合、その WSDL には、該当のバインディングに関連付けられた複数のポートが存在する場合があります。各ポートには異なる URL を使用でき、異なる WS-Policy を付加できます。したがって、生成される WSDL は、そのバインディングを使用しますが、そのバインディング用に WS-Policy のない人為的なポートを生成します。すべての WSDL ベース サービスでは、サービス定義の転送セクションで転送の種類と転送 URL を上書きできます。

サービスの URL に ?WSDL を追加したものをブラウザのアドレス フィールドに入力することで、HTTP(S) ベースのプロキシ サービスの WSDL を取得できます。

関連トピック

プロキシ サービスの表示と検索

プロキシ サービスの表示と変更

プロキシ サービスの削除

メッセージ フローの表示と変更

 

プロキシ サービスの表示と検索

[プロキシ サービスの概要] ページでは、プロキシ サービスのリストを表示できます。プロキシ サービスとは、WebLogic Server 上にローカルに実装される Web サービスの AquaLogic Service Bus 定義です。詳細については、「プロキシ サービスの概要」を参照してください。

プロキシ サービスを表示および検索するには

  1. 左側のナビゲーション ペインで、[リソース ブラウザ] の下にある [プロキシ サービス] を選択します。[プロキシ サービスの概要] ページが表示されます。プロキシ サービスごとに、以下の情報が表示されます。各プロパティの詳細については、「プロキシ サービスの表示と変更」を参照してください。

    2. 表 14-12 [プロキシ サービスの概要] ページ

    プロパティ

    説明

    名前

    ユニークなプロキシ サービス名。詳細の表示ページにリンクされている。詳細については、「プロキシ サービスの表示と変更」を参照。

    パス

    プロジェクト名と、プロキシ サービスが格納されているフォルダの名前。このリソースが格納されているプロジェクトまたはフォルダにリンクされている。詳細については、「プロジェクトの詳細の表示」または「フォルダの詳細の表示」を参照。

    アクション

    プロキシ サービスの場合、[アクション] カラムには最大 4 つのアイコンが表示される。

    • [モニタの管理] アイコン。このアイコンは、[モニタ コンフィグレーション - [サービス名]] ページにリンクされている。アイコンをクリックすると、特定のサービスに対するモニタまたはサービス自体を有効または無効にできる。また、特定のサービスに関するアラート ルールを表示したりコンフィグレーションしたりできる。詳細については、「アラート ルールの表示と検索」を参照。

    • [テスト コンソールの起動] アイコン。クリックすると、テスト コンソールを起動できる。テスト コンソールは、サービスおよびトランスフォーメーションの設計の検証とテストに使用する。ビジネス サービスの場合、テスト コンソールは実行時 (つまり、セッションをアクティブ化したとき) にのみ使用できる。詳細については、「サービスのテスト」を参照。

    • [メッセージ フローの編集] アイコン。このアイコンは特定のサービスに関するパイプラインの編集用画面にリンクされている。詳細については、「メッセージ フローの表示と変更」を参照。

    • [WSDL のエクスポート] アイコン。WSDL ベースのすべてのプロキシ サービスに対して表示される。WSDL のエクスポート機能は、WSDL をすばやく IDE などの外部ツールでの消費に使用できるようにする場合に使用する。これは、システムの管理モジュールにあるリソースのエクスポート機能とは異なる。リソースのエクスポート機能は、2 つのドメイン間でリソースを移動およびステージングする場合に使用する。[WSDL のエクスポート] アイコンをクリックすると、WSDL がエクスポートされる。詳細については、「WSDL のエクスポート」を参照。

    オプション

    [オプション] カラムに以下のアイコンが表示される。

    AquaLogic Service Bus の他のリソースによって参照されているリソースは削除できない。このようなリソースの場合は、[削除] アイコンではなく、赤い X 印の付いた削除アイコンが表示される。


     
  2. 特定のプロキシ サービスを検索するには、以下のいずれか 1 つを実行します。
    • プロキシ サービス名でフィルタする。[名前] フィールドと [パス] フィールドに、検索対象の名前とパスを入力してから、[検索] をクリックします。このパスは、プロジェクト名、およびプロキシ サービスが格納されるフォルダの名前であり、検索条件と一致するサービスが表示されます。
    • リストを再ソートする。ソート可能なカラムには昇順および降順の矢印ボタンが表示されます (この場合は [名前] カラムと [パス] カラム)。このボタンをクリックしてソート順を変更します。
    • ページをスクロールする。右下隅のコントロールを使用します。ページを移動するには、ページ番号を選択するか、次のページ、前のページ、最初のページ、または最後のページに移動する矢印ボタンを使用します。

      • 注意 : [すべて表示] をクリックすると、すべてのプロキシ サービスが表示されます。

関連トピック

プロキシ サービスの追加

メッセージ フローの表示と変更

 

プロキシ サービスの表示と変更

[詳細の表示] ページでは、個々のプロキシ サービスの詳細を表示および編集できます。詳細については、「プロキシ サービスの概要」を参照してください。

プロキシ サービスの詳細を表示および編集するには

  1. 対象のプロキシ サービスを検索します。詳細については、「プロキシ サービスの表示と検索」を参照してください。
  2. プロキシ サービス名をクリックします。

    3. [詳細の表示] ページに以下の情報が表示されます。

    表 14-13 [詳細の表示] ページ

    プロパティ

    説明

    リソース名

    このプロキシ サービスの名前。

    作成者

    このプロキシ サービスを作成したか、コンフィグレーションにインポートしたユーザ。

    作成日

    ユーザがこのプロキシ サービスを作成したか、コンフィグレーションにインポートした日時。

    参照先

    このプロキシ サービスが参照するオブジェクトの数。該当する参照がある場合は、リンクをクリックするとオブジェクトのリストが表示される。詳細については、「参照の表示」を参照。

    参照元

    このプロキシ サービスを参照するオブジェクトの数。該当する参照がある場合は、リンクをクリックするとオブジェクトのリストが表示される。詳細については、「参照の表示」を参照。

    説明

    このプロキシ サービスの説明 (説明が存在する場合)。


     

    詳細の表示ページに以下の全般的なコンフィグレーション情報が表示されます。

    表 14-14 全般的なコンフィグレーション情報

    プロパティ

    説明

    サービスの種類

    サービス タイプ。

    プロキシ サービス プロバイダ

    このプロキシ サービス プロバイダの名前。


     

    このプロキシ サービスのサービス タイプがメッセージング サービスの場合は、以下のメッセージ タイプのコンフィグレーション情報が表示されます。

    表 14-15 メッセージ タイプのコンフィグレーション情報

    プロパティ

    説明

    要求メッセージの種類

    [なし]、[バイナリ]、[テキスト]、[MFL]、または [XML] で示される要求メッセージのメッセージ タイプ。

    応答メッセージの種類

    [なし]、[バイナリ]、[テキスト]、[MFL]、または [XML] で示される応答メッセージのメッセージ タイプ。


     

    このページには以下の転送コンフィグレーション情報が表示されます。

    表 14-16 転送コンフィグレーション情報

    プロパティ

    説明

    プロトコル

    転送プロトコル。

    エンドポイント URI

    エンドポイントの URI。

    すべてのヘッダを取得

    転送からすべてのヘッダ、定義に該当するヘッダのどちらを取り出すか。


     

    転送プロトコルが電子メールの場合は、以下の電子メール転送コンフィグレーション情報が表示されます。

    表 14-17 電子メール転送コンフィグレーション情報

    プロパティ

    説明

    電子メール プロトコル

    この電子メール アカウントのサーバ タイプ。

    • [pop3]

    • [imap]

    サービス アカウント

    このメール サーバのサービス アカウント。

    ポーリング間隔

    秒数で示されたポーリング間隔。

    読み込み制限

    ポーリング スイープあたりの読み込みメッセージ最大数。無制限の場合は「0」を指定する。

    参照として渡す

    ファイルをアーカイブ ディレクトリにステージングして、ヘッダに参照として渡すかどうか。

    読み込み後のアクション

    メッセージの読み込み後に、アーカイブ化、削除、移動のどの動作を実行するか。

    • [アーカイブ] - メッセージがアーカイブ化される。

    • [削除] - メッセージが削除される。

    • [移動] - メッセージが移動される。

    注意 : [移動] は、IMAP プロトコルでのみ使用可能。

    添付ファイル

    添付ファイルをアーカイブ化するか、無視するか。

    • [アーカイブ] - 添付ファイルがアーカイブ ディレクトリに保存される。

    • [無視] - 添付ファイルが無視される。

    IMAP 移動先フォルダ

    [読み込み後のアクション] フィールドで [移動] を選択した場合に使用されるメッセージの移動先フォルダ。

    ダウンロード ディレクトリ

    電子メールのダウンロードに使用される一時的な保存先。

    アーカイブ ディレクトリ

    [読み込み後のアクション] フィールドで [アーカイブ] を選択した場合に使用されるメッセージのアーカイブ場所へのパス。[アーカイブ ディレクトリ] フィールドは、[参照として渡す] フィールドを選択した場合も必須。

    エラー ディレクトリ

    問題が生じた場合にメッセージと添付ファイルが書き込まれるファイル システム ディレクトリへのパス。

    要求エンコーディング

    電子メール転送の要求用文字セット エンコーディングが表示される。デフォルト値は iso-8859-1。


     

    転送プロトコルがファイルの場合は、以下のファイル転送コンフィグレーション情報が表示されます。

    表 14-18 ファイル転送コンフィグレーション情報

    プロパティ

    説明

    ファイル マスク

    選択されるファイルに適用される正規表現。

    ポーリング間隔

    秒数で示されたポーリング間隔。

    読み込み制限

    ポーリング スイープあたりの読み込みメッセージの最大数。無制限の場合は 0 を指定する。

    到着順にソート

    イベントの配信を受信の順序にするかどうか。

    サブディレクトリのスキャン

    すべてのディレクトリを再帰的にスキャンするかどうか。

    参照として渡す

    ファイルをアーカイブ ディレクトリにステージングして、ヘッダに参照として渡すかどうか。

    リモート ストリーミング

    処理時にリモート サーバから ftp ファイルを直接ストリーミングするかどうか。

    読み込み後のアクション

    メッセージの読み込み後に、アーカイブ化または削除するかどうか。

    • [アーカイブ] - メッセージがアーカイブ化される。

    • [削除] - メッセージが削除される。

    ステージ ディレクトリ

    ファイルの処理中に一時的にファイルをステージングする中間ディレクトリ。

    エラー ディレクトリ

    問題が生じた場合にメッセージと添付ファイルが書き込まれるファイル システム ディレクトリへのパス。

    アーカイブ ディレクトリ

    [読み込み後のアクション] フィールドで [アーカイブ] を選択した場合に使用されるメッセージのアーカイブ場所へのパス。[アーカイブ ディレクトリ] フィールドは、[参照として渡す] フィールドを選択した場合も必須。

    要求エンコーディング

    ファイル転送の要求用文字セット エンコーディングが表示される。デフォルト値は utf-8。


     

    転送プロトコルが FTP の場合は、以下の FTP 転送コンフィグレーション情報が表示されます。

    表 14-19 FTP 転送コンフィグレーション情報

    プロパティ

    説明

    ID (電子メール ID)/サービス アカウント

    匿名ユーザのメール ID または外部的にコンフィグレーションされたユーザのサービス アカウント。

    タイムアウト

    秒数で示されたソケット タイムアウト。

    ファイル マスク

    選択されるファイルに適用される正規表現。

    サブディレクトリのスキャン

    すべてのディレクトリを再帰的にスキャンするかどうか。

    参照として渡す

    ファイルをアーカイブ ディレクトリにステージングして、ヘッダに参照として渡すかどうか。

    読み込み後のアクション

    メッセージの読み込み後に、アーカイブ化または削除するかどうか。

    • [アーカイブ] - メッセージがアーカイブ化される。

    • [削除] - メッセージが削除される。

    アーカイブ ディレクトリ

    [読み込み後のアクション] フィールドで [アーカイブ] を選択した場合に使用されるメッセージのアーカイブ場所へのパス。[アーカイブ ディレクトリ] フィールドは、[参照として渡す] フィールドを選択した場合も必須。

    ダウンロード ディレクトリ

    FTP ファイルのダウンロードに使用される一時的な保存場所。

    エラー ディレクトリ

    問題が生じた場合にメッセージと添付ファイルが書き込まれるファイル システム ディレクトリへのパス。

    再試行回数

    FTP 接続に失敗したときに再試行する回数。

    ポーリング間隔

    秒数で示されたポーリング間隔。

    読み込み制限

    ポーリング スイープあたりの読み込みメッセージの最大数。無制限の場合は 0 を指定する。

    到着順にソート

    イベントの配信を受信の順序にするかどうか。

    転送モード

    転送モード : [Binary] または [ASCII]。

    要求エンコーディング

    FTP 転送の要求用文字セット エンコーディングが表示される。デフォルト値は utf-8。


     

    転送プロトコルが HTTP の場合は、以下の HTTP 転送コンフィグレーション情報が表示されます。

    表 14-20 HTTP 転送コンフィグレーション情報

    プロパティ

    説明

    基本認証が必要

    基本認証が必要かどうか (必要な場合は [有効] が表示される)。

    要求エンコーディング

    HTTP 転送の要求用文字セット エンコーディングが表示される。デフォルト値は iso-8859-1。

    応答エンコーディング

    HTTP 転送の応答用文字セット エンコーディングが表示される。デフォルト値は iso-8859-1。


     

    転送プロトコルが HTTPS の場合は、以下の HTTPS 転送コンフィグレーション情報が表示されます。

    表 14-21 HTTPS 転送コンフィグレーション情報

    プロパティ

    説明

    クライアント認証

    クライアント認証方式 : [なし]、[基本]、または [クライアント証明書]。

    要求エンコーディング

    HTTPS 転送の要求用文字セット エンコーディングが表示される。デフォルト値は iso-8859-1。

    応答エンコーディング

    HTTPS 転送の応答用文字セット エンコーディングが表示される。デフォルト値は iso-8859-1。


     

    転送プロトコルが JMS の場合は、以下の JMS 転送コンフィグレーション情報が表示されます。

    表 14-22 JMS 転送コンフィグレーション情報

    プロパティ

    説明

    送り先の種類

    送り先のタイプ : [キュー] または [トピック]。

    SSL を使用

    要求を TSL/SSL 接続で行うかどうか。

    応答が必要

    メッセージの送信後に応答を受け取るかどうか。

    要求エンコーディング

    JMS 転送の要求用文字セット エンコーディングが表示される。デフォルト値は utf-8。

    応答 URI

    jms://host:port/factoryJndiName/destJndiName の形式で記載された応答 URI。

    複数のサーバを送り先にするには、次の URI 形式を使用する。
    jms://host1:port,host2:port/QueueConnectionFactory/DestName

    JMS サービス アカウント

    JMS サーバによって管理される JMS リソースに使用するサービス アカウント。


     

    このページには以下の操作選択コンフィグレーション情報が表示されます。

    表 14-23 操作選択コンフィグレーション情報

    プロパティ

    説明

    WS-I 準拠の適用

    このオプションを選択して AquaLogic Service Bus Console でサービスが WS-I 準拠であるかどうかを指定した場合は、[はい] が表示される。これを指定しなかった場合は、[いいえ] が表示される。

    選択アルゴリズム

    このプロキシ サービスに呼び出される操作を決定する選択アルゴリズム。

    ヘッダ名

    このプロキシ サービスについて [選択アルゴリズム] フィールドで [転送ヘッダ] を選択している場合、このフィールドには、呼び出される操作を選択するためのキーとして使用される値を抽出する転送ヘッダが表示される。

    XPath 式

    このプロキシ サービスについて [選択アルゴリズム] フィールドで [SOAP ヘッダ] を選択している場合、呼び出される操作を選択するためのキーとして使用される値を抽出する XPath 式がこのフィールドに表示される。

    操作のマッピング

    このプロキシ サービスについて [選択アルゴリズム] フィールドで [転送ヘッダ]、[WS-Addressing]、または [SOAP ヘッダ] を選択している場合、各操作の値がこのフィールドに表示される。この値が操作のキーとして使用される。


     
  3. セッションの作成または編集をまだ行っていない場合は、左側のナビゲーション ペインで、[Change Center] の下にある [作成] をクリックして新しいセッションを作成するか、[編集] をクリックして既存のセッションに入り、現在のコンフィグレーションを変更します。詳細については、「Change Center の使用」を参照してください。
  4. 対象のページの [編集] をクリックして、各コンフィグレーション ページのフィールドに変更を加えます。各ページとフィールドの詳細については、「プロキシ サービスの追加」を参照してください。

    5. 注意 : [サービス名] および [サービスの種類] フィールドは変更できません。

  5. 以下のいずれか 1 つを実行します。
    • [戻る] をクリックして、前のページに戻る。
    • [完了] をクリックして、プロキシ サービスを更新する。プロキシ サービスが更新されます。

      • [プロキシ サービスの概要] ページが表示されます。

    • [取り消し] をクリックして変更を取り消し、[プロキシ サービスの概要] ページに戻る。

注意 : プロキシ サービスは現在のセッション内で更新されます。コンフィグレーションに対する変更が完了したら、左側のナビゲーション ペインで、[Change Center] の下にある [アクティブ化] をクリックします。セッションが終了し、コア コンフィグレーションが更新されます。または、セッション中の任意の時点で [破棄] をクリックして、現在のセッションでそれまでに行った変更内容を削除します。

関連トピック

プロキシ サービスの追加

プロキシ サービスの表示と変更

プロキシ サービスの削除

 

プロキシ サービスの削除

[プロキシ サービスの概要] ページでは、プロキシ サービスを削除できます。詳細については、「プロキシ サービスの概要」を参照してください。

注意 : AquaLogic Service Bus の他のリソースによって参照されているリソースは削除できません。このようなリソースには、[削除] アイコンの代わりに赤い X が付いた削除アイコンが表示されます。

注意 : AquaLogic Service Bus からプロキシ サービスを削除する前に、そのプロキシ サービスに関連付けられたすべてのサービス レベルのアクセス制御ポリシーと転送レベルのアクセス制御ポリシーを削除する必要があります。

プロキシ サービスを削除するには

  1. まだセッションを作成していない場合は、左側のナビゲーション ペインで、[Change Center] の下にある [作成] をクリックして、現在のコンフィグレーションに変更を加えるための新しいセッションを作成します。詳細については、「Change Center の使用」を参照してください。
  2. 左側のナビゲーション ペインで、[リソース ブラウザ] の下にある [プロキシ サービス] を選択します。[プロキシ サービスの概要] ページが表示されます。
  3. 削除するプロキシ サービスの [オプション] フィールドにある [削除] アイコンをクリックします。

    4. そのプロキシ サービスがリストから削除されます。

    注意 : 必要であれば、このリソースの削除を取り消すことができます。詳細については、「タスクの取り消し」を参照してください。

    プロキシ サービスは現在のセッション内で削除されます。コンフィグレーションに対する変更が完了したら、左側のナビゲーション ペインで、[Change Center] の下にある [アクティブ化] をクリックします。セッションが終了し、コア コンフィグレーションが更新されます。または、セッション中の任意の時点で [破棄] をクリックして、現在のセッションでそれまでに行った変更内容を削除します。

関連トピック

プロキシ サービスの追加

プロキシ サービスの表示と変更

メッセージ フローの表示と変更

 

ナビゲーションのスキップ  ページの先頭 前 次