This page is not yet available in English. Read it in Portuguese

Skip to content
Menu da documentação

Segurança

Security Testing

SAST, SCA, segredos, SBOM e achados de outras ferramentas na mesma triagem, com o portão de severidade para o CI pela API v1 e pela CLI.

#O que faz

Análise de código, dependências e cadeia de software com orquestração de scanners e portões de política.

FuncionalidadeO que fazNa área logada
SASTAnálise estática do código no executor isolado, quando o scan pede `sast`: motor OpenGrep (LGPL-2.1) com regras escritas pela AIUBY para JavaScript/TypeScript, Python e Go e regras para Kotlin, PHP, Ruby, Rust, Swift e Groovy (injeção de SQL e de comando, eval, XSS, TLS sem verificação, desserialização insegura, hash fraco, modo de depuração). Regras próprias da organização (padrões estruturais, sem regex), análise por IA sob pedido com cada achado conferido contra o arquivo e lição curta por CWE. Achado com arquivo, linha, severidade e CWE, na mesma triagem, exceções e portão dos outros scanners. Sem fluxo de dados entre funções e arquivos; pastas de teste, vendor e node_modules ficam de fora./plataforma/engenharia/seguranca
SCADependências diretas e transitivas, vulnerabilidades e licenças (OSV e Trivy no executor isolado), segredos pelo gitleaks e imagem base identificada no scan do registro./plataforma/engenharia/seguranca
Supply Chain SecuritySBOM CycloneDX gerado no executor isolado a cada scan pedido com SBOM ou enviado de fora (CycloneDX ou SPDX), componentes por repositório e commit, diferença entre SBOMs, busca de pacote, purl ou CVE em todos os repositórios (resposta a zero-day), política de licenças da organização com violações na triagem, exportação em CycloneDX e SPDX, atestado de proveniência de um scan e AI-BOM. Vigilância sob pedido: avisos novos do OSV, dependência descontinuada pelo deps.dev e postura do repositório e do CI no GitHub. O atestado não é assinado e não há proveniência SLSA do build./plataforma/engenharia/supply-chain
Scanner OrchestrationVários scanners, resultados normalizados, exceções com prazo e evidência. Scan pedido pela tela, pela API v1, pela ferramenta MCP e pelo CI, com chave de escopo próprio. Achados repetidos viram um grupo, priorizados só pela evidência do scanner (teste, documentação e exemplo descem), com sugestão de triagem pela regra de caminho ou, opcionalmente, por IA, que só vira exceção quando uma pessoa aceita, e proposta de troca de versão para revisão (nada é aplicado)./plataforma/engenharia/seguranca
Finding RiskMesmo problema visto por scanners diferentes correlacionado pelo CVE e contado uma vez no portão; exceção e redução de severidade com duas pessoas (quem pede não aprova); EPSS da FIRST e catálogo KEV da CISA nos achados e no portão do CI, em que KEV reprova mesmo com exceção aprovada e CVE sem consulta recente reprova./plataforma/engenharia/seguranca
External FindingsAchados de outras ferramentas na mesma triagem: SARIF 2.1.0 de qualquer scanner, SBOM externo em CycloneDX ou SPDX e arquivo de modelo de IA (pickle ou PyTorch) lido sem executar, com veredito pelo que ele importaria. Pela tela ou pela API v1, com chave de escopo security:write; importação não conta como scan no portão./plataforma/engenharia/seguranca
Application DASTVarredura passiva de aplicação web com o ZAP, num executor isolado, só contra alvo do Test Automation com posse comprovada, com teto de minutos e de varreduras por hora; resultado com token de uso único, na mesma triagem dos outros scanners. Sem varredura ativa./plataforma/engenharia/seguranca
Security GovernanceDono e prazo por achado com fila de vencidos, tendência semanal por severidade, relatório técnico de conformidade com evidência e lacuna, webhooks no formato do Jira para abrir item a partir de achado e checagem de base endurecida no Dockerfile./plataforma/engenharia/seguranca

#Como ativar

  • Na área logada: o dono adiciona o Guard (as telas de segurança são do Guard) em Produtos (veja Produtos e conta pré-paga). As telas ficam no menu do produto.
  • Pela API v1 e pela CLI: a organização precisa do Guard ou do Cortex ativo (basta um; com os dois, conta o Guard), de conta de faturamento válida e de uma chave de API ligada ao workspace, com o escopo da rota.
  • O repositório precisa estar conectado e no catálogo do workspace para ser escaneado.

Nota

Produto da plataforma não ativo ou módulo não liberado para a organização: a API v1 responde 404 not_found, como se a rota não existisse. Sem conta de faturamento válida: 402. Veja API v1.

Nota

Com o Guard, a mesma organização usa pela tela e pelo CI. As rotas v1 aceitam também o Cortex, para quem só usa pelo CI.

#Primeiro uso

  1. Peça o scan

    Chave com Pedir scan de segurança (agente de código) security:scan. Scanners: gitleaks, trivy, osv e sast.
    bash
    curl -X POST https://aiuby.com/api/v1/engineering/security/scans \
      -H "Authorization: Bearer $AIUBY_TOKEN" -H "Content-Type: application/json" \
      -d '{"repo":"empresa/api","ref":"main","scanners":["sast","osv"]}'
    
    aiuby security scan --repo empresa/api --scanner sast --scanner osv --wait
  2. Decida pelo portão

    Chave com Ler o portão de segurança no CI security:read (só lê o portão) ou engineering:read.
    bash
    curl "https://aiuby.com/api/v1/engineering/security/gate?repo=empresa/api&failOn=high&kev=true" \
      -H "Authorization: Bearer $AIUBY_TOKEN"
    
    aiuby security gate --repo empresa/api --fail-on high --kev   # sai com 6 se reprovar
  3. Traga achados de fora

    Chave com Enviar SARIF e SBOM do CI security:write: aiuby security upload-sarif resultado.sarif --repo empresa/api (SARIF 2.1.0, até 5 MB) e aiuby security upload-sbom sbom.cdx.json --repo empresa/api (CycloneDX ou SPDX, até 8 MB). Detalhes em SARIF e SBOM de outras ferramentas.

#Resposta do portão

json
{
  "data": {
    "repo": "empresa/api",
    "decision": "fail",
    "reason": "open_findings",
    "failOn": "high",
    "category": null,
    "open": { "critical": 0, "high": 2, "medium": 5, "low": 1, "info": 0 },
    "blocking": 2,
    "blockingGroups": 1,
    "waived": 0,
    "epssAtLeast": null,
    "kev": true
  },
  "error": null,
  "meta": {}
}
reasonQuando
cleanNenhum achado aberto a partir de failOn no ref padrão
open_findingsHá achado aberto a partir de failOn (exceção vencida conta como aberto)
no_scanNenhum scan concluído do ref padrão
scanner_missingUm scanner que cobre a pergunta não terminou bem
incomplete_scanO resultado veio cortado
stale_scanScan mais velho que maxAgeDays
intel_missingCom epssAtLeast ou kev: CVE aberto sem consulta de EPSS/KEV dos últimos 7 dias

#Rotas da API

RotaEscopoPara quêCLI
POST /api/v1/engineering/security/sarifEnviar SARIF e SBOM do CI security:writeEnvia resultado SARIF 2.1.0aiuby security upload-sarif
POST /api/v1/engineering/security/sbomEnviar SARIF e SBOM do CI security:writeEnvia SBOM externoaiuby security upload-sbom
GET /api/v1/engineering/security/findingsLer a engenharia (API v1) engineering:readAchados dos scannersaiuby security findings
GET /api/v1/engineering/security/gateLer a engenharia (API v1) engineering:read (ou security:read)Portão de severidade do repositório (CI)aiuby security gate
GET /api/v1/engineering/security/scansLer a engenharia (API v1) engineering:readScans de segurançaaiuby security scans
POST /api/v1/engineering/security/scansPedir scan de segurança (agente de código) security:scanPede um scan pelo CIaiuby security scan
GET /api/v1/engineering/security/scans/{id}Ler a engenharia (API v1) engineering:readUm scan e os achados deleaiuby security scans get <id>
GET /api/v1/engineering/sbomLer a engenharia (API v1) engineering:readSBOMs dos scansaiuby sbom get
GET /api/v1/engineering/sbom/whereLer a engenharia (API v1) engineering:readOnde usamos um pacote ou vulnerabilidadeaiuby sbom where
GET /api/v1/engineering/sbom/{id}Ler a engenharia (API v1) engineering:readUm SBOM e os componentesaiuby sbom get
GET /api/v1/engineering/sbom/{id}/exportLer a engenharia (API v1) engineering:readExportar SBOM (CycloneDX ou SPDX)aiuby sbom get --format

#O que ainda não existe

  • Registrar exceção ou reduzir severidade pela API: fica na tela, com duas pessoas (quem pede não aprova).
  • DAST pela API: a varredura passiva com o ZAP é pedida na tela, só contra alvo com posse verificada. Varredura ativa não existe.
  • Aplicar a troca de versão sugerida: a proposta é só para revisão.