Connections to Mail Servers

You can create Connections to mail servers that can be used with Email Triggers on Jobs. This connection information is saved in one place and can be referenced in one or more Jobs.

Adding a Connection for EWS

You can create an EWS Connection to be used in Workflow Jobs, PowerShell cmdlets, or Mail Watch Jobs. Before adding an EWS Connection, ensure a credential has been configured within JAMS that contains the Client ID and Client Secret Value, which can be accessed in the Microsoft Azure Portal. This is required for Microsoft Office 365 Modern Authentication. You also need to register JAMS as an application in the Azure Portal.

  1. Click Connection Store from the Shortcuts menu.
  2. Click +.
  3. In the Name field, enter the name, such as EWSConnection.
  4. In the Description field, enter a description.
  5. In the Type of Connection field, select EWS.
  6. Click Ok.
    NOTE: You can also change the Type of Connection on the Properties tab. If you change it, the Property values are maintained if they exist in the new Connection Type.
  7. Click the Properties tab.
  8. In the Address field, enter the address of the EWS server (outlook.office365.com).
  9. In the Port field, enter the incoming port number for the EWS server.
  10. In the Client Credential, select the Credential previously saved within the JAMS Credential Shortcut. This should contain the Client Id and Client Secret Value that are found within the Azure Portal.
  11. In the Tenant Id field, enter your tenant ID that is found within the Azure Portal.
  12. In the Mail Credentials field, select the Credential previously saved within the JAMS Credential Shortcut. This should contain the email address. This will also specify what mailbox to access.
  13. Optional - In the Mail Check Interval field, specify a value for Mail Watch Jobs. The default is 30 seconds.
  14. In the SSL Heading field, select any SSL Setting for the EWS server, if needed.

  15. Click the Security tab.
  16. Review the permissions for this Connection.
    NOTE: Ensure the Submit permission is selected for user accounts that will use this Connection.
  17. Click Save and Close.

Adding a Connection for an IMAP Server

You can create an IMAP connection for monitoring a mailbox for email Triggers. Before adding an IMAP Connection, ensure a Credential has been configured within JAMS that contains the email address and password for the mailbox.

  1. Click Connection Store from the Shortcuts menu.
  2. Click +.
  3. In the Name field, enter the name, such as IMAP Connection.
  4. In the Description field, enter a description.
  5. In the Type of Connection field, select IMAP.
  6. Click Ok.
    NOTE: You can also change the Type of Connection on the Properties tab. If you change it, the Property values are maintained if they exist in the new Connection Type.
  7. Click the Properties tab.
  8. In the Address field, enter the address of the IMAP Server.
  9. In the Port field, enter the incoming port number for the IMAP Server (993).
  10. In the Mail Credentials field, select the Mail Credentials previously saved within the JAMS Credential Shortcut.
  11. In the SSL Heading field, select any SSL Setting for the IMAP Server, if needed.

  12. Click the Security tab.
  13. Review the permissions for this Connection.
    NOTE: Ensure the Submit permission is selected for user accounts that will use this Connection.
  14. Click Save and Close.

Adding a Connection for POP3 Connection

You can create a POP3 Connection for monitoring a mailbox for email Triggers. Before adding a POP3 Connection, ensure a Credential has been configured within JAMS that contains the email address and password for the mailbox.

  1. Click Connection Store from the Shortcuts menu.
  2. Click +.
  3. In the Name field, enter a name for the connection.
  4. In the Type of Connection field, select POP3.
  5. Click Ok.
  6. Click the Properties tab.
  7. In the Address field, enter the address of the POP3 server.
  8. In the Port field, enter 995.
  9. In the SSL Mode field, enter Implicit.
  10. In the Mail Credentials field, select the select the Mail Credentials previously saved within the JAMS Credential Shortcut.

  11. Click Save and Close.

Mail Trigger Connection

The example below shows a JAMS Job that uses a Mail Trigger within JAMS. You can define the Mail Trigger Connection in the Mail Server field. See Triggers for more information.