WebExpress.URLRewriteRulesJSON

redirigé depuis WebExpress.SetURLRewriteRulesJSON

WebExpress = class static (TObject)Interface de WebExpressExemples de WebExpress

Qubes 10.0 Contrôle de la réécriture d'URL

Syntaxe

property URLRewriteRulesJSON: String read GetURLRewriteRulesJSON write SetURLRewriteRulesJSON

Remarques

Cette propriété permet de configurer les règles de réécritures d'URL: quand un appel au serveur est effectué, si l'une des règle correspond, elle sera réécrite et traitée comme si un appel à l'URL réécrite avait eut lieu.

Ce mécanisme peut être utiliser pour de l'embellissement d'URL, pour effectuer des redirections silencieuses côté serveur, ou pour masquer des URLs (en interdire l'accès de manière absolue).

Le JSON contient une description des règles, sous la forme d'un tableau d'objets de deux champs:

  • pattern: indique le masque auquel la règle s'applique, le caractère '*' indique une partie variable
  • rewrite indique la règle de réécriture, les parties variables étant référencées par '$' suivi de leur index débutant à 1

Les règles sont évaluée dans l'ordre de leur déclaration, la première s'appliquant à l'URL sera utilisée.

Par exemple le JSON ci-dessous définit deux règles:

[
  {"pattern": "/icon/default", "rewrite": "/WebProcess.cit/WP002/default"},
  {"pattern": "/icon/*", "rewrite": "/WebProcess.cit/WP001/icon?img=$1"}
}
  • La première règle défini une réécriture statique: appeler /icon/default sera équivalent à appeler /WebProcess.cit/WP002/default.
  • La seconde règle réécrit tous les appels vers /icon/]@ en les réécrivant ver un WebProcess, par example [@/icon/hello sera équivalent à appeler /WebProcess.cit/WP001/icon?img=hello. Cela sera le cas pour toutes les URL commençant pas "/icon/", sauf "/icon/default" car la première règle s'applique à ce cas.

Pour configurer les règles au démarrage du QubesExpress, le script de démarrage du service peut être utilisé (par défaut le fichier "QubesExpress.startup.pas" placé dans le même dossier que "QubesExpress.exe").

Important: si QubesExpert est activé sur la base de donnée, une mauvaise configuration des règles de réécriture pourra le rendre injoignable.

Classification

QubesExpress WebExpress