iaik.security.smime

Class SMimeMailer

java.lang.Object

iaik.utils.SmtpMailer

iaik.security.smime.SMimeMailer

public class SMimeMailer
extends SmtpMailer

This class implements a simple S/MIME mailing tool.

Field Summary

Fields

Modifier and Type	Field and Description
static int	ENCRYPTED Value for creating encrypted S/MIME messages.
static int	SIGNED Value for creating signed S/MIME messages.
static int	SIGNED_AND_ENCRYPTED Value for creating signed and encrypted S/MIME messages.

Constructor Summary

Constructors

Constructor and Description
SMimeMailer(java.lang.String mailhost, int mode) Creates a new SMimeMailer.

Method Summary

Modifier and Type	Method and Description
void	addAdditionalField(java.lang.String line) Sets any additional field according to RFC822.
void	addBcc(java.lang.String realName, java.lang.String emailAddress, X509Certificate recipientCert, AlgorithmID keyEncAlg) Adds one receiver (Bcc: field) of the S/MIME email message.
void	addCc(java.lang.String realName, java.lang.String emailAddress, X509Certificate recipientCert, AlgorithmID keyEncAlg) Adds one receiver (Cc: field) of the S/MIME email message.
void	addDate() Sets the "Date:" field to the current date.
void	addDate(java.util.Date date) Sets the "Date:" field to the specified date.
void	addTo(java.lang.String realName, java.lang.String emailAddress, X509Certificate recipientCert, AlgorithmID keyEncAlg) Adds one receiver (To: field) of the S/MIME email message.
boolean	sendMail() Encrypt and send the mail that was just created.
void	setEncryption(AlgorithmID contentEncAlg, int keyLength) Sets the symmetric algorithm for encrypting the message.
void	setFrom(java.lang.String realName, java.lang.String emailAddress, X509Certificate senderCert, AlgorithmID keyEncAlg) Sets the from field of the S/MIME email message.
void	setSecureRandom(java.security.SecureRandom random) Sets the source of randomness for the key generation.
java.lang.String	toString() Returns a string representation of this SMimeMailer.

Methods inherited from class iaik.utils.SmtpMailer

addBcc, addCc, addText, addTo, checkResponse, send, sendCommands, setDebug, setFrom, setReplyTo, setSubject, setText, setVerify, writeBody, writeHeaders

Methods inherited from class java.lang.Object

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

Field Detail

ENCRYPTED

public static final int ENCRYPTED

Value for creating encrypted S/MIME messages.

See Also:

Constant Field Values

SIGNED

public static final int SIGNED

Value for creating signed S/MIME messages.

See Also:

Constant Field Values

SIGNED_AND_ENCRYPTED

public static final int SIGNED_AND_ENCRYPTED

Value for creating signed and encrypted S/MIME messages.

See Also:

Constant Field Values

Constructor Detail

SMimeMailer

public SMimeMailer(java.lang.String mailhost,
                   int mode)

Creates a new SMimeMailer.

Parameters:

mailhost - the name of the SMTP server (e.g. "mailhost.domain.com")

mode - the S/MIME message mode (ENCRYPTED and/or SIGNED)

Method Detail

setFrom

public void setFrom(java.lang.String realName,
                    java.lang.String emailAddress,
                    X509Certificate senderCert,
                    AlgorithmID keyEncAlg)

Sets the from field of the S/MIME email message. Use this method to set the from field if the sender also should be able to decrypt the encrypted message. If the sender doesn't need the possibility to encrypt the message you can use the method void setFrom(String realName, String emailAddress); from the superclass SmtpMailer.

Parameters:

realName - the real name of the sender (e.g. "Wolfgang Platzer")

emailAddress - the email address of the sender (e.g. "wplatzer@iaik.tu-graz.ac.at")

senderCert - the certificate of the sender

keyEncAlg - the algorithm used to encrypt the temporary symmetric key for a receiver

addTo

public void addTo(java.lang.String realName,
                  java.lang.String emailAddress,
                  X509Certificate recipientCert,
                  AlgorithmID keyEncAlg)

Adds one receiver (To: field) of the S/MIME email message.

Parameters:

realName - the real name of the sender (e.g. "Wolfgang Platzer")

emailAddress - the email address of the sender (e.g. "wplatzer@iaik.tu-graz.ac.at")

recipientCert - the certificate of the sender

keyEncAlg - the algorithm used to encrypt the temporary symmetric key for a receiver

addCc

public void addCc(java.lang.String realName,
                  java.lang.String emailAddress,
                  X509Certificate recipientCert,
                  AlgorithmID keyEncAlg)

Adds one receiver (Cc: field) of the S/MIME email message.

Parameters:

realName - the real name of the sender (e.g. "Wolfgang Platzer")

emailAddress - the email address of the sender (e.g. "wplatzer@iaik.tu-graz.ac.at")

recipientCert - the certificate of the sender

keyEncAlg - the algorithm used to encrypt the temporary symmetric key for a receiver

addBcc

public void addBcc(java.lang.String realName,
                   java.lang.String emailAddress,
                   X509Certificate recipientCert,
                   AlgorithmID keyEncAlg)

Adds one receiver (Bcc: field) of the S/MIME email message.

Parameters:

realName - the real name of the sender (e.g. "Wolfgang Platzer")

emailAddress - the email address of the sender (e.g. "wplatzer@iaik.tu-graz.ac.at")

recipientCert - the certificate of the sender

keyEncAlg - the algorithm used to encrypt the temporary symmetric key for a receiver

addAdditionalField

public void addAdditionalField(java.lang.String line)

Sets any additional field according to RFC822. For example: "MIME-Version: 1.0". This method overwrites the corresponding method in SmtpMailer to ensure that this additional headers are also encrypted.

Overrides:

addAdditionalField in class SmtpMailer

Parameters:

line - a complete line

addDate

public void addDate()

Sets the "Date:" field to the current date.

addDate

public void addDate(java.util.Date date)

Sets the "Date:" field to the specified date.

Parameters:

date - the date

setEncryption

public void setEncryption(AlgorithmID contentEncAlg,
                          int keyLength)

Sets the symmetric algorithm for encrypting the message. For RC2 the key length in bits can be: 40, 64, 128. If the encryption algorithm is not RC2 this parameter is ignored.

Possible encryption algorithms are:

• AlgorithmID.rc2_CBC
• AlgorithmID.des_CBC
• AlgorithmID.des_EDE3_CBC

Parameters:

contentEncAlg - the algorithm for encrypting the content

keyLength - the key length for RC2

See Also:

AlgorithmID

setSecureRandom

public void setSecureRandom(java.security.SecureRandom random)

Sets the source of randomness for the key generation.

Parameters:

random - a random number generator

sendMail

public boolean sendMail()
                 throws SmtpException

Encrypt and send the mail that was just created.

Overrides:

sendMail in class SmtpMailer

Returns:

true if the response codes from the server were the expected (if verify is switched on), false otherwise

Throws:

SmtpException - if there is a problem while sending the EMail

See Also:

SmtpMailer

toString

public java.lang.String toString()

Returns a string representation of this SMimeMailer.

Overrides:

toString in class SmtpMailer

Returns:

the string representation