com.sun.security.auth.login

クラス ConfigFile

java.lang.Object

javax.security.auth.login.Configuration

com.sun.security.auth.login.ConfigFile

public class ConfigFile
extends Configuration

このクラスは javax.security.auth.login.Configuration のデフォルトの実装を表します。

実行時のログイン構成表現を格納し、複数のファイル内にある複数の静的なログイン構成を合わせます。ログイン構成ファイルを検出し、その情報をこの Configuration に読み込むアルゴリズムは次のとおりです。

1. java.security.Security のプロパティー login.config.url.1、login.config.url.2、...、login.config.url.X に対してループ処理を行います。これらのプロパティーは <JAVA_HOME>/lib/security/java.security という名前の Java セキュリティープロパティーファイルに設定されます。<JAVA_HOME> は java.home システムプロパティーの値を参照しており、JRE のインストールディレクトリを示します。それぞれのプロパティー値では、ロードされるログイン構成ファイルを参照する URL を指定します。各構成が読み込まれ、ロードされます。
2. java.lang.System のプロパティーである java.security.auth.login.config にも、別のログイン構成ファイルを参照する URL を設定できます (実行時に -D スイッチを使用する場合)。このプロパティーが定義されており、このプロパティーの使用がセキュリティープロパティーファイルで許可されている (セキュリティープロパティー policy.allowSystemProperty が true) 場合は、そのログイン構成もロードされます。
3. java.security.auth.login.config プロパティーが「==」(「=」ではない) を使用して定義されている場合、ほかに指定したログイン構成はすべて無視され、この構成だけがロードされます。
4. システムプロパティーやセキュリティープロパティーが設定されていない場合は、${user.home}/.java.login.config ファイルからの読み込みが試みられます (${user.home} はuser.home システムプロパティーで表される値)。

この実装でサポートされる構成構文は、javax.security.auth.login.Configuration クラスで指定した構文です。

関連項目:

LoginContext

ネストされたクラスのサマリー

javax.security.auth.login.Configuration から継承されたネストされたクラス/インタフェース

Configuration.Parameters

コンストラクタのサマリー

コンストラクタ

コンストラクタと説明
ConfigFile() 新しい Configuration オブジェクトを作成します。
ConfigFile(URI uri) 指定された URI から新しいConfiguration オブジェクトを作成します。

メソッドのサマリー

メソッド

修飾子と型	メソッドと説明
AppConfigurationEntry[]	getAppConfigurationEntry(String applicationName) アプリケーション名をインデックスとして使用している Configuration からのエントリを取得します。
void	refresh() すべてのログイン構成を読み込みし直すことで、Configuration をリフレッシュし、再ロードします。

クラス javax.security.auth.login.Configuration から継承されたメソッド

getConfiguration, getInstance, getInstance, getInstance, getParameters, getProvider, getType, setConfiguration

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

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

コンストラクタの詳細

ConfigFile

public ConfigFile()

新しい Configuration オブジェクトを作成します。

ConfigFile

public ConfigFile(URI uri)

指定された URI から新しいConfiguration オブジェクトを作成します。

パラメータ:

uri - この URI から新しい Configuration オブジェクトを作成する。

メソッドの詳細

getAppConfigurationEntry

public AppConfigurationEntry[] getAppConfigurationEntry(String applicationName)

アプリケーション名をインデックスとして使用している Configuration からのエントリを取得します。

定義:

getAppConfigurationEntry 、クラス: Configuration

パラメータ:

applicationName - Configuration のインデックスとして使用される名前。

戻り値:

このアプリケーション用にスタックされた LoginModule の構成に対応する、AppConfigurationEntries の配列。LoginModule が構成されていない場合は null。

refresh

public void refresh()

すべてのログイン構成を読み込みし直すことで、Configuration をリフレッシュし、再ロードします。

オーバーライド:

refresh 、クラス: Configuration

例外:

SecurityException - 呼び出し側に Configuration をリフレッシュするアクセス権がない場合。