JavaTM Platform
Standard Ed. 6

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, elements, entrySet, get, getInfo, getName, getProperty, getService, getServices, getVersion, keys, keySet, load, put, putAll, putService, remove, removeService, toString, values
 
クラス java.util.Properties から継承されたメソッド
getProperty, list, list, load, loadFromXML, propertyNames, save, setProperty, store, store, storeToXML, storeToXML, stringPropertyNames
 
クラス java.util.Hashtable から継承されたメソッド
clone, contains, containsKey, containsValue, equals, hashCode, isEmpty, 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 - このプロバイダが呼び出し側から認証情報を取得する際に使用する CallbackHandlernull の場合もある
例外:
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 - 認証情報を取得するための CallbackHandlernull を設定できる
例外:
SecurityException - 呼び出し側が SecurityPermission("authProvider.name") のセキュリティーチェックにパスしなかった場合。 ここで、name はこのプロバイダの getName メソッドの戻り値

JavaTM Platform
Standard Ed. 6

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。