demo.smime.basic

Class SMimeSendDemo

java.lang.Object

demo.smime.basic.SMimeSendDemo

public class SMimeSendDemo
extends java.lang.Object

This class demonstrates the usage of the IAIK S/MIME implementation for sending signed and/or encryped emails based on the Jakarta Mail API.

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

Usage:

 SMimeSend [-H host] [-S sender name] [-F (From) sender address] [-T (To) recipient address]
 

Example:

 SMimeSend -H mailhost -S \"John SMime\" -F smimetest@iaik.tugraz.at -T smimetest@iaik.tugraz.at
 

By default this demo used "mailhost" as host, "John SMime" as sender name, and "smimetest@iaik.tugraz.at" as sender and also as recipient mail address. "smimetest@iaik.tugraz.at" is also the email address contained in the demo certificates. Although you should specify other email addresses to send the test messages to yourself, be aware that the certificate email check may fail on the receiving side (SMimeShowDemo).

See Also:

EncryptedContent, SignedContent

Constructor Summary

Constructors

Constructor and Description
SMimeSendDemo() Default constructor.

Method Summary

Modifier and Type	Method and Description
jakarta.mail.Message	createCertsOnlyMessage(jakarta.mail.Session session) Creates a certs-only message.
jakarta.mail.Message	createCertsOnlyMultiPartMessage(jakarta.mail.Session session) Creates a certs-only message where the certificate list is transferred as attachment.
jakarta.mail.Message	createEncryptedMessage(jakarta.mail.Session session, iaik.asn1.structures.AlgorithmID algorithm, 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	createPKCS10Message(jakarta.mail.Session session) Creates a PKCS#10 certificate request message.
jakarta.mail.Message	createPKCS10MultiPartMessage(jakarta.mail.Session session) Creates a PKCS#10 message where the certificate request is transferred as attachment.
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, jakarta.activation.DataHandler dataHandler, boolean implicit) Creates a signed and encrypted message.
jakarta.mail.Message	createSignedMessage(jakarta.mail.Session session, jakarta.activation.DataHandler dataHandler, boolean implicit) Creates a signed message.
static void	main(java.lang.String[] argv) Main method.
void	start(java.lang.String[] argv) Starts the demo.

Methods inherited from class java.lang.Object

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

Constructor Detail

SMimeSendDemo

public SMimeSendDemo()

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

Method Detail

start

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

Starts the demo.

Parameters:

argv - optional parameters like mailhost, sender name,...

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,
                                                            jakarta.activation.DataHandler dataHandler,
                                                            boolean implicit)
                                                     throws jakarta.mail.MessagingException

Creates a signed and encrypted message.

Parameters:

session - the mail session

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

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

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)
                                         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

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 algorithm,
                                                   int keyLength)
                                            throws jakarta.mail.MessagingException

Creates an encrypted message.

Parameters:

session - the mail session

algorithm - 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

createCertsOnlyMessage

public jakarta.mail.Message createCertsOnlyMessage(jakarta.mail.Session session)
                                            throws jakarta.mail.MessagingException

Creates a certs-only message.

Parameters:

session - the mail session

Returns:

the certs-only message

Throws:

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

createCertsOnlyMultiPartMessage

public jakarta.mail.Message createCertsOnlyMultiPartMessage(jakarta.mail.Session session)
                                                     throws jakarta.mail.MessagingException

Creates a certs-only message where the certificate list is transferred as attachment.

Parameters:

session - the mail session

Returns:

the certs-only message

Throws:

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

createPKCS10Message

public jakarta.mail.Message createPKCS10Message(jakarta.mail.Session session)
                                         throws jakarta.mail.MessagingException

Creates a PKCS#10 certificate request message.

Parameters:

session - the mail session

Returns:

the PKCS#10 certificate request message

Throws:

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

createPKCS10MultiPartMessage

public jakarta.mail.Message createPKCS10MultiPartMessage(jakarta.mail.Session session)
                                                  throws jakarta.mail.MessagingException

Creates a PKCS#10 message where the certificate request is transferred as attachment.

Parameters:

session - the mail session

Returns:

the PKCS#10 certificate request 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

Main method.

Throws:

java.io.IOException