Perform Actions on Sanctioned Apps
Focus
Focus
SaaS Security

Perform Actions on Sanctioned Apps

Table of Contents

Perform Actions on Sanctioned Apps

Learn about the various actions that you can perform on Sanctioned Apps.
Where Can I Use This?What Do I Need?
  • NGFW (Managed by Strata Cloud Manager)
  • Prisma Access (Managed by Strata Cloud Manager)
  • Data Security license
Or any of the following licenses that include the Data Security license:
  • CASB-X
  • CASB-PA
Learn more about the actions you can perform on sanctioned apps after you add them to Data Security.

Start Scanning a Cloud App

Learn how to start scanning a recently onboarding cloud app on Data Security.
After you onboard a cloud app, you must initiate scanning on that cloud app so that Data Security can scan for policy violations and data exposure. When you initiate scanning—known as discovery or initial backward scanData Security scans all assets in the associated cloud app. During the discovery process, Data Security also matches the assets against enabled default policy rules and identifies incidents. The time required to complete the discovery process depends on the number of assets on your cloud app. However, as soon as you begin to see the assets populate on the Data Security Dashboard, you can assess incidents.
After the discovery process completes, Data Security periodically queries for scannable root entities (for example, user, channel, shared drive, etc.) that are not on its list of known entities, and this scan frequency depends on the SaaS app, taking into account optimal performance; however, Data Security scans most SaaS apps every 5 minutes and is able to do so without delay if Data Security hasn’t reached the rate limit. Each cloud app has unique entities for scanning purposes. When Data Security detects such entities, two distinct scan processes trigger automatically:
  • Forward scan—Process of scanning newly detected, scanable root entities after the point of detection. This process occurs automatically, and there is no way to manually trigger this process, nor do you need to.
  • Backward scan—Process of scanning newly detected, scanable root entities before the point of detection. This process occurs automatically, and there is no way to manually trigger this process, nor do you need to.
  1. To start scanning a cloud app, go to Data SecurityApplications<Your Application>View SettingsActionsStart Scanning.
    The status changes to Up.

Reauthenticate to a Cloud App

Learn how to reauthenticate.
When you connect Data Security to one of your sanctioned SaaS applications, you must provide login credentials that enable the service to establish a secure connection with the cloud app. Data Security and the app maintain this secure connection (in most cases using token-based authentication). In some cases, you might need to reauthenticate to a cloud app when:
  • Network—There is a network connectivity issue between the two services.
  • Password—You changed the password associated with the login account.
    Chrome caches credentials. Use an Incognito window to reauthenticate to avoid applying those cached credentials.
  • Account—The administrator associated with the login account changed credentials to those associated with a different administrator.
  • Permissions—You unintentionally revoked access permissions you formerly granted Data Security or the required permissions changed.
  • Token expiration—Your SaaS app exceeded its RTL (Refresh Token Lifespan), which varies by SaaS application. 100 days is a common RTL. RTL is not configurable.
If you encounter authentication errors when you retrieve a token for Data Security, see Authentication Errors.
Reauthentication is not applicable for the following SaaS apps:
  • Google Drive
  • Gmail
  1. To reauthenticate an app, go to Data SecurityApplications<Your Application>View SettingsVertical EllipsesRe-authenticate.
  2. Follow the same process to log in to the app that you did when you first added the app. See the specific app section in Onboard Sanctioned SaaS Apps to Data Security for details on what privileges are required for each app and for specific steps to successfully authenticate.
  3. To begin scanning the app after you successfully reauthenticate, select Vertical EllipsesStart Scanning.

Verify Permissions on Cloud Apps

Learn how to verify permissions on cloud apps.
A permission refresh is supported for Gmail app, Box app, and Google Drive app.
When you initially onboard a cloud app, Data Security automatically verifies that the administrator account has the necessary permissions. Additionally, using API calls to the cloud app, Data Security continues to periodically perform this check on a regular, scheduled basis. Although the cloud app in Data Security can indicate a Monitoring status, there might be an undetected permissions issue if permissions changed after the last health check.
You might want to verify permissions outside this scheduled event if:
  • New assets are not displaying in Data Security.
  • New incidents are not being created.
  1. Select DashboardScanning cloud apps to display all your cloud apps.
  2. Click on the cloud app for which you want to verify permissions.
  3. Click Refresh Health Status.

Rescan a Managed Cloud App

Learn how to rescan a cloud app on Data Security to update match results.
When you Configure Data Patterns, Data Security scans all connected cloud apps automatically to detect sensitive content that match on these patterns. This is the discovery process. Unlike a forward scan, a rescan does not request assets from the cloud; rather, a rescan downloads previously discovered assets from the cloud app.
Rescan is a resource‑intensive and time‑consuming operation. Depending on the volume of assets in your cloud app, the rescan might take a long time to complete.
Consider a rescan if:
  • You added or modified a data pattern. Data Security matches content from that time onwards, but does not automatically look for matches on previous scan results. To find matches for content that Data Security already scanned, you can Rescan a specific cloud app.
  • You updated your internal domains list and you want Data Security to recalculate exposure for previously discovered assets.
  1. To rescan your app, go to Data SecurityApplications<Your Application>View SettingsActionsRescan.
    The Rescan option is available for the cloud app if the option is displayed, and rescans are limited to once every three days. A rescan timestamp indicates when you initiated it.

Delete Cloud Apps Managed by Data Security

Learn how to delete a cloud app from Data Security.
When you delete a cloud app, Data Security purges all related cloud app data from Data Security, removes the cloud app from the Dashboard, and relinquishes permissions to access the cloud app. Deleting a cloud app does not remove the integration from the cloud app’s marketplace—you must do so manually.
For specific cloud apps, the cloud app vendor automatically notifies Data Security when you delete the integration. If you do not delete the cloud app, the SaaS Security web interface displays Marketplace integration deleted. Finish installing.. In this case, we recommend that you also delete the cloud app to complete your uninstall.
Delete a cloud app if:
Before you delete a managed cloud app, contact SaaS Security Technical Support to speak with an experienced Support Engineer who will help you troubleshoot your issue.
  • Cloud app not in use—Your organization no longer uses the cloud app or was only using the cloud app on a trial basis, and you have no need to view the analytics that Data Security compiled for the cloud app.
  • Integration deleted—You already deleted the integration on the cloud app’s marketplace and have no use for the cloud app data.
  • Asset display issues—Asset information isn't displaying as expected, and you intend to add the cloud app again. A scan from scratch (includes both forward and backward scans) usually resolves this behavior, but a scan can take 24 hours or more to complete, depending on the number of assets. Before you delete the cloud app, try to resolve using reauthentication or, if available for your cloud app rescan.
  • Scan issues—You’re having unusual scan issues, and you don't have any assets on your tenant.
  1. (Recommended) Log in to your cloud app’s marketplace and delete the Data Security integration.
  2. Log in to SaaS Security. Go to Data SecurityApplications<Your Application>View SettingsVertical Ellipses (…)Delete App Instance.