Red Hat Summit Red Hat SummitSupportConsoleDéveloppeursCommencer un essaiContact

4.4. Configurer une application web pour utiliser une valve.

Les valves qui ne sont pas installées en tant que valves globales doivent être incluses avec votre application et configurées dans le descripteur de déploiement jboss-web.xml.

Important

Les valves globales sont appliquées automatiquement à toutes les applications qui sont déployées. Pour obtenir des instructions sur la façon de configurer les valves globales, voir le chapitre intitulé Valves globales dans le Guide d'administration et de configuration pour JBoss EAP.

Conditions préalables

  • La valve doit être créée et incluse dans le chemin de classe de l'application. Pour ce faire, il convient de l'inclure dans le fichier WAR de l'application ou dans tout autre module ajouté comme dépendance. Les exemples de tels modules comprennent un module statique installé sur le serveur ou un fichier JAR dans le répertoire lib/ d'une archive EAR si le WAR est déployé dans une archive EAR.
  • L'application doit inclure un descripteur de déploiement de jboss-web.xml.

Procédure 4.1. Configurer une application pour une valve locale.

  1. Configuration d'une valve

    Créer un élément valve contenant l'élément enfant class-name au fichier jboss-web.xml de l'application. Le class-name est le nom de la classe de valve. 
    <valve>
      <class-name>VALVE_CLASS_NAME</class-name>
</valve>
    Copy to Clipboard Toggle word wrap

    Exemple 4.1. Exemple d'élément de valve configuré dans le fichier jboss-web.xml

    <valve>
      <class-name>org.jboss.security.negotiation.NegotiationAuthenticator</class-name>
</valve>
    Copy to Clipboard Toggle word wrap

  2. Configurer une valve personnalisée

    Si la valve possède des paramètres configurables, ajouter un élément enfant param à l'élément valve pour chaque paramètre, en spécifiant leur nom et leur valeur param-name et param-value.

    Exemple 4.2. Exemple d'élément de valve personnalisé configuré dans le fichier jboss-web.xml

    <valve>   
    <class-name>org.jboss.web.tomcat.security.GenericHeaderAuthenticator</class-name>  
    <param>  
        <param-name>httpHeaderForSSOAuth</param-name>  
        <param-value>sm_ssoid,ct-remote-user,HTTP_OBLIX_UID</param-value>  
    </param>  
    <param>  
        <param-name>sessionCookieForSSOAuth</param-name>  
        <param-value>SMSESSION,CTSESSION,ObSSOCookie</param-value>  
    </param>  
</valve>
    Copy to Clipboard Toggle word wrap
Une fois l'application déployée, la valve sera autorisée pour cette application avec la configuration spécifiée.

Exemple 4.3. Configuration valve jboss-web.xml

<valve>
    <class-name>org.jboss.samplevalves.RestrictedUserAgentsValve</class-name>
    <param>  
        <param-name>restrictedUserAgents</param-name>
        <param-value>^.*MS Web Services Client Protocol.*$</param-value>
    </param>
 </valve>
Copy to Clipboard Toggle word wrap
Rapporter un bogue
Red Hat logoGithubredditYoutubeTwitter

Apprendre

Essayez, achetez et vendez

Communautés

À propos de la documentation Red Hat

Nous aidons les utilisateurs de Red Hat à innover et à atteindre leurs objectifs grâce à nos produits et services avec un contenu auquel ils peuvent faire confiance. Découvrez nos récentes mises à jour.

Rendre l’open source plus inclusif

Red Hat s'engage à remplacer le langage problématique dans notre code, notre documentation et nos propriétés Web. Pour plus de détails, consultez le Blog Red Hat.

À propos de Red Hat

Nous proposons des solutions renforcées qui facilitent le travail des entreprises sur plusieurs plates-formes et environnements, du centre de données central à la périphérie du réseau.

Theme

© 2026 Red HatRetour au début