SaaS Security
Begin Scanning a Box App
Table of Contents
Expand All
|
Collapse All
SaaS Security Docs
Begin Scanning a Box App
Use these steps to connect the Box application to Data Security to begin scanning assets for policy violations.
Where Can I Use This? | What Do I Need? |
---|---|
|
Or any of the following licenses that include the Data Security license:
|
This feature is available for Business, Business Plus, and Enterprise versions
only. Personal accounts are not supported.
Support for automated remediation
capabilities varies by SaaS application.
Supported Content
Support For
|
Details
|
---|---|
Scan Content
| Files, Folders |
Backward Scan
|
Yes
|
Forward Scan
|
Yes
|
Selective Scan
|
Yes
|
User Activities
|
|
Remediation Actions
|
|
Notifications
|
|
Post-Remediation Actions (Actions after Admin
Quarantine)
|
Yes
|
Exposure
|
All
|
Snippet Support
|
Yes
|
Known License and Version restrictions
|
Supported Versions
|
Caveats and Notes
|
None
|
Onboard Box App
To onboard and start scanning your Box app instance,
you must have an Admin or a Co-admin account. Further, if you are onboarding
as a Co-admin, you must have the Co-owner permissions enabled to be able to
scan your box app.
- Prerequisites to be completed before onboarding
- (Recommended) Add your Box app domain as an internal domain.(Optional) Enable group-based Enable Group-based Selective Scanning.Integrate Cloud Identity Engine with Data Security if you plan to use selective scanning before adding your Box application so that Data Security can discover and scan assets belonging to the user groups you want to monitor.Ensure that the Box account you plan to use with Data Security has sufficient privileges.Enabling the Edit settings for your company option suppresses email notifications. If you don't enable this setting, every collaborator on an asset receives an email notification each time Data Security accesses an asset. When you suppress an email notification, actions will still appear in the user’s update feeds and in the audit logs.From within the Box app, select Admin ConsoleUsers and Groups and select the administrator account you want to use and Allow this user to see all managed users.Next step: Proceed to Add Box App to Data Security.Add Box App to Data Security
- Log in to Strata Cloud Manager.Select ManageConfigurationSaaS SecurityData SecurityApplicationsAdd ApplicationBox.Click Connect Box to Data Security.Enter the email address and password for the administrator account you want Data Security to use when connecting to Box and then Authorize.Data Security validates the administrator account and if the account has the right authentication permissions to access all the Box assets. If the account does not have adequate permissions, an onscreen status displays an error alerting you to fix the issue.After authentication succeeds, Grant access to Box.After you grant access to Box, on successful onboarding, the following message is displayed.Click View Onboarding Status to know if the validation checks have passed. You will be able to start scanning only after successful validation.Optional After authentication, Data Security adds the new Box app to the Cloud Apps list as Box n, where n is the number of Box app instances that you connected to Data Security. For example, if you added one Box app, the name displays as Box 1. You’ll specify a descriptive name soon.Next step: Proceed to Start Scanning the Box App and Monitor Results.
Troubleshooting Onboarding for Box App
To ensure that your app has onboarded correctly without any issues in authentication or permissions, Data Security performs validation checks between the onboarding and scanning process. You can start scanning only after a successful validation. For Box, the following validation happens:- App Authentication
After the validation is successful, Data Security displays the sample user activities and data assets:If the App Authentication check fails, try the following:- Ensure you have administrator permissions.
- Go to your Box app directory (https://<custom
domain>.app.box.com/app-center?myApps=true) and check if your Palo
Alto Networks application is listed in the list of installed apps. Following are
the app names for specific regions:
- India region: Palo Alto Networks NG-CASB - India
- Australia region: Palo Alto Networks NG-CASB - AUS
- Japan region: Palo Alto Networks NG-CASB - JP
- UK region: Palo Alto Networks NG-CASB - UK
- EU region: Aperture EU by Palo Alto Networks
- APAC region: Aperture APAC by Palo Alto Networks
- US region: Aperture by Palo Alto Networks
Handling ErrorsTo understand your error messages and ways to resolve them, see:If the issue persists, contact SaaS Security Technical Support.Customize Box App
After you add the Box app, customize the app to make use of capabilities that are unique to this app. - (Optional) Specify an Alternative account for quarantined files.You can specify a different Box account (in email address format) for the quarantine administrator for precise assignment of incident management responsibilities. If you choose not to specify an alternative account, Data Security uses the onboarding account to quarantine files in the Admin Quarantine folder. The Box account for the quarantine administrator does not need to have admin privileges. After you define this quarantine administrator, you can't modify the setting without deleting the Box app and repeating the onboarding process; therefore, use a service account that persists as administrators join and leave your organization.Click Done to save your changes.Next step: Proceed to Selective Scanning on Box App.
Selective Scanning on Box App
Perform selective scanning on your Box app. - (Optional) Enable group-based selective scanning.Integrate Cloud Identity Engine with Data Security if you plan to use selective scanning before adding your Box application so that Data Security can discover and scan assets belonging to the user groups you want to monitor.You cannot change the status of selective scanning for your Box app that has already started scanning.You can choose to either Scan or Exclude From Scan your user groups.Choose your groups from the Available Groups list and move them to the Selected Groups list.Save your changes.You can perform each of the above four steps any number of times and make any changes as long as you have not started scanning your Box app. However, if you have started scanning, all operations related to selective scanning are disabled.Next step: Proceed to Start Scanning and Monitor Results.
Start Scanning and Monitor Results
When you add a new cloud app, then enable scanning, Data Security automatically scans the cloud app against the default data patterns and displays the match occurrences. You can take action now to improve your scan results and identify risks.- To start scanning the new Box app for risks, select ManageConfigurationSaaS SecurityData SecurityApplicationsBoxView Settings...Start Scanning.Monitor the scan results.During the discovery phase, as Data Security scans files and matches them against enabled policy rules, verify that your default policy rules are effective. If the results don’t capture all the risks or you see false positives, proceed to the next step to improve your results.(Optional) Modify match criteria for existing policy rules.(Optional) Add new policy rules.Consider the business use of your cloud app, then identify risks unique to your enterprise. As necessary, add new:(Optional) Configure or edit a data pattern.You can Configure Data Patterns to identify specific strings of text, characters, words, or patterns to make it possible to find all instances of text that match a data pattern you specify.