Versions Compared

Old Version 19

changes.mady.by.user Christine Gross

Saved on

compared with

New Version 20

changes.mady.by.user Christine Gross

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Include Page
API Header
API Header

Note:

Steps to get required configs

  • You will get your Google organization on the top bar of GCP dashboard as marked by the red arrow in the screenshot below. Users & Groups in this primary domain organization will be synced.

    Image Added

  • To authenticate the integration, you will need either Zilla managed service account’s credentials or your own service account’s credentials.

In the case of Zilla managed service account:

  • If you want to go with Zilla managed service account based authentication, please reach out to the Zilla support team to get the service account email, support@zillasecurity.com.

  • After getting the email, create a custom role for Zilla with the below command in Cloud shell.

    Code Block
    gcloud iam roles create zilla_security_role --organization=<your-org-id> --permissions=resourcemanager.organizations.get,resourcemanager.organizations.getIamPolicy,iam.roles.get,iam.roles.list,resourcemanager.projects.get,resourcemanager.projects.getIamPolicy,resourcemanager.projects.list

  • Assign this role to Zilla managed service account with the below command in Cloud shell.

    Code Block
    gcloud organizations add-iam-policy-binding <your-org-id> --member serviceAccount:<zilla-managed-service-account-email> --role organizations/<your-org-id>/roles/zilla_security_role --condition=None

  • Private key and email of the service account will be set by the Zilla support team.

In the case of your own service account:

  • If you want to use your own service account to authenticate the integration, please create one under any of your projects and grant the permissions below.

    Code Block
    resourcemanager.organizations.get
resourcemanager.organizations.getIamPolicy
iam.roles.get
iam.roles.list
resourcemanager.projects.get
resourcemanager.projects.getIamPolicy
resourcemanager.projects.list

  • Private key and emails of the service account will be used in a later step.

Info

Prerequisites to be completed before GCP sync:

  • Sync Google Workspace application. This is required to capture the users and groups in the Google Workspace directory. For instructions to sync Google Workspace visit: Google Workspace.Have correct admin permissions. To sync GCP you need to have SuperAdmin role in Zilla and have Organization Administrator role in your organization's GCP account.

Setup GCP Application Integration on Zilla

  • Login to Zilla with your admin credentials.

...

  • You will see your Zilla Applications tab (if not, click Applications in the top left menu bar), click Add Application button in the top right top corner.

...

  • A dialog appears, enable API Integration.

...

  • Fill in Your google domain with your Google primary domain. If your email address is john.doe@example.com enter example.com as your domain. Most likely it will appear on the top bar of GCP dashboard as marked by the red arrow in the screenshot below. Users & Groups in this primary domain organization will be synced. , Private key of the service account and Email of the service account from the earlier steps. In case of Zilla managed service account, private key and email of service account configs will be set by the Zilla support team.

  • Set Use service account based authentication to Yes.

  • Optional: Comma separated list of project ID prefixes to skip projects (e.g. sys, sandbox): projects can be excluded from the sync by specifying the project ID prefix or entire project ID.

...

  • Click Next Sync Now.

...

  • Click Next.Enter password, click Next.

...

Note: Zilla’s use and transfer to any other app of information received from Google APIs will adhere to Google API Services User Data Policy, including the Limited Use requirements.

  • You will be redirected to Google to do OAuth consent for following permission, Click Continue.

...

.

...

  • You will see sync is in progress. Click Done.

...