Ressalvas
Limitações importantes e considerações ao usar o cside.
Ambientes que Usam um Domínio Diferente
Ambiente de staging
Para que o cside identifique corretamente e autorize o uso da nossa infraestrutura edge, usamos o header referrer nas requisições para determinar se a requisição está vindo de um cliente licenciado. Essa abordagem tem algumas limitações.
Por exemplo, se você usa um ambiente de staging, o cside não conseguirá identificar corretamente e autorizar o uso da infraestrutura edge para os scripts. Isso ocorre porque o header referrer será (frequentemente) um domínio diferente. Isso é comumente visto em URLs de preview/staging que usam um domínio gerado dinamicamente, como Vercel, Netlify e outras plataformas.
Ambiente local
Adicionamos alguns mecanismos de detecção ao script web para lidar automaticamente com ambientes locais, como localhost, 127.0.0.1, ::1 e outros casos para desabilitar automaticamente o roteamento do script web pelo Gatekeeper nesses ambientes. Se você não deseja que sua infraestrutura edge funcione no ambiente local, pode renderizar condicionalmente o script web do cside.
Scripts Inline
O cside atualmente não monitora scripts inline. Planejamos adicionar suporte para monitoramento de scripts inline no futuro. Recomendamos que você use o atributo src para carregar seus scripts, em vez de usar inline. Mas entendemos que isso nem sempre é possível.
Prefixação Server-side
Para desempenho e proteção ideais, você também deve prefixar quaisquer URLs usadas em tags <script> dentro do HTML enviado ao navegador. A ferramenta CLI lida com isso automaticamente para sites estáticos, e plugins de integração como Vite e Next.js lidam com isso durante o processo de build.
Domínios com Bypass
Alguns scripts de terceiros são conhecidos por causar conflitos quando servidos de outro domínio. Mantemos uma lista desses domínios que são automaticamente ignorados pela nossa infraestrutura edge. Esses scripts não serão roteados pelo Gatekeeper para garantir compatibilidade.
Se você encontrar problemas com um script de terceiro específico, entre em contato com support@cside.dev para assistência.