public class

SMIMESignedParser

extends CMSSignedDataParser
java.lang.Object
   ↳ org.bouncycastle.cms.CMSContentInfoParser
     ↳ org.bouncycastle.cms.CMSSignedDataParser
       ↳ org.bouncycastle.mail.smime.SMIMESignedParser

Class Overview

general class for handling a pkcs7-signature message.

A simple example of usage - note, in the example below the validity of the certificate isn't verified, just the fact that one of the certs matches the given signer...

  CertStore               certs = s.getCertificates("Collection", "BC");
  SignerInformationStore  signers = s.getSignerInfos();
  Collection              c = signers.getSigners();
  Iterator                it = c.iterator();
  
  while (it.hasNext())
  {
      SignerInformation   signer = (SignerInformation)it.next();
      Collection          certCollection = certs.getCertificates(signer.getSID());
  
      Iterator        certIt = certCollection.iterator();
      X509Certificate cert = (X509Certificate)certIt.next();
  
      if (signer.verify(cert.getPublicKey()))
      {
          verified++;
      }   
  }
 

Note: if you are using this class with AS2 or some other protocol that does not use 7bit as the default content transfer encoding you will need to use the constructor that allows you to specify the default content transfer encoding, such as "binary".

Summary

[Expand]
Inherited Fields
From class org.bouncycastle.cms.CMSContentInfoParser
Public Constructors
SMIMESignedParser(MimeMultipart message)
base constructor using a defaultContentTransferEncoding of 7bit.
SMIMESignedParser(MimeMultipart message, File backingFile)
base constructor using a defaultContentTransferEncoding of 7bit and a specified backing file.
SMIMESignedParser(MimeMultipart message, String defaultContentTransferEncoding)
base constructor with settable contentTransferEncoding.
SMIMESignedParser(MimeMultipart message, String defaultContentTransferEncoding, File backingFile)
base constructor with settable contentTransferEncoding and a specified backing file.
SMIMESignedParser(Part message)
base constructor for a signed message with encapsulated content.
SMIMESignedParser(Part message, File file)
Constructor for a signed message with encapsulated content.
Public Methods
MimeBodyPart getContent()
return the content that was signed.
MimeMessage getContentAsMimeMessage(Session session)
Return the content that was signed as a mime message.
Object getContentWithSignature()
return the content that was signed with its signature attached.
[Expand]
Inherited Methods
From class org.bouncycastle.cms.CMSSignedDataParser
From class org.bouncycastle.cms.CMSContentInfoParser
From class java.lang.Object

Public Constructors

public SMIMESignedParser (MimeMultipart message)

base constructor using a defaultContentTransferEncoding of 7bit. A temporary backing file will be created for the signed data.

Parameters
message signed message with signature.
Throws
on an error extracting the signature or otherwise processing the message.
CMSException if some other problem occurs.
MessagingException

public SMIMESignedParser (MimeMultipart message, File backingFile)

base constructor using a defaultContentTransferEncoding of 7bit and a specified backing file.

Parameters
message signed message with signature.
backingFile the temporary file to use to back the signed data.
Throws
on an error extracting the signature or otherwise processing the message.
CMSException if some other problem occurs.
MessagingException

public SMIMESignedParser (MimeMultipart message, String defaultContentTransferEncoding)

base constructor with settable contentTransferEncoding. A temporary backing file will be created to contain the signed data.

Parameters
message the signed message with signature.
defaultContentTransferEncoding new default to use.
Throws
on an error extracting the signature or otherwise processing the message.
CMSException if some other problem occurs.
MessagingException

public SMIMESignedParser (MimeMultipart message, String defaultContentTransferEncoding, File backingFile)

base constructor with settable contentTransferEncoding and a specified backing file.

Parameters
message the signed message with signature.
defaultContentTransferEncoding new default to use.
backingFile the temporary file to use to back the signed data.
Throws
on an error extracting the signature or otherwise processing the message.
CMSException if some other problem occurs.
MessagingException

public SMIMESignedParser (Part message)

base constructor for a signed message with encapsulated content.

Note: in this case the encapsulated MimeBody part will only be suitable for a single writeTo - once writeTo has been called the file containing the body part will be deleted. If writeTo is not called the file will be left in the temp directory.

Parameters
message the message containing the encapsulated signed data.
Throws
on an error extracting the signature or otherwise processing the message.
SMIMEException if the body part encapsulated in the message cannot be extracted.
CMSException if some other problem occurs.
MessagingException

public SMIMESignedParser (Part message, File file)

Constructor for a signed message with encapsulated content. The encapsulated content, if it exists, is written to the file represented by the File object passed in.

Parameters
message the Part containing the signed content.
file the file the encapsulated part is to be written to after it has been decoded.
Throws
on an error extracting the signature or otherwise processing the message.
SMIMEException if the body part encapsulated in the message cannot be extracted.
CMSException if some other problem occurs.
MessagingException

Public Methods

public MimeBodyPart getContent ()

return the content that was signed.

Returns
  • the signed body part in this message.

public MimeMessage getContentAsMimeMessage (Session session)

Return the content that was signed as a mime message.

Parameters
session the session to base the MimeMessage around.
Returns
  • a MimeMessage holding the content.
Throws
if there is an issue creating the MimeMessage.
IOException if there is an issue reading the content.
MessagingException

public Object getContentWithSignature ()

return the content that was signed with its signature attached.

Returns
  • depending on whether this was unencapsulated or not it will return a MimeMultipart or a MimeBodyPart