org.bouncycastle.openpgp.api

Class OpenPGPCertificate.OpenPGPComponentSignature

java.lang.Object

org.bouncycastle.openpgp.api.OpenPGPSignature

org.bouncycastle.openpgp.api.OpenPGPCertificate.OpenPGPComponentSignature

Enclosing class:

OpenPGPCertificate

public static class OpenPGPCertificate.OpenPGPComponentSignature
extends OpenPGPSignature

OpenPGP Signature made over some OpenPGPCertificate.OpenPGPCertificateComponent on a OpenPGPCertificate.

Nested Class Summary

Nested classes/interfaces inherited from class org.bouncycastle.openpgp.api.OpenPGPSignature

OpenPGPSignature.OpenPGPDocumentSignature, OpenPGPSignature.OpenPGPSignatureSubpacket

Field Summary

Fields inherited from class org.bouncycastle.openpgp.api.OpenPGPSignature

isCorrect, issuer, isTested, signature

Constructor Summary

Constructors

Constructor and Description
OpenPGPComponentSignature(PGPSignature signature, OpenPGPCertificate.OpenPGPComponentKey issuer, OpenPGPCertificate.OpenPGPCertificateComponent target) Component signature.

Method Summary

Modifier and Type	Method and Description
OpenPGPCertificate.OpenPGPComponentKey	getIssuerComponent() Return the OpenPGPCertificate.OpenPGPComponentKey that issued this signature.
java.util.Date	getKeyExpirationTime() Return the key expiration time stored in the signature.
OpenPGPCertificate.OpenPGPCertificateComponent	getTargetComponent() Return the OpenPGPCertificate.OpenPGPCertificateComponent that this signature was calculated over.
protected java.lang.String	getTargetDisplay()
OpenPGPCertificate.OpenPGPComponentKey	getTargetKeyComponent() Return the OpenPGPCertificate.OpenPGPComponentKey that this signature is calculated over.
void	verify() Verify this signature.
void	verify(OpenPGPImplementation implementation) Verify this signature.
void	verify(PGPContentVerifierBuilderProvider contentVerifierBuilderProvider, OpenPGPPolicy policy) Verify this signature.
protected void	verifyKeySignature(OpenPGPCertificate.OpenPGPComponentKey issuer, OpenPGPCertificate.OpenPGPComponentKey target, PGPContentVerifierBuilderProvider contentVerifierBuilderProvider) Verify a signature of type PGPSignature.DIRECT_KEY, PGPSignature.KEY_REVOCATION, PGPSignature.SUBKEY_BINDING or PGPSignature.SUBKEY_REVOCATION.
protected void	verifyUserAttributeSignature(OpenPGPCertificate.OpenPGPComponentKey issuer, OpenPGPCertificate.OpenPGPUserAttribute target, PGPContentVerifierBuilderProvider contentVerifierBuilderProvider) Verify a certification signature over an OpenPGPCertificate.OpenPGPUserAttribute.
protected void	verifyUserIdSignature(OpenPGPCertificate.OpenPGPComponentKey issuer, OpenPGPCertificate.OpenPGPUserId target, PGPContentVerifierBuilderProvider contentVerifierBuilderProvider) Verify a certification signature over an OpenPGPCertificate.OpenPGPUserId.

Methods inherited from class org.bouncycastle.openpgp.api.OpenPGPSignature

getCreationTime, getEncoded, getEncoded, getExpirationTime, getIssuer, getIssuerCertificate, getIssuerDisplay, getKeyIdentifier, getKeyIdentifiers, getMostExpressiveIdentifier, getSignature, getType, isCertification, isEffectiveAt, isHardRevocation, isRevocation, isTestedCorrect, toAsciiArmoredString, toAsciiArmoredString, toAsciiArmoredString, toString

Methods inherited from class java.lang.Object

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

Constructor Detail

OpenPGPComponentSignature

public OpenPGPComponentSignature(PGPSignature signature,
                                 OpenPGPCertificate.OpenPGPComponentKey issuer,
                                 OpenPGPCertificate.OpenPGPCertificateComponent target)

Component signature.

Parameters:

signature - signature

issuer - key that issued the signature. Is nullable (e.g. for 3rd party sigs where the certificate is not available).

target - signed certificate component

Method Detail

getIssuerComponent

public OpenPGPCertificate.OpenPGPComponentKey getIssuerComponent()

Return the OpenPGPCertificate.OpenPGPComponentKey that issued this signature.

Returns:

issuer

getTargetComponent

public OpenPGPCertificate.OpenPGPCertificateComponent getTargetComponent()

Return the OpenPGPCertificate.OpenPGPCertificateComponent that this signature was calculated over.

Returns:

target

getTargetKeyComponent

public OpenPGPCertificate.OpenPGPComponentKey getTargetKeyComponent()

Return the OpenPGPCertificate.OpenPGPComponentKey that this signature is calculated over. Contrary to getTargetComponent(), which returns the actual target, this method returns the OpenPGPCertificate.OpenPGPComponentKey "closest" to the target. For a subkey-binding signature, this is the target subkey, while for an identity-binding signature (binding for a user-id or attribute) the return value is the OpenPGPCertificate.OpenPGPComponentKey which carries the identity.

Returns:

target key component of the signature

getKeyExpirationTime

public java.util.Date getKeyExpirationTime()

Return the key expiration time stored in the signature.

Returns:

key expiration time

verify

public void verify()
            throws PGPSignatureException

Verify this signature.

Throws:

PGPSignatureException - if the signature cannot be verified successfully

verify

public void verify(OpenPGPImplementation implementation)
            throws PGPSignatureException

Verify this signature.

Parameters:

implementation - OpenPGP implementation

Throws:

PGPSignatureException - if the signature cannot be verified successfully

verify

public void verify(PGPContentVerifierBuilderProvider contentVerifierBuilderProvider,
                   OpenPGPPolicy policy)
            throws PGPSignatureException

Verify this signature.

Parameters:

contentVerifierBuilderProvider - provider for verifiers

policy - algorithm policy

Throws:

PGPSignatureException - if the signature cannot be verified successfully

verifyKeySignature

protected void verifyKeySignature(OpenPGPCertificate.OpenPGPComponentKey issuer,
                                  OpenPGPCertificate.OpenPGPComponentKey target,
                                  PGPContentVerifierBuilderProvider contentVerifierBuilderProvider)
                           throws PGPSignatureException

Verify a signature of type PGPSignature.DIRECT_KEY, PGPSignature.KEY_REVOCATION, PGPSignature.SUBKEY_BINDING or PGPSignature.SUBKEY_REVOCATION.

Parameters:

issuer - issuing component key

target - targeted component key

contentVerifierBuilderProvider - provider for content verifier builders

Throws:

PGPSignatureException - if an exception happens during signature verification

verifyUserIdSignature

protected void verifyUserIdSignature(OpenPGPCertificate.OpenPGPComponentKey issuer,
                                     OpenPGPCertificate.OpenPGPUserId target,
                                     PGPContentVerifierBuilderProvider contentVerifierBuilderProvider)
                              throws PGPSignatureException

Verify a certification signature over an OpenPGPCertificate.OpenPGPUserId. The signature is of type PGPSignature.DEFAULT_CERTIFICATION, PGPSignature.NO_CERTIFICATION, PGPSignature.CASUAL_CERTIFICATION, PGPSignature.POSITIVE_CERTIFICATION or PGPSignature.CERTIFICATION_REVOCATION.

Parameters:

issuer - issuing component key

target - targeted userid

contentVerifierBuilderProvider - provider for content verifier builders

Throws:

PGPSignatureException - if an exception happens during signature verification

verifyUserAttributeSignature

protected void verifyUserAttributeSignature(OpenPGPCertificate.OpenPGPComponentKey issuer,
                                            OpenPGPCertificate.OpenPGPUserAttribute target,
                                            PGPContentVerifierBuilderProvider contentVerifierBuilderProvider)
                                     throws PGPSignatureException

Verify a certification signature over an OpenPGPCertificate.OpenPGPUserAttribute. The signature is of type PGPSignature.DEFAULT_CERTIFICATION, PGPSignature.NO_CERTIFICATION, PGPSignature.CASUAL_CERTIFICATION, PGPSignature.POSITIVE_CERTIFICATION or PGPSignature.CERTIFICATION_REVOCATION.

Parameters:

issuer - issuing component key

target - targeted userid

contentVerifierBuilderProvider - provider for content verifier builders

Throws:

PGPSignatureException - if an exception happens during signature verification

getTargetDisplay

protected java.lang.String getTargetDisplay()

Specified by:

getTargetDisplay in class OpenPGPSignature