クラスSecurity

java.lang.Object

java.security.Security

public final class Security extends Object

このクラスは、すべてのセキュリティ・プロパティ、および共通のセキュリティ・メソッドを集中管理します。 その主な使用目的の1つにプロバイダの管理があります。

セキュリティ・プロパティのデフォルト値は、実装固有のロケーション(通常は、Javaインストール・ディレクトリ内のプロパティ・ファイルconf/security/java.security)から読み取られます。

実装上のノート:

プロパティ・ファイルのロードに失敗した� �合、JDK実装では、Securityクラスの初期化時に未指定のエラーがスローされます。

導入されたバージョン:

1.1

メソッドのサマリー

修飾子と型	メソッド	説明
static int	addProvider(Provider provider)	プロバイダを可能な次の位置に追� します。
static String	getAlgorithmProperty(String algName, String propName)	非推奨。 このメソッドは、アルゴリズ� 固有のパラメータを解析する方法を決定するために、"SUN"暗号化サービス・プロバイダのマスター・ファイル内の独自プロパティの値を返すために使用されます。
static Set<String>	getAlgorithms(String serviceName)	指定されたJava暗号化サービス(e.g., Signature, MessageDigest, Cipher, Mac, KeyStore)で使用可能なすべてのアルゴリズ� またはタイプの名前を含むStringオブジェクトのセットを返します。
static String	getProperty(String key)	セキュリティ・プロパティ値を取得します。
static Provider	getProvider(String name)	指定された名前でインストールされているプロバイダを返します。
static Provider[]	getProviders()	インストールされているすべてのプロバイダの配列を返します。
static Provider[]	getProviders(String filter)	指定した選択基準を満たすすべてのインストール済プロバイダを含む配列を返します。そのようなプロバイダがインストールされていない� �合はnullを返します。
static Provider[]	getProviders(Map<String,String> filter)	指定した選択基準を満たすすべてのインストール済プロバイダを含む配列を返します。そのようなプロバイダがインストールされていない� �合はnullを返します。
static int	insertProviderAt(Provider provider, int position)	指定された位置に新規プロバイダを追� します。
static void	removeProvider(String name)	指定された名前のプロバイダを削除します。
static void	setProperty(String key, String datum)	セキュリティ・プロパティの値を設定します。

クラスjava.lang.Objectで宣言されたメソッド

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

メソッドの詳細

getAlgorithmProperty

@Deprecated public static String getAlgorithmProperty(String algName, String propName)

非推奨。

このメソッドは、アルゴリズ� 固有のパラメータを解析する方法を決定するために、"SUN"暗号化サービス・プロバイダのマスター・ファイル内の独自プロパティの値を返すために使用されます。 代わりに、新しいプロバイダベースのアルゴリズ� に依存しないAlgorithmParametersおよびKeyFactoryエンジン・クラス(J2SEバージョン1.2プラットフォー� より導入)を使用してく� さい。

アルゴリズ� に対する指定されたプロパティを取得します。 アルゴリズ� の名前は標準名とする必要があります。 標準アルゴリズ� 名の詳細は、「Javaセキュリティ標準アルゴリズ� 名仕様」を参照してく� さい。 特殊なアルゴリズ� ・パーサーが(キー・パーサーと同じように)認識されているアルゴリズ� にクラスをマップするために使用することもあります。

パラメータ:

algName - アルゴリズ� 名。

propName - 取得するプロパティの名前。

戻り値:

指定されたプロパティの値。

外部仕様

• Javaセキュリティ標準アルゴリズ� 名

insertProviderAt

public static int insertProviderAt(Provider provider, int position)

指定された位置に新規プロバイダを追� します。 位置は優先� �になっていて、要求されたアルゴリズ� に対してプロバイダがその� �序で検索されます。 位置は1から始まり、1が最優先で次に2、3 ...と続きます。 位置が1未満またはnより大きい� �合(nはインストールされているプロバイダの数)、プロバイダ(ま� インストールされていない� �合)はリストの末尾またはn + 1の位置に挿入されます。

あるプロバイダが要求された� �所にインストールされた� �合は、それまでその� �所にあったプロバイダ、およびpositionよりあとの位置のすべてのプロバイダの� �位は、1つあとになり、インストールされたプロバイダ一覧の最後尾に向かって1つ移動します。

プロバイダは、インストール済みの� �合には追� できません。

パラメータ:

provider - 追� されるプロバイダ。

position - 呼出し側がこのプロバイダに要望する優先� �位。

戻り値:

プロバイダが追� された実際の優先� �位。インストール済みで追� できない� �合は -1。

スロー:

NullPointerException - プロバイダがnullの� �合

関連� �目:

• getProvider(java.lang.String)
• removeProvider(java.lang.String)

addProvider

public static int addProvider(Provider provider)

プロバイダを可能な次の位置に追� します。

パラメータ:

provider - 追� されるプロバイダ。

戻り値:

プロバイダが追� された実際の優先� �位。インストール済みで追� できない� �合は -1。

スロー:

NullPointerException - プロバイダがnullの� �合

関連� �目:

• getProvider(java.lang.String)
• removeProvider(java.lang.String)

removeProvider

public static void removeProvider(String name)

指定された名前のプロバイダを削除します。

指定されたプロバイダが削除されると、そのプロバイダよりもあとの位置にあるすべてのプロバイダの位置が1つ前になり、インストールされたプロバイダ一覧の先� �に向かって1つ移動します。

プロバイダがインストールされていない� �合、または名前がnullの� �合、このメソッドは暗黙的に返されます。

パラメータ:

name - 削除されるプロバイダの名前。

関連� �目:

• getProvider(java.lang.String)
• addProvider(java.security.Provider)

getProviders

public static Provider[] getProviders()

インストールされているすべてのプロバイダの配列を返します。 配列内でのプロバイダは優先� �位の� �になっています。

戻り値:

インストールされているすべてのプロバイダの配列。

getProvider

public static Provider getProvider(String name)

指定された名前でインストールされているプロバイダを返します。 指定した名前のプロバイダがインストールされていない� �合、または名前がnullの� �合は、nullを返します。

パラメータ:

name - 取得するプロパティの名前。

戻り値:

指定された名前のプロバイダ。

関連� �目:

• removeProvider(java.lang.String)
• addProvider(java.security.Provider)

getProviders

public static Provider[] getProviders(String filter)

指定した選択基準を満たすすべてのインストール済プロバイダを含む配列を返します。そのようなプロバイダがインストールされていない� �合はnullを返します。 返されたプロバイダの� �は優先� �となります。

暗号化サービスは、常に特定のアルゴリズ� またはタイプに関連付けられています。 たとえば、デジタル署名サービスは常に特定のアルゴリズ� (DSAなど)に、CertificateFactoryサービスは常に特定の証明書タイプ(X.509など)にそれぞれ関連付けられています。

次の2種類のフォーマットのどちらかで選択基準を指定する必要があります。

• <crypto_service>.<algorithm_or_type>

  暗号化サービス名には、ドットを含まないようにします。

  プロバイダが、指定暗号化サービス向けに指定されたアルゴリズ� または型を実装していると、プロバイダは指定された選択基準を満たしています。

  「CertificateFactory.X.509」の� �合は、X.509証明書のCertificateFactoryの実装を提供しているプロバイダであれば、その選択基準を満たしています。

• <crypto_service>.<algorithm_or_type> <attribute_name>:<attribute_value>

  暗号化サービス名には、ドットを含まないようにします。 <algorithm_or_type>と<attribute_name>の間にスペース文字が1つ以上必要です。

  プロバイダが、指定暗号化サービス向けに指定されたアルゴリズ� または型を実装していて、その実装が指定された属性名と値のペアで表記された制約を満たしている� �合、プロバイダはこの選択基準を満たしています。

  たとえば、1024以上のキー・サイズを持つSHA1withDSA署名アルゴリズ� を実装しているどのプロバイダも、「Signature.SHA1withDSA KeySize:1024」を満たしています。

標準暗号化サービス名、標準アルゴリズ� 名および標準属性名の詳細は、「Javaセキュリティ標準アルゴリズ� 名仕様」を参照してく� さい。

パラメータ:

filter - プロバイダの選択基準。 フィルタは大文字と小文字を区別する。

戻り値:

選択基準を満たすすべてのインストール済プロバイダ、またはそのようなプロバイダがインストールされていない� �合はnull。

スロー:

InvalidParameterException - フィルタが必要な形式以外の� �合

NullPointerException - フィルタがnullの� �合

導入されたバージョン:

1.3

外部仕様

• Javaセキュリティ標準アルゴリズ� 名

関連� �目:

• getProviders(java.util.Map)

getProviders

public static Provider[] getProviders(Map<String,String> filter)

指定した選択基準を満たすすべてのインストール済プロバイダを含む配列を返します。そのようなプロバイダがインストールされていない� �合はnullを返します。 返されたプロバイダの� �は優先� �となります。

選択基準はマップで表現されます。 各マップ・エントリは選択基準のことです。 すべての選択基準をプロバイダが満たしている� �合、プロバイダは選択されます。 このマップでは、どのエントリのキーも次の2種類の形式のどちらかになります。

• <crypto_service>.<algorithm_or_type>

  暗号化サービス名には、ドットを含まないようにします。

  キーに関連した値は空の文字列である必要があります。

  プロバイダが、指定暗号化サービス向けに指定されたアルゴリズ� または型を実装していると、プロバイダはこの選択基準を満たしています。

• <crypto_service>. <algorithm_or_type> <attribute_name>

  暗号化サービス名には、ドットを含まないようにします。 <algorithm_or_type>と<attribute_name>の間にスペース文字が1つ以上必要です。

  キーに関連した値は、空でない文字列になります。 プロバイダが、指定暗号化サービス向けに指定されたアルゴリズ� または型を実装していて、その実装が指定された属性名と値のペアで表記された制約を満たしている� �合、プロバイダはこの選択基準を満たしています。

標準暗号化サービス名、標準アルゴリズ� 名および標準属性名の詳細は、「Javaセキュリティ標準アルゴリズ� 名仕様」を参照してく� さい。

パラメータ:

filter - プロバイダの選択基準。 フィルタは大文字と小文字を区別する。

戻り値:

選択基準を満たすすべてのインストール済プロバイダ、またはそのようなプロバイダがインストールされていない� �合はnull。

スロー:

InvalidParameterException - フィルタが必要な形式以外の� �合

NullPointerException - フィルタがnullの� �合

導入されたバージョン:

1.3

外部仕様

• Javaセキュリティ標準アルゴリズ� 名

関連� �目:

• getProviders(java.lang.String)

getProperty

public static String getProperty(String key)

セキュリティ・プロパティ値を取得します。

パラメータ:

key - 取得するプロパティのキー。

戻り値:

セキュリティ・プロパティの値。そのキーを持つプロパティがない� �合はnull。

スロー:

NullPointerException - キーがnullの� �合

IllegalArgumentException - keyが予約されていて、Securityプロパティ名として使用できない� �合。 予約されている鍵: "include"。

関連� �目:

• setProperty(java.lang.String, java.lang.String)

setProperty

public static void setProperty(String key, String datum)

セキュリティ・プロパティの値を設定します。

パラメータ:

key - 設定するプロパティの名前。

datum - 設定するプロパティの値。

スロー:

NullPointerException - キーまたはデータ� がnullの� �合

IllegalArgumentException - keyが予約されていて、Securityプロパティ名として使用できない� �合。 予約されている鍵: "include"。

関連� �目:

• getProperty(java.lang.String)

getAlgorithms

public static Set<String> getAlgorithms(String serviceName)

指定されたJava暗号化サービス(e.g., Signature, MessageDigest, Cipher, Mac, KeyStore)で使用可能なすべてのアルゴリズ� またはタイプの名前を含むStringオブジェクトのセットを返します。 指定されたサービスをサポートするプロバイダがない� �合、またはserviceNameがnullの� �合、空のセットを返します。 Java暗号化サービスの完全なリストについては、「Java暗号化アーキテクチャ(JCA)リファレンス・ガイド」を参照してく� さい。 ノート: 返されるセットは不変です。

パラメータ:

serviceName - Java暗号化サービス(e.g., Signature, MessageDigest, Cipher, Mac, KeyStore)の名前。 ノート: このパラメータは大文字と小文字を区別する。

戻り値:

指定されたJava暗号化サービスで使用可能なすべてのアルゴリズ� またはタイプの名前を含む一連のStringオブジェクト、または指定したサービスをサポートするプロバイダがない� �合は空のセット。

導入されたバージョン:

1.4