Este manual fornece diretrizes claras e objetivas para a implementação do Indexa num site que chamaremos de “www.mysite.com”. O processo envolve configurações com diferentes times, incluindo infraestrutura, front-end e analytics.
Alguns métodos comuns para implementar esse processo estão detalhados na documentação abaixo no Manual de Implementação de CDN, em que apresentamos modelos de instalação em diferentes CDNs (mas também é possível adaptar a lógica para outros formatos conforme necessário).
Etapa 1 – Configuração de Redirecionamento (Time de Infraestrutura)
A Simplex precisa utilizar um domínio próprio para criar as páginas que serão utilizadas. Esse domínio será apresentado nesse guia como mysite.simplex.live/. É importante confirmar com o time da simplex qual deve ser o domínio usado no seu caso específico.
Definição de Padrão de URL
Para que a ferramenta possa ser instalada, é importante definir um padrão de URL, que estará presente em todas as URLs criadas pela ferramenta. É obrigatório que esse parâmetro seja exclusivo das páginas do indexa, ou seja, ele não pode aparecer em URLs nativas do site.
Para este guia, utilizaremos a terminação de URL .sdex.
Configuração via CDN (ou Servidor, se necessário)
Precisamos garantir que qualquer chamada contendo .sdex direcione para a origem da Simplex.
Configuração Esperada:
Toda chamada para:
https://www.mysite.com/(.*).sdex
deve ser redirecionada de forma transparente para:
https://mysite.simplex.live/$1.sdex
Idealmente, essa configuração deve ser realizada via CDN, mas também pode ser feita diretamente no servidor (Apache ou Nginx), caso necessário.
Essa requer implementações técnicas, portanto disponibilizamos alguns exemplos neste guia, na seção: Exemplos Práticos.
Etapa 2 – Garantia de Continuidade de Acessos (Time de Infraestrutura)
O sistema da Simplex precisa acessar regularmente o site onde a ferramenta está instalada. Para permitir isso, existem 3 alternativas que podem ser usadas individualmente ou combinadas:
1) Adicionar os IPs da Simplex à Whitelist
Inclua os IPs da Simplex em uma safelist para que possam acessar o site livremente, sem bloqueios.
• Consulte: https://www.cloudflare.com/pt-br/ips/
(Muitas requisições se originarão da infraestrutura da Cloudflare, portanto, permitir o intervalo de IPs deles é essencial.)
• Confirme conosco se serão usados IPs específicos para o seu projeto — isso é um requisito comum.
2) Permitir chamadas pelo User-Agent da Simplex
As nossas requisições podem sempre ser feitas com user-agents muito específicos. Você pode entrar em contato com nossa equipe para definir uma substring de user-agent que deverá ser liberada nas regras de bloqueio de acesso.
3) Definir um Authorization Header
Você pode definir com a nossa equipe um authorization header específico a ser incluído em todas as requisições da Simplex, conforme o exemplo abaixo:
'x-acesso-simplex': 'token-hasheado-a-ser-combinado'
Etapa 3– Adição de Link no Footer (Time de Front-end ou CMS)
Para permitir a indexação pelo Google das páginas criadas pela ferramenta, é necessário adicionar um link no footer do site para um sitemap HTML que liste as páginas do Indexa.
Nós iremos te fornecer o link que deve ser incluído no footer, normalmente em um endereço do tipowww.mysite.com/sitemap.sdex.
Sugestões de Texto Âncora: → "Mapa do site" → "Mapa de blog" → "Mapa de conteúdo" → "Mapa de artigos"
Observação
Não remover ou substituir mapas do site ou outros links já existentes no footer.
Etapa 4 – Acessos ao GA e GSC (Times de Analytics e SEO)
Para monitoramento adequado, precisamos de acesso de visualização nas seguintes ferramentas:
→ Google Analytics (GA) – Configuração realizada pelo time de Analytics.
→ Google Search Console (GSC) – Configuração realizada pelo time de SEO.
Esses acessos são necessários apenas para fins de monitoramento dos indicadores da ferramenta.
Exemplos Práticos
Exemplo 1 - Integração com Cloudflare CDN
Configuração do Worker na Cloudflare
Segue um código típico para um Worker da Cloudflare:
Exemplo 2 - Integração com CloudFront CDN
Pré-Requisitos
1. Conta AWS e acesso ao AWS Management Console.
2. Distribuição CloudFront já configurada.
3. Conhecimento sobre Lambda@Edge.
Configuração
Passo 1: Criar uma Função Lambda
1. Acesse o console AWS Lambda.
2. Crie uma nova função e escolha "Author from scratch".
3. Defina um nome e selecione um runtime (Node.js ou Python).
4. Escolha ou crie uma função com permissões adequadas.
5. Clique em "Create function".
Passo 2: Lógica da Função
Exemplo de função Node.js:
Passo 3: Deploy no Lambda@Edge
1. Escolha "Deploy to Lambda@Edge".
2. Selecione sua distribuição CloudFront.
3. Escolha "Origin Request".
4. Confirme o deploy.
Passo 4: Testar a Configuração
Testar acessando URLs terminadas em .sdex e verificando o comportamento esperado.
Exemplo 3 - Integração com Apache2
Pré-Requisitos
1. Apache 2 instalado.
2. Módulos ativados:
Configuração do Virtual Host
Reinicie o Apache:
sudo systemctl restart apache2
Configuração via .htaccess
Exemplo 4 - Integração com Nginx
Pré-Requisitos
1. Nginx instalado;
2. SSL configurado corretamente.
Configuração
Reinicie o Nginx:
sudo systemctl restart nginx