javax.crypto
클래스 Mac

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

모든 구현 인터페이스:

Cloneable

public class Mac

extends Object

implements Cloneable

이 클래스는 「메세지 인증 코드」(MAC) 알고리즘의 기능을 제공합니다.

MAC 는 비밀열쇠에 근거해, 전송 된 정보나 신뢰할 수 없는 미디어에 저장되고 있는 정보의 완전성을 확인하는 수단을 제공합니다. 통상, 메세지 인증 코드는 서로 전송 된 정보를 검증하기 위해서, 비밀열쇠를 공유하는 2 살의 당사자 사이에 사용됩니다.

암호화 해시 기능에 근거하는 MAC 기구는 HMAC 로 불립니다. HMAC 는 MD5 나 SHA-1 등, 어느 암호화 해시 기능에서도, 공유의 비밀열쇠와 조합해 사용할 수가 있습니다. HMAC 는 RFC 2104 로 지정되고 있습니다.

도입된 버젼:

1.4

생성자의 개요

protected

Mac (MacSpi macSpi, Provider provider, String algorithm) MAC 오브젝트를 작성합니다.

메소드의 개요

Object	clone () 프로바이더의 구현이 복제 가능한 경우는 복제를 돌려줍니다.
byte[]	doFinal () MAC 조작을 종료합니다.
byte[]	doFinal (byte[] input) 지정된 바이트의 배열을 처리해 MAC 조작을 종료합니다.
void	doFinal (byte[] output, int outOffset) MAC 조작을 종료합니다.
String	getAlgorithm () 이 Mac 오브젝트의 알고리즘명을 돌려줍니다.
static Mac	getInstance (String algorithm) 지정된 MAC 알고리즘을 구현하는 Mac 오브젝트를 작성합니다.
static Mac	getInstance (String algorithm, Provider provider) 지정된 프로바이더로부터, 지정된 MAC 알고리즘의 Mac 오브젝트를 생성합니다.
static Mac	getInstance (String algorithm, String provider) 지정된 프로바이더로부터, 지정된 MAC 알고리즘의 Mac 오브젝트를 작성합니다.
int	getMacLength () MAC 의 길이를 바이트 단위로 돌려줍니다.
Provider	getProvider () 이 Mac 오브젝트의 프로바이더를 돌려줍니다.
void	init (Key key) 지정된 열쇠를 사용해 이 Mac 오브젝트를 초기화합니다.
void	init (Key key, AlgorithmParameterSpec params) 지정된 열쇠와 알고리즘 파라미터를 사용해 이 Mac 오브젝트를 초기화합니다.
void	reset () 이 Mac 오브젝트를 리셋트 합니다.
void	update (byte input) 지정된 바이트를 처리합니다.
void	update (byte[] input) 지정된 바이트의 배열을 처리합니다.
void	update (byte[] input, int offset, int len) input 내의 len 바이트를 처리합니다.

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

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

생성자의 상세

Mac

protected Mac(MacSpi  macSpi,
              Provider  provider,
              String  algorithm)

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

파라미터:

macSpi - delegate처

provider - 프로바이더

algorithm - 알고리즘

메소드의 상세

getAlgorithm

public final String  getAlgorithm()

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

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

반환값:

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

getInstance

public static final Mac  getInstance(String  algorithm)
                             throws NoSuchAlgorithmException 

지정된 MAC 알고리즘을 구현하는 Mac 오브젝트를 작성합니다. 요구되는 MAC 알고리즘의 구현을 디폴트의 프로바이더 패키지가 제공하는 경우는 그 구현을 포함한 Mac 의 인스턴스가 돌려주어집니다. 디폴트의 프로바이더 패키지로 목적의 알고리즘이 제공되어 있지 않은 경우에는 다른 프로바이더 패키지가 검색됩니다.

파라미터:

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

반환값:

새로운 Mac 오브젝트

예외:

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

getInstance

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

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

파라미터:

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

provider - 프로바이더명

반환값:

새로운 Mac 오브젝트

예외:

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

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

IllegalArgumentException - provider 가 null 의 경우

getInstance

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

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

파라미터:

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

provider - 프로바이더명

반환값:

새로운 Mac 오브젝트

예외:

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

IllegalArgumentException - provider 가 null 의 경우

getProvider

public final Provider  getProvider()

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

반환값:

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

getMacLength

public final int getMacLength()

MAC 의 길이를 바이트 단위로 돌려줍니다.

반환값:

바이트 단위의 MAC 장

init

public final void init(Key  key)
                throws InvalidKeyException 

지정된 열쇠를 사용해 이 Mac 오브젝트를 초기화합니다.

파라미터:

key - 열쇠

예외:

InvalidKeyException - 지정된 열쇠가 이 MAC 의 초기화에 부적절한 경우

init

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

지정된 열쇠와 알고리즘 파라미터를 사용해 이 Mac 오브젝트를 초기화합니다.

파라미터:

key - 열쇠

params - 알고리즘 파라미터

예외:

InvalidKeyException - 지정된 열쇠가 이 MAC 의 초기화에 부적절한 경우

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

update

public final void update(byte input)
                  throws IllegalStateException 

지정된 바이트를 처리합니다.

파라미터:

input - 처리되는 입력 바이트

예외:

IllegalStateException - 이 Mac 가 초기화되어 있지 않은 경우

update

public final void update(byte[] input)
                  throws IllegalStateException 

지정된 바이트의 배열을 처리합니다.

파라미터:

input - 처리되는 바이트의 배열

예외:

IllegalStateException - 이 Mac 가 초기화되어 있지 않은 경우

update

public final void update(byte[] input,
                         int offset,
                         int len)
                  throws IllegalStateException 

input 내의 len 바이트를 처리합니다. offset 로부터 시작합니다.

파라미터:

input - 입력 버퍼

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

len - 처리하는 바이트수

예외:

IllegalStateException - 이 Mac 가 초기화되어 있지 않은 경우

doFinal

public final byte[] doFinal()
                     throws IllegalStateException 

MAC 조작을 종료합니다.

이 메소드를 호출하면(자),Mac 오브젝트는 init(Key) 또는 init(Key, AlgorithmParameterSpec) 의 호출을 개입시켜 이전 초기화된 상태에 리셋트 됩니다. 즉, 오브젝트는 필요에 따라서 update 및 doFinal 의 신규의 호출을 개입시켜, 리셋트 되어 같은 열쇠로부터 다른 MAC 를 생성하기 위해서 사용 가능하게 됩니다. 다른 열쇠로 이 Mac 오브젝트를 재사용하기 위해서는 init(Key) 또는 init(Key, AlgorithmParameterSpec) 의 호출을 개입시켜, 재차 초기화할 필요가 있습니다.

반환값:

MAC 결과

예외:

IllegalStateException - 이 Mac 가 초기화되어 있지 않은 경우

doFinal

public final void doFinal(byte[] output,
                          int outOffset)
                   throws ShortBufferException ,
                          IllegalStateException 

MAC 조작을 종료합니다.

이 메소드를 호출하면(자),Mac 오브젝트는 init(Key) 또는 init(Key, AlgorithmParameterSpec) 의 호출을 개입시켜 이전 초기화된 상태에 리셋트 됩니다. 즉, 오브젝트는 필요에 따라서 update 및 doFinal 의 신규의 호출을 개입시켜, 리셋트 되어 같은 열쇠로부터 다른 MAC 를 생성하기 위해서 사용 가능하게 됩니다. 다른 열쇠로 이 Mac 오브젝트를 재사용하기 위해서는 init(Key) 또는 init(Key, AlgorithmParameterSpec) 의 호출을 개입시켜, 재차 초기화할 필요가 있습니다.

MAC 결과는 output 에 저장됩니다. outOffset 로부터 시작됩니다.

파라미터:

output - MAC 결과가 저장되는 버퍼

outOffset - MAC 가 저장되는 output 내의 오프셋(offset)

예외:

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

IllegalStateException - 이 Mac 가 초기화되어 있지 않은 경우

doFinal

public final byte[] doFinal(byte[] input)
                     throws IllegalStateException 

지정된 바이트의 배열을 처리해 MAC 조작을 종료합니다.

이 메소드를 호출하면(자),Mac 오브젝트는 init(Key) 또는 init(Key, AlgorithmParameterSpec) 의 호출을 개입시켜 이전 초기화된 상태에 리셋트 됩니다. 즉, 오브젝트는 필요에 따라서 update 및 doFinal 의 신규의 호출을 개입시켜, 리셋트 되어 같은 열쇠로부터 다른 MAC 를 생성하기 위해서 사용 가능하게 됩니다. 다른 열쇠로 이 Mac 오브젝트를 재사용하기 위해서는 init(Key) 또는 init(Key, AlgorithmParameterSpec) 의 호출을 개입시켜, 재차 초기화할 필요가 있습니다.

파라미터:

input - 바이트 단위의 데이터

반환값:

MAC 결과

예외:

IllegalStateException - 이 Mac 가 초기화되어 있지 않은 경우

reset

public final void reset()

이 Mac 오브젝트를 리셋트 합니다.

이 메소드를 호출하면(자),Mac 오브젝트는 init(Key) 또는 init(Key, AlgorithmParameterSpec) 의 호출을 개입시켜 이전 초기화된 상태에 리셋트 됩니다. 즉, 오브젝트는 필요에 따라서 update 및 doFinal 의 신규의 호출을 개입시켜, 리셋트 되어 같은 열쇠로부터 다른 MAC 를 생성하기 위해서 사용 가능하게 됩니다. 다른 열쇠로 이 Mac 오브젝트를 재사용하기 위해서는 init(Key) 또는 init(Key, AlgorithmParameterSpec) 의 호출을 개입시켜, 재차 초기화할 필요가 있습니다.

clone

public final Object  clone()
                   throws CloneNotSupportedException 

프로바이더의 구현이 복제 가능한 경우는 복제를 돌려줍니다.

오버라이드(override):

클래스 Object 내의 clone

반환값:

프로바이더의 구현이 복제 가능한 경우는 복제

예외:

CloneNotSupportedException - Cloneable 를 서포트하고 있지 않는 delegate처에서 불려 갔을 경우

관련 항목:

Cloneable