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

You can use Alation data products with assets, or you can mirror your Alation data products in Immuta. See the tabs below for instructions for each option.

Use assets

1. Follow the Alation documentation to Create a data product.

2. Follow the Alation documentation to Add delivery systems to your new data product. Insert the access request link for the asset aligning with the 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/00868568-30bc-4c8a-b36c-d88afa2c01d3/request-access?type=data-access"

Use data products

Set up access request links for Alation assets

1. To set up access request links for access requests, 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?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": ["s3"]
   }

2. To set up access request links for masking exception requests, 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?host=${dataSource.host}&technology=${dataSource.type}&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 catalog does not support access request links in databases or schemas.