java.security
クラス AuthProvider

java.lang.Object
  java.util.Dictionary<K,V>
      java.util.Hashtable<Object,Object>
          java.util.Properties
              java.security.Provider
                  java.security.AuthProvider

すべての実装されたインタフェース:

Serializable, Cloneable, Map<Object,Object>

public abstract class AuthProvider
extends Provider

このクラスは、特定のプロバイダに対するログインメソッドとログアウトメソッドを定義します。

呼び出し元は login を直接呼び出すことができますが、特定の処理に先だってログインを実行する必要があるとプロバイダが判断した場合には、プロバイダ自身が呼び出し元に代わって login を呼び出します。

導入されたバージョン:

1.5

関連項目:

直列化された形式

入れ子のクラスの概要

クラス java.security.Provider から継承された入れ子のクラス/インタフェース

Provider.Service

フィールドの概要

クラス java.util.Properties から継承されたフィールド

defaults

コンストラクタの概要

protected

AuthProvider(String name, double version, String info) 指定された名前、バージョン番号、および情報を使用してプロバイダを構築します。

メソッドの概要

abstract void	login(Subject subject, CallbackHandler handler) このプロバイダにログインします。
abstract void	logout() このプロバイダからログアウトします。
abstract void	setCallbackHandler(CallbackHandler handler) CallbackHandler を設定します。

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

clear, entrySet, getInfo, getName, getService, getServices, getVersion, keySet, load, put, putAll, putService, remove, removeService, toString, values

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

getProperty, getProperty, list, list, loadFromXML, propertyNames, save, setProperty, store, storeToXML, storeToXML

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

clone, contains, containsKey, containsValue, elements, equals, get, hashCode, isEmpty, keys, rehash, size

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

finalize, getClass, notify, notifyAll, wait, wait, wait

コンストラクタの詳細

AuthProvider

protected AuthProvider(String name,
                       double version,
                       String info)

指定された名前、バージョン番号、および情報を使用してプロバイダを構築します。

パラメータ:

name - プロバイダの名前

version - プロバイダのバージョン番号

info - プロバイダとそのサービスの記述

メソッドの詳細

login

public abstract void login(Subject subject,
                           CallbackHandler handler)
                    throws LoginException

このプロバイダにログインします。

プロバイダは、CallbackHandler を使って PIN などの認証情報を呼び出し元から取得します。呼び出し元がこのメソッドに null ハンドラを渡した場合、プロバイダは setCallbackHandler メソッドで設定されたハンドラを使用します。そのメソッド経由でハンドラが設定されていなかった場合、プロバイダは auth.login.defaultCallbackHandler セキュリティプロパティを照会することで、デフォルトハンドラ実装の完全指定クラス名を取得します。そのセキュリティプロパティが設定されていなかった場合、認証情報を取得するための別の方法がそのプロバイダに備わっているものと見なされます。

パラメータ:

subject - Subject。これには、認証で使用する原則/資格を含めたり、認証の正常完了後に追加の原則/資格を設定したりできる。このパラメータには null を設定できる

handler - このプロバイダが呼び出し元から認証情報を取得する際に使用する CallbackHandler。null を設定できる

例外:

LoginException - ログイン処理が失敗した場合

SecurityException - 呼び出し元が SecurityPermission("authProvider.name") のセキュリティチェックにパスしなかった場合。ここで、name はこのプロバイダの getName メソッドの戻り値

logout

public abstract void logout()
                     throws LoginException

このプロバイダからログアウトします。

例外:

LoginException - ログアウト処理が失敗した場合

SecurityException - 呼び出し元が SecurityPermission("authProvider.name") のセキュリティチェックにパスしなかった場合。ここで、name はこのプロバイダの getName メソッドの戻り値

setCallbackHandler

public abstract void setCallbackHandler(CallbackHandler handler)

CallbackHandler を設定します。

login メソッドにハンドラが渡されなかった場合、プロバイダはこのハンドラを使用します。また、プロバイダ自身が呼び出し元に代わって login を呼び出す場合にも、プロバイダはこのハンドラを使用します。いずれにしても、このメソッド経由でハンドラが設定されていなかった場合、プロバイダは auth.login.defaultCallbackHandler セキュリティプロパティを照会することで、デフォルトハンドラ実装の完全指定クラス名を取得します。そのセキュリティプロパティが設定されていなかった場合、認証情報を取得するための別の方法がそのプロバイダに備わっているものと見なされます。

パラメータ:

handler - 認証情報を取得するための CallbackHandler。null を設定できる

例外:

SecurityException - 呼び出し元が SecurityPermission("authProvider.name") のセキュリティチェックにパスしなかった場合。ここで、name はこのプロバイダの getName メソッドの戻り値