AI Swarm Pentest

Um engagement autorizado e com escopo definido

O AI Swarm Pentest é a etapa Validar do Proof-Driven AppSec. Antes de o Plexicus ajudar você a entender uma fraqueza no código (Deep Code Analysis, módulo 5) ou a corrigi-la (Remediation, módulo 7), ele mostra quais caminhos de ataque são reais em uma aplicação em execução. No produto, o AI Swarm Pentest aparece como AI Pentest, na sua própria entrada Pentest da barra lateral.

Um pentest envia tráfego real para um sistema real, então tudo começa pela autorização.

Regras de atuação

Um AI Swarm Pentest cobre uma aplicação, API, código-fonte ou ambiente de testes autorizados. Antes de o trabalho começar, o alvo, o acesso de teste e as regras de atuação são acordados por escrito, e o Plexicus não atua fora desse escopo. Na prática, suas regras de atuação respondem a quatro perguntas:

O que está no escopo: a URL exata da aplicação ou o domínio, e qual ambiente (staging ou produção).
Que acesso de teste você fornece, se houver: nenhum, uma conta de teste dedicada, ou chaves de API ou headers de teste (a aula 4 explica por que você não deve presumir que eles serão usados).
O que está fora dos limites: por exemplo, excluir contas, enviar e-mail ou SMS, ou capturar pagamentos.
Quem decide o que acontece com os resultados.

Quando a sua equipe executa o AI Pentest na plataforma, é ela que redige e aprova essas regras internamente. O assistente registra parte delas: o alvo, as configurações de autenticação, os itens fora do escopo e o briefing.

O que ele é, e o que não é

O AI Swarm Pentest usa verificações de IA coordenadas que mapeiam a sua aplicação, formulam hipóteses, testam caminhos de ataque e anexam evidências ao que encontram. Ele automatiza a exploração, a correlação e a reprodução repetitivas. Sua equipe mantém o contexto, a supervisão e a decisão final.

Ele não é:

um scanner de assinaturas que busca correspondências com padrões conhecidos,
um chatbot de segurança que sugere respostas,
uma verificação executada sem um escopo assinado,
um pentest humano clássico, presencial, de vários dias,
uma lista interminável de “possíveis problemas” sem priorização,
uma ferramenta que altera a produção automaticamente.

Se nada puder ser confirmado, os resultados não são inflados com alertas teóricos. O Plexicus não promete zero vulnerabilidades. Ele promete que tudo o que é apresentado como verificado pode ser demonstrado.

Os quatro guardrails

Os quatro guardrails do módulo 1 (escopo acordado por escrito, evidência rastreável, limites do engagement e decisão humana) se aplicam a cada execução. Na prática, o assistente os aplica assim:

O assistente passa ao agente um escopo restrito: o host da própria URL alvo, sem domínios extras, nas portas 80 e 443, além de qualquer porta escrita na URL. Destructive actions já vem pré-selecionado como fora do escopo na última etapa do assistente. Cada item fora do escopo que você seleciona chega ao agente como uma instrução escrita para não executá-lo. É uma instrução, não um bloqueio técnico, então combine-a com um alvo de staging e meios de pagamento de teste. Todas as profundidades, inclusive Quick, enviam requisições reais ao alvo.

Como o enxame funciona

Um scanner de assinaturas compara a sua aplicação com padrões conhecidos e diz onde procurar. Um chatbot de segurança responde a perguntas com base no contexto que você fornece. O AI Swarm Pentest não faz nenhuma das duas coisas. Ele explora caminhos, testa hipóteses e anexa evidências, para que você possa priorizar o que merece atenção.

O trabalho é dividido entre verificações de IA coordenadas. Elas mapeiam a superfície, formulam hipóteses e testam caminhos de ataque dentro do escopo acordado, e uma segunda rodada confirma cada achado de forma independente antes que ele seja marcado como verificado. No produto, o agente de pentest do Plexicus roda contra a sua URL alvo, guiado pelo briefing que você escreve no assistente (aula 4). Modos de scan mais profundos permitem execuções mais longas e mais esforço do agente. Enquanto uma execução está ativa, o War room (live board) na página da execução mostra a atividade do enxame.

Do sinal ao achado verificado

O engagement foi pensado para que uma única verificação nunca baste para considerar algo verificado. Um resultado passa por três estágios:

Achado candidato. Uma hipótese produz um sinal com contexto técnico.
Verificação independente. Uma segunda rodada tenta confirmar, por conta própria, o comportamento observado.
Achado verificado. Só um resultado confirmado é apresentado como verificado, com o seu impacto e uma prioridade baseada no risco real (severidade mais contexto), e não na ordem de chegada.

Pelo padrão de evidência, um resultado que uma segunda rodada não consegue reproduzir não é apresentado como achado verificado. Ele é marcado como não verificado ou descartado. Essa é a regra do módulo 1: sem prova reproduzível, não há achado verificado.

No produto, o selo Unverified na lista de Pentest se refere à propriedade do alvo (aula 3), não aos achados. Não o interprete como um veredito sobre nenhum achado.

O que isso significa ao ler os resultados

Esse design tem duas consequências práticas.

Poucos achados são um resultado, não uma falha. Uma execução que para porque atingiu o limite de tempo ou o orçamento de IA também é marcada como Completed. Uma execução Completed com poucos achados, ou nenhum, mostra o que o enxame conseguiu e não conseguiu confirmar nessa janela. Ela não prova que o alvo foi testado de forma exaustiva. Dê mais direção à próxima execução: um scan mais profundo, áreas de foco específicas, um briefing mais claro.

A revisão humana continua valendo. Os achados de pentest passam pela mesma validação por IA que os outros achados do Plexicus, incluindo o veredito da IA e a análise de falsos positivos vistos nos módulos 4 e 5. Se você discordar de um veredito, use Mark as false positive. A ação não pede justificativa por escrito, então registre o seu raciocínio no ticket ou nas anotações da equipe. Nada chega à produção sem uma decisão da sua equipe.

Se a sua organização configurou o próprio provedor de IA, o agente de pentest usa esse provedor. Caso contrário, usa um modelo gerenciado pela Plexicus. O código dos clientes não é usado para treinar modelos de IA.

Como provar que você é dono do alvo

Antes de o agente enviar uma única requisição, o Plexicus exige a prova de que você controla o alvo. Launch AI Pentest fica desativado até a propriedade ser verificada, e o servidor rejeita alvos sem prova mesmo que alguém contorne a interface.

Por que aceitar os termos não é prova

Aceitar os termos de serviço é uma declaração, não uma evidência. Qualquer pessoa pode aceitar termos para um domínio que não controla, então o Plexicus não trata isso como autorização. Como o agente envia tráfego real que pode alterar o estado do alvo, o Plexicus só aceita provas que exigem que você altere algo no próprio alvo: um token no HTML dele, em um arquivo que ele serve ou no DNS dele.

Dois escopos, três métodos

Na etapa Verify ownership do assistente, você escolhe um escopo:

Escopo	Método	Cobre	Indicado para
Verify this application	Meta tag HTML ou um arquivo em /.well-known/	Apenas aquele host exato	Uma aplicação, o caminho mais rápido
Verify the whole domain	Registro DNS TXT	O domínio e todos os subdomínios, atuais e futuros	Equipes que testam muitas aplicações em um mesmo domínio

A verificação feita no disparo aceita qualquer uma das duas provas. Um domínio verificado cobre o próprio domínio e todos os seus subdomínios. Uma aplicação verificada cobre aquele host exato.

A opção Verify this application

O assistente mostra um Verification token. Publique-o de uma destas duas formas. Adicione esta meta tag à página alvo, copiada exatamente como aparece, com name antes de content:

<meta name="plexicus-site-verification" content="YOUR-TOKEN">

Ou sirva um arquivo em /.well-known/plexicus-verification.txt contendo o token. Depois, clique em Recheck. O Plexicus verifica as duas opções automaticamente: primeiro o arquivo na origem do site, depois a meta tag na URL alvo exata. Lembre-se de três regras:

A resposta precisa ser HTTP 200.
Redirecionamentos não são seguidos, então uma página que redireciona para uma tela de login não passa na verificação.
Cada requisição expira após 10 segundos.

Quando a verificação passa, o status mostra “Ownership verified · HTML meta tag or file”.

A opção Verify the whole domain

Escolha Verify the whole domain e o assistente mostra um Host e um TXT record value, um token que começa com verif-. O assistente propõe o domínio pai do seu alvo: para app.example.com, é example.com. Confira o Host antes de publicar qualquer coisa. Não é possível editá-lo, e o assistente sempre propõe os dois últimos rótulos do host. Se isso estiver errado (por exemplo, co.uk para shop.example.co.uk), use Verify this application no lugar. Caso contrário, adicione o registro TXT no seu provedor de DNS, aguarde a propagação e clique em Recheck. Se o registro ainda não estiver visível, você verá “Verification token not found yet — DNS changes can take time to propagate”.

Quando o selo e o disparo não batem

A coluna Verification da lista de Pentest só reconhece um domínio verificado para o host alvo exato. Um alvo coberto pela verificação da aplicação, ou por um domínio pai verificado, pode aparecer como Unverified. A linha dele pode então oferecer Verify first em vez de View Findings, Rescan ou Run. Quem decide de fato é a verificação feita no disparo. Se isso acontecer, abra os achados em Findings App Pentest e, para testar de novo, inicie um New AI Pentest para a mesma URL.

Se uma execução for recusada por falta de prova de propriedade, a mensagem diz “Target URL is not verified. Please verify this application or the whole domain under Settings → Domain Verification.” No menu de configurações, essa página se chama Ownership Verification.

Como executar uma avaliação

Uma avaliação é uma definição de pentest salva (nome, URL alvo, autenticação, repositório opcional, orientações do scan) que você pode executar várias vezes.

O assistente, etapa por etapa

Etapa	O que você define
1. Target	Assessment name e Target URL. Se você omitir o esquema, `https://` é adicionado.
2. Verify ownership	Prova para a aplicação ou para o domínio inteiro (aula 3) e, depois, Recheck.
3. Authentication	No authentication, Username / Password (Login URL, usuário de teste, senha de teste) ou API Keys / Headers.
4. Source repository	Opcional: Select existing, Connect new, ou pule a etapa para uma execução caixa-preta.
5. Scan & launch	Profundidade do scan, áreas de foco, itens fora do escopo, stack tecnológica conhecida, Additional context e, por fim, um Summary.

Observações sobre o assistente:

Autenticação. Se você fornecer acesso, use uma conta de teste dedicada, nunca a de um usuário real. As senhas e os valores de header armazenados nunca são devolvidos pela API. Para usar credenciais diferentes, crie uma nova avaliação. O teste autenticado não é garantido: trate uma execução como não autenticada, a menos que o Live browser view ou a gravação mostre que o agente fez login e chegou às áreas que você esperava.
Repositório de código-fonte. Vincular um repositório dá ao agente o seu código-fonte para uma execução caixa-branca. Share source code with the engine (whitebox scan) vem ativado por padrão. Desative-o para fazer um teste caixa-preta mantendo o repositório vinculado.
Profundidade. Quick (“Minutes · CI/CD & smoke checks”), Standard (“30 min–1 hr · routine review”, o padrão) ou Deep (“1–4 hr · full audit, chained exploits”). As durações do assistente são referências. Toda execução tem um limite de tempo definido pela profundidade, e uma execução sem resultado antes desse limite é marcada como Failed.
Orientações. Escolha áreas de foco como Access control (IDOR), revise a lista de itens fora do escopo e escreva o Additional context como um briefing para um pentester humano: fluxos críticos, problemas a verificar de novo, endpoints a evitar. Tudo isso vira o briefing do agente.

Ao clicar em Launch AI Pentest, o Plexicus também verifica se o conector AI Pentest está ativado, se algum repositório vinculado pertence à sua organização e se ainda resta uma sessão neste mês. Se todas as verificações passarem, você verá “Scan started.” e será levado à página da execução. Se o conector estiver desativado, alguém com permissão para gerenciar conectores pode ativá-lo em Pentest Configure .

Se alguma verificação falhar, o assistente mostra um erro e salva a avaliação como Draft. Corrija a causa, depois abra a avaliação em Draft na lista de Pentest e clique em Run na página da execução dela. Iniciar de novo pelo assistente cria uma segunda avaliação.

Status das execuções

Status	Significado
Draft	Criada, mas não iniciada. Só uma avaliação em Draft pode ser alterada, e apenas pela API.
Pending	Disparo aceito. A execução está começando.
Running	O agente está testando. Cancele a execução pela página dela.
Completed	A execução terminou e retornou resultados.
Failed	O agente reportou um erro, ou nenhum resultado chegou antes do limite de tempo da execução.
Cancelled	Alguém cancelou a execução.

Como acompanhar uma execução

A página da execução mostra “Scan in progress” com um cronômetro do tempo decorrido. Após 90 minutos, o banner muda para “Scan may be stuck” e oferece Cancel.

O Live browser view transmite o navegador do agente. O War room (live board) mostra a atividade do enxame com um selo LIVE. Nas execuções concluídas, ele mostra Replay, e Expand passa para a tela cheia. Só a sua organização pode abrir essas visualizações ao vivo.

Você também recebe capturas de tela e, quando houver, uma gravação da sessão (Session recording) do navegador do agente. Com as funções nativas, Admin e Cyberoper podem iniciar e cancelar execuções. Developer tem acesso somente leitura (módulo 10).

Evidências e resultados

Quando uma execução é concluída, você tem achados, um relatório, capturas de tela e, se tiver sido gerada, uma gravação da sessão. Os achados de pentest normalmente trazem um artefato de prova de conceito.

Achados na página da execução

O card Findings lista cada achado com um selo de severidade e um título. Clique em um deles para expandir a descrição, a URL afetada e o tipo do artefato de prova de conceito:

Artefato	O que contém
Comando cURL	A requisição HTTP que demonstrou o problema, como um comando cURL.
Script de shell	Os passos de reprodução registrados, em forma de script.
Captura HAR	Um HTTP Archive registrado da sessão, exibido como JSON formatado.

View PoC abre o artefato em um visualizador, e Download o salva com o nome de arquivo original. Os artefatos continuam disponíveis depois que a execução termina. Se uma execução concluída não tiver achados, o card mostra “No findings”.

Achados de todas as execuções

Os achados de pentest são armazenados como achados comuns do Plexicus, vinculados ao pentest de origem. Abra Findings App Pentest para trabalhar com eles na tabela de achados padrão, com os filtros e o painel de detalhes, ou clique em View Findings em uma linha concluída da lista de Pentest.

No painel de detalhes, um achado de pentest mostra Evidence & attack path em vez de Code & taint trace. Essa seção contém a URL alvo, um chip que indica se um repositório de código-fonte foi vinculado (“White-box run — source repository linked” ou “Black-box run — no source repository”), o tipo do artefato (CURL, HAR ou SCRIPT) e Download artifact. O painel descreve o artefato como um replay determinístico cujo comando e evidência esperada são “shown as recorded; nothing is re-run from your browser.” O visualizador exibe até 64 KB de um artefato. Para qualquer coisa maior, baixe o arquivo para ver a captura completa. Se nenhum artefato foi armazenado, o painel informa “No stored replay artifact for this finding.”

Relatório e gravação

Download report aparece no cabeçalho da página da execução assim que o agente armazena o relatório, um arquivo Markdown (.md) gerado no fim da execução. Download video salva a gravação da sessão como um arquivo .webm. Para exportar em PDF ou JSON os achados de App Pentest, use Findings App Pentest Download (os relatórios são abordados no módulo 8). Os achados verificados seguem então para o seu fluxo normal de remediação (módulo 7). Confirme com o seu contato na Plexicus se as correções por IA estão disponíveis para achados de pentest na sua versão. A decisão de fazer o merge é sempre da sua equipe.

Cotas de sessões

O uso do AI Pentest é contado em sessões mensais, separadas da sua cota de uso de IA. Quantas sessões você tem depende do seu plano. Se o seu plano não inclui o AI Pentest, New AI Pentest mostra um aviso de upgrade no lugar do assistente.

Cada Run ou Rescan consome uma sessão.
Quando há dados de uso disponíveis, o menu do seu perfil mostra um medidor Pentest com as sessões usadas e o limite deste mês (ou Unlimited). Quando o faturamento é exibido para o seu plano, Settings Billing também tem um card Pentest Sessions.
Uma sessão só é devolvida automaticamente se a execução falhar antes de o agente começar, por exemplo quando a preparação falha. Depois que o agente começa, cancelar a execução ou uma falha posterior ainda consome a sessão.
Quando não restam sessões, o disparo é recusado com o número de sessões usadas, o limite e a data de renovação.
A contagem de sessões é zerada no dia 1º de cada mês do calendário (UTC), e não na data de faturamento.

Planeje antes de gastar uma sessão: verifique a propriedade, revise a lista de itens fora do escopo, escreva o briefing e escolha a profundidade que corresponde à pergunta que você quer responder.

Principais pontos

O AI Swarm Pentest (AI Pentest no produto) é um engagement autorizado e com escopo definido, sujeito aos quatro guardrails do módulo 1: escopo acordado por escrito, evidência rastreável, limites do engagement e decisão humana. Ele não faz alterações automáticas em produção.
O enxame mapeia a superfície, formula hipóteses e testa caminhos de ataque dentro do escopo acordado, e uma segunda rodada precisa confirmar um resultado antes que ele seja apresentado como verificado. Sem prova reproduzível, não há achado verificado.
Iniciar uma execução exige propriedade comprovada: uma meta tag ou um arquivo em /.well-known para um único host, ou um registro DNS TXT para um domínio inteiro. Aceitar os termos não é prova, e o selo Verification da lista de Pentest é só um indício.
O assistente New AI Pentest tem cinco etapas. Prefira staging, lembre-se de que os itens fora do escopo são instruções, e não bloqueios técnicos, e escreva o briefing como faria para um pentester humano.
Os achados de pentest normalmente trazem um artefato de prova de conceito (comando cURL, script de shell ou captura HAR), exibido exatamente como foi registrado. Nada é executado novamente a partir do seu navegador.
Cada Run ou Rescan consome uma sessão mensal, que só é devolvida se a execução falhar antes de o agente começar. O banner “Scan may be stuck”, que aparece aos 90 minutos, não é por si só motivo para cancelar uma execução Deep.