java.security
클래스 Security

java.lang.Object 
  |
  +--java.security.Security

public final class Security

extends Object

이 클래스는 모든 시큐러티 프로퍼티, 및 공통의 시큐러티 메소드를 집중관리합니다. 그 주된 사용 목적의 1 개에 프로바이더의 관리가 있습니다.

메소드의 개요

static int	addProvider (Provider provider) 프로바이더를 가능한 다음의 위치에 추가합니다.
static String	getAlgorithmProperty (String algName, String propName) 추천 되고 있지 않습니다. 이 메소드는 SUN 암호화 서비스 프로바이더의 마스터 파일내에 있는 소유 프로퍼티의 값을 돌려주기 위해서(때문에) 사용됩니다. 이것은 알고리즘 고유의 파라미터의 구문 분석 방법을 결정하기 위한 처리입니다. 이 메소드 대신에, 새로운 프로바이더를 기본으로 하는 알고리즘에 의존하지 않는 AlgorithmParameters 및 KeyFactory 엔진 클래스 (Java 2 플랫폼보다 도입)를 사용해 주세요.
static Set	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 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

메소드의 상세

getAlgorithmProperty

public static String  getAlgorithmProperty(String  algName,
                                          String  propName)

추천 되고 있지 않습니다. 이 메소드는 SUN 암호화 서비스 프로바이더의 마스터 파일내에 있는 소유 프로퍼티의 값을 돌려주기 위해서(때문에) 사용됩니다. 이것은 알고리즘 고유의 파라미터의 구문 분석 방법을 결정하기 위한 처리입니다. 이 메소드 대신에, 새로운 프로바이더를 기본으로 하는 알고리즘에 의존하지 않는 AlgorithmParameters 및 KeyFactory 엔진 클래스 (Java 2 플랫폼보다 도입)를 사용해 주세요.

알고리즘에 대한 지정된 프로퍼티를 취득합니다. 알고리즘의 이름은 표준명으로 할 필요가 있습니다. 알고리즘 표준명에 대해서는 「Java 암호화 아키텍쳐 API 사양 & 레퍼런스」의 부록 A 를 참조해 주세요. 용도의 1 개에, 전용의 알고리즘 파서에 의한 사용이 있습니다. 이 알고리즘 파서는 (Key 파서가 실시하는 것과 거의와 같이 ) 그것이 인식하는 알고리즘에 클래스 매핑 합니다.

파라미터:

algName - 알고리즘명

propName - 취득하는 프로퍼티의 이름

반환값:

지정된 프로퍼티의 값

insertProviderAt

public static int insertProviderAt(Provider  provider,
                                   int position)

지정된 위치에 신규 프로바이더를 추가합니다. 위치는 우선순서가 되어 있어, 요구된 알고리즘에 대해서 프로바이더가 그 순서로 검색됩니다. 이 우선 순서는 지켜질 수 없는 경우가 있는 것에 주의해 주세요. 위치는 1 으로부터 시작되기 (위해)때문에, 1 이 최우선으로 되어, 그 다음이 2,... (와)과 계속됩니다.

지정된 프로바이더가 요구된 위치에 인스톨 되는 경우, 그 위치에 있던 프로바이더와 position 를 넘는 위치에 있는 모든 프로바이더는 (인스톨 되고 있는 프로바이더의 리스트의 마지막 (분)편을 향해) 1 kr씩 앞당길 수 있습니다.

프로바이더는 인스톨 끝난 경우에는 추가할 수 없습니다.

시큐러티 매니저가 존재하는 경우, 최초로 시큐러티 매니저의 checkSecurityAccess 메소드가 인수로서 "insertProvider. "+provider.getName() 라고 하는 캐릭터 라인을 지정해 불려 가 새로운 프로바이더를 추가해도 괜찮은지 어떤지를 확인합니다. 디폴트의 checkSecurityAccess 의 구현이 사용되는 경우 (즉,checkSecurityAccess 메소드가 오버라이드(override)되어 있지 않은 경우), 이 메소드의 결과는 시큐러티 매니저의 checkPermission 메소드가 인수로서 SecurityPermission("insertProvider. "+provider.getName()) 액세스권을 지정해 불려 갔을 경우와 같습니다.

파라미터:

provider - 추가되는 프로바이더

position - 호출측이 이 프로바이더에 요망하는 우선적인 위치

반환값:

프로바이더가 추가된 실제의 우선 위치. 인스톨이 끝난 상태로 추가할 수 없는 경우는 -1

예외:

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 의 구현이 사용되는 경우 (즉,checkSecurityAccess 메소드가 오버라이드(override)되어 있지 않은 경우), 이 메소드의 결과는 시큐러티 매니저의 checkPermission 메소드가 인수로서 SecurityPermission("insertProvider. "+provider.getName()) 액세스권을 지정해 불려 갔을 경우와 같습니다.

파라미터:

provider - 추가되는 프로바이더

반환값:

프로바이더가 추가된 실제의 우선 위치. 인스톨이 끝난 상태로 추가할 수 없는 경우는 -1

예외:

SecurityException - 시큐러티 매니저가 존재하는 경우에, 시큐러티 매니저의 SecurityManager.checkSecurityAccess(java.lang.String) 메소드가 새로운 프로바이더의 추가를 허가하지 않을 때

관련 항목:

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

removeProvider

public static void removeProvider(String  name)

지정된 이름의 프로바이더를 삭제합니다.

지정된 프로바이더가 삭제되는 경우, 지정된 프로바이더가 있던 위치를 넘는 위치에 있는 모든 프로바이더는 (인스톨 되고 있는 프로바이더의 리스트의 선두에 향해) 1 kr씩 뒤로 돌릴 수 있습니다.

이 메소드는 프로바이더가 인스톨되어 있지 않은 경우는 아무것도 실시하지 않고 복귀합니다.

시큐러티 매니저가 존재하는 경우, 최초로 시큐러티 매니저의 checkSecurityAccess 메소드가 인수로서 "removeProvider. "+name 라고 하는 캐릭터 라인을 지정해 불려 가 프로바이더를 삭제해도 괜찮은지 어떤지를 확인합니다. 디폴트의 checkSecurityAccess 의 구현이 사용되는 경우 (즉,checkSecurityAccess 메소드가 오버라이드(override)되어 있지 않은 경우), 이 메소드의 결과는 시큐러티 매니저의 checkPermission 메소드가 인수로서 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)

지정된 이름으로 인스톨 되고 있는 프로바이더를 돌려줍니다. 지정된 이름의 프로바이더가 인스톨되어 있지 않은 경우는 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 암호화 아키텍쳐 API 사양 & 레퍼런스」의 부록 A 를 참조

파라미터:

filter - 프로바이더의 선택 기준. 필터는 대문자와 소문자를 구별한다

반환값:

선택 기준을 채우는 인스톨 끝난 모든 프로바이더. 이러한 프로바이더가 없는 경우는 null

예외:

InvalidParameterException - 필터가 필요한 형식 이외의 경우

관련 항목:

getProviders(java.util.Map)

getProviders

public static Provider [] getProviders(Map  filter)

지정된 선택 기준을 채우는 모든 인스톨 된 프로바이더를 포함한 배열을 돌려줍니다. 이러한 프로바이더가 존재하지 않는 경우는 null. 돌려주어진 프로바이더의 순서는「우선순서」라고 됩니다.

선택 기준은 MAP로 표현됩니다. 각 MAP 엔트리는 선택 기준입니다. 모든 선택 기준을 프로바이더가 채우고 있는 경우, 프로바이더는 선택됩니다. 이 MAP에서는 어느 엔트리의 열쇠도 다음의 2 종류의 형식의 어딘가에 됩니다.

• <crypto_service>. <algorithm_or_type>

  암호화 서비스명에는 닷을 포함하지 않게 합니다.

  열쇠에 관련한 값은 하늘의 캐릭터 라인일 필요가 있습니다.

  프로바이더가, 지정 암호화 서비스전용으로 지정된 알고리즘 또는 형태를 구현하고 있으면(자), 프로바이더는 이 선택 기준을 채우고 있습니다.

• <crypto_service>. <algorithm_or_type> <attribute_name>

  암호화 서비스명에는 닷을 포함하지 않게 합니다. <algorithm_or_type> 와 <attribute_name> 의 사이에 스페이스 캐릭터가 1 개 이상 필요합니다.

  열쇠에 관련한 값은 하늘이 아닌 캐릭터 라인이 됩니다. 프로바이더가, 지정 암호화 서비스전용으로 지정된 알고리즘 또는 형태를 구현하고 있어, 그 구현이 지정된 속성명과 값의 페어로 표기된 제약을 채우고 있는 경우, 프로바이더는 이 선택 기준을 채우고 있습니다.

암호화 서비스의 표준명, 알고리즘의 표준명, 속성의 표준명에 대해서는 「Java 암호화 아키텍쳐 API 사양 & 레퍼런스」의 부록 A 를 참조

파라미터:

filter - 프로바이더의 선택 기준. 필터는 대문자와 소문자를 구별한다

반환값:

선택 기준을 채우는 인스톨 끝난 모든 프로바이더. 이러한 프로바이더가 없는 경우는 null

예외:

InvalidParameterException - 필터가 필요한 형식 이외의 경우

관련 항목:

getProviders(java.lang.String)

getProperty

public static String  getProperty(String  key)

시큐러티 프로퍼티치를 취득합니다.

시큐러티 매니저가 존재하는 경우, 시큐러티 매니저의 checkPermission 메소드가 java.security.SecurityPermission("getProperty. "+key) 액세스권을 인수로서 지정해 불려 가 지정된 세큐리티프로바티치를 취득해도 괜찮은지 어떤지를 확인합니다.

파라미터:

key - 취득하는 프로퍼티의 키

반환값:

키에 대응하는 시큐러티 프로퍼티의 값

예외:

SecurityException - 시큐러티 매니저가 존재하는 경우에, 시큐러티 매니저의 SecurityManager.checkPermission(java.security.Permission) 메소드가 지정된 시큐러티 프로퍼티치의 취득을 허가하지 않을 때

관련 항목:

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

setProperty

public static void setProperty(String  key,
                               String  datum)

시큐러티 프로퍼티의 값을 설정합니다.

시큐러티 매니저가 존재하는 경우, 시큐러티 매니저의 checkPermission 메소드가 java.security.SecurityPermission("getProperty. "+key) 액세스권을 인수로서 지정해 불려 가 지정된 세큐리티프로바티치를 취득해도 괜찮은지 어떤지를 확인합니다.

파라미터:

key - 설정되는 프로퍼티의 이름

datum - 설정되는 프로퍼티의 값

예외:

SecurityException - 시큐러티 매니저가 존재하는 경우에, 시큐러티 매니저의 SecurityManager.checkPermission(java.security.Permission) 메소드가 지정된 시큐러티 프로퍼티치의 설정을 허가하지 않을 때

관련 항목:

getProperty(java.lang.String) , SecurityPermission

getAlgorithms

public static Set  getAlgorithms(String  serviceName)

지정한 Java 암호화 서비스로 사용 가능한 알고리즘이나 형태의 이름 (Signature, MessageDigest, Cipher, Mac, KeyStore 등)을 포함한 String 의 Set 를 돌려줍니다. 지정한 서비스로 서포트되는 프로바이더가 없는 경우는 하늘의 Set 가 돌려주어집니다. Java 암호화 서비스의 일람에 대해서는 Java Cryptography Architecture API Specification & Reference 를 참조해 주세요. 주: 돌려주어지는 세트는 불변입니다.

파라미터:

serviceName - Java 암호화 서비스의 이름 (Signature, MessageDigest, Cipher, Mac, KeyStore 등). 주: 이 파라미터는 대문자 소문자를 구별한다

반환값:

지정한 Java 암호화 서비스로 사용 가능한 알고리즘이나 형태의 이름을 포함한 String 의 Set. 지정한 서비스로 서포트되는 프로바이더가 없는 경우는 하늘세트가 돌려주어지는

도입된 버젼:

1.4