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.

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

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

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

Importante: Este formato é apenas para auditoria e não pode ser reimportado

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

Importante: Este formato permite que o arquivo seja alterado e reimportado

Importando Autorizações

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

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"]

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

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