Skip to main content
Version: 0.12.1

About DataHub Access Policies

Access Policies define who can do what to which resources. In conjunction with Roles, Access Policies determine what users are allowed to do on DataHub.

Policy Types

There are 2 types of Access Policy within DataHub:

  1. Platform Policies
  2. Metadata Policies

Platform Policies determine who has platform-level Privileges on DataHub. These include:

  • Managing Users & Groups
  • Viewing the DataHub Analytics Page
  • Managing Policies themselves

Platform policies can be broken down into 2 parts:

  1. Privileges: Which privileges should be assigned to the Actors (e.g. "View Analytics")
  2. Actors: Who the should be granted the privileges (Users, or Groups)

A few Platform Policies in plain English include:

  • The Data Platform team should be allowed to manage users & groups, view platform analytics, & manage policies themselves
  • John from IT should be able to invite new users

Metadata policies determine who can do what to which Metadata Entities. For example:

  • Who can edit Dataset Documentation & Links?
  • Who can add Owners to a Chart?
  • Who can add Tags to a Dashboard?

Metadata policies can be broken down into 3 parts:

  1. Privileges: The 'what'. What actions are being permitted by a Policy, e.g. "Add Tags".
  2. Resources: The 'which'. Resources that the Policy applies to, e.g. "All Datasets".
  3. Actors: The 'who'. Specific users, groups, & roles that the Policy applies to.

A few Metadata Policies in plain English include:

  • Dataset Owners should be allowed to edit documentation, but not Tags.
  • Jenny, our Data Steward, should be allowed to edit Tags for any Dashboard, but no other metadata.
  • James, a Data Analyst, should be allowed to edit the Links for a specific Data Pipeline he is a downstream consumer of.

Each of these can be implemented by constructing DataHub Access Policies.

Access Policies Setup, Prerequisites, and Permissions

What you need to manage Access Policies on DataHub:

  • Manage Policies Privilege

This Platform Privilege allows users to create, edit, and remove all Access Policies on DataHub. Therefore, it should only be given to those users who will be serving as Admins of the platform. The default Admin role has this Privilege.

Using Access Policies

Policies can be created by first navigating to Settings > Permissions > Policies.

To begin building a new Policy, click Create new Policy.

Creating a Platform Policy

Step 1. Provide a Name & Description

In the first step, we select the Platform Policy type, and define a name and description for the new Policy.

Good Policy names describe the high-level purpose of the Policy. For example, a Policy named "View DataHub Analytics - Data Governance Team" would be a great way to describe a Platform Policy which grants abilities to view DataHub's Analytics view to anyone on the Data Governance team.

You can optionally provide a text description to add richer details about the purpose of the Policy.

Step 2: Configure Privileges

In the second step, we can simply select the Privileges that this Platform Policy will grant.

Platform Privileges most often provide access to perform administrative functions on the Platform. These include:

Platform PrivilegesDescription
Manage PoliciesAllow actor to create and remove access control policies. Be careful - Actors with this Privilege are effectively super users.
Manage Metadata IngestionAllow actor to create, remove, and update Metadata Ingestion sources.
Manage SecretsAllow actor to create & remove secrets stored inside DataHub.
Manage Users & GroupsAllow actor to create, remove, and update users and groups on DataHub.
Manage All Access TokensAllow actor to create, remove, and list access tokens for all users on DataHub.
Create DomainsAllow the actor to create new Domains
Manage DomainsAllow actor to create and remove any Domains.
View AnalyticsAllow the actor access to the DataHub analytics dashboard.
Generate Personal Access TokensAllow the actor to generate access tokens for personal use with DataHub APIs.
Manage User CredentialsAllow the actor to generate invite links for new native DataHub users, and password reset links for existing native users.
Manage GlossariesAllow the actor to create, edit, move, and delete Glossary Terms and Term Groups
Create TagsAllow the actor to create new Tags
Manage TagsAllow the actor to create and remove any Tags
Manage Public ViewsAllow the actor to create, edit, and remove any public (shared) Views.
Manage Ownership TypesAllow the actor to create, edit, and remove any Ownership Types.
Manage Platform Settings(Acryl DataHub only) Allow the actor to manage global integrations and notification settings
Manage Monitors(Acryl DataHub only) Allow the actor to create, remove, start, or stop any entity assertion monitors
Restore Indices API1Allow the actor to restore indices for a set of entities via API
Enable/Disable Writeability API1Allow the actor to enable or disable GMS writeability for use in data migrations
Apply Retention API1Allow the actor to apply aspect retention via API

Step 3: Choose Policy Actors

In this step, we can select the actors who should be granted Privileges appearing on this Policy.

To do so, simply search and select the Users or Groups that the Policy should apply to.

Assigning a Policy to a User

Assigning a Policy to a Group

Creating a Metadata Policy

Step 1. Provide a Name & Description

In the first step, we select the Metadata Policy, and define a name and description for the new Policy.

Good Policy names describe the high-level purpose of the Policy. For example, a Policy named "Full Dataset Edit Privileges - Data Platform Engineering" would be a great way to describe a Metadata Policy which grants all abilities to edit Dataset Metadata to anyone in the "Data Platform" group.

You can optionally provide a text description to add richer detail about the purpose of the Policy.

Step 2: Configure Privileges

In the second step, we can simply select the Privileges that this Metadata Policy will grant. To begin, we should first determine which assets that the Privileges should be granted for (i.e. the scope), then select the appropriate Privileges to grant.

Using the Resource Type selector, we can narrow down the type of the assets that the Policy applies to. If left blank, all entity types will be in scope.

For example, if we only want to grant access for Datasets on DataHub, we can select Datasets.

Next, we can search for specific Entities of the that the Policy should grant privileges on. If left blank, all entities of the selected types are in scope.

For example, if we only want to grant access for a specific sample dataset, we can search and select it directly.

We can also limit the scope of the Policy to assets that live in a specific Domain. If left blank, entities from all Domains will be in scope.

For example, if we only want to grant access for assets part of a "Marketing" Domain, we can search and select it.

Finally, we will choose the Privileges to grant when the selected entities fall into the defined scope.

Metadata Privileges grant access to change specific entities (i.e. data assets) on DataHub.

The common Metadata Privileges, which span across entity types, include:

Common PrivilegesDescription
View Entity PageAllow actor to access the entity page for the resource in the UI. If not granted, it will redirect them to an unauthorized page.
Edit TagsAllow actor to add and remove tags to an asset.
Edit Glossary TermsAllow actor to add and remove glossary terms to an asset.
Edit OwnersAllow actor to add and remove owners of an entity.
Edit DescriptionAllow actor to edit the description (documentation) of an entity.
Edit LinksAllow actor to edit links associated with an entity.
Edit StatusAllow actor to edit the status of an entity (soft deleted or not).
Edit DomainAllow actor to edit the Domain of an entity.
Edit DeprecationAllow actor to edit the Deprecation status of an entity.
Edit LineageAllow actor to edit custom lineage edges for the entity.
Edit Data ProductAllow actor to edit the data product that an entity is part of
Propose Tags(Acryl DataHub only) Allow actor to propose new Tags for the entity.
Propose Glossary Terms(Acryl DataHub only) Allow actor to propose new Glossary Terms for the entity.
Propose Documentation(Acryl DataHub only) Allow actor to propose new Documentation for the entity.
Manage Tag Proposals(Acryl DataHub only) Allow actor to accept or reject proposed Tags for the entity.
Manage Glossary Terms Proposals(Acryl DataHub only) Allow actor to accept or reject proposed Glossary Terms for the entity.
Manage Documentation Proposals(Acryl DataHub only) Allow actor to accept or reject proposed Documentation for the entity
Edit EntityAllow actor to edit any information about an entity. Super user privileges. Controls the ability to ingest using API when REST API Authorization is enabled.
Get Timeline API1Allow actor to get the timeline of an entity via API.
Get Entity API1Allow actor to get an entity via API.
Get Timeseries Aspect API1Allow actor to get a timeseries aspect via API.
Get Aspect/Entity Count APIs1Allow actor to get aspect and entity counts via API.
Search APIAllow actor to search for entities via API.
Produce Platform Event APIAllow actor to ingest a platform event via API.

Specific Metadata Privileges include

EntityPrivilegeDescription
DatasetEdit Dataset Column TagsAllow actor to edit the column (field) tags associated with a dataset schema.
DatasetEdit Dataset Column Glossary TermsAllow actor to edit the column (field) glossary terms associated with a dataset schema.
DatasetEdit Dataset Column DescriptionsAllow actor to edit the column (field) descriptions associated with a dataset schema.
DatasetEdit Dataset QueriesAllow actor to edit the Highlighted Queries on the Queries tab of the dataset.
DatasetView Dataset UsageAllow actor to access usage metadata about a dataset both in the UI and in the GraphQL API. This includes example queries, number of queries, etc. Also applies to REST APIs when REST API Authorization is enabled.
DatasetView Dataset ProfileAllow actor to access a dataset's profile both in the UI and in the GraphQL API. This includes snapshot statistics like #rows, #columns, null percentage per field, etc.
DatasetEdit AssertionsAllow actor to change the assertions associated with a dataset.
DatasetEdit Incidents(Acryl DataHub only) Allow actor to change the incidents associated with a dataset.
DatasetEdit Monitors(Acryl DataHub only) Allow actor to change the assertion monitors associated with a dataset.
TagEdit Tag ColorAllow actor to change the color of a Tag.
GroupEdit Group MembersAllow actor to add and remove members to a group.
GroupEdit Contact InformationAllow actor to change email, slack handle associated with the group.
GroupManage Group Subscriptions(Acryl DataHub only) Allow actor to subscribe the group to entities.
GroupManage Group Notifications(Acryl DataHub only) Allow actor to change notification settings for the group.
UserEdit User ProfileAllow actor to change the user's profile including display name, bio, title, profile image, etc.
User + GroupEdit Contact InformationAllow actor to change the contact information such as email & chat handles.
Term GroupManage Direct Glossary ChildrenAllow actor to change the direct child Term Groups or Terms of the group.
Term GroupManage All Glossary ChildrenAllow actor to change any direct or indirect child Term Groups or Terms of the group.

Still have questions about Privileges? Let us know in Slack!

Step 3: Choose Policy Actors

In this step, we can select the actors who should be granted the Privileges on this Policy. Metadata Policies can target specific Users & Groups, or the owners of the Entities that are included in the scope of the Policy.

To do so, simply search and select the Users or Groups that the Policy should apply to.

We can also grant the Privileges to the owners of Entities (or Resources) that are in scope for the Policy. This advanced functionality allows of Admins of DataHub to closely control which actions can or cannot be performed by owners.

Updating an Existing Policy

To update an existing Policy, simply click the Edit on the Policy you wish to change.

Then, make the changes required and click Save. When you save a Policy, it may take up to 2 minutes for changes to be reflected.

Removing a Policy

To remove a Policy, simply click on the trashcan icon located on the Policies list. This will remove the Policy and deactivate it so that it no longer applies.

When you delete a Policy, it may take up to 2 minutes for changes to be reflected.

Deactivating a Policy

In addition to deletion, DataHub also supports "deactivating" a Policy. This is useful if you need to temporarily disable a particular Policy, but do not want to remove it altogether.

To deactivate a Policy, simply click the Deactivate button on the Policy you wish to deactivate. When you change the state of a Policy, it may take up to 2 minutes for the changes to be reflected.

After deactivating, you can re-enable a Policy by clicking Activate.

Default Policies

Out of the box, DataHub is deployed with a set of pre-baked Policies. This set of policies serves the following purposes:

  1. Assigns immutable super-user privileges for the root datahub user account (Immutable)
  2. Assigns all Platform Privileges for all Users by default (Editable)

The reason for #1 is to prevent people from accidentally deleting all policies and getting locked out (datahub super user account can be a backup) The reason for #2 is to permit administrators to log in via OIDC or another means outside of the datahub root account when they are bootstrapping with DataHub. This way, those setting up DataHub can start managing Access Policies without friction. Note that these Privileges can and likely should be changed inside the Policies page before onboarding your company's users.

REST API Authorization

Policies only affect REST APIs when the environment variable REST_API_AUTHORIZATION is set to true for GMS. Some policies only apply when this setting is enabled, marked above, and other Metadata and Platform policies apply to the APIs where relevant, also specified in the table above.

Additional Resources

Videos

GraphQL

FAQ and Troubleshooting

How do Policies relate to Roles?

Policies are the lowest level primitive for granting Privileges to users on DataHub.

Roles are built for convenience on top of Policies. Roles grant Privileges to actors indirectly, driven by Policies behind the scenes. Both can be used in conjunction to grant Privileges to end users.

Need more help? Join the conversation in Slack!


  1. Only active if REST_API_AUTHORIZATION_ENABLED environment flag is enabled