Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
Integration profiles define the API connection details used by generated playbooks. Configure integration profiles before you create or run generated playbooks that call Microsoft or third-party services.
Each integration profile includes connection details such as the base API URL, authentication method, and required credentials.
Prerequisites
Before you begin, make sure that:
- You have access to the Microsoft Defender portal.
- You have the Automation Integration Unified RBAC permission with Read and Write access.
- You have the credentials required for the target API.
- To run automation on third-party data ingested through Log Analytics, you have a Microsoft Sentinel workspace.
Create an integration profile
Sign in to the Microsoft Defender portal.
Go to Microsoft Sentinel > Configuration > Automation.
Select the Integration Profiles tab.
Select Create.
Enter an integration name.
Enter a description.
Enter the base API URL for the service.
Select the authentication method.
Supported authentication methods include:
- OAuth2 Client Credentials
- API Key
- AWS Auth
- User and Password
- Bearer/JWT Authentication
- Hawk
Enter the required authentication details.
Review the integration profile settings.
Select Create.
Create a Microsoft Graph integration profile
Use a Microsoft Graph integration profile when a generated playbook needs to call Microsoft Graph APIs.
In the Azure portal, go to Microsoft Entra ID > App registrations.
Select New registration.
Enter a name for the application.
Complete the app registration.
Copy the Application (client) ID and Directory (tenant) ID.
Go to Certificates & secrets.
Select New client secret.
Copy the client secret value and store it securely.
Important
You can't retrieve the client secret value after leaving the page.
Sign in to the Microsoft Defender portal.
Go to Microsoft Sentinel > Configuration > Automation.
Select the Integration Profiles tab.
Select Create.
Configure the profile with the following values:
Field Value Integration name Enter a descriptive name, such as Graph Integration.Description Enter a short description. Base API URL https://graph.microsoft.comAuthentication method OAuth2 Client ID Enter the Application client ID. Client secret Enter the client secret value. Token endpoint https://login.microsoftonline.com/{TENANT_ID}/oauth2/v2.0/tokenScopes https://graph.microsoft.com/.defaultReplace
{TENANT_ID}with the Directory tenant ID.Select Create.
Edit an integration profile
You can edit the integration name and description after the profile is created.
Sign in to the Microsoft Defender portal.
Go to Microsoft Sentinel > Configuration > Automation.
Select the Integration Profiles tab.
Select the integration profile.
Update the name or description.
Save your changes.
Note
The API URL and authentication method can't be changed after an integration profile is created. To change the API URL or authentication method, create a new integration profile.
Limitations
Integration profiles have the following limitations:
- Microsoft Graph and Azure Resource Manager integrations aren't enabled by default and must be manually created.
- The API URL and authentication method can't be changed after an integration profile is created.
- The maximum number of integrations per tenant is 500.