Set up Microsoft Exchange Online spoke

Integrate the ServiceNow instance and Microsoft Exchange Online account by creating a custom OAuth application in Microsoft Exchange Online to authenticate ServiceNow requests.

Before you begin

  • Request an Integration Hub subscription.
  • Activate the Microsoft Exchange Online spoke.
  • Role required: admin.

Register an application using the Microsoft Azure portal

Provide authorization to the ServiceNow instance by registering an application with Azure AD.

Before you begin

Role required: Azure Active Directory admin

About this task

Complete these steps from the Microsoft Azure portal. For instructions on registering an application, see the Microsoft Azure documentation.

Procedure

  1. In the Microsoft Azure portal, add the Redirect URIs in this format: https://<instance-name>.service-now.com/oauth_redirect.do
  2. For the Required Permissions, select Microsoft Graph.
    Permissions required for Microsoft Exchange Online spoke
  3. Record the Client Secret for use in later configurations.

Result

The ServiceNow application is created with Microsoft Azure AD.

Register Microsoft Exchange Online as the OAuth provider

Register Microsoft Exchange Online as the OAuth provider so that the ServiceNow instance can request OAuth 2.0 tokens.

Before you begin

Role required: admin

About this task

Use the information generated during the registration of the application in the Microsoft Azure portal.

Procedure

  1. Navigate to All > System OAuth > Application Registry.
  2. Open the record, Microsoft Exchange Online.
  3. On the form, fill in the fields.
  4. Right-click the form header, and click Save.
    A system-generated OAuth entity profile is created and displayed in the OAuth Entity Profiles related list. For example, Microsoft Exchange Online default_profile.
  5. Navigate to System OAuth > Application Registry.
  6. Open the record, Microsoft Exchange Online_clientCredentials.
  7. On the form, fill in the fields.
  8. Right-click the form header, and click Save.
    A system-generated OAuth entity profile is created and displayed in the OAuth Entity Profiles related list. For example, Microsoft Exchange Online_clientCredentials default_profile.

Create credential records for the Microsoft Exchange Online spoke

Authorize the Microsoft Exchange Online spoke actions by creating credential records for the application registered in the Microsoft Azure portal. The Microsoft Exchange Online connection and credential alias uses these credentials to authorize actions.

Before you begin

Role required: admin.

Procedure

  1. Navigate to All > Connections & Credentials > Credentials.
  2. Click New.
    The system displays the message, What type of Credentials would you like to create?
  3. Select OAuth 2.0 Credentials.
  4. On the form, fill in the fields.
  5. Right-click the form header and click Save.
  6. To generate the OAuth token, click the Get OAuth Token related link.
  7. Navigate to Connections & Credentials > Credentials.
  8. Click New.
    The system displays the message, What type of Credentials would you like to create?
  9. Select OAuth 2.0 Credentials.
  10. On the form, fill in the fields.
  11. Right-click the form header and click Save.
  12. To generate the OAuth token, click the Get OAuth Token related link.

Result

The credential records for the Microsoft Exchange Online spoke are created.

Create a credential record for the Microsoft Exchange Online spoke Mailbox actions

Create a credential record for the Microsoft Exchange Online spoke Mailbox actions. The Microsoft Exchange Online spoke connection and credential alias uses these credentials to authorize Mailbox actions.

Before you begin

  • Make sure that MID Server is setup and configured
  • Make sure that Power Shell with EXO V2 module is installed. This module is required for executing Mailbox management actions.
  • Role required: admin

Procedure

  1. Navigate to All > Connections & Credentials > Credentials.
  2. Click New.

    The system displays this message: What type of Credentials would you like to create?

  3. Select Windows Credentials.
  4. On the form, fill in the fields.
  5. Right-click the form header and click Submit.

Result

A Windows Credential record is created for the Microsoft Exchange Online spoke Mailbox actions.

Create connection records for the Microsoft Exchange Online spoke

Perform actions in Microsoft Exchange Online by creating connection records for your Microsoft Exchange Online account. The Microsoft Exchange Online spoke connection and credential alias uses these connections to perform actions.

Before you begin

Role required: admin.

Procedure

  1. Navigate to All > Connections & Credentials > Connection & Credential Aliases.
  2. Open the record, Microsoft_Exchange_Online.
  3. In the Connections related list, click New.
  4. On the form, fill in the fields.
  5. Click Update.
  6. Navigate to Connections & Credentials > Connection & Credential Aliases.
  7. Open the record, Microsoft_Exchange_Online_clientCred.
  8. In the Connections related list, click New.
  9. On the form, fill in the fields.
  10. Click Update.

Result

The Microsoft Exchange Online spoke is set up and integrated with the ServiceNow instance.

Create a connection record for the Microsoft Exchange Online spoke Mailbox actions

Create a connection record for your Microsoft Exchange Online spoke Mailbox actions. The Microsoft Exchange Online spoke connection and credential aliases use these connections to perform only Mailbox actions.

Before you begin

  • Make sure that MID Server is setup and configured
  • Make sure that Power Shell with EXO V2 module is installed. This module is required for executing Mailbox management actions.
  • Role required: admin

Procedure

  1. Navigate to All > Connections & Credentials > Connections & Credentials Aliases.
  2. Open the Microsoft Exchange Online MID record.
  3. From the Connections tab, click New.
  4. On the form, fill these fields.
  5. Click Submit.

Result

A connection record is created for Microsoft Exchange Online spoke Mailbox actions.