Issue Statement

As per the Jira Software 9.2.x release notes, Jira introduced OAuth 2.0 for outgoing mail.

The problem is this:

• there is no public documentation describing how to configure Jira Outgoing Mail with Oauth 2.0: the documentation Configuring an SMTP mail server to send notifications was not updated to explain how to configure SMTP with Oauth 2.0
• in the release note, there is no link to a documentation explaining how to configure Outgoing/SMTP mail with Oauth 2.0

Suggestions

1st Step - Updating the Outgoing Link Documentation

First, we need to update the documentation Configure an outgoing link.

We need to update the scopes row of the table under 3. Provide remaining application details:

• Change 1:
  • Change this:

    For Google, we recommend this scope: https://mail.google.com (for IMAP and POP3)

  • To this:

    For Google, we recommend this scope: https://mail.google.com (for IMAP, POP3 and SMTP)

• Change 2:
  • Change this:

    For Microsoft, we recommend always using the offline_access scope and at least one additional, depending on what protocol you want to use:
    the scopes will vary depending on your Microsoft account type:

    • If you're using non-GCC (Government Community Cloud) accounts, we recommend the following scopes:
      https://outlook.office.com/IMAP.AccessAsUser.All (for IMAP)
      https://outlook.office.com/POP.AccessAsUser.All (for POP3)
      offline_access
    • For GCC accounts, use:
      https://outlook.office365.com/IMAP.AccessAsUser.All (for IMAP)
      https://outlook.office365.com/POP.AccessAsUser.All (for POP3)
      offline_access

  • To this:

    For Microsoft, we recommend always using the offline_access scope and at least one additional, depending on what protocol you want to use:
    the scopes will vary depending on your Microsoft account type and the mail protocol type:

    • If you're using non-GCC (Government Community Cloud) accounts, we recommend the following scopes:
      https://outlook.office.com/IMAP.AccessAsUser.All (for IMAP)
      https://outlook.office.com/POP.AccessAsUser.All (for POP3)
      https://outlook.office.com/SMTP.Send (for SMTP)
      offline_access
    • For GCC accounts, use:
      https://outlook.office365.com/IMAP.AccessAsUser.All (for IMAP)
      https://outlook.office365.com/POP.AccessAsUser.All (for POP3)
      https://outlook.office365.com/SMTP.Send (for SMTP)
      offline_access

2nd Step - Updating the Outgoing Mail Server Documentation

Then, we need to update the documentation Configuring an SMTP mail server to send notifications as explained in the section Configuring an SMTP mail server to send notifications of this hello page.

3rd Step - Updating the Jira 9.2 release notes

Add to the Oauth 2.0 section of the 9.2 release note a link to the page Configuring an SMTP mail server to send notifications, so that customers know how to configure it.