# Grupos

Um grupo é um conjunto de usuários que pode ser vinculado a um ou mais papéis.

## A página de Grupos <a href="#w5vdysfjsn4u" id="w5vdysfjsn4u"></a>

{% hint style="info" %}
Apenas usuários **ativos** serão exibidos em grupos.
{% endhint %}

A página de Grupos exibe uma tabela que mostra os grupos ativos em seu *realm*.&#x20;

Esta tabela mostra o **nome**, **descrição** e **número de membros** de cada grupo.

![](/files/5ye59ZgiEb8ACjCjkemQ)

## Ações <a href="#id-1l3n9ay3fmff" id="id-1l3n9ay3fmff"></a>

### Como criar um grupo <a href="#ic4qogmxjd77" id="ic4qogmxjd77"></a>

Para criar um grupo:

1. Clique no botão **Criar**, no canto superior direito.
2. Preencha o nome e a descrição do grupo.
3. Clique no ícone **+** para atribuir membros ao novo grupo (opcional).

{% hint style="info" %}
Você pode adicionar ou remover membros de um grupo a qualquer momento.
{% endhint %}

4. Clique em **Salvar** para criar o novo grupo.

### Como vincular um papel a um grupo <a href="#ui1k2pip8u4q" id="ui1k2pip8u4q"></a>

{% hint style="info" %}
Você deve criar o papel desejado antes de vinculá-lo a um grupo. [Aprenda mais sobre papéis aqui.](/documentation/developer-guide/pt-br/platform-administration/administration/new-access-control/access-control-roles.md)
{% endhint %}

Para vincular um papel a um grupo:

1. Use a barra de pesquisa ou procure na tabela o grupo ao qual deseja atribuir um papel.
2. Clique no ícone de lápis na coluna **Ações.**
3. Na aba **Permissões**, clique em **Vínculo.**
4. Selecione o papel desejado e o ambiente ao qual deseja atribuir as permissões do papel.
5. Clique em **Salvar.**
6. Escreva uma nota descrevendo os motivos das alterações que você acabou de fazer.
7. Clique em **Editar** para confirmar a ação.

### Como definir permissões de ambiente para um grupo

{% hint style="info" %}
Confira a [documentação de papéis](/documentation/developer-guide/pt-br/platform-administration/administration/new-access-control/access-control-roles.md) para ver quais papeis possuem as permissões necessárias para modificar a variável de ambientes para usuários.&#x20;
{% endhint %}

O parâmetro de ambiente permite que os usuários especifiquem os ambientes (teste ou produção) nos quais um grupo pode executar determinadas tarefas. Se nenhum ambiente for selecionado, o grupo terá acesso a todos os ambientes.

Para definir permissões de ambiente:

1. Use a barra de pesquisa ou pesquise na tabela o grupo que deseja arquivar.
2. Clique no ícone de lápis na coluna **Ações**.
3. Na guia **Permissões**, selecione 1 ou mais ambientes de acordo com a função.
4. Clique em **Salvar**.

### Como arquivar um grupo <a href="#id-9p3yo68cnrdj" id="id-9p3yo68cnrdj"></a>

Se você arquivar um grupo, ele ficará inativo. Os membros de um grupo arquivado perderão as permissões concedidas por ele.

Para arquivar um grupo:

1. Use a barra de pesquisa ou procure na tabela o grupo que deseja arquivar.
2. Clique no ícone da caixa na coluna **Ações**.
3. Escreva uma nota descrevendo os motivos do arquivamento do grupo.
4. Clique em **Arquivar**.

### Como restaurar um grupo

Quando um grupo é restaurado, ele não é mais exibido na lista de grupos arquivados, mas fica visível na lista de grupos ativos. Todas as permissões anteriores vinculadas a um grupo também são restauradas. Um grupo pode ser restaurado a qualquer momento.

Além disso, um grupo mantém os mesmos usuários que já pertencem a ele, desde que estejam ativos.

Para restaurar um grupo:

1. Clique em **Arquivado** no menu suspenso na barra de pesquisa para ver a lista de todos os grupos arquivados.
2. Use a barra de pesquisa para encontrar um grupo específico que deseja restaurar ou ainda o encontre a partir da lista disponível.
3. Clique no ícone de **caixa aberta** no grupo que deseja restaurar.
4. Clique no botão **Restaurar** na caixa de diálogo para confirmar a ação.

<figure><img src="/files/m7GnmHCJOH6DbB39KOHE" alt=""><figcaption><p><em>Restauração de grupos</em></p></figcaption></figure>

## Grupos padrão <a href="#id-4qxm4nw2dj56" id="id-4qxm4nw2dj56"></a>

Além de criar seus próprios grupos, você também pode usar os grupos padrão do Digibee. Cada grupo padrão é vinculado a um conjunto de papéis de sistema. Esses grupos cobrem os tipos de usuários mais comuns da Digibee Integration Platform.

Ao contrário dos [papéis de sistema,](/documentation/developer-guide/pt-br/platform-administration/administration/new-access-control/access-control-roles.md#papeis-de-sistema) os grupos padrão podem ser modificados, excluídos e arquivados.

{% hint style="info" %}
Os papéis de sistema **connectivity-manager** e **connectivity-viewer** não pertencem a nenhum grupo padrão, mas você pode adicioná-los aos grupos que deseja ou criar um grupo novo com esses papéis.
{% endhint %}

| Nome do grupo       | Papéis do sistema                                                                                                                                                                                                                                                                                                                                          |
| ------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| developers          | <p>alert-viewer </p><p>capsule-builder </p><p>deployment-viewer </p><p>pipeline-builder </p><p>pipeline-documentation-viewer </p><p>pipeline-documentation-manager </p><p>pipeline-manager<br>ai-assistant-viewer</p>                                                                                                                                      |
| deployers           | <p>deployment-manager </p><p>deployment-viewer</p>                                                                                                                                                                                                                                                                                                         |
| access-managers     | <p>groups-manager </p><p>idp-access-manager </p><p>roles-manager </p><p>projects-manager</p><p>users-manager</p>                                                                                                                                                                                                                                           |
| governance-managers | <p>account-viewer</p><p>alert-manager</p><p>api-key-manager</p><p>api-key-viewer</p><p>audit-viewer</p><p>capsule-manager</p><p>capsule-publisher</p><p>global-manager</p><p>global-viewer</p><p>licensing-viewer</p><p>multi-instance-manager</p><p>multi-instance-viewer</p><p>pipeline-manager</p><p>relationship-manager</p><p>relationship-viewer</p> |
| credential-managers | <p>account-manager </p><p>api-key-manager</p>                                                                                                                                                                                                                                                                                                              |
| support             | <p>alert-manager</p><p>logs-viewer</p><p>metrics-viewer</p><p>pipeline-executor</p><p>running-executions-manager</p><p>running-executions-viewer</p>                                                                                                                                                                                                       |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.digibee.com/documentation/developer-guide/pt-br/platform-administration/administration/new-access-control/access-control-groups.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.