Cosminexus アプリケーションサーバ V8 リファレンス API編
統合ユーザ管理のAPIで使用する例外クラスについて説明します。使用する例外クラスには,JAASで規定されているログインモジュールの例外クラスと日立で提供するAPI(JAAS以外)の例外クラスがあります。
JAASで規定されているログインモジュールの例外クラスを次の表に示します。
表8-3 JAASのログインモジュールの例外クラス一覧
| 項番 | 例外名 | 内容 |
|---|---|---|
| 1 | javax.security.auth.login.LoginException | 項番2〜4の親クラスです。コンストラクタのパラメタにmsg(java.lang.String)を持ちます。 |
| 2 | javax.security.auth.login.AccountExpiredException | ユーザアカウントが期限切れであることを通知します。 |
| 3 | javax.security.auth.login.CredentialExpiredException | Credentialが期限切れであることを通知します。 |
| 4 | javax.security.auth.login.FailedLoginException | 認証が失敗したことを通知します。 |
また,ユーザ認証ライブラリ/シングルサインオンライブラリのログインモジュールでは,これらの例外にエラーメッセージ文字列を設定して送出します。エラーメッセージ文字列の一覧を次の表に示します。
なお,ここで示した例外以外でも,JAASのコンフィグレーションファイルの記述に誤りがある場合にLoginContextクラスをインスタンス化すると,java.lang.SecurityException例外が発生します。その場合は,次の表のエラーメッセージ文字列を参照して,JAASのコンフィグレーションファイルの内容を修正してください。
表8-4 ユーザ認証ライブラリ/シングルサインオンライブラリのログインモジュールの例外
| 例外名 | エラーメッセージ文字列 | 発生条件 |
|---|---|---|
| javax.security.auth.login.FailedLoginException | data not found | 認証情報が,渡されたパラメタ内にありません。 WebPasswordHandlerクラスに渡したHttpServletRequest内にユーザID/パスワードが格納されていません。 |
| invalid data |
|
|
| no data | 該当セッション内で認証済みである場合に,呼び出そうとしたレルムに対応したシングルサインオン用認証情報が定義されていません。 | |
| javax.security.auth.login.LoginException | invalid parameter | Credentialを作成しようとしたときの属性名と属性の一覧の指定内容に次のような誤りがあります。
|
| SQLの例外名称 | JDBCを使用したアクセスに失敗しました。この例外が発生した場合は,エラーメッセージ文字列を参照して対処してください。 | |
| JNDIの例外名称 | LDAPのアクセスに失敗しました。
|
|
| not supported | 未サポートのCallbackHandlerを使用しました。
|
|
| no class for xxx | WebSSOLoginModuleから呼び出すクラスが使用できません(xxxはcom.cosminexus.admin.auth.sso.loginmoduleで指定された値)。
|
|
| config error |
|
|
| invalid session | HttpSessionオブジェクトに関連づけようとしましたが,HttpSessionオブジェクトが無効になりました。 | |
| crypto error | 暗号化/復号化で失敗しました。
|
|
| no sso data | シングルサインオン用の情報がありません。
|
|
| no principal | Principalがないため,最初に認証したユーザを特定することができませんでした。 | |
| class cast error | リポジトリから取り出した型と統合ユーザ管理のコンフィグレーションファイルに指定された型が不一致です。一致するようにしてください。ua.conf(統合ユーザ管理のコンフィグレーションファイル)のcom.cosminexus.admin.auth.ldap.password.encryptを参照してください。ua.confファイルについては,マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「14.3 ua.conf(統合ユーザ管理のコンフィグレーションファイル)」を参照してください。 | |
| not found driver | JDBCを使用しました。
|
|
| その他 | 各システムのログインモジュールで発生しました。
|
日立で提供するAPI(JAAS以外)の例外クラスは,次の図に示す階層を持ちます。
図8-2 例外クラスの階層
例外クラス一覧を次の表に示します。
表8-5 日立で提供するAPIの例外クラス一覧
| 項番 | 例外名 | 内容 |
|---|---|---|
| 1 | com.cosminexus.admin.common.UAException | 項番2〜8の親クラスです。 |
| 2 | com.cosminexus.admin.common.ParameterError | 各APIのパラメタの指定に誤りがありました。 |
| 3 | com.cosminexus.admin.common.FormatError | Formatを持つものに対する指定に誤りがありました。 |
| 4 | com.cosminexus.admin.common.ConfigError | コンフィグレーションファイルの内容に誤りがありました。 |
| 5 | com.cosminexus.admin.auth.api.repository.ldap.ObjectClassError | オブジェクトクラスの指定に誤りがありました。 |
| 6 | com.cosminexus.admin.auth.CryptoException | 暗号化/復号化に失敗しました。 |
| 7 | com.cosminexus.admin.auth.api.repository.event.ChangeDataFailedException | 他システムの認証情報の更新に失敗した場合に,リスナクラスが呼び出されます。 |
| 8 | com.cosminexus.admin.auth.api.repository.event.SSODataListenerException | 他システムの認証情報の更新に失敗した場合に,LdapSSODataManagerクラスが呼び出されます。 |
All Rights Reserved. Copyright (C) 2008, 2011, Hitachi, Ltd.