Carga de dados

Carga de dados: CMDB e Vulnerabilidades

Guia rápido para preparar e subir novas cargas de CMDB (ServiceNow) e de vulnerabilidades (Tenable), garantindo que só entram dados da AM/PM.

Por que filtrar antes de subir

O ServiceNow e o Tenable do grupo Ultrapar são compartilhados entre todas as empresas (Ipiranga, Ultrapar, Iconic, AM/PM). Um export "bruto" do CMDB ou do Tenable traz ativos de todas essas empresas misturados — sem filtrar antes de subir, o ambiente da AM/PM passa a exibir servidores e vulnerabilidades de outras empresas do grupo. Siga os passos abaixo em toda carga nova, não só na primeira.

1. Como identificar o que é da AM/PM

O campo "Empresa"/"company" do export não é totalmente confiável — em uma carga real, cerca de 40% das linhas marcadas como AM/PM na verdade tinham nome de servidor no padrão de outra empresa do grupo. O critério que funciona é o nome do servidor:

Prefixo do nomeEmpresa
AM...AM/PM — manter
IP... / I2...Ipiranga — remover
U2...Ultragaz — remover
outros/genéricos (ex.: endereço IP, hash, SERV-*)revisar manualmente antes de decidir

Regra prática no Excel: filtre a coluna de nome do servidor pra manter só linhas que começam com AM (não importa o que a coluna "Empresa" diga) e apague o restante. Revise manualmente linhas com nome fora desse padrão antes de decidir incluir ou não — nunca confie só na coluna "Empresa".

2. Mapeamento de colunas — CMDB

O arquivo de CMDB do ServiceNow vem com nomes de coluna em inglês; a carga no ampmInsights espera um XLSX com os cabeçalhos exatamente como na tabela abaixo (renomeie as colunas no Excel antes de subir):

Coluna no export ServiceNowRenomear para (cabeçalho esperado)
nameNOME
operational_statusSTATUS_OPERACIONAL
short_descriptionDESCRIÇÃO
environmentAMBIENTE
companyEMPRESA (revise pelo nome do servidor, não copie direto)
managed_by_groupGERENCIADO_PELO_GRUPO
assignment_groupGRUPO_RESPONSÁVEL
u_safe_boxCOFRE (converter Verdadeiro/Falso(a) para 1/0)
u_soxSOX (converter Verdadeiro/Falso(a) para 1/0)
u_tipo_de_redeTIPO_DE_REDE
u_grupo_resp_assignment_groupGRUPOS_RESPONSÁVEIS
u_tenableTENABLE (converter Verdadeiro/Falso(a) para 1/0)
u_siemSIEM (converter Verdadeiro/Falso(a) para 1/0)
sem equivalente no exportÉ_VIRTUAL, APPLIANCE, EDR — deixe em branco

3. Mapeamento de colunas — Vulnerabilidades

O export do Tenable também precisa ter os cabeçalhos renomeados. Use só as colunas abaixo — o restante do export do Tenable (CVE, CVSS, solução, etc.) não é usado nesta carga:

Coluna no export TenableRenomear para (cabeçalho esperado)
age_in_daysAGE_IN_DAYS
asset.display_ipv4_addressASSET_DISPLAY_IPV4_ADDRESS
asset.idASSET_ID
asset.nameASSET_NAME
asset.tagsASSET_TAGS
definition.exploitability_easeDEFINITION_EXPLOITABILITY_EASE
definition.familyDEFINITION_FAMILY
definition.idDEFINITION_ID
definition.nameDEFINITION_NAME
definition.vpr.scoreDEFINITION_VPR_SCORE
first_observedFIRST_OBSERVED
idID
last_seenLAST_SEEN
outputOUTPUT
protocolPROTOCOL
resurfaced_dateRESURFACED_DATE
severitySEVERITY
stateSTATE
Filtre as vulnerabilidades pelo mesmo critério do CMDB

Depois de filtrar o CMDB, filtre também o arquivo de vulnerabilidades: mantenha só as linhas cujo ASSET_NAME começa com AM — mesmo critério do passo 1, aplicado aqui pelo nome do ativo em vez do nome do servidor.

4. Passo a passo da carga

  1. Exportar o CMDB (ServiceNow) e as vulnerabilidades (Tenable) em CSV, como de costume.
  2. Filtrar as duas planilhas pelo critério do passo 1 (nome começa com AM).
  3. Renomear as colunas conforme as tabelas dos passos 2 e 3, e salvar cada planilha como .xlsx.
  4. Se for recarregar dados já existentes (não uma carga inicial), limpe as tabelas antes — peça ao time técnico para rodar:
    Limpeza antes de recarregar (time técnico)
    DELETE FROM TB_26AI_TECH_VECTOR WHERE source_type = 'VUL';
    DELETE FROM TB_26AI_TECH_V2;
    DELETE FROM TB_26AI_TECH_CMDB;
    COMMIT;
  5. Suba o CMDB primeiro, pelo menu Upload CMDB da aplicação.
  6. Suba as vulnerabilidades em seguida (depois do CMDB, pra já aparecer nome/empresa corretos nos insights).
  7. Valide: confira no CMDB que o total de linhas bate com o esperado e que o filtro "Empresa" só mostra AM/PM; confira na tela de Insights que os nomes de servidor são todos padrão AM....
Casos que sempre merecem revisão manual
  • Nomes com sufixo #DUP — o ServiceNow já marcou como duplicata pendente de revisão.
  • Nomes duplicados exatos na planilha de CMDB — mantenha a linha com status "Operacional" e descarte a outra.
  • Ativos de vulnerabilidade sem correspondência no CMDB filtrado — ficam sem nome/empresa preenchidos nos insights, mas os dados de vulnerabilidade continuam sendo carregados normalmente.