Configure an OAuth profile to use certificates for authentication with Microsoft Azure
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
-
Log in to the Microsoft Azure registration profile with your organization credentials.
For more information, see the Microsoft Azure registration portal documentation.
-
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.
-
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.
-
Enable the Mail.ReadWrite permission.
-
In Microsoft Azure, navigate to Manage > API permissions.
-
Select Add a permission.
-
Click the Microsoft Graph tile.
-
Select Application Permissions.
-
In the Select permissions field, enter
Mail.ReadWrite. -
Select the Mail.ReadWrite check box.
-
Select Add permissions.
-
-
Select Grant admin consent for <your organization name>.
-
Select Yes to confirm.
-
Upload the certificate
-
In Microsoft Azure, navigate to Manage > Certificates & secrets.
-
Select upload certificate.
-
Provide a description, a start date, and an expiration date and upload the certificate.
-
-
Copy the client ID and directory ID to a text file.
-
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
Configure a JWT provider on the ServiceNow AI Platform to configure an OAuth application profile to authenticate using certificates. - Generate a SHA-1 thumbprint
Generate a SHA-1 thumbprint using the JWT provider's sys_id and JKS certificate's sys_id and certificate's alias to be added to the GraphCertificateOAuthTemplate script. - Create an OAuth API script
Create and duplicate an OAuth API script for application registry.
Parent Topic:Reading email using Microsoft Graph
Related topics
Configure an OAuth profile to use a client ID and secret for token generation
---
title: Configure an OAuth profile to use certificates for authentication with Microsoft Azure
description: Configure an OAuth application profile to authenticate using certificates.
locale: en-US
canonical_url: https://www.servicenow.com/docs/r/australia/platform-administration/configure-oauth-profile-using-certificates.html
release: australia
topic_type: task
last_updated: "2026-09-10"
reading_time_minutes: 2
breadcrumb: [Read email using Microsoft Graph, Read or send emails using Microsoft Graph, Advanced email setup, Configure, Email Administration, Notifications, Configure core features, Administer the ServiceNow AI Platform]
---
# Configure an OAuth profile to use certificates for authentication with Microsoft Azure
Configure an OAuth application profile to authenticate using certificates.
## Before you begin
Create an [Microsoft Azure](https://portal.azure.com) account to configure OAuth profile.
Complete the set up steps using your Microsoft Azure Developer account. See the [Microsoft Azure product documentation](https://docs.microsoft.com/en-us/azure/) 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](https://portal.azure.com/#blade/Microsoft_AAD_RegisteredApps/ApplicationsListBlade).
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](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/platform-administration/configure-jwt-provider.md)
- **[Configure a JWT provider](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/platform-administration/configure-jwt-provider.md)**
Configure a JWT provider on the ServiceNow AI Platform to configure an OAuth application profile to authenticate using certificates.
- **[Generate a SHA-1 thumbprint](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/platform-administration/generate-thumbprint.md)**
Generate a SHA-1 thumbprint using the JWT provider's sys\_id and JKS certificate's sys\_id and certificate's alias to be added to the GraphCertificateOAuthTemplate script.
- **[Create an OAuth API script](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/platform-administration/oauth-api-script.md)**
Create and duplicate an OAuth API script for application registry.
**Parent Topic:**[Reading email using Microsoft Graph](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/platform-administration/read-email-using-ms-graph.md)
**Related topics**
[Configure an OAuth profile to use a client ID and secret for token generation]()
[Create an email account for Microsoft Graph \(receive\)]()
| title | Configure an OAuth profile to use certificates for authentication with Microsoft Azure |
| description | Configure an OAuth application profile to authenticate using certificates. |
| locale | en-US |
| canonical_url | https://www.servicenow.com/docs/r/australia/platform-administration/configure-oauth-profile-using-certificates.html |
| release | australia |
| topic_type | task |
| last_updated | 2026-09-10 |
| reading_time_minutes | 2 |
| breadcrumb | Read email using Microsoft GraphRead or send emails using Microsoft GraphAdvanced email setupConfigureEmail AdministrationNotificationsConfigure core featuresAdminister the ServiceNow AI Platform |