Skip to main content

Data Connection Manager: Server UI

Data Connection Manager (DCM) is a centralized storage for Database and Cloud interoperable connections (credentials linked to data sources) that facilitates workflow connection management and collaboration across Alteryx products. Use DCM to enter and use your connections and credentials among tools and workflows. DCM allows you to synchronize credentials between Server and Designer. Go to the DCM help page for more info.

To configure DCM for your Server, visit the DCM - Server help page.

In the Server UI, Data Connection Manager consists of 3 parts: DCM Data Sources, DCM Vaults, and DCM Credentials.

DCM Credentials

Add a Credential

To add a credential, go to DCM Credentials in the Server UI.

  1. Select +Add Credential.

  2. Enter a Credential Name. This is a user-friendly name for the credential. We recommend using a name that will help you to keep the usage for this credential obvious and keep the names distinct.

  3. Select DCM in Vault dropdown.

  4. Select Method for the credential. Select one of the authentication methods. Below are a few (but not all) examples:

    • AWS IAM Access Keys: Enter Access Key ID and Secret Access Key. Use this method to access S3 download/upload, Redshift bulk output, Athena bulk output, and Snowflake bulk output.

    • Azure SharePoint App-Only: Enter Client ID and Secret Key. Use this method to access SharePoint Lists input/output.

    • Azure User-Assigned Managed Service Identity: Enter Object ID. Use this method to access Azure SQL (such as Analytics Platform, SQL Data Warehouse, Azure SQL, and more).

    • Microsoft Azure SQL Database Service Principal: Enter Client ID and Client Secret. Use this method to access Azure SQL.

    • Username: Enter a Username. Use this method to access almost all data sources.

    • Username and password: Enter a Username and Password. Use this method to access almost all data sources.

  5. Select Save.

The credential displays in the DCM Credentials list.

DCM Data Sources

Add a Data Source

To add a data source, go to DCM Data Sources in the Server UI.

  1. Select Add Data Source.

  2. Select Technology.

  3. Enter the required information, which depends on the selected Technology, such as Datasource Name, Server, Driver, Host, or Database.

  4. Select Save.

The data source displays in the DCM Data Sources list.

Create a Connection

To connect a credential to a data source, go to DCM Data sources in the Server UI.

  1. In the data source list, select the data source you want to connect to a credential.

  2. In the data source details page, select + Connect Credential.

  3. Select the Authentication Method from the drop-down list.

  4. Select the desired credential in the Credential drop-down.

  5. Select Link.

The combination of a data source with a linked credential is considered a connection. The created connection displays in Connections for the selected data source.

Edit a Connection

To edit an existing connection, go to DCM Data sources in the Server UI.

  1. In the data source list, select the data source for which you want to edit an existing connection.

  2. In the 3-dot menu, select Edit.

  3. Update the connection and select Save and Link.

Share a Connection with Users and Groups

After you create a connection, you can share it with users or custom groups. There are 2 ways of sharing a connection, which are mutually exclusive—once you share the connection in 1 way, you can't share the other way. You must share a connection with everyone the same way.

  • Share for Collaboration: Share a connection allowing multiple users to collaborate on creating workflows. This form of sharing allows other users to synchronize the connection to their instance of Designer to build workflows using this connection.

    • The connection owner can choose to share their credentials together with the connections. If they choose to, other users won’t be able to view the secrets but will be able to use them in workflows. Other users won’t be able to reuse the shared credentials in any other connection—it will be bound to the shared connection only. If the connection owner decides to not share the credentials, each user must then connect their own credentials—for the same authentication method—in order to use the connection.

    • No updates in workflows are necessary to execute the workflow by other users who have this connection shared.

    • Only Server Curators are allowed to share connections for Collaboration.

  • Share to Run on Server Only: Share a connection for workflow execution on Server. The user can’t see the connection, nor can they synchronize it and use it in Designer.

    • With this form of sharing, the user the connection is shared with does not receive a notification or see information about the connection. They can, however, use the connection to run workflows. The only way they know that the connection has been shared is because they can run workflows.

  1. On the DCM Data Sources page, select the connection you want to share.

  2. In the 3-dot menu, select Share.

  3. In the Share Connection window, select Users or Custom Groups, then Add User or Add Group.

  4. Enter the name of a user or group.

  5. Select the user or group.

  6. Select the desired form of sharing, either Share for Collaboration or Share to Run on Server Only.

  7. Select Add. The added users or custom groups display in the Users or Custom Groups list.

  8. Select Done.

The Server UI lists the user or group you share the connection with on the corresponding tab. Go to the DCM help page to see how users access and manage shared credentials in Designer.

Revoke Access to a Connection

To revoke a user's or group's access to a connection, go to DCM Data sources in the Server UI.

  1. In the data source list, select the connection of a data source you want to share.

  2. In the 3-dot menu, select Share.

  3. In the Share Connection window, select the trash icon next to the user or group name. To confirm, select Remove.

  4. Select Done.

Note

For Share for Collaboration, please be aware that the user will retain this shared access in Designer until they next synchronize their DCM Connections with the Server.

Change the Sharing Mode

Since connection sharing modes are mutually exclusive, to change from Share for Collaboration to Share to Run on Server Only, you must first unshare the connection with all users and user groups.

Remove a Connection

To remove an existing connection, go to DCM Data sources in the Server UI.

  1. In the data source list, select the data source for which you want to remove an existing connection.

  2. In the 3-dot menu, select Unlink.

  3. To remove the connection, select Delete in the pop-up window.

Technology List

When you are adding a data source, you can select the technology from the list available at DCM Supported Connectors and Tools.

DCM Vaults

The DCM Vault feature allows you to connect DCM with your Vault of choice (see supported vaults). Thus, you can use DCM Vaults to fetch credentials from your Vault and securely use them in your workflow.

To configure DCM Vaults, DCM must be enabled. Learn how to enable DCM in the DCM - Server article.

Connect DCM to External Vault

To connect DCM to your Vault:

  1. In Server UI, select DCM Vaults.

  2. Select +New.

  3. Choose Technology from the dropdown.

  4. Enter the Data Source Name.

  5. Enter the address of your Vault into the URL input. Fore more information, go to DCM External Vaults.

  6. Select Save.

Next, create credentials to authenticate to your Vault:

  1. Under Connections, select +Connect Credential.

  2. Choose an Authentication Method.

  3. Fill in the credential information. In case you don't have an existing credential, you can create a credential by selecting Create New Credential in the dropdown.

  4. Select Link if you are adding an existing credential or Create and Link if you are adding a new credential.

You are now able to select this Vault as a source of credentials.

Edit Vault Credential

  1. Go to DCM Vaults.

  2. Select which credential to edit.

  3. Select Edit.

  4. Update credential details.

  5. Select Save.

Delete Vault Credential

  1. Go to DCM Vaults.

  2. Select which vault to delete.

  3. Select the trashcan icon.

  4. Select Delete to confirm.

Supported Vaults

  • AWS Secrets Manager

  • CyberArk Conjur

  • Hashicorp Vault (KV secrets engine)

Synchronize DCM between Server and Designer

To synchronize DCM between Server and Designer, follow these steps:

  1. Go to Designer > File > Manage Connections to open Connection Manager. Then select Synchronize in the menu.

  2. Select from the list the Server you want to synchronize.

  3. Select Synchronize.

After you have synchronized DCM between Server and Designer, any credentials you own and all data sources you have access to will be visible and ready for use in Connection Manager.

Note

Admins can select from DCM connections synchronization options from Server to Designer and from Designer to Server in System Settings > DCM. For more information, go to DCM - Server.