Alation

Set up access request links in Alation

Use Alation's data products in their Marketplace or assets in their catalog and configure the access request links so users can click a button directly in Alation to request access. You may also opt to add the access request links to data object descriptions.

Requirements

• Connection registered in Immuta
• Alation user with Marketplace Admin if you are setting up links within Alation data products.

Set up access request links for Alation data products in the Alation Marketplace

1. Publish a data product in Immuta, and take note of the data product ID.
2. Follow the Alation documentation to Create a data product, and enter the Immuta data product ID as the productId field.
3. Follow the Alation documentation to Add delivery systems to your new data product. Insert the access request link for the Immuta data product aligning with the Alation data product in the URI field as seen below and update the accessRequestInstruction field to match the sample provided:

deliverySystems:
  immuta:
    accessRequestInstruction:
      provider: Immuta
      type: external
      uri: "https://app.immutacloud.com/marketplace/data-product/<data product ID>/request-access?type=data-access"
    type: api
    uri: "https://app.immutacloud.com/marketplace/data-product/<data product ID>/request-access?type=data-access"

Set up access request links for Alation assets

Set up your access request links to use the Alation Open With functionality.

1. To set up access request links for access requests under the Open with button, use the Alation API to make a call to the https://<your_alation_url>/integration/v2/catalog_chooser/register_opener/ endpoint with the following payload:

   {
     "name": "Request Access in Immuta",
     "description": "Request access via Immuta Marketplace",
     "endpoint": "https://app.immutacloud.com/marketplace/request?requestType=data-access&host=${dataSource.host}&technology=${dataSource.type}&fullyQualifiedName=${qualifiedName}",
     "endpoint_type": "NAVIGATE",
     "accept_object_types": ["table"],
     "accept_data_source_types": ["snowflake", "databricks", "postgresql", "redshift", "bigquery", "teradata", "presto"],
     "accept_file_system_types": []
   }

2. To set up access request links for masking exception requests under the Open with button, use the Alation API to make a call to the https://<your_alation_url>/integration/v2/catalog_chooser/register_opener/ endpoint with the following payload:

   {
     "name": "Request Masking Exception in Immuta",
     "description": "Request masking exception via Immuta Marketplace",
     "endpoint": "https://app.immutacloud.com/marketplace/request?requestType=masking-exception&fullyQualifiedName=${qualifiedName}",
     "endpoint_type": "NAVIGATE",
     "accept_object_types": ["attribute"],
     "accept_data_source_types": ["snowflake", "databricks", "redshift", "bigquery", "teradata", "presto"],
     "accept_file_system_types": []
   }

This will automatically update all the supported data sources with the request access link to their corresponding asset under the Open with button in Alation.

Alation's Open With functionality is not supported at the database or schema level.