public class KeyStoreLoginModule extends Object implements LoginModule
X500Principal
と、サブジェクトの公開資格にある別名の証明書パスを格納します。また、証明書が別名の証明書パスで最初の証明書であり、かつ非公開鍵がサブジェクトの非公開資格にある別名の非公開鍵である X500PrivateCredential
も格納します。 構成ファイルでは、次のオプションを使用できます。
keyStoreURL
user.home
システムプロパティーで指定したディレクトリ内の .keystore ファイルを示す URL です。この URL からの入力ストリームは、KeyStore.load
メソッドに渡されます。KeyStore.load
メソッドに null
ストリームを渡す必要がある場合は、「NONE」を指定できます。「NONE」は、キーストアが、たとえばハードウェアトークンデバイスに置かれている場合に指定します。keyStoreType
KeyStore.getDefaultType()
を呼び出した結果です。種類が「PKCS11」の場合、keyStoreURL は「NONE」でなければならず、privateKeyPasswordURL を指定することはできません。keyStoreProvider
keyStoreAlias
keyStorePasswordURL
protected
が false の場合は必須になります。デフォルト値はありません。 privateKeyPasswordURL
protected
コンストラクタと説明 |
---|
KeyStoreLoginModule() |
修飾子と型 | メソッドと説明 |
---|---|
boolean |
abort()
このメソッドは、LoginContext の全体の認証に失敗した場合に呼び出されます。
|
boolean |
commit()
認証プロセスをコミットする抽象メソッドです (フェーズ 2)。
|
void |
initialize(Subject subject, CallbackHandler callbackHandler, Map<String,?> sharedState, Map<String,?> options)
この
LoginModule を初期化します。 |
boolean |
login()
ユーザーを認証します。
|
boolean |
logout()
ユーザーをログアウトさせます。
|
public void initialize(Subject subject, CallbackHandler callbackHandler, Map<String,?> sharedState, Map<String,?> options)
LoginModule
を初期化します。
initialize
、インタフェース: LoginModule
subject
- 認証対象の Subject
。callbackHandler
- エンドユーザーとの通信 (ユーザー名とパスワードの入力など) に使用される CallbackHandler
。null
の場合もある。sharedState
- 共有 LoginModule
の状態。options
- この LoginModule
用にログイン Configuration
で指定されたオプション。public boolean login() throws LoginException
キーストアの別名と関連するパスワードを取得します。入力された別名の主体と資格をキーストアから取得します。
login
、インタフェース: LoginModule
LoginModule
を無視してはならない)。FailedLoginException
- 認証に失敗した場合。 LoginException
- 認証に失敗した場合public boolean commit() throws LoginException
LoginContext の認証全体が成功した場合 (関連する REQUIRED、REQUISITE、SUFFICIENT、および OPTIONAL の各 LoginModule が成功した場合) に呼び出されます。
この LoginModule 自体の認証が成功したかどうかをチェックするには、login
メソッドによって保存された非公開状態を取得します。認証が成功した場合、サブジェクトの主体にある別名の資格で最初の証明書のサブジェクトの識別名に対する X500Principal
、サブジェクトの公開資格にある別名の証明書パス、別名の証明書パス内の最初の証明書とサブジェクトの非公開資格にある別名の非公開鍵を持つ X500PrivateCredential
が、このメソッドにより関連付けられます。この LoginModule 自体の認証が失敗した場合は、当初保存された状態を削除します。
commit
、インタフェース: LoginModule
LoginException
- コミットに失敗した場合public boolean abort() throws LoginException
このメソッドは、LoginContext の全体の認証に失敗した場合に呼び出されます。(関連する REQUIRED、REQUISITE、SUFFICIENT、および OPTIONAL の各 LoginModule が失敗した場合)。
この LoginModule 自体の認証が成功した場合は (login
メソッドと commit
メソッドによって保存された非公開状態を取得して調べる)、当初保存された状態を整理します。
ロードされたキーストアのプロバイダが java.security.AuthProvider
を拡張する場合は、プロバイダの logout
メソッドが呼び出されます。
abort
、インタフェース: LoginModule
LoginException
- 中止に失敗した場合。public boolean logout() throws LoginException
このメソッドは、commit
メソッドによって追加された主体、公開資格、および非公開資格を削除します。
ロードされたキーストアのプロバイダが java.security.AuthProvider
を拡張する場合は、プロバイダの logout
メソッドが呼び出されます。
logout
、インタフェース: LoginModule
LoginModule
を無視してはならないため、常に true。LoginException
- ログアウトに失敗した場合。
Copyright © 1998, 2013, Oracle and/or its affiliates. All rights reserved.