ヘッダーをスキップ
Oracle SOA Suite開発者ガイド
10g(10.1.3.1.0)
B31839-01
  目次へ
目次
索引へ
索引

前へ
前へ
 
次へ
次へ
 

10.4 Oracle Web Services Manager Gatewayを使用した暗号化

この項では、Oracle Web Services Manager Gatewayを使用してデータを暗号化する手順を説明します。

SOA Order Bookingアプリケーションでは、保護されていない機密データがビジネス・プロセスによって処理されます。これは、プロセス・フロー内でのデータの送信方法を確認することで、これらの機密データを検証できるためです。

データの送信方法を確認する手順は、次のとおりです。

  1. 図10-24に示すように、SOA Order Bookingアプリケーションのプロセス・フローを確認するには、Oracle BPEL Process Manager Consoleを使用します。

    図10-24 SOA Order Bookingアプリケーションのプロセス・フロー

    この図の詳細は、周辺の説明を参照してください。

  2. 図10-25に示すように、下にスクロールしてCreditServiceフローを確認します。

    図10-25 Webサービスのフロー

    この図の詳細は、周辺の説明を参照してください。

  3. 図10-26に示すように、「InvokeCreditService」をクリックして、メッセージの詳細を表示します。

    図10-26 サービス起動の詳細

    この図の詳細は、周辺の説明を参照してください。

Oracle BPEL Process Managerによって、ユーザーのクレジット・カード詳細が、クリアテキストで、検証のために与信検証サービスに送信されます。

このデータのクリアテキストによる送信を回避するには、Oracle BPEL Process Managerプロセスから与信検証サービスに送信するデータを暗号化するために、Oracle Web Services Manager Gatewayを設定して使用できます。 Oracle Web Services Manager Agentによって、ユーザーが認証され、メッセージが復号化されてパートナ・リンクに渡されます。


注意:

ゲートウェイの使用は、このタスクをOracle Web Services Managerで実行するための1つの方法です。 エージェントとゲートウェイの比較については、第10.2.1項「エージェントまたはゲートウェイを使用する場合」を参照してください。

図10-27に、SOA Order BookingアプリケーションでのOracle Web Services Manager Gatewayの利用方法を示します。 このゲートウェイでは、クライアントがWebサービスに送信するデータが暗号化されます。

図10-27 Oracle Web Services Managerによる暗号化

この図の詳細は、周辺の説明を参照してください。
「図10-27 Oracle Web Services Managerによる暗号化」の説明


関連項目:

このプロセス・フローの詳細は、「セキュリティ・アーキテクチャ」を参照してください。

Oracle Web Services Managerによる暗号化を完了する手順は、次のとおりです。

  1. Oracle Web Services Manager Gatewayを登録します。

  2. WebサービスのWSDLを検索します。

  3. ゲートウェイで保護するサービスのポリシーを登録します。

  4. Webサービス・クライアントをゲートウェイにリダイレクトします。

  5. 証明書キーストアを作成します。

  6. 暗号化と復号化のポリシー・ステップを定義します。

  7. メッセージの暗号化をテストします。

10.4.1 ゲートウェイの登録方法

Oracle Web Services Manager Gatewayは仲介要素として機能し、Webサービス・リクエストのルーティングで経由するプロキシの役割を果たします。

ゲートウェイを登録する手順は、次のとおりです。

  1. Oracle Web Services ManagerのWeb Services Manager Control Consoleにログインします。

  2. 「新規コンポーネントの追加」をクリックします。

    図10-28に、BPEL Gatewayという新規のコンポーネントを示します。

    図10-28 ゲートウェイの登録

    この図の詳細は、周辺の説明を参照してください。

    「コンポーネント・タイプ」が「ゲートウェイ」であること、「コンポーネントURL」がOracle Enterprise Managerに常駐しているゲートウェイ・アプリケーションのURLと一致していることに注意してください。

  3. 「登録」をクリックします。 図10-29に、表示される確認ページを示します。

    図10-29 ゲートウェイのコンポーネントID

    この図の詳細は、周辺の説明を参照してください。

    コンポーネントIDをメモし、「OK」をクリックします。

  4. テキスト・エディタを使用して、次の場所に配置されているゲートウェイの構成ファイルを開きます。

    Oracle_Home/owsm/config/gateway/gateway-config-installer.properties

  5. gateway.component.idの値を、手順3で生成されたゲートウェイIDに置き換えます。

    ファイルを保存して閉じます。

  6. wsmadminコマンドライン・ツールを使用して、ゲートウェイを起動します。


    関連項目:

    wsmadminについては、第10.3.6項「サーバー・エージェントのインストール方法」の手順4を参照してください。

この手順によって、Oracle Web Services Manager内にゲートウェイが作成されます。 ただし、この段階ではこのゲートウェイに添付されたポリシー・ステップはありません。

10.4.2 ゲートウェイ登録時の処理内容

ゲートウェイを登録すると、Oracle Web Services Managerによって、そのゲートウェイがサーバー・システム・レジストリに追加されます。 また、一意のコンポーネントID番号がゲートウェイに割り当てられます。このIDによって、デプロイ全体にわたるすべてのアクション、およびゲートウェイから収集されたメトリック内のすべてのアクションに対するコンポーネントが識別されます。

すべてのコンポーネントに対して体系化されたネーミング規則が作成されます。 コンポーネントが次の詳細とともにわかりやすい名前で記録されます。

  • コンポーネントID

  • 製品のバージョン番号

  • コンポーネントの説明

  • そのポリシーの実行点に関連するコンポーネント固有の追加詳細

前述したように、ゲートウェイは、保護対象のサービスを指定し、各サービスに実装するセキュリティ・ポリシーを定義するまでは機能しません。

10.4.3 サービスのWSDLの検索方法

Webサービスに対してOracle Web Services Managerポリシーを作成するためには、そのサービスのWSDLの場所を認識する必要があります。 サービスのWSDLはBPELに存在しないため、この情報は、UDDIレジストリやOC4Jなどの別のソースから取得する必要があります。

次の手順では、アプリケーション・サーバーからSOA Order Bookingアプリケーションの与信検証サービスに対するWSDLを取得する例を示します。

サービスのWSDLを検索する手順は、次のとおりです。

  1. Oracle Enterprise Manager 10g Application Server Control Consoleにログインします。

  2. 「ホーム」を開きます。

  3. WSDLの情報が必要なアプリケーションをクリックします。 この例では、SOADEMO-CREDITSERVICE-CreditService-WSというWebサービスです。

  4. このサービスのアプリケーション・ホームページで、「Webサービス」をクリックします。

  5. サービスのリストが表示されます。 この例でリストされているサービスは、ValidateCreditCardServiceSoapHttpのみです。 「サービスのテスト」をクリックします。

  6. 「Webサービスのテスト」をクリックします。 図10-30に示すように、このWebサービスのホームページが表示されます。

    図10-30 Webサービスのホームページ

    この図の詳細は、周辺の説明を参照してください。

    ホームページには、Webサービスで使用可能な操作のリストが表示されます。また、このホームページは、WebサービスのWSDLとそのサービスのJavaScriptスタブにリンクします。

  7. 「サービスの説明」リンクをクリックし、WebサービスのWSDLを開きます。 図10-31に、与信検証サービスに関するサービスの説明ページを示します。

    図10-31 サービスの説明ページ

    この図の詳細は、周辺の説明を参照してください。

  8. ブラウザのアドレス・バーには、WSDLの場所のURLが表示されます。 このアドレスに注意してください。 次の項では、このWSDLアドレスを使用して、Oracle WSM GatewayにWebサービスを登録します。


注意:

Webサービスを起動する別の方法については、第9.7項「Webアプリケーションのテスト」を参照してください。

10.4.4 ゲートウェイへのWebサービスの登録方法

以前に、Oracle Web Services ManagerのOracle Web Services Manager Gatewayを、クライアント・アプリケーションとWebサービス間の相互作用を保護するための最初のステップとして構成しました。

1つのゲートウェイで複数のWebサービスのセキュリティ・ポリシーを処理できます。 ここで、ゲートウェイのOracle Web Services Managerが保護するWebサービスを指定する必要があります。

ゲートウェイにWebサービスを登録する手順は、次のとおりです。

  1. Web Services Manager Control Consoleを起動します。

    「ポリシー管理」をクリックし、次に「サービスの登録」をクリックします。 使用可能なゲートウェイが表示されます。

  2. リストで該当するゲートウェイを検索し、対応する「サービス」リンクをクリックします。

  3. ゲートウェイに対するWebサービスのリストが表示されます。 現在、この例のBPELGatewayに定義されているサービスはありません。 「新規サービスの追加」をクリックします。

  4. 次の情報を入力してサービスを登録します。

    フィールド
    サービス名 Gateway Service
    サービスのバージョン 1.0
    サービスの説明 BPEL Gateway Service
    WSDL URL 「サービスのWSDLの検索方法」の手順8で保存したWSDL URL
    サービス・プロトコル Http(S)

    他のフィールドについては、デフォルトの値をそのまま使用します。

    図10-32に、与信検証サービスに対して定義されたサービス詳細を示します。

    図10-32 ゲートウェイへのWebサービス詳細の追加

    この図の詳細は、周辺の説明を参照してください。
  5. 「次へ」をクリックします。 2番目のページが表示され、サービス・プロトコルのパラメータが表示されます。

  6. デフォルトをそのまま使用し、「終了」をクリックします。

  7. 確認ページが表示され、サービスが追加されたことが示されます。 「OK」をクリックします。

  8. ゲートウェイで定義されたサービスのリストが表示されます。 このサービスは、「コミット」リンクをクリックしてコミットする必要があります。

    ポリシーがコミットされたことを確認した後、「OK」をクリックします。


    注意:

    コミット処理によって、ゲートウェイは新規サービスの詳細を使用して更新されましたが、セキュリティ・ポリシー・ステップはまだ構成されていません。 ゲートウェイでのサービスに対する暗号化ポリシー・ステップの構成、およびサーバー・エージェントでの復号化ポリシー・ステップの構成については、第10.4.8項「暗号化と復号化のポリシー・ステップの定義方法」を参照してください。

  9. ゲートウェイで定義されたサービスのリストから、該当するゲートウェイ・サービスの「詳細の表示」アイコンをクリックします。 図10-33に示すように、サービスの詳細ページが表示されます。

    図10-33 サービスの詳細へのアクセス

    この図の詳細は、周辺の説明を参照してください。

    サービスのWSDL URLをメモします。 このWSDLは、次の手順で、与信評価サービスのクライアントをゲートウェイにリダイレクトするために使用します。

10.4.5 ゲートウェイへのクライアントのリダイレクト方法

Oracle Web Services ManagerのOracle Web Services Manager Gatewayを使用してWebサービスを保護するには、そのサービスが直接起動できないことを確認する必要があります。 このためには、サービスのWSDLを更新して、ゲートウェイを指し示すようにする必要があります。

たとえば、与信検証サービスのWSDLを変更して、前の手順(「ゲートウェイの登録方法」を参照)で作成したゲートウェイを指し示すようにできます。


注意:

セキュリティは、元のURLを無効化することで拡張できます。 新規の保護されたURLをUniversal Description, Discovery, and Integration(UDDI)レジストリに公開すると、サービス検出が簡素化され、他のアプリケーションによる呼出しに使用できます。

クライアントをゲートウェイにリダイレクトする手順は、次のとおりです。

  1. JDeveloperを起動します。

  2. アプリケーション・ナビゲータで、アプリケーション・ファイルを検索して開きます(SOADEMO/SOAOrderBookingなど)。

  3. 「インテグレーション・コンテンツ」を開きます。

  4. .bpelファイル(SOAOrderBooking.bpelなど)をダブルクリックします。

  5. パートナ・リンクまで下にスクロールします。 目的のサービスを開きます。 サービスのアイコンを右クリックし、「編集」を選択します。

  6. 「パートナ・リンクの編集」ダイアログで、サービスのWSDLファイルの場所をメモします。

  7. Oracle JDeveloper(または任意のテキスト・エディタ)でWSDLファイルを開きます。 Oracle JDeveloperのWSDLエディタでファイルを表示するには、「パートナ・リンクの編集」ダイアログで「WSDL設定」の下にある「ローカル・ファイルシステムからWSDLファイルを参照」アイコンをクリックし、ファイルを特定して「オープン」をクリックします。

    図10-34に、与信検証サービスのWSDLファイルの一部を示します。

    図10-34 WebサービスのWSDLファイル

    この図の詳細は、周辺の説明を参照してください。

  8. importタグのlocation属性には、WebサービスのWSDL URLが含まれています。 このURLをゲートウェイ・サービスのWSDL URLに置き換えます。

    ゲートウェイ・サービスのWSDL URLは、Web Services Manager Control Consoleで、「ポリシー管理」をクリックし、次に「サービスの登録」をクリックして取得できます。 関連のゲートウェイに対する「サービス」をクリックし、そのサービスの「詳細の表示」をクリックします。

    図10-35に、与信検証サービスを保護するゲートウェイのURLの例を示します。

    図10-35 サービスのWSDL URLの検索

    この図の詳細は、周辺の説明を参照してください。

  9. このサービスのWSDL URLをコピーして、サービスのWSDLファイルの「location」フィールドに貼り付けます。 図10-36に、URLを更新した後のファイルを示します。

    図10-36 場所を更新した後のWebサービスのWSDLファイル

    この図の詳細は、周辺の説明を参照してください。

  10. ファイルを保存します。 プロセスをコンパイルして再デプロイします。

10.4.6 証明書キーストアの作成方法

Oracle Web Services Managerで暗号化および復号化を実行するために、Oracle Web Services Managerキーストアには、ゲートウェイおよびエージェントの両方の証明書が含まれています。 この項では、Javaのkeytoolユーティリティを起動して、必要なキーストアを生成します。

証明書キーストアを作成する手順は、次のとおりです。

  1. コマンド・プロンプトを開きます。 BPEL Developer Promptである必要はありません。任意のコマンド・ウィンドウでかまいません。

    JAVA_HOME/binディレクトリに移動します。

  2. キーストアの作成に必要なパラメータを使用して、keytoolコマンドを実行します。 図10-37に示すように、このコマンドは複数行にわたりますが、改行や区切りのない1行です。

    図10-37 keytoolコマンド

    この図の詳細は、周辺の説明を参照してください。

    注意:

    keytoolコマンドをパラメータなしで実行すると、コマンド・オプションを表示できます。

    -keystoreパラメータ値を使用してキーストアの場所を指定する場合は、パスを指定できます。特定のパス要件はなく、キーストアはシステム上の任意の場所に配置できます。

    図10-37の例では、カレント・ディレクトリのC:\Demoに、orderbooking.jksというキーストアが作成されています。

  3. 一連の質問が表示されます。 キーストアは、これらの質問に答えた後に作成されます。

    コマンド・ラインおよび後続のダイアログに入力した情報をメモします。これは、この情報が後でゲートウェイのポリシー・ステップを定義するときに必要になるためです。

  4. コマンド・ウィンドウを閉じます。

10.4.7 証明書キーストアに関する注意事項

キーストアの前述の説明では、ゲートウェイ(クライアント側)に対する単一のキーストアの設定について説明しました。 実際のシナリオでは、証明書キーストアは、クライアント側とサーバー側の両方に必要です。

メッセージ・セキュリティを実装する処理によって、特定の構成詳細が生成されます。 柔軟性のために、Oracle Web Services Managerには、様々なポリシー・ステップが用意されています。 たとえば、メッセージの暗号化と署名はそれぞれ個別のポリシー・ステップで実行できます。この場合、復号化および署名の検証は、逆の順序で個別に実行する必要があります。

詳細は、次のマニュアルを参照してください。

  • 『Oracle Web Services Manager管理者ガイド』。 付録の「Oracle Web Services Managerのポリシー・ステップ」では、特定の暗号化、復号化および署名の各ステップの使用方法とコンテキストに関する詳細について説明しています。

  • 『Oracle Web Services Managerデプロイメント・ガイド』。 Oracle Business Process Execution Languageとの統合に関する章では、証明書をインストールして、暗号化と復号化および署名と検証を容易にする方法について説明しています。

10.4.8 暗号化と復号化のポリシー・ステップの定義方法

ポリシー・ステップの設定は、1)Oracle BPEL Process ManagerクライアントからOracle WSM Gatewayに送信されたOracle Web Services Managerのメッセージを暗号化するために必要であり、2)Oracle WSM Server Agent(SOA Order Bookingアプリケーションでは、このエージェントによって与信検証サービスがラップされます)が受け取るメッセージを復号化するために必要です。

暗号化ポリシー・ステップを定義する手順は、次のとおりです。

  1. Oracle Web Services ManagerのWeb Services Manager Control Consoleにログインします。

  2. 「ポリシー管理」を選択し、次に「サービスの登録」をクリックして、ゲートウェイを表示します。

  3. 目的のゲートウェイに対する「サービス」リンクをクリックします。 ゲートウェイに対するサービスのリストが表示されます。

  4. 目的のサービスの「編集」アイコンをクリックします。 サービスの詳細が表示されます。

    第10.4.1項「ゲートウェイの登録方法」で設定したBPEL Gatewayで構成されたサービスは、BPEL Gatewayサービスのみです。

  5. 「サービス・ポリシー」で、「ポリシーの変更」をクリックします。 ポリシー・パイプラインのページが表示されます。

  6. 該当するポリシーのリクエスト・パイプラインおよびレスポンス・パイプラインには、デフォルトで、「ログ」ステップが含まれています。このステップを使用すると、SOAPメッセージをポリシー実行点で記録できます。 リクエスト・パイプラインの「パイプラインの開始」で「以下にステップを追加」を選択し、「ログ」ステップの下に新規ステップを追加します。

  7. 図10-38に示すように、「新規ステップ」ダイアログ・ボックスが表示されます。 リストから「XML暗号化」を選択します。

    図10-38 XML暗号化ポリシー・ステップの追加

    この図の詳細は、周辺の説明を参照してください。

    ダイアログ・ボックスで「OK」をクリックします。 暗号化ステップが、リクエスト・パイプラインに表示されます。

  8. 作成した「XML暗号化」ステップに対する「構成」リンクをクリックします。 図10-39に示すように、パイプライン・ステップの構成詳細ページが表示されます。

    図10-39 「XML暗号化」ステップに関する詳細の追加

    この図の詳細は、周辺の説明を参照してください。

    このページに入力する必要のある情報は、次のとおりです。

    • キーストアの場所(キーストアの作成時に指定した場所)

    • 暗号化キーストア・タイプ(この例ではjks

    • キーストア・パスワード

    • 復号化機能の公開鍵の別名

    • 暗号化されたコンテンツ(BODY)

    • 暗号化に関する追加詳細

  9. 「OK」をクリックします。

これによって、Oracle BPEL Process ManagerクライアントからWebサービスに送信するコンテンツを暗号化するためのステップが完了しました。

復号化ポリシー・ステップを定義する手順は、次のとおりです。

  1. Web Services Manager Control Consoleで、「ポリシー管理」をクリックし、次に「ポリシーの管理」をクリックしてコンポーネント・リストを表示します。

  2. Oracle Web Services Managerコンポーネントのリストから、目的のWebサービスに関連付けられているサーバー・エージェントを検索します。 たとえば、Authentication Agentは、与信検証サービスを保護するサーバー・エージェントです。

    「ポリシー」をクリックし、デフォルトのポリシーに対応する「編集」アイコンをクリックします。

  3. エージェント・ポリシーが表示されます。 リクエスト・パイプラインまで下にスクロールし、「パイプラインの開始」で「以下にステップを追加」をクリックし、「ログ」ステップの上に新規ステップを追加します。

  4. 「新規ステップ」リストから「XML復号化」を選択し、ダイアログ・ボックスの下にある「OK」を押します。

  5. 作成した「XML復号化」ステップに対する「構成」リンクをクリックします。 図10-40に示すように、パイプライン・ステップの構成詳細ページが表示されます。

    図10-40 「XML復号化」ステップに関する詳細の追加

    この図の詳細は、周辺の説明を参照してください。

    このページに入力する必要のある情報は、次のとおりです。

    • キーストアの場所

    • 復号化キーストア・タイプ(jks

    • キーストア・パスワード

    • 復号化機能の秘密鍵の別名

    • 復号化機能の秘密鍵のパスワード

    • 暗号化の実施(true

  6. 「OK」をクリックしてから「次へ」をクリックし、次に「保存」をクリックします。

  7. ポリシー・セット・ページで、ページ上部にある「コミット」をクリックします。

これによって、Webサービス・エンド・ポイントで受信するメッセージを復号化するステップが完了しました。

10.4.9 メッセージの暗号化のテスト方法

コンテンツの暗号化と復号化は、Oracle BPEL Process ManagerプロセスとWebサービス間のメッセージ・フローとして、TCPトンネリングを開いてメッセージ・トラフィックを監視することで観察できます。


注意:

Oracle JDeveloperのHTTPアナライザを使用すると、プロキシがWebサービスに接続し、そのサービスがレスポンスを戻すときに渡されるSOAPメッセージのコンテンツを確認することもできます。 第5.4項「JDeveloperでのWebサービスのデバッグ、テストおよび分析」を参照してください。

メッセージ・トラフィックを観察する手順は、次のとおりです。

  1. Windowsの「スタート」メニューからBPEL Developer Promptを開きます。 次に例を示します。

    「スタート」メニューから、「すべてのプログラム」「Oracle BPEL Process Manager 10.1.2」「Developer Prompt」の順にクリックします。

  2. Developer Promptで、次のコマンドを入力します。

    obtunnel

    これによって、TCPトンネリングが開始されます。

  3. TCPMonitor Consoleで、「ポート」フィールドおよび「ホスト」フィールドに適切な値が設定されていることを確認します。たとえば、「1234」および「8888」などです。 値が設定されていない場合は、「停止」をクリックし、値を設定して「開始」をクリックします。

  4. アプリケーションを実行して、メッセージ・フローを開始します。 たとえば、SOA Order Bookingアプリケーションを実行して顧客注文を発行します。 このフローは、「進行中のBPELプロセス・インスタンス」の下にあるOracle BPEL Process Manager Consoleフロー・ビューアで観察できます。

  5. TCPトンネリング・ウィンドウを再度参照します。 上部のウィンドウは、メッセージ本文が暗号化されたことを示します。 メッセージは、このように暗号化されてネットワーク間を移動しました。 相手側のOracle Web Services Manager Server Agentでは、このメッセージがWebサービス用に復号化されます。