Segurança
AI & API Security
Inventário e postura de APIs, teste seguro de fora, proteção em tempo de execução, firewall de IA e de MCP: o que a API v1 lê e o que fica na tela.
#O que faz
Proteção de APIs e de sistemas de IA em operação: inventário, postura e firewall de IA.
| Funcionalidade | O que faz | Na área logada |
|---|---|---|
| AI Firewall | Mascaramento de dados pessoais e financeiros na entrada e na saída, ferramentas bloqueadas, orçamento e limites por chave, argumentos de ferramentas MCP conferidos contra o esquema declarado. A detecção de injeção de prompt e o firewall das chamadas MCP são funcionalidades próprias, abaixo. | /plataforma/politicas |
| Prompt Injection Detection | Detector determinístico (regras pt/en, sem chamar modelo) de injeção de prompt, jailbreak, pedido do prompt de sistema, instrução escondida ou codificada, injeção indireta em resultados de Knowledge e MCP, segredo ou código de exploração colado e toxicidade básica. Na saída do modelo: HTML ativo, link javascript:, shell e SQL destrutivos, trecho do prompt de sistema e dado sensível que sobrou; em impor, a resposta é recusada ou o stream interrompido. Trechos do Knowledge com injeção saem do contexto do chat e dos agentes. Modos observar, simular e impor por workspace e organização (a organização só endurece), registro com trecho redigido e hash, painel por categoria, workspace e chave. Heurística: tem falso positivo e falso negativo. | /plataforma/politicas |
| AI Posture | Inventário do uso de IA pelo navegador e pelo perímetro da rede. | /plataforma/navegador |
| AI Security Testing | Avaliação de endpoints de IA próprios contra categorias OWASP LLM, com posse verificada, alvos tirados de OpenAPI, do inventário de APIs ou de coleção do Postman, agenda com modo incremental e reavaliação; varredura de skills, ferramentas MCP e instruções de agentes por regras fixas. | /plataforma/engenharia/seguranca-ia |
| API Posture | Inventário de APIs pelas especificações OpenAPI/Swagger dos repositórios e enviadas, por rotas inferidas do código e pelo tráfego coletado do log do gateway (nginx, Envoy, Kong) ou de espelhamento, só com metadados. Dono pelo grafo, dado sensível provável pelo nome do campo, regras determinísticas com evidência (sem autenticação, dado sensível na query, servidor HTTP, versão antiga, endpoint sombra), drift entre versões, painel com nota de risco 0–100 por API, inspetor de tráfego por endpoint no OpenAPI gerado, aplicações e políticas configuráveis do workspace. | /plataforma/engenharia/seguranca-api |
| API Security | Teste seguro de API de fora: só GET, HEAD e OPTIONS, sem corpo e sem credencial, contra origem com posse verificada, executado num job isolado na nuvem com teto de requisições; confere cabeçalhos de segurança, CORS, TLS antigo, rota sem autenticação e stack trace exposto, e os achados entram no inventário de APIs. | /plataforma/engenharia/seguranca-api |
| API Protection | Proteção de API em tempo de execução por um gateway na frente da aplicação, gerenciado no Compute ou rodando na borda do cliente com chave presa à proteção: confere cada requisição contra o OpenAPI (endpoint sombra, parâmetros e corpo fora do schema), aplica limite de taxa por IP, chave ou rota, tamanho de corpo, métodos permitidos, lista de bloqueio e regras próprias de ataque (SQLi, XSS, travessia de caminho, SSRF, injeção de comando) e de bots. Cada regra em observar, simular ou impor; patch virtual com prazo; atores de ameaça com bloqueio; conformidade do tráfego com o contrato; painel com contagens e amostras redigidas, alerta e incidente. Heurística, com falso positivo e falso negativo; não mascara dados na resposta, não tem reputação de IP nem desafio de bot, e o limite de taxa é por instância. | /plataforma/engenharia/protecao-api |
| MCP Firewall | Firewall em volta de cada chamada MCP dos agentes da plataforma: regras que só negam, limite por hora, linha de base do tamanho da resposta com modo monitorar ou bloquear, máscara de dado sensível na resposta, credencial recusada identificada, nota de risco por ferramenta, inventário agente, servidor MCP e host, terceiros alcançados e eventos para o SIEM pelos webhooks assinados. | /plataforma/agentes/mcp/firewall |
#Como ativar
- Na área logada: o dono adiciona o 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 firewall de IA e a detecção de injeção de prompt agem nas chamadas que passam pelo Gateway: valem para o que usa o Models, configurados em Políticas.
Nota
404 not_found, como se a rota não existisse. Sem conta de faturamento válida: 402. Veja API v1.#Primeiro uso
Monte o inventário
As especificações OpenAPI dos repositórios conectados entram sozinhas; envie outras na tela ou mande o tráfego do gateway (abaixo).Leia pela CLI ou pela API
bash curl https://aiuby.com/api/v1/api-security/apis -H "Authorization: Bearer $AIUBY_TOKEN" aiuby apis list aiuby apis drift <id> aiuby apis spec <id> > openapi.json aiuby apis findings --severity high aiuby api-protection stats <id> --hours 72
#Tráfego do gateway
Chave com Enviar tráfego de APIs (log do gateway) api-security:ingest. Até 2.000 linhas por envio, só metadados: a query é descartada e segmentos que parecem id viram {id}. Também aceita a linha nativa do Kong (http-log/file-log) e do Envoy (access log em JSON).
curl -X POST https://aiuby.com/api/v1/api-security/traffic \
-H "Authorization: Bearer $AIUBY_TOKEN" -H "Content-Type: application/json" \
-d '{"records":[{"method":"GET","host":"api.empresa.com.br","path":"/v1/pedidos/123","status":200,"latencyMs":42}]}'{
"data": { "accepted": 1, "dropped": 0, "apis": [{ "host": "api.empresa.com.br", "apiId": "…", "endpoints": 1, "newEndpoints": 1 }] },
"error": null,
"meta": {}
}#Rotas do gateway e da extensão
Estas rotas são chamadas pelos componentes da AIUBY instalados do seu lado, com chave própria. Não são para integrar à mão.
| Rota | Quem chama | Escopo |
|---|---|---|
/api/shield/v1/policy, /telemetry, /upstream-token | Gateway da proteção de API rodando na sua borda | api-shield:gateway |
/api/guard/v1/decide, /config, /approvals/{id} | Extensão do Guard no navegador | Guard no navegador (extensão) guard:decide |
/api/guard/v1/connect, /report | Proxy de perímetro do Guard | Guard no perímetro (proxy) guard:perimeter |
#Rotas da API
| Rota | Escopo | Para quê | CLI |
|---|---|---|---|
POST /api/v1/api-security/traffic | Enviar tráfego de APIs (log do gateway) api-security:ingest | Enviar tráfego observado (log do gateway ou espelhamento) | aiuby apis traffic |
GET /api/v1/api-security/applications | Ler a engenharia (API v1) engineering:read | Aplicações do inventário de APIs | aiuby apis applications |
GET /api/v1/api-security/policies | Ler a engenharia (API v1) engineering:read | Políticas configuráveis de postura | aiuby apis policies |
GET /api/v1/api-security/apis/{id}/spec | Ler a engenharia (API v1) engineering:read | OpenAPI gerado do inventário | aiuby apis spec <id> |
GET /api/v1/api-security/apis | Ler a engenharia (API v1) engineering:read | Inventário de APIs | aiuby apis list |
GET /api/v1/api-security/apis/{id} | Ler a engenharia (API v1) engineering:read | Uma API do inventário | aiuby apis get <id> |
GET /api/v1/api-security/apis/{id}/drift | Ler a engenharia (API v1) engineering:read | Drift da especificação | aiuby apis drift <id> |
GET /api/v1/api-security/findings | Ler a engenharia (API v1) engineering:read | Achados de postura de API | aiuby apis findings |
GET /api/v1/api-protection/protections | Ler a engenharia (API v1) engineering:read | Proteções de API | aiuby api-protection list |
GET /api/v1/api-protection/protections/{id} | Ler a engenharia (API v1) engineering:read | Uma proteção de API | aiuby api-protection get <id> |
GET /api/v1/api-protection/protections/{id}/stats | Ler a engenharia (API v1) engineering:read | Estatísticas de uma proteção | aiuby api-protection stats <id> |
GET /api/v1/api-protection/protections/{id}/samples | Ler a engenharia (API v1) engineering:read | Amostras redigidas de uma proteção | aiuby api-protection samples <id> |
#O que ainda não existe
- Mudar regra, modo ou patch virtual da proteção de API pela API: a v1 só lê.
- Disparar o teste seguro de API, a avaliação de endpoints de IA ou a varredura de skills e ferramentas MCP por chave: só na tela.
- Firewall de MCP por chave: regras, inventário e eventos ficam na tela e nos webhooks.
- Teste de API com corpo ou credencial: o teste de fora usa só GET, HEAD e OPTIONS.