Table of Contents
[ 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.
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.
-
[ http://shareware.unc.edu/software.html ] Download KClient for Windows - All
-
[ http://shareware.unc.edu/pub/win/krb.con ] Download krb.con file configured for Isis
-
Download the KClient software from the link above.
-
Once it is downloaded, the file to run the KClient installer.
-
Once the installation has completed, you may be asked to reboot. Say yes to the reboot.
-
Once your computer has rebooted, copy the
krb.confile you downloaded into yourc:\windowsdirectory. The installation program puts a defaultkrb.confile in this directory, but you should replace it with the one you downloaded. -
You should see a key icon with a red X on it in the Windows system tray in the bottom right of the screen. once on this icon and choose from the menu that pops up. In the Time Server box you should type
clock1.unc.eduorclock2.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.
-
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 under the 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 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. -
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 . 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.
-
One last Important Note
Be sure to "Destroy" your authentication tickets by 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.
For more information on Kerberos and its use of tickets, check out the following websites:
-
[ http://web.mit.edu/kerberos/ ] Kerberos: The Network Authentication Protocol
-
[ http://www.faqs.org/faqs/kerberos-faq/general/ ] Kerberos FAQ, v2.0


