> 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/product-docs/product-guide/configuracoes/pam/sysadmin/policies/authorization/importacao-e-exportacao-de-autorizacoes.md).

# Importação e Exportação de Autorizações

A funcionalidade de Importação e Exportação de Autorizações permite o gerenciamento em massa das regras de autorização através de arquivos estruturados (CSV ou Excel). Esta ferramenta possibilita criar, atualizar e fazer backup de múltiplas autorizações simultaneamente, otimizando a administração de permissões em ambientes com grande volume de regras.

{% hint style="success" %}
**Casos de Uso Típicos**

* **Migração de Sistemas**: Transferência de autorizações entre ambientes
* **Backup e Restauração**: Criação de cópias de segurança das configurações
* **Mudanças Organizacionais**: Atualização em massa após reestruturações
* **Auditoria e Compliance**: Documentação e análise das permissões existentes
* **Implementação Inicial**: Configuração rápida de múltiplas autorizações
  {% endhint %}

## Acessando a Funcionalidade

1. **Localização dos Controles**
   * Na tela principal de autorizações, localize os ícones no canto superior direito
   * **Ícone de Importação**: Permite carregar arquivos para criar/atualizar autorizações
   * **Ícone de Exportação**: Permite baixar autorizações existentes

## Exportando Autorizações

Exportação para Auditoria

{% tabs %}
{% tab title="Exportação para Auditoria" %}
Esta funcionalidade permite a exportação das autorizações existentes no sistema para fins de auditoria, documentação e análise de compliance.

1. **Iniciando a Exportação**
   * Clique no ícone de exportação
   * Será aberta a janela "Exportar"
2. **Configurando o Formato**
   * **Tipo de arquivo**: Escolha entre CSV ou Excel
   * **Exportar Alcance**: Selecione "Exportar tudo" ou "Exportar apenas itens selecionados"
3. **Finalização**
   * Clique em "Confirmar"
   * O arquivo será baixado automaticamente

{% hint style="danger" %}
**Importante**: Este formato é apenas para auditoria e não pode ser reimportado
{% endhint %}
{% endtab %}

{% tab title="Exportação para Modificação/Reimportação" %}

1. **Acessando o Menu de Importação**
   * Selecione as autorizações que deseja modificar (opcional)
   * Clique no ícone de importação
   * Será aberta a janela "Carregar & Atualização"
2. **Baixando Template Editável**
   * Selecione a opção "Atualização"
   * Clique em "Baixar modelo atualizado" (CSV ou XLSX)
   * Este arquivo pode ser modificado e reimportado
3. **Diferenças dos Formatos**
   * **Exportação (auditoria)**: Formato simples, apenas para visualização
   * **Template (modificação)**: Formato estruturado com IDs e metadados necessários para reimportação

{% hint style="success" %}
**Importante**: Este formato permite que o arquivo seja alterado e reimportado
{% endhint %}
{% endtab %}
{% endtabs %}

## Importando Autorizações

{% tabs %}
{% tab title="Modo Criar - Novas Autorizações" %}
O modo **Criar** é utilizado quando você deseja adicionar novas regras de autorização ao sistema através de importação em massa. Este modo é ideal para configurações iniciais do sistema, migração de outros ambientes ou quando há necessidade de criar múltiplas autorizações com estruturas similares. O sistema fornece um template em branco que deve ser preenchido com os dados das novas autorizações que serão criadas.

1. **Preparando o Template**
   * Clique no ícone de importação
   * Selecione a opção "Criar"
   * Clique em "Baixar Modelo Criado" para obter o template
2. **Preenchendo o Template**
   * Abra o arquivo baixado (CSV ou XLSX)
   * **Linha 1**: Contém os cabeçalhos das colunas
   * **Linha 2**: Contém as instruções de preenchimento (pode ser removida)
   * **Linha 3 em diante**: Preencha com os dados das novas autorizações
3. **Estrutura dos Dados**
   * **ID**: Deixe em branco (será gerado automaticamente)
   * **Name**: Nome da autorização (obrigatório, máximo 128 caracteres)
   * **Users**: Formato `["nome(id)", ...]` - exemplo: `["John(b8903cab-63a1-406b-8ba3-7eead1b5c592)"]`
   * **Groups**: Mesmo formato dos usuários, ou `[]` se vazio
   * **Assets**: Formato `["nome(id)", ...]` - exemplo: `["vmTestes(1c086d8a-1222-4c59-9402-0bde1d413b87)"]`
   * **Nodes**: Mesmo formato dos assets
   * **Tags**: Formato `[]` Deixe em branco
   * **Accounts**: Combine contas específicas e virtuais - exemplo: `["john", "john.doe", "@SPEC"]`
   * **Protocols**: `["all"]` para todos ou `["ssh", "rdp", "vnc"]` para específicos
   * **Action**: `["connect", "upload", "download", "copy", "paste", "delete", "share"]`
   * **Active**: `Yes` ou `No`
   * **Date start**: Formato `2025/07/12 22:03:07 +0800`
   * **Date expired**: Mesmo formato da data de início
   * **Description**: Texto livre
4. **Realizando a Importação**
   * Salve o arquivo preenchido
   * Na tela de importação, selecione "Criar"
   * Faça upload do arquivo preenchido
   * Clique para confirmar a importação

{% hint style="success" %}
**Códigos Especiais para Contas Virtuais**

Ao preencher o campo "Accounts", você pode usar os seguintes códigos especiais:

* **@ALL**: Todas as contas existentes
* **@SPEC**: Contas específicas pré-definidas
* **@USER**: Conta com mesmo nome do usuário PAM
* **@ANON**: Conta anônima (sem credenciais)
* **@INPUT**: Entrada manual durante conexão

**Exemplo de uso**: `["root", "admin", "@SPEC", "@USER"]`
{% endhint %}
{% endtab %}

{% tab title="Modo Atualizar - Autorizações Existentes" %}
O modo **Atualizar** permite modificar regras de autorização já existentes no sistema através de importação em massa. Este modo é especialmente útil para ajustes de permissões em lote, como alterações de datas de expiração, adição/remoção de usuários ou assets, ou modificação de ações permitidas em múltiplas autorizações simultaneamente. O template baixado já contém os dados atuais das autorizações selecionadas, facilitando a identificação e edição apenas dos campos que precisam ser alterados.

1. **Baixando Template Editável**
   * Clique no ícone de importação
   * Selecione a opção "Atualização"
   * **Opcional**: Selecione autorizações específicas na lista principal antes de acessar a importação para incluí-las no template
   * Clique em "Baixar modelo atualizado" (CSV ou XLSX)
   * O arquivo baixado conterá os dados atuais das autorizações (todas ou apenas as selecionadas)
2. **Modificando os Dados**
   * Abra o arquivo baixado
   * Modifique apenas os campos que deseja alterar
   * **Importante**: Mantenha o ID das autorizações para identificação correta
3. **Aplicando as Atualizações**
   * Salve o arquivo modificado
   * Na tela de importação, selecione "Atualização"
   * Faça upload do arquivo modificado
   * Confirme a importação
     {% endtab %}
     {% endtabs %}

{% hint style="info" %}

#### **Validação e Tratamento de Erros**

**Durante a Importação**

* O sistema valida cada linha do arquivo
* Erros são reportados com detalhes específicos
* Linhas com erro são ignoradas, mas as válidas são processadas

**Problemas Comuns**

* **Formato de data incorreto**: Use o padrão `AAAA/MM/DD HH:MM:SS +fuso`
* **IDs inválidos**: Verifique se os IDs de usuários, grupos e assets existem
* **Sintaxe de arrays**: Use aspas duplas e formato JSON correto
* **Campos obrigatórios**: O campo "Name" é obrigatório

**Limitações Importantes**

1. **Tamanho do Arquivo**: Máximo de 10MB para upload
2. **Formato**: Apenas CSV e XLSX são suportados
3. **Codificação**: Use UTF-8 para caracteres especiais
4. **Identificadores**: IDs devem corresponder exatamente aos objetos existentes no sistema

**Boas Práticas**

1. **Backup Antes de Atualizar**: Sempre exporte as autorizações antes de fazer atualizações em massa
2. **Teste com Poucos Registros**: Valide o processo com um pequeno conjunto antes de importações grandes
3. **Validação de IDs**: Confirme que todos os IDs referenciados existem no sistema
4. **Documentação**: Use o campo "Description" para registrar o propósito de cada autorização
5. **Versionamento**: Mantenha versões dos arquivos de importação para rastreabilidade
   {% endhint %}