Red Hat Training

A Red Hat training course is available for Red Hat JBoss Enterprise Application Platform

9.5. Configuration d'une valve globale

Les valves globales sont activées et configurées dans le sous-système web par l'intermédiaire de l'interface CLI de JBoss.

Procédure 9.2. Configuration d'une valve globale

  1. Activer la valve

    Utiliser l'opération add pour ajouter une nouvelle saisie de valve.
    /subsystem=web/valve=VALVENAME:add(module="MODULENAME",class-name="CLASSNAME")
    Vous devrez indiquer les valeurs suivantes :
    • VALVENAME, le nom utilisé pour cette valve dans la configuration de l'application.
    • MODULENAME, le module qui contient la valeur en cours de configuration.
    • CLASSNAME, le nom de classe de la valve spécifique du module.
    Par exemple :
    /subsystem=web/valve=clientlimiter:add(module="clientlimitermodule",class-name="org.jboss.samplevalves.RestrictedUserAgentsValve")
  2. En option : spécifier les paramètres

    Si la valve a des paramètres de configuration, spécifier les dans l'opération add-param.
    /subsystem=web/valve=VALVENAME:add-param(param-name="PARAMNAME", param-value="PARAMVALUE")
    Vous devrez indiquer les valeurs suivantes :
    • VALVENAME, le nom utilisé pour cette valve dans la configuration de l'application.
    • PARAMNAME, le nom du paramètre configuré pour une valve spécifique.
    • PARAMVALUE, la valeur du paramètre spécifié.
    Par exemple :

    Exemple 9.1. Configuration de la valve

    /subsystem=web/valve=clientlimiter:add-param(
       param-name="restrictedUserAgents", 
       param-value="^.*MS Web Services Client Protocol.*$"
    )
Cette valve est maintenant activée et configurée pour toutes les applications déployées.
Voir la section Create a Custom Valve du Guide de développement pour obtenir plus d'informations sur la façon de créer une valve personnalisée.