Atlan ᴮᴱᵀᴬ

The Atlan integration allows Sifflet to retrieve metadata from Atlan and enrich business context, helping you create more relevant monitors and better understand the impact of data issues.

With this integration, you can:

• Import metadata from Atlan into Sifflet
• View Atlan metadata directly on asset pages
• Use selected metadata as Data Catalog filters
• Open assets directly in Atlan from Sifflet

---

What Does the Integration Support?

The integration currently supports importing the following metadata from Atlan:

• Official descriptions
• Terms
• Tags
• Owners
• Custom metadata fields defined in Atlan

---

Setting Up the Connection

You configure the Atlan integration as a source in Sifflet using OAuth authentication.

Before configuring the integration, you must:

• Have access to an Atlan instance
• Create OAuth credentials in Atlan

You can follow the official Atlan documentation here: Atlan OAuth Documentation

---

1. Create a New Source in Sifflet

Go to:

• Integration Settings
• Click Create New Source
• Select Atlan

---

2. Configure Your Atlan Credentials

Provide the following information:

• Source name

• Atlan tenant URL (example: https://your-company.atlan.com)

• Credential. To create one:

  1. Click New Credential in Sifflet.

  2. Copy-paste the text below and replace the values with the client ID and client secret provided by Atlan:

     JSON

     {
       "client_id": "<clientId>",
       "client_secret": "<clientSecret>"
     }

  3. Save the configuration.

  

These credentials allow Sifflet to securely authenticate and retrieve metadata from Atlan.

---

3. Select Metadata to Import

Once the connection is configured:

1. Click Load Metadata
2. Select which metadata categories to synchronize into Sifflet
3. Enable the metadata you want to use as Data Catalog filters

Save the configuration once your selection is complete.

Managing Metadata Filters

As an administrator, you can control which metadata appears as filters in the Data Catalog.

To update available filters:

1. Edit the Atlan source configuration
2. Enable or disable the desired metadata
3. Save the source
4. Run synchronization again

Once synchronization is complete, the selected metadata will appear as filters in the Data Catalog.

---

4. Asset Mapping

Sifflet maps assets based on the Atlan connection associated with the corresponding Sifflet source. This ensures metadata retrieved from Atlan is correctly linked to the corresponding assets already present in Sifflet.

1. Click Load Assets
2. Select the Atlan integration
3. Match it with the corresponding Sifflet source
4. Choose the synchronization frequency
5. Click Test before saving to ensure the configuration is valid.

---

How Metadata Appears in Sifflet

Metadata imported from Atlan is treated as external metadata. This works similarly to metadata retrieved from external systems such as Snowflake and BigQuery.

Asset Views

Imported metadata is visible:

• On asset detail pages
• Within Data Catalog filters (depending on enabled metadata)

This allows you to enrich asset discovery and observability workflows with additional business context.

Data Catalog Filters

Imported metadata can be used as filters in the Sifflet Data Catalog based on the metadata enabled during source configuration.

Open Assets in Atlan

An Open in Atlan button is available when an asset is linked to Atlan.

---

Error Handling

If synchronization errors occur:

• Errors are surfaced similarly to other Sifflet source errors
• As an administrator, you can review logs directly from the source configuration