Applies to: Microsoft Cloud App Security

Connect Box to Microsoft Cloud App Security

This section provides instructions for connecting Microsoft Cloud App Security to your existing Box account using the App Connector APIs.

How to connect Box to Cloud App Security

Note

Deploying with an account that is not an Admin account leads to a failure in the API test and does not allow Cloud App Security 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.

  1. If you restrict application permission access, follow this step. Otherwise, skip to step 2.

    • In the Box Admin console, click the settings icon followed by Business settings or Enterprise settings.

      box business settings

    • Click on the Apps tab.

      box apps

    • If Unpublished Applications is selected, in the Except for text box, add the Cloud App Security app serial number:

      Data center Microsoft Cloud App Security serial number
      US1 nduj1o3yavu30dii7e03c3n7p49cj2qh
      US2 w0ouf1apiii9z8o0r6kpr4nu1pvyec75
      US3 dmcyvu1s9284i2u6gw9r2kb0hhve4a0r
      EU1 me9cm6n7kr4mfz135yt0ab9f5k4ze8qp
      EU2 uwdy5r40t7jprdlzo85v8suw1l4cdsbf

      Then click Save. For information on how to see which Cloud App Security data center you are connected to, see API tokens.

      box settings except for

    Note

    If you are an existing Adallom customer, and your console URL is for Adallom and not Cloud App Security, use this app serial number: bwahmilhdlpbqy2ongkl119o3lrkoshc.

  2. In the Cloud App Security portal, click Investigate and then Connected apps.

  3. In the App connectors page, click the plus sign button and select Box.

    connect box

  4. In the Box settings pop-up, click Follow this link.

  5. The Box logon page opens. Enter your credentials to allow Cloud App Security access to your team's Box app.

  6. Box asks you if you want to allow Cloud App Security access to your team information, activity log, and perform activities as a team member. To proceed, click Allow.

  7. Back in the Cloud App Security portal, you should receive a message saying that Box was successfully connected.

  8. Make sure the connection succeeded by clicking Test API.

    Testing may take a couple of minutes. After receiving a success notice, click Close.

Box is now connected to Cloud App Security.

After connecting Box, you will receive events for 60 days prior to connection.

After connecting Box, Cloud App Security performs a full scan. Depending on how many files and users you have, completing the full scan can take awhile. 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 does not apply to files that are not inherently modified. For example, files that are viewed, previewed, printed, or exported are scanned as part of the regularly scheduled scan.

See Also

Control cloud apps with policies

Premier customers can also choose Cloud App Security directly from the Premier Portal.