9.5. Configure a Global Valve

Global valves are enabled and configured in the web subsystem. This is done using the JBoss CLI tool.

Procedure 9.2. Configure a Global Valve

Enable the Valve
Use the add operation to add a new valve entry.
```
/subsystem=web/valve=VALVENAME:add(module="MODULENAME",class-name="CLASSNAME")
```
You need to specify the following values:
- VALVENAME, the name that is used to refer to this valve in application configuration.
- MODULENAME, the module that contains the value being configured.
- CLASSNAME, the classname of the specific valve in the module.
For example:
```
/subsystem=web/valve=clientlimiter:add(module="clientlimitermodule",class-name="org.jboss.samplevalves.RestrictedUserAgentsValve")
```
Optionally: Specify Parameters
If the valve has configuration parameters, specify these with the add-param operation.
```
/subsystem=web/valve=VALVENAME:add-param(param-name="PARAMNAME", param-value="PARAMVALUE")
```
You need to specify the following values:
- VALVENAME, the name that is used to refer to this valve in application configuration.
- PARAMNAME, the name of the parameter that is being configured for specific valve.
- PARAMVALUE, the value of the specified parameter.
For example:
Example 9.1. Valve configuration
```
/subsystem=web/valve=clientlimiter:add-param(
   param-name="restrictedUserAgents", 
   param-value="^.*MS Web Services Client Protocol.*$"
)
```

The valve is now enabled and configured for all deployed applications.

Refer to Create a Custom Valve section of the Developement Guide for more information on how to create a custom valve.