$Id: imapssl-macosx.txt,v 1.4 2001/06/01 00:01:06 jdlarios Exp $

OS X users should read my other page about securing non-ssl email clients at
http://staff.washington.edu/jdlarios/imapssl-with-nonssl-clients.txt
if they want to know what's going on under the hood, so to speak. Steps 5 and 6
of that document are particularly important, as they apply to MacOS X users as
well. 

These instructions are step-by-step, but don't include much explanation. Read 
all the instructions before starting, though.

0. Make sure you have installed the Developer Tools from the grey cd which
   came with OS X.

1. Log in as the user you created when you installed OS X. This may just mean
   booting into OS X.

2. Launch the "Terminal" application.

3. Make a temporary directory and go into it, like so:

mkdir tmp
cd tmp

4. Download my OS X imap-ssl script, like so:

wget http://staff.washington.edu/jdlarios/macosx-ssl-script.txt

5. Run the script:

sh ./macosx-ssl-script.txt


5a.For the adventurous or super-impatient, steps 4 and 5 can be combined, by
   running the following command:

wget -O - http://staff.washington.edu/jdlarios/macosx-ssl-script.txt | /bin/sh

   I don't really recommend that you do that, though.


6. After the script has finished, configure your Mail app's preferences.
   Launch the Mail application. Go to the "Mail" menu, and pull it down to
   "Preferences...". In the Mail Preferences window, click on "Accounts".
   Click on your current deksmail account, and then click "Edit". In the
   "Account Information" tab, change the "Host name:" entry from your deskmail
   server to "localhost". Click on the "Account Options" tab. Change the
   "Connect to server using port:" field from 143 to whatever port you've 
   chosen to put the imap-ssl proxy on. In my example, I used 8888. If you're
   running the proxy from my example, use 8888. Click "Ok". Close the 
   preferences window by clicking on the red button in the upper left.


   Your OS X Mail application should now be able to talk to the UW's SSL
   IMAP servers, and you will be able to get your mail in the new secure
   environment.

7. Read steps 5 and 6 of the document at
   http://staff.washington.edu/jdlarios/imapssl-with-nonssl-clients.txt

8. Here's how you use the proxy once you've installed it:

   Boot the computer (or log in).
   Launch the "Terminal" application.
   In the terminal, type the following line (with your own NetID):

/usr/local/bin/imapssl-proxy 8888 yournetid.deskmail.washington.edu

   Launch the Mail application. You should now be able to connect to
   your deskmail server through port 8888 of "localhost". When you're
   done, quit the mail application.

   Type control-c in the terminal window you ran the imapssl-proxy command in.

9. If you have any questions, send me mail: jdlarios@cac.washington.edu
   This software is not supported by Computing and Communications, and if
   you write to help@cac.washington.edu with questions about it, they'll 
   probably be annoyed.