Cosminexus アプリケーションサーバ V8 リファレンス API編

[目次][索引][前へ][次へ]

4.3 LoginInfoManagerクラス

説明
J2EEサーバに設定したユーザとパスワードを使って,セキュリティ認証を実行します。
セキュリティ認証を実行するJ2EEサーバについて説明します。
  • ejbserver.security.service.urlプロパティを指定している場合
    セキュリティ認証は,ejbserver.security.service.urlプロパティに指定したCORBAネーミングサービスに接続しているJ2EEサーバのうち,ejbserver.serverNameプロパティで指定したサーバ名称と一致するJ2EEサーバで実行されます。
    ejbserver.security.service.urlプロパティは,java.naming.provider.urlプロパティに指定したCORBAネーミングサービスに接続していないJ2EEサーバでセキュリティ認証を実行する場合に,指定してください。
  • ejbserver.security.service.urlプロパティを指定していない場合
    セキュリティ認証は,java.naming.provider.urlプロパティに指定したCORBAネーミングサービスに接続しているJ2EEサーバのうち,ejbserver.serverNameプロパティで指定したサーバ名称と一致するJ2EEサーバで実行されます。
JNDIラウンドロビン検索機能やCTM連携機能などを使った負荷分散構成の場合は,セキュリティ認証を実行できるJ2EEサーバが複数存在することになります。この場合,構成するJ2EEサーバすべてに同じユーザ,および同じロールの情報を設定した上で,セキュリティ認証用のJ2EEサーバを一つ決定してください。
各プロパティの詳細については,マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「15. Javaアプリケーションで使用するファイル」を参照してください。EJBクライアントアプリケーションでのセキュリティの実装方法については,マニュアル「Cosminexus アプリケーションサーバ 機能解説 基本・開発編(EJBコンテナ)」の「3.6 EJBクライアントアプリケーションでのセキュリティの実装」を参照してください。
LoginInfoManagerクラスのパッケージ名は,com.hitachi.software.ejb.security.base.authenticationです。

メソッド一覧
メソッド名 機能
getLoginInfoManagerメソッド LoginInfoManagerオブジェクトを取得します。
loginメソッド J2EEサーバにログインします。
logoutメソッド J2EEサーバからログアウトします。

注意事項
LoginInfoManagerクラスのメソッドを使用する場合は次の点に注意してください。
  • LoginInfoManagerクラスのメソッドは,EJBクライアントアプリケーションから発行することを推奨しています。JSP,サーブレット,またはEJB内から発行した場合,RunAs機能によって設定した情報が,リクエスト単位で削除されます。
  • loginメソッドを発行してJ2EEサーバを呼び出したあとは,必ずlogoutメソッドを発行してください。
  • loginメソッドおよびlogoutメソッドを入れ子で発行しないでください。logoutメソッドを発行しないでloginメソッドを連続で発行すると,1回目のloginメソッドで指定した情報が2回目のloginメソッドによって上書きされます。
<この節の構成>
getLoginInfoManagerメソッド
loginメソッド
logoutメソッド