# 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 %} --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://wiki.datadike.com/product-guide/configuracoes/pam/sysadmin/policies/authorization/importacao-e-exportacao-de-autorizacoes.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.