README For SUCSES Eudora Plug-ins

 

 

SCONCE Group, UC Irvine

 

 

1. Introduction

 

The SUCSES plug-ins for Eudora allows user to sign or encrypt outgoing emails, verify or decrypt incoming emails using SUCSES cryptographic settings.

 

Specificly, it include SAS (Server Aided Signature), mRSA (Mediated RSA) and IB-mRSA (Identity-based mediated RSA). For details on each protocol, please visit our web site at http://sconce.ics.uci.edu/sucses. In short, they have the following features:

        - Tight security control: All three algorithms enable a fine-grained control over users' security capabilities, by deploying a semi-trusted security mediator.

        - Light local computation: SAS  protocl can offload the expensive public-key cryptographic computations to the more resourceful security mediator.

        - Simplified Certificate Usage: In IB-mRSA, users' RSA public key can be computed publicly from their email address so that no individual certificate is needed.

  

Platform: Windows 2000/NT/98

 

Required Software: Eudora 5.0.1 or above.  Our plug-ins are for Eudora Windows version only. We assume that the Eudora has been installed. To get Eudora program, visit  http://www.eudora.com/download

 

In the following sections, we show how to install, configure and run the three plug-ins. The installation program is in http://sconce.ics.uci.edu/sucses/addin.htm

 

2. Plugin Installation and Configuration

 

2.1 Install

Download and run s_e_setup.exe from the addin web page. It installs the plugins and puts an example setting  in directory sucses_eudora_setting under the target path. By default, it locates in C:\Program Files\Qualcomm\plugins . You may try those setting using SEM in sconce.ics.uci.edu. The installation program also allows users to choose a directory for log file suces.log.  

 

 Note that all the certificates and key files used by the plugins are in PEM format.

2.2 Configure SAS

 

circle01_red.gif Start Eudora, go to menu ``Special | Message Plug-ins Settings...'', a dialog with title ``Installed Message Plug-ins'' will be ejected out;

circle01_red.gif Double click ``SAS Plugin, v1.5'' to get the access to ``SAS Sign Settings'' dialog;

circle01_red.gif In the ``SAS Sign Settings'' dialog

   square04_green.gif In ``CA Certificate'' frame, choose the CA certificate by clicking ``CA...'' button to choose the file, e.g. ca_sem/cacert.pem;

  square04_green.gif In ``SEM Certificate'' frame, choose SEM certificate by clicking ``SEM...'' button, e.g. ca_sem/semcert1k.pem;

  square04_green.gif In ``USER Certificate'' frame, choose your personal certificate with SAS extensions by clicking ``User...'' button, e.g. sas_setting/sascert.pem ;

  square04_green.gif In ``SAS Context'' frame, choose your SAS context file, e.g. sas_setting/sasctx, by clicking ``CTX...'' button..

  square04_green.gif In ``SEM address'' frame, input the SEM hostname directly, e.g. sconce.ics.uci.edu.

circle01_red.gif Click ``OK'' button to save the setting or ``Cancel'' button to cancel it;

 

2.3 Configure mRSA

 

circle01_red.gif Start Eudora, go to menu ``Special | Message Plug-ins Settings...''. Choose ``mRSA Plugin, v1.5'' to configure mRSA;

circle01_red.gif In the ``mRSA Configure'' dialog

  square04_green.gif Choose CA ceritificate in the same way as for SAS plugin.

  square04_green.gif In ``User Bundle'' frame, choose mRSA client bundle clicking ``Browse...''. The client bundle is a binary PKCS#12 file, e.g mrsa_setting/client.p12.

  square04_green.gif In ``USER Certificate'' frame, choose the personal certificate by clicking ``Browse...'', e.g. mrsa_setting/mrsacert.pem

  square04_green.gif In ``Address Book'' frame, specify your SEM address configuration file, e.g. tmp.addr. The address book stores the SEM certificate serial number and the hostnames of SEM which provide mRSA services with the corresponding certificate. The format of the address book  is as follows:

<certificate serial number><space><sem hostname>

An example is

307 sconce.ics.uci.edu

where 307 is the serial number of the certificate used by sconce.ics.uci.edu. The file is composed of one or multiple lines of the tuple above, each of which is ended by a carriage return;

 

circle01_red.gif Click ``OK'' to save or ``Cancel'' to cancel them;

 

2.4 Configure IB-mRSA

 

circle01_red.gif Start Eudora, go to menu ``Special | Message Plug-ins Settings...'', a dialog with title ``Installed Message Plug-ins'' will be ejected out;

circle01_red.gif Double click ``IB-mRSA Plugin, v1.5'' to get the access to ``IB_mRSA Configure'' dialog;

circle01_red.gif The configuration of IB_mRSA is similar to mRSA, except that there is no "USER Certificate" frame, but an ``Organization Certificate'' frame. In this frame, you can choose your organization certificate, e.g  ibe_setting/orgcert.pem.  The example setting for IB-mRSA is in ibe_setting folder.

 

 

2.5 Run Plugins

Before sending an email, you may choose the needed security property. Four buttons appears in the composer window:

circle01_red.gif SAS  button for SAS signture

circle01_red.gif S button for mRSA signature,  E button for RSA encryption

circle01_red.gif  IS button for IB-mRSA signature, IE button for IB-mRSA encryption.

For the incoming emails, Eudora places the corresponding plugin icon in the email body window. Click the icon to activate the related plugin process for reading email. For example, if it has SAS   in the body, clicking the icon will activate SAS signature verification plugin.

 

 

3. Sample Setting

A set of sample files are in the installation package.  A folder named sucses_eudora_setting will be created in your designated directory, which includes.

circle01_red.gif CA and SEM Setting

   square04_green.gif cacert.pem : CA certificate

   square04_green.gif semcert.pem : SEM certificate

circle01_red.gif sas_setting : SAS setting subfolder, including:

   square04_green.gif sascert.pem : A SAS user's certificate

   square04_green.gif sasctx.bak : SAS user's context file backup file

   square04_green.gif sasctx: SAS users' context file

circle01_red.gif mrsa_setting : mRSA setting subfolder, including:

   square04_green.gif client.p12 : mRSA user's bundle file. The decryption password is "asdf"

   square04_green.gif mrsacert.pem : mRSA user's certificate

circle01_red.gif ibe_setting : IB-mRSA setting subfolder, including:

   square04_green.gif ibe.p12 : IB-mRSA user's bundle file. The decryption password is "asdf'"

   square04_green.gif orgcert.pem: Certificate for the organization the user belongs to

circle01_red.gif tmp.addr: An example file of the address book for mRSA and IB-mRSA.

 

 

These sample file are for demo usage only. Configure your SUCSES plugin from menu and set the SEM host as sconce.ics.uci.edu. Note that the sample certificates have encoded their email address, which are different from your setting. It could cause your email cannot be processed correctly.

 

NOTE: anipin_blue.gifIn SAS protocol, the state of Client and SEM must be consistent. The sas setting within the examples may not function correctly because other user has already used that.

            anipin_blue.gifThe identity-based mRSA setting in the examples is restricted to domain "usc.edu", which is only for our experiment purpose.  

To try your own setting, either install SEM/CA utilities of your own or contact us for extra help.

  

 

Bug Report

 

Welcome to send bug report or comments to xhding@ics.uci.edu