Clarified Tomcat forward-slash encoding in documentation (issue 29)

James Moger

2011-11-30 efba97d1d2568d4a71c39ec049cb1a5015855f75

Clarified Tomcat forward-slash encoding in documentation (issue-29)

 distrib/gitblit.properties

@@ -202,6 +202,7 @@
#

# <https://issues.apache.org/jira/browse/WICKET-1303>

# <http://tomcat.apache.org/security-6.html#Fixed_in_Apache_Tomcat_6.0.10>

# Add *org.apache.tomcat.util.buf.UDecoder.ALLOW_ENCODED_SLASH=true* to *CATALINA_OPTS*

#

# SINCE 0.5.2

web.forwardSlashCharacter = /


 docs/03_faq.mkd

@@ -66,7 +66,8 @@
Tomcat takes the extra precaution of [disallowing embedded slashes by default](http://tomcat.apache.org/security-6.html#Fixed_in_Apache_Tomcat_6.0.10).  This breaks Gitblit urls.  

You have a few options on how to handle this scenario:



1. [Tweak Tomcat](http://tomcat.apache.org/security-6.html#Fixed_in_Apache_Tomcat_6.0.10) 
1. [Tweak Tomcat](http://tomcat.apache.org/security-6.html#Fixed_in_Apache_Tomcat_6.0.10)  
Add *org.apache.tomcat.util.buf.UDecoder.ALLOW_ENCODED_SLASH=true* to *CATALINA_OPTS*

2. *web.mountParameters = false* and use non-pretty, parameterized urls

3. *web.forwardSlashCharacter = !* which tells Gitblit to use **!** instead of **/**