javax.crypto
클래스 ExemptionMechanism

java.lang.Object 
  javax.crypto.ExemptionMechanism

public class ExemptionMechanism
extends Object 

이 클래스는 제외 도구 의 기능과 「키의 회복」, 「키의 약화」 및 「키 에스크로-」의 예를 제공합니다.

제외 도구를 사용하는 어플리케이션 또는 애플릿에는 사용하지 않는 것보다 강력한 암호화 기능을 부여할 수 있습니다.

도입된 버전 :

1.4

생성자 개요

protected

ExemptionMechanism (ExemptionMechanismSpi exmechSpi, Provider provider, String mechanism) ExemptionMechanism 객체를 작성합니다.

메서드 개요

protected void	finalize () ExemptionMechanism 객체에의 참조가 존재하지 않게 되었을 때에 이 객체에 의해 포함된 키가 확실히 지워지도록 합니다.
byte[]	genExemptionBlob () 제외 도구 의 키 Blob를 생성합니다.
int	genExemptionBlob (byte[] output) 제외 도구 의 키 Blob를 생성해, 결과를 output 버퍼에 포함합니다.
int	genExemptionBlob (byte[] output, int outputOffset) 제외 도구 의 키 Blob를 생성해, 결과를 outputOffset로 부터 시작되는 output 버퍼에 포함합니다.
static ExemptionMechanism	getInstance (String algorithm) 지정된 제외 도구 알고리즘을 구현하는 ExemptionMechanism 객체를 작성합니다.
static ExemptionMechanism	getInstance (String algorithm, Provider provider) 지정된 프로바이더로부터, 지정된 제외 도구 알고리즘의 ExemptionMechanism 객체를 생성합니다.
static ExemptionMechanism	getInstance (String algorithm, String provider) 지정된 프로바이더로부터, 지정된 제외 도구 의 ExemptionMechanism 객체를 작성합니다.
String	getName () 이 ExemptionMechanism 객체의 제외 도구 명을 리턴합니다.
int	getOutputSize (int inputLen) 입력의 길이 inputLen (바이트 단위)를 지정해, 다음의 genExemptionBlob 조작의 결과를 보관 유지하기 위해서 필요한 출력 버퍼의 길이를 바이트수로 리턴합니다.
Provider	getProvider () 이 ExemptionMechanism 객체의 프로바이더를 리턴합니다.
void	init (Key key) 키를 사용해 이 제외 도구를 초기화합니다.
void	init (Key key, AlgorithmParameters params) 키와 알고리즘 파라미터세트를 사용해 이 제외 도구를 초기화합니다.
void	init (Key key, AlgorithmParameterSpec params) 키와 알고리즘 파라미터세트를 사용해 이 제외 도구를 초기화합니다.
boolean	isCryptoAllowed (Key key) 이 제외 도구에 의해 결과 Blob가 정상적으로 생성되었는지 어떠했는지를 리턴합니다.

클래스 java.lang. Object 로부터 상속된 메서드

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

생성자 상세

ExemptionMechanism

protected ExemptionMechanism(ExemptionMechanismSpi  exmechSpi,
                             Provider  provider,
                             String  mechanism)

ExemptionMechanism 객체를 작성합니다.

파라미터:

exmechSpi - 위양처

provider - 프로바이더

mechanism - 제외 도구

메서드의 상세

getName

public final String  getName()

이 ExemptionMechanism 객체의 제외 도구 명을 리턴합니다.

이것은 이 ExemptionMechanism 객체를 작성한 getInstance 호출의 1개 로 지정된 이름과 같습니다.

반환값:

이 ExemptionMechanism 객체의 제외 도구 명

getInstance

public static final ExemptionMechanism  getInstance(String  algorithm)
                                            throws NoSuchAlgorithmException 

지정된 제외 도구 알고리즘을 구현하는 ExemptionMechanism 객체를 작성합니다. 디폴트의 프로바이더의 패키지가 요구된 제외 도구 알고리즘의 구현을 제공하고 있는 경우는 그 구현을 가진 ExemptionMechanism 클래스의 인스턴스가 리턴됩니다 . 제외 도구가 디폴트의 프로바이더 패키지로 얻을 수 없는 경우는 다른 프로바이더 패키지가 검색됩니다.

파라미터:

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

반환값:

새로운 ExemptionMechanism 객체

예외:

NullPointerException - algorithm가 null인 경우

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

getInstance

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

                                                   NoSuchProviderException 

지정된 프로바이더로부터, 지정된 제외 도구 의 ExemptionMechanism 객체를 작성합니다.

파라미터:

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

provider - 프로바이더명

반환값:

새로운 ExemptionMechanism 객체

예외:

NullPointerException - algorithm가 null인 경우

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

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

IllegalArgumentException - provider가 null인 경우

getInstance

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

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

파라미터:

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

provider - 프로바이더

반환값:

새로운 ExemptionMechanism 객체

예외:

NullPointerException - algorithm가 null인 경우

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

IllegalArgumentException - provider가 null인 경우

getProvider

public final Provider  getProvider()

이 ExemptionMechanism 객체의 프로바이더를 리턴합니다.

반환값:

이 ExemptionMechanism 객체의 프로바이더

isCryptoAllowed

public final boolean isCryptoAllowed(Key  key)
                              throws ExemptionMechanismException 

이 제외 도구에 의해 결과 Blob가 정상적으로 생성되었는지 어떠했는지를 리턴합니다.

이 메서드는 건네받은 키가 이 제외 도구가 초기화 및 생성 단계에서 사용한 키와 같은 것도 확인합니다.

파라미터:

key - 암호가 사용하는 키

반환값:

이 제외 도구에 의해 같은 키의 결과 Blob가 정상적으로 생성되었는지 어떠했는지. key가 null인 경우는 false

예외:

ExemptionMechanismException - 이 제외 도구 객체에 의해 결과 Blob가 정상적으로 생성되었는지 어떠했는지를 판정할 때에 문제가 발견되었을 경우

getOutputSize

public final int getOutputSize(int inputLen)
                        throws IllegalStateException 

입력의 길이 inputLen (바이트 단위)를 지정해, 다음의 genExemptionBlob 조작의 결과를 보관 유지하기 위해서 필요한 출력 버퍼의 길이를 바이트수로 리턴합니다.

다음의 genExemptionBlob 호출의 실제의 출력장은 이 메서드가 돌려주는 길이보다 작은 일이 있습니다.

파라미터:

inputLen - 입력장 (바이트 단위)

반환값:

필요한 출력 버퍼 사이즈 (바이트 단위)

예외:

IllegalStateException - 이 제외 도구가 잘못한 상태에 있는 경우 (예를 들어 아직 초기화되어 있지 않다)

init

public final void init(Key  key)
                throws InvalidKeyException,

                       ExemptionMechanismException 

키를 사용해 이 제외 도구를 초기화합니다.

이 제외 도구가 지정된 key로 부터 파생할 수 없는 알고리즘 파라미터를 필요로 하는 경우, 기본이 되는 제외 도구 의 구현은 프로바이더 고유의 기본값을 사용해 필요한 파라미터 자체를 생성합니다. 알고리즘 파라미터를 호출해 옆에서 지정할 필요가 있는 경우는 InvalidKeyException가 발생합니다.

파라미터:

key - 이 제외 도구 의 키

예외:

InvalidKeyException - 지정된 키가 이 제외 도구에 부적절한 경우

ExemptionMechanismException - 초기화의 처리로 문제가 발견되었을 경우

init

public final void init(Key  key,
                       AlgorithmParameterSpec  params)
                throws InvalidKeyException,

                       InvalidAlgorithmParameterException,

                       ExemptionMechanismException 

키와 알고리즘 파라미터세트를 사용해 이 제외 도구를 초기화합니다.

이 제외 도구가 알고리즘 파라미터를 필요로 해, params가 null 인 경우, 기본이 되는 제외 도구 의 구현은 프로바이더 고유의 기본값을 사용해 필요한 파라미터 자체를 생성합니다. 알고리즘 파라미터를 호출해 옆에서 지정할 필요가 있는 경우는 InvalidAlgorithmParameterException가 발생합니다.

파라미터:

key - 이 제외 도구 의 키

params - 알고리즘 파라미터

예외:

InvalidKeyException - 지정된 키가 이 제외 도구에 부적절한 경우

InvalidAlgorithmParameterException - 지정된 알고리즘 파라미터가 이 제외 도구에 부적절한 경우

ExemptionMechanismException - 초기화의 처리로 문제가 발견되었을 경우

init

public final void init(Key  key,
                       AlgorithmParameters  params)
                throws InvalidKeyException,

                       InvalidAlgorithmParameterException,

                       ExemptionMechanismException 

키와 알고리즘 파라미터세트를 사용해 이 제외 도구를 초기화합니다.

이 제외 도구가 알고리즘 파라미터를 필요로 해, params가 null 인 경우, 기본이 되는 제외 도구 의 구현은 프로바이더 고유의 기본값을 사용해 필요한 파라미터 자체를 생성합니다. 알고리즘 파라미터를 호출해 옆에서 지정할 필요가 있는 경우는 InvalidAlgorithmParameterException가 발생합니다.

파라미터:

key - 이 제외 도구 의 키

params - 알고리즘 파라미터

예외:

InvalidKeyException - 지정된 키가 이 제외 도구에 부적절한 경우

InvalidAlgorithmParameterException - 지정된 알고리즘 파라미터가 이 제외 도구에 부적절한 경우

ExemptionMechanismException - 초기화의 처리로 문제가 발견되었을 경우

genExemptionBlob

public final byte[] genExemptionBlob()
                              throws IllegalStateException,

                                     ExemptionMechanismException 

제외 도구 의 키 Blob를 생성합니다.

반환값:

결과의 키 Blob가 들어간 새로운 버퍼

예외:

IllegalStateException - 이 제외 도구가 잘못한 상태에 있는 경우 (예를 들어 초기화되어 있지 않다)

ExemptionMechanismException - 생성의 처리로 문제가 발견되었을 경우

genExemptionBlob

public final int genExemptionBlob(byte[] output)
                           throws IllegalStateException,

                                  ShortBufferException,

                                  ExemptionMechanismException 

제외 도구 의 키 Blob를 생성해, 결과를 output 버퍼에 포함합니다.

output 버퍼가 너무 작아 결과를 보관 유지할 수 없는 경우는 ShortBufferException가 발생 됩니다. 이 경우 보다 큰 출력 버퍼를 사용해 이 호출을 반복합니다. getOutputSize를 사용해, 필요한 출력 버퍼의 사이즈를 판정합니다.

파라미터:

output - 결과를 포함하는 버퍼

반환값:

output에 포함된 바이트수

예외:

IllegalStateException - 이 제외 도구가 잘못한 상태에 있는 경우 (예를 들어 초기화되어 있지 않다)

ShortBufferException - 지정된 출력 버퍼가 너무 작아 결과를 보관 유지할 수 없는 경우

ExemptionMechanismException - 생성의 처리로 문제가 발견되었을 경우

genExemptionBlob

public final int genExemptionBlob(byte[] output,
                                  int outputOffset)
                           throws IllegalStateException,

                                  ShortBufferException,

                                  ExemptionMechanismException 

제외 도구 의 키 Blob를 생성해, 결과를 outputOffset로 부터 시작되는 output 버퍼에 포함합니다.

output 버퍼가 너무 작아 결과를 보관 유지할 수 없는 경우는 ShortBufferException가 발생 됩니다. 이 경우 보다 큰 출력 버퍼를 사용해 이 호출을 반복합니다. getOutputSize를 사용해, 필요한 출력 버퍼의 사이즈를 판정합니다.

파라미터:

output - 결과를 포함하는 버퍼

outputOffset - 결과가 포함되는 output 내의 오프셋(offset)

반환값:

output에 포함된 바이트수

예외:

IllegalStateException - 이 제외 도구가 잘못한 상태에 있는 경우 (예를 들어 초기화되어 있지 않다)

ShortBufferException - 지정된 출력 버퍼가 너무 작아 결과를 보관 유지할 수 없는 경우

ExemptionMechanismException - 생성의 처리로 문제가 발견되었을 경우

finalize

protected void finalize()

ExemptionMechanism 객체에의 참조가 존재하지 않게 되었을 때에 이 객체에 의해 포함된 키가 확실히 지워지도록 합니다.

오버라이드(override):

클래스 Object 내의 finalize