# Configure an External Catalog

This page outlines how to connect an external catalog on the Immuta app settings page. For details on external catalogs with Immuta, see the [External catalog reference page](/2024.2/data-and-integrations/catalogs/reference-guides/pre-configuration.md).

## Link an Alation catalog

**Requirements**:

* `APPLICATION_ADMIN` Immuta permission
* An [Alation API access token](https://developer.alation.com/dev/docs/authentication-into-alation-apis#create-an-api-access-token) connected to a user with the [<mark style="color:blue;">`Server Admin`</mark>](https://developer.alation.com/dev/docs/alation-apis-by-roles) permission

{% hint style="info" %}
To change the default expiration period for your Alation catalog's API tokens, see [configure the expiration period for Alation API tokens](https://docs2.alationdata.com/en/latest/admins/AdditionalConfiguration/ConfigureAPITokensManagement.html#configure-the-expiration-period-for-api-tokens).
{% endhint %}

1. Navigate to the **App Settings** page.
2. Scroll to **2 External Catalogs**, and click **Add Catalog**.
3. Enter a **Display Name** and select **Alation** from the dropdown menu.
4. Complete the **URL** and **API key** fields. The API key must be an API access token for your Alation instance connected to a user with the [<mark style="color:blue;">`Server Admin`</mark>](https://developer.alation.com/dev/docs/alation-apis-by-roles) permission.
5. Configure whether or not Alation tags and custom fields are imported as Immuta tags:
   * **Link Alation tags**: When selected, Immuta imports Alation tags as Immuta tags.
   * **Link Alation Custom Fields**: When selected, Immuta imports Alation custom fields as Immuta tags. Follow the Alation documentation to [create an Alation custom field](https://docs.alation.com/en/latest/steward/TemplatesAndCustomFields/ManageCustomFields.html#create-or-edit-a-custom-field), [add permissions to your custom field](https://docs.alation.com/en/latest/steward/TemplatesAndCustomFields/ManageCustomFields.html#add-permissions-to-a-custom-field), and apply custom fields to tables and columns.
6. Opt to select **Upload Certificates**.
   1. Upload the **Certificate Authority**, **Certificate File**, and **Key File**.
   2. Opt to enable **Strict SSL** by selecting the checkbox.
7. Click the **Test Connection** button.
8. Once the connection is successful, click **Save**.

## Link a Collibra catalog

**Requirement**: `APPLICATION_ADMIN` Immuta permission

1. Navigate to the **App Settings** page.
2. Scroll to **2 External Catalogs**, and click **Add Catalog**.
3. Enter the **Display Name** and select **Collibra** from the dropdown menu.
4. Enter the HTTP endpoint of the catalog in the **URL** field.
5. Complete the **Username** and **Password** fields. *Note: This is the username and the password that Immuta can use to connect to the external catalog.*
6. Opt to **Require the data source name in Collibra to contain both the schema and table name** by selecting the checkbox.
7. Complete the **Asset Mappings** modal to set which asset types in Collibra should align to Immuta's data sources and columns.
8. Complete the **Attributes as Tags** modal to specify which Collibra attributes you would like to pull in as tags in Immuta.
9. Opt to select **Upload Certificates**.
   1. Upload the **Certificate Authority**, **Certificate File**, and **Key File**.
   2. Opt to enable **Strict SSL** by selecting the checkbox.
10. Click the **Test Connection** button.
11. Once the connection is successful, click **Save**.

## Link a Custom REST Catalog

**Requirement**: `APPLICATION_ADMIN` Immuta permission

Integrating a Custom REST Catalog service with Immuta requires implementing a REST interface. For details about the necessary endpoints that must be serviced, see the [Custom REST Catalog Interface Endpoints page](/2024.2/data-and-integrations/catalogs/reference-guides/custom-rest-catalogs/interface.md).

1. Navigate to the **App Settings** page.
2. Scroll to **2 External Catalogs**, and click **Add Catalog**.
3. Enter the **Display Name** and select **Rest** from the dropdown menu.
4. Select the **Internal Plugin** checkbox if the catalog has been uploaded to Immuta as a custom server plugin.
5. Complete the following fields:
   1. Enter the HTTP endpoint of the catalog in the **URL** field.
   2. Complete the **Username** and **Password** fields.
   3. Enter the path of the **Tags Endpoint**.
   4. Enter the path of the **Data Source Endpoint**.
   5. Enter the path to the information page for a data source in the **Data Source Link Template** field.
6. Opt to enter the path to the information page for a column in the **Column Link Template** field.
7. Opt to upload a **Catalog Image**.
8. Opt to select **Upload Certificates**.
   1. Upload the **Certificate Authority**, **Certificate File**, and **Key File**.
   2. Opt to enable **Strict SSL** by selecting the checkbox.
9. Click the **Test Connection** button.
10. Click the **Test Data Source Link**.
11. Once both tests are successful, click **Save**.

## Enable Snowflake Tag Ingestion

{% hint style="info" %}
**Snowflake user authentication**

To configure Snowflake tag ingestion, which syncs Snowflake tags into Immuta, you must provide a Snowflake user who has, at minimum, the ability to set the following privileges:

* `GRANT IMPORTED PRIVILEGES ON DATABASE snowflake`
* `GRANT APPLY TAG ON ACCOUNT`
  {% endhint %}

1. Navigate to the **App Settings** page.
2. Scroll to **2 External Catalogs**, and click **Add Catalog**.
3. Enter a **Display Name** and select **Snowflake** from the dropdown menu.
4. Enter the **Account**.
5. Enter the **Authentication** information: **Username**, **Password**, **Port**, **Default Warehouse**, and **Role**.
6. Opt to enter the **Proxy Host**, **Proxy Port**, and **Encrypted Key File Passphrase**.
7. Opt to **Upload Certificates**.
8. Click the **Test Connection** button.
9. Click the **Test Data Source Link**.
10. Once both tests are successful, click **Save**.

## Manually Link Catalogs to Data Sources

For pre-existing data sources in Immuta, you can manually link them to external catalogs from the Data Source Details tab.

1. Navigate to your data source and click **Link** in the **Data Catalog** section on the right side of the page.
2. Select your **external catalog** from the dropdown menu.
3. Click **Link** to confirm.


---

# 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/2024.2/data-and-integrations/catalogs/configure.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.