> For the complete documentation index, see [llms.txt](https://docs.collibra.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.collibra.com/data-quality-self-hosted/admin-configuration/admin-console/role-management/connection-management/adding-roles-to-connections.md).

# Adding roles to connections

Administrators can manage the roles assigned to connections on the Connection Management page.

## Steps

{% stepper %}
{% step %}
Sign in to Data Quality & Observability (self-hosted) and click <img src="https://4121921244-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWCrP7Albs8DfJjIQxUxw%2Fuploads%2Fgit-blob-268a786d787f353b92e094a60945df32bf9cb208%2FCogwheelIcon.svg?alt=media" alt="Cogwheel icon" data-size="line"> in the left navigation pane.
{% endstep %}

{% step %}
Click **Admin Console**.
{% endstep %}

{% step %}
Click **Role Management** and then click **Connections**.
{% endstep %}

{% step %}
In the far right column, click <img src="https://4121921244-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWCrP7Albs8DfJjIQxUxw%2Fuploads%2Fgit-blob-5face7f577747d86367bf6698315172b6a3536f5%2FEditIcon.svg?alt=media" alt="Edit icon" data-size="line">.\ <i class="fa-chevrons-right">:chevrons-right:</i> The **Edit Connection \[your connection]** modal displays for that specific role.
{% endstep %}

{% step %}
Map roles to your connection by moving the roles from the **Not included** box to the **Included** box. To do this, select the role(s) you wish to map to your connection, then click <img src="https://4121921244-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWCrP7Albs8DfJjIQxUxw%2Fuploads%2Fgit-blob-6a7c7a806e6f4e24a51783c46471c3a50bc1d56b%2Fdq-next-arrow-icon.png?alt=media" alt="" data-size="line">. You can also filter the roles in the search fields.

{% hint style="info" %}
To remove a role mapping, you can click the left arrow to move the role(s) you select from the **Included** column back to the **Not included** column.
{% endhint %}

![image of edit connection modal with mapped roles](https://4121921244-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWCrP7Albs8DfJjIQxUxw%2Fuploads%2Fgit-blob-1c6218de8f1ad11e88abb3c39d2f208fea6bc939%2Fdq-security-connection-manager.png?alt=media)
{% endstep %}

{% step %}
Click **Save**.
{% endstep %}
{% endstepper %}

The role(s) you mapped to the connection display in the Roles column of the Connection Management table.

![image of connection management table with roles mapped to a connection](https://4121921244-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWCrP7Albs8DfJjIQxUxw%2Fuploads%2Fgit-blob-05f0129b51344d1b5c9734890f99d91fb7e6a6b2%2Fdq-security-connection-manager-roles.png?alt=media)

{% hint style="info" %}
After mapping roles to a connection, any user with those mapped roles can see the connection in Collibra DQ.
{% endhint %}
