7 Webサービス

この章では、Oracle Web Services Managerを含むWebサービス開発、セキュリティおよび管理に関連する問題について説明します。

内容は次のとおりです。

• 7.1項「マルチバイトのユーザー資格証明のwss_http_token_*ポリシーでの使用」

• 7.2項「ポリシーの一括アップロードの実行」

• 7.3項「デプロイ後のカスタマイズの削除」

• 7.4項「ローカライズの制限の確認」

• 7.5項「2つのサーバーがSSL対応(双方向SSL)である場合にFusion Middleware Controlにポリシーがリストされない」

• 7.6項「「Webサービスのテスト」ページでSOAPヘッダーにバインドされた入力引数をテストできない」

• 7.7項「カスタムExactly-oneポリシーの使用時に発生する可能性のある制限」

• 7.8項「OWSMとWebLogic Server間で使用されるセキュリティ・ポリシーの「サービスの互換性」エラーは無視する」

• 7.9項「サブスクライバ・メディエータ・コンポーネントでセキュリティ・ポリシーが機能しない」

• 7.10項「一部のロケールでアタッチされているポリシーがポリシー表に表示されない」

• 7.11項「WebLogic Webサービス・クライアントに対して使用状況トラッキングを使用できない」

• 7.12項「permitallおよびdenyallポリシーは同じWebサービスにアタッチしない」

• 7.13項「スコープが設定されたオーバーライドが同じポリシーへの後続の参照に対し保持される」

• 7.14項「アプリケーションを再起動して正確なポリシーの使用状況数を取得する」

• 7.15項「Webサービス・ポリシー・ページのパフォーマンスの改善」

• 7.16項「誤った互換性のあるクライアント・ポリシー・リスト」

• 7.17項「カスタムExactlyOneポリシーに安全な会話要素が表示される」

• 7.18項「現在のリリースではWebサービスの信頼できるメッセージングはサポートされていない」

• 7.19項「現在のリリースではポリシーの一括アタッチはサポートされていない」

• 7.20項「クライアント・ポリシーの編集後に「OWSMポリシー」ページに戻る」

• 7.21項「KSSおよびHSMキーストア構成の変更が表示されない」

• 7.22項「JKS構成画面に誤った値が表示される」

• 7.23項「Fusion Middleware Controlでトークン属性ルールの構成が正しく機能しない」

• 7.24項「RESTアプリケーションを保護するときにコンテキスト・ルートを「/」に設定してはいけない」

• 7.25項「クラスパス・モードでドメイン構成はサポートされていない」

• 7.26項「OWSMの「ドメイン構成」ページの「認証」タブでSAML信頼を編集した後に「適用」/「元に戻す」ボタンがアクティブ化されない」

• 7.27項「例による問合せ機能が動作しない」

• 7.28項「署名付きのSAMLトークンにSTS証明書がない場合にNPEがスローされることがある」

• 7.29項「XML暗号への攻撃の回避」

• 7.30項「今回のリリースではクロスドメイン・ポリシー・マネージャの構成はサポートされていない」

• 7.31項「プロキシを誤って構成するとOWSMイントロスペクション・プラグインが失敗する」

• 7.32項「統合されたフォルト・コードでBadContextTokenが処理されない」

• 7.33項「Oracle Infrastructure Webサービスの非推奨コマンド」

注意: WebLogic Webサービスの詳細は、『Oracle Fusion Middleware Oracle WebLogic Serverリリース・ノート』のWebサービスとXMLの問題と回避策に関する説明を参照してください。

7.1 マルチバイトのユーザー資格証明のwss_http_token_*ポリシーでの使用

このリリースでは、マルチバイトのユーザー資格証明はwss_http_token_*ポリシーでサポートされていません。マルチバイトのユーザー資格証明が必要な場合、wss_username_token_*ポリシーなどの別のポリシーを使用します。利用可能なポリシーの詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』の事前定義ポリシーに関する説明を参照してください。

7.2 ポリシーの一括アップロードの実行

ポリシーのMDSリポジトリへの一括インポート時、操作が初めに成功しなかった場合、一括インポートが成功するまで操作を再試行します。

ほとんどの場合、これは、Oracle RACデータベースでメタデータのアップロード時にデータベースが切り替えられるときに起こります。Oracle RACデータベースにn個のデータベースがある場合、この操作をn回再試行する可能性があります。

ポリシーの一括インポートの詳細は、『Webサービスの管理』のポリシーの移行に関する説明を参照してください。

7.3 デプロイ後のカスタマイズの削除

AdfConnection MBeanを使用したデプロイ後にconnections.xmlファイルを変更すると、完全な接続がカスタマイズとして保存されます。つまり、再デプロイされたアプリケーションの接続に対する変更は、カスタマイズによって上書きされます。

Fusion Middleware Controlを使用してデプロイ後にアプリケーションのconnections.xmlファイルを変更すると、新しいconnections.xmlファイルがカスタマイズとして作成され、MDSリポジトリに格納されます。このカスタマイズは、アプリケーションの有効期間中は保持されます。したがって、アプリケーションを再デプロイしても、カスタマイズされたconnections.xmlファイルは、引き続きアプリケーションに対するカスタマイズとして適用されます。

(Fusion Middleware Controlによる)前のカスタマイズではなく、再デプロイされたアプリケーションのconnections.xmlファイルを適用するには、MDSリポジトリから明示的にconnections.xmlのカスタマイズを削除する必要があります。

たとえば、Webサービスのデータ・コントロールを含むアプリケーションをデプロイする場合、Fusion Middleware Controlを使用してusername_token_client_policyをアタッチし、続けてポリシーをデタッチします。次に、JDeveloperに戻ってアプリケーションを編集し、http_token_client_policyをアタッチしてアプリケーションを再デプロイします。Fusion Middleware Controlを使用してアプリケーションを表示すると、アタッチしたhttp_token_client_policyが使用されていないことがわかります。これは、Fusion Middleware Controlを使用して前に作成したカスタマイズ済のconnections.xmlファイルが使用されていることが原因です。

MDSリポジトリからconnections.xmlのカスタマイズを削除すると、アプリケーションでは独自のconnections.xmlファイルが使用されます。

7.4 ローカライズの制限の確認

このリリースのOracle Enterprise Managerでは、次の情報は英語でのみサポートされます。

• ポリシーおよびアサーション・テンプレートのorawsp:displayNameフィールド以外のすべてのフィールド。

• ?orawsdlブラウザ・アドレスを使用する場合のorawsp:descriptionフィールド。

7.5 2つのサーバーがSSL対応(双方向SSL)である場合にFusion Middleware Controlにポリシーがリストされない

管理対象サーバーが双方向SSL対応の場合(たとえば、双方向SSLを介してOWSMポリシー・マネージャをホストするSOAサーバーなど)、Fusion Middleware Controlをホストする管理サーバーがその双方向SSL対応の管理対象サーバーにアクセスするよう正しく構成されていても、Fusion Middleware ControlにはOWSMポリシーがリストされません。

7.6 「Webサービスのテスト」ページでSOAPヘッダーにバインドされた入力引数をテストできない

SOAPヘッダーにバインドされた入力引数を持つWebサービスでは、Fusion Middleware Controlコンソールの「Webサービスのテスト」ページにメッセージが表示されません。したがって、このような操作は、「Webサービスのテスト」ページではテストできません。

たとえば、マルチパートWSDLの入力をFusion Middleware Controlを通じて表示する場合、一方の入力引数がSOAPヘッダーにバインドされていると、他方のメッセージが入力から欠落するため、コンポジット・インスタンスは次の例外とともに失敗します。

ORAMED-01203:[No Part]No part exist with name "request1" in source message

この問題を解決するには、入力引数のXML表示を選択し、WSDLの2つのパートの入力を渡せるようにペイロードを編集します。

7.7 カスタムExactly-oneポリシーの使用時に発生する可能性のある制限

一部の状況では、カスタムExactly-oneポリシーの使用時に制限が発生します。Exactly-oneポリシー内のアサーションのセットで、リクエスト・メッセージが最初のアサーションに一致した場合、最初のアサーションが実行され、対応するレスポンスが送信されます。ただし、一部の状況では、リクエストが後続のアサーションとの一致を意図しているために、この動作では適切でないことがあります。

たとえば、Timestamp=ONであるクライアント・ポリシーと、メッセージ保護アサーション(1つ目はTimestamp=OFF、2つ目はTimestamp=ON)付きのwss11 username tokenを持つサービスexactly-oneポリシーがあるとします。したがって、サービスexactly-oneポリシー内の1つ目のアサーションはリクエスト内のタイムスタンプを予期していませんが、2つ目のアサーションは予期しています。この場合、1つ目のアサーションが実行されると、レスポンスはタイムスタンプなしで送信されます。しかし、クライアント側の処理は、リクエストで送信されたタイムスタンプを予期しているため、失敗します。

この制限は、クライアント・ポリシーでより多くの数の要素が署名されるとみなされる一方で、サービス・ポリシーではそれに対応していない場合に発生する可能性があります。

7.8 OWSMとWebLogic Server間で使用されるセキュリティ・ポリシーの「サービスの互換性」エラーは無視する

Fusion Middleware Controlでは、サービス・ポリシーの互換性の検証時に間違ったエラー・メッセージが表示される可能性があります。この互換性メッセージが表示されるのは、Enterprise Managerを使用してOWSMセキュリティ・クライアント・ポリシーをアタッチする場合です。「サービスの互換性をチェックします」をクリックすると、ポリシーには互換性があるはずだが、これらに互換性がないことを示すメッセージが表示されます。

回避策:

OWSMポリシーがWebサービス・エンドポイントにアタッチされている場合、対応するクライアント・ポリシーを使用します。たとえば、サービスにwss11_saml_or_username_token_with_message_protection_service_policyがある場合、クライアント側ではwss11_saml_token_with_message_protection_client_policyまたはwss11_username_token_with_message_protection_client_policyが機能します。WSM以外のポリシーがWebサービスにアタッチされている場合は、対応するクライアント・ポリシーの詳細について『Oracle Web Services Manager相互運用性ソリューション・ガイド』を参照し、これをアタッチしてください。

7.9 サブスクライバ・メディエータ・コンポーネントでセキュリティ・ポリシーが機能しない

コンポーネント認可denyallポリシーは、サブスクライバ・メディエータ・コンポーネントで機能しません。認可ポリシーは、他の通常のメディエータ・コンポーネントで機能します。

7.10 一部のロケールでアタッチされているポリシーがポリシー表に表示されない

Fusion Middleware ControlでWebサービス・アプリケーションを選択し、Webサービス・エンドポイントにナビゲートします。「アタッチ/デタッチ」ページでエンドポイントにポリシーをアタッチします。場合によっては、一部のロケール(zh-cn、zh-tw、ja、pt-br、es、fr、ko)でアタッチされているポリシーが「直接アタッチされたポリシー」表に表示されない可能性があります。

回避策としては、列のサイズを大きくします。

7.11 WebLogic Webサービス・クライアントに対して使用状況トラッキングを使用できない

このリリースでは、WebLogic Java EE Webサービス・クライアントに対して使用状況トラッキングおよび分析は提供されていません。

7.12 permitallおよびdenyallポリシーは同じWebサービスにアタッチしない

同じWebサービスに複数の認可ポリシーをアタッチできますが、permitallとdenyallの両方のポリシーをアタッチしないでください。ただし、両方ともアタッチすると、このリリースではこの組合せは検証に成功します。

回避策:

permitallおよびdenyallポリシーは同じWebサービスにアタッチしないでください。認可ポリシーの詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』の認可の構成に関する説明を参照してください。

7.13 スコープが設定されたオーバーライドが同じポリシーへの後続の参照に対し保持される

メッセージ保護ポリシーを使用してサーバー側のアイデンティティ/暗号化鍵(keystore.enc.csf.key)にスコープが設定されたオーバーライドを使用する場合、オーバーライド値はポリシーに保存されます。ポリシーはキャッシュされるため、別のサービスによるこのポリシーへの後続の参照には、オーバーライド値が含まれます。そのため、結果は予期しないものになります。

このシナリオの例は、次のとおりです。

• Oracle Infrastructure Webサービスにはアタッチされたメッセージ保護サービス・ポリシーがあります。両方のサービス・アイデンティティ(サービス公開暗号化鍵、keystore.enc.csf.key)とサービス・メッセージ保護ポリシーはサービスWSDLで通知されます。サービス暗号化鍵がグローバルsetWSMPolicyOverrideコマンドなどを使用して上書きされると、初期サービスの特定の添付/参照用だったkeystore.enc.csf.keyプロパティのスコープが設定された上書きされた値は、同じポリシーへの別のサービスの添付/参照に影響を与える可能性があります。

回避策

推奨する回避策は、可能なときにキャッシュのリフレッシュを実行することです。たとえば、ポリシーの添付/参照に、プロパティkeystore.enc.csf.keyのスコープが設定されたオーバーライドがあり、一度強制されたか通知された場合、キャッシュされたポリシーにはオーバーライドが含まれますが、リポジトリ内の元のポリシーには影響がありません。オーバーライドをクリアするには、サーバーの再起動、アプリケーションの再デプロイ、Fusion Middleware Controlを使用したポリシーの変更などの方法を使用して、キャッシュをリフレッシュします。

しかし、状況によっては、キャッシュのリフレッシュを実行できないこともあります。たとえば、ポリシーの添付/参照があるサービスに、プロパティkeystore.enc.csf.keyのスコープが設定されたオーバーライドがあり、手動でキャッシュをリフレッシュする時間のない実行のフローで、同じポリシーを参照する別のサービスの前に強制された場合、後続のサービスにより参照されるキャッシュ内のポリシーには構成のオーバーライドが含まれます。たとえば、同じポリシーが非同期リクエストと非同期コールバック・クライアントの両方にアタッチされた非同期サービスで、非同期リクエストの添付/参照のみにオーバーライドがある(非同期コールバックにはない)場合、非同期コールバック・ポリシーの強制が、非同期リクエストの後に発生します。この場合、コールバック・クライアントは構成のオーバーライドを含むキャッシュ内のポリシーにアクセスします。キャッシュをリフレッシュする機会がないため、使用できる回避策はありません。

7.14 正確なポリシーの使用状況数を取得するためのアプリケーションの再起動

Webサービスで参照されるポリシーが削除されてから再度インポートされる場合、その使用状況数は正確でないため、アプリケーションを再起動して正確な使用状況数を取得する必要があります。

7.15 Webサービス・ポリシー・ページのパフォーマンスの改善

不要なロールの問合せを削除することで、Fusion Middleware ControlのWebサービス・ポリシー・ページのパフォーマンスが改善されています。

7.16 誤った互換性のあるクライアント・ポリシー・リスト

『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のWSDLからのクライアント・ポリシーの生成に関する説明で示すように、WSDLからクライアント・ポリシーを生成する場合、次のポリシーがアタッチされた対応するWebサービスに対して、互換性のあるクライアント・ポリシーのリストにwss_username_token_over_ssl_client_policyポリシーが戻されません。

wss11_saml_or_username_token_with_message_protection_service_policy

『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のポリシーのWebサービス・クライアントへの直接的なアタッチに関する説明で示すように、このクライアント・ポリシーは、同じクライアントにポリシーをアタッチすると、互換性のあるクライアント・ポリシーのリストに表示されます。

7.17 カスタムExactlyOneポリシーに安全な会話要素が表示される

安全な会話ポリシーを使用してExactlyOneポリシーを作成する場合、新しく作成したポリシーにsecure-conversation要素が存在することがあります。OWSMは現在、secure-conversation要素の使用をサポートしていません。この要素は無視して構いません。安全な会話をサポートするポリシーの詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のWS-SecureConversationをサポートするポリシーに関する説明を参照してください。

7.18 現在のリリースではWebサービスの信頼できるメッセージングはサポートされていない

WebLogic Server 12c (12.1.2) JAX-WS WS-ReliableMessaging実装は一般に本番目的には適切でなく、デフォルトで無効になっています。また、WebLogic Serverのサンプル・サーバーとともに提供されるWebサービスの信頼できるメッセージング・サンプル・アプリケーションもデフォルトで無効になっています。

WebLogic Server 12c (12.1.2)で評価用にJAX-WS WS-ReliableMessagingの使用を希望するカスタマ、またはJAX-WS WS-ReliableMessaging機能を本番用に使用する必要があるカスタマは、Oracleカスタマ・サポートにご連絡ください。

http://www.oracle.com/us/support/index.html

7.19 現在のリリースではポリシーの一括アタッチはサポートされていない

現在のリリースでは、一括アタッチ機能を使用して1つ以上のポリシーを1つ以上のWebサービスにアタッチすることはサポートされていません。かわりに、ポリシー・セット機能を使用します。ポリシー・セットの詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のWLSTを使用したポリシー・セットによるポリシーのグローバルなアタッチに関する説明とポリシー・セットに対するスキーマ参照に関する説明を参照してください。

7.20 クライアント・ポリシーの編集後に「OWSMポリシー」ページに戻る

Enterprise Managerでクライアント・ポリシーを生成すると、「クライアント・ポリシーの生成」ページが表示され、生成したポリシーは保存されていないと表示されます。ポリシーを保存してからそれらのいずれかを編集すると、「OWSMポリシー」ページに戻ります。これはEnterprise Managerのエラーです。本来は「クライアント・ポリシーの生成」ページに戻る必要があります。

他のポリシーを編集するには、「OWSMポリシー」ページの検索機能を使用して、編集するクライアント・ポリシーを検索します。

詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のWSDLからのクライアント・ポリシーの生成に関する説明を参照してください。

7.21 KSSおよびHSMキーストア構成の変更が表示されない

OWSMの「ドメイン構成」ページでキーストア・サービス(KSS)またはハードウェア・セキュリティ・モジュール(HSM)構成の変更を保存する場合、変更は実装されますが、表示されません(変更が行われたことがページに表示されません)。

OWSMの「ドメイン構成」ページにおけるKSSおよびHSMキーストアの構成の詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のKSSキーストアを使用するためのOWSMの構成に関する説明とHSMキーストアを使用するためのOWSMの構成に関する説明を参照してください。

7.22 JKS構成画面に誤った値が表示される

KSS用にOWSMキーストアを構成してからJKSキーストアを構成しようとすると、JKS構成画面の「パス」フィールドと「キー」メニューにKSSキーストアの値が入力されます。

回避策: JKSキーストアを構成する前に、JKS構成画面の「パス」および「キー」フィールドを消去します。OWSMでのJKSキーストアの構成の詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のJKSキーストアを使用するためのOWSMの構成に関する説明を参照してください。

7.23 Fusion Middleware Controlでトークン属性ルールの構成が正しく機能しない

Fusion Middleware Controlの「ドメイン構成」ページの「認証」タブで、信頼できる発行者用のトークン属性ルールの構成は正しく機能しません。回避策として、WLSTコマンドを使用してトークン属性ルールを構成します。

Fusion Middleware Controlでのトークン属性ルールの構成については、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のFusion Middleware Controlを使用した信頼できる発行者用のトークン属性ルールの構成に関する説明を参照してください。WLSTを使用したトークン属性ルールの構成については、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のWLSTを使用したSAMLの信頼できる発行者、DNリストおよびトークン属性ルールの構成に関する説明を参照してください。

7.24 RESTアプリケーションを保護するときにコンテキスト・ルートを「/」に設定してはいけない

OWSMポリシーを使用してRESTアプリケーションを保護する場合、このアプリケーションのコンテキスト・ルートをフォワード・スラッシュ(「/」)以外の値に設定する必要があります。

7.25 クラスパス・モードでドメイン構成はサポートされていない

ポリシー・マネージャURLがクラスパスとして構成されている場合、ドメインレベルの構成はサポートされていません。すべてのドメインレベルの構成情報は、クラスパスに含まれるJARファイルではなく、OWSMリポジトリに格納されています。ポリシー・マネージャURLの構成の詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』の次の項を参照してください。

• 「Fusion Middleware Controlを使用したポリシー・マネージャの接続の構成」

• 「WLSTを使用したポリシー・マネージャの接続の構成」

ドメインレベルの構成を管理する場合は、リモート・ドメインを指定するか、autoモードを使用するようにポリシー・マネージャURLを構成します。新しいポリシー・マネージャURLモードを構成したら、サーバーを再起動してそれを有効にする必要があります。

7.26 OWSMの「ドメイン構成」ページの「認証」タブでSAML信頼を編集した後に「適用」/「元に戻す」ボタンがアクティブ化されない

OWSMの「ドメイン構成」ページの「認証」タブでSAMLの信頼できる発行者とDNリストを編集する場合、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のFMCを使用したSAMLの信頼できる発行者とDNリストの構成に関する説明に示すように、このページで別のフィールドを編集するまで「適用」および「元に戻す」ボタンがアクティブ化しません。必要に応じて、ボタンをアクティブ化するために別のフィールドで「ダミー」編集を行います。

7.27 例による問合せ機能が動作しない

『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』の例による問合せフィルタの使用に関する説明(Webサービス・ポリシー用)と例による問合せフィルタの使用に関する説明(アサーション・テンプレート用)で、特定のフィールドを問い合せてポリシーとアサーション・テンプレートを検索する方法について説明しています。この機能は現在のリリースでは動作しません。

回避策: この問題を回避するには、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』の拡張検索の使用に関する説明(Webサービス・ポリシー用)および拡張検索の使用に関する説明(アサーション・テンプレート用)に従って、拡張検索ユーティリティを使用します。

7.28 署名付きのSAMLトークンにSTS証明書がない場合にNPEがスローされることがある

デフォルトでは、Oracle Security Token Service (OSTS)で、STSから返される署名付きのSAMLトークン内にSTS署名証明書は含まれていません。OWSMは、SAML署名内にSTS証明書がない署名付きのトークンを見付けると、NullPointerException (NPE)をスローします。

回避策: この問題を回避するには、署名付きのSAMLトークンにSTS証明書が存在することを確認します。STS用ポリシーの構成の詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のSTS用の自動ポリシー構成の設定に関する説明を参照してください。

7.29 XML暗号への攻撃の回避

以前のリリースでは、OWSMは異なるエラーに対して異なるフォルト・コード(FailedAuthentication、InvalidSecurityToken、FailedCheckなど)を送信していましたが、現在のリリースでは、このデフォルトの動作が変更されています。OWSMは、すべてのエラーに対してInvalidSecurityフォルト・コードを送るようになりました。これは、XML暗号への攻撃を回避するためです。サービスが異なるタイプのエラーに対して異なるフォルト・コード(FailedAuthentication、InvalidSecurityToken、FailedCheckなど)を送信する場合、暗号への攻撃が可能です。このデフォルトの動作は、ドメイン全体のエージェント・プロパティuse.unified.fault.codeをfalseに設定することで変更できます。ただし、これによってXML暗号への攻撃が可能になる場合があるため、お薦めしません。このプロパティのデフォルト値「true」では、OWSMはすべてのエラーに対してInvalidSecurityフォルト・コードを送信します。use.unified.fault.codeプロパティの詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のWLSTを使用したセキュリティ・ポリシーの強制の構成に関する説明を参照してください。

7.30 今回のリリースではクロスドメイン・ポリシー・マネージャの構成はサポートされていない

リモート・ドメインでのポリシー・マネージャの構成は、今回のリリースではサポートされていません。したがって、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』の次のトピックで説明しているリモート・ポリシー・マネージャに接続する手順は、本番環境ではお薦めしません。

• リモート・ポリシー・マネージャへの接続の構成

• Fusion Middleware Controlを使用したポリシー・マネージャの接続の構成

• WLSTを使用したポリシー・マネージャの接続の構成

7.31 プロキシを誤って構成するとOWSMイントロスペクション・プラグインが失敗する

OWSMはOracle Virtual Assembly Builder用に、インストールされたOracleコンポーネントを仮想化して変更した後、Oracle VM環境にデプロイするためのツール、イントロスペクション・プラグインを提供します。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のOracle Virtual Assembly Builder用OWSMイントロスペクション・プラグインに関する説明を参照してください。

OWSMイントロスペクション・プラグインは、abctl introspectWLS12コマンドまたはOracle Virtual Assembly Builder Studio (abstudio.sh)を使用してWebLogicドメインのイントロスペクションを行う場合に実行されます。このイントロスペクションは、次の条件で失敗する場合があります。

• 管理サーバーのリスニング・アドレスが、localhostとは異なる特定のアドレスでリスニングするように構成されている場合。

  回避策:

  1. Oracle WebLogic Server管理コンソール・オンライン・ヘルプのリスニング・アドレスの構成に関する説明に従って、管理コンソールで管理サーバーのリスニング・アドレスを消去し、ローカル・アドレスを有効にします。

  2. 管理サーバーのリスニング・アドレスをlocalhostに設定します。

• イントロスペクション中にプロキシ設定を実行する場合。ネットワーク環境にプロキシ・サーバーが必要で、イントロスペクションを実行するために使用するツール(abctlやabstudio.shなど)でプロキシ構成を利用できない場合、このイントロスペクションは失敗することがあります。

  回避策:

  abstudio.shを使用してイントロスペクションを行う場合、localhostに対するプロキシ設定をバイパスする必要があります。プロキシ構成の詳細は、『Oracle Virtual Assembly Builderリリース・ノート』を参照してください。

  abctlを使用してイントロスペクションを行う場合、Javaアプリケーション用の標準プロキシ構成プロパティを使用します。abctlコマンドを発行する前に、SYSPROPS環境変数を使用して環境にプロパティを設定し、localhostに対するプロキシ設定をバイパスします。たとえば、使用しているシェルに応じて次のいずれかのコマンドを使用します。

  csh: setenv SYSPROPS '-Dhttp.proxyHost=myProxyHost -Dhttp.proxyPort=NN -Dhttp.nonProxyHosts=localhost|n.n.n.n

  sh/bash/ksh: export SYSPROPS '-Dhttp.proxyHost=myProxyHost -Dhttp.proxyPort=NN -Dhttp.nonProxyHosts=localhost|n.n.n.n

  
  

  注意: 実際のプロキシ設定は環境固有です。

  
  

7.32 統合されたフォルト・コードでBadContextTokenが処理されない

このバグは安全な会話トークン(SCT)の再発行に影響します。SCTは、クライアント側がBadContextTokenフォルトを受け取ると再発行されます。ただし、このバグによって、クライアントはキャッシュを消去せず、トークンの期限が切れるまで同じトークンを送信し続けます。

クライアントに有効なトークンがあり、サービスのセッション・マネージャに同じトークンがない場合に、この状況が発生する可能性があります。サービス側の永続性が無効な状態でサーバーが停止した場合、サーバーが再開したときにセッションIDがありません。その結果、クライアント・リクエストは失敗します。通常、BadContextTokenフォルトを受け取るとクライアント側キャッシュは消去されますが、統合されたフォルト・コードによって、クライアントは別のフォルト・コードを受け取ります。

回避策は、統合されたフォルト・コードを無効にすることです。use.unified.fault.codeオプションの詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のWLSTを使用したセキュリティ・ポリシーの強制の構成に関する説明を参照してください。

7.33 Oracle Infrastructure Webサービスの非推奨コマンド

表7-1に、Oracle Fusion Middleware 11gリリースで利用可能で、12c (12.1.2)で非推奨になったOracle Infrastructure Webサービス(またはクライアント)のWLSTコマンドを示します。また、この表には、同等の新しいWLSTコマンドと、新しいコマンドを使用したコードに更新する方法の例を示します。

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

表7-1 Oracle Infrastructure Webサービスの非推奨コマンド

非推奨コマンド(11g)	推奨コマンド(12c)	コードの更新
abortRespositorySession	abortWSMSession	11gリリース(リポジトリ操作用): wls:/jrfServer_domain/serverConfig> abortRepositorySession() 12cリリース(リポジトリとポリシー・サブジェクトの両方の操作用): wls:/jrfServer_domain/serverConfig> abortWSMSession()
attachPolicySet	setWSMPolicySetScope	11gリリース: wls:/jrfServer_domain/serverConfig> attachPolicySet ('Domain("base_domain")') 12cリリース: wls:/jrfServer_domain/serverConfig> setWSMPolicySetScope ('Domain("base_domain")')
attachPolicySetPolicy	attachWSMPolicy attachWSMPolicies	11gリリース(ポリシー・セットに対するリポジトリとポリシー・サブジェクトの両方の操作用): wls:/jrfServer_domain/serverConfig> attachPolicySetPolicy ('oracle/wss_username_token_service_policy') 12cリリース: wls:/jrfServer_domain/serverConfig> attachWSMPolicy('oracle/wss_username_token_service_policy') wls:/wls-domain/serverConfig>attachWSMPolicies(["oracle/wss_username_token_client_policy","oracle/log_policy"])
beginRespositorySession	beginWSMSession	11gリリース(リポジトリ操作用): wls:/jrfServer_domain/serverConfig> beginRepositorySession() 12cリリース(リポジトリとポリシー・サブジェクトの両方の操作用): wls:/jrfServer_domain/serverConfig> beginWSMSession()
clonePolicySet	cloneWSMPolicySet	11gリリース: wls:/jrfServer_domain/serverConfig> clonePolicySet ('myNewPolicySet', 'myPolicySet') 12cリリース: wls:/jrfServer_domain/serverConfig> cloneWSMPolicySet ('myNewPolicySet', 'myPolicySet')
commitRespositorySession	commitWSMSession	11gリリース(リポジトリ操作用): wls:/jrfServer_domain/serverConfig> commitRepositorySession() 12cリリース(リポジトリとポリシー・サブジェクトの両方の操作用): wls:/jrfServer_domain/serverConfig> commitWSMSession()
createPolicySet	createWSMPolicySet	11gリリース: wls:/jrfServer_domain/serverConfig> createPolicySet('myPolicySet', 'ws-service', 'Domain("base_domain")') 12cリリース: wls:/jrfServer_domain/serverConfig> createWSMPolicySet ('myPolicySet', 'ws-service', 'Domain("base_domain")')
deletePolicySet	deleteWSMPolicySet	11gリリース: wls:/jrfServer_domain/serverConfig> deletePolicySet('myPolicySet') 12cリリース: wls:/jrfServer_domain/serverConfig> deleteWSMPolicySet ('myPolicySet')
describeRespositorySession	describeWSMSession	11gリリース(リポジトリ操作用): wls:/jrfServer_domain/serverConfig> describeRepositorySession() 11gリリース(ポリシー・サブジェクト操作用): 該当なし 12cリリース(リポジトリとポリシー・サブジェクトの両方の操作用): wls:/jrfServer_domain/serverConfig> describeWSMSession()
detachPolicySet	detachWSMPolicy detachWSMPolicies	11gリリース(ポリシー・セットに対するリポジトリとポリシー・サブジェクトの両方の操作用): wls:/jrfServer_domain/serverConfig> detachPolicySet ('oracle/wss_username_token_service_policy') 12cリリース: wls:/jrfServer_domain/serverConfig> detachWSMPolicy('oracle/wss_username_token_service_policy') wls:/wls-domain/serverConfig>detachWSMPolicies(["oracle/log_policy","oracle/wss_username_token_client_policy"])
displayPolicySet	displayWSMPolicySet	11gリリース: wls:/jrfServer_domain/serverConfig> displayPolicySet('myPolicySet') 12cリリース: wls:/jrfServer_domain/serverConfig> displayWSMPolicySet ('myPolicySet')
enablePolicySet	enableWSMPolicySet	11gリリース: wls:/jrfServer_domain/serverConfig> enablePolicySet(true) 12cリリース: wls:/jrfServer_domain/serverConfig> enableWSMPolicySet(true)
enablePolicySetPolicy	enableWSMPolicy enableWSMPolicies	11gリリース: wls:/wls-domain/serverConfig>enablePolicySetPolicy('/oracle/log_policy',false) 12cリリース: wls:/wls-domain/serverConfig>enableWSMPolicy('/oracle/log_policy',false) wls:/wls-domain/serverConfig>enableWSMPolicies(["oracle/log_policy", "oracle/wss_username_token_client_policy"], true )
exportRepository	exportWSMRepository	11gリリース: wls:/jrfServer_domain/serverConfig> exportRepository ("/tmp/repo.zip") 12cリリース: wls:/jrfServer_domain/serverConfig> exportWSMRepository ("/tmp/repo.zip")
importRepository	importWSMArchive	11gリリース(リポジトリ・ドキュメント用): wls:/jrfServer_domain/serverConfig> importRepository ("/tmp/repo.zip") 12cリリース(リポジトリ・ドキュメント用): wls:/jrfServer_domain/serverConfig> importWSMArchive ("/tmp/repo.zip")
listPolicySets	listWSMPolicySets	11gリリース: wls:/wls-domain/serverConfig>listPolicySets('sca-reference') 12cリリース: wls:/wls-domain/serverConfig>listWSMPolicySets('sca-reference')
migrateAttachments	migrateWSMAttachments	11gリリース: wls:/jrfServer_domain/serverConfig> migrateAttachments() 12cリリース: wls:/jrfServer_domain/serverConfig> migrateWSMAttachments()
modifyPolicySet	selectWSMPolicySet	11gリリース: wls:/jrfServer_domain/serverConfig> modifyPolicySet('myPolicySet') 12cリリース: wls:/jrfServer_domain/serverConfig> selectWSMPolicySet ('myPolicySet')
resetWSMPolicyRepository	restWSMRepository	11gリリース: wls:/jrfServer_domain/serverConfig> resetWSMPolicyRepository() 12cリリース: wls:/jrfServer_domain/serverConfig> resetWSMRepository()
setPolicySetConstraint	setWSMPolicySetConstraint	11gリリース: wls:/jrfServer_domain/serverConfig> setPolicySetConstraint ('HTTPHeader("VIRTUAL_HOST_TYPE","external")') 12cリリース: wls:/jrfServer_domain/serverConfig> setWSMPolicySetConstraint ('HTTPHeader("VIRTUAL_HOST_TYPE","external")')
setPolicySetDescription	setWSMPolicySetDescription	11gリリース: wls:/jrfServer_domain/serverConfig> setPolicySetDescription ('Global policy set for web service endpoint.') 12cリリース: wls:/jrfServer_domain/serverConfig> setWSMPolicySetDescription ('Global policy set for web service endpoint.')
setWebServicePolicyOverride	setWSMPolicyOverride	11gリリース: wls:/jrfServer_domain/serverConfig> setWebServicePolicyOverride ('/base_domain/server1/HelloWorld#1_0','j2wbasicPolicy', 'web', '{http://namespace/}WssUsernameService','JRFWssUsernamePort', 'oracle/wss_username_token_service_policy', 'reference.priority', '10') 12cリリース: wls:/jrfServer_domain/serverConfig> setWSMPolicyOverride ('oracle/wss_username_token_service_policy', 'reference.priority', '10')
setPolicySetPolicyOverride	setWSMPolicyOverride	11gリリース(ポリシー・セットに対するリポジトリとポリシー・サブジェクトの両方の操作用): wls:/jrfServer_domain/serverConfig> setPolicySetPolicyOverride ('oracle/wss_username_token_service_policy', 'reference.priority', '10') 12cリリース: wls:/jrfServer_domain/serverConfig> setWSMPolicyOverride ('oracle/wss_username_token_service_policy', 'reference.priority', '10')
upgradeWSMPolicyRepository	upgradeWSMRepository	11gリリース: wls:/jrfServer_domain/serverConfig> upgradeWSMPolicyRepository() 12cリリース: wls:/jrfServer_domain/serverConfig> upgradeWSMRepository()
validatePolicySet	validateWSMPolicySet	11gリリース: wls:/jrfServer_domain/serverConfig> validatePolicySet ('myPolicySet') 12cリリース: wls:/jrfServer_domain/serverConfig> validateWSMPolicySet ('myPolicySet')