WebExpress.URLRewriteRulesJSON
| WebExpress = class static (TObject) | Interface de WebExpress | Exemples de WebExpress |
Qubes 10.0 Contrôle de la réécriture d'URL
Syntaxe
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/defaultsera é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/hellosera é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.