compact1, compact2, compact3

java.security

Безопасность класса

java.lang. Объект

java.security. Безопасность

public final class Security
extends Object

Этот class централизует все свойства безопасности и методы коллективной безопасности. Одно из его основного использования должно управлять провайдерами.

Значения по умолчанию свойств безопасности читаются из специфичного для реализации расположения, которое обычно является файлом свойств lib/security/java.security в каталоге установки Java.

Сводка метода

Модификатор и Тип	Метод и Описание
static int	addProvider(Provider provider) Добавляет провайдер к следующей доступной позиции.
static String	getAlgorithmProperty(String algName, String propName) Осуждаемый. Этот метод, используемый, чтобы возвратить значение собственного свойства в основном файле Провайдера криптографических служб "SUN", чтобы определить, как проанализировать специфичные для алгоритма параметры. Используйте новое основанное на провайдере и независимое от алгоритма AlgorithmParameters и KeyFactory классы механизма (представленный в платформе версии 1.2 J2SE) вместо этого.
static Set<String>	getAlgorithms(String serviceName) Возвраты ряд Строк, содержащих имена всех доступных алгоритмов или типов для указанной криптографической службы Java (например, Подпись, MessageDigest, Шифр, Mac, KeyStore).
static String	getProperty(String key) Получает значение свойства безопасности.
static Provider	getProvider(String name) Возвращает провайдера, установленного с указанным именем, если любой.
static Provider[]	getProviders() Возвращает массив, содержащий всех установленных провайдеров.
static Provider[]	getProviders(Map<String,String> filter) Возвращает массив, содержащий всех установленных провайдеров, которые удовлетворяют specified* критерии отбора, или нуль, если никакие такие провайдеры не были установлены.
static Provider[]	getProviders(String filter) Возвращает массив, содержащий всех установленных провайдеров, которые удовлетворяют указанный критерий выбора, или нуль, если никакие такие провайдеры не были установлены.
static int	insertProviderAt(Provider provider, int position) Добавляет новый провайдер в указанной позиции.
static void	removeProvider(String name) Удаляет провайдера с указанным именем.
static void	setProperty(String key, String datum) Устанавливает значение свойства безопасности.

Методы, наследованные от class java.lang. Объект

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

Деталь метода

getAlgorithmProperty

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

Осуждаемый. Этот метод, используемый, чтобы возвратить значение собственного свойства в основном файле Провайдера криптографических служб "SUN", чтобы определить, как проанализировать специфичные для алгоритма параметры. Используйте новое основанное на провайдере и независимое от алгоритма AlgorithmParameters и KeyFactory классы механизма (представленный в платформе версии 1.2 J2SE) вместо этого.

Получает указанное свойство для алгоритма. Имя алгоритма должно быть стандартным именем. См. Документацию Имени Алгоритма Стандарта Архитектуры Криптографии Java для информации о стандартных именах алгоритма. Одно возможное применение специализированными синтаксическими анализаторами алгоритма, которые могут классы сопоставления к алгоритмам, которые они понимают (очень как Ключевые синтаксические анализаторы, делают).

Параметры:

algName - имя алгоритма.

propName - имя свойства, чтобы добраться.

Возвраты:

значение указанного свойства.

insertProviderAt

public static int insertProviderAt(Provider provider,
                                   int position)

Добавляет новый провайдер в указанной позиции. Позиция является привилегированным порядком, в котором провайдеры ищутся требуемые алгоритмы. Позиция на основе 1, то есть, 1 больше всего предпочитается, сопровождается 2, и так далее.

Если данный провайдер устанавливается в требуемой позиции, провайдер, который имел обыкновение быть в той позиции, и всех провайдерах с позицией, больше чем position, смещаются одна позиция (к концу списка установленных провайдеров).

Провайдер не может быть добавлен, если он уже устанавливается.

Во-первых, если есть менеджер безопасности, checkSecurityAccess метод вызывают со строкой "insertProvider."+provider.getName() видеть, ли нормально добавлять нового провайдера. Если реализация по умолчанию checkSecurityAccess используется (то есть, тот метод не является overriden), тогда это приведет к звонку в менеджера безопасности checkPermission метод с a SecurityPermission("insertProvider."+provider.getName()) разрешение.

Параметры:

provider - провайдер, который будет добавлен.

position - привилегированная позиция, которую вызывающая сторона хотела бы за этого провайдера.

Возвраты:

фактическая привилегированная позиция, в которой провайдер был добавлен, или-1, если провайдер не был добавлен, потому что это уже устанавливается.

Броски:

NullPointerException - если провайдер является нулем

SecurityException - если менеджер безопасности существует и SecurityManager.checkSecurityAccess(java.lang.String) метод лишает доступа, чтобы добавить нового провайдера

См. Также:

getProvider(java.lang.String), removeProvider(java.lang.String), SecurityPermission

addProvider

public static int addProvider(Provider provider)

Добавляет провайдер к следующей доступной позиции.

Во-первых, если есть менеджер безопасности, checkSecurityAccess метод вызывают со строкой "insertProvider."+provider.getName() видеть, ли нормально добавлять нового провайдера. Если реализация по умолчанию checkSecurityAccess используется (то есть, тот метод не является overriden), тогда это приведет к звонку в менеджера безопасности checkPermission метод с a SecurityPermission("insertProvider."+provider.getName()) разрешение.

Параметры:

provider - провайдер, который будет добавлен.

Возвраты:

привилегированная позиция, в которой провайдер был добавлен, или-1, если провайдер не был добавлен, потому что это уже устанавливается.

Броски:

NullPointerException - если провайдер является нулем

SecurityException - если менеджер безопасности существует и SecurityManager.checkSecurityAccess(java.lang.String) метод лишает доступа, чтобы добавить нового провайдера

См. Также:

getProvider(java.lang.String), removeProvider(java.lang.String), SecurityPermission

removeProvider

public static void removeProvider(String name)

Удаляет провайдера с указанным именем.

Когда указанный провайдер удаляется, все провайдеры, расположенные в позиции, больше чем, где указанный провайдер был, смещаются вниз одна позиция (к главе списка установленных провайдеров).

Этот метод возвращается тихо, если провайдер не устанавливается или если имя является нулем.

Во-первых, если есть менеджер безопасности, checkSecurityAccess метод вызывают со строкой "removeProvider."+name видеть, ли нормально удалять провайдера. Если реализация по умолчанию checkSecurityAccess используется (то есть, тот метод не является overriden), тогда это приведет к звонку в менеджера безопасности checkPermission метод с a SecurityPermission("removeProvider."+name) разрешение.

Параметры:

name - имя провайдера, чтобы удалить.

Броски:

SecurityException - если менеджер безопасности существует и SecurityManager.checkSecurityAccess(java.lang.String) метод лишает доступа, чтобы удалить провайдера

См. Также:

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

getProviders

public static Provider[] getProviders()

Возвращает массив, содержащий всех установленных провайдеров. Порядок провайдеров в массиве является их привилегированным порядком.

Возвраты:

массив всех установленных провайдеров.

getProvider

public static Provider getProvider(String name)

Возвращает провайдера, установленного с указанным именем, если любой. Нуль возвратов, если никакой провайдер с указанным именем не устанавливается или если имя является нулем.

Параметры:

name - имя провайдера, чтобы добраться.

Возвраты:

провайдер указанного имени.

См. Также:

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

getProviders

public static Provider[] getProviders(String filter)

Возвращает массив, содержащий всех установленных провайдеров, которые удовлетворяют указанный критерий выбора, или нуль, если никакие такие провайдеры не были установлены. Возвращенные провайдеры упорядочиваются согласно их привилегированному порядку.

Криптографическая служба всегда связывается с определенным алгоритмом или типом. Например, служба цифровой подписи всегда связывается с определенным алгоритмом (например, DSA), и служба CertificateFactory всегда связывается с определенным типом сертификата (например, X.509).

Критерий выбора должен быть определен в одном из следующих двух форматов:

• <crypto_service>. <algorithm_or_type>

  Имя криптографической службы не должно содержать точки.

  Провайдер удовлетворяет указанную эквивалентность критерия выбора, провайдер реализует указанный алгоритм или тип для указанной криптографической службы.

  Например, "CertificateFactory. X.509" был бы удовлетворен любым провайдером, который предоставлял реализацию CertificateFactory для сертификатов X.509.

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

  Имя криптографической службы не должно содержать точки. Должны быть одно или более пространств charaters между <algorithm_or_type> и <attribute_name>.

  Провайдер удовлетворяет эту эквивалентность критерия выбора, провайдер реализует указанный алгоритм или тип для указанной криптографической службы, и ее реализация встречает ограничение, выраженное указанным названием атрибута / пара значения.

  Например, "Подпись. SHA1withDSA KeySize:1024" был бы удовлетворен любым провайдером, который реализовывал алгоритм подписи SHA1withDSA с размером ключа 1024 (или больше).

См. Документацию Имени Алгоритма Стандарта Архитектуры Криптографии Java для информации о стандартных именах криптографической службы, стандартных именах алгоритма и стандартных названиях атрибута.

Параметры:

filter - критерий для того, чтобы выбрать провайдеров. Фильтр является нечувствительным к регистру.

Возвраты:

все установленные провайдеры, которые удовлетворяют критерий выбора, или нуль, если никакие такие провайдеры не были установлены.

Броски:

InvalidParameterException - если фильтр не находится в необходимом формате

NullPointerException - если фильтр является нулем

С тех пор:

1.3

См. Также:

getProviders(java.util.Map)

getProviders

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

Возвращает массив, содержащий всех установленных провайдеров, которые удовлетворяют specified* критерии отбора, или нуль, если никакие такие провайдеры не были установлены. Возвращенные провайдеры упорядочиваются согласно их привилегированному порядку.

Критерии отбора представляются картой. Каждая запись карты представляет критерий выбора. Провайдер является выбранной эквивалентностью, это удовлетворяет все критерии отбора. Ключ для любой записи в такой карте должен быть в одном из следующих двух форматов:

• <crypto_service>. <algorithm_or_type>

  Имя криптографической службы не должно содержать точки.

  Значение, связанное с ключом, должно быть пустой строкой.

  Провайдер удовлетворяет эту эквивалентность критерия выбора, провайдер реализует указанный алгоритм или тип для указанной криптографической службы.

• <crypto_service>. <algorithm_or_type> <attribute_name>

  Имя криптографической службы не должно содержать точки. Должны быть одно или более пространств charaters между <algorithm_or_type> и <attribute_name>.

  Значение, связанное с ключом, должно быть непустой строкой. Провайдер удовлетворяет эту эквивалентность критерия выбора, провайдер реализует указанный алгоритм или тип для указанной криптографической службы, и ее реализация встречает ограничение, выраженное указанным названием атрибута / пара значения.

См. Документацию Имени Алгоритма Стандарта Архитектуры Криптографии Java для информации о стандартных именах криптографической службы, стандартных именах алгоритма и стандартных названиях атрибута.

Параметры:

filter - критерии для того, чтобы выбрать провайдеров. Фильтр является нечувствительным к регистру.

Возвраты:

все установленные провайдеры, которые удовлетворяют критерии отбора, или нуль, если никакие такие провайдеры не были установлены.

Броски:

InvalidParameterException - если фильтр не находится в необходимом формате

NullPointerException - если фильтр является нулем

С тех пор:

1.3

См. Также:

getProviders(java.lang.String)

getProperty

public static String getProperty(String key)

Получает значение свойства безопасности.

Во-первых, если есть менеджер безопасности, checkPermission метод вызывают с a java.security.SecurityPermission("getProperty."+key) разрешение, чтобы видеть, ли нормально получать указанное значение свойства безопасности..

Параметры:

key - ключ получаемого свойства.

Возвраты:

значение соответствия свойства безопасности ключу.

Броски:

SecurityException - если менеджер безопасности существует и SecurityManager.checkPermission(java.security.Permission) метод лишает доступа, чтобы получить указанное значение свойства безопасности

NullPointerException - является ключевым, нуль

См. Также:

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

setProperty

public static void setProperty(String key,
                               String datum)

Устанавливает значение свойства безопасности.

Во-первых, если есть менеджер безопасности, checkPermission метод вызывают с a java.security.SecurityPermission("setProperty."+key) разрешение, чтобы видеть, ли нормально устанавливать указанное значение свойства безопасности.

Параметры:

key - имя свойства, которое будет установлено.

datum - значение свойства, которое будет установлено.

Броски:

SecurityException - если менеджер безопасности существует и SecurityManager.checkPermission(java.security.Permission) метод лишает доступа, чтобы установить указанное значение свойства безопасности

NullPointerException - если ключ или данная величина являются нулем

См. Также:

getProperty(java.lang.String), SecurityPermission

getAlgorithms

public static Set<String> getAlgorithms(String serviceName)

Возвраты ряд Строк, содержащих имена всех доступных алгоритмов или типов для указанной криптографической службы Java (например, Подпись, MessageDigest, Шифр, Mac, KeyStore). Возвращает пустое множество, если нет никакого провайдера, который поддерживает указанную службу или если serviceName является нулем. Для полного списка криптографических служб Java, пожалуйста, см. Спецификацию API Архитектуры Криптографии Java & Ссылку. Отметьте: возвращенный набор является неизменным.

Параметры:

serviceName - имя криптографической службы Java (например, Подпись, MessageDigest, Шифр, Mac, KeyStore). Отметьте: этот параметр является нечувствительным к регистру.

Возвраты:

ряд Строк, содержащих имена всех доступных алгоритмов или типов для указанной криптографической службы Java или пустого множества, если никакой провайдер не поддерживает указанную службу.

С тех пор:

1.4