java.security
클래스 SignedObject

java.lang.Object 
  java.security.SignedObject

모든 구현된 인터페이스:

Serializable

public final class SignedObject
extends Object 
implements Serializable 

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

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

서명 첨부 객체는 원의 객체의 직렬화 된 형식에서의 정밀한 카피입니다. 한 번 카피가 생성되면, 원의 객체를 또한 조작해도, 카피에 영향을 줄 것은 없습니다.

기본으로 되는 서명 알고리즘은 생성자과 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) {}; 

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

또한 중요한 것은 유연성입니다. 생성자과 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와 같이 합니다. 디폴트는 없기 때문에 반드시 알고리즘의 이름을 지정하지 않으면 안됩니다.

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

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

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

관련 항목:

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 - 검증키가 무효인 경우