demo.smime.basic

Class SMimeEnvelopedDemoAEAD

java.lang.Object

demo.smime.basic.SMimeEnvelopedDemoAEAD

public class SMimeEnvelopedDemoAEAD
extends java.lang.Object

This class demonstrates the usage of the IAIK S/MIME implementation. It shows how to create signed and/or encrypted S/MIME messages and how to parse them and verify the signatures and decrypt the content, respectively. This demos creates encrypted messages using an AEAD cipher mode (like GCM). Although CMS and S/MIME generally use AEAD cipher modes with the AuthEnvelopedData content type, it is technically possible to also use AEAD cipher modes with the EnvelopedData content type (when appending the mac value to the cipher text). This demo shows how to encrypt S/MIME messages with AEAD cipher modes when using the CMS EnvelopedData type.

To run this demo the following packages are required:

• iaik_cms.jar (IAIK-CMS/SMIME)
• iaik_jce(_full).jar (IAIK-JCE Core Crypto Library).
• Jakarta/Angus Mail
• Jakarta Activation Framework

This demo requires Java 7 or later.

Constructor Summary

Constructors

Constructor and Description
SMimeEnvelopedDemoAEAD() Default constructor.

Method Summary

Modifier and Type	Method and Description
jakarta.mail.Message	createEncryptedMessage(jakarta.mail.Session session, iaik.asn1.structures.AlgorithmID contentEA, int keyLength) Creates an encrypted message.
jakarta.mail.Message	createMessage(jakarta.mail.Session session, java.lang.String subject) Creates a MIME message container with the given subject for the given session.
jakarta.mail.Message	createPlainMessage(jakarta.mail.Session session, jakarta.activation.DataHandler dataHandler) Creates a simple plain (neither signed nor encrypted) message.
jakarta.mail.Message	createSignedAndEncryptedMessage(jakarta.mail.Session session, iaik.asn1.structures.AlgorithmID contentEA, int keyLength, jakarta.activation.DataHandler dataHandler, boolean implicit, boolean authEncrypt) Creates a signed and encrypted message.
jakarta.mail.Message	createSignedMessage(jakarta.mail.Session session, jakarta.activation.DataHandler dataHandler, boolean implicit, iaik.asn1.structures.AlgorithmID digestAlgorithm, iaik.asn1.structures.AlgorithmID signatureAlgorithm) Creates a signed message.
static void	main(java.lang.String[] argv) The main method.
void	start() Starts the demo.

Methods inherited from class java.lang.Object

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

Constructor Detail

SMimeEnvelopedDemoAEAD

public SMimeEnvelopedDemoAEAD()

Default constructor. Reads certificates and keys from the demo keystore.

Method Detail

start

public void start()
           throws java.io.IOException

Starts the demo.

Throws:

java.io.IOException - if an I/O related error occurs

createMessage

public jakarta.mail.Message createMessage(jakarta.mail.Session session,
                                          java.lang.String subject)
                                   throws jakarta.mail.MessagingException

Creates a MIME message container with the given subject for the given session.

Parameters:

session - the mail sesion

subject - the subject of the message

Returns:

the MIME message with FROM, TO, DATE and SUBJECT headers (without content)

Throws:

jakarta.mail.MessagingException - if the message cannot be created

createPlainMessage

public jakarta.mail.Message createPlainMessage(jakarta.mail.Session session,
                                               jakarta.activation.DataHandler dataHandler)
                                        throws jakarta.mail.MessagingException

Creates a simple plain (neither signed nor encrypted) message.

Parameters:

session - the mail session

dataHandler - the content of the message

Returns:

the plain message

Throws:

jakarta.mail.MessagingException - if an error occurs when creating the message

createSignedAndEncryptedMessage

public jakarta.mail.Message createSignedAndEncryptedMessage(jakarta.mail.Session session,
                                                            iaik.asn1.structures.AlgorithmID contentEA,
                                                            int keyLength,
                                                            jakarta.activation.DataHandler dataHandler,
                                                            boolean implicit,
                                                            boolean authEncrypt)
                                                     throws jakarta.mail.MessagingException

Creates a signed and encrypted message.

Parameters:

session - the mail session

contentEA - the content encryption algorithm to be used

keyLength - the length of the secret content encryption key to be created and used

dataHandler - the content of the message to be signed and encrypted

implicit - whether to use implicit (application/pkcs7-mime) or explicit (multipart/signed) signing

authEncrypt - whether to create an encrypted message

Returns:

the signed and encrypted message

Throws:

jakarta.mail.MessagingException - if an error occurs when creating the message

createSignedMessage

public jakarta.mail.Message createSignedMessage(jakarta.mail.Session session,
                                                jakarta.activation.DataHandler dataHandler,
                                                boolean implicit,
                                                iaik.asn1.structures.AlgorithmID digestAlgorithm,
                                                iaik.asn1.structures.AlgorithmID signatureAlgorithm)
                                         throws jakarta.mail.MessagingException

Creates a signed message.

Parameters:

session - the mail session

dataHandler - the content of the message to be signed

implicit - whether to use implicit (application/pkcs7-mime) or explicit (multipart/signed) signing

digestAlgorithm - the digest algorithm to be used

signatureAlgorithm - the signature algorithm to be used

Returns:

the signed message

Throws:

jakarta.mail.MessagingException - if an error occurs when creating the message

createEncryptedMessage

public jakarta.mail.Message createEncryptedMessage(jakarta.mail.Session session,
                                                   iaik.asn1.structures.AlgorithmID contentEA,
                                                   int keyLength)
                                            throws jakarta.mail.MessagingException

Creates an encrypted message.

Parameters:

session - the mail session

contentEA - the content encryption algorithm to be used

keyLength - the length of the secret content encryption key to be created and used

Returns:

the encrypted message

Throws:

jakarta.mail.MessagingException - if an error occurs when creating the message

main

public static void main(java.lang.String[] argv)
                 throws java.io.IOException

The main method.

Throws:

java.io.IOException