Skip to content

Configure Starburst Integration

Audience: System Administrators

Content Summary: This page details how to install the Starburst integration. Starburst is only available with certain licenses. Please see your Immuta representative for more information.

Prerequisites: The Starburst ODBC driver must be uploaded on the App Settings page.

Installation Method

This installation method is only available to users on Starburst Enterprise.

1 - Enable the Integration

  1. Click the App Settings icon in the left sidebar.
  2. Scroll to the Native Integrations section and click Add Native Integration.
  3. Select Trino from the Native Integration Type dropdown menu.

    Trino Enable

  4. Click Save.

2 - Configure the Immuta Connector in Starburst

  1. Create a configuration file immuta.properties with the following contents in the etc/catalog folder:

    connector.name=immuta
    immuta.endpoint=https://your-immuta-url.com/
    immuta.apikey=<your-api-key>
    

For more details, see Starburst's Event Listener documentation.

3 - Configure the Event Listener

  1. Create an etc/event-listener.properties file in the same etc/catalog folder.
  2. Copy the Event Listener Configuration items from the App Settings page and paste it in the event-listener.properties file:

    Dynamic Trino Event Listener

For more details, see Starburst's Event Listener documentation.

4 - Configure Starburst to Block Access

Best Practice: Give Users read-only Access to Immuta Catalog

Give users read-only access to the Immuta catalog. This will prevent users from describing the views, which in turn prevents them from seeing secrets involved in some masking policies.

Follow Starburst's System Access Control documentation to configure Starburst to block access to any catalog that is not Immuta so that all user access has policies enacted on it.