Manage Authentication to Data Products¶
Alation Cloud Service Applies to Alation Cloud Service instances of Alation
When you authenticate to a data product to use the chat, Alation securely stores your connection credentials as a user connection. These connections are reused across multiple data products built on the same underlying database.
The Manage Authentication feature provides a centralized view of all your connections established across data products in the Marketplace. From this page, you can review connection details, test a connection, search and filter connections, and delete credentials that are no longer in use.
Note
Manage Authentication is available if the Chat with Data Products feature is enabled on your instance. The capabilities are available to all users who can view the Marketplace and have access to data products where Chat is enabled.
In this topic:
Access Manage Authentication¶
To access Manage Authentication:
In the left-side navigation, click the Data Products App icon. Expand the navigation panel if it’s collapsed.
In the Data Products App navigation, click Manage Authentication.
The Manage Data Connections dialog displays all connections that you have established with data products in the Marketplace. If no connections have been established, the dialog will be empty.
View Connection Details¶
Click any connection card to expand it and view the connection’s details.
The expanded card shows:
Connection type: An icon representing the data source type (for example, Snowflake, PostgreSQL, Databricks).
Connection URI: The connection string for the data source. Click the copy icon on the left of the URI to copy it to your clipboard.
Auth ID: A unique identifier for the credential. Click the copy icon to copy it to your clipboard.
Connection status: A color-coded status chip indicating whether the connection is active:
Connected: The connection is active and credentials are valid.
Not connected: The connection is inactive because the credentials have expired.
Total connections count: Shown at the top right of the dialog, displaying the total number of connections.
Authentication Type: The method used for authentication (for example, Basic, OAuth)
Username: The username configured for the connection.
Used by data products: The name of the data product that uses this connection. Click the data product name to navigate to its page.
Note
If a connection is no longer associated with any data product, a warning message is displayed: No data products are associated with this connection. Consider deleting unused connections to keep credentials organized.
You have these capabilities:
Filter Connections¶
Use the Filter list within the Manage Data Connections dialog to narrow the list of displayed connections. When filters are active, the modal shows how many connections match the selected criteria (for example, Showing 2 of 5).
To filter connections:
In the Manage Data Connections dialog, click the Filter list to expand it. The filter categories include Authentication type, Connection status, and Used by data product:
Filter |
Description |
|---|---|
Authentication type |
Filter by the type of authentication used by the connection. Options include:
Only authentication types that are in use across your connections appear in the filter list. |
Connection status |
Filter by the current connection status:
|
Used by data product |
Filter by the data product associated with the connection. Select one or more data products to show only their connections. Only data products that have configured connections appear in this list. |
Use the Search box at the top of the filter popover to search within the filter options.
Select one or more options within a filter category. You can combine selections across multiple categories. Filters are applied immediately.
To remove all active filters, click Clear all filters next to the Filter button.
Test a Connection¶
You can validate that the configured credentials can successfully connect to the underlying data source. Testing a connection helps confirm that authentication is working correctly.
To test a connection:
Open the Manage Authentication dialog.
Click a connection card to expand it.
Under Connection Status, click Test connection. Alation initiates a background connection test against the data source. The button shows a loading indicator while the test is in progress.
The test result appears next to the button:
Success: The credentials are valid and the connection to the data source succeeded.
Test connection failed: The connection could not be established. An error message is displayed with additional details. Review the credential configuration and ensure the data source is accessible.
Note
Connection tests run asynchronously in the background. The status may take a moment to update after you initiate the test.
Delete a Connection¶
To delete a credential that is no longer needed:
In the Manage Data Connections dialog, click a connection card to expand it.
At the bottom right of the card, click Delete connection.
In the confirmation dialog, confirm the deletion. The connection is permanently removed and the list refreshes.
Important
Deleting a connection removes the stored credentials. Users of the associated data product will need to re-authenticate the next time they access the data product Chat.