# Requesting Access from Your Catalog

{% hint style="info" %}
**Private preview**: The assets and access request link features are private preview and available to all accounts.
{% endhint %}

Data consumers can request two types of access:

* **Data access requests**: These access requests grant permission to query the data sources of an asset.
* **Masking exception requests**: These access requests grant permission to see unmasked values in specific columns of an asset that are normally protected by a masking policy.

To make one of these access requests, click the access request link on the data object in your data catalog and fill out the request form:

* If approval is not required, access (or the masking exception) is automatically granted once you acknowledge the data use agreement and answer any required question(s).
* If approval is required, the request will enter the approval flow and appear as `Pending`.

Once a request is approved, Immuta automatically provisions access through policies in the data platform and the [access request will show as `Approved`](#review-access-requests):

* For data access requests, the asset itself becomes available to query.
* For masking exception requests, only the approved columns are unmasked for that user, while all other users continue to see masked values.

## Steps to request access

The general process to request access to data and get it automatically provisioned through Immuta is to complete the following steps:

1. Find the data (table, view, data product) in your catalog.
2. [Click the `Request Access` button or the Immuta request link inside the asset](#request-access-button-or-request-link).
3. Sign in to Immuta, if prompted.
4. On the request form, use the radio buttons to show if you are requesting access for yourself or someone else.
5. **Fill out your answer** to the access question(s).
6. Review and **select the checkbox** for the **Data use agreement** tab, if there is one.
7. Click **Submit request**.
8. Get notified by your configured notification provider, if your access request is approved.

{% hint style="warning" %}

### Asset not registered

You may request access to an asset that has not been registered in Immuta yet. This will bring you to an **Asset not registered** screen. Immuta will then notify your administrators of your request, so they can configure the asset.
{% endhint %}

## Request access button or request link

Each supported catalog has differing capabilities with how it integrates with Immuta. See the details for each specific catalog below.

### Alation

{% tabs %}
{% tab title="Alation catalog" %}

1. Search through the data sources in the Alation Catalog.
2. Click on the data source that you want access to.
3. Click **Open With**, and select **Request Access in Immuta**.
4. Sign in to Immuta, if prompted.
5. On the request form, use the radio buttons to show if you are requesting access for yourself or someone else.
6. **Fill out your answer** to the access question(s).
7. Review and **select the checkbox** for the **Data use agreement** tab, if there is one.
8. Click **Submit request**.
   {% endtab %}

{% tab title="Alation Marketplace" %}

1. Search through the data products in the Alation Marketplace.
2. Click on the data product you want access to.
3. Click **Request Access**.
4. Click **Immuta**.
5. Sign in to Immuta, if prompted.
6. On the request form, use the radio buttons to show if you are requesting access for yourself or someone else.
7. **Fill out your answer** to the access question(s).
8. Review and **select the checkbox** for the **Data use agreement** tab, if there is one.
9. Click **Submit request**.
   {% endtab %}
   {% endtabs %}

### Atlan

1. Search through the assets in Atlan.
2. Click on the catalog, schema, or data object that you want access to.
3. Click **Request data access**.
4. Sign in to Immuta, if prompted.
5. On the request form, use the radio buttons to show if you are requesting access for yourself or someone else.
6. **Fill out your answer** to the access question(s).
7. Review and **select the checkbox** for the **Data use agreement** tab, if there is one.
8. Click **Submit request**.

### Collibra

1. Search through the data sets in Collibra.
2. Click on the catalog, schema, or data object that you want access to.
3. Click **Actions**, and select **Request Access through Immuta**.
4. Click **Request Now**.
5. Sign in to Immuta, if prompted.
6. On the request form, use the radio buttons to show if you are requesting access for yourself or someone else.
7. **Fill out your answer** to the access question(s).
8. Review and **select the checkbox** for the **Data use agreement** tab, if there is one.
9. Click **Submit request**.

### Databricks

1. Search through the Databricks Catalog.
2. Click on the catalog, schema, or data object that you want access to.
3. Click **Request permissions**, and then click **Continue to external system(s)**.
4. Sign in to Immuta, if prompted.
5. On the request form, use the radio buttons to show if you are requesting access for yourself or someone else.
6. **Fill out your answer** to the access question(s).
7. Review and **select the checkbox** for the **Data use agreement** tab, if there is one.
8. Click **Submit request**.

Databricks will also present the **Request access** button if you attempt to query a table that you do not yet have access to.

Once you have access, it is possible to request access again using the same button to do a masking exception request.

### Snowflake

{% tabs %}
{% tab title="Access request link in description" %}
If the administrator configured access request links in the descriptions for your Snowflake data, you can make an access request with the following steps:

1. Navigate to a data object you want to access in the Snowflake Catalog.
2. View the description.
3. Click the **Request access** link in the description.
4. Sign in to Immuta, if prompted.
5. On the request form, use the radio buttons to show if you are requesting access for yourself or someone else.
6. **Fill out your answer** to the access question(s).
7. Review and **select the checkbox** for the **Data use agreement** tab, if there is one.
8. Click **Submit request**.
   {% endtab %}

{% tab title="Access request link in contacts" %}
If the administrator configured access request links in the contacts for your Snowflake data, you can make an access request with the following steps:

1. Navigate to the [Snowsight Universal Search](https://docs.snowflake.com/en/user-guide/ui-snowsight-universal-search).
2. Run a search. Results that you do not have access to will present a **Request access** button.
3. Click the **Request access** button.
4. Sign in to Immuta, if prompted.
5. On the request form, use the radio buttons to show if you are requesting access for yourself or someone else.
6. **Fill out your answer** to the access question(s).
7. Review and **select the checkbox** for the **Data use agreement** tab, if there is one.
8. Click **Submit request**.
   {% endtab %}
   {% endtabs %}

[Snowflake contacts limitations](/saas/request/configure/how-to-guides/configure-access-request-links/snowflake-horizon.md#limitations):

* You are only able to see the **Request access** button from [Snowsight in Universal Search](https://docs.snowflake.com/en/user-guide/ui-snowsight-universal-search) results.
* If you have access to at least one object under a database or schema in the Snowsight Universal Search results screen, then the **Request access** button will not appear.

## Review access requests

To review all current and historical access requests that you have made, view the [**Asset Requests** page](https://app.immutacloud.com/marketplace/access-requests).


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://documentation.immuta.com/saas/request/access-data-products/how-to-guides/requesting-access-from-your-catalog.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.