segunda-feira, 16 de novembro de 2026 Edição nº 240
Buscar
Avaliação Conduzido por humano, com apoio de IA · Infraestrutura · 96 min de leitura

Lambda MicroVM: Hands-On com Injeção de Credenciais no Egress usando iron-proxy

Por Fabio Douek

Conduzido por humano, com apoio de IA. Pesquisa e implementação feitas com ferramentas de IA, conduzidas, testadas e editadas por mim. Como os posts são classificados

Ir para seção
Explica (TLDR) como se eu fosse...
O que é isso?

Imagine que o seu robô ajudante quer comprar doces, mas você não confia dinheiro de verdade a ele. Então você dá a ele moedas de mentirinha e uma sala de brinquedos com uma porta só, e essa porta dá para um adulto. Qualquer loja que o robô procure na lista telefônica, a página diz "pergunte ao adulto", e o adulto troca cada moeda de mentirinha por uma de verdade, mas só nas lojas que você aprovou.

Não tem janelas, e a lista telefônica não consegue levar bilhetes secretos, porque toda página aponta para o mesmo adulto. Mas o adulto ainda não consegue diferenciar o seu robô do robô do seu amigo.

O arranjo coloca um intermediário controlado entre o código em que a organização não confia e todos os serviços externos que esse código usa. Os sandboxes ficam em uma rede sem rota para a internet, todo nome que eles consultam resolve para esse intermediário, e só ele guarda as credenciais reais.

Permanece uma exposição residual. Qualquer sandbox que alcance o proxy pode usar as credenciais dele, a trilha de auditoria não consegue atribuir um request a um sandbox específico, dados ainda podem ir para destinos aprovados, e o controle de DNS depende de algumas configurações do firewall, das quais só uma está travada contra alterações. Trate-o como um controle forte com exceções documentadas.

A condição é a exposição de credenciais em sandboxes que rodam código de agentes. A intervenção move todas as credenciais para um proxy, remove a rota do sandbox para a internet e aponta toda resposta de DNS para o proxy. Nos testes, Claude Code, git e a AWS CLI funcionaram sem nenhuma configuração de proxy enquanto o sandbox guardava só placeholders.

Efeitos colaterais: tudo o que não é HTTP falha devagar, por timeout, o proxy faz fail open quando não consegue buscar um segredo, e a proteção de DNS depende de a associação e as regras do firewall continuarem no lugar. Indicado para uso com um único tenant, como testado.

Repare no alívio de entregar as chaves a um agente sem entregar as chaves, e sem pedir a ninguém que se lembre de uma configuração de proxy. Não há nada real na sala para imprimir, e nenhuma porta para fora da sala além daquela que o proxy vigia.

A preocupação não desaparece, ela muda de lugar. Agora alguém é dono de um proxy cujas regras são a verdadeira policy e de uma configuração de DNS da qual tudo depende, e o proxy compartilhado não consegue dizer qual sandbox pediu o quê. Isso merece uma conversa honesta antes que mais de um time dependa dele.

Pense no sandbox como uma sala com isolamento acústico e um único cabo até a mesa, e no iron-proxy como o técnico de som. Qualquer canal que a banda chame está ligado à mesa, e o técnico só coloca o sinal real nos canais que estão no setlist.

O ritmo se mantém: Claude Code, git e a AWS CLI tocam no andamento normal sem reafinar nada. O que não está em um cabo simplesmente morre na sala, e o técnico ainda não consegue ver qual músico está em qual canal.

A proposta é "agentes com credenciais que eles nunca veem, e nenhuma configuração de proxy para errar." O sandbox guarda placeholders, a rede dele só leva ao proxy, e um agente abriu um pull request real sem nada secreto dentro da VM.

A parte da história que os compradores vão questionar: é encanamento open source que você mesmo opera, cerca de US$ 0,10 por hora de infraestrutura fixa, um único proxy compartilhado do jeito que foi montado, e ainda pré-1.0. O valor está no controle e em uma trilha de auditoria, não em um produto pronto para uso.

GitHub Veja o código-fonte aqui: lambda-microvm-iron-proxy

Visão Geral

A parte 1 terminou com duas lacunas. O egress padrão de uma Lambda MicroVM é a internet aberta, e qualquer código dentro dela consegue ler as credenciais da execution role. O Lambda oferece um único controle para a primeira lacuna: um VPC egress connector, a partir do qual passam a valer as rotas, os security groups e o DNS da sua VPC. Não há proxy de egress, nem allowlist de domínios, nem injeção de credenciais. Então um agente que precisa de uma chave da Anthropic, de um token do GitHub e de algum acesso à AWS normalmente receberia os três como variáveis de ambiente, onde um printenv via prompt injection consegue pegá-los.

Este post, parte 2 de 3, constrói a camada que falta com o iron-proxy, um proxy de egress open source da Paradigm (Go, Apache-2.0, v0.55.0 lançada em 2026-11-02). Ele intercepta TLS, nega por padrão, troca tokens placeholder por segredos reais guardados fora do sandbox e reassina requests SigV4 da AWS com a própria role. Eu o rodo no ECS Fargate atrás de um Network Load Balancer interno, em uma VPC só dele. As MicroVMs ganham uma segunda VPC sem rota para a internet, ligada à primeira por peering, onde uma regra do DNS Firewall responde a todo nome com os endereços do load balancer. Um sandbox não precisa de nenhuma configuração de proxy: seja lá ao que ele se conecte, ele chega ao iron-proxy ou a lugar nenhum. A parte 3 adiciona um workspace no navegador sobre este mesmo proxy, usando um control plane opcional que fica aqui.

A minha primeira versão usava uma VPC e uma configuração HTTPS_PROXY em cada sandbox; as próximas seções explicam por que ela virou duas, e como cada peça funciona. Depois eu testei a cerca, como a injeção se comporta, o Claude Code abrindo um pull request real, tentativas de tirar as credenciais, rotação e revogação, regras de path, o que o DNS deixa escapar e o que acontece quando o controle de DNS é removido. Tudo rodou em 2026-11-04 na us-east-1, com o iron-proxy 0.55.0 fixado por digest da imagem, Claude Code 2.1.317, gh 2.103.3 e a AWS CLI v2 dentro da MicroVM.

Arquitetura

SANDBOX VPC (10.51.0.0/16) sem internet gateway, sem NAT gateway Lambda MicroVM Claude Code · git · gh · aws só chaves placeholder cert. da CA demo (público) sem configuração de proxy sem execution role Route 53 Resolver 10.51.0.2, 169.254.169.253 query log: queries sem cache DNS Firewall 100 ALLOW proxy.sandbox.internal 200 BLOCK *, OVERRIDE com um CNAME para proxy.sandbox.internal fail closed, mutation protection zona privada sandbox.internal proxy.sandbox.internal A 10.50.10.10, 10.50.11.10 consulta resposta: CNAME proxy.sandbox.internal + A 10.50.10.10, 10.50.11.10 HTTP(S) egress connector 2 ENIs gerenciadas pelo Lambda SG: saída TCP 80, 443, 8080 só para o SG do NLB rotas do sandbox local 10.50.10.10/32 → peering 10.50.11.10/32 → peering O QUE NÃO CHEGA A LUGAR NENHUM: TIMEOUT IPs diretos IPs reais, DNS público sem rota de saída IPv6 /128 dado pelo Lambda sem caminho portas não HTTP SSH, SMTP, TCP puro o SG as descarta PROXY VPC (10.50.0.0/16) DNS normal do Route 53 VPC peering não transitivo SGs referenciados nele NLB interno 10.50.10.10, 10.50.11.10 TCP 80, 443, 8080 SG: só o SG do connector iron-proxy (Fargate) transparente em 80 e 443 host via SNI / header Host interceptação de TLS, CA própria allowlist, negação por padrão secrets: placeholder → real aws_auth: reassina SigV4 log de auditoria → CloudWatch NAT gateway subnet pública um IP público internet api.anthropic.com github.com *.amazonaws.com Secrets Manager Anthropic, GitHub ttl 30 s tráfego DNS beco sem saída

O design tem quatro camadas, e cada uma cobre algo que as outras não cobrem:

  • A rede é a cerca. A VPC do sandbox não tem internet gateway nem NAT gateway, e as únicas rotas dela levam aos dois endereços do load balancer. O security group do connector restringe essas rotas a TCP 80, 443 e 8080.
  • O DNS aponta tudo para o proxy. Todo nome que um sandbox consulta volta como os endereços do load balancer, então os clientes chegam ao iron-proxy sem saber disso, e nenhuma consulta sai da VPC.
  • O iron-proxy é a policy. Ele decide quais hosts são alcançáveis e qual credencial cada um recebe.
  • Placeholders são tudo o que o sandbox guarda. O certificado da CA do proxy vem embutido na imagem (ele é público); a chave privada, os tokens reais e a role da AWS ficam todos do lado do proxy. (Aqui o Terraform gera a CA, então a chave também fica no state local dele: aceitável para uma demo, não para produção.)

Por que duas VPCs

O que uma única VPC não conseguia fazer

A primeira versão tinha uma única VPC: o connector das MicroVMs, o NAT gateway e o iron-proxy a compartilhavam, o security group do connector era a cerca, e cada sandbox recebia um HTTPS_PROXY apontando para o load balancer. Funcionou para uma policy no nível de host, e bateu em três paredes.

  1. O HTTPS_PROXY quebra as regras mais finas do iron-proxy. Com HTTPS_PROXY, o iron-proxy 0.55.0 só vê um túnel CONNECT api.github.com:443, com path vazio e nenhum dos headers do request, então as regras de path e o require: true (que rejeita requests que não carregam um placeholder) recusam todos os túneis (Teste 10, issue #222); e os clientes que ignoram a configuração, como o fetch do Node, simplesmente ficavam bloqueados pela cerca.
  2. Interceptar nomes um a um esbarrou na AWS. A forma de contornar o CONNECT é a interceptação transparente: o DNS responde api.github.com com o endereço do proxy, e o cliente fala TLS diretamente com o proxy. O iron-proxy traz um servidor DNS para isso, mas não dá para apontar uma MicroVM para ele: o /etc/resolv.conf é um mount somente leitura, e reescrevê-lo no run hook matou a MicroVM. Então eu usei uma private hosted zone do Route 53 por nome interceptado. Só que uma zona privada vale para tudo na VPC dela, e essa VPC também rodava o Fargate e os serviços da parte 3, que chamam a AWS por conta própria. Qualquer nome da AWS interceptado para os sandboxes também teria sido interceptado para eles, então os endpoints da AWS ficaram de fora, e nesse modo a AWS CLI em um sandbox não tinha saída nenhuma. O próprio iron-proxy precisava resolver os upstreams dele pelo 1.1.1.1 para não acabar encontrando a si mesmo.
  3. O DNS precisava de um firewall próprio, compartilhado com o proxy. Os security groups não filtram o resolver de DNS da VPC, e o resolver é recursivo: uma MicroVM cercada ainda podia consultar <data>.attacker.example, e o resolver levaria esse label até os name servers do atacante. Fechar isso exigiu uma allowlist de domínios no DNS Firewall. Como o firewall cobre a VPC inteira, a lista precisava incluir tudo o que a infraestrutura do proxy consulta, e ela quebrou os pulls de imagem do Fargate (um nome do Docker Hub é um CNAME para uma CDN) até eu ajustá-la.

O fio condutor: zonas privadas, regras do Resolver e DNS Firewall valem todos para uma VPC inteira, não para uma subnet. Os sandboxes precisam de um DNS que mande todo nome para o proxy; o iron-proxy e os serviços da AWS em volta dele precisam de um DNS que diga a verdade. A forma limpa de dar respostas diferentes a cada um são duas VPCs.

A divisão

VPC O que tem nela Rotas DNS
proxy, 10.50.0.0/16NAT gateway, NLB interno (10.50.10.10, 10.50.11.10), iron-proxy no Fargatea internet pelo NAT; as duas subnets do connector pelo peeringrespostas normais do Route 53
sandbox, 10.51.0.0/16as duas interfaces de rede do egress connector, nada maislocal, e os dois /32 do NLB pelo peeringtodo nome respondido com os endereços do NLB

A VPC do sandbox não tem rota nenhuma para a internet. Ela não tem internet gateway nem NAT gateway para onde uma rota possa apontar, e a conexão de peering não pode fazer esse papel, porque o peering não é transitivo: o tráfego da VPC do sandbox não consegue sair pelo NAT gateway da VPC do proxy, digam o que disserem as rotas. O security group deixa de ser a única cerca. Ele restringe as duas rotas a três portas em um único load balancer.

O que muda para os clientes

Nada para configurar. Um sandbox não recebe HTTPS_PROXY, e qualquer que seja o nome ao qual ele se conecte, ele cai no iron-proxy:

  • curl, git, gh, a AWS CLI, Claude Code, o urllib do Python e o fetch do Node funcionam todos sem modificação, inclusive os clientes que nunca leem configurações de proxy.
  • Todo request chega ao iron-proxy como uma conexão TLS direta na 443 (ou HTTP na 80), então ele vê o método, o path e os headers reais, e as regras de path e o require funcionam (Teste 10).
  • Os endpoints da AWS são interceptados como qualquer outro nome, e o aws_auth reassina as chamadas (Teste 6).
  • O sandbox ainda precisa dos placeholders e da CA do proxy, que a imagem e o payload do run fornecem.

Antes de reconstruir o stack deste post, eu rodei o design de ponta a ponta em um par descartável de VPCs: 181 verificações, nenhuma falhou. Dois resultados dessa rodada não aparecem nos testes abaixo. O ciclo de vida da MicroVM não mudou: iniciar, suspender, retomar, a suspensão automática por inatividade e encerrar se comportaram como na parte 1. E conexões de longa duração se mantêm: uma conexão foi reutilizada no mesmo socket depois de 420 s ociosa.

Quanto custa

Mais ou menos o mesmo que uma VPC só. O peering não tem cobrança por hora, a zona privada custa US$ 0,50 por mês, e o DNS Firewall custa US$ 0,60 por milhão de consultas. A camada fixa fica em cerca de US$ 0,095 por hora; a tabela está em Preços.

Como as peças funcionam

Cada componente do diagrama é um bloco padrão da AWS ou do proxy, e o design só se sustenta se você souber o que cada um cobre e o que não cobre. Aqui estão eles na ordem em que um request os encontra.

O VPC egress connector

As Lambda MicroVMs recebem a rede delas de network connectors, escolhidos por MicroVM no momento do run-microvm e fixos durante toda a vida dela. Entrada e saída são separadas. O Lambda oferece connectors gerenciados (HTTP_INGRESS para o endpoint HTTPS da MicroVM, SHELL_INGRESS para o shell, INTERNET_EGRESS para saída para a internet, que é o padrão) e permite que você crie os seus próprios para o tráfego de saída: um VPC egress connector.

Um VPC egress connector é um recurso lambda-core que aponta para subnets e security groups na sua VPC, aqui a VPC do sandbox. O Lambda cria interfaces de rede nessas subnets, usando uma operator role que você entrega a ele e que pode criá-las e colocar tags nelas, e toda conexão de saída da MicroVM sai por uma delas. Este connector tem exatamente duas, uma por subnet, compartilhadas por todas as MicroVMs que rodam nele. Elas são gerenciadas pelo Lambda (InterfaceType: lambda), e o describe-network-interfaces só as lista com IncludeManagedResources. A partir daí é tráfego comum de VPC: as suas rotas, os seus security groups, o seu resolver.

O connector substitui o caminho padrão para a internet em vez de se somar a ele; pedir INTERNET_EGRESS e um VPC connector juntos é rejeitado (Only one default route egress network connector can be provided). O tráfego de entrada não muda: o endpoint da MicroVM, que a parte 3 usa para os terminais, continua passando pelo ingress gerenciado do Lambda com os próprios tokens, e não pela sua VPC. O security group do connector aqui não tem nenhuma regra de entrada, e o endpoint funciona. Duas coisas nunca passam pelo connector: o endpoint de metadata, que é roteado dentro da VM, e o endereço IPv6 que o Lambda dá a toda MicroVM, já que o connector é só IPv4 (Onde o design para).

Security groups: a cerca no último salto

Um security group é um firewall stateful associado a interfaces de rede, aqui as duas do connector. Stateful quer dizer que as respostas a conexões permitidas voltam sozinhas, então a cerca só precisa de regras de egress. E uma regra pode citar outro security group em vez de uma faixa de IPs; com peering na mesma região, esse grupo pode estar na outra VPC:

  • o grupo do connector pode enviar TCP 80, 443 e 8080 para qualquer coisa que tenha o grupo do NLB;
  • o grupo do NLB aceita essas portas de qualquer coisa que tenha o grupo do connector;
  • o grupo do próprio iron-proxy só aceita tráfego do grupo do NLB.

Nada mais na VPC do proxy corresponde: nem o NAT gateway, nem a task do iron-proxy diretamente, nem o resolver da VPC do proxy (o Teste 1 tenta cada um; ali, as rotas os barram antes de os security groups entrarem em jogo). A AWS documenta essas referências através do peering, mas não especificamente para interfaces gerenciadas pelo Lambda. Elas corresponderam, neste stack e na rodada de ponta a ponta antes dele, e o describe-security-group-rules mostra a conexão de peering em cada referência.

Os security groups têm pontos cegos documentados: eles não filtram o tráfego para o próprio resolver de DNS da VPC, para o metadata da instância ou para alguns outros serviços da AWS. É por isso que o DNS ganha um controle próprio mais abaixo, e é por isso que estas MicroVMs rodam sem execution role.

VPC peering

Uma conexão de peering é um link privado entre duas VPCs, aqui na mesma conta e na mesma região, aceito automaticamente. Ela não carrega nada até que tabelas de rotas apontem para ela, e aqui elas apontam de forma estreita. A tabela de rotas do sandbox manda só os dois /32 do NLB para ela, e a tabela de rotas das subnets do proxy manda de volta só as duas subnets do connector. Nenhum dos lados tem rota para a outra VPC inteira.

O peering não é transitivo. O tráfego não consegue entrar por uma conexão de peering e sair pelo internet gateway, pelo NAT gateway ou por outro peering daquela VPC. É isso que faz o “sem rota para a internet” valer para a VPC do sandbox: nem uma rota 0.0.0.0/0 para o peering chegaria ao NAT gateway da VPC do proxy. O único destino útil do outro lado é o load balancer.

O peering não tem cobrança por hora. Os dados são gratuitos dentro de uma Availability Zone e custam US$ 0,01 por GB em cada direção entre zonas.

Route 53 Resolver, a zona privada e o override do DNS Firewall

Toda VPC tem um resolver de DNS embutido, o Route 53 Resolver, no endereço base dela mais dois (aqui, 10.51.0.2) e em 169.254.169.253. Uma MicroVM em um VPC connector resolve por ele: o /etc/resolv.conf dela, somente leitura, lista o stub local do Lambda, 127.0.0.2 e 169.254.53.53, que encaminha para o resolver da VPC. Para nomes públicos, esse resolver é recursivo, e os security groups não conseguem filtrá-lo. É isso que faz do DNS um canal de saída de um sandbox cercado: uma consulta a <data>.attacker.example leva o label até os name servers de attacker.example, que o atacante opera.

Três recursos do Route 53 transformam o resolver da VPC do sandbox no diretório do proxy:

  • Uma private hosted zone, sandbox.internal, visível só na VPC do sandbox. Ela tem um único registro: proxy.sandbox.internal, um registro A com os dois endereços do NLB.
  • O DNS Firewall filtra as consultas que uma VPC envia ao resolver dela, com regras em ordem de prioridade. Uma regra BLOCK responde NODATA ou NXDOMAIN, ou, com uma resposta OVERRIDE, um registro que você escolhe. Aqui a regra 100 permite proxy.sandbox.internal, e a regra 200 corresponde a todos os outros nomes (*) e responde com um CNAME para proxy.sandbox.internal. O firewall da VPC está configurado para fail closed: se ele não consegue avaliar uma consulta, a consulta é bloqueada em vez de respondida.
  • O query logging registra cada consulta que o próprio resolver responde (não as que ele serve do cache), com a ação do firewall.

O próprio resolver segue o CNAME do override até a zona privada, então uma única resposta traz o CNAME e os dois endereços. De dentro de uma MicroVM:

$ dig api.github.com
;; ->>HEADER<<- opcode: QUERY, status: NOERROR, id: 5180
;; flags: qr rd ra; QUERY: 1, ANSWER: 3, AUTHORITY: 0, ADDITIONAL: 1
api.github.com.		60	IN	CNAME	proxy.sandbox.internal.
proxy.sandbox.internal.	60	IN	A	10.50.10.10
proxy.sandbox.internal.	60	IN	A	10.50.11.10
;; Query time: 10 msec
;; SERVER: 127.0.0.2#53(127.0.0.2) (UDP)

Todo nome recebe essa resposta, exista ele ou não. Os outros tipos de registro testados recebem só o CNAME, sem dados: AAAA, TXT, MX, NS, HTTPS e consultas reversas de endereços públicos. Nenhuma consulta chega à internet por recursão: a AWS documenta que uma consulta bloqueada não segue para o destino, então uma consulta não consegue levar dados para fora, e nenhum registro TXT consegue trazer dados para dentro. Ao contrário de uma allowlist de domínios, não há nada para ajustar, porque a infraestrutura da VPC do proxy não fica atrás deste firewall. O Teste 11 verifica sete tipos de registro e todos os quatro endereços de resolver que a MicroVM alcança, por UDP, mais TCP para dois deles (a rodada de ponta a ponta tentou TCP nos quatro).

Há uma regra que eu não consigo provar que é necessária: o ALLOW para o nome do próprio proxy nunca aparece no query log. Mas, por padrão, o DNS Firewall inspeciona todo nome em uma cadeia de CNAME, e o alvo do override, sem ela, também corresponderia a *, o que é um bom motivo para mantê-la.

O Network Load Balancer interno

O iron-proxy roda como uma task do Fargate, e uma task recebe um endereço IP novo toda vez que reinicia. O registro DNS e os security groups precisam de algo estável, e o NLB fornece isso. Ele é interno (sem endereço público), com um IP privado fixo por subnet do proxy (10.50.10.10 e 10.50.11.10) e um security group próprio. Cada endereço fixo fica dentro de uma reserva explícita de CIDR da subnet, então a AWS não consegue atribuí-lo a outra interface, como a de uma nova task do Fargate, antes de o NLB ocupá-lo.

O NLB repassa o TCP direto, sem tocar no TLS, nas portas 80 e 443, mais a 8080 para as comparações com HTTPS_PROXY. Ele faz health check do iron-proxy na porta de métricas dele e mantém conexões ociosas abertas por uma hora. Todo nome resolve para os dois endereços, então um cliente cujo primeiro endereço falha pode tentar o outro, depois do connect timeout dele. Um efeito colateral importa mais adiante: o iron-proxy vê toda conexão chegando dos endereços do NLB, nunca dos de uma MicroVM.

iron-proxy: interceptação, placeholders, regras

O tráfego chega ao iron-proxy de forma transparente: o cliente resolve api.github.com para o NLB, conecta na porta 443 achando que é o GitHub e inicia o TLS. O iron-proxy lê o host pretendido no SNI do handshake, ou no header Host na porta 80, e responde com um certificado para esse host, assinado pela própria CA, na qual o sandbox confia porque o certificado da CA está na imagem dele. Isso é interceptação de TLS: o proxy agora vê o request HTTP em texto claro, passa o request pelos transforms dele em ordem e abre a própria conexão TLS com o host real, que ele resolve pelo resolver comum da VPC do proxy. O servidor DNS do próprio iron-proxy fica desligado, e o listener HTTPS_PROXY dele aparece aqui só em comparações.

  1. allowlist: negação por padrão; só passam os hosts listados (e, opcionalmente, métodos e paths). Um host recusado ainda completa o TLS com um certificado do proxy e depois recebe um HTTP 403.
  2. secrets: procura o placeholder de uma credencial (nos headers, na query string ou no body, conforme configurado) nos hosts aos quais essa credencial está vinculada, e o substitui pelo valor real do Secrets Manager, em cache por 30 s.
  3. aws_auth: descarta a assinatura AWS do cliente e reassina o request com a role do próprio proxy, se o serviço e a região forem permitidos.

Toda decisão vai para um log de auditoria com o host, o path, o status, o transform que a recusou e qual segredo foi trocado onde. Um placeholder é só uma string fixa e inventada por credencial, como ghp_proxyplaceholder000…. Ele existe para que os clientes tenham algo para enviar onde vai uma chave; ele não é um segredo, e este post mostra todos eles.

O que fica isolado do quê

Fronteira Fornecida por Impede Não impede
Computaçãouma MicroVM Firecracker por sandbox (parte 1)sandboxes compartilhando kernel ou memóriao que um sandbox envia para fora; as linhas abaixo cobrem isso
RotasVPC do sandbox sem gateways, peering com duas rotas /32toda conexão para um endereço que não seja o do NLBIPv6 na interface do próprio Lambda (não chega a lugar nenhum, mas a VPC não o controla)
Portassecurity groups do connector e do NLB, referenciados através do peeringqualquer coisa além de TCP 80, 443 e 8080 para o NLBDNS para o resolver da VPC, o endpoint de metadata
DNSoverride do DNS Firewall e a zona privadaconsultas chegando à internet, dados em nomes ou em registros TXTalguém com permissões no Route 53 Resolver removendo a associação, ou mudando as regras para que um ALLOW corresponda primeiro (o Teste 11 mostra o primeiro caso)
Destinosallowlist do iron-proxyhosts fora da listaenviar dados para um host permitido, como um gist no GitHub
Credenciaisplaceholders, valores reais só no proxyler uma chave real de dentro da VMusar a chave através do proxy, a partir de qualquer sandbox que o alcance
Identidade AWSsem execution role; o aws_auth assina no lugar delacredenciais da AWS no endpoint de metadatachamadas que a role do proxy permite
Tenantsum proxy por tenant (não construído aqui)um tenant usando as credenciais de outrocom um único proxy compartilhado: nada; o log nem consegue dizer qual sandbox agiu (Teste 9)

Os testes abaixo verificam as linhas de Rotas para baixo: o que cada uma impede e o que passa por ela.

Onde o design para

  • A cerca só cobre as MicroVMs no connector. O run-microvm recebe o egress connector por MicroVM, e uma MicroVM iniciada sem egress connector, ou com uma lista vazia, recebe o INTERNET_EGRESS gerenciado do Lambda: a internet aberta, sem peering, DNS Firewall ou proxy no caminho. O que quer que inicie sandboxes precisa passar o connector toda vez, como o common.run() faz.
  • O que não é HTTP falha devagar. git sobre SSH, SMTP, TCP puro e outras portas resolvem para o NLB como qualquer nome, mas o security group só permite TCP 80, 443 e 8080, então os pacotes deles são descartados; o QUIC, que é UDP, não é permitido de forma alguma. O cliente não recebe nenhuma recusa; ele espera até o connect timeout estourar. Um agente que tenta SSH fica travado pelo tempo que a ferramenta dele permitir, então aponte o git para HTTPS.
  • O IPv6 está presente, mas morto. O Lambda dá a cada MicroVM um endereço IPv6 global na faixa da AWS e uma rota IPv6 padrão, embora nenhuma das VPCs tenha IPv6 e o connector seja só IPv4. Toda conexão IPv6 que eu tentei deu timeout (02_fence.py), inclusive para os endpoints dual-stack da própria AWS. Mas é uma interface que as rotas e os security groups da VPC não controlam, então isso é testado, e não presumido.
  • O controle de DNS depende de algumas configurações do Resolver, e só uma está protegida. Se o rule group for desassociado da VPC do sandbox, ou se as regras dele mudarem de forma que um ALLOW corresponda primeiro, o resolver volta na hora para a resolução recursiva (no Teste 11, a primeira consulta depois da desassociação já foi resolvida recursivamente), e as consultas voltam a ser um canal de saída; as rotas continuam bloqueando toda conexão direta (12_dns_firewall.py). A mutation protection cobre só a associação: removê-la é recusado até que alguém desligue a proteção com uma chamada separada. As regras, as domain lists e qualquer novo rule group associado com prioridade mais alta não estão protegidos, e, pela ordem de avaliação documentada pela AWS, cada um deles está a uma chamada de reabrir a recursão (eu testei só a desassociação). Então proteja o rule group, as domain lists dele e as associações da VPC com IAM ou com uma service control policy, para que só administradores possam alterá-los, e não o que quer que inicie sandboxes, e crie alarmes para toda alteração: uma regra do EventBridge sobre o CloudTrail envia cada alteração do DNS Firewall, recusada ou não, para um log group e um tópico SNS. O alarme detecta; ele não consegue desfazer. A mutation protection também bloqueia o terraform destroy, e é por isso que o scripts/destroy.sh a desliga primeiro. Um caso que eu não consegui testar: uma falha do próprio DNS Firewall. O modo fail closed deveria bloquear todas as consultas nesse caso, mas eu não consigo simular isso, nem verificar se o stub local do Lambda recorreria a outro resolver.
  • Um proxy para todos os sandboxes. Todos os sandboxes no connector compartilham o mesmo iron-proxy, as credenciais, as regras e o log de auditoria dele, e o proxy não consegue diferenciá-los (Teste 9). O workspace da parte 3 roda sobre este mesmo proxy, então compartilha a mesma limitação; identidade por sandbox no proxy fica para trabalho futuro.

Configuração

Passo 1: Credenciais a injetar

Três credenciais, e nenhuma delas entra na MicroVM:

  • Uma chave de API da Anthropic, para o Claude Code.
  • Um fine-grained token do GitHub restrito a um repositório de teste, com leitura e escrita no conteúdo e nos pull requests.
  • Uma role do IAM para a task do Fargate do proxy, que pode listar buckets do S3 e clusters do ECS e ler um bucket de demonstração. As chamadas do sandbox à AWS são reassinadas com ela.

O 01_setup.py lê as duas primeiras do .env e as grava no Secrets Manager. O Terraform só cria os segredos vazios, então os valores reais nunca vão parar no state file dele.

Passo 2: A VPC do proxy e o iron-proxy

O infra/proxy_vpc.tf cria a VPC do proxy: uma subnet pública com o NAT gateway, e duas subnets do proxy cuja tabela de rotas tem a rota para o NAT e rotas de retorno para as subnets do connector. O infra/proxy.tf adiciona o NLB interno com os seus endereços fixos, e o iron-proxy de ironsh/iron-proxy fixado por digest (as imagens não são assinadas), com 0,5 vCPU e 1 GB de Fargate ARM64. A imagem não tem configuração padrão e espera a CA em arquivos, então o entrypoint da task grava o certificado da CA, a chave da CA (do Secrets Manager) e a configuração renderizada antes de iniciá-lo.

Os listeners e os limites de upstream em infra/iron-proxy.yaml.tftpl, com cortes:

dns:
  enabled: false                # iron-proxy's DNS server stays off; DNS Firewall does that job
proxy:
  http_listen: ":80"            # transparent interception: plain HTTP
  https_listen: ":443"          # transparent interception: TLS, host from SNI
  upstream_deny_cidrs:          # replaces the defaults, so list them all
    - "169.254.169.254/32"      # IMDS
    - "169.254.170.2/32"        # the ECS task credentials endpoint: not in the defaults
    - "10.50.0.0/16"            # the proxy VPC
    - "10.51.0.0/16"            # the sandbox VPC
    # ...plus loopback, IMDS over IPv6 and the rest of RFC 1918
tls:
  mode: "mitm"

A lista de negação padrão cobre o IMDS e o loopback, mas não o 169.254.170.2, o endpoint onde o Fargate serve as credenciais da role da task. A allowlist já recusa IPs literais, então esta entrada é defesa em profundidade: se uma regra algum dia permitisse o endereço, o proxy ainda assim não se conectaria a ele.

Passo 3: As regras do proxy

O mesmo arquivo tem três transforms. Com cortes:

transforms:
  - name: allowlist
    config:
      domains: ["api.anthropic.com", "github.com", "api.github.com", "httpbin.org",
                "sts.us-east-1.amazonaws.com", "*.s3.us-east-1.amazonaws.com", "ecs.us-east-1.amazonaws.com"]
  - name: secrets
    config:
      secrets:
        - source: { type: aws_sm, secret_id: "<anthropic secret ARN>", ttl: "30s" }
          replace: { proxy_value: "sk-ant-api03-proxy-placeholder-…", match_headers: ["X-Api-Key", "Authorization"] }
          rules: [{ host: "api.anthropic.com" }]
        - source: { type: aws_sm, secret_id: "<github secret ARN>", ttl: "30s" }
          replace: { proxy_value: "ghp_proxyplaceholder000…", match_headers: ["Authorization"] }
          rules: [{ host: "api.github.com" }, { host: "github.com" }]
  - name: aws_auth
    config:
      credentials_provider: { type: workload_identity }   # the Fargate task role
      allowed_services: ["sts", "s3", "ecs"]
      allowed_regions: ["us-east-1"]
      rules: [{ host: "*.amazonaws.com" }]

A allowlist real é um pouco mais longa: o host de statsig da Anthropic, os hosts de download do GitHub, mais formatos de endpoint do S3 e do STS, e dois hosts da AWS (iam.amazonaws.com e o EC2 em us-west-2) que a allowlist deixa passar para que o Teste 6 possa mostrar o aws_auth recusando-os. Uma chave opcional, control_plane, usada pela parte 3, move a configuração do proxy para o S3 e assina as chamadas à AWS com uma role selecionável; tudo neste post roda com ela desligada.

Passo 4: A VPC do sandbox

O infra/sandbox_vpc.tf cria uma VPC com duas subnets do connector e nada para onde rotear: nenhum internet gateway, nenhum NAT gateway. A tabela de rotas dela recebe duas rotas além da local, uma por endereço do NLB, e o connector aponta para as duas subnets (com cortes):

resource "aws_route" "sandbox_to_nlb" {
  count                     = 2
  route_table_id            = aws_route_table.sandbox.id
  destination_cidr_block    = "${local.nlb_ips[count.index]}/32"   # 10.50.10.10/32, 10.50.11.10/32
  vpc_peering_connection_id = aws_vpc_peering_connection.p.id
}

resource "aws_lambdacore_network_connector" "sandbox" {
  name          = "my2cents-ip-sandbox"
  operator_role = aws_iam_role.operator.arn
  configuration {
    vpc_egress_configuration {
      subnet_ids                        = aws_subnet.connector[*].id
      security_group_ids                = [aws_security_group.connector.id]
      network_protocol                  = "IPv4"
      associated_compute_resource_types = ["MicroVm"]
    }
  }
}

Toda rota no repositório é um recurso aws_route separado. Uma tabela de rotas com blocos route inline é dona de todas as suas rotas, então misturar as duas formas faz cada terraform apply apagar as rotas do peering. O connector depende da associação do DNS Firewall (Passo 6), então nenhuma MicroVM consegue iniciar nele antes de todos os nomes serem reescritos. Ele levou cerca de quatro minutos e meio para ficar ativo.

Passo 5: O peering e os security groups

A conexão de peering e as duas metades da cerca, uma em cada VPC, cada uma apontando para o security group da outra (simplificado):

resource "aws_vpc_peering_connection" "p" {
  vpc_id      = aws_vpc.sandbox.id
  peer_vpc_id = aws_vpc.proxy.id
  auto_accept = true                       # same account, same Region
}

# Sandbox VPC: the connector may send TCP 80, 443 and 8080 to the NLB's group, across the peering
resource "aws_vpc_security_group_egress_rule" "connector_to_nlb" {
  for_each                     = toset(["80", "443", "8080"])
  security_group_id            = aws_security_group.connector.id
  referenced_security_group_id = aws_security_group.nlb.id
  ip_protocol                  = "tcp"
  from_port                    = tonumber(each.key)
  to_port                      = tonumber(each.key)
}

# Proxy VPC: the NLB accepts the same ports from the connector's group, and nothing else
resource "aws_vpc_security_group_ingress_rule" "nlb_from_connector" {
  for_each                     = toset(["80", "443", "8080"])
  security_group_id            = aws_security_group.nlb.id
  referenced_security_group_id = aws_security_group.connector.id
  ip_protocol                  = "tcp"
  from_port                    = tonumber(each.key)
  to_port                      = tonumber(each.key)
}

Do lado do proxy, a rota de retorno em infra/proxy_vpc.tf cobre só as duas subnets do connector, não a VPC do sandbox inteira.

Passo 6: DNS: a zona privada e o override

O infra/dns.tf tem as quatro peças: a zona, o único registro dela, a regra de override e a associação. Com cortes:

resource "aws_route53_zone" "sandbox" {
  name = "sandbox.internal"
  vpc { vpc_id = aws_vpc.sandbox.id }       # visible only in the sandbox VPC
}

resource "aws_route53_record" "proxy" {
  zone_id = aws_route53_zone.sandbox.zone_id
  name    = "proxy.sandbox.internal"
  type    = "A"
  ttl     = 60
  records = local.nlb_ips                   # both NLB addresses
}

resource "aws_route53_resolver_firewall_rule" "override_all" {
  name                    = "everything-to-proxy"
  action                  = "BLOCK"
  block_response          = "OVERRIDE"
  block_override_dns_type = "CNAME"
  block_override_domain   = "proxy.sandbox.internal."
  block_override_ttl      = 60
  firewall_domain_list_id = aws_route53_resolver_firewall_domain_list.everything.id   # ["*."]
  firewall_rule_group_id  = aws_route53_resolver_firewall_rule_group.g.id
  priority                = 200             # after ALLOW proxy.sandbox.internal. at 100
}

resource "aws_route53_resolver_firewall_rule_group_association" "sandbox" {
  name                   = "my2cents-ip-sandbox"
  firewall_rule_group_id = aws_route53_resolver_firewall_rule_group.g.id
  vpc_id                 = aws_vpc.sandbox.id
  priority               = 101
  mutation_protection    = "ENABLED"        # removal refused until this is switched off
}

resource "aws_route53_resolver_firewall_config" "sandbox" {
  resource_id        = aws_vpc.sandbox.id
  firewall_fail_open = "DISABLED"           # if the firewall fails, block
}

Escreva o domínio curinga como *.: a AWS armazena * dessa forma, então * deixa um diff permanente. O mesmo arquivo liga o query logging para a VPC do sandbox.

O controle de DNS depende de algumas configurações do Resolver, e só uma delas é protegida: a mutation protection cobre a associação, não as regras, as domain lists nem outros rule groups. Por isso o infra/alarm.tf tem uma regra do EventBridge para toda chamada registrada no CloudTrail que altere qualquer uma delas (com cortes):

resource "aws_cloudwatch_event_rule" "alarm" {
  event_pattern = jsonencode({
    source        = ["aws.route53resolver"]
    "detail-type" = ["AWS API Call via CloudTrail"]
    detail = {
      eventSource = ["route53resolver.amazonaws.com"]
      eventName = [
        # rules
        "CreateFirewallRule",
        "UpdateFirewallRule",
        "DeleteFirewallRule",
        # rule groups
        "CreateFirewallRuleGroup",
        "DeleteFirewallRuleGroup",
        # domain lists
        "CreateFirewallDomainList",
        "UpdateFirewallDomains",
        "ImportFirewallDomains",
        "DeleteFirewallDomainList",
        # associations with a VPC
        "AssociateFirewallRuleGroup",
        "UpdateFirewallRuleGroupAssociation",
        "DisassociateFirewallRuleGroup",
        # the VPC's fail-open setting
        "UpdateFirewallConfig",
        # the query log
        "DisassociateResolverQueryLogConfig",
      ]
    }
  })
}

O padrão não filtra por errorCode, então chamadas recusadas também correspondem a ele; a desassociação recusada do Teste 11 aparece no log do alarme. Cada correspondência vai para um log group e para um tópico SNS que você pode ligar a um pager. O alarme só detecta; o que impede é a proteção via IAM ou service control policy descrita em Onde o design para.

Passo 7: A imagem do sandbox

O images/sandbox/Dockerfile instala o Claude Code, o gh, o git e a AWS CLI sobre node:22-bookworm-slim, adiciona a CA do proxy ao repositório de certificados do sistema e aponta para ela a configuração de CA de cada cliente:

COPY ca.crt /usr/local/share/ca-certificates/iron-proxy-demo.crt
RUN update-ca-certificates \
 && git config --system credential.helper '!f() { echo username=x-access-token; echo "password=$GH_TOKEN"; }; f'
ENV NODE_EXTRA_CA_CERTS=/usr/local/share/ca-certificates/iron-proxy-demo.crt \
    SSL_CERT_FILE=/etc/ssl/certs/ca-certificates.crt \
    REQUESTS_CA_BUNDLE=/etc/ssl/certs/ca-certificates.crt \
    AWS_CA_BUNDLE=/etc/ssl/certs/ca-certificates.crt \
    IS_SANDBOX=1

Os placeholders não vêm embutidos na imagem. Eles chegam como JSON no payload do run hook, e o agente dentro da VM, images/sandbox/agent.py (adaptado do agente da parte 1), os grava em /etc/sandbox.env, que todo comando carrega. Isso inclui chaves placeholder da AWS: sem alguma chave, a AWS CLI se recusa a enviar qualquer coisa, e o aws_auth não teria nada para reassinar. Não há variáveis de proxy.

O terraform apply levou cerca de sete minutos a partir do zero, quatro e meio deles para o connector, que espera a associação do DNS Firewall, e o build da imagem levou 206,7 s.

Testes

Toda MicroVM abaixo roda no connector da VPC do sandbox sem execution role e sem configurações de proxy, iniciada pelo common.run(). Cada script oculta o ID da conta, os nomes dos buckets, os ARNs dos segredos e o IP público do NAT gateway, e termina com as próprias verificações de pass/fail. Na execução gravada em 2026-11-04, os 12 scripts passaram em todas as suas 172 verificações. As saídas longas aparecem em trechos, com a saída completa em um bloco recolhido; nas curtas, só o cabeçalho e as linhas PASS ficam de fora.

Teste 1: A cerca

O 02_fence.py imprime as rotas e o security group da VPC do sandbox e depois tenta todas as formas de sair a partir de uma MicroVM. Como agora todo nome resolve para o NLB, a única forma de sequer tentar uma conexão direta é usar um endereço IP real, então o script consulta esses endereços no meu laptop e os repassa:

=== The sandbox VPC: routes, gateways, the connector's security group
  route 10.50.10.10/32     -> pcx-05d1deac78c2809cd (active)
  route 10.50.11.10/32     -> pcx-05d1deac78c2809cd (active)
  route 10.51.0.0/16       -> local (active)
  internet gateways: 0, NAT gateways: 0
  connector SG egress  tcp 443-443 -> sg-08dcc03d049e8fe5b (NLB SG, across peering pcx-05d1deac78c2809cd)
  connector SG egress  tcp 8080-8080 -> sg-08dcc03d049e8fe5b (NLB SG, across peering pcx-05d1deac78c2809cd)
  connector SG egress  tcp 80-80 -> sg-08dcc03d049e8fe5b (NLB SG, across peering pcx-05d1deac78c2809cd)
  connector ENIs (Lambda-managed, listed only with IncludeManagedResources): 10.51.20.254 us-east-1a; 10.51.21.67 us-east-1b

MicroVM microvm-4bfac5ab-19d3-3028-8717-d854f2f7b925 on nc-15b226cf-a5ba-4dbf-916a-bedf9a27d208 | proxy env: none | NLB ['10.50.10.10', '10.50.11.10']

=== Probes: what the fence allows (the NLB on 80, 443, 8080) ====
NLB 10.50.10.10                                  80 open, 443 open, 8080 open
NLB 10.50.11.10                                  80 open, 443 open, 8080 open

=== Probes: direct egress =======================================
direct HTTPS to httpbin.org's real IP (--resolve) 000 FAIL rc=28
direct HTTP to example.com's real IP (--resolve) 000 FAIL rc=28
direct raw IP 1.1.1.1:443                        000 FAIL rc=28
TCP github.com:22 (git over SSH)                 timeout
TCP example.com:25 (SMTP)                        timeout
DNS to 1.1.1.1:53 (UDP)                          ;; communications error to 1.1.1.1#53: timed out
DNS to 8.8.8.8:53 (TCP)                          ;; Connection to 8.8.8.8#53(8.8.8.8) for example.com failed: timed out.

=== Probes: the rest of the proxy VPC ===========================
NLB 10.50.10.10 on another port (9090)           000 FAIL rc=28
NAT gateway ENI 10.50.0.208:443                  timeout
iron-proxy task 10.50.11.136, bypassing the NLB  80 timeout, 443 timeout, 8080 timeout, 9090 timeout
proxy VPC resolver 10.50.0.2:53 (UDP)            ;; communications error to 10.50.0.2#53: timed out

=== Probes: IPv6 ================================================
global IPv6: inet6 2600:1f18:…/128
default IPv6 route: default via fe80::1 dev eth0 src <its global IPv6> metric 1024 pref medium
IPv6 HTTPS to [2606:4700:4700::1111]             000 FAIL rc=28
IPv6 HTTPS to sts.us-east-1.api.aws              000 FAIL rc=28

=== Probes: through the proxy ===================================
through the proxy, allowlisted host              200
egress IP seen by httpbin (via proxy)            {"origin":"<nat-eip>"}
through the proxy, not allowlisted               403
system resolver: public name                     10.50.11.10     proxy.sandbox.internal example.com
VPC resolver 10.51.0.2 directly                  proxy.sandbox.internal. 10.50.10.10 10.50.11.10
IMDS role (no execution role)                    Resource not found: /latest/meta-data/iam/security-credentials/.

32 passed, 0 failed
Saída completa do 02_fence.py
# 02_fence  2026-11-04 04:02:20 GMT  region us-east-1

=== The sandbox VPC: routes, gateways, the connector's security group
  route 10.50.10.10/32     -> pcx-05d1deac78c2809cd (active)
  route 10.50.11.10/32     -> pcx-05d1deac78c2809cd (active)
  route 10.51.0.0/16       -> local (active)
  internet gateways: 0, NAT gateways: 0
  connector SG egress  tcp 443-443 -> sg-08dcc03d049e8fe5b (NLB SG, across peering pcx-05d1deac78c2809cd)
  connector SG egress  tcp 8080-8080 -> sg-08dcc03d049e8fe5b (NLB SG, across peering pcx-05d1deac78c2809cd)
  connector SG egress  tcp 80-80 -> sg-08dcc03d049e8fe5b (NLB SG, across peering pcx-05d1deac78c2809cd)
  connector ENIs (Lambda-managed, listed only with IncludeManagedResources): 10.51.20.254 us-east-1a; 10.51.21.67 us-east-1b

MicroVM microvm-4bfac5ab-19d3-3028-8717-d854f2f7b925 on nc-15b226cf-a5ba-4dbf-916a-bedf9a27d208 | proxy env: none | NLB ['10.50.10.10', '10.50.11.10']

=== Probes: what the fence allows (the NLB on 80, 443, 8080) ====
NLB 10.50.10.10                                  80 open, 443 open, 8080 open
NLB 10.50.11.10                                  80 open, 443 open, 8080 open

=== Probes: direct egress =======================================
direct HTTPS to httpbin.org's real IP (--resolve) 000 FAIL rc=28
direct HTTP to example.com's real IP (--resolve) 000 FAIL rc=28
direct raw IP 1.1.1.1:443                        000 FAIL rc=28
TCP 1.1.1.1:22                                   timeout
TCP 140.82.112.3:443 (a GitHub address)          timeout
TCP github.com:22 (git over SSH)                 timeout
TCP example.com:25 (SMTP)                        timeout
DNS to 1.1.1.1:53 (UDP)                          ;; communications error to 1.1.1.1#53: timed out
DNS to 8.8.8.8:53 (TCP)                          ;; Connection to 8.8.8.8#53(8.8.8.8) for example.com failed: timed out.

=== Probes: the rest of the proxy VPC ===========================
NLB 10.50.10.10 on another port (9090)           000 FAIL rc=28
NLB 10.50.11.10:22                               timeout
NAT gateway ENI 10.50.0.208:443                  timeout
iron-proxy task 10.50.11.136, bypassing the NLB  80 timeout, 443 timeout, 8080 timeout, 9090 timeout
proxy VPC resolver 10.50.0.2:53 (UDP)            ;; communications error to 10.50.0.2#53: timed out

=== Probes: IPv6 ================================================
global IPv6: inet6 2600:1f18:…/128
default IPv6 route: default via fe80::1 dev eth0 src <its global IPv6> metric 1024 pref medium
IPv6 HTTPS to [2606:4700:4700::1111]             000 FAIL rc=28
IPv6 TCP [2001:4860:4860::8888]:443              timeout
IPv6 TCP [2001:4860:4860::8888]:53               timeout
IPv6 TCP [2606:4700:4700::1111]:80               timeout
IPv6 DNS (UDP) to 2001:4860:4860::8888           ;; communications error to 2001:4860:4860::8888#53: timed out
IPv6 HTTPS to sts.us-east-1.api.aws              000 FAIL rc=28
IPv6 HTTPS to s3.dualstack.us-east-1.amazonaws.com 000 FAIL rc=28

=== Probes: through the proxy ===================================
through the proxy, allowlisted host              200
egress IP seen by httpbin (via proxy)            {"origin":"<nat-eip>"}
through the proxy, not allowlisted               403
system resolver: public name                     10.50.11.10     proxy.sandbox.internal example.com
VPC resolver 10.51.0.2 directly                  proxy.sandbox.internal. 10.50.10.10 10.50.11.10
IMDS role (no execution role)                    Resource not found: /latest/meta-data/iam/security-credentials/.

(NAT gateway public IP: <nat-eip>)

=== iron-proxy audit log for this test ==========================
allow  200 GET     httpbin.org/get  from 10.50.11.10:33061
allow  200 GET     httpbin.org/ip  from 10.50.11.10:46969
reject 403 GET     example.com/  from 10.50.10.10:20789 allowlist

=== Checks ======================================================
PASS  sandbox routes: local + the two NLB /32s, nothing else  (10.50.10.10/32, 10.50.11.10/32, 10.51.0.0/16)
PASS  sandbox VPC: no internet gateway, no NAT gateway  (0 IGW, 0 NAT)
PASS  NLB 10.50.10.10 reachable on 80, 443 and 8080  ({80: 'open', 443: 'open', 8080: 'open'})
PASS  NLB 10.50.11.10 reachable on 80, 443 and 8080  ({80: 'open', 443: 'open', 8080: 'open'})
PASS  direct https to httpbin.org's real IP fails  (000 FAIL rc=28)
PASS  direct http to example.com's real IP fails  (000 FAIL rc=28)
PASS  direct raw IP 1.1.1.1:443 fails  (000 FAIL rc=28)
PASS  TCP 1.1.1.1:22: no connection  (timeout)
PASS  TCP 140.82.112.3:443 (a GitHub address): no connection  (timeout)
PASS  TCP github.com:22 (git over SSH): no connection  (timeout)
PASS  TCP example.com:25 (SMTP): no connection  (timeout)
PASS  UDP DNS to 1.1.1.1 fails  (;; communications error to 1.1.1.1#53: timed out)
PASS  TCP DNS to 8.8.8.8 fails  (;; Connection to 8.8.8.8#53(8.8.8.8) for example.com failed: timed out.)
PASS  NLB 9090 (health port) unreachable  (000 FAIL rc=28)
PASS  NLB 10.50.11.10:22: no connection  (timeout)
PASS  NAT gateway ENI 10.50.0.208:443: no connection  (timeout)
PASS  iron-proxy task 10.50.11.136 unreachable directly  ({80: 'timeout', 443: 'timeout', 8080: 'timeout', 9090: 'timeout'})
PASS  the proxy VPC's resolver is unreachable  (;; communications error to 10.50.0.2#53: timed out)
PASS  IPv6 HTTPS fails  (000 FAIL rc=28)
PASS  IPv6 TCP [2001:4860:4860::8888]:443: no connection  (timeout)
PASS  IPv6 TCP [2001:4860:4860::8888]:53: no connection  (timeout)
PASS  IPv6 TCP [2606:4700:4700::1111]:80: no connection  (timeout)
PASS  IPv6 UDP DNS fails  (;; communications error to 2001:4860:4860::8888#53: timed out)
PASS  IPv6 HTTPS to sts.us-east-1.api.aws fails  (000 FAIL rc=28)
PASS  IPv6 HTTPS to s3.dualstack.us-east-1.amazonaws.com fails  (000 FAIL rc=28)
PASS  allowlisted host through the proxy: 200  (200)
PASS  egress through the proxy VPC's NAT gateway  ({"origin":"<nat-eip>"})
PASS  off-allowlist host: 403 from the proxy  (403)
PASS  example.com resolves to the NLB  (10.50.11.10     proxy.sandbox.internal example.com
10.50.10.10     proxy.sandbox.internal example.com)
PASS  the sandbox VPC's resolver answers with the override  (proxy.sandbox.internal. 10.50.10.10 10.50.11.10)
PASS  no execution role at the metadata endpoint  (Resource not found: /latest/meta-data/iam/security-credentials/.)
PASS  the proxy saw the allowlisted request
32 passed, 0 failed

A cerca se mantém, e agora as rotas fazem parte dela. O NLB respondeu nas portas 80, 443 e 8080. Todo o resto deu timeout: os endereços reais do httpbin.org, do example.com e do GitHub, o 1.1.1.1, SSH e SMTP, DNS para resolvers públicos via UDP e TCP, a porta de health check do NLB, o NAT gateway, a própria task do iron-proxy (contornando o NLB), o resolver da VPC do proxy e todos os destinos IPv6. O tráfego permitido sai pelo endereço do NAT gateway, e o próprio resolver da MicroVM responde example.com com o NLB.

Repare em como as coisas falham: por timeout (o rc=28 do curl), nunca por recusa. Um cliente espera até esgotar o seu timeout de conexão. As linhas de IPv6 são a surpresa abordada em Onde o design para: um endereço global e uma rota padrão vindos do Lambda, e nenhum lugar para onde ir.

Teste 2: Como um request chega ao proxy, e como a injeção se comporta

O 03_injection.py primeiro mostra o caminho sem configurações de proxy: o curl pede api.github.com, conecta a um endereço do NLB e recebe um certificado emitido pela CA de demonstração. Depois ele usa um segredo fictício, “demo”, e o httpbin.org, que devolve os requests como eco, para que você veja exatamente o que chega ao upstream. A MicroVM envia demo-placeholder-token, e o valor do segredo é um substituto visível:

demo placeholder: demo-placeholder-token | demo real value (fake, safe to show): demo-REAL-value-c8efe7fb

=== How a request reaches iron-proxy (no proxy settings in the MicroVM)
proxy variables: none
* Connected to api.github.com (10.50.11.10) port 443 (#0)
< HTTP/2 200
certificate: commonName=api.github.com | issuer: organizationName=my2cents.ai, commonName=my2cents iron-proxy demo CA

=== Placeholder in the request, as httpbin receives it ==========
Authorization header                                 -> Bearer demo-REAL-value-c8efe7fb
custom header X-Token                                -> demo-REAL-value-c8efe7fb
query string                                         -> {'token': 'demo-REAL-value-c8efe7fb'}
JSON body                                            -> {'token': 'demo-REAL-value-c8efe7fb'}
plain HTTP (no TLS between proxy and httpbin)        -> demo-REAL-value-c8efe7fb
placeholder split across two headers                 -> ('demo-pla', 'ceholder-token')
base64 of the placeholder                            -> ZGVtby1wbGFjZWhvbGRlci10b2tlbg==

=== Placeholders sent to the wrong host =========================
GitHub placeholder to httpbin                        -> token ghp_proxyplaceholder000000000000000000000
Anthropic placeholder to httpbin                     -> sk-ant-api03-proxy-placeholder-0000000000000000000000000000000000000000000000000000000000000000-AAAAAAAA
demo placeholder to api.github.com                   -> 401

=== Allowlist ===================================================
https://example.com                                  -> 403
https://api.openai.com/v1/models                     -> 403
https://pypi.org/simple/                             -> 403
https://<random>.example.com (doesn't exist)         -> 403
response body of a denial: ''
curl's exit code for a denial: 0
TLS for a denied host: certificate: commonName=example.com | issuer: organizationName=my2cents.ai, commonName=my2cents iron-proxy demo CA

A troca acontece onde quer que a regra mande procurar (este segredo está configurado para varrer headers, query string e corpo) e só para os hosts aos quais ele está vinculado: os placeholders do GitHub e da Anthropic chegam ao httpbin inalterados, e o placeholder de demonstração não significa nada para o GitHub. Um placeholder dividido ou codificado em base64 não é reconhecido. A troca também acontece em HTTP puro, que agora chega na porta 80, então um segredo real pode sair do proxy sem criptografia se um cliente pedir uma URL http:// (uma issue em aberto).

Um host negado ainda completa o TLS com um certificado da CA de demonstração para o seu nome, mesmo que ele não exista, e depois o request recebe um HTTP 403 com corpo vazio. O curl sai com 0, então os scripts precisam verificar códigos de status, não códigos de saída.

O log de auditoria registra cada troca com o segredo e onde ele foi encontrado, e todo request chega como mode=mitm, sem CONNECT:

=== iron-proxy audit log ========================================
allow  200 GET     api.github.com/zen  from 10.50.11.10:22806  secrets:{"swapped":[{"secret":"<secret-arn:github>","locations
allow  200 GET     httpbin.org/anything  from 10.50.11.10:56274  secrets:{"swapped":[{"secret":"<secret-arn:demo>","locations":
allow  401 GET     api.github.com/user  from 10.50.11.10:25853
reject 403 GET     example.com/  from 10.50.10.10:18312 allowlist
reject 403 GET     api.openai.com/v1/models  from 10.50.11.10:27688 allowlist

22 passed, 0 failed
Saída completa do 03_injection.py
# 03_injection  2026-11-04 04:08:33 GMT  region us-east-1
demo placeholder: demo-placeholder-token | demo real value (fake, safe to show): demo-REAL-value-c8efe7fb

=== How a request reaches iron-proxy (no proxy settings in the MicroVM)
proxy variables: none
* Connected to api.github.com (10.50.11.10) port 443 (#0)
< HTTP/2 200
certificate: commonName=api.github.com | issuer: organizationName=my2cents.ai, commonName=my2cents iron-proxy demo CA

=== Placeholder in the request, as httpbin receives it ==========
Authorization header                                 -> Bearer demo-REAL-value-c8efe7fb
custom header X-Token                                -> demo-REAL-value-c8efe7fb
query string                                         -> {'token': 'demo-REAL-value-c8efe7fb'}
JSON body                                            -> {'token': 'demo-REAL-value-c8efe7fb'}
plain HTTP (no TLS between proxy and httpbin)        -> demo-REAL-value-c8efe7fb
placeholder split across two headers                 -> ('demo-pla', 'ceholder-token')
base64 of the placeholder                            -> ZGVtby1wbGFjZWhvbGRlci10b2tlbg==

=== Placeholders sent to the wrong host =========================
GitHub placeholder to httpbin                        -> token ghp_proxyplaceholder000000000000000000000
Anthropic placeholder to httpbin                     -> sk-ant-api03-proxy-placeholder-0000000000000000000000000000000000000000000000000000000000000000-AAAAAAAA
demo placeholder to api.github.com                   -> 401

=== Allowlist ===================================================
https://example.com                                  -> 403
https://api.openai.com/v1/models                     -> 403
https://pypi.org/simple/                             -> 403
https://<random>.example.com (doesn't exist)         -> 403
response body of a denial: ''
curl's exit code for a denial: 0
TLS for a denied host: certificate: commonName=example.com | issuer: organizationName=my2cents.ai, commonName=my2cents iron-proxy demo CA

=== iron-proxy audit log ========================================
allow  200 GET     api.github.com/zen  from 10.50.11.10:22806  secrets:{"swapped":[{"secret":"<secret-arn:github>","locations
allow  200 GET     httpbin.org/anything  from 10.50.11.10:56274  secrets:{"swapped":[{"secret":"<secret-arn:demo>","locations":
allow  200 GET     httpbin.org/anything  from 10.50.11.10:8616  secrets:{"swapped":[{"secret":"<secret-arn:demo>","locations":
allow  200 GET     httpbin.org/anything  from 10.50.11.10:47661  secrets:{"swapped":[{"secret":"<secret-arn:demo>","locations":
allow  200 POST    httpbin.org/anything  from 10.50.11.10:41806  secrets:{"swapped":[{"secret":"<secret-arn:demo>","locations":
allow  200 GET     httpbin.org/anything  from 10.50.11.10:23400  secrets:{"swapped":[{"secret":"<secret-arn:demo>","locations":
allow  200 GET     httpbin.org/anything  from 10.50.11.10:16122
allow  200 GET     httpbin.org/anything  from 10.50.11.10:11018
allow  200 GET     httpbin.org/anything  from 10.50.11.10:49196
allow  200 GET     httpbin.org/anything  from 10.50.11.10:6734
allow  401 GET     api.github.com/user  from 10.50.11.10:25853
reject 403 GET     example.com/  from 10.50.10.10:18312 allowlist
reject 403 GET     api.openai.com/v1/models  from 10.50.11.10:27688 allowlist
reject 403 GET     pypi.org/simple/  from 10.50.10.10:21490 allowlist
reject 403 GET     rf8m1pkz5.example.com/  from 10.50.11.10:1668 allowlist
reject 403 GET     example.com/  from 10.50.11.10:19772 allowlist
reject 403 GET     example.com/  from 10.50.11.10:41740 allowlist

=== Checks ======================================================
PASS  no proxy variables in the MicroVM  (proxy variables: none)
PASS  api.github.com: connected to an NLB IP  (* Connected to api.github.com (10.50.11.10) port 443 (#0))
PASS  api.github.com: 200 through iron-proxy
PASS  api.github.com: certificate issued by the demo CA (TLS intercepted)
PASS  header: swapped  (Bearer demo-REAL-value-c8efe7fb)
PASS  custom header: swapped (match_headers: [] means every header)  (demo-REAL-value-c8efe7fb)
PASS  query string: swapped  ({'token': 'demo-REAL-value-c8efe7fb'})
PASS  body: swapped  ({'token': 'demo-REAL-value-c8efe7fb'})
PASS  plain HTTP (port 80): intercepted and swapped  (demo-REAL-value-c8efe7fb)
PASS  split placeholder: not swapped  (('demo-pla', 'ceholder-token'))
PASS  base64 placeholder: not swapped  (ZGVtby1wbGFjZWhvbGRlci10b2tlbg==)
PASS  GitHub placeholder reaches httpbin unchanged  (token ghp_proxyplaceholder000000000000000000000)
PASS  Anthropic placeholder reaches httpbin unchanged  (sk-ant-api03-proxy-placeholder-000000000)
PASS  demo placeholder means nothing to GitHub (401)  (401)
PASS  https://example.com: 403 from the proxy  (403)
PASS  https://api.openai.com/v1/models: 403 from the proxy  (403)
PASS  https://pypi.org/simple/: 403 from the proxy  (403)
PASS  https://<random>.example.com (doesn't exist): 403 from the proxy  (403)
PASS  a denied host still gets a demo-CA certificate (refused after TLS, not at it)  (certificate: commonName=example.com | issuer: organizationName=my2cents.ai, commonName=my2cents iron-proxy demo CA)
PASS  audit: a swap logged with the demo secret
PASS  audit: example.com rejected by the allowlist
PASS  audit: every request intercepted directly (mode=mitm), no CONNECT  ({'mitm'})
22 passed, 0 failed

Teste 3: Claude Code com uma chave placeholder

O 04_claude_code.py roda o Claude Code em modo headless: uma resposta de uma linha, uma execução com uso de ferramentas que escreve e roda um arquivo, uma execução com streaming e uma execução sem chave nenhuma:

=== What the MicroVM has ========================================
2.1.317 (Claude Code)
ANTHROPIC_API_KEY=sk-ant-api03-proxy-pla
HTTPS_PROXY=unset
10.50.10.10     proxy.sandbox.internal api.anthropic.com

=== claude -p, transparently through the proxy ==================
is_error=False result='the proxy holds the key' turns=1 cost=$0.0278 wall=17.5s model=['claude-opus-5-5']

=== A tool-using run (writes and reads a file) ==================
is_error=False result='5050' turns=2 cost=$0.0347

=== Streaming output (stream-json lines arrive through the MITM)
token deltas streamed through the proxy: 10

=== Without the placeholder =====================================
Not logged in · Please run /login

=== iron-proxy audit (api.anthropic.com), summarized ============
  16  GET   api.anthropic.com/mcp-registry/v0/servers                      no key
   7  POST  api.anthropic.com/api/event_logging/v2/batch                   key swapped
   4  HEAD  api.anthropic.com/api/hello                                    no key
   4  POST  api.anthropic.com/v1/messages                                  key swapped
   3  GET   api.anthropic.com/api/claude_code/settings                     key swapped
   3  GET   api.anthropic.com/api/claude_code/policy_limits                key swapped
   3  POST  api.anthropic.com/api/eval/<id>                                key swapped
   3  GET   api.anthropic.com/api/claude_code_penguin_mode                 key swapped
   3  GET   api.anthropic.com/api/claude_cli/bootstrap                     key swapped
   3  POST  api.anthropic.com/api/claude_code/metrics                      key swapped
   1  GET   api.anthropic.com/api/claude_code/organizations/metrics_enabled key swapped
   1  POST  api.anthropic.com/api/event_logging/v2/batch                   no key

5 passed, 0 failed

O Claude Code funciona sem modificações e sem nada para configurar: api.anthropic.com resolve para o NLB, ele confia na CA via NODE_EXTRA_CA_CERTS e envia o placeholder como x-api-key. O streaming funciona através da interceptação: a execução com stream-json teve 10 deltas de token. Sem a variável do placeholder, ele se recusa a iniciar (Not logged in · Please run /login), então o sandbox precisa de algo na variável, mesmo que não seja um segredo. Todo request que levava a chave seguiu para o upstream com a chave real no lugar, e o log de auditoria mostra cada troca; alguns, como as consultas ao registry de MCP e uma verificação HEAD /api/hello, nem enviam chave.

Teste 4: git e gh sem token

05_github.py. O gh envia o placeholder como Authorization: token …; o credential helper do git o envia como HTTP Basic, que o iron-proxy decodifica antes de procurar o placeholder:

=== What the MicroVM has ========================================
GH_TOKEN=ghp_proxyplaceholder000000000000000000000
HTTPS_PROXY=unset
!f() { echo username=x-access-token; echo "password=$GH_TOKEN"; }; f
gh version 2.103.3 (2026-10-26)

=== gh api user (token header on api.github.com) ================
fabiodouek

=== git clone fabiodouek/my2centsai-sandbox-test (Basic auth on github.com)
8373223 Initial commit

=== git push to iron-proxy-demo-git-1793765451 ==================
remote:      https://github.com/fabiodouek/my2centsai-sandbox-test/pull/new/iron-proxy-demo-git-1793765451
remote:
2285dfd9e5fe

=== What the token can't do (GitHub's scoping, not the proxy's) =
other repo: {"message":"Resource not accessible by personal access token","documentation_url":"https://docs.github.com/rest/collaborators/collaborators#list-repository-collaborators","status":"403"}gh: Resource not accessible by personal access token (HTTP 403)
create a gist: X Failed to create gist: HTTP 403: Resource not accessible by personal access token (https://api.github.com/gists)

=== iron-proxy audit (github) ===================================
allow  200 GET     api.github.com/user  from 10.50.11.10:15317  secrets:{"swapped":[{"secret":"<secret-arn:github>","locations
allow  401 GET     github.com/fabiodouek/my2centsai-sandbox-test.git/info/refs  from 10.50.10.10:58900
allow  200 GET     github.com/fabiodouek/my2centsai-sandbox-test.git/info/refs  from 10.50.10.10:58900  secrets:{"swapped":[{"secret":"<secret-arn:github>","locations
allow  403 GET     api.github.com/repos/torvalds/linux/collaborators  from 10.50.10.10:27274  secrets:{"swapped":[{"secret":"<secret-arn:github>","locations
allow  403 POST    api.github.com/gists  from 10.50.10.10:53543  secrets:{"swapped":[{"secret":"<secret-arn:github>","locations

6 passed, 0 failed
Saída completa do 05_github.py
# 05_github  2026-11-04 04:10:49 GMT  region us-east-1

=== What the MicroVM has ========================================
GH_TOKEN=ghp_proxyplaceholder000000000000000000000
HTTPS_PROXY=unset
!f() { echo username=x-access-token; echo "password=$GH_TOKEN"; }; f
gh version 2.103.3 (2026-10-26)

=== gh api user (token header on api.github.com) ================
fabiodouek

=== git clone fabiodouek/my2centsai-sandbox-test (Basic auth on github.com)
8373223 Initial commit

=== git push to iron-proxy-demo-git-1793765451 ==================
remote:      https://github.com/fabiodouek/my2centsai-sandbox-test/pull/new/iron-proxy-demo-git-1793765451
remote:
2285dfd9e5fe

=== What the token can't do (GitHub's scoping, not the proxy's) =
other repo: {"message":"Resource not accessible by personal access token","documentation_url":"https://docs.github.com/rest/collaborators/collaborators#list-repository-collaborators","status":"403"}gh: Resource not accessible by personal access token (HTTP 403)
create a gist: X Failed to create gist: HTTP 403: Resource not accessible by personal access token (https://api.github.com/gists)

=== Clean up the branch =========================================
deleted

=== iron-proxy audit (github) ===================================
allow  200 GET     api.github.com/user  from 10.50.11.10:15317  secrets:{"swapped":[{"secret":"<secret-arn:github>","locations
allow  401 GET     github.com/fabiodouek/my2centsai-sandbox-test.git/info/refs  from 10.50.10.10:58900
allow  200 GET     github.com/fabiodouek/my2centsai-sandbox-test.git/info/refs  from 10.50.10.10:58900  secrets:{"swapped":[{"secret":"<secret-arn:github>","locations
allow  200 POST    github.com/fabiodouek/my2centsai-sandbox-test.git/git-upload-pack  from 10.50.10.10:58900  secrets:{"swapped":[{"secret":"<secret-arn:github>","locations
allow  200 POST    github.com/fabiodouek/my2centsai-sandbox-test.git/git-upload-pack  from 10.50.10.10:58900  secrets:{"swapped":[{"secret":"<secret-arn:github>","locations
allow  401 GET     github.com/fabiodouek/my2centsai-sandbox-test.git/info/refs  from 10.50.11.10:12263
allow  200 GET     github.com/fabiodouek/my2centsai-sandbox-test.git/info/refs  from 10.50.11.10:12263  secrets:{"swapped":[{"secret":"<secret-arn:github>","locations
allow  200 POST    github.com/fabiodouek/my2centsai-sandbox-test.git/git-receive-pack  from 10.50.11.10:12263  secrets:{"swapped":[{"secret":"<secret-arn:github>","locations
allow  401 GET     github.com/fabiodouek/my2centsai-sandbox-test.git/info/refs  from 10.50.11.10:17367
allow  200 GET     github.com/fabiodouek/my2centsai-sandbox-test.git/info/refs  from 10.50.11.10:17367  secrets:{"swapped":[{"secret":"<secret-arn:github>","locations
allow  200 POST    github.com/fabiodouek/my2centsai-sandbox-test.git/git-upload-pack  from 10.50.11.10:17367  secrets:{"swapped":[{"secret":"<secret-arn:github>","locations
allow  403 GET     api.github.com/repos/torvalds/linux/collaborators  from 10.50.10.10:27274  secrets:{"swapped":[{"secret":"<secret-arn:github>","locations
allow  403 POST    api.github.com/gists  from 10.50.10.10:53543  secrets:{"swapped":[{"secret":"<secret-arn:github>","locations
allow  401 GET     github.com/fabiodouek/my2centsai-sandbox-test.git/info/refs  from 10.50.11.10:64233
allow  200 GET     github.com/fabiodouek/my2centsai-sandbox-test.git/info/refs  from 10.50.11.10:64233  secrets:{"swapped":[{"secret":"<secret-arn:github>","locations
allow  200 POST    github.com/fabiodouek/my2centsai-sandbox-test.git/git-receive-pack  from 10.50.11.10:64233  secrets:{"swapped":[{"secret":"<secret-arn:github>","locations

=== Checks ======================================================
PASS  gh api user returns the token's login  (fabiodouek)
PASS  git clone works  (8373223 Initial commit)
PASS  git push works (the branch exists upstream)  (remote:      https://github.com/fabiodouek/my2centsai-sandbox-test/pull/new/iron-proxy-demo-git-1793765451
remote:
2285dfd9e5fe)
PASS  another repo refused by GitHub  ({"message":"Resource not accessible by personal access token","documentation_url":"https://docs.github.com/rest/collaborators/collaborators#list-repository-coll)
PASS  gist refused by GitHub  (X Failed to create gist: HTTP 403: Resource not accessible by personal access token (https://api.github.com/gists))
PASS  token swapped on api.github.com and github.com
6 passed, 0 failed

Aqui, quem restringe o que o token pode fazer não é o proxy, e sim o escopo do token no GitHub. Com um fine-grained token limitado a um repositório, o agente não consegue mexer em mais nada, mesmo que o proxy, com regras por host, encaminhasse o request sem problema: os dois 403 aparecem como allow no log do proxy, porque o proxy os encaminhou e o GitHub recusou. O Teste 10 leva esse limite para dentro do proxy. O log também mostra o padrão habitual do git, que importa lá: cada primeiro request sai sem credenciais e recebe um 401, e então o git o repete com o placeholder, que é trocado.

Teste 5: Claude Code abre um pull request

O 06_agent_pr.py pede ao Claude Code para clonar o repositório, adicionar um arquivo, fazer push de uma branch e abrir um PR; depois fecha o PR e apaga a branch, para que o repositório de teste não fique lotado:

=== Claude Code: clone, commit, push, open PR ===================
is_error=False turns=2 cost=$0.0441 wall=26s
result: I cloned the repo and created branch `iron-proxy-demo-agent-1793765499`. On it I committed `docs/lambda-microvm-iron-proxy.md`, which has two sentences on the credential-injecting egress proxy. Then I pushed the branch and opened the PR with `gh pr create --fill`. Because of `--fill`, the PR title and description come from the commit message.

https://github.com/fabiodouek/my2centsai-sandbox-test/pull/16

=== Requests the proxy saw, by host =============================
  17  allow  api.anthropic.com
   3  allow  api.github.com
   7  allow  github.com
   2  reject http-intake.logs.us5.datadoghq.com

=== Close the pull request and delete its branch ================
✓ Closed pull request fabiodouek/my2centsai-sandbox-test#16 (Add doc on credential-injecting egress proxy for Lambda MicroVMs)
✓ Deleted branch iron-proxy-demo-agent-1793765499 and switched to branch main
CLOSED

3 passed, 0 failed

Concluído em 26 s e dois turnos (US$ 0,0441), sem nada secreto na MicroVM e sem nada configurado; em seguida, o script fechou o pull request #16 e apagou a branch dele. O log do proxy é um inventário razoável daquilo com que um agente realmente conversa, inclusive do que ele não tem permissão para acessar: duas rejeições para a telemetria do próprio Claude Code indo para o Datadog, que não está na allowlist.

Teste 6: AWS sem credenciais da AWS

07_aws.py. Os endpoints da AWS resolvem para o NLB, como qualquer outro nome. A MicroVM tem AWS_ACCESS_KEY_ID=AKIAPLACEHOLDER00000 e um segredo placeholder; a CLI assina com eles, e o aws_auth descarta essa assinatura e reassina com a role da task:

=== What the MicroVM has ========================================
AWS_ACCESS_KEY_ID=AKIAPLACEHOLDER00000
AWS_EC2_METADATA_DISABLED=true
AWS_SECRET_ACCESS_KEY=placeholder-secret-not-real
HTTPS_PROXY=unset
10.50.11.10     proxy.sandbox.internal sts.us-east-1.amazonaws.com

=== sts get-caller-identity =====================================
Arn: arn:aws:sts::<acct>:assumed-role/my2cents-ip-task/0de98f37d3154cee8b3a42262454a78a

=== s3 ls (every bucket the task role can see, names anonymized)
16 buckets: ['bucket-a98b', 'bucket-2c8f', 'bucket-a58e', 'bucket-fd51', 'bucket-e526', 'bucket-ee05', 'bucket-2749', 'bucket-8a84', 'bucket-cb6b', 'bucket-547e', 'bucket-9ed7', 'bucket-d640'] ...

=== Objects in the demo bucket ==================================
demo object reports/q3-summary.txt
key with a space (iron-proxy issue #220): download failed: s3://<demo-bucket>/reports/q3 summary.txt to - An error occurred (403) when calling the HeadObject operation: Forbidden

=== ecs list-clusters (anonymized) ==============================
['cluster-4cae']

=== Outside the policy ==========================================
iam list-users (service not in allowed_services): e (not well-formed (invalid token): line 1, column 0), invalid XML received. Further retries may succeed: b'{"error":"aws_auth","reason":"service_not_allowed"}'
ec2 in us-west-2 (region not allowed): se (not well-formed (invalid token): line 1, column 0), invalid XML received. Further retries may succeed: b'{"error":"aws_auth","reason":"region_not_allowed"}'
s3 put-object (the task role has no write): upload failed: - to s3://<demo-bucket>/written-from-sandbox.txt An error occurred (400) when calling the PutObject operation: Bad Request

=== What aws_auth checks (and doesn't) ==========================
random fake keys, still re-signed: arn:aws:sts::<acct>:assumed-role/my2cents-ip-task/0de98f37d3154cee8b3a42262454a78a
no keys at all: aws: [ERROR]: An error occurred (NoCredentials): Unable to locate credentials. You can configure credentials by running "aws login".
unsigned curl to STS: {"error":"aws_auth","reason":"missing_sigv4"}
presigned URL (signed with the placeholder): 400
boto3 (python3-boto3 from Debian): 1.26.27 assumed-role/my2cents-ip-task/0de98f37d3154cee8b3a42262454a78a

=== iron-proxy audit (amazonaws) ================================
reject 403 POST    iam.amazonaws.com/  from 10.50.10.10:30075 aws_auth aws_auth:{"rejected":"service_not_allowed","service":"iam"}
reject 403 POST    ec2.us-west-2.amazonaws.com/  from 10.50.10.10:56773 aws_auth aws_auth:{"region":"us-west-2","rejected":"region_not_allowed"}
reject 400 PUT     <demo-bucket>.s3.us-east-1.amazonaws.com/written-from-sandbox.txt  from 10.50.11.10:31623 aws_auth aws_auth:{"rejected":"chunked_body_not_allowed"}
reject 400 GET     sts.amazonaws.com/  from 10.50.10.10:30699 aws_auth aws_auth:{"error":"request has no SigV4 signature (no Authorization header or X-Amz-Credential query param)","rejected":"missing_sigv4"}

10 passed, 0 failed
Saída completa do 07_aws.py
# 07_aws  2026-11-04 04:12:47 GMT  region us-east-1

=== What the MicroVM has ========================================
AWS_ACCESS_KEY_ID=AKIAPLACEHOLDER00000
AWS_CA_BUNDLE=/etc/ssl/certs/ca-certificates.crt
AWS_DEFAULT_REGION=us-east-1
AWS_EC2_METADATA_DISABLED=true
AWS_LAMBDA_MICROVM_IMAGE_ARN=arn:aws:lambda:us-east-1:<acct>:microvm-image:my2cents-ip-sandbox
AWS_LAMBDA_MICROVM_IMAGE_NAME=my2cents-ip-sandbox
AWS_LAMBDA_MICROVM_IMAGE_VERSION=1.0
AWS_REGION=us-east-1
AWS_SECRET_ACCESS_KEY=placeholder-secret-not-real
HTTPS_PROXY=unset
10.50.11.10     proxy.sandbox.internal sts.us-east-1.amazonaws.com

=== sts get-caller-identity =====================================
Arn: arn:aws:sts::<acct>:assumed-role/my2cents-ip-task/0de98f37d3154cee8b3a42262454a78a

=== s3 ls (every bucket the task role can see, names anonymized)
16 buckets: ['bucket-a98b', 'bucket-2c8f', 'bucket-a58e', 'bucket-fd51', 'bucket-e526', 'bucket-ee05', 'bucket-2749', 'bucket-8a84', 'bucket-cb6b', 'bucket-547e', 'bucket-9ed7', 'bucket-d640'] ...

=== Objects in the demo bucket ==================================
2026-11-04 03:40:58         29 notes/readme.txt
2026-11-04 03:40:59         35 reports/q3 summary.txt
2026-11-04 03:40:59         35 reports/q3-summary.txt
2026-11-04 03:40:59         32 reports/q4-plan.txt
demo object reports/q3-summary.txt
key with a space (iron-proxy issue #220): download failed: s3://<demo-bucket>/reports/q3 summary.txt to - An error occurred (403) when calling the HeadObject operation: Forbidden

=== ecs list-clusters (anonymized) ==============================
['cluster-4cae']

=== Outside the policy ==========================================
iam list-users (service not in allowed_services): e (not well-formed (invalid token): line 1, column 0), invalid XML received. Further retries may succeed: b'{"error":"aws_auth","reason":"service_not_allowed"}'
ec2 in us-west-2 (region not allowed): se (not well-formed (invalid token): line 1, column 0), invalid XML received. Further retries may succeed: b'{"error":"aws_auth","reason":"region_not_allowed"}'
s3 put-object (the task role has no write): upload failed: - to s3://<demo-bucket>/written-from-sandbox.txt An error occurred (400) when calling the PutObject operation: Bad Request

=== What aws_auth checks (and doesn't) ==========================
random fake keys, still re-signed: arn:aws:sts::<acct>:assumed-role/my2cents-ip-task/0de98f37d3154cee8b3a42262454a78a
no keys at all: aws: [ERROR]: An error occurred (NoCredentials): Unable to locate credentials. You can configure credentials by running "aws login".
unsigned curl to STS: {"error":"aws_auth","reason":"missing_sigv4"}
presigned URL (signed with the placeholder): 400
boto3 (python3-boto3 from Debian): 1.26.27 assumed-role/my2cents-ip-task/0de98f37d3154cee8b3a42262454a78a

=== iron-proxy audit (amazonaws) ================================
allow  200 POST    sts.us-east-1.amazonaws.com/  from 10.50.11.10:58178  aws_auth:{"injected":["header:Authorization","header:X-Amz-Date","header:X-Amz-Content-Sha256","header:X-Amz-Security-Token"],"region":"us-east-1","s
allow  200 GET     s3.us-east-1.amazonaws.com/  from 10.50.10.10:16169  aws_auth:{"injected":["header:Authorization","header:X-Amz-Date","header:X-Amz-Content-Sha256","header:X-Amz-Security-Token"],"region":"us-east-1","s
allow  200 GET     <demo-bucket>.s3.us-east-1.amazonaws.com/  from 10.50.11.10:61287  aws_auth:{"injected":["header:Authorization","header:X-Amz-Date","header:X-Amz-Content-Sha256","header:X-Amz-Security-Token"],"region":"us-east-1","s
allow  200 HEAD    <demo-bucket>.s3.us-east-1.amazonaws.com/reports/q3-summary.txt  from 10.50.10.10:20837  aws_auth:{"injected":["header:Authorization","header:X-Amz-Date","header:X-Amz-Content-Sha256","header:X-Amz-Security-Token"],"region":"us-east-1","s
allow  206 GET     <demo-bucket>.s3.us-east-1.amazonaws.com/reports/q3-summary.txt  from 10.50.10.10:20837  aws_auth:{"injected":["header:Authorization","header:X-Amz-Date","header:X-Amz-Content-Sha256","header:X-Amz-Security-Token"],"region":"us-east-1","s
allow  403 HEAD    <demo-bucket>.s3.us-east-1.amazonaws.com/reports/q3 summary.txt  from 10.50.10.10:17431  aws_auth:{"injected":["header:Authorization","header:X-Amz-Date","header:X-Amz-Content-Sha256","header:X-Amz-Security-Token"],"region":"us-east-1","s
allow  200 POST    ecs.us-east-1.amazonaws.com/  from 10.50.10.10:47267  aws_auth:{"injected":["header:Authorization","header:X-Amz-Date","header:X-Amz-Content-Sha256","header:X-Amz-Security-Token"],"region":"us-east-1","s
reject 403 POST    iam.amazonaws.com/  from 10.50.10.10:30075 aws_auth aws_auth:{"rejected":"service_not_allowed","service":"iam"}
reject 403 POST    ec2.us-west-2.amazonaws.com/  from 10.50.10.10:56773 aws_auth aws_auth:{"region":"us-west-2","rejected":"region_not_allowed"}
reject 400 PUT     <demo-bucket>.s3.us-east-1.amazonaws.com/written-from-sandbox.txt  from 10.50.11.10:31623 aws_auth aws_auth:{"rejected":"chunked_body_not_allowed"}
allow  200 POST    sts.us-east-1.amazonaws.com/  from 10.50.11.10:5388  aws_auth:{"injected":["header:Authorization","header:X-Amz-Date","header:X-Amz-Content-Sha256","header:X-Amz-Security-Token"],"region":"us-east-1","s
reject 400 GET     sts.amazonaws.com/  from 10.50.10.10:30699 aws_auth aws_auth:{"error":"request has no SigV4 signature (no Authorization header or X-Amz-Credential query param)","rejected":"missing_sigv4"}
allow  400 GET     <demo-bucket>.s3.us-east-1.amazonaws.com/notes/readme.txt  from 10.50.10.10:38430  aws_auth:{"injected":["header:Authorization","header:X-Amz-Date","header:X-Amz-Content-Sha256","header:X-Amz-Security-Token"],"region":"us-east-1","s
allow  200 POST    sts.amazonaws.com/  from 10.50.11.10:7123  aws_auth:{"injected":["header:Authorization","header:X-Amz-Date","header:X-Amz-Content-Sha256","header:X-Amz-Security-Token"],"region":"us-east-1","s

=== Checks ======================================================
PASS  re-signed as the proxy's task role  (arn:aws:sts::<acct>:assumed-role/my2cents-ip-task/0de98f37d3154cee8b3a42262454a78a)
PASS  s3 list-buckets works  (16 buckets)
PASS  s3 ls of the demo bucket lists the 4 objects  (/q3 summary.txt
2026-11-04 03:40:59         35 reports/q3-summary.txt
2026-11-04 03:40:59         32 reports/q4-plan.txt)
PASS  s3 cp of an object works  (demo object reports/q3-summary.txt)
PASS  ecs list-clusters works  (1 clusters)
PASS  iam refused by aws_auth  ( 1, column 0), invalid XML received. Further retries may succeed: b'{"error":"aws_auth","reason":"service_not_allowed"}')
PASS  us-west-2 refused by aws_auth  (e 1, column 0), invalid XML received. Further retries may succeed: b'{"error":"aws_auth","reason":"region_not_allowed"}')
PASS  upload refused  (upload failed: - to s3://<demo-bucket>/written-from-sandbox.txt An error occurred (400) when calling the PutObject operation: Bad Request)
PASS  any keys are re-signed (possession isn't checked)  (arn:aws:sts::<acct>:assumed-role/my2cents-ip-task/0de98f37d3154cee8b3a42262454a78a)
PASS  iam rejected by aws_auth in the audit log
10 passed, 0 failed

As leituras funcionam com a CLI e com o boto3 do Debian, o nome da sessão é o ID da task do ECS, e allowed_services e allowed_regions barram as chamadas antes que cheguem à AWS. A CLI reporta mal essas recusas: o iron-proxy responde com um 403 em JSON, e a CLI reclama de XML inválido. Vale a pena conhecer as falhas:

  • Chaves de objeto que precisam de URL encoding falham, por causa de um bug do iron-proxy. A chave com espaço recebe um 403 no HeadObject que a CLI envia primeiro: uma divergência de assinatura. Na versão 0.55.0, o aws_auth reassina paths do S3 com o escape de URI padrão do assinador, que o S3 não usa, então uma chave com espaço, uma barra codificada (%2F) ou outro caractere que precise de escape gera uma assinatura diferente da que o S3 calcula. É a issue #220 do iron-proxy, que foi fechada sem uma correção mergeada; o pull request #256, que corrige o problema, continua aberto. Não é um limite da AWS nem do Lambda.
  • Os uploads são rejeitados pelo proxy, não pelo IAM. O upload da CLI é recusado pelo aws_auth (chunked_body_not_allowed) antes que o IAM pudesse recusá-lo; a role da task não tem permissão de escrita de qualquer forma, mas não interprete esse 400 como uma decisão do IAM. Uploads com streaming precisam de unsigned_payload ou allow_chunked_body.
  • A posse não é verificada. Qualquer request assinado para um host permitido é reassinado, sejam quais forem as chaves que o cliente usou. As chaves placeholder são uma formalidade; o controle é a policy do proxy. Sem chave nenhuma, porém, a CLI nem chega a enviar o request.

Teste 7: Tentando extrair as credenciais

O 08_leaks.py roda as tentativas de sempre: o que há na VM, reflexão através de uma API permitida, rotas que contornam o proxy, SSRF através dele, DNS como canal lateral, e um pedido para o Claude Code imprimir as credenciais:

=== 1. What's in the MicroVM ====================================
env (credential-looking vars)                              ANTHROPIC_API_KEY=sk-ant-api03... GH_TOKEN=ghp_proxypla... DEMO_TOKEN=demo-placeho... AWS_SECRET_ACCESS_KEY=placeholder-... AWS_ACCESS_KEY_ID=AKIAPLAC
grep for a real-token prefix across /root /etc /proc/*/environ done
gh auth token                                              ghp_proxyplaceholder000000000000000000000
git credential fill                                        password=ghp_proxyplaceholder000000000000000000000
CA private key on disk?                                    ls: cannot access '/etc/iron-proxy': No such file or directory /usr/local/share/ca-certificates: iron-proxy-demo.crt

=== 2. Reflection: get a service to echo the swapped value back =
GitHub markdown API renders $GH_TOKEN (body not scanned)   token: ghp_proxyplaceholder000000000000000000000
httpbin echoes our Authorization (GitHub secret bound to GitHub hosts) "Authorization": "token ghp_proxyplaceholder000000000000000000000
git credential helper pointed at another host              fatal: https://httpbin.org/anything/x.git/info/refs not valid: is this a git repository?

=== 3. Around the proxy =========================================
proxy variables to unset                                   0
direct connection to api.github.com's real IP (--resolve)  FAIL rc=28
python urllib to the real IP                               urllib.error.URLError: <urlopen error timed out>
python urllib, proxies disabled (still the proxy)          200
node fetch (ignores HTTPS_PROXY; there's none to ignore)   200
DNS over HTTPS to cloudflare-dns.com                       403
DNS over HTTPS to 1.1.1.1 (raw IP)                         000 FAIL rc=28

=== 4. SSRF through the proxy ===================================
ECS task credentials endpoint 169.254.170.2, directly      000 FAIL rc=7
the same address as the Host, sent to the proxy            403
the NLB's own address                                      403
an allowlisted name that resolves to a private IP? (DNS rebinding) 403

=== 5. DNS as a side channel (the security group doesn't see it)
encode data into a lookup: the answer                      NOERROR CNAME proxy.sandbox.internal., A 10.50.11.10, A 10.50.10.10
TXT records come back in (inbound channel)?                NOERROR CNAME proxy.sandbox.internal.

=== 6. Ask Claude Code for the credentials ======================
I can't help with this one.

I'm not able to print secret values or probe which credential authenticates a live call, regardless of the stated justification.

Um rótulo exagera o que o teste faz: 10.50.0.2.nip.io não está na allowlist, então foi a allowlist que o recusou, e a linha não testa nem DNS rebinding nem a deny list do proxy.

Nada na VM é real, e a reflexão através de uma API permitida devolve o placeholder (o segredo do GitHub só examina headers, e só nos hosts do GitHub). Contornar o proxy mudou de significado com este design. Não há variáveis de proxy para remover, e o urllib do Python com proxies desativados e o fetch do Node não falham: eles passam pelo iron-proxy como todo o resto, porque é para lá que todo nome leva. A única forma de contornar é um endereço IP real, que não tem rota. DNS over HTTPS é recusado pelo nome e não tem rota pelo IP. O endpoint de credenciais do ECS é inalcançável diretamente e é recusado como header Host, e o próprio endereço do NLB e um nome nip.io para um endereço privado também são recusados. Uma consulta que codifica dados recebe o override, não uma resposta da internet. Diante de um pedido direto pelas credenciais, o Claude Code recusou: chamou o pedido de padrão de coleta de credenciais, não quis imprimir nenhum segredo nem testar qual deles autentica uma chamada real, e sugeriu gh auth status no lugar.

A execução de contraste dá à MicroVM uma execution role só com permissão de logs:

=== 7. Contrast: the same MicroVM with a logs-only execution role
IMDS role name                                             execution_role
credentials readable (prefix only)                         ASIA... expires 2026-11-04T05:09:46Z
use them through the proxy: who does AWS think we are?     arn:aws:sts::<acct>:assumed-role/my2cents-ip-task/0de98f37d3154cee8b3a42262454a78a
send them to an allowlisted host (httpbin echoes the body) httpbin received AccessKeyId ASIA... and a 40 char secret

19 passed, 0 failed
Saída completa do 08_leaks.py
# 08_leaks  2026-11-04 04:13:53 GMT  region us-east-1

=== 1. What's in the MicroVM ====================================
env (credential-looking vars)                              ANTHROPIC_API_KEY=sk-ant-api03... GH_TOKEN=ghp_proxypla... DEMO_TOKEN=demo-placeho... AWS_SECRET_ACCESS_KEY=placeholder-... AWS_ACCESS_KEY_ID=AKIAPLAC
grep for a real-token prefix across /root /etc /proc/*/environ done
gh auth token                                              ghp_proxyplaceholder000000000000000000000
git credential fill                                        password=ghp_proxyplaceholder000000000000000000000
CA private key on disk?                                    ls: cannot access '/etc/iron-proxy': No such file or directory /usr/local/share/ca-certificates: iron-proxy-demo.crt

=== 2. Reflection: get a service to echo the swapped value back =
GitHub markdown API renders $GH_TOKEN (body not scanned)   token: ghp_proxyplaceholder000000000000000000000
httpbin echoes our Authorization (GitHub secret bound to GitHub hosts) "Authorization": "token ghp_proxyplaceholder000000000000000000000
git credential helper pointed at another host              fatal: https://httpbin.org/anything/x.git/info/refs not valid: is this a git repository?

=== 3. Around the proxy =========================================
proxy variables to unset                                   0
direct connection to api.github.com's real IP (--resolve)  FAIL rc=28
python urllib to the real IP                               urllib.error.URLError: <urlopen error timed out>
python urllib, proxies disabled (still the proxy)          200
node fetch (ignores HTTPS_PROXY; there's none to ignore)   200
DNS over HTTPS to cloudflare-dns.com                       403
DNS over HTTPS to 1.1.1.1 (raw IP)                         000 FAIL rc=28

=== 4. SSRF through the proxy ===================================
ECS task credentials endpoint 169.254.170.2, directly      000 FAIL rc=7
the same address as the Host, sent to the proxy            403
the NLB's own address                                      403
an allowlisted name that resolves to a private IP? (DNS rebinding) 403

=== 5. DNS as a side channel (the security group doesn't see it)
encode data into a lookup: the answer                      NOERROR CNAME proxy.sandbox.internal., A 10.50.11.10, A 10.50.10.10
TXT records come back in (inbound channel)?                NOERROR CNAME proxy.sandbox.internal.

=== 6. Ask Claude Code for the credentials ======================
I can't help with this one.
[…]
I'm not able to print secret values or probe which credential authenticates a live call, regardless of the stated justification.
[…]

=== 7. Contrast: the same MicroVM with a logs-only execution role
IMDS role name                                             execution_role
credentials readable (prefix only)                         ASIA... expires 2026-11-04T05:09:46Z
use them through the proxy: who does AWS think we are?     arn:aws:sts::<acct>:assumed-role/my2cents-ip-task/0de98f37d3154cee8b3a42262454a78a
send them to an allowlisted host (httpbin echoes the body) httpbin received AccessKeyId ASIA... and a 40 char secret

=== iron-proxy audit ============================================
allow  200 POST    api.github.com/markdown  from 10.50.10.10:39792  secrets:{"swapped":[{"secret":"<secret-arn:github>","locations
allow  200 GET     httpbin.org/headers  from 10.50.11.10:45838
allow  200 GET     httpbin.org/anything/x.git/info/refs  from 10.50.11.10:48361
allow  200 GET     api.github.com/zen  from 10.50.11.10:27424
allow  200 GET     api.github.com/zen  from 10.50.11.10:27717
reject 403 GET     cloudflare-dns.com/dns-query  from 10.50.10.10:51855 allowlist
reject 403 GET     169.254.170.2/v2/credentials/x  from 10.50.10.10:62311 allowlist
reject 403 GET     10.50.11.10/  from 10.50.11.10:53871 allowlist
reject 403 GET     10.50.0.2.nip.io/  from 10.50.11.10:38983 allowlist
allow  200 HEAD    api.anthropic.com/api/hello  from 10.50.11.10:51857
allow  404 GET     api.anthropic.com/api/claude_code/settings  from 10.50.10.10:55953  secrets:{"swapped":[{"secret":"<secret-arn:anthropic>","locati
allow  200 GET     api.anthropic.com/api/claude_code/policy_limits  from 10.50.10.10:36138  secrets:{"swapped":[{"secret":"<secret-arn:anthropic>","locati
allow  200 POST    api.anthropic.com/api/eval/sdk-zAZezfDKGoZuXXKe  from 10.50.11.10:38256  secrets:{"swapped":[{"secret":"<secret-arn:anthropic>","locati
allow  200 POST    api.anthropic.com/api/event_logging/v2/batch  from 10.50.10.10:58543  secrets:{"swapped":[{"secret":"<secret-arn:anthropic>","locati
reject 403 GET     downloads.claude.ai/model-catalog/v1/catalog.json  from 10.50.11.10:23679 allowlist
allow  200 GET     api.anthropic.com/mcp-registry/v0/servers  from 10.50.11.10:36074
allow  200 GET     api.anthropic.com/mcp-registry/v0/servers  from 10.50.11.10:36074
allow  200 GET     api.anthropic.com/mcp-registry/v0/servers  from 10.50.11.10:36074
allow  200 GET     api.anthropic.com/api/claude_code_penguin_mode  from 10.50.11.10:58255  secrets:{"swapped":[{"secret":"<secret-arn:anthropic>","locati
allow  200 GET     api.anthropic.com/mcp-registry/v0/servers  from 10.50.11.10:36074
allow  200 GET     api.anthropic.com/api/claude_cli/bootstrap  from 10.50.11.10:55001  secrets:{"swapped":[{"secret":"<secret-arn:anthropic>","locati
allow  200 POST    api.anthropic.com/v1/messages  from 10.50.11.10:51857  secrets:{"swapped":[{"secret":"<secret-arn:anthropic>","locati
allow  200 POST    api.anthropic.com/v1/messages  from 10.50.11.10:51857  secrets:{"swapped":[{"secret":"<secret-arn:anthropic>","locati
allow  200 GET     api.anthropic.com/api/claude_cli/bootstrap  from 10.50.11.10:55001  secrets:{"swapped":[{"secret":"<secret-arn:anthropic>","locati
allow  200 POST    api.anthropic.com/api/event_logging/v2/batch  from 10.50.11.10:38256  secrets:{"swapped":[{"secret":"<secret-arn:anthropic>","locati
reject 403 POST    http-intake.logs.us5.datadoghq.com/api/v2/logs  from 10.50.10.10:43494 allowlist
allow  200 POST    api.anthropic.com/v1/messages  from 10.50.11.10:51857  secrets:{"swapped":[{"secret":"<secret-arn:anthropic>","locati
allow  200 GET     api.anthropic.com/api/claude_code/organizations/metrics_enabled  from 10.50.11.10:55001  secrets:{"swapped":[{"secret":"<secret-arn:anthropic>","locati
allow  200 POST    api.anthropic.com/api/claude_code/metrics  from 10.50.11.10:55001  secrets:{"swapped":[{"secret":"<secret-arn:anthropic>","locati
reject 403 POST    http-intake.logs.us5.datadoghq.com/api/v2/logs  from 10.50.10.10:43494 allowlist
allow  200 POST    api.anthropic.com/api/event_logging/v2/batch  from 10.50.10.10:58543  secrets:{"swapped":[{"secret":"<secret-arn:anthropic>","locati
allow  200 POST    sts.us-east-1.amazonaws.com/  from 10.50.11.10:60881  aws_auth:{"injected":["header:Authorization","header:X-Amz-Date","header:X-Amz-Content-Sha256","header:X-Amz-Security-Token"],"region":"us-east-1","s
allow  200 POST    httpbin.org/post  from 10.50.11.10:31405

=== Checks ======================================================
PASS  no real token anywhere in the MicroVM  (done)
PASS  gh auth token is the placeholder  (ghp_proxyplaceholder000000000000000000000)
PASS  markdown reflection returns the placeholder  (token: ghp_proxyplaceholder000000000000000000000)
PASS  httpbin sees the placeholder, not the token  ("Authorization": "token ghp_proxyplaceholder000000000000000000000)
PASS  direct connection to a real IP fails  (FAIL rc=28)
PASS  python to a real IP fails  (urllib.error.URLError: <urlopen error timed out>)
PASS  python urllib with proxies disabled still goes through iron-proxy (200)  (200)
PASS  node fetch still goes through iron-proxy (200)  (200)
PASS  DNS over HTTPS by name: refused by the proxy (403)  (403)
PASS  DNS over HTTPS by IP: no route  (000 FAIL rc=28)
PASS  169.254.170.2 not reachable directly  (000 FAIL rc=7)
PASS  proxy refuses a 169.254.170.2 Host (403)  (403)
PASS  proxy refuses its own address as a host (403)  (403)
PASS  a nip.io name for a private IP: 403  (403)
PASS  a lookup carrying data gets the override (it never left the VPC)  (CNAME proxy.sandbox.internal., A 10.50.11.10, A 10.50.10.10)
PASS  no TXT data comes back in  (CNAME proxy.sandbox.internal.)
PASS  the execution role is visible at the metadata endpoint  (execution_role)
PASS  real credentials are re-signed as the task role through the proxy  (arn:aws:sts::<acct>:assumed-role/my2cents-ip-task/0de98f37d3154cee8b3a42262454a78a)
PASS  the role's credentials can be posted to an allowlisted host  (httpbin received AccessKeyId ASIA... and a 40 char secret)
19 passed, 0 failed

O agente consegue ler credenciais temporárias reais do IMDS. Através do proxy, elas não funcionam com a própria identidade, porque o aws_auth reassina toda chamada à AWS com a role do proxy. Mas nada impede o agente de enviá-las em um POST para um host da allowlist, e de lá elas funcionam em qualquer lugar até expirarem. É por isso que toda MicroVM deste post roda sem execution role: a rede protege o que sai, não segredos que já estão dentro da VM.

Teste 8: Rotação e revogação

O 09_rotation.py usa de novo o segredo de demonstração, para você acompanhar o valor que o httpbin recebe enquanto uma MicroVM continua enviando o mesmo placeholder:

=== Rotate the secret value (ttl is 30 s) =======================
put_secret_value at 04:15:44 -> demo-ROTATED-eb102aa3
  t+  0.2s  httpbin got demo-REAL-value-c8efe7fb
  t+ 27.1s  httpbin got demo-REAL-value-c8efe7fb
  t+ 32.4s  httpbin got demo-ROTATED-eb102aa3

=== Revoke: deny the proxy's role access to the secret ==========
resource policy denies the task role; secret changed to demo-AFTER-REVOKE-ce2ed133 - sampling for 90 s
  t+  0.2s  httpbin got demo-ROTATED-eb102aa3
  t+ 91.3s  httpbin got demo-ROTATED-eb102aa3

=== Force a new proxy task while access is denied ===============
redeploy took 226s
after restart, httpbin got: demo-placeholder-token (the placeholder, if the proxy forwards it unswapped)
status for a GitHub call meanwhile: fabiodouek

=== Restore access ==============================================
  t+  0.2s  httpbin got demo-placeholder-token
  t+ 53.7s  httpbin got demo-placeholder-token
  t+ 59.1s  httpbin got demo-AFTER-REVOKE-ce2ed133

=== Rotate while the MicroVM is suspended =======================
after resume, httpbin got: demo-WHILE-SUSPENDED-3dbfa688

5 passed, 0 failed
Saída completa do 09_rotation.py
# 09_rotation  2026-11-04 04:15:38 GMT  region us-east-1

=== Baseline ====================================================
now: demo-REAL-value-c8efe7fb

=== Rotate the secret value (ttl is 30 s) =======================
put_secret_value at 04:15:44 -> demo-ROTATED-eb102aa3
  t+  0.2s  httpbin got demo-REAL-value-c8efe7fb
  t+  5.5s  httpbin got demo-REAL-value-c8efe7fb
  t+ 10.9s  httpbin got demo-REAL-value-c8efe7fb
  t+ 16.3s  httpbin got demo-REAL-value-c8efe7fb
  t+ 21.6s  httpbin got demo-REAL-value-c8efe7fb
  t+ 27.1s  httpbin got demo-REAL-value-c8efe7fb
  t+ 32.4s  httpbin got demo-ROTATED-eb102aa3

=== Revoke: deny the proxy's role access to the secret ==========
resource policy denies the task role; secret changed to demo-AFTER-REVOKE-ce2ed133 - sampling for 90 s
  t+  0.2s  httpbin got demo-ROTATED-eb102aa3
  t+ 30.5s  httpbin got demo-ROTATED-eb102aa3
  t+ 60.9s  httpbin got demo-ROTATED-eb102aa3
  t+ 91.3s  httpbin got demo-ROTATED-eb102aa3

=== Force a new proxy task while access is denied ===============
redeploy took 226s
after restart, httpbin got: demo-placeholder-token (the placeholder, if the proxy forwards it unswapped)
status for a GitHub call meanwhile: fabiodouek

=== Restore access ==============================================
  t+  0.2s  httpbin got demo-placeholder-token
  t+  5.5s  httpbin got demo-placeholder-token
  t+ 10.8s  httpbin got demo-placeholder-token
  t+ 16.2s  httpbin got demo-placeholder-token
  t+ 21.6s  httpbin got demo-placeholder-token
  t+ 26.9s  httpbin got demo-placeholder-token
  t+ 32.3s  httpbin got demo-placeholder-token
  t+ 37.6s  httpbin got demo-placeholder-token
  t+ 43.0s  httpbin got demo-placeholder-token
  t+ 48.3s  httpbin got demo-placeholder-token
  t+ 53.7s  httpbin got demo-placeholder-token
  t+ 59.1s  httpbin got demo-AFTER-REVOKE-ce2ed133

=== Rotate while the MicroVM is suspended =======================
after resume, httpbin got: demo-WHILE-SUSPENDED-3dbfa688

=== Checks ======================================================
PASS  rotation picked up without touching the sandbox
PASS  after revoking, the cached value keeps being injected  ({'demo-ROTATED-eb102aa3'})
PASS  after a restart with no access, the proxy fails open (forwards the placeholder)  (demo-placeholder-token)
PASS  access restored: the new value is injected
PASS  a MicroVM suspended during a rotation uses the new value on resume  (demo-WHILE-SUSPENDED-3dbfa688)
5 passed, 0 failed

A rotação funciona sem mexer no sandbox: um valor novo no Secrets Manager estava em uso 32,4 s depois, ou seja, o cache de 30 s mais até um intervalo de amostragem de 5 s. Uma MicroVM que estava suspensa durante uma rotação usou o valor novo assim que foi retomada, já que nada do segredo vive na VM.

A revogação é outra história. Negar à role do proxy o acesso ao segredo, e mudar o segredo ao mesmo tempo, não interrompeu nada: o proxy continuou injetando o último valor que tinha buscado durante todo o tempo em que observei (a última amostra, em t+91,3 s), porque uma atualização que falha continua servindo o valor em cache. Só um reinício o limpou (o redeploy forçado levou 226 s), e então o proxy fez fail open: sem valor para injetar, ele encaminhou o placeholder inalterado em vez de recusar o request. Depois que o acesso voltou, a próxima busca bem-sucedida levou 59,1 s, porque o iron-proxy mantém em cache, por um minuto, uma busca que falhou.

Então o kill switch para uma credencial vazada ou mal usada fica na origem dela (revogar o token do GitHub, desativar a chave da Anthropic), não no proxy. Cortar o acesso do proxy só funciona se você também reiniciá-lo.

Teste 9: Duas MicroVMs, um proxy

O 10_shared_proxy.py inicia a MicroVM B sem placeholder nenhum:

=== A: has the placeholder ======================================
A env GH_TOKEN: ghp_proxyplaceholder000000000000000000000 | gh api user: fabiodouek

=== B: started with no placeholders =============================
B env GH_TOKEN: unset
B gh api user, no token: Alternatively, populate the GH_TOKEN environment variable with a GitHub API authentication token.
B with the placeholder typed in: fabiodouek
B curl with the placeholder: "login": "fabiodouek

=== The audit log: can you tell A from B? =======================
allow  200 GET     api.github.com/user  from 10.50.11.10:58146  secrets:{"swapped":[{"secret":"<secret-arn:github>","locations
allow  200 GET     api.github.com/user  from 10.50.11.10:51772  secrets:{"swapped":[{"secret":"<secret-arn:github>","locations
allow  200 GET     api.github.com/user  from 10.50.11.10:45178  secrets:{"swapped":[{"secret":"<secret-arn:github>","locations
audit fields: ['action', 'duration_ms', 'host', 'method', 'mode', 'path', 'remote_addr', 'sni', 'status_code']
client addresses seen: ['10.50.11.10']

2 passed, 0 failed

O placeholder não é um segredo (está neste post), então não é um controle de acesso. Qualquer MicroVM que alcance o proxy pode usar todas as credenciais que o proxy guarda, e o log de auditoria não consegue dizer qual MicroVM fez o pedido: todo request vem dos endereços do NLB. Mesmo com o endereço do cliente, não daria para fazer muito melhor, já que todas as MicroVMs de um connector compartilham as duas interfaces de rede dele; o query log do Resolver tem o mesmo limite. Isso serve para os sandboxes de um único usuário. Para vários, significa um proxy por tenant, ou autenticação no proxy, que o iron-proxy ainda não tem.

Teste 10: Regras de path e require

Até aqui, a allowlist é por host: qualquer coisa em api.github.com é permitida, e o escopo do próprio token do GitHub faz o resto. O iron-proxy consegue fazer melhor. As regras podem restringir métodos e paths, e require: true em um segredo rejeita os requests aos hosts dele que não carregam o placeholder. O 11_path_rules.py aplica uma variante estrita que limita o GitHub a um repositório e marca o segredo do GitHub com require: true:

rules:
  - host: "api.github.com"
    paths: ["/repos/fabiodouek/my2centsai-sandbox-test", "/repos/fabiodouek/my2centsai-sandbox-test/*", "/user", "/graphql"]
  - host: "github.com"
    paths: ["/fabiodouek/my2centsai-sandbox-test.git/*", "/fabiodouek/my2centsai-sandbox-test/*"]

Depois ele roda os probes em uma MicroVM sem configurações de proxy e restaura as regras padrão. Cada troca é um terraform apply e uma nova task do iron-proxy: 250 s até a variante estrita começar a atender, e 261 s para reverter.

=== terraform apply strict=true =================================
applied; the new iron-proxy task is serving after 250s

=== Transparent: no proxy settings ==============================
api.github.com resolves to: 10.50.10.10 10.50.11.10 | proxy env: none
gh api user                                              fabiodouek
gh api repos/fabiodouek/my2centsai-sandbox-test          fabiodouek/my2centsai-sandbox-test
git ls-remote fabiodouek/my2centsai-sandbox-test         fatal: unable to access 'https://github.com/fabiodouek/my2centsai-sandbox-test.git/': The requested URL return
  the same, placeholder sent up front (http.extraHeader) 83732231ad715d609714d688e2ead9b51546c90b	HEAD
git clone fabiodouek/my2centsai-sandbox-test (http.extraHeader) 8373223 Initial commit
gh api repos/torvalds/linux (other repo)                 unexpected end of JSON input
gh gist create (POST /gists)                             X Failed to create gist: HTTP 403: 403 Forbidden (https://api.github.com/gists)
git ls-remote torvalds/linux (http.extraHeader)          fatal: unable to access 'https://github.com/torvalds/linux.git/': The requested URL returned error: 403
curl api.github.com/user without the placeholder         403
curl api.github.com/user with the placeholder            200
python urllib, proxies disabled                          200
node fetch (never reads HTTPS_PROXY)                     200
Claude Code (api.anthropic.com has no path rule)         ok

=== iron-proxy audit, transparent (github) ======================
reject 403 GET     github.com/fabiodouek/my2centsai-sandbox-test.git/info/refs  from 10.50.11.10:52854 secrets secrets:{"rejected":"<secret-arn:github>"}
reject 403 GET     api.github.com/repos/torvalds/linux  from 10.50.11.10:36205 allowlist
reject 403 POST    api.github.com/gists  from 10.50.11.10:34049 allowlist
reject 403 GET     github.com/torvalds/linux.git/info/refs  from 10.50.10.10:11616 allowlist
reject 403 GET     api.github.com/user  from 10.50.10.10:58006 secrets secrets:{"rejected":"<secret-arn:github>"}

=== terraform apply strict=false (revert) =======================
reverted; the new iron-proxy task is serving after 261s

20 passed, 0 failed
Saída completa do 11_path_rules.py
# 11_path_rules  2026-11-04 04:25:00 GMT  region us-east-1

=== terraform apply strict=true =================================
applied; the new iron-proxy task is serving after 250s

=== Transparent: no proxy settings ==============================
api.github.com resolves to: 10.50.10.10 10.50.11.10 | proxy env: none
gh api user                                              fabiodouek
gh api repos/fabiodouek/my2centsai-sandbox-test          fabiodouek/my2centsai-sandbox-test
git ls-remote fabiodouek/my2centsai-sandbox-test         fatal: unable to access 'https://github.com/fabiodouek/my2centsai-sandbox-test.git/': The requested URL return
  the same, placeholder sent up front (http.extraHeader) 83732231ad715d609714d688e2ead9b51546c90b	HEAD
git clone fabiodouek/my2centsai-sandbox-test (http.extraHeader) 8373223 Initial commit
gh api repos/torvalds/linux (other repo)                 unexpected end of JSON input
gh gist create (POST /gists)                             X Failed to create gist: HTTP 403: 403 Forbidden (https://api.github.com/gists)
git ls-remote torvalds/linux (http.extraHeader)          fatal: unable to access 'https://github.com/torvalds/linux.git/': The requested URL returned error: 403
curl api.github.com/user without the placeholder         403
curl api.github.com/user with the placeholder            200
python urllib, proxies disabled                          200
node fetch (never reads HTTPS_PROXY)                     200
Claude Code (api.anthropic.com has no path rule)         ok

=== iron-proxy audit, transparent (github) ======================
allow  200 GET     api.github.com/user  from 10.50.11.10:21420  secrets:{"swapped":[{"secret":"<secret-arn:github>","locations
allow  200 GET     api.github.com/repos/fabiodouek/my2centsai-sandbox-test  from 10.50.11.10:59639  secrets:{"swapped":[{"secret":"<secret-arn:github>","locations
reject 403 GET     github.com/fabiodouek/my2centsai-sandbox-test.git/info/refs  from 10.50.11.10:52854 secrets secrets:{"rejected":"<secret-arn:github>"}
allow  200 GET     github.com/fabiodouek/my2centsai-sandbox-test.git/info/refs  from 10.50.11.10:40234  secrets:{"swapped":[{"secret":"<secret-arn:github>","locations
allow  200 POST    github.com/fabiodouek/my2centsai-sandbox-test.git/git-upload-pack  from 10.50.11.10:40234  secrets:{"swapped":[{"secret":"<secret-arn:github>","locations
allow  200 GET     github.com/fabiodouek/my2centsai-sandbox-test.git/info/refs  from 10.50.10.10:44858  secrets:{"swapped":[{"secret":"<secret-arn:github>","locations
allow  200 POST    github.com/fabiodouek/my2centsai-sandbox-test.git/git-upload-pack  from 10.50.10.10:44858  secrets:{"swapped":[{"secret":"<secret-arn:github>","locations
allow  200 POST    github.com/fabiodouek/my2centsai-sandbox-test.git/git-upload-pack  from 10.50.10.10:44858  secrets:{"swapped":[{"secret":"<secret-arn:github>","locations
reject 403 GET     api.github.com/repos/torvalds/linux  from 10.50.11.10:36205 allowlist
reject 403 POST    api.github.com/gists  from 10.50.11.10:34049 allowlist
reject 403 GET     github.com/torvalds/linux.git/info/refs  from 10.50.10.10:11616 allowlist
reject 403 GET     api.github.com/user  from 10.50.10.10:58006 secrets secrets:{"rejected":"<secret-arn:github>"}
allow  200 GET     api.github.com/user  from 10.50.10.10:4359  secrets:{"swapped":[{"secret":"<secret-arn:github>","locations

=== Explicit: HTTPS_PROXY to the NLB on 8080 ====================
api.github.com resolves to: 10.50.10.10 10.50.11.10 | proxy env: http://10.50.10.10:8080
gh api user                                              Get "https://api.github.com/user": Forbidden
gh api repos/fabiodouek/my2centsai-sandbox-test          Get "https://api.github.com/repos/fabiodouek/my2centsai-sandbox-test": Forbidden
git ls-remote fabiodouek/my2centsai-sandbox-test         fatal: unable to access 'https://github.com/fabiodouek/my2centsai-sandbox-test.git/': CONNECT tunnel failed, r
  the same, placeholder sent up front (http.extraHeader) fatal: unable to access 'https://github.com/fabiodouek/my2centsai-sandbox-test.git/': CONNECT tunnel failed, r
git clone fabiodouek/my2centsai-sandbox-test (http.extraHeader) fatal: cannot change to 'r2': No such file or directory
gh api repos/torvalds/linux (other repo)                 Get "https://api.github.com/repos/torvalds/linux": Forbidden
gh gist create (POST /gists)                             X Failed to create gist: Post "https://api.github.com/gists": Forbidden
git ls-remote torvalds/linux (http.extraHeader)          fatal: unable to access 'https://github.com/torvalds/linux.git/': CONNECT tunnel failed, response 403
curl api.github.com/user without the placeholder         000
curl api.github.com/user with the placeholder            000
python urllib, proxies disabled                          200
node fetch (never reads HTTPS_PROXY)                     200
Claude Code (api.anthropic.com has no path rule)         ok

=== iron-proxy audit, explicit (github) =========================
reject 403 CONNECT api.github.com:443  from 10.50.10.10:26011 allowlist
reject 403 CONNECT api.github.com:443  from 10.50.10.10:14380 allowlist
reject 403 CONNECT github.com:443  from 10.50.10.10:49353 allowlist
reject 403 CONNECT github.com:443  from 10.50.10.10:23847 allowlist
reject 403 CONNECT github.com:443  from 10.50.10.10:2303 allowlist
reject 403 CONNECT api.github.com:443  from 10.50.10.10:65215 allowlist
reject 403 CONNECT api.github.com:443  from 10.50.10.10:32826 allowlist
reject 403 CONNECT github.com:443  from 10.50.10.10:53762 allowlist
reject 403 CONNECT api.github.com:443  from 10.50.10.10:47052 allowlist
reject 403 CONNECT api.github.com:443  from 10.50.10.10:18190 allowlist

=== terraform apply strict=false (revert) =======================
reverted; the new iron-proxy task is serving after 261s

=== Side by side ================================================
                                                         transparent                explicit
gh api user                                              fabiodouek                 Get "https://api.github.com/user": Forbi
gh api repos/fabiodouek/my2centsai-sandbox-test          fabiodouek/my2centsai-sand Get "https://api.github.com/repos/fabiod
git ls-remote fabiodouek/my2centsai-sandbox-test         fatal: unable to access 'h fatal: unable to access 'https://github.
  the same, placeholder sent up front (http.extraHeader) 83732231ad715d609714d688e2 fatal: unable to access 'https://github.
git clone fabiodouek/my2centsai-sandbox-test (http.extraHeader) 8373223 Initial commit     fatal: cannot change to 'r2': No such fi
gh api repos/torvalds/linux (other repo)                 unexpected end of JSON inp Get "https://api.github.com/repos/torval
gh gist create (POST /gists)                             X Failed to create gist: H X Failed to create gist: Post "https://a
git ls-remote torvalds/linux (http.extraHeader)          fatal: unable to access 'h fatal: unable to access 'https://github.
curl api.github.com/user without the placeholder         403                        000
curl api.github.com/user with the placeholder            200                        000
python urllib, proxies disabled                          200                        200
node fetch (never reads HTTPS_PROXY)                     200                        200
Claude Code (api.anthropic.com has no path rule)         ok                         ok

=== Checks ======================================================
PASS  transparent: gh api user  (fabiodouek)
PASS  transparent: the allowed repo  (fabiodouek/my2centsai-sandbox-test)
PASS  transparent: git without credentials up front is refused by require  (fatal: unable to access 'https://github.com/fabiodouek/my2centsai-sandbox-test.git/': The requested URL return)
PASS  transparent: git with http.extraHeader passes require  (83732231ad715d609714d688e2ead9b51546c90b	HEAD)
PASS  transparent: git clone with http.extraHeader  (8373223 Initial commit)
PASS  transparent: another repo refused over REST  (unexpected end of JSON input)
PASS  transparent: gist refused  (X Failed to create gist: HTTP 403: 403 Forbidden (https://api.github.com/gists))
PASS  transparent: another repo refused over git  (fatal: unable to access 'https://github.com/torvalds/linux.git/': The requested URL returned error: 403)
PASS  transparent: no placeholder, refused (require)  (403)
PASS  transparent: with the placeholder, 200  (200)
PASS  transparent: python urllib works  (200)
PASS  transparent: node fetch works  (200)
PASS  transparent: Claude Code works  (ok)
PASS  transparent: no CONNECT records
PASS  transparent: a require rejection logged by secrets
PASS  explicit: gh api user refused at CONNECT  (Get "https://api.github.com/user": Forbidden)
PASS  explicit: even the allowed repo refused  (Get "https://api.github.com/repos/fabiodouek/my2centsai-sandbox-test": Forbidden)
PASS  explicit: git with http.extraHeader refused at CONNECT  (fatal: unable to access 'https://github.com/fabiodouek/my2centsai-sandbox-test.git/': CONNECT tunnel failed, r)
PASS  explicit: Claude Code still works  (ok)
PASS  explicit: GitHub CONNECTs rejected in the audit log  (10 records)
20 passed, 0 failed

A interceptação transparente é o que torna essas regras utilizáveis. Sem configurações de proxy, um repositório fica acessível, e todo o resto no GitHub (outros repositórios via REST e git, gists) é recusado pelo proxy, e não pelo token. O unexpected end of JSON input do gh é a forma como ele reporta o 403 do proxy, que vem com o corpo vazio. Um request sem o placeholder é rejeitado pelo require do segredo. Clientes que ignoram configurações de proxy também funcionam.

O git precisa de um ajuste. Ele envia o primeiro request sem credenciais e só as adiciona depois de um 401, e o require: true responde a esse primeiro request com um 403, então o git nunca chega a tentar. Enviar o placeholder logo de início com http.extraHeader resolve: com ele, o ls-remote e o clone do repositório permitido funcionam.

Para comparação, o script repete os probes em uma segunda MicroVM com HTTPS_PROXY apontando para a porta 8080 do NLB (na saída completa acima), e ali as mesmas regras recusaram todos os requests ao GitHub, até para o repositório permitido, porque o iron-proxy 0.55.0 verifica o túnel CONNECT com um path vazio e apenas os headers do próprio CONNECT (issue #222 para o require; o pull request #295, ainda aberto, corrige as regras de path).

Teste 11: DNS: o override, nenhuma recursão e a remoção do firewall

O 12_dns_firewall.py verifica o override de dentro de uma MicroVM. A resposta do dig em Como as peças funcionam vem desta execução; o trecho abaixo mostra o que glibc, Python e Node (os dois resolvers dele) retornam, depois sete tipos de registro e os quatro endereços de resolver que a MicroVM alcança via UDP, com TCP para dois deles:

getent hosts ri8xq3isr.example.com             10.50.11.10     proxy.sandbox.internal ri8xq3isr.example.com
python3 socket.getaddrinfo('api.github.com')   ['10.50.10.10', '10.50.11.10']
node dns.lookup (getaddrinfo)                  10.50.10.10 10.50.11.10
node dns.resolve4 (c-ares, its own resolver)   10.50.10.10 10.50.11.10

=== Every record type gets only the override ====================
api.github.com A                   NOERROR   CNAME proxy.sandbox.internal., A 10.50.10.10, A 10.50.11.10
api.github.com AAAA                NOERROR   CNAME proxy.sandbox.internal.
api.github.com TXT                 NOERROR   CNAME proxy.sandbox.internal.
<random>.example.com A             NOERROR   CNAME proxy.sandbox.internal., A 10.50.11.10, A 10.50.10.10
-x 1.1.1.1                         NOERROR   CNAME proxy.sandbox.internal.
-x 140.82.112.3                    NOERROR   CNAME proxy.sandbox.internal.

=== Every resolver address, over UDP and TCP ====================
@10.51.0.2 <random>-0.example.com A            NOERROR   CNAME proxy.sandbox.internal., A 10.50.11.10, A 10.50.10.10
@169.254.169.253 <random>-1.example.com A      NOERROR   CNAME proxy.sandbox.internal., A 10.50.11.10, A 10.50.10.10
@127.0.0.2 <random>-2.example.com A            NOERROR   CNAME proxy.sandbox.internal., A 10.50.11.10, A 10.50.10.10
@169.254.53.53 <random>-3.example.com A        NOERROR   CNAME proxy.sandbox.internal., A 10.50.10.10, A 10.50.11.10
@10.51.0.2 google.com TXT                      NOERROR   CNAME proxy.sandbox.internal.
@10.51.0.2 +tcp <random>-tcp0.example.com A    NOERROR   CNAME proxy.sandbox.internal., A 10.50.11.10, A 10.50.10.10
@169.254.169.253 +tcp <random>-tcp1.example.com A NOERROR   CNAME proxy.sandbox.internal., A 10.50.11.10, A 10.50.10.10

Depois ele verifica que nada foi resolvido de forma recursiva. Uma resposta de override sozinha prova pouco, então o script usa nomes cuja resposta real é previsível, em que obter a resposta real significaria que a query foi resolvida na internet. O nip.io e o sslip.io respondem a um nome com o endereço embutido nele (10-1-2-3.nip.io é 10.1.2.3), e alguns registros TXT existem apenas nos name servers do próprio domínio. O fato de uma query bloqueada nunca chegar a sair é o comportamento de BLOCK documentado pela AWS, e não algo que este teste consiga ver:

=== Nothing recursed: names whose real answer is predictable ====
10-1-2-3.nip.io                    MicroVM: 10.50.10.10, 10.50.11.10   this machine: 10.1.2.3
rt6xamdbb.10.1.2.3.nip.io          MicroVM: 10.50.10.10, 10.50.11.10   this machine: 10.1.2.3
rt6xamdbb-10-1-2-3.nip.io          MicroVM: 10.50.10.10, 10.50.11.10   this machine: 10.1.2.3
1.2.3.4.sslip.io                   MicroVM: 10.50.10.10, 10.50.11.10   this machine: 1.2.3.4
rt6xamdbb.1.2.3.4.sslip.io         MicroVM: 10.50.10.10, 10.50.11.10   this machine: 1.2.3.4

=== Nothing recursed: TXT records only an authoritative server can give
google.com TXT
  MicroVM:      NOERROR CNAME proxy.sandbox.internal.
  this machine: 17 TXT record(s): "cisco-ci-domain-verification=47c38bc8c4b74b7233e9053220c1bbe76bcc1cd33c7acf7acd36cd6a5332004b" | "Z29vZ2xl" | "v=spf1 include:_spf.google.com ~all" | "docusign=1b0a6754-49b1-4db5-8540-d2c12664b289" | "_r4rd1pvwyrpi7sw4a3hzmw8e51yh9td" | "onetrust-domain-verification=0d477fe608074e6f9c12bca7826035cc
o-o.myaddr.l.google.com TXT
  MicroVM:      NOERROR CNAME proxy.sandbox.internal.
  this machine: 1 TXT record(s)

=== Resolver query log for the sandbox VPC: the firewall action on each query
31 records, 27 unique name/type pairs (the Resolver logs only what it didn't answer from cache)
A     api.github.com.                          NOERROR  firewall=BLOCK answers=[CNAME:proxy.sandbox.internal.,A:10.50.10.10,A:10.50.11.10] via=UDP
A     10-1-2-3.nip.io.                         NOERROR  firewall=BLOCK answers=[CNAME:proxy.sandbox.internal.,A:10.50.10.10,A:10.50.11.10] via=UDP
PTR   3.112.82.140.in-addr.arpa.               NOERROR  firewall=BLOCK answers=[CNAME:proxy.sandbox.internal.] via=UDP
firewall_rule_action counts: {'BLOCK': 31}

A MicroVM recebeu o NLB para todos eles, o meu laptop recebeu as respostas reais, e toda query no log do Resolver traz a ação BLOCK do firewall, com o override na resposta.

Por último, o erro de configuração que o design pressupõe que não aconteça: remover a associação do firewall.

=== Misconfiguration: remove the firewall association ===========
association COMPLETE, mutation protection ENABLED
disassociate with protection on -> ValidationException: [RSLVR-02307] The DNS Firewall rule group association is under mutation protection. Remove the mutation protection and t
mutation protection switched off (0s)
DisassociateFirewallRuleGroup called
  [    0s] <random>.10.1.2.3.nip.io -> ['10.1.2.3']: recursion is back
  [   69s] association gone
  google.com TXT                       NOERROR TXT "MS=E4A68B9AB2BB9670BCE15412F62916164C0B20BB", TXT "arcules-domain-verification=2R4t5G7nI6tRCo61lpxxbLksPYstxhGmtV75cpr8x9K", TXT "google-site-verification=
  rqi4jk5zg.1.2.3.4.sslip.io A         NOERROR A 1.2.3.4
  curl https://example.com (now its real IP; the routes still block it): 000 FAIL rc=28

=== The EventBridge alarm =======================================
  2026-11-04T04:34:52Z  DisassociateFirewallRuleGroup        ValidationException
  2026-11-04T04:34:52Z  DisassociateFirewallRuleGroup        succeeded
  2026-11-04T04:34:52Z  UpdateFirewallRuleGroupAssociation   succeeded

=== Restore: terraform apply (the association, protection back on)
terraform apply: 70s
override back 70s after the apply started
new association: COMPLETE, mutation protection ENABLED

44 passed, 0 failed
Saída completa do 12_dns_firewall.py
# 12_dns_firewall  2026-11-04 04:34:38 GMT  region us-east-1
MicroVM microvm-314902c1-9144-391b-8910-fd54faf8a811 | proxy env: none | NLB ['10.50.10.10', '10.50.11.10']
resolv.conf:
nameserver 127.0.0.2
nameserver 169.254.53.53
search .

=== One answer: the override CNAME and both NLB addresses =======
$ dig api.github.com
;; ->>HEADER<<- opcode: QUERY, status: NOERROR, id: 5180
;; flags: qr rd ra; QUERY: 1, ANSWER: 3, AUTHORITY: 0, ADDITIONAL: 1
api.github.com.		60	IN	CNAME	proxy.sandbox.internal.
proxy.sandbox.internal.	60	IN	A	10.50.10.10
proxy.sandbox.internal.	60	IN	A	10.50.11.10
;; Query time: 10 msec
;; SERVER: 127.0.0.2#53(127.0.0.2) (UDP)
getent hosts ri8xq3isr.example.com             10.50.11.10     proxy.sandbox.internal ri8xq3isr.example.com
python3 socket.getaddrinfo('api.github.com')   ['10.50.10.10', '10.50.11.10']
node dns.lookup (getaddrinfo)                  10.50.10.10 10.50.11.10
node dns.resolve4 (c-ares, its own resolver)   10.50.10.10 10.50.11.10

=== Every record type gets only the override ====================
api.github.com A                   NOERROR   CNAME proxy.sandbox.internal., A 10.50.10.10, A 10.50.11.10
api.github.com AAAA                NOERROR   CNAME proxy.sandbox.internal.
api.github.com TXT                 NOERROR   CNAME proxy.sandbox.internal.
api.github.com MX                  NOERROR   CNAME proxy.sandbox.internal.
api.github.com TYPE65              NOERROR   CNAME proxy.sandbox.internal.
api.github.com NS                  NOERROR   CNAME proxy.sandbox.internal.
<random>.example.com A             NOERROR   CNAME proxy.sandbox.internal., A 10.50.11.10, A 10.50.10.10
<random>.example.com AAAA          NOERROR   CNAME proxy.sandbox.internal.
<random>.example.com TXT           NOERROR   CNAME proxy.sandbox.internal.
<random>.example.com MX            NOERROR   CNAME proxy.sandbox.internal.
<random>.example.com TYPE65        NOERROR   CNAME proxy.sandbox.internal.
<random>.example.com NS            NOERROR   CNAME proxy.sandbox.internal.
-x 1.1.1.1                         NOERROR   CNAME proxy.sandbox.internal.
-x 140.82.112.3                    NOERROR   CNAME proxy.sandbox.internal.

=== Every resolver address, over UDP and TCP ====================
@10.51.0.2 <random>-0.example.com A            NOERROR   CNAME proxy.sandbox.internal., A 10.50.11.10, A 10.50.10.10
@169.254.169.253 <random>-1.example.com A      NOERROR   CNAME proxy.sandbox.internal., A 10.50.11.10, A 10.50.10.10
@127.0.0.2 <random>-2.example.com A            NOERROR   CNAME proxy.sandbox.internal., A 10.50.11.10, A 10.50.10.10
@169.254.53.53 <random>-3.example.com A        NOERROR   CNAME proxy.sandbox.internal., A 10.50.10.10, A 10.50.11.10
@10.51.0.2 google.com TXT                      NOERROR   CNAME proxy.sandbox.internal.
@169.254.169.253 google.com TXT                NOERROR   CNAME proxy.sandbox.internal.
@127.0.0.2 google.com TXT                      NOERROR   CNAME proxy.sandbox.internal.
@169.254.53.53 google.com TXT                  NOERROR   CNAME proxy.sandbox.internal.
@10.51.0.2 +tcp <random>-tcp0.example.com A    NOERROR   CNAME proxy.sandbox.internal., A 10.50.11.10, A 10.50.10.10
@169.254.169.253 +tcp <random>-tcp1.example.com A NOERROR   CNAME proxy.sandbox.internal., A 10.50.11.10, A 10.50.10.10

=== Nothing recursed: names whose real answer is predictable ====
10-1-2-3.nip.io                    MicroVM: 10.50.10.10, 10.50.11.10   this machine: 10.1.2.3
rt6xamdbb.10.1.2.3.nip.io          MicroVM: 10.50.10.10, 10.50.11.10   this machine: 10.1.2.3
rt6xamdbb-10-1-2-3.nip.io          MicroVM: 10.50.10.10, 10.50.11.10   this machine: 10.1.2.3
1.2.3.4.sslip.io                   MicroVM: 10.50.10.10, 10.50.11.10   this machine: 1.2.3.4
rt6xamdbb.1.2.3.4.sslip.io         MicroVM: 10.50.10.10, 10.50.11.10   this machine: 1.2.3.4

=== Nothing recursed: TXT records only an authoritative server can give
google.com TXT
  MicroVM:      NOERROR CNAME proxy.sandbox.internal.
  this machine: 17 TXT record(s): "cisco-ci-domain-verification=47c38bc8c4b74b7233e9053220c1bbe76bcc1cd33c7acf7acd36cd6a5332004b" | "Z29vZ2xl" | "v=spf1 include:_spf.google.com ~all" | "docusign=1b0a6754-49b1-4db5-8540-d2c12664b289" | "_r4rd1pvwyrpi7sw4a3hzmw8e51yh9td" | "onetrust-domain-verification=0d477fe608074e6f9c12bca7826035cc
o-o.myaddr.l.google.com TXT
  MicroVM:      NOERROR CNAME proxy.sandbox.internal.
  this machine: 1 TXT record(s)

=== Misconfiguration: remove the firewall association ===========
association COMPLETE, mutation protection ENABLED
disassociate with protection on -> ValidationException: [RSLVR-02307] The DNS Firewall rule group association is under mutation protection. Remove the mutation protection and t
mutation protection switched off (0s)
DisassociateFirewallRuleGroup called
  [    0s] <random>.10.1.2.3.nip.io -> ['10.1.2.3']: recursion is back
  [   69s] association gone
  google.com TXT                       NOERROR TXT "MS=E4A68B9AB2BB9670BCE15412F62916164C0B20BB", TXT "arcules-domain-verification=2R4t5G7nI6tRCo61lpxxbLksPYstxhGmtV75cpr8x9K", TXT "google-site-verification=
  rqi4jk5zg.1.2.3.4.sslip.io A         NOERROR A 1.2.3.4
  curl https://example.com (now its real IP; the routes still block it): 000 FAIL rc=28

=== The EventBridge alarm =======================================
  2026-11-04T04:34:52Z  DisassociateFirewallRuleGroup        ValidationException
  2026-11-04T04:34:52Z  DisassociateFirewallRuleGroup        succeeded
  2026-11-04T04:34:52Z  UpdateFirewallRuleGroupAssociation   succeeded

=== Restore: terraform apply (the association, protection back on)
terraform apply: 70s
override back 70s after the apply started
new association: COMPLETE, mutation protection ENABLED

=== Resolver query log for the sandbox VPC: the firewall action on each query
31 records, 27 unique name/type pairs (the Resolver logs only what it didn't answer from cache)
A     ri8xq3isr.example.com.                   NOERROR  firewall=BLOCK answers=[CNAME:proxy.sandbox.internal.,A:10.50.11.10,A:10.50.10.10] via=UDP
A     api.github.com.                          NOERROR  firewall=BLOCK answers=[CNAME:proxy.sandbox.internal.,A:10.50.10.10,A:10.50.11.10] via=UDP
AAAA  ri8xq3isr.example.com.                   NOERROR  firewall=BLOCK answers=[CNAME:proxy.sandbox.internal.] via=UDP
A     r184ryt4v-2.example.com.                 NOERROR  firewall=BLOCK answers=[CNAME:proxy.sandbox.internal.,A:10.50.11.10,A:10.50.10.10] via=UDP
A     rt6xamdbb-10-1-2-3.nip.io.               NOERROR  firewall=BLOCK answers=[CNAME:proxy.sandbox.internal.,A:10.50.10.10,A:10.50.11.10] via=UDP
TXT   api.github.com.                          NOERROR  firewall=BLOCK answers=[CNAME:proxy.sandbox.internal.] via=UDP
TXT   google.com.                              NOERROR  firewall=BLOCK answers=[CNAME:proxy.sandbox.internal.] via=UDP
NS    rxyn2ba6i.example.com.                   NOERROR  firewall=BLOCK answers=[CNAME:proxy.sandbox.internal.] via=UDP
MX    rxyn2ba6i.example.com.                   NOERROR  firewall=BLOCK answers=[CNAME:proxy.sandbox.internal.] via=UDP
A     10-1-2-3.nip.io.                         NOERROR  firewall=BLOCK answers=[CNAME:proxy.sandbox.internal.,A:10.50.10.10,A:10.50.11.10] via=UDP
A     r184ryt4v-1.example.com.                 NOERROR  firewall=BLOCK answers=[CNAME:proxy.sandbox.internal.,A:10.50.11.10,A:10.50.10.10] via=UDP
MX    api.github.com.                          NOERROR  firewall=BLOCK answers=[CNAME:proxy.sandbox.internal.] via=UDP
A     r184ryt4v-tcp1.example.com.              NOERROR  firewall=BLOCK answers=[CNAME:proxy.sandbox.internal.,A:10.50.11.10,A:10.50.10.10] via=TCP
NS    api.github.com.                          NOERROR  firewall=BLOCK answers=[CNAME:proxy.sandbox.internal.] via=UDP
PTR   3.112.82.140.in-addr.arpa.               NOERROR  firewall=BLOCK answers=[CNAME:proxy.sandbox.internal.] via=UDP
A     rt6xamdbb.1.2.3.4.sslip.io.              NOERROR  firewall=BLOCK answers=[CNAME:proxy.sandbox.internal.,A:10.50.10.10,A:10.50.11.10] via=UDP
A     1.2.3.4.sslip.io.                        NOERROR  firewall=BLOCK answers=[CNAME:proxy.sandbox.internal.,A:10.50.10.10,A:10.50.11.10] via=UDP
TYPE65 api.github.com.                          NOERROR  firewall=BLOCK answers=[CNAME:proxy.sandbox.internal.] via=UDP
TXT   rxyn2ba6i.example.com.                   NOERROR  firewall=BLOCK answers=[CNAME:proxy.sandbox.internal.] via=UDP
A     r184ryt4v-0.example.com.                 NOERROR  firewall=BLOCK answers=[CNAME:proxy.sandbox.internal.,A:10.50.11.10,A:10.50.10.10] via=UDP
PTR   1.1.1.1.in-addr.arpa.                    NOERROR  firewall=BLOCK answers=[CNAME:proxy.sandbox.internal.] via=UDP
A     r184ryt4v-tcp0.example.com.              NOERROR  firewall=BLOCK answers=[CNAME:proxy.sandbox.internal.,A:10.50.11.10,A:10.50.10.10] via=TCP
TYPE65 rxyn2ba6i.example.com.                   NOERROR  firewall=BLOCK answers=[CNAME:proxy.sandbox.internal.] via=UDP
A     rt6xamdbb.10.1.2.3.nip.io.               NOERROR  firewall=BLOCK answers=[CNAME:proxy.sandbox.internal.,A:10.50.11.10,A:10.50.10.10] via=UDP
A     r184ryt4v-3.example.com.                 NOERROR  firewall=BLOCK answers=[CNAME:proxy.sandbox.internal.,A:10.50.10.10,A:10.50.11.10] via=UDP
firewall_rule_action counts: {'BLOCK': 31}

=== Checks ======================================================
PASS  dig: override CNAME to proxy.sandbox.internal  (CNAME proxy.sandbox.internal.)
PASS  dig: both NLB A records in the same answer
PASS  getent hosts ri8xq3isr.example.com: the NLB IPs only  (10.50.10.10 10.50.11.10)
PASS  python3 socket.getaddrinfo('api.github.com'): the NLB IPs only  (10.50.10.10 10.50.11.10)
PASS  node dns.lookup (getaddrinfo): the NLB IPs only  (10.50.10.10 10.50.11.10)
PASS  node dns.resolve4 (c-ares, its own resolver): the NLB IPs only  (10.50.10.10 10.50.11.10)
PASS  dig api.github.com A: override only  (NOERROR)
PASS  dig api.github.com AAAA: override only  (NOERROR)
PASS  dig api.github.com TXT: override only  (NOERROR)
PASS  dig api.github.com MX: override only  (NOERROR)
PASS  dig api.github.com TYPE65: override only  (NOERROR)
PASS  dig api.github.com NS: override only  (NOERROR)
PASS  dig <random>.example.com A: override only  (NOERROR)
PASS  dig <random>.example.com AAAA: override only  (NOERROR)
PASS  dig <random>.example.com TXT: override only  (NOERROR)
PASS  dig <random>.example.com MX: override only  (NOERROR)
PASS  dig <random>.example.com TYPE65: override only  (NOERROR)
PASS  dig <random>.example.com NS: override only  (NOERROR)
PASS  dig -x 1.1.1.1: override only  (NOERROR)
PASS  dig -x 140.82.112.3: override only  (NOERROR)
PASS  dig @10.51.0.2 <random>-0.example.com A: override only  (NOERROR)
PASS  dig @169.254.169.253 <random>-1.example.com A: override only  (NOERROR)
PASS  dig @127.0.0.2 <random>-2.example.com A: override only  (NOERROR)
PASS  dig @169.254.53.53 <random>-3.example.com A: override only  (NOERROR)
PASS  dig @10.51.0.2 google.com TXT: override only  (NOERROR)
PASS  dig @169.254.169.253 google.com TXT: override only  (NOERROR)
PASS  dig @127.0.0.2 google.com TXT: override only  (NOERROR)
PASS  dig @169.254.53.53 google.com TXT: override only  (NOERROR)
PASS  dig @10.51.0.2 +tcp <random>-tcp0.example.com A: override only  (NOERROR)
PASS  dig @169.254.169.253 +tcp <random>-tcp1.example.com A: override only  (NOERROR)
PASS  10-1-2-3.nip.io: the NLB IPs, not the embedded 10.1.2.3  (10.50.10.10, 10.50.11.10)
PASS  rt6xamdbb.10.1.2.3.nip.io: the NLB IPs, not the embedded 10.1.2.3  (10.50.10.10, 10.50.11.10)
PASS  rt6xamdbb-10-1-2-3.nip.io: the NLB IPs, not the embedded 10.1.2.3  (10.50.10.10, 10.50.11.10)
PASS  1.2.3.4.sslip.io: the NLB IPs, not the embedded 1.2.3.4  (10.50.10.10, 10.50.11.10)
PASS  rt6xamdbb.1.2.3.4.sslip.io: the NLB IPs, not the embedded 1.2.3.4  (10.50.10.10, 10.50.11.10)
PASS  google.com TXT: no real TXT data in the MicroVM  (MicroVM 0 TXT, this machine 17)
PASS  o-o.myaddr.l.google.com TXT: no real TXT data in the MicroVM  (MicroVM 0 TXT, this machine 1)
PASS  mutation protection refuses DisassociateFirewallRuleGroup  (ValidationException: [RSLVR-02307] The DNS Firewall rule group association is under mutation protection. Remove the mutation protection and t)
PASS  without the association, recursion returns (10.1.2.3.nip.io -> 10.1.2.3)  (after 0s)
PASS  the fence still blocks the real IP  (000 FAIL rc=28)
PASS  EventBridge alarm fired on the disassociation  (readable 81s after the call)
PASS  override restored by terraform apply  (70s)
PASS  the new association has mutation protection on  (ENABLED)
PASS  every logged query carries a firewall action  ({'BLOCK': 31})
44 passed, 0 failed

Com a mutation protection ligada, a chamada de remoção foi recusada (RSLVR-02307). Desligar a proteção exigiu mais uma chamada e foi imediato. Depois disso, a remoção funcionou, e a recursão voltou já no primeiro probe, embora a associação tenha levado 69 s para sumir da API: <random>.10.1.2.3.nip.io resolveu para 10.1.2.3, e os registros TXT reais do Google voltaram. As rotas continuaram bloqueando uma conexão ao endereço real. O alarme do EventBridge registrou a tentativa recusada, o desligamento e a remoção, legíveis no log group 81 s depois da chamada. Um terraform apply da associação levou 70 s, e o override estava de volta quando ele terminou, com a proteção ligada de novo.

Então remover a associação tem efeito imediato e exige duas chamadas deliberadas. Mudar as regras ou as domain lists do rule group exigiria uma, e a mutation protection não as cobre; eu não testei esse caminho. O alarme avisa que uma mudança aconteceu, cerca de um minuto depois; ele não fecha a lacuna, e o DNS continua sendo um canal de saída até que alguém coloque a associação de volta. Essas permissões devem ficar só com administradores.

Teste 12: Latência

O 14_latency.py envia o mesmo request (GET https://api.github.com/zen com o token placeholder) de três formas a partir de uma MicroVM, em 10 rodadas intercaladas depois de duas de aquecimento, cada uma com um curl novo e novos handshakes TCP e TLS: pelo override, com --resolve para pular o DNS e, para comparação, por um túnel CONNECT na 8080. Depois ele mede o tempo das consultas pelo override:

=== HTTP: median of 10 requests each (seconds; curl's cumulative timers)
variant                    dns  connect  tls done    ttfb   total  min-max total   codes
transparent             0.0004   0.0029    0.0374  0.1406  0.1407  0.133-0.164   ['200']
transparent, pinned     0.0000   0.0039    0.0370  0.1413  0.1414  0.129-0.157   ['200']
explicit (8080)         0.0000   0.0041    0.0397  0.1504  0.1505  0.138-0.166   ['200']

transparent - explicit: -9.8 ms median total; DNS share of transparent: 0.4 ms

=== DNS through the override ====================================
dig, random name (Resolver cache miss)   median 0.0 ms   [0, 0, 0, 10, 10, 0, 0, 10, 10, 0]
dig, api.github.com (repeated)            median 0.0 ms   [0, 0, 0, 0, 0, 0, 0, 0, 0, 0]
getaddrinfo, random name (A + AAAA)       median 4.9 ms   [6.77, 5.16, 4.74, 3.89, 4.26, 4.92, 4.95, 4.88, 5.04, 4.58]
getaddrinfo, api.github.com (repeated)    median 0.06 ms   [0.09, 0.07, 0.07, 0.06, 0.06, 0.06, 0.06, 0.06, 0.06, 0.06]

4 passed, 0 failed

O modo transparente não custa nada mensurável: 141 ms de mediana, contra 150 ms por um túnel CONNECT, uma diferença dentro da variação entre execuções. O DNS respondeu por 0,4 ms disso. Pelo getaddrinfo, que pede A e AAAA, a consulta de um nome novo levou 4,9 ms de mediana, e a de um nome repetido, 0,06 ms; o dig reportou 0 ou 10 ms.

O que o iron-proxy não resolve

  • Tenants. O proxy não consegue distinguir uma MicroVM da outra (todo request vem dos endereços do NLB), e os placeholders não são segredo. Todo sandbox que alcança um proxy pode usar todas as credenciais dele, e o log de auditoria não consegue dizer qual sandbox fez isso. Um proxy por tenant é o único isolamento disponível hoje; identidade por sandbox no proxy é trabalho futuro.
  • Exfiltração para hosts permitidos. Qualquer coisa que o agente consiga ler, ele consegue postar em uma API permitida: o httpbin aqui, um gist ou uma issue no GitHub na vida real. Os segredos reais estão seguros porque nunca entram na VM, mas os dados e todo o resto que está na VM (como as credenciais de uma execution role) não estão. As regras de path reduzem isso agora que funcionam, como no Teste 10, mas só para os hosts para os quais você as escreve.
  • Revogação no proxy. Um segredo em cache continua sendo injetado depois que o proxy perde o acesso a ele, e depois de um reinício o proxy encaminha o placeholder em vez de falhar. Revogue as credenciais na origem. O control plane opcional da parte 3 revoga no proxy com um statement de deny e um reload da configuração em vez de um reinício, o que tem efeito em cerca de 30 s.
  • HTTP puro. Os segredos também são trocados em requests http://, então o valor real pode atravessar a internet sem criptografia se um agente pedir isso.
  • Uploads para a AWS e chaves complicadas. Os uploads chunked da CLI são rejeitados a menos que você permita corpos chunked ou payloads não assinados, e chaves de objeto que precisam de URL encoding não são reassinadas corretamente na 0.55.0 (issue #220 do iron-proxy, fechada sem uma correção mergeada; o pull request #256 continua aberto).
  • CONNECT. Se você não puder usar interceptação transparente, as regras de path e o require recusam todo túnel na 0.55.0, então uma configuração com HTTPS_PROXY fica só com policy por host.
  • Operação. É um projeto pre-1.0, com releases a cada uma ou duas semanas ultimamente, depois de uma pausa de dois meses no verão, e com um mantenedor principal; as imagens não são assinadas (fixe por digest), e uma única task do Fargate é um ponto único de falha para todos os sandboxes atrás dela. O DNS deve continuar respondendo se a task cair (não testado), mas nada passa.

Preços

A camada do proxy é infraestrutura fixa, que roda haja ou não algum sandbox rodando (preços de tabela em us-east-1):

Recurso Tarifa Por hora
NAT gatewayUS$ 0,045 / h + US$ 0,045 / GB processadoUS$ 0,045
Network Load BalancerUS$ 0,0225 / h + unidades de capacidadeUS$ 0,0225
Fargate, ARM, 0,5 vCPU / 1 GBUS$ 0,03238 / vCPU-h, US$ 0,00356 / GB-hUS$ 0,020
IPv4 público (NAT gateway)US$ 0,005 / hUS$ 0,005
Secrets Manager (4 secrets)US$ 0,40 / segredo-mês + chamadas de APIUS$ 0,002
Zona hospedada privada do Route 53US$ 0,50 / mêsUS$ 0,0007
VPC peeringsem cobrança por hora; US$ 0,01 / GB em cada direção entre AZsUS$ 0
Total fixo≈ US$ 0,095 / h, ≈ US$ 69 / mês

A segunda VPC não custa nada por si só, então a divisão acrescenta à linha fixa apenas a zona privada. Além disso, por uso: as MicroVMs nas tarifas da parte 1, o DNS Firewall a US$ 0,60 por milhão de queries (as duas domain lists de uma entrada cada custam uma fração de centavo por mês), o CloudWatch Logs para a trilha de auditoria e o query log, os dados que passam pelo NAT gateway e os dados entre AZs (pelo peering, e entre o NLB, a task e o NAT gateway). Para um desenvolvedor, isso é basicamente a linha fixa. Para uma frota, a cobrança por GB do NAT gateway é a que merece atenção, já que todo byte que os agentes buscam passa por ele; o DNS Firewall precisaria de um milhão de consultas para custar 60 centavos.

Limpeza

python 13_cleanup.py      # terminate this repo's MicroVMs, delete the image (it bills snapshot storage)
scripts/destroy.sh        # switch off mutation protection, then terraform destroy (about 5 minutes on a twin stack)

O 13_cleanup.py vem primeiro, porque o connector não pode ser deletado enquanto há MicroVMs usando ele, e a imagem não é gerenciada pelo Terraform. Um terraform destroy simples falha na associação protegida do firewall, então o scripts/destroy.sh desliga a proteção antes (o alarme também registra isso).

Veredito

A versão com duas VPCs é a que eu construiria. A versão com uma única VPC funcionou, mas dependia de todo cliente respeitar o HTTPS_PROXY, abria mão das regras de path do iron-proxy e precisava de uma allowlist de DNS compartilhada com a própria infraestrutura do proxy. Mover os sandboxes para uma VPC sem rota para a internet, com um DNS que só conhece o proxy, resolveu os três problemas a praticamente o mesmo custo e sem mudar o iron-proxy. Claude Code, git, gh, a AWS CLI e clientes que ignoram configurações de proxy funcionaram sem nada configurado, e um agente abriu um pull request real sem nada secreto na VM dele.

O que funciona

  • A cerca. Nenhuma rota para a internet, duas rotas para o NLB, três portas; todos os outros probes deram timeout.
  • Nada para configurar no sandbox. Todo nome resolve para o proxy, então todo cliente HTTP passa por ele, inclusive os que ignoram configurações de proxy.
  • DNS como canal fechado. Nada foi resolvido de forma recursiva em nenhum dos sete tipos de registro nem dos quatro endereços de resolver testados, e não há domain list para manter.
  • Injeção. Placeholders trocados por host, em headers, query string ou corpo, com uma linha de auditoria que nomeia o segredo e onde ele foi encontrado.
  • AWS sem credenciais da AWS. O aws_auth reassina com a role do proxy e aplica a restrição de serviços e regiões.
  • Rotação. Um valor novo no Secrets Manager passa a ser usado em cerca de 30 s (32,4 s aqui), até por uma MicroVM que estava suspensa no momento.
  • Regras de path e require, sem um CONNECT no caminho.
  • Nenhuma penalidade pelo modo transparente. Ficou dentro do ruído de um túnel CONNECT, e uma consulta pelo override levou milissegundos.

O que não funciona

  • Nenhum isolamento de tenants neste build. Toda MicroVM que alcança o proxy compartilha as credenciais dele, e o log não consegue dizer qual delas agiu.
  • O controle de DNS depende de algumas configurações do Resolver. A mutation protection protege a associação, não as regras; o alarme detecta mudanças nas duas, mas alguém com as permissões ainda consegue fazê-las, e a recursão volta na hora.
  • Falhas lentas e silenciosas. Tráfego não HTTP dá timeout em vez de ser recusado, e um host negado recebe um 403 com corpo vazio e exit code 0 no curl.
  • Revogação e falha. Segredos em cache sobrevivem ao acesso revogado, e um segredo ausente leva ao encaminhamento do placeholder em vez de uma falha.
  • A exfiltração para hosts permitidos continua aberta, para dados e para qualquer coisa que já esteja na VM.
  • Arestas por aparar. Trocas em HTTP puro, chaves do S3 que precisam de encoding, uploads chunked desligados por padrão, imagens não assinadas, um mantenedor principal e uma única task do Fargate.

Quem deve usar

Uma pessoa ou um time rodando agentes em Lambda MicroVMs que queira as chaves fora do sandbox, um log do que o agente tocou e uma policy que se sustente quer as ferramentas do agente respeitem ou não as configurações de proxy, e que consiga operar um pequeno serviço no Fargate e um punhado de recursos do Route 53. Se você precisa de vários tenants, dê a cada um o seu próprio proxy, ou espere pela autenticação no proxy. A parte 3 constrói um workspace no navegador sobre este mesmo proxy.

Comments