com.sun.security.auth.module
クラス UnixLoginModule

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()

メソッドの概要

boolean	abort() 認証を中止します (第 2 フェーズ)。
boolean	commit() 認証をコミットします (第 2 フェーズ)。
void	initialize(Subject subject, CallbackHandler callbackHandler, Map<String,?> sharedState, Map<String,?> options) この LoginModule を初期化します。
boolean	login() ユーザを認証します (第 1 フェーズ)。
boolean	logout() ユーザをログアウトさせます。

クラス java.lang.Object から継承されたメソッド

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

コンストラクタの詳細

UnixLoginModule

public UnixLoginModule()

メソッドの詳細

initialize

public void initialize(Subject subject,
                       CallbackHandler callbackHandler,
                       Map<String,?> sharedState,
                       Map<String,?> options)

この LoginModule を初期化します。

定義:

インタフェース LoginModule 内の initialize

パラメータ:

subject - 認証を受ける Subject

callbackHandler - エンドユーザとの通信 (ユーザ名とパスワードの入力など) に使用される CallbackHandler

sharedState - 共有 LoginModule の状態

options - この LoginModule 用にログイン Configuration で指定されたオプション

login

public boolean login()
              throws LoginException

ユーザを認証します (第 1 フェーズ)。

ネイティブの Unix システムコールを行うことで、ユーザの Unix Subject 情報を取得しようとします。

定義:

インタフェース LoginModule 内の login

戻り値:

常に true (この LoginModule を無視してはならない)

例外:

FailedLoginException - 背後のシステム情報を取得しようとして失敗した場合

LoginException

commit

public boolean commit()
               throws LoginException

認証をコミットします (第 2 フェーズ)。

LoginContext の認証全体が成功した場合 (関連する REQUIRED、REQUISITE、SUFFICIENT、および OPTIONAL の各 LoginModule が成功した場合) に呼び出されます。

この LoginModule 自体の認証が成功した場合 (Solaris 認証情報のインポートに成功した場合)、Solaris Principal が LoginModule に現在結び付けられている Subject に関連付けられます。この LoginModule の認証に失敗した場合は、当初保存された状態が削除されます。

定義:

インタフェース LoginModule 内の commit

戻り値:

この LoginModule 自体のログインとコミットの試みが成功した場合は true、そうでない場合は false

例外:

LoginException - コミットに失敗した場合

abort

public boolean abort()
              throws LoginException

認証を中止します (第 2 フェーズ)。

LoginContext の認証全体が失敗した場合 (関連する REQUIRED、REQUISITE、SUFFICIENT、および OPTIONAL の各 LoginModule が失敗した場合) に呼び出されます。

login メソッドや commit メソッドの認証試行の一部として、当初保存された状態を消去します。

定義:

インタフェース LoginModule 内の abort

戻り値:

この LoginModule 自体のログインやコミットの試みが失敗した場合は false、そうでない場合は true

例外:

LoginException - 中止に失敗した場合

logout

public boolean logout()
               throws LoginException

ユーザをログアウトさせます。

Subject に関連付けられた主体を削除します。

定義:

インタフェース LoginModule 内の logout

戻り値:

常に true (この LoginModule を無視してはならない)

例外:

LoginException - ログアウトに失敗した場合