Buscar K
Aparência
Listar grupos
GET
/tenant/groups
Retorna todos os grupos ativos do tenant com seus membros e permissões.
O que são Grupos?
Grupos são conjuntos de permissões que podem ser atribuídos a múltiplos usuários.
Isso simplifica a gestão de acesso, pois ao invés de configurar permissões
individualmente para cada usuário, você configura uma vez no grupo.
Herança de Permissões
Um usuário herda as permissões de todos os grupos aos quais pertence:
- Se pertence a um grupo com acesso à Mesa A, terá acesso à Mesa A
- Se pertence a um grupo com app X bloqueado, terá app X bloqueado
Importante: Permissões individuais do usuário podem sobrescrever as do grupo.
Campos Retornados
| Campo | Descrição |
|---|---|
id |
ID do grupo |
nome |
Nome do grupo |
bi_desks |
IDs das mesas de BI liberadas |
apps_deny |
IDs das aplicações bloqueadas |
table_restrictions |
Restrições de dados por tabela |
users |
IDs dos usuários membros |
Autorizações
tenantBearerAuth
Token de acesso do tenant
TipoHTTP (bearer)
Respostas
Lista de grupos retornada com sucesso
application/json
JSON
{
"status": "success",
"data": [
{
"id": 1,
"nome": "Administradores",
"bi_desks": [
1,
2,
3
],
"apps_deny": [
],
"table_restrictions": [
],
"users": [
1,
5,
8
]
},
{
"id": 2,
"nome": "Analistas Regionais",
"bi_desks": [
1
],
"apps_deny": [
5,
6
],
"table_restrictions": [
{
"tableId": 10,
"filters": "regiao = 'Sul'"
}
],
"users": [
2,
3,
4
]
},
{
"id": 3,
"nome": "Visualizadores",
"bi_desks": [
1
],
"apps_deny": [
2,
3,
4,
5,
6
],
"table_restrictions": [
],
"users": [
6,
7
]
}
]
}