Mail Account Resource
Creating a Mail Account Resource
Make sure you are have selected the "Mail Account Resource" item in the resources explorer, the right-click in the category that you wish to create the resource in and select "Create New > Mail Account Resource" from the pop-up menu.
The Mail Account Resource Editor
When creating a new Mail Account or editing an existing one, you will be presented with the following editor:
This is where you can specify the server, account and connection details:
- Name : A short user-friendly description - e.g. "Bob's Inbox"
- IMAP Folder : If IMAP is selected (see below) this allows the user to select a specific folder (e.g. "Inbox").
- POP vs IMAP : These are two different types of mail retrieval protocol. Most mail servers support POP3 (Post Office Protocol) and many also support IMAP (Internet Message Access Protocol). See this GMail article for an interesting discussion on the merits of IMAP.
- Mail Account Name : Usually this is the first part (before the @ sign) of the email address of the account to be monitored
- Password : This is the Password associated with the account.
- Server host : This should be the Hostname or IP Address of the Mail server.
- Server Port : The port that the server listens on for connections - typically this is 110 for POP3 or 143 for IMAP. If using SSL (see below) this will be either 995 (for POP) or 993 (for IMAP) - consult your mail server administrator if you are not sure.
- SSL : SSL (Secure Socket Layer) allows you to communicate with the mail server using SSL encryption.
SSL typically requires a local certificate which authenticates your computer and contains encryption key information. This is usually stored in a key store (a local file which securely stores certificates and keys).
Clicking the button labelled "SSL" will bring up the SSL Settings Dialog:
- Disable Certificate Checks : Some Mail Servers will allow you to connect securely via SSL without a certificate. Check this checkbox if you wish to attempt via SSL without a local certificate.
- Enable Certificate Checks : Allows you to specify the location of the keystore that contains your SSL certificate.
- Download Certificate To: : The "Download" button connects to your mail server using the details specified in the Info Tab and downloads a certificate for this account, adding it to the keystore specified in the "Path" text field. Progress is outputted to the text area below (labelled "Show results of querying the mail account").
This provides the user with the ability to test connecting to the mail server. Click the "Test" button to view progress in the text area below.
Resources > Mail Accounts
|FTP Connections | Database Resource | SMTP Servers | POP / IMAP Mail Accounts|