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 - 위양처

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 암호화 확장 기능 레퍼런스 가이드」의 부록 A를 참조

반환값:

새로운 KeyGenerator 객체

예외:

NullPointerException - 지정된 알고리즘이 null인 경우

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

getInstance

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

                                             NoSuchProviderException 

지정된 프로바이더로부터, 지정된 키 알고리즘의 KeyGenerator 객체를 작성합니다.

파라미터:

algorithm - 요구된 키 알고리즘의 표준적인 이름. 알고리즘의 표준명에 대해서는 「Java 암호화 확장 기능 레퍼런스 가이드」의 부록 A를 참조

provider - 프로바이더명

반환값:

새로운 KeyGenerator 객체

예외:

NullPointerException - 지정된 알고리즘이 null인 경우

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

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

IllegalArgumentException - provider가 null인 경우

getInstance

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

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

파라미터:

algorithm - 요구된 키 알고리즘의 표준적인 이름. 알고리즘의 표준명에 대해서는 「Java 암호화 확장 기능 레퍼런스 가이드」의 부록 A를 참조

provider - 프로바이더

반환값:

새로운 KeyGenerator 객체

예외:

NullPointerException - 지정된 알고리즘이 null인 경우

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()

비밀키를 생성합니다.

반환값:

새로운 키