Proteja chamadas a APIs de modelos com o AI Gateway

Coloque o WASViking AI Gateway entre suas aplicações e OpenAI, Anthropic, Gemini, Azure OpenAI ou qualquer endpoint compatível com OpenAI. Traga a chave do seu provedor, crie um gateway e uma chave, aponte seu SDK para o gateway e veja cada decisão no registro de requisições.

O WASViking^® AI Gateway fica entre as suas aplicações e os provedores de modelos que elas chamam. Cada requisição é verificada contra as suas políticas do AI Guardian antes de sair: um segredo pode ser bloqueado, um dado pessoal pode ser trocado por um marcador, uma injeção de prompt pode ser barrada. As respostas podem ser inspecionadas antes de chegar à aplicação. Cada decisão fica registrada com a regra que a tomou, a versão da política e se ela foi de fato aplicada.

Suas aplicações continuam com o mesmo SDK. Elas trocam a URL base e a chave, e nada mais.

Para um primeiro uso guiado, com valores de exemplo e o resultado esperado em cada passo, siga Sua primeira requisição protegida pelo AI Gateway. Para fazer o Claude Code passar pelo gateway, veja Use o Claude Code pelo AI Gateway.

O gateway protege aplicações e scripts que chamam APIs de modelos. Colaboradores que usam ChatGPT, Claude ou Gemini no navegador são cobertos pela extensão de navegador do AI Guardian (Implantar o AI Guardian).

Nem toda aplicação de IA pode ser apontada para um gateway. Antes de planejar uma implantação, veja Quais aplicações de IA podem passar pelo AI Gateway: aplicação por aplicação, se o gateway se aplica e o que cobre o restante.

Antes de começar

• O AI Gateway é um add-on a partir do plano Pro, contratado à parte. Enquanto ele não faz parte do seu contrato, a tela dele mostra uma página bloqueada com Activate, que envia o pedido ao seu parceiro ou à equipe comercial da WASViking.
• Você precisa de um papel de administrador ou de um papel com acesso de gestão ao AI Gateway.
• Tenha em mãos a chave de API do provedor que você usa. Ela é guardada criptografada e nunca mais é exibida; as telas mostram só os quatro últimos caracteres.

Passo 1: ligue o AI Gateway

Abra AI Guard, Protection, AI Gateway e selecione Turn on the AI Gateway. Enquanto ele estiver desligado, toda requisição que apresentar uma chave do gateway é recusada. Você pode preparar tudo o que vem abaixo e ligar no final.

Passo 2: adicione uma credencial de provedor

Em Providers & Models, selecione Add credential:

Selecione Test na nova linha. O gateway pede ao provedor a lista de modelos com a sua chave e informa se a chave foi aceita, recusada ou se o endpoint não pôde ser alcançado.

Passo 3: crie um gateway

Um gateway é uma carga de trabalho: com chaves, modelos, guardrails, limites e orçamento próprios. Em Workloads, selecione New gateway:

Passo 4: adicione uma rota

Em Routing & Failover, escolha o gateway e a credencial, os modelos que a rota atende (*, um prefixo como gpt-4o* ou um nome exato) e se ela é primária ou de contingência. As rotas de contingência só entram quando uma primária falha ou responde com erro de servidor ou limite de taxa. Uma contingência atende o mesmo modelo, a menos que você o mapeie explicitamente em Serve as model, e a resposta sempre diz qual modelo respondeu (cabeçalho x-wasviking-routed-model).

Para ser avisado quando todas as rotas de um gateway falharem, abra Notification Channels e ative o evento AI Guardian Gateway Degraded em um canal. A aba Routing & Failover mostra quais canais o recebem.

Passo 5: crie uma chave

Em Access & Keys, selecione o gateway, dê um rótulo à chave e escolha a quem ela pertence: uma pessoa do seu diretório ou uma conta de serviço nomeada. Copie a chave quando ela aparecer: ela é exibida uma única vez. A revogação vale a partir da próxima requisição.

Passo 6: aponte sua aplicação para o gateway

A aba Integrations mostra as suas URLs base e exemplos prontos para copiar para o SDK da OpenAI, o SDK da Anthropic e o Gemini REST. A verificação mais rápida é uma requisição com curl:

curl https://api.wasviking.com/ai-gateway/openai/v1/chat/completions \
  -H "Authorization: Bearer $WASVIKING_GATEWAY_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "gpt-4o-mini", "messages": [{"role": "user", "content": "Hello"}]}'

A chave vai no cabeçalho que o seu SDK já usa: Authorization: Bearer, x-api-key ou x-goog-api-key. O gateway não traduz entre formatos: uma requisição no formato OpenAI chega a um provedor que fala o formato OpenAI.

Passo 7: crie as regras que importam

Em AI Guardian Policies, crie regras e escolha onde elas se aplicam: AI Gateway: requests, AI Gateway: responses ou ambos. Regras comuns para começar:

• Bloquear segredos em prompts (classe de dado secret, ação Block).
• Ocultar dados pessoais em prompts (classe de dado pii, ação Redact and forward).
• Bloquear injeção de prompt (ameaça instruction override, ação Block).
• Reter respostas que contenham segredos (classe de dado secret em responses, ação Block).

Coloque uma regra nova em Audit only para ver o que ela faria antes de aplicar. O Policy simulator, na mesma tela, passa uma amostra pelas suas regras e explica a decisão.

Leia o registro de requisições

Traffic lista cada requisição com quem chamou, o modelo pedido e o modelo que respondeu, a decisão, a regra, o status, a latência e o custo estimado. Selecione uma linha para ver o detalhe: as classes de dados encontradas, as versões de política e de detectores, os tokens e o trace id. Prompts e respostas nunca são guardados, só a classificação deles.

Rótulos que vale conhecer:

• Blocked e Redacted contam só o que o gateway aplicou.
• (audit only) significa que uma regra casou mas não mudou nada.
• Would block (streamed, not enforced) significa que a resposta já tinha sido transmitida quando a detecção aconteceu.
• Failed: provider unavailable significa que a sua política permitiu a requisição, mas nenhuma rota de provedor respondeu.
• Refused: request too large significa que a requisição passou do limite de tamanho do gateway e não chegou a nenhum provedor.

O gasto é uma estimativa a partir de preços de tabela, não a fatura do provedor. Modelos que a tabela de preços não conhece aparecem como not priced e não contam para orçamento. Respostas em streaming também contam: quando um provedor não informa a contagem de tokens de um streaming, o gateway estima pelo tamanho do texto e o detalhe da requisição indica isso.

Uso e limites

O seu contrato define quantas requisições ao AI Gateway a organização faz nos últimos 30 dias, inclusive as bloqueadas, e quantas conexões simultâneas ela pode manter (respostas em streaming ainda abertas). Um painel logo abaixo do cabeçalho da tela AI Gateway mostra o uso frente ao contrato, e a aba AI Guardian de Profile & Plan Usage traz os mesmos números em um cartão por módulo.

• Os avisos saem em 80% e em 100% do contrato, para os destinos de alerta inscritos em AI Guardian Usage e por e-mail para os administradores da organização.
• Acima do contrato nada é cobrado automaticamente e a proteção nunca para: toda decisão continua valendo. As requisições permitidas sem nenhum achado (nenhuma regra, detecção, redação, máscara, aprovação ou erro) deixam de ser registradas enquanto o uso continuar acima.
• Depois de 30 dias acima do contrato, novas chaves do gateway esperam até a capacidade ser aumentada. As chaves existentes continuam funcionando, e a espera acaba assim que a capacidade é aumentada. Enquanto o uso está acima, o painel mostra a data a partir da qual as novas chaves passariam a esperar.
• Uma requisição nova acima das conexões simultâneas é respondida na hora com 429 concurrency_limit e Retry-After: 2. As requisições que já estão rodando nunca são cortadas.

Quem aumenta a capacidade é o seu parceiro WASViking, ou a equipe comercial da WASViking se você compra direto. Se a sua organização recebeu o AI Gateway como um trial de 60 dias quando os módulos foram empacotados, o painel também mostra a data em que o trial termina.

Solução de problemas

Próximos passos

• Proteja as ferramentas dos agentes com o MCP Gateway.
• Meça suas regras com o AI Security Testing e mantenha o registro no AI Governance (Visão geral do AI Guardian).
• Inscreva um canal em AI Guardian Gateway Degraded em Alert destinations para saber quando um gateway não consegue avaliar a política ou alcançar um provedor.