Oracle® Fusion Middleware

Webサービスの管理

E82678-01(原本部品番号:E78153-01)

2016年10月

Webサービスの管理方法を説明した開発者および管理者向けのドキュメント

Oracle Fusion Middleware Webサービスの管理

E82678-01

Copyright © 2016, Oracle and/or its affiliates.  All rights reserved.

原本著者: Oracle Corporation

このソフトウェアおよび関連ドキュメントの使用と開示は、ライセンス契約の制約条件に従うものとし、知的財産に関する法律により保護されています。ライセンス契約で明示的に許諾されている場合もしくは法律によって認められている場合を除き、形式、手段に関係なく、いかなる部分も使用、複写、複製、翻訳、放送、修正、ライセンス供与、送信、配布、発表、実行、公開または表示することはできません。このソフトウェアのリバース・エンジニアリング、逆アセンブル、逆コンパイルは互換性のために法律によって規定されている場合を除き、禁止されています。

ここに記載された情報は予告なしに変更される場合があります。また、誤りが無いことの保証はいたしかねます。誤りを見つけた場合は、オラクル社までご連絡ください。

このソフトウェアまたは関連ドキュメントを、米国政府機関もしくは米国政府機関に代わってこのソフトウェアまたは関連ドキュメントをライセンスされた者に提供する場合は、次の通知が適用されます。

U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are "commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, use, duplication, disclosure, modification, and adaptation of the programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, shall be subject to license terms and license restrictions applicable to the programs. No other rights are granted to the U.S. Government.

このソフトウェアもしくはハードウェアは様々な情報管理アプリケーションでの一般的な使用のために開発されたものです。このソフトウェアもしくはハードウェアは、危険が伴うアプリケーション(人的傷害を発生させる可能性があるアプリケーションを含む)への用途を目的として開発されていません。このソフトウェアもしくはハードウェアを危険が伴うアプリケーションで使用する際、安全に使用するために、適切な安全装置、バックアップ、冗長性(redundancy)、その他の対策を講じることは使用者の責任となります。このソフトウェアもしくはハードウェアを危険が伴うアプリケーションで使用したことに起因して損害が発生しても、オラクル社およびその関連会社は一切の責任を負いかねます。

OracleおよびJavaはOracle Corporationおよびその関連企業の登録商標です。その他の名称は、それぞれの所有者の商標または登録商標です。

Intel、Intel Xeonは、Intel Corporationの商標または登録商標です。すべてのSPARCの商標はライセンスをもとに使用し、SPARC International, Inc.の商標または登録商標です。AMD、Opteron、AMDロゴ、AMD Opteronロゴは、Advanced Micro Devices, Inc.の商標または登録商標です。UNIXは、The Open Groupの登録商標です。

このソフトウェアまたはハードウェア、そしてドキュメントは、第三者のコンテンツ、製品、サービスへのアクセス、あるいはそれらに関する情報を提供することがあります。適用されるお客様とOracle Corporationとの間の契約に別段の定めがある場合を除いて、Oracle Corporationおよびその関連会社は、第三者のコンテンツ、製品、サービスに関して一切の責任を負わず、いかなる保証もいたしません。適用されるお客様とOracle Corporationとの間の契約に定めがある場合を除いて、Oracle Corporationおよびその関連会社は、第三者のコンテンツ、製品、サービスへのアクセスまたは使用によって損失、費用、あるいは損害が発生しても一切の責任を負いかねます。

目次

例一覧

図一覧

表一覧

タイトルおよび著作権情報

はじめに

- このガイドについて

- 対象読者

- ドキュメントのアクセシビリティについて

- 関連ドキュメント

- 表記規則

新機能

- リリース12c (12.2.1.1)の新機能と変更された機能

- リリース12c (12.2.1)の新機能と変更された機能

- リリース12c (12.1.3)の新機能と変更された機能

- リリース12c (12.1.2)の新機能と変更された機能

- リリース12c (12.1.2)でのこのドキュメントにおけるその他の重要な変更

1 Webサービス管理の概要

- 1.1 Oracle Fusion Middleware 12cにおけるWebサービスの管理

- 1.2 Webサービス管理タスクのロードマップ

2 管理ツールへのアクセス

- 2.1 Oracle Enterprise Manager Fusion Middleware Controlへのアクセス

- 2.2 Oracle WebLogic管理コンソールへのアクセス

- 2.3 WebサービスのカスタムWLSTコマンドへのアクセス

3 Webサービス・アプリケーションのデプロイ

- 3.1 Webサービス・アプリケーション・デプロイの概要

- 3.2 Webサービス・アプリケーションのデプロイ

- 3.3 Webサービス・アプリケーションのアンデプロイ

- 3.4 Webサービス・アプリケーションの再デプロイ

4 Webサービスの管理

- 4.1 Fusion Middleware Controlを使用したWebサービス管理の概要

- 4.1.1 サポートされるユーザー・ロールのアクセス権限の理解

- 4.1.2 Fusion Middleware Controlを使用したWebサービスの表示の概要

- 4.1.2.1 Fusion Middleware Controlを使用したサーバーのWebサービスの表示

- 4.1.2.2 Fusion Middleware Controlを使用したアプリケーションのデプロイにおけるWebサービスの表示

- 4.1.2.3 アプリケーションの「Webサービスのサマリー」ページの表示

- 4.1.2.4 Java EE Webサービスのサマリー・ページの表示

- 4.1.2.5 SOAコンポジットのWebサービスと参照の表示

- 4.1.2.6 Fusion Middleware Controlを使用したWebサービス・エンドポイントの詳細の表示の概要

- 4.1.2.6.1 SOAコンポジット・アプリケーションの詳細の表示

- 4.1.2.6.2 SOA以外のOracle Infrastructure Webサービス・エンドポイントの詳細の表示

- 4.1.2.6.3 Java EE Webサービス・エンドポイントの詳細の表示

- 4.1.2.6.4 Java EE Webサービス操作の詳細の表示

- 4.1.2.6.5 RESTfulサービス・アプリケーションの詳細の表示

- 4.1.3 Fusion Middleware Controlを使用したWebサービス・クライアントの表示の概要

- 4.1.3.1 SOA参照の表示

- 4.1.3.2 接続ベースのWebサービス・クライアントの表示

- 4.1.3.3 Java EE Webサービス・クライアントの表示

- 4.1.3.4 非同期のWebサービス・コールバック・クライアントの表示

- 4.1.4 Fusion Middleware Controlを使用したWebサービスの構成の概要

- 4.1.4.1 Fusion Middleware Controlを使用したアドレス指定の構成

- 4.1.4.2 Fusion Middleware Controlを使用した非同期Webサービスの構成

- 4.1.4.3 Fusion Middleware Controlを使用した非同期WebサービスのJMSシステム・ユーザーの変更

- 4.1.4.4 Fusion Middleware Controlを使用した信頼性のあるメッセージの構成

- 4.1.4.5 Fusion Middleware Controlを使用した原子性トランザクションの構成

- 4.1.4.6 Fusion Middleware Controlを使用したMTOMの構成

- 4.1.4.7 Fusion Middleware Controlを使用したFast Infosetの構成

- 4.1.4.8 Fusion Middleware Controlを使用した永続性の構成

- 4.1.4.9 Fusion Middleware Controlを使用したSOAP Over JMS Transportの構成

- 4.1.4.10 Fusion Middleware Controlを使用したWebサービスの有効化または無効化

- 4.1.4.11 Fusion Middleware Controlを使用したWebサービスWSDLドキュメントへのパブリック・アクセスの有効化または無効化

- 4.1.4.12 Fusion Middleware Controlを使用したSOAPプロセスの有効化または無効化

- 4.1.4.13 Fusion Middleware Controlを使用したNon-SOAP XMLメッセージ・プロセスの有効化または無効化

- 4.1.4.14 Fusion Middleware Controlを使用した診断ログのログ・レベルの設定

- 4.1.4.15 Fusion Middleware Controlを使用したWebサービスのテスト・クライアントの有効化または無効化の概要

- 4.1.4.15.1 Fusion Middleware Controlを使用したドメイン・レベルのWebサービスのテスト・クライアントの有効化または無効化

- 4.1.4.16 Fusion Middleware Controlを使用したメタデータの交換の有効化または無効化

- 4.1.4.17 Fusion Middleware Controlを使用したMTOMエンコード失敗メッセージの構成

- 4.1.4.18 Fusion Middleware Controlを使用したリクエスト・メッセージの検証

- 4.1.4.19 Fusion Middleware Controlを使用したリクエスト・メッセージのサイズの設定

- 4.1.4.20 Fusion Middleware Controlを使用したバイナリ・コンテンツのキャッシングの有効化または無効化

- 4.1.5 Fusion Middleware Controlを使用したWebサービス・クライアントの構成の概要

- 4.1.5.1 Webサービス・クライアントの構成プロパティ

- 4.1.5.2 SOA参照の構成

- 4.1.5.3 接続ベースのWebサービス・クライアントの構成

- 4.1.5.4 非同期Webサービスのコールバック・クライアントの構成

- 4.1.6 Fusion Middleware Controlを使用したWSDLの管理の概要

- 4.1.6.1 WebサービスWSDLドキュメントの表示

- 4.1.6.2 WebサービスWSDLドキュメントへのパブリック・アクセスの有効化または無効化

- 4.2 WLSTを使用したWebサービス管理の概要

- 4.2.1 WLSTを使用したドメイン内でのWebサービスの表示

- 4.2.2 WLSTを使用したアプリケーション内でのWebサービスの表示

- 4.2.3 WLSTを使用したWebサービス・エンドポイントの詳細の表示

- 4.2.4 WLSTを使用したWebサービス・クライアントの表示

- 4.2.5 WLSTを使用したWebサービスの構成の概要

- 4.2.5.1 WLSTを使用したアドレス指定の構成

- 4.2.5.2 WLSTを使用した非同期Webサービスの構成

- 4.2.5.3 WLSTを使用した非同期WebサービスのJMSシステム・ユーザーの構成

- 4.2.5.4 WLSTを使用した信頼性のあるメッセージの構成

- 4.2.5.5 WLSTを使用した原子性トランザクションの構成

- 4.2.5.6 WLSTを使用したMTOMの構成

- 4.2.5.7 WLSTを使用したFast Infosetの構成

- 4.2.5.8 WLSTを使用したSOAP Over JMS Transportの構成

- 4.2.5.9 WLSTを使用した永続性の構成

- 4.2.5.10 WLSTを使用したWebサービスの有効化または無効化

- 4.2.5.11 WLSTを使用したWebサービスWSDLドキュメントへのパブリック・アクセスの有効化または無効化

- 4.2.5.12 WLSTを使用したSOAPリクエストのプロセスの有効化または無効化

- 4.2.5.13 WLSTを使用したNon-SOAP XMLメッセージ・プロセスの有効化または無効化

- 4.2.5.14 WLSTを使用した診断ログのログ・レベルの設定

- 4.2.5.15 WLSTを使用したWebサービスのテスト・クライアントの有効化または無効化の概要

- 4.2.5.15.1 WLSTを使用したドメイン・レベルのWebサービスのテスト・クライアントの有効化または無効化

- 4.2.5.15.2 WLSTを使用したWebサービスのエンドポイント・レベルのWebサービスのテスト・クライアントの有効化または無効化

- 4.2.5.16 WLSTを使用したメタデータの交換の有効化または無効化

- 4.2.5.17 WLSTを使用したMTOMエンコード化SOAPフォルト・メッセージの有効化または無効化

- 4.2.5.18 WLSTを使用したリクエスト・メッセージの検証

- 4.2.5.19 WLSTを使用したリクエスト・メッセージの最大サイズの設定

- 4.2.5.20 コンテンツのバイナリ・キャッシングの構成

- 4.2.6 WLSTを使用したWebサービス・クライアントの構成

5 Webサービスのテスト

- 5.1 Webサービス・テストの概要

- 5.2 Webサービスのテスト・クライアントの使用

- 5.2.1 Webサービスのテスト・クライアントの起動

- 5.2.1.1 ブラウザからのWebサービスのテスト・クライアントの起動

- 5.2.1.2 Webサービス・エンドポイントを使用したWebサービスのテスト・クライアントの起動

- 5.2.1.3 管理コンソールを使用したWebサービスのテスト・クライアントの起動

- 5.2.2 テストするWebサービスの選択

- 5.2.3 Webサービス・オペレーションのテスト

- 5.2.4 基本的なテスト設定の構成

- 5.2.5 Webサービスの高度な機能およびセキュリティのテスト

- 5.2.5.1 アドレスのテスト

- 5.2.5.2 原子性トランザクションのテスト

- 5.2.5.3 MTOMのテスト

- 5.2.5.4 Fast Infosetのテスト

- 5.2.5.5 OWSMセキュリティ・ポリシーのテスト

- 5.2.6 WSDLおよびインポートされたスキーマの表示

- 5.2.7 Webサービスのテスト・クライアントの構成

- 5.2.7.1 HTTPプロキシの構成

- 5.2.7.2 JKSキーストアの構成

- 5.2.7.3 デフォルトの作業ディレクトリの構成

- 5.2.8 入力引数のXMLソースとしての編集

- 5.2.9 履歴の表示

- 5.2.10 テスト・ケースのエクスポートおよびインポート

- 5.2.10.1 テスト・ケースのエクスポート

- 5.2.10.2 テスト・ケースのインポート

- 5.2.11 Webサービスのテスト・クライアントの有効化および無効化

- 5.2.12 Webサービスのテスト・クライアントのログアウト

- 5.3 Fusion Middleware Controlの「Webサービスのテスト」ページ

- 5.3.1 テストのためのWebサービスへのアクセス

- 5.3.2 SOAP Webサービスのテスト

- 5.3.3 非同期Webサービスのテスト

- 5.3.4 RESTful Webサービスのテストの概要

- 5.3.4.1 RESTful Webサービスのテスト

- 5.3.4.2 WebRestApp1 Webサービス

- 5.3.4.2.1 GET personsメソッド

- 5.3.4.2.2 GET headerGetPersonメソッド

- 5.3.4.2.3 GET person{id}メソッド

- 5.3.4.2.4 POST personMatrixAddメソッド

- 5.3.4.2.5 POST personXXXAddメソッド

- 5.3.4.2.6 POST personPathAddメソッド

- 5.3.4.2.7 POST headerAddPersonメソッド

- 5.3.4.2.8 POST personQueryAddメソッド

- 5.3.4.2.9 POST personAddFormメソッド

- 5.3.4.2.10 POST personQueryDefaultAddメソッド

- 5.3.4.2.11 DELETE persondeleteメソッド

- 5.3.4.2.12 PUT personUpdateメソッド

- 5.3.4.2.13 POST verifyPart1メソッド

- 5.3.4.3 Mime_Multipart_rs Webサービス

- 5.3.4.3.1 POST greetingsMultipartメソッド

- 5.3.4.3.2 GET greetingsメソッド

- 5.3.4.3.3 POST greetingsImagePOSTメソッド

- 5.3.4.3.4 GET greetings_matrix_toメソッド

- 5.3.4.3.5 GET greetings_query_toメソッド

- 5.3.4.3.6 GET greetingsMsgメソッド

- 5.3.4.3.7 POST greetingsImagePOST1メソッド

- 5.3.4.3.8 POST greetingsMsgQPメソッド

- 5.3.4.3.9 GET helloメソッド

- 5.3.5 セキュリティのテスト

- 5.3.5.1 OWSMセキュリティ・ポリシー

- 5.3.5.2 SOAPおよびRESTful OWSMセキュリティ・ポリシー

- 5.3.5.3 HTTP Basic認証

- 5.3.5.4 拡張

- 5.3.5.5 SOAPサービスのサポートされているクライアント・セキュリティ・ポリシー

- 5.3.5.6 RESTfulサービスのサポートされているクライアント・セキュリティ・ポリシー

- 5.3.6 サービスのクオリティ・テストの有効化

- 5.3.7 HTTPヘッダーのテスト

- 5.3.8 入力引数のXMLソースとしての編集

- 5.3.9 Webサービス操作のストレス・テスト

6 Webサービスの監視および監査

- 6.1 パフォーマンスの監視、監査、およびチューニングの概要

- 6.2 Webサービスの監視の概要

- 6.2.1 Webサービス統計の開始またはリセットのタイミング

- 6.2.2 サーバー・インスタンスのWebサービス統計の表示

- 6.2.3 アプリケーションのWebサービス統計の概要

- 6.2.3.1 SOAコンポジット・アプリケーションのWebサービス統計の表示

- 6.2.3.2 SOA以外のOracle Infrastructure Webサービス・アプリケーションのWebサービス統計の表示

- 6.2.3.3 Java EEアプリケーションのWebサービス統計の表示

- 6.2.4 個々のWebサービスのWebサービス統計の表示

- 6.2.5 Webサービス・エンドポイントの操作統計の表示

- 6.2.6 Java EE Webサービス操作の統計の表示

- 6.2.7 Java EE Webサービス・クライアントの統計の表示

- 6.2.8 RESTfulリソースの統計の表示

- 6.2.9 SOAバインディング・コンポーネントの統計の表示

- 6.2.10 Webサービスのセキュリティ違反の表示の概要

- 6.2.10.1 Oracle Infrastructure Webサービスのセキュリティ違反の表示

- 6.2.10.2 Java EE JAX-WS Webサービスのセキュリティ違反の表示

- 6.2.10.3 Java EE JAX-RPC Webサービスのセキュリティ違反の表示

- 6.3 Webサービスの監査

- 6.3.1 監査ポリシーの構成

- 6.3.2 監査データの収集および格納の管理

- 6.3.3 監査レポートの表示

7 診断ログおよびメッセージ・ログの管理

- 7.1 ログを使用した問題の診断の概要

- 7.1.1 Webサービス診断ログの概要

- 7.1.1.1 診断ログのログ・レベルの設定

- 7.1.1.2 診断ログの表示

- 7.1.1.3 診断ログのフィルタ処理

- 7.1.1.4 OWSMデバッグ・メッセージのロギング

- 7.1.2 Webサービス診断ログの概要

- 7.1.2.1 メッセージ・ログの構成

- 7.1.2.2 メッセージ・ログの表示

- 7.1.2.3 メッセージ・ログのフィルタ処理

- 7.1.3 サンプル・ログ

- 7.1.3.1 サンプル・ログ: OWSM Policy Manager使用不可

- 7.1.3.2 サンプル・ログ: セキュリティ・キーストア未構成

- 7.1.3.3 サンプル・ログ: 証明書使用不可

- 7.2 Webサービスのログ・ファイルの構成

8 環境間のアプリケーション移行の管理

- 8.1 Webサービス・アプリケーションの移行の概要

- 8.1.1 Webサービス・アプリケーション移行の概要

- 8.1.2 開発またはテスト環境から本番環境へのWebサービス・アプリケーションの移行

- 8.2 ポリシーの作成と異なるステージでの水平移行

- 8.3 ポリシーの移行

- 8.4 ポリシー構成の移行の概要

- 8.4.1 キーストアの移行

- 8.4.2 ユーザーおよびグループの移行

- 8.4.3 資格証明の移行

- 8.4.3.1 ユーザー名およびパスワードの移行

- 8.4.3.2 キーストアおよび暗号化キー・パスワードの移行

- 8.4.4 Oracle Platform Security Servicesアプリケーションおよびシステム・ポリシーの移行

- 8.4.5 Oracle Platform Security Services構成の移行

- 8.4.6 SSLの移行

- 8.4.7 Kerberos構成の移行

- 8.5 アサーション・テンプレートの移行

9 Webサービスの表示、登録および公開

- 9.1 Webサービスとソースの登録の概要

- 9.1.1 UDDIの基本の理解

- 9.1.2 WSILの基本の理解

- 9.1.3 登録済ソースとWebサービスの表示

- 9.1.4 ソースの登録

- 9.1.5 UDDIソースからのWebサービスの登録

- 9.1.6 WSILソースからのWebサービスの登録

- 9.1.7 WebサービスまたはWebサービス・ソースの削除

- 9.2 UDDIへのWebサービスのパブリッシュの概要

- 9.2.1 登録済ソースからUDDIへのWebサービスの公開

- 9.2.2 アプリケーションからUDDIへのWebサービスの公開

- 9.2.3 UDDIのプロキシ・サーバーの構成

A Webサービス監査イベントのリファレンス

- A.1 Webサービス監査イベント

- A.1.1 OWSM-AGENTのイベントと属性

- A.1.2 OWSM-PM-EJBのイベントと属性

- A.1.3 Webサービス・ポリシー・アタッチメントのイベントと属性

- A.1.4 Oracle Webサービスのイベントと属性

- A.2 ビルトイン監査レポート

例の一覧

図一覧

- 3-1 「アーカイブの選択」ページ

- 3-2 「ターゲットの選択」ページ

- 3-3 「アプリケーション属性」ページ

- 3-4 「デプロイメント設定」ページ

- 3-5 デプロイ・プランの編集

- 3-6 再デプロイ中におけるアプリケーション属性の設定

- 4-1 サーバーのWebサービス・サマリー・ページ

- 4-2 ADFアプリケーションの「Webサービスのサマリー」ページ

- 4-3 Java EEアプリケーションの「Webサービスのサマリー」ページ

- 5-1 「Webサービスのテスト」ページ(折りたたんだ表示)

- 5-2 WSDLの「Webサービスのテスト」ページの下部(展開表示)

- 5-3 WSDLのテストの成功

- 5-4 データ検証エラー

- 5-5 テストWebサービス・ページの非同期テスト・オプション

- 5-6 非同期Webサービスのテストの成功およびレスポンス

- 5-7 テスト・レスポンスを示す「非同期レスポンス・テスト」ページ

- 5-8 WADL用のWebサービスのテスト・ページ

- 5-9 WADLのテストの成功

- 5-10 データ検証エラー

- 5-11 SOAP WebサービスのOWSMセキュリティ・ポリシー・テスト・オプション

- 5-12 RESTful WebサービスのOWSMセキュリティ・ポリシー・テスト・オプション

- 5-13 「拡張」テスト・オプション

- 5-14 「Webサービスのテスト」ページのサービスのクオリティのパラメータ

- 5-15 テストWebサービス・ページのHTTPヘッダー

- 5-16 入力引数 - XML表示

- 5-17 入力引数 - ツリー表示

- 5-18 「Webサービスのテスト」ページのストレス・テストのパラメータ

- 5-19 「Webサービスのテスト」ページのストレス・テストの結果

- 6-1 SOAコンポジット・アプリケーションのダッシュボード

- 6-2 アプリケーションのWebサービス・パフォーマンスのサマリーとグラフ

- 6-3 Java EE Webサービスのサマリー

- 6-4 個々のOracle Infrastructure WebサービスのWebサービス統計

- 6-5 Java EE Webサービス・クライアントの統計

- 6-6 SOAバインディング・コンポーネントの統計

- 6-7 Java EE JAX-RPC Webサービス・エンドポイントのセキュリティ違反

- 7-1 「ログ・レベル」ページ

- 7-2 「ログ・メッセージ」ページ

- 7-3 「ログ・ファイルの編集」ページ

- 9-1 登録済ソースとサービスの表示

- 9-2 「新規ソースの登録」ページ

- 9-3 UDDIソースからの新規サービスの登録

- 9-4 WSILソースからの新規サービスの登録

- 9-5 「UDDIにパブリッシュ」が選択された「登録済ソースおよびサービス」ページ

- 9-6 サービスをUDDIソースからUDDIウィンドウにパブリッシュ

- 9-7 「UDDIにパブリッシュ」が選択された「Webサービスのサマリー」ページ

- 9-8 「UDDIへのサービスの公開」ダイアログ・ボックス

表一覧

- 1-1 Webサービス管理タスクに使用されるツール

- 4-1 サポートされるロールごとのOracle Web Services Manager権限

- 4-2 非同期Webサービスの構成プロパティ

- 4-3 Webサービス・クライアントの構成プロパティ

- 5-1 基本的なテスト・クライアント設定

- 5-2 WSアドレシングのテスト設定

- 5-3 原子性トランザクションのテスト設定

- 5-4 MTOMのテスト設定

- 5-5 Fast Infosetのテスト設定

- 5-6 OWSMのテスト設定

- 6-1 Java EE Webサービス・クライアントの呼出し統計

- 6-2 Java EE Webサービス・クライアントのWebLogicポリシー違反

- 6-3 RESTfulリソースのサマリー

- 6-4 RESTfulリソースのサマリー統計

- 6-5 RESTfulリソースのメソッドおよびリクエスト統計

- 6-6 エンドポイントのポリシー違反情報

- 6-7 WebLogicポリシー違反データ

- 6-8 Webサービスのイベントの監査

- 7-1 OWSMデバッグ・メッセージのロギングの起動プロパティ

- 7-2 OWSMのデフォルトのログ・ファイル

- 7-3 「ログ・ファイルの編集」ページのフィールド

- 9-1 UDDIのプロキシ・サーバーを指定するために使用されるJavaシステム・プロパティ

- A-1 OWSM-AGENTイベント

- A-2 OWSM-PM-EJBイベント

- A-3 WSポリシー・アタッチメントのイベント

- A-4 Oracle Webサービス・イベント

はじめに

この項では、対象読者、このガイドの使用方法を説明し、ドキュメントのアクセシビリティについての情報を提供します。

このガイドについて

このガイドでは、Webサービスを管理するために必要なタスクを説明します。詳細は次のとおりです。

- Webサービスをデプロイ、構成、テストおよび監視します。

- 診断ログおよびメッセージ・ログを管理します。

- ポリシーのライフサイクルを管理して、テスト環境から本番環境へ移行します。

- Webサービスを有効化、公開および登録します。

対象読者

このガイドの対象読者は次のとおりです。

- Webサービスおよびセキュリティを管理するシステムおよびセキュリティ管理者

- Webサービスを開発し、Webサービスをデプロイする前にセキュリティのテストを行うアプリケーション開発者

- セキュリティ・ポリシーを作成するセキュリティ・アーキテクト

ドキュメントのアクセシビリティについて

Oracleのアクセシビリティへの取り組みについては、Oracle Accessibility ProgramのWebサイト(http://www.oracle.com/pls/topic/lookup?ctx=acc&id=docacc)にアクセスしてください。

Oracle Supportへのアクセス

サポートをご購入のOracleのお客様は、My Oracle Supportにアクセスして電子サポートを受けることができます。詳細は、http://www.oracle.com/pls/topic/lookup?ctx=acc&id=info、聴覚に障害があるお客様はhttp://www.oracle.com/pls/topic/lookup?ctx=acc&id=trsを参照してください。

関連ドキュメント

詳細は、次のOracle Web Services Managerドキュメントを参照してください。

- 『Oracle JDeveloperによるアプリケーションの開発』のWebサービスの開発および保護に関する項

- Oracle Web Services Manager拡張可能アプリケーションの開発

- Oracle Application Development FrameworkによるFusion Webアプリケーションの開発

- Oracle WebLogic Server JAX-RPC Webサービスの開発

- Oracle WebLogic Server JAX-WS Webサービスの開発

- Oracle Infrastructure Webサービスの開発

- 『Oracle SOA Suiteを使用したSOAアプリケーションの開発』

- Oracle Web Services Manager相互運用性ソリュー ション・ガイド

- Oracle WebLogic ServerのWebLogic Webサービスの保護

- Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理

- Oracle Web Services Managerの理解

- Oracle WebLogic ServerのWebLogic Webサービスの理解

- Webサービスの理解

- Oracle Web Services Managerを使用したWebサービスの保護のユース・ケース

- Oracle WebLogic ServerのWebLogic Webサービス・リファレンス

Oracle Web Services Managerテクノロジのサイトhttp://www.oracle.com/technetwork/middleware/webservices-manager/index.htmlも参照してください。

表記規則

このマニュアルでは次の表記規則を使用します。

表記規則

意味

太字

太字は、操作に関連するGraphical User Interface要素、または本文中で定義されている用語および用語集に記載されている用語を示します。

イタリック体

イタリックは、ユーザーが特定の値を指定するプレースホルダ変数を示します。

固定幅フォント

固定幅フォントは、段落内のコマンド、URL、サンプル内のコード、画面に表示されるテキスト、または入力するテキストを示します。

新機能

次の項では、Webサービス管理の新機能や変更された機能、およびこのガイドに記載されるその他の重要な変更について紹介し、詳細情報へのリンクを提供します。

リリース12c (12.2.1.1)の新機能と変更された機能

12cリリース12.2.1.1では、セキュリティのテストに、カスタム・ポリシーに関する追加情報が含まれるようになりました。

リリース12c (12.2.1)の新機能と変更された機能

このドキュメントに記載されているOracle Fusion Middleware 12c (12.2.1)の新機能と変更された機能は次のとおりです。

- 新しいリクエスト・タイプ「マルチパート・リクエスト」をサポートするRESTの強化。
詳細は、RESTful Webサービスのテストで、WebRestApp1 Webサービスと、Mime_Multipart_rs Webサービスを参照してください。

- RESTベースのWebサービスをテストする追加機能を提供するために拡張された「Webサービスのテスト」ページ。

- サーバー・アプリケーション・デプロイメント・ターゲット・ノードのOWSM関連のWebサービス・エンドポイント構成および監視機能を分割し、ドメイン・アプリケーション・デプロイメント・ターゲット・ノードに移動しました。

- JAX-RSアプリケーションの向上したサポートを提供し、詳細なデプロイメント・データおよび監視統計を提供し、デプロイされたアプリケーションの詳細ページのJAX-RSアプリケーション・リンクを有効にするためにWLSコンソールを強化しました。

- WS以外のプロトコルのテストおよび基本的な管理のサポート。

リリース12c (12.1.3)の新機能と変更された機能

このドキュメントに記載されているOracle Fusion Middleware 12c (12.1.3)の新機能と変更された機能は次のとおりです。

- Oracle SOA Suite (SOAP/RESTful Webサービス)のサポート。これらのコンポーネントについては、必要に応じてこのドキュメント全体を通して言及しています。具体的には次のようなセクションです。

- "SOAコンポジットのWebサービスと参照の表示"

- "SOAコンポジット・アプリケーションの詳細の表示"

- "SOA参照の表示"

- "SOA参照の構成"

- "SOAコンポジット・アプリケーションのWebサービス統計の表示"

- Fusion Middleware ControlのOWSMポリシーおよびポリシー・セット管理に必要なデプロイヤ・ロールのサポート。詳細は、「サポートされるユーザー・ロールのアクセス権限の理解」を参照してください。

- Fusion Middleware Controlの「Webサービスのテスト」ページからXMLペイロードを保存および閲覧する機能。詳細は、「SOAP Webサービスのテスト」を参照してください。

- RESTful WebサービスにおけるOWSMセキュリティ・ポリシーのテストのサポート。詳細は、次の項を参照してください。

- "RESTful Webサービスのテストの概要

- "セキュリティのテスト"

リリース12c (12.1.2)の新機能と変更された機能

このドキュメントにおける、Oracle Fusion Middleware 12c (12.1.2)の新機能と変更された機能は次のとおりです。

- WebサービスのWLSTフレームワークを再設計して、Webサービス・スタック全体に一貫性を提供します。その結果、多数の新規および非推奨になったOracle Infrastructure WebサービスのWLSTコマンドがあります。新しいコマンドは、このドキュメント全体の例で使用されています。非推奨のコマンドおよび相当する12cのコマンドの完全なリストは、Oracle Fusion Middleware Infrastructureのリリース・ノートの非推奨となったOracle Infrastructure Webサービスのコマンドに関する項を参照してください。

- 接続プロトコルとしてのSOAP Over JMSトランスポートのサポート(「Fusion Middleware Controlを使用したSOAP Over JMSトランスポートの構成」および「WLSTを使用したSOAP Over JMSトランスポートの構成」を参照)。

- テキスト・ベースのXMLフォーマットより効果的なシリアライズを提供する、圧縮バイナリ・エンコーディング・フォーマットを提供するFast Infosetサポート(「Fusion Middleware Controlを使用したFast Infosetの構成」および「WLSTを使用したFast Infosetの構成」を参照)。

- Webサービス機能を構成するための新しい事前定義済ポリシーおよび注釈。詳細は、Fusion Middleware Controlを使用したWebサービスの構成の概要と、WLSTを使用したWebサービスの構成の概要を参照してください。

- Webサービスの高度な機能をテストするため、拡張されたWebサービス・テスト・クライアント。「Webサービスのテスト・クライアントの使用」を参照してください。

- RESTfulおよび非同期WebサービスのテストをサポートするFusion Middleware ControlのテストWebサービス・ページの強化。詳細は、Fusion Middleware Controlの「Webサービスのテスト」ページを参照してください。

- Java EEおよびRESTful Webサービスの表示および監視が可能なFusion Middleware Controlの新規サマリー画面。詳細は、次を参照してください。

- "Fusion Middleware Controlを使用したアプリケーションのデプロイにおけるWebサービスの表示"

- "Java EE Webサービスのサマリー・ページの表示"

- "Java EE Webサービス操作の統計の表示"

- "RESTful Resourcesの統計の表示"

リリース12c (12.1.2)でのこのドキュメントにおけるその他の重要な変更

このガイドは12c (12.1.2)でいくつかの点が更新されました。次の表に、追加または変更された項を示します。

- Oracle Fusion Middleware 11gで提供されている『Webサービスのためのセキュリティおよび管理者ガイド』は、このリリースでは次の3つのドキュメントに分割されました。

- Oracle Web Services Managerの理解

- Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理

- 『Webサービスの管理』(このドキュメント)

- WebサービスのサマリーおよびOWSM監査イベントが追加されました。詳細は、「Webサービス監査イベントのリファレンス」を参照してください。

- WebサービスのサマリーおよびOracle Fusion Middleware Audit Frameworkを使用して監査可能なOWSMイベントは、『Oracle Platform Security Servicesによるアプリケーションの保護』からこのガイドへ移動されました。詳細は、「Webサービス監査イベントのリファレンス」を参照してください。

1 Webサービス管理の概要

この章では、Oracle Fusion Middleware 12cにおけるWebサービス管理の概要を説明します。世界中の企業がイントラネット環境およびインターネット環境の両方において、Webサービスを使用してサービス指向アーキテクチャ(SOA)を積極的にデプロイしています。Webサービスには従来の方法(オブジェクトの配布やカスタム・ソフトウェアなど)に比べて多くの利点がありますが、相互接続されたWebサービスのネットワークをデプロイするには、特にセキュリティと管理の面で依然として重大な課題があります。

この章の内容は次のとおりです。

- Oracle Fusion Middleware 12cにおけるWebサービスの管理

- Webサービス管理タスクのロードマップ

このマニュアルやその他のマニュアルの用語の定義については、「用語集」を参照してください。

1.1 Oracle Fusion Middleware 12cにおけるWebサービスの管理

Oracle Fusion Middleware 12cは、Oracle Infrastructure WebサービスとJava EE Webサービスをサポートしています。開発時に、アプリケーション開発者が、Oracle JDeveloperの使用またはプログラムによる注釈の使用によってポリシーを添付すると、Webサービスは保護されます。デプロイ後、システム管理者が、サービス・エンドポイントにまたはリファレンスによってエンドポイント全体にポリシーを添付すると、Webサービスは保護されます。

さらに、Webサービスを保護するために、システム管理者には次の作業が可能です。

- Webサービスをデプロイ、構成、テストおよび監視します。

- Webサービスを有効化、公開および登録します。

- ポリシーのライフサイクルを管理して、テスト環境から本番環境へ移行します。

- 他のWebサービスとの相互運用性をテストします。

Webサービスの保護およびWebサービス・ポリシーの管理の詳細は、Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理を参照してください。

1.2 Webサービス管理タスクのロードマップ

図1-1に、システム管理者がWebサービスの保護および管理に使用可能なツールを示します。これらの管理ツールへのアクセス方法に関する情報は、「管理ツールへのアクセス」を参照してください。

図1-1 Webサービス管理タスクに使用されるツール

使用するツール

実行するタスク

Oracle Enterprise Manager Fusion Middleware Control。

- Webサービス・アプリケーションのデプロイ

- RESTfulおよびOracle Infrastructure Webサービスおよびクライアントの表示と構成

- Java EE (WebLogic) Webサービスおよびクライアントの表示

- OWSMポリシーによるJava EE、RESTfulおよびOracle Infrastructure Webサービスの保護。OWSMを使用したWebサービスの保護の詳細は、Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理を参照してください。

- Webサービスのテスト。

- 実行時のパフォーマンスの監視およびWebサービスの監査。

- 診断ログおよびメッセージ・ログを管理します。

- Webサービスとソースの登録、および登録済Webサービスの公開。

注意:

- 『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のJava EE WebサービスをサポートするOWSMポリシーに関する項に記載されているように、一部のOWSMポリシーのみがJava EE Webサービスをサポートします。

- 『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のRESTful WebサービスをサポートするOWSMポリシーに関する項に記載されているように、一部のOWSMポリシーのみがRESTful Webサービスをサポートします。

- JAX-RPC WebLogic Webサービスのセキュリティおよび管理は、サポートされません。

WebLogic Scripting Tool(WLST)

- Oracle Infrastructure Webサービスおよびクライアントの表示と構成。

- Java EE Webサービスおよびクライアントの表示。

- OWSMポリシーによるOracle Infrastructure WebサービスおよびJava EE Webサービスの保護。OWSMを使用したWebサービスの保護の詳細は、Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理を参照してください。

- テストから生産のような環境間のアプリケーション移行の管理。

Oracle WebLogic Server管理コンソール

Java EE Webサービスを保護および管理します。

Oracle WebLogic Server管理コンソールを使用してJava EE Webサービスを保護および管理する方法の詳細は、Oracle WebLogic Server管理コンソール・オンライン・ヘルプのWebサービスに関する項を参照してください。

注意: 利用可能な場合、Oracle Enterprise Manager Fusion Middleware Controlは、Java EE Webサービスを保護および管理するために推奨されるグラフィカル・ユーザー・インタフェース(GUI)ツールです。

2 管理ツールへのアクセス

この章では、Fusion Middleware Webサービスの保護と管理に使用できる管理ツールをいくつか紹介します。この章では、セキュリティおよび管理ツールにアクセスする方法について説明します。

この章の内容は次のとおりです。

- Oracle Enterprise Manager Fusion Middleware Controlへのアクセス

- Oracle WebLogic管理コンソールへのアクセス

- WebサービスのカスタムWLSTコマンドへのアクセス

2.1 Oracle Enterprise Manager Fusion Middleware Controlへのアクセス

Oracle Enterprise Manager Fusion Middleware Controlへアクセスする手順は次のとおりです。

1. Oracle WebLogic Serverインスタンスを起動します。

詳細は、Oracle WebLogic Server管理コンソール・オンライン・ヘルプのサーバーの起動と停止に関する項 を参照してください。

2. サポートされているWebブラウザを開き、次のURLに移動します。

http://hostname:port/em
https://hostname:port/em

hostnameはFusion Middleware ControlのDNS名またはIPアドレスを指定し、portはFusion Middleware Controlがリクエストされるポートのアドレスを指定します(デフォルト7001)。

Secure Sockets Layer (SSL)を使用してOracle Fusion Middlewareを起動した場合には、httpsを使用します。

サポートされているブラウザのリストについては、次の場所にあるOracle Fusion Middlewareのシステム要件と仕様を参照してください: http://www.oracle.com/technetwork/middleware/ias/downloads/fusion-requirements-100147.html

「ログイン」ページが表示されます。

3. ユーザー名およびパスワードを入力します。

管理ユーザーのデフォルト・ユーザー名は、weblogicです。これは、最初にFusion Middleware Controlにログインするために使用できるアカウントです。パスワードは、Oracle Fusion Middlewareのインストール時に入力したものです。

4. 「ログイン」をクリックします。

注意:

Fusion Middleware ControlでWebサービスの管理に使用できるタスクや機能はロールによって異なります。詳細は、「サポートされるユーザー・ロールのアクセス権限の理解」を参照してください。

詳細は、『Oracle Fusion Middlewareの管理』の「Oracle Enterprise Manager Fusion Middleware Controlの使用の概要」を参照してください。

2.2 Oracle WebLogic管理コンソールへのアクセス

Oracle WebLogic管理コンソールへアクセスする手順は次のとおりです。

1. Oracle WebLogic Serverを起動します。

詳細は、Oracle WebLogic Server管理コンソール・オンライン・ヘルプのサーバーの起動と停止に関する項 を参照してください。

2. サポートされているWebブラウザを開き、次のいずれかのURLに移動します。

http://hostname:port/console
https://hostname:port/console

hostnameにはOracle WebLogic管理サーバーのDNS名またはIPアドレスを指定し、portにはOracle WebLogic管理サーバーがリクエストをリスニングしているポートのアドレスを指定します(デフォルトでは7001)。

Secure Sockets Layer (SSL)を使用してOracle WebLogic Serverを起動した場合には、httpsを使用します。

サポートされているブラウザのリストについては、次の場所にあるOracle Fusion Middlewareのシステム要件と仕様を参照してください: http://www.oracle.com/technetwork/middleware/ias/downloads/fusion-requirements-100147.html

「ログイン」ページが表示されます。

3. ユーザー名およびパスワードを入力します。

インストール処理中にユーザー名とパスワードを指定する場合があります。これがOracle管理サーバーの起動に使用したものと同じユーザー名とパスワードの場合もあります。または、デフォルトのグローバル・セキュリティ・ロールのいずれかが付与されているユーザー名の可能性もあります。

4. 「ログイン」をクリックします。

詳細は、Oracle WebLogic管理コンソール・オンライン・ヘルプのコンソールの起動に関する項を参照してください。

2.3 WebサービスのカスタムWLSTコマンドへのアクセス

WebサービスのWLSTコマンドにアクセスする手順は次のとおりです。

1. インストールのために、Oracleの共通ホーム・ディレクトリ、たとえば/home/Oracle/Middleware/oracle_commonに移動します。

Oracle共通ホームのディレクトリおよびOracle Fusion Middlewareのインストールに関する詳細は、『Oracle Fusion Middlewareのインストールのプランニング』を参照してください。

2. oracle_common/common/binディレクトリにあるWLST.sh/cmdコマンドを使用して、WLSTを起動します。次に例を示します。

- /home/Oracle/Middleware/oracle_common/common/bin/wlst.sh (UNIX)

- C:\Oracle\Middleware\oracle_common\common\bin\wlst.cmd(Windows)

これらのコマンドを実行すると、WLSTがオフライン・モードで起動されます。WebサービスのWLSTコマンドを使用するには、WLSTをオンライン・モードで使用する必要があります。

3. Oracle WebLogic Serverを起動します。

詳細は、Oracle WebLogic Server管理コンソール・オンライン・ヘルプのサーバーの起動と停止に関する項 を参照してください。

4. connect()コマンドを使用して、実行中のWebLogic Serverインスタンスに接続します。たとえば、次のコマンドは、ユーザー名/パスワードの資格証明weblogic/welcome1を使用して、URL myAdminServer.example.com:7001でWLSTを管理サーバーに接続します。

connect("weblogic","welcome1","t3://myAdminServer.example.com:7001")

WLSTの使用に関する詳細は、『WebLogic Scripting Toolの理解』のWebLogic Scripting Toolの使用に関する項を参照してください。

WebサービスのWLSTコマンドの詳細は、『インフラストラクチャ・コンポーネントのためのWLSTコマンド・リファレンス』のWebサービス・カスタムWLSTコマンドに関する項を参照してください。

3 Webサービス・アプリケーションのデプロイ

この章では、Oracle Fusion Middlewareのデプロイおよびアンデプロイに関する簡単な説明を示します。

この章の内容は次のとおりです。

- Webサービス・アプリケーション・デプロイの概要

- Webサービス・アプリケーションのデプロイ

- Webサービス・アプリケーションのアンデプロイ

- Webサービス・アプリケーションの再デプロイ

3.1 Webサービス・アプリケーション・デプロイの概要

Webサービスを使用すると、異なる方法で関連付けられたアプリケーションをデプロイおよびアンデプロイできます。Webサービスに関連付けられたアプリケーションをデプロイする際には、次のガイドラインに従ってください。

- Oracle Enterprise Manager Fusion Middleware Controlを使用して、Oracle Metadata Services (MDS)を必要とする、またはOracle Application Development Framework (Oracle ADF)を利用するJava EEアプリケーションをデプロイします。

- アプリケーションがSOAコンポジットの場合は、SOAコンポジット・デプロイ・ウィザードを使用します。

- アプリケーションがSOAコンポジットでない場合、またはMDSリポジトリやADF接続を必要としない場合は、Fusion Middleware ControlまたはOracle WebLogic Server管理コンソールを使用してアプリケーションをデプロイできます。

この章では、Webサービス・アプリケーションをデプロイする基本的な手順の概要を説明します。アプリケーションのデプロイの詳細は、『Oracle Fusion Middlewareの管理』の"アプリケーションのデプロイに関する項"を参照してください。特に、次の項に注意してください。

- Java EEアプリケーションのデプロイ、アンデプロイおよび再デプロイ

- Oracle ADFアプリケーションのデプロイ、アンデプロイおよび再デプロイ

- SOAコンポジット・アプリケーションのデプロイ、アンデプロイおよび再デプロイ

3.2 Webサービス・アプリケーションのデプロイ

次に、Oracle Enterprise Manager Fusion Middleware Controlを使用してWebサービス・アプリケーションをデプロイする基本的な手順の概要を示します。

Webサービス・アプリケーションをデプロイするには::

1. ナビゲーション・ペインで「WebLogicドメイン」を開きます。

2. Webサービスをデプロイするドメインを開き、デプロイ先のサーバーのインスタンスを選択します。

3. コンテンツ・ペインで、「WebLogic Server」→「デプロイメント」を選択します。

4. 「デプロイメント」ページで「デプロイ」をクリックします。

図3-1に示すように、デプロイ・プロセスの最初の画面が表示されます。

図3-1 「アーカイブの選択」ページ

5. 次に示す「アーカイブまたは展開済ディレクトリ」オプションのいずれか1つを選択します。

- アーカイブはこのWebブラウザが稼働しているマシンに存在します。

- アーカイブまたは展開済ディレクトリはEnterprise Managerが稼働しているサーバーに存在します。

6. 次に示す「デプロイ・プラン」オプションのいずれか1つを選択します。

- 新規デプロイ・プランを自動的に作成します。

- デプロイ・プランはローカル・ホストに存在します。

- デプロイ・プランはEnterprise Managerが稼働しているサーバーに存在します。

デプロイ・プランは、特定の環境にデプロイするアプリケーションの構成に使用するXMLファイルです。デプロイするWebサービス・アプリケーションのデプロイ・プランがない場合、アプリケーションをデプロイすると作成されます。

7. 次に示す「デプロイメント・タイプ」オプションのいずれか1つを選択します。

- このアーカイブまたは展開済ディレクトリをアプリケーションとしてデプロイします

- このアーカイブまたは展開済ディレクトリをライブラリとしてデプロイします

8. 「次へ」をクリックします。

9. 「ターゲットの選択」ページで、このアプリケーションをデプロイするターゲット(WebLogicサーバーまたはクラスタ)を選択し、「次へ」をクリックします。

図3-2 「ターゲットの選択」ページ

10. 「アプリケーション属性」ページで、このWebサービス・アプリケーションの属性を入力し、「次へ」をクリックします。必須属性は「アプリケーション名」のみです。

ただし、後から、アンデプロイせずにこのWebサービス・アプリケーションを再デプロイできるようにする場合は、バージョン番号も割り当てる必要があります。

コンテキスト・ルートはWebモジュールのURIです。Webサービスを含む各WebモジュールまたはEJBモジュールには、コンテキスト・ルートが存在する場合があります。

図3-3 「アプリケーション属性」ページ

11. 図3-4に示すように、「デプロイ設定」ページで、このWebサービス・アプリケーションのデプロイ設定を編集します。

図3-4 「デプロイ設定」ページ

12. ローカル・システムにデプロイ・プランのコピーを保存するには、「デプロイ・プランの保存」をクリックします。

13. デプロイ・プランを編集し、可能な場合に拡張デプロイ・オプションを追加するには、「デプロイ・プランの編集」をクリックします。その場合には、図3-5に示すように、「デプロイ・プランの編集」画面が表示されます。デプロイ・プランへの変更を行ったら、「適用」をクリックして変更を有効にします。

図3-5 デプロイ・プランの編集

14. 「デプロイ設定」ページで、「デプロイ」をクリックします。成功すると、「正常にデプロイされました」画面が表示されます。

3.3 Webサービス・アプリケーションのアンデプロイ

Webサービスのアンデプロイまたは再デプロイの手順は、他のアプリケーションの場合の手順と同じです。

Webサービス・アプリケーションをアンデプロイするには::

1. ナビゲーション・ペインで、「アプリケーションのデプロイ」を開き、アプリケーション・デプロイを開いてアプリケーションを選択します。

「アプリケーションのデプロイ」が表示されます。

2. コンテンツ・ペインで、「アプリケーション・デプロイメント」→「デプロイメント」を選択します。

3. デプロイメント表で、アプリケーションを選択し、「アンデプロイ」をクリックします。

アンデプロイの確認ページが表示されます。

4. 「アンデプロイ」をクリックします。

処理メッセージが表示されます。

5. 処理が完了したら、「閉じる」をクリックします。

3.4 Webサービス・アプリケーションの再デプロイ

Webサービス・アプリケーションを再デプロイすると、実行中のアプリケーションが自動的に停止されて再起動されます。

次のような場合にアプリケーションを再デプロイします。

- アプリケーションを変更し、その変更内容を有効にする場合。

- デプロイ・プランを変更した場合。

- 新しい場所に完全に新しいアーカイブ・ファイルを再デプロイする必要がある場合。

アプリケーションを再デプロイしたら、元のアーカイブ・ファイルまたは展開済ディレクトリを再デプロイすることも、元のアーカイブ・ファイルのかわりに新しいアーカイブ・ファイルを指定することもできます。また、アプリケーションに関連付けられているデプロイ・プランを変更することも可能です。

注意:

バージョンなしでデプロイされたアプリケーションは、再デプロイできません。バージョニングされていないアプリケーションを再デプロイするには、アプリケーションをアンデプロイしてからデプロイする必要があります。

新しいバージョンを使用してアプリケーションを再デプロイする必要があるということと、現在のバージョンにオプションでリタイア・ポリシーを設定できるという2点を除き、Webサービス・アプリケーションを再デプロイする手順は、最初にアプリケーションをデプロイする際に必要な手順(「Webサービス・アプリケーションのデプロイ」で説明されている)と同じです。図3-6に示すように、このどちらのアクションも、再デプロイ・プロセスの手順3で実行します。

図3-6 再デプロイ中におけるアプリケーション属性の設定

4 Webサービスの管理

この章では、Oracle Enterprise Manager Fusion Middleware ControlおよびWebLogic Scripting Tool (WLST)コマンドを使用して、Oracle Fusion Middleware Webサービスを構成および管理する方法について説明します。

この章の内容は次のとおりです。

- Fusion Middleware Controlを使用したWebサービス管理の概要

- WLSTを使用したWebサービス管理の概要

4.1 Fusion Middleware Controlを使用したWebサービス管理の概要

次の項では、Fusion Middleware Controlを使用して、サーバーとクライアントでWebサービスにアクセスおよびWebサービスを構成する方法を説明します。

- サポートされるユーザー・ロールのアクセス権限の理解

- Fusion Middleware Controlを使用したWebサービスの表示の概要

- Fusion Middleware Controlを使用したWebサービス・クライアントの表示の概要

- Fusion Middleware Controlを使用したWebサービスの構成の概要

- Fusion Middleware Controlを使用したWebサービス・クライアントの構成の概要

- Fusion Middleware Controlを使用したWSDLの管理の概要

4.1.1 サポートされるユーザー・ロールのアクセス権限の理解

Fusion Middleware Controlは、ロール・ベースのアクセスの概念をサポートしています。ユーザーは様々なロールにマップされ、各ロールは異なる一連の権限に対応しています。Fusion Middleware Controlでは、Oracle WebLogic Serverセキュリティ・レルムとそのレルムで定義されたロールを使用します。

表4-1に示すように、アサーション・テンプレートとポリシーに関するWebサービス管理タスクはロールによって制限できます。

表4-1 サポートされるロールごとのOracle Web Services Manager権限

権限

管理者

デプロイヤ

モニター

オペレータ

ポリシー、アサーション・テンプレートおよびポリシー・セットの読取り

はい

はい

はい

はい

ポリシーとアサーション・テンプレートの作成、更新および削除

注意: 事前定義済のポリシーおよびアサーション・テンプレートは読取り専用であり、これらを更新または削除する権限はどのロールにもありません。事前定義済のポリシーまたはアサーション・テンプレートを変更するには、それを事前にクローンしておく必要があります。セキュリティおよび管理カテゴリ内のポリシーのみがクローン可能です。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』の"Fusion Middleware ControlによるWebサービス・ポリシーの管理に関する項"を参照してください。

はい

いいえ

いいえ

いいえ

ポリシー・セットの作成、更新および削除

はい

いいえ

いいえ

いいえ

OWSMポリシーのアタッチとデタッチ

はい

いいえ

いいえ

いいえ

クライアント・ポリシーの生成。

はい

いいえ

いいえ

いいえ

サービス・ポリシーとクライアント・ポリシーの整合性のチェック

はい

はい

はい

はい

Fusion Middleware Controlのユーザーとロールの詳細は、『Oracle Fusion Middlewareの管理』のFusion Middleware Controlのユーザーおよびロールの理解に関する項を参照してください。

4.1.2 Fusion Middleware Controlを使用したWebサービスの表示の概要

次の項では、サーバー上、およびアプリケーション・デプロイまたはアプリケーション内のWebサービスを表示する方法を説明します。

- Fusion Middleware Controlを使用したサーバーのWebサービスの表示

- Fusion Middleware Controlを使用したアプリケーションのデプロイにおけるWebサービスの表示

- アプリケーションの「Webサービスのサマリー」ページの表示

- Java EE Webサービスのサマリー・ページの表示

- SOAコンポジットのWebサービスと参照の表示

- Fusion Middleware Controlを使用したWebサービス・エンドポイントの詳細の表示の概要

4.1.2.1 Fusion Middleware Controlを使用したサーバーのWebサービスの表示

指定されたサーバーに現在デプロイされているすべてのWebサービスを表示するには、次の手順に従います。

サーバーのWebサービスを表示するには:

1. ナビゲーション・ペインで「WebLogicドメイン」を開いてドメインを表示します。

2. ドメイン名を開いてサーバーのリストを表示します。

3. すべての現行Webサービスを表示するサーバーを選択します。

4. コンテンツ・ペインで「WebLogicサーバー」、「Webサービス」を順に選択します。図4-1に示すWebサービスのサーバー・サマリー・ページが表示されます。

Java EE Webサービス、ADFのようなOracle Infrastructure Webサービス、およびRESTfulサービスのタブを表示できます。

表示されるタブは、サーバーにデプロイされるWebサービスに応じて異なります。

図4-1 サーバーのWebサービス・サマリー・ページ

4.1.2.2 Fusion Middleware Controlを使用したアプリケーションのデプロイにおけるWebサービスの表示

Fusion Middleware Controlを使用して、特定アプリケーション・デプロイメントの現行のデプロイされているWebサービスのサマリーを表示できます。サマリーが、アプリケーション・デプロイメントのホームページに表示されます。

アプリケーション・デプロイメントにWebサービスを表示するには:

1. ナビゲーション・ペインで「アプリケーションのデプロイ」フォルダを開き、ドメイン内のアプリケーション・デプロイメントを表示します。

2. アプリケーション・デプロイメントを選択します。

「ドメイン・アプリケーション・デプロイメント」ページの右側に、「Webサービスのサマリー」が表示されます。サービスごとに、サマリーに、Webサービス名、実行中のサーバー名、サーバーで実行中の関連付けられたアプリケーション名、Webサービス・エンドポイント名、およびサービスのテスト・ページへのリンクがリストされます。

注意:

「Webサービスのサマリー」には、RESTful Webサービスは含まれません。

4.1.2.3 アプリケーションの「Webサービスのサマリー」ページの表示

アプリケーションのWebサービスのリストを表示できるページに移動するには、次の手順に従ってください。

アプリケーションの「Webサービスのサマリー」ページを表示するには:

1. ナビゲーション・ペインで「アプリケーションのデプロイ」フォルダを開き、ドメイン内のアプリケーション・デプロイメントを表示して、目的のドメイン・アプリケーション・デプロイを選択します。

「ドメイン・アプリケーションのデプロイ」ホームページが、コンテンツ・ペインに表示されます。

2. ナビゲータ・ペインで、選択したアプリケーション・デプロイメントを開き(該当する場合は、その子ノードであるクラスタ・アプリケーション・デプロイメントなどを開いてアプリケーション・デプロイメントを表示)、目的のアプリケーション・デプロイメントを選択します。

「アプリケーションのデプロイ」ホームページが、コンテンツ・ペインに表示されます。

3. コンテンツ・ペインで「アプリケーションのデプロイ」、「Webサービス」を順に選択します。

Webサービスのアプリケーション・サマリー・ページが表示されます。

Webサービスのアプリケーション・サマリー・ページでは次のことができます。

- アプリケーション内のWebサービスを表示できます。

- Webサービスの構成、エンドポイント・ステータス、ポリシー障害などを表示できます。(ADFにのみ適用されます)。

- セキュリティ、信頼できるメッセージング、MTOM、管理およびサービス・フォルトなどの、Webサービス・フォルトを表示および監視できます。(ADFにのみ適用されます)。

- 認証、認可、メッセージ整合性およびメッセージ機密保護違反など、セキュリティ違反を表示および監視できます。(ADFにのみ適用されます)。

- エンドポイントの有効化や無効化、Webサービスへのポリシーの添付など、Webサービス・エンドポイントの構成が可能なページに移動できます。

「Webサービスの詳細」表には、Webサービスとポート、Webサービス・エンドポイント、RESTfulサービスおよびJava EE Webサービス・クライアントの詳細情報が表示されるタブが含まれます。

図4-2は、ADFアプリケーションのWebサービスのアプリケーション・サマリー・ページを示しています。

注意:

「RESTfulサービス」タブおよび「Java EE Webサービス・クライアント」タブは、アプリケーション内にRESTfulサービスまたはJava EE Webサービスのクライアント・インスタンスがある場合にのみそれぞれ表示されます。

図4-2 ADFアプリケーションの「Webサービスのサマリー」ページ

図4-3は、Java EEアプリケーションのWebサービスのサマリー・ページを示しています。Webサービス(Java EE)ページには、Webサービス、Webサービス・エンドポイント、Webサービス・クライアントとクライアント・ポートの数、およびRESTfulアプリケーションとリソースの数などのこのアプリケーションのWebサービスに関する情報が表示されます。

図4-3 Java EEアプリケーションの「Webサービスのサマリー」ページ

4.1.2.4 Java EE Webサービスのサマリー・ページの表示

この手順に従って、Java EE Webサービスのサマリー情報を表示します。

1. アプリケーションの「Webサービスのサマリー」ページの表示に記載されている、Java EEアプリケーションの「Webサービスのサマリー」ページに移動します。

2. 「Webサービス」タブで、サマリー情報を表示するWebサービスの名前をクリックします。

Java EE Webサービスのサマリー・ページには、「Webサービス・エンドポイント」と「呼出し」の2つのタブが表示されます。「Webサービス・エンドポイント」タブには、Webサービスに関連付けられたエンドポイントが表示されます。呼出し統計は、Java EE Webサービスの集約された情報です。これらの統計に関する詳細は、「Webサービス・エンドポイントの操作統計の表示」を参照してください。

「呼出し」タブには、呼出しおよびレスポンス・エラー数などのWebサービス呼出しの統計が示されます。これらの統計に関する詳細は、「Java EE Webサービス操作の統計の表示」を参照してください。

4.1.2.5 SOAコンポジットのWebサービスと参照の表示

SOAコンポジット・アプリケーションのSOAPまたはRESTful Webサービス、参照およびコンポーネントを表示する手順は次のとおりです。

1. ナビゲーション・ペインで「SOA」フォルダを開きます。

2. soa-infraを開いてSOAパーティションを表示します。SOAパーティション(たとえば、defaultパーティション)を開き、目的のSOAコンポジット・アプリケーションを選択します。

SOAコンポジットのホームページが表示されます。

3. 選択されていない場合は、「ダッシュボード」タブを選択します。

このタブの「コンポーネント」セクションには、コンポジット・アプリケーションで使用されているSOAコンポーネントが表示され、「サービスと参照」セクションには、Webサービスと参照バインディングが表示されます。

4.1.2.6 Fusion Middleware Controlを使用したWebサービス・エンドポイントの詳細の表示の概要

Fusion Middleware Controlでは、次の各項で、Webサービス・エンドポイントの詳細を表示する手順が説明されています。

- SOAコンポジット・アプリケーションの詳細の表示

- SOA以外のOracle Infrastructure Webサービス・エンドポイントの詳細の表示

- Java EE Webサービス・エンドポイントの詳細の表示

- Java EE Webサービス操作の詳細の表示

- RESTfulサービス・アプリケーションの詳細の表示

- RESTfulリソースの詳細の表示

4.1.2.6.1 SOAコンポジット・アプリケーションの詳細の表示

次の手順に従って、SOAコンポジット・アプリケーションのWebサービス・エンドポイントの構成を表示します。

1. 「SOAコンポジットのWebサービスと参照の表示」の説明に従って、SOAコンポジットのホームページに移動します。

2. ページのサービスと参照セクションで、必要に応じてサービスまたは参照の名前をクリックして、サービス・ホームまたは参照ホーム・ページを表示します。

3. サービス・ホームまたは参照ホームページから、次の内容を実行できます。

- まだ選択されていない場合は「ダッシュボード」タブをクリックし、サーバーを起動してから現在までの受信メッセージとフォルトの合計数、およびメッセージ名、フォルトの時間、フォルトのタイプ(ビジネスまたはシステム)を含む最近拒否されたメッセージのグラフ表示を確認します。

- 「ポリシー」タブをクリックして、そのエンドポイントに添付されているポリシーを表示または変更します。

- 「プロパティ」タブをクリックして、そのエンドポイントの構成を表示および変更します。

注意:

RESTful SOAコンポーネント・サービスの場合、「プロパティ」タブは使用できません。

- 「アダプタ・レポート」タブをクリックして、診断可能性レポートのリストを表示および有効化します。このタブは、アダプタ・エンドポイントにのみ表示されます。

SOAコンポジット・エンドポイントの詳細は、Oracle SOA SuiteおよびOracle Business Process Management Suiteの管理のバインディング・コンポーネントの管理に関する項を参照してください。

4.1.2.6.2 SOA以外のOracle Infrastructure Webサービス・エンドポイントの詳細の表示

次の手順に従って、SOA以外のOracle Infrastructure Webサービス・エンドポイント(ADFなど)の詳細を表示します。

1. 「アプリケーションのWebサービスのサマリー・ページの表示」で説明されているように、「Webサービス・アプリケーションのサマリー」ページに移動します。

2. ページの「Webサービスの詳細」セクションで、まだ表示されていない場合は、「Webサービス」タブをクリックして、Webサービス・エンドポイントを表示するWebサービスを開きます。

または、「Webサービス・エンドポイント」タブをクリックして、Webサービス・エンドポイントのリストを表示します。

3. エンドポイント名をクリックして「Webサービス・エンドポイント」ページに移動します。

4. 「Webサービス・エンドポイント」ページから、次の内容を実行できます。

- 「操作」タブをクリックすると、そのエンドポイントの操作リストを表示できます。

- エンドポイントに有効な構成があり、セキュアな場合に、「WSMポリシー」タブをクリックして、このエンドポイントに添付されているポリシーを表示します。

- 「グラフ」タブをクリックすると、そのエンドポイントのフォルトをグラフ表示できます。すべてのフォルトの分布を示すチャートと、セキュリティ・フォルトの分布のみを示すチャートがあります。詳細は、「Webサービスのセキュリティ違反の表示の概要」を参照してください。

- 「構成」タブをクリックして、Webサービス・エンドポイントのプロパティを構成します。詳細は、Fusion Middleware Controlを使用したWebサービスの構成の概要を参照してください。

Webサービス・エンドポイントの詳細を表示する別の方法として、「Fusion Middleware Controlを使用したサーバーのWebサービスの表示」の説明に従って、すべてのWebサービスが表示されている「Webサービスのサマリー」ページに移動し、エンドポイント名をクリックして特定の「Webサービス・エンドポイント」ページに移動することもできます。

4.1.2.6.3 Java EE Webサービス・エンドポイントの詳細の表示

この手順に従って、Java EE Webサービス・エンドポイントの情報を表示します。

1. 「アプリケーションのWebサービスのサマリー・ページの表示」で説明されているように、「Webサービス・のサマリー」ページに移動します。

2. ページの「Webサービスの詳細」セクションで、まだ表示されていない場合は、「Webサービス」タブをクリックして、Webサービス・エンドポイントを表示するWebサービスを開きます。

または、「Webサービス・エンドポイント」タブをクリックして、Webサービス・エンドポイントのリストを表示します。

3. エンドポイント名をクリックして「Webサービス・エンドポイント」ページに移動します。

4. 「Webサービス・エンドポイント」ページから、次の内容を実行できます。

- 「操作」タブをクリックすると、そのエンドポイントの操作リストを表示できます。

- 「呼出し」タブをクリックして、エンドポイントの呼出しに関連付けられたエラー、呼出し、およびレスポンス統計を表示します。

- エンドポイントに有効な構成があり、セキュアな場合に、「WSMポリシー」タブをクリックして、このエンドポイントに添付されているポリシーを表示します。

注意:

エンドポイントのセキュリティ違反に関する詳細も表示できます。詳細は、「Webサービスのセキュリティ違反の表示の概要」を参照してください。

Webサービス・エンドポイントの詳細を表示する別の方法として、「Fusion Middleware Controlを使用したサーバーのWebサービスの表示」の説明に従って、すべてのWebサービスが表示されているサーバー全体の「Webサービスのサマリー」ページに移動し、エンドポイント名をクリックして特定の「Webサービス・エンドポイント」ページに移動することもできます。

4.1.2.6.4 Java EE Webサービス操作の詳細の表示

この手順に従って、Java EE Webサービスに属する操作を表示します。

1. 「Java EE Webサービスのサマリー・ページの表示」で説明されているように、Java EE Webサービスのサマリー・ページに移動します。

2. 「Webサービス」タブで、詳細を表示するエンドポイントの名前を選択します。

3. Webサービス・エンドポイント・ページの「操作」タブをクリックすると、エンドポイントに関連付けられた操作が表示されます。

4. 操作名をクリックすると、より詳細な情報が表示されます。

「Webサービス操作」ページには、エンドポイントのURI、関連付けられたアプリケーション名、Webサービス名、およびエンドポイント名、およびエラー、呼出し、レスポンス統計などの操作に関する情報が表示されます。

エンドポイントの詳細および統計に関する記述は、「Java EE Webサービス操作の統計の表示」を参照してください。

4.1.2.6.5 RESTfulサービス・アプリケーションの詳細の表示

この手順に従って、RESTfulサービス・アプリケーションの詳細を表示します。

1. 「アプリケーションのWebサービスのサマリー・ページの表示」で説明されているように、「Webサービス・アプリケーションのサマリー」ページに移動します。

2. ページの「Webサービスの詳細」セクションで、「RESTfulサービス」タブをクリックします。

3. RESTfulアプリケーション名をクリックして、「RESTfulサービス・アプリケーション」ページへ移動します。

4. RESTfulサービス・アプリケーションページから、次の手順が実施可能です。

- RESTfulリソースタブをクリックして、RESTfulサービスに関連付けられているリソースを示すリストを表示します。リソースごとに、その名前、種類、パス、呼出し回数、および平均実行時間(ミリ秒)を表示可能です。

- RESTfulサービスに有効な構成があり、セキュアな場合に、「WSMポリシー」タブをクリックして、このRESTfulサービスに添付されているポリシーを表示します。

4.1.2.6.5.1 RESTfulリソースの詳細の表示

この手順に従って、RESTfulリソースの詳細を表示します。

1. 「アプリケーションのWebサービスのサマリー・ページの表示」で説明されているように、「Webサービス・アプリケーションのサマリー」ページに移動します。

2. ページの「Webサービスの詳細」セクションで、「RESTfulサービス」タブをクリックします。

3. RESTfulアプリケーション名をクリックして、「RESTfulサービス・アプリケーション」ページへ移動します。

4. RESTfulサービス・アプリケーションページから、RESTfulリソースタブをクリックして、RESTfulサービスに関連付けられているリソースを示すリストを表示します。

5. 詳細を表示したいRESTfulリソース名をクリックします。

RESTfulリソースページには、アプリケーション名、モジュール名、RESTfulアプリケーション名、リソースの名前、種類およびパス、手法およびサブレッサ・ロケータの数、呼出し回数と平均実行時間(ミリ秒)を含む統計などのリソースに関する情報が表示されます。

RESTfulメソッドタブには、メソッド名、戻り型、パス、関連付けられたHTTPメソッド、および生成するメディア型を含むリソース・メソッドに関する情報が表示されます。呼出し回数、平均実行時間、実行時間合計を含む統計も、表示されます。

4.1.3 Fusion Middleware Controlを使用したWebサービス・クライアントの表示の概要

次の各項で説明されているように、Webサービス・クライアントを表示する手順は、アプリケーションの種類(SOA参照、ADF DCまたは非同期コールバック・クライアント)によって異なります。

- SOA参照の表示

- 接続ベースのWebサービス・クライアントの表示

- Java EE Webサービス・クライアントの表示

- 非同期のWebサービス・コールバック・クライアントの表示

4.1.3.1 SOA参照の表示

SOA参照クライアントを表示するには、次の手順を使用します。

1. ナビゲーション・ペインで「SOA」フォルダを開きます。

2. soa-infraを開き、SOAパーティション(たとえば、defaultパーティション)を開き、目的のSOAコンポジット・アプリケーションを選択します。

SOAコンポジットのホームページが表示されます。

3. 選択されていない場合は、「ダッシュボード」タブをクリックします。

4. ページのサービスと参照部分で、表示するSOA参照を選択します。

5. 「参照ホーム」ページでは次のことができます。

- まだ選択されていない場合は「ダッシュボード」タブをクリックし、サーバーを起動してから現在までの受信メッセージとフォルトの合計数、およびメッセージ名、フォルトの時間、フォルトのタイプ(ビジネスまたはシステム)を含む最近拒否されたメッセージのグラフ表示を確認します。

- 「ポリシー」タブをクリックして、そのエンドポイントに添付されているポリシーを表示または変更します。

- 「プロパティ」タブをクリックして、そのエンドポイントの構成を表示および変更します。

- 「アダプタ・レポート」タブをクリックして、診断可能性レポートのリストを表示および有効化します。このタブは、アダプタ・エンドポイントにのみ表示されます。

SOAコンポジット・エンドポイントの詳細は、Oracle SOA SuiteおよびOracle Business Process Management Suiteの管理のバインディング・コンポーネントの管理に関する項を参照してください。

4.1.3.2 接続ベースのWebサービス・クライアントの表示

次の手順に従って、ADF DC Webサービス・クライアント、ADF JAX-WS Indirection Proxyなどの接続ベースのWebサービス・クライアントを表示します。

1. ナビゲーション・ペインで「アプリケーションのデプロイ」フォルダを開き、ドメイン内のアプリケーション・デプロイメントを表示して、目的のドメイン・アプリケーション・デプロイを選択します。

「ドメイン・アプリケーションのデプロイ」ホームページが、コンテンツ・ペインに表示されます。

2. ナビゲータ・ペインで、選択したアプリケーション・デプロイメントを開き(該当する場合は、その子ノードであるクラスタ・アプリケーション・デプロイメントなどを開いてアプリケーション・デプロイメントを表示)、目的のアプリケーション・デプロイメントを選択します。

「アプリケーションのデプロイ」ホームページが、コンテンツ・ペインに表示されます。

3. 「アプリケーションのデプロイ」メニューから、「ADF」→ADF接続の構成を選択します。

4. 「ADF接続構成」ページで、ページの「Webサービス接続」セクションから接続を選択し、「詳細な接続構成」リストからエンドポイントを選択します。

5. 「Webサービスの構成」ページで、タブをクリックしてクライアント・データを表示します。

4.1.3.3 Java EE Webサービス・クライアントの表示

次の手順に従って、Java EE Webサービス・クライアントを表示します。

1. ナビゲーション・ペインで「アプリケーションのデプロイ」フォルダを開き、ドメイン内のアプリケーションを表示して、目的のドメイン・アプリケーション・デプロイを選択します。

「ドメイン・アプリケーションのデプロイ」ホームページが、コンテンツ・ペインに表示されます。

2. ナビゲータ・ペインで、選択したアプリケーション・デプロイメントを開き(該当する場合は、その子ノードであるクラスタ・アプリケーション・デプロイメントなどを開いてアプリケーション・デプロイメントを表示)、目的のJava EEアプリケーション・デプロイメントを選択します。

「アプリケーションのデプロイ」ホームページが、コンテンツ・ペインに表示されます。

3. 「アプリケーション・デプロイメント」メニューから、「Webサービス」を選択します。

Webサービス(Java EE)のサマリー・ページが表示されます。

4. 「Java EE Webサービス・クライアント」タブを選択して、アプリケーション内でクライアントを表示します。

- 「監視」タブを使用して、アプリケーション内のランタイム・クライアント・インスタンスを表示します。詳細は、「Java EE Webサービス・クライアントの統計の表示」を参照してください。

- 「構成」タブを使用して、クライアント・ポートを表示し、ポリシーを添付または解除します。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』の「Webサービス・クライアントへのポリシーの直接的な添付」を参照してください。

4.1.3.4 非同期のWebサービス・コールバック・クライアントの表示

非同期のWebサービス・コールバック・クライアントを表示するには、次の手順を使用します。コールバック・クライアントは、非同期Webサービスが呼出し元にレスポンスを返すためにのみ使用されます。詳細は、『Oracle Infrastructure Webサービスの開発』の非同期Webサービスの開発に関する項を参照してください。

1. 「Fusion Middleware Controlを使用したWebサービス・エンドポイントの詳細の表示の概要」で説明されているように、非同期Webサービスのエンドポイントに移動します。

2. エンドポイント・ページの右上角のコールバック・クライアントをクリックします。

4.1.4 Fusion Middleware Controlを使用したWebサービスの構成の概要

次の項では、Fusion Middleware Controlを使用して、Webサービスを構成する方法を説明します。

- Fusion Middleware Controlを使用したアドレス指定の構成

- Fusion Middleware Controlを使用した非同期Webサービスの構成

- Fusion Middleware Controlを使用した非同期WebサービスのJMSシステム・ユーザーの変更

- Fusion Middleware Controlを使用した信頼性のあるメッセージの構成

- Fusion Middleware Controlを使用した原子性トランザクションの構成

- Fusion Middleware Controlを使用したMTOMの構成

- Fusion Middleware Controlを使用したFast Infosetの構成

- Fusion Middleware Controlを使用したSOAP Over JMS Transportの構成

- Fusion Middleware Controlを使用した永続性の構成

- Fusion Middleware Controlを使用したWebサービスの有効化または無効化

- Fusion Middleware Controlを使用したWebサービスWSDLドキュメントへのパブリック・アクセスの有効化または無効化

- Fusion Middleware Controlを使用したSOAPプロセスの有効化または無効化

- Fusion Middleware Controlを使用したNon-SOAP XMLメッセージ・プロセスの有効化または無効化

- Fusion Middleware Controlを使用した診断ログのログ・レベルの設定

- Fusion Middleware Controlを使用したWebサービスのテスト・クライアントの有効化または無効化の概要

- Fusion Middleware Controlを使用したメタデータの交換の有効化または無効化

- Fusion Middleware Controlを使用したMTOMエンコード失敗メッセージの構成

- Fusion Middleware Controlを使用したリクエスト・メッセージの検証

- Fusion Middleware Controlを使用したリクエスト・メッセージのサイズの設定

- Fusion Middleware Controlを使用したバイナリ・コンテンツのキャッシングの有効化または無効化

4.1.4.1 Fusion Middleware Controlを使用したアドレス指定の構成

注意:

この項で説明する手順は、SOA以外のOracle Infrastructure Webサービスにのみ適用されます。

Fusion Middleware Controlを使用してアドレス指定するために、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のFusion Middleware Controlを使用したWebサービスおよびクライアントへのポリシーの添付に関する項で説明されているように、oracle/wsaddr_policyポリシーを添付します。

ポリシーのアドレス指定を無効にするには、次の手順のうちの1つを実行します。

- ポリシーをデタッチします。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のFusion Middleware Controlを使用したポリシーの直接的な添付のデタッチに関する項を参照してください。

- ポリシーを無効化します。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のFusion Middleware Controlを使用したポリシーの直接的な添付の有効化および無効化に関する項を参照してください。

- oracle/no_addressing_policyを添付すると、広範囲で構成されたアドレス化ポリシーが無効化されます。

アドレス化ポリシーの詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』の「アドレス化ポリシー」を参照してください。

4.1.4.2 Fusion Middleware Controlを使用した非同期Webサービスの構成

注意:

この項で説明する手順は、SOA以外の非同期のOracle Infrastructure Webサービスにのみ適用されます。

Webサービスを同期的に呼び出す場合、呼出し側のクライアント・アプリケーションは、レスポンスが戻るまで待機してから、処理を続行します。レスポンスが即座に戻る場合であれば、このWebサービス呼出しの方法は適切であると考えられます。しかし、リクエストの処理が遅延する可能性があるため、クライアント・アプリケーションによる処理を続行しレスポンスへの対処は後で行うようにします。Webサービスを非同期的にコールすれば、クライアントはその処理を間断なく続行でき、非同期レスポンスが戻されたときに通知を受けることができます。

Fusion Middleware Controlを使用して非同期Webサービスを構成するには、次のいずれかの方法を使用します。

- 『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のポリシーの添付に関する項で説明されているように、oracle/async_web_service_policy構成ポリシーをWebサービスに添付します。
非同期ポリシーを無効にするには、次の手順のうちの1つを実行します。

- ポリシーをデタッチします。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のFusion Middleware Controlを使用したポリシーの直接的な添付のデタッチに関する項を参照してください。

- ポリシーを無効化します。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のFusion Middleware Controlを使用したポリシーの直接的な添付の有効化および無効化に関する項を参照してください。

- oracle/no_async_web_service_policyを添付すると、広範囲で構成された非同期ポリシーが無効化されます。

構成ポリシーの詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』の構成ポリシーに関する項を参照してください。

- 次で説明されているように、「構成」タブを使用します。

「非同期のWebサービス・コールバック・クライアントの構成」の説明に従って、非同期のコールバック・クライアントを構成することもできます。

非同期Webサービスの開発の詳細は、『Oracle Infrastructure Webサービスの開発』の非同期Webサービスの開発に関する項を参照してください。

「構成」タブを使用して非同期Webサービスを構成するには:

1. 「Webサービス・アプリケーションのサマリー」ページに移動します。

2. ページの「Webサービスの詳細」セクションで、まだ表示されていない場合は、Webサービス・エンドポイントを表示するWebサービスを表示します。

3. 非同期Webサービスのエンドポイント名をクリックして、「Webサービス・エンドポイント」ページに移動します。

非同期Webサービスの場合は、ページ上部の「非同期」フラグが「True」に設定されます。非同期Webサービスの詳細を示す次のフラグを確認します。

- リクエスト・キューに対するトランザクションの有効化: トランザクションがリクエスト・キューで有効かどうかを指定するフラグ。

- レスポンス・キューの使用: レスポンス・キューを使用するかどうかを指定するフラグ。「False」に設定すると、レスポンスは格納されずにWebサービス・クライアントに直接送信されます。

- レスポンス・キュー用に有効化されたトランザクション: トランザクションがレスポンス・キューで有効かどうかを指定するフラグ。

これらのフラグは、設計時に構成されます。詳細は、『Oracle Infrastructure Webサービスの開発』の非同期Webサービスの開発に関する項を参照してください。

4. 「Webサービス・エンドポイント」ページで、「構成」タブをクリックします。

5. ページの「非同期Webサービス」セクションで、表4-2に定義されている構成プロパティを設定できます。

注意:

表4-2に定義されている構成プロパティは、非同期Webサービスでのみ表示され、これに対してのみ有効です。

表4-2 非同期Webサービスの構成プロパティ

構成プロパティ

説明

JMSリクエスト・キューのコネクション・ファクトリ名

JMSリクエスト・キューのコネクション・ファクトリの名前。ベース・ドメインとともに提供されるデフォルトのJMSコネクション・ファクトリであるweblogic.jms.XAConnectionFactoryがデフォルトで使用されます。

JMSリクエスト・キュー名

リクエスト・キューの名前。oracle.j2ee.ws.server.async.DefaultRequestQueueというキューがデフォルトで使用されます。

JMSレスポンス・キューのコネクション・ファクトリ名

JMSレスポンス・キューのコネクション・ファクトリの名前。ベース・ドメインとともに提供されるデフォルトのJMSコネクション・ファクトリであるweblogic.jms.XAConnectionFactoryがデフォルトで使用されます。

JMSレスポンス・キュー名

リクエスト・キューの名前。デフォルトでは、キューoracle.j2ee.ws.server.async.DefaultResponseQueueが使用されます。

JMSシステム・ユーザー

JMSキューの使用を許可されているユーザー。デフォルトでは、このプロパティはOracleSystemUserに設定されます。

注意: 大多数のユーザーでは、OracleSystemUserで十分です。ただし、このユーザーをセキュリティ・レルムの別のユーザーに変更する必要がある場合は、「Fusion Middleware Controlを使用した非同期WebサービスのJMSシステム・ユーザーの変更」に示す手順に従って変更できます。

6. 「適用」をクリックします。

4.1.4.3 Fusion Middleware Controlを使用した非同期WebサービスのJMSシステム・ユーザーの変更

注意:

この項で説明する手順は、SOA以外のOracle Infrastructure Webサービスにのみ適用されます。

デフォルトでは、JMSシステム・ユーザーはOracleSystemUserとして設定されます。大多数のユーザーにとっては、このデフォルト値で十分です。

Fusion Middleware Controlを使用してセキュリティ領域のカスタム・ユーザーを構成するには、次のメソッドのうちの1つを実行します。

- 『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のFusion Middleware Controlを使用したWebサービスおよびクライアントへのポリシーの添付に関する項で説明されているように、oracle/async_web_service_policy構成ポリシーをWebサービスに添付して、jms.access.user構成ポリシーを無効にする。
非同期ポリシーを無効にするには、次の手順のうちの1つを実行します。

- ポリシーをデタッチします。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のFusion Middleware Controlを使用したポリシーの直接的な添付のデタッチに関する項を参照してください。

- ポリシーを無効化します。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のFusion Middleware Controlを使用したポリシーの直接的な添付の有効化および無効化に関する項を参照してください。

- oracle/no_async_web_service_policyを添付すると、広範囲で構成された非同期ポリシーが無効化されます。

構成ポリシーの詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』の構成ポリシーに関する項を参照してください。

- 次で説明されているように、「構成」タブを使用します。

「構成」タブを使用したJMSシステム・ユーザーの変更方法:

1. 「Fusion Middleware Controlを使用した非同期Webサービスの構成」で説明されているように、非同期Webサービスの「Webサービス・エンドポイント」ページで「構成」タブにアクセスします。

2. JMSシステム・ユーザーフィールドにカスタム・ユーザーの名前を入力し、「適用」をクリックします。

注意:

カスタム・ユーザーは、セキュリティ・レルムに存在し、JMSリソースにアクセスするのに必要な権限を持つ必要があります。

3. WebLogic Server管理コンソールにアクセスします。Fusion Middleware Controlからアクセスするには、ナビゲータ・ペインでドメインを選択します。「WebLogicドメイン」メニューから、「WebLogic Server管理コンソール」を選択します。

4. 必要な管理者権限を持つ有効なユーザー名とパスワードを使用して、WebLogic Server管理コンソールにログインします。

5. 「ドメイン構造」ペインで「デプロイ」をクリックし、対応するMDB、service_AsynchRequestProcessorMDBまたはservice_AsynchResponseProcessorMDBに移動します。これらのMDB名では、serviceは、ユーザー名を変更する非同期サービスの名前です。

6. 「チェンジ・センター」で、「ロックして編集」を選択します。

7. リクエストまたはレスポンスMDBのMDB名を選択します。(リクエストMDBとレスポンスMDBの両方のユーザー名を更新する必要があります。)「設定」ページで、「構成」タブを選択します。

8. ページの「エンタープライズBean構成」セクションで、プリンシパル名として実行フィールドにカスタム・ユーザー名を入力し、「保存」をクリックします。

このフィールドに入力するユーザー名は、Fusion Middleware ControlのJMSシステム・ユーザーに入力したユーザー名と一致している必要があることに注意してください。

構成の変更内容は、新しいデプロイ・プランに保存する必要があります。

9. 「デプロイメント・プラン保存アシスタント」を使用して、新しいデプロイ・プランを保存します。

10. 2番目のMDBに対して手順7と8を繰り返します。変更内容は新しいデプロイ・プランに自動的に保存されます。

11. 「チェンジ・センター」で、「変更のアクティブ化」をクリックします。

12. アプリケーションを再デプロイします。詳細は、「Webサービス・アプリケーションのデプロイ」を参照してください。

4.1.4.4 Fusion Middleware Controlを使用した信頼性のあるメッセージの構成

注意:

この項で説明する手順は、SOA以外のOracle Infrastructure Webサービスにのみ適用されます。

Fusion Middleware Controlを使用してWebサービスの信頼性のあるメッセージを有効にするために、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のポリシーの添付に関する項で説明されているように、oracle/reliable_messaging_policyポリシーを添付します。

信頼性のあるメッセージのポリシーを無効にするには、次の手順のうちの1つを実行します。

- ポリシーをデタッチします。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のFusion Middleware Controlを使用したポリシーの直接的な添付のデタッチに関する項を参照してください。

- ポリシーを無効化します。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のFusion Middleware Controlを使用したポリシーの直接的な添付の有効化および無効化に関する項を参照してください。

- oracle/no_reliable_messaging_policyを添付すると、広範囲で構成された信頼性のあるメッセージが無効化されます。

信頼性のあるメッセージ・ポリシーの詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』の「信頼性のあるメッセージ・ポリシー」を参照してください。

4.1.4.5 Fusion Middleware Controlを使用した原子性トランザクションの構成

注意:

この項で説明する手順:

- Oracle Infrastructure Webサービスにのみ適用されます。

- RESTful SOAコンポーネント・サービスには適用されません。

Webサービスは、WS-CoordinationおよびWS-AtomicTransaction (WS-AT)仕様をサポートしています。そのため、Webサービスの原子性トランザクションを構成して、Oracle WebLogic Serverと、WebSphere、Microsoft .NETなどの他のベンダーのトランザクション処理システムとの相互運用性を有効にできます。

Fusion Middleware Controlを使用してWebサービスの原子性トランザクション・ポリシーを構成するには、次のいずれかの方法を使用します。

- 次に説明するように「構成」タブまたは「プロパティ」タブを使用する。

注意:

SOAコンポジットの場合、「プロパティ」タブを使用した構成のみが可能です。次に説明する構成ポリシーは、SOAコンポジットでは使用できません。

- 『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のFusion Middleware Controlを使用したWebサービスおよびクライアントへのポリシーの添付に関する項で説明されているように、oracle/atomic_transaction_policyポリシーをWebサービスに添付する。
原子性トランザクション・ポリシーを無効にするには、次の手順のうちの1つを実行します。

- ポリシーをデタッチします。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のFusion Middleware Controlを使用したポリシーの直接的な添付のデタッチに関する項を参照してください。

- ポリシーを無効化します。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のFusion Middleware Controlを使用したポリシーの直接的な添付の有効化および無効化に関する項を参照してください。

- oracle/no_atomic_transaction_policyを添付すると、広範囲で構成された原子性トランザクション・ポリシーが無効化されます。

原子性トランザクション・ポリシーの詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』の「原子性トランザクション・ポリシー」を参照してください。

「構成」タブまたは「プロパティ」タブを使用してWebサービスの原子性トランザクションを構成するには:

1. 「Fusion Middleware Controlを使用したWebサービス・クライアントの表示の概要」の説明に従って、「Webサービス・エンドポイント」ページまたは(SOAコンポジット)の「サービス・ホーム」ページに移動します。

2. 「構成」タブをクリックします。SOAコンポジット(SOAPのみ)の場合は、「プロパティ」タブをクリックします。

3. 「アトミック・トランザクションのバージョン」フィールドで、サポートされるWebサービス原子性トランザクションのコーディネーション・コンテキストのバージョンを選択します。トランザクション全体で同じ値を指定する必要があります。有効な値は次のとおりです。

- WSAT10

- WSAT11

- WSAT12

- デフォルト

Defaultを選択すると、3つのバージョンすべてがサポートされます。

注意:

このプロパティは、同期操作のみを伴うSOA Webサービス、ならびに同期操作および非同期操作の両方を伴うWebサービスと連動します。非同期操作のみを伴うSOA Webサービスとは連動しません。

4. 「アトミック・トランザクションのフロー・オプション」フィールドで、トランザクション・コーディネーション・コンテキストをトランザクション・フローとともにWebサービスに渡すかどうかを選択します。

有効な値は次のとおりです。

- Never - トランザクション・コーディネーション・コンテキストをエクスポートしません。これはデフォルトです。

- Supports - トランザクションが有効な場合、トランザクション・コーディネーション・コンテキストをエクスポートします。

- Mandatory - トランザクション・コーディネーション・コンテキストをエクスポートします。アクティブなトランザクションがない場合は、例外がスローされます。

5. 「適用」をクリックします。

4.1.4.6 Fusion Middleware Controlを使用したMTOMの構成

注意:

この項で説明する手順は、Oracle Infrastructure Webサービスにのみ適用されます。

Fusion Middleware Controlを使用してMTOMを有効にするために、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のFusion Middleware Controlを使用したWebサービスおよびクライアントへのポリシーの添付に関する項で説明されているように、oracle/wsmtom_policy構成ポリシーを添付します。

MTOMポリシーを無効にするには、次の手順のうちの1つを実行します。

- ポリシーをデタッチします。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のFusion Middleware Controlを使用したポリシーの直接的な添付のデタッチに関する項を参照してください。

- ポリシーを無効化します。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のFusion Middleware Controlを使用したポリシーの直接的な添付の有効化および無効化に関する項を参照してください。

- oracle/no_mtom_policyを添付すると、広範囲で構成されたMTOMポリシーが無効化されます。

MTOMポリシーの詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』の「MTOMポリシー」を参照してください。

4.1.4.7 Fusion Middleware Controlを使用したFast Infosetの構成

注意:

この項で説明する手順は、SOA以外のOracle Infrastructure Webサービスにのみ適用されます。

Fusion Middleware Controlを使用してFast Infosetを有効にするために、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のFusion Middleware Controlを使用したWebサービスおよびクライアントへのポリシーの添付に関する項で説明されているように、oracle/fast_infoset_service_policyポリシーを添付します。

Fast Infosetポリシーを無効にするには、次の手順のうちの1つを実行します。

- ポリシーをデタッチします。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のFusion Middleware Controlを使用したポリシーの直接的な添付のデタッチに関する項を参照してください。

- ポリシーを無効化します。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のFusion Middleware Controlを使用したポリシーの直接的な添付の有効化および無効化に関する項を参照してください。

- oracle/no_fast_infoset_service_policyを添付すると、広範囲で構成されたFast Infosetポリシーが無効化されます。

Fast Infosetポリシーの詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』の「構成ポリシー」を参照してください。

4.1.4.8 Fusion Middleware Controlを使用した永続性の構成

注意:

この項で説明する手順は、SOA以外のOracle Infrastructure Webサービスにのみ適用されます。

Fusion Middleware Controlを使用して永続性を有効にするために、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のFusion Middleware Controlを使用したWebサービスおよびクライアントへのポリシーの添付に関する項で説明されているように、oracle/persistence_policy構成ポリシーを添付します。

永続性ポリシーを無効にするには、次の手順のうちの1つを実行します。

- ポリシーをデタッチします。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のFusion Middleware Controlを使用したポリシーの直接的な添付のデタッチに関する項を参照してください。

- ポリシーを無効化します。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のFusion Middleware Controlを使用したポリシーの直接的な添付の有効化および無効化に関する項を参照してください。

- oracle/no_persistence_policyを添付すると、広範囲で構成された永続性ポリシーが無効化されます。

構成ポリシーの詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』の構成ポリシーに関する項を参照してください。

4.1.4.9 Fusion Middleware Controlを使用したSOAP Over JMS Transportの構成

注意:

この項で説明する手順は、SOA以外のOracle Infrastructure Webサービスにのみ適用されます。

通常、Webサービスおよびクライアントは、接続プロトコルとしてSOAP over HTTP/Sを使用して通信します。ただし、クライアント・アプリケーションがトランスポートとしてJMSを使用するようにWebサービスを構成できます。

SOAP over JMSトランスポートを使用すると、WebサービスとクライアントがHTTP接続ではなくJMS宛先を使用して通信するようになるため、次のような利点があります。

- 信頼性

- スケーラビリティ

- サービス品質

Webサービスの信頼性のあるメッセージングの場合と同様に、メソッド呼出しがまだキューに入っているときにWebLogic Serverが停止しても、再起動すればすぐに処理が行われます。クライアントは、Webサービスを呼び出す際にレスポンスを待機しないため、クライアントの実行は続行可能です。ただし、SOAP over JMSトランスポートを使用する場合は、HTTP/Sより若干オーバーヘッドが大きくなり、プログラムが複雑になります。

『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のセキュリティおよびポリシーの注釈に関するリファレンスで説明しているとおり、@JMSTransportService注釈を使用して、設計時にSOAP over JMSトランスポートを有効化および構成できます。

Fusion Middleware Controlを使用してSOAP over JMSトランスポート・ポリシーを構成するには、次のメソッドのうちの1つを実行します。

- 『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のFusion Middleware Controlを使用したWebサービスおよびクライアントへのポリシーの添付に関する項で説明されているように、oracle/jms_transport_service_policyポリシーをWebサービスに添付します。
JMSトランスポート・ポリシーを無効にするには、次の手順のうちの1つを実行します。

- ポリシーをデタッチします。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のFusion Middleware Controlを使用したポリシーの直接的な添付のデタッチに関する項を参照してください。

- ポリシーを無効化します。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のFusion Middleware Controlを使用したポリシーの直接的な添付の有効化および無効化に関する項を参照してください。

- oracle/no_jms_transport_service_policyを添付すると、広範囲で構成されたSOAP over JMSトランスポート・ポリシーが無効化されます。

SOAP Over JMSトランスポート・ポリシーの詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』の「SOAP Over JMSトランスポート・ポリシー」を参照してください。

- 次で説明されているように、「構成」タブを使用します。

「構成」タブを使用したSOAP over JMSトランスポートの構成方法:

1. 「Fusion Middleware Controlを使用したWebサービス・クライアントの表示の概要」の説明に従って、「Webサービス・エンドポイント」ページまたは(SOAコンポジット)の「サービス・ホーム」ページに移動します。

SOAP over JMSトランスポートを有効にすると、SOAP over JMSトランスポート・プロパティがサマリー領域に表示されます。構成プロパティは読み専用です。

2. 「構成」タブをクリックします。

3. 「SOAP over JMSのHTTP WSDLアクセスの有効化」フィールドで、メニューから「TRUE」を選択してWSDLアクセスを有効化するか、「FALSE」を選択してWSDLアクセスを無効化します。

4. 「適用」をクリックします。

4.1.4.10 Fusion Middleware Controlを使用したWebサービスの有効化または無効化

注意:

この項で説明する手順は、SOA以外のOracle Infrastructure Webサービスにのみ適用されます。

Fusion Middleware Controlを使用してWebサービスを有効化または無効化するには、次のいずれかの方法を使用します。

- 『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のFusion Middleware Controlを使用したWebサービスおよびクライアントへのポリシーの添付に関する項で説明されているように、oracle/request_processing_service_policyポリシーをWebサービスに添付します。
Webサービス・リクエスト処理ポリシーを無効にするには、次の手順のうちの1つを実行します。

- ポリシーをデタッチします。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のFusion Middleware Controlを使用したポリシーの直接的な添付のデタッチに関する項を参照してください。

- ポリシーを無効化します。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のFusion Middleware Controlを使用したポリシーの直接的な添付の有効化および無効化に関する項を参照してください。

- oracle/no_request_processing_policyを添付すると、広範囲で構成されたWebサービス・リクエスト処理ポリシーが無効化されます。

構成ポリシーの詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』の構成ポリシーに関する項を参照してください。

- 次で説明されているように、「構成」タブを使用します。

「構成」を使用してWebサービス・エンドポイントを有効化または無効化するには:

1. 「Webサービス・アプリケーションのサマリー」ページに移動します。

2. ページの「Webサービスの詳細」セクションで、まだ表示されていない場合は、Webサービス・エンドポイントを表示するWebサービスを表示します。

3. エンドポイント名をクリックして「Webサービス・エンドポイント」ページに移動します。

4. 「Webサービス・エンドポイント」ページで、「構成」タブをクリックします。

5. 「エンドポイント有効」フィールドで、メニューから「有効」または「無効」を選択して、Webサービスをそれぞれ有効または無効にします。

6. 「適用」をクリックします。

4.1.4.11 Fusion Middleware Controlを使用したWebサービスWSDLドキュメントへのパブリック・アクセスの有効化または無効化

注意:

この項で説明する手順:

- Oracle Infrastructure Webサービスにのみ適用されます。

- RESTful SOAコンポーネント・サービスには適用されません。

Fusion Middleware Controlを使用してWebサービスWSDLドキュメントへのアクセスを有効化するには、次のいずれかの方法を使用します。

- 次に説明するように「構成」タブまたは「プロパティ」タブを使用する。

注意:

SOAコンポジットの場合、「プロパティ」タブを使用した構成のみが可能です。次に説明する構成ポリシーは、SOAコンポジットでは使用できません。

- 『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のFusion Middleware Controlを使用したWebサービスおよびクライアントへのポリシーの添付に関する項で説明されているように、oracle/wsdl_request_processing_service_policyポリシーをWebサービスに添付する。
WSDLアクセス・ポリシーを無効にするには、次の手順のうちの1つを実行します。

- ポリシーをデタッチします。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のFusion Middleware Controlを使用したポリシーの直接的な添付のデタッチに関する項を参照してください。

- ポリシーを無効化します。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のFusion Middleware Controlを使用したポリシーの直接的な添付の有効化および無効化に関する項を参照してください。

- oracle/no_wsdl_request_processing_service_policyを添付すると、広範囲で構成されたWSDLアクセス・ポリシーが無効化されます。

構成ポリシーの詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』の構成ポリシーに関する項を参照してください。

「構成」タブまたは「プロパティ」タブを使用してWebサービスのWSDLドキュメントを構成するには:

1. 「Fusion Middleware Controlを使用したWebサービス・クライアントの表示の概要」の説明に従って、「Webサービス・エンドポイント」ページまたは(SOAコンポジットの)「サービス・ホーム」ページに移動します。

2. 「構成」タブをクリックします。SOAコンポジット(SOAPのみ)の場合は、「プロパティ」タブをクリックします。

3. 「WSDL対応」フィールドで、メニューから「TRUE」を選択してWSDLの表示を有効化するか、「FALSE」を選択してWSDLの表示を無効化します。

4. 「適用」をクリックします。

4.1.4.12 Fusion Middleware Controlを使用したSOAPプロセスの有効化または無効化

注意:

この項で説明する手順は、SOA以外のOracle Infrastructure Webサービスにのみ適用されます。

Fusion Middleware Controlを使用してWebサービス・エンドポイントのSOAPリクエスト処理を有効にするために、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のFusion Middleware Controlを使用したWebサービスおよびクライアントへのポリシーの添付に関する項で説明されているように、oracle/soap_request_processing_service_policy構成ポリシーを添付します。

SOAP処理ポリシーを無効にするには、次の手順のうちの1つを実行します。

- ポリシーをデタッチします。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のFusion Middleware Controlを使用したポリシーの直接的な添付のデタッチに関する項を参照してください。

- ポリシーを無効化します。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のFusion Middleware Controlを使用したポリシーの直接的な添付の有効化および無効化に関する項を参照してください。

- oracle/no_request_processing_service_policyを添付すると、広範囲で構成されたSOAP処理ポリシーが無効化されます。

構成ポリシーの詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』の構成ポリシーに関する項を参照してください。

4.1.4.13 Fusion Middleware Controlを使用したNon-SOAP XMLメッセージ・プロセスの有効化または無効化

注意:

この項で説明する手順:

- Oracle Infrastructure Webサービスにのみ適用されます。

- RESTful SOAコンポーネント・サービスには適用されません。

Fusion Middleware Controlを使用してユーザー定義のjavax.xml.ws.Provider<T>.invokeメソッドによって処理されたnon-SOAP XMLメッセージを受け取るエンドポイントを有効化するには、次のメソッドのうちの1つを実行します。

- 次に説明するように「構成」タブまたは「プロパティ」タブを使用する。

注意:

SOAコンポジットの場合、「プロパティ」タブを使用した構成のみが可能です。次に説明する構成ポリシーは、SOAコンポジットでは使用できません。

- 『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のFusion Middleware Controlを使用したWebサービスおよびクライアントへのポリシーの添付に関する項で説明されているように、oracle/pox_http_binding_service_policyポリシーをWebサービスに添付する。
non-SOAP XMLメッセージ処理ポリシーを無効にするには、次の手順のうちの1つを実行します。

- ポリシーをデタッチします。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のFusion Middleware Controlを使用したポリシーの直接的な添付のデタッチに関する項を参照してください。

- ポリシーを無効化します。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のFusion Middleware Controlを使用したポリシーの直接的な添付の有効化および無効化に関する項を参照してください。

- oracle/no_pox_http_binding_service_policyを添付すると、広範囲で構成されたnon-SOAP XMLメッセージ処理ポリシーが無効化されます。

構成ポリシーの詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』の構成ポリシーに関する項を参照してください。

「構成」タブまたは「プロパティ」タブを使用してnon-SOAP XMLメッセージ処理を有効にするには:

1. 「Fusion Middleware Controlを使用したWebサービス・クライアントの表示の概要」の説明に従って、「Webサービス・エンドポイント」ページまたは(SOAコンポジットの)「サービス・ホーム」ページに移動します。

2. 「構成」タブをクリックします。SOAコンポジット(SOAPのみ)の場合は、「プロパティ」タブをクリックします。

3. 「RESTfulの有効化」フィールドで、メニューから「TRUE」を選択して機能を有効化するか、「FALSE」を選択して機能を無効化します。

4. 「適用」をクリックします。

4.1.4.14 Fusion Middleware Controlを使用した診断ログのロギング・レベルの設定

注意:

この項で説明する手順:

- Oracle Infrastructure Webサービスにのみ適用されます。

- RESTful SOAコンポーネント・サービスには適用されません。

Fusion Middleware Controlを使用して診断ログのロギング・レベルを設定するには、次のメソッドのうちの1つを実行します。

- 次に説明するように「構成」タブまたは「プロパティ」タブを使用する。

注意:

SOAコンポジットの場合、「プロパティ」タブを使用した構成のみが可能です。次に説明する構成ポリシーは、SOAコンポジットでは使用できません。

- 『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のFusion Middleware Controlを使用したWebサービスおよびクライアントへのポリシーの添付に関する項で説明されているように、oracle/ws_logging_level_policyポリシーをWebサービスに添付する。
ログ・レベル・ポリシーを無効にするには、次の手順のうちの1つを実行します。

- ポリシーをデタッチします。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のFusion Middleware Controlを使用したポリシーの直接的な添付のデタッチに関する項を参照してください。

- ポリシーを無効化します。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のFusion Middleware Controlを使用したポリシーの直接的な添付の有効化および無効化に関する項を参照してください。

- oracle/no_ws_logging_level_service_policyを添付すると、広範囲で構成されたロギング・レベル・ポリシーが無効化されます。

構成ポリシーの詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』の構成ポリシーに関する項を参照してください。

「構成」タブまたは「プロパティ」タブを使用して診断ログのロギング・レベルを設定するには:

1. 「Fusion Middleware Controlを使用したWebサービス・クライアントの表示の概要」の説明に従って、「Webサービス・エンドポイント」ページまたは(SOAコンポジットの)「サービス・ホーム」ページに移動します。

2. 「構成」タブをクリックします。SOAコンポジット(SOAPのみ)の場合は、「プロパティ」タブをクリックします。

3. 「ロギング・レベル」フィールドで、ロギング・レベルを選択します。

4. 「適用」をクリックします。

4.1.4.15 Fusion Middleware Controlを使用したWebサービスのテスト・クライアントの有効化または無効化の概要

次の項で説明されているように、Fusion Middleware Controlを使用してドメインまたはWebサービスのエンドポイント・レベルのWebサービスのテスト・クライアントを有効化または無効化できます。

- "Fusion Middleware Controlを使用したドメイン・レベルのWebサービスのテスト・クライアントの有効化または無効化"

- "Fusion Middleware Controlを使用したWebサービスのエンドポイント・レベルのWebサービスのテスト・クライアントの有効化または無効化"

Webサービスのテスト・クライアントの詳細は、「Webサービスのテスト・クライアントの使用」を参照してください。

注意:

この項で説明している手順が、Fusion Middleware Controlの「Webサービスのテスト」ページにアクセスできるようにする「Webサービス・エンドポイント」ページ上の「Webサービスのテスト」リンクの可用性に影響を与えることはありません。詳細は、Fusion Middleware Controlの「Webサービスのテスト」ページを参照してください。

4.1.4.15.1 Fusion Middleware Controlを使用したドメイン・レベルのWebサービスのテスト・クライアントの有効化または無効化

Fusion Middleware Controlを使用したドメイン・レベルのWebサービスのテスト・クライアントの有効化または無効化方法:

1. WebLogicドメイン → 管理 →一般設定 を選択します。

2. 「詳細」をクリックし、詳細設定を表示します。

3. 「Webサービスのテスト・ページの有効化」フラグを切り替えると、ドメイン・レベルでWebサービスのテスト・クライアントを有効化または無効化できます。

4. 「保存」をクリックします。

5. WebLogicドメインを再起動します。

4.1.4.15.1.1 Fusion Middleware Controlを使用したWebサービスのエンドポイント・レベルのWebサービスのテスト・クライアントの有効化または無効化

注意:

この項で説明する手順:

- Oracle Infrastructure Webサービスにのみ適用されます。

- RESTful SOAコンポーネント・サービスには適用されません。

Fusion Middleware Controlを使用してWebサービスのテスト・クライアントを有効するには、次のいずれかの方法を実行します。

- 次に説明するように「構成」タブまたは「プロパティ」タブを使用する。

注意:

SOAコンポジット(SOAPのみ)の場合、「プロパティ」タブを使用した構成のみが可能です。次に説明する構成ポリシーは、SOAコンポジットでは使用できません。

- 『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のFusion Middleware Controlを使用したWebサービスおよびクライアントへのポリシーの添付に関する項で説明されているように、oracle/test_page_processing_service_policyポリシーをWebサービスに添付する。
Webサービスのテスト・クライアント・ポリシーを無効にするには、次のいずれかの手順を実行します。

- ポリシーをデタッチします。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のFusion Middleware Controlを使用したポリシーの直接的な添付のデタッチに関する項を参照してください。

- ポリシーを無効化します。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のFusion Middleware Controlを使用したポリシーの直接的な添付の有効化および無効化に関する項を参照してください。

- oracle/no_ws_logging_level_service_policyを添付すると、広範囲で構成されたWebサービスのテスト・クライアント・ポリシーが無効化されます。

構成ポリシーの詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』の構成ポリシーに関する項を参照してください。

「構成」タブまたは「プロパティ」タブを使用してWebサービスのテスト・クライアントを有効にするには:

1. 「Fusion Middleware Controlを使用したWebサービス・クライアントの表示の概要」の説明に従って、「Webサービス・エンドポイント」ページまたは(SOAコンポジットの)「サービス・ホーム」ページに移動します。

2. 「構成」タブをクリックします。SOAコンポジット(SOAPのみ)の場合は、「プロパティ」タブをクリックします。

3. エンドポイント・テストの有効化フィールドで、メニューから「TRUE」を選択してテスト・エンドポイントを有効化するか、「FALSE」を選択してテスト・エンドポイントを無効化します。

4. 「適用」をクリックします。

4.1.4.16 Fusion Middleware Controlを使用したメタデータの交換の有効化または無効化

注意:

この項で説明する手順:

- Oracle Infrastructure Webサービスにのみ適用されます。

- RESTful SOAコンポーネント・サービスには適用されません。

Fusion Middleware Controlを使用してメタデータの交換を有効にするには、次のメソッドのうちの1つを実行します。

- 次に説明するように「構成」タブまたは「プロパティ」タブを使用する。

注意:

SOAコンポジット(SOAPのみ)の場合、「プロパティ」タブを使用した構成のみが可能です。次に説明する構成ポリシーは、SOAコンポジットでは使用できません。

- 『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のFusion Middleware Controlを使用したWebサービスおよびクライアントへのポリシーの添付に関する項で説明されているように、oracle/mex_request_processing_service_policyポリシーをWebサービスに添付する。
メタデータ変更ポリシーを無効にするには、次の手順のうちの1つを実行します。

- ポリシーをデタッチします。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のFusion Middleware Controlを使用したポリシーの直接的な添付のデタッチに関する項を参照してください。

- ポリシーを無効化します。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のFusion Middleware Controlを使用したポリシーの直接的な添付の有効化および無効化に関する項を参照してください。

- oracle/no_mex_request_processing_service_policyを添付すると、広範囲で構成されたメタデータ変更ポリシーが無効化されます。

構成ポリシーの詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』の構成ポリシーに関する項を参照してください。

「構成」タブまたは「プロパティ」タブを使用してメタデータの交換を有効または無効にするには:

1. 「Fusion Middleware Controlを使用したWebサービス・クライアントの表示の概要」の説明に従って、「Webサービス・エンドポイント」ページまたは(SOAコンポジットの)「サービス・ホーム」ページに移動します。

2. 「構成」タブをクリックします。SOAコンポジット(SOAPのみ)の場合は、「プロパティ」タブをクリックします。

3. メタデータ交換の有効化フィールドで、メニューから「TRUE」を選択してメタデータの交換を有効化するか、「FALSE」を選択してメタデータの交換を無効化します。

4. 「適用」をクリックします。

4.1.4.17 Fusion Middleware Controlを使用したMTOMエンコード失敗メッセージの構成

注意:

この項で説明する手順は、SOA以外のOracle Infrastructure Webサービスにのみ適用されます。

Fusion Middleware Controlを使用してMTOMが有効にする場合に、MTOMエンコード化フォルト・メッセージを有効にするために、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のFusion Middleware Controlを使用したWebサービスおよびクライアントへのポリシーの添付に関する項で説明されているように、oracle/mtom_encode_fault_service_policy構成ポリシーを添付します。

MTOMエンコード化フォルト処理ポリシーを無効にするには、次の手順のうちの1つを実行します。

- ポリシーをデタッチします。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のFusion Middleware Controlを使用したポリシーの直接的な添付のデタッチに関する項を参照してください。

- ポリシーを無効化します。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のFusion Middleware Controlを使用したポリシーの直接的な添付の有効化および無効化に関する項を参照してください。

- oracle/no_mtom_encode_fault_service_policyを添付すると、広範囲で構成されたMTOMエンコード化フォルト処理ポリシーが無効化されます。

構成ポリシーの詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』の構成ポリシーに関する項を参照してください。

4.1.4.18 Fusion Middleware Controlを使用したリクエスト・メッセージの検証

注意:

この項で説明する手順:

- Oracle Infrastructure Webサービスにのみ適用されます。

- RESTful SOAコンポーネント・サービスには適用されません。

Fusion Middleware Controlを使用してスキーマに対するリクエスト・メッセージを検証するには、次のメソッドのうちの1つを実行します。

- 次に説明するように「構成」タブまたは「プロパティ」タブを使用する。

注意:

SOAコンポジット(SOAPのみ)の場合、「プロパティ」タブを使用した構成のみが可能です。次に説明する構成ポリシーは、SOAコンポジットでは使用できません。

- 『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のFusion Middleware Controlを使用したWebサービスおよびクライアントへのポリシーの添付に関する項で説明されているように、oracle/schema_validation_policy構成ポリシーをWebサービスに添付する。
スキーマ検証ポリシーを無効にするには、次の手順のうちの1つを実行します。

- ポリシーをデタッチします。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のFusion Middleware Controlを使用したポリシーの直接的な添付のデタッチに関する項を参照してください。

- ポリシーを無効化します。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のFusion Middleware Controlを使用したポリシーの直接的な添付の有効化および無効化に関する項を参照してください。

- oracle/no_schema_validation_policyを添付すると、広範囲で構成されたスキーマ検証ポリシーが無効化されます。

構成ポリシーの詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』の構成ポリシーに関する項を参照してください。

「構成」タブまたは「プロパティ」タブを使用してスキーマ検証を有効または無効にするには:

1. 「Fusion Middleware Controlを使用したWebサービス・クライアントの表示の概要」の説明に従って、「Webサービス・エンドポイント」ページまたは(SOAコンポジットの)「サービス・ホーム」ページに移動します。

2. 「構成」タブをクリックします。SOAコンポジット(SOAPのみ)の場合は、「プロパティ」タブをクリックします。

3. スキーマ検証フィールドで、メニューから「TRUE」を選択してスキーマ検証を有効化するか、「FALSE」を選択してスキーマ検証を無効化します。

4. 「適用」をクリックします。

4.1.4.19 Fusion Middleware Controlを使用したリクエスト・メッセージのサイズの設定

注意:

この項で説明する手順:

- Oracle Infrastructure Webサービスにのみ適用されます。

- RESTful SOAコンポーネント・サービスには適用されません。

Fusion Middleware Controlを使用してリクエスト・メッセージの最大サイズを設定するには、次のメソッドのうちの1つを実行します。

- 次に説明するように「構成」タブまたは「プロパティ」タブを使用する。

注意:

SOAコンポジット(SOAPのみ)の場合、「プロパティ」タブを使用した構成のみが可能です。次に説明する構成ポリシーは、SOAコンポジットでは使用できません。

- 『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のFusion Middleware Controlを使用したWebサービスおよびクライアントへのポリシーの添付に関する項で説明されているように、oracle/max_request_size_policy構成ポリシーをWebサービスに添付する。
最大リクエスト・サイズ・ポリシーを無効にするには、次の手順のうちの1つを実行します。

- ポリシーをデタッチします。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のFusion Middleware Controlを使用したポリシーの直接的な添付のデタッチに関する項を参照してください。

- ポリシーを無効化します。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のFusion Middleware Controlを使用したポリシーの直接的な添付の有効化および無効化に関する項を参照してください。

- oracle/no_max_request_size_policyを添付すると、広範囲で構成された最大リクエスト・サイズ・ポリシーが無効化されます。

構成ポリシーの詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』の構成ポリシーに関する項を参照してください。

「構成」タブまたは「プロパティ」タブを使用してリクエスト・メッセージのサイズを設定するには:

1. 「Fusion Middleware Controlを使用したWebサービス・クライアントの表示の概要」の説明に従って、「Webサービス・エンドポイント」ページまたは(SOAコンポジットの)「サービス・ホーム」ページに移動します。

2. 「構成」タブをクリックします。SOAコンポジット(SOAPのみ)の場合は、「プロパティ」タブをクリックします。

3. 「最大リクエスト・サイズ」および「最大リクエスト・サイズの単位」を設定します。

-1に設定すると、メッセージのサイズは制限されません。または、テキスト・ボックスに数値を入力して測定単位を選択することで、メッセージに最大制限を設定できます。

注意:

「最大リクエスト・サイズ」を、最大リクエスト・サイズがないことを示す-1に設定すると、「最大リクエスト・サイズの単位」設定は無効になり、デフォルトのbytesになります。

4. 「適用」をクリックします。

4.1.4.20 Fusion Middleware Controlを使用したバイナリ・コンテンツのキャッシングの有効化または無効化

注意:

この項で説明する手順は、SOA以外のOracle Infrastructure Webサービスにのみ適用されます。

Fusion Middleware Controlを使用してバイナリ・コンテンツ・キャッシングを有効にするために、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のFusion Middleware Controlを使用したWebサービスおよびクライアントへのポリシーの添付に関する項で説明されているように、oracle/cache_binary_content_policy構成ポリシーを添付します。

バイナリ・キャッシング・コンテンツ・ポリシーを無効にするには、次の手順のうちの1つを実行します。

- ポリシーをデタッチします。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のFusion Middleware Controlを使用したポリシーの直接的な添付のデタッチに関する項を参照してください。

- ポリシーを無効化します。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のFusion Middleware Controlを使用したポリシーの直接的な添付の有効化および無効化に関する項を参照してください。

- oracle/no_cache_binary_content_policyを添付すると、広範囲で構成されたバイナリ・キャッシング・コンテンツ・ポリシーが無効化されます。

構成ポリシーの詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』の構成ポリシーに関する項を参照してください。

4.1.5 Fusion Middleware Controlを使用したWebサービス・クライアントの構成の概要

注意:

この項で説明する手順は、Oracle Infrastructure Webサービス・クライアントにのみ適用されます。

次の手順では、Fusion Middleware Controlを使用してSOA参照、ADF DCおよび非同期Webサービス・コールバック・クライアントを構成する方法について説明します。

- Webサービス・クライアントの構成プロパティ

- SOA参照の構成

- 接続ベースのWebサービス・クライアントの構成

- 非同期Webサービスのコールバック・クライアントの構成

4.1.5.1 Webサービス・クライアントの構成プロパティ

SOA参照、ADFデータ・コントロールおよび非同期Webサービスのコールバック・クライアントを含む、アプリケーションのWebサービス・クライアントには、表4-3で定義されている構成プロパティを設定できます。

表4-3 Webサービス・クライアントの構成プロパティ

構成プロパティ

プロパティ名

説明

一般

UDDI ServiceKey

oracle.soa.uddi.serviceKey

UDDIをエンドポイントのランタイム解決に使用する場合は、Oracle Service Registry(OSR)のサービス・キーを指定します。

詳細は、Oracle SOA SuiteおよびOracle Business Process Management Suiteの管理のOracle Service Registry Integrationのエンドポイント参照とサービス・キーの変更に関する項を参照してください。

注意: このプロパティは、SOAP SOA参照クライアントにのみ使用できます。

エンドポイント・アドレス

javax.xml.ws.service.endpoint.address

クライアントのリクエスト送信先のエンドポイントURL。

注意: このプロパティは、非同期Webサービスのコールバック・クライアントには使用できません。

WS-Addressing返信先

oracle.webservices.wsaddressing.replyTo

ADF Webサービス・データ・コントロール/Webサービス接続クライアントのコールバックURLを指定します。値は、送信メッセージのWSアドレスreplyToヘッダーで使用されます。

注意: このプロパティは、RESTful SOA参照クライアントには使用できません。

セッションの維持

javax.xml.ws.session.maintain

セッションを維持するかどうかを指定するフラグ。

注意: このプロパティは、非同期Webサービスのコールバック・クライアントやRESTful SOA参照クライアントには使用できません。

原子性トランザクションのバージョン

wsat.Version

アウトバウンド・メッセージにのみ使用されるSOA Webサービス原子性トランザクションのコーディネーション・コンテキストのバージョンを指定します。

トランザクション全体で同じ値を指定する必要があります。

有効な値は、WSAT10、WSAT11、WSAT12、Defaultです。

フロー・オプションをWSDL Drivenに設定すると、バージョンを指定できないことに注意してください。WSDLで通知されるバージョンが使用されます。

フロー・オプションをSupportsまたはMandatoryに設定して、Defaultオプションを指定した場合は、WSAT10が使用されます。

注意: WLSTでは、有効な値、「WSAT10」、「WSAT11」、「WSAT12」、および「DEFAULT」を指定する必要があります。無効な値を使用すると、エラー・メッセージが出力されます。

注意: このプロパティは、SOAP SOA参照クライアントにのみ適用されます。

原子性トランザクション・フロー・オプション

wsat.flowOption

トランザクション・コーディネーション・コンテキストがトランザクション・フローにより渡されるかどうかを指定します。

SOA参照クライアントに有効な値は、次のとおりです。

- Never(デフォルト) - トランザクション・コーディネーション・コンテキストをエクスポートしません。

- Supports - トランザクションが有効な場合、トランザクション・コーディネーション・コンテキストをエクスポートします。

- Mandatory - トランザクション・コーディネーション・コンテキストをエクスポートします。アクティブなトランザクションがない場合は、例外がスローされます。

- WSDL Driven - WSDLに設定された値を使用します。

注意: WLSTでは、有効な値、「NEVER」、「SUPPORTS」、「MANDATORY」、または「WSDLDriven」を指定する必要があります。無効な値を使用すると、エラー・メッセージが出力されます。

注意: このプロパティは、SOAP SOA参照クライアントにのみ適用されます。

HTTPチャンク

チャンクの中止

oracle.webservices.donotChunk

クライアント・リクエストに対してチャンクを有効にするかどうかを指定するフラグ。

チャンク・サイズ(バイト)

oracle.webservices.chunkSize

リクエスト・チャンクのサイズ(バイト)。

HTTPタイムアウト

HTTP読取りタイムアウト(ミリ秒)

oracle.webservices.httpReadTimeout

リクエスト読取りのタイムアウトの長さ(ミリ秒)。

HTTP接続タイムアウト(ミリ秒)

oracle.webservices.httpConnTimeout

リクエスト接続のタイムアウトの長さ(ミリ秒)。

HTTP Basic認証

HTTPユーザー名

(javax.xml.ws.security.auth.username)

oracle.webservices.auth.username

認証されたHTTPユーザー名。

注意: このプロパティは、RESTful SOA参照クライアントには使用できません。

HTTPユーザー・パスワード

(javax.xml.ws.security.auth.password)

oracle.webservices.auth.password

認証されたHTTPユーザーのパスワード。

注意: このプロパティは、RESTful SOA参照クライアントには使用できません。

割込み

oracle.webservices.preemptiveBasicAuth

要求されなくてもリクエストと一緒にセキュリティを送信するかどうかを指定するフラグ。

注意: このプロパティは、RESTful SOA参照クライアントには使用できません。

HTTPプロキシ

プロキシ・ホスト

oracle.webservices.proxyHost

クライアントのリクエスト送信先となるプロキシのURL。

注意: このプロパティは、RESTful SOA参照クライアントには使用できません。

プロキシ・ポート

oracle.webservices.proxyPort

プロキシのポート番号。

注意: このプロパティは、RESTful SOA参照クライアントには使用できません。

プロキシ・ユーザー名

oracle.webservices.proxyUsername

プロキシにアクセスするための有効なユーザー名。

注意: このプロパティは、RESTful SOA参照クライアントには使用できません。

プロキシ・ユーザー・パスワード

oracle.webservices.proxyPassword

プロキシにアクセスするための有効なパスワード。

注意: このプロパティは、RESTful SOA参照クライアントには使用できません。

プロキシ・レルム

oracle.webservices.proxyAuthRealm

プロキシによって使用されるレルム。

注意: このプロパティは、RESTful SOA参照クライアントには使用できません。

プロキシ認証タイプ

oracle.webservices.proxyAuthType

プロキシによって使用される認証タイプ。

注意: このプロパティは、RESTful SOA参照クライアントには使用できません。

4.1.5.2 SOA参照の構成

次の手順では、SOA参照の構成方法について説明します。

1. 「SOA参照の表示」の説明に従って、SOA参照を表示します。

2. 「プロパティ」タブをクリックします。

3. 必要に応じてプロパティ値を設定します。表4-3を参照してください。

4. 「適用」をクリックします。

4.1.5.3 接続ベースのWebサービス・クライアントの構成

次の手順では、ADF DC Webサービス・クライアントやADF JAX-WS Indirection Proxyなどの接続ベースのWebサービス・クライアントを構成する方法について説明します。

1. 「接続ベースのWebサービス・クライアントの表示」の説明に従って、接続ベースのWebサービス・クライアントを表示します。

2. 「構成」タブをクリックします。

3. 必要に応じて構成値を設定します。表4-3を参照してください。

4. 「適用」をクリックします。

4.1.5.4 非同期Webサービスのコールバック・クライアントの構成

次の手順では、非同期Webサービスのコールバック・クライアントの構成方法について説明します。コールバック・クライアントは、非同期Webサービスが呼出し元にレスポンスを返すためにのみ使用されます。詳細は、『Oracle Infrastructure Webサービスの開発』の非同期Webサービスの開発に関する項を参照してください。

非同期Webサービスのコールバック・クライアントを構成する手順は次のとおりです。

1. 「Fusion Middleware Controlを使用したWebサービス・エンドポイントの詳細の表示の概要」で説明されているように、非同期Webサービスのエンドポイントに移動します。

2. エンドポイント・ページの右上角のコールバック・クライアントをクリックします。

3. 「構成」タブをクリックします。

4. 必要に応じて構成値を設定します。表4-3を参照してください。

5. 「適用」をクリックします。

4.1.6 Fusion Middleware Controlを使用したWSDLの管理の概要

WebサービスWSDLを一般に公開したくない場合もあります。「Webサービス・エンドポイント」ページから、WSDLへのパブリック・アクセスを有効または無効にできます。

注意:

起動中に、Webサービス・クライアントからWSDLへのアクセスが必要な場合もあります。WSDLへのパブリック・アクセスを無効にすると、クライアントにはWSDLのローカル・コピーが必要になります。

- WebサービスWSDLドキュメントの表示

- WebサービスWSDLドキュメントへのパブリック・アクセスの有効化または無効化

4.1.6.1 WebサービスWSDLドキュメントの表示

WebサービスのWSDLドキュメントを表示するには:

1. 「Webサービス・アプリケーションのサマリー」ページに移動します。

2. ページの「Webサービスの詳細」セクションで、まだ表示されていない場合は、Webサービス・エンドポイントを表示するWebサービスを表示します。

3. エンドポイント名をクリックして「Webサービス・エンドポイント」ページに移動します。

4. 「WSDLドキュメント」フィールドで、エンドポイント名をクリックしてWebサービスのWSDLを表示します。

4.1.6.2 WebサービスWSDLドキュメントへのパブリック・アクセスの有効化または無効化

WebサービスWSDLドキュメントの表示を有効化または無効化する手順は次のとおりです。

- Fusion Middleware Controlを使用する場合は、「Fusion Middleware Controlを使用したWebサービスWSDLドキュメントへのパブリック・アクセスの有効化または無効化」を参照してください。

- WLSTを使用する場合は、「WLSTを使用したWebサービスWSDLドキュメントへのパブリック・アクセスの有効化または無効化」を参照してください。

4.2 WLSTを使用したWebサービス管理の概要

次の項では、WLSTを使用して、一般的なWebサービスの管理タスクを実行する方法を説明します。

- WLSTを使用したドメイン内でのWebサービスの表示

- WLSTを使用したアプリケーション内でのWebサービスの表示

- WLSTを使用したWebサービス・エンドポイントの詳細の表示

- WLSTを使用したWebサービス・クライアントの表示

- WLSTを使用したWebサービスの構成の概要

- WLSTを使用したWebサービス・クライアントの構成

4.2.1 WLSTを使用したドメイン内でのWebサービスの表示

ドメイン内のすべての現行Webサービスを表示する手順は次のとおりです。

1. 「WebサービスのカスタムWLSTコマンドへのアクセス」の説明に従って、Webサービスを表示するWebLogic Serverの実行中のインスタンスに接続します。

2. WLSTコマンドlistWebServices()またはlistWSMPolicySubjects()を使用して、Webサービスのリストを表示します。Webサービス・アプリケーションまたはSOAコンポジットを指定しない場合、コマンドはドメイン内のサーバー・インスタンスごとに、すべてのアプリケーション内のすべてのサービスとコンポジットをリストします。

listWebServices()コマンドの例を示します。

wls:/base_domain/serverConfig> listWebServices()

/base_domain/AdminServer/jaxwsejb30ws :
moduleName=jaxwsejb, moduleType=web, serviceName=JaxwsWithHandlerChainBeanService
moduleName=jaxwsejb, moduleType=web, serviceName=WsdlConcreteService
moduleName=jaxwsejb, moduleType=web, serviceName=EchoEJBService
moduleName=jaxwsejb, moduleType=web, serviceName=CalculatorService
moduleName=jaxwsejb, moduleType=web, serviceName=DoclitWrapperWTJService

/base_domain/AdminServer/webservicesJwsSimple :
moduleName=webservicesJwsSimple!SimpleImplService, moduleType=wls, serviceName=examples.webservices.jws_basic.simple.SimpleImpl

/base_domain/AdminServer/CalWSBA :
moduleName=CalWSBA#1!CalculatorService, moduleType=wls, serviceName=CalculatorService

/base_domain/AdminServer/SimpleRestApp :
moduleName=SimpleRestApp, moduleType=web, serviceName=SimpleRestServiceService

/base_domain/AdminServer/SimpleJAXWS :
moduleName=SimpleJAXWS#1!SimpleImplService, moduleType=wls, serviceName=SimpleImplService

moduleName=SimpleJAXWS#1!SimpleEjbService, moduleType=wls, serviceName=SimpleEjbService

listWSMPolicySubjects()コマンドの例を示します。

wls:/base_domain/serverConfig> listWSMPolicySubjects()

Application: /weblogic/base_domain/SimpleRestApp

Assembly: #SimpleRestApp

Subject: WS-Service({http://rest.jaxws.ws.j2ee.oracle/}SimpleRestServiceService#SimpleRestServicePort)

Application: /weblogic/base_domain/jaxwsejb30ws

Assembly: #jaxwsejb

Subject: WS-Service({http://host.example.com/targetNamespace}EchoEJBService#EchoEJBServicePort)

Subject: WS-Service({http://host.examplecom/jaxws/tests/concrete}WsdlConcreteService#WsdlConcretePort)

Subject: WS-Service({http://host.example.com/jaxws/tests}CalculatorService#CalculatorPort)

Subject: WS-Service({http://soapinterop.org/DoclitWrapperWTJ}DoclitWrapperWTJService#DoclitWrapperWTJPort)

Subject: WS-Service({http://j2ee.tests.ejb.impl/}JaxwsWithHandlerChainBeanService#JaxwsWithHandlerChainBeanPort)

Application: /weblogic/base_domain/em

Assembly: #default

Subject: WS-Client({http://host.example.com/jaxws/tests}CalculatorService#CalculatorPort)

3. listWSMPolicySubjectsまたはlistWebServicesコマンドのdetail引数をtrueに設定して、ドメイン内のすべてのアプリケーションとコンポジットのエンドポイント(ポート)およびポリシーの詳細、エンドポイントのセキュア・ステータス、すべての構成オーバーライドと制約、およびエンドポイントに有効な構成があるかどうかを表示します。グローバルにアタッチされたポリシーまたは直接アタッチされたポリシーの優先度を指定できるため(reference.priority構成オーバーライドを使用)、effectiveフィールドには、直接アタッチされたポリシーがエンドポイントで有効かどうかが示されます。

注意:

エンドポイント管理を簡単にするために、エンドポイントで有効かどうかにかかわらず、すべての直接アタッチされたポリシーが出力に表示されます。対照的に、グローバルにアタッチされているポリシーは、そのエンドポイントに対して有効なもののみが表示されます。

エンドポイントは、(直接または外部に)添付されたポリシーで認証、認可またはメッセージ保護操作が強制される場合にセキュアであると判断されます。

注意:

listWebServicesコマンドの出力には、ポリシー・アタッチメントなどSOAコンポーネントの詳細は含まれません。

wls:/base_domain/serverConfig> listWebServices(detail='true')
/weblogic/base_domain/jaxwsejb30ws :
moduleName=jaxwsejb, moduleType=web,
serviceName=JaxwsWithHandlerChainBeanService
JaxwsWithHandlerChainBeanPort
http://host.example.com:17001/jaxwsejb/JaxwsWithHandlerChainIntf
URI="oracle/mex_request_processing_service_policy",
category=wsconfig, policy-status=enabled; source=local policy set;
reference-status=enabled; effective=true
Property name="local.policy.reference.source", value="IMPLIED_FEATURE"
URI="oracle/mtom_encode_fault_service_policy",
category=wsconfig, policy-status=enabled; source=local policy set;
reference-status=enabled; effective=true
Property name="local.policy.reference.source", value="IMPLIED_FEATURE"
URI="oracle/max_request_size_policy", category=wsconfig,
policy-status=enabled; source=local policy set; reference-status=enabled;
effective=true
Property name="local.policy.reference.source", value="IMPLIED_FEATURE"
Property name="max.request.size", value="-1"
URI="oracle/request_processing_service_policy",
category=wsconfig, policy-status=enabled; source=local policy set;
reference-status=enabled; effective=true
Property name="local.policy.reference.source", value="IMPLIED_FEATURE"
URI="oracle/soap_request_processing_service_policy",
category=wsconfig, policy-status=enabled; source=local policy set;
reference-status=enabled; effective=true
Property name="local.policy.reference.source", value="IMPLIED_FEATURE"
URI="oracle/ws_logging_level_policy", category=wsconfig,
policy-status=enabled; source=local policy set; reference-status=enabled;
effective=true
Property name="local.policy.reference.source", value="IMPLIED_FEATURE"
Property name="logging.level", value=""
URI="oracle/test_page_processing_service_policy",
category=wsconfig, policy-status=enabled; source=local policy set;
reference-status=enabled; effective=true
Property name="local.policy.reference.source", value="IMPLIED_FEATURE"
URI="oracle/wsdl_request_processing_service_policy",
category=wsconfig, policy-status=enabled; source=local policy set;
reference-status=enabled; effective=true
Property name="local.policy.reference.source", value="IMPLIED_FEATURE"
URI="oracle/wss_saml_or_username_token_over_ssl_service_
policy", category=security, policy-status=enabled; source=global policy set
"test", scope="DOMAIN('*')"; reference-status=enabled; effective=true

The policy subject is secure in this context.

moduleName=jaxwsejb, moduleType=web, serviceName=WsdlConcreteService
WsdlConcretePort
http://host.example.com:17001/jaxwsejb/WsdlAbstract
URI="oracle/mex_request_processing_service_policy",
category=wsconfig, policy-status=enabled; source=local policy set;
reference-status=enabled; effective=true
Property name="local.policy.reference.source", value="IMPLIED_FEATURE"
URI="oracle/mtom_encode_fault_service_policy",
category=wsconfig, policy-status=enabled; source=local policy set;
reference-status=enabled; effective=true
Property name="local.policy.reference.source", value="IMPLIED_FEATURE"
URI="oracle/max_request_size_policy", category=wsconfig,
policy-status=enabled; source=local policy set; reference-status=enabled;
effective=true
Property name="local.policy.reference.source", value="IMPLIED_FEATURE"
Property name="max.request.size", value="-1"
URI="oracle/request_processing_service_policy",
category=wsconfig, policy-status=enabled; source=local policy set;
reference-status=enabled; effective=true
Property name="local.policy.reference.source", value="IMPLIED_FEATURE"
URI="oracle/soap_request_processing_service_policy",
category=wsconfig, policy-status=enabled; source=local policy set;
reference-status=enabled; effective=true
Property name="local.policy.reference.source", value="IMPLIED_FEATURE"
URI="oracle/ws_logging_level_policy", category=wsconfig,
policy-status=enabled; source=local policy set; reference-status=enabled;
effective=true
Property name="local.policy.reference.source", value="IMPLIED_FEATURE"
Property name="logging.level", value=""
URI="oracle/test_page_processing_service_policy",
category=wsconfig, policy-status=enabled; source=local policy set;
reference-status=enabled; effective=true
Property name="local.policy.reference.source", value="IMPLIED_FEATURE"
URI="oracle/wsdl_request_processing_service_policy",
category=wsconfig, policy-status=enabled; source=local policy set;
reference-status=enabled; effective=true
Property name="local.policy.reference.source", value="IMPLIED_FEATURE"
URI="oracle/wss_saml_or_username_token_over_ssl_service_
policy", category=security, policy-status=enabled; source=global policy set
"test", scope="DOMAIN('*')"; reference-status=enabled; effective=true

The policy subject is secure in this context.

listWSMPolicySubjects()コマンドの例を示します。WsdlConcretePortサブジェクトの詳細アップリストのリストです。

wls:/base_domain/serverConfig> listWSMPolicySubjects ('jaxwsejb30ws', '#jaxwsejb', None, detail='true')
Application: /WLS/rc6_domain/jaxwsejb30ws

Assembly: #jaxwsejb

Subject: WS-Service({http://www.oracle.com/jaxws/tests/concrete}WsdlConcreteService#WsdlConcretePort)

URI="oracle/mex_request_processing_service_policy", category=wsconfig, policy-status=enabled; source=local policy set; reference-status=enabled; effective=true
Property name="local.policy.reference.source", value="IMPLIED_FEATURE"
URI="oracle/mtom_encode_fault_service_policy", category=wsconfig, policy-status=enabled; source=local policy set; reference-status=enabled; effective=true
Property name="local.policy.reference.source", value="IMPLIED_FEATURE"
URI="oracle/max_request_size_policy", category=wsconfig, policy-status=enabled; source=local policy set; reference-status=enabled; effective=true
Property name="local.policy.reference.source", value="IMPLIED_FEATURE"
Property name="max.request.size", value="-1"
URI="oracle/request_processing_service_policy", category=wsconfig, policy-status=enabled; source=local policy set; reference-status=enabled; effective=true
Property name="local.policy.reference.source", value="IMPLIED_FEATURE"
URI="oracle/soap_request_processing_service_policy", category=wsconfig, policy-status=enabled; source=local policy set; reference-status=enabled; effective=true
Property name="local.policy.reference.source", value="IMPLIED_FEATURE"
URI="oracle/ws_logging_level_policy", category=wsconfig, policy-status=enabled; source=local policy set; reference-status=enabled; effective=true
Property name="local.policy.reference.source", value="IMPLIED_FEATURE"
Property name="logging.level", value=""
URI="oracle/test_page_processing_service_policy", category=wsconfig, policy-status=enabled; source=local policy set; reference-status=enabled; effective=true
Property name="local.policy.reference.source", value="IMPLIED_FEATURE"
URI="oracle/wsdl_request_processing_service_policy", category=wsconfig, policy-status=enabled; source=local policy set; reference-status=enabled; effective=true
Property name="local.policy.reference.source", value="IMPLIED_FEATURE"

The policy subject is not secure in this context.
Subject: WS-Service({http://oracle.j2ee.tests.ejb.impl/}JaxwsWithHandlerChainBeanService#JaxwsWithHandlerChainBeanPort)

URI="oracle/mex_request_processing_service_policy", category=wsconfig, policy-status=enabled; source=local policy set; reference-status=enabled; effective=true
Property name="local.policy.reference.source", value="IMPLIED_FEATURE"
URI="oracle/mtom_encode_fault_service_policy", category=wsconfig, policy-status=enabled; source=local policy set; reference-status=enabled; effective=true
Property name="local.policy.reference.source", value="IMPLIED_FEATURE"
URI="oracle/max_request_size_policy", category=wsconfig, policy-status=enabled; source=local policy set; reference-status=enabled; effective=true
Property name="local.policy.reference.source", value="IMPLIED_FEATURE"
Property name="max.request.size", value="-1"
URI="oracle/request_processing_service_policy", category=wsconfig, policy-status=enabled; source=local policy set; reference-status=enabled; effective=true
Property name="local.policy.reference.source", value="IMPLIED_FEATURE"
URI="oracle/soap_request_processing_service_policy", category=wsconfig, policy-status=enabled; source=local policy set; reference-status=enabled; effective=true
Property name="local.policy.reference.source", value="IMPLIED_FEATURE"
URI="oracle/ws_logging_level_policy", category=wsconfig, policy-status=enabled; source=local policy set; reference-status=enabled; effective=true
Property name="local.policy.reference.source", value="IMPLIED_FEATURE"
Property name="logging.level", value=""
URI="oracle/test_page_processing_service_policy", category=wsconfig, policy-status=enabled; source=local policy set; reference-status=enabled; effective=true
Property name="local.policy.reference.source", value="IMPLIED_FEATURE"
URI="oracle/wsdl_request_processing_service_policy", category=wsconfig, policy-status=enabled; source=local policy set; reference-status=enabled; effective=true
Property name="local.policy.reference.source", value="IMPLIED_FEATURE"

The policy subject is not secure in this context.
...

listWSMPolicySubjectsおよびlistWebServicesコマンドに関する情報は、『インフラストラクチャ・コンポーネントのためのWLSTコマンド・リファレンス』のWebサービス・カスタムWLSTコマンドに関する項を参照してください。

4.2.2 WLSTを使用したアプリケーション内でのWebサービスの表示

アプリケーションのWebサービスを表示する手順は次のとおりです。

1. 「WebサービスのカスタムWLSTコマンドへのアクセス」の説明に従って、アプリケーションがデプロイされるWebLogic Serverの実行中のインスタンスに接続します。

2. WLSTコマンドlistWebServices()を使用して、アプリケーションのWebサービスのリストを表示します。アプリケーションとアプリケーションがデプロイされるサーバー・インスタンスを特定するには、完全なアプリケーション・パスを指定する必要があります。

listWebServices (application,composite,[detail]

次に例を示します。

wls:/wls-domain/serverConfig>listWebServices("wls-domain/AdminServer/jaxwsejb30ws")
/wls-domain/AdminServer/jaxwsejb30ws:
moduleName=jaxwsejb,moduleType=web,serviceName={http://namespace/}JaxwsWithHandlerChainBeanService
moduleName=jaxwsejb, moduleType=web, serviceName={http://namespace/}WsdlConcreteService
moduleName=jaxwsejb, moduleType=web, serviceName={http://namespace/}EchoEJBService
moduleName=jaxwsejb, moduleType=web, serviceName={http://namespace/}CalculatorService
moduleName=jaxwsejb, moduleType=web, serviceName={http://namespace/}DoclitWrapperWTJService

listWebServicesコマンドに関する詳細は、『インフラストラクチャ・コンポーネントのためのWLSTコマンド・リファレンス』のWebサービス・カスタムWLSTコマンドに関する項を参照してください。

4.2.3 WLSTを使用したWebサービス・エンドポイントの詳細の表示

Webサービス・エンドポイント(ポート)の詳細を表示する手順は次のとおりです。

1. 「WebサービスのカスタムWLSTコマンドへのアクセス」の説明に従って、アプリケーションがデプロイされるWebLogic Serverの実行中のインスタンスに接続します。

2. 「WLSTを使用したアプリケーションのWebサービスの表示」の説明に従って、WLSTコマンドlistWebServicesを使用して、アプリケーションのWebサービスのリストを表示します。

3. listWebServicePortsコマンドを使用して、Webサービスのエンドポイント名とエンドポイントURLを表示します。

listWebServicePorts(application,moduleOrCompName,moduleType,serviceName)

たとえば、WsdlConcreteServiceのエンドポイントを表示するには、次のようにします。

wls:/wls-domain/serverConfig> listWebServicePorts ('jaxwsejb30ws','jaxwsejb','web','WsdlConcreteService')

WsdlConcretePort   http://host.example.com:7001/jaxwsejb/WsdlAbstract

4. listWebServicePoliciesコマンドを使用して、Webサービス・エンドポイントに添付されたポリシーを表示します。

listWebServicePolicies(application,moduleOrCompName,moduleType,serviceName,subjectName)

たとえば、WsdlConcretePortエンドポイントに添付されたポリシーとポリシーのオーバーライド設定を表示するには、次のようにします。

wls:/wls_domain/serverConfig> listWebServicePolicies ("jaxwsejb30ws", "jaxwsejb","web","WsdlConcreteService","WsdlConcretePort")

WsdlConcretePort :
URI="oracle/mex_request_processing_service_policy", category=wsconfig, policy-status=enabled; source=local policy set; reference-status=enabled; effective=true
URI="oracle/mtom_encode_fault_service_policy", category=wsconfig, policy-status=enabled; source=local policy set; reference-status=enabled; effective=true
URI="oracle/max_request_size_policy", category=wsconfig, policy-status=enabled; source=local policy set; reference-status=enabled; effective=true
Property name="max.request.size", value="-1"
URI="oracle/request_processing_service_policy", category=wsconfig, policy-status=enabled; source=local policy set; reference-status=enabled; effective=true
URI="oracle/soap_request_processing_service_policy", category=wsconfig, policy-status=enabled; source=local policy set; reference-status=enabled; effective=true
URI="oracle/ws_logging_level_policy", category=wsconfig, policy-status=enabled; source=local policy set; reference-status=enabled; effective=true
Property name="logging.level", value=""
URI="oracle/test_page_processing_service_policy", category=wsconfig, policy-status=enabled; source=local policy set; reference-status=enabled; effective=true
URI="oracle/wsdl_request_processing_service_policy", category=wsconfig, policy-status=enabled; source=local policy set; reference-status=enabled; effective=true
URI="oracle/wss_saml_or_username_token_over_ssl_service_policy", category=security, policy-status=enabled; source=global policy set "test_PS", scope="DOMAIN('*')"; reference-status=enabled; effective=true

The policy subject is secure in this context.

これらのWLSTコマンドおよび議論に関する情報は、『インフラストラクチャ・コンポーネントのためのWLSTコマンド・リファレンス』のWebサービス・カスタムWLSTコマンドに関する項を参照してください。

4.2.4 WLSTを使用したWebサービス・クライアントの表示

WLSTコマンドを使用してWebサービス・クライアントを表示するには、次の手順に従ってください。

1. 「WebサービスのカスタムWLSTコマンドへのアクセス」の説明に従って、アプリケーションがデプロイされるWebLogic Serverの実行中のインスタンスに接続します。

2. WLSTコマンドlistWebServiceClientsを使用して、Webサービス・クライアントのリストを表示します。

listWebServiceClients(application,composite,[detail])

このコマンドにより、アプリケーション、SOAコンポジット、またはドメインのクライアントのリストを表示できます。アプリケーションまたはSOAコンポジットのクライアント情報をリストするには、該当する引数を指定します。アプリケーションまたはSOAコンポジットを指定しない場合は、このコマンドにより、ドメインの各サーバー・インスタンスのすべてのアプリケーションとコンポジットのすべてのWebサービス・クライアントに対して、モジュール名、モジュール・タイプ、SOA参照名などの情報が出力されます。エンドポイントおよびポリシーを含む、各クライアントに関する詳細を表示するには、detail引数をtrueに設定します。

次に例を示します。

wls:/soainfra/serverConfig> listWebServiceClients(detail='true')

/soainfra/soa_server1/soa-infra :

compositeName=default/SampleSOAFirstPrj[1.0], moduleType=soa, serviceRefName=ReferenceToSecondSOA

BPELProcess1_pt   serviceWSDLURI=

http://localhost:8001/soa-infra/services/default/

SampleSOASecondPrj/BPELProcess1.wsdl

oracle.webservices.contentTransferEncoding=base64

oracle.webservices.charsetEncoding=UTF-8

oracle.webservices.operationStyleProperty=document

oracle.webservices.soapVersion=soap1.1

oracle.webservices.chunkSize=4096

oracle.webservices.preemptiveBasicAuth=false

oracle.webservices.session.maintain=false

oracle.webservices.encodingStyleProperty=

http://schemas.xmlsoap.org/soap/encoding/

oracle.webservices.donotChunk=true

No attached policies found; endpoint is not secure.

/soainfra/AdminServer/ADFDCDecoupling_Project1_ADFDCDecoupling-1 :
moduleName=testadfbc, moduleType=wsconn,
serviceRefName=AppModuleService
AppModuleServiceSoapHttpPort
serviceWSDLURI=http://adc1140275.example.com:7001/ADFBCDecoupling-ADFBCDecoupling-context-root/AppModuleService?wsdl
URI="oracle/wss10_saml_token_with_message_protection_client_
policy", category=security, policy-status=enabled; source=local policy set;
reference-status=enabled; effective=true

The policy subject is secure in this context.

出力にはSOAコンポジットdefault/SampleSOAFirstPrj[1.0]のSOA参照が表示されることに注意してください(serviceRefName引数を使用した場合)。SOAコンポジットのSOA参照をリストするには、コマンドでコンポジット名を指定します(例: listWebServiceClients(None,'default/SampleSOAFirstPrj[1.0]'))。

ADFクライアントは、出力ではmoduleType=wsconn引数によって指定されます。

このWLSTコマンドおよびその議論に関する情報は、『インフラストラクチャ・コンポーネントのためのWLSTコマンド・リファレンス』のWebサービス・カスタムWLSTコマンドに関する項を参照してください。

4.2.5 WLSTを使用したWebサービスの構成の概要

注意:

この項で説明する手順は、SOA以外のOracle Infrastructure Webサービスおよびプロパイダにのみ適用されます。

Oracle Infrastructure Webサービス・プロバイダは、java.xml.ws.Providerインタフェースを実装しています。「Webサービス・エンドポイント」ページに「実装クラス」を表示し、構成プロパティのサブセットを提供します。

WLSTを使用してWebサービス・エンドポイントを構成には、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』の構成ポリシーに関する項で定義される構成ポリシーのうちの1つを添付します。

次の項では、WLSTを使用して、一般的なWebサービスの構成タスクを実行する方法を説明します。

- WLSTを使用したアドレス指定の構成

- WLSTを使用した非同期Webサービスの構成

- WLSTを使用した非同期WebサービスのJMSシステム・ユーザーの構成

- WLSTを使用した信頼性のあるメッセージの構成

- WLSTを使用した原子性トランザクションの構成

- WLSTを使用したMTOMの構成

- WLSTを使用したFast Infosetの構成

- WLSTを使用したSOAP Over JMS Transportの構成

- WLSTを使用した永続性の構成

- WLSTを使用したWebサービスの有効化または無効化

- WLSTを使用したWebサービスWSDLドキュメントへのパブリック・アクセスの有効化または無効化

- WLSTを使用したSOAPリクエストのプロセスの有効化または無効化

- WLSTを使用したNon-SOAP XMLメッセージ・プロセスの有効化または無効化

- WLSTを使用した診断ログのログ・レベルの設定

- WLSTを使用したWebサービスのテスト・クライアントの有効化または無効化の概要

- WLSTを使用したMTOMエンコード化SOAPフォルト・メッセージの有効化または無効化

- WLSTを使用したリクエスト・メッセージの検証

- WLSTを使用したリクエスト・メッセージの最大サイズの設定

- コンテンツのバイナリ・キャッシングの構成

4.2.5.1 WLSTを使用したアドレス指定の構成

WLSTを使用してWebサービス・アドレスを構成する手順は次のとおりです。

1. attachWSMPolicyコマンドを使用してポリシーoracle/wsaddr_policyを添付します。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のOracle Web Services Managerを使用したポリシーの直接的な添付に関する項を参照してください。

次に例を示します。

wls:/wls_domain/serverConfig> attachWSMPolicy("oracle/wsaddr_policy")

Policy reference "oracle/wsaddr_policy" added.

2. setWSMPolicyOverrideコマンドを使用して、ポリシーを構成します。オーバーライドできる構成プロパティについては、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』の「oracle/wsaddr_policy」を参照してください。

wls:/wls_domain/serverConfig> setWSMPolicyOverride('oracle/wsaddr_policy','reference.priority','10')

The configuration override property "reference.priority" having value "10" has been added to the reference to policy with URI "oracle/wsaddr_policy".

reference.priority構成プロパティのオーバーライドに関する情報は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のポリシー添付のプロパティの指定に関する項を参照してください。

3. 次の例のように、commitWSMSessionコマンドを使用してセッションをコミットします。

wls:/wls_domain/serverConfig> commitWSMSession()

The policy set for subject "/weblogic/base_domain/jaxwsejb30ws|#jaxwsejb|WS-Service({http://ejb.oracle.com/targetNamespace}EchoEJBService#EchoEJBServicePort)" was saved successfully.

ポリシーのアドレス指定を無効にするには、次の手順のうちの1つを実行します。

- ポリシーをデタッチします。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のWLSTを使用したポリシーの直接的な添付のデタッチに関する項を参照してください。

- ポリシーを無効化します。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のWLSTを使用したポリシーの直接的な添付の有効化および無効化に関する項を参照してください。

- attachWSMPolicyコマンドを使用してポリシーoracle/no_addressing_policyを添付して、広範囲で構成されたアドレス化ポリシーを無効にします。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のOracle Web Services Managerを使用したポリシーの直接的な添付に関する項を参照してください。
次に例を示します。

wls:/wls_domain/serverConfig> attachWSMPolicy("oracle/no_addressing_policy")

Policy reference "oracle/no_addressing_policy" added.

WLSTコマンドに関する情報は、『インフラストラクチャ・コンポーネントのためのWLSTコマンド・リファレンス』のWebサービス・カスタムWLSTコマンドに関する項を参照してください。

4.2.5.2 WLSTを使用した非同期Webサービスの構成

非同期Webサービスを構成する手順は次のとおりです。

1. attachWSMPolicyコマンドを使用してポリシーoracle/async_web_service_policyを添付します。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のOracle Web Services Managerを使用したポリシーの直接的な添付に関する項を参照してください。

次に例を示します。

wls:/wls_domain/serverConfig> attachWSMPolicy("oracle/async_web_service_policy")

Policy reference "oracle/async_web_service_policy" added.

2. setWSMPolicyOverrideコマンドを使用して、ポリシーを構成します。オーバーライドできる構成プロパティについては、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』の「oracle/async_web_service_policyを参照してください。

wls:/wls_domain/serverConfig> setWSMPolicyOverride('oracle/async_web_service_policy','jms.queue','myDefaultRequestQueue')

The configuration override property "jms.queue" having value "myDefaultRequestQueue" has been added to the reference to policy with URI "oracle/async_web_service_policy".

3. 次の例のように、commitWSMSessionコマンドを使用してセッションをコミットします。

wls:/wls_domain/serverConfig> commitWSMSession()

The policy set for subject "/weblogic/base_domain/jaxwsejb30ws|#jaxwsejb|WS-Service({http://ejb.oracle.com/targetNamespace}EchoEJBService#EchoEJBServicePort)" was saved successfully.

非同期ポリシーを無効にするには、次の手順のうちの1つを実行します。

- ポリシーをデタッチします。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のWLSTを使用したポリシーの直接的な添付のデタッチに関する項を参照してください。

- ポリシーを無効化します。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のWLSTを使用したポリシーの直接的な添付の有効化および無効化に関する項を参照してください。

- attachWSMPolicyコマンドを使用してポリシーoracle/no_async_web_service_policyを添付して、広範囲で構成された非同期ポリシーを無効にします。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のOracle Web Services Managerを使用したポリシーの直接的な添付に関する項を参照してください。
次に例を示します。

wls:/wls_domain/serverConfig> attachWSMPolicy("oracle/no_async_web_service_policy")

Policy reference "oracle/no_async_web_service_policy" added.

WLSTコマンドに関する情報は、『インフラストラクチャ・コンポーネントのためのWLSTコマンド・リファレンス』のWebサービス・カスタムWLSTコマンドに関する項を参照してください。

4.2.5.3 WLSTを使用した非同期WebサービスのJMSシステム・ユーザーの構成

非同期WebサービスのJMSシステム・ユーザーを構成する手順は次のとおりです。

1. attachWSMPolicyコマンドを使用してポリシーoracle/async_web_service_policyを添付します。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のOracle Web Services Managerを使用したポリシーの直接的な添付に関する項を参照してください。

次に例を示します。

wls:/wls_domain/serverConfig> attachWSMPolicy("oracle/async_web_service_policy")

Policy reference "oracle/async_web_service_policy" added.

2. setWSMPolicyOverrideコマンドを使用して、jms.access.userポリシー構成プロパティを構成します。オーバーライドできる構成プロパティについては、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』の「oracle/async_web_service_policyを参照してください。

wls:/wls_domain/serverConfig> setWSMPolicyOverride('oracle/async_web_service_policy','jms.access.user','OracleSystemUser')

The configuration override property "jms.access.user" having value "OracleSystemUser" has been added to the reference to policy with URI "oracle/async_web_service_policy".

3. 次の例のように、commitWSMSessionコマンドを使用してセッションをコミットします。

wls:/wls_domain/serverConfig> commitWSMSession()

The policy set for subject "/weblogic/base_domain/jaxwsejb30ws|#jaxwsejb|WS-Service({http://ejb.oracle.com/targetNamespace}EchoEJBService#EchoEJBServicePort)" was saved successfully.

非同期ポリシーを無効にするには、次の手順のうちの1つを実行します。

- ポリシーをデタッチします。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のWLSTを使用したポリシーの直接的な添付のデタッチに関する項を参照してください。

- ポリシーを無効化します。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のWLSTを使用したポリシーの直接的な添付の有効化および無効化に関する項を参照してください。

- attachWSMPolicyコマンドを使用してポリシーoracle/no_async_web_service_policyを添付して、広範囲で構成された非同期ポリシーを無効にします。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のOracle Web Services Managerを使用したポリシーの直接的な添付に関する項を参照してください。
次に例を示します。

wls:/wls_domain/serverConfig> attachWSMPolicy("oracle/no_async_web_service_policy")

Policy reference "oracle/no_async_web_service_policy" added.

WLSTコマンドに関する情報は、『インフラストラクチャ・コンポーネントのためのWLSTコマンド・リファレンス』のWebサービス・カスタムWLSTコマンドに関する項を参照してください。

4.2.5.4 WLSTを使用した信頼性のあるメッセージの構成

WLSTを使用してWebサービスの信頼性のあるメッセージングを構成する手順は次のとおりです。

1. attachWSMPolicyコマンドを使用してポリシーoracle/reliable_messaging_policyを添付します。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のOracle Web Services Managerを使用したポリシーの直接的な添付に関する項を参照してください。

次に例を示します。

wls:/wls_domain/serverConfig> attachWSMPolicy("oracle/reliable_messaging_policy")

Policy reference "oracle/reliable_messaging_policy" added.

2. setWSMPolicyOverrideコマンドを使用して、ポリシーを構成します。オーバーライドできる構成プロパティについては、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』の「oracle/reliable_messaging_policyを参照してください。

wls:/wls_domain/serverConfig> setWSMPolicyOverride('oracle/reliable_messaging_policy','acknowledgement.interval','P0DT01S')

The configuration override property "acknowledgement.interval" having value "P0DT01S" has been added to the reference to policy with URI "oracle/reliable_messaging_policy".

3. 次の例のように、commitWSMSessionコマンドを使用してセッションをコミットします。

wls:/wls_domain/serverConfig> commitWSMSession()

The policy set for subject "/weblogic/base_domain/jaxwsejb30ws|#jaxwsejb|WS-Service({http://ejb.oracle.com/targetNamespace}EchoEJBService#EchoEJBServicePort)" was saved successfully.

Webサービスの信頼性のあるメッセージング・ポリシーを無効にするには、次の手順のうちの1つを実行します。

- ポリシーをデタッチします。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のWLSTを使用したポリシーの直接的な添付のデタッチに関する項を参照してください。

- ポリシーを無効化します。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のWLSTを使用したポリシーの直接的な添付の有効化および無効化に関する項を参照してください。

- attachWSMPolicyコマンドを使用してポリシーoracle/no_reliable_messaging_policyを添付して、広範囲で構成された信頼性のあるメッセージング・ポリシーを無効にします。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のOracle Web Services Managerを使用したポリシーの直接的な添付に関する項を参照してください。
次に例を示します。

wls:/wls_domain/serverConfig> attachWSMPolicy("oracle/no_reliable_messaging_policy")

Policy reference "oracle/no_reliable_messaging_policy" added.

WLSTコマンドに関する情報は、『インフラストラクチャ・コンポーネントのためのWLSTコマンド・リファレンス』のWebサービス・カスタムWLSTコマンドに関する項を参照してください。

4.2.5.5 WLSTを使用した原子性トランザクションの構成

Webサービスの原子性トランザクションを構成する手順は次のとおりです。

1. attachWSMPolicyコマンドを使用してポリシーoracle/atomic_transaction_policyを添付します。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のOracle Web Services Managerを使用したポリシーの直接的な添付に関する項を参照してください。

次に例を示します。

wls:/wls_domain/serverConfig> attachWSMPolicy("oracle/atomic_transaction_policy")

Policy reference "oracle/atomic_transaction_policy" added.

2. setWSMPolicyOverrideコマンドを使用して、ポリシーを構成します。オーバーライドできる構成プロパティについては、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』の「oracle/atomic_transaction_policyを参照してください。

wls:/wls_domain/serverConfig> setWSMPolicyOverride('oracle/atomic_transaction_policy','version','WSAT11')

The configuration override property "version" having value "WSAT11" has been added to the reference to policy with URI "oracle/atomic_transaction_policy".

3. 次の例のように、commitWSMSessionコマンドを使用してセッションをコミットします。

wls:/wls_domain/serverConfig> commitWSMSession()

The policy set for subject "/weblogic/base_domain/jaxwsejb30ws|#jaxwsejb|WS-Service({http://ejb.oracle.com/targetNamespace}EchoEJBService#EchoEJBServicePort)" was saved successfully.

Webサービスの原子性トランザクション・ポリシーを無効にするには、次の手順のうちの1つを実行します。

- ポリシーをデタッチします。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のWLSTを使用したポリシーの直接的な添付のデタッチに関する項を参照してください。

- ポリシーを無効化します。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のWLSTを使用したポリシーの直接的な添付の有効化および無効化に関する項を参照してください。

- attachWSMPolicyコマンドを使用してポリシーoracle/no_atomic_transaction_policyを添付して、広範囲で構成された原子性トランザクション・ポリシーを無効にします。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のOracle Web Services Managerを使用したポリシーの直接的な添付に関する項を参照してください。
次に例を示します。

wls:/wls_domain/serverConfig> attachWSMPolicy("oracle/no_atomic_transaction_policy")

Policy reference "oracle/no_atomic_transaction_policy" added.

WLSTコマンドに関する情報は、『インフラストラクチャ・コンポーネントのためのWLSTコマンド・リファレンス』のWebサービス・カスタムWLSTコマンドに関する項を参照してください。

4.2.5.6 WLSTを使用したMTOMの構成

WLSTを使用してWebサービスのMTOMを構成する手順は次のとおりです。

1. attachWSMPolicyコマンドを使用して、Webサービスにoracle/wsmtom_policyを添付します。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のOracle Web Services Managerを使用したポリシーの直接的な添付に関する項を参照してください。

次に例を示します。

wls:/wls_domain/serverConfig> attachWSMPolicy("oracle/wsmtom_policy")

Policy reference "oracle/wsmtom_policy" added.

2. setWSMPolicyOverrideコマンドを使用して、ポリシーを構成します。オーバーライドできる構成プロパティについては、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』の「oracle/wsmtom_policyを参照してください。

wls:/wls_domain/serverConfig> setWSMPolicyOverride('oracle/wsmtom_policy','reference.priority','10')

The configuration override property "reference.priority" having value "10" has been added to the reference to policy with URI "oracle/wsmtom_policy".

reference.priority構成プロパティのオーバーライドに関する情報は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のポリシー添付のプロパティの指定に関する項を参照してください。

3. 次の例のように、commitWSMSessionコマンドを使用してセッションをコミットします。

wls:/wls_domain/serverConfig> commitWSMSession()

The policy set for subject "/weblogic/base_domain/jaxwsejb30ws|#jaxwsejb|WS-Service({http://ejb.oracle.com/targetNamespace}EchoEJBService#EchoEJBServicePort)" was saved successfully.

Webサービスの原子性トランザクション・ポリシーを無効にするには、次の手順のうちの1つを実行します。

- ポリシーをデタッチします。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のWLSTを使用したポリシーの直接的な添付のデタッチに関する項を参照してください。

- ポリシーを無効化します。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のWLSTを使用したポリシーの直接的な添付の有効化および無効化に関する項を参照してください。

- attachWSMPolicyコマンドを使用してポリシーoracle/no_mtom_policyを添付して、広範囲で構成されたMTOMポリシーを無効にします。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のOracle Web Services Managerを使用したポリシーの直接的な添付に関する項を参照してください。
次に例を示します。

wls:/wls_domain/serverConfig> attachWSMPolicy("oracle/no_mtom_policy")

Policy reference "oracle/no_mtom_policy" added.

WLSTコマンドに関する情報は、『インフラストラクチャ・コンポーネントのためのWLSTコマンド・リファレンス』のWebサービス・カスタムWLSTコマンドに関する項を参照してください。

4.2.5.7 WLSTを使用したFast Infosetの構成

WLSTを使用してWebサービスまたはクライアントのFast Infosetを構成する手順は次のとおりです。

1. attachWSMPolicyコマンドを使用して、Webサービスまたはクライアントにoracle/fastinfoset_service_policyまたはoracle/fastinfoset_client_policyポリシーをそれぞれ添付します。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のOracle Web Services Managerを使用したポリシーの直接的な添付に関する項を参照してください。

次に例を示します。

wls:/wls_domain/serverConfig> attachWSMPolicy("oracle/fast_infoset_service_policy")

Policy reference "oracle/fast_infoset_service_policy" added.

2. setWSMPolicyOverrideコマンドを使用して、ポリシーを構成します。オーバーライドできる構成プロパティについては、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』の「oracle/fast_infoset_service_policy」および「oracle/fast_infoset_client_policy」を参照してください。

wls:/wls_domain/serverConfig> setWSMPolicyOverride('oracle/fast_infoset_client_policy','fast.infoset.content.negotiation','OPTIMISTIC')

The configuration override property "fast.infoset.content.negotiation" having value "OPTIMISTIC" has been added to the reference to policy with URI "oracle/fast_infoset_client_policy".

3. 次の例のように、commitWSMSessionコマンドを使用してセッションをコミットします。

wls:/wls_domain/serverConfig> commitWSMSession()

The policy set for subject "/weblogic/base_domain/jaxwsejb30ws|#jaxwsejb|WS-Service({http://ejb.oracle.com/targetNamespace}EchoEJBService#EchoEJBServicePort)" was saved successfully.

WebサービスのFast Infosetポリシーを無効にするには、次の手順のうちの1つを実行します。

- ポリシーをデタッチします。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のWLSTを使用したポリシーの直接的な添付のデタッチに関する項を参照してください。

- ポリシーを無効化します。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のWLSTを使用したポリシーの直接的な添付の有効化および無効化に関する項を参照してください。

- attachWSMPolicyコマンドを使用してポリシーoracle/no_fast_infoset_service_policyを添付して、広範囲で構成されたFast Infosetポリシーを無効にします。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のOracle Web Services Managerを使用したポリシーの直接的な添付に関する項を参照してください。
次に例を示します。

wls:/wls_domain/serverConfig> attachWSMPolicy("oracle/no_fast_infoset_service_policy")

Policy reference "oracle/no_fast_infoset_service_policy" added.

WLSTコマンドに関する情報は、『インフラストラクチャ・コンポーネントのためのWLSTコマンド・リファレンス』のWebサービス・カスタムWLSTコマンドに関する項を参照してください。

4.2.5.8 WLSTを使用したSOAP Over JMS Transportの構成

WLSTを使用してWebサービスまたはクライアントのSOAP over JMSトランスポートを構成する手順は次のとおりです。

1. attachWSMPolicyコマンドを使用して、Webサービスまたはクライアントにoracle/jms_transport_service_policyまたはoracle/jms_transport_client_policyポリシーをそれぞれ添付します。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のOracle Web Services Managerを使用したポリシーの直接的な添付に関する項を参照してください。

次に例を示します。

wls:/wls_domain/serverConfig> attachWSMPolicy("oracle/jms_transport_service_policy")

Policy reference "oracle/jms_transport_service_policy" added.

2. setWSMPolicyOverrideコマンドを使用して、ポリシーを構成します。オーバーライドできる構成プロパティについては、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』の「oracle/jms_transport_service_policyおよび「oracle/jms_transport_client_policyを参照してください。

wls:/wls_domain/serverConfig> setWSMPolicyOverride('oracle/jms_transport_service_policy','jndi.connection.factory.name','com.oracle.webservices.jms.ConnectionFactory')

The configuration override property "jndi.connection.factory.name" having value "com.oracle.webservices.jms.ConnectionFactory" has been added to the reference to policy with URI "oracle/jms_transport_service_policy".

3. 次の例のように、commitWSMSessionコマンドを使用してセッションをコミットします。

wls:/wls_domain/serverConfig> commitWSMSession()

The policy set for subject "/weblogic/base_domain/jaxwsejb30ws|#jaxwsejb|WS-Service({http://ejb.oracle.com/targetNamespace}EchoEJBService#EchoEJBServicePort)" was saved successfully.

SOAP over JMS transportポリシーを無効にするには、次の手順のうちの1つを実行します。

- ポリシーをデタッチします。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のWLSTを使用したポリシーの直接的な添付のデタッチに関する項を参照してください。

- ポリシーを無効化します。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のWLSTを使用したポリシーの直接的な添付の有効化および無効化に関する項を参照してください。

- attachWSMPolicyコマンドを使用してポリシーoracle/no_jms_transport_service_policyを添付して、広範囲で構成されたSOAP over JMS transportポリシーを無効にします。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のOracle Web Services Managerを使用したポリシーの直接的な添付に関する項を参照してください。
次に例を示します。

wls:/wls_domain/serverConfig> attachWSMPolicy("oracle/no_jms_transport_service_policy")

Policy reference "oracle/no_jms_transport_service_policy" added.

WLSTコマンドに関する情報は、『インフラストラクチャ・コンポーネントのためのWLSTコマンド・リファレンス』のWebサービス・カスタムWLSTコマンドに関する項を参照してください。

4.2.5.9 WLSTを使用した永続性の構成

WLSTを使用した永続性の構成方法:

1. attachWSMPolicyコマンドを使用して、Webサービスにoracle/persistence_policyを添付します。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のOracle Web Services Managerを使用したポリシーの直接的な添付に関する項を参照してください。

次に例を示します。

wls:/wls_domain/serverConfig> attachWSMPolicy("oracle/persistence_policy")

Policy reference "oracle/persistence_policy" added.

2. setWSMPolicyOverrideコマンドを使用して、ポリシーを構成します。オーバーライドできる構成プロパティについては、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』の「oracle/persistence_policyを参照してください。

注意:

Java SEクライアントの場合、oracle:jrf:Coherenceだけを構成可能です。

wls:/wls_domain/serverConfig> setWSMPolicyOverride('oracle/persistence_policy','providerName', 'oracle:jrf:Coherence')

The configuration override property "peristence_policy" having value "oracle:jrf:Coherence" has been added to the reference to policy with URI "oracle/persistence_policy".

3. 次の例のように、commitWSMSessionコマンドを使用してセッションをコミットします。

wls:/wls_domain/serverConfig> commitWSMSession()

The policy set for subject "/weblogic/base_domain/jaxwsejb30ws|#jaxwsejb|WS-Service({http://ejb.oracle.com/targetNamespace}EchoEJBService#EchoEJBServicePort)" was saved successfully.

永続性ポリシーを無効にするには、次の手順のうちの1つを実行します。

- ポリシーをデタッチします。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のWLSTを使用したポリシーの直接的な添付のデタッチに関する項を参照してください。

- ポリシーを無効化します。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のWLSTを使用したポリシーの直接的な添付の有効化および無効化に関する項を参照してください。

- attachWSMPolicyコマンドを使用してポリシーoracle/no_persistent_policyを添付して、広範囲で構成された永続性ポリシーを無効にします。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のOracle Web Services Managerを使用したポリシーの直接的な添付に関する項を参照してください。
次に例を示します。

wls:/wls_domain/serverConfig> attachWSMPolicy("oracle/no_persistent_policy")

Policy reference "oracle/no_persistent_policy" added.

WLSTコマンドに関する情報は、『インフラストラクチャ・コンポーネントのためのWLSTコマンド・リファレンス』のWebサービス・カスタムWLSTコマンドに関する項を参照してください。

WLSTコマンドに関する情報は、『インフラストラクチャ・コンポーネントのためのWLSTコマンド・リファレンス』のWebサービス・カスタムWLSTコマンドに関する項を参照してください。

4.2.5.10 WLSTを使用したWebサービスの有効化または無効化

Webサービス・アプリケーションがデプロイされると、エラーが発生しない場合、Webサービス・エンドポイントがデフォルトで有効化されます。エラーが発生した場合、Webサービス・アプリケーションはデプロイされますが、Webサービス・エンドポイントは有効化されません。

Webサービスを無効化して、一時的にWebサービスを使用不可にすることが必要な場合があります。たとえば、無効なポリシー参照を修正する必要がある場合です。Webサービスを無効化すると、Webサービスへのリクエストが失敗します。Webサービスを無効化するには、Webサービスがリクエストを受信するエンドポイントを使用不可にする必要があります。

WLSTを使用してWebサービス・エンドポイントを有効にする手順は次のとおりです。

1. attachWSMPolicyコマンドを使用してポリシーoracle/request_processing_service_policyを添付します。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のOracle Web Services Managerを使用したポリシーの直接的な添付に関する項を参照してください。

次に例を示します。

wls:/wls_domain/serverConfig> attachWSMPolicy("oracle/request_processing_service_policy")

Policy reference "oracle/request_processing_service_policy" added.

2. setWSMPolicyOverrideコマンドを使用して、ポリシーを構成します。オーバーライドできる構成プロパティについては、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』の「oracle/request_processing_service_policyを参照してください。

wls:/wls_domain/serverConfig> setWSMPolicyOverride("oracle/request_processing_service_policy", "reference.priority", "10")

reference.priority構成プロパティのオーバーライドに関する情報は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のポリシー添付のプロパティの指定に関する項を参照してください。

Webサービスのアクセス・ポリシーを無効にするには、次の手順のうちの1つを実行します。

- ポリシーをデタッチします。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のWLSTを使用したポリシーの直接的な添付のデタッチに関する項を参照してください。

- ポリシーを無効化します。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のWLSTを使用したポリシーの直接的な添付の有効化および無効化に関する項を参照してください。

- attachWSMPolicyコマンドを使用してポリシーoracle/no_pox_http_binding_service_policyを添付して、広範囲で構成されたWebサービスのアクセス・ポリシーを無効にします。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のOracle Web Services Managerを使用したポリシーの直接的な添付に関する項を参照してください。
次に例を示します。

wls:/wls_domain/serverConfig> attachWSMPolicy("oracle/no_request_processing_service_policy")

Policy reference "oracle/no_request_processing_service_policy" added.

WLSTコマンドに関する情報は、『インフラストラクチャ・コンポーネントのためのWLSTコマンド・リファレンス』のWebサービス・カスタムWLSTコマンドに関する項を参照してください。

4.2.5.11 WLSTを使用したWebサービスWSDLドキュメントへのパブリック・アクセスの有効化または無効化

WLSTを使用してWebサービスWSDLドキュメントへのパブリック・アクセスを有効にする手順は次のとおりです。

1. attachWSMPolicyコマンドを使用して、Webサービスにoracle/wsdl_request_processing_service_policyを添付します。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のOracle Web Services Managerを使用したポリシーの直接的な添付に関する項を参照してください。

次に例を示します。

wls:/wls_domain/serverConfig> attachWSMPolicy("oracle/wsdl_request_processing_service_policy")

Policy reference "oracle/wsdl_request_processing_service_policy" added.

2. setWSMPolicyOverrideコマンドを使用して、ポリシーを構成します。オーバーライドできる構成プロパティについては、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』の「oracle/wsdl_request_processing_service_policyを参照してください。

wls:/wls_domain/serverConfig> setWSMPolicyOverride('oracle/wsdl_request_processing_service_policy','reference.priority,'10')

The configuration override property "reference.priority" having value "10" has been added to the reference to policy with URI "oracle/wsdl_request_processing_service_policy".

reference.priority構成プロパティのオーバーライドに関する情報は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のポリシー添付のプロパティの指定に関する項を参照してください。

3. 次の例のように、commitWSMSessionコマンドを使用してセッションをコミットします。

wls:/wls_domain/serverConfig> commitWSMSession()

The policy set for subject "/weblogic/base_domain/jaxwsejb30ws|#jaxwsejb|WS-Service({http://ejb.oracle.com/targetNamespace}EchoEJBService#EchoEJBServicePort)" was saved successfully.

WSDLアクセス・ポリシーを無効にするには、次の手順のうちの1つを実行します。

- ポリシーをデタッチします。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のWLSTを使用したポリシーの直接的な添付のデタッチに関する項を参照してください。

- ポリシーを無効化します。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のWLSTを使用したポリシーの直接的な添付の有効化および無効化に関する項を参照してください。

- attachWSMPolicyコマンドを使用してポリシーoracle/no_wsdl_request_processing_service_policyを添付して、広範囲で構成されたWSDLアクセス・ポリシーを無効にします。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のOracle Web Services Managerを使用したポリシーの直接的な添付に関する項を参照してください。
次に例を示します。

wls:/wls_domain/serverConfig> attachWSMPolicy("oracle/no_wsdl_request_processing_service_policy")

Policy reference "oracle/no_wsdl_request_processing_service_policy" added.

WLSTコマンドに関する情報は、『インフラストラクチャ・コンポーネントのためのWLSTコマンド・リファレンス』のWebサービス・カスタムWLSTコマンドに関する項を参照してください。

4.2.5.12 WLSTを使用したSOAPリクエストのプロセスの有効化または無効化

WLSTを使用したSOAPリクエストのプロセスの有効化方法:

1. attachWSMPolicyコマンドを使用して、Webサービスにoracle/soap_request_processing_service_policyを添付します。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のOracle Web Services Managerを使用したポリシーの直接的な添付に関する項を参照してください。

次に例を示します。

wls:/wls_domain/serverConfig> attachWSMPolicy("oracle/soap_request_processing_service_policy")

Policy reference "oracle/soap_request_processing_service_policy" added.

2. setWSMPolicyOverrideコマンドを使用して、ポリシーを構成します。オーバーライドできる構成プロパティについては、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』の「oracle/soap_request_processing_service_policyを参照してください。

wls:/wls_domain/serverConfig> setWSMPolicyOverride('oracle/soap_request_processing_service_policy','reference.priority', '10')

The configuration override property "reference.priority" having value "10" has been added to the reference to policy with URI "oracle/soap_request_processing_service_policy".

reference.priority構成プロパティのオーバーライドに関する情報は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のポリシー添付のプロパティの指定に関する項を参照してください。

3. 次の例のように、commitWSMSessionコマンドを使用してセッションをコミットします。

wls:/wls_domain/serverConfig> commitWSMSession()

The policy set for subject "/weblogic/base_domain/jaxwsejb30ws|#jaxwsejb|WS-Service({http://ejb.oracle.com/targetNamespace}EchoEJBService#EchoEJBServicePort)" was saved successfully.

SOAPリクエスト処理ポリシーを無効にするには、次の手順のうちの1つを実行します。

- ポリシーをデタッチします。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のWLSTを使用したポリシーの直接的な添付のデタッチに関する項を参照してください。

- ポリシーを無効化します。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のWLSTを使用したポリシーの直接的な添付の有効化および無効化に関する項を参照してください。

- attachWSMPolicyコマンドを使用してポリシーoracle/no_wsdl_request_processing_service_policyを添付して、広範囲で構成されたSOAPリクエスト処理ポリシーを無効にします。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のOracle Web Services Managerを使用したポリシーの直接的な添付に関する項を参照してください。
次に例を示します。

wls:/wls_domain/serverConfig> attachWSMPolicy("oracle/no_soap_request_processing_service_policy")

Policy reference "oracle/no_soap_request_processing_service_policy" added.

WLSTコマンドに関する情報は、『インフラストラクチャ・コンポーネントのためのWLSTコマンド・リファレンス』のWebサービス・カスタムWLSTコマンドに関する項を参照してください。

4.2.5.13 WLSTを使用したNon-SOAP XMLメッセージ・プロセスの有効化または無効化

WLSTを使用してユーザー定義のjavax.xml.ws.Provider<T>.invokeメソッドによって処理されたnon-SOAP XMLメッセージを受け取るエンドポイントを有効化する方法:

1. attachWSMPolicyコマンドを使用して、Webサービスにoracle/pox_http_binding_service_policyを添付します。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のOracle Web Services Managerを使用したポリシーの直接的な添付に関する項を参照してください。

次に例を示します。

wls:/wls_domain/serverConfig> attachWSMPolicy("oracle/pox_http_binding_service_policy")

Policy reference "oracle/pox_http_binding_service_policy" added.

2. setWSMPolicyOverrideコマンドを使用して、ポリシーを構成します。オーバーライドできる構成プロパティについては、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』の「oracle/pox_http_binding_service_policyを参照してください。

wls:/wls_domain/serverConfig> setWSMPolicyOverride('oracle/pox_http_binding_service_policy','reference.priority,'10')

The configuration override property "reference.priority" having value "10" has been added to the reference to policy with URI "oracle/pox_http_binding_service_policy".

reference.priority構成プロパティのオーバーライドに関する情報は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のポリシー添付のプロパティの指定に関する項を参照してください。

3. 次の例のように、commitWSMSessionコマンドを使用してセッションをコミットします。

wls:/wls_domain/serverConfig> commitWSMSession()

The policy set for subject "/weblogic/base_domain/jaxwsejb30ws|#jaxwsejb|WS-Service({http://ejb.oracle.com/targetNamespace}EchoEJBService#EchoEJBServicePort)" was saved successfully.

non-SOAP XMLメッセージ・ポリシーを無効にするには、次の手順のうちの1つを実行します。

- ポリシーをデタッチします。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のWLSTを使用したポリシーの直接的な添付のデタッチに関する項を参照してください。

- ポリシーを無効化します。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のWLSTを使用したポリシーの直接的な添付の有効化および無効化に関する項を参照してください。

- attachWSMPolicyコマンドを使用してポリシーoracle/no_pox_http_binding_service_policyを添付して、広範囲で構成されたnon-SOAP XMLメッセージ・ポリシーを無効にします。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のOracle Web Services Managerを使用したポリシーの直接的な添付に関する項を参照してください。
次に例を示します。

wls:/wls_domain/serverConfig> attachWSMPolicy("oracle/no_pox_http_binding_service_policy")

Policy reference "oracle/no_pox_http_binding_service_policy" added.

WLSTコマンドに関する情報は、『インフラストラクチャ・コンポーネントのためのWLSTコマンド・リファレンス』のWebサービス・カスタムWLSTコマンドに関する項を参照してください。

4.2.5.14 WLSTを使用した診断ログのログ・レベルの設定

WLSTを使用してWebサービス・エンドポイントにおける診断ログのロギング・レベルを設定する手順は次のとおりです。

1. attachWSMPolicyコマンドを使用して、Webサービスにoracle/ws_logging_level_policyを添付します。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のOracle Web Services Managerを使用したポリシーの直接的な添付に関する項を参照してください。

次に例を示します。

wls:/wls_domain/serverConfig> attachWSMPolicy("oracle/ws_logging_level_policy")

Policy reference "oracle/ws_logging_level_policy" added.

2. setWSMPolicyOverrideコマンドを使用して、ポリシーを構成します。オーバーライドできる構成プロパティについては、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』の「oracle/ws_logging_level_policyを参照してください。

wls:/wls_domain/serverConfig> setWSMPolicyOverride('oracle/ws_logging_level_policy','logging.level', 'INFO')

The configuration override property "loggging.level" having value "INFO" has been added to the reference to policy with URI "oracle/ws_logging_level_policy".

3. 次の例のように、commitWSMSessionコマンドを使用してセッションをコミットします。

wls:/wls_domain/serverConfig> commitWSMSession()

The policy set for subject "/weblogic/base_domain/jaxwsejb30ws|#jaxwsejb|WS-Service({http://ejb.oracle.com/targetNamespace}EchoEJBService#EchoEJBServicePort)" was saved successfully.

ロギング・レベル・ポリシーを無効にするには、次の手順のうちの1つを実行します。

- ポリシーをデタッチします。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のWLSTを使用したポリシーの直接的な添付のデタッチに関する項を参照してください。

- ポリシーを無効化します。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のWLSTを使用したポリシーの直接的な添付の有効化および無効化に関する項を参照してください。

- attachWSMPolicyコマンドを使用してポリシーoracle/no_ws_logging_level_policyを添付して、広範囲で構成されたログ・レベル・ポリシーを無効にします。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のOracle Web Services Managerを使用したポリシーの直接的な添付に関する項を参照してください。
次に例を示します。

wls:/wls_domain/serverConfig> attachWSMPolicy("oracle/no_ws_logging_level_policy")

Policy reference "oracle/no_ws_logging_level_policy" added.

WLSTコマンドに関する情報は、『インフラストラクチャ・コンポーネントのためのWLSTコマンド・リファレンス』のWebサービス・カスタムWLSTコマンドに関する項を参照してください。

4.2.5.15 WLSTを使用したWebサービスのテスト・クライアントの有効化または無効化の概要

「Webサービスのテスト・クライアントの使用」の説明に従って、ドメインまたはWebサービスのエンドポイント・レベルでWebサービスのテスト・クライアントを有効化または無効化できます。

- "WLSTを使用したドメイン・レベルのWebサービスのテスト・クライアントの有効化または無効化"

- "WLSTを使用したWebサービスのエンドポイント・レベルのWebサービスのテスト・クライアントの有効化または無効化"

注意:

この項で説明している手順が、Fusion Middleware Controlの「Webサービスのテスト」ページにアクセスできるようにする「Webサービス・エンドポイント」ページ上の「Webサービスのテスト」リンクの可用性に影響を与えることはありません。詳細は、Fusion Middleware Controlの「Webサービスのテスト」ページを参照してください。

4.2.5.15.1 WLSTを使用したドメイン・レベルのWebサービスのテスト・クライアントの有効化または無効化

Webサービスのテスト・クライアントを有効化または無効化するには、ドメインのWebServiceTestEnableプロパティをtrueに設定するとテスト・クライアントが有効になり、falseに設定すると無効になります。

WLSTを使用したドメイン・レベルのWebサービスのテスト・クライアントの有効方法を例として示します。

wls:/wls-domain/serverConfig> edit()
Location changed to edit tree. This is a writable tree with
DomainMBean as the root. To make changes you will need to start
an edit session via StartEdit().

For more help, use help('edit')

wls:/mydomain/edit> startEdit()
Starting an edit session ...
Started edit session, please be sure to save and activate
your changes once you are done.
wls:/mydomain/edit> cd('WebserviceTestpage')
wls:/mydomain/edit/WebserviceTestpage !> cd('new_domain')
wls:/mydomain/edit/WebserviceTestpage/new_domain !> set('Enabled','true')
wls:/mydomain/edit/WebserviceTestpage/new_domain !> save()
Saving all your changes ...
Saved all your changes successfully.
wls:/mydomain/edit/WebserviceTestpage/new_domain !> activate()
Activating all your changes, this may take awhile ...
The edit lock associated with the edit session is released
once the activation is complete.
Activation completed
wls:/mydomain/edit/WebserviceTestpage/new_domain !>

WLSTコマンドに関する情報は、『インフラストラクチャ・コンポーネントのためのWLSTコマンド・リファレンス』のWebサービス・カスタムWLSTコマンドに関する項を参照してください。

4.2.5.15.2 WLSTを使用したWebサービスのエンドポイント・レベルのWebサービスのテスト・クライアントの有効化または無効化

WLSTを使用してWebサービスのエンドポイント・レベルでWebサービスのテスト・クライアントを有効にする手順は次のとおりです。

1. attachWSMPolicyコマンドを使用して、Webサービスにoracle/test_page_processing_service_policyを添付します。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のOracle Web Services Managerを使用したポリシーの直接的な添付に関する項を参照してください。

次に例を示します。

wls:/wls_domain/serverConfig> attachWSMPolicy("oracle/test_page_processing_service_policy")

Policy reference "oracle/test_page_processing_service_policy" added.

2. setWSMPolicyOverrideコマンドを使用して、ポリシーを構成します。オーバーライドできる構成プロパティについては、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』の「oracle/test_page_processing_service_policyを参照してください。

wls:/wls_domain/serverConfig> setWSMPolicyOverride('oracle/test_page_processing_service_policy','reference.priority,'10')

The configuration override property "reference.priority" having value "10" has been added to the reference to policy with URI "oracle/test_page_processing_service_policy".

reference.priority構成プロパティのオーバーライドに関する情報は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のポリシー添付のプロパティの指定に関する項を参照してください。

3. 次の例のように、commitWSMSessionコマンドを使用してセッションをコミットします。

wls:/wls_domain/serverConfig> commitWSMSession()

The policy set for subject "/weblogic/base_domain/jaxwsejb30ws|#jaxwsejb|WS-Service({http://ejb.oracle.com/targetNamespace}EchoEJBService#EchoEJBServicePort)" was saved successfully.

Webサービスのテスト・クライアント・ポリシーを無効にするには、次のいずれかの手順を実行します。

- ポリシーをデタッチします。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のWLSTを使用したポリシーの直接的な添付のデタッチに関する項を参照してください。

- ポリシーを無効化します。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のWLSTを使用したポリシーの直接的な添付の有効化および無効化に関する項を参照してください。

- attachWSMPolicyコマンドを使用してポリシーoracle/no_ws_logging_level_policyを添付して、広範囲で構成されたWebサービスのテスト・クライアントの・ポリシーを無効にします。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のOracle Web Services Managerを使用したポリシーの直接的な添付に関する項を参照してください。
次に例を示します。

wls:/wls_domain/serverConfig> attachWSMPolicy("oracle/no_test_page_processing_service_policy")

Policy reference "oracle/no_test_page_processing_service_policy" added.

WLSTコマンドに関する情報は、『インフラストラクチャ・コンポーネントのためのWLSTコマンド・リファレンス』のWebサービス・カスタムWLSTコマンドに関する項を参照してください。

4.2.5.16 WLSTを使用したメタデータの交換の有効化または無効化

WLSTを使用してWebサービスのメタデータの交換を有効にする手順は次のとおりです。

1. attachWSMPolicyコマンドを使用して、Webサービスにoracle/mex_request_processing_service_policyを添付します。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のOracle Web Services Managerを使用したポリシーの直接的な添付に関する項を参照してください。

次に例を示します。

wls:/wls_domain/serverConfig> attachWSMPolicy("oracle/mex_request_processing_service_policy")

Policy reference "oracle/mex_request_processing_service_policy" added.

2. setWSMPolicyOverrideコマンドを使用して、ポリシーを構成します。オーバーライドできる構成プロパティについては、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』の「oracle/mex_request_processing_service_policyを参照してください。

wls:/wls_domain/serverConfig> setWSMPolicyOverride('oracle/mex_request_processing_service_policy','reference.priority,'10')

The configuration override property "reference.priority" having value "10" has been added to the reference to policy with URI "oracle/mex_request_processing_service_policy".

reference.priority構成プロパティのオーバーライドに関する情報は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のポリシー添付のプロパティの指定に関する項を参照してください。

3. 次の例のように、commitWSMSessionコマンドを使用してセッションをコミットします。

wls:/wls_domain/serverConfig> commitWSMSession()

The policy set for subject "/weblogic/base_domain/jaxwsejb30ws|#jaxwsejb|WS-Service({http://ejb.oracle.com/targetNamespace}EchoEJBService#EchoEJBServicePort)" was saved successfully.

メタデータ変更ポリシーを無効にするには、次の手順のうちの1つを実行します。

- ポリシーをデタッチします。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のWLSTを使用したポリシーの直接的な添付のデタッチに関する項を参照してください。

- ポリシーを無効化します。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のWLSTを使用したポリシーの直接的な添付の有効化および無効化に関する項を参照してください。

- attachWSMPolicyコマンドを使用してポリシーoracle/no_mex_request_processing_service_policyを添付して、広範囲で構成されたメタデータ交換ポリシーを無効にします。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のOracle Web Services Managerを使用したポリシーの直接的な添付に関する項を参照してください。
次に例を示します。

wls:/wls_domain/serverConfig> attachWSMPolicy("oracle/no_mex_request_processing_service_policy")

Policy reference "oracle/no_mex_request_processing_service_policy" added.

WLSTコマンドに関する情報は、『インフラストラクチャ・コンポーネントのためのWLSTコマンド・リファレンス』のWebサービス・カスタムWLSTコマンドに関する項を参照してください。

4.2.5.17 WLSTを使用したMTOMエンコード化SOAPフォルト・メッセージの有効化または無効化

WLSTを使用してMTOMが有効となる場合、MTOMエンコード化SOAPフォルト・メッセージの作成を有効とする方法:

1. attachWSMPolicyコマンドを使用して、Webサービスにoracle/mtom_encode_fault_service_policyを添付します。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のOracle Web Services Managerを使用したポリシーの直接的な添付に関する項を参照してください。

次に例を示します。

wls:/wls_domain/serverConfig> attachWSMPolicy("oracle/mtom_encode_fault_service_policy")

Policy reference "oracle/mtom_encode_fault_service_policy" added.

2. setWSMPolicyOverrideコマンドを使用して、ポリシーを構成します。オーバーライドできる構成プロパティについては、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』の「oracle/mtom_encode_fault_service_policyを参照してください。

wls:/wls_domain/serverConfig> setWSMPolicyOverride('oracle/mtom_encode_fault_service_policy','reference.priority,'10')

The configuration override property "reference.priority" having value "10" has been added to the reference to policy with URI "oracle/mtom_encode_fault_service_policy".

reference.priority構成プロパティのオーバーライドに関する情報は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のポリシー添付のプロパティの指定に関する項を参照してください。

3. 次の例のように、commitWSMSessionコマンドを使用してセッションをコミットします。

wls:/wls_domain/serverConfig> commitWSMSession()

The policy set for subject "/weblogic/base_domain/jaxwsejb30ws|#jaxwsejb|WS-Service({http://ejb.oracle.com/targetNamespace}EchoEJBService#EchoEJBServicePort)" was saved successfully.

MTOMエンコード化フォルト・メッセージ・ポリシーを無効にするには、次の手順のうちの1つを実行します。

- ポリシーをデタッチします。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のWLSTを使用したポリシーの直接的な添付のデタッチに関する項を参照してください。

- ポリシーを無効化します。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のWLSTを使用したポリシーの直接的な添付の有効化および無効化に関する項を参照してください。

- attachWSMPolicyコマンドを使用してポリシーoracle/no_mtom_encode_fault_service_policyを添付して、広範囲で構成されたMTOMエンコード化フォルト・メッセージ・ポリシーを無効にします。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のOracle Web Services Managerを使用したポリシーの直接的な添付に関する項を参照してください。
次に例を示します。

wls:/wls_domain/serverConfig> attachWSMPolicy("oracle/no_mtom_encode_fault_service_policy")

Policy reference "oracle/no_mtom_encode)fault_service_policy" added.

WLSTコマンドに関する情報は、『インフラストラクチャ・コンポーネントのためのWLSTコマンド・リファレンス』のWebサービス・カスタムWLSTコマンドに関する項を参照してください。

4.2.5.18 WLSTを使用したリクエスト・メッセージの検証

WLSTを使用したリクエスト・メッセージの検証の有効化方法:

1. attachWSMPolicyコマンドを使用して、Webサービスにoracle/schema_validation_policyを添付します。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のOracle Web Services Managerを使用したポリシーの直接的な添付に関する項を参照してください。

次に例を示します。

wls:/wls_domain/serverConfig> attachWSMPolicy("oracle/schema_validation_policy")

Policy reference "oracle/schema_validation_policy" added.

2. setWSMPolicyOverrideコマンドを使用して、ポリシーを構成します。オーバーライドできる構成プロパティについては、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』の「oracle/schema_validation_policyを参照してください。

wls:/wls_domain/serverConfig> setWSMPolicyOverride('oracle/schema_validation_policy','reference.priority', '10')

The configuration override property "reference.priority" having value "10" has been added to the reference to policy with URI "oracle/schema_validation_policy".

reference.priority構成プロパティのオーバーライドに関する情報は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のポリシー添付のプロパティの指定に関する項を参照してください。

3. 次の例のように、commitWSMSessionコマンドを使用してセッションをコミットします。

wls:/wls_domain/serverConfig> commitWSMSession()

The policy set for subject "/weblogic/base_domain/jaxwsejb30ws|#jaxwsejb|WS-Service({http://ejb.oracle.com/targetNamespace}EchoEJBService#EchoEJBServicePort)" was saved successfully.

スキーマ検証ポリシーを無効にするには、次の手順のうちの1つを実行します。

- ポリシーをデタッチします。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のWLSTを使用したポリシーの直接的な添付のデタッチに関する項を参照してください。

- ポリシーを無効化します。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のWLSTを使用したポリシーの直接的な添付の有効化および無効化に関する項を参照してください。

- attachWSMPolicyコマンドを使用してポリシーoracle/no_schema_validation_policyを添付して、広範囲で構成されたスキーマ検証ポリシーを無効にします。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のOracle Web Services Managerを使用したポリシーの直接的な添付に関する項を参照してください。
次に例を示します。

wls:/wls_domain/serverConfig> attachWSMPolicy("oracle/no_schema_validation_policy")

Policy reference "oracle/no_schema_validation_policy" added.

WLSTコマンドに関する情報は、『インフラストラクチャ・コンポーネントのためのWLSTコマンド・リファレンス』のWebサービス・カスタムWLSTコマンドに関する項を参照してください。

4.2.5.19 WLSTを使用したリクエスト・メッセージの最大サイズの設定

WLSTを使用したリクエスト・メッセージの最大サイズの設定方法:

1. attachWSMPolicyコマンドを使用して、Webサービスにoracle/max_request_size_policyを添付します。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のOracle Web Services Managerを使用したポリシーの直接的な添付に関する項を参照してください。

次に例を示します。

wls:/wls_domain/serverConfig> attachWSMPolicy("oracle/max_request_size_policy")

Policy reference "oracle/max_request_size_policy" added.

2. setWSMPolicyOverrideコマンドを使用して、ポリシーを構成します。オーバーライドできる構成プロパティについては、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』の「oracle/max_request_size_policyを参照してください。

wls:/wls_domain/serverConfig> setWSMPolicyOverride('oracle/max_request_size_policy','max.request.size', '-1')

The configuration override property "max.request.size" having value "-1" has been added to the reference to policy with URI "oracle/max_request_size_policy".

3. 次の例のように、commitWSMSessionコマンドを使用してセッションをコミットします。

wls:/wls_domain/serverConfig> commitWSMSession()

The policy set for subject "/weblogic/base_domain/jaxwsejb30ws|#jaxwsejb|WS-Service({http://ejb.oracle.com/targetNamespace}EchoEJBService#EchoEJBServicePort)" was saved successfully.

最大リクエスト・サイズ・ポリシーを無効にするには、次の手順のうちの1つを実行します。

- ポリシーをデタッチします。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のWLSTを使用したポリシーの直接的な添付のデタッチに関する項を参照してください。

- ポリシーを無効化します。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のWLSTを使用したポリシーの直接的な添付の有効化および無効化に関する項を参照してください。

- attachWSMPolicyコマンドを使用してポリシーoracle/no_max_request_size_policyを添付して、広範囲で構成された最大リクエスト・サイズ・ポリシーを無効にします。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のOracle Web Services Managerを使用したポリシーの直接的な添付に関する項を参照してください。
次に例を示します。

wls:/wls_domain/serverConfig> attachWSMPolicy("oracle/no_max_request_size_policy")

Policy reference "oracle/no_max_request_size_policy" added.

WLSTコマンドに関する情報は、『インフラストラクチャ・コンポーネントのためのWLSTコマンド・リファレンス』のWebサービス・カスタムWLSTコマンドに関する項を参照してください。

4.2.5.20 コンテンツのバイナリ・キャッシングの構成

WLSTを使用したコンテンツのバイナリ・キャッシングの有効化および構成方法:

1. attachWSMPolicyコマンドを使用して、Webサービスにoracle/cache_binary_content_policyを添付します。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のOracle Web Services Managerを使用したポリシーの直接的な添付に関する項を参照してください。

次に例を示します。

wls:/wls_domain/serverConfig> attachWSMPolicy("oracle/cache_binary_content_policy")

Policy reference "oracle/cache_binary_content_policy" added.

2. setWSMPolicyOverrideコマンドを使用して、ポリシーを構成します。オーバーライドできる構成プロパティについては、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』の「oracle/cache_binary_content_policy」を参照してください。

wls:/wls_domain/serverConfig> setWSMPolicyOverride('oracle/cache_binary_content_policy','mode', 'com.oracle.webservices.api.CacheBinaryContentMode.BINARY')

The configuration override property "mode" having value "com.oracle.webservices.api.CacheBinaryContentMode.BINARY" has been added to the reference to policy with URI "oracle/cache_binary_content_policy".

3. 次の例のように、commitWSMSessionコマンドを使用してセッションをコミットします。

wls:/wls_domain/serverConfig> commitWSMSession()

The policy set for subject "/weblogic/base_domain/jaxwsejb30ws|#jaxwsejb|WS-Service({http://ejb.oracle.com/targetNamespace}EchoEJBService#EchoEJBServicePort)" was saved successfully.

バイナリ・コンテンツ・キャッシング・ポリシーを無効にするには、次の手順のうちの1つを実行します。

- ポリシーをデタッチします。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のWLSTを使用したポリシーの直接的な添付のデタッチに関する項を参照してください。

- ポリシーを無効化します。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のWLSTを使用したポリシーの直接的な添付の有効化および無効化に関する項を参照してください。

- attachWSMPolicyコマンドを使用してポリシーoracle/no_cache_binary_content_policyを添付して、広範囲で構成されたバイナリ・コンテンツ・キャッシング・ポリシーを無効にします。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のOracle Web Services Managerを使用したポリシーの直接的な添付に関する項を参照してください。
次に例を示します。

wls:/wls_domain/serverConfig> attachWSMPolicy("oracle/no_cache_binary_content_policy")

Policy reference "oracle/no_cache_binary_content_policy" added.

WLSTコマンドに関する情報は、『インフラストラクチャ・コンポーネントのためのWLSTコマンド・リファレンス』のWebサービス・カスタムWLSTコマンドに関する項を参照してください。

4.2.6 WLSTを使用したWebサービス・クライアントの構成

WLSTを使用してWebサービス・クライアントのエンドポイント(ポート)を構成するには、次の手順に従ってください。

1. 「WebサービスのカスタムWLSTコマンドへのアクセス」の説明に従って、アプリケーションがデプロイされるWebLogic Serverの実行中のインスタンスに接続します。

2. 「WLSTを使用したWebサービス・クライアントの表示」の説明に従って、WLSTコマンドlistWebServiceClientsを使用して、アプリケーションのWebサービス・クライアントのリストを表示します。

3. listWebServiceClientPortsコマンドを使用して、Webサービス・クライアントのエンドポイント名とエンドポイントURLを表示します。

listWebServiceClientPorts(application,moduleOrCompName,moduleType,serviceRefName)

たとえば、サービス参照clientのエンドポイントを表示するには、次のようにします。

wls:/wls-domain/serverConfig> listWebServiceClientPorts('/base_domain/AdminServer/application1#V2.0', 'test1', 'wsconn', 'client')

HelloWorld_pt serviceWSDLURI=http://namespace/soa-infra/services/default/HelloWorld/client?wsdl

4. listWebServiceClientStubPropertiesコマンドを使用して、Webサービス・クライアント・エンドポイントの構成の詳細を表示します。

listWebServiceClientStubProperties(application, moduleOrCompName, moduleType, serviceRefName,portInfoName)

たとえば、HelloWorld_ptの構成の詳細を表示するには、次のようにします。

wls:/wls-domain/serverConfig> listWebServiceClientStubProperties('/base_domain/AdminServer/application1#V2.0', 'test1','wsconn','client','HelloWorld_pt')

keystore.recipient.alias=A1
saml.issuer.name=B1
user.roles.include=C1

別の方法として、「WLSTを使用したWebサービス・クライアントの表示」に示すように、listWebServiceClientsコマンドでdetail引数にtrueを設定して、エンドポイントの構成の詳細を表示することもできます。

5. 次のいずれかを行います:

- setWebServiceClientStubPropertyコマンドを使用して、Webサービスのクライアント・エンドポイントの単一スタブ・プロパティを設定または変更します。propName引数およびpropValue引数を使用して、設定または変更するプロパティを指定します。プロパティを削除するには、propValue引数に空白を指定します。

setWebServiceClientStubProperty(application,moduleOrCompName,moduleType,
serviceRefName,portInfoName,propName,[propValue])

たとえば、HelloWorld_ptに対してkeystore.recipient.aliasをoracleに変更するには、次のコマンドを使用します。

wls:/wls-domain/serverConfig> setWebServiceClientStubProperty('/base_domain/AdminServer/application1#V2.0',  'test1', 'wsconn', 'client', 'HelloWorld_pt', 'keystore.recipient.alias', 'oracle')

- setWebServiceClientStubPropertiesコマンドを使用して、Webサービスのクライアント・エンドポイントのプロパティのセットを構成します。properties引数を使用して、設定または変更するプロパティを指定します。

setWebServiceClientStubProperties(application, moduleOrCompName,
moduleType, serviceRefName, portInfoName, properties)

このコマンドは、クライアントにアタッチされたOWSMクライアント・セキュリティ・ポリシーのすべてのスタブ・プロパティを構成またはリセットします。このコマンドで一覧表示する各プロパティが、指定した値に設定されます。前に設定したプロパティが、このコマンドに明示的に指定されていない場合、それはそのプロパティのデフォルトにリセットされます。デフォルトが存在しない場合、そのプロパティは削除されます。

たとえば、SOAコンポジット・アプリケーションdefault/SimpleRef[1.0]のSOA参照エンドポイントTaskReference_ptに対して原子性トランザクションを構成するには、次のコマンドを使用します。

wls:soainfra/serverConfig>
setWebServiceClientStubProperties('soa-infra' ,'default/SimpleRef[1.0]', 'soa' ,'client', 'TaskReference_pt', [("wsat.flowOption","SUPPORTS"), ("wsat.Version","DEFAULT")])

参照が正しく構成されていることを検証するには、次のコマンドを入力します。

wls:soainfra/serverConfig>listWebServiceClients(None, None, true)

/soainfra/soa_server1/soa-infra:
compositeName=default/SimpleRef[1.0], moduleType=soa, serviceRefName=client
TaskReference_pt
wsat.version=DEFAULT
wsat.flowOption=SUPPORTS

設定できるクライアント・プロパティの詳細は、表4-3を参照してください。これらのプロパティを指定するには、「プロパティ名」の列に示す形式を使用します。

また、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のポリシー構成オーバーライドの概要に関する項で説明されているプロパティも設定できます。

これらのWLSTコマンドおよび議論に関する情報は、『インフラストラクチャ・コンポーネントのためのWLSTコマンド・リファレンス』のWebサービス・カスタムWLSTコマンドに関する項を参照してください。

5 Webサービスのテスト

この章では、Webサービスの基本機能および拡張機能をテストする方法について説明します。テスト可能な機能には、セキュリティ、サービス品質(QoS)、HTTPヘッダー・オプションなどが含まれます。セキュリティ機能のストレス・テストを実行することもできます。

この章の内容は次のとおりです。

- Webサービス・テストの概要

- Webサービスのテスト・クライアントの使用

- Fusion Middleware Controlの「Webサービスのテスト」ページ

5.1 Webサービス・テストの概要

WebサービスをWebLogic Serverにデプロイした後、次のツールのうちの1つを使用して、Webサービスをテスト可能です。

- 5-1ページの「Webサービスのテスト・クライアントの使用」に記載されている、Webサービスのテスト・クライアント。

- 5-14ページの「Fusion Middleware ControlのテストWebサービス・ページの使用」に記載されている、Fusion Middleware ControlのテストWebサービス・ページ。

5.2 Webサービスのテスト・クライアントの使用

Webサービスのテスト・クライアントを使用すると、次のことが可能です。

- 基本的な機能性のテストにより、Webサービスがデプロイされ、期待どおりに作動していることを確認。

- 基本的な認証のセキュリティのテスト。

- Webサービス・アドレス、原子性トランザクション、SOAPメッセージ転送最適化メカニズム(MTOM)、Fast Infoset、Oracle Web Service Manager (OWSM)のセキュリティ・ポリシーなどの拡張機能のテスト。

注意:

接続プロトコルとしてSOAP over Java Messaging Service (JMS)トランスポートを使用するWebサービスでは、基本機能のみをテストできます。

- 適用可能な場合、WebサービスのWSDLおよびインポートされたスキーマの表示。

- テスト・ケースのエクスポートおよびインポート。

- セキュリティ・テストに使用するためのJava keystores (JKS)の構成。

- 環境に要求されるHTTPプロキシ設定の構成および使用。

次の項では、Webサービスのテスト・クライアントを使用する方法について説明します。

- Webサービスのテスト・クライアントの起動

- テストするWebサービスの選択

- Webサービス・オペレーションのテスト

- 基本的なテスト設定の構成

- Webサービスの高度な機能およびセキュリティのテスト

- WSDLおよびインポートされたスキーマの表示

- Webサービスのテスト・クライアントの構成

- 入力引数のXMLソースとしての編集

- 履歴の表示

- テスト・ケースのエクスポートおよびインポート

- Webサービスのテスト・クライアントの有効化および無効化

- Webサービスのテスト・クライアントのログアウト

5.2.1 Webサービスのテスト・クライアントの起動

次の項で説明されているように、Webサービス・エンドポイントまたは管理コンソールを使用して、ブラウザからWebサービスのテスト・クライアントを起動します。

- 5-2ページの「ブラウザからのWebサービスのテスト・クライアントの起動」

- 5-3ページの「Webサービス・エンドポイントを使用したWebサービスのテスト・クライアントの起動」

- 5-3ページの「管理コンソールを使用したWebサービスのテスト・クライアントの起動」

注意:

初めてWebサービスのテスト・クライアントを起動する場合、アプリケーションのデプロイの間にわずかなディレイが生じます。

接続プロトコルとしてSOAP over JMSトランスポートを使用するWebサービスをテストする場合は、Webサービスがデプロイされているサーバーからテスト・ページを起動する必要があります。

5.2.1.1 ブラウザからのWebサービスのテスト・クライアントの起動

次のURLを入力すると、ブラウザからWebサービスのテスト・クライアントが起動します。

http://host:port/ws_utc

説明:

- host - WebLogic Serverが動作しているコンピュータの名前。

- port - WebLogic Serverがリスニングしているポート番号(デフォルト値は7001です)。

プロンプトが表示されたら、Webサービスのテスト・クライアントのログイン資格証明を入力します。

Webサービスのテスト・クライアントのホーム・ページが起動します。WebサービスのWSDLを選択するには、5-3ページの「テストするWebサービスの選択」を参照してください。

5.2.1.2 Webサービス・エンドポイントを使用したWebサービスのテスト・クライアントの起動

Webサービス・エンドポイントへ移動して、Webサービスのテスト・クライアントを起動します。

- Oracle Infrastructure Webサービスの場合、Webサービス・エンドポイントへ移動すると、Webサービスのテスト・クライアントが選択したWebサービスのWSDLとともに起動します。

- JAX-WSおよびJAX-RPCのWebサービスの場合、中間ページが起動します。「テスト」をクリックすると、選択したWebサービスのWSDLとともにWebサービスのテスト・クライアントが起動します。

プロンプトが表示されたら、Webサービスのテスト・クライアントのログイン資格証明を入力します。

Webサービス操作をテストするには、5-4ページの「Webサービス操作のテスト」を参照してください。

5.2.1.3 管理コンソールを使用したWebサービスのテスト・クライアントの起動

管理コンソールを使用してデプロイされたWebサービスをテストするには、次の手順を実行します。

1. 次のURLを使用して、ブラウザで管理コンソールを呼び出します。

http://[host]:[port]/console

説明:

- host - WebLogic Serverが動作しているコンピュータの名前。

- port - WebLogic Serverがリスニングしているポート番号(デフォルト値は7001です)。

2. 「デプロイメント」表でテストするWebサービスを選択します。詳細は、『Oracle WebLogic Server WebLogic Webサービスの理解』の「Webサービスが管理コンソール上でどのように表示されるか」を参照してください。

3. 「テスト」タブを選択し、テストするWebサービス・エンドポイントの隣の「テスト・ポイント」リンクをクリックします。

4. プロンプトが表示されたら、Webサービスのテスト・クライアントのログイン資格証明を入力します。

5. Oracle WebLogic管理コンソール・オンライン・ヘルプのWebサービスのテストに関する項に示される手順に従います。

選択したWebサービスのWSDLとともにWebサービスのテスト・クライアントが起動します。Webサービス操作をテストするには、5-4ページの「Webサービス操作のテスト」を参照してください。

5.2.2 テストするWebサービスの選択

Webサービスのテスト・クライアントのホーム・ページから、テストするWebサービスに対応したWSDLを入力します。「別のWSDLを選択」を選択すると、いつでもこのページに戻ります。

テストするWebサービスを選択する手順は次のとおりです。

1. 「WSDL URLの入力」フィールドで、WSDLを入力します。

2. 構成されたHTTPプロキシを使用するには、「HTTPプロキシ」チェック・ボックスをクリックします。

プロキシの構成の詳細は、5-11ページの「HTTPプロキシの構成」を参照してください。

3. 「テスト」をクリックします。

または、WSDLリストからロード済のWSDLを選択できます。「WSDLリストの表示」または「WSDLリストの非表示」をクリックして、リストを切り替えます。

テスト可能なWebサービス操作が表示されます。詳細は、5-4ページの「Webサービスの操作のテスト」を参照してください。

5.2.3 Webサービス・オペレーションのテスト

Webサービス操作をテストする手順は次のとおりです。

1. 次のいずれかの方法で、テストするWebサービス操作を選択します。

- 操作ペインで、操作を選択します。

- 「操作」ペインでWebサービス・ポート・フォルダを選択し、テストするWebサービス操作に関連する「テスト」をクリックします。

2. 「パラメータ」セクションに各パラメータの値を入力します。

必要なパラメータは、を使用して特定されます。

XMLソースの編集に関する詳細は、5-12ページの「入力引数のXMLソースとしての編集」を参照してください。

3. エンドポイントURL、基本認証設定、エンコーディングとバインディング・タイプ、および使用する場合は構成したHTTPプロキシなどのテスト・クライアントの基本設定を構成します。詳細は、5-4ページの「基本的なテスト設定の構成」を参照してください。

4. 5-5ページのWebサービスの高度な機能およびセキュリティのテストで説明するとおり、設定(使用可能な場合)を構成して、Webサービスの高度な機能をテストします。

拡張機能の設定が、テストするWebサービス・エンドポイントと互換性を持つことを確認します。互換性がない場合、テストは失敗し、「テスト結果」セクションにスタック・エラーが表示されます。

注意:

接続プロトコルとしてSOAP over JMSトランスポートを使用するWebサービスでは、基本機能のみをテストできます。

5. 「起動」をクリックします

テスト結果セクションがコンテント・エリアの下部に表示され、SOAPリクエストおよびレスポンス・メッセージが表示されます。テストが失敗すると、「テスト結果」セクションにスタック・エラーが表示されます。

5.2.4 基本的なテスト設定の構成

基本認証のユーザー名とパスワードを含むWebサービスのテスト・クライアントの基本設定を構成するには、「設定」セクションの基本設定タブをクリックして、表5-1で定義された値を設定し、「起動」をクリックしてWebサービスを起動します。

表5-1 基本的なテスト・クライアント設定

設定

説明

エンドポイントURL

Webサービス・エンドポイント・アドレスをオーバーライドします。

ユーザー名

基本認証のテストに使用するユーザー名です。

注意: 5-11ページの「JKSキーストアの構成」の説明に従って、JKSキーストアを構成します。

パスワード

基本認証のテストに使用するパスワードです。

注意: 5-11ページの「JKSキーストアの構成」の説明に従って、JKSキーストアを構成します。

エンコーディング

エンコーディング規格です。有効な値にはUTF-8とUTF-16が含まれます。

BindingType

バインディング・タイプです。有効な値は次のとおりです。

- SOAPバインディング—標準SOAP Webサービス

- REST/HTTPバインディング—javax.xml.ws.Provider<T>インタフェースのinvoke()メソッドを使用したSOAP over HTTP

HTTPプロキシ

HTTPプロキシが有効かどうかを指定するフラグ。5-11ページの「HTTPプロキシの構成」の説明に従って、グローバルHTTPプロキシ設定を構成します。

注意: この設定は、開発モードでのみ使用できます。

5.2.5 Webサービスの高度な機能およびセキュリティのテスト

Webサービスの拡張機能をテストするには、次の各項を参照してください。

- アドレスのテスト

- 原子性トランザクションのテスト

- MTOMのテスト

- Fast Infosetのテスト

- OWSMセキュリティ・ポリシーのテスト

注意:

接続プロトコルとしてSOAP over JMSトランスポートを使用するWebサービスでは、基本機能のみをテストできます。

5.2.5.1 アドレスのテスト

WS-Addressingは、Webサービスおよびそれに関連するメッセージをアドレッシングするための、トランスポートに依存しないメカニズムを提供します。WS-Addressingを使用すると、エンドポイントはSOAPヘッダー内で一意かつ明確に定義されます。詳細は、『Oracle WebLogic Server JAX-WS Webサービスの開発』の「Webサービスのアドレシングの使用」を参照してください。

Webサービスで使用できる場合、WSアドレシングをテストするには、「設定」セクションの「アドレッシング」タブをクリックして、表5-2で定義された値を設定し、「起動」をクリックしてWebサービスを起動します。

表5-2 WSアドレシングのテスト設定

設定

説明

有効

WSアドレシングが、Webサービスのテスト・クライアントに対して有効かどうかを指定するフラグです。

バージョン

WSアドレシングのバージョンです。有効な値は次のとおりです。

- W3C。詳細は、http://www.w3.org/2002/ws/addr/を参照してください。

- Member Submission。詳細は、http://www.w3.org/Submission/ws-addressing/を参照してください。

ReplyTo

ReplyToヘッダーのタイプです。有効な値にはanonymous、non-anonymous、およびAddressing None.が含まれます。

FaultTo

FaultToヘッダーのタイプです。有効な値にはanonymous、non-anonymous、およびAddressing None.が含まれます。

5.2.5.2 原子性トランザクションのテスト

Webサービスは、次の仕様のサポートを通じて、Websphere、Microsoft .NETなどの他の外部トランザクション処理システムとの相互運用を可能にします。

- Webサービスの原子性トランザクション(WS-AtomicTransaction)バージョン1.0、1.1、および1.2: http://docs.oasis-open.org/ws-tx/wstx-wsat-1.2-spec-cs-01/wstx-wsat-1.2-spec-cs-01.html

- Webサービスのコーディネーション(WS-Coordination)バージョン1.0、1.1、および1.2: http://docs.oasis-open.org/ws-tx/wstx-wscoor-1.2-spec-cs-01/wstx-wscoor-1.2-spec-cs-01.html

Webサービスの原子性トランザクションの詳細は、『Oracle WebLogic Server JAX-WS Webサービスの開発』のWebサービスの原子性トランザクションの使用に関する項を参照してください。

Webサービスで使用できる場合、原子性トランザクションをテストするには、「設定」セクションの「アトミック・トランザクション」タブをクリックして、表5-4で定義された値を設定し、「呼出し」をクリックしてWebサービスを起動します。

表5-3 原子性トランザクションのテスト設定

設定

説明

有効

原子性トランザクションが、Webサービスのテスト・クライアントに対して有効かどうかを指定するフラグです。

バージョン

Webサービスのテスト・クライアントで使用されるWebサービス原子性トランザクションのコーディネーション・コンテキストのバージョンです。有効な値は、default、wsat、wsat11、およびwsat12です。Webサービス・クライアントのdefault値は、wsat(WS-AT 1.0と同等)です。

トランザクション・フロー・タイプ

Webサービス原子性トランザクションのコーディネーション・コンテキストがトランザクション・フローとともに渡されるかどうかを指定するフラグです。この値の設定に関する詳細は、『Oracle WebLogic Server JAX-WS Webサービスの開発』のWebサービスにおけるWebサービス原子性トランザクションの有効化を参照してください。

起動後のアクション

起動後に必要なアクションです。有効な値にはトランザクションのcommitまたはrollback.が含まれます。

5.2.5.3 MTOMのテスト

SOAP MTOM/XOP (Message Transmission Optimization Mechanism/XML-binary Optimized Packaging)では、SOAPメッセージ内のxs:base64Binary型またはxs:hexBinary型のXMLデータの転送を最適化する方法が定義されています。トランスポート・プロトコルがHTTPの場合、Multipurpose Internet Mail Extension (MIME)添付ファイルを使用して、送信側と受信側の両方に対して同時にSOAPメッセージ内のXMLデータへの直接アクセスを許可する間にデータを伝達します。このとき、base64BinaryまたはhexBinaryデータのマーシャリングにMIMEアーティファクトが使用されていたことを意識する必要はありません。

MTOMの詳細は、次を参照してください。

- JAX-WS: 『Oracle WebLogic Server JAX-WS Webサービスの開発』の「MTOM/XOPを使用したバイナリ・データ転送の最適化」を参照してください

- Oracle Infrastructure Webサービス: 『Oracle Infrastructure Webサービスの開発』のMTOMエンコード化メッセージ添付の使用に関する項。

Webサービスで使用できる場合、MTOMをテストするには、「設定」セクションの「MTOM」タブをクリックして、表5-5で定義された値を設定し、「呼出し」をクリックしてWebサービスを起動します。

表5-4 MTOMのテスト設定

設定

説明

有効

MTOMがWebサービスのテスト・クライアントで有効かどうかを指定するフラグ。

しきい値

xs:binary64データが、インラインで送信されるか、添付として送信されるかを指定する添付のしきい値(バイト)。この値のデフォルトは、0です(すべてのデータが添付として送信されます)。

5.2.5.4 Fast Infosetのテスト

Fast Infosetは、テキストベースのXML形式よりも効率的にシリアライズできる、圧縮バイナリ・エンコーディング形式です。Fast Infosetの詳細は、次を参照してください。

- JAX-WS: 『Oracle WebLogic Server JAX-WS Webサービスの開発』の「Fast Infosetを使用したXMLの最適化」を参照してください。

- Oracle Infrastructure Webサービス: 『Oracle Infrastructure Webサービスの開発』のFast Infosetを使用したXML転送の最適化に関する項。

Webサービスで使用できる場合、Fast Infosetをテストするには、「設定」セクションの「Fast Infoset」タブをクリックして、表5-6で定義された値を設定し、「起動」をクリックしてWebサービスを起動します。

表5-5 Fast Infosetのテスト設定

設定

説明

有効

原子性トランザクションが、Webサービスのテスト・クライアントに対して有効かどうかを指定するフラグです。

ネゴシエーション・タイプ

ネゴシエーション戦略です。有効な値は次のとおりです。

- none—ネゴシエーション戦略なし。

- optimistic—クライアントはFast Infosetが有効であると仮定します。

- pessimistic—最初のクライアント・リクエストであり、Fast Infosetは有効ではありません。サービスにおいて可能であれば、続くリクエストはFast Infosetを使用します。

コンテンツのネゴシエーション戦略の詳細は、次を参照してください。

- JAX-WS: 『Oracle WebLogic Server JAX-WS Webサービスの開発』の「コンテンツのネゴシエーション戦略の構成」を参照してください。

- Oracle Infrastructure Web Services: 『Oracle Infrastructure Webサービスの開発』のコンテンツ・ネゴシエーション戦略の構成に関する項。

5.2.5.5 OWSMセキュリティ・ポリシーのテスト

OWSMセキュリティ・ポリシーをテストするには、「設定」セクションの「OWSM」タブをクリックして、表5-8で定義された値を設定し、「起動」をクリックしてWebサービスを起動します。

注意:

Java EE Webサービスの場合、このタブはOWSMがインストールされている場合のみ使用できます。

使用できるのはOWSM事前定義済ポリシーの一部のみであり、これらのポリシー用に表示される属性のみが構成可能です。他のポリシー属性には、すべてポリシーのデフォルト値のみが使用されます。

したがって、事前定義済ポリシーから作成したコピーは使用できません。安全な会話の有効化やメッセージ・セキュリティ・アルゴリズム・スイートの変更などもできません。

表5-6 OWSMのテスト設定

設定

説明

有効

OWSMポリシーが、Webサービスのテスト・クライアントに対して有効かどうかを指定するフラグです。

ポリシー

関連するチェック・ボックス列を選択して、クライアントにおいてテストするポリシーを選択します。セキュリティ・ポリシーのサブセットのみテストできます。

注意: 選択したポリシーに対して、次の必要なプロパティを構成する必要があります。それ以外の場合は、例外がスローされます。

ユーザー名

基本認証に使用するユーザー名です。

パスワード

基本認証に使用するパスワードです。

キーストアの場所

キーストア・ファイルの場所。「ファイルの選択」をクリックして、ローカル・ディレクトリ内のファイルに移動します。ローカル・ディレクトリは通常、DOMAIN_HOME\domain_name\config\fmwconfigにあります。

リモート・キーストアの場所

リモート・キーストアの場所です。指定がない場合、サーバーに対してローカルなキーストアを使用します。

キーストア・パスワード

キーストア・アクセスに使用するパスワードです。

暗号化キーの別名

サービスからのレスポンスの復号化に使用されるキーストア内のキーの別名。このプロパティはWSS11ポリシーでは使用されません。

暗号化キーのパスワード

復号化に使用されるキーストア内のキーのパスワード。このプロパティはWSS11ポリシーでは使用されません。

署名鍵の別名

デジタル署名に使用されるキーストア内のキーの別名。WSS11ポリシーの場合、このプロパティは相互認証にのみ使用されます。

署名鍵のパスワード

デジタル署名に使用されるキーストア内のキーの別名のパスワード。

受信者キーの別名

アウトバウンド・メッセージ・タイプの暗号化に使用される受信者の公開鍵の別名です。

SAMLオーディエンスのURI

カンマ区切りのURIで表されたリライイング・パーティ。このプロパティではワイルドカードを使用できます。

SAML発行者名

SAMLメカニズムを使用して保護されているサービスにアクセスしようとする場合に使用するSAML発行者名。

ユーザー・ロールの組込み

SAMLアサーションのユーザー・ロール。

マッピング属性のアテスト

アテスト・エンティティの表現で使用されるマッピング属性。現在サポートされているのはDNのみです。この属性は、送信者保証メッセージ保護ユースケースにのみ適用されます。SAML over SSLポリシーには適用されません。

5.2.6 WSDLおよびインポートされたスキーマの表示

現在のWebサービスのWSDLを表示するには、「WSDL」をクリックします。

インポートされたWSDLおよびスキーマを表示するために、インポートされたWSDLおよびスキーマをクリックします。ダイアログ・ボックスで、表示するインポートされたファイルをクリックします。右上隅のxをクリックして、ダイアログ・ボックスを閉じます。

5.2.7 Webサービスのテスト・クライアントの構成

注意:

構成設定は、開発モードでのみ使用できます。

次の項で説明されているように、HTTPプロキシの定義、デフォルトの作業ディレクトリの設定、またはJavaキーストア(JKS)の定義によって、Webサービスのテスト・クライアントを構成します。

- HTTPプロキシの構成

- JKSキーストアの構成

- デフォルトの作業ディレクトリの構成

5.2.7.1 HTTPプロキシの構成

Webサービスのテスト・クライアントのHTTPプロキシを、一般設定ページで構成します。

HTTPプロキシの構成方法:

1. Webサービスのテスト・クライアントの右上隅のをクリックします。

2. ナビゲーション・ペインで、一般をクリックします。

3. Httpプロキシ・ホストにプロキシ・ホストを入力します。

4. Httpプロキシ・ポートにプロキシ・ポートを入力します。

5. 「送信」をクリックします

5.2.7.2 JKSキーストアの構成

Webサービスのテスト・クライアント・セキュリティ・ページでテストするOWSMセキュリティ・ポリシーに関連するJKSキーストアを構成します。

WebLogicサーバーにおけるJKSキーストアの定義の詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』の「WebLogicサーバーにおけるJKSキーストアの構成方法」を参照してください。

Javaキーストア(JKS)の構成方法:

1. Webサービスのテスト・クライアントの右上隅のをクリックします。

2. ナビゲーション・ペインで、セキュリティをクリックします。

3. 新規JKSキーストアの追加方法:

a. 「追加」をクリックします。

b. 設定名フィールドに、JKSキーストアの名前を入力します。

c. キーストア・パスワード・フィールドに、JKSキーストアのパスワードを入力します。

注意:

製品環境が推奨されていないJKSキーストアのパスワードを定義します。

d. キーストア・ファイルフィールドにファイルへのパスを入力するか、ファイルの選択をクリックして、ローカル・ディレクトリにファイルを移動します。

e. 「発行」をクリックします。

4. 既存のJKSキーストアの編集または削除方法:

a. 「編集」をクリックします。

b. をクリックして、JKSキーストアを削除します。

c. をクリックし、フィールドを編集し、編集の発行をクリックして、JKSキーストアを編集します。

d. 編集の取消をクリックして、編集モードを終了します。

5.2.7.3 デフォルトの作業ディレクトリの構成

Webサービスのテスト・クライアントのデフォルトの作業ディレクトリを構成できます。デフォルトでは、作業ディレクトリは、ドメイン・ディレクトリのサブディレクトリに従って設定されます。

<domain-directory>/tmp/WSTestPageWorkDir

デフォルトの作業ディレクトリの構成方法:

1. Webサービスのテスト・クライアントの右上隅のをクリックします。

2. ナビゲーション・ペインで、一般をクリックします。

3. 現在の作業ホームフィールドを編集して、望ましい作業ホーム・ディレクトリを示します。

4. 「送信」をクリックします

5.2.8 入力引数のXMLソースとしての編集

入力引数は、ユーザーにわかりやすい形式で表示できます。また、XMLソース・コードを直接編集できます。XMLソースを直接編集する場合は、有効なXMLを入力する必要があります。入力引数をXMLソースとして表示するために、未処理メッセージをクリックします。ユーザー・フレンドリなフォームに切り替えるために、フォーム入力をクリックします。

5.2.9 履歴の表示

注意:

イノベーション履歴ペインは、最初のテスト操作の起動後にのみ表示され、開発モードでのみ利用可能です。

イノベーション履歴ペインの操作のクリックによって、現在のセッションに、以前に実行したテストの結果を表示できます。テストの失敗例は、イノベーション履歴ペインに赤で表示されます。

5.2.10 テスト・ケースのエクスポートおよびインポート

注意:

この機能は開発モードでのみ使用できます。

次の各項の説明に従って、個別のテストケースをWebサービスのテスト・クライアントからエクスポートして、その後、他のテスト環境にインポートできます。

- テスト・ケースのエクスポート

- テスト・ケースのインポート

5.2.10.1 テスト・ケースのエクスポート

Webサービスのテスト・クライアントの右上隅のをクリックして、テスト・ケースをエクスポートします。テスト・ケースは、ws-testcase.xmlのファイル名で、XMLファイルとして保存されます。複数のテスト・ケースを保存する場合、ws-testcase(n).xmlのようにファイル名に拡張子が追加されます(nは、新しいテスト・ケースが保存されるたびに増えます)。

5.2.10.2 テスト・ケースのインポート

テスト・ケースのインポート方法:

1. Webサービスのテスト・クライアントの右上隅のをクリックします。

2. 「ファイルの選択」をクリックします

3. テスト・ケース・ファイルに移動して、開くをクリックします。

「インポート」をクリックします。

5.2.11 Webサービスのテスト・クライアントの有効化および無効化

開発環境では、デフォルトで、Webサービスのテスト・クライアントは有効です。本番環境では、デフォルトで、Webサービスのテスト・クライアントは無効(かつアンデプロイ済)です。

Webサービスのテスト・クライアント・ポリシーを有効または無効にするには、次の手順のうちの1つを実行します。

- 次で説明されているように、管理コンソールを使用します。

- 4-25ページの「WLSTを使用したWebサービスのテスト・クライアントの有効化または無効化」で説明されているように、Fusion Middleware ControlをドメインまたはWebサービス・エンドポイント・レベルで使用します。

- 4-58ページの「WLSTを使用したWebサービスのテスト・クライアントの有効化または無効化」で説明されているように、WLSTを使用します。

Webサービスのテスト・クライアントを無効にすると、Webサービスを公開するアプリケーションについて外部から参照できる詳細が少なくなり、セキュリティが向上します。

注意:

本番モードではWebサービスのテスト・クライアントを有効にしないことをお薦めします。本番モードの詳細は、in 『Oracle WebLogic Serverドメイン構成の理解』の「ドメイン・モード」を参照してください。

管理コンソールを使用したドメイン・レベルのWebサービスのテスト・クライアントの有効化または無効化方法:

1. 2-2ページの「Oracle WebLogic管理コンソールへのアクセス」の説明に従って、管理コンソールを起動します。

2. コンソール・ホーム・ページの「ドメイン構成」セクションの「ドメイン」をクリックします。

3. 「構成」→「全般」を選択して、ドメインの一般的な構成オプションを表示します。

4. 「詳細」をクリックし、構成の詳細設定を表示します。

5. Webサービスのテスト・ページの有効化構成フラグを切り替えると、Webサービスのテスト・クライアントを有効化または無効化できます。

6. 「保存」をクリックします。

7. サーバーを再起動して、構成設定を有効にします。

本番環境でWebサーバーのテスト・クライアントが有効になると、サーバーの再起動時にクライアントがデプロイされます。

5.2.12 Webサービスのテスト・クライアントのログアウト

Webサービスのテスト・クライアントの右上隅のをクリックすると、いつでもWebサービスのテスト・クライアントをログアウトできます。

5.3 Fusion Middleware Controlの「Webサービスのテスト」ページ

この項では、Fusion Middleware Controlの「Webサービスのテスト」ページを使用して、SOAP Webサービス(WSDL)またはRESTful (WADL)サービスから想定どおりの結果が得られるどうかを確認する方法について説明します。

Webサービスのテスト・ページを使用すると、次のことが可能です。

- 基本的な機能性のテストにより、Webサービスがデプロイされ、期待どおりに作動していることを確認。

- Webサービス・アドレス、信頼性のあるメッセージング、MTOMおよびHTTPヘッダーなどの拡張機能をテストします。

- 拡張機能をテストします。

- Webサービス・エンドポイントのストレス・テストを行います。

「Webサービスのテスト」ページを使用すると、WSDLまたはWADLドキュメントで公開されている任意の操作をテストできます。任意のアクセス可能なホストにデプロイされたWebサービスをテストできます。Webサービスをこのホストにデプロイする必要はありません。

注意:

「Webサービスのテスト」ページでは、ASCII文字のみを含むWSDLまたはWADL URLを解析できます。URLに非ASCII文字が含まれている場合、解析操作は失敗します。URLに非ASCII文字が含まれているWebサービスをテストするには、ブラウザでWSDLまたはWADL URLを変換できるようにし、エンコードされたWSDL URLを「Webサービスのテスト」ページで使用します。

ポリシーを使用するWebサービスをテストする場合、Fusion Middleware Controlを実行しているドメインと同じドメインにOWSMコンポーネントをインストールする必要があります。そうしないと、無効なポリシー例外が返されます。

詳細は、次の項を参照してください。

- テストのためのWebサービスへのアクセス

- SOAP Webサービスのテスト

- 非同期Webサービスのテスト

- RESTful Webサービスのテストの概要

- セキュリティのテスト

- サービスのクオリティ・テストの有効化

- HTTPヘッダーのテスト

- 入力引数のXMLソースとしての編集

- Webサービス操作のストレス・テスト

5.3.1 テストのためのWebサービスへのアクセス

様々な方法で「Webサービスのテスト」ページに移動できます。次の項では、2種類の事例について説明します。

Oracle WebLogic Serverドメインのホーム・ページからWebサービスにアクセスします。

1. ナビゲーション・ペインで「WebLogicドメイン」を開き、Webサービスをテストするドメインを表示します。

2. ドメインを選択します。

3. 「WebLogicドメイン」メニューから、「Webサービス」→「Webサービスのテスト」を選択します。「Webサービスのテスト」入力ページが表示されます。

4. テストするWebサービスのWSDLまたはWADL URLを入力します。WSDLまたはWADLがわからない場合、検索アイコンをクリックし、登録されているWebサービス(存在する場合)の中から選択します。

5. 「WSDLまたはWADLの解析」をクリックします。
WSDLまたはWADLがHTTP Basic認証で保護されている場合は、「WSDLまたはWADLアクセスのためのHTTP Basic認証オプション」をクリックし、WSDL解析の前にユーザー名とパスワードを入力します。

図5-1 (WSDL)および図5-8 (WADL)に示すような完全な「Webサービスのテスト」ページが表示されます。

Webサービス・アプリケーションのホーム・ページからWebサービスにアクセスします。

1. ナビゲーション・ペインで、「アプリケーションのデプロイ」を開き、ドメイン内のアプリケーションを表示します。

2. Webサービスをテストするアプリケーションを選択します。

3. ページの「Webサービス」セクションで、テストするWebサービス・エンドポイントの「テスト」をクリックします。

図5-1 (WSDL)および図5-8 (WADL)に示すような「Webサービスのテスト」ページが表示されます。WSDLまたはWADLフィールドには、エンドポイントのWSDLまたはWADLが自動的に移入されます。

5.3.2 SOAP Webサービスのテスト

「Webサービスのテスト」ページがSOAP WebサービスのWSDLの詳細によって更新されると、テストするサービス、ポートおよび操作タイプの選択とともに、様々な入力パラメータを指定できます。

1. 第5.3.1項 「テストのためのWebサービスへのアクセス」で説明されているメソッドを使用して、テストWebサービスのページへアクセスします。

2. 「WSDLまたはWADLの解析」をクリックします。

WSDLがHTTP Basic認証で保護されている場合は、「WSDLまたはWADLへのアクセスのためのHTTP Basic認証オプション」をクリックし、WSDL解析の前にユーザー名とパスワードを入力します。

図5-1 WSDL用のWebサービスのテスト・ページ(折りたたんだ表示)

3. テストするサービスとポートを選択します。図5-1に示されているように、WSDLに複数のサービスとポートがある場合は、これらのフィールドがドロップダウン・メニューとして表示されます。WSDLのサービスおよびポートが1種類だけの場合、これらのフィールドは読み取り専用です。

4. 「操作」メニューからテストする操作を選択します。使用可能なオプションはWSDLにより決定されます。

5. テストのエンド・ポイントURLを変更する場合は、「エンドポイントURL」をクリックしてURLを変更します。

6. 選択されていない場合は、「リクエスト」タブを選択します。

7. テスト・オプション・セクションを開きます。展開表示の「Webサービスのテスト」ページを図5-2に示します。

図5-2 WSDLの「Webサービスのテスト」ページの下部(展開表示)

8. 「セキュリティ」セクションで、WebサービスのテストにOWSMセキュリティ・ポリシー、HTTP Basic認証またはカスタム・ポリシーの認証を使用するか、あるいは資格証明を使用しないかを指定します。WSDLのポリシーではセキュリティ設定は決定されないため、テストするセキュリティのタイプを指定できます。デフォルトは「なし」です。選択したオプションに応じて、追加のフィールドが表示されます。使用可能なオプションの詳細は、第5.3.5項「セキュリティのテスト」を参照してください。

9. 「サービスのクオリティ」セクションで、信頼できるメッセージング(WS-RM)、WS-AddressingまたはMTOMポリシーを明示的にテストするかどうかを指定します。使用可能なオプションの詳細は、5-37ページの「サービスのクオリティ・テストの有効化」を参照してください。

10. 「HTTPヘッダー」セクションでは、Webサービスにリクエスト情報を渡すHTTPヘッダーを追加、変更または削除できます。詳細については、5-37ページの「HTTPヘッダーのテスト」を参照してください。

11. Webサービスを同時に複数回起動する場合は、「追加テスト・オプション」セクションでストレス・テストの有効化オプションを選択します。このオプションを設定すると、ストレス・テストのオプションに値を入力することも、デフォルトをそのまま使用することもできるようになります。詳細は、5-38ページの「Webサービス操作のストレス・テスト」を参照してください。

注意:

「非同期レスポンス・テスト」フィールドと「レスポンス・キー」フィールドは、非同期Webサービスのテスト専用です。詳細は、第5.3.3項「非同期Webサービスのテスト」を参照してください。

12. 「引数の入力」セクションで、Webサービスの入力引数を「値」フィールドに入力します。パラメータとタイプおよび要求される入力値は、WSDLにより決定されます。

「ツリー表示」または「XML表示」を選択して、入力パラメータの階層リストとXMLコンテンツの階層リストを切り替えます。

SOAP Webサービスでは、XMLとしてペイロードを保存し、以前に保存したペイロードをロードできます。「ペイロードの保存」をクリックして、ローカル・ファイル・システムのXMLファイルとして現在のペイロードを保存します。保存されたペイロードをロードするには、「参照」をクリックして1つを検索して選択するか、「更新」をクリックして現在ロードされているペイロードを置き換えます。(保存されたペイロードがロードされると、参照が更新で置き換えられます。)

13. 「Webサービスのテスト」をクリックしてテストを開始します。

テストを終了すると、「レスポンス」タブに結果が表示されます。

テストが成功すると、図5-3に示すように、「テストのステータス」フィールドに「リクエストは正常に受信されました。」と表示され、レスポンス時間が表示されます。

注意:

SOAコンポジット・テストを実行すると、新規コンポジットが生成されたかどうかが「レスポンス」タブに示されます。「フロー・トレースの起動」ボタンをクリックして、「フローのトレース」ウィンドウを開くこともできます。このウィンドウでは、様々なコンポジットおよびコンポーネント・インスタンスを介したメッセージのフローを表示できます。

図5-3 WSDLのテストの成功

テストが失敗すると、エラー・メッセージが表示されます。たとえば、図5-4には、var-Intパラメータのタイプ・エラーが原因のエラーが表示されています。この例の場合には、intが必要な状況でstringデータが入力されました。

注意:

「レスポンス」タブに表示される結果は、標準のWebサービス結果を簡略化したものです。

14. 図5-4 データ検証エラー

5.3.3 非同期Webサービスのテスト

「Webサービスのテスト」ページが非同期WebサービスのWSDLの詳細によって更新されると、SOAP Webサービスの「Webサービスのテスト」ページとほぼ同じになりますが、図5-5に示すように、次のテスト・レスポンス・オプションが「追加テスト・オプション」セクションに表示される点が異なります。

- 非同期レスポンス・テスト – テストの実行時に非同期レスポンスをリクエストするかどうかを指定します。

- 「レスポンス・キー」 – 非同期レスポンスと関連付ける値(例: myasynctest)を入力します。各レスポンス・キーは一意である必要があります。非同期レスポンスは、後で「非同期レスポンス・テスト」ページで、対応するレスポンス・キーを指定して追跡することもできます。

図5-5 テストWebサービス・ページの非同期テスト・オプション

テストが成功すると、「テストのステータス」フィールドに「リクエストは正常に受信されました。」と表示され、レスポンス時間が表示されます。非同期レスポンスに一致するユーザー定義のレスポンス・キー値も表示されます。

図5-6に示されているように、「レスポンスの表示」をクリックすると、レスポンスが存在する場合、「レスポンス」フィールドにXMLフォーマットでテスト・レスポンスが表示されます。

図5-6 非同期Webサービスのテストの成功およびレスポンス

注意:

非同期リクエストのレスポンスは、サーバーが再起動されていない場合のみ存在します。

レスポンスが利用できない場合、後で「非同期レスポンス・テスト」ページで、対応するレスポンス・キーを使用して追跡することもできます。

テスト後の非同期テスト・レスポンスへのアクセス

1. ナビゲーション・ペインで「WebLogicドメイン」を開き、非同期Webサービスのテスト・レスポンスにアクセスするドメインを表示します。

2. ドメインを選択します。

3. 「WebLogicドメイン」メニューから、「Webサービス」、「非同期テスト・レスポンス」を順に選択します。

4. 次のいずれかの方法で、「非同期レスポンス・テスト」ページで、対応するレスポンス・キーを指定できます。

- レスポンス・キー・リストを使用して、既存、ユーザー定義のレスポンス・キーを選択します。

- レスポンス・キーの検索フィールドを使用して、既存、ユーザー定義のレスポンス・キーを検索します。

5. 「レスポンスの表示」をクリックすると、レスポンスが存在する場合、「レスポンス」フィールドにXMLフォーマットでテスト・レスポンスが表示されます。

図5-7　テスト・レスポンスを示す「非同期レスポンス・テスト」ページ

注意:

非同期リクエストのレスポンスは、サーバーが再起動されていない場合のみ存在します。

6. ステップ4に戻り、レスポンス・キーを持つ他の非同期テスト・レスポンスへアクセスして表示する。

5.3.4 RESTful Webサービスのテストの概要

Web Application Description Language(WADL)は、RESTful Webサービス・アプリケーションを記述するXMLベースのファイル・フォーマットです。「Webサービスのテスト」ページがRESTful WebサービスのWADLの詳細によって更新されると、WSDLの「Webサービスのテスト」ページとほぼ同じになりますが、テストするリソース、メソッドおよびメディア・タイプを選択できる点が異なります。このリリースはWSDLページより制限があるため、様々なインプット・パラメータも設定できます。

- RESTful Webサービスのテスト

- WebRestApp1 Webサービス

- Mime_Multipart_rs Webサービス

5.3.4.1 RESTful Webサービスのテスト

RESTful Webサービスをテストするには、次のようにします。:

1. 第5.3.1項 「テストのためのWebサービスへのアクセス」で説明されているメソッドを使用して、テストWebサービスのページへアクセスします。

2. 「WSDLまたはWADLの解析」をクリックします。

WADLがHTTP Basic認証で保護されている場合は、「WSDLまたはWADLへのアクセスのためのHTTP Basic認証オプション」をクリックし、WADL解析の前にユーザー名とパスワードを入力します。

図5-8 WADL用のWebサービスのテスト・ページ

3. テストするリソースおよびメソッドのタイプを選択します。「メソッド」フィールドに、「リソース」フィールドで選択したリソース・パスに対応するHTTPメソッドが表示されます。

WADLに複数のリソース・メソッドがある場合は、図5-8に示されているように、これらのフィールドがドロップダウン・メニューとして表示されます。WADLのリソースおよびメソッドが1種類だけの場合、これらのフィールドは読み取り専用です。

注意:

GETおよびPOSTメソッドだけが、今回のリリースでサポートされています。(WADLに他のメソッドが存在する場合、それらのメソッドは無視されます。)

4. 「リクエストのための表現メディア・タイプ」メニューから、「テスト・リクエスト」に使用するMIMEメディア・タイプを選択します。利用可能なタイプを、存在する場合はWADLから決定します。

5. 「レスポンスのための表現メディア・タイプ」メニューから、「テスト・レスポンス」に使用するMIMEメディア・タイプを選択します。利用可能なタイプを、存在する場合はWADLから決定します。このリリースでサポートされているメディア・タイプは次のとおりです。

- application/xml

- application/json

- text/plain

- text/xml

- application/x-www-form-urlencoded

6. 選択されていない場合は、「リクエスト」タブを選択します。

7. 「セキュリティ」セクションにあるオプションは、「OWSMセキュリティ・ポリシー」、「HTTP Basic認証」および「なし」です。デフォルトは、Noneです。詳細については、5-31ページの「セキュリティのテスト」を参照してください。

8. 「HTTPヘッダー」セクションで、RESTful Webサービスにリクエスト情報を渡すHTTPヘッダーを追加、変更または削除できます。詳細については、5-37ページの「HTTPヘッダーのテスト」を参照してください。

9. 「引数の入力」セクションで、RESTful Webサービスの入力引数を「値」フィールドに入力します。パラメータとタイプおよび要求される入力値は、WADLにより決定されます。「スタイル」列では、次の入力パラメータを使用してRESTサービスを異なるスタイルで可視化できます。

- テンプレート: RESTリクエストへのパスをパラメータ化するパラメータ。(RESOURCEレベルのみ)。

- マトリックス: リソースの実際のパスに追加して問合せ文字列が先行するパラメータを定義するパラメータ。

- 問合せ: リクエストを送信する場合にURLのパスに追加するパラメータ(最も一般的なパラメータ・タイプ)。たとえば、通常GET HTTPリクエストの'?'の後のパスに追加されたり、HTMLフォーム送信の一部としてPOSTおよびPUTリクエストのリクエスト本体のキー値ペアとして示されます。

- ヘッダー: HTTPリクエストの送信ヘッダーに追加されるパラメータ。

スタイル値は、「リソース」および「メソッド」メニュー選択によって決定されます。

リクエストのヘッダーおよびボディセクションに直接インプットできる箇所では、「ツリー表示」または「Raw表示」を選択して、入力パラメータの階層リストと未処理データ表示を切り替えます。

注意:

「ツリー表示」は、GETメソッドにのみ使用できます。

10. 「Webサービスのテスト」をクリックしてテストを開始します。

テストを終了すると、「レスポンス」タブに結果が表示されます。メッセージとアイコンによってレスポンスのステータスが示されます。緑色のフラグは成功を、赤色のフラグは失敗を、黄色のフラグは未実行を表します。

テストが成功すると、図5-9に示すように、「テストのステータス」フィールドに「リクエストは正常に受信されました。」と表示され、レスポンス時間が表示されます。

図5-9 WADLのテストの成功

レスポンスタブの「Raw表示」オプションのみが使用可能で、リクエストの呼出しからレスポンス全体が表示されます。

テストが失敗すると、エラー・メッセージが表示されます。例として、図5-10に型エラーが原因のエラーを示します。

11. 図5-10 データ検証エラー

5.3.4.2 WebRestApp1 Webサービス

トークン発行者の信頼構成の参照と管理には、Representational State Transfer (REST)リソースのセットを使用できます。次に、その概要を示します。

リソース

メソッド

リソース・パス

persons

GET

rest/persons

headerGetPerson

GET

rest/headerGetPerson

person{id}

GET

rest/person/{id}

personMatrixAdd

POST

rest/personMatrixAdd

personXXXAdd

POST

rest/personXXXAdd

personPathAdd

POST

rest/personPathAdd/{id}

headerAddPerson

POST

rest/headerAddPerson

personQueryAdd

POST

rest/personQueryAdd

personAddForm

POST

rest/personAddForm

personQueryDefaultAdd

POST

rest/personQueryDefaultAdd

persondelete

DELETE

rest/persondelete

personUpdate

PUT

rest/personUpdate

verifyPart1

POST

rest/verifyPart1

5.3.4.2.1 GET personsメソッド

GETメソッドを使用して、すべての作成されたユーザーを参照します。

RESTリクエスト

GET rest/persons

入力パラメータ

なし。

レスポンス

メディアのタイプ

結果

application/xml

すべてのfirst_name、last_name、ph_noおよびID

作成され、使用可能な人(XML形式)

application/json

すべてのfirst_name、last_name、ph_noおよびID

作成され、使用可能な人(JSON形式)

5.3.4.2.2 GET headerGetPersonメソッド

GETメソッドを使用して、指定された名のユーザーのヘッダー詳細を参照します。

RESTリクエスト

GET rest/headerGetPerson

入力パラメータ

"fname/<firstname>"の名前/値とともにHTTPヘッダーを作成します。

レスポンス

メディアのタイプ

結果

application/xml

XML形式のヘッダーに入力されたfnameのfirst_name、last_name、ph_noおよびID

application/json

Json形式のヘッダーに入力されたfnameのfirst_name、last_name、ph_noおよびID

5.3.4.2.3 GET person{id}メソッド

GETメソッドを使用して、指定されたIDのユーザーを参照します。

RESTリクエスト

GET rest/person/{id}

入力パラメータ

検索するユーザーのIDを入力します。

レスポンス

メディアのタイプ

結果

application/xml

XML形式の入力パラメータに入力されたIDのすべての詳細

application/json

Json形式の入力パラメータに入力されたIDのすべての詳細

5.3.4.2.4 POST personMatrixAddメソッド

POSTメソッドを使用して、新しいユーザーおよび詳細を作成します。

RESTリクエスト

POST rest/personMatrixAdd

入力パラメータ

FirstNameおよびLastNameの文字列値、IDおよびPhone_noの整数値を入力します。

レスポンス

メディアのタイプ

結果

application/xml

XML形式の作成されたユーザーのfirst_name、last_name、ph_noおよびID

application/json

Json形式の作成されたユーザーのfirst_name、last_name、ph_noおよびID

5.3.4.2.5 POST personXXXAddメソッド

POSTメソッドを使用して、ユーザーの詳細を作成します。

RESTリクエスト

POST rest/personXXXAdd

入力パラメータ

入力パラメータは、メディア・タイプに依存します。

- リクエスト・メディア・タイプにapplication/vnd.xxx+xmlを選択する場合:
<person> <firstname>Firstname 12345/<firstname> <id>12345/id <lastname>Last 12345/lastname <phone_no>12345/phone_no/<person>

- リクエスト・メディア・タイプにapplication/vnd.xxx+jsonを選択する場合: {"firstname":"cc","id":14,"lastname":"cc","phone_no":14} <person>

レスポンス

ユーザーが追加されたことを確認するテキスト・メッセージ。

5.3.4.2.6 POST personPathAddメソッド

POSTメソッドを使用して、詳細とともにユーザーを作成します。

RESTリクエスト

POST rest/personPathAdd/{id}/{fname}/{lname}/{phno}

入力パラメータ

FirstNameおよびLastNameの文字列値、IDおよびPhone_noの整数値を入力します。

レスポンス

ユーザーが追加されたことを確認するテキスト・メッセージ。

5.3.4.2.7 POST headerAddPersonメソッド

POSTメソッドを使用して、ユーザーの詳細とともにHTTPヘッダーを作成します。

RESTリクエスト

POST rest/headerAddPerson

入力パラメータ

次の名前/値とともにHTTPヘッダーを作成します。

“fname = <firstname>"

“lname = <lastname>"

“phone_no = <phone_no>"

“id = <id>"

レスポンス

メディアのタイプ

結果

application/xml

XML形式の作成されたユーザーのfirst_name、last_name、ph_noおよびID

application/json

Json形式の作成されたユーザーのfirst_name、last_name、ph_noおよびID

ユーザーが追加されたことを確認するテキスト・メッセージ。

5.3.4.2.8 POST personQueryAddメソッド

POSTメソッドを使用して、詳細とともにユーザーを作成します。

RESTリクエスト

POST rest/personQueryAdd

入力パラメータ

FirstNameおよびLastNameの文字列値、IDおよびPhone_noの整数値を入力します。

レスポンス

ユーザーが追加されたことを確認するテキスト・メッセージ。

5.3.4.2.9 POST personAddFormメソッド

POSTメソッドを使用して、詳細とともにユーザーを作成します。

RESTリクエスト

POST rest/personAddForm

入力パラメータ

FirstNameおよびLastNameの文字列値、IDおよびPhone_noの整数値を入力します。

レスポンス

ユーザーが追加されたことを確認するテキスト・メッセージ。

5.3.4.2.10 POST personQueryDefaultAddメソッド

POSTメソッドを使用して、新しいユーザーおよび詳細を作成します。

RESTリクエスト

POST rest/personQueryDefaultAdd

入力パラメータ

このメソッドは、入力パラメータに関係なく呼び出される可能性があります。

- FirstNameおよびLastNameの文字列値、IDおよびPhone_noの整数値を入力します。

- すべての値を空白のままにし、テストを呼び出します。デフォルト値が選択され、ユーザーが作成されます

レスポンス

メディアのタイプ

結果

application/xml

XML形式の作成されたユーザーのfirst_name、last_name、ph_noおよびID

application/json

Json形式の作成されたユーザーのfirst_name、last_name、ph_noおよびID

5.3.4.2.11 DELETE persondeleteメソッド

DELETEメソッドを使用して、指定されたユーザーを削除します。

RESTリクエスト

DELETE rest/persondelete

入力パラメータ

削除するユーザーのIDを入力します。

レスポンス

ユーザーが削除されたことを確認するテキスト・メッセージ。

5.3.4.2.12 PUT personUpdateメソッド

PUTメソッドを使用して、指定されたユーザーの詳細を更新します。

RESTリクエスト

PUT rest/personUpdate

入力パラメータ

更新するユーザーのIDを入力し、他の入力変数を変更します。

レスポンス

ユーザーが削除されたことを確認するテキスト・メッセージ。

5.3.4.2.13 POST verifyPart1メソッド

POSTメソッドを使用して、部分としてコンテンツを送信します。

RESTリクエスト

POST rest/verifyPart1

入力パラメータ

次に示すように、「制御」、「アクション」で部分を作成します。

1. 部分名に"part1"、部分コンテンツに"part1_contents"を入力します。「OK」をクリックします。

2. 入力モードからファイルを選択します。部分名に"part2"を入力し、任意のファイルを参照します。
「OK」をクリックします。

レスポンス

結果には、送信された部分数および各部分の詳細が含まれます。

5.3.4.3 Mime_Multipart_rs Webサービス

応答文字列のマルチパート構成は、次に説明するように、一連のRepresentational State Transfer (REST)リソースを使用して参照および管理できます。

リソース

メソッド

リソース・パス

greetingsMultipart

POST

/hello/greetingsMultipart

greetings

GET

/hello/{greetings}

greetingsImagePOST

POST

/hello/greetingsImagePOST

greetings_matrix_to

GET

/hello/greetings_matrix_to

greetings_query_to

GET

/hello/greetings_query_to

greetingsMsg

GET

/hello/greetingsMsg

greetingsImagePOST1

POST

/hello/greetingsImagePOST1

greetingsMsgQP

POST

/hello/greetingsMsgQP

hello

GET

/hello

5.3.4.3.1 POST greetingsMultipartメソッド

POSTメソッドを使用して、部分としてコンテンツを送信します。

RESTリクエスト

POST /hello/greetingsMultipart

入力パラメータ

次に示すように、「制御」、「アクション」で部分を作成します。

1. 部分名に"part1"、部分コンテンツに"part1_contents"を入力します。「OK」をクリックします。

2. 入力モードからファイルを選択します。部分名に"part2"を入力し、任意のファイルを参照します。
「OK」をクリックします。

レスポンス

応答コンテンツのダウンロードをクリック・ボタンをクリックします。テキスト・ファイルにレスポンスが表示されます。

5.3.4.3.2 GET greetingsメソッド

GETメソッドを使用して、応答文字列を参照します。

RESTリクエスト

GET /hello/{greetings}

入力パラメータ

応答用の文字列値を入力します。

レスポンス

応答コンテンツのダウンロードをクリック・ボタンをクリックします。テキスト・ファイルには、入力された入力コンテンツとともにレスポンスが表示されます。

5.3.4.3.3 POST greetingsImagePOSTメソッド

POSTメソッドを使用して、イメージ・ファイルを追加します。

RESTリクエスト

POST /hello/greetingsImagePOST

入力パラメータ

.pngイメージ・ファイルを参照および追加します。

レスポンス

応答コンテンツのダウンロードをクリック・ボタンをクリックします。テキスト・ファイルには、イメージ・ファイル・コンテンツとともにレスポンスが表示されます。

5.3.4.3.4 GET greetings_matrix_toメソッド

GETメソッドを使用して、応答文字列を参照します。

RESTリクエスト

GET /hello/greetings_matrix_to

入力パラメータ

応答用の文字列値を入力します。

レスポンス

応答コンテンツのダウンロードをクリック・ボタンをクリックします。テキスト・ファイルには、入力された入力コンテンツとともにレスポンスが表示されます。

5.3.4.3.5 GET greetings_query_toメソッド

GETメソッドを使用して、応答文字列を参照します。

RESTリクエスト

GET /hello/greetings_query_to

入力パラメータ

応答用の文字列値を入力します。

レスポンス

応答コンテンツのダウンロードをクリック・ボタンをクリックします。テキスト・ファイルには、入力された入力コンテンツとともにレスポンスが表示されます。

5.3.4.3.6 GET greetingsMsgメソッド

GETメソッドを使用して、応答文字列を参照します。

RESTリクエスト

GET /hello/greetingsMsg

入力パラメータ

コンテンツ・テキスト領域に応答用の文字列値を入力します。

レスポンス

レスポンスには、入力した入力コンテンツが表示されます。

5.3.4.3.7 POST greetingsImagePOST1メソッド

POSTメソッドを使用して、イメージ・ファイルを追加します。

RESTリクエスト

POST /hello/greetingsImagePOST1

入力パラメータ

フォルダを参照し、イメージ・ファイルを追加します。

レスポンス

添付されたファイル・サイズが返されることを確認します

5.3.4.3.8 POST greetingsMsgQPメソッド

POSTメソッドを使用して、イメージ・ファイルを追加します。

RESTリクエスト

POST /hello/greetingsMsgQP

入力パラメータ

応答用の文字列値を入力します。

レスポンス

応答コンテンツのダウンロードをクリック・ボタンをクリックします。テキスト・ファイルには、イメージ・ファイル・コンテンツとともにレスポンスが表示されます。

5.3.4.3.9 GET helloメソッド

GETメソッドを使用して、応答文字列を参照します。

RESTリクエスト

GET /hello

入力パラメータ

なし。

レスポンス

応答コンテンツのダウンロードをクリック・ボタンをクリックします。テキスト・ファイルにはレスポンスが含まれます。

5.3.5 セキュリティのテスト

「Webサービスのテスト」ページでは、OWSMセキュリティ・ポリシー、HTTP Basic認証または事前定義済ポリシーのコピーを含むカスタム・ポリシーを使用してWebサービスのセキュリティをテストできます。ページの「セキュリティ」セクション内のいずれかのオプションを選択することによって、テストのタイプを選択できます。

WSDLまたはWADLのポリシーではセキュリティ設定は決定されないため、テストするセキュリティのタイプを指定できます。デフォルトは「なし」です。

次のオプションを使用できます。次の各項で各オプションについて詳しく説明します。

- 「OWSMセキュリティ・ポリシー」: OWSMセキュリティ・ポリシーによる認証およびメッセージ保護に必要な資格証明やその他のセキュリティ・オプションを使用します。
この項で後述するように、「OWSMセキュリティ・ポリシー」を選択したときに使用できるオプションは、テスト対象がRESTful WebサービスかSOAP Webサービスかによって少し異なります。

- HTTP Basic認証: ユーザー名およびパスワードの資格証明をHTTPトランスポート・ヘッダーに挿入します。ユーザー名およびパスワードの両方が必須です。
ユーザー名とパスワードを指定する場合は、存在していて有効なものを指定する必要があります。

- 拡張: カスタム・ポリシーを使用してユーザーを認証します。ユーザー定義またはデフォルト以外のすべてのOWSMポリシーと、デフォルト・ポリシーのコピーを、カスタム・ポリシーと呼びます。ポリシーのURIを指定する必要があります。構成のオーバーライドも指定できます。

注意:

このオプションは、RESTful Webサービスには使用できません。

- なし - 資格証明は含まれません。

5.3.5.1 OWSMセキュリティ・ポリシー

使用できるのはOWSM事前定義済ポリシーの一部のみであり、これらのポリシー用に表示される属性のみが構成可能です。他のポリシー属性には、すべてポリシーのデフォルト値が使用されます。たとえば、安全な会話の有効化やメッセージ・セキュリティ・アルゴリズム・スイートの変更などはできません。

注意:

テスト機能でサポートされているクライアント・ポリシーのリストは、5-36ページの「SOAPサービスのサポートされているクライアント・セキュリティ・ポリシー」と5-37ページの「RESTfulサービスのサポートされているクライアント・セキュリティ・ポリシー」を参照してください。

セキュリティ・ポリシーでないもの、およびテスト機能でサポートされていないポリシーは、読取り専用で表示され、選択できません。あるサービスのサービス・ポリシーで、対応するクライアント・ポリシーがサポートされていない場合(コピーを含む)、これらのポリシーは読取り専用として表示されます。したがって、事前定義済ポリシーから作成したコピーは直接には表示されず、「拡張」オプションによってのみ使用可能になります。

たとえば、Webサービスにoracle/wss11_message_protection_service_policyポリシーのコピーが添付されており、oracle/wss11_message_protection_client_policyのコピーを作成したとします。テスト・クライアントにはoracle/wss11_message_protection_client_policyとoracle/wss11_message_protection_client_policy_copyの両方のポリシーが表示されますが、oracle/wss11_message_protection_client_policy_copyポリシーの方は使用不可であり、グレイアウトされています。

次の2つの方法のいずれかを選択できます。

- テスト用として事前定義済ポリシーoracle/wss11_message_protection_client_policyが要件を満たしている場合は、oracle/wss11_message_protection_client_policyを選択します。
「JKSキーストア・ロケーション」フィールドと「JKSキーストア・パスワード」フィールドは必須であり、ページ上に表示されています。ロケーションとパスワードを入力し、「キーのロード」をクリックします。

- 独自のポリシーoracle/wss11_message_protection_client_policy_copyを使用する場合は、次の手順に従います。

1. 「詳細」を選択します。

2. ポリシーURI、この場合は「oracle/wss11_message_protection_client_policy_copy」を入力します。

3. メッセージ保護ポリシーとSSLポリシーには「JKSキーストア・ロケーション」フィールドと「JKSキーストア・パスワード」フィールドが必須です。
『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』の設計時にオーバーライド可能なクライアント・ポリシー構成プロパティに記載されている完全なプロパティ名を使用して、JKSキーストア・ロケーションとパスワードの値を入力します。

oracle.wsm.security.util.SecurityConstants.ClientConstants.WSS_KEYSTORE_LOCATION
oracle.wsm.security.util.SecurityConstants.ClientConstants.WSS_KEYSTORE_PASSWORD

5.3.5.2 SOAPおよびRESTful OWSMセキュリティ・ポリシー

「OWSMセキュリティ・ポリシー」を選択したときに使用できるオプションは、テスト対象がSOAP WebサービスかRESTful Webサービスかによって少し異なります。

SOAP Webサービスのオプションを図5-11に示します。RESTful Webサービスのオプションを図5-12に示します。「拡張オプション」フィールドを選択して使用可能なフィールドをすべて表示した状態です。

図5-11 SOAP WebサービスのOWSMセキュリティ・ポリシー・テスト・オプション

図5-12 RESTful WebサービスのOWSMセキュリティ・ポリシー・テスト・オプション

OWSMセキュリティ・ポリシーを使用してWebサービスのセキュリティをテストする手順は、次のとおりです。

1. サービスのテストに使用するポリシーを選択します。使用できるポリシーは、テスト対象がSOAP WebサービスかRESTful Webサービスかによって異なります。

- SOAP Webサービスのテスト用ポリシーの選択
WSDLで指定されている、互換性があるクライアント・ポリシーの一覧が表示される「互換性のあるクライアント・ポリシー」で、テストするクライアント・ポリシーを選択します。

または、エンドポイントでネガティブ・テストを実行するには、「その他のクライアント・ポリシー」リストから、互換性のないポリシーまたは「すべて」を選択します。

- RESTful Webサービスのテスト用ポリシーの選択
「クライアント・ポリシー」リストからテストするクライアント・ポリシーを選択します。

選択したポリシーで必須の構成プロパティは、アスタリスク(*)付きで表示されます。次に例を示します。

- username_tokenおよびhttp_tokenポリシーの場合、「ユーザー名」と「パスワード」フィールドは必須です。SAMLポリシーの場合、「ユーザー名」フィールドのみ必須です。

- メッセージ保護ポリシーおよびSSLポリシーの場合、JKSキー・ストアの場所とJKSキーストア・パスワードのフィールドは必須です。(KSSキーストアはサポートされていません。)

2. ポリシーが必須と判断したフィールドに値を入力します。
「JKSキーストア・ロケーション」フィールドおよび「JKSキーストア・パスワード」フィールドがポリシーによって要求される場合、NFSがアクセス可能な、ユーザーが作成したキーストアの場所とパスワードを入力し、「キーのロード」をクリックします。「拡張オプション」の下にある関連するキーストア・フィールドに、キーストアで指定されている別名が移入されます。

キーストアの作成の詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』の秘密鍵の生成とJavaキーストアの作成に関する項を参照してください。

3. 「拡張オプション」をクリックします。追加のキーストア別名およびSAMLプロパティのフィールドが表示されます。選択したポリシーで必須のプロパティは、アスタリスク付きで表示されます。該当のフィールドに必要な値を入力するか、オーバーライド値を入力します。

5.3.5.3 HTTP Basic認証

このオプションでは、HTTPトランスポート・ヘッダーに挿入されたユーザー名およびパスワード資格証明が必要です。ユーザー名とパスワードは存在していて、WebLogic Serverで有効である必要があります。

5.3.5.4 拡張

注意:

「拡張」オプションは、RESTful Webサービスには使用できません。

「拡張」を選択すると表示されるオプションを、図5-13に示します。

図5-13 「拡張」テスト・オプション

「拡張」オプションを選択すると、事前定義済ポリシーのコピーなどのカスタム・ポリシーを使用してWebサービスのセキュリティをテストできるようになります。これを行うには、次の手順を実行します。

1. カスタム・ポリシーのURIは、「ポリシーURI」フィールドで指定します。たとえば、「oracle/wss11_message_protection_client_policy_copy」を指定します。このフィールドは必須です。

2. 「名前」と「値」フィールドに、ポリシー構成のオーバーライドを指定します。
username_tokenポリシーとhttp_tokenポリシーの場合、「ユーザー名」プロパティと「パスワード」プロパティが必須です。SAMLポリシーの場合、「ユーザー名」プロパティのみが必須です。

メッセージ保護ポリシーとSSLポリシーの場合、「JKSキーストア・ロケーション」フィールドと「JKSキーストア・パスワード」フィールドが必須です。(KSSキーストアはサポートされていません。)

プロパティを追加するには、「追加」をクリックして、構成をオーバーライドする名前と値のペアを指定します。プロパティを削除するには、表内のプロパティを選択して、「削除」をクリックします。

注意:

プロパティの指定には、各プロパティの完全名を使用する必要があります。たとえば、oracle.wsm.security.util.SecurityConstants.ClientConstants.WSS_KEYSTORE_LOCATIONのように指定します。オーバーライド可能なプロパティのプロパティ名の完全な一覧は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』の設計時のクライアント・ポリシー構成プロパティのオーバーライドに関する項を参照してください。

他のポリシー属性には、すべてポリシーのデフォルト値が使用されます。たとえば、安全な会話を有効化した場合や、メッセージ・セキュリティ・アルゴリズム・スイートを変更した場合に、これらのポリシー値が使用されます。

5.3.5.5 SOAPサービスのサポートされているクライアント・セキュリティ・ポリシー

次に示すSOAPサービスのOWSMクライアント・セキュリティ・ポリシーはテスト機能でサポートされています。これらの事前定義済ポリシーのコピーは直接には表示されず、「拡張」オプションによってのみ使用可能になります。

- oracle/wss_http_token_client_policy

- oracle/wss_http_token_over_ssl_client_policy

- oracle/wss_saml_token_bearer_over_ssl_client_policy

- oracle/wss_saml_token_over_ssl_client_policy

- oracle/wss_saml20_token_bearer_over_ssl_client_policy

- oracle/wss_saml20_token_over_ssl_client_policy

- oracle/wss_username_token_client_policy

- oracle/wss_username_token_over_ssl_client_policy

- oracle/wss10_message_protection_client_policy

- oracle/wss10_saml_token_with_message_integrity_client_policy

- oracle/wss10_saml_token_with_message_protection_client_policy

- oracle/wss10_saml_token_with_message_protection_ski_basic256_client_policy

- oracle/wss10_saml20_token_with_message_protection_client_policy

- oracle/wss10_username_id_propagation_with_msg_protection_client_policy

- oracle/wss10_username_token_with_message_protection_client_policy

- oracle/wss10_username_token_with_message_protection_ski_basic256_client_policy

- oracle/wss10_x509_token_with_message_protection_client_policy

- oracle/wss11_message_protection_client_policy

- oracle/wss11_saml_token_identity_switch_with_message_protection_client_policy

- oracle/wss11_saml_token_with_message_protection_client_policy

- oracle/wss11_saml20_token_with_message_protection_client_policy

- oracle/wss11_username_token_with_message_protection_client_policy

- oracle/wss11_x509_token_with_message_protection_client_policy

5.3.5.6 RESTfulサービスのサポートされているクライアント・セキュリティ・ポリシー

次に示すRESTfulサービスのOWSMクライアント・セキュリティ・ポリシーはテスト機能でサポートされています。

- oracle/http_basic_auth_over_ssl_client_policy

- oracle/http_saml20_token_bearer_client_policy

- oracle/http_saml20_token_bearer_over_ssl_client_policy

- oracle/wss_http_token_client_policy

- oracle/http_jwt_token_client_policy

- oracle/http_jwt_token_over_ssl_client_policy

5.3.6 サービスのクオリティ・テストの有効化

注意:

この項の内容は、RESTful Webサービスのテスト時には適用されません。

「Webサービスのテスト」ページの「サービスのクオリティ」セクション(図5-14)では、サービスのクオリティ(QoS)のWebサービスの信頼性のあるメッセージング(WS-RM)、WS-AddressingおよびMTOMという3つの特性をテストできます。サービスのクオリティの各タイプには、3つのオプションがあります。

- WSDLデフォルト: WSDLのデフォルト動作を実行します。たとえば、「MTOM」に「WSDLデフォルト」が選択され、WSDLにMTOMポリシーへの参照が含まれている場合は、そのポリシーが実行されます。WSDLにMTOMポリシーへの参照が含まれない場合は、MTOMポリシーは実行されません。

- なし - WSDLに含まれている場合でも、特定のQoSのポリシーは実行されません。たとえば、WS-RMに「なし」が選択されている場合、信頼できるメッセージング・ポリシーは実行されません。WSDLに信頼できるメッセージング・ポリシーへの参照が含まれている場合は、無視されます。

- カスタム - カスタム・ポリシーが実行されます。たとえば、WS-AddressingポリシーがWSDL内で参照されている場合、このポリシーは無視され、かわりに「URI」フィールドで指定されたポリシーが使用されます。

- URI: ポリシーが実行される場所を指定します。

図5-14 「Webサービスのテスト」ページのサービスのクオリティのパラメータ

5.3.7 HTTPヘッダーのテスト

「HTTPヘッダー」セクションでは、SOAPまたはRESTful Webサービスにリクエスト情報を渡すHTTPヘッダーを追加、変更または削除できます。サービス起動後、HTTPヘッダーはメッセージ・レスポンスの一部として表示されます。

図5-15 テストWebサービス・ページのHTTPヘッダー

5.3.8 入力引数のXMLソースとしての編集

入力引数は、ユーザーにわかりやすい形式で表示できます。また、XMLソース・コードを直接編集できます。XMLソースを直接編集する場合は、有効なXMLを入力する必要があります。

図5-16 入力引数 - XML表示

ツリー表示とXML表示を切り替えるには、ページの「引数を入力」セクションのドロップダウン・リストを使用します。

図5-17 入力引数 - ツリー表示

5.3.9 Webサービス操作のストレス・テスト

Webサービス操作の連続した呼出しを起動するには(図5-18)、ストレス・テストの有効化チェック・ボックスを選択します(図5-18)。次のオプションを使用できます。

- 同時スレッド: 起動を送信する同時スレッド数。デフォルトは5スレッドです。

- スレッドごとのループ: 操作を起動する回数。デフォルトは10回です。

- ミリ秒単位の遅延 - ある操作から次の操作を起動するまでに待機する時間(ミリ秒数)。デフォルトは1000ミリ秒(1秒)です。

図5-18 「Webサービスのテスト」ページのストレス・テストのパラメータ

テストを起動すると、進捗ボックスにテストのステータスが表示されます。ストレス・テストが完了すると、確認ページにテストの結果が表示されます。

「レスポンス」タブには、エラーが発生したテスト数、レスポンス時間の平均値、最小値および最大値など、ストレス・テストに関する追加情報が表示されます。各テストの詳細は、表形式で示されます。各テストについて、スレッド数、ループ数、テスト時間、テストの開示時刻と終了時刻、および呼出しステータスを表示できます。表に表示されたフィールドは、「表示」メニューを使用してフィルタリングできます。

図5-19 「Webサービスのテスト」ページのストレス・テストの結果

6 Webサービスの監視および監査

この章では、Fusion Middleware Controlを使用してWebサービスのパフォーマンスを監視する方法について説明します。

この章の内容は次のとおりです。

- パフォーマンスのモニタリング、監査、およびチューニングの概要

- Webサービスの監視の概要

- Webサービスの監査

6.1 パフォーマンスのモニタリング、監査、およびチューニングの概要

注意:

この章で説明する監視機能の一部のみが、Java EE Webサービスに適用されます。

Fusion Middleware Controlの「Webサービス」アプリケーション・サマリー・ページでは次のことができます。

- セキュリティ、信頼できるメッセージング、MTOM、管理およびサービス・フォルトなどの、Webサービス・フォルトを監視できます。

- 認証、認可、メッセージ整合性およびメッセージ機密保護の問題などの、セキュリティの問題を監視できます。

- ポートの有効化や無効化、Webサービスへのポリシーの添付、ポリシーの有効化や無効化など、Webサービス・ポートを構成できます。

アプリケーションにWebサービスが含まれている場合、「アプリケーション」ホームページには選択したWebサービスの詳細も表示されます。

6.2 Webサービスの監視の概要

この項では、次の項について説明します。

- Webサービス統計の開始またはリセットのタイミング

- サーバー・インスタンスのWebサービス統計の表示

- アプリケーションのWebサービス統計の概要

- 個々のWebサービスのWebサービス統計の表示

- Webサービス・エンドポイントの操作統計の表示

- Java EE Webサービス操作の統計の表示

- Java EE Webサービス・クライアントの統計の表示

- RESTful Resourcesの統計の表示

- SOAバインディング・コンポーネントの統計の表示

- Webサービスのセキュリティ違反の表示の概要

この章で説明する監視機能に加えて、1つ以上のWebサービスによるポリシーの使用状況を分析するには、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のポリシーの使用状況の分析に関する項を参照してください。

6.2.1 Webサービス統計の開始またはリセットのタイミング

この章で説明する統計は、次のイベントのいずれかが発生すると開始またはリセットされます。

- アプリケーションが初めてデプロイされたとき。

- アプリケーションが再デプロイされたとき。

- アプリケーションがすでにデプロイされていて、ホストするサーバーが再起動されたとき。

6.2.2 サーバー・インスタンスのWebサービス統計の表示

サーバー側の「Webサービス」ページには、サーバー上のすべてのWebサービスの統計が表示されます。

サーバーのすべてのWebサービス統計を表示するには::

1. ナビゲータ・ペインで「WebLogicドメイン」を開き、ポリシーを表示するドメインを表示し、ドメインを選択します。

2. ドメインを開き、そのドメインのサーバーを表示します。統計を表示するサーバーを選択します。

3. コンテンツ・ペインで「WebLogic Server」→「Webサービス」を選択します。

4. Webサービス・サーバー・サマリー・ページに、サーバーにデプロイされたWebサービスの統計が表示されます。

デプロイしたWebサービスのタイプに応じて、使用可能なWebサービス・タイプのタブ(「Java EE」、「Oracle Infrastructure Web Services」、「RESTfulサービス」)が表示されます。

Java EE Webサービスの場合、次の統計がサーバーで実行中のWebサービスごとに表形式で表示されます。

- Webサービス名: Webサービスの名前。

- アプリケーション名: Webサービスが含まれているアプリケーションの名前。

- エンドポイント名: Webサービス・エンドポイントの名前。エンドポイント名をクリックすると、「Webサービス・エンドポイント」ページが表示されます。

- 呼出し数: このエンドポイントに対する呼出しリクエストの数。

- レスポンス数: 生成されたレスポンスの数。

- レスポンス・エラー数: レスポンス中に発生したエラー数。

- 平均実行時間: Webサービスの実行に要した平均時間(ミリ秒)。

- 平均レスポンス時間: Webサービスからのレスポンスの受取りに要した平均時間(ミリ秒)。

Oracle Infrastructure Webサービスの場合、次の統計がサーバーで実行中のWebサービスごとに表形式で表示されます。

- Webサービス名: Webサービスの名前。

- アプリケーション名: Webサービスが含まれているアプリケーションの名前。

- エンドポイント名: Webサービス・エンドポイントの名前。エンドポイント名をクリックすると、「Webサービス・エンドポイント」ページが表示されます。

- 完了した呼出し: このエンドポイントに対する完了済のリクエスト数。

- 平均呼出し時間: Webサービスがレスポンスの送信に要した平均時間(ミリ秒)。

- フォルトの合計: 失敗したリクエストの合計数。

RESTfulサービスの場合、次の統計がサーバーで実行中のWebサービスごとに表形式で表示されます。

- アプリケーション名: RESTful Webサービスが含まれているアプリケーションの名前。

- モジュール名: RESTfulサービスのモジュールの名前。

- 名前: RESTfulアプリケーション名。RESTfulサービス・アプリケーション・ページを表示するには、名前をクリックします。

- 呼出し数: RESTful Webサービスが呼び出された回数。

- エラー数: RESTful Webサービスで発生したエラー数。

- 平均実行時間: すべてのRESTful Webサービスの平均実行時間(ミリ秒)。

6.2.3 アプリケーションのWebサービス統計の概要

次の各項では、アプリケーションの種類に応じてWebサービス統計を表示する方法を説明します。

- "SOAコンポジット・アプリケーションのWebサービス統計の表示"

- "SOA以外のOracle Infrastructure Webサービス・アプリケーションのWebサービス統計の表示"

- "Java EEアプリケーションのWebサービス統計の表示"

6.2.3.1 SOAコンポジット・アプリケーションのWebサービス統計の表示

Fusion Middleware Controlでは、SOAコンポジット・アプリケーションのダッシュボードに、コンポジット・アプリケーション内のすべてのサービスと参照について基本的な監視情報が表示されます(図6-1を参照)。

SOAコンポジット・アプリケーションのダッシュボード・ページに移動するには::

1. ナビゲーション・ペインで「SOA」フォルダを開きます。

2. soa-infraを開いてSOAパーティションを表示します。SOAパーティション(たとえば、defaultパーティション)を開き、目的のSOAコンポジット・アプリケーションを選択します。

SOAコンポジットのホームページが表示されます。

3. 選択されていない場合は、「ダッシュボード」タブを選択します。

このタブの「コンポーネント」セクションには、コンポジット・アプリケーションで使用されているSOAコンポーネントが表示され、「サービスと参照」セクションには、Webサービスと参照バインディングが表示されます。

SOAコンポジット・アプリケーションのサービスと参照について、次のようなWebサービス・アプリケーション・レベルの統計が表示されます。

- 名前: サービスまたは参照の名前。

- タイプ: サービスまたは参照のタイプ。

- 使用状況: サービスまたは参照。

- 合計メッセージ数: メッセージの合計数。

- 平均処理時間(秒): 平均処理時間(秒)。

図6-1 SOAコンポジット・アプリケーションのダッシュボード

6.2.3.2 SOA以外のOracle Infrastructure Webサービス・アプリケーションのWebサービス統計の表示

Fusion Middleware Controlでは、アプリケーションの「Webサービスのサマリー」ページに、アプリケーション内のすべてのWebサービスについて全体のサマリーとフォルト/違反情報が表示されます(図6-2を参照)。

「チャート」セクションには、Webサービスのすべてのセキュリティ・フォルトがグラフで表示されます。

SOA以外のOracle Infrastructure Webサービス・アプリケーションの「Webサービスのサマリー」ページに移動するには::

1. ナビゲータ・ペインで、「アプリケーションのデプロイ」フォルダを開き、ドメイン内のアプリケーションを表示して、アプリケーションのデプロイを選択します。

「ドメイン・アプリケーションのデプロイ」ホームページが、コンテンツ・ペインに表示されます。

2. ナビゲータ・ペインで、「アプリケーションのデプロイ」を開き、アプリケーション名を選択します。

「アプリケーションのデプロイ」ホームページが、コンテンツ・ペインに表示されます。

3. コンテンツ・ペインで「アプリケーションのデプロイ」、「Webサービス」を順に選択します。

アプリケーションの「Webサービスのサマリー」ページが表示されます。

このページには、Webサービスのエンドポイントとアプリケーション・レベルのメトリックが表示されます。

Oracle Infrastructure Webサービスについて、次のようなWebサービス・アプリケーション・レベルの統計が表示されます。

- Webサービス: アプリケーション内のWebサービスの合計数。

- Webサービス・エンドポイント: このアプリケーション内のWebサービスが使用するエンドポイントの合計数。

- Webサービス・エンドポイント無効: 無効なWebサービスに割り当てられたエンドポイントの合計数。

- ポリシーの障害: ポリシー・フォルトのため失敗したWebサービス・リクエストの数。アプリケーションが最後に再起動してからの合計数を指定します。

- フォルトの合計: セキュリティ、信頼できるメッセージ、MTOM、管理およびサービス・フォルトを含む、失敗したリクエストの合計数。アプリケーションが最後に再起動してからの合計数を指定します。

- 完了した呼出し: アプリケーションが最後に再起動してからのWebサービスに対するクライアント・リクエストの合計数。

図6-2 アプリケーションのWebサービス・パフォーマンスのサマリーとグラフ

6.2.3.3 Java EEアプリケーションのWebサービス統計の表示

Fusion Middleware Controlでは、SOAPおよびRESTfulサービスを含むJava EEアプリケーションのWebサービスのサマリー・ページに、アプリケーション内のすべてのWebサービスについて全体のサマリーとフォルト/違反情報が表示されます(図6-3を参照)。

Java EE Webサービス・アプリケーションの「Webサービスのサマリー」ページに移動するには::

1. ナビゲータ・ペインで、「アプリケーションのデプロイ」フォルダを開き、ドメイン内のアプリケーションを表示して、アプリケーションのデプロイを選択します。

「ドメイン・アプリケーションのデプロイ」ホームページが、コンテンツ・ペインに表示されます。

2. ナビゲータ・ペインで、「アプリケーションのデプロイ」を開き、アプリケーション名を選択します。

「アプリケーションのデプロイ」ホームページが、コンテンツ・ペインに表示されます。

3. コンテンツ・ペインで「アプリケーションのデプロイ」、「Webサービス」を順に選択します。

アプリケーションの「Webサービスのサマリー」ページが表示されます。

このページには、Webサービスのエンドポイントとアプリケーション・レベルのメトリックが表示されます。

SOAPおよびRESTful Webサービスを含むJava EE Webサービスについて、次のようなWebサービス・アプリケーション・レベルの統計が表示されます。

- サーバー名: アプリケーションがデプロイされるサーバー。

- Webサービス: アプリケーション内のWebサービスの数。

- Webサービス・エンドポイント: このアプリケーション内のWebサービスが使用するエンドポイントの合計数。

- RESTfulアプリケーションの数: このWebサービスに登録されているRESTfulアプリケーションの合計数。

- RESTfulリソースの数: RESTfulアプリケーションに使用可能なリソースの数。

- Java EE Webサービス・クライアント: アプリケーション内のランタイム・クライアント・インスタンス数。

- Java EE Webサービス・クライアント・ポート: OWSMポリシーを添付できるアプリケーション内のWebサービス・クライアント・ポート数。

図6-3 Java EE Webサービスのサマリー

6.2.4 個々のWebサービスのWebサービス統計の表示

アプリケーションの「Webサービスのサマリー」ページの「Webサービスの詳細」セクションには、図6-4に示すように、Webサービス単位の統計が表示されます。「Webサービスのサマリー」ページへの移動の詳細は、アプリケーションのWebサービス統計の概要を参照してください。

Java EE Webサービスについて次の統計が表示されます。

- 名前 — Webサービスの名前。Webサービスを展開すると、Webサービスのエンドポイントが表示されます。

- 呼出し回数—このエンドポイントに対する呼出しリクエストの数。

- レスポンス・エラー数 — レスポンス中に生じるエラー数。

- レスポンス数 — レスポンスの数。

- 平均実行時間(ミリ秒) — Webサービスの実行に要した平均時間(ミリ秒)

- 平均レスポンス時間(ミリ秒) — Webサービスからのレスポンスの受取りに要した平均時間(ミリ秒)。

RESTful Webサービスについて次の統計が表示されます。

- モジュール名とRESTfulアプリケーション名 — モジュールとRESTfulアプリケーションの名前。RESTfulアプリケーション名をクリックすると、「RESTfulサービス・アプリケーション」ページが表示されます。

- リソース名 — RESTfulリソースの名前。

- リソース・タイプ — RESTfulリソースのタイプ。

- リソース・パス — RESTfulリソースのURI。

- 呼出し回数—このエンドポイントに対する呼出しリクエストの数。

- 平均実行時間(ミリ秒) — Webサービスの実行に要した平均時間(ミリ秒)

Oracle Infrastructure Webサービスについて次の統計が表示されます。

- 名前 — Webサービスの名前。Webサービスを展開すると、Webサービスのエンドポイントが表示されます。

- エンドポイント有効: Webサービスが有効か無効かを指定するフラグ。Oracle Infrastructure Webサービス・プロバイダの場合、このフィールドには「N/A」が表示されます。

- 開始時間: Webサービスが開始した時間。

- 完了した呼出し: このエンドポイントへの完了済リクエスト数。

- 平均呼出し時間: すべてのWebサービス呼出しが処理される平均時間。

- ポリシーの障害: ポリシーが正常に実行されなかったため失敗したリクエストの数。

- フォルトの合計: 失敗したリクエストの合計数。

図6-4 個々のOracle Infrastructure WebサービスのWebサービス統計

6.2.5 Webサービス・エンドポイントの操作統計の表示

この手順に従って、Webサービス・エンドポイントの統計を表示します。個別操作の統計表示は、「Java EE Webサービス操作の統計の表示」を参照してください。

特定のWebサービス・エンドポイントの操作統計を表示する手順は、次のとおりです。

1. 「アプリケーションのWebサービスのサマリー・ページの表示」で説明されているように、「Webサービス・のサマリー」ページに移動します。

2. Webサービスのサマリー・ページの「Webサービスの詳細」セクションで、「Webサービス・エンドポイント」タブを選択します。

3. 統計を表示するエンドポイントを選択します。

「Webサービス・エンドポイント」ページが表示されます。

4. 「操作」タブを選択します(まだ選択していない場合)。

Oracle Infrastructure Webサービスについて次の統計が表示されます。

要素

説明

操作名

操作の名前。

一方向

操作がコールに対して値を戻すかどうかを指定するフラグ。

アクション

アクションのURIです。

入力エンコーディング

入力メッセージのエンコーディング・スタイル。

出力エンコーディング

出力メッセージのエンコーディング・スタイル。

完了した呼出し

このエンドポイントへの完了済リクエスト数。

平均呼出し時間

すべてのWebサービス起動が処理される平均時間。

フォルト

エンドポイントに対するフォルトの合計数。

Java EE Webサービスについて次の統計が表示されます。

要素

説明

名前

操作の名前。

呼出し回数

Webサービスが起動された回数。

平均ディスパッチ時間(ミリ秒)

すべてのWebサービス起動が処理される平均時間(ミリ秒)。

平均実行時間(ミリ秒)

すべてのWebサービス実行の平均時間(ミリ秒)。

平均レスポンス時間(ミリ秒)

生成されたすべてのレスポンスの平均時間(ミリ秒)。

レスポンス数

Webサービス起動から生成されるレスポンスの合計数。

レスポンス・エラー数

Webサービス起動から生成されるレスポンスのエラーの合計数。

6.2.6 Java EE Webサービス操作の統計の表示

個別のWebサービス操作は、「Webサービス・エンドポイント」ページの「操作」タブに表示されます。この手順は、Java EE Webサービス操作にのみ適用されます。

個別のJava EE Webサービス操作の統計を表示する手順は、次のとおりです。

1. 「Java EE Webサービス操作の詳細の表示」の説明に従って、「Webサービス操作」ページに移動します。

2. 操作名をクリックすると、統計が表示されます。

「Webサービス操作」ページには次の統計が表示されます。

要素

説明

アプリケーション名

この操作が関連付けられているアプリケーションの名前。

Webサービス名

この操作が関連付けられているWebサービスの名前。

エンドポイント名

この操作が関連付けられているエンドポイントの名前。

操作名

Webサービス操作の名前。

エンドポイントURI

この操作が関連付けられているエンドポイントのURI。

エラー

Webサービス操作ページのエラー・セクションには、次のエラー統計が表示されます。

要素

説明

エラー数

リクエストの送受信で発生したエラー数。

最後のエラー

リクエストの処理中に最後に発生したエラー。

最新のエラー時間

WebLogic Serverでリクエスト(送信または受信)のエラーが最後に検出された時刻。UTC 1970年1月1日の深夜12時からのミリ秒数で表されます。

レスポンス・エラー数

操作呼出しから生成されたレスポンスにおけるエラーの合計数。

最終レスポンス・エラー

クライアントまたはサービスに対して最後に受信したレスポンス・エラー(エラーが発生しなかった場合はnull)。

最終レスポンス・エラー時間

WebLogic Serverでレスポンスの送信または受信のエラーが最後に検出された時刻(または、エラーが発生していない場合は0)。UTC 1970年1月1日の深夜12時からのミリ秒数で表されます。

呼出し統計

Webサービス操作ページの呼出し統計セクションには、次の呼出し統計が表示されます。

要素

説明

呼出し回数

現在の測定期間の操作呼出し回数の合計数。

最終呼出し時間

操作リクエストが最後に送信または受信された時刻(または、リクエストが送受信されていない場合は0)。

平均ディスパッチ時間(ミリ秒)

現在の測定期間における平均の操作ディスパッチ時間(ミリ秒)。ディスパッチ時間とは、WebLogic Serverで呼出しを処理する時間を指します。測定期間は通常、WebLogic Serverが最初に起動されたときから始まります。

合計ディスパッチ時間(ミリ秒)

現在の測定期間内の全操作ディスパッチの合計時間(ミリ秒)。ディスパッチ時間とは、WebLogic Serverで呼出しを処理する時間を指します。測定期間は通常、WebLogic Serverが最初に起動されたときから始まります。

最長ディスパッチ時間

現在の測定期間における最長の操作ディスパッチ時間。ディスパッチ時間とは、WebLogic Serverで呼出しを処理する時間を指します。測定期間は通常、WebLogic Serverが最初に起動されたときから始まります。

最短ディスパッチ時間

現在の測定期間における最短の操作ディスパッチ時間。ディスパッチ時間とは、WebLogic Serverで呼出しを処理する時間を指します。測定期間は通常、WebLogic Serverが最初に起動されたときから始まります。

平均実行時間(ミリ秒)

平均の操作実行時間(ミリ秒)。

合計実行時間(ミリ秒)

すべての操作実行の合計時間(ミリ秒)。

最長実行時間

最長の操作実行時間。

最短実行時間

最短の操作実行時間。

レスポンス統計

Webサービス操作ページのレスポンス統計セクションには、次のレスポンス統計が表示されます。

要素

説明

レスポンス数

操作呼出しから生成されたレスポンスの合計数。

最終レスポンス時間

WebLogic Serverでこのクライアント/サービスに対するレスポンスが最後に到着した時刻(または、レスポンスが受信されていない場合は0)。UTC 1970年1月1日の深夜12時からのミリ秒数で表されます。

平均レスポンス時間(ミリ秒)

操作呼出しから生成されたレスポンスからの平均レスポンス時間(ミリ秒)。

合計レスポンス時間(ミリ秒)

操作呼出しから生成された全レスポンスの合計時間(ミリ秒)。

最長レスポンス時間

操作呼出しから生成されたレスポンスからの最長レスポンス時間。

最短レスポンス時間

操作呼出しから生成されたレスポンスからの最短レスポンス時間。

6.2.7 Java EE Webサービス・クライアントの統計の表示

Java EEアプリケーション内のランタイム・クライアント・インスタンスのWebサービス統計を表示する手順は、次のとおりです。

1. 「アプリケーションのWebサービスのサマリー・ページの表示」の説明に従って、Java EE Webサービスのサマリー・ページに移動します。

2. 「Java EE Webサービス・クライアント」タブを選択して、アプリケーション内でクライアントを表示します。

注意:

このタブは、アプリケーションにJava EE Webサービス・クライアントが含まれている場合のみ使用できます。

3. 「監視」タブが選択されていない場合はこのタブを選択して、アプリケーション内のすべてのランタイム・クライアント・インスタンスの統計を表示します。

注意:

JAX-WS Webサービスでは、Webサービス・ランタイムによってWebサービス・エンドポイント内にシステム定義のクライアント・インスタンスが作成されます。このインスタンスは、このエンドポイントに必要なプロトコル固有のメッセージを送信する際に使用されます。これらのクライアント・インスタンスには、クライアント・インスタンスが属するWebサービス・エンドポイントの名前に基づき、接尾辞が-SystemClientの名前が付けられます。システム定義のクライアント・インスタンスに関する監視情報を利用して、アプリケーションを評価できます。

4. 「クライアント」列内のクライアントを選択して、そのクライアントのWebサービス統計を表示します。

図6-5に示すような、「Java EE Webサービス・クライアント」ページが表示されます。

図6-5 Java EE Webサービス・クライアントの統計

ランタイム・クライアント・インスタンスについて、次のサマリー情報が表示されます。

- アプリケーション名: クライアントが関連付けられているアプリケーションの名前。

- モジュール名: エンドポイントで実行中のJava EEモジュールの名前。

- Webサービス・エンドポイント: クライアントが呼び出すポートの名前。

- トランスポート・プロトコル・タイプ: サービスが要求するトランスポート・プロトコル。

5. 「呼出し」タブを選択して、クライアントの呼出し統計を表示します。

ランタイム・クライアント・インスタンスについて表示される呼出し統計を、表6-1に示します。

表6-1 Java EE Webサービス・クライアントの呼出し統計

要素

説明

エラー

エラー数

セキュリティ・フォルトおよびセキュリティ違反の合計数。

レスポンス・エラー数

このクライアント・インスタンスの呼出しから生成されたレスポンスにおけるエラーの合計数。

呼出し統計

呼出し回数

現在の測定期間中にクライアント・インスタンスがサービス側の操作を呼び出した合計回数。

平均ディスパッチ時間(ミリ秒)

現在の測定期間における平均のディスパッチ時間。

合計ディスパッチ時間(ミリ秒)

現在の測定期間内の、この操作の全ディスパッチの合計時間。

平均実行時間(ミリ秒)

この操作の平均実行時間。

合計実行時間(ミリ秒)

この操作のすべての実行にかかる合計時間。

レスポンス統計

レスポンス数

この操作の呼出しから生成されたレスポンスの合計数。

平均レスポンス時間(ミリ秒)

この操作の呼出しから生成されたレスポンスの平均レスポンス時間。

合計レスポンス時間(ミリ秒)

この操作の呼出しから生成された全レスポンスの合計時間。

6. 「WebLogicポリシー違反」タブを選択して、このランタイム・クライアント・インスタンスのポリシー違反を表示します。

注意:

このタブが表示されるのは、Java EE Webサービス・クライアントにアタッチされているWebLogic Webサービス・ポリシーがある場合のみです。

表6-2は、ランタイム・クライアント・インスタンスについて表示されるポリシー違反を示します。

表6-2 Java EE Webサービス・クライアントのWebLogicポリシー違反

要素

説明

サマリー

フォルトの合計

失敗したリクエストの合計数。

ポリシー・フォルト

ポリシー・フォルトの合計数。

セキュリティ・フォルトの合計数

セキュリティ・フォルトおよびセキュリティ違反の合計数。

違反

認証違反

このポートに対して生成された認証違反の合計数。違反数には受信メッセージ処理のみ追加できます。

機密保持違反

このポートに対して生成された機密保持違反の合計数。違反数には送信および受信メッセージ処理を追加できます。

整合性違反

このポートに対して生成された整合性違反の合計数。違反数には送信および受信メッセージ処理を追加できます。

成功

認証の成功

このポートに対して検出された認証成功の合計数。成功数には受信メッセージ処理のみ追加できます。

機密性成功

このポートに対して生成された機密保持成功の合計数。成功数には送信および受信メッセージ処理を追加できます。

整合性成功

このポートに対して生成された整合性成功の合計数。成功数には送信および受信メッセージ処理を追加できます。

6.2.8 RESTful Resourcesの統計の表示

RESTful WebサービスのリソースのWebサービス統計を表示する手順は、次のとおりです。

1. 「アプリケーションのWebサービスのサマリー・ページの表示」の説明に従って、Webサービスのアプリケーション・サマリー・ページに移動します。

2. RESTfulサービスタブをクリックして、RESTfulアプリケーションを表示します。

注意:

このタブは、アプリケーションにRESTful Webサービスが含まれる場合のみ利用できます。

3. RESTfulリソースを表示するRESTfulアプリケーション名をクリックします。

4. RESTfulリソース・タブで、統計を表示したいリソースをクリックします。

表6-3は、提供されるサマリー情報を表示します。

表6-3 RESTfulリソースのサマリー

フィールド

説明

アプリケーション名

RESTfulサービスが関連付けられているアプリケーションの名前。

モジュール名

RESTfulアプリケーションが実行中のモジュールの名前。

RESTfulアプリケーション名

RESTfulアプリケーションの名前です。

リソース名

RESTfulリソースのURI。

リソース・タイプ

リソースのタイプ。

リソース・パス

リソースのパス。

メソッド数

メソッド数。

サブ・リソース・ロケータの数

サブ・リソース・ロケータの数。

呼出し回数

RESTfulサービスが起動された数。

平均実行時間(ミリ秒)

このメソッドの平均実行時間(ミリ秒)。

5. RESTfulメソッドタブに、メソッドの統計が表示されます。

表6-4に、各RESTfulメソッドの統計を示します。

表6-4 RESTfulリソースのサマリー統計

フィールド

説明

メソッド名

メソッドの名前です。

リクエストとメソッドの統計

メソッドおよびリクエスト・データをドリル・ダウンする眼鏡アイコン。

戻り型

メソッドの戻り型。

パス

メソッドのパス。

HTTPメソッド

メソッドがマップされているHTTPメソッド。

メディア・タイプの生成中

現在の測定期間内の、この操作の全ディスパッチの合計時間。

呼出し回数

RESTfulメソッドが起動された数。

平均実行時間(ミリ秒)

この操作の平均実行時間(ミリ秒)。

合計実行時間(ミリ秒)

このメソッドのすべての実行にかかる合計時間。

6. 「RESTfulメソッド」 タブで、「リクエストとメソッドの統計」列の眼鏡アイコンをクリックして、特定のRESTfulメソッドの次のリクエストおよびメソッドを参照します。

表6-5 RESTfulリソースのメソッドおよびリクエスト統計

フィールド

説明

平均リクエスト処理時間(ミリ秒)

平均リクエスト処理時間(単位はミリ秒)。

最大リクエスト処理時間(ミリ秒)

最大リクエスト処理時間(単位はミリ秒)。

最小リクエスト処理時間(ミリ秒)

最小リクエスト処理時間(単位はミリ秒)。

リクエストの合計数

処理の完了したリクエストの合計数。

合計リクエスト率(/ミリ秒)

リクエストの処理に必要な合計時間(/ミリ秒)。

7. 統計情報の表示を終了するには、「OK」をクリックします。

6.2.9 SOAバインディング・コンポーネントの統計の表示

SOAコンポジット・アプリケーションのサービス・バインディング・コンポーネントおよび参照バインディング・コンポーネント(インスタンス、フォルトおよび拒否メッセージを含む)を監視できます。詳細は、Oracle SOA SuiteおよびOracle Business Process Management Suiteの管理の次の各項を参照してください。

- サービス・バインディング・コンポーネントおよび参照バインディング・コンポーネントの監視

- SOAインフラストラクチャのサービスおよび参照バインディング・コンポーネントの監視

SOAバインディング・コンポーネントの統計を表示するには:

1. 「SOAコンポジットのWebサービスと参照の表示」の説明に従って、SOAコンポジット・アプリケーションに移動します。

2. 「サービスと参照」セクションで、特定のサービスまたは参照を選択します。

JCAアダプタ、WebサービスまたはRESTサービスであるサービス・バインディング・コンポーネントを選択した場合、「ダッシュボード」ページには、図6-6に示すように、サーバー起動後の受信メッセージとフォルトの合計数がグラフで表示されます。

図6-6 SOAバインディング・コンポーネントの統計

6.2.10 Webサービスのセキュリティ違反の表示の概要

Webサービスのセキュリティ違反を表示するには、次にリストされている手順に従ってください。

- Oracle Infrastructure Webサービスのセキュリティ違反の表示

- Java EE JAX-WS Webサービスのセキュリティ違反の表示

- Java EE JAX-RPC Webサービスのセキュリティ違反の表示

6.2.10.1 Oracle Infrastructure Webサービスのセキュリティ違反の表示

Oracle Infrastructure Webサービスのセキュリティ違反を表示するには:

1. 「アプリケーションのWebサービスのサマリー・ページの表示」で説明されているように、「Webサービス・のサマリー」ページに移動します。

2. ページの「グラフ」 セクションで、「セキュリティ違反」タブを選択します。

アプリケーションのすべてのWebサービスに関する認証、認可、機密保護および整合性のフォルトが円グラフで表示されます。

3. ページの「Webサービスの詳細」セクションで、まだ表示されていない場合は、Webサービス・エンドポイントを表示するWebサービスを表示します。

4. エンドポイント名をクリックして「Webサービス・エンドポイント」ページに移動します。

5. 「グラフ」タブをクリックして、エンドポイントのすべてのフォルトおよびすべてのセキュリティ違反のグラフ表示を参照します。

6. 「OWSMポリシー」タブをクリックします。

次の2つの表が表示されます。

「グローバルに添付されたポリシー」表には、ポリシーの名前およびそれを参照するポリシー・セットが表示されます。

「直接添付されたポリシー」表には、ポリシーの名前およびポリシーのステータス(ポリシーが有効または無効)が表示されます。

どちらの表にも、ポリシーが属するカテゴリ(「セキュリティ」、「MTOMアタッチメント」、「信頼できるメッセージング」、「WSアドレス」および「管理」)が示されます。

各タイプのポリシー添付について表示される違反情報を、表6-6に示します。

表6-6 エンドポイントのポリシー違反情報

違反タイプ

説明

合計違反

ポリシーに対するフォルトの合計数。

注意: 合計違反は、次に示されているセキュリティ違反(たとえば、認証、認可、機密保護、完全性)の合計に等しくない可能性があります。合計違反数には、これらの主要なカテゴリに属さない他のセキュリティ違反およびセキュリティ以外の違反も含まれています。

セキュリティ違反

認証

サーバーが再起動してから認証が失敗した回数。

認可

サーバーが再起動してから認可が失敗した回数。

機密保護

サーバーが再起動してから秘密保護に失敗したメッセージの数。

完全性

サーバーが再起動してから整合性がとれなかったメッセージの数。

6.2.10.2 Java EE JAX-WS Webサービスのセキュリティ違反の表示

Java EE JAX-WS Webサービスのセキュリティ違反を表示するには:

1. 「アプリケーションのWebサービスのサマリー・ページの表示」で説明されているように、「Webサービス・のサマリー」ページに移動します。

2. ページの「Webサービスの詳細」セクションで、まだ表示されていない場合は、Webサービス・エンドポイントを表示するWebサービスを表示します。

3. エンドポイント名をクリックして「Webサービス・エンドポイント」ページに移動します。

4. エンドポイントに添付されているポリシーのタイプに応じて、次のいずれかの操作を行います。

- OWSMポリシーがエンドポイントに添付されている場合は、「OWSMポリシー」タブをクリックします。
エンドポイントに添付されているポリシーのリストが表示されます。ポリシーごとに、表にはポリシーの名前、ポリシーのカテゴリ(「セキュリティ」、「MTOMアタッチメント」、「信頼できるメッセージング」、「WSアドレス」および「管理」)、およびポリシーのステータス(ポリシーが有効または無効)が表示されます。表6-6は、エンドポイントに添付された各OWSMポリシーについて表示される違反情報を説明しています。

- WebLogicポリシーがエンドポイントに添付されている場合は、「WebLogicポリシー違反」タブをクリックします。
このタブには、JAX-WSエンドポイントに添付されたWebLogicポリシーについて、ポリシー違反の詳細が表示されます。表6-7は、このページに表示される情報を説明しています。

表6-7 WebLogicポリシー違反データ

要素

説明

サマリー

フォルトの合計

失敗したリクエストの合計数。

ポリシー・フォルト

ポリシーが正常に実行されなかったため失敗したリクエストの数。

合計違反

ポリシーに対するフォルトの合計数。

違反

認証違反

サーバーが再起動してから認証が失敗した回数。

機密保持違反

サーバーが再起動してから秘密保護に失敗したメッセージの数。

整合性違反

サーバーが再起動してから整合性がとれなかったメッセージの数。

成功

認証の成功

サーバーが再起動してから認証が成功した回数。

機密性成功

サーバーが再起動してから機密保護に成功したメッセージの数。

整合性成功

サーバーが再起動してから整合性がとれたメッセージの数。

6.2.10.3 Java EE JAX-RPC Webサービスのセキュリティ違反の表示

Java EE JAX-RPC Webサービスのセキュリティ違反を表示するには:

1. アプリケーションの「Webサービスのサマリー」ページに移動します。

2. ページの「Webサービスの詳細」セクションで、まだ表示されていない場合は、Webサービス・エンドポイントを表示するWebサービスを表示します。

3. エンドポイント名をクリックして「Webサービス・エンドポイント」ページに移動します。

4. 「WebLogicポリシー違反」タブをクリックします。

図6-7に示すように、このタブには、JAX-RPCエンドポイントに添付されたWebLogicポリシーについて、ポリシー違反の詳細が表示されます。このタブに表示される情報の詳細は、表6-7を参照してください。

図6-7 Java EE JAX-RPC Webサービス・エンドポイントのセキュリティ違反

6.3 Webサービスの監査

監査は、セキュリティ・イベントおよびそれらのイベントの結果に関する情報の収集および格納のプロセスを説明します。監査では、選択したシステムのアクティビティに関する電子的証跡が提供されます。

監査ポリシーでは、実行時に取得されるイベントのタイプおよびスコープが定義されます。操作中は非常に大きなシステムおよびユーザー・イベントの配列が発生しますが、実際に監査されるイベントは、実行時に有効な監査ポリシーによって異なります。コンポーネント固有またはアプリケーション固有のポリシーを定義するか、個々のユーザーを監査できます。

「監査ポリシー」ページを使用して、Webサービスおよびドメイン・レベルのアプリケーションなどの、システム・コンポーネントの監査を構成できます。SOAおよびADFサービスを監査できます。

次の表は、Webサービスおよび関連するコンポーネントで監査できるイベントをまとめたものです。

表6-8 Webサービスのイベントの監査

監査を有効にするWebサービスのイベント

使用するシステム・コンポーネント

- ユーザー認証。

- ユーザー認可。

- メッセージ機密保護、メッセージ整合性およびセキュリティ・ポリシーを含むポリシー強制。

OWSM—エージェント

詳細は、「OWSM-AGENTのイベントと属性」を参照してください。

- Webサービス・リクエストの送信と、レスポンスの受信。

- SOAPフォルトの発生。

注意: この場合、セキュリティと非セキュリティ両方のWebサービス起動のイベントがログに記録されます。

Oracle Webサービス

詳細は、「Oracle Webサービスのイベントと属性」を参照してください。

- OWSMアサーション・テンプレートの作成、削除または変更。

- OWSMポリシー・インテントの作成、削除または変更。

- OWSMポリシーの作成、削除または変更。

- OWSMポリシー・セットのオーサリング作成、削除または変更。

OWSM—ポリシー・マネージャ

注意: ポリシー・マネージャは、ローカル・ポリシー添付とポリシー・セットのグローバル・ポリシー添付の両方を監査します。

詳細は、「OWSM-PM-EJBのイベントと属性」を参照してください。

- OWSMポリシー・アタッチメント。

OWSM—ポリシー・アタッチメント

注意: ポリシー添付は、ローカル・ポリシー添付のみを監査します。

詳細は、「Webサービス・ポリシー・アタッチメントのイベントと属性」を参照してください。

また、管理者によるすべてのイベントを監査するなど、特定ユーザーのイベントを監査できます。

監査ポリシーの構成に関する詳細は、『Oracle Platform Security Servicesによるアプリケーションの保護』の「監査の構成および管理」を参照してください。

次の項では、監査ポリシーを定義し監査データを表示する方法を説明します。

- 監査ポリシーの構成

- 監査データの収集および格納の管理

- 監査レポートの表示

6.3.1 監査ポリシーの構成

この項の手順に従って監査ポリシーを構成します。詳細は、『Oracle Platform Security Servicesによるアプリケーションの保護』の「Fusion Middleware ControlによるJavaコンポーネントの監査ポリシーの管理」を参照してください。

1. 「WebLogicドメイン」メニューから、「セキュリティ」→「監査ポリシー」を選択します。

「監査ポリシー設定」ページが表示されます。

ページ中央の監査ポリシーの表には、現在有効な監査が表示されます。

2. 「監査コンポーネント名」メニューから監査したいコンポーネントを選択します。

3. 「監査レベル」メニューから監査レベルを選択します。

有効な監査レベルは次のとおりです。

- なし: 監査を無効にします。

- 低、中、高: 監査の事前定義済レベルを表すイベント・カテゴリのサブセットを監査します。

- カスタム: カスタム監査ポリシーを使用できるようになります。

監査ポリシー・リストの各レベルで、監査に対して選択したコンポーネントおよびアプリケーションを表示できます。「カスタム」以外のすべての監査レベルで、監査ポリシー・リストの情報はグレーで表示され、他の監査レベル設定はカスタマイズできなくなっています。

4. 監査ポリシーをカスタマイズするには、カスタム・オプションを選択して、次の手順のうちの1つを実行します。

- 「監査の選択」列で、関連するチェック・ボックスを選択して、監査する情報を選択します。
コンポーネントのすべてのイベント、コンポーネント・イベント・カテゴリ内のすべてのイベント、個々のイベント、または個々のイベントの特定の結果(成功または失敗など)などの粒度のレベルで監査できます。

すべてを選択をクリックするとすべてのカテゴリが選択され、Noneをクリックするとすべてのカテゴリの選択が外れ、すべてのイベントを監査をクリックするとすべてのイベントが監査され、個別のイベント(成功および失敗など)の特定の結果が含まれます。

イベントの結果レベルで編集フィルタを指定できます。フィルタはルールベースの式で、戻りイベントを制御するように定義できます。たとえば、ポリシーが特定のユーザーによって作成、変更または削除された場合に、ポリシー管理操作を追跡するフィルタとしてイニシエータを指定できます。結果レベルでフィルタを定義するには、適切な列で「フィルタの編集」アイコンをクリックし、フィルタ属性を指定して「OK」をクリックします。フィルタ定義は「フィルタ」列に表示されます。

サブコンポーネントの監査をカスタマイズするには、より高いレベルのコンポーネントのチェック・ボックスを選択解除します。列名に隣接するチェック・ボックスを選択して、すべてのコンポーネントとアプリケーションを選択できます。

- イベントの結果レベルで編集フィルタを指定できます。フィルタはルールベースの式で、戻りイベントを制御するように定義できます。たとえば、ポリシーが特定のユーザーによって作成、変更または削除された場合に、ポリシー管理操作を追跡するフィルタとしてイニシエータを指定できます。結果レベルでフィルタを定義するには、適切な列で「フィルタの編集」アイコンをクリックし、フィルタ属性を指定して「OK」をクリックします。フィルタ定義は「フィルタ」列に表示されます。

- すべてのシステム・コンポーネントおよびアプリケーションの成功または障害のみを監査するには、成功のみ選択または障害のみ選択を使用します。すべての選択を消去する場合は、Noneを選択します。

5. 必要に応じて、Users to Always Auditのテキスト・ボックスに、ユーザーをカンマで区切って入力します。

指定されたユーザーは、監査が有効または無効にされているか、またはどのレベルの監査が設定されているかにかかわらず常に監査されます。

6. 「適用」をクリックします。

現在のセッション中に行ったすべての変更を戻すには、「元に戻す」をクリックします。

6.3.2 監査データの収集および格納の管理

監査情報のデータの収集および格納を管理するには、次のタスクを実行する必要があります。

- 監査データ・リポジトリの設定および管理。
ファイルまたはデータベースのいずれかのリポジトリ・モードを使用して、レコードを格納できます。データベース・リポジトリ・モードの使用をお薦めします。Oracle Business Intelligence Publisherベースの監査レポートは、データベース・リポジトリ・モードでのみ機能します。

- 監査イベント収集の設定。

詳細は、『Oracle Platform Security Servicesによるアプリケーションの保護』のAudit Data Storeの管理に関する項を参照してください。

6.3.3 監査レポートの表示

データベース・リポジトリの場合、データはOracle Business Intelligence Publisherで事前定義されたレポートを介して公開されます。

認証および認可の履歴、OWSMポリシー強制および管理など、多くの事前定義済レポートを使用できます。Oracle Business Intelligence Publisherを使用した監査報告の作成および表示に関する詳細は、『Oracle Platform Security Servicesによるアプリケーションの保護』の「監査分析の使用および報告」を参照してください。

ファイルベース・リポジトリの場合、テキスト・エディタを使用してバスストップ・ファイルを表示し、独自のカスタム問合せを作成できます。

7 診断ログおよびメッセージ・ログの管理

この章では、診断ログとメッセージ・ログを管理および構成する方法について説明します。Webサービスを含むOracle Fusion Middlewareコンポーネントは、起動情報と停止情報、エラー、警告メッセージ、HTTPリクエストのアクセス情報など、すべてのタイプのイベントを記録するメッセージを含むログ・ファイルを生成します。各ログ・メッセージには、時間、コンポーネントID、および発生する問題の検出と診断を支援するユーザーなどの特定の情報が含まれます。

この章の内容は次のとおりです。

- ログを使用した問題の診断の概要

- Webサービスのログ・ファイルの構成

7.1 ログを使用した問題の診断の概要

ログ・メッセージを確認し、Webサービスなど特定のコンポーネントでの問題を診断できます。ログ・ファイルには2つのカテゴリがあり、Webサービスに関する問題の診断に役立てるために参照できます。

- 診断ログ: Oracle Fusion Middlewareの特定の機能コンポーネントに関する診断データにアクセスできます。詳細は、「Webサービス診断ログの概要」を参照してください。
事前定義済診断ログ出力のセットがあります。「Webサービス・ログ・ファイルの構成」の説明に従って、独自の診断ログ出力を構成できます。

- メッセージ・ログ: SOAPメッセージ・リクエストの要素を表示できます。ポリシーを使用してメッセージ・ログの作成を制御します。詳細は、「Webサービス・メッセージ・ログの概要」を参照してください。

Oracle Fusion Middlewareのロギングの詳細は、『Oracle Fusion Middlewareの管理』の「ログ・ファイルおよび診断データの管理」を参照してください。

次の項では、問題を診断するための、診断およびメッセージ・ログの使用方法を説明します。この項の最後にサンプル・ログのセットがあります。

- Webサービス診断ログの概要

- Webサービス・メッセージ・ログの概要

- サンプル・ログ

7.1.1 Webサービス診断ログの概要

診断ログを使用して、Oracle Fusion Middlewareの特定の機能コンポーネントに関する診断データにアクセスできます。

次の項では、診断ログ・ファイルの表示方法および管理方法を説明します。

- 診断ログのログ・レベルの設定

- 診断ログの表示

- 診断ログのフィルタ処理

- OWSMデバッグ・メッセージのロギング

7.1.1.1 診断ログのログ・レベルの設定

「ログ構成」ページを使用して、WebLogic ServerレベルでWebサービスおよびOWSMのコンポーネントのロギング・レベルを設定します。

また、「Webサービス・エンドポイント」ページから、特定のWebサービス・エンドポイントのサーバー・レベルで設定されたログ・レベルをオーバーライドできます。Webサービス・エンドポイント・レベルで設定されたロギング・レベルは、WebLogic Serverレベルで設定されたレベルよりも詳細なレベルである必要があります。詳細でない場合は、WebLogic Serverレベルで設定されたロギング・レベルが使用されます。

次の手順では、WebLogic ServerおよびWebサービス・エンドポイント・レベルで診断ログのログ・レベルを設定する方法を説明します。詳細は、『Oracle Fusion Middlewareの管理』の「ログ・ファイルに書かれた情報のレベルの設定」を参照してください。

WebLogic Serverレベルで診断ログのログ・レベルを設定する手順

1. ログ出力を構成するWebLogic Serverに移動します。

a. ナビゲーション・ペインで「WebLogicドメイン」を開きます。

b. ドメインを開きます。

c. リストから必要なサーバーを選択します。
「WebLogicサーバー」ホームページが表示されます。

2. 「WebLogic Server」メニューで、「ログ」→「ログ構成」を選択します。
「ログ構成」ページが表示されます。

3. 「ログ・レベル」タブを選択します。
図7-1に示すように、ログ出力のリストが表示されます。

「ログ・レベル」ページには、ログ出力の名前、現在のロギング・レベル、編集可能なもの、および関連するログ・ファイル(たとえば、olh-handler)が表示されます。ログ・ファイルの構成の詳細は、「Webサービスのログ・ファイルの構成」を参照してください。

図7-1 「ログ・レベル」ページ

4. 「ルート・ログ出力」を開きます。

5. 「Oracle」を開きます。

6. 次の1つ以上のコンポーネントのロギング・レベルを設定します。

- oracle.webservices—Webサービス・コンポーネント。

- oracle.wsm—OWSMコンポーネント。

前述のコンポーネントのいずれかを開いてサブコンポーネント・レベルでロギング・レベルを指定することで、ロギング・レベルを微調整できます。

ログ出力のロギング・レベルを変更するには、「ログ出力名」列のログ出力に移動し、「Oracle Diagnostic Loggingレベル(Javaレベル)」ドロップダウン・メニューから目的のロギング・レベルを選択します。

たとえば、ログ出力oracle.wsmに関連するドロップダウン・メニューから「TRACE:32」を選択します。

デフォルトでは、ロギング・レベルはその親から継承され、WebサービスおよびOWSMのコンポーネントとサブコンポーネントに対してNOTIFICATION: 1 (INFO)に設定されます。

7. 「適用」をクリックして、新しいロギング・レベルを保存します。

Webサービス・エンドポイント・レベルで診断ログのログ・レベルを設定するには:

1. Fusion Middleware Controlを使用したWebサービス・エンドポイントの詳細の表示の概要で説明されているように、「Webサービス・エンドポイント」ページに移動します。

2. 「構成」タブをクリックします。

3. 「ロギング・レベル」フィールドに、「重度」、「警告」、「情報」、「構成」、「密」、「詳細」、「最も詳細」または「NULL」のいずれかを設定します。

7.1.1.2 診断ログの表示

「ログ・メッセージ」ページから、ADF Webサービス・エンドポイントの診断ログ・ファイルを表示できます。

Webサービス・エンドポイントの診断ログを表示するには:

「Fusion Middleware Controlを使用したWebサービス・クライアントの表示の概要」の説明に従って、「Webサービス・エンドポイント」ページに移動し、「Webサービス・エンドポイント」ページの「クイックリンク」セクション(右上)で「診断ログ」をクリックします。

注意:

アプリケーションのWebサービスで生じたすべての障害のサマリーを表示できます。詳細は、Webサービスの監視の概要を参照してください。

次の図に示すように、「ログ・メッセージ」ページが表示されます。

図7-2 「ログ・メッセージ」ページ

メッセージ領域のメッセージをクリックすると、ページの下部に詳細が表示されます。必要に応じて、リスト上のメッセージを選択して「メッセージをファイルにエクスポート」をクリックすることで、メッセージをテキスト、XMLまたはCSVファイルにエクスポートできます。

次のコントロールを使用して、表示されるメッセージ・コンテンツを制御できます。

- 検索: 検索条件を変更します。詳細は、「診断ログのフィルタ処理」を参照してください。

- 「表示」メニュー: 表で表示する列を選択します。特定の列をクリックすると、コンテンツが昇順または降順にソートされます。

- 「表示」メニュー: メッセージをタイプまたはID別にグループ化したり、年代順にメッセージを表示します。

- 関連メッセージの表示: リストで選択したメッセージに関連するメッセージを表示します。

- —表示されるメッセージのスコープを拡大します。ドメイン、クラスタ、アプリケーション・デプロイメント、またはWebLogicサーバーのすべてのメッセージが含まれるようにスコープを拡大可能です。

- 「リフレッシュ」メニュー: 自動または手動リフレッシュ率を指定します。

生成されたログ・ファイルのコンテンツを表示する手順は次のとおりです。

- メッセージに関連付けられたログ・ファイルのアイコンをクリックし、そのログ・ファイルのコンテンツを表示します。

- 「ターゲット・ログ・ファイル」をクリックし、「ログ・ファイル」ページを表示して、生成されたログ・ファイルすべてのコンテンツを表示またはダウンロードします。

詳細は、『Oracle Fusion Middlewareの管理』の"ログ・ファイルの表示と検索に関する項"を参照してください。

7.1.1.3 診断ログのフィルタ処理

デフォルトでは、「ログ・メッセージ」ページには、過去1時間に記録された診断メッセージのサマリーが表示されます。

診断ログをフィルタ処理する手順

1. 次のフィールドを使用して検索条件を更新して、表示されるメッセージをフィルタ処理します。

- 日付範囲: 日付範囲を次のいずれかに設定します。

- 最新: 期間を定義する時間を設定します。

- 時間間隔: 間隔を定義する開始日と終了日を設定します。

- メッセージ・タイプ: 表示するメッセージ・タイプを選択します。

- フィールドの追加: メッセージID、コンポーネントなどの他のメッセージ・フィールドを検索条件に追加します。

2. フィールドを設定したら、必要に応じて「検索」をクリックします。

メッセージ領域は、フィルタ処理された結果で更新されます。

詳細は、『Oracle Fusion Middlewareの管理』の"ログ・ファイルの表示と検索に関する項"を参照してください。

7.1.1.4 OWSMデバッグ・メッセージのロギング

OWSMをデバッグするには、WebLogic Serverの起動時に、必要に応じて次のいずれかのプロパティを渡します。詳細は、『Oracle WebLogic Serverサーバーの起動と停止の管理』のサーバーの起動と停止に関する項を参照してください。

注意:

1つ以上のプロパティを有効にすると、非常に大きなメッセージの場合、パフォーマンスに悪影響を及ぼす可能性があります。有効化されると、OWSMによって一時バッファが作成され、Javaガベージ・コレクタに余分な負荷がかかります。

表7-1 OWSMデバッグ・メッセージのロギングの起動プロパティ

起動プロパティ

説明

-Dxml.debug.verify=true

署名検証の失敗時に生成される一連のバイトを記録します。ログ・レベルが少なくともERRORに設定されている場合、検証エラーはstderrおよび診断ログに出力されます。

-Dxml.debug.digest=true

署名生成の正規化および署名検証の一致の際に生成される一連のバイトを記録します。ログ・レベルが少なくともFINEに設定されている場合、検証エラーはstderrおよび診断ログに出力されます。

-Dxml.debug.decrypt

復号化の失敗の後、XML解析の前に生成される一連のバイトを記録します。検証エラーはstderrおよび診断ログ・ファイルに出力されます。

7.1.2 Webサービス・メッセージ・ログの概要

メッセージ・ログを使用して、ADF Webサービスとクライアントに対する、SOAPメッセージ・リクエストとレスポンスのコンテンツにアクセスできます。デフォルトでは、メッセージ・ログは診断メッセージとは別のログ・ファイルに格納されます。

次の項では、メッセージ・ログ・ファイルの表示方法および管理方法を説明します。

- メッセージ・ログの構成

- メッセージ・ログの表示

- メッセージ・ログのフィルタ処理

7.1.2.1 メッセージ・ログの構成

Webサービスまたはクライアントのメッセージ・ログは、次のいずれかの方法で構成します。

- ロギング・アサーションを含むポリシーをWebサービスまたはクライアントに添付します。
oracle/security_log_templateという1つの事前定義済ロギング・アサーション・テンプレートがあります。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のoracle/security_log_templateに関する項を参照してください。このテンプレートは、WebサービスのリクエストとレスポンスのSOAPメッセージ全体をログ出力するように構成されています。デフォルトでは、すべての事前定義済Webサービス・セキュリティ・ポリシーで、最初のセキュリティ・アサーションが実行される前後にSOAPメッセージ全体を取得するために、このロギング・アサーションが使用されます。デフォルトでは、ロギング・アサーションは実行されません。SOAPメッセージをメッセージ・ログに記録するには、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のポリシー内のアサーションの有効化または無効化に関する項の説明に従って、ロギング・アサーションを有効にする必要があります。ロギング・アサーションは、デバッグおよび監査目的でのみ有効化することをお薦めします。

- oracle/log_policyポリシーをWebサービスまたはクライアントに添付します。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のoracle/log_policyに関する項を参照してください。

- 独自のロギング・ポリシーまたはアサーション・テンプレートを作成して、Webサービスのリクエストとレスポンスに関して記録されるSOAPメッセージの要素を絞り込みます。
たとえば、リクエスト・メッセージのSOAP本文のみを表示できます。新規ポリシーを作成するには、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のWebサービス・ポリシーの新規作成に関する項で説明されている手順に従ってください。oracle/security_log_templateアサーション・テンプレートのコピーを作成して、新規ポリシーで使用できるように構成できます。新規アサーション・テンプレートの作成の詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のアサーション・テンプレートのクローン作成に関する項を参照してください。

7.1.2.2 メッセージ・ログの表示

「ログ・メッセージ」ページから、ADF Webサービス・エンドポイントのメッセージ・ログ・ファイルを表示できます。

Webサービス・エンドポイントのメッセージ・ログを表示するには:

「Fusion Middleware Controlを使用したWebサービス・クライアントの表示の概要」の説明に従って、「Webサービス・エンドポイント」ページに移動し、「Webサービス・エンドポイント」ページの「クイックリンク」セクション(右上)で「メッセージ・ログ」をクリックします。

図7-2のような「ログ・メッセージ」ページが表示されます。「ログ・メッセージ」ページのコンテンツの詳細は、「診断ログの表示」を参照してください。

7.1.2.3 メッセージ・ログのフィルタ処理

デフォルトでは、「ログ・メッセージ」ページには、過去1時間に記録されたSOAPメッセージのサマリーが表示されます。検索条件を更新することで、表示されるメッセージをフィルタ処理できます。プロセスは診断ログのプロセスと同じです。詳細は、「診断ログのフィルタ処理」を参照してください。

デフォルトでは、「コンポーネント」および「モジュール」メッセージ・フィールドは、メッセージ・ログの検索条件の一部に含まれます。「コンポーネント」フィールドは、WebLogic Server名に設定されます。「モジュール」フィールドは、メッセージ・ロギング・コンポーネント名のoracle.wsm.msg.loggingに設定されます。

7.1.3 サンプル・ログ

次の項に、ログ・エントリを使用して特定の問題を診断する方法を実演する、サンプル・ログからの抜粋を示します。

- サンプル・ログ: OWSM Policy Manager使用不可

- サンプル・ログ: セキュリティ・キーストア未構成

- サンプル・ログ: 証明書使用不可

7.1.3.1 サンプル・ログ: OWSM Policy Manager使用不可

次のサンプル・ログの抜粋は、OWSM Policy Managerが停止していることを示します。この問題を解決するためには、『Oracle Fusion Middlewareの管理』のアプリケーションの起動と停止に関する項で説明されているように、wsm-pmアプリケーションを再起動します。

2009-02-16 16:21:28,029 [[ACTIVE] ExecuteThread: '4' for queue:
'weblogic.kernel.Default (self-tuning)']
ERROR policymgr.PolicyManagerModelBean logp.251 -
Service lookup failed with URL:t3://host.example.com:7001/wsm-pm
oracle.wsm.policymanager.PolicyManagerException: WSM-02118 :
The query service cannot be created.
...

7.1.3.2 サンプル・ログ: セキュリティ・キーストア未構成

次のサンプル・ログの抜粋は、メッセージ保護されているOWSMセキュリティ・ポリシーが適用されていて、キーストアが構成されていないことを示します。このセキュリティ・フォルトを解決するためには、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のメッセージ保護のためのキーストアの構成に関する項 で説明されているように、キーストアを構成します。

Feb 16, 2009 5:29:56 PM oracle.wsm.common.logging.WsmMessageLogger logSevere
SEVERE: The specified Keystore file /scratch/sbollapa/stage131/user_projects/domains/sai131_domain/config/fmwconfig/default-keystore.jks
cannot be found; it either does not exist or its path is not included in the
application classpath.
Feb 16, 2009 5:29:56 PM oracle.wsm.common.logging.WsmMessageLogger logSevere
SEVERE: Keystore is not properly configured in jps config.
Feb 16, 2009 5:29:56 PM oracle.wsm.common.logging.WsmLogUtil log
SEVERE: failure in OWSM Agent processRequest, category=security,
function=agent.function.client, application=default, composite=pe3test3,
modelObj=Service1, + policy=null, policyVersion=null, assertionName=null
oracle.wsm.common.sdk.WSMException: WSM-00101 : The specified Keystore file
/scratch/sbollapa/stage131/user_projects/domains/sai131_domain/config/fmwconfig/default-keystore.jks cannot be found;
it either does not exist or its path is not included in the application classpath.
...

7.1.3.3 サンプル・ログ: 証明書使用不可

次のサンプル・ログの抜粋は、メッセージ保護されているOWSMセキュリティ・ポリシーが適用されていて、キーストアで使用できないセキュリティ証明書が必要なことを示します。このセキュリティ・フォルトを解決するためには、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』の信頼できる証明書の入手およびキーストアへのインポートに関する項で説明されているように、証明書付きキーストアを構成します。

[2009-04-15T04:07:02.821-07:00] [jrfServer] [ERROR] [WSM-000062]
[oracle.wsm.resources.security] [tid: [ACTIVE].ExecuteThread: '0' for
queue: 'weblogic.kernel.Default (self-tuning)'] [userId: <anonymous>]
[ecid: 0000I2dTFG7DScT6uBe9UH19tRyv000000,0:1] [WEBSERVICE_PORT.name:
NonCAAsCAMessageProtectionPolicyPort] [APP: jaxwsservices]
[J2EE_MODULE.name: NonCAAsCAMessageProtectionPolicy] [WEBSERVICE.name:
NonCAAsCAMessageProtectionPolicyService] [J2EE_APP.name: jaxwsservices]
[arg: oracle.wsm.security.SecurityException: WSM-00062 :
The path to the certificate used for the signature is invalid.]

[2009-04-15T04:07:02.810-07:00] [jrfServer] [NOTIFICATION] []
[oracle.wsm.security.policy.scenario.processor.Wss11X509TokenProcessor]
[tid: [ACTIVE].ExecuteThread: '0' for queue: 'weblogic.kernel.Default
(self-tuning)'] [userId: <anonymous>]
[ecid: 0000I2dTFG7DScT6uBe9UH19tRyv000000,0:1]
[WEBSERVICE_PORT.name: NonCAAsCAMessageProtectionPolicyPort]
[APP: jaxwsservices] [J2EE_MODULE.name: NonCAAsCAMessageProtectionPolicy]
[WEBSERVICE.name: NonCAAsCAMessageProtectionPolicyService] [J2EE_APP.name:
jaxwsservices] Certificate path validation failed for signing certificate

[2009-04-15T04:07:02.821-07:00] [jrfServer] [ERROR] [WSM-00006]
[oracle.wsm.resources.security] [tid: [ACTIVE].ExecuteThread: '0' for queue:
'weblogic.kernel.Default (self-tuning)'] [userId: <anonymous>]
[ecid: 0000I2dTFG7DScT6uBe9UH19tRyv000000,0:1] [WEBSERVICE_PORT.name:
NonCAAsCAMessageProtectionPolicyPort] [APP: jaxwsservices]
[J2EE_MODULE.name: NonCAAsCAMessageProtectionPolicy] [WEBSERVICE.name:
NonCAAsCAMessageProtectionPolicyService] [J2EE_APP.name: jaxwsservices]
[arg: oracle.wsm.security.SecurityException: WSM-00062 : The path to the
certificate used for the signature is invalid.] Error in receiving the request:
oracle.wsm.security.SecurityException: WSM-00062 : The path to the certificate
used for the signature is invalid.

7.2 Webサービスのログ・ファイルの構成

ロギング・データをより詳細に編成するには、Webサービスのログ・ファイルを構成します。SOAおよびADFサービスのログ・ファイルを構成できます。

次の表では、OWSMに関連するデフォルトのログ・ファイルが定義されています。

表7-2 OWSMのデフォルトのログ・ファイル

デフォルト・ログ・ファイル

説明

odl-handler

サーバーのJava EEコンポーネントの一般的な診断データを記録します。

owsm-message-handler

SOAPメッセージをOWSMロギング・ポリシーにより記録します。

次の手順では、WebLogic ServerおよびWebサービス・エンドポイント・レベルで診断ログのログ・レベルを設定する方法を説明します。

Fusion Middleware ControlまたはWLSTを使用したログ・レベルの設定に関する詳細は、『Oracle Fusion Middlewareの管理』の「ログ・ファイルに書かれた情報のレベルの設定」を参照してください。

Webサービスのログ・ファイルを構成するには:

1. ログ出力を構成するWebLogic Serverに移動します。

a. ナビゲーション・ペインで「WebLogicドメイン」を開いてドメイン名を表示します。

b. ドメインを開いてサーバーのリストを表示します。

c. リストから必要なサーバーを選択します。
「WebLogicサーバー」ホームページが表示されます。

2. 「WebLogic Server」メニューで、「ログ」→「ログ構成」を選択します。
「ログ構成」ページが表示されます。

3. 「ログ・ファイル」タブを選択します。
ログ・ファイルの最新リストが表示されます。「ログ構成」ページには、現在構成されているログ・パス、ファイル形式およびローテーション・ポリシーが表示されます。

4. ログ・ポリシー構成を編集する場合は、リスト内のログ・ファイルを選択し、「構成の編集 . . .」をクリックします。
「ログ・ファイルの編集」ページが表示されます。

図7-3 「ログ・ファイルの編集」ページ

5. 必要に応じて、ログ・ファイル情報を編集します。

表7-3 「ログ・ファイルの編集」ページのフィールド

フィールド

説明

ログ・パス

ログ・ファイルのパス。このフィールドは必須です。

ログ・ファイル形式

ログ・ファイルの形式。有効な値はテキストまたはXMLです。

ログ・レベル

ログ出力のデフォルトのログ・レベル。リストからログ・レベルを選択します。有効な値は次のとおりです。

- INCIDENT_ERROR:1 (SEVERE+100)

- ERROR:1 (SEVERE)

- WARNING:1 (WARNING)

- NOTIFICATION:1 (INFO)

- NOTIFICATION:16 (CONFIG)

- TRACE:1 (FINE)

- TRACE:16 (FINER)

- TRACE:32 (FINEST)

デフォルト属性の使用

ログ出力にデフォルト属性を使用するかどうかを指定するフラグ。

サプリメンタル属性

サプリメンタル属性は必須です。

関連付けるログ出力

ログ出力に関連付けるコンポーネント。

ローテーション・ポリシー

期間によるファイル・サイズに基づいて、ログ・ファイルをローテーションするかどうか指定します。詳細は、『Oracle Fusion Middlewareの管理』のログ・ファイルのローテーションの構成に関する項を参照してください。

ローテーション・ポリシーとして「サイズ・ベース」が選択されている場合、「最大ログ・ファイル・サイズ」は必須フィールドです。ローテーション・ポリシーとして「時間ベース」が選択されている場合、「頻度」は必須フィールドです。

6. 「OK」をクリックして、ログ・ファイルの構成を編集します。

8 環境間のアプリケーション移行の管理

この章では、開発環境またはテスト環境から本番環境へなど、環境間でWebサービス・アプリケーションを移行する方法について説明します。内容は次のとおりです。

この章の内容は次のとおりです。

- Webサービス・アプリケーション移行の概要

- ポリシーの作成と異なるステージでの水平移行

- ポリシーの移行

- ポリシー構成の移行の概要

- アサーション・テンプレートの移行

テスト環境から本番環境に移動する方法の詳細は、『Oracle Fusion Middlewareの管理』のテストから本番環境への移動に関する項を参照してください。

8.1 Webサービス・アプリケーション移行の概要

この項には次のトピックが含まれます:

- Webサービス・アプリケーション移行の概要

- 開発またはテスト環境から本番環境へのWebサービス・アプリケーションの移行

8.1.1 Webサービス・アプリケーション移行の概要

Webサービス・アプリケーションを、環境間で(たとえばテスト環境から本番環境など)またはスケーリングされたクラスタ環境に個別に移行するには、アプリケーションをデプロイできるようにポリシーとデプロイ構成情報を新しい環境にエクスポートする必要があります。構成によっては、ポリシー構成アーティファクトやポリシー・アサーション・テンプレートの移行も必要になります。

デプロイメント・ディスクリプタは、アプリケーションの基本的なデプロイ構成が格納されたXMLファイルです。WebLogic ServerおよびJava EE Webサービスのアプリケーションの場合は、アプリケーションを新しい環境にデプロイするために必要なデプロイメント・ディスクリプタを含めたデプロイ・プランを作成します。

ただし、ADFビジネス・コンポーネントおよびWebCenterサービスの場合は、ランタイム・ポリシーの変更は、独自のデプロイメント・ディスクリプタ(PDD)ファイルであるoracle-webservices.xmlおよびoracle-webservices-client.xmlに保持されます。これらのファイルはWebLogicデプロイ・プランに含まれず、他のデプロイメント・ディスクリプタと一緒にエクスポートされないため、これらのPDDファイルを単独でエクスポートしてインポートする必要があります。また、アプリケーションをクラスタ環境にスケーリングする場合も、これらのPDDファイルを単独でエクスポートしてインポートする必要があります。

次のOracle Infrastructure Webサービス・コンポーネントでは、使用される構成管理メカニズムが異なることに注意してください。

- SOAコンポジットでは、WebサービスおよびOWSMの構成がcomposite.xmlファイルに保持されます。このファイルはデプロイ構成に使用される構成プランに含まれます。SOAフレームワークでは、コンポジット・サービスおよび構成のライフサイクルと同期化に独自のメカニズムが使用されます。

- ADF Webサービスのデータ管理構成では、WebCenterサービスの接続詳細はconnections.xmlファイルに格納され、デプロイ後の変更はすべてカスタマイズとしてMetadata Services(MDS)リポジトリに格納されます。

8.1.2 開発またはテスト環境から本番環境へのWebサービス・アプリケーションの移行

Webサービス・アプリケーションを開発またはテスト環境から本番環境へ移行する一般的な手順は、次のとおりです。

1. 本番環境を、必要なコンポーネントとともにインストールし、構成します。

2. ユーザーとグループ、アイデンティティとポリシー・ストア、資格証明などのセキュリティ情報を移行します。詳細は、ポリシー構成の移行の概要を参照してください。

3. 必要に応じて、ポリシーとデプロイ構成を移行します。詳細は、「ポリシーの移行」を参照してください。新しい環境に固有の情報(ホスト名、ポートなど)を変更します。

4. アプリケーションを新しい環境にデプロイします。

環境の間のFusion Middlewareアプリケーションの移動に関する情報は、『Oracle Fusion Middlewareの管理』の「高度な管理: 環境の拡張」を参照してください。

8.2 ポリシーの作成と異なるステージでの水平移行

次の手順では、アプリケーションの開発やデプロイのサイクルでの様々なステージでポリシーを作成および水平移行する方法の一般的なシナリオについて説明します。

1. Oracle Enterprise Manager Fusion Middleware Controlを使用して、ポリシーを作成します。

詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のWebサービス・ポリシーの作成および編集に関する項を参照してください。

2. ZIPアーカイブへのポリシーのエクスポート

詳細は、「ポリシーの移行」を参照してください。

3. ZIPアーカイブのMETA-INFディレクトリの中身を、Oracle JDeveloper環境のポリシーの格納場所に抽出します。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のJDeveloperで使用するポリシーのOWSMリポジトリからのエクスポートに関する項を参照してください。

4. Oracle JDeveloperでWebサービスを作成し、そのWebサービスにポリシーを添付します。

詳細は、『Oracle JDeveloperによるアプリケーションの開発』のWebサービスの開発と保護に関する項を参照してください。

5. Webサービスをステージング・サーバーにデプロイし、Webサービスをテストします。

詳細は、『Oracle JDeveloperによるアプリケーションの開発』のWebサービスの開発と保護に関する項を参照してください。

6. ポリシーを本番のサーバー環境にインポートします。

詳細は、「ポリシーの移行」を参照してください。

7. 必要に応じて、次の情報を移行します。

- ポリシーの構成。"ポリシー構成の移行の概要"を参照してください。

- アサーション・テンプレート。「アサーション・テンプレートの移行」を参照してください。

8. アプリケーションを本番環境にデプロイし、Webサービスをテストします。

「Webサービス・アプリケーションのデプロイ」および「Webサービスのテスト」を参照してください。

8.3 ポリシーの移行

Fusion Middleware Controlを使用してユーザーが作成した1つ以上のポリシーをアーカイブ・ファイルをエクスポートできます。アーカイブは、別のリポジトリにインポートできます。

注意:

事前定義済ポリシーとアサーション・テンプレートなどの読み専用ドキュメントは、すでにターゲット環境に存在するため、Fusion Middleware ControlまたはWLSTを使用してインポートまたはエクスポートされません。

Fusion Middleware Controlを使用したユーザー作成ポリシーのエクスポートおよびインポートに関する詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』の次のトピックを参照してください。

- Webサービス・ポリシーのエクスポート

- Webサービス・ポリシーのインポート

または、WLSTコマンドexportWSMRepositoryおよびimportWSMArchiveを使用して、ポリシーをエクスポートおよびインポートすることもできます。

WLSTコマンドを使用してポリシーを移行する手順は次のとおりです。

1. exportWSMRepositoryコマンドを使用して、zipファイルなど、サポートされているアーカイブ・ファイルにOWSMポリシーをエクスポートします。

たとえば、テスト/ ディレクトリのすべてのユーザー作成OWSMポリシーを、policies.zipの名前のアーカイブにエクスポートする場合は、次のように入力します。

wls:/jrfServer_domain/serverConfig> exportWSMRepository('/tmp/policies.zip',['policies:test/%'])

Exporting "/policies/test/wss11_x509_token_with_message_protection_service_policy_test"
Exporting "/policies/test/wss_username_token_over_ssl_service_policy_Test"
Successfully exported "2" documents.

2. 必要に応じて、作成後のアーカイブを編集できます。たとえば、すべてのポリシーを新しい環境に移行する必要がない場合は、それをアーカイブから手動で削除できます。

3. アーカイブを新しいマシンに移動します。OWSM Policy Managerが新しいマシンにデプロイされていることを確認します。

4. importWSMArchiveコマンドを使用して、OWSMポリシーをインポートします。たとえば、前の手順でエクスポートされたポリシーをインポートする手順は、次のとおりです。

wls:/jrfServer_domain/serverConfig> importWSMArchive('/tmp/policies.zip')

Importing "META-INF/policies/test/wss11_x509_token_with_message_protection_service_policy_test"
Importing "META-INF/policies/test/wss_username_token_over_ssl_service_policy_Test"
Successfully imported "2" documents

これらのWLSTコマンドに関する情報は、『インフラストラクチャ・コンポーネントのためのWLSTコマンド・リファレンス』のWebサービス・カスタムWLSTコマンドに関する項を参照してください。

8.4 ポリシー構成の移行の概要

次の項では、OWSMポリシーの構成アーティファクトを移行する方法を説明します。この項には次のトピックが含まれます:

- キーストアの移行

- ユーザーおよびグループの移行

- 資格証明の移行

- Oracle Platform Security Servicesアプリケーションおよびシステム・ポリシーの移行

- Oracle Platform Security Services構成の移行

- SSLの移行

- Kerberos構成の移行

8.4.1 キーストアの移行

メッセージ保護ポリシーを使用している場合は、キーストアを移行する必要があります。キーストアを移行する手順は次のとおりです。

1. キーストアを新しい環境に手動でコピーします。
Java SEアプリケーションの場合は、キーストアをユーザー定義の場所にコピーします。Java EEアプリケーションの場合は、キーストアをjps-config.xmlファイルと同じディレクトリ、DOMAIN_HOME/config/fmwconfigにコピーします。

2. デフォルトでは、キーストアの名前はdefault-keystore.jksです。キーストアの名前を変更した場合は、Oracle Platform Security Servicesのキーストア・サービス・インスタンスでキーストア名を構成する必要があります。

キーストアの構成の詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』の「メッセージ保護のキーストアの構成」を参照してください。

キーストア・サービスを使用してキーストアを移行する手順は次のとおりです。

1. exportKeyStoreコマンドを使用して、キーストアをファイルにエクスポートします。

2. importKeyStoreコマンドを使用して、ファイルを新しいキーストアにインポートします。

KSSにおけるキーストア移行コマンドの使用の詳細は、Oracle Platform Security Servicesによるアプリケーションの保護のキーと証明書の管理を参照してください。

8.4.2 ユーザーおよびグループの移行

ユーザーとグループは、WebLogic Serverのセキュリティ・レルムの一部として保持されます。

組込みLDAPのユーザーとグループを移行する場合は、Oracle WebLogic管理コンソールまたはWLSTのいずれかを使用してデータを移行できます。必要な手順の詳細は、『Oracle WebLogic Serverセキュリティの管理 12c (12.2.1)』のセキュリティ・データの移行に関する項を参照してください。

LDAPストアのユーザーとグループを移行する場合は、移行パスはありません。新しい環境でユーザーとグループを再作成し、LDAPストアでの割当てを指定する必要があります。『Oracle WebLogic Serverセキュリティの管理 12c (12.2.1)』の認証プロバイダの構成に関する項を参照してください。

8.4.3 資格証明の移行

移行が必要な可能性のある、資格証明ストアに保持された資格証明には2つのタイプがあります。

- ユーザー名およびパスワード

- キーストアおよび暗号化キー・パスワード

次の項では、移行手順を説明します。

8.4.3.1 ユーザー名およびパスワードの移行

組込みLDAPに格納されているユーザーを「ユーザーおよびグループの移行」の説明に従って移行する場合、単純に既存の資格証明を新しい資格証明ストアに移行します。必要な手順の詳細は、『Oracle WebLogic Serverセキュリティの管理 12c (12.2.1)』のセキュリティ・データの移行に関する項を参照してください。

ユーザーがLDAPストアに格納されている場合、自動移行パスはありません。資格証明ストアに資格証明を再作成する必要があります。認証の構成に関する詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』の「認証ストアの構成」を参照してください。

8.4.3.2 キーストアおよび暗号化キー・パスワードの移行

キーストアおよび暗号化キー・パスワードは、『Oracle Platform Security Servicesによるアプリケーションの保護』のセキュア・アプリケーションのデプロイに関する項の資格証明の手動での移行の説明にある手順に従って、手動で移行できます。

8.4.4 Oracle Platform Security Servicesアプリケーションおよびシステム・ポリシーの移行

Webサービスで認可ポリシーを使用する場合は、Oracle Platform Security Servicesアプリケーションおよび権限を付与するシステム・ポリシーを移行する必要があります。詳細は、『Oracle Platform Security Servicesによるアプリケーションの保護』のOPSSセキュリティ・ストアに関する項にあるScript migrateSecurityStoreによる移行の説明を参照してください。

8.4.5 Oracle Platform Security Services構成の移行

Oracle Platform Security Services構成には、自動移行パスはありません。新しい環境で構成を再作成する必要があります。

再作成が必要な可能性のあるOracle Platform Security Servicesの構成には、3つのタイプがあります。

- 信頼できるSAMLアサーション発行者名(すべてのSAMLポリシーに適用可能)。
信頼できるSAML発行者名構成にデフォルトの構成を使用する場合は、移行は必要ありません。新規環境におけるSAMLの構成に関する詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』の「Fusion Middleware Controlを使用したSAMLおよびSAML2ログイン・モジュールの構成」を参照してください。

- キーストアの場所、およびキーストアとキーストア・パスワードのCSFキー構成(メッセージ保護ポリシーのみに適用可能)。
キーストアにデフォルトの構成を使用する場合は、移行は必要ありません。新規環境におけるキーストアの構成の詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』の「メッセージ保護のキーストアの構成」を参照してください。

- keytabの場所およびサービス・プリンシパル名(Kerberosポリシーに適用可能)
新規環境におけるキータブ・ロケーションおよびサービス・プリンシパル名の構成の詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』の次のトピックを参照してください:

- Fusion Middleware Controlを使用したSAMLおよびSAML2ログイン・モジュールの構成

- Fusion Middleware Controlを使用したKerberosログイン・モジュールの構成

8.4.6 SSLの移行

SSL構成には、自動移行パスはありません。新しい環境でSSLキーストアを構成して設定する必要があります。新規環境におけるSSLキーストアの構成および設定の詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』の「SSLのキーストアの構成」を参照してください。

8.4.7 Kerberos構成の移行

Kerberos構成を移行する手順は次のとおりです。

1. Kerberos構成ファイルを、同じディレクトリ構造の新しい環境にコピーします。Kerberos構成ファイルは、各オペレーティング・システムで次の場所にあります。

- UNIX: : /etc/krb5.conf

- Windows: C:\windows\krb5.ini

2. チケット・キャッシュを適切な資格証明で初期化します。

詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』の「Kerberos Tokensの構成」を参照してください。

8.5 アサーション・テンプレートの移行

Oracle Enterprise Manager Fusion Middleware Controlからアサーション・テンプレートを個別にエクスポートできます。ポリシーをディレクトリにコピーすることも、ポリシーをインポートして別のリポジトリに移動することもできます。

アサーション・テンプレートのエクスポートおよびインポートに関する詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』の「ポリシー・アサーション・テンプレートの管理」を参照してください。

9 Webサービスの表示、登録および公開

この章では、WSILまたはUDDIレジストリからEnterprise ManagerのWebサービスおよびソースを登録する方法について説明します。また、登録されたリソースをUDDIレジストリで公開する方法についても説明します。この章の内容は次のとおりです。

- Webサービスとソースの登録の概要

- UDDIへのWebサービスのパブリッシュの概要

9.1 Webサービスとソースの登録の概要

Webサービス・モデルの主な機能は、Webサービスを広範囲にわたって利用および検出できるようにすることです。UDDIは、Webサービスを公開および検出するための1つの手段であり、ビジネスやそのサービスに関する情報をレジストリで集中管理します。新しい別の標準として、Web Services Inspection Language (WSIL)仕様があります。

Oracle Enterprise Manager Fusion Middleware Controlで、WSILドキュメントおよびUDDI v3レジストリでパブリッシュされたWebサービスを登録できます。WSILドキュメントまたはUDDI v3レジストリで使用できる任意のサービスをEnterprise Manager内に登録できます。

Enterprise Manager内の登録済サービスをサービスのソースで管理しやすくするために、メタ情報またはプロファイルを登録することもできます。ソースを登録してそれに論理名を割り当てておくと、その後はWSDLのURLなどの接続情報を指定する必要がなくなります。ドメインは複数の登録済ソースを持つことができ、各登録済ソースが複数の登録済サービスを持つことができます。ソースを登録しておくと、そのソースに登録できるサービスを簡単に検索できるようになります。

サービス名と対応するWSDLは、単一の登録済ソース内で一意である必要があります。あるサービスを登録すると、それと同じ名前の別のサービス、または名前は異なるが同じWSDL URLの別のサービスを登録しようとすると無効になります。

Webサービスを登録しておくと、Enterprise Manager内の選択リストから簡単にサービスを参照できるようになります。たとえば、「Webサービスのテスト」の説明に従ってWebサービスをテストする場合、WSDLを指定するかわりに「検索」アイコンをクリックしてから、登録済サービスのリストからWSDLを選択します。

この項には次のトピックが含まれます:

- UDDIの基本の理解

- WSILの基本の理解

- 登録済ソースとWebサービスの表示

- ソースの登録

- UDDIソースからのWebサービスの登録

- WSILソースからのWebサービスの登録

- WebサービスまたはWebサービス・ソースの削除

9.1.1 UDDIの基本の理解

Universal Description Discovery & Integration (UDDI)は、ビジネスを迅速、簡単、かつ動的に検索し、そして相互の取引を実行可能にすることを目指す業界イニシアティブです。UDDIレジストリには、ビジネス、ビジネスが提供するサービス、およびビジネスがトランザクションを実行するために使用する通信規格とインタフェースに関する情報がカタログ化されて格納されます。

Webサービスのオーナーは、それらをUDDIレジストリにパブリッシュします。パブリッシュされると、Webサービスの説明およびサービスに対するポインタがUDDIレジストリに保持されます。UDDIを使用すると、クライアントはこのレジストリを検索し、目的のサービスを見つけてその詳細を取得できます。これらの詳細には、サービスの呼出しポイントのほかに、サービスとその機能を識別するための情報が含まれます。

9.1.2 WSILの基本の理解

WSILでは、Webサービスの説明の参照にExtensible Markup Language(XML)形式が定義されます。これらの参照はWSILドキュメントに含まれ、Webサービスの説明(WSDLファイルなど)およびWebサービスの他の集合(別のWSILドキュメントまたはUDDIレジストリなど)を参照します。

WSILドキュメントは、通常Webサービス・プロバイダによって配布されます。これらのドキュメントには、使用可能なWebサービスのプロバイダのWebサイトを検索する方法が記述されています。したがって、WSIL標準は、Webサービスの利用者がWSILドキュメントを使用できるようにするルールも定義します。

WSILモデルは、Webサービスの検出を分散化します。複数のビジネス・エンティティおよびサービスに関する情報を集中管理するUDDIレジストリとは対照的に、WSILはWebサービスの記述情報をどの場所からでも提供できるようにします。UDDIとは異なり、WSILはビジネス・エンティティ情報には関係せず、特定のサービス記述形式を必要としません。ユーザーがサービス・プロバイダを理解していることが前提であり、WSDLなど、他の規格のWebサービス記述を使用します。

9.1.3 登録済ソースとWebサービスの表示

この項の手順に従って登録済ソースとWebサービスを表示および編集します。

1. ナビゲーション・ペインで「WebLogicドメイン」を開き、登録済のソースとWebサービスを表示するドメインを表示します。

2. ドメインを選択します。

3. 「WebLogicドメイン」メニューから、「Webサービス」→「登録済サービス」を選択します。図9-1に示すように、「登録済ソースとサービス」ページが表示されます。

図9-1 登録済ソースとサービスの表示

「ソース」表には、各登録済ソースに関する次の情報が表示されます。

- 名前: ソースの論理名

- 説明: ソースの説明

- ソースURL: URL形式のソースの場所

- タイプ - ソース・タイプ: UDDI v3レジストリ・インポート、ファイルからのWSILインポート、URLからのWSILインポート

- ユーザーID: 外部ソースのユーザーID

「表示」メニューを使用して、表示される情報をカスタマイズできます。ページのこのセクションから、新しいソースの追加、ソースの削除や編集、ソースのWebサービスの登録、およびソースから事前定義済UDDIレジストリへのWebサービスのパブリッシュも行えます。

4. 「ソース」表でソースを選択します。

各登録済ソースは複数の登録済サービスを持つことができます。「サービス」表には、選択したソース場所からインポートされた登録済サービスに関する次の情報が表示されます。

- 名前: 登録済サービスの名前

- 説明: サービスの説明

- サービス場所: URL形式でのサービスの場所

「表示」メニューを使用して、表示される情報をカスタマイズできます。選択したサービスのWSDLを表示して、選択したWebサービスをテストすることもできます。

9.1.4 ソースの登録

次のタイプのWebサービス・ソースを登録できます。

- UDDI v3レジストリ・インポート

- URLからのWSILインポート

- ファイルからのWSILインポート

ソースを登録する手順:

1. ナビゲーション・ペインで「WebLogicドメイン」を開き、Webサービスのソースを登録するドメインを表示します。

2. ドメインを選択します。

3. 「WebLogicドメイン」メニューから、「Webサービス」→「登録済サービス」を選択します。図9-1に示すように、「登録済ソースとサービス」ページが表示されます。

4. 「追加」をクリックして新しいソースを登録します。図9-2に示すように、「新規ソースの登録」ページが表示されます。

図9-2 「新規ソースの登録」ページ

5. 新しいソースに関する次の情報を入力します。

- 名前: ソースの論理名。

- 説明: ソースの説明。

- タイプ: UDDI v3レジストリ・インポート、URLからのWSILインポート、ファイルからのWSILインポートの3つのオプションからいずれかを選択します。
その他の入力する必要がある情報は、選択したオプションによって異なります。

6. UDDI v3レジストリ・インポートを選択した場合は、次の情報を入力します。

- 「ソースURL」フィールドに、UDDI照会URL、たとえばhttp://somehost/uddi/inquiryを入力します。

- サービスをUDDIソース(外部UDDIレジストリ)にパブリッシュできるようにするには、「有効化」ボックスを選択してフィールドに次のように入力します。

- パブリッシュURLフィールドで、サービスのパブリッシュ先となるレジストリのURLロケーションを入力します。

- 「セキュリティURL」フィールドに、レジストリにアクセスするために必要なセキュリティ・ポートのURLロケーションを入力します。

- 「ユーザーID」および「パスワード」フィールドに、レジストリにアクセスするために必要なセキュリティ資格証明を入力します。

7. 「URLからのWSILインポート」を選択した場合は、次の情報を入力します。

- 「ソースURL」フィールドに、WSILの場所をURL形式で入力します。

- WSILにアクセスするためにユーザー名とパスワードが必要な場合は、Basic認証フィールドで「有効化」ボックスを選択します。「ユーザーID」および「パスワード」フィールドに、ユーザー名とパスワードを入力します。

8. 「ファイルからのWSILインポート」を選択した場合は、「参照」(「WSILファイル」フィールドの横)をクリックしてインポートするWSILファイルを選択します。

9. 「OK」をクリックしてソースを登録します。

9.1.5 UDDIソースからのWebサービスの登録

登録済UDDIソースからWebサービスを登録するには、この項の手順に従います。

1. ナビゲーション・ペインで「WebLogicドメイン」を開き、Webサービスを登録するドメインを表示します。

2. ドメインを選択します。

3. 「WebLogicドメイン」メニューから、「Webサービス」→「登録済サービス」を選択します。図9-1に示すように、「登録済ソースとサービス」ページが表示されます。

4. サービスの登録元となるUDDIソースを選択します。UDDIソースの「タイプ」は、UDDI v3レジストリ・インポートとして指定することに注意してください。

5. Webサービスの登録を選択します。

図9-3に示すように、「新規サービスの登録」ページが表示されます。

図9-3 UDDIソースからの新規サービスの登録

「新規サービスの登録」ページには、読取り専用形式のソース情報、および登録できるUDDIで使用可能なサービスのリストが表示されます。

サービス名および「サービス・キー」フィールドを使用して、表示される使用可能なサービスのリストをフィルタできます。たとえば、電卓(calculator)サービスを検索するには、サービス名フィールドにcalcと入力します。電卓(calculator)サービスなど、文字列calcを含むサービスのみが表示されます。検索では大文字と小文字は区別されません。

ページの「UDDIで使用可能なサービス」セクションで、サービス詳細の表示アイコンをクリックして、表内の各サービスのサービス詳細をUDDIから表示できます。UDDIからのサービス詳細ウィンドウには、特にサービス名、サービスの説明、サービスのWSDL、サービス・キー、ビジネス・キー、およびサービス場所などのサービスに関する情報が表示されます。

「編集」アイコンをクリックして、サービスの詳細を編集できます。これにより、選択したサービスの名前と説明を変更できます。

6. ページの「UDDIで使用可能なサービス」セクションで、ソースから登録する1つ以上のサービスを選択し、「登録」をクリックします。

サービスが正常に登録されたことを示す確認メッセージが表示されます。

9.1.6 WSILソースからのWebサービスの登録

登録済WSILソースからWebサービスを登録するには、この項の手順に従います。

1. ナビゲーション・ペインで「WebLogicドメイン」を開き、Webサービスを登録するドメインを表示します。

2. ドメインを選択します。

3. 「WebLogicドメイン」メニューから、「Webサービス」→「登録済サービス」を選択します。図9-1に示すように、「登録済ソースとサービス」ページが表示されます。

4. サービスの登録元となるWSILソースを選択します。WSILソースの「タイプ」は、「ファイルからのWSILインポート」または「URLからのWSILインポート」として指定することに注意してください。

5. Webサービスの登録を選択します。

図9-4に示すように、「新規サービスの登録」ページが表示されます。

図9-4 WSILソースからの新規サービスの登録

「新規サービスの登録」ページには、読取り専用形式のソース情報、およびWSILで使用可能なサービス表に示すように、登録できるWSILで使用可能なサービスのリスト(あれば)が表示されます。WSILにWSIL参照がある場合は、それらが「WSILで使用可能な参照」表にリストされます。

WSILで使用可能なサービス表で、「編集」アイコンをクリックして、サービスの詳細を編集できます。これにより、選択したサービスの名前と説明を変更できます。

6. 現在のWSILから使用可能なサービスを登録するには、WSILで使用可能名サービス表でサービスを選択して、「登録」をクリックします。

サービスが正常に登録されたことを示す確認メッセージが表示されます。

7. 現在のWSILが別のWSIL URLや参照も参照している場合は、「WSILで使用可能な参照」を開いて表示します。参照されているWebサービスも登録できます。

現在のWSILのかわりに参照されているWSILからサービスを登録するには、「WSILで使用可能な参照」表でその参照の「プロセス」アイコンをクリックします。

WSILが正常に解析されると、新しいソースが登録され、現在のWSILソースが参照されているWSILに置き換えられます。参照されているWSILソースで使用可能なサービスが、WSILで使用可能なサービス表にリストされます。これで参照されているWSILからサービスを登録できます。

注意:

作成された各新規ソースには、親ソース名に_nを付加した名前が付けられます。たとえば、親ソース名がwsil_file_1の場合、参照されている新規ソースの名前は、ソース・タイプWSIL URLを含むwsil_file_1_1、wsil_file_1_2)になります。新しいソースは、登録済ソースとサービスページの「ソース」表にリストされます。

WSILが正常に解析されなかった場合は、エラー・メッセージが表示されます。通常そのような場合でも、選択されたWSIL参照に対して新しいソースは正常に登録されます。ただし、システムがWSILドキュメントを解析できなかったために、エラー・メッセージが表示されます。エラー・ダイアログを閉じて、「OK」をクリックして「登録済ソースとサービス」ページに戻ります。

WSIL解析は、参照が不適切であるか認可証明書が必要な場合には失敗します。「ソースの登録」で説明されているように、WSILソースの認可を有効化できます。

注意:

接続やその他の不具合が原因で、システムが登録済ソースからのWebサービスの取得に失敗した場合は、「新規サービスの登録」ページにソースの読取り専用情報が表示されますが、Webサービスは表示されません。このような場合は、エラー・ダイアログが表示されている場合は、エラー・ダイアログで「OK」をクリックし、それから「新規サービスの登録」ページで「OK」をクリックして、ソースとサービスの登録ページに戻ります。問題解決方法として、他の方法により登録済ソースを表示します。たとえば、ソースのタイプに応じて、次の方法を実行します。

- WSIL URLソース: URLをブラウザのアドレス・バーにコピーしてその内容を表示します。

- WSILファイル・ソース: XMLエディタを使用してWSILファイルを調べます。

- UDDIソース: UDDIレジストリに直接アクセスして調べます。

また、関連するEnterprise Managerエラー・ログを確認することもできます。

9.1.7 WebサービスまたはWebサービス・ソースの削除

この項の手順に従ってWebサービスまたはWebサービス・ソースを削除します。

1. ナビゲーション・ペインで「WebLogicドメイン」を開き、Webサービスを削除するドメインを表示します。

2. ドメインを選択します。

3. 「WebLogicドメイン」メニューから、「Webサービス」→「登録済サービス」を選択します。図9-1に示すように、「登録済ソースとサービス」ページが表示されます。

4. 次のいずれかを行います:

- ソースを削除するには、「ソース」表からソースを選択し、「削除」をクリックします。
確認メッセージが表示されます。「OK」をクリックしてソースを削除します。

- サービスをソースから削除するには、「ソース」表からソースを選択します。
「サービス」表に登録済Webサービスが表示されます。

削除するサービスを「サービス」表から選択し、「削除」をクリックします。

確認メッセージが表示されます。「OK」をクリックしてサービスを削除します。

9.2 UDDIへのWebサービスのパブリッシュの概要

登録済のUDDIソースから、およびADF、Java EEの各アプリケーションの「Webサービスのサマリー」ページから、UDDIにWebサービスをパブリッシュできます。登録済UDDIソースは、「登録済ソースとサービス」ページにリストされます。これにはドメインに登録されているすべてのソースとサービスが含まれます。「Webサービスのサマリー」ページには、アプリケーション内のWebサービスがリストされます。

注意:

サービスをUDDIにパブリッシュするには、プロキシを使用する必要があります。これはファイアウォールより外側のURLにアクセスする必要があるためです。必要なプロキシ設定の詳細は、「UDDIのプロキシ・サーバーの構成」を参照してください。

サービスがすでにOracle Enterprise Repository (OER)に存在する場合、OER交換ユーティリティを使用してそれらのサービスをOracle Service Registryにパブリッシュする必要があります。

次の手順では、WebサービスをUDDIにパブリッシュする方法について説明します。

- "登録済ソースからUDDIへのWebサービスのパブリッシュ"

- "アプリケーションからUDDIへのWebサービスのパブリッシュ"

- "UDDIのプロキシ・サーバーの構成"

9.2.1 登録済ソースからUDDIへのWebサービスのパブリッシュ

Webサービスを登録済ソースからUDDIにパブリッシュするには:

1. 「登録済ソースとWebサービスの表示」の説明に従って、「登録済ソースとサービス」ページに移動します。

2. 「ソース」表でソース行を選択してから、「UDDIにパブリッシュ」を選択します。

図9-5 「UDDIにパブリッシュ」が選択された「登録済ソースとサービス」ページ

3. 「サービスをUDDIにパブリッシュ」ウィンドウで、パブリッシュするサービスに関する情報を入力します。

- 「サービス名」は、UDDIレジストリにパブリッシュされるWebサービスの名前です。このフィールドは必須です。

- 「サービスの説明」は、選択したWebサービスの説明です。

- サービス定義の場所は、サービス定義のURLロケーションです。このフィールドは必須です。

- UDDIソースは、サービスの登録元となるUDDIソースの名前です。このフィールドは読取り専用です。

- 「ビジネス名」は、UDDIレジストリ内のデータ構造の名前です。ビジネスがすでにUDDIに登録されていることが前提です。リストからビジネス名を選択します。このフィールドは必須です。

図9-6 サービスをUDDIソースからUDDIウィンドウにパブリッシュ

4. 「サービスをUDDIにパブリッシュ」ウィンドウで「OK」をクリックします。

システムにより、指定されたサービスが有効なWSDLを持つこと、そしてUDDIレジストリが新しいエントリを受け入れたか既存のエントリを更新したことが検証されます。正常であれば、確認メッセージが表示され、サービスがレジストリにパブリッシュされます。サービスがUDDIにパブリッシュされると、「UDDIソースからのWebサービスの登録」の説明に従って、そのサービスをソースに登録できるようになります。

操作中にエラーが発生すると、エラー・メッセージが出力されます。

ソースに登録できるのは、一意のWSDLを使用しているサービスのみであることに注意してください。

9.2.2 アプリケーションからUDDIへのWebサービスのパブリッシュ

WebサービスをアプリケーションからUDDIにパブリッシュするには:

1. 「アプリケーションのWebサービスのサマリー・ページの表示」の説明に従って、Webサービスのアプリケーション・サマリー・ページに移動します。

2. ページの「Webサービスの詳細」セクションで、「Webサービス」タブが選択されていない場合は選択し、パブリッシュするサービスを選択します。

3. 「アクション」→「UDDIにパブリッシュ」を選択します。図9-7を参照してください。

図9-7 「UDDIにパブリッシュ」が選択された「Webサービスのサマリー」ページ

4. 「サービスをUDDIにパブリッシュ」ダイアログ・ボックス(図9-8)で、パブリッシュするサービスに関する情報を入力します。

- 「サービス名」は、UDDIレジストリにパブリッシュされるWebサービスの名前です。このフィールドは必須です。

- 「サービスの説明」は、選択したWebサービスの説明です。

- サービス定義の場所は、サービス定義のURLロケーションにより事前に入力されています(これは読取り専用フィールドです)。

- UDDIソースは、UDDIレジストリ・ソースの論理名です。リストからUDDIソースを選択します。このフィールドは必須です。

注意:

リストには、ドメインに登録済のパブリッシュを有効化されたUDDIソースが含まれます。登録済ソースの詳細は、「Webサービスとソースの登録の概要」を参照してください。

- 「ビジネス名」は、UDDIレジストリ内のデータ構造の名前です。ビジネスがすでにUDDIに登録されていることが前提です。リストからビジネス名を選択します。このフィールドは必須です。

図9-8 「サービスをUDDIにパブリッシュ」ダイアログ・ボックス

5. 「OK」をクリックして外部のUDDIレジストリに接続し、Webサービスを登録します。

サービスが正常に登録されると、確認メッセージが表示されます。操作中にエラーが発生すると、エラー・メッセージが出力されます。

9.2.3 UDDIのプロキシ・サーバーの構成

サービスをUDDIにパブリッシュするには、ファイアウォールより外側のURLにアクセスするため、プロキシを使用する必要があります。

Oracle WebLogicを起動する前に、表9-1に定義されているJavaシステム・プロパティを設定する必要があります。これらは環境変数として設定するか、Oracle WebLogic起動ファイルの中で設定します。

表9-1 UDDIのプロキシ・サーバーを指定するために使用されるJavaシステム・プロパティ

プロパティ

説明

proxySet=true

WebLogicプロキシ・プロパティを使用するかどうかを指定するフラグ。

http.proxyHost=proxyHost

プロキシ・サーバー が動作しているホスト・コンピュータ名。

http.proxyPort=proxyPort

プロキシ・サーバーがリスニングしているポート。

http.nonProxyHosts=hostname | hostname |...

プロキシをバイパスし、直接アクセスするホストのリスト。各ホスト名を「|」文字で区切ります。

次に例を示します。

set PROXY_SETTINGS="-DproxySet=true -Dhttp.proxyHost=www-proxy.example.com -Dhttp.proxyPort=80 -Dhttp.nonProxyHosts=localhost|${HOST}|*.example.com"

A Webサービス監査イベントのリファレンス

この付録は、「Webサービスの監査」で説明されているように、Oracle Fusion Middleware Audit Frameworkを使用して監査可能なWebサービスおよびOWSMイベントに関するリファレンス情報を提供します。

Oracle Fusion Middleware Audit Frameworkの使用に関する詳細は、『Oracle Platform Security Servicesによるアプリケーションの保護』の「「監査分析の使用および報告」を参照してください。

この付録の内容は次のとおりです。

- Webサービス監査イベント

- ビルトイン監査レポート

A.1 Webサービス監査イベント

この項では、監査対象のコンポーネントと監査可能なイベント・タイプについて説明します。

- "OWSM-AGENTのイベントと属性"

- "OWSM-PM-EJBのイベントと属性"

- "Webサービス・ポリシー・アタッチメントのイベントと属性"

- "Oracle Webサービスのイベントと属性"

A.1.1 OWSM-AGENTのイベントと属性

次の表は、監査可能なOWSM-AGENTイベント・タイプの要約です。

表A-1 OWSM-Agentのイベント

イベント・カテゴリ

イベント・タイプ

イベントで使用される属性

ユーザー・セッション

認証

ComponentType、InstanceId、HostId、HostNwaddr、ProcessId、OracleHome、HomeInstance、ECID、RID、ContextFields、SessionId、TargetComponentType、ApplicationName、EventType、EventCategory、EventStatus、TstzOriginating、ThreadId、ComponentName、Initiator、MessageText、FailureCode、RemoteIP、Resource、AssertionName、CompositeName、Endpoint、AgentMode、ModelObjectName、Operation、ProcessingStage、Version、Protocol

認可

認可をチェック

ComponentType、InstanceId、HostId、HostNwaddr、ProcessId、OracleHome、HomeInstance、ECID、RID、ContextFields、SessionId、TargetComponentType、ApplicationName、EventType、EventCategory、EventStatus、TstzOriginating、ThreadId、ComponentName、Initiator、MessageText、FailureCode、RemoteIP、Resource、AssertionName、CompositeName、Endpoint、AgentMode、ModelObjectName、Operation、ProcessingStage、Version、Protocol

ポリシー実行

機密性を実行

ComponentType、InstanceId、HostId、HostNwaddr、ProcessId、OracleHome、HomeInstance、ECID、RID、ContextFields、SessionId、TargetComponentType、ApplicationName、EventType、EventCategory、EventStatus、TstzOriginating、ThreadId、ComponentName、Initiator、MessageText、FailureCode、RemoteIP、Resource、AssertionName、CompositeName、Endpoint、AgentMode、ModelObjectName、Operation、ProcessingStage、Version、Protocol

—

インテグリティを実行

ComponentType、InstanceId、HostId、HostNwaddr、ProcessId、OracleHome、HomeInstance、ECID、RID、ContextFields、SessionId、TargetComponentType、ApplicationName、EventType、EventCategory、EventStatus、TstzOriginating、ThreadId、ComponentName、Initiator、MessageText、FailureCode、RemoteIP、Resource、AssertionName、CompositeName、Endpoint、AgentMode、ModelObjectName、Operation、ProcessingStage、Version、Protocol

—

ポリシーを実行

ComponentType、InstanceId、HostId、HostNwaddr、ProcessId、OracleHome、HomeInstance、ECID、RID、ContextFields、SessionId、TargetComponentType、ApplicationName、EventType、EventCategory、EventStatus、TstzOriginating、ThreadId、ComponentName、Initiator、MessageText、FailureCode、RemoteIP、Resource、AssertionName、CompositeName、Endpoint、AgentMode、ModelObjectName、Operation、ProcessingStage、Version、Protocol

A.1.2 OWSM-PM-EJBのイベントと属性

次の表は、監査可能なOWSM-PM-EJBイベント・タイプの要約です。

表A-2 OWSM-PM-EJBのイベント

イベント・カテゴリ

イベント・タイプ

イベントで使用される属性

認可アサーション・テンプレート

アサーション・テンプレートの作成

ComponentType、InstanceId、HostId、HostNwaddr、ProcessId、OracleHome、HomeInstance、ECID、RID、ContextFields、SessionId、TargetComponentType、ApplicationName、EventType、EventCategory、EventStatus、TstzOriginating、ThreadId、ComponentName、Initiator、MessageText、FailureCode、Resource、Version

-

アサーション・テンプレートの削除

ComponentType、InstanceId、HostId、HostNwaddr、ProcessId、OracleHome、HomeInstance、ECID、RID、ContextFields、SessionId、TargetComponentType、ApplicationName、EventType、EventCategory、EventStatus、TstzOriginating、ThreadId、ComponentName、Initiator、MessageText、FailureCode、Resource、Version、ToVersion

-

アサーション・テンプレートの変更

ComponentType、InstanceId、HostId、HostNwaddr、ProcessId、OracleHome、HomeInstance、ECID、RID、ContextFields、SessionId、TargetComponentType、ApplicationName、EventType、EventCategory、EventStatus、TstzOriginating、ThreadId、ComponentName、Initiator、MessageText、FailureCode、Resource、Version

ポリシー認可

ポリシーの作成

ComponentType、InstanceId、HostId、HostNwaddr、ProcessId、OracleHome、HomeInstance、ECID、RID、ContextFields、SessionId、TargetComponentType、ApplicationName、EventType、EventCategory、EventStatus、TstzOriginating、ThreadId、ComponentName、Initiator、MessageText、FailureCode、Resource、Version

-

ポリシーの削除

ComponentType、InstanceId、HostId、HostNwaddr、ProcessId、OracleHome、HomeInstance、ECID、RID、ContextFields、SessionId、TargetComponentType、ApplicationName、EventType、EventCategory、EventStatus、TstzOriginating、ThreadId、ComponentName、Initiator、MessageText、FailureCode、Resource、Version、ToVersion

-

ポリシーの変更

ComponentType、InstanceId、HostId、HostNwaddr、ProcessId、OracleHome、HomeInstance、ECID、RID、ContextFields、SessionId、TargetComponentType、ApplicationName、EventType、EventCategory、EventStatus、TstzOriginating、ThreadId、ComponentName、Initiator、MessageText、FailureCode、Resource、Version

ポリシー・セットの認可

ポリシー・セットの作成

ComponentType、InstanceId、HostId、HostNwaddr、ProcessId、OracleHome、HomeInstance、ECID、RID、ContextFields、SessionId、TargetComponentType、ApplicationName、EventType、EventCategory、EventStatus、TstzOriginating、ThreadId、ComponentName、Initiator、MessageText、FailureCode、Resource、Version

-

ポリシー・セットの削除

ComponentType、InstanceId、HostId、HostNwaddr、ProcessId、OracleHome、HomeInstance、ECID、RID、ContextFields、SessionId、TargetComponentType、ApplicationName、EventType、EventCategory、EventStatus、TstzOriginating、ThreadId、ComponentName、Initiator、MessageText、FailureCode、Resource、Version、ToVersion

-

ポリシー・セットの変更

ComponentType、InstanceId、HostId、HostNwaddr、ProcessId、OracleHome、HomeInstance、ECID、RID、ContextFields、SessionId、TargetComponentType、ApplicationName、EventType、EventCategory、EventStatus、TstzOriginating、ThreadId、ComponentName、Initiator、MessageText、FailureCode、Resource、Version

A.1.3 Webサービス・ポリシー・アタッチメントのイベントと属性

次の表は、監査可能なWSポリシー・アタッチメント・イベント・タイプの要約です。

表A-3 WSポリシー・アタッチメントのイベント

イベント・カテゴリ

イベント・タイプ

イベントで使用される属性

WSポリシー・アタッチメント

ポリシー・アタッチメントのイベント

ComponentType、InstanceId、HostId、HostNwaddr、ProcessId、OracleHome、HomeInstance、ECID、RID、ContextFields、SessionId、TargetComponentType、ApplicationName、EventType、EventCategory、EventStatus、TstzOriginating、ThreadId、ComponentName、Initiator、MessageText、FailureCode、RemoteIP、Target、Resource、PolicyChangeType、PolicyURI、PolicyCategory、PolicyStatus、ServiceEndPoint、PolicySubjRescPattern

A.1.4 Oracle Webサービスのイベントと属性

次の表は、監査可能なOracle Webサービスのイベント・タイプの要約です。

表A-4 Oracle Webサービス・イベント

イベント・カテゴリ

イベント・タイプ

イベントで使用される属性

WS処理

受領リクエスト

ComponentType、InstanceId、HostId、HostNwaddr、ProcessId、OracleHome、HomeInstance、ECID、RID、ContextFields、SessionId、TargetComponentType、ApplicationName、EventType、EventCategory、EventStatus、TstzOriginating、ThreadId、ComponentName、Initiator、MessageText、FailureCode、RemoteIP、Target、Resource、Protocol、Endpoint、Operation、FaultUrl

-

レスポンス送信

ComponentType、InstanceId、HostId、HostNwaddr、ProcessId、OracleHome、HomeInstance、ECID、RID、ContextFields、SessionId、TargetComponentType、ApplicationName、EventType、EventCategory、EventStatus、TstzOriginating、ThreadId、ComponentName、Initiator、MessageText、FailureCode、RemoteIP、Target、Resource、Protocol、Endpoint、Operation、FaultUri

WSフォルト

ソープ・フォルトのイベント

ComponentType、InstanceId、HostId、HostNwaddr、ProcessId、OracleHome、HomeInstance、ECID、RID、ContextFields、SessionId、TargetComponentType、ApplicationName、EventType、EventCategory、EventStatus、TstzOriginating、ThreadId、ComponentName、Initiator、MessageText、FailureCode、RemoteIP、Target、Resource、URI、Source、Protocol、Endpoint、Operation

A.2 ビルトイン監査レポート

Oracle Fusion Middleware監査フレームワークには、Oracle Business Intelligence Publisherを通してアクセス可能な、すぐに使用できる一連のレポートが用意されています。OWSM監査レポートは、次のように分類されます。

- ユーザー・アクティビティ

- 認証履歴

- 認可履歴

- エラーと例外

- すべてのエラーと例外

- 認証失敗

- 認可失敗

- すべてのイベント

- ポリシー管理

- アサーション・テンプレート管理

- Webサービスのポリシー管理

- ポリシー施行

- 機密性の施行

- ポリシー施行

- メッセージ整合性の実行

- 違反

- リクエスト・レスポンス

- ポリシー・アタッチメント

OWSM監査レポート

監査データがデータベース内に存在する場合は、事前定義済のOracle Business Intelligence Publisherレポートを実行して、データに関する独自のレポートを作成できます。

監査レポートの構成、生成および管理の詳細は、Oracle Business Intelligence Publisher管理者ガイドを参照してください。