Configuring Mulberry for Kerberos Authentication


 Introduction

[ http://help.unc.edu/?id=63 ] Mulberry is an IMAP email client available for use with UNC email. Kerberos is a network authentication protocol that can be used with email for additional security. This protocol uses strong cryptography so that a client can prove its identity to a server (and vice versa) across an insecure network connection. For more information on Kerberos, see the "Additional Information" section below.

The following instructions are for downloading and installing the necessary software to set up Mulberry (version 1.4 or later) to use Kerberos authentication on a Windows 95/98/NT machine.

 Downloads

In order to set up Mulberry for Kerberos Authentication, you will need to download the CMU KClient software (see links below) and install it on your computer. Windows users will also want to download a preconfigured krb.con file to save some setup time.

 Installation Instructions

  1. Download the KClient software from the link above.

  2. Once it is downloaded, double-click the file to run the KClient installer.

  3. Once the installation has completed, you may be asked to reboot. Say yes to the reboot.

  4. Once your computer has rebooted, copy the krb.con file you downloaded into your c:\windows directory. The installation program puts a default krb.con file in this directory, but you should replace it with the one you downloaded.

  5. You should see a key icon with a red X on it in the Windows system tray in the bottom right of the screen. Right-click once on this icon and choose Options from the menu that pops up. In the Time Server box you should type clock1.unc.edu or clock2.unc.edu .

    The remaining options are dependent on how you want to set them up. The "Synchronize clock with time server on startup" and "Destroy tickets when kstatus exits" options are recommended. Kerberos authentication requires that the client machine's time deviate no more than five minutes from that of the Kerberos database server. If you already synchronize your time with one of the UNC clock servers, you should be okay.

  6. After you have finished setting up KClient, you must make an adjustment to the Mulberry preferences. Open Mulberry (remember you must be using at least version 1.4). If prompted to log in, do so, since Mulberry will sometimes quit the application if you hit cancel. Choose Preferences under the File menu. Once the preferences are open, click the radio button on the right labeled Advanced to open the advanced preferences. Next, choose the Accountstab; make sure the account chosen is your IMAP server (by default is is called "imap"), and find the section with the Authenticate tab.

    On the Authenticate tab, you will see a "Method of authentication". By default it is "Plain Text". Click the menu to choose Kerberos V4 as the authentication method. After you make this selection, the section below the menu will change. Make sure the Use Default Server Principal box is not checked. In the Server Principal box, enter imap.mailserv0@ISIS.UNC.EDU .

  7. Once you have made those changes, you are finished setting up Mulberry for Kerberos 4 authentication. You should exit Mulberry and restart it. After restart, you should see a User ID/Password box with a key on it. This is the KClient application prompting for authentication information. Use your Isis login and password and click OK. Mulberry should open normally. You will know for sure that you authenticated properly if the key in the system tray is not marked with a red X.

  8. One last Important Note

    Be sure to "Destroy" your authentication tickets by right-clicking on the key in the system tray and choosing "Destroy Tickets." If you don't, someone could potentially go to the machine you were on and open Mulberry and wouldn't be prompted to log in. Your authentication tickets would still be valid (until they expire), and another user could view your email.

 Additional Information

For more information on Kerberos and its use of tickets, check out the following websites:

Copyright 2002-2007 The University of North Carolina at Chapel Hill.

Creative Commons License
This work is licensed under a Creative Commons Attribution 3.0 United States License.

Post a Comment

This form is for document feedback. If you need technical assistance, and are affiliated with UNC-Chapel Hill, please Submit a Help Request
Optional
Optional
So that we may contact you.
Do not fill out this form, this is a spam trap.
Top
University of North Carolina - Chapel Hill