---
title: Control Handling of the URL Encoded Sequence %2f
description: This property controls whether the encoding sequence %2f, if used in incoming URL paths, is rejected, accepted (without decoding) or decoded.
component: java-agents
version: 2025.11
page_id: java-agents:properties-reference:org.forgerock.agents.percent.2f.handling.strategy
canonical_url: https://docs.pingidentity.com/java-agents/2025.11/properties-reference/org.forgerock.agents.percent.2f.handling.strategy.html
---

# Control Handling of the URL Encoded Sequence %2f

This property controls whether the encoding sequence `%2f`, if used in incoming URL paths, is rejected, accepted (without decoding) or decoded.

When set to `REJECT_OUTRIGHT`, if the sequence `%2f` occurs anywhere in the incoming URI path, or path parameters, the agent will reject the incoming request with an HTTP 400 response.

When set to `ACCEPT_BUT_NOT_INTERPRET`, any occurrence of `%2f` in the incoming URI path, or path parameters, will be left unconverted.

When set to `ACCEPT_AND_INTERPRET`, any occurrence of `%2f` in the incoming URI path, or path parameters, will be replaced by a forward slash character.

|                          |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Property name            | `org.forgerock.agents.percent.2f.handling.strategy`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| Aliases                  | `org.forgerock.agents.percent.2f.handling.strategy`   Introduced in Java Agent 2024.11                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| Function                 | Configure behaviour                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| Supported settings       | * REJECT\_OUTRIGHT

  Any and all occurrences of the specified sequence within the incoming URL will cause the agent to reject the incoming request with HTTP 400.

* ACCEPT\_BUT\_NOT\_INTERPRET

  Occurrences of the specified sequence within the incoming URL will not cause the agent to reject the incoming request, but the sequence will be left decoded.

* ACCEPT\_AND\_INTERPRET

  Occurrences of the specified sequence within the incoming URL will not cause the agent to reject the incoming request, and the sequence will be decoded for the purposes of not-enforced rule matching and AM policy evaluation |
| Default                  | `REJECT_OUTRIGHT`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| Bootstrap property       | No                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| Required property        | No                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| Restart required         | No                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| Local configuration file | `AgentConfig.properties`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |