> For the complete documentation index, see [llms.txt](https://wiki.datadike.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.datadike.com/pt/pam/administration/identities/roles.md).

# Funções e permissões

O que um usuário pode fazer dentro do console, como as funções de organização diferem das funções de sistema e como a multi-tenancy delimita o alcance delas.

## O que é isto e quando usar

Uma função decide o que uma pessoa pode fazer **dentro do console**: quais telas ela vê e quais ações pode executar nelas.

Não é uma [autorização](https://wiki.datadike.com/pt/pam/administration/access/authorizations.md), que decide quais ativos e contas ela pode alcançar. Um auditor pode ter uma função poderosa e nenhuma autorização; essa é uma configuração normal e desejável.

Há dois níveis, e confundi-los é a origem habitual do "por que ele consegue ver isso?":

| Nível                     | Alcance                                                                     |
| ------------------------- | --------------------------------------------------------------------------- |
| **Função na organização** | Vale **apenas dentro de uma organização**. Totalmente personalizável        |
| **Função do sistema**     | Vale em toda a solução: administrador global, auditor de logs e semelhantes |

Um usuário que pertence a várias organizações pode ter uma função diferente em cada uma. Ser *Org Admin* em Desenvolvimento e *Org Auditor* em Produção é um arranjo normal.

## Multi-tenancy

A solução implementa multi-tenancy por organização. Cada organização é um tenant isolado dentro de uma única instância.

| Propriedade             | O que significa                                                                                         |
| ----------------------- | ------------------------------------------------------------------------------------------------------- |
| Isolamento de dados     | Cada organização tem seus próprios usuários, ativos, contas, permissões e rótulos, totalmente separados |
| Organização padrão      | Existe sempre e não pode ser removida. É a organização principal da instância                           |
| Troca de contexto       | O usuário troca de organização pelo seletor no topo da interface                                        |
| Isolamento de auditoria | O auditor de uma organização vê apenas os logs e as sessões dessa organização                           |
| Escopo dos recursos     | Funções, ativos e aplicações ficam restritos à organização onde foram criados                           |
| Sem compartilhamento    | Os recursos não são compartilhados entre organizações                                                   |

## Funções de organização nativas

![A tela de funções](https://2577774576-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmW94amWe62SEQe4f16Vs%2Fuploads%2Fgit-blob-9a4344f5a9264459aa6126c25d7c5a27656ac44b%2Froles.png?alt=media)

**1** Quantas funções existem.

Três acompanham o produto e não podem ser editadas nem excluídas:

| Função          | Para que serve               | Principais permissões                                                                         |
| --------------- | ---------------------------- | --------------------------------------------------------------------------------------------- |
| **Org Admin**   | Administrador da organização | Gestão completa de usuários, ativos, contas, permissões e configurações dentro da organização |
| **Org Auditor** | Auditor da organização       | Visualização de logs, sessões, gravações e relatórios de auditoria da organização             |
| **Org User**    | Usuário comum                | Acesso à área de trabalho, conexão aos ativos autorizados e terminal web                      |

## Módulos de permissão

Uma função de organização personalizada é montada concedendo permissões por módulo:

| Módulo                       | Permissões típicas                                                |
| ---------------------------- | ----------------------------------------------------------------- |
| Console (Ativos)             | Ver, criar, editar e excluir os ativos e as pastas da organização |
| Console (Usuários)           | Ver, criar e editar os usuários e grupos da organização           |
| Console (Contas)             | Ver e gerenciar as contas dos ativos da organização               |
| Console (Autorizações)       | Criar e editar regras de autorização                              |
| Auditoria                    | Ver os logs, as sessões e as gravações da organização             |
| Área de trabalho (Operações) | Executar e gerenciar tarefas na organização                       |

## Passos: criar uma função personalizada

1. Abra **Usuários › Funções › Funções da organização**.
2. Clique em **Criar** e defina o **nome** e um **comentário** descrevendo para que serve a função. Escreva o comentário: daqui a seis meses ele será o único registro da intenção.
3. Salve e abra a página de detalhes da função.
4. Em **Informações da função › Permissões**, marque as permissões de cada módulo.
5. Clique em **Salvar**.

## Atribuir uma função

Há dois caminhos, e o resultado é o mesmo:

* **Pelo usuário**: edite o usuário e preencha o campo **Função na organização**
* **Pela função**: abra os detalhes da função e, em **Usuário autorizado**, clique em **Adicionar**

## Como verificar se funcionou

1. Entre como um usuário que tem a função, ou peça que ele entre.
2. Confirme que o console mostra exatamente as áreas que a função concede, e nenhuma outra.
3. Confirme que ele *não consegue* alcançar uma tela que a função não concede. Testar apenas o que deveria funcionar deixa o excesso de permissão sem ser detectado, e o excesso de permissão é a falha que importa aqui.

## Referência de campos

| Campo                                 | O que significa                                                                         |
| ------------------------------------- | --------------------------------------------------------------------------------------- |
| Nome                                  | O nome da função dentro da organização                                                  |
| Quantidade de usuários                | Quantos usuários a possuem                                                              |
| Nativa                                | Se acompanha o produto e não pode ser editada nem excluída                              |
| Comentário                            | Texto livre descrevendo a finalidade da função                                          |
| Escopo                                | O contexto em que a função se aplica. Para funções de organização, sempre *Organização* |
| ID                                    | Identificador interno                                                                   |
| Data de criação / Data de atualização | Criação e última alteração                                                              |
| Criador / Atualizado por              | Quem criou e quem alterou por último                                                    |

## Páginas relacionadas

* [Usuários e grupos](https://wiki.datadike.com/pt/pam/administration/identities/users-and-groups.md)
* [Autorizações](https://wiki.datadike.com/pt/pam/administration/access/authorizations.md): quais ativos, e não quais telas
* [Boas práticas de permissão](https://wiki.datadike.com/pt/pam/administration/access/permission-best-practices.md): como funções e autorizações se combinam sem excesso
* [Trilha de auditoria](https://wiki.datadike.com/pt/pam/administration/audit/audit-trail.md)
