Ce manuel fournit des directives claires et objectives pour l’implémentation d’Indexa sur un site que nous appellerons www.mysite.com. Le processus implique des configurations avec différentes équipes, notamment infrastructure, front-end et analytics.

Certaines méthodes courantes d’implémentation sont détaillées dans la documentation ci-dessous dans le Manuel d’Implémentation CDN, qui présente des modèles d’installation sur différentes CDNs. Il est également possible d’adapter la logique à d’autres formats si nécessaire.

Étape 1 – Configuration de Redirection (Équipe Infrastructure)

Simplex doit utiliser un domaine dédié pour créer les pages nécessaires. Ce domaine apparaîtra dans ce guide comme mysite.simplex.live/. Il est important de confirmer avec l’équipe de Simplex quel domaine doit être utilisé dans votre cas spécifique.

Définition du Modèle d’URL

Pour que l’outil soit installé, il est important de définir un modèle d’URL, présent dans toutes les URLs créées par l’outil. Ce paramètre doit être exclusif aux pages d’Indexa, c’est-à-dire qu’il ne doit pas apparaître dans les URLs natives du site.
Pour ce guide, nous utiliserons le suffixe d’URL .sdex.

Configuration via CDN (ou Serveur, si nécessaire)

Nous devons garantir que toute requête contenant .sdex soit redirigée vers l’origine de Simplex.

Configuration Attendue :

Toute requête vers :

doit être redirigée de manière transparente vers :

Idéalement, cette configuration doit être réalisée via CDN, mais elle peut également être effectuée directement sur le serveur (Apache ou Nginx), si nécessaire.

Cela nécessite des implémentations techniques, nous fournissons donc des exemples dans ce guide, dans la section Exemples Pratiques.

Étape 2 – Garantie de Continuité d’Accès (Équipe Infrastructure)

Le système Simplex doit accéder régulièrement au site où l’outil est installé. Il est donc nécessaire de :

Ajouter les IPs de Simplex à une whitelist afin qu’elles puissent accéder au site sans blocage.

• https://www.cloudflare.com/fr-fr/ips/ (de nombreuses requêtes proviendront de l’infrastructure Cloudflare, il est donc essentiel d’autoriser leur réseau IP)

• Vérifier auprès de l’équipe Simplex s’il existe des IPs spécifiques pour votre projet, ce qui est courant.

Permettre également les accès dont le user-agent contient "simplex-c4", pour éviter les blocages et erreurs de chargement des pages pour les utilisateurs.

Étape 3 – Ajout d’un Lien dans le Footer (Équipe Front-end ou CMS)

Pour permettre l’indexation par Google des pages créées par l’outil, il est nécessaire d’ajouter un lien dans le pied de page du site vers un sitemap HTML listant les pages d’Indexa.

Simplex fournira le lien à inclure dans le footer, généralement une URL du type www.mysite.com/sitemap.sdex.

Étape 4 – Accès à GA et GSC (Équipes Analytics et SEO)

Pour un suivi adéquat, nous avons besoin d’un accès en lecture aux outils suivants :

→ Google Analytics (GA) – Configuration réalisée par l’équipe Analytics.

→ Google Search Console (GSC) – Configuration réalisée par l’équipe SEO.
Ces accès sont nécessaires uniquement à des fins de suivi des indicateurs de l’outil.

Exemples Pratiques

Exemple 1 – Intégration avec Cloudflare CDN

Configuration du Worker dans Cloudflare

Voici un exemple typique de code pour un Worker Cloudflare :

Exemple 2 – Intégration avec CloudFront CDN

Pré-requis

1. Compte AWS et accès à AWS Management Console.

2. Distribution CloudFront déjà configurée.

3. Connaissances sur Lambda@Edge.

Configuration

Étape 1 : Créer une Fonction Lambda

1. Accédez au console AWS Lambda.

2. Créez une nouvelle fonction et choisissez "Author from scratch".

3. Définissez un nom et sélectionnez un runtime (Node.js ou Python).

4. Choisissez ou créez un rôle avec les autorisations adéquates.

5. Cliquez sur "Create function".

Étape 2 : Logique de la Fonction

Exemple de fonction en Node.js :

Étape 3 : Déploiement sur Lambda@Edge

1. Choisissez "Deploy to Lambda@Edge".

2. Sélectionnez votre distribution CloudFront.

3. Choisissez "Origin Request".

4. Confirmez le déploiement.

Étape 4 : Tester la Configuration

Tester en accédant à des URLs se terminant par .sdex et vérifier le comportement attendu.

Exemple 3 – Intégration avec Apache2

Pré-requis

1. Apache 2 installé.

2. Modules activés :

Configuration du Virtual Host

Redémarrer Apache :

Configuration via .htaccess

Exemple 4 – Intégration avec Nginx

Pré-requis

1. Nginx installé ;

2. SSL correctement configuré.

Configuration

Redémarrer Nginx :