Configure an OAuth profile to use certificates for authentication with Microsoft Azure

  • Release version: Yokohama
  • Updated January 30, 2025
  • 1 minute to read

    • Configure an OAuth application profile to authenticate using certificates.

    Before you begin

    Create an Microsoft Azure account to configure OAuth profile.

    Complete the set up steps using your Microsoft Azure Developer account. See the Microsoft Azure product documentation for instructions on creating and configuring custom applications.

    Role required: admin and Microsoft Azure portal administrator

    Procedure

    1. Log in to the Microsoft Azure registration profile with your organization credentials.
      For more information, see the Microsoft Azure registration portal documentation.
    2. Register a new custom application by filling in the application name, supported account type, and redirect URL, and then select Register.
      Note:
      Enter the redirect URL in the following format: https://<instance>/oauth_redirect.do.
      An overview of the application's basic information is displayed.
    3. Copy the client ID to a text file.
      You will use this ID and the secret value generated in the next steps to register the app as a third-party OAuth provider on your ServiceNow instance. You use the application ID as the client ID when you connect the application to ServiceNow.
    4. Enable the Mail.ReadWrite permission.
      1. In Microsoft Azure, navigate to Manage > API permissions.
      2. Select Add a permission.
      3. Click the Microsoft Graph tile.
      4. Select Application Permissions.
      5. In the Select permissions field, enter Mail.ReadWrite.
      6. Select the Mail.ReadWrite check box.
      7. Select Add permissions.
    5. Select Grant admin consent for <your organization name>.
    6. Select Yes to confirm.
    7. Upload the certificate
      1. In Microsoft Azure, navigate to Manage > Certificates & secrets.
      2. Select upload certificate.
      3. Provide a description, a start date, and an expiration date and upload the certificate.
    8. Copy the client ID and directory ID to a text file.
    9. Navigate to Overview > Endpoints and copy the OAuth 2.0 token endpoint (v2) to a text file.

    What to do next

    Configure a JWT provider