この章の構成は、次のとおりです。
認証およびセッション管理の処理は使用される統合メソッドに応じて異なります。最初のインストール時には、Imaging WebサービスはOracle Web Service Managerのセキュリティ・ポリシーを適用せずに構成されます。セキュリティ・ポリシーが適用されない場合、サービスではHTTP Basic認証メカニズムかユーザー名トークン認証のいずれかを使用します。ただし、ユーザー資格情報(ユーザーIDとパスワード)がWebサービスのHTTPメッセージ・ヘッダー・メカニズムで送信されるBasic認証は、Secure Socket Layer (SSL)転送メカニズムが使用されていないかぎり、いかなる方法でも暗号化されないため、十分安全であるとは言えません。
Imagingサーバー・インスタンスに対してSSLが適切に構成されていれば、すべてのWebサービス通信でSSLが強制的に使用されるようにImagingを構成できます。このためには、Imaging構成MBean、RequireBasicAuthSSLをtrueに設定します。デフォルトではfalseです。
注意:
RequireBasicAuthSSL設定は、HTTP Basic認証が使用されていない場合のみ適用されます。これはOWSMセキュリティ・ポリシーが適用されていないためです。
OWSMセキュリティ・ポリシーの使用
より高いレベルのセキュリティが望ましい場合、Imaging Webサービスは、次のOracle Webサービス管理(OWSM)セキュリティ・ポリシーをサポートしています。
wss_username_token
wss_username_token_over_ssl
wss11_username_token_with_message_protection
セキュリティ・ポリシーをImaging Webサービスに適用する際には、DocumentContentServiceを除き、すべてのWebサービスに同じポリシーを適用する必要があります。DocumentContentServiceはOWSMセキュリティ・ポリシーと互換性のないストリーミングMTOMを使用するように設計されています。DocumentContentServiceのセキュリティはまず、OWSMセキュリティ・ポリシーを利用するLoginServiceによる別のステートフル・ログインを要求します。この情報は主としてWebサービスの直接コールにとって重要です。ネイティブJava APIを使用すると、自動的に適切なログイン順序が実行されます。)
セキュリティ・ポリシーをImaging Webサービスに適用するには、WebLogicサーバー管理コンソールから次の手順を実行します。
管理コンソールにログインします。
「デプロイメント」をクリックします。「デプロイメントのサマリー」ページが表示されます。
「デプロイメント」表の「名前」列で「Imaging」の横にあるプラス(+)アイコンをクリックします。Imagingデプロイメントが展開されます。
DocumentContentServiceを除く「Webサービス」の下にある各Imaging Webサービスで次の操作を行います。
Webサービスを選択します。そのサービスの設定ページが表示されます。
「構成」タブを選択します。「構成」タブがアクティブになります。
「WS-Policy」タブを選択します。「WS-Policy」タブがアクティブになります。
「このWebサービスに関連付けられているWS-Policyファイル」表の「サービスのエンドポイントおよび操作」列で目的のWebサービス・ポートをクリックします。「Webサービスのポリシーのタイプを構成」ページが表示されます。
「OWSM」が選択されていることを確認し、「次へ」をクリックします。WebLogicポリシーがサポートされていないことに注意してください。「WebServiceポリシーの構成」ページIDが表示されます。
「選択可能なエンドポイント・ポリシー」フィールドからサポートされているサービス・ポリシーを選択します。サポートされるポリシーは「Basic認証のためのSSL通信の提供」に一覧表示されています。
右矢印をクリックして、選択したポリシーを「選択されたエンドポイント・ポリシー」フィールドに移動します。ただし、選択するセキュリティ・ポリシーは1つのみにします。
「終了」をクリックします。「デプロイメント・プラン保存アシスタント」ページが表示されます。
「OK」をクリックして、デプロイメント計画を保存します。
DocumentContentService以外の各Webサービスについて、同じポリシーがすべてのサービスに適用されるまで、「Imaging WebサービスへのOWSMセキュリティ・ポリシーの適用」の手順を繰り返します。
「デプロイメント」をクリックして、「デプロイメント」ページに戻ります。
「デプロイメント」表の「名前」列で「Imaging」の横にあるチェック・ボックスを選択し、「更新」をクリックします。「アプリケーション更新アシスタント」ページが開き、指定した新しいデプロイメント・プランが「デプロイメント・プランのパス」の隣に表示されます。
「終了」をクリックします。新しいポリシーが適用され、デプロイメントが更新されます。
OWSMセキュリティ・ポリシーがImaging Webサービスに適用される場合、Java APIコードはBasicUserTokenクラスではなく、WsmUserTokenクラスを使用する必要があります。WsmUserTokenクラスはOWSMクライアント側のセキュリティ・ポリシーを構成するためのヘルパー・クラスで、正しいクライアント側ポリシーを設定するための静的定数のセットが含まれています。使用されているポリシーによっては、追加の構成設定も必要になる場合があります。様々な構成オプションの意味の詳細は、OWSMのドキュメントを参照してください。
例3-1のコード部分は、様々なポリシー・タイプのWsmUserTokenクラスの使用例を示しています。
例3-1 様々なポリシー・タイプのWsmUserTokenクラス
WsmUserToken userToken = new WsmUserToken ("weblogic", "weblogic"); userToken.setClientPolicy(WsmUserToken.USERNAME_TOKEN_POLICY); ServicesFactory.login(userToken, wsurl);