Onboard non-Microsoft IdP catalog apps for Conditional Access app control
Access and session controls in Microsoft Defender for Cloud apps work with both catalog and custom apps. While Microsoft Entra ID apps are automatically onboarded to use Conditional Access app control, if you're working with a non-Microsoft IdP, you'll need to onboard your app manually.
This article describes how to configure your IdP to work with Defender for Cloud Apps. Integrating your IdP with Defender for Cloud Apps automatically onboards all catalog apps from your IdP for Conditional Access app control.
Prerequisites
Your organization must have the following licenses to use conditional access app control:
- The license required by your identity provider (IdP) solution
- Microsoft Defender for Cloud Apps
Apps must be configured with single sign-on
Apps must be configured with the SAML 2.0 authentication protocol.
Fully performing and testing the procedures in this article requires that you have a session or access policy configured. For more information, see:
- Create Microsoft Defender for Cloud Apps access policies
- Create Microsoft Defender for Cloud Apps session policies
Configure your IdP to work with Defender for Cloud Apps
This procedure describes how to route app sessions from other IdP solutions to Defender for Cloud Apps.
Tip
The following articles provide detailed examples of this procedure:
To configure your IdP to work with Defender for Cloud Apps:
In Microsoft Defender XDR, select Settings > Cloud Apps > Connected Apps > Conditional Access App Control apps.
In the Conditional Access App Control apps page, select + Add.
In the Add a SAML application with your identity provider dialog, select the Search for an app drop down and then select the app you want to deploy. With your app selected, select Start wizard.
On the wizard's APP INFORMATION page, either upload a metadata file from your app or enter app data manually.
Make sure to provide the following information:
- The Assertion consumer service URL. This is the URL that your app uses to receive SAML assertions from your IdP.
- A SAML certificate, if your app provides one. In such cases, select the Use ... SAML certificate option, and then upload the certificate file.
When you're finished, select Next to continue.
On the wizard's IDENTITY PROVIDER page, follow the instructions to set up a new custom app in your IdP's portal.
Note
The steps required may differ, depending on your IdP. We recommend that you perform the external configuration as described for the following reasons:
- Some identity providers do not allow you to change the SAML attributes or URL properties of a gallery / catalog app.
- When you configure a custom app, you can test the app with Defender for Cloud Apps access and session controls, without changing your organization's existing configured behavior.
Copy your app's single sign-on configuration information for use later in this procedure. When you're finished, select Next to continue.
Continuing on the IDENTITY PROVIDER page of the wizard, either upload a metadata file from your IdP or enter app data manually.
Make sure to provide the following information:
- The Single sign-on service URL. This is the URL that your IdP uses to receive single sign-on requests.
- A SAML certificate, if your IdP provides one. In such cases, select the Use identity provider's SAML certificate option, and then upload the certificate file.
Continuing on the IDENTITY PROVIDER page of the wizard, copy both the single sign-on URL and all attributes and values for use later in this procedure.
When you're done, select Next to continue.
Browse to your IdP's portal and enter the values you'd copied to your IdP configuration. Typically, these settings are found in your IdP's custom app settings area.
Enter your app's single sign-on URL that you'd copied from the previous step. Some providers may refer to the single sign-on URL as the Reply URL.
Add the attributes and values you'd copied from the previous step to the app's properties. Some providers may refer to them as User attributes or Claims.
If your attributes are limited to 1024 characters for new apps, first create the app without the relevant attributes, and add them in afterwards by editing the app.
Verify that your name identifier is in the format of an email address.
Make sure to save your settings when you're done.
Back in Defender for Cloud Apps, on the wizard's APP CHANGES page, copy the SAML single sign-on URL and download the Microsoft Defender for Cloud Apps SAML certificate. The SAML single sign-on URL is a customized URL for your app when used with Defender for Cloud Apps Conditional Access app control.
Browse to your app's portal and configure your single-sign on settings as follows:
- (Recommended) Create a back up of your current settings.
- Replace the identity provider sign-in URL field value with the Defender for Cloud Apps SAML single sign-on URL you copied from the previous step. The specific name for this field may differ, depending on your app.
- Upload the Defender for Cloud Apps SAML certificate you downloaded in the previous step.
- Make sure to save your changes.
In the wizard, select Finish to complete the configuration.
After saving your app's single-sign on settings with the values customized by Defender for Cloud Apps, all associated sign-in requests to the app are routed though Defender for Cloud Apps and Conditional Access app control.
Note
The Defender for Cloud Apps SAML certificate is valid for 1 year. After it expires, you'll need to generate and upload a new one.
Sign in to your app using a user scoped to the policy
After you've created your access or session policy, sign in to each app configured in the policy. Make sure that you've first signed out of all existing sessions, and that you sign in with a user configured in the policy.
Defender for Cloud Apps will sync your policy details to its servers for each new app you sign in to. This may take up to one minute.
For more information, see:
- Create Microsoft Defender for Cloud Apps access policies
- Create Microsoft Defender for Cloud Apps session policies
Verify that apps are configured to use access and session controls
This procedure describes how to verify that your apps are configured to use access and session controls in Defender for Cloud Apps and configure those settings if needed.
Note
While you can't remove session control settings for an app, no behavior is changed until you have a session or access policy configured for the app.
In Microsoft Defender XDR, select Settings > Cloud Apps > Connected apps > Conditional Access App Control apps.
In the apps table, search for your app and check the IDP type column value. Make sure that Non-MS authentication app and Session control appear for your app.
Related content
- Protect apps with Microsoft Defender for Cloud Apps Conditional Access app control
- Deploy Conditional Access app control for custom apps with non-Microsoft identity providers
- Troubleshooting access and session controls
If you run into any problems, we're here to help. To get assistance or support for your product issue, please open a support ticket.
Feedback
https://aka.ms/ContentUserFeedback.
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see:Submit and view feedback for