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.
| Funcionalidade | O que faz | Na área logada |
|---|---|---|
| SAST | Aná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 |
| SCA | Dependê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 Security | SBOM 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 Orchestration | Vá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 Risk | Mesmo 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 Findings | Achados 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 DAST | Varredura 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 Governance | Dono 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
Peça o scan
Chave com Pedir scan de segurança (agente de código)security:scan. Scanners:gitleaks,trivy,osvesast.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 --waitDecida pelo portão
Chave com Ler o portão de segurança no CIsecurity:read(só lê o portão) ouengineering: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 reprovarTraga achados de fora
Chave com Enviar SARIF e SBOM do CIsecurity:write:aiuby security upload-sarif resultado.sarif --repo empresa/api(SARIF 2.1.0, até 5 MB) eaiuby 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
{
"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": {}
}| reason | Quando |
|---|---|
clean | Nenhum achado aberto a partir de failOn no ref padrão |
open_findings | Há achado aberto a partir de failOn (exceção vencida conta como aberto) |
no_scan | Nenhum scan concluído do ref padrão |
scanner_missing | Um scanner que cobre a pergunta não terminou bem |
incomplete_scan | O resultado veio cortado |
stale_scan | Scan mais velho que maxAgeDays |
intel_missing | Com epssAtLeast ou kev: CVE aberto sem consulta de EPSS/KEV dos últimos 7 dias |
#Rotas da API
| Rota | Escopo | Para quê | CLI |
|---|---|---|---|
POST /api/v1/engineering/security/sarif | Enviar SARIF e SBOM do CI security:write | Envia resultado SARIF 2.1.0 | aiuby security upload-sarif |
POST /api/v1/engineering/security/sbom | Enviar SARIF e SBOM do CI security:write | Envia SBOM externo | aiuby security upload-sbom |
GET /api/v1/engineering/security/findings | Ler a engenharia (API v1) engineering:read | Achados dos scanners | aiuby security findings |
GET /api/v1/engineering/security/gate | Ler 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/scans | Ler a engenharia (API v1) engineering:read | Scans de segurança | aiuby security scans |
POST /api/v1/engineering/security/scans | Pedir scan de segurança (agente de código) security:scan | Pede um scan pelo CI | aiuby security scan |
GET /api/v1/engineering/security/scans/{id} | Ler a engenharia (API v1) engineering:read | Um scan e os achados dele | aiuby security scans get <id> |
GET /api/v1/engineering/sbom | Ler a engenharia (API v1) engineering:read | SBOMs dos scans | aiuby sbom get |
GET /api/v1/engineering/sbom/where | Ler a engenharia (API v1) engineering:read | Onde usamos um pacote ou vulnerabilidade | aiuby sbom where |
GET /api/v1/engineering/sbom/{id} | Ler a engenharia (API v1) engineering:read | Um SBOM e os componentes | aiuby sbom get |
GET /api/v1/engineering/sbom/{id}/export | Ler a engenharia (API v1) engineering:read | Exportar 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.