Référence des actions

Les actions sont les opérations qu'une règle doit effectuer, et qui peuvent être définies à la troisième étape du formulaire d'édition de règle. Cette page présente les différents types d'actions pris en charge par redirection.io.

Veuillez noter qu'une règle peut effectuer plusieurs actions. Les actions sont effectuées séquentiellement - vous pouvez ainsi, par exemple, décider d'ajouter un en-tête de réponse HTTP personnalisé, d'injecter des données structurées dans la page et de remplacer les balises meta HTML "title" et "description" dans une seule règle.

Redirection

L'action Redirection génère une redirection HTTP.

Si vous n'êtes pas familier avec les redirections HTTP, veuillez d'abord lire notre guide sur ce qu'est une redirection d'URL.

Vous pouvez configurer deux paramètres :

• la cible de la redirection (c'est-à-dire l'URL vers laquelle l'utilisateur doit être redirigé). Il peut s'agir d'une URL relative ou absolue (commençant par http:// ou https://).
• le code de statut de la redirection - choisissez s'il doit s'agir d'une redirection permanente ou temporaire ;

Lorsque vous cliquez sur le bouton "Utiliser une variable", vous pouvez réutiliser un marker que vous avez peut-être défini dans le déclencheur "URL source". Ceci est utile pour créer des règles de redirection dynamiques, qui utiliseront une partie de l'URL source dans l'emplacement cible.

Les membres du projet du plan "Pro" peuvent également utiliser n'importe quelle propriété de requête dans l'URL cible de la redirection. Il peut s'agir de :

• la valeur de n'importe quel en-tête de requête
• l'heure de la requête
• le nom d'hôte
• le chemin de la requête
• la méthode HTTP utilisée
• le schéma de l'URL demandée
• l'adresse IP du client

Cette fonctionnalité peut être utile dans de nombreux cas. Par exemple, elle peut aider à créer des scénarios basés sur la valeur d'un Cookie ou de tout en-tête de requête que votre CDN pourrait ajouter, etc.

Afin d'ajouter une valeur d'en-tête dans le champ URL cible de la redirection, suivez les étapes suivantes :

1. Cliquez sur le bouton "Utiliser une variable". Cela listera les markers utilisés lors de l'étape "Déclencheur", et cela affichera également le lien "Utiliser une propriété de requête" - choisissez cette option
2. Remplissez le formulaire dans le panneau latéral, pour sélectionner la propriété de requête que vous souhaitez injecter dans l'URL cible de la redirection.
3. Veuillez noter que des transformations peuvent être utilisées pour modifier la valeur injectée. Par exemple, vous pouvez vouloir mettre en minuscules la valeur d'un en-tête, ou effectuer des remplacements.
4. La propriété apparaît dans le champ "URL cible".

Code de statut personnalisé

L'action Code de statut de réponse personnalisé permet de forcer un code de statut donné dans la réponse HTTP.

De nombreuses possibilités sont offertes par cette action :

• vous pourriez vouloir renvoyer une réponse 404 Not Found, pour "abandonner" le trafic au niveau du proxy redirection.io. Si vous avez récemment supprimé du contenu de votre site web et que vous souhaitez indiquer aux robots et aux visiteurs de cesser de visiter ces URL, cette action peut être utile et aider à économiser du trafic sur votre pile backend ;
• ou vous pourriez renvoyer une réponse 410 Gone (un code de statut 410 devrait être préféré si la page a complètement disparu, et que vous voulez empêcher les moteurs de recherche de perdre du temps et des ressources à visiter cette page à nouveau) ;
• si votre site web ou une partie de celui-ci est en maintenance, vous pourriez vouloir renvoyer une réponse 503 Service Unavailable, pour indiquer que votre site web n'est pas prêt à traiter les requêtes ;
• etc.

Bien sûr, vous devez être prudent lorsque vous utilisez cette action, car elle pourrait générer des erreurs HTTP si vous la configurez ainsi !

Tous les codes de statut standard dans la plage 2xx - 5xx sont pris en charge.

Substitution de balise meta

Lors de la création d'un site web, c'est une erreur SEO assez courante d'oublier de remplir toutes les balises <meta>. Même les sites web optimisés ont tendance à avoir des doublons dans les titres de page ou les descriptions, ce qui n'est généralement pas considéré comme une bonne pratique SEO.

Afin d'éviter ces problèmes, l'action SEO override permet d'ajuster précisément le contenu de ces méta-balises HTML dans les réponses HTTP envoyées depuis votre plateforme.

Considérez, par exemple, la page HTML suivante :

<!doctype html>
<html lang=en>
  <head>
    <meta charset=utf-8>
  </head>
  <body>
    <p>Here goes the page content.</p>
  </body>
</html>

L'utilisation de l'action SEO override permet de "réparer" la page et d'injecter des méta-balises :

<!doctype html>
<html lang=en>
  <head>
    <meta charset=utf-8>
    <title>Some unique title for this page</title>
    <meta name="description">Put here a unique description for this page</meta>
    <meta name="keywords">keywords, html, page, example</meta>
  </head>
  <body>
    <p>Here goes the page content.</p>
  </body>
</html>

Nous prenons en charge la substitution d'une liste assez étendue de méta-balises, ce qui devrait couvrir la plupart des exigences.

En-tête HTTP personnalisé

La gestion de la réponse HTTP n'est pas seulement une question de HTML ou de code de statut ; le proxy redirection.io peut également vous aider à ajouter, supprimer ou modifier les en-têtes HTTP de réponse aux réponses envoyées par votre site web.

L'action "En-tête HTTP personnalisé" est un moyen très flexible de gérer les réponses envoyées à vos utilisateurs. Elle peut être utilisée pour inclure des en-têtes personnalisés requis par votre entreprise (en-têtes X-*), pour ajouter des en-têtes de sécurité, corriger les en-têtes de politique de sécurité du contenu pour une URL spécifique, etc.

L'action "En-tête HTTP personnalisé" peut effectuer plusieurs types d'opérations sur les en-têtes de réponse :

• Définir la valeur : Remplace toutes les occurrences de cet en-tête par un seul en-tête contenant cette valeur. Si l'en-tête n'était pas présent dans la réponse, il est ajouté.
• Valeur par défaut : Définit cet en-tête s'il n'est pas présent dans la réponse. Si l'en-tête est déjà défini dans la réponse, il n'est pas modifié.
• Remplacer la valeur existante : Remplace toutes les occurrences de cet en-tête par la valeur configurée. Si l'en-tête est présent plusieurs fois, chacune de ses occurrences sera configurée avec cette valeur. Si l'en-tête n'était pas présent dans la réponse, il ne sera pas ajouté.
• Ajouter un nouvel en-tête : Ajoute un nouvel en-tête de réponse avec cette valeur. Si l'en-tête est déjà présent dans la réponse, l'action ajoutera une autre occurrence de cet en-tête de réponse.
• Supprimer l'en-tête : Supprime toutes les occurrences de l'en-tête de la réponse.

Veuillez noter que certains des modes d'édition listés ci-dessus ne sont pas disponibles avec tous les proxys. Par exemple, avec le module nginx, il n'est pas possible de modifier les en-têtes qui sont eux-mêmes définis directement par nginx. Par exemple, l'en-tête Server, qui est défini par nginx, ne peut pas être supprimé par le module nginx. L'agent redirection.io en mode proxy inverse, en revanche, prend en charge correctement tous les modes d'édition listés ci-dessus.

Quant à la cible URL de l'action de redirection, les membres du projet du plan "Pro" peuvent réutiliser n'importe quelle variable de requête dans les valeurs d'en-tête de réponse :

Pas à l'aise avec la notion d'en-têtes HTTP ? Vous pouvez consulter les recettes redirection.io, pour vous aider à créer plus facilement des règles agissant sur les en-têtes.

Insérer du code HTML

Cette action permet d'intégrer la chaîne de caractères de votre choix à différentes positions dans la réponse HTML. Cela peut être utile pour ajouter une feuille de style, un fichier javascript, ou du code.

Corps de réponse personnalisé

Cette action est disponible uniquement pour les projets du plan "Pro".

Cette action permet de définir complètement le contenu du corps de la réponse. Cela permet de renvoyer du contenu HTML, mais aussi des feuilles de style CSS, du javascript, des images SVG, du contenu text/plain pur, etc.

En plus de définir le contenu de la réponse, l'action permet également de sélectionner une valeur pour l'en-tête de réponse Content-Type.

Gestion de Robots.txt

Cette action est disponible uniquement pour les projets du plan "Pro".

Cette action ne peut être utilisée que lorsque l'"URL source" est l'URL d'un fichier robots.txt, et elle permet de servir un fichier robots.txt personnalisé.

L'action propose 3 possibilités :

• Autoriser tout pour permettre à tous les crawlers d'accéder à toutes les pages
• Bloquer tout pour empêcher tous les crawlers et robots d'explorer n'importe quelle page. Gardez à l'esprit que dans certaines situations, les URL de votre site web peuvent toujours être indexées par les moteurs de recherche, même si elles n'ont pas été explorées.
• Personnalisé pour définir vous-même le contenu qui devrait être servi comme fichier robots.txt du site web.

Si l'"URL source" fournie à l'étape "Déclencheur" est une URL absolue, nous chargerons automatiquement votre fichier robots.txt préexistant :

Gestion de Sitemap

Cette action est disponible uniquement pour les projets du plan "Pro".

Utilisez cette action pour servir un fichier sitemap.xml à l'emplacement défini dans le déclencheur "URL source".

Cette action permet de définir jusqu'à 50 000 entrées dans un contenu sitemap, et garantit que le contenu sitemap fourni est valide.

Configuration

Cette action est disponible uniquement pour les projets du plan "Pro".

L'action Configuration est utile pour gérer le comportement du module redirection.io sur votre site web. Elle permet d'activer ou de désactiver complètement le traitement par redirection.io, ou peut simplement désactiver la journalisation des requêtes HTTP, ce qui est quelque chose que vous pourriez vouloir éviter pour ne pas journaliser des données sensibles.

Par exemple, vous pourriez vouloir désactiver le module redirection.io sur vos pages de paiement. Vous pourriez également vouloir désactiver la journalisation sur vos pages de "changement de mot de passe" utilisateur, etc.

La désactivation de redirection.io peut être effectuée en utilisant les options "Réinitialiser les règles précédentes" et "Arrêter le traitement des règles" :

Vous cherchez un exemple de cette action ? Jetez un œil à la recette "Redirection sauf un chemin" !