Create a Protect group

You need to have at least one Protect group to create a standard or rule. The Groups tab in Protect contains an overview of Protect groups that are active in the data sources. Each Protect group is associated with a role in the data source.

Note 
  • These groups correspond to your data source roles, not to groups of Collibra users.
  • roles are referred to as principals in BigQuery.
  • Multiple Protect groups can be mapped to the same data source identity.
  • Within a single Protect group, only one mapping per data source is supported. You receive a validation error when creating or editing a Protect group with multiple mappings for the same data source.

Prerequisites

You have a global role that has the Protect > Edit or Protect > Administration global permission.

Steps

  1. On the environment where you want to create a Protect group, click → API Documentation.

    Image showing the link to API Documentation
    The APIs Documentation page opens.

  2. In the REST APIs section, click REST Protect API.
    The Collibra Protect API page opens.
  3.  Click Groups > POST > Try it out.
  4.  Edit the request body.
    Copy
    Example: POST/groups
    {
      "name": "Sales",
      "mappings": [
        {
          "provider": "CustomDataSource",
          "identity": "SALES"
        }
      ]
    }
    • name: Unique name to identify the Protect group in Collibra.
    • provider: Primary name that is used to identify the data source (AWSLakeFormation, Databricks, GoogleBigQuery, Snowflake).
    • identity: Existing role from the data source to map to the group. Examples:

  5. Click Execute.
    The Protect group is created in Collibra.
  • The following image shows the roles in Snowflake.

  • The following images show a CSV file (named protect_groups.csv) that contains Protect groups to be added to Collibra, and a bash script that adds those groups to Collibra for Snowflake.

    Protect groups CSV file

    Bash script to add Protect groups from a CSV file

Groups tab

The following table describes the columns that are shown on the Groups tab in Protect.

Column Description
Group Name Name of the group.
System Reference References to identify the data source and the native identifier associated with the group.

Created By

 Name of the user who created the group.
Created Date Date when the group was created.