> 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/assets/folders-and-tags.md).

# Pastas e tags

Monte a árvore de pastas de ativos, arquive os ativos nela e use as pastas como alvo de regras, além do que as tags fazem e as pastas não.

## O que é isto e quando usar

Pastas e tags são as duas formas de agrupar ativos, e não são intercambiáveis.

Uma **pasta**, chamada de **Node** sempre que um formulário pede uma, é uma posição em uma hierarquia que você constrói. O valor dela está em que as regras podem apontar para ela: uma autorização, uma tarefa de rotação ou uma política de descoberta pode citar uma pasta em vez de uma lista de ativos, e todo ativo naquela pasta fica coberto, inclusive os que forem adicionados amanhã.

Uma **tag** é um rótulo plano no formato `chave: valor`. Um objeto pode carregar várias, e as tags cortam a hierarquia: `env: prod` pode estar em ativos de seis pastas diferentes. As tags filtram listas; salvo raras exceções, não concedem nada.

|                           | Pastas (Nodes)                                                   | Tags                                                 |
| ------------------------- | ---------------------------------------------------------------- | ---------------------------------------------------- |
| Formato                   | Uma árvore, a partir da raiz `DEFAULT`                           | Rótulos planos `chave: valor`                        |
| Construída por            | Você, por ambiente, cliente ou finalidade                        | Você, conforme a necessidade, ao registrar objetos   |
| Serve de alvo de regra    | Sim: autorizações, tarefas de automação, políticas de descoberta | Não                                                  |
| Serve para filtrar listas | Sim                                                              | Sim                                                  |
| Aplica-se a               | Ativos                                                           | Ativos, contas, modelos de conta, usuários, gateways |

{% hint style="info" %}
O [Inventário de ativos](https://wiki.datadike.com/pt/pam/administration/assets/inventory.md) descreve o painel de pastas como um recurso de filtragem: as duas árvores, o marcador `Folder: DEMO`, o **Limpar tudo**. Esta página trata de construir a estrutura e usá-la como algo mais do que um filtro.
{% endhint %}

Duas árvores convivem no painel, e só uma delas é sua:

* **Pastas de ativos**, a estrutura que você constrói, a partir da raiz `DEFAULT`.
* **Pastas por tipo**, o agrupamento automático por tipo de plataforma. É uma visão, não um lugar. Você não pode arquivar nada nela e nada do que fizer ali altera um ativo.

## Antes de começar

* Um critério para a hierarquia, escolhido antes de começar a criar pastas: ambiente, cliente, unidade de negócio ou criticidade. Seja qual for, deve ser aquilo que as suas autorizações vão querer citar.
* A função **SYSADMIN**.

Escolha o critério perguntando o que uma autorização futura vai precisar conceder. Uma árvore organizada como as suas regras de acesso pensam vale mais do que uma organizada como o seu rack está cabeado.

## Passos

1. Abra **Ambiente › Ativos**. A aba **Pastas de ativos** do painel da direita contém a árvore, a partir de `DEFAULT`.
2. Monte a estrutura de que você precisa sob `DEFAULT`. O contador no topo do painel informa quantas pastas existem.
3. Arquive cada ativo: abra os detalhes do ativo e use o bloco **Node** para colocá-lo em uma pasta. No formulário de criação, o campo **Node** faz a mesma coisa já no momento do registro.
4. Adicione **Tags** pelo mesmo painel de detalhes, para os rótulos transversais: responsável, ambiente, criticidade.
5. Para os ativos que chegam sozinhos, defina a pasta em uma **política de sincronização** da descoberta, e não à mão: uma ação com tipo de recurso **Node** arquiva todo ativo recém-descoberto que atenda às condições da política. Veja [Descobrir ativos na rede](https://wiki.datadike.com/pt/pam/administration/assets/discovery.md).

## Para que servem as pastas

Filtrar a lista é o menor dos usos.

| Onde                                                                                                             | Como a pasta é usada                                                                                                                  |
| ---------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
| [Autorizações](https://wiki.datadike.com/pt/pam/administration/access/authorizations.md)                         | O campo **Nodes** concede uma pasta inteira, por exemplo `/OFFICE`. Os ativos arquivados ali depois ficam cobertos sem editar a regra |
| [Rotacionar credenciais](https://wiki.datadike.com/pt/pam/administration/accounts/rotation.md) e tarefas de push | **Assets or Nodes** aponta para uma pasta, e a tarefa acompanha o conteúdo dela                                                       |
| Políticas de sincronização da [descoberta](https://wiki.datadike.com/pt/pam/administration/assets/discovery.md)  | Uma ação com tipo de recurso **Node** decide onde um ativo recém-encontrado cai                                                       |
| [Contas gerenciadas](https://wiki.datadike.com/pt/pam/administration/accounts/managed-accounts.md)               | A **Árvore de dispositivos** do painel lateral filtra as contas por grupo de ativos                                                   |
| A aba **Ativos autorizados** de um usuário                                                                       | A árvore filtra os ativos que aquele usuário de fato alcança                                                                          |
| A lista de acessos do próprio usuário                                                                            | Os usuários filtram seus dispositivos por pasta, ao lado dos **Favoritos**                                                            |

É por isso que vale manter a árvore em ordem. Uma pasta citada em três autorizações e duas tarefas de rotação é parte da sua política de acesso, não uma conveniência de navegação.

## Para que servem as tags

* **Filtrar.** As listas de ativos, de contas e de modelos de conta trazem cada uma um controle **Tags** que filtra pelos rótulos aplicados.
* **Entrada de funcionalidade, ocasionalmente.** As tags nem sempre são inertes: a máquina publicadora de uma aplicação de acesso virtual é escolhida ao acaso por padrão, e uma tag na configuração do ativo fixa uma máquina específica. Trate a tag como um dado que o produto pode ler, e não apenas como uma anotação para você mesmo.

**Sysadmin › Outros › Tags** lista as tags que existem no tenant. Vale abrir essa tela depois de uma importação em massa.

{% hint style="warning" %}
Na importação, **uma tag que não existe é criada automaticamente**. Um erro de digitação não falha: ele cria em silêncio uma segunda tag quase idêntica, e o filtro que você montar depois deixa de fora metade dos ativos, sem avisar. Confira a lista de tags depois de qualquer importação em massa de ativos ou de usuários.
{% endhint %}

As tags são escritas como pares `chave: valor` e, em um arquivo de importação, formam um array JSON de strings: `["env: prod", "owner: dbteam"]`.

## Como verificar se funcionou

Arquivar um ativo é fácil de confirmar e não prova nada. Verifique se o **escopo de pasta** funciona, porque é nisso que você está de fato confiando:

1. Crie uma autorização cujo alvo seja uma pasta, e não uma lista de ativos, e conceda-a a um usuário de teste.
2. Confirme que o usuário de teste vê os ativos que estão hoje naquela pasta.
3. Agora arquive um ativo **novo** na mesma pasta, sem mudar mais nada.
4. O usuário de teste precisa ver o ativo novo sem nenhuma edição na autorização. Se não vir, a regra está mirando ativos individualmente e a pasta é decorativa.

Para as tags, filtre uma lista pela tag que você acabou de aplicar e confirme que o ativo aparece. Depois confirme que não existe nenhuma tag quase idêntica em **Sysadmin › Outros › Tags**.

## Erros comuns

| Sintoma                                                              | Causa                                                                     | Solução                                                                         |
| -------------------------------------------------------------------- | ------------------------------------------------------------------------- | ------------------------------------------------------------------------------- |
| A contagem de ativos de uma pasta parece errada                      | As contagens são atualizadas por uma tarefa periódica, não a cada mudança | Confie na lista filtrada, não no selo. A contagem se acerta na próxima execução |
| Um ativo novo em uma pasta concedida não fica visível para o usuário | A autorização cita os ativos um a um em vez da pasta                      | Mude a regra para mirar o **Node**                                              |
| Um filtro por tag retorna menos ativos do que o esperado             | Uma tag quase idêntica foi criada por erro de digitação na importação     | Confira **Sysadmin › Outros › Tags** e consolide                                |
| Aparecem ativos em uma pasta que você nunca criou                    | Isso é **Pastas por tipo**, o agrupamento automático por plataforma       | Volte para a aba **Pastas de ativos**                                           |
| Reorganizar a árvore quebra o acesso                                 | Uma autorização ou uma tarefa citava uma pasta que você moveu ou renomeou | Verifique quais regras citam a pasta antes de reestruturá-la                    |
| Uma tarefa de rotação passa a cobrir mais hosts                      | Ela mira uma pasta, e ativos foram arquivados nela                        | É o esperado. Tarefas com escopo de pasta acompanham a pasta                    |

## Referência de campos

| Item                   | Onde                                                         | O que é                                                        |
| ---------------------- | ------------------------------------------------------------ | -------------------------------------------------------------- |
| Pastas de ativos       | O painel em **Ambiente › Ativos**                            | A árvore que você constrói, a partir da raiz `DEFAULT`         |
| Pastas por tipo        | O mesmo painel                                               | Agrupamento automático por tipo de plataforma. Somente leitura |
| Node                   | Formulário de criação de ativo e painel de detalhes do ativo | Arquiva o ativo na árvore de pastas                            |
| Nodes                  | Formulário de autorização                                    | Concede uma pasta inteira                                      |
| Assets or Nodes        | Tarefas de rotação e de push                                 | Mira ativos individuais, pastas, ou ambos                      |
| Tipo de recurso = Node | Ação de política de sincronização da descoberta              | Arquiva em uma pasta os ativos recém-descobertos               |
| Tags                   | Formulários de ativo, conta, modelo de conta e usuário       | Rótulos `chave: valor`. Vários por objeto                      |
| Tags                   | Barras de ferramentas das listas                             | Filtra a lista por tag                                         |

## Páginas relacionadas

* [Inventário de ativos](https://wiki.datadike.com/pt/pam/administration/assets/inventory.md): o painel de pastas e como a filtragem se comporta
* [Descobrir ativos na rede](https://wiki.datadike.com/pt/pam/administration/assets/discovery.md): arquivar ativos novos automaticamente
* [Autorizações](https://wiki.datadike.com/pt/pam/administration/access/authorizations.md): conceder uma pasta em vez de uma lista
* [Rotacionar credenciais](https://wiki.datadike.com/pt/pam/administration/accounts/rotation.md): alvos de automação com escopo de pasta
* [Plataformas](https://wiki.datadike.com/pt/pam/administration/assets/platforms.md): o critério pelo qual as **Pastas por tipo** agrupam
