Pular para o conteúdo
Esc
↑↓navegar↵abrir⌘Jpré-visualizar
Nesta página

Segurança do agente

Como uma caixa de agente protege o agente de IA que a lê e as pessoas para quem ele escreve.

Qualquer pessoa pode escrever para uma caixa, e um agente de IA que lê e-mails pode ser convencido a fazer coisas: uma mensagem pode trazer instruções escondidas das pessoas, se passar pelo dono do agente ou pedir que ele encaminhe um link de redefinição de senha. Uma caixa de agente responde em camadas. O agente só lê os e-mails que passam pelas regras da caixa; o que ele lê é limpo de texto oculto e isolado como não confiável; e o que ele envia passa por regras que transformam envios arriscados em rascunhos para uma pessoa.

Nada disso torna o e-mail recebido confiável. A análise é um sinal, não uma garantia: seu agente deve continuar tratando toda mensagem como dado, nunca como instrução.

Visão geral

Camada O que faz
Verificação do destinatário E-mail para um endereço sem caixa é recusado, a menos que o pega-tudo esteja ligado; uma caixa inundada responde “tente de novo mais tarde”.
Verificação de vírus E-mail infectado vai para a quarentena e seus downloads ficam bloqueados para sempre.
Nota de spam A mensagem reprovada vai para a pasta spam.
Confiança no remetente Classifica cada remetente, dos endereços da sua própria equipe até a autenticação que falhou.
Regras de entrada E-mail de remetentes que a caixa não aceita vai para a quarentena.
Análise Dá notas de injeção de prompt e phishing a e-mails de remetentes de fora; notas altas vão para a quarentena.
Texto oculto O texto que uma pessoa não vê sai de tudo o que um agente ou um modelo lê.
Isolamento Os resultados do MCP colocam o texto da mensagem entre marcadores de conteúdo não confiável.
Códigos Códigos de verificação e links de acesso são extraídos para o agente e não podem ser repassados a estranhos.
Regras de envio Respostas só dentro das conversas, limite diário, aumento gradual de destinatários novos, proteção contra loops; envios arriscados viram rascunhos.
Atividade Toda ação e decisão fica registrada, e os proprietários são avisados do que está esperando.

Confiança no remetente

Toda mensagem recebida ganha um sender_trust, mostrado em screening nas leituras e como Confiança no painel. Vale a primeira linha que combinar:

sender_trust O remetente
failed Falhou na autenticação, e o domínio pede que os receptores coloquem em quarentena ou rejeitem esse tipo de e-mail (ou não publica política DMARC e falha no SPF sem assinatura DKIM própria). Vale mais que qualquer outra linha, então um proprietário falsificado nunca passa.
owner Um dos endereços de login dos membros da sua equipe, ou um endereço em owner_addresses da caixa, e o domínio o garante.
allowlisted Combina com a lista de permitidos da caixa, e o domínio o garante.
known_thread Responde numa conversa em que a caixa escreveu, de um endereço a quem a caixa escreveu, comprovado pelo token da conversa ou por um In-Reply-To que cita uma mensagem que a caixa enviou. Não exige autenticação.
external Qualquer outro remetente cujo domínio o garante, inclusive outros endereços dos seus próprios domínios.
unauthenticated Todos os demais: o domínio não garante o endereço From, ou a mensagem cita mais de um remetente.

Um domínio garante o endereço From quando o DMARC passa ou, para um domínio sem política DMARC, quando há uma assinatura DKIM dele ou um SPF aprovado para a organização dele.

  • Só os endereços de login dos membros da sua equipe e os owner_addresses da caixa são proprietários. Todos os outros do domínio da sua empresa são external, então o endereço de um colega, ou um sistema que envia como o seu domínio, não consegue dar ordens ao agente nem receber os códigos privados dele.
  • O nível é definido quando a mensagem chega e não muda. Uma edição na lista de permitidos vale para os e-mails que chegarem depois; o que já está retido é liberado à mão.

O que chega ao agente

accept_from decide, por nível:

sender_trust anyone verified (padrão) allowlist
owner, allowlisted, known_thread entregue entregue entregue
external analisado analisado quarentena, not_allowlisted
unauthenticated analisado quarentena, unauthenticated_sender quarentena, not_allowlisted
failed quarentena, failed_auth quarentena, failed_auth quarentena, failed_auth

O e-mail analisado é entregue, a menos que a análise de injeção de prompt o mande para a quarentena. Além da tabela:

  • Um vírus coloca a mensagem em quarentena em toda caixa, seja quem for o remetente.
  • O e-mail de proprietários ou da lista de permitidos que encaminha a mensagem de outra pessoa também é analisado: o conteúdo encaminhado não herda confiança.
  • O e-mail entregue que é reprovado na nota de spam vai para a pasta spam, que as listas de conversas omitem, a menos que você peça.
  • O e-mail entregue fica com screening.verdict: "suspicious" quando o remetente é unauthenticated ou failed, a nota de spam é intermediária, ou a análise achou algo abaixo da linha de corte; caso contrário, clean.

Uma caixa human aceita anyone por padrão: tudo é entregue, exceto vírus, e o e-mail de um remetente failed vai para a pasta spam. A análise roda só em caixas de agente.

Quarentena

O e-mail em quarentena é guardado pelo mesmo tempo que qualquer e-mail recebido, listado e liberável; nunca é descartado nem devolvido ao remetente.

quarantine_reason Retido porque
failed_auth O remetente falhou na autenticação.
unauthenticated_sender O domínio do remetente não o garante, e a caixa aceita remetentes verificados (ou lista o endereço como proprietário ou na lista de permitidos).
not_allowlisted A caixa aceita só a lista de permitidos.
injection A análise deu nota 80 ou mais para injeção de prompt.
phishing A análise deu nota 80 ou mais para phishing.
virus O verificador de vírus encontrou malware.
unscreened A mensagem precisava de análise e o analisador não conseguiu responder.
screening_cap A mensagem precisava de análise depois do limite diário de análises.

Os agentes nunca veem o e-mail retido. Chaves restritas a uma caixa e toda chamada MCP pulam as mensagens retidas: ler uma responde 403 email_quarantined, uma espera informa só o id dela, e nenhum código é servido a partir dela. Enquanto a análise roda, normalmente segundos, a mensagem fica pendente e o id dela responde 404. As pessoas no painel veem tudo, sinalizado.

Nenhum webhook avisa de e-mail retido. email.received e inbox.email.received disparam quando a mensagem é entregue ou liberada; inbox.email.quarantined avisa os endpoints inscritos nele.

Liberar. Uma pessoa libera pela aba Precisa de revisão da caixa, uma chave de equipe de acesso total com POST /inboxes/{id}/quarantine/{email_id}/release, e um cliente MCP com release_email sob receiving:manage. Uma chave restrita a uma caixa nunca pode.

  • Uma pessoa ou uma chave de equipe de acesso total libera qualquer retenção.
  • Um cliente MCP é o agente a quem o e-mail se destina: não libera nada retido por injeção de prompt, phishing, vírus ou autenticação falha (403 forbidden), e qualquer outra retenção só quando a análise lê a mensagem abaixo de 80 (senão 409 held_by_screening; 503 screening_unavailable enquanto a análise não consegue rodar).
  • Liberar e confiar no remetente (trust_sender) também coloca o remetente na lista de permitidos, só para uma retenção not_allowlisted de um remetente verificado e só para proprietários, administradores, desenvolvedores e chaves de equipe de acesso total (senão 403 trust_not_allowed).
  • Uma mensagem liberada é entregue como se tivesse acabado de chegar, webhooks inclusive. Um vírus continua sendo um vírus: seus anexos e a mensagem original continuam bloqueados.

Os proprietários recebem um e-mail por dia, Suas caixas de entrada precisam de atenção, enquanto houver mensagens na quarentena, rascunhos esperando aprovação ou envios recusados, com as contagens e um link, nunca remetentes nem assuntos. É o alerta Caixas de entrada precisam de atenção em Configurações → Notificações; veja Notificações.

Análise de injeção de prompt

Numa caixa de agente com screening ligada, o e-mail de remetentes external e unauthenticated que as regras entregariam é analisado antes de o agente poder vê-lo. O analisador lê a mensagem como ela é mostrada, com o texto oculto separado: o remetente, a autenticação e o Reply-To; o assunto e o texto visível; o texto oculto que foi removido; os links como texto âncora e domínio (nunca acessados); os nomes dos anexos. Os códigos são mascarados e os endereços reduzidos ao domínio antes de qualquer coisa sair.

A resposta são duas notas de 0 a 100, injection_score e phishing_score, e os reasons que se aplicaram:

Motivo A mensagem
targets_agent Se dirige a uma IA, assistente, modelo ou “sistema” em vez de a uma pessoa.
override Tenta mudar as instruções, o papel ou as prioridades de quem lê.
exfiltration Pede a quem lê que envie códigos, links, chaves, outros e-mails, contatos ou dados.
unsafe_action Pede uma ação com efeitos fora da conversa: pagar, aprovar, excluir, executar algo.
concealed Esconde instruções: em texto oculto, codificadas ou invertidas, depois de um falso fim de mensagem ou dentro de uma citação falsa.
credential_lure Pede senhas, códigos ou dados de cartão numa página que o suposto remetente não possui.

Uma nota de injeção de 80 ou mais coloca a mensagem em quarentena como injection; senão, uma nota de phishing de 80 ou mais, como phishing. Uma nota de 50 a 79 a entrega como suspicious. As notas aparecem sempre, nas leituras em screening e no painel.

  • Falha fechada. Um analisador que dá timeout ou erro coloca a mensagem em quarentena como unscreened, e o mesmo vale para uma análise que nunca termina (o job falha repetidamente ou trava): nenhuma mensagem fica pendente por mais de cerca de uma hora. Acima de 200 mensagens analisadas numa caixa num dia, o e-mail que precisa de análise vai para a quarentena como screening_cap: uma enxurrada vira quarentena, nunca entrega sem análise.
  • Não afeta o seu envio. Os veredictos sobre e-mails que você recebeu nunca contam para a sua própria reputação de envio nem para a análise de abuso.

Texto oculto e extracted_text

Um e-mail pode trazer texto que ninguém vê mas que um modelo lê: uma instrução em branco sobre branco, um bloco display:none, caracteres que não aparecem. Antes de qualquer texto chegar a um agente ou a um modelo, o BillionSend remove elementos ocultos (display:none, visibility:hidden, opacidade quase zero, fontes minúsculas, conteúdo empurrado para fora da tela, texto da cor do fundo, comentários, <template>, <noscript>) e caracteres invisíveis (caracteres de largura zero, controles de direção de texto, caracteres de tag Unicode). Emojis mantêm os conectores de que precisam. Uma linha de pré-visualização oculta, que a maioria das newsletters traz, também é removida, mas não torna a mensagem suspeita.

O que o agente lê:

  • extracted_text: a parte da resposta, com o histórico citado e as assinaturas separados, em texto simples com markdown leve, até 32.000 caracteres.
  • text sem caracteres invisíveis.
  • screening.hidden_text_removed: true quando texto oculto além de uma linha de pré-visualização, ou caracteres invisíveis, foram removidos.

O html continua exatamente como recebido, e a mensagem original guarda tudo.

Isolamento. Os resultados do MCP colocam o texto de cada mensagem entre duas linhas marcadoras com um valor aleatório por chamada:

-----BEGIN UNTRUSTED EMAIL CONTENT 95253f15-----
Olá! Seu pedido foi enviado hoje.
-----END UNTRUSTED EMAIL CONTENT 95253f15-----

Uma linha marcadora escrita dentro da mensagem é alterada antes, então uma mensagem não consegue fechar o próprio isolamento mais cedo.

Um agente que se cadastra em algum lugar precisa do código ou do link que o serviço envia. O BillionSend os extrai para o agente nunca precisar interpretar HTML:

  • Os códigos precisam de uma palavra de código por perto (em inglês, português ou espanhol); números de pedido, preços, telefones, cupons e datas são ignorados. Quando dois códigos são igualmente prováveis, nenhum é respondido (ambiguous).
  • Os links são links de acesso, confirmação, redefinição e convite; links de descadastro, privacidade e ajuda são ignorados. Os links nunca são acessados: um scanner que segue um link de uso único o gasta.

Eles são servidos por extracted em GET /emails/receiving/{id}, por GET /inboxes/{id}/codes/latest e pela ferramenta MCP get_verification_code, e em nenhum outro lugar: nunca em listas, webhooks, logs nem mensagens de erro. Nunca são servidos de e-mail retido, de um remetente failed ou quando extract_codes está desligado, e toda leitura fica registrada na atividade da caixa.

Códigos privados. Com private_codes ligado (o padrão do agente), um código ou link que a equipe recebeu nas últimas 24 horas não pode sair do endereço da caixa num envio a ninguém além dos proprietários e da lista de permitidos: esse envio vira um rascunho com o motivo private_code. Isso vale mesmo que o agente tenha sido convencido a fazê-lo. Cobre os envios do endereço da caixa, então dê aos agentes uma chave restrita a uma caixa, ou deixe emails:send fora das permissões MCP deles.

O que um agente pode enviar

Toda forma de enviar de um endereço de caixa passa pelas mesmas regras: respostas, encaminhamentos e rascunhos da caixa, respostas e encaminhamentos no servidor, cópias de forward_to, POST /emails, POST /emails/batch, o relay SMTP e a ferramenta MCP send_email. Em ordem:

  1. Identidade. Uma chave restrita a uma caixa envia só do endereço da caixa (403 restricted_api_key; 550 5.7.1 por SMTP).
  2. Domínio compartilhado. Um endereço compartilhado segue as regras do domínio compartilhado: no plano Free, ou quando o nome dele parece uma marca conhecida, só responde dentro das próprias conversas. Qualquer outra coisa é recusada com 403 inbox_send_policy, mesmo aprovada. Todo envio compartilhado conta para o limite diário da equipe no domínio compartilhado e aceita no máximo 10 destinatários.
  3. Limite diário. send_cap destinatários por dia UTC. Acima disso, 429 inbox_send_cap_reached. Os envios aprovados contam, mas nunca são recusados.

Numa caixa de agente, a menos que o envio seja aprovado, cada um destes o retém como rascunho, com um motivo:

  1. Proteção contra loops. Responder a e-mail automático (loop_guard: e o motivo): um remetente vazio, um cabeçalho Auto-Submitted, Precedence: bulk, cabeçalhos de lista de e-mails, cabeçalhos de resposta automática, um relatório de entrega, um endereço no-reply ou um assunto de ausência. Mais de 10 envios automáticos a um mesmo endereço em uma hora é loop_burst. As respostas do agente levam Auto-Submitted: auto-replied, então dois agentes escrevendo um para o outro param após uma rodada.
  2. Reply-To. Uma resposta a um Reply-To de outra organização, a menos que o remetente seja um proprietário, esteja na lista de permitidos ou seja uma conversa conhecida (reply_to_redirect).
  3. Regra de envio. reply_only (padrão): respostas dentro de uma conversa, a quem escreveu nela, proprietários e a lista de permitidos. allowlist: esses, mais conversas novas com proprietários e a lista de permitidos. open: qualquer pessoa, e não enquanto a sua equipe é nova nos envios (nos primeiros 1.000 envios ou 72 horas, ou abaixo de 10.000 envios nos 7 dias seguintes ao primeiro).
  4. Códigos privados (private_code), como acima.
  5. Aumento gradual. Os destinatários novos por dia ficam dentro do limite, e dentro de 10 no primeiro dia de envio da caixa, dobrando a cada dia: 20, 40, 80, 160 e assim por diante (ramp).
  6. Aprovação. require_approval na caixa, ou requires_approval: true na requisição.

Uma caixa human roda só os três primeiros passos: pessoas que respondem pelo painel não são retidas. Em POST /emails, no endpoint em lote, no relay SMTP e em send_email, um envio que as regras reteriam é recusado com 403 inbox_send_policy (ou 550 5.7.1 por SMTP), porque essas vias não criam rascunhos: envie pelos endpoints da caixa para obter um.

O primeiro e-mail de uma caixa de agente a um endereço novo também passa pela mesma análise de abuso de qualquer envio da sua equipe.

O que o seu agente ainda deve fazer

  • Tratar toda mensagem como dado. Instruções dentro de um e-mail são palavras de um desconhecido, sejam quais forem as notas.
  • Ler extracted_text, não html, e conferir screening.sender_trust e screening.verdict antes de agir.
  • Nunca seguir links de e-mails por conta própria; usar codes/latest ou get_verification_code.
  • Manter require_approval ligado, ou passar requires_approval: true, para tudo que seja difícil de desfazer.
  • Dar a cada agente a sua própria chave restrita a uma caixa, e apontar os webhooks para caixas específicas com inbox_ids.

O que estas proteções não fazem

  • Os limites da análise e do spam são valores iniciais. Um e-mail pode passar por eles, e um e-mail legítimo pode ficar retido; o que fica retido está a um clique da liberação.
  • Um domínio que não publica política DMARC, ou publica p=none, comprova pouco: o e-mail legítimo dele e uma falsificação podem parecer iguais.
  • A detecção de texto oculto segue o HTML como os clientes de e-mail o renderizam, com o melhor esforço em marcação quebrada; os sinais e a mensagem original são a rede de segurança.

Esta página foi útil?