Begin Scanning a Google Drive App

Add your Google Drive App to Prisma SaaS to begin scanning and monitoring assets for possible security risks.
Prisma SaaS supports both My Drive and Shared Drives. Files in My Drive are individually owned whereas files in Shared Drives belong to members of a team. Groups in a team are not supported.
google-shared-drives-list.png
To connect a Google Drive app to Prisma SaaS and begin scanning assets, you need to:
  • Ensure that you have a Google Drive admin account. Add that account to Prisma SaaS as super admin.
  • Grant Google Drive API access to Prisma SaaS.
  • Add the Google Drive app to Prisma SaaS.
For information on which automated remediation capabilities Prisma SaaS supports with Google Drive, refer to Supported Applications with Remediation.
Whether files are individually owned and shared (My Drive) or belong to members in a team (Shared Drives), Prisma SaaS scans and protects the assets because your end users can share data externally from Shared Drives just as easily as they can from My Drive.
google-asset-ownership.png

Add Google Drive App

In order for Prisma SaaS to scan assets, you must consent to specific permissions during the course of adding the Google Drive app.
  1. (
    Recommended
    ) Add your Google Drive domain as an internal domain.
  2. Verify that your Google Drive administrator account has the required privileges.
    Google’s default Super Admin role provides the necessary communication between Prisma SaaS and the Google Drive app.
    • Read, write, and relocate assets in the app.
    • API access. API access provides visibility into the assets in Google Drive and allows Prisma SaaS to monitor the sharing of assets.
    • Google Drive administrator account’s domain matches the existing domain on Prisma SaaS.
    gdrive-admin-permissions.png
  3. Log in to Google Marketplace using an account with Super Admin role permissions.
    1. Go to https://gsuite.google.com/marketplace and log out of Google Marketplace to ensure that you are not logged in as a user other than an account with Super Admin role permissions.
      gdrive-sign-out.png
    2. Log in again to Google Marketplace using an account that has Super Admin role permissions.
      gdrive-login-sudo-admin.png
  4. Add the email address of the Google Drive administrator to Prisma SaaS.
    You must add the administrator to Prisma SaaS and assign a Super Admin role before you can connect the Google Drive app to Prisma SaaS.
    gdrive-add-super-admin.png
  5. Add the Google Drive app.
    1. From the Prisma SaaS
      Dashboard
      , select
      Add a Cloud App
      .
    2. Select
      Google Drive
      .
      google-drive-tile-frame.png
    3. Enter the login credentials for the account with Super Admin role privileges on the Google page to which Prisma SaaS redirects you, then
      Connect to Google Drive Account
      .
      google-drive-enter-email.png
    4. Select
      Domain Install
      on the Google Marketplace page.
      Do not click the redirect link at this time. You will do so later in 5.i. Doing so aborts the onboarding process. If you inadvertently click the redirect link, simply repeat the process starting with 5.
      gdrive-install-app.png
    5. Authenticate your account by entering the account password on the Google login page, if you forgot to log on to the marketplace as outlined in 3.
    6. Click
      Continue
      to proceed with the
      Domain wide install
      process.
      gdrive-domain-install.png
    7. Review and
      Accept
      the requested permissions.
      Prisma SaaS requires these permissions to scan your assets on Google Drive. A new browser window opens in the foreground.
      google-drive-waiver.png
    8. Click
      Done
      .
      gdrive-install-success.png
    9. Click the app redirect link.
      This link informs Prisma SaaS that you installed the Google Drive app on Google Marketplace. Google no longer redirects from its marketplace.
      Google Drive app does not display in the Cloud Apps list if you proceed without clicking on this redirect.
      gdrive-click-redirect-link.png
    After authentication, Prisma SaaS adds the new Google Drive app to the Cloud Apps list as
    Google Drive
     
    n
    , where
    n
    is the number of Google Drive app instances that you connected to Prisma SaaS. For example, if you added one Google Drive app, the name displays as
    Google 1
    . You’ll specify a descriptive name soon.
  6. (
    Optional
    ) Give a descriptive name to this app instance and specify an incident reviewer.
    1. Select the Google Drive 
      n
      link on the Cloud Apps list.
    2. Enter a descriptive
      Name
      to differentiate this instance of Google Drive from other instances you are managing.
    3. Specify an
      Incident Reviewer Account
      . Use this setting with caution. The account you provide becomes a collaborator on all risks — even private files.
    4. (
      Optional
      ) Enter the
      Organizational Units
      to scan.
      You can enter multiple OUs including the OU name and sub-OU. For example, your domain is companydomain.com and you want to selectively scan three OUs—finance, operations, and marking/socialmedia OUs. Enter the OUs as a comma-separated list:
      /finance,/operations,/marketing/socialmedia
      . If you leave this field blank, all units are scanned.
      google-drive-organizational-units.png
    5. Click
      Done
      to save your changes.
  7. Set up a Google Remediation account.
    1. Select
      Settings
      , and select the corresponding Google Drive app.
    2. Enter an email address for the
      Google Remediation Account
      . This account grants access to all assets (files and folders) in the corresponding Google Drive account.
    3. Click
      Done
      to save your changes.
  8. Start scanning the new Google Drive app for risks.
    1. Select
      Settings
      Cloud Apps & Scan Settings
      .
    2. In the Cloud Apps row that corresponds to the new Google Drive app, select
      Actions
      Start Scanning
      .
      Prisma SaaS scans all assets in the associated Google Drive app and identifies incidents. Depending on the number of assets, it may take some time to complete the process. However, as soon as you begin to see this information populating on the Prisma SaaS
      Dashboard
      , you can begin to Assess Incidents.
  9. During the discovery phase, as Prisma SaaS scans files and matches them against enabled default policy rules.
    Verify that your default policy rules are effective. If the results don’t capture all risks or you see false positives, improve the results.

Identify Risks

When you add a new cloud app, Prisma SaaS 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.
  1. (
    Optional
    ) Modify match criteria for existing policy rules.
  2. (
    Optional
    ) Add new policy rules.
    Consider the business use of your app, then identify risks unique to your enterprise. As necessary, add new:
  3. (
    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.

Fix Google Drive App Onboarding Issues

The most common issues related to onboarding a Google Drive app are as follows:
Symptom
Explanation
Solution
When you attempt to add the Google Drive app by logging in to your Google account from Prisma SaaS, you receive an authentication error.
The Google account doesn’t have sufficient permissions to authenticate and access all the assets within Google Drive.
Make sure your Google account is an administrator with default super admin role or applicable custom role with the permission outlined in 2.
gdrive-assign-role.png
When you attempt to add the Google Drive app by logging in to your Google account from Prisma SaaS, you receive a login error:
This email must be added as a Super Admin
The Google account doesn’t have an administrator account in Prisma SaaS.
Make sure your Google account is super admin on Prisma SaaS.
gdrive-add-super-admin.png
When you a click on the redirect link as outlined in 5.i, you’re redirected to a product landing page and the Google Drive app doesn’t appear in the Cloud Apps list.
gdrive-incorrect-redirect-landing.png
Cached files are preventing the correct redirect.
Do not log out of Prisma SaaS. Instead, open Prisma SaaS in an incognito window. Repeat 5, then click on the redirect link again. The Google Drive app now appears in the Cloud app list.
When Prisma SaaS redirects you to Google Marketplace to install the app, an
Uninstall
message appears.
gdrive-uninstall-app.png
This usually occurs if you previously installed the app and deleted it from Prisma SaaS.
Delete the app from the Google Marketplace, then you’ll be able to add the Google Drive app in Prisma SaaS.
gdrive-delete-marketplace-app.png
This problem occurs if you did not click the redirect link during the onboarding process.
If the Google Marketplace page is open in the same browser and session that you used when you initially added the Google Drive app, simply click on the redirect link as outlined in 5.i
gdrive-click-redirect-link.png
Otherwise, delete the Google Drive app from the Google Marketplace and repeat the Google Drive app onboarding process in Prisma SaaS.
gdrive-delete-marketplace-app.png

Fix Google Drive Monitoring Issues

If user activities for Google Drive do not display in Prisma SaaS , contact Prisma SaaS Customer Support to initiate appropriate troubleshooting steps. However, if requested do so by Prisma SaaS Customer Support due to permissions issues, remove the API client access from Google, then authenticate the Google app again to re-enable access.
  1. Open a web browser and log in to
    admin.google.com
    .
  2. Navigate to
    Manage API client access
    (located in
    Security
    Advanced Settings
    ).
  3. Scroll to find the list of
    Prisma SaaS
    clients.
  4. Click
    Remove
    .
    google-api-client-access.png

Google Drive App Behaviors

The most common behaviors related to Google Drive app are as follows:
Symptom
Explanation
Solution
When a user moves a file from Shared Drives to My Drive or vice versa, Prisma SaaS displays
Delete
in the Activity log.
Google API reported the action as a
Delete
when actually Google did in fact
Move
the file. Prisma SaaS displays in the Activity Log what Google API reports.
No known solution at this time. We communicate with our Google partner on an ongoing basis regarding its API.
Some files are shared with internal users, but Prisma SaaS indicates
External
.
For Google shared drives, Prisma SaaS analyzes a file’s direct collaborators and the drive’s members. If one of the members is external, Prisma SaaS assigns an
External
exposure level.
This behavior is expected and by design.

Recommended For You