Oracle® Fusion Middleware Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理 12c (12.2.1.2) E82680-02 |
|
前 |
次 |
この付録では、Webサービス・セキュリティおよびポリシー注釈について説明しており、次の項があります。
Oracle Webサービスのプログラミング・モデルでは、JDKメタデータ注釈が使用されます。
JDKメタデータ注釈については、次のテクニカル・ノートで説明されています。
http://docs.oracle.com/javase/7/docs/technotes/guides/language/annotations.html
詳細は、次の場所にあるJSR 175を参照してください。
http://www.jcp.org/en/jsr/detail?id=175
このプログラミング・モデルでは、注釈付きのJavaファイルを使用してWebサービスの形状や特性を作成します。
使用可能な注釈の詳細は、Oracle Infrastructure Web ServicesのためのJava APIリファレンスを参照してください。OWSMの事前定義済ポリシーの詳細は、Oracle Web Services Managerの事前定義済ポリシーを参照してください。
Webサービスのセキュリティおよびポリシー注釈は、Oracle Webサービスで高度な機能を保護し、有効にします。
表A-1は、この付録で説明しているWebサービスのセキュリティおよびポリシー注釈の概要を示しています。「設計時におけるWebサービスおよびクライアントへのポリシーのアタッチの理解」で説明しているように、この表は、Webサービス・クライアントのサブセットにポリシーをアタッチする際に使用可能な、対応するWebサービス機能クラスも示しています。
表A-1 Oracle Web Servicesのセキュリティおよびポリシー注釈
注釈 | 説明 |
---|---|
SOAP 1.1/HTTPバインディングとSOAP 1.2/HTTPバインディングのいずれかでWS-Addressingを使用することを指定します。 |
|
Webサービスのアトミック・トランザクションを有効にします。 |
|
Webサービスのバッファリングを有効にします。 |
|
コンテンツのバイナリ・キャッシュを有効にして、構成します。 |
|
クライアント・コールバック・サービスに非同期レスポンスを送信するときに管理ポリシーをアタッチします。 |
|
クライアント・コールバック・サービスに非同期レスポンスを送信するときにMTOMポリシーをアタッチします。 |
|
コールバック・サービスに接続される非同期Webサービスのコールバック・クライアントに、1つ以上のポリシー・セットをアタッチします。 |
|
クライアント・コールバック・サービスに非同期レスポンスを送信するときにセキュリティ・ポリシーをアタッチします。 |
|
コールバック・サービスに接続される非同期Webサービスのコールバック・クライアントで、Fast Infosetを有効にして、構成します。 |
|
Webサービス・クライアント上のFast Infosetを有効にして、構成します。 |
|
WebサービスのFast Infosetを有効にします。 |
|
JAX-WS Webサービス・クライアントについて、SOAP over JMSトランスポートを有効化および構成します。 |
|
JAX-WS Webサービスについて、SOAP over JMSトランスポートを有効化および構成します。 |
|
管理ポリシーをWebサービスにアタッチします。 |
|
Webサービスに送信可能なリクエスト・メッセージの最大サイズをバイト単位で構成します。 |
|
メタデータの交換を有効にします。 |
|
Webサービスでのメッセージ転送最適化メカニズム(MTOM)の使用を有効にします。 |
|
MTOMが有効になっている場合の、MTOM対応SOAPフォルト・メッセージの作成を有効にします。 |
|
MTOMポリシーをWebサービスにアタッチします。 |
|
Webサービスに、セキュア通信セッション永続性メカニズムを構成します。 |
|
サブジェクトに単一ポリシーをアタッチし、オプションで構成プロパティ値をオーバーライドします。 |
|
一連のポリシー参照を定義し、オプションでスコープのない構成プロパティ値をオーバーライドします。 |
|
ユーザー定義の |
|
1つ以上のポリシーの構成のオーバーライドに使用できる単一プロパティを指定します。 |
|
信頼できるメッセージング・ポリシー |
|
|
|
Webサービス・エンドポイントを有効にします。 |
|
スキーマに対するリクエスト・メッセージの検証を有効にします。 |
|
|
|
|
|
リクエストまたはレスポンスSOAPメッセージにセキュリティ・ポリシーをアタッチします。 |
|
リクエストまたはレスポンスSOAPメッセージにセキュリティ・ポリシーをアタッチします。 |
|
Webサービス・エンドポイントでのSOAPリクエストの処理を有効にします。 |
|
Webサービス・テスト・クライアントを有効にします。 |
|
WebサービスのWSDLを有効にします。 |
|
Webサービス・エンドポイントの診断ログのログ・レベルを設定します。 |
Oracle Webサービスには、次のセキュリティおよびポリシー注釈が含まれています。
javax.xml.ws.soap.Addressing
注釈は、SOAP 1.1/HTTPバインディングとSOAP 1.2/HTTPバインディングのいずれかでWS-Addressingを使用することを指定します。
次の表は、javax.xml.ws.soap.Addressing
注釈に渡すことができる属性を定義しています。
表A-2 javax.xml.ws.soap.Addressing注釈の属性
属性 | 説明 | デフォルト |
---|---|---|
|
エンドポイントでWS-Addressingをサポートするかどうかを指定するブール値。 |
|
|
WS-Addressingヘッダーが受信メッセージに存在する必要があるかどうかを指定するブール値。 |
|
|
エンドポイントで、匿名、非匿名、すべてのタイプのレスポンスのいずれを使用する必要があるかを指定する値。有効な値は、
|
|
com.oracle.webservices.api.tx.at.AtomicTransaction
注釈は、Webサービスのアトミック・トランザクションを有効にします。
詳細は、『Oracle Infrastructure Webサービスの開発』のWebサービスのアトミック・トランザクションの使用に関する項を参照してください。
注意:
この注釈は、Oracle Infrastructure Web Servicesにのみ適用されます。
次の表は、com.oracle.webservices.api.tx.at.AtomicTransaction
注釈に渡すことができる属性を定義しています。
表A-3 com.oracle.webservices.api.tx.at.AtomicTransaction注釈の属性
属性 | 説明 | デフォルト |
---|---|---|
|
機能を有効にするかどうかを指定するブール値。 |
|
|
Webサービスアトミック・トランザクション調整コンテキストがトランザクション・フローとともに渡されるかどうか。 有効な値は、
有効な値の詳細は、『Oracle Infrastructure Webサービスの開発』のWebサービスのアトミック・トランザクションの構成に関する項を参照してください。 |
|
|
SOAサービスまたはSOA参照に対してサポートされているWebサービス・アトミック・トランザクション調整コンテキストのバージョン。SOA参照の場合、アウトバウンド・メッセージに使用されるバージョンのみを指定します。トランザクション全体で同じ値を指定する必要があります。 有効な値は、
有効な値の詳細は、『Oracle Infrastructure Webサービスの開発』のWebサービスのアトミック・トランザクションの構成に関する項を参照してください。 |
|
com.oracle.webservices.api.Buffering
注釈は、Oracle Infrastructure Webサービスのバッファリングを有効にします。
注意:
この注釈は、Oracle Infrastructure Web Servicesにのみ適用されます。
バッファリングされたWebサービス上の操作が呼び出されると、その呼出しを表すメッセージがJMSキューに格納されます。WebLogic Serverは、このバッファリングされたメッセージを非同期に処理します。メッセージがまだキュー内にある間にWebLogic Serverがダウンした場合、WebLogic Serverが再起動するとすぐに処理されます。
次に例を示します。
@Buffering( enabled=true, requestQueueEnabled=true)
次の表に、com.oracle.webservices.api.Buffering
注釈に渡すことができる属性を定義します。
表A-4 com.oracle.webservices.api.Buffering注釈の属性
属性 | 説明 | デフォルト |
---|---|---|
|
ポリシーが有効かどうかを指定するブール値。 |
|
|
リクエスト・メッセージ・バッファリングに使用する接続ファクトリのJNDI名。この値のデフォルトは、サーバーで定義されているデフォルトのJMS接続ファクトリです。 |
サーバーによって定義されたデフォルトのJMS接続ファクトリ |
|
リクエスト・キューが有効かどうかを指定するフラグ。 |
|
|
リクエスト・バッファリング・キューのJNDI名。 |
"" |
|
リクエスト・バッファリング・キューのメッセージを格納および取得するときにトランザクションを使用するかどうかを指定するフラグ。 |
|
|
レスポンス・メッセージ・バッファリングに使用する接続ファクトリのJNDI名。 |
サーバーによって定義されたデフォルトのJMS接続ファクトリ |
|
レスポンス・キューが有効かどうかを指定するフラグ。 |
|
|
レスポンス・バッファリング・キューのJNDI名。 |
"" |
|
レスポンス・バッファリング・キューのメッセージを格納および取得するときにトランザクションを使用するかどうかを指定するフラグ。 |
|
|
JMSキューが、操作が正常に呼び出されるまでWebサービスの実装にメッセージの配信を試みる回数。 |
|
|
バッファリングされたリクエストとレスポンスの再試行の間隔。この値は、 指定する値はXMLスキーマの期間を表す字句形式( |
|
com.oracle.webservices.api.CacheBinaryContent
注釈は、コンテンツのバイナリ・キャッシュを有効にして、構成します。
注意:
この注釈は、Oracle Infrastructure Web Servicesにのみ適用されます。
次の表は、com.oracle.webservices.api.CacheBinaryContent
注釈に渡すことができる属性を定義しています。
表A-5 com.oracle.webservices.api.CacheBinaryContent注釈の属性
属性 | 説明 | デフォルト |
---|---|---|
|
次のいずれかの値を定義するブール値。
|
|
|
機能を有効にするかどうかを指定するブール値。 |
|
|
OraSAAJのXTIスケーラブルDOMのランタイム要件を指定する値。有効な値は、
|
|
oracle.webservices.annotations.CallbackManagementPolicy
注釈は、クライアント・コールバック・サービスに非同期レスポンスを送信するときに管理ポリシーをアタッチできるようにします。
『Oracle Infrastructure Webサービスの開発』の非同期Webサービスの開発に関する項で説明しているように、この注釈は、oracle.webservices.annotations.async.AsyncWebService
注釈が注釈付けされる非同期Webサービス実装クラスに適用されます。
注意:
この注釈は非推奨になりました。@CallbackPolicySetで説明しているように、oracle.wsm.metadata.annotation.CallbackPolicySet
注釈を使用することをお薦めします。
この注釈は、Oracle Infrastructure Web Servicesにのみ適用されます。
次の表に、oracle.webservices.annotations.async.CallbackManagementPolicy
注釈に渡すことができる属性を定義します。
表A-6 oracle.webservices.annotations.async.CallbackManagementPolicy注釈の属性
属性 | 説明 | デフォルト |
---|---|---|
|
ポリシーが有効かどうかを指定するブール値。 |
|
|
WS-Policyファイルの取得元の場所。Web上のWS-PolicyファイルのURLを指定するには、 |
"" |
oracle.webservices.annotations.async.CallbackMtomPolicy
注釈は、クライアント・コールバック・サービスに非同期レスポンスを送信するときにMTOMポリシーをアタッチします。
注意:
この注釈は非推奨になりました。@CallbackPolicySetで説明しているように、oracle.wsm.metadata.annotation.CallbackPolicySet
注釈を使用することをお薦めします。
この注釈は、Oracle Infrastructure Web Servicesにのみ適用されます。
『Oracle Infrastructure Webサービスの開発』の非同期Webサービスの開発に関する項で説明しているように、この注釈は、oracle.webservices.annotations.async.AsyncWebService
注釈が注釈付けされる非同期Webサービス実装クラスに適用されます。
次の表に、oracle.webservices.annotations.async.CallbackMtomPolicy
注釈に渡すことができる属性を定義します。
表A-7 oracle.webservices.annotations.async.CallbackMtomPolicy注釈の属性
属性 | 説明 | デフォルト |
---|---|---|
|
ポリシーが有効かどうかを指定するブール値。 |
|
|
MTOMポリシー・ファイルの取得元の場所。Web上のMTOMポリシー・ファイルのURLを指定するには、 |
"" |
oracle.wsm.metadata.annotation.CallbackPolicySet
注釈は、コールバック・サービス用の一連のポリシー参照を定義し、オプションでスコープのない構成プロパティ値をオーバーライドします。
注意:
この注釈は、Oracle Infrastructure Web Servicesにのみ適用されます。
次の表は、oracle.wsm.metadata.annotation.CallbackPolicySet
注釈に渡すことができる属性を定義しています。
表A-8 oracle.wsm.metadata.annotation.CallbackPolicySet注釈の属性
属性 | 説明 | デフォルト |
---|---|---|
|
構成オーバーライドのプロパティ値を定義する |
"" |
|
サブジェクトにアタッチするポリシーを定義する |
"" |
oracle.webservices.annotations.async.CallbackSecurityPolicy
注釈は、クライアント・コールバック・サービスに非同期レスポンスを送信するときにセキュリティ・ポリシーをアタッチします。
注意:
この注釈は非推奨になりました。@CallbackPolicySetで説明しているように、oracle.wsm.metadata.annotation.CallbackPolicySet
注釈を使用することをお薦めします。
この注釈は、Oracle Infrastructure Web Servicesにのみ適用されます。
『Oracle Infrastructure Webサービスの開発』の非同期Webサービスの開発に関する項で説明しているように、この注釈は、oracle.webservices.annotations.async.AsyncWebService
注釈が注釈付けされる非同期Webサービス実装クラスに適用されます。
次の表は、oracle.webservices.annotations.async.CallbackSecurityPolicy
注釈に渡すことができる属性の概要を示しています。
表A-9 oracle.webservices.annotations.async.CallbackSecurityPolicy注釈の属性
属性 | 説明 | デフォルト |
---|---|---|
|
オプション。ポリシーが有効かどうかを指定するブール値です。 |
|
|
オプション。プロパティの値と名前の組合せの配列です。 |
"" |
|
WS-Policyファイルの取得元の場所。Web上のWS-PolicyファイルのURLを指定するには、 |
"" |
com.oracle.webservices.api.FastInfosetCallbackClient
注釈は、コールバック・サービスに接続される非同期Webサービスのコールバック・クライアントで、Fast Infosetを有効にして、構成します。
注意:
この注釈は、Oracle Infrastructure Web Servicesにのみ適用されます。
非同期Webサービスおよび非同期コールバック・クライアントの開発の詳細は、『Oracle Infrastructure Webサービスの開発』の非同期Webサービスの開発に関する項を参照してください。Fast Infosetの詳細は、『Oracle Infrastructure Webサービスの開発』のFast Infosetを使用したXML転送の最適化に関する項を参照してください。
次の表は、com.oracle.webservices.api.FastInfosetCallbackClient
注釈に渡すことができる属性を定義しています。
表A-10 com.oracle.webservices.api.FastInfosetCallbackClient注釈の属性
属性 | 説明 | デフォルト |
---|---|---|
|
コンテンツ・ネゴシエーション戦略。有効な値は、
詳細は、次を参照してください。
|
|
|
機能を有効にするかどうかを指定するブール値。 |
|
com.oracle.webservices.api.FastInfosetClient
注釈は、Webサービス・クライアントでFast Infosetを有効にして構成します。
Fast Infosetの詳細は、次を参照してください。
JAX-WS Webサービス: 『Oracle WebLogic Server JAX-WS Webサービスの開発』のFast Infosetを使用したXML転送の最適化に関する項
Oracle Infrastructure Webサービス: 『Oracle Infrastructure Webサービスの開発』のFast Infosetを使用したXML転送の最適化に関する項。
com.oracle.webservices.api.FastInfosetService
注釈は、Webサービス上のFast Infosetを有効にします。
Fast Infosetの詳細は、次を参照してください。
JAX-WS Webサービス: 『Oracle WebLogic Server JAX-WS Webサービスの開発』のFast Infosetを使用したXML転送の最適化に関する項
Oracle Infrastructure Webサービス: 『Oracle Infrastructure Webサービスの開発』のFast Infosetを使用したXML転送の最適化に関する項。
次の表は、com.oracle.webservices.api.FastInfosetService
注釈に渡すことができる属性を定義しています。
表A-11 com.oracle.webservices.api.FastInfosetService注釈の属性
属性 | 説明 | デフォルト |
---|---|---|
|
機能を有効にするかどうかを指定するブール値。 |
|
com.oracle.webservices.api.jms.JMSTransportClient
注釈は、Oracle InfrastructureおよびJAX-WS (Java EE) Webサービス・クライアントに対してSOAP over JMSトランスポートを有効にして、構成します。
SOAP over JMSトランスポートを使用すると、WebサービスとクライアントがHTTP接続ではなくJMS宛先を使用して通信するようになるため、次のような利点があります。
信頼性
スケーラビリティ
サービス品質
SOAP over JMSトランスポートの使用の詳細は、『Oracle WebLogic Server JAX-WS Webサービスの開発』のSOAP Over JMSトランスポートの使用に関する項を参照してください。
注意:
SOAP over JMSトランスポートは、Webサービス機能のうち、信頼性のあるメッセージングおよびHTTPトランスポート固有のセキュリティとは互換性がありません。
Oracle Infrastructure Web Servicesの場合、SOAP over JMSトランスポートは、非同期Webサービスと互換性がありません。
@JMSTransportClient
注釈を使用して構成できる属性については、『Oracle WebLogic Server JAX-WS Webサービスの開発』のJMSトランスポートのプロパティの構成に関する項を参照してください。
@JMSTransportClient ( destinationName="myQueue", replyToName="myReplyToQueue", jndiURL="t3://localhost:7001", jndiInitialContextFactory="weblogic.jndi.WLInitialContextFactory", jndiConnectionFactoryName="weblogic.jms.ConnectionFactory", timeToLive=1000, priority=1, messageType=com.oracle.webservices.api.jms.JMSMessageType.TEXT )
com.oracle.webservices.api.jms.JMSTransportService
注釈は、Oracle InfrastructureおよびJAX-WS (Java EE) Webサービス・クライアントに対してSOAP over JMSトランスポートを有効にして、構成します。
SOAP over JMSトランスポートを使用すると、WebサービスとクライアントがHTTP接続ではなくJMS宛先を使用して通信するようになるため、次のような利点があります。
信頼性
スケーラビリティ
サービス品質
SOAP over JMSトランスポートの使用の詳細は、『Oracle WebLogic Server JAX-WS Webサービスの開発』のSOAP Over JMSトランスポートの使用に関する項を参照してください。
注意:
SOAP over JMSトランスポートは、Webサービス機能のうち、信頼性のあるメッセージングおよびHTTPトランスポート固有のセキュリティとは互換性がありません。
Oracle Infrastructure Web Servicesの場合、SOAP over JMSトランスポートは、非同期Webサービスと互換性がありません。
@JMSTransportService
注釈を使用して構成できる属性については、『Oracle WebLogic Server JAX-WS Webサービスの開発』のJMSトランスポートのプロパティの構成に関する項を参照してください。
@JMSTransportService(destinationName="myQueue", activationConfig = { @ActivationConfigProperty( propertyName = "destinationType", propertyValue = "TOPIC"), @ActivationConfigProperty( propertyName = "subscriptionDurability", propertyValue = "Durable"), @ActivationConfigProperty(propertyName = "topicMessagesDistributionMode", propertyValue = "One-Copy-Per-Application")})
oracle.webservices.annotations.ManagementPolicy
注釈は、管理ポリシーをWebサービスにアタッチします。
注意:
この注釈は非推奨になりました。@PolicyReferenceで説明しているように、oracle.wsm.metadata.annotation.PolicyReference
注釈を使用することをお薦めします。
この注釈は、Oracle Infrastructure Web Servicesにのみ適用されます。
次の表に、oracle.webservices.annotations.ManagementPolicy
注釈に渡すことができる属性を定義します。
表A-12 oracle.webservices.annotations.ManagementPolicy注釈の属性
属性 | 説明 | デフォルト |
---|---|---|
|
ポリシーが有効かどうかを指定するブール値。 |
|
|
WS-Policyファイルの取得元の場所。Web上のWS-PolicyファイルのURLを指定するには、 |
"" |
com.oracle.webservices.api.MaxRequestSize
注釈は、Webサービスに送信可能なリクエスト・メッセージの最大サイズをバイト単位で構成できるようにします。
注意:
この注釈は、Oracle Infrastructure Web Servicesにのみ適用されます。
次の表に、com.oracle.webservices.api.MaxRequestSize
注釈に渡すことができる属性を定義します。
表A-13 com.oracle.webservices.api.MaxRequestSize注釈の属性
属性 | 説明 | デフォルト |
---|---|---|
|
ポリシーが有効かどうかを指定するブール値。 |
|
|
リクエスト・メッセージの最大サイズ(バイト単位)。 |
|
com.oracle.webservices.api.MEXRequestProcessingService
注釈は、Webサービス・メタデータの交換を有効にします。
注意:
この注釈は、Oracle Infrastructure Web Servicesにのみ適用されます。
次の表は、com.oracle.webservices.api.MEXRequestProcessingService
注釈に渡すことができる属性を定義しています。
表A-14 com.oracle.webservices.api.MEXRequestProcessingService注釈の属性
属性 | 説明 | デフォルト |
---|---|---|
|
ポリシーが有効かどうかを指定するブール値。 |
|
javax.xml.ws.soap.MTOM
注釈は、Webサービスでのメッセージ転送最適化メカニズム(MTOM)の使用を有効にします。MTOMは、SOAPメッセージ内のxs:base64Binary
またはxs:hexBinary
タイプのXMLデータの転送を最適化するためのメソッドを定義します。
詳細は、次を参照してください。
『Oracle WebLogic Server JAX-WS Webサービスの開発』のバイナリ・データ送信の最適化に関する項
@MTOM
Javadoc (http://docs.oracle.com/javase/7/docs/api/javax/xml/ws/soap/MTOM.html
)
次の表は、javax.xml.ws.soap.MTOM
注釈に渡すことができる属性を定義しています。
表A-15 javax.xml.ws.soap.MTOM注釈の属性
属性 | 説明 | デフォルト |
---|---|---|
|
MTOMを有効にするかどうかを指定するブール値。 |
|
com.oracle.webservices.api.MTOMEncodeFaultService
注釈は、MTOMが有効になっている場合の、MTOM対応SOAPフォルト・メッセージの作成を有効にします。
注意:
この注釈は、Oracle Infrastructure Web Servicesにのみ適用されます。
次の表は、com.oracle.webservices.api.MTOMEncodeFaultService
注釈に渡すことができる属性を定義しています。
表A-16 com.oracle.webservcies.api.MTOMEncodeFaultService注釈の属性
属性 | 説明 | デフォルト |
---|---|---|
|
MTOMを有効にするかどうかを指定するブール値。 |
|
oracle.webservices.annotations.MtomPolicy
注釈は、MTOMポリシーをWebサービスにアタッチします。
注意:
この注釈は非推奨になりました。@PolicyReferenceで説明しているように、oracle.wsm.metadata.annotation.PolicyReference
注釈を使用することをお薦めします。
この注釈は、Oracle Infrastructure Web Servicesにのみ適用されます。
次の表に、oracle.webservices.annotations.MtomPolicy
注釈に渡すことができる属性を定義します。
表A-17 oracle.webservices.annotations.MtomPolicy注釈の属性
属性 | 説明 | デフォルト |
---|---|---|
|
ポリシーが有効かどうかを指定するブール値。 |
|
|
MTOMポリシー・ファイルの取得元の場所。Web上のMTOMポリシー・ファイルのURLを指定するには、 |
"" |
oracle.webservices.annotations.Persistence
注釈は、Webサービスに、セキュア通信セッション永続性メカニズムを構成します。
注意:
この注釈は、Oracle Infrastructure Web Servicesにのみ適用されます。
次の表は、oracle.webservices.annotations.Persistence
注釈に渡すことができる属性を定義しています。
表A-18 oracle.webservices.annotations.Persistence注釈の属性
属性 | 説明 | デフォルト |
---|---|---|
|
ポリシーが有効かどうかを指定するブール値。 |
|
|
システムに登録されている永続性プロバイダを識別します。次の値を指定できます。
|
|
oracle.wsm.metadata.annotation.PolicyReference
注釈は、サブジェクトに単一ポリシーをアタッチし、オプションで構成プロパティ値をオーバーライドします。
注意:
この注釈は、Oracle Infrastructure WebサービスおよびRESTful Webサービスに適用されます。
次の表は、oracle.wsm.metadata.annotation.PolicyReference
注釈に渡すことができる属性を定義しています。
表A-19 oracle.wsm.metadata.annotation.PolicyReference注釈の属性
属性 | 説明 | デフォルト |
---|---|---|
|
ポリシーが有効かどうかを指定するブール値。 |
|
|
構成オーバーライドのプロパティ値を定義する |
"" |
|
MTOMポリシー・ファイルの取得元の場所。Web上のMTOMポリシー・ファイルのURLを指定するには、 |
"" |
oracle.wsm.metadata.annotation.PolicySet
注釈は、Webサービス用の一連のポリシー参照を定義し、オプションでスコープのない構成プロパティ値をオーバーライドします。
注意:
この注釈は、Oracle Infrastructure Web Servicesにのみ適用されます。
次の表は、oracle.wsm.metadata.annotation.PolicySet
注釈に渡すことができる属性を定義しています。
表A-20 oracle.wsm.metadata.annotation.PolicySet注釈の属性
属性 | 説明 | デフォルト |
---|---|---|
|
構成オーバーライドのプロパティ値を定義する |
"" |
|
サブジェクトにアタッチするポリシーを定義する |
"" |
com.oracle.webservices.api.POXHttpBindingService
注釈は、ユーザー定義のjavax.xml.ws.Provider<T>.invoke
メソッドによって処理される非SOAP XMLメッセージをエンドポイントで受信できるようにします。
注意:
この注釈は、Oracle Infrastructure Web Servicesにのみ適用されます。
次の表は、com.oracle.webservices.api.POXHttpBindingService
注釈に渡すことができる属性を定義しています。
表A-21 com.oracle.webservcies.api.POXHttpBindingService注釈の属性
属性 | 説明 | デフォルト |
---|---|---|
|
MTOMを有効にするかどうかを指定するブール値。 |
|
oracle.wsm.metadata.annotation.Property
注釈は、1つ以上のポリシーの構成のオーバーライドに使用できる単一プロパティを指定します。
注意:
この注釈は、Oracle Infrastructure WebサービスおよびRESTful Webサービスに適用されます。
次の表は、oracle.wsm.metadata.annotation.Property
注釈に渡すことができる属性を定義しています。
表A-22 oracle.wsm.metadata.annotation.Property注釈の属性
属性 | 説明 | デフォルト |
---|---|---|
|
スコープのない構成オーバーライドのプロパティ値を定義する |
"" |
|
サブジェクトにアタッチするポリシーを定義する |
"" |
oracle.webservices.annotations.ReliabilityPolicy
注釈は、信頼できるメッセージング・ポリシーoracle/wsrm10_policy
またはoracle/wsrm10_policy
をWebサービスにアタッチします。
注意:
この注釈は非推奨になりました。@ReliableMessagingで説明しているように、com.oracle.webservices.api.rm.ReliableMessaging
注釈を使用することをお薦めします。
この注釈は、Oracle Infrastructure Web Servicesにのみ適用されます。
次の表は、oracle.webservices.annotations.ReliabilityPolicy
注釈に渡すことができる属性を定義しています。
表A-23 oracle.webservices.annotations.ReliabilityPolicy注釈の属性
属性 | 説明 | デフォルト |
---|---|---|
|
ポリシーが有効かどうかを指定するブール値。 |
|
|
信頼できるメッセージング・ポリシー・ファイルの取得元の場所。Web上の信頼できるメッセージング・ポリシー・ファイルのURLを指定するには、 |
"" |
com.oracle.webservices.api.rm.ReliableMessaging
注釈は、oracle/reliable_messaging_policy
ポリシーをWebサービスにアタッチします。
注意:
この注釈は、Oracle Infrastructure Web Servicesにのみ適用されます。
次の表は、oracle.webservices.annotations.ReliableMessaging
注釈に渡すことができる属性を定義しています。
表A-24 oracle.webservices.annotations.ReliableMessaging注釈の属性
属性 | 説明 | デフォルト |
---|---|---|
|
ポリシーが有効かどうかを指定するブール値。 |
|
|
信頼できるメッセージング・ポリシー・ファイルの取得元の場所。Web上の信頼できるメッセージング・ポリシー・ファイルのURLを指定するには、 |
"" |
com.oracle.webservices.api.RequestProcessingService
注釈は、Webサービス・エンドポイントで着信リクエストを処理できるようにします。
注意:
この注釈は、Oracle Infrastructure Web Servicesにのみ適用されます。
次の表は、oracle.webservices.annotations.RequestProcessingService
注釈に渡すことができる属性を定義しています。
表A-25 oracle.webservices.annotations.RequestProcessingService注釈の属性
属性 | 説明 | デフォルト |
---|---|---|
|
ポリシーが有効かどうかを指定するブール値。 |
|
com.oracle.webservices.api.SchemaValidation
注釈は、スキーマに対するリクエスト・メッセージの検証を有効にします。
注意:
この注釈は、Oracle Infrastructure Web Servicesにのみ適用されます。
次の表は、oracle.webservices.annotations.SchemaValidation
注釈に渡すことができる属性を定義しています。
表A-26 oracle.webservices.annotations.SchemaValidation注釈の属性
属性 | 説明 | デフォルト |
---|---|---|
|
ポリシーが有効かどうかを指定するブール値。 |
|
oracle.webservices.annotations.SecurityPolicies
注釈は、oracle.webservices.annotations.SecurityPolicy
注釈の配列を指定します。複数のWS-Policyファイルをクラスにアタッチする場合は、この注釈を使用します。
注意:
この注釈は非推奨になりました。@PolicySetで説明しているように、oracle.wsm.metadata.annotation.PolicySet
注釈を使用することをお薦めします。
この注釈は、Oracle Infrastructure Web Servicesにのみ適用されます。
次に例を示します。
@SecurityPolicies({ @SecurityPolicy(uri= "policy:oracle/wss10_username_token_with_message_protection_server_policy"), @SecurityPolicy(uri="policy:oracle/authorization_policy")
weblogic.wsee.jws.jaxws.owsm.SecurityPolicies
注釈は、weblogic.wsee.jws.jaxws.owsm.SecurityPolicy
注釈の配列を指定します。複数のWS-Policyファイルをクラスにアタッチする場合は、この注釈を使用します。
注意:
この注釈は、Java EE Webサービスにのみ適用されます。
oracle.webservices.annotations.SecurityPolicy
注釈は、セキュリティ・ポリシーをリクエストSOAPメッセージまたはレスポンスSOAPメッセージにアタッチします。この注釈を単独で使用して、単一のWS-Policyファイルをクラスに適用できます。複数のWS-Policyファイルをクラスに適用する場合は、@SecurityPolicies
注釈を使用してそれらのファイルを1つにまとめます。
注意:
この注釈は非推奨になりました。@PolicyReferenceで説明しているように、oracle.wsm.metadata.annotation.PolicyReference
注釈を使用することをお薦めします。
この注釈は、Oracle Infrastructure Web Servicesにのみ適用されます。
次の表は、oracle.webservices.annotations.SecurityPolicy
注釈に渡すことができる属性をまとめたものです。
表A-27 oracle.webservices.annotations.SecurityPolicy注釈の属性
属性 | 説明 | デフォルト |
---|---|---|
|
オプション。ポリシーが有効かどうかを指定するブール値です。 |
|
|
オプション。プロパティの値と名前の組合せの配列です。 |
"" |
|
WS-Policyファイルの取得元の場所。Web上のWS-PolicyファイルのURLを指定するには、 |
"" |
weblogic.wsee.jws.jaxws.owsm.SecurityPolicy
注釈は、リクエストまたはレスポンスSOAPメッセージにセキュリティ・ポリシーをアタッチします。この注釈を単独で使用して、単一のWS-Policyファイルをクラスに適用できます。複数のWS-Policyファイルをクラスに適用する場合は、@SecurityPolicies
注釈を使用してそれらのファイルを1つにまとめます。
注意:
この注釈は、Java EE Webサービスにのみ適用されます。
次の表は、weblogic.wsee.jws.jaxws.owsm.SecurityPolicy
注釈に渡すことができる属性の概要を示しています。
表A-28 weblogic.wsee.jws.jaxws.owsm.SecurityPolicy注釈の属性
属性 | 説明 | デフォルト |
---|---|---|
|
オプション。ポリシーが有効かどうかを指定するブール値です。 |
|
|
WS-Policyファイルの取得元の場所。Web上のWS-PolicyファイルのURLを指定するには、 |
"" |
このcom.oracle.webservices.api.SOAPRequestProcessingService
注釈は、Webサービス・エンドポイントでのSOAPリクエストの処理を有効にします。
注意:
この注釈は、Oracle Infrastructure Web Servicesにのみ適用されます。
次の表は、oracle.webservices.annotations.SOAPRequestProcessingService
注釈に渡すことができる属性を定義しています。
表A-29 oracle.webservices.annotations.SOAPRequestProcessingService注釈の属性
属性 | 説明 | デフォルト |
---|---|---|
|
ポリシーが有効かどうかを指定するブール値。 |
|
com.oracle.webservices.api.TestPageProcessingService
注釈は、Webサービス・テスト・クライアントを有効にします。この注釈は、Oracle Infrastructure Web Servicesにのみ適用されます。
詳細は、Webサービスの管理のWebサービス・テスト・クライアントの使用に関する項を参照してください。
注意:
この項で説明している手順が、Fusion Middleware Controlの「Webサービスのテスト」ページにアクセスできるようにする「Webサービス・エンドポイント」ページ上の「Webサービスのテスト」リンクの可用性に影響を与えることはありません。詳細は、『Webサービスの管理』のFusion Middleware Controlの「Webサービスのテスト」ページの使用に関する項を参照してください。
次の表は、oracle.webservices.annotations.TestPageProcessingService
注釈に渡すことができる属性を定義しています。
表A-30 oracle.webservices.annotations.TestPageProcessingService注釈の属性
属性 | 説明 | デフォルト |
---|---|---|
|
ポリシーが有効かどうかを指定するブール値。 |
|
このcom.oracle.webservices.api.WSDLRequestProcessingService
注釈は、WebサービスのWSDLへのアクセスを有効にします。
注意:
この注釈は、Oracle Infrastructure Web Servicesにのみ適用されます。
次の表は、oracle.webservices.annotations.WSDLRequestProcessingService
注釈に渡すことができる属性を定義しています。
表A-31 oracle.webservices.annotations.WSDLRequestProcessingService注釈の属性
属性 | 説明 | デフォルト |
---|---|---|
|
ポリシーが有効かどうかを指定するブール値。 |
|
このcom.oracle.webservices.api.WSLoggingLevel
注釈は、Webサービス・エンドポイントの診断ログのログ・レベルを設定します。
注意:
この注釈は、Oracle Infrastructure Web Servicesにのみ適用されます。
次の表は、oracle.webservices.annotations.WSLoggingLevel
注釈に渡すことができる属性を定義しています。
表A-32 oracle.webservices.annotations.WSLoggingLevel注釈の属性
属性 | 説明 | デフォルト |
---|---|---|
|
ポリシーが有効かどうかを指定するブール値。 |
|
|
ロギング・レベルを定義します。有効な値は、SEVERE、WARNING、INFO、CONFIG、FINE、FINER、FINESTまたはNULLです。 |
"" |