Mail Accounts

From PresenceWiki
Revision as of 09:47, 20 August 2015 by Rob (Talk | contribs)

(diff) ←Older revision | view current revision (diff) | Newer revision→ (diff)
Jump to: navigation, search

Mail Account Resource

This type of Resource is used by Mail Scanner Nodes, and includes details on how to connect to a POP3 or IMAP email account in order to download messages.

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.

Mail account creation.png

The Mail Account Resource Editor

When creating a new Mail Account or editing an existing one, you will be presented with the following editor:

Mail account editor.png

Info Tab

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 Settings

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:

Pop ssl settings.png

  • 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").

Test Tab

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.

See Also

Resources > Mail Accounts

FTP Connections | Database Resource | SMTP Servers | POP / IMAP Mail Accounts

Text Template Resources | Message Transporters | LDAP Resource

Task Elements | Resources