MailServerList: Difference between revisions

From MozillaWiki
Jump to navigation Jump to search
(Replaced content with 'New mail server info should be entered in the [http://ispdb.mozillamessaging.com ISP DB].')
Line 1: Line 1:
Database: [http://ispdb.mozillamessaging.com ISP DB]
New mail server info should be entered in the [http://ispdb.mozillamessaging.com ISP DB].
 
<b>You must read this page before you edit the list.</b> By editing it, you place your contributions in the public domain (insofar as copyright can apply to collections of facts).
 
The Mail Server List is a public domain list of email providers and the correct configuration for their mail servers. It is designed to enable services which make autoconfiguration of email clients as easy as giving name, email address and password.
 
Please test config information before submitting it. If you go to add a provider and find it's already there, please double-check the information.
 
===Formatting Notes===
 
* Please insert new entries in Unicode code point ('alphabetical') order by Provider Name (Field 1).
* Place a question mark "?" in any field for which you do not know the value. Use "-" to say that there is no value.
* Do include data for major providers which don't offer POP or IMAP (e.g. Hotmail). Clients can then inform the user of this lack of support.
 
===Formatting Notes for Particular Fields===
 
See also the formatting instructions at the head of each column. If you have further questions, email [mailto:gerv@mozilla.org Gerv].
 
* <b>Short Name</b> (Field 4): The common, short name of the email service. If it has no shorter name, leave blank.
* <b>Preferred</b> (Field 5): If the provider offers multiple mail access methods, which one is better. Leave blank if there is no reason to prefer one over the other except for the technical merits of each protocol. If in doubt, leave blank.
* <b>DNS Names</b> (Fields 6, 11, 16) : Include port numbers after server names (separated by a colon) if and only if non-default for (service + encryption type). But do check if port 587 is supported for SMTP and, if so, list it; it’s preferable to 25.
* <b>Encryption</b> (Fields 7, 12, 17): SSL is SSL or TLS on a port specific for SSL (usually 993, 995, 465). STARTTLS is running on the normal, plain port (usually 25, 143, 110) and the server offering to upgrade to a secure connection via "STARTTLS". Note that even when you put "STARTTLS", the client will require a secure connection, to prevent MITM attacks.
* <b>Usernames</b> (Fields 9, 14, 19): "email" for the whole email address, "localpart" for the part of the email address before the "@" (e.g. fred in fred@foo.com), or "prompt (D1234543)" to get the client to prompt, giving the example username "D1234543".
* <b>Enable URL</b> (Fields 10, 15): Some providers do not provide IMAP or POP service by default, but require it to be enabled via a web UI. Paste the URL that a logged-in user would use into this field, and the application can prompt the user to visit it.
* <b>Imap options</b> (Fields 23-27) (see [https://bugzilla.mozilla.org/show_bug.cgi?id=475139 bug 475139]):
** special folders (Fields 23-26): for some imap account, it is necessary to tell Thunderbird what are the names of the special folders, because if it is not done, Thundebird will use and create is own specials folders. So you should défine the following folders if their name are differents from the defaults names:
***Sent : Use to store your sent messages
***Trash : Use to store your deleted messages
***Junk : Use to store your junk messages
***Drafts : Use to store your drafts messages
** Root folder (Field 27): in order to avoid that Thunderbird show folders as sub-folders of the inbox, it is necessary to tell it the name of the imap server directory.
 
=== Gathering data ===
 
Try to get authorative information from the ISP's online tutorials, documentation or similar first (e.g. search "site:example.net Thunderbird" or "POP3" or "Outlook". Only when that fails, use trial and error.
 
==== Secure Auth ====
This is whether the password must be sent in clear or can be encrypted (hashed via MD5).
 
To find out manually, you can contact the server directly and talk the POP/IMAP/SMTP protocol manually. Use <code>netcat -v <i>hostname</i> <i>port</i></code> (preferred) or <code>telnet <i>hostname</i> <i>port</i></code> as "client".
 
* POP3: when you see <code>+OK WEB.DE POP3-Server</code> or similar, enter <code><b>CAPA</b></code>, hit return.
* IMAP: when you see <code>* OK mwinf2j04 IMAP4 server ready</code> or similar, enter <code><b>1 CAPABILITY</b></code>, hit return.
* SMTP: when you see <code>220 mail.gmx.net GMX Mailservices ESMTP</code> or similar, enter <code><b>EHLO example.net</b></code>, hit return.
 
In all cases, if you see <code>CRAM-MD5</code> or <code>DIGEST-MD5</code> or (for POP) <code>APOP</code> in the response, the server should support "secure auth". If you <i>only</i> see <code>AUTH</code> <code>LOGIN</code> and/or <code>PLAIN</code>, the server probably does not support secure auth.
 
==== Test ====
 
Please test the resulting settings if at all possible (although untested data is better than no data). You are probably in the best position to try this, as other project participants won't have accounts with this ISP.
 
===Using the List===
 
* You may use the list for any purpose. Good community members are expected to contribute back any improvements they make to the list.
* Entries in the list may move around; the unique identifiers are the individual mail domains (note: <u>not</u> the whole field contents) in field 2.
* Columns may also move around if we find more data is required. Field numbers are guaranteed not to change. You can find the Field Number row because it is the row identified by "Field Number" in column 1. Use these numbers to recognise the columns.
* The number of header rows may also change. The data starts after the marker DATA_STARTS_BELOW_THIS_LINE.
 
<!--
===Location===
* [http://spreadsheets.google.com/ccc?key=p49SW32nNYX0otkRc3UZUJA The list for editing] (requires google login for google apps access)
* [http://spreadsheets.google.com/pub?key=p49SW32nNYX0otkRc3UZUJA  The list for public viewing]  (no login required)
 
This list is outdated, superceded by ispdb.mozillamessaging.com
 
-->

Revision as of 15:30, 21 July 2010

New mail server info should be entered in the ISP DB.

Retrieved from "https://wiki.mozilla.org/index.php?title=MailServerList&oldid=239909"