javax.crypto
클래스 Cipher

java.lang.Object 
  javax.crypto.Cipher

알려진 직계 서브 클래스:

NullCipher

public class Cipher
extends Object 

이 클래스는 암호화 및 복호화의 기능을 제공해, JCE (Java Cryptographic Extension) 체제의 코어를 형성합니다.

Cipher 객체를 작성하려면, 어플리케이션은 Cipher getInstance 메서드를 호출해, 요구된 「변환」의 이름을 건네줍니다. 필요에 따라서, 프로바이더의 이름을 지정할 수 있습니다 .

「변환」이란 출력을 생성하기 위해서 지정된 입력에 대해서 실행하는 조작 (또는 일련의 조작)을 기술하는 캐릭터 라인입니다. 변환에는 항상 암호화 알고리즘명 (DES 등)이 포함되어 있어 피드백 모드와 패딩 방식이 나중에 계속되는 일이 있습니다.

변환의 형식은 다음과 같습니다.

• "「알고리즘/모드/패딩」, 또는

• "「알고리즘」

후자의 경우, 모드와 패딩 방식에 대해서는 프로바이더 고유의 기본값이 사용됩니다. 유효한 변환의 예를 다음에 나타냅니다.

     Cipher c = Cipher.getInstance("DES/CBC/PKCS5Padding");
 

스트림 암호화 모드로 블록 암호를 요구하는 경우 (예를 들어, CFB 또는 OFB 모드의 DES)는 필요에 따라서 한 번에 처리하는 비트수를 지정할 수 있습니다 . 지정하려면, "DES/CFB8/NoPadding" 및 "DES/OFB32/PKCS5Padding" 변환으로 나타나도록, 비트수를 모드명에 추가합니다. 비트수의 지정이 없는 경우는 프로바이더 고유의 기본값이 사용됩니다 (예를 들어 「SunJCE」프로바이더는 디폴트의 64 비트를 사용).

도입된 버전 :

1.4

관련 항목:

KeyGenerator, SecretKey

필드 개요

static int	DECRYPT_MODE 암호를 복호화 모드에 초기화하는데 사용하는 정수입니다.
static int	ENCRYPT_MODE 암호를 암호화 모드에 초기화하는데 사용하는 정수입니다.
static int	PRIVATE_KEY 랩 해제되는 키가 「비공개키」인 것을 나타내는데 사용하는 정수입니다.
static int	PUBLIC_KEY 랩 해제되는 키가 「공개키」인 것을 나타내는데 사용하는 정수입니다.
static int	SECRET_KEY 랩 해제되는 키가 「비밀키」인 것을 나타내는데 사용하는 정수입니다.
static int	UNWRAP_MODE 암호를 키 랩핑 해제 모드에 초기화하는데 사용하는 정수입니다.
static int	WRAP_MODE 암호를 키 랩핑 모드에 초기화하는데 사용하는 정수입니다.

생성자 개요

protected

Cipher (CipherSpi cipherSpi, Provider provider, String transformation) Cipher 객체를 작성합니다.

메서드 개요

byte[]	doFinal () 복수의 부분으로부터 완성되는 암호화 또는 복호화 조작 (이 암호의 초기화 방법에 의해 다르다)을 종료합니다.
byte[]	doFinal (byte[] input) 단일의 부분으로부터 완성되는 조작으로 데이터를 암호화 또는 복호화 하는지, 복수의 부분으로부터 완성되는 조작을 종료합니다.
int	doFinal (byte[] output, int outputOffset) 복수의 부분으로부터 완성되는 암호화 또는 복호화 조작 (이 암호의 초기화 방법에 의해 다르다)을 종료합니다.
byte[]	doFinal (byte[] input, int inputOffset, int inputLen) 단일의 부분으로부터 완성되는 조작으로 데이터를 암호화 또는 복호화 하는지, 복수의 부분으로부터 완성되는 조작을 종료합니다.
int	doFinal (byte[] input, int inputOffset, int inputLen, byte[] output) 단일의 부분으로부터 완성되는 조작으로 데이터를 암호화 또는 복호화 하는지, 복수의 부분으로부터 완성되는 조작을 종료합니다.
int	doFinal (byte[] input, int inputOffset, int inputLen, byte[] output, int outputOffset) 단일의 부분으로부터 완성되는 조작으로 데이터를 암호화 또는 복호화 하는지, 복수의 부분으로부터 완성되는 조작을 종료합니다.
int	doFinal (ByteBuffer input, ByteBuffer output) 단일의 부분으로부터 완성되는 조작으로 데이터를 암호화 또는 복호화 하는지, 복수의 부분으로부터 완성되는 조작을 종료합니다.
String	getAlgorithm () 이 Cipher 객체의 알고리즘명을 리턴합니다.
int	getBlockSize () 블록 사이즈를 리턴합니다 (바이트 단위).
ExemptionMechanism	getExemptionMechanism () 이 암호로 사용되는 제외 도구 객체를 리턴합니다.
static Cipher	getInstance (String transformation) 지정된 변환을 구현하는 Cipher 객체를 생성합니다.
static Cipher	getInstance (String transformation, Provider provider) 지정된 프로바이더에 의해 제공되는 지정된 변환을 구현하는 Cipher 객체를 작성합니다.
static Cipher	getInstance (String transformation, String provider) 지정된 프로바이더에 의해 제공되는 지정된 변환을 구현하는 Cipher 객체를 작성합니다.
byte[]	getIV () 새로운 버퍼의 초기화 벡터 (IV)를 리턴합니다.
static int	getMaxAllowedKeyLength (String transformation) 인스톨 한 JCE 관할 정책 파일에 기반해 지정의 변환을 실시하는 최대의 키의 길이를 리턴합니다.
static AlgorithmParameterSpec	getMaxAllowedParameterSpec (String transformation) 관할 정책 파일에 기반해 최대 암호화 파라미터값를 포함한 AlgorithmParameterSpec 객체를 리턴합니다.
int	getOutputSize (int inputLen) 입력의 길이 inputLen (바이트 단위)를 지정해, 다음의 update 또는 doFinal 조작의 결과를 보관 유지하기 위해서 필요한 출력 버퍼의 길이를 바이트수로 리턴합니다.
AlgorithmParameters	getParameters () 이 암호로 사용되는 파라미터를 리턴합니다.
Provider	getProvider () 이 Cipher 객체의 프로바이더를 리턴합니다.
void	init (int opmode, Certificate certificate) 이 암호를, 검증 조작을 위해서 지정된 공개키로 초기화합니다.
void	init (int opmode, Certificate certificate, SecureRandom random) 이 암호를, 검증 조작을 위해서 지정된 공개키 및 난수의 발생원을 사용해 초기화합니다.
void	init (int opmode, Key key) 키를 사용해 이 암호를 초기화합니다.
void	init (int opmode, Key key, AlgorithmParameters params) 키와 알고리즘 파라미터세트를 사용해 이 암호를 초기화합니다.
void	init (int opmode, Key key, AlgorithmParameterSpec params) 키와 알고리즘 파라미터세트를 사용해 이 암호를 초기화합니다.
void	init (int opmode, Key key, AlgorithmParameterSpec params, SecureRandom random) 키, 알고리즘 파라미터세트 및 난수의 발생원을 사용해 이 암호를 초기화합니다.
void	init (int opmode, Key key, AlgorithmParameters params, SecureRandom random) 키, 알고리즘 파라미터세트 및 난수의 발생원을 사용해 이 암호를 초기화합니다.
void	init (int opmode, Key key, SecureRandom random) 키와 난수의 발생원을 사용해 이 암호를 초기화합니다.
Key	unwrap (byte[] wrappedKey, String wrappedKeyAlgorithm, int wrappedKeyType) 전에 랩 된 키를 랩 해제합니다.
byte[]	update (byte[] input) 복수의 부분으로부터 완성되는 암호화 또는 복호화 조작 (이 암호의 초기화 방법에 의해 다르다)을 계속해, 다른 데이터 부분을 처리합니다.
byte[]	update (byte[] input, int inputOffset, int inputLen) 복수의 부분으로부터 완성되는 암호화 또는 복호화 조작 (이 암호의 초기화 방법에 의해 다르다)을 계속해, 다른 데이터 부분을 처리합니다.
int	update (byte[] input, int inputOffset, int inputLen, byte[] output) 복수의 부분으로부터 완성되는 암호화 또는 복호화 조작 (이 암호의 초기화 방법에 의해 다르다)을 계속해, 다른 데이터 부분을 처리합니다.
int	update (byte[] input, int inputOffset, int inputLen, byte[] output, int outputOffset) 복수의 부분으로부터 완성되는 암호화 또는 복호화 조작 (이 암호의 초기화 방법에 의해 다르다)을 계속해, 다른 데이터 부분을 처리합니다.
int	update (ByteBuffer input, ByteBuffer output) 복수의 부분으로부터 완성되는 암호화 또는 복호화 조작 (이 암호의 초기화 방법에 의해 다르다)을 계속해, 다른 데이터 부분을 처리합니다.
byte[]	wrap (Key key) 키를 랩 합니다.

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

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

필드의 상세

ENCRYPT_MODE

public static final int ENCRYPT_MODE

암호를 암호화 모드에 초기화하는데 사용하는 정수입니다.

관련 항목:

정수 필드값

DECRYPT_MODE

public static final int DECRYPT_MODE

암호를 복호화 모드에 초기화하는데 사용하는 정수입니다.

관련 항목:

정수 필드값

WRAP_MODE

public static final int WRAP_MODE

암호를 키 랩핑 모드에 초기화하는데 사용하는 정수입니다.

관련 항목:

정수 필드값

UNWRAP_MODE

public static final int UNWRAP_MODE

암호를 키 랩핑 해제 모드에 초기화하는데 사용하는 정수입니다.

관련 항목:

정수 필드값

PUBLIC_KEY

public static final int PUBLIC_KEY

랩 해제되는 키가 「공개키」인 것을 나타내는데 사용하는 정수입니다.

관련 항목:

정수 필드값

PRIVATE_KEY

public static final int PRIVATE_KEY

랩 해제되는 키가 「비공개키」인 것을 나타내는데 사용하는 정수입니다.

관련 항목:

정수 필드값

SECRET_KEY

public static final int SECRET_KEY

랩 해제되는 키가 「비밀키」인 것을 나타내는데 사용하는 정수입니다.

관련 항목:

정수 필드값

생성자 상세

Cipher

protected Cipher(CipherSpi  cipherSpi,
                 Provider  provider,
                 String  transformation)

Cipher 객체를 작성합니다.

파라미터:

cipherSpi - 위양처

provider - 프로바이더

transformation - 변환

메서드의 상세

getInstance

public static final Cipher  getInstance(String  transformation)
                                throws NoSuchAlgorithmException,

                                       NoSuchPaddingException 

지정된 변환을 구현하는 Cipher 객체를 생성합니다.

요구된 변환의 구현을 디폴트의 프로바이더 패키지가 제공하고 있는 경우는 그 구현을 포함한 Cipher 인스턴스가 리턴됩니다 . 디폴트의 프로바이더 패키지로 목적의 변환이 제공되어 있지 않은 경우에는 다른 프로바이더 패키지가 검색됩니다.

파라미터:

transformation - 변환의 이름. 예를 들어, DES/CBC/PKCS5Padding. 변환의 표준적인 이름에 대해서는 「Java 암호화 확장 기능 레퍼런스 가이드」의 부록 A를 참조

반환값:

요구된 변환을 구현하는 암호

예외:

NoSuchAlgorithmException - transformation가 null, 공백, 형식이 부정, 또는 현재 인스톨 되고 있는 프로바이더로 사용 불가능한 경우

NoSuchPaddingException - 사용할 수 없는 패딩 방식이 transformation에 포함되어 있는 경우

getInstance

public static final Cipher  getInstance(String  transformation,
                                       String  provider)
                                throws NoSuchAlgorithmException,

                                       NoSuchProviderException,

                                       NoSuchPaddingException 

지정된 프로바이더에 의해 제공되는 지정된 변환을 구현하는 Cipher 객체를 작성합니다.

파라미터:

transformation - 변환의 이름. 예를 들어, DES/CBC/PKCS5Padding. 변환의 표준적인 이름에 대해서는 「Java 암호화 확장 기능 레퍼런스 가이드」의 부록 A를 참조

provider - 프로바이더명

반환값:

요구된 변환을 구현하는 암호

예외:

NoSuchAlgorithmException - transformation가 null, 공백, 형식이 부정, 또는 현재 인스톨 되고 있는 프로바이더로부터 제공되어 있지 않은 경우

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

NoSuchPaddingException - 사용할 수 없는 패딩 방식이 transformation에 포함되어 있는 경우

IllegalArgumentException - provider가 null인 경우

getInstance

public static final Cipher  getInstance(String  transformation,
                                       Provider  provider)
                                throws NoSuchAlgorithmException,

                                       NoSuchPaddingException 

지정된 프로바이더에 의해 제공되는 지정된 변환을 구현하는 Cipher 객체를 작성합니다. provider는 등록되어 있을 필요는 없는 것에 주의해 주세요.

파라미터:

transformation - 변환의 이름. 예를 들어, DES/CBC/PKCS5Padding. 변환의 표준적인 이름에 대해서는 「Java 암호화 확장 기능 레퍼런스 가이드」의 부록 A를 참조

provider - 프로바이더

반환값:

요구된 변환을 구현하는 암호

예외:

NoSuchAlgorithmException - transformation가 null, 공백, 형식이 부정, 또는 현재 인스톨 되고 있는 프로바이더로부터 제공되어 있지 않은 경우

NoSuchPaddingException - 사용할 수 없는 패딩 방식이 transformation에 포함되어 있는 경우

IllegalArgumentException - provider가 null인 경우

getProvider

public final Provider  getProvider()

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

반환값:

이 Cipher 객체의 프로바이더

getAlgorithm

public final String  getAlgorithm()

이 Cipher 객체의 알고리즘명을 리턴합니다.

이것은 이 Cipher 객체를 작성한 getInstance 호출의 어떤 것인가로 지정된 이름과 같습니다.

반환값:

이 Cipher 객체의 알고리즘명

getBlockSize

public final int getBlockSize()

블록 사이즈를 리턴합니다 (바이트 단위).

반환값:

블록 사이즈 (바이트 단위). 기본이 되는 알고리즘이 블록 암호가 아닌 경우는 0

getOutputSize

public final int getOutputSize(int inputLen)

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

이 호출에서는 이전의 update 호출의 처리되어 있지 않은 (버퍼에 있다) 데이터를 고려해, 패딩 합니다.

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

파라미터:

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

반환값:

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

예외:

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

getIV

public final byte[] getIV()

새로운 버퍼의 초기화 벡터 (IV)를 리턴합니다.

이것은 랜덤 IV가 작성되었을 경우, 혹은 IV가 사용자 지정의 패스워드로부터 파생하는 패스워드 베이스의 암호화 또는 복호화의 컨텍스트에 대해 도움이 됩니다.

반환값:

새로운 버퍼내의 초기화 벡터. 기본이 되는 알고리즘이 IV를 사용하지 않는 경우, 또는 IV가 설정되어 있지 않은 경우는 null

getParameters

public final AlgorithmParameters  getParameters()

이 암호로 사용되는 파라미터를 리턴합니다.

리턴된 파라미터는 이 암호를 초기화하는데 사용한 것과 같은 경우가 있습니다. 또는 리턴된 파라미터에는 이 암호에 알고리즘 파라미터가 필요해, 한편 알고리즘 파라미터로 초기화되지 않았던 경우에 기본이 되는 암호 구현으로 사용되는 디폴트와 랜덤의 파라미터값의 편성이 포함되는 일도 있습니다.

반환값:

이 암호로 사용되는 파라미터. 이 암호로 파라미터를 사용하지 않는 경우는 null

getExemptionMechanism

public final ExemptionMechanism  getExemptionMechanism()

이 암호로 사용되는 제외 도구 객체를 리턴합니다.

반환값:

이 암호로 사용되는 제외 도구 객체. 이 암호로 제외 도구를 사용하지 않는 경우는 null

init

public final void init(int opmode,
                       Key  key)
                throws InvalidKeyException 

키를 사용해 이 암호를 초기화합니다.

이 암호는 opmode값에 따라, 암호화, 복호화, 키 랩핑, 또는 키 랩핑 해제의 4개의 조작의 1개에 맞추어 초기화됩니다.

이 암호가 지정된 key로 부터 파생할 수 없는 알고리즘 파라미터를 필요로 하는 경우, 기본이 되는 암호 구현은 암호화 또는 키 랩핑용으로 초기화되고 있으면, 프로바이더 고유의 디폴트 또는 랜덤치를 사용해 필요한 파라미터 자체를 생성해, 복호화 또는 키 랩핑 해제용으로 초기화되고 있으면, InvalidKeyException을 발생시킵니다. 생성된 파라미터는 getParameters 또는 getIV (파라미터가 IV인 경우)를 사용해 꺼낼 수가 있습니다.

이 암호 (기본이 되는 피드백 또는 패딩 방식을 포함한다)가 난수 바이트를 필요로 하는 경우 (예를 들어 파라미터 생성을 위해)는 인스톨 되고 있는 프로바이더 가운데, 가장 우선 순위의 높은 프로바이더 SecureRandom 구현을 난수의 발생원으로서 사용해 난수 바이트를 취득합니다. SecureRandom 구현을 제공하는 프로바이더가 인스톨되어 있지 않은 경우는 시스템이 제공하는 난수의 발생원이 사용됩니다.

Cipher 객체가 초기화되면, 이전에 취득한 상태는 모두 없어집니다. 즉, Cipher를 초기화하는 것은 그 Cipher 새로운 인스턴스를 작성해 초기화하는 것과 같습니다.

파라미터:

opmode - 이 암호의 조작 모드 (ENCRYPT_MODE, DECRYPT_MODE, WRAP_MODE, 또는 UNWRAP_MODE 어떤 것이나)

key - 키

예외:

InvalidKeyException - 지정된 키가 이 암호의 초기화에 부적절한 경우, 이 암호가 복호화용으로 초기화되어 지정된 키로부터 판정할 수가 없는 알고리즘 파라미터를 필요로 하는 경우, 또는 지정된 키의 사이즈가 최대 허용키 사이즈 (설정되어 있는 관할 정책 파일에 의해 결정)를 넘는 경우

init

public final void init(int opmode,
                       Key  key,
                       SecureRandom  random)
                throws InvalidKeyException 

키와 난수의 발생원을 사용해 이 암호를 초기화합니다.

이 암호는 opmode값에 따라, 암호화, 복호화, 키 랩핑, 또는 키 랩핑 해제의 4개의 조작의 1개에 맞추어 초기화됩니다.

이 암호가 지정된 key로 부터 파생할 수 없는 알고리즘 파라미터를 필요로 하는 경우, 기본이 되는 암호 구현은 암호화 또는 키 랩핑용으로 초기화되고 있으면, 프로바이더 고유의 디폴트 또는 랜덤치를 사용해 필요한 파라미터 자체를 생성해, 복호화 또는 키 랩핑 해제용으로 초기화되고 있으면, InvalidKeyException을 발생시킵니다. 생성된 파라미터는 getParameters 또는 getIV (파라미터가 IV인 경우)를 사용해 꺼낼 수가 있습니다.

이 암호 (기본이 되는 피드백 또는 패딩 방식을 포함한다)가 난수 바이트를 필요로 하는 경우 (예를 들어 파라미터 생성을 위해)는 random로 부터 취득합니다.

Cipher 객체가 초기화되면, 이전에 취득한 상태는 모두 없어집니다. 즉, Cipher를 초기화하는 것은 그 Cipher 새로운 인스턴스를 작성해 초기화하는 것과 같습니다.

파라미터:

opmode - 이 암호의 조작 모드 (ENCRYPT_MODE, DECRYPT_MODE, WRAP_MODE, 또는 UNWRAP_MODE 어떤 것이나)

key - 암호화키

random - 난수의 소스

예외:

InvalidKeyException - 지정된 키가 이 암호의 초기화에 부적절한 경우, 이 암호가 복호화용으로 초기화되어 지정된 키로부터 판정할 수가 없는 알고리즘 파라미터를 필요로 하는 경우, 또는 지정된 키의 사이즈가 최대 허용키 사이즈 (설정되어 있는 관할 정책 파일에 의해 결정)를 넘는 경우

init

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

                       InvalidAlgorithmParameterException 

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

이 암호는 opmode값에 따라, 암호화, 복호화, 키 랩핑, 또는 키 랩핑 해제의 4개의 조작의 1개에 맞추어 초기화됩니다.

이 암호가 알고리즘 파라미터를 필요로 해, params가 null인 경우, 기본이 되는 암호 구현은 암호화 또는 키 랩핑용으로 초기화되고 있으면, 프로바이더 고유의 디폴트 또는 랜덤치를 사용해 필요한 파라미터 자체를 생성해, 복호화 또는 키 랩핑 해제용으로 초기화되고 있으면, InvalidAlgorithmParameterException을 발생시킵니다. 생성된 파라미터는 getParameters 또는 getIV (파라미터가 IV인 경우)를 사용해 꺼낼 수가 있습니다.

이 암호 (기본이 되는 피드백 또는 패딩 방식을 포함한다)가 난수 바이트를 필요로 하는 경우 (예를 들어 파라미터 생성을 위해)는 인스톨 되고 있는 프로바이더 가운데, 가장 우선 순위의 높은 프로바이더 SecureRandom 구현을 난수의 발생원으로서 사용해 난수 바이트를 취득합니다. SecureRandom 구현을 제공하는 프로바이더가 인스톨되어 있지 않은 경우는 시스템이 제공하는 난수의 발생원이 사용됩니다.

Cipher 객체가 초기화되면, 이전에 취득한 상태는 모두 없어집니다. 즉, Cipher를 초기화하는 것은 그 Cipher 새로운 인스턴스를 작성해 초기화하는 것과 같습니다.

파라미터:

opmode - 이 암호의 조작 모드 (ENCRYPT_MODE, DECRYPT_MODE, WRAP_MODE, 또는 UNWRAP_MODE 어떤 것이나)

key - 암호화키

params - 알고리즘 파라미터

예외:

InvalidKeyException - 지정된 키가 이 암호의 초기화에 부적절한 경우, 또는 지정된 키의 사이즈가 최대 허용키 사이즈 (설정되어 있는 관할 정책 파일에 의해 결정)를 넘는 경우

InvalidAlgorithmParameterException - 지정된 알고리즘 파라미터가 이 암호에 부적절한 경우, 이 암호가 복호화용으로 초기화되어 알고리즘 파라미터를 필요로 해, params가 null인 경우, 또는 지정된 알고리즘 파라미터가 유효한 제한 (설정되어 있는 관할 정책 파일에 의해 결정)을 넘는 암호화 강도를 나타내는 경우

init

public final void init(int opmode,
                       Key  key,
                       AlgorithmParameterSpec  params,
                       SecureRandom  random)
                throws InvalidKeyException,

                       InvalidAlgorithmParameterException 

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

이 암호는 opmode값에 따라, 암호화, 복호화, 키 랩핑, 또는 키 랩핑 해제의 4개의 조작의 1개에 맞추어 초기화됩니다.

이 암호가 알고리즘 파라미터를 필요로 해, params가 null인 경우, 기본이 되는 암호 구현은 암호화 또는 키 랩핑용으로 초기화되고 있으면, 프로바이더 고유의 디폴트 또는 랜덤치를 사용해 필요한 파라미터 자체를 생성해, 복호화 또는 키 랩핑 해제용으로 초기화되고 있으면, InvalidAlgorithmParameterException을 발생시킵니다. 생성된 파라미터는 getParameters 또는 getIV (파라미터가 IV인 경우)를 사용해 꺼낼 수가 있습니다.

이 암호 (기본이 되는 피드백 또는 패딩 방식을 포함한다)가 난수 바이트를 필요로 하는 경우 (예를 들어 파라미터 생성을 위해)는 random로 부터 취득합니다.

Cipher 객체가 초기화되면, 이전에 취득한 상태는 모두 없어집니다. 즉, Cipher를 초기화하는 것은 그 Cipher 새로운 인스턴스를 작성해 초기화하는 것과 같습니다.

파라미터:

opmode - 이 암호의 조작 모드 (ENCRYPT_MODE, DECRYPT_MODE, WRAP_MODE, 또는 UNWRAP_MODE 어떤 것이나)

key - 암호화키

params - 알고리즘 파라미터

random - 난수의 소스

예외:

InvalidKeyException - 지정된 키가 이 암호의 초기화에 부적절한 경우, 또는 지정된 키의 사이즈가 최대 허용키 사이즈 (설정되어 있는 관할 정책 파일에 의해 결정)를 넘는 경우

InvalidAlgorithmParameterException - 지정된 알고리즘 파라미터가 이 암호에 부적절한 경우, 이 암호가 복호화용으로 초기화되어 알고리즘 파라미터를 필요로 해, params가 null인 경우, 또는 지정된 알고리즘 파라미터가 유효한 제한 (설정되어 있는 관할 정책 파일에 의해 결정)을 넘는 암호화 강도를 나타내는 경우

init

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

                       InvalidAlgorithmParameterException 

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

이 암호는 opmode값에 따라, 암호화, 복호화, 키 랩핑, 또는 키 랩핑 해제의 4개의 조작의 1개에 맞추어 초기화됩니다.

이 암호가 알고리즘 파라미터를 필요로 해, params가 null인 경우, 기본이 되는 암호 구현은 암호화 또는 키 랩핑용으로 초기화되고 있으면, 프로바이더 고유의 디폴트 또는 랜덤치를 사용해 필요한 파라미터 자체를 생성해, 복호화 또는 키 랩핑 해제용으로 초기화되고 있으면, InvalidAlgorithmParameterException을 발생시킵니다. 생성된 파라미터는 getParameters 또는 getIV (파라미터가 IV인 경우)를 사용해 꺼낼 수가 있습니다.

이 암호 (기본이 되는 피드백 또는 패딩 방식을 포함한다)가 난수 바이트를 필요로 하는 경우 (예를 들어 파라미터 생성을 위해)는 인스톨 되고 있는 프로바이더 가운데, 가장 우선 순위의 높은 프로바이더 SecureRandom 구현을 난수의 발생원으로서 사용해 난수 바이트를 취득합니다. SecureRandom 구현을 제공하는 프로바이더가 인스톨되어 있지 않은 경우는 시스템이 제공하는 난수의 발생원이 사용됩니다.

Cipher 객체가 초기화되면, 이전에 취득한 상태는 모두 없어집니다. 즉, Cipher를 초기화하는 것은 그 Cipher 새로운 인스턴스를 작성해 초기화하는 것과 같습니다.

파라미터:

opmode - 이 암호의 조작 모드 (ENCRYPT_MODE, DECRYPT_MODE, WRAP_MODE, 또는 UNWRAP_MODE 어떤 것이나)

key - 암호화키

params - 알고리즘 파라미터

예외:

InvalidKeyException - 지정된 키가 이 암호의 초기화에 부적절한 경우, 또는 지정된 키의 사이즈가 최대 허용키 사이즈 (설정되어 있는 관할 정책 파일에 의해 결정)를 넘는 경우

InvalidAlgorithmParameterException - 지정된 알고리즘 파라미터가 이 암호에 부적절한 경우, 이 암호가 복호화용으로 초기화되어 알고리즘 파라미터를 필요로 해, params가 null인 경우, 또는 지정된 알고리즘 파라미터가 유효한 제한 (설정되어 있는 관할 정책 파일에 의해 결정)을 넘는 암호화 강도를 나타내는 경우

init

public final void init(int opmode,
                       Key  key,
                       AlgorithmParameters  params,
                       SecureRandom  random)
                throws InvalidKeyException,

                       InvalidAlgorithmParameterException 

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

이 암호는 opmode값에 따라, 암호화, 복호화, 키 랩핑, 또는 키 랩핑 해제의 4개의 조작의 1개에 맞추어 초기화됩니다.

이 암호가 알고리즘 파라미터를 필요로 해, params가 null인 경우, 기본이 되는 암호 구현은 암호화 또는 키 랩핑용으로 초기화되고 있으면, 프로바이더 고유의 디폴트 또는 랜덤치를 사용해 필요한 파라미터 자체를 생성해, 복호화 또는 키 랩핑 해제용으로 초기화되고 있으면, InvalidAlgorithmParameterException을 발생시킵니다. 생성된 파라미터는 getParameters 또는 getIV (파라미터가 IV인 경우)를 사용해 꺼낼 수가 있습니다.

이 암호 (기본이 되는 피드백 또는 패딩 방식을 포함한다)가 난수 바이트를 필요로 하는 경우 (예를 들어 파라미터 생성을 위해)는 random로 부터 취득합니다.

Cipher 객체가 초기화되면, 이전에 취득한 상태는 모두 없어집니다. 즉, Cipher를 초기화하는 것은 그 Cipher 새로운 인스턴스를 작성해 초기화하는 것과 같습니다.

파라미터:

opmode - 이 암호의 조작 모드 (ENCRYPT_MODE, DECRYPT_MODE, WRAP_MODE, 또는 UNWRAP_MODE 어떤 것이나)

key - 암호화키

params - 알고리즘 파라미터

random - 난수의 소스

예외:

InvalidKeyException - 지정된 키가 이 암호의 초기화에 부적절한 경우, 또는 지정된 키의 사이즈가 최대 허용키 사이즈 (설정되어 있는 관할 정책 파일에 의해 결정)를 넘는 경우

InvalidAlgorithmParameterException - 지정된 알고리즘 파라미터가 이 암호에 부적절한 경우, 이 암호가 복호화용으로 초기화되어 알고리즘 파라미터를 필요로 해, params가 null인 경우, 또는 지정된 알고리즘 파라미터가 유효한 제한 (설정되어 있는 관할 정책 파일에 의해 결정)을 넘는 암호화 강도를 나타내는 경우

init

public final void init(int opmode,
                       Certificate  certificate)
                throws InvalidKeyException 

이 암호를, 검증 조작을 위해서 지정된 공개키로 초기화합니다.

이 암호는 opmode값에 따라, 암호화, 복호화, 키 랩핑, 또는 키 랩핑 해제의 4개의 조작의 1개에 맞추어 초기화됩니다.

인증서 의 종류가 X. 509 로 중요와 마크 된 key usage 확장 영역이 있어, key usage 확장 영역의 값에 의해 인증서 의 공개키와 거기에 대응하는 비공개키가 opmode값으로 나타내지는 조작에 사용되지 않는 것으로 있는 경우는 InvalidKeyException가 발생 됩니다.

이 암호가 지정된 인증서 의 공개키로부터 파생할 수 없는 알고리즘 파라미터를 필요로 하는 경우, 기본이 되는 암호 구현은 암호화 또는 키 랩핑용으로 초기화되고 있으면, 프로바이더 고유의 디폴트 또는 랜덤치를 사용해 필요한 파라미터 자체를 생성해, 복호화 또는 키 랩핑 해제용으로 초기화되고 있으면, InvalidKeyException을 발생시킵니다. 생성된 파라미터는 getParameters 또는 getIV (파라미터가 IV인 경우)를 사용해 꺼낼 수가 있습니다.

이 암호 (기본이 되는 피드백 또는 패딩 방식을 포함한다)가 난수 바이트를 필요로 하는 경우 (예를 들어 파라미터 생성을 위해)는 인스톨 되고 있는 프로바이더 가운데, 가장 우선 순위의 높은 프로바이더의 SecureRandom 구현을 난수의 발생원으로서 사용해 난수 바이트를 취득합니다. SecureRandom 구현을 제공하는 프로바이더가 인스톨되어 있지 않은 경우는 시스템이 제공하는 난수의 발생원이 사용됩니다.

Cipher 객체가 초기화되면, 이전에 취득한 상태는 모두 없어집니다. 즉, Cipher를 초기화하는 것은 그 Cipher 새로운 인스턴스를 작성해 초기화하는 것과 같습니다.

파라미터:

opmode - 이 암호의 조작 모드 (ENCRYPT_MODE, DECRYPT_MODE, WRAP_MODE, 또는 UNWRAP_MODE 어떤 것이나)

certificate - 인증서

예외:

InvalidKeyException - 지정된 인증서 의 공개키가 이 암호의 초기화에 부적절한 경우, 이 암호가 복호화키 또는 랩핑 해제키용으로 초기화되어 지정된 인증서 의 공개키로부터 판정할 수가 없는 알고리즘 파라미터를 필요로 하는 경우, 또는 지정된 인증서 의 공개키의 사이즈가 최대 허용키 사이즈 (설정되어 있는 관할 정책 파일에 의해 결정)를 넘는 경우

init

public final void init(int opmode,
                       Certificate  certificate,
                       SecureRandom  random)
                throws InvalidKeyException 

이 암호를, 검증 조작을 위해서 지정된 공개키 및 난수의 발생원을 사용해 초기화합니다.

이 암호는 opmode값에 따라, 암호화, 복호화, 키 랩핑, 또는 키 랩핑 해제의 4개의 조작의 1개에 맞추어 초기화됩니다.

인증서 의 종류가 X. 509 로 중요와 마크 된 key usage 확장 영역이 있어, key usage 확장 영역의 값에 의해 인증서 의 공개키와 거기에 대응하는 비공개키가 opmode값으로 나타내지는 조작에 사용되지 않는 것으로 있는 경우는 InvalidKeyException가 발생 됩니다.

이 암호가 지정된 certificate 공개키로부터 파생할 수 없는 알고리즘 파라미터를 필요로 하는 경우, 기본이 되는 암호 구현은 암호화 또는 키 랩핑용으로 초기화되고 있으면, 프로바이더 고유의 디폴트 또는 랜덤치를 사용해 필요한 파라미터 자체를 생성해, 복호화 또는 키 랩핑 해제용으로 초기화되고 있으면, InvalidKeyException을 발생시킵니다. 생성된 파라미터는 getParameters 또는 getIV (파라미터가 IV인 경우)를 사용해 꺼낼 수가 있습니다.

이 암호 (기본이 되는 피드백 또는 패딩 방식을 포함한다)가 난수 바이트를 필요로 하는 경우 (예를 들어 파라미터 생성을 위해)는 random로 부터 취득합니다.

Cipher 객체가 초기화되면, 이전에 취득한 상태는 모두 없어집니다. 즉, Cipher를 초기화하는 것은 그 Cipher 새로운 인스턴스를 작성해 초기화하는 것과 같습니다.

파라미터:

opmode - 이 암호의 조작 모드 (ENCRYPT_MODE, DECRYPT_MODE, WRAP_MODE, 또는 UNWRAP_MODE 어떤 것이나)

certificate - 인증서

random - 난수의 소스

예외:

InvalidKeyException - 지정된 인증서 의 공개키가 이 암호의 초기화에 부적절한 경우, 이 암호가 복호화키 또는 랩핑 해제키용으로 초기화되어 지정된 인증서 의 공개키로부터 판정할 수가 없는 알고리즘 파라미터를 필요로 하는 경우, 또는 지정된 인증서 의 공개키의 사이즈가 최대 허용키 사이즈 (설정되어 있는 관할 정책 파일에 의해 결정)를 넘는 경우

update

public final byte[] update(byte[] input)

복수의 부분으로부터 완성되는 암호화 또는 복호화 조작 (이 암호의 초기화 방법에 의해 다르다)을 계속해, 다른 데이터 부분을 처리합니다.

input 버퍼내의 바이트가 처리되어 결과가 새로운 버퍼에 포함됩니다.

input 길이가 제로의 경우, 이 메서드는 null을 리턴합니다.

파라미터:

input - 입력 버퍼

반환값:

결과가 들어간 새로운 버퍼. 기본이 되는 암호가 블록 암호이며, 입력 데이터가 단인가 지나 새로운 블록이 되지 않는 경우는 null

예외:

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

update

public final byte[] update(byte[] input,
                           int inputOffset,
                           int inputLen)

복수의 부분으로부터 완성되는 암호화 또는 복호화 조작 (이 암호의 초기화 방법에 의해 다르다)을 계속해, 다른 데이터 부분을 처리합니다.

inputOffset로 부터 시작되는 input 버퍼내의 최초의 inputLen 바이트가 처리되어 결과가 새로운 버퍼에 포함됩니다.

inputLen가 제로의 경우, 이 메서드는 null을 리턴합니다.

파라미터:

input - 입력 버퍼

inputOffset - 입력을 개시하는 input 내의 오프셋(offset)

inputLen - 입력장

반환값:

결과가 들어간 새로운 버퍼. 기본이 되는 암호가 블록 암호이며, 입력 데이터가 단인가 지나 새로운 블록이 되지 않는 경우는 null

예외:

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

update

public final int update(byte[] input,
                        int inputOffset,
                        int inputLen,
                        byte[] output)
                 throws ShortBufferException 

복수의 부분으로부터 완성되는 암호화 또는 복호화 조작 (이 암호의 초기화 방법에 의해 다르다)을 계속해, 다른 데이터 부분을 처리합니다.

inputOffset로 부터 시작되는 input 버퍼내의 최초의 inputLen 바이트가 처리되어 결과가 output 버퍼에 포함됩니다.

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

inputLen가 0인 경우, 이 메서드는 길이 제로를 리턴합니다.

주: 이 메서드는 카피에 대해서 안전한 필요가 있습니다. 즉, input 및 output 버퍼는 같은 바이트 배열을 참조할 수가 있어 결과가 출력 버퍼에 카피될 때 미처리의 입력 데이터가 덧쓰기되지 않는 것이 필요합니다.

파라미터:

input - 입력 버퍼

inputOffset - 입력을 개시하는 input 내의 오프셋(offset)

inputLen - 입력장

output - 결과를 포함하는 버퍼

반환값:

output에 포함된 바이트수

예외:

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

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

update

public final int update(byte[] input,
                        int inputOffset,
                        int inputLen,
                        byte[] output,
                        int outputOffset)
                 throws ShortBufferException 

복수의 부분으로부터 완성되는 암호화 또는 복호화 조작 (이 암호의 초기화 방법에 의해 다르다)을 계속해, 다른 데이터 부분을 처리합니다.

inputOffset로 부터 시작되는 input 버퍼내의 최초의 inputLen 바이트가 처리되어 결과는 output 버퍼의 outputOffset로 부터 시작되는 위치에 포함됩니다.

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

inputLen가 0인 경우, 이 메서드는 길이 제로를 리턴합니다.

주: 이 메서드는 카피에 대해서 안전한 필요가 있습니다. 즉, input 및 output 버퍼는 같은 바이트 배열을 참조할 수가 있어 결과가 출력 버퍼에 카피될 때 미처리의 입력 데이터가 덧쓰기되지 않는 것이 필요합니다.

파라미터:

input - 입력 버퍼

inputOffset - 입력을 개시하는 input 내의 오프셋(offset)

inputLen - 입력장

output - 결과를 포함하는 버퍼

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

반환값:

output에 포함된 바이트수

예외:

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

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

update

public final int update(ByteBuffer  input,
                        ByteBuffer  output)
                 throws ShortBufferException 

복수의 부분으로부터 완성되는 암호화 또는 복호화 조작 (이 암호의 초기화 방법에 의해 다르다)을 계속해, 다른 데이터 부분을 처리합니다.

input.position()로 시작되는 모든 input.remaining() 바이트가 처리됩니다. 결과는 출력 버퍼에 포함됩니다. 귀가시에는 입력 버퍼의 위치는 게다가 한과 같게 되어, 상한은 변경되지 않습니다. 출력 버퍼의 위치는 이 메서드로 리턴된 값인 n 만 진행됩니다. 출력 버퍼의 상한은 변경되지 않습니다.

output.remaining() 버퍼가 결과를 보관 유지하는데 불충분한 경우는 ShortBufferException가 발생 됩니다. 이 경우 보다 큰 출력 버퍼를 사용해 이 호출을 반복합니다. getOutputSize를 사용해, 필요한 출력 버퍼의 사이즈를 판정합니다.

주: 이 메서드는 카피에 대해서 안전한 필요가 있습니다. 즉, input 및 output 버퍼는 같은 메모리브록크를 참조할 수가 있어 결과가 출력 버퍼에 카피될 때 미처리의 입력 데이터가 덧쓰기되지 않는 것이 필요합니다.

파라미터:

input - 입력 ByteBuffer

output - 출력 ByteByffer

반환값:

output에 포함된 바이트수

예외:

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

IllegalArgumentException - 입력 및 출력이 같은 객체의 경우

ReadOnlyBufferException - 출력 버퍼가 읽기 전용 버퍼인 경우

ShortBufferException - 출력 버퍼내에 남아 있는 용량이 부족한 경우

도입된 버전 :

1.5

doFinal

public final byte[] doFinal()
                     throws IllegalBlockSizeException,

                            BadPaddingException 

복수의 부분으로부터 완성되는 암호화 또는 복호화 조작 (이 암호의 초기화 방법에 의해 다르다)을 종료합니다.

입력 데이터는 전의 update 조작중에 버퍼에 넣어져, 패딩 (요구되었을 경우)이 적용되고 있는 경우가 있습니다. 결과는 새로운 버퍼에 포함됩니다.

종료시에 이 메서드는 이 암호 객체를 앞에 두고 init를 호출해 초기화되었을 때 상태에 리셋 합니다. 즉, 객체는 리셋 되어, 또한 데이터를 암호화 또는 복호화 하기 위해서 사용할 수 있습니다 (init 호출로 지정된 조작 모드에 의해 다르다).

주: 예외가 발생되는 경우, 이 암호 객체는 리셋 하지 않으면 재차 사용할 수 없는 경우가 있습니다.

반환값:

결과가 들어간 새로운 버퍼

예외:

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

IllegalBlockSizeException - 이 암호가 블록 암호이며, 패딩이 요구되지 않고 (암호화 모드의 경우만), 이 암호로 처리된 데이터의 입력장의 합계가 블록 사이즈의 배수가 아닌 경우, 또는 이 암호화 알고리즘에서는 제공된 입력 데이터를 처리할 수 없는 경우

BadPaddingException - 이 암호가 복호화 모드이며, 패딩 (또는 패딩 해제)이 요구되었지만, 복호화 된 데이터가 적절한 패딩 바이트로 바인드 되지 않는 경우

doFinal

public final int doFinal(byte[] output,
                         int outputOffset)
                  throws IllegalBlockSizeException,

                         ShortBufferException,

                         BadPaddingException 

복수의 부분으로부터 완성되는 암호화 또는 복호화 조작 (이 암호의 초기화 방법에 의해 다르다)을 종료합니다.

입력 데이터는 전의 update 조작중에 버퍼에 넣어져, 패딩 (요구되었을 경우)이 적용되고 있는 경우가 있습니다. 결과는 outputOffset로 부터 시작되는 output 버퍼에 포함됩니다.

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

종료시에 이 메서드는 이 암호 객체를 앞에 두고 init를 호출해 초기화되었을 때 상태에 리셋 합니다. 즉, 객체는 리셋 되어, 또한 데이터를 암호화 또는 복호화 하기 위해서 사용할 수 있습니다 (init 호출로 지정된 조작 모드에 의해 다르다).

주: 예외가 발생되는 경우, 이 암호 객체는 리셋 하지 않으면 재차 사용할 수 없는 경우가 있습니다.

파라미터:

output - 결과를 포함하는 버퍼

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

반환값:

output에 포함된 바이트수

예외:

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

IllegalBlockSizeException - 이 암호가 블록 암호이며, 패딩이 요구되지 않고 (암호화 모드의 경우만), 이 암호로 처리된 데이터의 입력장의 합계가 블록 사이즈의 배수가 아닌 경우, 또는 이 암호화 알고리즘에서는 제공된 입력 데이터를 처리할 수 없는 경우

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

BadPaddingException - 이 암호가 복호화 모드이며, 패딩 (또는 패딩 해제)이 요구되었지만, 복호화 된 데이터가 적절한 패딩 바이트로 바인드 되지 않는 경우

doFinal

public final byte[] doFinal(byte[] input)
                     throws IllegalBlockSizeException,

                            BadPaddingException 

단일의 부분으로부터 완성되는 조작으로 데이터를 암호화 또는 복호화 하는지, 복수의 부분으로부터 완성되는 조작을 종료합니다. 데이터는 이 암호가 초기화된 방법에 따라, 암호화 또는 복호화 됩니다.

input 버퍼내의 바이트 및 전의 update 조작중에 버퍼에 넣어진 가능성이 있는 모든 입력 바이트가 처리되어 패딩 (요구되었을 경우)이 적용됩니다. 결과는 새로운 버퍼에 포함됩니다.

종료시에 이 메서드는 이 암호 객체를 앞에 두고 init를 호출해 초기화되었을 때 상태에 리셋 합니다. 즉, 객체는 리셋 되어, 또한 데이터를 암호화 또는 복호화 하기 위해서 사용할 수 있습니다 (init 호출로 지정된 조작 모드에 의해 다르다).

주: 예외가 발생되는 경우, 이 암호 객체는 리셋 하지 않으면 재차 사용할 수 없는 경우가 있습니다.

파라미터:

input - 입력 버퍼

반환값:

결과가 들어간 새로운 버퍼

예외:

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

IllegalBlockSizeException - 이 암호가 블록 암호이며, 패딩이 요구되지 않고 (암호화 모드의 경우만), 이 암호로 처리된 데이터의 입력장의 합계가 블록 사이즈의 배수가 아닌 경우, 또는 이 암호화 알고리즘에서는 제공된 입력 데이터를 처리할 수 없는 경우

BadPaddingException - 이 암호가 복호화 모드이며, 패딩 (또는 패딩 해제)이 요구되었지만, 복호화 된 데이터가 적절한 패딩 바이트로 바인드 되지 않는 경우

doFinal

public final byte[] doFinal(byte[] input,
                            int inputOffset,
                            int inputLen)
                     throws IllegalBlockSizeException,

                            BadPaddingException 

단일의 부분으로부터 완성되는 조작으로 데이터를 암호화 또는 복호화 하는지, 복수의 부분으로부터 완성되는 조작을 종료합니다. 데이터는 이 암호가 초기화된 방법에 따라, 암호화 또는 복호화 됩니다.

inputOffset로 부터 시작되는 input 버퍼내의 최초의 inputLen 바이트 및 전의 update 조작으로 버퍼에 넣어진 가능성이 있는 모든 입력 바이트가 처리되어 패딩 (요구되었을 경우)이 적용됩니다. 결과는 새로운 버퍼에 포함됩니다.

종료시에 이 메서드는 이 암호 객체를 앞에 두고 init를 호출해 초기화되었을 때 상태에 리셋 합니다. 즉, 객체는 리셋 되어, 또한 데이터를 암호화 또는 복호화 하기 위해서 사용할 수 있습니다 (init 호출로 지정된 조작 모드에 의해 다르다).

주: 예외가 발생되는 경우, 이 암호 객체는 리셋 하지 않으면 재차 사용할 수 없는 경우가 있습니다.

파라미터:

input - 입력 버퍼

inputOffset - 입력을 개시하는 input 내의 오프셋(offset)

inputLen - 입력장

반환값:

결과가 들어간 새로운 버퍼

예외:

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

IllegalBlockSizeException - 이 암호가 블록 암호이며, 패딩이 요구되지 않고 (암호화 모드의 경우만), 이 암호로 처리된 데이터의 입력장의 합계가 블록 사이즈의 배수가 아닌 경우, 또는 이 암호화 알고리즘에서는 제공된 입력 데이터를 처리할 수 없는 경우

BadPaddingException - 이 암호가 복호화 모드이며, 패딩 (또는 패딩 해제)이 요구되었지만, 복호화 된 데이터가 적절한 패딩 바이트로 바인드 되지 않는 경우

doFinal

public final int doFinal(byte[] input,
                         int inputOffset,
                         int inputLen,
                         byte[] output)
                  throws ShortBufferException,

                         IllegalBlockSizeException,

                         BadPaddingException 

단일의 부분으로부터 완성되는 조작으로 데이터를 암호화 또는 복호화 하는지, 복수의 부분으로부터 완성되는 조작을 종료합니다. 데이터는 이 암호가 초기화된 방법에 따라, 암호화 또는 복호화 됩니다.

inputOffset로 부터 시작되는 input 버퍼내의 최초의 inputLen 바이트 및 전의 update 조작으로 버퍼에 넣어진 가능성이 있는 모든 입력 바이트가 처리되어 패딩 (요구되었을 경우)이 적용됩니다. 결과는 output 버퍼에 포함됩니다.

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

종료시에 이 메서드는 이 암호 객체를 앞에 두고 init를 호출해 초기화되었을 때 상태에 리셋 합니다. 즉, 객체는 리셋 되어, 또한 데이터를 암호화 또는 복호화 하기 위해서 사용할 수 있습니다 (init 호출로 지정된 조작 모드에 의해 다르다).

주: 예외가 발생되는 경우, 이 암호 객체는 리셋 하지 않으면 재차 사용할 수 없는 경우가 있습니다.

주: 이 메서드는 카피에 대해서 안전한 필요가 있습니다. 즉, input 및 output 버퍼는 같은 바이트 배열을 참조할 수가 있어 결과가 출력 버퍼에 카피될 때 미처리의 입력 데이터가 덧쓰기되지 않는 것이 필요합니다.

파라미터:

input - 입력 버퍼

inputOffset - 입력을 개시하는 input 내의 오프셋(offset)

inputLen - 입력장

output - 결과를 포함하는 버퍼

반환값:

output에 포함된 바이트수

예외:

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

IllegalBlockSizeException - 이 암호가 블록 암호이며, 패딩이 요구되지 않고 (암호화 모드의 경우만), 이 암호로 처리된 데이터의 입력장의 합계가 블록 사이즈의 배수가 아닌 경우, 또는 이 암호화 알고리즘에서는 제공된 입력 데이터를 처리할 수 없는 경우

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

BadPaddingException - 이 암호가 복호화 모드이며, 패딩 (또는 패딩 해제)이 요구되었지만, 복호화 된 데이터가 적절한 패딩 바이트로 바인드 되지 않는 경우

doFinal

public final int doFinal(byte[] input,
                         int inputOffset,
                         int inputLen,
                         byte[] output,
                         int outputOffset)
                  throws ShortBufferException,

                         IllegalBlockSizeException,

                         BadPaddingException 

단일의 부분으로부터 완성되는 조작으로 데이터를 암호화 또는 복호화 하는지, 복수의 부분으로부터 완성되는 조작을 종료합니다. 데이터는 이 암호가 초기화된 방법에 따라, 암호화 또는 복호화 됩니다.

inputOffset로 부터 시작되는 input 버퍼내의 최초의 inputLen 바이트 및 전의 update 조작으로 버퍼에 넣어진 가능성이 있는 모든 입력 바이트가 처리되어 패딩 (요구되었을 경우)이 적용됩니다. 결과는 outputOffset로 부터 시작되는 output 버퍼에 포함됩니다.

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

종료시에 이 메서드는 이 암호 객체를 앞에 두고 init를 호출해 초기화되었을 때 상태에 리셋 합니다. 즉, 객체는 리셋 되어, 또한 데이터를 암호화 또는 복호화 하기 위해서 사용할 수 있습니다 (init 호출로 지정된 조작 모드에 의해 다르다).

주: 예외가 발생되는 경우, 이 암호 객체는 리셋 하지 않으면 재차 사용할 수 없는 경우가 있습니다.

주: 이 메서드는 카피에 대해서 안전한 필요가 있습니다. 즉, input 및 output 버퍼는 같은 바이트 배열을 참조할 수가 있어 결과가 출력 버퍼에 카피될 때 미처리의 입력 데이터가 덧쓰기되지 않는 것이 필요합니다.

파라미터:

input - 입력 버퍼

inputOffset - 입력을 개시하는 input 내의 오프셋(offset)

inputLen - 입력장

output - 결과를 포함하는 버퍼

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

반환값:

output에 포함된 바이트수

예외:

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

IllegalBlockSizeException - 이 암호가 블록 암호이며, 패딩이 요구되지 않고 (암호화 모드의 경우만), 이 암호로 처리된 데이터의 입력장의 합계가 블록 사이즈의 배수가 아닌 경우, 또는 이 암호화 알고리즘에서는 제공된 입력 데이터를 처리할 수 없는 경우

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

BadPaddingException - 이 암호가 복호화 모드이며, 패딩 (또는 패딩 해제)이 요구되었지만, 복호화 된 데이터가 적절한 패딩 바이트로 바인드 되지 않는 경우

doFinal

public final int doFinal(ByteBuffer  input,
                         ByteBuffer  output)
                  throws ShortBufferException,

                         IllegalBlockSizeException,

                         BadPaddingException 

단일의 부분으로부터 완성되는 조작으로 데이터를 암호화 또는 복호화 하는지, 복수의 부분으로부터 완성되는 조작을 종료합니다. 데이터는 이 암호가 초기화된 방법에 따라, 암호화 또는 복호화 됩니다.

input.position()로 시작되는 모든 input.remaining() 바이트가 처리됩니다. 결과는 출력 버퍼에 포함됩니다. 귀가시에는 입력 버퍼의 위치는 그 제한과 동일해져, 제한은 변경하지 않습니다. 출력 버퍼의 위치는 이 메서드로 리턴된 값의 n 만 진행됩니다. 출력 버퍼의 제한은 변경하지 않습니다.

output.remaining() 버퍼가 결과를 보관 유지하는데 불충분한 경우는 ShortBufferException가 발생 됩니다. 이 경우 보다 큰 출력 버퍼를 사용해 이 호출을 반복합니다. getOutputSize를 사용해, 필요한 출력 버퍼의 사이즈를 판정합니다.

종료시에 이 메서드는 이 암호 객체를 앞에 두고 init를 호출해 초기화되었을 때 상태에 리셋 합니다. 즉, 객체는 리셋 되어, 또한 데이터를 암호화 또는 복호화 하기 위해서 사용할 수 있습니다 (init 호출로 지정된 조작 모드에 의해 다르다).

주: 예외가 발생되는 경우, 이 암호 객체는 리셋 하지 않으면 재차 사용할 수 없는 경우가 있습니다.

주: 이 메서드는 카피에 대해서 안전한 필요가 있습니다. 즉, input 및 output 버퍼는 같은 바이트 배열을 참조할 수가 있어 결과가 출력 버퍼에 카피될 때 미처리의 입력 데이터가 덧쓰기되지 않는 것이 필요합니다.

파라미터:

input - 입력 ByteBuffer

output - 출력 ByteBuffer

반환값:

output에 포함된 바이트수

예외:

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

IllegalArgumentException - 입력 및 출력이 같은 객체의 경우

ReadOnlyBufferException - 출력 버퍼가 읽기 전용 버퍼인 경우

IllegalBlockSizeException - 이 암호가 블록 암호이며, 패딩이 요구되지 않고 (암호화 모드의 경우만), 이 암호로 처리된 데이터의 입력장의 합계가 블록 사이즈의 배수가 아닌 경우, 또는 이 암호화 알고리즘에서는 제공된 입력 데이터를 처리할 수 없는 경우

ShortBufferException - 출력 버퍼내에 남아 있는 용량이 부족한 경우

BadPaddingException - 이 암호가 복호화 모드이며, 패딩 (또는 패딩 해제)이 요구되었지만, 복호화 된 데이터가 적절한 패딩 바이트로 바인드 되지 않는 경우

도입된 버전 :

1.5

wrap

public final byte[] wrap(Key  key)
                  throws IllegalBlockSizeException,

                         InvalidKeyException 

키를 랩 합니다.

파라미터:

key - 랩 되는 키

반환값:

랩 된 키

예외:

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

IllegalBlockSizeException - 이 암호가 블록 암호이며, 패딩이 요구되지 않고, 랩 되는 키의 인코딩의 길이가 블록 사이즈의 배수가 아닌 경우

InvalidKeyException - 이 암호를 사용해 키를감싸는 것이 불가능한가 안전하지 않은 경우 (예를 들어 하드웨어 보호된 키가 소프트웨어만의 암호에게 건네지는 경우)

unwrap

public final Key  unwrap(byte[] wrappedKey,
                        String  wrappedKeyAlgorithm,
                        int wrappedKeyType)
                 throws InvalidKeyException,

                        NoSuchAlgorithmException 

전에 랩 된 키를 랩 해제합니다.

파라미터:

wrappedKey - 랩이 해제되는 키

wrappedKeyAlgorithm - 랩 된 키에 관련한 알고리즘

wrappedKeyType - 랩 된 키의 타입. SECRET_KEY, PRIVATE_KEY, 또는 PUBLIC_KEY 어떤 것인가일 필요가 있다

반환값:

랩 해제된 키

예외:

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

NoSuchAlgorithmException - 인스톨 되고 있는 어느 프로바이더도 wrappedKeyAlgorithm wrappedKeyType 타입의 키를 작성할 수 없는 경우

InvalidKeyException - wrappedKey가 wrappedKeyAlgorithm 랩 키 타입 wrappedKeyType를 나타내지 않은 경우

getMaxAllowedKeyLength

public static final int getMaxAllowedKeyLength(String  transformation)
                                        throws NoSuchAlgorithmException 

인스톨 한 JCE 관할 정책 파일에 기반해 지정의 변환을 실시하는 최대의 키의 길이를 리턴합니다. JCE 로 강도가 무제한의 관할 정책 파일이 인스톨 되고 있는 경우는 Integer.Max_Value가 리턴됩니다 . JCE 권한 정책 파일의 디폴트의 키의 사이즈의 상세한 것에 대하여는 「JCE 레퍼런스 가이드」를 참조하십시오.

파라미터:

transformation - 암호화 변환

반환값:

키의 최대 bit length 또는 Integer.MAX_VALUE

예외:

NullPointerException - transformation가 null인 경우

NoSuchAlgorithmException - 형식이 「알고리즘」또는 「알고리즘/모드/패딩」 등, transformation가 유효한 변환이 아닌 경우

도입된 버전 :

1.5

getMaxAllowedParameterSpec

public static final AlgorithmParameterSpec  getMaxAllowedParameterSpec(String  transformation)
                                                               throws NoSuchAlgorithmException 

관할 정책 파일에 기반해 최대 암호화 파라미터값를 포함한 AlgorithmParameterSpec 객체를 리턴합니다. JCE 강도 무제한의 정책 파일이 인스톨 되고 있는지, 정책 파일로 가리키는 변환의 파라미터에 최대값 의 제한이 없는 경우는 null이 리턴됩니다 .

파라미터:

transformation - 암호화 변환

반환값:

최대값 또는 null을 보관 유지하는 AlgorithmParameterSpec

예외:

NullPointerException - transformation가 null인 경우

NoSuchAlgorithmException - 형식이 「알고리즘」또는 「알고리즘/모드/패딩」 등, transformation가 유효한 변환이 아닌 경우

도입된 버전 :

1.5