In this article, you will learn how to integrate Microsoft 365 and Microsoft Defender for Cloud Apps, formerly Microsoft Cloud Access Security (MCAS), with SecurityCoach. Once you set up this integration, data provided by Microsoft will be available under the SecurityCoach tab of your KSAT console. This data can be viewed in SecurityCoach reports and used to create detection rules for real-time coaching campaigns.
For general information about SecurityCoach, see our SecurityCoach Product Manual. If you would like to learn how to integrate other Microsoft products with SecurityCoach, see the vendor integration guides in our Knowledge Base.
Set Up the Integration in Your Microsoft Azure Portal
Before you can set up the SecurityCoach integration in your KSAT console, you will need to register the SecurityCoach application, add API permissions, and create a client secret in your Microsoft Azure portal.
To jump to the article subsection for each of these steps, click the links below:
Register the SecurityCoach Application
First, you will need to register the SecurityCoach application in your Microsoft Azure portal. To register the application, follow the steps below:
- Log in to your Microsoft Azure portal and navigate to your Microsoft Entra ID.
- From the sidebar on the left side of the page, select App registrations.
- Click + New registration and enter a name for your application, such as “SecurityCoachAPIAccess”.
- Click Register.
Add API Permissions
After you have registered the SecurityCoach application, you can add API permissions. To add API permissions, follow the steps below:
- Log in to your Microsoft Azure portal and navigate to your Microsoft Entra ID.
- From the sidebar on the left side of the page, select App registrations.
- Select the registered application you created for Microsoft 365 or MCAS in the Register the SecurityCoach Application section of this guide. In the example below, the registered application is titled “MS-Alert”.
- From the sidebar on the left side of the page, select API permissions.
-
Click + Add a permission.
-
Select Microsoft Graph from the Microsoft APIs subtab.
-
Click Application permissions.
-
Click the SecurityEvents drop-down menu and select the check box next to SecurityEvents.Read.All.
-
Click Add permissions.
-
Click Grant admin consent for [your active directory name]. Once permission is granted, the triangle symbol on the right side of the page will change to a green check mark.
Create a Client Secret
After you have registered the SecurityCoach application and added API permissions, you can create a client secret. To create a client secret, follow the steps below:
- Log in to your Microsoft Azure portal and navigate to your Microsoft Entra ID.
- From the sidebar on the left side of the page, select App registrations and click on the registered application you added permissions to in the Add API Permissions section of this article. When you click on the registered application, the application’s overview page will display.
- From the sidebar on the left side of the page, select Certificates & secrets.
- Click + New client secret.
- Enter a description for the client secret and select an expiry window.
- Click Add. Once you click Add, the client secret Value and Expires date will display.
- Copy and save the client secret Value and the Expires date somewhere that you can easily access. You will need these credentials to complete the integration setup in the Set Up the Integration in Your KSAT Console section below.
Set Up the Integration in Your KSAT Console
Once you've set up the integration in your Microsoft Azure portal, you can set up the integration in your KSAT console.
To set up the integration in your KSAT console, follow the steps below:
- Log in to your KSAT console and navigate to SecurityCoach > Setup.
- In the Available Integrations section, locate the card for the Microsoft application you want to set up.
-
At the bottom of the card, click Configure.
- In a separate browser window, log in to your Microsoft Azure portal and navigate to your Microsoft Entra ID.
- From the Overview page, scroll down to the Tenant information section. Then, copy the Primary domain.
- Navigate back to your KSAT console. In the Primary Domain field, paste your Primary domain.
- To get your Application (Client) ID, navigate to your Microsoft Azure portal. Select App registrations and click on the registered application you created for Microsoft 365 or MCAS in the Register the SecurityCoach Application section of this article.
- On the application’s overview page, copy the Application (client) ID in the Essentials section at the top of the page.
- Navigate back to your KSAT console. In the Application (Client) ID field, paste your Application (client) ID.
- In the Client Secret Value field, enter the Value from the client secret that you created in the Create a Client Secret section above.
- In the Token Expiration Date field, select the Expires date for the client secret that you created in the Create a Client Secret section above.
- To finish setting up the integration, click Connect.
Once you’ve successfully authorized this integration, you can manage detection rules for Microsoft 365 or MCAS on the Detection Rules subtab of SecurityCoach. For a full list of available system detection rules for this vendor, see our Which Detection Rules Can I Use with My Vendors? article.