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.
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 nome | Empresa |
|---|---|
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 ServiceNow | Renomear para (cabeçalho esperado) |
|---|---|
name | NOME |
operational_status | STATUS_OPERACIONAL |
short_description | DESCRIÇÃO |
environment | AMBIENTE |
company | EMPRESA (revise pelo nome do servidor, não copie direto) |
managed_by_group | GERENCIADO_PELO_GRUPO |
assignment_group | GRUPO_RESPONSÁVEL |
u_safe_box | COFRE (converter Verdadeiro/Falso(a) para 1/0) |
u_sox | SOX (converter Verdadeiro/Falso(a) para 1/0) |
u_tipo_de_rede | TIPO_DE_REDE |
u_grupo_resp_assignment_group | GRUPOS_RESPONSÁVEIS |
u_tenable | TENABLE (converter Verdadeiro/Falso(a) para 1/0) |
u_siem | SIEM (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 Tenable | Renomear para (cabeçalho esperado) |
|---|---|
age_in_days | AGE_IN_DAYS |
asset.display_ipv4_address | ASSET_DISPLAY_IPV4_ADDRESS |
asset.id | ASSET_ID |
asset.name | ASSET_NAME |
asset.tags | ASSET_TAGS |
definition.exploitability_ease | DEFINITION_EXPLOITABILITY_EASE |
definition.family | DEFINITION_FAMILY |
definition.id | DEFINITION_ID |
definition.name | DEFINITION_NAME |
definition.vpr.score | DEFINITION_VPR_SCORE |
first_observed | FIRST_OBSERVED |
id | ID |
last_seen | LAST_SEEN |
output | OUTPUT |
protocol | PROTOCOL |
resurfaced_date | RESURFACED_DATE |
severity | SEVERITY |
state | STATE |
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
- Exportar o CMDB (ServiceNow) e as vulnerabilidades (Tenable) em CSV, como de costume.
- Filtrar as duas planilhas pelo critério do passo 1 (nome começa com
AM). - Renomear as colunas conforme as tabelas dos passos 2 e 3, e salvar cada planilha como
.xlsx. - Se for recarregar dados já existentes (não uma carga inicial), limpe as tabelas antes — peça ao time técnico para rodar:
DELETE FROM TB_26AI_TECH_VECTOR WHERE source_type = 'VUL'; DELETE FROM TB_26AI_TECH_V2; DELETE FROM TB_26AI_TECH_CMDB; COMMIT; - Suba o CMDB primeiro, pelo menu Upload CMDB da aplicação.
- Suba as vulnerabilidades em seguida (depois do CMDB, pra já aparecer nome/empresa corretos nos insights).
- 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....
- 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.