Documentação
Segurança e velocidade web, em linguagem de trabalho
54 artigos: como fazer cada coisa no painel, o que os conceitos por baixo querem dizer, e o que fazer quando alguma coisa não está a funcionar.
Como usar
Passo a passo, do primeiro site à partilha com clientes.
- Criar um siteO assistente tem sete passos e nenhum deles é obrigatório à primeira. Este guia explica o que cada um decide e o que podes deixar para depois.
- Ligar o domínio e o DNSÉ o passo que faz o tráfego real passar por nós. Há duas formas de o fazer, e a escolha depende de o teu domínio ter email ou não.
- Configurar a origemIntermédioA origem é onde o teu site vive de verdade. Este guia explica como a apontar, como ter mais do que uma, e o que fazemos quando ela deixa de responder.
- Cache e velocidadeO que guardamos, durante quanto tempo, e como pedir que uma coisa deixe de ser guardada. Inclui o que fazer quando publicas uma alteração e o site continua a mostrar a antiga.
- Proteção e firewallIntermédioComo ligar a firewall sem bloquear os teus clientes. O caminho seguro é começar em auditoria, ver o que ela apanharia, e só depois passar a bloquear.
- Redirecionamentos e regras de tráfegoMudar endereços sem perder visitantes, pôr uma página de manutenção, ou fechar um site com password. Tudo o que decide o que acontece a um pedido antes de ele chegar à tua origem.
- Carteira de clientes e relatóriosPara quem gere sites de outras pessoas. Atribuir um cliente a cada site organiza a lista, agrupa os números e dá um relatório mensal pronto a enviar.
- Equipa e convitesComo dar acesso à conta a mais alguém, e a diferença entre trazer uma pessoa para dentro da conta e partilhar um site com alguém de fora.
- Partilhar um site com o clienteIntermédioDar a alguém de fora da tua conta acesso a um site — ou a todos os sites de um cliente — sem lhe dar os dos outros. Em ver, ou em ver e gerir.
- Plano e faturaçãoComo se define o plano, ver as faturas, e o que acontece aos sites quando um pagamento falha.
- Suporte e notificaçõesQuando usar o chat e quando abrir um pedido escrito, e onde ver o histórico do que aconteceu na tua conta.
Conceitos
Como a web funciona por baixo, sem jargão.
- Como funciona a webQuando abres um site, o teu navegador fala com um servidor que está noutro sítio do mundo. Esta conversa segue regras simples — perceber estas regras ajuda a perceber praticamente tudo o resto.
- HTTPS e certificadosO cadeado verde na barra do browser não é decoração. Indica que a conversa entre o teu visitante e o site está cifrada e que o site é mesmo quem diz ser.
- DNS explicadoQuando escreves "o-meu-site.pt" o browser precisa de descobrir em que computador o site vive. O DNS é a lista telefónica gigante que faz essa tradução.
- Cache e CDNServir o mesmo ficheiro a 10 mil pessoas é desperdício. Caches guardam cópias prontas a entregar — a FortFox guarda essas cópias perto do visitante, em servidores espalhados pelo mundo (CDN).
- Endereços IP e CIDRCada computador na internet tem um número que o identifica — o endereço IP. CIDR é a forma compacta de referir um conjunto inteiro de IPs vizinhos.
- Cabeçalhos HTTPCabeçalhos são informação extra que pedidos e respostas trocam — quem é o visitante, que tipo de conteúdo está a ser enviado, o que cachear, instruções de segurança. Muitas das definições da FortFox traduzem-se em cabeçalhos enviados ao browser.
Servidores
A tua origem: onde o site vive e como a protegemos.
- Servidor de origemO servidor de origem é onde o teu site realmente vive — o servidor que tens em Wordpress, num VPS, num cPanel, na cloud, na cave. A FortFox fica à frente dele, filtra ameaças e serve cópias em cache.
- Prioridade e failoverQuando tens vários servidores de origem, a FortFox usa-os por prioridade — o número mais baixo é o primeiro. Os outros entram só se o principal falhar. Resultado: o teu site continua a responder mesmo quando um servidor cai.
- Verificação de saúdeA FortFox testa periodicamente os teus servidores de origem para saber se estão a responder bem. Se algum cair, o tráfego é desviado para outro automaticamente — sem o visitante notar e sem precisares de fazer nada.
- Proteger a origem de tráfego diretoIntermédioSe um atacante descobre o IP real do teu servidor (via DNS antigo, certificados, leaks), pode atacá-lo diretamente, ignorando a FortFox. Esta página explica as três formas — da mais simples à mais robusta — de garantir que só pedidos da FortFox chegam ao teu servidor.
Proteção
Firewall, bots, limites e regras.
- Firewall de aplicação (WAF)O WAF é o guarda à porta do teu site. Analisa cada pedido antes de o deixar entrar e bloqueia o que parece ser ataque — injeções de SQL, scripts maliciosos, tentativas de explorar falhas.
- Modos normal, auditoria e sombraO WAF tem três modos de operação. Em "normal" bloqueia mesmo. Em "auditoria" observa e regista sem bloquear nada. Em "sombra" decide como decidiria, mas deixa passar — útil para testar regras novas sem risco.
- Nível de proteçãoQuão rigorosa é a análise do WAF. Equilibra a quantidade de ataques apanhados com a probabilidade de bloquear visitantes legítimos. "Equilibrada" serve para a maioria dos sites; "Alta" e "Máxima" são para alvos óbvios de ataque.
- Gestão de botsNem todo o tráfego é humano. A gestão de bots distingue browsers de programas automáticos e decide o que fazer com cada um — deixa passar os bons (Google, monitorização) e bloqueia ou desafia os maus (scrapers, brute-force, bots de IA).
- Sensibilidade dos botsDefine quão facilmente o sistema decide que um pedido é bot. Mais sensibilidade apanha mais automação maliciosa, mas pode também marcar visitantes legítimos. "Média" cobre 95% dos sites.
- Pontuação e desafiosCada pedido recebe uma pontuação 0-100. Acima do limite de bloqueio é travado; numa zona cinzenta pode receber uma verificação rápida (challenge) que humanos passam e bots não.
- Filtro por paísRecusar ou permitir visitantes consoante o país de origem (geolocalização do IP). Tem dois modos — lista negra (bloquear estes) e lista branca (permitir só estes). Útil mas requer cuidado com falsos positivos.
- Limite de pedidosLimita quantos pedidos um mesmo IP pode fazer por segundo. Trava força bruta, scraping agressivo e pequenos ataques sem afetar o uso normal. Diferente da proteção DDoS, que opera em volumes muito maiores.
- Proteção DDoSDDoS = milhares (ou milhões) de computadores a atacar o teu site ao mesmo tempo, com o objetivo de o deitar abaixo a esgotar recursos. A FortFox absorve e filtra o tráfego antes que ele chegue ao teu servidor.
- Regras avançadas (DSL)IntermédioA linguagem de regras da FortFox permite combinar múltiplas condições do pedido (endereço, método, cabeçalhos, IP, país…) numa só regra com a ação que escolheres. Esta página é a referência completa.
Velocidade
Cache, compressão e imagens.
- Cache na FortFoxA FortFox guarda cópias das respostas do teu site nos servidores edge. Visitantes seguintes recebem a cópia sem incomodar o teu servidor — mais rápido para eles, menos carga para ti.
- Duração da cache (TTL)Quanto tempo a FortFox guarda uma cópia antes de ir buscar uma versão fresca ao servidor. Mais tempo = mais hits e menos carga; menos tempo = conteúdo mais atual. Equilibrar é a arte.
- Variar por query stringPor defeito, a FortFox trata "/produtos" e "/produtos?cor=azul" como o mesmo pedido para fins de cache. Ativar "variar por query string" obriga-a a manter cópias separadas — útil quando o conteúdo muda conforme os parâmetros.
- CompressãoAntes de enviar a resposta ao visitante, a FortFox encolhe-a para uma fração do tamanho. A página carrega mais depressa, gasta menos dados (importante em redes móveis), e o utilizador nem nota.
- Otimização de imagensImagens são tipicamente 60-80% do peso de uma página. A FortFox converte-as automaticamente para formatos modernos (WebP, AVIF) muito mais leves, e ajusta qualidade e tamanho — sem mexeres nos ficheiros originais.
Regras de tráfego
Redirecionamentos, manutenção e password.
- RedirecionamentosEnvia automaticamente quem visita um endereço para outro. Útil quando mudas páginas de sítio, restruturas o site, ou queres encurtar URLs. Tem tipos diferentes para casos diferentes.
- Páginas de manutençãoMostra uma página de "voltamos já" em vez do site, num caminho à tua escolha ou no site inteiro. Os visitantes veem uma mensagem amigável em vez de erros, e a FortFox serve tudo do edge sem incomodar o teu servidor.
- Proteção por passwordExige uma password para aceder a um caminho (ou ao site inteiro). Útil para áreas privadas, ambientes de testes, sites ainda não lançados ou conteúdo que partilhas com poucas pessoas.
- Padrões de caminhoQuase todas as regras (cache, redirecionamentos, password, manutenção) usam padrões de caminho para decidir onde se aplicam. Esta página explica como o matching funciona, incluindo prefixos, wildcards e a regra do "menor ganha".
Definições
Domínio próprio, TLS e cabeçalhos de segurança.
- Domínio próprioLiga o teu próprio endereço (`o-meu-site.com`) à FortFox em vez de usar o endereço temporário que recebes ao criar o site. Envolve um passo de verificação por DNS para provar que o domínio é teu, e a emissão automática de certificado HTTPS.
- Versão mínima de TLSO TLS é o protocolo que cifra a ligação entre o visitante e o teu site (o "S" do HTTPS). Tem versões — 1.0, 1.1, 1.2, 1.3 — onde as mais novas são mais seguras mas browsers muito antigos não as suportam. A versão mínima diz qual aceitas.
- Cabeçalhos de segurançaIntermédioCabeçalhos HTTP extra que o teu site envia ao browser do visitante para o proteger de certos ataques — "roubo de cliques", deteção indevida de ficheiros, vazamento de privacidade. São instruções defensivas que o browser respeita.
API e integrações
Automatizar: tokens, endpoints, webhooks e regras de WAF.
- Autenticação e tokens de APIAvançadoComo um programa se autentica na API. Explica a diferença entre a sessão do painel e um token de API, e como limitar um token ao mínimo de que ele precisa.
- Primeiros pedidosAvançadoA forma da API, os grupos de endpoints por área, e o que esperar de uma resposta de erro. O suficiente para o primeiro script.
- WebhooksAvançadoReceber um POST assinado quando algo acontece nos teus sites. Como subscrever, como verificar a assinatura, e o que fazemos quando o teu endpoint falha.
- Limites de pedidosAvançadoA API tem tectos. O que fazer quando levas um 429, e como escrever um cliente que não os encontra.
- A linguagem de regras do WAFAvançadoA sintaxe para escrever regras próprias de firewall: campos, operadores e ações. Com os enganos mais comuns e como evitá-los.
Resolução de problemas
O que fazer quando alguma coisa não está a funcionar.
- O meu domínio não verificaA verificação falha por seis razões, e cinco delas resolvem-se em minutos. Esta é a ordem por que vale a pena procurar.
- O site não ativa, ou dá 502Um site que não serve tem três causas possíveis, e distinguem-se em dois minutos: a subscrição, a origem, ou o DNS.
- Recebi um erro de pagamentoO que aconteceu, quanto tempo tens, e como resolver. Os sites não caem no momento em que a cobrança falha.
- Perdi o acesso à contaPassword esquecida, telefone com o 2FA perdido, ou códigos de recuperação gastos. O que se resolve sozinho e o que precisa de nós.
- Terminar sessão em todos os dispositivosIntermédioO que este botão faz, o que não faz, e o que mais tens de fazer se suspeitas que alguém entrou na tua conta.
- Porque é que a taxa de cache parece baixaIntermédioUma taxa baixa não é necessariamente um problema. Este guia explica o que o número mede, quando é normal ser baixo, e o que fazer quando não é.