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

Skip to content
Menu da documentação

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.

FuncionalidadeO que fazNa área logada
AI FirewallMascaramento 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 DetectionDetector 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 PostureInventário do uso de IA pelo navegador e pelo perímetro da rede./plataforma/navegador
AI Security TestingAvaliaçã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 PostureInventá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 SecurityTeste 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 ProtectionProteçã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 FirewallFirewall 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

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.

#Primeiro uso

  1. 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).
  2. 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).

bash
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}]}'
json
{
  "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.

RotaQuem chamaEscopo
/api/shield/v1/policy, /telemetry, /upstream-tokenGateway da proteção de API rodando na sua bordaapi-shield:gateway
/api/guard/v1/decide, /config, /approvals/{id}Extensão do Guard no navegadorGuard no navegador (extensão) guard:decide
/api/guard/v1/connect, /reportProxy de perímetro do GuardGuard no perímetro (proxy) guard:perimeter

#Rotas da API

RotaEscopoPara quêCLI
POST /api/v1/api-security/trafficEnviar tráfego de APIs (log do gateway) api-security:ingestEnviar tráfego observado (log do gateway ou espelhamento)aiuby apis traffic
GET /api/v1/api-security/applicationsLer a engenharia (API v1) engineering:readAplicações do inventário de APIsaiuby apis applications
GET /api/v1/api-security/policiesLer a engenharia (API v1) engineering:readPolíticas configuráveis de posturaaiuby apis policies
GET /api/v1/api-security/apis/{id}/specLer a engenharia (API v1) engineering:readOpenAPI gerado do inventárioaiuby apis spec <id>
GET /api/v1/api-security/apisLer a engenharia (API v1) engineering:readInventário de APIsaiuby apis list
GET /api/v1/api-security/apis/{id}Ler a engenharia (API v1) engineering:readUma API do inventárioaiuby apis get <id>
GET /api/v1/api-security/apis/{id}/driftLer a engenharia (API v1) engineering:readDrift da especificaçãoaiuby apis drift <id>
GET /api/v1/api-security/findingsLer a engenharia (API v1) engineering:readAchados de postura de APIaiuby apis findings
GET /api/v1/api-protection/protectionsLer a engenharia (API v1) engineering:readProteções de APIaiuby api-protection list
GET /api/v1/api-protection/protections/{id}Ler a engenharia (API v1) engineering:readUma proteção de APIaiuby api-protection get <id>
GET /api/v1/api-protection/protections/{id}/statsLer a engenharia (API v1) engineering:readEstatísticas de uma proteçãoaiuby api-protection stats <id>
GET /api/v1/api-protection/protections/{id}/samplesLer a engenharia (API v1) engineering:readAmostras redigidas de uma proteçãoaiuby 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.