Connections to Mail Servers

You can create Connections to mail servers that can be used 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 You Begin

• Register your application in the Azure Portal so it can access the Microsoft Graph API.

  • Grant the application the appropriate Microsoft Graph API permissions. In JAMS, Graph API uses the Open Authorization (OAuth) client credentials flow to authenticate in Microsoft Azure.
  • To send emails and execute MailWatch Jobs, ensure the Mail.Read, Mail.ReadWrite, and Mail.Send permissions have been added in the Microsoft Graph API permissions. The Mail.ReadWrite is required for MailWatch Jobs.

• Ensure you have the Tenant ID.

• Create a Credential within JAMS that contains the Client ID and Client Secret Value.

• Create a Credential to specify the email address as the Logon As user.

After you create the Connection Store item, you can use it in several places in JAMS. See Registering and Configuring Graph API.

1. Click Execution from the main menu.
2. Click Connections.
3. Click Add.
4. In the Connection Name field, enter the name, such as GraphAPIConnection.
5. In the Connection Type field, select Graph API.
6. In the Description field, enter a description.
7. Click Save and Continue to Edit.
8. Click the Properties tab.
9. In the Address field, enter the address of the server (graph.microsoft.com).
10. In the Port field, enter the incoming port number for the server (443).
11. 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.
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. In the Tenant Id field, enter the Azure tenant ID.
14. Click Save.

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.

1. Click Execution from the main menu.
2. Click Connections.
3. Click Add.
4. In the Connection Name field, enter the name, such as SMTPConnection.
5. In the Connection Type field, select SMTP.
6. In the Description field, enter a description.
7. Click Save and Continue to Edit.
8. Click the Properties tab.
9. In the Address field, enter the address of the SMTP server.
10. In the Port field, enter the incoming port number for the SMTP server (25).
11. In the Mail Credentials field, select the Credential previously saved within the JAMS Credential Shortcut.
12. In the SSL Heading field, select any SSL Setting for the SMTP server, if needed.
13. Optional - In the FIPS-Only Security field, select or clear the checkbox to use only FIPS-140-2 certified security algorithms.
14. In the SMTP Retry Count field, enter the retry count used to resend SMTP emails if an attempt to send one is unsuccessful.
15. 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.
16. Click Save.

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 Execution from the main menu.
2. Click Connections.
3. Click Add.
4. In the Connection Name field, enter the name, such as EWSConnection.
5. In the Connection Type field, select EWS.
6. In the Description field, enter a description.
7. Click Save and Continue to Edit.
8. Click the Properties tab.
9. In the Address field, enter the address of the EWS server (outlook.office365.com).
10. In the Port field, enter the incoming port number for the EWS server.
11. In the Client Credentials field, select the Credential previously saved within the JAMS Credentials Shortcut. This should contain the Client Id and Client Secret Value that are found within the Azure Portal.
12. In the Tenant Id field, enter your tenant ID that is found within the Azure Portal.
13. 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.
14. Optional - In the Mail Check Interval field, specify a value for Mail Watch Jobs. The default is 30 seconds.
15. In the SSL Heading field, select any SSL Setting for the EWS server, if needed.
16. Click Save.

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 Execution from the main menu.
2. Click Connections.
3. Click Add.
4. In the Connection Name field, enter the name, such as IMAPConnection.
5. In the Connection Type field, select IMAP.
6. In the Description field, enter a description.
7. Click Save and Continue to Edit.
8. Click the Properties tab.
9. In the Address field, enter the address of the IMAP Server.
10. In the Port field, enter the incoming port number for the IMAP Server (993).
11. In the Mail Credentials field, select the Mail Credentials previously saved within the JAMS Credential Shortcut.
12. In the SSL Heading field, select any SSL Setting for the IMAP Server, if needed.
13. Click Save.

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 Execution from the main menu.
2. Click Connections.
3. Click Add.
4. In the Connection Name field, enter the name, such as POP3Connection.
5. In the Connection Type field, select POP3.
6. In the Description field, enter a description.
7. Click Save and Continue to Edit.
8. Click the Properties tab.
9. In the Address field, enter the address of the POP3 server.
10. In the Port field, enter 995.
11. In the SSL Mode field, enter Implicit.
12. In the Mail Credentials field, select the select the Mail Credentials previously saved within the JAMS Credential Shortcut.
13. Click Save.