API

Como saber pela API se a versão instalada é afetada por uma CVE

Use o campo affected_versions para decidir se a versão que você tem está na faixa vulnerável, e o /changes com o /cve/batch para manter a sua base em dia sem baixar tudo de novo.

  • Para quemPara quem desenvolve inventário, CMDB ou gestão de vulnerabilidades.
  • PlanoConta grátis; mais volume nos planos
  • Tempocerca de 20 min

O que você precisa

  • A chave da API: o guia de primeiros passos mostra como gerar.
  • A lista de produtos e versões que você quer conferir.

Limites da conta: grátis, 50 por dia e 10 por minuto · SOC, 5.000 por dia e 60 por minuto · MSSP, 20.000 por dia e 120 por minuto.

Passo a passo

  1. Leia o affected_versions da CVE

    Cada item traz o fabricante, o produto, a base da faixa (version), o limite superior exclusivo (less_than) ou inclusivo (less_or_equal), o status e o version_type, que diz como comparar.

    curl -s -H "Authorization: Bearer vx_live_SUA_CHAVE" \
      "https://api.vexday.io/api/v1/cve/CVE-2024-3400" | jq '.data.affected_versions'
  2. Compare como versão, não como texto

    Use um comparador que respeite o version_type, como o packaging.version do Python para semver. Na ordem alfabética, uma versão menor pode parecer maior; git e custom pedem tratamento próprio.

    "2.4.9" > "2.4.49"   # verdadeiro como texto, falso como versão
  3. Respeite os limites e o status

    O less_than não inclui o limite e o less_or_equal inclui: errar isso erra na versão da fronteira. A faixa com status unaffected é a CNA dizendo que ela não é vulnerável.

  4. Trate a faixa vazia como falta de dado

    Sem affected_versions, a CNA não publicou a versão: a CVE afeta a família do produto, e a sua versão não dá para confirmar. Mostre a lacuna em vez de concluir que não afeta.

  5. Busque só o que mudou

    O /changes lista as CVEs, os incidentes e as vítimas que mudaram desde uma data, de até 30 dias atrás. Com truncated, repita a chamada com o next_since que veio na resposta.

    curl -s -H "Authorization: Bearer vx_live_SUA_CHAVE" \
      "https://api.vexday.io/api/v1/changes?since=2026-11-01T00:00:00Z"
  6. Traga o detalhe em lote

    O /cve/batch devolve várias CVEs numa chamada. Cada ID conta uma consulta no limite diário, e os que não existem voltam em not_found, sem erro.

    curl -s -X POST -H "Authorization: Bearer vx_live_SUA_CHAVE" -H "Content-Type: application/json" \
      -d '{"ids": ["CVE-2024-3400", "CVE-2021-44228"]}' "https://api.vexday.io/api/v1/cve/batch"

Deu errado?

O affected_versions veio vazioA CNA não publicou a faixa de versão. Mostre como "afeta a família; versão não confirmável" e acompanhe pelo /changes: a faixa pode chegar depois.
O /changes recusou a dataUse ISO-8601 com o fuso (o Z do UTC, por exemplo) e uma data de até 30 dias atrás.
O lote passou do limiteCada plano tem um número de IDs por lote, e cada ID conta no limite diário. Divida a lista em lotes menores.

Perguntas frequentes

O Vexday decide por mim se a minha versão é vulnerável?

Na API, não: ela entrega a faixa do registro, e a comparação é do seu sistema. No painel, o inventário faz essa conta, e o alerta pode filtrar pela versão.

De onde vem a faixa de versão?

Do registro oficial da CVE, publicado pela CNA, a organização que atribui o ID. O version_type diz como comparar.

Quantos IDs cabem num /cve/batch?

O número de IDs por lote depende do plano e aparece na página de preços.

Continue