# Grupos
Um grupo é um conjunto de usuários que pode ser vinculado a um ou mais papéis.
## A página de Grupos
{% 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*.
Esta tabela mostra o **nome**, **descrição** e **número de membros** de cada grupo.
.png)
## Ações
### Como criar um grupo
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
{% hint style="info" %}
Você deve criar o papel desejado antes de vinculá-lo a um grupo. [Aprenda mais sobre papéis aqui.](https://docs.digibee.com/documentation/developer-guide/pt-br/platform-administration/administration/new-access-control/access-control-roles)
{% 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](https://docs.digibee.com/documentation/developer-guide/pt-br/platform-administration/administration/new-access-control/access-control-roles) para ver quais papeis possuem as permissões necessárias para modificar a variável de ambientes para usuários.
{% 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
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.
Restauração de grupos
## Grupos padrão
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,](https://docs.digibee.com/documentation/developer-guide/pt-br/platform-administration/administration/access-control-roles#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 |
.png)