Outgoing Mail Connections

To access the list of Outgoing Mail Connections, go to the Administration configuration tab and choose Outgoing Mail Connections under the OUTGOING MAILS menu item.

Outgoing Mail Connections

Filtering the list

The Outgoing Mail Connection list can be filtered by clicking on the Search button. After clicking, a free text field will be opened, in which the search term can be entered. The filter searches in the Name, Description, Host, and Username fields.

Default Outgoing Mail Connection

One of the Outgoing Mail Connections can be marked as Default. Unless you define to use another Outgoing Mail Connection, the Default Outgoing Mail Connection is used for sending the emails.

You can define the Outgoing Mail Connections to use for different projects, type or issues by creating an Advanced Email Configuration with the proper scope.

Outgoing Mail Connections dialog - generic settings

1. Name - enter the preferred name to identify the connection

2. Description (optional) - short description to help identify the connection

3. From Address - email address that will show as the "From address" when using this connection. This can be the same as the Username, but it can also be a shared address that the user you authorize the connection with has access to. To use an email address as the From address, you need to have the proper permissions on the mail server side.

4. Reply-to Address (optional) - specify a different email address where replies are sent when someone responds to an email sent from this connection.

5. From Name Prefix (optional) - a prefix to appear in front of the From name in the receiving mail clients.

6. Timeout - Timeout for connection attempts to the mail server in milliseconds, valid values: 1-60000 msec.

Connection Mode - specific settings

Email This Issue supports login and OAuth authentication mechanisms for Outgoing Mail Connections. You can select it by selecting the correct protocol.

• SMTP: log in with username and password; this can be used for custom mail server connections. For detailed steps, go to Custom Mail Server: Basic Authentication.

• Google OAuth2: OAuth for Gmail/Gsuite

• Microsoft 365 SMTP (w/ OAuth2): OAuth for Microsoft account using SMTP protocol

• Microsoft 365 Graph API (w/ OAuth2): OAuth for Microsoft account using Graph API

Google OAuth2 connection

1. Create the OAuth2 credentials: Gmail with OAuth2

2. Select the Client Credentials you created on the credentials page.

3. Enter the user name of the Outgoing Mail Connection you want to use.

4. Click on the "Authorize" button to grant access to Email This Issue to send emails from your account.

5. In the dialog, select the account that belongs to the email address you use for login: Note: If you have multiple Google accounts, select the one with the email that matches the username in the Outgoing Mail Connection dialog. Emails will be sent from that account.

6. If you get the following warning, do the following:

   1. Click Advanced.

   2. Click the "Go to meta-inf.hu (unsafe)" link.

   3. Confirm your choice by clicking Allow.

Result: You can send emails in Email This Issue from Gsuite with OAuth Authentication.

If you want to revoke the access from Email This Issue to your Gmail account, you can do it by visiting Account Settings.

Microsoft Connections

Microsoft SMTP with OAuth 2.0

1. Set up the OAuth2 credentials: Microsoft IMAP and SMTP with OAuth2

2. Enter the Username you would like to authenticate with.

3. Click Authorize

4. You will be redirected to the Microsoft login page, where you will be logged in automatically if you have SSO enabled. If the Username is not the same as the one you have an active session with, you will need to log in to Microsoft with the username before Authorizing - this way, you should be able to choose the correct account to complete the Authorization process with.

Microsoft Graph with OAuth2

1. Set up the OAuth2 credentials: Microsoft Graph API with OAuth2. You will be able to choose between application access or delegated access.

   1. Delegated access (OAuth2 credentials were created with Auth Code Grant type)

      1. Enter the Username you would like to authenticate with.

      2. Click Authorize

      3. You will be redirected to the Microsoft login page, where you will be logged in automatically if you have SSO enabled. If the Username is not the same as the one you have an active session with, you will need to log in to Microsoft with the username before Authorizing - this way you should be able to choose the correct account to complete the Authorization process with.

   2. Application access (OAuth2 credentials were created with Client Credentials Grant type)

      1. Fill out the Username field, as it is a requirement for the connection health check.

      2. The Authorization will be checked automatically after you select the credentials; no login is necessary.

         

Microsoft OAuth 2.0 host settings

For OAuth2-based Microsoft365 SMTP connections, the hostname "smtp.office365.com" is used by default, when connecting to the mail server. However, in certain scenarios, the use of a custom hostname might be required. In such cases, there is a possibility to override the default value by enabling the respective "Override default host setting" toggle and selecting the desired host from the "Host" dropdown appearing below.

The dropdown contains a pre-defined set of hostnames, which are globally available. If you have even more specific needs, please contact our support team.

Testing Outgoing Mail Connection

While adding or editing an Outgoing Mail Connection, test if the connection details are correct.

Sending a test email

To check whether the Outgoing Mail Connection is capable of sending out emails to a certain email address, use the Send Test Email function. You can access the Send Test Email dialog by clicking the three dots next to an Outgoing Mail Connection.