javax.crypto
클래스 KeyGenerator

java.lang.Object 
  |
  +--javax.crypto.KeyGenerator

public class KeyGenerator

extends Object

이 클래스는 (대칭) 열쇠 제네레이터의 기능을 제공합니다.

열쇠 제네레이터는 이 클래스의 getInstance 클래스 메소드의 1 개를 사용해 구축됩니다.

KeyGenerator 오브젝트는 재사용할 수 있습니다. 즉, 열쇠의 생성 후, 같은 KeyGenerator 오브젝트를 재사용해 한층 더 열쇠를 생성할 수가 있습니다.

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

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

  모든 열쇠 제네레이터는 「열쇠 사이즈」와「난수의 발생원」이라고 하는 개념을 공유합니다. 이 KeyGenerator 클래스에는 init 메소드가 있어, 전체에 공통되는 형태의 2 개의 인수를 취합니다. 또, 인수에 keysize 만을 취해, 난수의 발생원으로서 가장 높은 우선 순위로 인스톨 되고 있는 프로바이더의 SecureRandom 의 구현을 사용하는 init 메소드 (SecureRandom 의 구현을 제공하는 프로바이더가 1 개나 인스톨되어 있지 않은 경우는 시스템이 제공하는 난수의 발생원을 사용), 및 난수의 발생원만을 취하는 init 메소드도 있습니다.

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

• 알고리즘에 특정의 초기화

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

클라이언트가 init 메소드의 호출로 명시적으로 KeyGenerator 를 초기화하지 않는 경우는 각 프로바이더는 디폴트의 초기화를 제공해, 이것을 문서화하지 않으면 안됩니다.

도입된 버젼:

1.4

관련 항목:

SecretKey

생성자의 개요

protected

KeyGenerator (KeyGeneratorSpi keyGenSpi, Provider provider, String algorithm) KeyGenerator 오브젝트를 작성합니다.

메소드의 개요

SecretKey	generateKey () 비밀열쇠를 생성합니다.
String	getAlgorithm () 이 KeyGenerator 오브젝트의 알고리즘명을 돌려줍니다.
static KeyGenerator	getInstance (String algorithm) 지정된 알고리즘의 KeyGenerator 오브젝트를 생성합니다.
static KeyGenerator	getInstance (String algorithm, Provider provider) 지정된 프로바이더로부터, 지정된 열쇠 알고리즘의 KeyGenerator 오브젝트를 생성합니다.
static KeyGenerator	getInstance (String algorithm, String provider) 지정된 프로바이더로부터, 지정된 열쇠 알고리즘의 KeyGenerator 오브젝트를 작성합니다.
Provider	getProvider () 이 KeyGenerator 오브젝트의 프로바이더를 돌려줍니다.
void	init (AlgorithmParameterSpec params) 이 열쇠 제네레이터를, 지정된 파라미터 세트를 사용해 초기화합니다.
void	init (AlgorithmParameterSpec params, SecureRandom random) 지정된 파라미터 세트와 유저가 제공하는 난수의 발생원을 사용해, 이 열쇠 제네레이터를 초기화합니다.
void	init (int keysize) 이 열쇠 제네레이터를 특정의 열쇠 사이즈에 응해 초기화합니다.
void	init (int keysize, SecureRandom random) 유저가 제공하는 난수의 발생원을 사용해, 이 열쇠 제네레이터를 특정의 열쇠 사이즈에 응해 초기화합니다.
void	init (SecureRandom random) 이 열쇠 제네레이터를 초기화합니다.

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

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

생성자의 상세

KeyGenerator

protected KeyGenerator(KeyGeneratorSpi  keyGenSpi,
                       Provider  provider,
                       String  algorithm)

KeyGenerator 오브젝트를 작성합니다.

파라미터:

keyGenSpi - delegate처

provider - 프로바이더

algorithm - 알고리즘

메소드의 상세

getAlgorithm

public final String  getAlgorithm()

이 KeyGenerator 오브젝트의 알고리즘명을 돌려줍니다.

이것은 이 KeyGenerator 오브젝트를 작성한 getInstance 호출의 1 개로 지정된 이름과 같습니다.

반환값:

이 KeyGenerator 오브젝트의 알고리즘명

getInstance

public static final KeyGenerator  getInstance(String  algorithm)
                                      throws NoSuchAlgorithmException 

지정된 알고리즘의 KeyGenerator 오브젝트를 생성합니다. 디폴트의 프로바이더의 패키지가, 요구된 열쇠 제네레이터의 구현을 제공하고 있는 경우는 그 구현을 가진 KeyGenerator 클래스의 인스턴스가 돌려주어집니다. 요구된 열쇠 제네레이터가 디폴트의 패키지로 얻을 수 없는 경우는 다른 프로바이더 패키지가 검색됩니다.

파라미터:

algorithm - 요구된 열쇠 알고리즘의 표준적인 이름. 알고리즘의 표준명에 대해서는 「Java 암호화 아키텍쳐 API 의 사양 및 레퍼런스」의 부록 A 를 참조

반환값:

새로운 KeyGenerator 오브젝트

예외:

NoSuchAlgorithmException - 지정된 알고리즘의 열쇠 제네레이터가, 디폴트의 프로바이더 패키지에도, 검색한 것 외의 프로바이더 패키지에도 없는 경우

getInstance

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

지정된 프로바이더로부터, 지정된 열쇠 알고리즘의 KeyGenerator 오브젝트를 작성합니다.

파라미터:

algorithm - 요구된 열쇠 알고리즘의 표준적인 이름. 알고리즘의 표준명에 대해서는 「Java 암호화 아키텍쳐 API 의 사양 및 레퍼런스」의 부록 A 를 참조

provider - 프로바이더명

반환값:

새로운 KeyGenerator 오브젝트

예외:

NoSuchAlgorithmException - 지정된 프로바이더로 지정된 알고리즘의 열쇠 제네레이터가 없는 경우

NoSuchProviderException - 지정된 프로바이더가 설정되어 있지 않은 경우

IllegalArgumentException - provider 가 null 의 경우

getInstance

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

지정된 프로바이더로부터, 지정된 열쇠 알고리즘의 KeyGenerator 오브젝트를 생성합니다. provider 는 등록되어 있을 필요는 없는 것에 주의해 주세요.

파라미터:

algorithm - 요구된 열쇠 알고리즘의 표준적인 이름. 알고리즘의 표준명에 대해서는 「Java 암호화 아키텍쳐 API 의 사양 및 레퍼런스」의 부록 A 를 참조

provider - 프로바이더

반환값:

새로운 KeyGenerator 오브젝트

예외:

NoSuchAlgorithmException - 지정된 프로바이더로 지정된 알고리즘의 열쇠 제네레이터가 없는 경우

IllegalArgumentException - provider 가 null 의 경우

getProvider

public final Provider  getProvider()

이 KeyGenerator 오브젝트의 프로바이더를 돌려줍니다.

반환값:

이 KeyGenerator 오브젝트의 프로바이더

init

public final void init(SecureRandom  random)

이 열쇠 제네레이터를 초기화합니다.

파라미터:

random - 이 제네레이터의 난수의 발생원

init

public final void init(AlgorithmParameterSpec  params)
                throws InvalidAlgorithmParameterException 

이 열쇠 제네레이터를, 지정된 파라미터 세트를 사용해 초기화합니다.

이 열쇠 제네레이터가 난수 바이트를 필요로 하는 경우는 인스톨 되고 있는 프로바이더 가운데, 가장 우선 순위의 높은 프로바이더의 SecureRandom 의 구현을 난수의 발생원으로서 사용해 난수 바이트를 취득합니다. SecureRandom 의 구현을 제공하는 프로바이더가 인스톨되어 있지 않은 경우는 시스템이 제공하는 난수의 발생원이 사용됩니다.

파라미터:

params - 열쇠 제네레이터의 파라미터

예외:

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

init

public final void init(AlgorithmParameterSpec  params,
                       SecureRandom  random)
                throws InvalidAlgorithmParameterException 

지정된 파라미터 세트와 유저가 제공하는 난수의 발생원을 사용해, 이 열쇠 제네레이터를 초기화합니다.

파라미터:

params - 열쇠 제네레이터의 파라미터

random - 이 열쇠 제네레이터의 난수의 발생원

예외:

InvalidAlgorithmParameterException - params 가 이 열쇠 제네레이터에 부적절한 경우

init

public final void init(int keysize)

이 열쇠 제네레이터를 특정의 열쇠 사이즈에 응해 초기화합니다.

이 열쇠 제네레이터가 난수 바이트를 필요로 하는 경우는 인스톨 되고 있는 프로바이더 가운데, 가장 우선 순위의 높은 프로바이더의 SecureRandom 의 구현을 난수의 발생원으로서 사용해 난수 바이트를 취득합니다. SecureRandom 의 구현을 제공하는 프로바이더가 인스톨되어 있지 않은 경우는 시스템이 제공하는 난수의 발생원이 사용됩니다.

파라미터:

keysize - 열쇠 사이즈. bit length로 지정된 알고리즘에 특정의 메트릭스

예외:

InvalidParameterException - 열쇠 사이즈가 잘못되어 있는지 서포트되어 있지 않은 경우

init

public final void init(int keysize,
                       SecureRandom  random)

유저가 제공하는 난수의 발생원을 사용해, 이 열쇠 제네레이터를 특정의 열쇠 사이즈에 응해 초기화합니다.

파라미터:

keysize - 열쇠 사이즈. bit length로 지정된 알고리즘에 특정의 메트릭스

random - 이 열쇠 제네레이터의 난수의 발생원

예외:

InvalidParameterException - 열쇠 사이즈가 잘못되어 있는지 서포트되어 있지 않은 경우

generateKey

public final SecretKey  generateKey()

비밀열쇠를 생성합니다.

반환값:

새로운 열쇠