javax.crypto
클래스 Mac

java.lang.Object 
  javax.crypto.Mac

모든 구현된 인터페이스:

Cloneable

public class Mac
extends Object 
implements Cloneable 

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

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

암호화 해시 기능에 근거하는 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 바이트를 처리합니다.
void	update (ByteBuffer input) ByteBuffer input 내의 데이터를, input.position() 위치로부터 input.remaining() 바이트만 처리합니다.

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

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

생성자 상세

Mac

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

MAC 객체를 작성합니다.

파라미터:

macSpi - 위양처

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

반환값:

새로운 Mac 객체

예외:

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

getInstance

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

                                    NoSuchProviderException 

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

파라미터:

algorithm - 요구된 MAC 알고리즘의 표준적인 이름. 알고리즘의 표준명에 대해서는 「Java 암호화 확장 기능 레퍼런스 가이드」의 부록 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 암호화 확장 기능 레퍼런스 가이드」의 부록 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가 초기화되어 있지 않은 경우

update

public final void update(ByteBuffer  input)

ByteBuffer input 내의 데이터를, input.position() 위치로부터 input.remaining() 바이트만 처리합니다. 종료시, 버퍼의 위치는 리밋트에 동일해집니다. 리밋트에 변화는 없습니다.

파라미터:

input - ByteBuffer

예외:

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

도입된 버전 :

1.5

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을 지원 하고 있지 않는 위양처에서 불려 갔을 경우

관련 항목:

Cloneable