gnu.java.security.pkcs

Class PKCS7SignedData


public class PKCS7SignedData
extends Object

The SignedData object in PKCS #7. This is a read-only implementation of this format, and is used to provide signed Jar file support.

Field Summary

static OID
PKCS7_SIGNED_DATA

Constructor Summary

PKCS7SignedData(BERReader ber)
Parse an encoded PKCS#7 SignedData object.
PKCS7SignedData(InputStream in)
PKCS7SignedData(Set<E> digestAlgorithms, PKCS7Data data, Certificate[] certificates, X509CRL[] crls, Set<E> signerInfos)
Constructs a new instance of PKCS7SignedData given a designated set of fields.

Method Summary

void
encode(OutputStream out)
Writes to the designated output stream the DER encoding of the current contents of this instance.
Certificate[]
getCertificates()
byte[]
getContent()
OID
getContentType()
Set<E>
getDigestAlgorithms()
Set<E>
getSignerInfos()
BigInteger
getVersion()

Methods inherited from class java.lang.Object

clone, equals, extends Object> getClass, finalize, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

PKCS7_SIGNED_DATA

public static final OID PKCS7_SIGNED_DATA

Constructor Details

PKCS7SignedData

public PKCS7SignedData(BERReader ber)
            throws CRLException,
                   CertificateException,
                   IOException
Parse an encoded PKCS#7 SignedData object. The ASN.1 format of this object is:
 SignedData ::= SEQUENCE {
   version           Version, -- always 1 for PKCS7 v1.5
   digestAlgorithms  DigestAlgorithmIdentifiers,
   contentInfo       ContentInfo,
   certificates  [0] IMPLICIT ExtendedCertificatesAndCertificates OPTIONAL,
   crls          [1] IMPLICIT CertificateRevocationLists OPTIONAL,
   signerInfos       SignerInfos }

 Version ::= INTEGER

 DigestAlgorithmIdentifiers ::= SET OF DigestAlgorithmIdentifier

 DigestAlgorithmIdentifier ::= AlgorithmIdentifier

 ContentInfo ::= SEQUENCE {
   contentType   ContentType,
   content   [0] EXPLICIT ANY DEFINED BY contentType OPTIONAL }

 ContentType ::= OBJECT IDENTIFIER

 ExtendedCertificatesAndCertificates ::=
   SET OF ExtendedCertificatesAndCertificate

 ExtendedCertificatesAndCertificate ::= CHOICE {
   certificate             Certificate, -- from X.509
   extendedCertificate [0] IMPLICIT ExtendedCertificate }

 CertificateRevocationLists ::= SET OF CertificateRevocationList
   -- from X.509

 SignerInfos ::= SET OF SignerInfo

 SignerInfo ::= SEQUENCE {
   version                       Version, -- always 1 for PKCS7 v1.5
   issuerAndSerialNumber         IssuerAndSerialNumber,
   digestAlgorithm               DigestAlgorithmIdentifier,
   authenticatedAttributes   [0] IMPLICIT Attributes OPTIONAL,
   digestEncryptionAlgorithm     DigestEncryptionAlgorithmIdentifier,
   encryptedDigest               EncryptedDigest,
   unauthenticatedAttributes [1] IMPLICIT Attributes OPTIONAL }

 EncryptedDigest ::= OCTET STRING
 

(Readers who are confused as to why it takes 40 levels of indirection to specify "data with a signature", rest assured that the present author is as confused as you are).


PKCS7SignedData

public PKCS7SignedData(InputStream in)
            throws CRLException,
                   CertificateException,
                   IOException

PKCS7SignedData

public PKCS7SignedData(Set<E> digestAlgorithms,
                       PKCS7Data data,
                       Certificate[] certificates,
                       X509CRL[] crls,
                       Set<E> signerInfos)
Constructs a new instance of PKCS7SignedData given a designated set of fields.
Parameters:
digestAlgorithms - the collection of DigestAlgorithm elements. Each DigestAlgorithm is a List of two elements, the first is an OID while the second is dependent on the value of the OID element.
data - an instance of a PKCS#7 (non-signed) data. In its simplest form such an ASN.1 structure would consist of just the OID of a non-signed PKCS#7 Data.
certificates - the array of Certificates used to authenticate the enclosed (or referenced, in case the content is null) data.
crls - the array of certificate-revocation lists of the used certificates.
signerInfos - a set of SignerInfo elements, one per signer of the data referenced by this PKCS7SignedData instance.

Method Details

encode

public void encode(OutputStream out)
            throws IOException,
                   CRLException,
                   CertificateEncodingException
Writes to the designated output stream the DER encoding of the current contents of this instance.
Parameters:
out - the destination output stream.
Throws:
IOException - if an I/O related exception occurs during the process.
CRLException - if an exception occurs while encoding the certificate revocation lists associated with this instance.
CertificateEncodingException - if an exception occurs while encoding the certificate chains associated with this instance.

getCertificates

public Certificate[] getCertificates()

getContent

public byte[] getContent()

getContentType

public OID getContentType()

getDigestAlgorithms

public Set<E> getDigestAlgorithms()

getSignerInfos

public Set<E> getSignerInfos()

getVersion

public BigInteger getVersion()

PKCS7SignedData.java -- reader/writer for PKCS#7 signedData objects Copyright (C) 2004, 2005, 2006, 2010 Free Software Foundation, Inc. This file is part of GNU Classpath. GNU Classpath is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2, or (at your option) any later version. GNU Classpath is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with GNU Classpath; see the file COPYING. If not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. Linking this library statically or dynamically with other modules is making a combined work based on this library. Thus, the terms and conditions of the GNU General Public License cover the whole combination. As a special exception, the copyright holders of this library give you permission to link this library with independent modules to produce an executable, regardless of the license terms of these independent modules, and to copy and distribute the resulting executable under terms of your choice, provided that you also meet, for each linked independent module, the terms and conditions of the license of that module. An independent module is a module which is not derived from or based on this library. If you modify this library, you may extend this exception to your version of the library, but you are not obligated to do so. If you do not wish to do so, delete this exception statement from your version.