Класс Security

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

Получает указанное свойство для алгоритма. Имя алгоритма должно быть стандартным. См. Спецификацию Java Security Standard Algorithm Names для получения информации о стандартных именах алгоритмов. Возможным применением являются специализированные парсеры алгоритмов, которые могут сопоставлять классы с алгоритмами, которые они понимают (подобно тому, как это делают парсеры ключей).

public static int insertProviderAt(Provider provider, int position)

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

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

Поставщик не может быть добавлен, если он уже установлен.

Если существует менеджер безопасности, вызывается метод SecurityManager.checkSecurityAccess(java.lang.String) с целевым именем разрешения "insertProvider" для проверки возможности добавления нового поставщика. Если эта проверка разрешения отклонена, метод checkSecurityAccess снова вызывается с целевым именем разрешения "insertProvider."+provider.getName(). Если обе проверки отклонены, выбрасывается SecurityException

public static int addProvider(Provider provider)

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

Если существует менеджер безопасности, вызывается метод SecurityManager.checkSecurityAccess(java.lang.String) с целевым именем разрешения "insertProvider" для проверки возможности добавления нового поставщика. Если проверка разрешения отклонена, checkSecurityAccess вызывается снова с целевым именем разрешения "insertProvider."+provider.getName(). Если обе проверки отклонены, выбрасывается SecurityException

public static void removeProvider(String name)

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

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

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

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

public static Provider[] getProviders()

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

public static Provider getProvider(String name)

Возвращает установленного поставщика с указанным именем, если он существует. Возвращает null, если поставщик с указанным именем не установлен или если имя равно null.

public static Provider[] getProviders(String filter)

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

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

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

• <crypto_service>.<algorithm_or_type>

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

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

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

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

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

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

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

См. Спецификацию Java Security Standard Algorithm Names для получения информации о стандартных именах криптографических сервисов, стандартных именах алгоритмов и стандартных именах атрибутов.

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

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

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

• <криптографическая_служба>.<алгоритм_или_тип>

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

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

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

• <криптографическая_служба>. <алгоритм_или_тип> <имя_атрибута>

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

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

См. Спецификацию Java Security Standard Algorithm Names для информации о стандартных именах криптографических служб, стандартных именах алгоритмов и стандартных именах атрибутов.

public static String getProperty(String key)

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

Сначала, если существует менеджер безопасности, вызывается его метод checkPermission с разрешением java.security.SecurityPermission("getProperty."+key) для проверки возможности получения значения указанного свойства безопасности.

public static void setProperty(String key, String datum)

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

Сначала, если существует менеджер безопасности, вызывается его метод checkPermission с разрешением java.security.SecurityPermission("setProperty."+key) для проверки возможности установки значения указанного свойства безопасности.

public static Set<String> getAlgorithms(String serviceName)

Возвращает набор строк, содержащих имена всех доступных алгоритмов или типов для указанной Java-криптографической службы (например, Signature, MessageDigest, Cipher, Mac, KeyStore). Возвращает пустой набор, если ни один поставщик не поддерживает указанную службу или если serviceName равен null. Полный список Java-криптографических служб см. в Руководстве по архитектуре Java Cryptography (JCA). Примечание: возвращаемый набор неизменяем.