|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
java.lang.Object java.security.Security
public final class Security
このクラスは、すべてのセキュリティプロパティ、および共通のセキュリティメソッドを集中管理します。その主な使用目的の 1 つにプロバイダの管理があります。
メソッドの概要 | |
---|---|
static int |
addProvider(Provider provider)
プロバイダを可能な次の位置に追加します。 |
static String |
getAlgorithmProperty(String algName,
String propName)
推奨されていません。 このメソッドは、SUN 暗号化サービスプロバイダのマスターファイル内にある所有プロパティの値を返すために使用されます。これは、アルゴリズム固有のパラメータの構文解析方法を決定するための処理です。このメソッドの代わりに、新しいプロバイダを基本とするアルゴリズムに依存しない、 AlgorithmParameters および KeyFactory エンジンクラス (Java 2 プラットフォームより導入) を使用してください。 |
static Set<String> |
getAlgorithms(String serviceName)
指定した Java 暗号化サービスで使用可能なアルゴリズムや型の名前 (Signature、MessageDigest、Cipher、Mac、KeyStore など) を含む String の Set を返します。 |
static String |
getProperty(String key)
セキュリティプロパティ値を取得します。 |
static Provider |
getProvider(String name)
指定された名前でインストールされているプロバイダを返します。 |
static Provider[] |
getProviders()
インストールされているすべてのプロバイダの配列を返します。 |
static Provider[] |
getProviders(Map<String,String> filter)
指定された選択基準を満たすすべてのインストールされたプロバイダを含む配列を返します。 |
static Provider[] |
getProviders(String filter)
指定された選択基準を満たすすべてのインストールされたプロバイダを含む配列を返します。 |
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 |
メソッドの詳細 |
---|
@Deprecated public static String getAlgorithmProperty(String algName, String propName)
AlgorithmParameters
および KeyFactory
エンジンクラス (Java 2 プラットフォームより導入) を使用してください。
algName
- アルゴリズム名propName
- 取得するプロパティの名前
public static int insertProviderAt(Provider provider, int position)
指定されたプロバイダが要求された位置にインストールされる場合、その位置にあったプロバイダと position
を超える位置にあるすべてのプロバイダは、(インストールされているプロバイダのリストの最後の方に向かって) 1 つずつ繰り上げられます。
プロバイダは、インストール済みの場合には追加できません。
セキュリティマネージャが存在する場合、まずセキュリティマネージャの checkSecurityAccess
メソッドが文字列 "insertProvider."+provider.getName()
を指定して呼び出され、新しいプロバイダを追加してもよいかどうかが確認されます。checkSecurityAccess
のデフォルト実装が使用される場合 (つまり、このメソッドオーバーライドされていない場合)、このメソッドの呼び出しによって、セキュリティマネージャの checkPermission
メソッドが SecurityPermission("insertProvider."+provider.getName())
アクセス権を指定して呼び出されます。
provider
- 追加されるプロバイダposition
- 呼び出し側がこのプロバイダに要望する優先的な位置
NullPointerException
- provider が null の場合
SecurityException
- セキュリティマネージャが存在する場合に、セキュリティマネージャの SecurityManager.checkSecurityAccess(java.lang.String)
メソッドが新しいプロバイダの追加を許可しないときgetProvider(java.lang.String)
,
removeProvider(java.lang.String)
,
SecurityPermission
public static int addProvider(Provider provider)
セキュリティマネージャが存在する場合、まずセキュリティマネージャの checkSecurityAccess
メソッドが文字列 "insertProvider."+provider.getName()
を指定して呼び出され、新しいプロバイダを追加してもよいかどうかが確認されます。checkSecurityAccess
のデフォルト実装が使用される場合 (つまり、このメソッドオーバーライドされていない場合)、このメソッドの呼び出しによって、セキュリティマネージャの checkPermission
メソッドが SecurityPermission("insertProvider."+provider.getName())
アクセス権を指定して呼び出されます。
provider
- 追加されるプロバイダ
NullPointerException
- provider が null の場合
SecurityException
- セキュリティマネージャが存在する場合に、セキュリティマネージャの SecurityManager.checkSecurityAccess(java.lang.String)
メソッドが新しいプロバイダの追加を許可しないときgetProvider(java.lang.String)
,
removeProvider(java.lang.String)
,
SecurityPermission
public static void removeProvider(String name)
指定されたプロバイダが削除される場合、指定されたプロバイダがあった位置を超える位置にあるすべてのプロバイダは、(インストールされているプロバイダのリストの先頭の方に向かって) 1 つずつ繰り下げられます。
このメソッドは、プロバイダがインストールされていない場合、あるいは name が null の場合、処理を何も行わずに復帰します。
セキュリティマネージャが存在する場合、まずセキュリティマネージャの checkSecurityAccess
メソッドが文字列 "removeProvider."+name
を指定して呼び出され、プロバイダを削除してもよいかどうかが確認されます。checkSecurityAccess
のデフォルト実装が使用される場合 (つまり、このメソッドがオーバーライドされていない場合)、このメソッドの呼び出しによって、セキュリティマネージャの checkPermission
メソッドが SecurityPermission("removeProvider."+name)
アクセス権を指定して呼び出されます。
name
- 削除されるプロバイダの名前
SecurityException
- セキュリティマネージャが存在する場合に、セキュリティマネージャの SecurityManager.checkSecurityAccess(java.lang.String)
メソッドがこのプロバイダを削除するアクセスを許可しないときgetProvider(java.lang.String)
,
addProvider(java.security.Provider)
public static Provider[] getProviders()
public static Provider getProvider(String name)
name
- 取得するプロパティの名前
removeProvider(java.lang.String)
,
addProvider(java.security.Provider)
public static Provider[] getProviders(String filter)
暗号化サービスは必ず特定のアルゴリズムまたは型に関連付けられています。デジタル署名サービスの場合は、常に DSA などの特定のアルゴリズムと関連付けられており、CertificateFactory サービスは常に X.509 などの特定の証明型と関連付けられています。
次の 2 種類のフォーマットのどちらかで選択基準を指定する必要があります。
暗号化サービス名には、ドットを含まないようにします。
プロバイダが、指定暗号化サービス向けに指定されたアルゴリズムまたは型を実装していると、プロバイダは指定された選択基準を満たしています。
「CertificateFactory.X.509」の場合は、X.509 証明書の CertificateFactory の実装を提供しているプロバイダであれば、その選択基準を満たしています。
暗号化サービス名には、ドットを含まないようにします。<algorithm_or_type> と <attribute_name> の間にスペース文字が 1 つ以上必要です。
プロバイダが、指定暗号化サービス向けに指定されたアルゴリズムまたは型を実装していて、その実装が指定された属性名と値のペアで表記された制約を満たしている場合、プロバイダはこの選択基準を満たしています。
たとえば、1024 以上のキーサイズを持つ SHA1withDSA 署名アルゴリズムを実装しているどのプロバイダも、「Signature.SHA1withDSA KeySize:1024」を満たしています。
暗号化サービスの標準名、アルゴリズムの標準名、属性の標準名については、「Java 暗号化アーキテクチャ API 仕様 & リファレンス」の付録 A を参照
filter
- プロバイダの選択基準。フィルタは大文字と小文字を区別する
InvalidParameterException
- フィルタが必要な形式以外の場合
NullPointerException
- filter が null の場合getProviders(java.util.Map)
public static Provider[] getProviders(Map<String,String> filter)
選択基準はマップで表現されます。各マップエントリは選択基準のことです。すべての選択基準をプロバイダが満たしている場合、プロバイダは選択されます。このマップでは、どのエントリの鍵も次の 2 種類の形式のどちらかになります。
暗号化サービス名には、ドットを含まないようにします。
鍵に関連した値は空の文字列である必要があります。
プロバイダが、指定暗号化サービス向けに指定されたアルゴリズムまたは型を実装していると、プロバイダはこの選択基準を満たしています。
暗号化サービス名には、ドットを含まないようにします。<algorithm_or_type> と <attribute_name> の間にスペース文字が 1 つ以上必要です。
鍵に関連した値は、空でない文字列になります。プロバイダが、指定暗号化サービス向けに指定されたアルゴリズムまたは型を実装していて、その実装が指定された属性名と値のペアで表記された制約を満たしている場合、プロバイダはこの選択基準を満たしています。
暗号化サービスの標準名、アルゴリズムの標準名、属性の標準名については、「Java 暗号化アーキテクチャ API 仕様 & リファレンス」の付録 A を参照
filter
- プロバイダの選択基準。フィルタは大文字と小文字を区別する
InvalidParameterException
- フィルタが必要な形式以外の場合
NullPointerException
- filter が null の場合getProviders(java.lang.String)
public static String getProperty(String key)
セキュリティマネージャが存在する場合、セキュリティマネージャの checkPermission
メソッドが java.security.SecurityPermission("getProperty."+key)
アクセス権を引数として指定して呼び出され、指定されたセキュリティプロバティ値を取得してもよいかどうかを確認します。
key
- 取得するプロパティのキー
SecurityException
- セキュリティマネージャが存在する場合に、セキュリティマネージャの SecurityManager.checkPermission(java.security.Permission)
メソッドが指定されたセキュリティプロパティ値の取得を許可しないとき
NullPointerException
- key が null の場合setProperty(java.lang.String, java.lang.String)
,
SecurityPermission
public static void setProperty(String key, String datum)
セキュリティマネージャが存在する場合、セキュリティマネージャの checkPermission
メソッドが java.security.SecurityPermission("getProperty."+key)
アクセス権を引数として指定して呼び出され、指定されたセキュリティプロバティ値を取得してもよいかどうかを確認します。
key
- 設定されるプロパティの名前datum
- 設定されるプロパティの値
SecurityException
- セキュリティマネージャが存在する場合に、セキュリティマネージャの SecurityManager.checkPermission(java.security.Permission)
メソッドが指定されたセキュリティプロパティ値の設定を許可しないとき
NullPointerException
- key または datum が null の場合getProperty(java.lang.String)
,
SecurityPermission
public static Set<String> getAlgorithms(String serviceName)
serviceName
- Java 暗号化サービスの名前 (Signature、MessageDigest、Cipher、Mac、KeyStore など)。注: このパラメータは大文字と小文字を区別する
|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。