java.security
클래스 KeyPairGenerator

java.lang.Object 
  |
  +--java.security.KeyPairGeneratorSpi 
        |
        +--java.security.KeyPairGenerator

public abstract class KeyPairGenerator

extends KeyPairGeneratorSpi

KeyPairGenerator 클래스는 공개열쇠와 비공개열쇠의 페어를 생성하기 위해서 사용합니다. 열쇠 페어 제네레이터는 getInstance 팩토리 메소드 (지정된 클래스의 인스턴스를 돌려주는 static 메소드)를 사용해 구축됩니다.

특정의 알고리즘에 대응하는 열쇠 페어 제네레이터는 이 알고리즘으로 사용되는 공개열쇠 및 비공개열쇠의 페어를 작성합니다. 또, 알고리즘에 특정의 파라미터를, 생성된 양쪽 모두의 열쇠에 관련짓습니다.

열쇠 페어를 생성하려면 2 방법의 방법, 즉, 알고리즘에 의존하지 않는 방법과 알고리즘에 특정의 방법이 있습니다. 이 2 개의 방법은 오브젝트의 초기화만이 다릅니다.

• 알고리즘에 의존하지 않는 초기화

  모든 열쇠 페어 제네레이터는 키 사이즈와 난수의 발생원이라고 하는 개념을 공유합니다. 키 사이즈의 해석은 알고리즘에 따라서 다릅니다 (예를 들어, DSA 알고리즘의 경우, 사이즈는 비트로 나타낸 모쥬라스의 길이에 대응). 이 KeyPairGenerator 클래스에는 initialize 라고 하는 메소드가 있어, 전체에 공통되는 형태의 2 개의 인수를 취합니다. 또, 인수에 keysize 만을 취해, 난수의 발생원으로서 가장 높은 우선 순위로 인스톨 되고 있는 프로바이더의 SecureRandom 의 구현을 사용하는 initialize 메소드도 있습니다. SecureRandom 를 제공하는 프로바이더가 1 개나 인스톨되어 있지 않은 경우는 시스템이 제공하는 난수의 발생원이 사용됩니다.

  상기의 알고리즘에 의존하지 않는 initialize 메소드를 호출했을 경우, 파라미터가 지정되지 않기 때문에, 각각의 열쇠에 관련한 알고리즘에 특정인 파라미터가 존재하는 경우, 이것을 어떻게 취급할까는 프로바이더에 맡습니다.

  알고리즘이 DSA 로, 키 사이즈 (모듈러 여물 이즈)가 512, 768, 또는 1024 의 경우, Sun 프로바이더는 파라미터 p,q, 및 g 에 계산 끝난 값세트를 사용합니다. 모듈러 여물 이즈가 상기의 어떤 것도 아닌 경우, Sun 프로바이더는 파라미터세트를 새롭게 작성합니다. 프로바이더에 따라서는 상기의 3 종류 만이 아니고, 좀 더 많은 모듈러 여물 이즈에 대응하는 파라미터세트를 가지고 있는 일도 있습니다. 반대로, 계산 끝난 파라미터의 리스트를 가지지 않고 항상 새로운 파라미터세트를 작성하는 프로바이더도 있습니다.

• 알고리즘에 의존하지 않는 초기화

  알고리즘에 특정의 파라미터 (예를 들어, DSA 의 커뮤니티 파라미터)가 벌써 존재하고 있는 경우는 인수에 AlgorithmParameterSpec 를 취하는 2 종류의 initialize 메소드를 이용할 수 있습니다. 이 중 한편은 인수에 SecureRandom 를 취합니다만, 이제(벌써) 한편은 난수의 발생원으로서 가장 높은 우선 순위로 인스톨 되고 있는 프로바이더의 SecureRandom 의 구현을 사용합니다. SecureRandom 를 제공하는 프로바이더가 1 개나 인스톨되어 있지 않은 경우는 시스템이 제공하는 난수의 발생원이 사용됩니다.

클라이언트가 initialize 메소드의 호출로 명시적으로 KeyPairGenerator 를 초기화하지 않는 경우는 각 프로바이더는 디폴트의 초기화를 제공해, 이것을 문서화하지 않으면 안됩니다. 예를 들어 Sun 의 프로바이더는 사이즈가 1,024 비트인 디폴트의 모듈러 여물 이즈 (키 사이즈)를 사용합니다.

이 클래스는 역사적인 사정으로부터 KeyPairGeneratorSpi 클래스를 계승한 abstract 클래스가 되어 있습니다. 어플리케이션의 개발자는 이 KeyPairGenerator 클래스에서 정의된 메소드인 만큼 배려해 주세요. 슈퍼 클래스의 모든 메소드는 열쇠 페어 제네레이터의 독자적인 구현을 제공할 필요가 있는 암호 서비스 프로바이더로 사용되는 것을 상정하고 있습니다.

관련 항목:

AlgorithmParameterSpec

생성자의 개요

protected

KeyPairGenerator (String algorithm) 지정된 알고리즘에 대한 KeyPairGenerator 를 작성합니다.

메소드의 개요

KeyPair	generateKeyPair () 열쇠 페어를 생성합니다.
KeyPair	genKeyPair () 열쇠 페어를 생성합니다.
String	getAlgorithm () 이 열쇠 페어 제네레이터의 알고리즘의 표준명을 돌려줍니다.
static KeyPairGenerator	getInstance (String algorithm) 지정된 다이제스트 알고리즘을 구현하는 KeyPairGenerator 오브젝트를 작성합니다.
static KeyPairGenerator	getInstance (String algorithm, Provider provider) 지정된 프로바이더로부터 지정된 알고리즘이 사용 가능한 경우에, 그 프로바이더가 제공한 알고리즘을 구현하는 KeyPairGenerator 오브젝트를 작성합니다.
static KeyPairGenerator	getInstance (String algorithm, String provider) 지정된 프로바이더로부터 지정된 알고리즘이 사용 가능한 경우에, 그 프로바이더가 제공한 알고리즘을 구현하는 KeyPairGenerator 오브젝트를 작성합니다.
Provider	getProvider () 이 열쇠 페어 제네레이터 오브젝트의 프로바이더를 돌려줍니다.
void	initialize (AlgorithmParameterSpec params) 지정된 파라미터세트와 난수의 발생원으로서 가장 높은 우선 순위로 인스톨 되고 있는 프로바이더의 SecureRandom 의 구현을 사용해, 열쇠 페어 제네레이터를 초기화합니다.
void	initialize (AlgorithmParameterSpec params, SecureRandom random) 지정된 파라미터 세트와 난수의 발생원을 사용해 열쇠 페어 제네레이터를 초기화합니다.
void	initialize (int keysize) 임의의 열쇠의 사이즈에 대한 열쇠 페어 제네레이터를 초기화합니다.
void	initialize (int keysize, SecureRandom random) 임의의 키 사이즈 대하는 열쇠 페어 제네레이터를 초기화합니다.

클래스 java.lang. Object 에서 상속받은 메소드

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

생성자의 상세

KeyPairGenerator

protected KeyPairGenerator(String  algorithm)

지정된 알고리즘에 대한 KeyPairGenerator 를 작성합니다.

파라미터:

algorithm - 알고리즘의 표준명의 캐릭터 라인. 알고리즘의 표준명에 대해서는 「Java 암호화 아키텍쳐 API 사양 & 레퍼런스」의 부록 A 를 참조

메소드의 상세

getAlgorithm

public String  getAlgorithm()

이 열쇠 페어 제네레이터의 알고리즘의 표준명을 돌려줍니다. 표준 알고리즘명에 대해서는 「Java 암호화 아키텍쳐 API 사양 & 레퍼런스」의 부록 A 를 참조해 주세요.

반환값:

알고리즘의 표준명을 나타내는 캐릭터 라인

getInstance

public static KeyPairGenerator  getInstance(String  algorithm)
                                    throws NoSuchAlgorithmException 

지정된 다이제스트 알고리즘을 구현하는 KeyPairGenerator 오브젝트를 작성합니다. 필요한 다이제스트 알고리즘의 구현이, 디폴트의 프로바이더 패키지에 의해 제공되고 있는 경우는 그 구현을 가지는 KeyPairGenerator 클래스의 인스턴스를 돌려줍니다. 디폴트의 패키지에서는 지정된 알고리즘을 이용할 수 없는 경우는 다른 패키지를 검색합니다.

파라미터:

algorithm - 알고리즘의 표준명의 캐릭터 라인. 알고리즘의 표준명에 대해서는 「Java 암호화 아키텍쳐 API 사양 & 레퍼런스」의 부록 A 를 참조

반환값:

새로운 KeyPairGenerator 오브젝트

예외:

NoSuchAlgorithmException - 알고리즘이 그 환경에서 사용할 수 없는 경우

getInstance

public static KeyPairGenerator  getInstance(String  algorithm,
                                           String  provider)
                                    throws NoSuchAlgorithmException ,
                                           NoSuchProviderException 

지정된 프로바이더로부터 지정된 알고리즘이 사용 가능한 경우에, 그 프로바이더가 제공한 알고리즘을 구현하는 KeyPairGenerator 오브젝트를 작성합니다.

파라미터:

algorithm - 알고리즘의 표준명의 캐릭터 라인. 알고리즘의 표준명에 대해서는 「Java 암호화 아키텍쳐 API 사양 & 레퍼런스」의 부록 A 를 참조

provider - 프로바이더명의 캐릭터 라인

반환값:

새로운 KeyPairGenerator 오브젝트

예외:

NoSuchAlgorithmException - 지정된 프로바이더에 알고리즘이 없는 경우

NoSuchProviderException - 프로바이더가 그 환경에서 사용할 수 없는 경우

IllegalArgumentException - 프로바이더의 이름이 null 나 비었을 경우

관련 항목:

Provider

getInstance

public static KeyPairGenerator  getInstance(String  algorithm,
                                           Provider  provider)
                                    throws NoSuchAlgorithmException 

지정된 프로바이더로부터 지정된 알고리즘이 사용 가능한 경우에, 그 프로바이더가 제공한 알고리즘을 구현하는 KeyPairGenerator 오브젝트를 작성합니다. 주: provider 를 등록할 필요는 없습니다.

파라미터:

algorithm - 알고리즘의 표준명의 캐릭터 라인. 알고리즘의 표준명에 대해서는 「Java 암호화 아키텍쳐 API 사양 & 레퍼런스」의 부록 A 를 참조

provider - 프로바이더

반환값:

새로운 KeyPairGenerator 오브젝트

예외:

NoSuchAlgorithmException - 지정된 프로바이더에 알고리즘이 없는 경우

IllegalArgumentException - provider 가 null 의 경우

도입된 버젼:

1.4

관련 항목:

Provider

getProvider

public final Provider  getProvider()

이 열쇠 페어 제네레이터 오브젝트의 프로바이더를 돌려줍니다.

반환값:

이 열쇠 페어 제네레이터 오브젝트의 프로바이더

initialize

public void initialize(int keysize)

임의의 열쇠의 사이즈에 대한 열쇠 페어 제네레이터를 초기화합니다. 디폴트의 파라미터 세트와 난수의 발생원으로서 가장 높은 우선 순위로 인스톨 되고 있는 프로바이더의 SecureRandom 의 구현을 사용합니다. SecureRandom 를 제공하는 프로바이더가 1 개나 인스톨되어 있지 않은 경우는 시스템이 제공하는 난수의 발생원이 사용됩니다.

파라미터:

keysize - 키 사이즈. 모쥬라스의 길이와 같은 bit length로 지정된 알고리즘에 특정의 메트릭스

예외:

InvalidParameterException - 이 KeyPairGenerator 오브젝트가 keysize 메소드를 서포트하고 있지 않는 경우

initialize

public void initialize(int keysize,
                       SecureRandom  random)

임의의 키 사이즈 대하는 열쇠 페어 제네레이터를 초기화합니다. 지정된 난수의 발생원과 디폴트의 파라미터 세트를 사용합니다.

정의:

클래스 KeyPairGeneratorSpi 내의 initialize

파라미터:

keysize - 키 사이즈. 모쥬라스의 길이와 같은 bit length로 지정된 알고리즘에 특정의 메트릭스

random - 난수의 발생원

예외:

InvalidParameterException - 이 KeyPairGenerator 오브젝트가 keysize 메소드를 서포트하고 있지 않는 경우

도입된 버젼:

1.2

initialize

public void initialize(AlgorithmParameterSpec  params)
                throws InvalidAlgorithmParameterException 

지정된 파라미터세트와 난수의 발생원으로서 가장 높은 우선 순위로 인스톨 되고 있는 프로바이더의 SecureRandom 의 구현을 사용해, 열쇠 페어 제네레이터를 초기화합니다. SecureRandom 를 제공하는 프로바이더가 1 개나 인스톨되어 있지 않은 경우는 시스템이 제공하는 난수의 발생원이 사용됩니다.

이 구상 메소드는 사전에 정의된 abstract 클래스에 추가된 것입니다. 이 메소드는 KeyPairGeneratorSpi 클래스의 initialize(java.security.spec.AlgorithmParameterSpec, java.security.SecureRandom) initialize 메소드를 호출합니다. 메소드의 호출 시에는 인수로서 params 와 난수의 발생원 (인스톨 되고 있는 프로바이더 가운데, 가장 우선 순위의 높은 프로바이더 제공하는 난수의 발생원. 프로바이더가 난수의 발생원을 제공하지 않는 경우는 시스템이 제공하는 난수의 발생원)을 건네줍니다. 이 initialize 메소드는 프로바이더에 의해 오버라이드(override)되어 있지 않은 한, 반드시 UnsupportedOperationException 를 슬로우 합니다.

파라미터:

params - 열쇠를 생성하기 위한 파라미터 세트

예외:

InvalidAlgorithmParameterException - 지정된 파라미터가 이 열쇠 페어 제네레이터에 부적절한 경우

도입된 버젼:

1.2

initialize

public void initialize(AlgorithmParameterSpec  params,
                       SecureRandom  random)
                throws InvalidAlgorithmParameterException 

지정된 파라미터 세트와 난수의 발생원을 사용해 열쇠 페어 제네레이터를 초기화합니다.

이 구상 메소드는 사전에 정의된 abstract 클래스에 추가된 것입니다. 이 메소드는 params 와 random 를 건네주어, KeyPairGeneratorSpi 클래스의 initialize 메소드를 호출합니다. 이 initialize 메소드는 프로바이더에 의해 오버라이드(override) 되지 않는 경우는 반드시 UnsupportedOperationException 를 슬로우 합니다.

오버라이드(override):

클래스 KeyPairGeneratorSpi 내의 initialize

파라미터:

params - 열쇠를 생성하기 위한 파라미터 세트

random - 난수의 발생원

예외:

InvalidAlgorithmParameterException - 지정된 파라미터가 이 열쇠 페어 제네레이터에 부적절한 경우

도입된 버젼:

1.2

genKeyPair

public final KeyPair  genKeyPair()

열쇠 페어를 생성합니다.

KeyPairGenerator 가 명시적으로 초기화되어 있지 않은 경우는 프로바이더 지정된 디폴트가 생성된 열쇠의 사이즈 및 알고리즘에 특정의 값에 사용합니다.

KeyPairGenerator 는 불려 갈 때마다, 새로운 열쇠 페어를 생성합니다.

이 메소드는 기능적으로는 generateKeyPair 와 같습니다.

반환값:

생성된 열쇠 페어

도입된 버젼:

1.2

generateKeyPair

public KeyPair  generateKeyPair()

열쇠 페어를 생성합니다.

KeyPairGenerator 가 명시적으로 초기화되어 있지 않은 경우는 프로바이더 지정된 디폴트가 생성된 열쇠의 사이즈 및 알고리즘에 특정의 값에 사용합니다.

KeyPairGenerator 는 불려 갈 때마다, 새로운 열쇠 페어를 생성합니다.

이 메소드는 기능적으로는 genKeyPair 와 같습니다.

정의:

클래스 KeyPairGeneratorSpi 내의 generateKeyPair

반환값:

생성된 열쇠 페어