Connect Box to Microsoft Defender for Cloud Apps
Microsoft Defender for Cloud Apps (previously known as Microsoft Cloud App Security) is now part of Microsoft 365 Defender. The Microsoft 365 Defender portal allows security admins to perform their security tasks in one location. This will simplify workflows, and add the functionality of the other Microsoft 365 Defender services. Microsoft 365 Defender will be the home for monitoring and managing security across your Microsoft identities, data, devices, apps, and infrastructure. For more information about these changes, see Microsoft Defender for Cloud Apps in Microsoft 365 Defender.
This article provides instructions for connecting Microsoft Defender for Cloud Apps to your existing Box account using the App Connector APIs. This connection gives you visibility into and control over Box use. For information about how Defender for Cloud Apps protects Box, see Protect Box.
How to connect Box to Defender for Cloud Apps
Deploying with an account that is not an Admin account leads to a failure in the API test and does not allow Defender for Cloud Apps to scan all of the files in Box. If this is a problem for you, you can deploy with a Co-Admin that has all of the privileges checked, but the API test will continue to fail and files owned by other admins in Box will not be scanned.
If you restrict application permission access, follow this step. Otherwise, skip to step 2.
Sign in with an Admin account to your Box account.
Select Apps > Custom apps > Settings.
If Disable unpublished apps by default is selected, in the Except for text box, add the Defender for Cloud Apps API key:
Data center Defender for Cloud Apps API key US1
Then select Save. For information on how to see which Defender for Cloud Apps data center you're connected to, see View your data center.
If you are an existing Adallom customer, and your console URL is for Adallom and not Defender for Cloud Apps, use this app serial number:
In the Defender for Cloud Apps portal, select Investigate and then Connected apps.
In the App connectors page, select the plus sign (+) button and then select Box.
In the Box settings pop-up, select Follow this link.
The Box sign-in page opens. Enter your credentials to allow Defender for Cloud Apps access to your team's Box app.
Box asks you if you want to allow Defender for Cloud Apps access to your team information, activity log, and perform activities as a team member. To proceed, select Allow.
Back in the Defender for Cloud Apps portal, you should receive a message saying that Box was successfully connected.
Make sure the connection succeeded by selecting Test API.
Testing may take a couple of minutes. After receiving a success notice, select Close.
Box is now connected to Defender for Cloud Apps.
After connecting Box:
- You'll receive events for the 7 days prior to connection.
- Defender for Cloud Apps will perform a full scan of all files. Depending on how many files and users you have, completing the full scan can take a while.
To enable near real-time scanning, files on which activities are detected are moved to the beginning of the scan queue. For example, a file that is edited, updated, or shared is scanned right away rather than waiting for the regular scan process. Near real-time scanning doesn't apply to files that aren't inherently modified. For example, files that are viewed, previewed, printed, or exported are scanned as part of the regularly scheduled scan.
If you have any problems connecting the app, see Troubleshooting App Connectors.
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.
Submit and view feedback for