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_addressesda caixa são proprietários. Todos os outros do domínio da sua empresa sãoexternal, 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 éunauthenticatedoufailed, 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ão409 held_by_screening;503 screening_unavailableenquanto 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çãonot_allowlistedde um remetente verificado e só para proprietários, administradores, desenvolvedores e chaves de equipe de acesso total (senão403 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 comoscreening_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.textsem caracteres invisíveis.screening.hidden_text_removed: truequando 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.
Códigos de verificação e links de acesso
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:
- Identidade. Uma chave restrita a uma caixa envia só do endereço da caixa (
403 restricted_api_key;550 5.7.1por SMTP). - 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. - Limite diário.
send_capdestinatá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:
- Proteção contra loops. Responder a e-mail automático (
loop_guard:e o motivo): um remetente vazio, um cabeçalhoAuto-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 levamAuto-Submitted: auto-replied, então dois agentes escrevendo um para o outro param após uma rodada. - Reply-To. Uma resposta a um
Reply-Tode 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). - 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). - Códigos privados (
private_code), como acima. - 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). - Aprovação.
require_approvalna caixa, ourequires_approval: truena 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ãohtml, e conferirscreening.sender_trustescreening.verdictantes de agir. - Nunca seguir links de e-mails por conta própria; usar
codes/latestouget_verification_code. - Manter
require_approvalligado, ou passarrequires_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.