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 Graph API

Before adding a Graph API 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. You also need to register your application in the Azure Portal so it can access the Microsoft Graph API.

After registering the application in the Azure portal, you must grant it the appropriate Microsoft Graph API permissions. In JAMS, Graph API uses the Open Authorization (OAuth) client credentials flow to authenticate in Microsoft Identity. To send emails, ensure the Mail.Read and Mail.Send permissions have been added in the Microsoft Graph API permissions.

You also need a Credential to specify which mailbox to access.

NOTE: Only the JAMS Desktop Client should be used to configure or modify the Graph API Connection Store item.
  1. Click Connection Store from the Shortcuts menu.
  2. Click +.
  3. In the Name field, enter the name, such as GraphAPIConnection.
  4. In the Description field, enter a description.
  5. In the Type of Connection field, select Graph API.
  6. Click Ok.
  7. Click the Properties tab.
  8. In the Address field, enter the address of the server (graph.microsoft.com).
  9. In the Port field, enter the incoming port number for the server (443).
  10. In the OAuth Client Credentials field, 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 the Azure tenant ID.
  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. Click the Security tab.
  14. Review the permissions for this Connection.
    NOTE: Ensure the Submit permission is selected for user accounts that will use this Connection.
  15. Click Save and Close.

Adding a Connection for SMTP

You can create a connection for SMTP to send and receive email messages with JAMS. You need to create a Credential to save the SMTP username and password for authentication.

NOTE: Only the JAMS Desktop Client should be used to configure or modify the SMTP Connection Store item.
  1. Click Connection Store from the Shortcuts menu.
  2. Click +.
  3. In the Name field, enter the name, such as SMTPConnection.
  4. In the Description field, enter a description.
  5. In the Type of Connection field, select SMTP.
  6. Click Ok.
  7. Click the Properties tab.
  8. In the Address field, enter the address of the SMTP server.
  9. In the Port field, enter the incoming port number for the SMTP server (25).
  10. In the Mail Credentials field, select the Credential previously saved within the JAMS Credential Shortcut.
  11. In the SSL Heading field, select any SSL Setting for the SMTP server, if needed.
  12. Optional - In the FIPS-Only Security field, select or clear the checkbox to use only FIPS-140-2 certified security algorithms.
  13. In the SMTP Retry Count field, enter the retry count used to resend SMTP emails if an attempt to send one is unsuccessful.
  14. In the SMTP Retry Delay field, enter the retry delta time to wait to resend SMTP emails if an attempt to send one is unsuccessful.
  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 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.
  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.