> For the complete documentation index, see [llms.txt](https://docs.opsmx.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.opsmx.com/administration/manage-teams-and-access.md).

# Manage Teams and Access

The **Access  Management** page displays the organization settings. You can view all the teams created in the organization and the user roles assigned to the teams. 

Navigate to **Setup** > **Access Management**. The Access Management page is displayed. 

* The resources panel displays the total number of integrations, rules and teams associated with each group. 
* The **Teams** panel displays the different teams available in the application. 
* The **Organization User Roles** panel displays the different user groups available in the application. 

<figure><img src="https://content.gitbook.com/content/xDmLTMQiowMHZ4CQPCvT/blobs/sXFdn9Ohh67Tkr8nSNsB/access%20management%20new%20navi.png" alt=""><figcaption></figcaption></figure>

You have options to create teams or groups and add users to the groups, thereby giving different access permissions to the added users.&#x20;

### To Create New Team

1. Click **+ Add Team**.&#x20;

<figure><img src="https://content.gitbook.com/content/xDmLTMQiowMHZ4CQPCvT/blobs/9tDWiN8N5W164rFPDVHP/access%20management%20team.png" alt=""><figcaption></figcaption></figure>

2. An expanded row appears as shown below:

<figure><img src="https://content.gitbook.com/content/xDmLTMQiowMHZ4CQPCvT/blobs/0ht03uqk784A4WgrZrMG/access%20management%20add%20team.png" alt=""><figcaption></figcaption></figure>

2. Enter the required details as shown:
   1. **Name** - Enter a name for the team.
   2. **Team Owner**- Select the owner for the team.
   3. Add related tags to the team. The tags are used to distinguish between the teams in an application.&#x20;
3. Click **Create**.&#x20;

The team is created.&#x20;

### To Add User Roles

You can add user roles to the created teams.&#x20;

1. Click **+ Add User Role**. &#x20;

<figure><img src="https://content.gitbook.com/content/xDmLTMQiowMHZ4CQPCvT/blobs/Bprv6dxE0GaymCDkIn3u/access%20management%20userrole.png" alt=""><figcaption></figcaption></figure>

2. An expanded row appears as shown below:

<figure><img src="https://content.gitbook.com/content/xDmLTMQiowMHZ4CQPCvT/blobs/52y5OjbTFmnHiI0zmW3i/access%20management%20add%20userroles.png" alt=""><figcaption></figcaption></figure>

2. Select the group from the **Select Group** dropdown to which you want to grant permissions.&#x20;
3. Select the required permissions from the **Select Permission** dropdown that you want to assign to the added group. You can give either  **read** (access to only view the applications) or **admin** (access to view and modify the applications) access to the users.&#x20;
4. You can select **Custom** to provide permissions for selected projects, integrations, policies, exceptions, alerts, cluster, license and teams.&#x20;

<figure><img src="https://591284771-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxDmLTMQiowMHZ4CQPCvT%2Fuploads%2Fqz7RkQosBciWIxUjXncA%2Fmanage%20access%20custom.png?alt=media&amp;token=7fea9582-367d-4329-b52a-948b09b98ec3" alt=""><figcaption></figcaption></figure>

5. Click **Save**.&#x20;

The user role gets updated.&#x20;

{% hint style="info" %}
The user roles can be added at the organization level and team level.&#x20;
{% endhint %}

### To Edit a Team

1. Select the team that you want to edit and click on it.
2. In the page that appears, click **Edit Team**.

<figure><img src="https://content.gitbook.com/content/xDmLTMQiowMHZ4CQPCvT/blobs/4MsH3stllbaD6WXS7T7c/access%20management%201.png" alt=""><figcaption></figcaption></figure>

3. Edit the details as needed and click **Update**.&#x20;

<figure><img src="https://content.gitbook.com/content/xDmLTMQiowMHZ4CQPCvT/blobs/1BBuZI3f0D8AL7UiAjgR/access%20management%202.png" alt=""><figcaption></figcaption></figure>

The new details get updated.

### To Generate Token

1. Click on the name of the **Team** (given as tabs in the Teams panel) for which you want to generate token as shown below:

<figure><img src="https://content.gitbook.com/content/xDmLTMQiowMHZ4CQPCvT/blobs/wmGH0XV7SEYbQ0eAgxyg/access%20token%201.png" alt=""><figcaption></figcaption></figure>

2. The details of the **Team** along with its **User Roles** are displayed.&#x20;
3. Click **Generate Token** button as shown below:

<figure><img src="https://content.gitbook.com/content/xDmLTMQiowMHZ4CQPCvT/blobs/WDIBMycqWT1Oh3DKhICx/access%20token%202.png" alt=""><figcaption></figcaption></figure>

A token is created and a success message is displayed as shown:&#x20;

<figure><img src="https://content.gitbook.com/content/xDmLTMQiowMHZ4CQPCvT/blobs/4QH2UHtcmQ15t5jGuvXK/image.png" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
The generated token is provided in the Jenkins plugin to integrate Delivery Shield with it, inorder to connect the applications to the respective teams. To know more, see [Jenkins](https://docs.opsmx.com/opsmx-delivery-shield-platform/getting-started/integrating-ci-and-cd-tools-in-delivery-shield/jenkins).&#x20;
{% endhint %}