--- title: "O agente de Segurança | Briks" url: https://briks.dev/pt-br/docs/security-agent description: "Contrate o agente de segurança: ele verifica código, chaves e páginas no ar, explica em palavras simples o que achou e o Builder corrige o que você aprovar." last_updated: 2026-10-08 --- # O agente de Segurança O agente de Segurança cuida da segurança do seu projeto. Ele verifica o código do seu site após cada publicação e o site inteiro toda semana, conta em palavras simples o que encontrou e o que fazer em seguida, e pede ao Builder que corrija o que você aprovar. Ele nunca altera o seu site por conta própria e nunca vê o valor de uma chave. 6 min de leitura Conferido com o estúdio em 8 de outubro de 2026 Quem pode contratá-lo O agente de segurança é contratado como qualquer outro agente, em Agents, e conta para o limite de agentes por projeto do seu plano. Owners e Admins o contratam, enviam as correções dele ao Builder e aceitam riscos; todos no espaço de trabalho podem ler o relatório. ## O que ele verifica Quase tudo o que ele verifica é feito pelas verificações da própria Briks, que leem seu site sempre do mesmo jeito e não custam créditos. O agente então lê só o ponto que uma verificação indica, decide se o achado é real e explica para você. | Área | O que é verificado | | --- | --- | | O código do seu site | Chaves escritas em arquivos, alterações nos seus dados sem limite de frequência, registros de membros lidos sem checar quem pede, texto exibido como HTML bruto, chamadas a outros sites e rotas ausentes da lista do próprio site de quem pode usar cada uma. | | Chaves | Cada chave que seu código lê e que não está definida em Settings → Secrets, e cada chave definida lá que nada mais lê. Só os nomes: o agente nunca vê um valor. | | O site no ar | Se todos os endereços respondem por https e se o http simples é redirecionado para lá, quantos dias restam ao certificado, os cabeçalhos de segurança, o cookie de login, se outros sites podem usar a API do seu site como um visitante logado, arquivos que nunca deveriam poder ser baixados e páginas de erro que mostram como o site funciona por dentro. | | E-mail | Para um domínio do qual você mesmo envia e-mail: os registros SPF, de assinatura (DKIM) e DMARC. | | Arquivos e formulários | Arquivos em pastas públicas do Storage com nomes que parecem privados, como backup, fatura, passaporte ou contrato, e uma explosão repentina de envios de formulário em comparação com um dia normal. | | Pacotes | Avisos de segurança conhecidos dos pacotes que o seu site tem além daqueles com que todo site começa, vindos de um banco de dados público de avisos. | | Um olhar mais de perto | Uma vez por mês, ele lê as partes do site que cuidam de login, dinheiro, arquivos enviados ou um recurso de IA, começando pelas que mudaram desde a última vez que olhou. | ## Quando é executado - **Após cada publicação.** As verificações de código e de chaves rodam na versão que acabou de ir ao ar, como ela foi salva, na hora e sem custo. O agente em si só acorda quando elas encontram algo novo, ou quando uma correção que ele pediu foi ao ar e precisa ser conferida. - **Toda semana**, na manhã de segunda-feira, no fuso horário do seu espaço de trabalho: o conjunto completo de verificações, incluindo o site no ar, e um relatório curto. - **When you write to it** na conversa dele, por exemplo para perguntar se um novo formulário é seguro para colocar no ar. Achados urgentes, como uma chave escrita em uma página ou um arquivo privado que qualquer pessoa pode baixar, chegam a você na hora: no sino e nos seus chats do Telegram que ativaram **Urgent security findings** nos alertas. ## Como ler o relatório Encontre o relatório 1. Abrir Agents Onde: Agents Escolha o projeto e depois o agente de segurança na aba Crew. 2. Abra a aba Security report Onde: Security report Os achados são agrupados por gravidade: Urgente, Alta, Média e Baixa. O número na aba é o que está esperando por você. 3. Ler cada achado Cada um diz o que alguém poderia fazer, o que isso significa para o seu negócio e o próximo passo: algo que só você pode fazer (com o lugar onde fazer), uma correção que o Builder pode aplicar, ou um aviso de que a Briks já está cuidando disso. 4. Veja as listas recolhidas Riscos que você aceitou, o que foi verificado e está em ordem, e o que foi corrigido nos últimos 30 dias ficam recolhidos no final. **Worth checking** lista o que depende de algo que só você consegue ver, como um arquivo em uma pasta pública do Storage cujo nome parece privado. Diz exatamente o que verificar e onde. Os achados que esperam por você também aparecem em **Waiting for you**, ao lado do que os outros agentes pedem. ## Corrigir e aceitar o risco Peça ao Builder para corrigir um achado 1. Escolha Fix it Onde: Security report A confirmação mostra quanto uma alteração costuma custar em créditos e quantos você tem. Pressione **Send to the Builder**. 2. Aprovar Onde: Waiting for you A correção espera em **Waiting for you**, no seu e-mail e no Telegram, como toda mudança que um agente pede. Você pode lê-la, alterar as palavras, aprová-la ou recusá-la. 3. O Builder faz a alteração Depois de aprovada, a alteração é construída, verificada e publicada como uma nova versão, que você pode desfazer pela lista de versões. 4. O agente verifica de novo Depois que a nova versão entra no ar, as verificações rodam de novo e o achado é marcado como corrigido quando deixa de existir. **Accept the risk** serve para uma descoberta com a qual você decidiu conviver, muitas vezes porque vem de algo que você pediu, como um arquivo em uma pasta pública do Storage que você pretende compartilhar. Sua escolha fica registrada com seu nome e a data, e o agente não a levanta de novo, a menos que piore. ## O que ele nunca faz - Ele nunca altera o seu site por conta própria. Toda correção é uma alteração que você aprova, sempre, feita pelo Builder, com opção de desfazer. - Ele nunca propõe desfazer algo que você pediu. Quando uma escolha sua traz um risco, ele avisa uma vez e deixa a decisão com você. - Ele nunca pede, lê nem repete o valor de uma chave. Trabalha só com os nomes das chaves. - Ele nunca tenta invadir. No site no ar, faz apenas as requisições simples que o navegador de um visitante faz, no máximo 25 por verificação, para os endereços do próprio site. - Ele nunca lê os registros dos seus clientes um a um. Ele os conta e só cita um quando um achado precisa disso. ## Orçamento e créditos As verificações em si não custam nada. O que o agente gasta é a leitura e a escrita que faz para explicar um achado e redigir uma correção, pagas com os créditos do seu espaço de trabalho dentro de um orçamento mensal próprio: 20 créditos por padrão, que você pode mudar nas configurações dele, com um quinto disso disponível por dia. Ele pede no máximo duas correções por execução, as mais graves primeiro, e cada correção é uma alteração normal com sua própria estimativa de créditos. Dica Quando você mesmo pode resolver algo em uma configuração, o agente avisa em vez de pedir ao Builder: adicionar uma chave em Settings → Secrets não custa nada. ### Ele pode corrigir coisas sem me perguntar? Não. As correções de segurança sempre esperam a sua aprovação, e as configurações do agente dizem isso no lugar do botão que os outros agentes têm. Toda correção espera em **Waiting for you** com a estimativa de créditos, e depois que você a aprova, ela é publicada como uma nova versão que você pode desfazer. ### Por que aparece que a Briks já está cuidando de algo? Alguns achados dizem respeito a como todos os sites são servidos, como um cabeçalho de segurança ou o certificado. A Briks corrige isso para todos os sites de uma vez, então não há nada para você nem para o Builder fazerem. ### Ele vai levantar de novo um risco que eu aceitei? Só se piorar. Um achado que ele verificou e concluiu que não é um risco real também não é levantado de novo. ## Leia a seguir - [Agentes de IA **Contrate agentes de IA** Contrate agentes de IA que cuidam de um site no ar: 13 tipos liderados por um Team lead, ou os seus, cada um com agenda e orçamento, perguntando antes de agir.](https://briks.dev/pt-br/docs/ai-agents) - [Agentes de IA **Aprovações e orçamentos** Veja o que os agentes perguntam antes de agir, aprove no estúdio, por e-mail ou no Telegram, escolha o que fazem sozinhos e fixe orçamentos que limitam gastos.](https://briks.dev/pt-br/docs/agent-approvals) - [Dados e automação **Segredos** Guarde chaves de API e senhas do código no servidor do site, nunca em páginas ou downloads. Adicione, altere e remova, e veja as regras que o Briks aplica.](https://briks.dev/pt-br/docs/secrets) - [Trabalhando em um projeto **Versões, desfazer e refazer** Cada build e alteração é salva como versão do seu site. Desfaça, refaça ou recoloque no ar qualquer versão anterior, exatamente como era, sem reter créditos.](https://briks.dev/pt-br/docs/versions) Ainda travado? Escreva para [hello@briks.dev](mailto:hello@briks.dev) com o nome do seu projeto e o que você esperava ver. Uma captura de tela ajuda.