: Onboard a Google Workspace App to SSPM
Focus
Focus

Onboard a Google Workspace App to SSPM

Table of Contents

Onboard a Google Workspace App to SSPM

Connect a Google Workspace instance to SSPM to detect posture risks.
Palo Alto Networks' use and transfer of information received from Google APIs to any other app will adhere to Google API Services User Data Policy, including the Limited Use requirements. For more information on how information may be captured, processed, and stored by and within the service, refer to the SaaS Security Privacy document. SSPM does not share your data with third-party tools, such as AI applications.
For SSPM to detect posture risks in a Google Workspace organizational unit, you must onboard your Google Workspace instance to SSPM. Through the onboarding process, SSPM connects to a Google Workspace API and, through the API, scans a Google Workspace organizational unit for misconfigured settings. If there are misconfigured settings, SSPM suggests a remediation action based on best practices. If users have extended Google Workspace by installing third-party apps, SSPM can also detect the third-party apps and the scopes that they can access. This information helps you determine the risks posed by third-party apps so you can take action as needed.
SSPM gets access to your Google Workspace instance through OAuth 2.0 authorization. During the onboarding process, you are prompted to log in to Google Workspace and to grant SSPM the access it requires.
To onboard your Google Workspace instance, you complete the following actions:

Identify an Administrator Account and an Organizational Unit

During the onboarding process, you will specify a particular Google Workspace organizational unit to scan. Then, SSPM will redirect you to log in to Google Workspace. After you log in, Google Workspace will prompt you to grant SSPM the access it needs to your Google Workspace instance.
  1. Identify the account that SSPM will use to access your Google Workspace instance.
    When you onboard Google Workspace, SSPM gives you an option to connect with read-only permissions or with read and write permissions. The onboarding screen lists the API scopes that SSPM requires for each type of scan that it can run. The onboarding screen also lists the API scopes that SSPM requires to perform certain actions on your behalf. After establishing a connection, SSPM will notify you if it is unable to run certain scans, or complete certain actions, because the account did not have the permissions to grant access to certain scopes.
    Onboarding Google Workspace with read-only permissions will enable SSPM to perform configuration scans. Connecting with read and write permissions enables additional SSPM features, including third-part application scans and the ability to revoke a user's access to a third-party plugin. SSPM will request access to the following scopes for the following reasons.
    API ScopeReason
    https://www.googleapis.com/auth/admin.reports.audit.readonly
    SSPM uses this scope to monitor your Google Workspace instance for misconfigured settings. SSPM reads the audit logs to track configuration changes.
    https://www.googleapis.com/auth/admin.directory.user.readonly
    SSPM uses this scope to identify users of third-party applications.
    https://www.googleapis.com/auth/admin.directory.user.security
    SSPM uses this scope to track the third-party applications that users in your organization can access, and to revoke access.
    Permissions for Read Access: To grant SSPM reduced permissions to perform configuration scans only, the account must be assigned to an admin role that has the Reports privilege to the Admin console. To log in with a user account the has only the minimum privileges required, create a custom role that has only the Reports privilege, and assign that custom role to the user account. To create the custom role, complete the following steps:
    1. From the Google Workspace Admin Console menu, select Account > Admin roles.
    2. Create new role.
    3. Enter a name for the role and CONTINUE.
    4. Under the list of Admin Console Privileges, select only the Reports privilege and CONTINUE.
    5. Create Role.
    Permissions for Read and Write Access: To grant SSPM full read and write access to perform all of its scans and actions, the account must be assigned to the Super Admin role.
  2. Identify the Google Workspace organizational unit to scan.
    An organizational unit is a grouping of users with common settings. During onboarding, you are prompted for the name of the organizational unit for SSPM to scan. If you want to scan multiple organizational units, you can onboard each one separately. To view the organizational units in your Google Workspace instance, from the Google Admin console, select DirectoryOrganizational Units.
  3. Sign out of all Google Workspace accounts.
    Signing out of all Google Workspace accounts helps ensure that you sign in under the correct account during the onboarding process. Some browsers can automatically sign you in by using saved credentials. To ensure that the browser does not automatically sign you in to the wrong account, you can turn off any automatic sign-in option or clear your saved credentials. Alternatively, you can prevent the browser from using saved credentials by opening the Cloud Management Console in an incognito window.

Connect SSPM to Your Google Workspace Instance

By adding a Google Workspace app in SSPM, you enable SSPM to connect to your Google Workspace instance.
  1. From the Add Application page (Posture SecurityApplicationsAdd Application), click the Google Workspace tile.
  2. On the Posture Security tab, Add New instance.
  3. Specify your Organization Unit Name in the field provided.
  4. Specify whether you want SSPM to connect with Read Permissions only or with Read and Write permissions.
    The onboarding page lists the API scopes that SSPM will access to complete its various scans and to perform remediation.
  5. Connect with Google Workspace.
    SSPM redirects you to the Google Workspace login page.
  6. Log in to the Google Workspace account.
    Google Workspace displays a consent form that details the access permissions that SSPM requires.
  7. Review the consent form and allow the requested permissions.
    SSPM connects to your Google Workspace instance, and displays whether it was able to access the API scopes that it requires for its scans. If SSPM is unable to access the necessary scopes, it indicates which scan types or actions it will not be able to perform.