java.security
클래스 SignedObject

java.lang.Object 
  |
  +--java.security.SignedObject

모든 구현 인터페이스:

Serializable

public final class SignedObject

extends Object

implements Serializable

SignedObject 는 인증 실행시 오브젝트의 작성을 목적으로 한 클래스입니다. 이 실행시 오브젝트의 정합성이 손상되었을 경우는 반드시 검출됩니다.

보다 구체적으로는 SignedObject 는 다른 Serializable 오브젝트, 서명 첨부 오브젝트, 및 그 서명을 보관 유지합니다.

서명 첨부 오브젝트는 원의 오브젝트의 직렬화 된 형식에서의 정밀한 카피입니다. 한 번 카피가 생성되면(자), 원의 오브젝트를 한층 더 조작해도, 카피에 영향을 줄 것은 없습니다.

기본으로 되는 서명 알고리즘은 constructor 과 verify 메소드에게 건네지는 Signature 오브젝트에 의해 지정됩니다. 다음에, 서명의 일반적인 사용법을 나타냅니다.

 Signature signingEngine = Signature.getInstance(algorithm,
                                                 provider);
 SignedObject so = new SignedObject(myobject, signingKey,
                                    signingEngine);
 

다음에, 검증의 일반적인 사용법을 나타냅니다 (SignedObject so 를 받고 있다).

 Signature verificationEngine =
     Signature.getInstance(algorithm, provider);
 if (so.verify(publickey, verificationEngine))
     try {
         Object myobj = so.getObject();
     } catch (java.lang.ClassNotFoundException e) {};
 

유의점을 몇개인가 듭니다. 최초로, 서명 엔진이나 검증 엔진은 constructor 과 verify 메소드내에서 재초기화되므로, 그러한 엔진을 초기화할 필요는 없습니다. 다음에, 검증을 성공시키려면 , 지정된 공개열쇠가, SignedObject 를 생성하는데 사용하는 비공개열쇠에 일치하고 있지 않으면 안됩니다.

한층 더 중요한 것은 유연성입니다. constructor 과 verify 메소드는 커스터마이즈 된 서명 엔진에 의해, 암호 프로바이더의 일부로서 정식으로 인스톨되어 있지 않은 서명 알고리즘을 구현할 수 있습니다. 다만, 서명의 검증에는 verify 메소드의 Signature 엔진 자신의 구현이 불려 가므로, 검증용 코드를 기술하는 프로그래머는 어느 Signature 엔진이 사용중인지를 확인하는 것이 중요합니다. 바꾸어 말하면, 악의가 있는 Signature 는 시큐러티 체크를 면하기 위해서(때문에) 검증으로 항상 true 를 돌려주려고 하는 경우가 있습니다.

많은 서명 알고리즘 중(안)에서, DSA 및 SHA-1 를 사용한 NIST 표준의 DSA 를 사용할 수 있습니다. 알고리즘은 서명과 같은 규약을 사용해 지정됩니다. 예를 들어, SHA-1 메세지 다이제스트 알고리즘을 사용하는 DSA 알고리즘은 SHA/DSA 또는 SHA-1/DSA (이것들은 등가)와 같이 지정할 수 있습니다. RSA 의 경우는 메세지 다이제스트 알고리즘에 복수의 선택사항이 있습니다. 따라서, 서명 알고리즘의 지정은 MD2/RSA, MD5/RSA, 또는 SHA-1/RSA 와 같이 합니다. 디폴트는 없기 때문에, 반드시 알고리즘의 이름을 지정하지 않으면 안됩니다.

암호 패키지 프로바이더의 이름은 constructor 과 verify 메소드에 대한 Signature 파라미터로 지정됩니다. 이 프로바이더를 지정하지 않으면 디폴트의 프로바이더가 사용됩니다. 각 인스톨은 특정 프로바이더를 디폴트로서 사용하도록(듯이) 설정할 수 있습니다.

SignedObject 를 사용하는 어플리케이션에서는 이하을 할 수가 있습니다.

• 개찬이 불가능한 인증 토큰으로서 어느 Java 실행시에 대해서도 내부적으로 사용할 수 있다. 악질적인 개찬은 반드시 검출되므로, 이 토큰은 안심하고 건네줄 수가 있다
• Java 실행시 이외에 저장하는 (예를 들어, 중요한 액세스 제어 데이터를 디스크에 저장한다) 위해(때문에), 데이터나 오브젝트에 서명해, 그것들을 직렬화하기 위해서(때문에) 사용할 수 있다
• 상자의 SignedObjects 를 사용하면(자), 인증과 delegate의 연쇄에 유사한, 서명의 논리 순차 순서를 구축할 수 있다

관련 항목:

Signature , 직렬화 된 형식

생성자의 개요

SignedObject (Serializable object, PrivateKey signingKey, Signature signingEngine)
임의의 Serializable 오브젝트로부터 SignedObject 를 구축합니다.

메소드의 개요

String	getAlgorithm () 서명 알고리즘의 이름을 취득합니다.
Object	getObject () 캡슐화된 오브젝트를 취득합니다.
byte[]	getSignature () 서명 첨부 오브젝트의 서명을, 바이트 배열의 형식에서 취득합니다.
boolean	verify (PublicKey verificationKey, Signature verificationEngine) 이 SignedObject 내의 서명이, 내부에 저장된 오브젝트의 유효한 서명인가 어떤가를, 지정된 검증 엔진을 사용해, 지정된 검증열쇠로 검증합니다.

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

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

생성자의 상세

SignedObject

public SignedObject(Serializable  object,
                    PrivateKey  signingKey,
                    Signature  signingEngine)
             throws IOException ,
                    InvalidKeyException ,
                    SignatureException 

임의의 Serializable 오브젝트로부터 SignedObject 을 구축합니다. 지정된 오브젝트는 지정된 서명 엔진을 사용해, 지정된 서명열쇠로 서명됩니다.

파라미터:

object - 서명 대상의 오브젝트

signingKey - 서명을 위한 비공개열쇠

signingEngine - 서명 엔진

예외:

IOException - 직렬화로 에러가 발생했을 경우

InvalidKeyException - 열쇠가 무효인 경우

SignatureException - 서명이 실패했을 경우

메소드의 상세

getObject

public Object  getObject()
                 throws IOException ,
                        ClassNotFoundException 

캡슐화된 오브젝트를 취득합니다. 이 오브젝트는 복귀하기 전에 직렬화가 복원됩니다.

반환값:

캡슐화된 오브젝트

예외:

IOException - 직렬화 복원으로 에러가 발생했을 경우

ClassNotFoundException - 직렬화 복원으로 에러가 발생했을 경우

getSignature

public byte[] getSignature()

서명 첨부 오브젝트의 서명을, 바이트 배열의 형식에서 취득합니다.

반환값:

서명

getAlgorithm

public String  getAlgorithm()

서명 알고리즘의 이름을 취득합니다.

반환값:

서명 알고리즘명

verify

public boolean verify(PublicKey  verificationKey,
                      Signature  verificationEngine)
               throws InvalidKeyException ,
                      SignatureException 

이 SignedObject 내의 서명이, 내부에 저장된 오브젝트의 유효한 서명인가 어떤가를, 지정된 검증 엔진을 사용해, 지정된 검증열쇠로 검증합니다.

파라미터:

verificationKey - 검증용의 공개열쇠

verificationEngine - 서명 검증 엔진

반환값:

서명이 유효한 경우는 true, 그렇지 않은 경우는 false

예외:

SignatureException - 서명 검증이 실패했을 경우

InvalidKeyException - 검증열쇠가 무효인 경우