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.
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. |
| 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
Abrir Agents
Onde: Agents
Escolha o projeto e depois o agente de segurança na aba Crew.
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ê.
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.
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
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.
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.
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.
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.
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.