java.lang.Object
com.sun.security.auth.module.UnixLoginModule
- すべての実装されたインタフェース:
LoginModule
public class UnixLoginModule extends Object implements LoginModule
この
LoginModule
は、ユーザーのUnix Principal
情報(UnixPrincipal
、UnixNumericUserPrincipal
、およびUnixNumericGroupPrincipal
)をインポートして、現在のSubject
と関連付けます。
このLoginModuleではデバッグ・オプションを利用できます。 ログインConfigurationでtrueに設定した場合は、デバッグ・メッセージが出力ストリームSystem.outに出力されます。
-
コンストラクタのサマリー
-
メソッドのサマリー
-
コンストラクタの詳細
-
UnixLoginModule
public UnixLoginModule()UnixLoginModule
を作成します。
-
-
メソッドの詳細
-
initialize
public void initialize(Subject subject, CallbackHandler callbackHandler, Map<String, ?> sharedState, Map<String, ?> options) このLoginModule
を初期化します。- 定義:
initialize
、インタフェースLoginModule
- パラメータ:
subject
- 認証対象のSubject
。callbackHandler
- エンド・ユーザーとの通信(ユーザー名とパスワードの入力など)に使用されるCallbackHandler
。sharedState
- 共有LoginModule
の状態。options
- このLoginModule
用にログインConfiguration
で指定されたオプション。
-
login
public boolean login() throws LoginExceptionユーザーを認証します(第1フェーズ)。このメソッドを実装すると、ネイティブのUnixシステム・コールを行うことで、ユーザーのUnix
Subject
情報を取得しようとします。- 定義:
login
、インタフェースLoginModule
- 戻り値:
- 常にtrue (この
LoginModule
を無視してはならない)。 - 例外:
FailedLoginException
- 背後のシステム情報を取得しようとして失敗した場合。LoginException
- 認証に失敗した場合
-
commit
public boolean commit() throws LoginException認証をコミットします(第2フェーズ)。LoginContextの認証全体が成功した場合(関連するREQUIRED、REQUISITE、SUFFICIENT、およびOPTIONALの各LoginModuleが成功した場合)に呼び出されます。
このLoginModule自体の認証が成功した場合(Unix認証情報のインポートに成功した場合)、Unix Principalが
LoginModule
に現在結び付けられているSubject
と関連付けられます。 このLoginModuleの認証に失敗した場合は、当初保存された状態が削除されます。- 定義:
commit
、インタフェースLoginModule
- 戻り値:
- このLoginModule自体のログインとコミットの試みが成功した場合はtrue、そうでない場合はfalse。
- 例外:
LoginException
- コミットに失敗した場合
-
abort
public boolean abort() throws LoginException認証を中止します(第2フェーズ)。このメソッドは、LoginContextの全体の認証に失敗した場合に呼び出されます。(関連するREQUIRED、REQUISITE、SUFFICIENT、およびOPTIONALの各LoginModuleが失敗した場合)。
このメソッドは、
login
メソッドやcommit
メソッドの認証試行の一部として、当初保存された状態を消去します。- 定義:
abort
、インタフェースLoginModule
- 戻り値:
- このLoginModule自体のログインやコミットの試みが失敗した場合はfalse、そうでない場合はtrue。
- 例外:
LoginException
- 中止に失敗した場合
-
logout
public boolean logout() throws LoginExceptionユーザーをログアウトさせます。このメソッドは、
Subject
に関連付けられたプリンシパルを削除します。- 定義:
logout
、インタフェースLoginModule
- 戻り値:
- 常にtrue (この
LoginModule
を無視してはならない)。 - 例外:
LoginException
- ログアウトに失敗した場合
-