welcome: please sign in

Diff for "MemberManual/Email/Clients"

Differences between revisions 1 and 16 (spanning 15 versions)
⇤ ← Revision 1 as of 2007-11-01 22:23:05 →
Size: 3419
Editor: MichaelOlson
Comment: Initial contents
← Revision 16 as of 2008-04-30 15:10:49 → ⇥
Size: 4766
Editor: AdamChlipala
Comment: deleuze -> mail
Deletions are marked like this. Additions are marked like this.
Line 9: Line 9:
== The easy way == == Using our CA certificate ==

Doing this will get rid of the warning message for all SSL-enabled HCoop websites, as well as mail. It will also get rid of the warning for any HCoop member websites served via HTTPS that have opted to be signed by our CA certificate.

 * Click on [http://hcoop.net/ca/ca.crt] using Safari to download our CA certificate.
 * Double-click the icon of the downloaded root certificate.
 * Choose X509 Anchors from the pop-up menu and click Add.
 * Enter an administrator password and click OK.

== Using just the email certificate ==

If you don't want to install the CA certificate, then it is possible to install just the certificate for mail.

=== The easy way ===
Line 13: Line 26:
== The hard way == === The hard way ===
Line 50: Line 63:
= Sending mail with Emacs = = OLPC =
Line 52: Line 65:
This particular section explains only how to send email using HCoop's mail server with Emacs. Browsing email with most Emacs mail packages is not covered here, and should be less difficult. Please read the ''Sending email'' section of the ["MemberManual/Email"] page before doing what is described here. At the time of this writing, the only way to access email from an [http://laptop.org OLPC laptop] is via [https://mail2.hcoop.net], and there is no easy way to successfully browse that site, due to a bug in the OLPC web browser. Here is how to work around the issue.
Line 54: Line 67:
To send mail through HCoop using Emacs's `smtpmail` you can use the following configuration. Put your authentication information into `~/.authinfo` which is in the netrc(5) format (make sure to supply `port 25` or else `smtpmail` won't read the entry), and ensure that it is readable only by your user. == Prerequisites ==
Line 56: Line 69:
{{{
(setq message-send-mail-function 'smtpmail-send-it
      smtpmail-default-smtp-server "mail.hcoop.net"
      smtpmail-smtp-service 25
      smtpmail-starttls-credentials '(("mail.hcoop.net" 25 nil nil))
      smtpmail-debug-info t ; optional, but handy in case something goes wrong
      smtpmail-auth-supported '(plain))
}}}		  * Another computer with Internet access must be present.
 * The {{{certutil}}} tool must be installed on your other computer. For Debian and Ubuntu, this means installing the {{{libnss3-tools}}} package.
 * You must have either a USB thumb drive or an SD card with card reader.
Line 65: Line 73:
This will work for any mail client that uses `message-mode` for editing and sending mail (e.g. Gnus). == Instructions ==

 * Insert the USB thumb drive or SD card into the OLPC.
 * Bring up the Terminal activity on the OLPC.
 * Figure out where the card or drive has been mounted. This can be done by typing {{{ls /media}}} and looking for a folder of the form {{{XXXX-XXXX}}}. We'll denote this path as '''$DIR'''.
 * {{{
mkdir $DIR/mozilla}}}
 * {{{
cp ~/.sugar/default/gecko/*.db $DIR/mozilla}}}
 * Unmount the drive or card by bringing up the Journal activity, hovering over the icon, and clicking "Unmount".
 * Insert the card or drive into your computer. Figure out where the drive was mounted -- we'll denote this as '''$DRIVE'''.
 * Download [http://hcoop.net/ca/ca.crt].
 * Switch to the directory where you downloaded that file.
 * {{{
certutil -A -n hcoop -t C,C,C -d $DRIVE/mozilla -i ca.crt}}}
 * Unmount the drive or card from your computer. Mount it into the OLPC again.
 * Close any Browse activities that you may have open.
 * Switch to the Terminal activity and run {{{
cp $DIR/mozilla/*.db ~/.sugar/default/gecko/}}}
 * Future instances of the Browse activity will then be able to browse HTTPS hcoop websites.

This page provides examples of how to get various email clients working with our setup.

TableOfContents()

MacOS X

Using our CA certificate

Doing this will get rid of the warning message for all SSL-enabled HCoop websites, as well as mail. It will also get rid of the warning for any HCoop member websites served via HTTPS that have opted to be signed by our CA certificate.

  • Click on [http://hcoop.net/ca/ca.crt] using Safari to download our CA certificate.

  • Double-click the icon of the downloaded root certificate.
  • Choose X509 Anchors from the pop-up menu and click Add.
  • Enter an administrator password and click OK.

Using just the email certificate

If you don't want to install the CA certificate, then it is possible to install just the certificate for mail.

The easy way

In mail.app when the warning about the certificate comes up, drag the certificate icon to a folder. Then drag this into keychain access into the system keychain, or open it with keychain access and specify "system".

The hard way

When using webmail, MacOS X always warns you about the root certificate not found. Mail.app does this as well. The solution for this problem is to do the following: 

openssl s_client -showcerts -connect mail.hcoop.net:443

In that output look for "BEGIN CERTIFICATE" and "END CERTIFICATE". Between those lines there is the certificate. Copy that to a pem file. Then do: 

certtool i hcoopmail.pem k=/System/Library/Keychains/X509Anchors v

It will import this into the X509Anchors keychain, the 'v' is for verbose. It should also say it imported successfully. Now Safari should not warn you about this.

Symbian

Hcoop email can be easily configured on your symbian mobile. This example is N91 specific, but other Symbian 9.1 phones should be very similar. IMAP4 configuration will be good if you like your mails to remain on the server.

  • Go to "Menu | Messaging". From there choose "Options | Settings | E-mail". From there choose "Mailboxes | Options | New mailbox" and hit Start.
  • Choose "IMAP4" for the mailbox type and hit Next.
  • Enter your email address in "My email address" and hit Next.
  • Enter "mail.hcoop.net" as your "Incoming mailserv." and hit Next.
  • Enter "mail.hcoop.net" as your "Outgoing mailserv." and hit Next.
  • Choose an access point that you will mostly use.
  • Give your mailbox a name eg:user_mydomain and hit OK to create the mailbox.

Your mailbox name will appear in the list of mailboxes.

  • Go on and select the mailbox name | "Connection Settings" | "Incoming Email".
  • Enter your username and password and change "Security(ports)" setting to "SSL/TLS" and change "Port" to "993".
  • Go on to configure "Outgoing mail" using the same settings with "Port" as "465".
  • Go back to "Menu | Messaging" and you will see your mailbox appear in the list. Open it and hit "Options | Connect" to read your mail.

OLPC

At the time of this writing, the only way to access email from an [http://laptop.org OLPC laptop] is via [https://mail2.hcoop.net], and there is no easy way to successfully browse that site, due to a bug in the OLPC web browser. Here is how to work around the issue.

Prerequisites

  • Another computer with Internet access must be present.

  • The certutil tool must be installed on your other computer. For Debian and Ubuntu, this means installing the libnss3-tools package.

  • You must have either a USB thumb drive or an SD card with card reader.

Instructions

  • Insert the USB thumb drive or SD card into the OLPC.
  • Bring up the Terminal activity on the OLPC.

  • Figure out where the card or drive has been mounted. This can be done by typing ls /media and looking for a folder of the form XXXX-XXXX. We'll denote this path as $DIR. 

  • mkdir $DIR/mozilla
  • cp ~/.sugar/default/gecko/*.db $DIR/mozilla
  • Unmount the drive or card by bringing up the Journal activity, hovering over the icon, and clicking "Unmount".

  • Insert the card or drive into your computer. Figure out where the drive was mounted -- we'll denote this as $DRIVE.

  • Download [http://hcoop.net/ca/ca.crt].

  • Switch to the directory where you downloaded that file. 
  • certutil -A -n hcoop -t C,C,C -d $DRIVE/mozilla -i ca.crt
  • Unmount the drive or card from your computer. Mount it into the OLPC again.
  • Close any Browse activities that you may have open.

  • Switch to the Terminal activity and run 

    cp $DIR/mozilla/*.db ~/.sugar/default/gecko/
  • Future instances of the Browse activity will then be able to browse HTTPS hcoop websites.

MemberManual/Email/Clients (last edited 2017-01-03 10:06:26 by KevinEverets)