# Managing Connectors

Our library of connectors, AnyConnect™, offers a seamless integration to external data providers, enabling you to leverage data from your systems for Toucan visualizations. The library is specifically designed to connect to the most widely used and modern databases and data warehousing tools available in the market.

We provide two types of connectors:

1. **Generic Connectors**: These connectors allow you to connect to multiple data sources, but they require advanced configuration to establish the connection.
2. **Specific Connectors**: Built for individual data sources, these connectors feature a user-friendly interface that only requires the relevant information for authentication and establishing a connection to the specific data source

## Add a connector

A list of connectors will be displayed where you can choose a connector from the list of available connectors.

1. To add a connector, in the `Datasources` tab of `DataHub`, click on `Add a connector` button.

   <figure><img src="https://1809014303-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZxYYf1KpgarKMgMsDCrw%2Fuploads%2Fgit-blob-bf1e856dc3757c54d29e8c321b9903b5c193ad64%2Fimage%20(33).png?alt=media" alt=""><figcaption></figcaption></figure>
2. A modal window will open. Select the connector you want to add among the list of connectors displayed
3. [Configure the connector and save it](https://docs-v3.toucantoco.com/data-management-in-datahub/datasources-in-toucan/managing-connectors/setting-up-a-connector). A modal will opened with the configuration form specific to the connector. form The connector will appear within the listing of configured connectors.
4. Click on `Test the connection` if the option is available or `Save` to add the connector

{% hint style="info" %}
**Note**

Some connectors need a specific installation. Please create a ticket to our support team if you want us to set up one of these connectors on your Toucan instance.
{% endhint %}

## Edit a connector configuration

To edit a connector configuration

1. Click on the "Settings" action within the actions menu of the connector you want to edit

![](https://1809014303-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZxYYf1KpgarKMgMsDCrw%2Fuploads%2Fgit-blob-aa31aca8b83fcc15cb44028200d863b7cd61e679%2Fimage.png?alt=media)

1. Edit the configuration of the connector and save it

## Delete a connector

To delete a connector:

1. Click on the three dots button, a "Delete" option is displayed![](https://1809014303-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZxYYf1KpgarKMgMsDCrw%2Fuploads%2Fgit-blob-aa31aca8b83fcc15cb44028200d863b7cd61e679%2Fimage%20\(30\).png?alt=media)
2. Confirm the deletion of the connector. If a dataset uses the connector you are trying to delete, you will have a warning message and be able to select child datasets that you would like to delete simultaneously.

## Test connection

Before saving your connector configuration, the test connection option allows you to verify that your configuration is correct by testing a simple call to check that your Toucan workspace is able to communicate with your data source.

This option is primarily available for SQL databases.

{% hint style="info" %}
We support test connection for the following connectors:\
\- AWS Athena\
\- AWS S3\
\- Databricks\
\- Google Big Query\
\- MongoDB\
\- MySQL\
\- PostGresSQL\
\- AWS Redshift\
\- Snowflake
{% endhint %}

for some connectors, before clicking on save button, a test connection button is available.

* After testing a connection, a modal will opened, the test connection is successful:

<figure><img src="https://1809014303-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZxYYf1KpgarKMgMsDCrw%2Fuploads%2Fgit-blob-0a7ef135c4410d239df7ce991364e4930bac1a36%2FDocumentation_athena_Connection%20Test.gif?alt=media" alt="AWS Athena Connection Test"><figcaption><p>AWS Athena Connection Test</p></figcaption></figure>

<figure><img src="https://1809014303-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZxYYf1KpgarKMgMsDCrw%2Fuploads%2Fgit-blob-603cb1e68ea74e388d9522a597696fed8a364bda%2Fimage.png?alt=media" alt="PostGreSQL Connection Test" width="375"><figcaption></figcaption></figure>

* if the connection is not successful, the modal will show where the problem might be:

### 🔒 Security

Security is a core priority in how we interface with your data systems:

* **Read-Only Access**: We operate in a non-intrusive way (only reading data). It does not have the ability to write, modify, or administer your data sources.
* **Least Privilege Principle**: We **strongly recommend** using a **read-only account** when configuring a connection. This minimizes potential risk and aligns with best practices for access control.
* **Encrypted Connections**: All data communications between Toucan and your source systems are encrypted. Connections with databases use secure protocols, and all interactions with the Toucan platform go through **HTTPS**.
* **Certificate Management**: By default, We support **trusted certificates**. If needed, it is also possible to configure a **custom certificate chain** for some connectors.
* **No Persistent Live Data Storage**: Data is not stored at rest unless explicitly configured in **stored mode**. In its default behavior, AnyConnect™ streams data only for immediate use in visualizations. See [Stored and Live Datasets](https://docs-v3.toucantoco.com/data-management-in-datahub/datasets-in-toucan/stored-and-live-datasets) for more information
* Secrets management: all secret fields related to your connectors are stored in a Vault using [**Hashicorp Vault**](https://www.vaultproject.io/)

{% hint style="info" %}
Access to a workspace's secrets is handled as follows:

* The dataset service, to access a workspace's secrets, checks if it has a valid token for the given workspace, generating one if needed via Kubernetes authentication (Tokens are valid for one hour and are only stored in memory).
* A token only allows access to the secrets of a single workspace, thus ensuring segregation of access to a workspace's secrets
  {% endhint %}

<table data-view="cards"><thead><tr><th></th><th></th><th></th></tr></thead><tbody><tr><td></td><td><a data-mention href="https://github.com/ToucanToco/doc-v3/blob/main/data-management-in-datahub/datasources-in-toucan/managing-connectors/broken-reference/README.md">https://github.com/ToucanToco/doc-v3/blob/main/data-management-in-datahub/datasources-in-toucan/managing-connectors/broken-reference/README.md</a></td><td></td></tr><tr><td></td><td><a data-mention href="managing-connectors/setting-up-a-connector">setting-up-a-connector</a></td><td></td></tr></tbody></table>
