javax.crypto
클래스 KeyAgreementSpi

java.lang.Object 
  javax.crypto.KeyAgreementSpi

public abstract class KeyAgreementSpi
extends Object 

이 클래스는 KeyAgreement 클래스의 Service Provider Interface (SPI)를 정의합니다. 특정의 키 합의 알고리즘의 구현을 제공하는 각 암호화 서비스 프로바이더는 이 클래스의 모든 추상 메서드를 구현할 필요가 있습니다.

공유의 비밀 정보의 확립에 관계된 키는 키 제네레이터 (KeyPairGenerator 또는 KeyGenerator)의 1개, 또는 KeyFactory에 의해 혹은 키 합의 프로토콜 (@see #engineDoPhase(java.security.Key, boolean) engineDoPhase)의 중간 단계의 결과로서 작성됩니다.

키 교환의 대응 관계 마다, engineDoPhase를 호출할 필요가 있습니다. 예를 들어 키 교환의 상대가 1개의 경우는 lastPhase 플래그를 true로 설정해 engineDoPhase를 1회 호출할 필요가 있습니다. 키 교환의 상대가 2개의 경우는 처음은 lastPhase 플래그를 false로 설정해, 2번째는 true로 설정해, engineDoPhase를 2회 호출할 필요가 있습니다. 키 교환의 상대의 수는 임의입니다.

도입된 버전 :

1.4

관련 항목:

KeyGenerator, SecretKey

생성자 개요

KeyAgreementSpi ()

메서드 개요

protected abstract Key	engineDoPhase (Key key, boolean lastPhase) 이 키 합의에 관계된 상대의 누군가로부터 받은 지정된 키를 사용해 이 키 합의의 다음의 단계를 실행합니다.
protected abstract byte[]	engineGenerateSecret () 공유의 비밀 정보를 생성해 새로운 버퍼내에 리턴합니다.
protected abstract int	engineGenerateSecret (byte[] sharedSecret, int offset) 공유의 비밀 정보를 생성해, offset로 부터 시작되는 sharedSecret 버퍼내에 포함합니다.
protected abstract SecretKey	engineGenerateSecret (String algorithm) 공유의 비밀 정보를 작성해, 그것이 요구된 알고리즘형의 비밀키 객체로서 리턴합니다.
protected abstract void	engineInit (Key key, AlgorithmParameterSpec params, SecureRandom random) 지정된 키, 알고리즘 파라미터세트 및 난수의 발생원을 사용해 이 키 합의를 초기화합니다.
protected abstract void	engineInit (Key key, SecureRandom random) 지정된 키와 난수의 발생원으로 이 키 합의를 초기화합니다.

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

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

생성자 상세

KeyAgreementSpi

public KeyAgreementSpi()

메서드의 상세

engineInit

protected abstract void engineInit(Key  key,
                                   SecureRandom  random)
                            throws InvalidKeyException 

지정된 키와 난수의 발생원으로 이 키 합의를 초기화합니다. 지정된 키에는 이 키 합의에 필요한 모든 알고리즘 파라미터를 포함할 필요가 있습니다.

키 합의 알고리즘이 난수 바이트를 필요로 하는 경우는 지정된 난수의 발생원 random로 부터 취득합니다. 다만, 기본이 되는 알고리즘 구현이 난수 바이트를 필요로 하지 않는 경우, random는 무시됩니다.

파라미터:

key - 당사자의 비공개 정보. 예를 들어 Diffie-Hellman 키 합의의 경우는 당사자 자신의 Diffie-Hellman 비공개키

random - 난수의 소스

예외:

InvalidKeyException - 지정된 키가 이 키 합의에 부적절한 경우. 예를 들어 형태가 잘못되어 있는 경우, 또는 알고리즘의 형태에 호환성이 없는 경우

engineInit

protected abstract void engineInit(Key  key,
                                   AlgorithmParameterSpec  params,
                                   SecureRandom  random)
                            throws InvalidKeyException,

                                   InvalidAlgorithmParameterException 

지정된 키, 알고리즘 파라미터세트 및 난수의 발생원을 사용해 이 키 합의를 초기화합니다.

파라미터:

key - 당사자의 비공개 정보. 예를 들어 Diffie-Hellman 키 합의의 경우는 당사자 자신의 Diffie-Hellman 비공개키

params - 키 합의 파라미터

random - 난수의 소스

예외:

InvalidKeyException - 지정된 키가 이 키 합의에 부적절한 경우. 예를 들어 형태가 잘못되어 있는 경우, 또는 알고리즘의 형태에 호환성이 없는 경우

InvalidAlgorithmParameterException - 지정된 파라미터가 이 키 합의에 부적절한 경우

engineDoPhase

protected abstract Key  engineDoPhase(Key  key,
                                     boolean lastPhase)
                              throws InvalidKeyException,

                                     IllegalStateException 

이 키 합의에 관계된 상대의 누군가로부터 받은 지정된 키를 사용해 이 키 합의의 다음의 단계를 실행합니다.

파라미터:

key - 이 단계의 키. 예를 들어 2 당사자 사이의 Diffie-Hellman인 경우는 상대의 Diffie-Hellman 공개키

lastPhase - 이것이 이 키 합의의 마지막 단계인가 어떤가를 나타내는 플래그

반환값:

이 단계의 결과의 (중간) 키. 이 단계에서 키가 생성되지 않는 경우는 null

예외:

InvalidKeyException - 지정된 키가 이 단계에 부적절한 경우

IllegalStateException - 이 키 합의가 초기화되어 있지 않은 경우

engineGenerateSecret

protected abstract byte[] engineGenerateSecret()
                                        throws IllegalStateException 

공유의 비밀 정보를 생성해 새로운 버퍼내에 리턴합니다.

이 메서드는 이 KeyAgreementSpi 객체를 리셋 하므로 게다가 다른 키 합의에 재사용할 수 있습니다. 이 키 합의가 engineInit 메서드의 1개 로 재초기화되지 않는 경우, 그 후의 키 합의에서는 같은 비공개 정보와 알고리즘 파라미터가 사용됩니다.

반환값:

공유의 비밀 정보가 들어간 새로운 버퍼

예외:

IllegalStateException - 이 키 합의가 아직 완료하고 있지 않는 경우

engineGenerateSecret

protected abstract int engineGenerateSecret(byte[] sharedSecret,
                                            int offset)
                                     throws IllegalStateException,

                                            ShortBufferException 

공유의 비밀 정보를 생성해, offset로 부터 시작되는 sharedSecret 버퍼내에 포함합니다.

sharedSecret 버퍼가 너무 작아 결과를 보관 유지할 수 없는 경우는 ShortBufferException가 발생 됩니다. 이 경우 보다 큰 출력 버퍼를 사용해 이 호출을 반복합니다.

이 메서드는 이 KeyAgreementSpi 객체를 리셋 하므로 게다가 다른 키 합의에 재사용할 수 있습니다. 이 키 합의가 engineInit 메서드의 1개 로 재초기화되지 않는 경우, 그 후의 키 합의에서는 같은 비공개 정보와 알고리즘 파라미터가 사용됩니다.

파라미터:

sharedSecret - 공유의 비밀 정보를 포함하는 버퍼

offset - 공유의 비밀 정보가 포함되는 sharedSecret 내의 오프셋(offset)

반환값:

sharedSecret에 포함된 바이트수

예외:

IllegalStateException - 이 키 합의가 아직 완료하고 있지 않는 경우

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

engineGenerateSecret

protected abstract SecretKey  engineGenerateSecret(String  algorithm)
                                           throws IllegalStateException,

                                                  NoSuchAlgorithmException,

                                                  InvalidKeyException 

공유의 비밀 정보를 작성해, 그것이 요구된 알고리즘형의 비밀키 객체로서 리턴합니다.

이 메서드는 이 KeyAgreementSpi 객체를 리셋 하므로 게다가 다른 키 합의에 재사용할 수 있습니다. 이 키 합의가 engineInit 메서드의 1개 로 재초기화되지 않는 경우, 그 후의 키 합의에서는 같은 비공개 정보와 알고리즘 파라미터가 사용됩니다.

파라미터:

algorithm - 요구된 비밀키 알고리즘

반환값:

공유의 비밀키

예외:

IllegalStateException - 이 키 합의가 아직 완료하고 있지 않는 경우

NoSuchAlgorithmException - 요구된 비밀키 알고리즘이 없는 경우

InvalidKeyException - 공유의 비밀키 데이터를 사용해, 요구된 알고리즘형의 비밀키를 생성할 수 없는 경우 (예를 들어 키 데이터가 너무 짧다)