From 617cb76575cb8fbbf0eadfe9ba7b0f44b1ddfef1 Mon Sep 17 00:00:00 2001 From: chrisisbeef Date: Mon, 25 Jul 2011 06:24:52 +0000 Subject: [PATCH 001/812] [maven-release-plugin] prepare for next development iteration --- pom.xml | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/pom.xml b/pom.xml index 9ffe42b87..aa817e883 100644 --- a/pom.xml +++ b/pom.xml @@ -3,7 +3,7 @@ 4.0.0 org.owasp.esapi esapi - 2.0.1 + 2.0.2-SNAPSHOT jar @@ -66,9 +66,9 @@ - scm:svn:http://owasp-esapi-java.googlecode.com/svn/tags/esapi-2.0.1 - scm:svn:https://owasp-esapi-java.googlecode.com/svn/tags/esapi-2.0.1 - http://code.google.com/p/owasp-esapi-java/source/checkout/tags/esapi-2.0.1 + scm:svn:http://owasp-esapi-java.googlecode.com/svn/trunk + scm:svn:https://owasp-esapi-java.googlecode.com/svn/trunk + http://code.google.com/p/owasp-esapi-java/source/checkout From 2d6b884786093b1c04e746c1b35bac157772d594 Mon Sep 17 00:00:00 2001 From: "kevin.w.wall" Date: Sun, 24 Jun 2012 01:04:46 +0000 Subject: [PATCH 002/812] 1) Fix Google issue # 271. 2) Fix to work with q4e Eclipse plug-in. --- pom.xml | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/pom.xml b/pom.xml index aa817e883..c48a1908f 100644 --- a/pom.xml +++ b/pom.xml @@ -30,7 +30,7 @@ The Enterprise Security API (ESAPI) project is an OWASP project to create simple strong security controls for every web platform. Security controls are not simple to build. You can read about the - hundreds of pitfalls for unwary developers on the OWASP website. By + hundreds of pitfalls for unwary developers on the OWASP web site. By providing developers with a set of strong controls, we aim to eliminate some of the complexity of creating secure web applications. This can result in significant cost savings across the SDLC. @@ -194,7 +194,7 @@ xom xom - 1.1 + 1.2.5 org.beanshell @@ -252,6 +252,7 @@ check-for-dependency-updates + compile display-dependency-updates display-plugin-updates From 899e828ddceba60e48e15d440b814fa7722a5b44 Mon Sep 17 00:00:00 2001 From: "kevin.w.wall" Date: Sun, 24 Jun 2012 01:08:09 +0000 Subject: [PATCH 003/812] Fix Google Issue # 257 --- src/main/java/org/owasp/esapi/User.java | 2 +- .../org/owasp/esapi/codecs/VBScriptCodec.java | 4 +- .../esapi/reference/DefaultRandomizer.java | 3 +- .../owasp/esapi/reference/DefaultUser.java | 3 +- src/test/java/org/owasp/esapi/UserTest.java | 8 ++-- .../esapi/reference/AuthenticatorTest.java | 41 ++++++++++--------- .../owasp/esapi/reference/EncoderTest.java | 13 +++--- .../esapi/reference/HTTPUtilitiesTest.java | 9 ++-- .../reference/IntrusionDetectorTest.java | 5 ++- .../owasp/esapi/reference/RandomizerTest.java | 5 ++- .../org/owasp/esapi/reference/UserTest.java | 25 +++++------ .../esapi/reference/crypto/EncryptorTest.java | 8 ++-- .../java/org/owasp/esapi/waf/WAFTestCase.java | 4 +- 13 files changed, 70 insertions(+), 60 deletions(-) diff --git a/src/main/java/org/owasp/esapi/User.java b/src/main/java/org/owasp/esapi/User.java index c8b70adb8..f6b9fa2d4 100644 --- a/src/main/java/org/owasp/esapi/User.java +++ b/src/main/java/org/owasp/esapi/User.java @@ -663,7 +663,7 @@ public void removeRole(String role) throws AuthenticationException { * {@inheritDoc} */ public String resetCSRFToken() throws AuthenticationException { - csrfToken = ESAPI.randomizer().getRandomString(8, Encoder.CHAR_ALPHANUMERICS); + csrfToken = ESAPI.randomizer().getRandomString(8, EncoderConstants.CHAR_ALPHANUMERICS); return csrfToken; } diff --git a/src/main/java/org/owasp/esapi/codecs/VBScriptCodec.java b/src/main/java/org/owasp/esapi/codecs/VBScriptCodec.java index ec3ed5f74..2dccbbd81 100644 --- a/src/main/java/org/owasp/esapi/codecs/VBScriptCodec.java +++ b/src/main/java/org/owasp/esapi/codecs/VBScriptCodec.java @@ -15,7 +15,7 @@ */ package org.owasp.esapi.codecs; -import org.owasp.esapi.reference.DefaultEncoder; +import org.owasp.esapi.EncoderConstants; /** @@ -44,7 +44,7 @@ public String encode(char[] immune, String input) { char c = input.charAt(i); // handle normal characters and surround them with quotes - if (containsCharacter(c, DefaultEncoder.CHAR_ALPHANUMERICS) || containsCharacter(c, immune)) { + if (containsCharacter(c, EncoderConstants.CHAR_ALPHANUMERICS) || containsCharacter(c, immune)) { if ( encoding && i > 0 ) sb.append( "&" ); if ( !inquotes && i > 0 ) sb.append( "\"" ); sb.append( c ); diff --git a/src/main/java/org/owasp/esapi/reference/DefaultRandomizer.java b/src/main/java/org/owasp/esapi/reference/DefaultRandomizer.java index 65b894c67..3272a6946 100644 --- a/src/main/java/org/owasp/esapi/reference/DefaultRandomizer.java +++ b/src/main/java/org/owasp/esapi/reference/DefaultRandomizer.java @@ -20,6 +20,7 @@ import java.util.UUID; import org.owasp.esapi.ESAPI; +import org.owasp.esapi.EncoderConstants; import org.owasp.esapi.Logger; import org.owasp.esapi.Randomizer; import org.owasp.esapi.errors.EncryptionException; @@ -109,7 +110,7 @@ public float getRandomReal(float min, float max) { * {@inheritDoc} */ public String getRandomFilename(String extension) { - String fn = getRandomString(12, DefaultEncoder.CHAR_ALPHANUMERICS) + "." + extension; + String fn = getRandomString(12, EncoderConstants.CHAR_ALPHANUMERICS) + "." + extension; logger.debug(Logger.SECURITY_SUCCESS, "Generated new random filename: " + fn ); return fn; } diff --git a/src/main/java/org/owasp/esapi/reference/DefaultUser.java b/src/main/java/org/owasp/esapi/reference/DefaultUser.java index 40672dd85..6b24f1aae 100644 --- a/src/main/java/org/owasp/esapi/reference/DefaultUser.java +++ b/src/main/java/org/owasp/esapi/reference/DefaultUser.java @@ -16,6 +16,7 @@ package org.owasp.esapi.reference; import org.owasp.esapi.ESAPI; +import org.owasp.esapi.EncoderConstants; import org.owasp.esapi.HTTPUtilities; import org.owasp.esapi.Logger; import org.owasp.esapi.User; @@ -472,7 +473,7 @@ public void removeRole(String role) { public String resetCSRFToken() { // user.csrfToken = ESAPI.encryptor().hash( session.getId(),user.name ); // user.csrfToken = ESAPI.encryptor().encrypt( address + ":" + ESAPI.encryptor().getTimeStamp(); - csrfToken = ESAPI.randomizer().getRandomString(8, DefaultEncoder.CHAR_ALPHANUMERICS); + csrfToken = ESAPI.randomizer().getRandomString(8, EncoderConstants.CHAR_ALPHANUMERICS); return csrfToken; } diff --git a/src/test/java/org/owasp/esapi/UserTest.java b/src/test/java/org/owasp/esapi/UserTest.java index e79db714c..ab31d4808 100644 --- a/src/test/java/org/owasp/esapi/UserTest.java +++ b/src/test/java/org/owasp/esapi/UserTest.java @@ -19,8 +19,6 @@ import junit.framework.TestCase; import junit.framework.TestSuite; -import org.owasp.esapi.reference.DefaultEncoder; - /** * @author Jeff Williams (jeff.williams@aspectsecurity.com) */ @@ -45,9 +43,13 @@ public static Test suite() { public void testAllMethods() throws Exception { // create a user to test Anonymous - String accountName = ESAPI.randomizer().getRandomString(8, DefaultEncoder.CHAR_ALPHANUMERICS); + String accountName = ESAPI.randomizer().getRandomString(8, EncoderConstants.CHAR_ALPHANUMERICS); Authenticator instance = ESAPI.authenticator(); String password = instance.generateStrongPassword(); + + // Probably could skip the assignment here, but maybe someone had + // future plans to use this. So will just suppress warning for now. + @SuppressWarnings("unused") User user = instance.createUser(accountName, password, password); // test the rest of the Anonymous user diff --git a/src/test/java/org/owasp/esapi/reference/AuthenticatorTest.java b/src/test/java/org/owasp/esapi/reference/AuthenticatorTest.java index e24f9e547..31699ccfb 100644 --- a/src/test/java/org/owasp/esapi/reference/AuthenticatorTest.java +++ b/src/test/java/org/owasp/esapi/reference/AuthenticatorTest.java @@ -24,6 +24,7 @@ import org.owasp.esapi.Authenticator; import org.owasp.esapi.ESAPI; +import org.owasp.esapi.EncoderConstants; import org.owasp.esapi.HTTPUtilities; import org.owasp.esapi.Logger; import org.owasp.esapi.User; @@ -89,7 +90,7 @@ protected void tearDown() throws Exception { */ public void testCreateUser() throws AuthenticationException, EncryptionException { System.out.println("createUser"); - String accountName = ESAPI.randomizer().getRandomString(8, DefaultEncoder.CHAR_ALPHANUMERICS); + String accountName = ESAPI.randomizer().getRandomString(8, EncoderConstants.CHAR_ALPHANUMERICS); Authenticator instance = ESAPI.authenticator(); String password = instance.generateStrongPassword(); User user = instance.createUser(accountName, password, password); @@ -101,13 +102,13 @@ public void testCreateUser() throws AuthenticationException, EncryptionException // success } try { - instance.createUser(ESAPI.randomizer().getRandomString(8, DefaultEncoder.CHAR_ALPHANUMERICS), "password1", "password2"); // don't match + instance.createUser(ESAPI.randomizer().getRandomString(8, EncoderConstants.CHAR_ALPHANUMERICS), "password1", "password2"); // don't match fail(); } catch (AuthenticationException e) { // success } try { - instance.createUser(ESAPI.randomizer().getRandomString(8, DefaultEncoder.CHAR_ALPHANUMERICS), "weak1", "weak1"); // weak password + instance.createUser(ESAPI.randomizer().getRandomString(8, EncoderConstants.CHAR_ALPHANUMERICS), "weak1", "weak1"); // weak password fail(); } catch (AuthenticationException e) { // success @@ -119,7 +120,7 @@ public void testCreateUser() throws AuthenticationException, EncryptionException // success } try { - instance.createUser(ESAPI.randomizer().getRandomString(8, DefaultEncoder.CHAR_ALPHANUMERICS), null, null); // null password + instance.createUser(ESAPI.randomizer().getRandomString(8, EncoderConstants.CHAR_ALPHANUMERICS), null, null); // null password fail(); } catch (AuthenticationException e) { // success @@ -173,8 +174,8 @@ public void testGenerateStrongPassword() throws AuthenticationException { public void testGetCurrentUser() throws Exception { System.out.println("getCurrentUser"); Authenticator instance = ESAPI.authenticator(); - String username1 = ESAPI.randomizer().getRandomString(8, DefaultEncoder.CHAR_ALPHANUMERICS); - String username2 = ESAPI.randomizer().getRandomString(8, DefaultEncoder.CHAR_ALPHANUMERICS); + String username1 = ESAPI.randomizer().getRandomString(8, EncoderConstants.CHAR_ALPHANUMERICS); + String username2 = ESAPI.randomizer().getRandomString(8, EncoderConstants.CHAR_ALPHANUMERICS); User user1 = instance.createUser(username1, "getCurrentUser", "getCurrentUser"); User user2 = instance.createUser(username2, "getCurrentUser", "getCurrentUser"); user1.enable(); @@ -228,10 +229,10 @@ public void testGetUser() throws AuthenticationException { System.out.println("getUser"); Authenticator instance = ESAPI.authenticator(); String password = instance.generateStrongPassword(); - String accountName=ESAPI.randomizer().getRandomString(8, DefaultEncoder.CHAR_ALPHANUMERICS); + String accountName=ESAPI.randomizer().getRandomString(8, EncoderConstants.CHAR_ALPHANUMERICS); instance.createUser(accountName, password, password); assertNotNull(instance.getUser( accountName )); - assertNull(instance.getUser( ESAPI.randomizer().getRandomString(8, DefaultEncoder.CHAR_ALPHANUMERICS) )); + assertNull(instance.getUser( ESAPI.randomizer().getRandomString(8, EncoderConstants.CHAR_ALPHANUMERICS) )); } /** @@ -243,7 +244,7 @@ public void testGetUserFromRememberToken() throws AuthenticationException { Authenticator instance = ESAPI.authenticator(); instance.logout(); // in case anyone is logged in String password = instance.generateStrongPassword(); - String accountName=ESAPI.randomizer().getRandomString(8, DefaultEncoder.CHAR_ALPHANUMERICS); + String accountName=ESAPI.randomizer().getRandomString(8, EncoderConstants.CHAR_ALPHANUMERICS); User user = instance.createUser(accountName, password, password); user.enable(); MockHttpServletRequest request = new MockHttpServletRequest(); @@ -281,7 +282,7 @@ public void testGetUserFromSession() throws AuthenticationException { System.out.println("getUserFromSession"); FileBasedAuthenticator instance = (FileBasedAuthenticator)ESAPI.authenticator(); instance.logout(); // in case anyone is logged in - String accountName=ESAPI.randomizer().getRandomString(8, DefaultEncoder.CHAR_ALPHANUMERICS); + String accountName=ESAPI.randomizer().getRandomString(8, EncoderConstants.CHAR_ALPHANUMERICS); String password = instance.generateStrongPassword(); User user = instance.createUser(accountName, password, password); user.enable(); @@ -307,7 +308,7 @@ public void testGetUserNames() throws AuthenticationException { String password = instance.generateStrongPassword(); String[] testnames = new String[10]; for(int i=0;i Date: Sun, 22 Jul 2012 00:19:30 +0000 Subject: [PATCH 004/812] 1) Fix warnings in keySet() method. 2) Javadoc clean-up. --- src/main/java/org/owasp/esapi/EncryptedProperties.java | 10 ++++++---- 1 file changed, 6 insertions(+), 4 deletions(-) diff --git a/src/main/java/org/owasp/esapi/EncryptedProperties.java b/src/main/java/org/owasp/esapi/EncryptedProperties.java index 667ee2b52..e95b1b858 100644 --- a/src/main/java/org/owasp/esapi/EncryptedProperties.java +++ b/src/main/java/org/owasp/esapi/EncryptedProperties.java @@ -72,14 +72,16 @@ public interface EncryptedProperties { String setProperty(String key, String value) throws EncryptionException; /** - * Returns a Set view of properties. The Set is backed by a Hashtable, so changes to the - * Hashtable are reflected in the Set, and vice-versa. The Set supports element - * removal (which removes the corresponding entry from the Hashtable), but not element addition. + * Returns a {@code Set} view of properties. The {@code Set} is backed by a + * {@code java.util.Hashtable}, so changes to the {@code Hashtable} are + * reflected in the {@code Set}, and vice-versa. The {@code Set} supports element + * removal (which removes the corresponding entry from the {@code Hashtable), + * but not element addition. * * @return * a set view of the properties contained in this map. */ - public Set keySet(); + public Set keySet(); /** * Reads a property list (key and element pairs) from the input stream. From ffd225161dd445bd6e3e573e5154e7714bafd014 Mon Sep 17 00:00:00 2001 From: "kevin.w.wall" Date: Sun, 22 Jul 2012 00:22:08 +0000 Subject: [PATCH 005/812] 1) Fix warnings. 2) Minor Javadoc changes. --- .../esapi/reference/crypto/DefaultEncryptedProperties.java | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/src/main/java/org/owasp/esapi/reference/crypto/DefaultEncryptedProperties.java b/src/main/java/org/owasp/esapi/reference/crypto/DefaultEncryptedProperties.java index 5726b856f..4f6d1a381 100644 --- a/src/main/java/org/owasp/esapi/reference/crypto/DefaultEncryptedProperties.java +++ b/src/main/java/org/owasp/esapi/reference/crypto/DefaultEncryptedProperties.java @@ -46,8 +46,10 @@ * * @author Jeff Williams (jeff.williams .at. aspectsecurity.com) Aspect Security + * @author kevin.w.wall@gmail.com * @since June 1, 2007 * @see org.owasp.esapi.EncryptedProperties + * @see org.owasp.esapi.reference.crypto.ReferenceEncryptedProperties */ public class DefaultEncryptedProperties implements org.owasp.esapi.EncryptedProperties { @@ -136,7 +138,7 @@ public synchronized String setProperty(String key, String value) throws Encrypti /** * {@inheritDoc} */ - public Set keySet() { + public Set keySet() { return properties.keySet(); } @@ -201,7 +203,7 @@ public static void main(String[] args) throws Exception { try { if ( out != null ) out.close(); } catch( Exception e ) {} } - Iterator i = ep.keySet().iterator(); + Iterator i = ep.keySet().iterator(); while (i.hasNext()) { String k = (String) i.next(); String value = ep.getProperty(k); From 88cb0cf1c6ca34eaef062cf9b6bdbaab89878d4f Mon Sep 17 00:00:00 2001 From: "kevin.w.wall" Date: Sun, 22 Jul 2012 00:28:32 +0000 Subject: [PATCH 006/812] 1) Remove unneeded import (bsh.This). 2) Fix or suppress warnings. 3) Add serialVersionUID. 4) Fix Javadoc. --- .../crypto/ReferenceEncryptedProperties.java | 28 ++++++++++++++----- 1 file changed, 21 insertions(+), 7 deletions(-) diff --git a/src/main/java/org/owasp/esapi/reference/crypto/ReferenceEncryptedProperties.java b/src/main/java/org/owasp/esapi/reference/crypto/ReferenceEncryptedProperties.java index bcbe786cf..cffc14963 100644 --- a/src/main/java/org/owasp/esapi/reference/crypto/ReferenceEncryptedProperties.java +++ b/src/main/java/org/owasp/esapi/reference/crypto/ReferenceEncryptedProperties.java @@ -15,7 +15,6 @@ */ package org.owasp.esapi.reference.crypto; -import bsh.This; import java.io.BufferedReader; import java.io.ByteArrayInputStream; import java.io.IOException; @@ -42,17 +41,24 @@ * and decryption based on {@code Encryptor}. *

* This implementation differs from {@code DefaultEncryptedProperties} in that - * it actually extends from java.util.Properties for applications that need an + * it actually extends from {@code java.util.Properties} for applications that need an * instance of that class. In order to do so, the {@code getProperty} and * {@code setProperty} methods were modified to throw {@code EncryptionRuntimeException} * instead of {@code EncryptionException}. * * @author August Detlefsen (augustd at codemagi dot com) * CodeMagi, Inc. + * @author kevin.w.wall@gmail.com * @since October 8, 2010 * @see org.owasp.esapi.EncryptedProperties + * @see org.owasp.esapi.reference.crypto.DefaultEncryptedProperties */ -public class ReferenceEncryptedProperties extends java.util.Properties implements org.owasp.esapi.EncryptedProperties { +public class ReferenceEncryptedProperties extends java.util.Properties implements EncryptedProperties { + + /** + * serverVersionUID; use format of YYYYMMDD. + */ + private static final long serialVersionUID = 20120718L; /** The logger. */ private final Logger logger = ESAPI.getLogger(this.getClass()); @@ -91,7 +97,7 @@ public ReferenceEncryptedProperties(Properties defaults) { /** * {@inheritDoc} * - * @throws This method will throw an {@code EncryptionRuntimeException} if decryption fails. + * @throws EncryptionRuntimeException Thrown if decryption fails. */ @Override public synchronized String getProperty(String key) throws EncryptionRuntimeException { @@ -120,7 +126,7 @@ public synchronized String getProperty(String key) throws EncryptionRuntimeExcep /** * {@inheritDoc} * - * @throws This method will throw an {@code EncryptionRuntimeException} if decryption fails. + * @throws EncryptionRuntimeException Thrown if decryption fails. */ @Override public String getProperty(String key, String defaultValue) throws EncryptionRuntimeException { @@ -134,7 +140,7 @@ public String getProperty(String key, String defaultValue) throws EncryptionRunt /** * {@inheritDoc} * - * @throws This method will throw an {@code EncryptionRuntimeException} if encryption fails. + * @throws EncryptionRuntimeException Thrown if encryption fails. */ @Override public synchronized String setProperty(String key, String value) throws EncryptionRuntimeException { @@ -164,6 +170,8 @@ public synchronized String setProperty(String key, String value) throws Encrypti /** * {@inheritDoc} + * @throws IOException Thrown if input stream invalid or does not + * correspond to Java properties file format. */ @Override public void load(InputStream in) throws IOException { @@ -175,7 +183,10 @@ public void load(InputStream in) throws IOException { * {@inheritDoc} * * For JDK 1.5 compatibility, this method has been overridden convert the Reader - * into an InputStream and call the superclass constructor. + * into an InputStream and call the superclass constructor. + * + * @throws IOException Thrown if {@code Reader} input stream invalid or does not + * correspond to Java properties file format. */ public void load(Reader in) throws IOException { @@ -218,6 +229,7 @@ public void list(PrintWriter out) { /** * This method has been overridden to throw an {@code UnsupportedOperationException} */ + @SuppressWarnings({ "unchecked", "rawtypes" }) @Override public Collection values() { throw new UnsupportedOperationException("This method has been removed for security."); @@ -226,6 +238,7 @@ public Collection values() { /** * This method has been overridden to throw an {@code UnsupportedOperationException} */ + @SuppressWarnings({ "unchecked", "rawtypes" }) @Override public Set entrySet() { throw new UnsupportedOperationException("This method has been removed for security."); @@ -234,6 +247,7 @@ public Set entrySet() { /** * This method has been overridden to throw an {@code UnsupportedOperationException} */ + @SuppressWarnings({ "unchecked", "rawtypes" }) @Override public Enumeration elements() { throw new UnsupportedOperationException("This method has been removed for security."); From b03591e53823c3d6a7792b030bb4cbfa6b6916d8 Mon Sep 17 00:00:00 2001 From: "kevin.w.wall" Date: Wed, 28 Aug 2013 03:27:06 +0000 Subject: [PATCH 007/812] Fix Javadoc comment for encodeForJavaScript() method. --- src/main/java/org/owasp/esapi/Encoder.java | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/src/main/java/org/owasp/esapi/Encoder.java b/src/main/java/org/owasp/esapi/Encoder.java index 168fb32ca..8a0ccd94e 100644 --- a/src/main/java/org/owasp/esapi/Encoder.java +++ b/src/main/java/org/owasp/esapi/Encoder.java @@ -294,11 +294,11 @@ public interface Encoder { * as input – even if the user input is encoded. * * For example: - * + * 

      *  
-     * 
+     *
* @param input * the text to encode for JavaScript * From 41138fef5f63d9cf0d5e05d2bee2c7f682ffef3f Mon Sep 17 00:00:00 2001 From: "kevin.w.wall" Date: Thu, 29 Aug 2013 00:49:41 +0000 Subject: [PATCH 008/812] Fix for Google Issue #306 and changes to address the side effects of the fix (i.e., the removal of the deprecated ESAPI 1.4 encrypt() / decrypt() methods from the Encryptor interface). --- src/main/java/org/owasp/esapi/Encryptor.java | 122 +----------------- .../org/owasp/esapi/crypto/CipherText.java | 24 ++-- .../esapi/crypto/CipherTextSerializer.java | 6 +- .../esapi/crypto/KeyDerivationFunction.java | 7 +- .../esapi/reference/crypto/JavaEncryptor.java | 78 +---------- 5 files changed, 31 insertions(+), 206 deletions(-) diff --git a/src/main/java/org/owasp/esapi/Encryptor.java b/src/main/java/org/owasp/esapi/Encryptor.java index 7d651ef31..35bf094dd 100644 --- a/src/main/java/org/owasp/esapi/Encryptor.java +++ b/src/main/java/org/owasp/esapi/Encryptor.java @@ -105,75 +105,12 @@ public interface Encryptor { */ String hash(String plaintext, String salt, int iterations) throws EncryptionException; - /** - * Encrypts the provided plaintext and returns a ciphertext string using the - * master secret key and default cipher transformation. - *

- * Compatibility with earlier ESAPI versions: The symmetric encryption - * in ESAPI 2.0 and later is not compatible with the encryption in ESAPI 1.4 - * or earlier. Not only are the interfaces slightly different, but they format - * of the serialized encrypted data is incompatible. Therefore, if you have - * encrypted data with ESAPI 1.4 or earlier, you must first encrypt it and - * then re-encrypt it with ESAPI 2.0. Backward compatibility with ESAPI 1.4 - * was proposed to both the ESAPI Developers and ESAPI Users mailing lists - * and voted down. More details are available in the ESAPI document - * - * Why Is OWASP Changing ESAPI Encryption? - *

- * Why this method is deprecated: Most cryptographers strongly suggest - * that if you are creating crypto functionality for general-purpose use, - * at a minimum you should ensure that it provides authenticity, integrity, - * and confidentiality. This method only provides confidentiality, but not - * authenticity or integrity. Therefore, you are encouraged to use - * one of the other encryption methods referenced below. Because this - * method provides neither authenticity nor integrity, it may be - * removed in some future ESAPI Java release. Note: there are some cases - * where authenticity / integrity are not that important. For instance, consider - * a case where the encrypted data is never out of your application's control. For - * example, if you receive data that your application is encrypting itself and then - * storing the encrypted data in its own database for later use (and no other - * applications can query or update that column of the database), providing - * confidentiality alone might be sufficient. However, if there are cases - * where your application will be sending or receiving already encrypted data - * over an insecure, unauthenticated channel, in such cases authenticity and - * integrity of the encrypted data likely is important and this method should - * be avoided in favor of one of the other two. - * - * @param plaintext - * the plaintext {@code String} to encrypt. Note that if you are encrypting - * general bytes, you should encypt that byte array to a String using - * "UTF-8" encoding. - * - * @return - * the encrypted, base64-encoded String representation of 'plaintext' plus - * the random IV used. - * - * @throws EncryptionException - * if the specified encryption algorithm could not be found or another problem exists with - * the encryption of 'plaintext' - * - * @see #encrypt(PlainText) - * @see #encrypt(SecretKey, PlainText) - * - * @deprecated As of 1.4.2; use {@link #encrypt(PlainText)} instead, which - * also ensures message authenticity. This method will be - * completely removed as of the next major release or point - * release (3.0 or 2.1, whichever comes first) as per OWASP - * deprecation policy. - */ - @Deprecated String encrypt(String plaintext) throws EncryptionException; - /** * Encrypts the provided plaintext bytes using the cipher transformation * specified by the property Encryptor.CipherTransformation * and the master encryption key as specified by the property * {@code Encryptor.MasterKey} as defined in the ESAPI.properties file. - *

- * This method is preferred over {@link #encrypt(String)} because it also - * allows encrypting of general byte streams rather than simply strings and - * also because it returns a {@code CipherText} object and thus supports - * cipher modes that require an Initialization Vector (IV), such as - * Cipher Block Chaining (CBC). + *

* * @param plaintext The {@code PlainText} to be encrypted. * @return the {@code CipherText} object from which the raw ciphertext, the @@ -217,68 +154,11 @@ public interface Encryptor { CipherText encrypt(SecretKey key, PlainText plaintext) throws EncryptionException; - /** - * Decrypts the provided ciphertext and returns a plaintext string using the - * master secret key and default cipher transformation. - *

- * Compatibility with earlier ESAPI versions: The symmetric encryption - * in ESAPI 2.0 and later is not compatible with the encryption in ESAPI 1.4 - * or earlier. Not only are the interfaces slightly different, but they format - * of the serialized encrypted data is incompatible. Therefore, if you have - * encrypted data with ESAPI 1.4 or earlier, you must first encrypt it and - * then re-encrypt it with ESAPI 2.0. Backward compatibility with ESAPI 1.4 - * was proposed to both the ESAPI Developers and ESAPI Users mailing lists - * and voted down. More details are available in the ESAPI document - * - * Why Is OWASP Changing ESAPI Encryption? - *

- * Why this method is deprecated: Most cryptographers strongly suggest - * that if you are creating crypto functionality for general-purpose use, - * at a minimum you should ensure that it provides authenticity, integrity, - * and confidentiality. This method only provides confidentiality, but not - * authenticity or integrity. Therefore, you are encouraged to use - * one of the other encryption methods referenced below. Because this - * method provides neither authenticity nor integrity, it may be - * removed in some future ESAPI Java release. Note: there are some cases - * where authenticity / integrity are not that important. For instance, consider - * a case where the encrypted data is never out of your application's control. For - * example, if you receive data that your application is encrypting itself and then - * storing the encrypted data in its own database for later use (and no other - * applications can query or update that column of the database), providing - * confidentiality alone might be sufficient. However, if there are cases - * where your application will be sending or receiving already encrypted data - * over an insecure, unauthenticated channel, in such cases authenticity and - * integrity of the encrypted data likely is important and this method should - * be avoided in favor of one of the other two. - * - * @param ciphertext - * the ciphertext (the encrypted plaintext) that resulted from - * encrypting using the method {@link #encrypt(String)}. - * - * @return - * the decrypted ciphertext (i.e., the corresponding plaintext). - * - * @throws EncryptionException - * if the specified encryption algorithm could not be found or another problem exists with - * the decryption of 'plaintext' - * - * @deprecated As of 1.4.2; use {@link #decrypt(CipherText)} instead, which - * also ensures message authenticity. This method will be - * completely removed as of the next major release or point - * release (3.0 or 2.1, whichever comes first) as per OWASP - * deprecation policy. - */ - @Deprecated String decrypt(String ciphertext) throws EncryptionException; - /** * Decrypts the provided {@link CipherText} using the information from it * and the master encryption key as specified by the property * {@code Encryptor.MasterKey} as defined in the {@code ESAPI.properties} * file. - *

- * This decrypt method is to be preferred over the deprecated - * {@link #decrypt(String)} method because this method can handle plaintext - * bytes that were encrypted with cipher modes requiring IVs, such as CBC. *

* @param ciphertext The {@code CipherText} object to be decrypted. * @return The {@code PlainText} object resulting from decrypting the specified diff --git a/src/main/java/org/owasp/esapi/crypto/CipherText.java b/src/main/java/org/owasp/esapi/crypto/CipherText.java index 629002e08..689ef1c21 100644 --- a/src/main/java/org/owasp/esapi/crypto/CipherText.java +++ b/src/main/java/org/owasp/esapi/crypto/CipherText.java @@ -65,7 +65,9 @@ public final class CipherText implements Serializable { // reflected in the class CipherTextSerializer. // This should be *same* version as in CipherTextSerializer and KeyDerivationFunction. // If one changes, the other should as well to accommodate any differences. - public static final int cipherTextVersion = 20110203; // Format: YYYYMMDD, max is 99991231. + // Previous versions: 20110203 - Original version (ESAPI releases 2.0 & 2.0.1) + // 20130830 - Fix to issue #306 (release 2.1.0) + public static final int cipherTextVersion = 20130830; // Format: YYYYMMDD, max is 99991231. // Required by Serializable classes. private static final long serialVersionUID = cipherTextVersion; // Format: YYYYMMDD @@ -435,21 +437,23 @@ void storeSeparateMAC(byte[] macValue) { * @return True if the ciphertext has not be tampered with, and false otherwise. */ public boolean validateMAC(SecretKey authKey) { - boolean usesMAC = ESAPI.securityConfiguration().useMACforCipherText(); + boolean requiresMAC = ESAPI.securityConfiguration().useMACforCipherText(); - if ( usesMAC && macComputed() ) { // Uses MAC and it was computed + if ( requiresMAC && macComputed() ) { // Uses MAC and it was computed // Calculate MAC from HMAC-SHA1(nonce, IV + plaintext) and // compare to stored value (separate_mac_). If same, then return true, // else return false. byte[] mac = computeMAC(authKey); assert mac.length == separate_mac_.length : "MACs are of differnt lengths. Should both be the same."; return CryptoHelper.arrayCompare(mac, separate_mac_); // Safe compare!!! - } else if ( ! usesMAC ) { // Doesn't use MAC + } else if ( ! requiresMAC ) { // Doesn't require a MAC return true; - } else { // Uses MAC but it has not been computed / stored. - logger.warning(Logger.SECURITY_FAILURE, "Cannot validate MAC as it was never computed and stored. " + - "Decryption result may be garbage even when decryption succeeds."); - return true; // Need to return 'true' here because of encrypt() / decrypt() methods don't support this. + } else { + // This *used* to be the case (for versions 2.0 and 2.0.1) where we tried to + // accomodate the deprecated decrypt() method from ESAPI 1.4. Unfortunately, + // that was an EPIC FAIL. (See Google Issue # 306 for details.) + logger.warning(Logger.SECURITY_FAILURE, "MAC may have been tampered with (e.g., length set to 0)."); + return false; // Deprecated decrypt() method removed, so now return false. } } @@ -474,8 +478,8 @@ public byte[] asPortableSerializedByteArray() throws EncryptionException { // If we are supposed to be using a (separate) MAC, also make sure // that it has been computed/stored. - boolean usesMAC = ESAPI.securityConfiguration().useMACforCipherText(); - if ( usesMAC && ! macComputed() ) { + boolean requiresMAC = ESAPI.securityConfiguration().useMACforCipherText(); + if ( requiresMAC && ! macComputed() ) { String msg = "Programming error: MAC is required for this cipher mode (" + getCipherMode() + "), but MAC has not yet been " + "computed and stored. Call the method " + diff --git a/src/main/java/org/owasp/esapi/crypto/CipherTextSerializer.java b/src/main/java/org/owasp/esapi/crypto/CipherTextSerializer.java index ca4d4ac16..b00dd245c 100644 --- a/src/main/java/org/owasp/esapi/crypto/CipherTextSerializer.java +++ b/src/main/java/org/owasp/esapi/crypto/CipherTextSerializer.java @@ -32,7 +32,9 @@ public class CipherTextSerializer { // This should be *same* version as in CipherText & KeyDerivationFunction. // If one changes, the other should as well to accommodate any differences. - public static final int cipherTextSerializerVersion = 20110203; // Format: YYYYMMDD, max is 99991231. + // Previous versions: 20110203 - Original version (ESAPI releases 2.0 & 2.0.1) + // 20130830 - Fix to issue #306 (release 2.1.0) + public static final int cipherTextSerializerVersion = 20130830; // Format: YYYYMMDD, max is 99991231. private static final long serialVersionUID = cipherTextSerializerVersion; private static final Logger logger = ESAPI.getLogger("CipherTextSerializer"); @@ -234,7 +236,7 @@ private CipherText convertToCipherText(byte[] cipherTextSerializedBytes) debug("kdfPrf: " + kdfPrf); assert kdfPrf >= 0 && kdfPrf <= 15 : "kdfPrf == " + kdfPrf + " must be between 0 and 15."; int kdfVers = ( kdfInfo & 0x07ffffff); - assert kdfVers > 0 && kdfVers <= 99991231 : "KDF Version (" + kdfVers + ") out of range."; // Really should be >= 20110203 (earliest). + assert kdfVers >= 20110203 && kdfVers <= 99991231 : "KDF Version (" + kdfVers + ") out of range."; // 20110203 (orig version). debug("convertToCipherText: kdfPrf = " + kdfPrf + ", kdfVers = " + kdfVers); if ( kdfVers != CipherText.cipherTextVersion ) { // NOTE: In future, support backward compatibility via this mechanism. When we do this diff --git a/src/main/java/org/owasp/esapi/crypto/KeyDerivationFunction.java b/src/main/java/org/owasp/esapi/crypto/KeyDerivationFunction.java index 90807199f..40c095b89 100644 --- a/src/main/java/org/owasp/esapi/crypto/KeyDerivationFunction.java +++ b/src/main/java/org/owasp/esapi/crypto/KeyDerivationFunction.java @@ -49,12 +49,15 @@ public class KeyDerivationFunction { * {@link CipherTextSerializer#cipherTextSerializerVersion} to make sure * that these classes are all kept in-sync in order to support backward * compatibility of previously encrypted data. - * + * 
+	 * Previous versions:	20110203 - Original version (ESAPI releases 2.0 & 2.0.1)
+	 *					    20130830 - Fix to issue #306 (release 2.1.0)
+	 *
* @see CipherTextSerializer#asSerializedByteArray() * @see CipherText#asPortableSerializedByteArray() * @see CipherText#fromPortableSerializedBytes(byte[]) */ - public static final int kdfVersion = 20110203; // Format: YYYYMMDD, max is 99991231. + public static final int kdfVersion = 20130830; // Format: YYYYMMDD, max is 99991231. private static final long serialVersionUID = kdfVersion; // Format: YYYYMMDD // Pseudo-random function algorithms suitable for NIST KDF in counter mode. diff --git a/src/main/java/org/owasp/esapi/reference/crypto/JavaEncryptor.java b/src/main/java/org/owasp/esapi/reference/crypto/JavaEncryptor.java index 68a4cf644..064fa932c 100644 --- a/src/main/java/org/owasp/esapi/reference/crypto/JavaEncryptor.java +++ b/src/main/java/org/owasp/esapi/reference/crypto/JavaEncryptor.java @@ -329,28 +329,6 @@ public String hash(String plaintext, String salt, int iterations) throws Encrypt throw new EncryptionException("Internal error", "Can't find encoding for " + encoding, ex); } } - - /** - * Convenience method that encrypts plaintext strings the new way (default - * is CBC mode and PKCS5 padding). This encryption method uses the master - * encryption key specified by the {@code Encryptor.MasterKey} property - * in {@code ESAPI.properties}. - * - * @param plaintext A String to be encrypted - * @return A base64-encoded combination of IV + raw ciphertext - * @throws EncryptionException Thrown when something goes wrong with the - * encryption. - * - * @see org.owasp.esapi.Encryptor#encrypt(PlainText) - */ - @Deprecated public String encrypt(String plaintext) throws EncryptionException - { - logWarning("encrypt", "Calling deprecated encrypt() method."); - CipherText ct = null; - ct = encrypt(new PlainText(plaintext) ); - return ct.getEncodedIVCipherText(); - } - /** * {@inheritDoc} @@ -366,10 +344,15 @@ public CipherText encrypt(PlainText plaintext) throws EncryptionException { public CipherText encrypt(SecretKey key, PlainText plain) throws EncryptionException { + if ( key == null ) { + throw new IllegalArgumentException("(Master) encryption key arg may not be null. Is Encryptor.MasterKey set?"); + } + if ( plain == null ) { + throw new IllegalArgumentException("PlainText may arg not be null"); + } byte[] plaintext = plain.asBytes(); boolean overwritePlaintext = ESAPI.securityConfiguration().overwritePlainText(); - assert key != null : "(Master) encryption key may not be null"; - + boolean success = false; // Used in 'finally' clause. String xform = null; int keySize = key.getEncoded().length * 8; // Convert to # bits @@ -569,53 +552,6 @@ public CipherText encrypt(SecretKey key, PlainText plain) } } - /** - * Convenience method that decrypts previously encrypted plaintext strings - * that were encrypted using the new encryption mechanism (with CBC mode and - * PKCS5 padding by default). This decryption method uses the master - * encryption key specified by the {@code Encryptor.MasterKey} property - * in {@code ESAPI.properties}. - * - * @param b64IVCiphertext A base64-encoded representation of the - * IV + raw ciphertext string to be decrypted with - * the default master key. - * @return The plaintext string prior to encryption. - * @throws EncryptionException When something fails with the decryption. - * - * @see org.owasp.esapi.Encryptor#decrypt(CipherText) - */ - @Deprecated public String decrypt(String b64IVCiphertext) throws EncryptionException - { - logWarning("decrypt", "Calling deprecated decrypt() method."); - CipherText ct = null; - try { - // We assume that the default cipher transform was used to encrypt this. - ct = new CipherText(); - - // Need to base64 decode the IV+ciphertext and extract the IV to set it in CipherText object. - byte[] ivPlusRawCipherText = ESAPI.encoder().decodeFromBase64(b64IVCiphertext); - int blockSize = ct.getBlockSize(); // Size in bytes. - byte[] iv = new byte[ blockSize ]; - CryptoHelper.copyByteArray(ivPlusRawCipherText, iv, blockSize); // Copy the first blockSize bytes into iv array - int cipherTextSize = ivPlusRawCipherText.length - blockSize; - byte[] rawCipherText = new byte[ cipherTextSize ]; - System.arraycopy(ivPlusRawCipherText, blockSize, rawCipherText, 0, cipherTextSize); - ct.setIVandCiphertext(iv, rawCipherText); - - // Now the CipherText object should be prepared to use it to decrypt. - PlainText plaintext = decrypt(ct); - return plaintext.toString(); // Convert back to a Java String - } catch (UnsupportedEncodingException e) { - // Should never happen; UTF-8 should be in rt.jar. - logger.error(Logger.SECURITY_FAILURE, "UTF-8 encoding not available! Decryption failed.", e); - return null; // CHECKME: Or re-throw or what? Could also use native encoding, but that's - // likely to cause unexpected and undesired effects far downstream. - } catch (IOException e) { - logger.error(Logger.SECURITY_FAILURE, "Base64 decoding of IV+ciphertext failed. Decryption failed.", e); - return null; - } - } - /** * {@inheritDoc} */ From 71d5b77b3da12028acf4291e9438b3e3a8825414 Mon Sep 17 00:00:00 2001 From: "kevin.w.wall" Date: Thu, 29 Aug 2013 00:51:29 +0000 Subject: [PATCH 009/812] Update ESAPI release number. --- pom.xml | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/pom.xml b/pom.xml index c48a1908f..2de9b9a73 100644 --- a/pom.xml +++ b/pom.xml @@ -3,7 +3,7 @@ 4.0.0 org.owasp.esapi esapi - 2.0.2-SNAPSHOT + 2.1.0 jar @@ -106,8 +106,8 @@ - Kevin Wall - Qwest + Kevin W. Wall + Wells Fargo Project Manager Architect From bfed966e11fe6f860347a129d1191e8c59f483a3 Mon Sep 17 00:00:00 2001 From: "kevin.w.wall" Date: Thu, 29 Aug 2013 00:53:43 +0000 Subject: [PATCH 010/812] Replace assertion with IllegalArgumentException when argument to CTOR is null. --- src/main/java/org/owasp/esapi/crypto/PlainText.java | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/src/main/java/org/owasp/esapi/crypto/PlainText.java b/src/main/java/org/owasp/esapi/crypto/PlainText.java index fa88d1d0c..bfa9fd3a2 100644 --- a/src/main/java/org/owasp/esapi/crypto/PlainText.java +++ b/src/main/java/org/owasp/esapi/crypto/PlainText.java @@ -38,10 +38,14 @@ public final class PlainText implements Serializable { * Construct a {@code PlainText} object from a {@code String}. * @param str The {@code String} that is converted to a UTF-8 encoded * byte array to create the {@code PlainText} object. + * @throws IllegalArgumentException If {@code str} argument is null. */ public PlainText(String str) { try { assert str != null : "String for plaintext cannot be null."; + if ( str == null ) { + throw new IllegalArgumentException("String for plaintext may not be null!"); + } rawBytes = str.getBytes("UTF-8"); } catch (UnsupportedEncodingException e) { // Should never happen. From 41e8903ebb3ba4f335cc71e2d1d00b36b72862d4 Mon Sep 17 00:00:00 2001 From: "kevin.w.wall" Date: Thu, 29 Aug 2013 00:54:52 +0000 Subject: [PATCH 011/812] Update documentation to reflect ESAPI 2.1.0 release. --- documentation/esapi4java-2.0-readme.txt | 1 + .../esapi4java-core-2.1-release-notes.txt | 53 +++++++++++++++++++ 2 files changed, 54 insertions(+) create mode 100644 documentation/esapi4java-core-2.1-release-notes.txt diff --git a/documentation/esapi4java-2.0-readme.txt b/documentation/esapi4java-2.0-readme.txt index 7806c393e..de7c40dda 100644 --- a/documentation/esapi4java-2.0-readme.txt +++ b/documentation/esapi4java-2.0-readme.txt @@ -31,6 +31,7 @@ File / Directory Descript | |---esapi4java-core-2.0-crypto-design-goals.doc (draft) Describes ESAPI 2.0 crypto design goals & design decisions | |---esapi4java-core-2.0-readme-crypto-changes.html Describes why crypto was changed from what was in ESAPI 1.4 | |---esapi4java-core-2.0-symmetric-crypto-user-guide.html User guide for using symmetric encryption in ESAPI 2.0 +| |---esapi4java-core-2.1-release-notes.txt ESAPI 2.1 release notes | `---esapi4java-waf-2.0-policy-file-spec.pdf Describes how to configure ESAPI 2.0's Web Application Firewall | |---libs/ ESAPI dependencies diff --git a/documentation/esapi4java-core-2.1-release-notes.txt b/documentation/esapi4java-core-2.1-release-notes.txt new file mode 100644 index 000000000..b5b04897f --- /dev/null +++ b/documentation/esapi4java-core-2.1-release-notes.txt @@ -0,0 +1,53 @@ +ESAPI for Java - 2.1.0 Release Notes + +1) Fixed security issue #306, a vulnerability discovered by Phillipe Arteau. + This fix necessitated removing the deprecated encrypt() and decrupt() methods + that were intended to provide backward compatibility with ESAPI 1.4. + As it turns out, there was no way to fix this bug without a major rewrite + unless these methods were removed. However, as these two methods have been + deprecated more than 2 years ago and they are known to be insecure + (they are vulnerable to padding oracle attacks), the ESAPI team has + decided to remove them in accordance to their support policy. + + See comments for issue #306 for further details, as well as additional + safety precautions that you may wish to take in the unlikely, but possible + event that this vulnerability resulted in an actual security breach. + + Finally, since the removal of these methods constitute an interface change + (to the Encryptor interface), this is considered a minor release (2.1) + rather than simply a patch release (2.0.2). + + Please note that there are further updates planned to further strengthen + the MAC that ESAPI crypt uses. However, because they will require some + design changes, they may not be out for another month. Note that these + fixes do not correct any *known* vulnerabilities, but will address + some potential weaknesses in what is not included in the MAC (such as + the crypto version). + +2) Other Google Issues fixed: 257, 271, and 292 are all fixed in this release. + +3) Fixed Javadoc for Encoder.encryptForJavaScript(). [Revision r1879] + +4) DefaultEncryptedProperties - made minor javadoc changes. + +5) The ESAPI 2.0 Encryptor.encrypt() methods now all throw an appropriate + IllegalArgumentException if any of the arguments are null. Previously, + if any of the arguments were null you would either get an AssertionError + (if you had assertions enabled) or a default NullPointerException when + assertions were disabled. While IllegalArgumentException is still an + unchecked RuntimeException, note that if you were previously catching + NullPointerExceptions for these cases, you may need to change your code. + +6) Other miscellaneous minor code clean-up, mostly to remove compiler warnings. + +NOTE: A follow-up patch release is scheduled within the next few months to + address some questionable design decisions regarding what data in + the serialized ciphertext should be authenticated via the MAC. For + instance, presently only the IV+ciphertext is MAC'd (as would be the + equivalent case of when you would use an authenticated combined cipher + mode such as GCM or CCM). A deeper analysis of the design is required + based on findings in Google Issue # 306. I will periodically try + to keep the ESAPI mailing lists updated with the progress so watch + there for emerging details and anticipated schedule. + +-Kevin W. Wall , 2013-08-30 From a8b4022f284cd67239439eb51c6d2cc18fe0a834 Mon Sep 17 00:00:00 2001 From: "kevin.w.wall" Date: Thu, 29 Aug 2013 00:56:49 +0000 Subject: [PATCH 012/812] New JUnit test, based on Philippe Arteau's orignial exploit, that shows Google Issue # 306 has been fixed. --- .../crypto/ESAPICryptoMACByPassTest.java | 232 ++++++++++++++++++ 1 file changed, 232 insertions(+) create mode 100644 src/test/java/org/owasp/esapi/crypto/ESAPICryptoMACByPassTest.java diff --git a/src/test/java/org/owasp/esapi/crypto/ESAPICryptoMACByPassTest.java b/src/test/java/org/owasp/esapi/crypto/ESAPICryptoMACByPassTest.java new file mode 100644 index 000000000..34878c705 --- /dev/null +++ b/src/test/java/org/owasp/esapi/crypto/ESAPICryptoMACByPassTest.java @@ -0,0 +1,232 @@ +/* + * OWASP Enterprise Security API (ESAPI) - Google issue # 306. + * + * This file is part of the Open Web Application Security Project (OWASP) + * Enterprise Security API (ESAPI) project. For details, please see + * http://www.owasp.org/index.php/ESAPI. + * + * Copyright (c) 2013 - The OWASP Foundation + * ESAPI is published by OWASP under the new BSD license. You should read + * and accept the LICENSE before you use, modify, and/or redistribute this + * software. + * + * Full credit for this JUnit to illustrate what is now Google Issue # 306 + * goes to Philippe Arteau . Originally + * published 2013/08/21 to ESAPI-DEV mailing list. Shows that both + * ESAPI 2.0 and 2.0.1 is vulnerable. Minor tweaks by Kevin W. Wall. + * + * Original class name: SignatureByPassTest. + * + * NOTE: If this test fails, your version of ESAPI is vulnerable (or you have + * it configured not to require a MAC which you should NOT do). + */ + +package org.owasp.esapi.crypto; + +import org.apache.commons.codec.binary.Hex; +import org.owasp.esapi.ESAPI; +import org.owasp.esapi.crypto.CipherText; +import org.owasp.esapi.crypto.PlainText; +import org.owasp.esapi.errors.EncryptionException; +import org.owasp.esapi.util.ByteConversionUtil; + +import javax.crypto.SecretKey; +import javax.crypto.spec.SecretKeySpec; +import java.io.ByteArrayOutputStream; +import java.io.UnsupportedEncodingException; +import java.lang.reflect.Field; +import java.security.NoSuchAlgorithmException; +import java.security.spec.InvalidKeySpecException; +import java.util.Date; + +import static org.junit.Assert.*; +import org.junit.Before; +import org.junit.Test; + + +public class ESAPICryptoMACByPassTest { + + @Before + public void setUp() throws NoSuchAlgorithmException, InvalidKeySpecException { + ; // Do any prerequisite setup here. + } + + @Test + public void testMacBypass() throws EncryptionException, NoSuchFieldException, IllegalAccessException { + + byte[] bkey = {0x00,0x01,0x02,0x03,0x04,0x05,0x06,0x07,0x08,0x09,0xA,0x0B,0x0C,0x0D,0x0E,0x0F}; //Truly random key. + SecretKey sk = new SecretKeySpec(bkey,"AES"); + + //Encryption with MAC + String originalMessage = "Cryptography!?!?"; + System.out.printf("Encrypting the message '%s'\n", originalMessage); + // Until there is a better way to do this. But this is much easier + // than having to set up a custom ESAPI.properties file just for + // this test. + // + // NOTE: Philippe Arteau's original exploit used "AES/OFB/NoPadding" + // so that one could see that the effect of the decryption would + // be "Craptography!?!?". However, if you wish to do that, then + // you must also change the ESAPI.properties file used by ESAPI + // JUnit tests sp that "OFB" is accepted as an allowed cipher + // mode. The easiest way to do that (if you are still not convinced) + // is to add "OFB" mode to Encryptor.cipher_modes.additional_allowed; + // e.g., Encryptor.cipher_modes.additional_allowed=CBC,OFB + // + String origCipherXform = + ESAPI.securityConfiguration().setCipherTransformation("AES/CBC/NoPadding"); + CipherText ct = ESAPI.encryptor().encrypt(sk,new PlainText(originalMessage)); + ct.computeAndStoreMAC(sk); + + //Serialize the ciphertext in order to send it over the wire.. + byte[] serializedCt = ct.asPortableSerializedByteArray(); + + //Malicious modification + byte[] modifiedCt = tamperCipherText(serializedCt); + + //Decrypt + CipherText modifierCtObj = CipherText.fromPortableSerializedBytes(modifiedCt); + try { + ESAPI.securityConfiguration().setCipherTransformation(origCipherXform); + // This decryption should fail by throwing an EncryptionException + // if ESAPI crypto is NOT vulnerable and you never get to the + // subsequent lines in the try block. + PlainText pt = ESAPI.encryptor().decrypt(sk,modifierCtObj); + System.out.printf("Decrypting to '%s' (probably will look like garbage!)\n", new String(pt.asBytes())); + System.out.println("This ESAPI version vulnerable to MAC by-pass described in Google issue # 306! Upgrade to latest version."); + fail("This ESAPI version is vulnerable to MAC by-pass described in Google issue # 306! Upgrade to latest version."); + } catch(EncryptionException eex) { + String errMsg = eex.getMessage(); + // See private String DECRYPTION_FAILED in JavaEncryptor. + String expectedError = "Decryption failed; see logs for details."; + assertTrue( errMsg.equals(expectedError) ); + System.out.println("testMacByPass(): Attempted decryption after MAC tampering failed."); + System.out.println("Fix of issue # 306 successful. Crypto MAC by-pass test failed; exception was: [" + eex + "]"); + } + } + + /** + * The modification of the ciphertext is done in a separate method to show that only the generate CipherText object is use. + * @param serializeCt + */ + private byte[] tamperCipherText(byte[] serializeCt) throws EncryptionException, NoSuchFieldException, IllegalAccessException { + CipherText ct = CipherText.fromPortableSerializedBytes(serializeCt); + + //Ciphertext metadata + //System.out.println(ct.toString()); + + byte[] cipherTextMod = ct.getRawCipherText(); + + System.out.printf("Original ciphertext\t'%s'\n",String.valueOf(Hex.encodeHex(cipherTextMod))); + + cipherTextMod[2] ^= 'y' ^ 'a'; //Alter the 3rd character + + System.out.printf("Modify ciphertext\t'%s'\n",String.valueOf(Hex.encodeHex(cipherTextMod))); + + //MAC ... what MAC ? + Field f2 = ct.getClass().getDeclaredField("separate_mac_"); + f2.setAccessible(true); + f2.set(ct,null); //mac byte array set to null + + //Changing CT + Field f3 = ct.getClass().getDeclaredField("raw_ciphertext_"); + f3.setAccessible(true); + f3.set(ct,cipherTextMod); + + //return ct.asPortableSerializedByteArray(); //Will complain about missing mac + //return new CipherTextSerializer(ct).asSerializedByteArray(); //NPE on mac.length + return serialize(ct); //Modify version of CipherTextSerializer.asSerializedByteArray() + } + + ///////////////////////////////////////////////////////////////////// + // The following code is a modified version of CipherTextSerializer + ///////////////////////////////////////////////////////////////////// + + private byte[] serialize(CipherText cipherText_) { + int kdfInfo = cipherText_.getKDFInfo(); + + long timestamp = cipherText_.getEncryptionTimestamp(); + String cipherXform = cipherText_.getCipherTransformation(); + + short keySize = (short) cipherText_.getKeySize(); + + short blockSize = (short)cipherText_.getBlockSize(); + byte[] iv = cipherText_.getIV(); + + short ivLen = (short)iv.length; + byte[] rawCiphertext = cipherText_.getRawCipherText(); + int ciphertextLen = rawCiphertext.length; + + byte[] mac = cipherText_.getSeparateMAC(); + + short macLen = 0;//(short)mac.length; //<-------------- The only modification to the serialization + + return computeSerialization(kdfInfo, timestamp, cipherXform, keySize, blockSize, ivLen, iv, ciphertextLen, rawCiphertext, macLen, mac); + } + + private byte[] computeSerialization(int kdfInfo, long timestamp, String cipherXform, short keySize, short blockSize, short ivLen, byte[] iv, int ciphertextLen, byte[] rawCiphertext, short macLen, byte[] mac) + { + debug("computeSerialization: kdfInfo = " + kdfInfo); + debug("computeSerialization: timestamp = " + new Date(timestamp)); + debug("computeSerialization: cipherXform = " + cipherXform); + debug("computeSerialization: keySize = " + keySize); + debug("computeSerialization: blockSize = " + blockSize); + debug("computeSerialization: ivLen = " + ivLen); + debug("computeSerialization: ciphertextLen = " + ciphertextLen); + debug("computeSerialization: macLen = " + macLen); + + ByteArrayOutputStream baos = new ByteArrayOutputStream(); + writeInt(baos, kdfInfo); + writeLong(baos, timestamp); + String[] parts = cipherXform.split("/"); + assert (parts.length == 3) : "Malformed cipher transformation"; + writeString(baos, cipherXform); + writeShort(baos, keySize); + writeShort(baos, blockSize); + writeShort(baos, ivLen); + if (ivLen > 0) baos.write(iv, 0, iv.length); + writeInt(baos, ciphertextLen); + baos.write(rawCiphertext, 0, rawCiphertext.length); + writeShort(baos, macLen); + if (macLen > 0) baos.write(mac, 0, mac.length); + return baos.toByteArray(); + } + + private static void debug(String msg) { + // System.err.println(msg); + } + + private void writeShort(ByteArrayOutputStream baos, short s) { + byte[] shortAsByteArray = ByteConversionUtil.fromShort(s); + assert (shortAsByteArray.length == 2); + baos.write(shortAsByteArray, 0, 2); + } + + private void writeInt(ByteArrayOutputStream baos, int i) { + byte[] intAsByteArray = ByteConversionUtil.fromInt(i); + baos.write(intAsByteArray, 0, 4); + } + + private void writeLong(ByteArrayOutputStream baos, long l) { + byte[] longAsByteArray = ByteConversionUtil.fromLong(l); + assert (longAsByteArray.length == 8); + baos.write(longAsByteArray, 0, 8); + } + + private void writeString(ByteArrayOutputStream baos, String str) + { + try + { + assert ((str != null) && (str.length() > 0)); + byte[] bytes = str.getBytes("UTF8"); + assert (bytes.length < 32767) : "writeString: String exceeds max length"; + writeShort(baos, (short)bytes.length); + baos.write(bytes, 0, bytes.length); + } + catch (UnsupportedEncodingException e) + { + System.err.println("writeString: " + e.getMessage()); + } + } + +} \ No newline at end of file From fc4e6375ec7b8830440372f6470b6028fc3ebea4 Mon Sep 17 00:00:00 2001 From: "kevin.w.wall" Date: Thu, 29 Aug 2013 00:58:32 +0000 Subject: [PATCH 013/812] Added comment about why ECB is there as an allowed cipher mode. (Hint: It's for testing!) --- src/test/resources/esapi/ESAPI.properties | 1 + 1 file changed, 1 insertion(+) diff --git a/src/test/resources/esapi/ESAPI.properties b/src/test/resources/esapi/ESAPI.properties index d6f93f1da..1435b7c6d 100644 --- a/src/test/resources/esapi/ESAPI.properties +++ b/src/test/resources/esapi/ESAPI.properties @@ -239,6 +239,7 @@ Encryptor.cipher_modes.combined_modes=GCM,CCM,IAPM,EAX,OCB,CWC # since the logic is somewhat different (i.e., ECB mode does # not use an IV). # DISCUSS: Better name? +# NOTE: ECB added only for testing purposes. Don't try this at home! Encryptor.cipher_modes.additional_allowed=CBC,ECB # 128-bit is almost always sufficient and appears to be more resistant to From 66f0d85f2efabd980246b7991185cf5d0bb39ab9 Mon Sep 17 00:00:00 2001 From: "kevin.w.wall" Date: Thu, 29 Aug 2013 01:00:55 +0000 Subject: [PATCH 014/812] Fix typo in test case name. (Spell much?) --- src/test/java/org/owasp/esapi/crypto/CryptoTokenTest.java | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/test/java/org/owasp/esapi/crypto/CryptoTokenTest.java b/src/test/java/org/owasp/esapi/crypto/CryptoTokenTest.java index 330f88f0b..f81986550 100644 --- a/src/test/java/org/owasp/esapi/crypto/CryptoTokenTest.java +++ b/src/test/java/org/owasp/esapi/crypto/CryptoTokenTest.java @@ -330,7 +330,7 @@ public final void testSetAndGetAttribute() { // public void addAttributes(final Map attrs) throws ValidationException // public Map getAttributes() @Test - public final void tesAddandGetAttributes() { + public final void testAddandGetAttributes() { CryptoToken ctok = new CryptoToken(); Map origAttrs = null; From ffae68a189d582773175232934783c6ab4efd169 Mon Sep 17 00:00:00 2001 From: "kevin.w.wall" Date: Thu, 29 Aug 2013 01:04:23 +0000 Subject: [PATCH 015/812] Changes required to crypto JUnit tests because old deprecated encrypt() / decrypt() methods were removed. --- .../esapi/reference/crypto/EncryptorTest.java | 98 ++++++++++--------- 1 file changed, 51 insertions(+), 47 deletions(-) diff --git a/src/test/java/org/owasp/esapi/reference/crypto/EncryptorTest.java b/src/test/java/org/owasp/esapi/reference/crypto/EncryptorTest.java index 8c205d8de..35166a3dd 100644 --- a/src/test/java/org/owasp/esapi/reference/crypto/EncryptorTest.java +++ b/src/test/java/org/owasp/esapi/reference/crypto/EncryptorTest.java @@ -56,9 +56,11 @@ public EncryptorTest(String testName) { * {@inheritDoc} * @throws Exception */ - protected void setUp() throws Exception { + @SuppressWarnings("deprecation") + protected void setUp() throws Exception { // This is only mechanism to change this for now. Will do this with - // a soon to be CryptoControls class in next release. + // a soon to be CryptoControls class or equivalent mechanism in a + // future release. ESAPI.securityConfiguration().setCipherTransformation("AES/CBC/PKCS5Padding"); } @@ -99,55 +101,52 @@ public void testHash() throws EncryptionException { } /** - * Test of deprecated encrypt method for Strings. + * Test of new encrypt / decrypt method for Strings whose length is + * not a multiple of the cipher block size (16 bytes for AES). * * @throws EncryptionException * the encryption exception */ - public void testEncrypt() throws EncryptionException { - System.out.println("testEncrypt()"); + public void testEncryptDecrypt1() throws EncryptionException { + System.out.println("testEncryptDecrypt2()"); Encryptor instance = ESAPI.encryptor(); - String plaintext = "test123456"; // Not multiple of block cipher size - String ciphertext = instance.encrypt(plaintext); - String result = instance.decrypt(ciphertext); - assertEquals(plaintext, result); + String plaintext = "test1234test1234tes"; // Not a multiple of block size (16 bytes) + try { + CipherText ct = instance.encrypt(new PlainText(plaintext)); + PlainText pt = instance.decrypt(ct); + assertTrue( pt.toString().equals(plaintext) ); + } + catch( EncryptionException e ) { + fail("testEncryptDecrypt2(): Caught exception: " + e); + } } /** - * Test of deprecated decrypt method for Strings. + * Test of new encrypt / decrypt method for Strings whose length is + * same as cipher block size (16 bytes for AES). */ - public void testDecrypt() { - System.out.println("testDecrypt()"); + public void testEncryptDecrypt2() { + System.out.println("testEncryptDecrypt2()"); Encryptor instance = ESAPI.encryptor(); + String plaintext = "test1234test1234"; try { - String plaintext = "test123"; - String ciphertext = instance.encrypt(plaintext); - assertFalse(plaintext.equals(ciphertext)); - String result = instance.decrypt(ciphertext); - assertEquals(plaintext, result); + CipherText ct = instance.encrypt(new PlainText(plaintext)); + PlainText pt = instance.decrypt(ct); + assertTrue( pt.toString().equals(plaintext) ); } catch( EncryptionException e ) { - fail(); + fail("testEncryptDecrypt2(): Caught exception: " + e); } } /** * Test of encrypt methods for empty String. - * - * @throws EncryptionException - * the encryption exception */ - @SuppressWarnings("deprecation") public void testEncryptEmptyStrings() { System.out.println("testEncryptEmptyStrings()"); Encryptor instance = ESAPI.encryptor(); String plaintext = ""; try { - // System.out.println("Deprecated encryption methods"); - String ciphertext = instance.encrypt(plaintext); - String result = instance.decrypt(ciphertext); - assertTrue( result.equals("") ); - // System.out.println("New encryption methods"); CipherText ct = instance.encrypt(new PlainText(plaintext)); PlainText pt = instance.decrypt(ct); @@ -158,23 +157,35 @@ public void testEncryptEmptyStrings() { } /** - * Test encryption / decryption methods for null. + * Test encryption method for null. */ - @SuppressWarnings("deprecation") public void testEncryptNull() { System.out.println("testEncryptNull()"); Encryptor instance = ESAPI.encryptor(); - String plaintext = ""; try { - String nullStr = null; - instance.encrypt(nullStr); - fail("testEncryptNull(): Did not result in expected exception!"); + CipherText ct = instance.encrypt( null ); // Should throw NPE or AssertionError + fail("New encrypt(PlainText) method did not throw. Result was: " + ct.toString()); } catch(Throwable t) { // It should be one of these, depending on whether or not assertions are enabled. assertTrue( t instanceof NullPointerException || t instanceof AssertionError); } } + /** + * Test decryption method for null. + */ + public void testDecryptNull() { + System.out.println("testDecryptNull()"); + Encryptor instance = ESAPI.encryptor(); + try { + PlainText pt = instance.decrypt( null ); // Should throw IllegalArgumentException or AssertionError + fail("New decrypt(PlainText) method did not throw. Result was: " + pt.toString()); + } catch(Throwable t) { + // It should be one of these, depending on whether or not assertions are enabled. + assertTrue( t instanceof IllegalArgumentException || t instanceof AssertionError); + } + } + /** * Test of new encrypt / decrypt methods added in ESAPI 2.0. */ @@ -246,7 +257,8 @@ private String runNewEncryptDecryptTestCase(String cipherXform, int keySize, byt // Change to a possibly different cipher. This is kludgey at best. Am thinking about an // alternate way to do this using a new 'CryptoControls' class. Maybe not until release 2.1. // Change the cipher transform from whatever it currently is to the specified cipherXform. - String oldCipherXform = ESAPI.securityConfiguration().setCipherTransformation(cipherXform); + @SuppressWarnings("deprecation") + String oldCipherXform = ESAPI.securityConfiguration().setCipherTransformation(cipherXform); if ( ! cipherXform.equals(oldCipherXform) ) { System.out.println("Cipher xform changed from \"" + oldCipherXform + "\" to \"" + cipherXform + "\""); } @@ -281,7 +293,8 @@ private String runNewEncryptDecryptTestCase(String cipherXform, int keySize, byt assertTrue( "Failed to decrypt properly.", origPlainText.toString().equals( decryptedPlaintext.toString() ) ); // Restore the previous cipher transformation. For now, this is only way to do this. - String previousCipherXform = ESAPI.securityConfiguration().setCipherTransformation(null); + @SuppressWarnings("deprecation") + String previousCipherXform = ESAPI.securityConfiguration().setCipherTransformation(null); assertTrue( previousCipherXform.equals( cipherXform ) ); String defaultCipherXform = ESAPI.securityConfiguration().getCipherTransformation(); assertTrue( defaultCipherXform.equals( oldCipherXform ) ); @@ -331,7 +344,8 @@ private static boolean isPlaintextOverwritten(PlainText plaintext) { // TODO - Need to test rainy day paths of new encrypt / decrypt so can // verify that exception handling working OK, etc. Maybe also in // a separate JUnit test, since everything here seems to be sunny - // day path. + // day path. (Note: Some of this no in new test case, + // org.owasp.esapi.crypto.ESAPICryptoMACByPassTest.) // // -kevin wall @@ -508,15 +522,5 @@ public void testMain() throws Exception { // and checked against (at least some of) the expected output. // Left as an exercise to some future, ambitious ESAPI developer. ;-) JavaEncryptor.main( args1 ); - } - - private boolean checkByteArray(byte[] ba, byte b) { - for(int i = 0; i < ba.length; i++ ) { - if ( ba[i] != b ) { - return false; - } - } - return true; - } - + } } From 600ecc1fc19056a56fbb31a8a0cb188b3e870ccb Mon Sep 17 00:00:00 2001 From: "kevin.w.wall" Date: Thu, 29 Aug 2013 01:19:51 +0000 Subject: [PATCH 016/812] Argh! Forgot to change test from NullPointerException to IllegalArgumentException. Always good to retest one last time. --- .../java/org/owasp/esapi/reference/crypto/EncryptorTest.java | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/test/java/org/owasp/esapi/reference/crypto/EncryptorTest.java b/src/test/java/org/owasp/esapi/reference/crypto/EncryptorTest.java index 35166a3dd..1143fd3a2 100644 --- a/src/test/java/org/owasp/esapi/reference/crypto/EncryptorTest.java +++ b/src/test/java/org/owasp/esapi/reference/crypto/EncryptorTest.java @@ -167,7 +167,7 @@ public void testEncryptNull() { fail("New encrypt(PlainText) method did not throw. Result was: " + ct.toString()); } catch(Throwable t) { // It should be one of these, depending on whether or not assertions are enabled. - assertTrue( t instanceof NullPointerException || t instanceof AssertionError); + assertTrue( t instanceof IllegalArgumentException || t instanceof AssertionError); } } From edab9e3f8b4db407a1dc5e7630fedc2e48c6809b Mon Sep 17 00:00:00 2001 From: "kevin.w.wall" Date: Fri, 30 Aug 2013 03:33:42 +0000 Subject: [PATCH 017/812] A few more minor updates have been documented. --- .../esapi4java-core-2.1-release-notes.txt | 21 ++++++++++++++++--- 1 file changed, 18 insertions(+), 3 deletions(-) diff --git a/documentation/esapi4java-core-2.1-release-notes.txt b/documentation/esapi4java-core-2.1-release-notes.txt index b5b04897f..3570d0f88 100644 --- a/documentation/esapi4java-core-2.1-release-notes.txt +++ b/documentation/esapi4java-core-2.1-release-notes.txt @@ -28,7 +28,7 @@ ESAPI for Java - 2.1.0 Release Notes 3) Fixed Javadoc for Encoder.encryptForJavaScript(). [Revision r1879] -4) DefaultEncryptedProperties - made minor javadoc changes. +4) DefaultEncryptedProperties - made minor Javadoc changes. 5) The ESAPI 2.0 Encryptor.encrypt() methods now all throw an appropriate IllegalArgumentException if any of the arguments are null. Previously, @@ -37,8 +37,23 @@ ESAPI for Java - 2.1.0 Release Notes assertions were disabled. While IllegalArgumentException is still an unchecked RuntimeException, note that if you were previously catching NullPointerExceptions for these cases, you may need to change your code. - -6) Other miscellaneous minor code clean-up, mostly to remove compiler warnings. + +6) The public constructor, CiphertextSerializer(CipherText ct), was changed + to explicitly check that the parameter is not null. Previously it had + checked with assertions which might later result in a NullPointerException + being thrown if assertions were disabled. Now if the parameter is null, + an appropriate IllegalArgumentException is thrown. This should not really + affect existing code (unless you are experimenting implementing your own + crypto) since user code should not really be using CiperTextSerializer + directly. + +7) Some of the setter methods in KeyDerivationFunction were changed to explicitly + check for invalid arguments and throw an IllegalArgumentException rather than + checking these parameters via assertions. This should not affect general + user code as most would not be calling the KeyDerivationFunction class + directly. + +8) Other miscellaneous minor code clean-up, mostly to remove compiler warnings. NOTE: A follow-up patch release is scheduled within the next few months to address some questionable design decisions regarding what data in From 602bdd096c69b38afbde655d500cb642f30a3195 Mon Sep 17 00:00:00 2001 From: "kevin.w.wall" Date: Sat, 31 Aug 2013 22:37:45 +0000 Subject: [PATCH 018/812] General code clean up and new tests to ensure that new ESAPI release can still deserialize encrypted data from ESAPI 2.0.x. --- .../crypto/CipherTextSerializerTest.java | 3 +- .../owasp/esapi/crypto/CipherTextTest.java | 79 ++++++++++++++++--- .../owasp/esapi/crypto/CryptoHelperTest.java | 24 ++++++ .../esapi/reference/crypto/CryptoPolicy.java | 3 +- .../esapi/reference/crypto/EncryptorTest.java | 3 +- 5 files changed, 96 insertions(+), 16 deletions(-) diff --git a/src/test/java/org/owasp/esapi/crypto/CipherTextSerializerTest.java b/src/test/java/org/owasp/esapi/crypto/CipherTextSerializerTest.java index cf6af911f..9f86b9fb7 100644 --- a/src/test/java/org/owasp/esapi/crypto/CipherTextSerializerTest.java +++ b/src/test/java/org/owasp/esapi/crypto/CipherTextSerializerTest.java @@ -17,7 +17,8 @@ public class CipherTextSerializerTest { private Cipher encryptor = null; private IvParameterSpec ivSpec = null; // Note: FindBugs reports false positive - // about this being unread field. + // about this being unread field. See + // testAsSerializedByteArray(). @BeforeClass public static void setUpBeforeClass() throws Exception { diff --git a/src/test/java/org/owasp/esapi/crypto/CipherTextTest.java b/src/test/java/org/owasp/esapi/crypto/CipherTextTest.java index 4bf07cfb3..18c7fb505 100644 --- a/src/test/java/org/owasp/esapi/crypto/CipherTextTest.java +++ b/src/test/java/org/owasp/esapi/crypto/CipherTextTest.java @@ -35,15 +35,21 @@ public class CipherTextTest { private static final boolean POST_CLEANUP = true; - private CipherSpec cipherSpec = null; + private CipherSpec cipherSpec_ = null; private Cipher encryptor = null; private Cipher decryptor = null; private IvParameterSpec ivSpec = null; @BeforeClass public static void preCleanup() { - // These two calls have side-effects that cause FindBugs to complain. - new File("ciphertext.ser").delete(); - new File("ciphertext-portable.ser").delete(); + try { + // These two calls have side-effects that cause FindBugs to complain. + removeFile("ciphertext.ser"); + removeFile("ciphertext-portable.ser"); + // Do NOT remove this file... + // src/test/resource/ESAPI2.0-ciphertext-portable.ser + } catch(Exception ex) { + ; // Do nothing + } } @Before @@ -62,8 +68,8 @@ public void tearDown() throws Exception { @AfterClass public static void postCleanup() { if ( POST_CLEANUP ) { // These two calls have side-effects that cause FindBugs to complain. - new File("ciphertext.ser").delete(); - new File("ciphertext-portable.ser").delete(); + removeFile("ciphertext.ser"); + removeFile("ciphertext-portable.ser"); } } @@ -72,18 +78,18 @@ public void tearDown() throws Exception { public final void testCipherText() { CipherText ct = new CipherText(); - cipherSpec = new CipherSpec(); - assertTrue( ct.getCipherTransformation().equals( cipherSpec.getCipherTransformation())); - assertTrue( ct.getBlockSize() == cipherSpec.getBlockSize() ); + cipherSpec_ = new CipherSpec(); + assertTrue( ct.getCipherTransformation().equals( cipherSpec_.getCipherTransformation())); + assertTrue( ct.getBlockSize() == cipherSpec_.getBlockSize() ); } @Test public final void testCipherTextCipherSpec() { - cipherSpec = new CipherSpec("DESede/OFB8/NoPadding", 112); - CipherText ct = new CipherText( cipherSpec ); + cipherSpec_ = new CipherSpec("DESede/OFB8/NoPadding", 112); + CipherText ct = new CipherText( cipherSpec_ ); assertTrue( ct.getRawCipherText() == null ); assertTrue( ct.getCipherAlgorithm().equals("DESede") ); - assertTrue( ct.getKeySize() == cipherSpec.getKeySize() ); + assertTrue( ct.getKeySize() == cipherSpec_.getKeySize() ); } @Test @@ -200,7 +206,7 @@ public final void testMIC() { /** Test portable serialization. */ @Test public final void testPortableSerialization() { - System.err.println("CipherTextTest.testPortableSerialization()..."); + System.out.println("CipherTextTest.testPortableSerialization()starting..."); String filename = "ciphertext-portable.ser"; File serializedFile = new File(filename); serializedFile.delete(); // Delete any old serialized file. @@ -218,6 +224,8 @@ public final void testMIC() { encryptor.init(Cipher.ENCRYPT_MODE, key, ivSpec); byte[] raw = encryptor.doFinal("This is my secret message!!!".getBytes("UTF8")); CipherText ciphertext = new CipherText(cipherSpec, raw); + // TODO: Replace this w/ call to KeyDerivationFunction as this is + // deprecated! Shame on me! SecretKey authKey = CryptoHelper.computeDerivedKey(key, key.getEncoded().length * 8, "authenticity"); ciphertext.computeAndStoreMAC( authKey ); // System.err.println("Original ciphertext being serialized: " + ciphertext); @@ -261,6 +269,39 @@ public final void testMIC() { } } + /** Test portable serialization for backward compatibility with ESAPI 2.0. */ + @Test public final void testPortableSerializationBackwardCompatibility() { + System.out.println("testPortableSerializationBackwardCompatibility()starting..."); + String filename = "src/test/resources/ESAPI2.0-ciphertext-portable.ser"; // Do NOT remove + File serializedFile = new File(filename); + + try { + // String expectedMsg = "This is my secret message!!!"; + + // NOTE: FindBugs complains about this (OS_OPEN_STREAM). It apparently + // is too lame to know that 'fis.read()' is a serious side-effect. + FileInputStream fis = new FileInputStream(serializedFile); + int avail = fis.available(); + byte[] bytes = new byte[avail]; + fis.read(bytes, 0, avail); + // We can't go as far and decrypt it because the file was encrypted using a + // temporary session key. + CipherText restoredCipherText = CipherText.fromPortableSerializedBytes(bytes); + assertTrue( restoredCipherText != null ); + int retrievedKdfVersion = restoredCipherText.getKDFVersion(); + } catch (EncryptionException e) { + Assert.fail("Caught EncryptionException: " + e); + } catch (FileNotFoundException e) { + Assert.fail("Caught FileNotFoundException: " + e); + } catch (IOException e) { + Assert.fail("Caught IOException: " + e); + } catch (Exception e) { + Assert.fail("Caught Exception: " + e); + } finally { + ; // Do NOT delete the file. + } + } + /** Test Java serialization. */ @Test public final void testJavaSerialization() { String filename = "ciphertext.ser"; @@ -334,4 +375,16 @@ public final void testMIC() { public static junit.framework.Test suite() { return new JUnit4TestAdapter(CipherTextTest.class); } + + private static void removeFile(String fname) { + try { + if ( fname != null ) { + File f = new File(fname); + // Findbugs complains about ignoring this return value. Too bad. + f.delete(); + } + } catch(Exception ex) { + ; // Do nothing + } + } } diff --git a/src/test/java/org/owasp/esapi/crypto/CryptoHelperTest.java b/src/test/java/org/owasp/esapi/crypto/CryptoHelperTest.java index 0e55723fe..678b0acf8 100644 --- a/src/test/java/org/owasp/esapi/crypto/CryptoHelperTest.java +++ b/src/test/java/org/owasp/esapi/crypto/CryptoHelperTest.java @@ -140,6 +140,30 @@ public final void testArrayCompare() { // System.out.println("diff: " + diff + " nanosec"); } + @Test + public final void testIsValidKDFVersion() { + assertTrue( CryptoHelper.isValidKDFVersion(20110203, false, false)); + assertTrue( CryptoHelper.isValidKDFVersion(20130830, false, false)); + assertTrue( CryptoHelper.isValidKDFVersion(33330303, false, false)); + assertTrue( CryptoHelper.isValidKDFVersion(99991231, false, false)); + + assertFalse( CryptoHelper.isValidKDFVersion(0, false, false)); + assertFalse( CryptoHelper.isValidKDFVersion(99991232, false, false)); + assertFalse( CryptoHelper.isValidKDFVersion(20110202, false, false)); + + assertTrue( CryptoHelper.isValidKDFVersion(20110203, true, false)); + assertTrue( CryptoHelper.isValidKDFVersion(KeyDerivationFunction.kdfVersion, true, false)); + assertFalse( CryptoHelper.isValidKDFVersion(KeyDerivationFunction.kdfVersion + 1, true, false)); + + try { + CryptoHelper.isValidKDFVersion(77777777, true, true); + fail("Failed to CryptoHelper.isValidKDFVersion() failed to throw IllegalArgumentException."); + } + catch (Exception e) { + assertTrue( e instanceof IllegalArgumentException); + } + } + private void fillByteArray(byte[] ba, byte b) { for (int i = 0; i < ba.length; i++) { ba[i] = b; diff --git a/src/test/java/org/owasp/esapi/reference/crypto/CryptoPolicy.java b/src/test/java/org/owasp/esapi/reference/crypto/CryptoPolicy.java index 2a3c26ba4..fe3a8e948 100644 --- a/src/test/java/org/owasp/esapi/reference/crypto/CryptoPolicy.java +++ b/src/test/java/org/owasp/esapi/reference/crypto/CryptoPolicy.java @@ -82,7 +82,8 @@ private static boolean checkCrypto() // (default) provider. } } catch( InvalidKeyException ikex ) { - System.out.println("Invalid key size - unlimited strength crypto NOT installed!"); + System.out.println("CryptoPolicy: 256 bits is " + + "invalid key size ==> unlimited strength crypto NOT installed!"); return false; } catch( Exception ex ) { System.out.println("Caught unexpected exception: " + ex); diff --git a/src/test/java/org/owasp/esapi/reference/crypto/EncryptorTest.java b/src/test/java/org/owasp/esapi/reference/crypto/EncryptorTest.java index 1143fd3a2..35709a21a 100644 --- a/src/test/java/org/owasp/esapi/reference/crypto/EncryptorTest.java +++ b/src/test/java/org/owasp/esapi/reference/crypto/EncryptorTest.java @@ -443,7 +443,8 @@ public void testVerifySeal() throws EnterpriseSecurityException { String plaintext = "ridiculous:with:delimiters"; // Should now work w/ : (issue #28) String seal = instance.seal( plaintext, instance.getRelativeTimeStamp( 1000 * NSEC ) ); try { - assertTrue( instance.verifySeal( seal ) ); + assertNotNull("Encryptor.seal() returned null", seal ); + assertTrue("Failed to verify seal", instance.verifySeal( seal ) ); } catch ( Exception e ) { fail(); } From 139318ed3d72cdfe02f08c3b615fb44f3e4273d3 Mon Sep 17 00:00:00 2001 From: "kevin.w.wall" Date: Sat, 31 Aug 2013 22:38:40 +0000 Subject: [PATCH 019/812] New files to test for backwards compatibility with revised crypto. --- .../resources/ESAPI2.0-ciphertext-portable.ser | Bin 0 -> 114 bytes src/test/resources/Readme.txt | 5 +++++ 2 files changed, 5 insertions(+) create mode 100644 src/test/resources/ESAPI2.0-ciphertext-portable.ser create mode 100644 src/test/resources/Readme.txt diff --git a/src/test/resources/ESAPI2.0-ciphertext-portable.ser b/src/test/resources/ESAPI2.0-ciphertext-portable.ser new file mode 100644 index 0000000000000000000000000000000000000000..dfe173c949c6042b597f746264843043b7099c3d GIT binary patch literal 114 zcmV-&0FD0X8?cz5C9M}UtOUT zaVIqAW!lU8Y0KyU001CaI}ONJlv$P>6$gX61o{yuTRg(Zey7RQAXyyi0S!9<6k}LZ USwZS~D$eSlIH?=UHzN7)_<&j}umAu6 literal 0 HcmV?d00001 diff --git a/src/test/resources/Readme.txt b/src/test/resources/Readme.txt new file mode 100644 index 000000000..1bb4585ed --- /dev/null +++ b/src/test/resources/Readme.txt @@ -0,0 +1,5 @@ +ESAPI2.0-ciphertext-portable.ser is a test for the backwards compatibility +of ESAPI 2.1.x and later crypto with ESAPI 2.0 crypto. + +The file was created on Windows using the 128-bit test key from +Encryptor.MasterKey and encrypted with AES/CBC/PKCS5Padding. From b69a2261ebe0feef88b0580806275b4088035d8e Mon Sep 17 00:00:00 2001 From: "kevin.w.wall" Date: Sat, 31 Aug 2013 22:41:13 +0000 Subject: [PATCH 020/812] Changes to ensure backward compatibility with previous ESAPI crypto from ESAPI 2.0 / 2.0.1 releases (crypto version 20110203). --- .../org/owasp/esapi/crypto/CipherSpec.java | 3 +- .../org/owasp/esapi/crypto/CipherText.java | 21 ++- .../esapi/crypto/CipherTextSerializer.java | 151 ++++++++++++++---- .../org/owasp/esapi/crypto/CryptoHelper.java | 43 ++++- .../org/owasp/esapi/crypto/CryptoToken.java | 4 +- .../esapi/crypto/KeyDerivationFunction.java | 37 +++-- 6 files changed, 215 insertions(+), 44 deletions(-) diff --git a/src/main/java/org/owasp/esapi/crypto/CipherSpec.java b/src/main/java/org/owasp/esapi/crypto/CipherSpec.java index ac9237fac..556ef8edb 100644 --- a/src/main/java/org/owasp/esapi/crypto/CipherSpec.java +++ b/src/main/java/org/owasp/esapi/crypto/CipherSpec.java @@ -365,7 +365,8 @@ public int hashCode() { * will just allow it to work in the future should we decide to allow * sub-classing of this class.) *

- * See {@link http://www.artima.com/lejava/articles/equality.html} + * See + * How to write an Equality Method in Java * for full explanation. *

*/ diff --git a/src/main/java/org/owasp/esapi/crypto/CipherText.java b/src/main/java/org/owasp/esapi/crypto/CipherText.java index 689ef1c21..47e6fc78f 100644 --- a/src/main/java/org/owasp/esapi/crypto/CipherText.java +++ b/src/main/java/org/owasp/esapi/crypto/CipherText.java @@ -102,6 +102,17 @@ private enum CipherTextFlags { // How much we've collected so far. We start out with having collected nothing. private EnumSet progress = EnumSet.noneOf(CipherTextFlags.class); + + // Check if versions of KeyDerivationFunction, CipherText, and + // CipherTextSerializer are all the same. + { + // Ignore error about comparing identical versions and dead code. + // We expect them to be, but the point is to catch us if they aren't. + assert CipherTextSerializer.cipherTextSerializerVersion == CipherText.cipherTextVersion : + "Versions of CipherTextSerializer and CipherText are not compatible."; + assert CipherTextSerializer.cipherTextSerializerVersion == KeyDerivationFunction.kdfVersion : + "Versions of CipherTextSerializer and KeyDerivationFunction are not compatible."; + } /////////////////////////// C O N S T R U C T O R S ///////////////////////// @@ -307,7 +318,9 @@ public int getRawCipherTextByteLength() { *

* If there is a need to store an encrypted value, say in a database, this * is not the method you should use unless you are using a fixed - * IV. If you are not using a fixed IV, you should normally use + * IV or are planning on retrieving the IV and storing it somewhere separately + * (e.g., a different database column). If you are not using a fixed IV + * (which is highly discouraged), you should normally use * {@link #getEncodedIVCipherText()} instead. *

* @see #getEncodedIVCipherText() @@ -566,7 +579,7 @@ public int getKDFVersion() { } public void setKDFVersion(int vers) { - assert vers > 0 && vers <= 99991231 : "Version must be positive, in format YYYYMMDD and <= 99991231."; + CryptoHelper.isValidKDFVersion(vers, false, true); kdfVersion_ = vers; } @@ -843,8 +856,8 @@ public int getKDFInfo() { // kdf version is bits 1-27, bit 28 (reserved) should be 0, and // bits 29-32 are the MAC algorithm indicating which PRF to use for the KDF. - int kdfVers = getKDFVersion(); - assert kdfVers > 0 && kdfVers <= 99991231 : "KDF version (YYYYMMDD, max 99991231) out of range: " + kdfVers; + int kdfVers = this.getKDFVersion(); + assert CryptoHelper.isValidKDFVersion(kdfVers, true, false); int kdfInfo = kdfVers; int macAlg = kdfPRFAsInt(); assert macAlg >= 0 && macAlg <= 15 : "MAC algorithm indicator must be between 0 to 15 inclusion; value is: " + macAlg; diff --git a/src/main/java/org/owasp/esapi/crypto/CipherTextSerializer.java b/src/main/java/org/owasp/esapi/crypto/CipherTextSerializer.java index b00dd245c..ee69e7baf 100644 --- a/src/main/java/org/owasp/esapi/crypto/CipherTextSerializer.java +++ b/src/main/java/org/owasp/esapi/crypto/CipherTextSerializer.java @@ -24,27 +24,45 @@ * Message Syntax (CMS) Authenticated-Enveloped-Data Content Type, or CMS' predecessor, * PKCS#7 (RFC 2315)), but these serialization schemes are by comparison very complicated, * and do not have extensive support for the various implementation languages which ESAPI - * supports. + * supports. (Perhaps wishful thinking that other ESAPI implementations such as + * ESAPI for .NET, ESAPI for C, ESAPI for C++, etc. will all support a single, common + * serialization technique so they could exchange encrypted data.) * * @author kevin.w.wall@gmail.com * */ public class CipherTextSerializer { - // This should be *same* version as in CipherText & KeyDerivationFunction. - // If one changes, the other should as well to accommodate any differences. + // This should be *same* version as in CipherText & KeyDerivationFunction as + // these versions all need to work together. Therefore, when one changes one + // one these versions, the other should be reviewed and changed as well to + // accommodate any differences. // Previous versions: 20110203 - Original version (ESAPI releases 2.0 & 2.0.1) // 20130830 - Fix to issue #306 (release 2.1.0) - public static final int cipherTextSerializerVersion = 20130830; // Format: YYYYMMDD, max is 99991231. + // We check that in an static initialization block (when assertions are enabled) + // below. + public static final int cipherTextSerializerVersion = 20130830; // Current version. Format: YYYYMMDD, max is 99991231. private static final long serialVersionUID = cipherTextSerializerVersion; private static final Logger logger = ESAPI.getLogger("CipherTextSerializer"); private CipherText cipherText_ = null; + // Check if versions of KeyDerivationFunction, CipherText, and + // CipherTextSerializer are all the same. + { + // Ignore error about comparing identical versions and dead code. + // We expect them to be, but the point is to catch us if they aren't. + assert CipherTextSerializer.cipherTextSerializerVersion == CipherText.cipherTextVersion : + "Versions of CipherTextSerializer and CipherText are not compatible."; + assert CipherTextSerializer.cipherTextSerializerVersion == KeyDerivationFunction.kdfVersion : + "Versions of CipherTextSerializer and KeyDerivationFunction are not compatible."; + } + public CipherTextSerializer(CipherText cipherTextObj) { - assert cipherTextObj != null : "CipherText object must not be null."; - assert cipherTextSerializerVersion == CipherText.cipherTextVersion : - "Version of CipherText and CipherTextSerializer not compatible."; + if ( cipherTextObj == null ) { + throw new IllegalArgumentException("CipherText object must not be null."); + } + assert cipherTextObj != null : "CipherText object must not be null."; cipherText_ = cipherTextObj; } @@ -59,8 +77,6 @@ public CipherTextSerializer(CipherText cipherTextObj) { public CipherTextSerializer(byte[] cipherTextSerializedBytes) throws EncryptionException /* DISCUSS: Change exception type?? */ { - assert cipherTextSerializerVersion == CipherText.cipherTextVersion : - "Version of CipherText and CipherTextSerializer not compatible."; cipherText_ = convertToCipherText(cipherTextSerializedBytes); } @@ -69,7 +85,6 @@ public CipherTextSerializer(byte[] cipherTextSerializedBytes) * @return A serialization of this object. Note that this is not the * Java serialization. */ - @SuppressWarnings("static-access") public byte[] asSerializedByteArray() { int kdfInfo = cipherText_.getKDFInfo(); debug("asSerializedByteArray: kdfInfo = " + kdfInfo); @@ -114,9 +129,35 @@ public byte[] asSerializedByteArray() { * @return The {@code CipherText} object that we are serializing. */ public CipherText asCipherText() { + assert cipherText_ != null; return cipherText_; } + /** + * Take all the individual elements that make of the serialized ciphertext + * format and put them in order and return them as a byte array. + * @param kdfInfo Info about the KDF... which PRF and the KDF version {@link #asCipherText()}. + * @param timestamp Timestamp when the data was encrypted. Intended to help + * facilitate key change operations and nothing more. If it is meaningless, + * then the expectations are just that the recipient should ignore it. Mostly + * intended when encrypted data is kept long term over a period of many + * key change operations. + * @param cipherXform Details of how the ciphertext was encrypted. The format used + * is the same as used by {@code javax.crypto.Cipher}, namely, + * "cipherAlg/cipherMode/paddingScheme". + * @param keySize The key size used for encrypting. Intended for cipher algorithms + * supporting multiple key sizes such as triple DES (DESede) or + * Blowfish. + * @param blockSize The cipher block size. Intended to support cipher algorithms + * that support variable block sizes, such as Rijndael. + * @param ivLen The length of the IV. + * @param iv The actual IV (initialization vector) bytes. + * @param ciphertextLen The length of the raw ciphertext. + * @param rawCiphertext The actual raw ciphertext itself + * @param macLen The length of the MAC (message authentication code). + * @param mac The MAC itself. + * @return A byte array representing the serialized ciphertext. + */ private byte[] computeSerialization(int kdfInfo, long timestamp, String cipherXform, short keySize, short blockSize, @@ -152,7 +193,9 @@ private byte[] computeSerialization(int kdfInfo, long timestamp, } // All strings are written as UTF-8 encoded byte streams with the - // length prepended before it as a short. + // length prepended before it as a short. The prepended length is + // more for the benefit of languages like C so they can pre-allocate + // char arrays without worrying about buffer overflows. private void writeString(ByteArrayOutputStream baos, String str) { byte[] bytes; try { @@ -223,6 +266,13 @@ private long readLong(ByteArrayInputStream bais) return ByteConversionUtil.toLong(longAsByteArray); } + /** Convert the serialized ciphertext byte array to a {@code CipherText} + * object. + * @param cipherTextSerializedBytes The serialized ciphertext as a byte array. + * @return The corresponding {@code CipherText} object. + * @throws EncryptionException Thrown if the byte array data is corrupt or + * there are version mismatches, etc. + */ private CipherText convertToCipherText(byte[] cipherTextSerializedBytes) throws EncryptionException { @@ -236,19 +286,27 @@ private CipherText convertToCipherText(byte[] cipherTextSerializedBytes) debug("kdfPrf: " + kdfPrf); assert kdfPrf >= 0 && kdfPrf <= 15 : "kdfPrf == " + kdfPrf + " must be between 0 and 15."; int kdfVers = ( kdfInfo & 0x07ffffff); - assert kdfVers >= 20110203 && kdfVers <= 99991231 : "KDF Version (" + kdfVers + ") out of range."; // 20110203 (orig version). + + // First do a quick sanity check on the argument. Previously this was an assertion. + if ( ! CryptoHelper.isValidKDFVersion(kdfVers, false, false) ) { + // TODO: Clean up. Use StringBuilder. Good enough for now. + String logMsg = "KDF version read from serialized ciphertext (" + kdfVers + ") is out of range. " + + "Valid range for KDF version is [" + KeyDerivationFunction.originalVersion + ", " + + "99991231]."; + // This should never happen under actual circumstances (barring programming errors; but we've + // tested the code, right?), so it is likely an attempted attack. Thus don't get the originator + // of the suspect ciphertext too much info. They ought to know what they sent anyhow. + throw new EncryptionException("Version info from serialized ciphertext not in valid range.", + "Likely tampering with KDF version on serialized ciphertext." + logMsg); + } + debug("convertToCipherText: kdfPrf = " + kdfPrf + ", kdfVers = " + kdfVers); - if ( kdfVers != CipherText.cipherTextVersion ) { - // NOTE: In future, support backward compatibility via this mechanism. When we do this - // we will have to compare as longs and watch out for sign extension of kdfInfo - // since it may have the sign bit set. Then we will do different things depending - // on what KDF version we encounter. However, as for now, since this is - // is first ESAPI 2.0 GA version, there nothing to be backward compatible with. - // (We did not promise backward compatibility for earlier release candidates.) - // Thus any version mismatch at this point is an error. - throw new InvalidClassException("This serialized byte stream not compatible " + - "with loaded CipherText class. Version read = " + kdfInfo + - "; version from loaded CipherText class = " + CipherText.cipherTextVersion); + System.err.println("convertToCipherText: kdfPrf = " + kdfPrf + ", kdfVers = " + kdfVers); + + if ( ! versionIsCompatible( kdfVers) ) { + throw new EncryptionException("This version of ESAPI does is not compatible with the version of ESAPI that encrypted your data.", + "KDF version " + kdfVers + " from serialized ciphertext not compatibile with current KDF version of " + + KeyDerivationFunction.kdfVersion); } long timestamp = readLong(bais); debug("convertToCipherText: timestamp = " + new Date(timestamp)); @@ -292,8 +350,10 @@ private CipherText convertToCipherText(byte[] cipherTextSerializedBytes) cipherSpec.setIV(iv); debug("convertToCipherText: CipherSpec: " + cipherSpec); CipherText ct = new CipherText(cipherSpec); - assert (ivLen > 0 && ct.requiresIV()) : - "convertToCipherText: Mismatch between IV length and cipher mode."; + if ( ! (ivLen > 0 && ct.requiresIV()) ) { + throw new EncryptionException("convertToCipherText: Mismatch between IV length and cipher mode.", + "Possible tampering of serialized ciphertext?"); + } ct.setCiphertext(rawCiphertext); // Set this *AFTER* setting raw ciphertext because setCiphertext() // method also sets encryption time. @@ -301,6 +361,13 @@ private CipherText convertToCipherText(byte[] cipherTextSerializedBytes) if ( macLen > 0 ) { ct.storeSeparateMAC(mac); } + // Fixed in ESAPI crypto version 20130839. Previously is didn't really matter + // because there was only one version (20110203) and it defaulted to that + // version, which was the current version. But we don't want that as now there + // are two versions and we could be decrypting data encrypted using the previous + // version. + ct.setKDF_PRF(kdfPrf); + ct.setKDFVersion(kdfVers); return ct; } catch(EncryptionException ex) { throw new EncryptionException("Cannot deserialize byte array into CipherText object", @@ -311,8 +378,38 @@ private CipherText convertToCipherText(byte[] cipherTextSerializedBytes) "Cannot deserialize byte array into CipherText object", e); } } - - private void debug(String msg) { + + /** Check to see if we can support the KSF version that was extracted from + * the serialized ciphertext. In particular, we assume that if we have a + * newer version of KDF than we can support it as we assume that we have + * built in backward compatibility. + * + * At this point (ESAPI 2.1.0, KDF version 20130830), all we need to check + * if the version is either the current version or the previous version as + * both versions work the same. This checking may get more complicated in + * the future. + * + * @param readKdfVers The version information extracted from the serialized + * ciphertext. + */ + private static boolean versionIsCompatible(int readKdfVers) { + // We've checked elsewhere for this, so assertion is OK here. + assert readKdfVers > 0 : "Extracted KDF version is negative!"; + + switch ( readKdfVers ) { + case KeyDerivationFunction.originalVersion: // First version + return true; + // Add new versions here; hard coding is OK... + // case YYYYMMDD: + // return true; + case KeyDerivationFunction.kdfVersion: // Current version + return true; + default: + return false; + } + } + + private void debug(String msg) { if ( logger.isDebugEnabled() ) { logger.debug(Logger.EVENT_SUCCESS, msg); } diff --git a/src/main/java/org/owasp/esapi/crypto/CryptoHelper.java b/src/main/java/org/owasp/esapi/crypto/CryptoHelper.java index 2763a2832..024150bda 100644 --- a/src/main/java/org/owasp/esapi/crypto/CryptoHelper.java +++ b/src/main/java/org/owasp/esapi/crypto/CryptoHelper.java @@ -210,7 +210,7 @@ public static boolean isAllowedCipherMode(String cipherMode) * * @param ct The specified {@code CipherText} object to check to see if * it requires a MAC. - * @returns True if a MAC is required, false if it is not required. + * @return True if a MAC is required, false if it is not required. */ public static boolean isMACRequired(CipherText ct) { boolean preferredCipherMode = @@ -345,10 +345,51 @@ public static boolean arrayCompare(byte[] b1, byte[] b2) { return (result == 0) ? true : false; } + /** + * Is this particular KDF version number one that is sane? For that, we + * just make sure it is inbounds of the valid range which is: + * 
+	 *     [20110203, 99991231]
+	 *
+ * @param kdfVers KDF version # that we are checking. Generally this is + * extracted from the serialized {@code CipherText}. + * @param restrictToCurrent If this is set, we do an additional check + * to see if the KDF version is a later version than the + * one that this current ESAPI version supports. + * @param throwIfError Instead of returning {@code false} in the case of + * an error, throw an {@code IllegalArgumentException} + * @return True if in range, false otherwise (except if {@code throwIfError} + * is true.} + */ + public static boolean isValidKDFVersion(int kdfVers, boolean restrictToCurrent, + boolean throwIfError) + throws IllegalArgumentException + { + boolean ret = true; + + if ( kdfVers < KeyDerivationFunction.originalVersion || kdfVers > 99991231 ) { + ret = false; + } else if ( restrictToCurrent ) { + ret = ( kdfVers <= KeyDerivationFunction.kdfVersion ); + } + if ( ret ) { + return ret; // True + } else { // False, so throw or not. + logger.warning(Logger.SECURITY_FAILURE, "Possible data tampering. Encountered invalid KDF version #. " + + ( throwIfError ? "Throwing IllegalArgumentException" : "" )); + if ( throwIfError ) { + throw new IllegalArgumentException("Version (" + kdfVers + ") invalid. " + + "Must be date in format of YYYYMMDD between " + KeyDerivationFunction.originalVersion + "and 99991231."); + } + } + return false; + } + /** * Prevent public, no-argument CTOR from being auto-generated. Public CTOR * is not needed as all methods are static. */ private CryptoHelper() { + ; // Prevent default CTOR from being auto-created. } } diff --git a/src/main/java/org/owasp/esapi/crypto/CryptoToken.java b/src/main/java/org/owasp/esapi/crypto/CryptoToken.java index 8df9dc107..4276079f9 100644 --- a/src/main/java/org/owasp/esapi/crypto/CryptoToken.java +++ b/src/main/java/org/owasp/esapi/crypto/CryptoToken.java @@ -250,8 +250,8 @@ public boolean isExpired() { /** * Set expiration time to expire in 'interval' seconds (NOT milliseconds). - * @param interval Number of seconds in the future from current date/time - * to set expiration. Must be positive. + * @param intervalSecs Number of seconds in the future from current date/time + * to set expiration. Must be positive. */ public void setExpiration(int intervalSecs) throws IllegalArgumentException { diff --git a/src/main/java/org/owasp/esapi/crypto/KeyDerivationFunction.java b/src/main/java/org/owasp/esapi/crypto/KeyDerivationFunction.java index 40c095b89..17635ce5a 100644 --- a/src/main/java/org/owasp/esapi/crypto/KeyDerivationFunction.java +++ b/src/main/java/org/owasp/esapi/crypto/KeyDerivationFunction.java @@ -57,7 +57,8 @@ public class KeyDerivationFunction { * @see CipherText#asPortableSerializedByteArray() * @see CipherText#fromPortableSerializedBytes(byte[]) */ - public static final int kdfVersion = 20130830; // Format: YYYYMMDD, max is 99991231. + public static final int originalVersion = 20110203; // First version. Do not change. EVER! + public static final int kdfVersion = 20130830; // Current version. Format: YYYYMMDD, max is 99991231. private static final long serialVersionUID = kdfVersion; // Format: YYYYMMDD // Pseudo-random function algorithms suitable for NIST KDF in counter mode. @@ -102,6 +103,17 @@ public enum PRF_ALGORITHMS { private int version_ = kdfVersion; private String context_ = ""; + // Check if versions of KeyDerivationFunction, CipherText, and + // CipherTextSerializer are all the same. + { + // Ignore error about comparing identical versions and dead code. + // We expect them to be, but the point is to catch us if they aren't. + assert CipherTextSerializer.cipherTextSerializerVersion == CipherText.cipherTextVersion : + "Versions of CipherTextSerializer and CipherText are not compatible."; + assert CipherTextSerializer.cipherTextSerializerVersion == KeyDerivationFunction.kdfVersion : + "Versions of CipherTextSerializer and KeyDerivationFunction are not compatible."; + } + /** * Construct a {@code KeyDerivationFunction}. * @param prfAlg Specifies a supported algorithm. @@ -155,12 +167,11 @@ static int getDefaultPRFSelection() { * be decrypted. * @param version Date as a integer, in format of YYYYMMDD. Maximum * version date is 99991231 (December 31, 9999). + * @throws IllegalArgumentException If {@code version} is not within + * the valid range of [20110203, 99991231]. */ - public void setVersion(int version) { - if ( version < 0 || version > 99991231 ) { - throw new IllegalArgumentException("Version (" + version + ") invalid. " + - "Must be date in format of YYYYMMDD < 99991231."); - } + public void setVersion(int version) throws IllegalArgumentException { + CryptoHelper.isValidKDFVersion(version, false, true); this.version_ = version; } @@ -173,6 +184,12 @@ public int getVersion() { return version_; } + + // TODO: IMPORTANT NOTE: In a future release (hopefully starting in 2.1.1), + // we will be using the 'context' to mix in some additional things. At a + // minimum, we will be using the KDF version (version_) so that downgrade version + // attacks are not possible. Other candidates are the cipher xform and + // the timestamp. /** * Set the 'context' as specified by NIST Special Publication 800-108. NIST * defines 'context' as "A binary string containing the information related @@ -186,7 +203,7 @@ public int getVersion() { * entities and other information to identify the derived * keying material. This is called context binding. * In particular, the identity (or identifier, as the term - * is defined in [NIST SP 800- 56A , sic] and [NIST SP + * is defined in [NIST SP 800-56A , sic] and [NIST SP * 800-56B , sic]) of each entity that will access (meaning * derive, hold, use, and/or distribute) any segment of * the keying material should be included in the Context @@ -204,7 +221,9 @@ public int getVersion() { * value but {@code null}. */ public void setContext(String context) { - assert context != null : "Context may not be null."; + if ( context == null ) { + throw new IllegalArgumentException("Context may not be null."); + } context_ = context; } @@ -239,7 +258,7 @@ public String getContext() { * @param keyDerivationKey A key used as an input to a key derivation function * to derive other keys. This is the key that generally * is created using some key generation mechanism such as - * {@link #generateSecretKey(String, int)}. The + * {@link CryptoHelper#generateSecretKey(String, int)}. The * "input" key from which the other keys are derived. * The derived key will have the same algorithm type * as this key. This KDK cannot be null. From d08e7f81397ebadaef033dd53f14c0f4b79b0393 Mon Sep 17 00:00:00 2001 From: "kevin.w.wall" Date: Sat, 31 Aug 2013 22:43:12 +0000 Subject: [PATCH 021/812] Future 'TODO' comment to ensure future backward compatibility with previous ESAPI crypto versions going forward. A reminder for release 2.1.1 and later. --- src/main/java/org/owasp/esapi/crypto/PlainText.java | 3 ++- .../org/owasp/esapi/crypto/SecurityProviderLoader.java | 8 ++++---- .../org/owasp/esapi/reference/crypto/JavaEncryptor.java | 9 +++++++++ 3 files changed, 15 insertions(+), 5 deletions(-) diff --git a/src/main/java/org/owasp/esapi/crypto/PlainText.java b/src/main/java/org/owasp/esapi/crypto/PlainText.java index bfa9fd3a2..4491404d5 100644 --- a/src/main/java/org/owasp/esapi/crypto/PlainText.java +++ b/src/main/java/org/owasp/esapi/crypto/PlainText.java @@ -148,7 +148,8 @@ public void overwrite() { * though; this will just allow it to work in the future should we * decide to allow * sub-classing of this class.) *

- * See {@link http://www.artima.com/lejava/articles/equality.html} + * See + * How to write an Equality Method in Java * for full explanation. *

*/ diff --git a/src/main/java/org/owasp/esapi/crypto/SecurityProviderLoader.java b/src/main/java/org/owasp/esapi/crypto/SecurityProviderLoader.java index 1c1e35ae8..cacc9c9ef 100644 --- a/src/main/java/org/owasp/esapi/crypto/SecurityProviderLoader.java +++ b/src/main/java/org/owasp/esapi/crypto/SecurityProviderLoader.java @@ -100,13 +100,13 @@ public class SecurityProviderLoader { * certificate has expired as of August 28, 2009. (This likely is true * for ABA, but I can't even find a copy to download!). Lastly, the IAIK * provider is no longer offered as free, open source. It is not a - * commercial product. See {@link http://jce.iaik.tugraz.at/} for + * commercial product. See {@link "http://jce.iaik.tugraz.at/"} for * details. While some older versions were offered free, it is not clear * whether the accompanying license still allows you to use it, and if * it does, whether or not the code signing certificate used to sign * their JCE jar(s) has expired are not. Therefore, if you are looking * for a FOSS alternative to SunJCE, Bouncy Castle - * ({@link http://www.bouncycastle.org/} is probably your best bet. The + * ({@link "http://www.bouncycastle.org/"} is probably your best bet. The * BC provider does support many the "combined cipher modes" that provide * both confidentiality and authenticity. (See the {@code ESAPI.properties} * property {@code Encryptor.cipher_modes.combined_modes} for details.) @@ -116,9 +116,9 @@ public class SecurityProviderLoader { * by NIST's Cryptographic Module Validation Program and are therefore * not considered FIPS 140-2 compliant. There are a few approved * JCE compatible Java libraries that are on NIST's CMVP list, but this - * list changes constantly so they are not listed here. For futher details + * list changes constantly so they are not listed here. For further details * on NIST's CMVP, see - * {@link http://csrc.nist.gov/groups/STM/cmvp/index.html}. + * {@link "http://csrc.nist.gov/groups/STM/cmvp/index.html"}. *

* Finally, if you wish to use some other JCE provider not recognized above, * you must specify the provider's fully-qualified class name (which in diff --git a/src/main/java/org/owasp/esapi/reference/crypto/JavaEncryptor.java b/src/main/java/org/owasp/esapi/reference/crypto/JavaEncryptor.java index 064fa932c..a20c6122f 100644 --- a/src/main/java/org/owasp/esapi/reference/crypto/JavaEncryptor.java +++ b/src/main/java/org/owasp/esapi/reference/crypto/JavaEncryptor.java @@ -692,6 +692,15 @@ private PlainText handleDecryption(SecretKey key, CipherText ciphertext) // But remember Jon Bentley's "Rule #1 on performance: First make it right, then make it fast." // This would be a security trade-off as it would leave keys in memory a bit longer, so it // should probably be off by default and controlled via a property. + // + // TODO: Feed in some additional parms here to use as the 'context' for the + // KeyDerivationFunction...especially the KDF version. We would have to + // store that in the CipherText object. We *possibly* could make it + // transient so it would not be serialized with the CipherText object, + // otherwise we would have to implement readObject() and writeObject() + // methods there to support backward compatibility. Anyhow the intent + // is to prevent down grade attacks when we finally re-design and + // re-implement the MAC. Think about this in version 2.1.1. encKey = computeDerivedKey( ciphertext.getKDFVersion(), ciphertext.getKDF_PRF(), key, keySize, "encryption"); } From 9162dcd5cc5edd97920d7fc99606803802f41212 Mon Sep 17 00:00:00 2001 From: "kevin.w.wall" Date: Sat, 31 Aug 2013 22:44:12 +0000 Subject: [PATCH 022/812] Javadoc cleanup. --- src/main/java/org/owasp/esapi/Encoder.java | 6 +++--- src/main/java/org/owasp/esapi/SecurityConfiguration.java | 2 +- src/main/java/org/owasp/esapi/codecs/MySQLCodec.java | 2 +- src/main/java/org/owasp/esapi/codecs/PercentCodec.java | 4 ++-- src/main/java/org/owasp/esapi/codecs/PushbackString.java | 8 +++----- .../org/owasp/esapi/reference/AbstractAuthenticator.java | 3 ++- .../java/org/owasp/esapi/reference/DefaultExecutor.java | 2 -- .../org/owasp/esapi/reference/DefaultHTTPUtilities.java | 3 ++- .../java/org/owasp/esapi/waf/ConfigurationException.java | 2 +- .../esapi/waf/configuration/ConfigurationParser.java | 2 +- 10 files changed, 16 insertions(+), 18 deletions(-) diff --git a/src/main/java/org/owasp/esapi/Encoder.java b/src/main/java/org/owasp/esapi/Encoder.java index 8a0ccd94e..3bce42fc4 100644 --- a/src/main/java/org/owasp/esapi/Encoder.java +++ b/src/main/java/org/owasp/esapi/Encoder.java @@ -295,9 +295,9 @@ public interface Encoder { * * For example: * 

-     *  
+     *  <script>
+     *      window.setInterval('<%= EVEN IF YOU ENCODE UNTRUSTED DATA YOU ARE XSSED HERE %>');
+     *  </script>
      *
* @param input * the text to encode for JavaScript diff --git a/src/main/java/org/owasp/esapi/SecurityConfiguration.java b/src/main/java/org/owasp/esapi/SecurityConfiguration.java index 1700d66f5..9c54acb9c 100644 --- a/src/main/java/org/owasp/esapi/SecurityConfiguration.java +++ b/src/main/java/org/owasp/esapi/SecurityConfiguration.java @@ -288,7 +288,7 @@ public interface SecurityConfiguration { * to an empty string, which means that the preferred JCE provider is not * changed. * @return The property {@code Encryptor.PreferredJCEProvider} is returned. - * @see org.owasp.esapi.crypto.SecurityProvider + * @see org.owasp.esapi.crypto.SecurityProviderLoader */ public String getPreferredJCEProvider(); diff --git a/src/main/java/org/owasp/esapi/codecs/MySQLCodec.java b/src/main/java/org/owasp/esapi/codecs/MySQLCodec.java index 7bdc60d39..01db4faf5 100644 --- a/src/main/java/org/owasp/esapi/codecs/MySQLCodec.java +++ b/src/main/java/org/owasp/esapi/codecs/MySQLCodec.java @@ -52,7 +52,7 @@ static Mode findByKey(int key) { /** Target MySQL Server is running in Standard MySQL (Default) mode. */ public static final int MYSQL_MODE = 0; - /** Target MySQL Server is running in {@link http://dev.mysql.com/doc/refman/5.0/en/ansi-mode.html ANSI Mode} */ + /** Target MySQL Server is running in {@link "http://dev.mysql.com/doc/refman/5.0/en/ansi-mode.html"} ANSI Mode */ public static final int ANSI_MODE = 1; //private int mode = 0; diff --git a/src/main/java/org/owasp/esapi/codecs/PercentCodec.java b/src/main/java/org/owasp/esapi/codecs/PercentCodec.java index 147795ab5..307da471a 100644 --- a/src/main/java/org/owasp/esapi/codecs/PercentCodec.java +++ b/src/main/java/org/owasp/esapi/codecs/PercentCodec.java @@ -47,7 +47,7 @@ public class PercentCodec extends Codec /** * Convinence method to encode a string into UTF-8. This * wraps the {@link UnsupportedEncodingException} that - * {@link String.getBytes(String)} throws in a + * {@link String#getBytes(String)} throws in a * {@link IllegalStateException} as UTF-8 support is required * by the Java spec and should never throw this exception. * @param str the string to encode @@ -72,7 +72,7 @@ private static byte[] toUtf8Bytes(String str) * Append the two upper case hex characters for a byte. * @param sb The string buffer to append to. * @param b The byte to hexify - * @returns sb with the hex characters appended. + * @return sb with the hex characters appended. */ // rfc3986 2.1: For consistency, URI producers // should use uppercase hexadecimal digits for all percent- diff --git a/src/main/java/org/owasp/esapi/codecs/PushbackString.java b/src/main/java/org/owasp/esapi/codecs/PushbackString.java index 60a4c5e13..d218eb932 100644 --- a/src/main/java/org/owasp/esapi/codecs/PushbackString.java +++ b/src/main/java/org/owasp/esapi/codecs/PushbackString.java @@ -49,12 +49,10 @@ public void pushback( Character c ) { pushback = c; } - /* - * Get the current index of the PushbackString. Typically used in error messages. - */ + /** - * - * @return + * Get the current index of the PushbackString. Typically used in error messages. + * @return The current index of the PushbackString. */ public int index() { return index; diff --git a/src/main/java/org/owasp/esapi/reference/AbstractAuthenticator.java b/src/main/java/org/owasp/esapi/reference/AbstractAuthenticator.java index 6a5ecdd43..4876da49d 100644 --- a/src/main/java/org/owasp/esapi/reference/AbstractAuthenticator.java +++ b/src/main/java/org/owasp/esapi/reference/AbstractAuthenticator.java @@ -115,7 +115,8 @@ protected DefaultUser getUserFromRememberToken() { String token = ESAPI.httpUtilities().getCookie(ESAPI.currentRequest(), HTTPUtilities.REMEMBER_TOKEN_COOKIE_NAME); if (token == null) return null; - // TODO - kww - URLDecode token first, and THEN unseal. See Google Issue 144. + // See Google Issue 144 regarding first URLDecode the token and THEN unsealing. + // Note that this Google Issue was marked as "WontFix". String[] data = ESAPI.encryptor().unseal(token).split("\\|"); if (data.length != 2) { diff --git a/src/main/java/org/owasp/esapi/reference/DefaultExecutor.java b/src/main/java/org/owasp/esapi/reference/DefaultExecutor.java index 1cfc91f96..9f4976591 100644 --- a/src/main/java/org/owasp/esapi/reference/DefaultExecutor.java +++ b/src/main/java/org/owasp/esapi/reference/DefaultExecutor.java @@ -199,8 +199,6 @@ public ExecuteResult executeSystemCommand(File executable, List params, File wor * * @param is * input stream to read from - * @return - * a string containing as many lines as the input stream contains, with newlines between lines * @throws IOException */ private static void readStream( InputStream is, StringBuilder sb ) throws IOException { diff --git a/src/main/java/org/owasp/esapi/reference/DefaultHTTPUtilities.java b/src/main/java/org/owasp/esapi/reference/DefaultHTTPUtilities.java index b1bf850d4..dc99d76b3 100644 --- a/src/main/java/org/owasp/esapi/reference/DefaultHTTPUtilities.java +++ b/src/main/java/org/owasp/esapi/reference/DefaultHTTPUtilities.java @@ -912,7 +912,8 @@ public String setRememberToken( HttpServletRequest request, HttpServletResponse long expiry = ESAPI.encryptor().getRelativeTimeStamp(maxAge * 1000); String cryptToken = ESAPI.encryptor().seal(clearToken, expiry); - // TODO - URLEncode cryptToken before creating cookie? See Google Issue # 144 - KWW + // Do NOT URLEncode cryptToken before creating cookie. See Google Issue # 144, + // which was marked as "WontFix". Cookie cookie = new Cookie( REMEMBER_TOKEN_COOKIE_NAME, cryptToken ); cookie.setMaxAge( maxAge ); diff --git a/src/main/java/org/owasp/esapi/waf/ConfigurationException.java b/src/main/java/org/owasp/esapi/waf/ConfigurationException.java index 314828bfd..9ea04fd7b 100644 --- a/src/main/java/org/owasp/esapi/waf/ConfigurationException.java +++ b/src/main/java/org/owasp/esapi/waf/ConfigurationException.java @@ -23,7 +23,7 @@ * The Exception to be thrown when there is an error parsing a policy file. * * @author Arshan Dabirsiaghi - * @see org.owasp.esapi.configuration.ConfigurationParser + * @see org.owasp.esapi.waf.configuration.ConfigurationParser * */ public class ConfigurationException extends EnterpriseSecurityException { diff --git a/src/main/java/org/owasp/esapi/waf/configuration/ConfigurationParser.java b/src/main/java/org/owasp/esapi/waf/configuration/ConfigurationParser.java index 2087eee2f..2366fcdf5 100644 --- a/src/main/java/org/owasp/esapi/waf/configuration/ConfigurationParser.java +++ b/src/main/java/org/owasp/esapi/waf/configuration/ConfigurationParser.java @@ -56,7 +56,7 @@ * The class used to turn a policy file's contents into an object model. * * @author Arshan Dabirsiaghi - * @see org.owasp.esapi.waf.AppGuardianConfiguration + * @see org.owasp.esapi.waf.configuration.AppGuardianConfiguration */ public class ConfigurationParser { From 67fa255324a597c750acd9e6cfffcdddf0cc83c5 Mon Sep 17 00:00:00 2001 From: "kevin.w.wall" Date: Sat, 31 Aug 2013 22:47:29 +0000 Subject: [PATCH 023/812] Ant script to create Javadoc. --- ant-javadoc.xml | 8 ++++++++ 1 file changed, 8 insertions(+) create mode 100644 ant-javadoc.xml diff --git a/ant-javadoc.xml b/ant-javadoc.xml new file mode 100644 index 000000000..084d4d1dc --- /dev/null +++ b/ant-javadoc.xml @@ -0,0 +1,8 @@ + + + + + + + + From e707ac86e6e162ecc64b7fd95f04fc3579d6e8b7 Mon Sep 17 00:00:00 2001 From: "chris.schmidt@owasp.org" Date: Mon, 2 Sep 2013 20:38:25 +0000 Subject: [PATCH 024/812] Updating version back to snapshot to perform release --- pom.xml | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/pom.xml b/pom.xml index 2de9b9a73..39ec222cc 100644 --- a/pom.xml +++ b/pom.xml @@ -3,7 +3,7 @@ 4.0.0 org.owasp.esapi esapi - 2.1.0 + 2.1.0-SNAPSHOT jar @@ -245,6 +245,7 @@ + + compile <!– Eclipse q4e plugin needs this –> display-dependency-updates display-plugin-updates @@ -261,6 +262,7 @@ +--> From 97d4891a1a2b277dc5997e04923bc697dd437ee8 Mon Sep 17 00:00:00 2001 From: "kevin.w.wall" Date: Mon, 2 Sep 2013 21:47:22 +0000 Subject: [PATCH 025/812] Final clean up. Removed erroneous code from ESAPICryptoMACByPassTest.java that caused (correct) AssertionError when assertions were enabled during execution of JUnit tests. Removed superfluous System.err.println() in CipherTextSerializer. --- src/main/java/org/owasp/esapi/crypto/CipherTextSerializer.java | 2 -- .../java/org/owasp/esapi/crypto/ESAPICryptoMACByPassTest.java | 3 +-- 2 files changed, 1 insertion(+), 4 deletions(-) diff --git a/src/main/java/org/owasp/esapi/crypto/CipherTextSerializer.java b/src/main/java/org/owasp/esapi/crypto/CipherTextSerializer.java index ee69e7baf..2a6caebff 100644 --- a/src/main/java/org/owasp/esapi/crypto/CipherTextSerializer.java +++ b/src/main/java/org/owasp/esapi/crypto/CipherTextSerializer.java @@ -301,8 +301,6 @@ private CipherText convertToCipherText(byte[] cipherTextSerializedBytes) } debug("convertToCipherText: kdfPrf = " + kdfPrf + ", kdfVers = " + kdfVers); - System.err.println("convertToCipherText: kdfPrf = " + kdfPrf + ", kdfVers = " + kdfVers); - if ( ! versionIsCompatible( kdfVers) ) { throw new EncryptionException("This version of ESAPI does is not compatible with the version of ESAPI that encrypted your data.", "KDF version " + kdfVers + " from serialized ciphertext not compatibile with current KDF version of " + diff --git a/src/test/java/org/owasp/esapi/crypto/ESAPICryptoMACByPassTest.java b/src/test/java/org/owasp/esapi/crypto/ESAPICryptoMACByPassTest.java index 34878c705..e54ad33f8 100644 --- a/src/test/java/org/owasp/esapi/crypto/ESAPICryptoMACByPassTest.java +++ b/src/test/java/org/owasp/esapi/crypto/ESAPICryptoMACByPassTest.java @@ -54,7 +54,7 @@ public void setUp() throws NoSuchAlgorithmException, InvalidKeySpecException { @Test public void testMacBypass() throws EncryptionException, NoSuchFieldException, IllegalAccessException { - byte[] bkey = {0x00,0x01,0x02,0x03,0x04,0x05,0x06,0x07,0x08,0x09,0xA,0x0B,0x0C,0x0D,0x0E,0x0F}; //Truly random key. + byte[] bkey = {0x00,0x01,0x02,0x03,0x04,0x05,0x06,0x07,0x08,0x09,0xA,0x0B,0x0C,0x0D,0x0E,0x0F}; //Truly random key. ;-) SecretKey sk = new SecretKeySpec(bkey,"AES"); //Encryption with MAC @@ -76,7 +76,6 @@ public void testMacBypass() throws EncryptionException, NoSuchFieldException, Il String origCipherXform = ESAPI.securityConfiguration().setCipherTransformation("AES/CBC/NoPadding"); CipherText ct = ESAPI.encryptor().encrypt(sk,new PlainText(originalMessage)); - ct.computeAndStoreMAC(sk); //Serialize the ciphertext in order to send it over the wire.. byte[] serializedCt = ct.asPortableSerializedByteArray(); From 4d37568b0b6aa0ad86f8faf63b6083c51741d587 Mon Sep 17 00:00:00 2001 From: "chris.schmidt@owasp.org" Date: Tue, 3 Sep 2013 01:16:41 +0000 Subject: [PATCH 026/812] [maven-release-plugin] prepare release esapi-2.1.0 --- pom.xml | 1008 +++++++++++++++++++++++++++---------------------------- 1 file changed, 504 insertions(+), 504 deletions(-) diff --git a/pom.xml b/pom.xml index 39ec222cc..e6ce7652e 100644 --- a/pom.xml +++ b/pom.xml @@ -1,504 +1,504 @@ - - - 4.0.0 - org.owasp.esapi - esapi - 2.1.0-SNAPSHOT - jar - - - org.sonatype.oss - oss-parent - 5 - - - - - BSD - http://www.opensource.org/licenses/bsd-license.php - Code License - New BSD License - - - Creative Commons 3.0 BY-SA - http://creativecommons.org/licenses/by-sa/3.0/ - Content License - Create Commons 3.0 BY-SA - - - - ESAPI - http://www.esapi.org/ - The Enterprise Security API (ESAPI) project is an OWASP project - to create simple strong security controls for every web platform. - Security controls are not simple to build. You can read about the - hundreds of pitfalls for unwary developers on the OWASP web site. By - providing developers with a set of strong controls, we aim to - eliminate some of the complexity of creating secure web applications. - This can result in significant cost savings across the SDLC. - - - - The Open Web Application Security Project (OWASP) - http://www.owasp.org/index.php - - - - - ESAPI-Users - https://lists.owasp.org/mailman/listinfo/esapi-user/ - https://lists.owasp.org/mailman/listinfo/esapi-user/ - mailto:esapi-users@lists.owasp.org - https://lists.owasp.org/pipermail/esapi-users/ - - - - ESAPI-Developers - https://lists.owasp.org/mailman/listinfo/esapi-dev/ - https://lists.owasp.org/mailman/listinfo/esapi-dev/ - mailto:esapi-dev@lists.owasp.org - https://lists.owasp.org/pipermail/esapi-dev/ - - - - OWASP-ESAPI (Inactive! Archive only!) - https://lists.owasp.org/pipermail/owasp-esapi/ - - - - - - scm:svn:http://owasp-esapi-java.googlecode.com/svn/trunk - scm:svn:https://owasp-esapi-java.googlecode.com/svn/trunk - http://code.google.com/p/owasp-esapi-java/source/checkout - - - - Google Code Issue Tracking - http://code.google.com/p/owasp-esapi-java/issues/list - - - - - Jeff Williams - Aspect Security - - Project Owner - Architect - Developer - - - - Jim Manico - - Project Manager - BuildMaster - Developer - Architect - - - - Chris Schmidt - Aspect Security - - Project Manager - Continuous Integration Admin - Architect - Developer - - - - Kevin W. Wall - Wells Fargo - - Project Manager - Architect - Developer - Crypto Guy - - - - - - - Dave Wichers - Aspect Security - - Documentation and Examples - Minor Code Contributions - Project Guidance - - - - - - UTF-8 - - - - - commons-configuration - commons-configuration - 1.5 - - - commons-beanutils - commons-beanutils-core - 1.7.0 - - - junit - junit - 4.4 - test - - - javax.servlet - servlet-api - 2.4 - provided - - - javax.servlet - jsp-api - 2.0 - provided - - - commons-fileupload - commons-fileupload - 1.2 - compile - - - - commons-io - commons-io - 1.3 - test - - - commons-collections - commons-collections - 3.2 - compile - - - log4j - log4j - 1.2.16 - compile - jar - - - xom - xom - 1.2.5 - - - org.beanshell - bsh-core - 2.0b4 - - - org.owasp.antisamy - antisamy - 1.4.3 - - - - - - - maven-compiler-plugin - 2.3.2 - - 1.5 - 1.5 - true - true - false - - - - - org.apache.maven.plugins - maven-eclipse-plugin - 2.8 - - true - - - - - maven-jar-plugin - 2.3.1 - - - - true - true - - - - - - - - - - - - - - org.codehaus.mojo - findbugs-maven-plugin - 2.3.1 - - true - true - true - Low - Max - false - - - - org.codehaus.mojo - cobertura-maven-plugin - 2.4 - - - html - xml - - - - - org.codehaus.mojo - jdepend-maven-plugin - 2.0-beta-2 - - - maven-pmd-plugin - 2.5 - - 1.5 - utf-8 - - - - org.apache.maven.plugins - maven-javadoc-plugin - 2.7 - - false - false - - - - net.sourceforge.maven-taglib - maven-taglib-plugin - 2.4 - - - org.apache.maven.plugins - maven-changelog-plugin - 2.2 - - [Ii]ssue[# ]*(\d)+ - http://code.google.com/p/owasp-esapi-java/issues/detail?id=%ISSUE% - date - - 2011-05-11 00:00:00 - - - - - org.codehaus.mojo - versions-maven-plugin - 1.2 - - - - dependency-updates-report - plugin-updates-report - property-updates-report - - - - - - - - - - - dist - - - - - performRelease - true - - - - - - sonatype-nexus-snapshots - https://oss.sonatype.org/content/repositories/snapshots - - - sonatype-nexus-staging - https://oss.sonatype.org/service/local/staging/deploy/maven2 - - - - - - - - - org.apache.maven.plugins - maven-gpg-plugin - - - sign-artifacts - deploy - - sign - - - 9F460575 - - - - - - - org.apache.maven.plugins - maven-jar-plugin - 2.3.1 - - - package - - sign - - - - - codesign.keystore - owasp foundation, inc.'s godaddy.com, inc. id - true - - - true - true - - - true - - - - - - - - org.apache.maven.plugins - maven-enforcer-plugin - - - enforce-jdk-version - - enforce - - - - - 1.5 - - ESAPI 2.0 uses the JDK1.5 for it's baseline. Please make sure that your - JAVA_HOME environment variable is pointed to a JDK1.5 distribution. - - - - - - - - - - - org.apache.maven.plugins - maven-javadoc-plugin - - - attach-javadocs - - jar - - - - - - - - org.apache.maven.plugins - maven-assembly-plugin - 2.2 - - - src/main/assembly/dist.xml - - - - - make-dist - package - - single - - - - - - - - org.apache.maven.plugins - maven-release-plugin - 2.1 - - https://owasp-esapi-java.googlecode.com/svn/tags/releases/ - - - - - - - - + + + 4.0.0 + org.owasp.esapi + esapi + 2.1.0 + jar + + + org.sonatype.oss + oss-parent + 5 + + + + + BSD + http://www.opensource.org/licenses/bsd-license.php + Code License - New BSD License + + + Creative Commons 3.0 BY-SA + http://creativecommons.org/licenses/by-sa/3.0/ + Content License - Create Commons 3.0 BY-SA + + + + ESAPI + http://www.esapi.org/ + The Enterprise Security API (ESAPI) project is an OWASP project + to create simple strong security controls for every web platform. + Security controls are not simple to build. You can read about the + hundreds of pitfalls for unwary developers on the OWASP web site. By + providing developers with a set of strong controls, we aim to + eliminate some of the complexity of creating secure web applications. + This can result in significant cost savings across the SDLC. + + + + The Open Web Application Security Project (OWASP) + http://www.owasp.org/index.php + + + + + ESAPI-Users + https://lists.owasp.org/mailman/listinfo/esapi-user/ + https://lists.owasp.org/mailman/listinfo/esapi-user/ + mailto:esapi-users@lists.owasp.org + https://lists.owasp.org/pipermail/esapi-users/ + + + + ESAPI-Developers + https://lists.owasp.org/mailman/listinfo/esapi-dev/ + https://lists.owasp.org/mailman/listinfo/esapi-dev/ + mailto:esapi-dev@lists.owasp.org + https://lists.owasp.org/pipermail/esapi-dev/ + + + + OWASP-ESAPI (Inactive! Archive only!) + https://lists.owasp.org/pipermail/owasp-esapi/ + + + + + + scm:svn:http://owasp-esapi-java.googlecode.com/svn/tags/esapi-2.1.0 + scm:svn:https://owasp-esapi-java.googlecode.com/svn/tags/esapi-2.1.0 + http://code.google.com/p/owasp-esapi-java/source/checkout/tags/esapi-2.1.0 + + + + Google Code Issue Tracking + http://code.google.com/p/owasp-esapi-java/issues/list + + + + + Jeff Williams + Aspect Security + + Project Owner + Architect + Developer + + + + Jim Manico + + Project Manager + BuildMaster + Developer + Architect + + + + Chris Schmidt + Aspect Security + + Project Manager + Continuous Integration Admin + Architect + Developer + + + + Kevin W. Wall + Wells Fargo + + Project Manager + Architect + Developer + Crypto Guy + + + + + + + Dave Wichers + Aspect Security + + Documentation and Examples + Minor Code Contributions + Project Guidance + + + + + + UTF-8 + + + + + commons-configuration + commons-configuration + 1.5 + + + commons-beanutils + commons-beanutils-core + 1.7.0 + + + junit + junit + 4.4 + test + + + javax.servlet + servlet-api + 2.4 + provided + + + javax.servlet + jsp-api + 2.0 + provided + + + commons-fileupload + commons-fileupload + 1.2 + compile + + + + commons-io + commons-io + 1.3 + test + + + commons-collections + commons-collections + 3.2 + compile + + + log4j + log4j + 1.2.16 + compile + jar + + + xom + xom + 1.2.5 + + + org.beanshell + bsh-core + 2.0b4 + + + org.owasp.antisamy + antisamy + 1.4.3 + + + + + + + maven-compiler-plugin + 2.3.2 + + 1.5 + 1.5 + true + true + false + + + + + org.apache.maven.plugins + maven-eclipse-plugin + 2.8 + + true + + + + + maven-jar-plugin + 2.3.1 + + + + true + true + + + + + + + + + + + + + + org.codehaus.mojo + findbugs-maven-plugin + 2.3.1 + + true + true + true + Low + Max + false + + + + org.codehaus.mojo + cobertura-maven-plugin + 2.4 + + + html + xml + + + + + org.codehaus.mojo + jdepend-maven-plugin + 2.0-beta-2 + + + maven-pmd-plugin + 2.5 + + 1.5 + utf-8 + + + + org.apache.maven.plugins + maven-javadoc-plugin + 2.7 + + false + false + + + + net.sourceforge.maven-taglib + maven-taglib-plugin + 2.4 + + + org.apache.maven.plugins + maven-changelog-plugin + 2.2 + + [Ii]ssue[# ]*(\d)+ + http://code.google.com/p/owasp-esapi-java/issues/detail?id=%ISSUE% + date + + 2011-05-11 00:00:00 + + + + + org.codehaus.mojo + versions-maven-plugin + 1.2 + + + + dependency-updates-report + plugin-updates-report + property-updates-report + + + + + + + + + + + dist + + + + + performRelease + true + + + + + + sonatype-nexus-snapshots + https://oss.sonatype.org/content/repositories/snapshots + + + sonatype-nexus-staging + https://oss.sonatype.org/service/local/staging/deploy/maven2 + + + + + + + + + org.apache.maven.plugins + maven-gpg-plugin + + + sign-artifacts + deploy + + sign + + + 9F460575 + + + + + + + org.apache.maven.plugins + maven-jar-plugin + 2.3.1 + + + package + + sign + + + + + codesign.keystore + owasp foundation, inc.'s godaddy.com, inc. id + true + + + true + true + + + true + + + + + + + + org.apache.maven.plugins + maven-enforcer-plugin + + + enforce-jdk-version + + enforce + + + + + 1.5 + + ESAPI 2.0 uses the JDK1.5 for it's baseline. Please make sure that your + JAVA_HOME environment variable is pointed to a JDK1.5 distribution. + + + + + + + + + + + org.apache.maven.plugins + maven-javadoc-plugin + + + attach-javadocs + + jar + + + + + + + + org.apache.maven.plugins + maven-assembly-plugin + 2.2 + + + src/main/assembly/dist.xml + + + + + make-dist + package + + single + + + + + + + + org.apache.maven.plugins + maven-release-plugin + 2.1 + + https://owasp-esapi-java.googlecode.com/svn/tags/releases/ + + + + + + + + From 95c8c1dd46060d36b40576e521f1fb8afa150d01 Mon Sep 17 00:00:00 2001 From: "chris.schmidt@owasp.org" Date: Tue, 3 Sep 2013 01:16:50 +0000 Subject: [PATCH 027/812] [maven-release-plugin] prepare for next development iteration --- pom.xml | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/pom.xml b/pom.xml index e6ce7652e..5e0fdd4bb 100644 --- a/pom.xml +++ b/pom.xml @@ -3,7 +3,7 @@ 4.0.0 org.owasp.esapi esapi - 2.1.0 + 2.1.1-SNAPSHOT jar @@ -66,9 +66,9 @@ - scm:svn:http://owasp-esapi-java.googlecode.com/svn/tags/esapi-2.1.0 - scm:svn:https://owasp-esapi-java.googlecode.com/svn/tags/esapi-2.1.0 - http://code.google.com/p/owasp-esapi-java/source/checkout/tags/esapi-2.1.0 + scm:svn:http://owasp-esapi-java.googlecode.com/svn/trunk + scm:svn:https://owasp-esapi-java.googlecode.com/svn/trunk + http://code.google.com/p/owasp-esapi-java/source/checkout From 204636f7ff3a71dad567f5abe1cc86d038de39ed Mon Sep 17 00:00:00 2001 From: "kevin.w.wall" Date: Sun, 15 Sep 2013 19:52:51 +0000 Subject: [PATCH 028/812] ESAPI Security Advisory as posted to Full Disclosure and Bugtraq mailing lists. Keywords: CVE-2013-5679, Google Issue # 306. --- documentation/ESAPI-security-bulletin1.docx | Bin 0 -> 25167 bytes documentation/ESAPI-security-bulletin1.pdf | Bin 0 -> 648851 bytes 2 files changed, 0 insertions(+), 0 deletions(-) create mode 100644 documentation/ESAPI-security-bulletin1.docx create mode 100644 documentation/ESAPI-security-bulletin1.pdf diff --git a/documentation/ESAPI-security-bulletin1.docx b/documentation/ESAPI-security-bulletin1.docx new file mode 100644 index 0000000000000000000000000000000000000000..9ab49c9bb04429a0448236f727e503faba0709e9 GIT binary patch literal 25167 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 PgZRiITKb;B_h0`3`AacY literal 0 HcmV?d00001 diff --git a/documentation/ESAPI-security-bulletin1.pdf b/documentation/ESAPI-security-bulletin1.pdf new file mode 100644 index 0000000000000000000000000000000000000000..9f09e49cc4085fb22c0e9e4e84ce8b40494af8ce GIT binary patch literal 648851 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

B+L}S^TJixa<^QY2HK) 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
5X2+@-S z?b1{96r$)$^d+RBr|D^!8z}S`e3G4dUqqQO_Gd##K{*iaM_+@G3hy6751>-?6iP$S zK-h|&MV09D=pP__LA`q|1MP$GMYJD6CTfB3AnHQhC<~v$r_e)G3iVZ#O?{2piOQ$~ zssNQ!Zc2ucK0pn^D1MsyDLOz6Q^Tm48lgteAz1PMD>6`TQs>btw3gPQBXk@chm7iJ z<97N8-HuGmBg|g(eWr))Z$lbntc)G~SiSY=4C7;t zp`S8C%n%x57MYLHTiW-v@1u9MztsK`O=&;Set<4&7qyG%lJ+C*N9aA>Pjw?`TK99^ zTWD5Y(f%eTEhY_Ji}_Z}x6p6ZwdTCOQ{Rbxr}yYR=(>JTKY@O)pVYsH?&vS;FJoFi zqo2Wy{)+wz*6Qc*^lF4~oEEJ2y8gZ}KmIo+`$=ZJU2;lJmt@r^i=Wl3t4`^2jRivhAa zD~|y_p8`rP;8}z33~3J_8dz9 zK|y&nYW?;|vtm@rw5>|xw&OB#EK7drlyp-HN@t{1ab6yiTJ7nsAvr;GNd0n-lp^Pe zqkvQo$oq(-B$H$U)M#@S*()3?(zrBkH^3^iK(3Z6KzgNOF>q3(OnbUL-MIlW9fS4F z7CBX%fO-_lX3+tyo(B7&pl45i(wG15_GN8DOdILT_zZdxz<9|g@&D~e)mnD&2Cv{f z<3qj#OQA2z>gT6?^*)1l+A{Au>D{p8d;2XrysawLtkv(^0#t}l_}aYFz65K~f8IZ1 zyX?OsZuMUhi^M8%znv3XZDFTY^oyrNzkS$|Db7M_QM@UxiW?GwJfr>@{{rMG0s01@ zP7qsx`uJT+r`Eq9p0nNJ^Li7#BfQz4Vf9;9_i6&P=UWDR7kGoeknops z?8E*$5)zA?v0{~-vjz!wDNpn}w?GYχpIw!8$`lMZ!9i9SzG8gX^{CnM*u2Fvr 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

Fk8R~asR3PLcpW$X#* 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

V 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 uNy85+4bM?E7oo@OgW#7^(5xLrKo&X{7{M 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

~w)d58WoMg%`e#y?!5 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 literal 0 HcmV?d00001 From 2e87be2162ac9b0248fb9ccb9c983ab296d40b9c Mon Sep 17 00:00:00 2001 From: "kevin.w.wall" Date: Tue, 8 Oct 2013 02:36:18 +0000 Subject: [PATCH 029/812] Update security bulletin with references to NIST NVD and new CVE identifier. --- documentation/ESAPI-security-bulletin1.docx | Bin 25167 -> 24998 bytes documentation/ESAPI-security-bulletin1.pdf | Bin 648851 -> 649591 bytes 2 files changed, 0 insertions(+), 0 deletions(-) diff --git a/documentation/ESAPI-security-bulletin1.docx b/documentation/ESAPI-security-bulletin1.docx index 9ab49c9bb04429a0448236f727e503faba0709e9..65d941b93774eb9b5aeee19940177fcf1299748b 100644 GIT binary patch delta 12612 zcmZ9TQ*b3aFUhXNSN`2EpszU=Z5P>^NN@!N3er8zEuo!GTj+4o+FpXkUhBUm;7q+4Izy4(ndz|araXIo_^z^Yru6z6D;_W<<#B^zeaEgu( zAIxZ1&GwqEA4~vixr+Ez9=Q z+_9Lo2#L?IQgb}I3+;)h)~RPmmnk|(c+w^6X^?vrc~lz6Y{jVIzX!gvmSYjj=vmmI zC&hPgY+MPmYp(PUPNF>DtVQI~d>=>aLxH2;i^kk3GOw9fM}Lj<)vJdz9A$UMz1%RN zYoNS38>cj3!t?;C*d9Uq&13!A_9&?l6|^eJ*hg8C!6WYm8kq9Tx>>!cP2U}m2#lo~ zcaTe>$>Hpbvmh(QGklX?2&YOXvNlc0Y5PsRNkR8d?`J}Yr8Q{k2WFF#^hP{qJK)MF z&5ma+9J!rdVGdErtg8uO6_IkwgQWF%e|>N{RdYu&D!W0w{AAFiGl)CwwtZn⁢gOD-iFtxWPEmzsWb; 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 KjFjPj)&DQHd|D|0 delta 12791 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 k!$=T3Ml(?pGYQ$49vnp{iPu;dtUt-umudf&c&j diff --git a/documentation/ESAPI-security-bulletin1.pdf b/documentation/ESAPI-security-bulletin1.pdf index 9f09e49cc4085fb22c0e9e4e84ce8b40494af8ce..38abe25149ea1b83b41fb290333a49664dd34801 100644 GIT binary patch delta 13200 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 ALjV8( delta 12657 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%0A`%+15c z&B_`RjfV@w&BKR@Mo%xLBK`VTfq#IhgNLX@uY=%UbpAiG;Z$|A@}mAH3C_R1U#~UH S*W14wMgBjS^6~s{rvD3FKBe&h From fd9c26e96ec099ec0308e4ee966e3c78d295e6c4 Mon Sep 17 00:00:00 2001 From: "erluko@gmail.com" Date: Tue, 19 Nov 2013 20:43:53 +0000 Subject: [PATCH 030/812] Allowing multi-valued Validator.ConfigurationFile property as requested in Issue 86 "Need validation configuration enhancements" --- .../DefaultSecurityConfiguration.java | 135 ++--- .../DefaultSecurityConfigurationTest.java | 28 ++ ...ESAPI-CommaValidatorFileChecker.properties | 466 ++++++++++++++++++ .../ESAPI-DualValidatorFileChecker.properties | 466 ++++++++++++++++++ ...SAPI-QuotedValidatorFileChecker.properties | 466 ++++++++++++++++++ ...SAPI-SingleValidatorFileChecker.properties | 466 ++++++++++++++++++ .../esapi/validation-test,comma.properties | 1 + .../esapi/validation-test1.properties | 1 + .../esapi/validation-test2.properties | 1 + 9 files changed, 1973 insertions(+), 57 deletions(-) create mode 100644 src/test/resources/esapi/ESAPI-CommaValidatorFileChecker.properties create mode 100644 src/test/resources/esapi/ESAPI-DualValidatorFileChecker.properties create mode 100644 src/test/resources/esapi/ESAPI-QuotedValidatorFileChecker.properties create mode 100644 src/test/resources/esapi/ESAPI-SingleValidatorFileChecker.properties create mode 100644 src/test/resources/esapi/validation-test,comma.properties create mode 100644 src/test/resources/esapi/validation-test1.properties create mode 100644 src/test/resources/esapi/validation-test2.properties diff --git a/src/main/java/org/owasp/esapi/reference/DefaultSecurityConfiguration.java b/src/main/java/org/owasp/esapi/reference/DefaultSecurityConfiguration.java index c2e382108..995ad7007 100644 --- a/src/main/java/org/owasp/esapi/reference/DefaultSecurityConfiguration.java +++ b/src/main/java/org/owasp/esapi/reference/DefaultSecurityConfiguration.java @@ -23,6 +23,7 @@ import java.net.URL; import java.util.ArrayList; import java.util.Arrays; +import java.util.Collections; import java.util.HashMap; import java.util.Iterator; import java.util.List; @@ -31,6 +32,7 @@ import java.util.regex.Pattern; import java.util.regex.PatternSyntaxException; +import org.apache.commons.lang.text.StrTokenizer; import org.owasp.esapi.ESAPI; import org.owasp.esapi.Logger; import org.owasp.esapi.SecurityConfiguration; @@ -84,7 +86,7 @@ public static SecurityConfiguration getInstance() { private String cipherXformCurrent = null; // New in ESAPI 2.0 /** The name of the ESAPI property file */ - public static final String RESOURCE_FILE = "ESAPI.properties"; + public static final String DEFAULT_RESOURCE_FILE = "ESAPI.properties"; public static final String REMEMBER_TOKEN_DURATION = "Authenticator.RememberTokenDuration"; public static final String IDLE_TIMEOUT_DURATION = "Authenticator.IdleTimeoutDuration"; @@ -147,6 +149,7 @@ public static SecurityConfiguration getInstance() { public static final String LOG_APPLICATION_NAME = "Logger.LogApplicationName"; public static final String LOG_SERVER_IP = "Logger.LogServerIP"; public static final String VALIDATION_PROPERTIES = "Validator.ConfigurationFile"; + public static final String VALIDATION_PROPERTIES_MULTIVALUED = "Validator.ConfigurationFile.MultiValued"; public static final String ACCEPT_LENIENT_DATES = "Validator.AcceptLenientDates"; @@ -215,13 +218,15 @@ public static SecurityConfiguration getInstance() { * be used to load the file. */ private String resourceDirectory = ".esapi"; // For backward compatibility (vs. "esapi") + private final String resourceFile; // private static long lastModified = -1; /** * Instantiates a new configuration. */ - public DefaultSecurityConfiguration() { + protected DefaultSecurityConfiguration(String resourceFile) { + this.resourceFile = resourceFile; // load security configuration try { loadConfiguration(); @@ -241,11 +246,17 @@ public DefaultSecurityConfiguration() { * @param properties */ public DefaultSecurityConfiguration(Properties properties) { - super(); + resourceFile = DEFAULT_RESOURCE_FILE; this.properties = properties; this.setCipherXProperties(); } + /** + * + */ + public DefaultSecurityConfiguration(){ + this(DEFAULT_RESOURCE_FILE); + } private void setCipherXProperties() { // TODO: FUTURE: Replace by future CryptoControls class??? // See SecurityConfiguration.setCipherTransformation() for @@ -422,74 +433,84 @@ private Properties loadPropertiesFromStream( InputStream is, String name ) throw * if the file is inaccessible */ protected void loadConfiguration() throws IOException { - try { //first attempt file IO loading of properties - logSpecial("Attempting to load " + RESOURCE_FILE + " via file I/O."); - properties = loadPropertiesFromStream(getResourceStream(RESOURCE_FILE), RESOURCE_FILE); + logSpecial("Attempting to load " + resourceFile + " via file I/O."); + properties = loadPropertiesFromStream(getResourceStream(resourceFile), resourceFile); } catch (Exception iae) { //if file I/O loading fails, attempt classpath based loading next - logSpecial("Loading " + RESOURCE_FILE + " via file I/O failed. Exception was: " + iae); - logSpecial("Attempting to load " + RESOURCE_FILE + " via the classpath."); + logSpecial("Loading " + resourceFile + " via file I/O failed. Exception was: " + iae); + logSpecial("Attempting to load " + resourceFile + " via the classpath."); try { - properties = loadConfigurationFromClasspath(RESOURCE_FILE); + properties = loadConfigurationFromClasspath(resourceFile); } catch (Exception e) { - logSpecial(RESOURCE_FILE + " could not be loaded by any means. Fail.", e); - throw new ConfigurationException(RESOURCE_FILE + " could not be loaded by any means. Fail.", e); + logSpecial(resourceFile + " could not be loaded by any means. Fail.", e); + throw new ConfigurationException(resourceFile + " could not be loaded by any means. Fail.", e); } } // if properties loaded properly above, get validation properties and merge them into the main properties if (properties != null) { + final Iterator validationPropFileNames; - String validationPropFileName = getESAPIProperty(VALIDATION_PROPERTIES, "validation.properties"); - Properties validationProperties = null; - - //clear any cached validation patterns so they can be reloaded from validation.properties - patternCache.clear(); - - try { - //first attempt file IO loading of properties - logSpecial("Attempting to load " + validationPropFileName + " via file I/O."); - validationProperties = loadPropertiesFromStream(getResourceStream(validationPropFileName), validationPropFileName); - - } catch (Exception iae) { - //if file I/O loading fails, attempt classpath based loading next - logSpecial("Loading " + validationPropFileName + " via file I/O failed."); - logSpecial("Attempting to load " + validationPropFileName + " via the classpath."); - try { - validationProperties = loadConfigurationFromClasspath(validationPropFileName); - } catch (Exception e) { - logSpecial(validationPropFileName + " could not be loaded by any means. fail.", e); - } - } + //defaults to single-valued for backwards compatibility + final boolean multivalued= getESAPIProperty(VALIDATION_PROPERTIES_MULTIVALUED, false); + final String validationPropValue = getESAPIProperty(VALIDATION_PROPERTIES, "validation.properties"); - if (validationProperties != null) { - Iterator i = validationProperties.keySet().iterator(); - while( i.hasNext() ) { - String key = (String)i.next(); - String value = validationProperties.getProperty(key); - properties.put( key, value); - } + if(multivalued){ + // the following cast warning goes away if the apache commons lib is updated to current version + validationPropFileNames = StrTokenizer.getCSVInstance(validationPropValue); + } else { + validationPropFileNames = Collections.singletonList(validationPropValue).iterator(); } - if ( shouldPrintProperties() ) { - - //FIXME - make this chunk configurable - /* - logSpecial(" ========Master Configuration========", null); - //logSpecial( " ResourceDirectory: " + DefaultSecurityConfiguration.resourceDirectory ); - Iterator j = new TreeSet( properties.keySet() ).iterator(); - while (j.hasNext()) { - String key = (String)j.next(); - // print out properties, but not sensitive ones like MasterKey and MasterSalt - if ( !key.contains( "Master" ) ) { - logSpecial(" | " + key + "=" + properties.get(key), null); - } - } - */ - + //clear any cached validation patterns so they can be reloaded from validation.properties + patternCache.clear(); + while(validationPropFileNames.hasNext()){ + String validationPropFileName = validationPropFileNames.next(); + Properties validationProperties = null; + try { + //first attempt file IO loading of properties + logSpecial("Attempting to load " + validationPropFileName + " via file I/O."); + validationProperties = loadPropertiesFromStream(getResourceStream(validationPropFileName), validationPropFileName); + + } catch (Exception iae) { + //if file I/O loading fails, attempt classpath based loading next + logSpecial("Loading " + validationPropFileName + " via file I/O failed."); + logSpecial("Attempting to load " + validationPropFileName + " via the classpath."); + try { + validationProperties = loadConfigurationFromClasspath(validationPropFileName); + } catch (Exception e) { + logSpecial(validationPropFileName + " could not be loaded by any means. fail.", e); + } + } + + if (validationProperties != null) { + Iterator i = validationProperties.keySet().iterator(); + while( i.hasNext() ) { + String key = (String)i.next(); + String value = validationProperties.getProperty(key); + properties.put( key, value); + } + } + + if ( shouldPrintProperties() ) { + + //FIXME - make this chunk configurable + /* + logSpecial(" ========Master Configuration========", null); + //logSpecial( " ResourceDirectory: " + DefaultSecurityConfiguration.resourceDirectory ); + Iterator j = new TreeSet( properties.keySet() ).iterator(); + while (j.hasNext()) { + String key = (String)j.next(); + // print out properties, but not sensitive ones like MasterKey and MasterSalt + if ( !key.contains( "Master" ) ) { + logSpecial(" | " + key + "=" + properties.get(key), null); + } + } + */ + } } } } @@ -541,7 +562,7 @@ public File getResourceFile(String filename) { } // if not found, then try the programmatically set resource directory - // (this defaults to SystemResource directory/RESOURCE_FILE + // (this defaults to SystemResource directory/resourceFile URL fileUrl = ClassLoader.getSystemResource(resourceDirectory + "/" + filename); if ( fileUrl == null ) { fileUrl = ClassLoader.getSystemResource("esapi/" + filename); @@ -664,7 +685,7 @@ private Properties loadConfigurationFromClasspath(String fileName) throws Illega if (result == null) { // CHECKME: This is odd...why not ConfigurationException? - throw new IllegalArgumentException("Failed to load " + RESOURCE_FILE + " as a classloader resource."); + throw new IllegalArgumentException("Failed to load " + resourceFile + " as a classloader resource."); } return result; diff --git a/src/test/java/org/owasp/esapi/reference/DefaultSecurityConfigurationTest.java b/src/test/java/org/owasp/esapi/reference/DefaultSecurityConfigurationTest.java index 4e1d1fee3..b25d8e4dd 100644 --- a/src/test/java/org/owasp/esapi/reference/DefaultSecurityConfigurationTest.java +++ b/src/test/java/org/owasp/esapi/reference/DefaultSecurityConfigurationTest.java @@ -1,5 +1,7 @@ package org.owasp.esapi.reference; +import java.util.regex.Pattern; + import junit.framework.Assert; import org.junit.Test; @@ -385,6 +387,32 @@ public void testGetMaxLogFileSize() { secConf = this.createWithProperty(DefaultSecurityConfiguration.MAX_LOG_FILE_SIZE, String.valueOf(maxLogSize)); Assert.assertEquals(maxLogSize, secConf.getMaxLogFileSize()); } + + private String patternOrNull(Pattern p){ + return null==p?null:p.pattern(); + } + @Test + public void testValidationsPropertiesFileOptions(){ + DefaultSecurityConfiguration secConf = new DefaultSecurityConfiguration("ESAPI-SingleValidatorFileChecker.properties"); + Assert.assertEquals(patternOrNull(secConf.getValidationPattern("Test1")), "ValueFromFile1"); + Assert.assertNull(secConf.getValidationPattern("Test2")); + Assert.assertNull(secConf.getValidationPattern("TestC")); + + secConf = new DefaultSecurityConfiguration("ESAPI-DualValidatorFileChecker.properties"); + Assert.assertEquals(patternOrNull(secConf.getValidationPattern("Test1")), "ValueFromFile1"); + Assert.assertEquals(patternOrNull(secConf.getValidationPattern("Test2")), "ValueFromFile2"); + Assert.assertNull(secConf.getValidationPattern("TestC")); + + secConf = new DefaultSecurityConfiguration("ESAPI-CommaValidatorFileChecker.properties"); + Assert.assertEquals(patternOrNull(secConf.getValidationPattern("TestC")), "ValueFromCommaFile"); + Assert.assertNull(secConf.getValidationPattern("Test1")); + Assert.assertNull(secConf.getValidationPattern("Test2")); + + secConf = new DefaultSecurityConfiguration("ESAPI-QuotedValidatorFileChecker.properties"); + Assert.assertEquals(patternOrNull(secConf.getValidationPattern("Test1")), "ValueFromFile1"); + Assert.assertEquals(patternOrNull(secConf.getValidationPattern("Test2")), "ValueFromFile2"); + Assert.assertEquals(patternOrNull(secConf.getValidationPattern("TestC")), "ValueFromCommaFile"); + } } diff --git a/src/test/resources/esapi/ESAPI-CommaValidatorFileChecker.properties b/src/test/resources/esapi/ESAPI-CommaValidatorFileChecker.properties new file mode 100644 index 000000000..837d5a9d3 --- /dev/null +++ b/src/test/resources/esapi/ESAPI-CommaValidatorFileChecker.properties @@ -0,0 +1,466 @@ +# +# OWASP Enterprise Security API (ESAPI) Properties file -- TEST Version +# +# This file is part of the Open Web Application Security Project (OWASP) +# Enterprise Security API (ESAPI) project. For details, please see +# http://www.owasp.org/index.php/ESAPI. +# +# Copyright (c) 2008,2009 - The OWASP Foundation +# +# DISCUSS: This may cause a major backwards compatibility issue, etc. but +# from a name space perspective, we probably should have prefaced +# all the property names with ESAPI or at least OWASP. Otherwise +# there could be problems is someone loads this properties file into +# the System properties. We could also put this file into the +# esapi.jar file (perhaps as a ResourceBundle) and then allow an external +# ESAPI properties be defined that would overwrite these defaults. +# That keeps the application's properties relatively simple as usually +# they will only want to override a few properties. If looks like we +# already support multiple override levels of this in the +# DefaultSecurityConfiguration class, but I'm suggesting placing the +# defaults in the esapi.jar itself. That way, if the jar is signed, +# we could detect if those properties had been tampered with. (The +# code to check the jar signatures is pretty simple... maybe 70-90 LOC, +# but off course there is an execution penalty (similar to the way +# that the separate sunjce.jar used to be when a class from it was +# first loaded). Thoughts? +############################################################################### +# +# WARNING: Operating system protection should be used to lock down the .esapi +# resources directory and all the files inside and all the directories all the +# way up to the root directory of the file system. Note that if you are using +# file-based implementations, that some files may need to be read-write as they +# get updated dynamically. +# +# Before using, be sure to update the MasterKey and MasterSalt as described below. +# N.B.: If you had stored data that you have previously encrypted with ESAPI 1.4, +# you *must* FIRST decrypt it using ESAPI 1.4 and then (if so desired) +# re-encrypt it with ESAPI 2.0. If you fail to do this, you will NOT be +# able to decrypt your data with ESAPI 2.0. +# +# YOU HAVE BEEN WARNED!!! More details are in the ESAPI 2.0 Release Notes. +# +#=========================================================================== +# ESAPI Configuration +# +# If true, then print all the ESAPI properties set here when they are loaded. +# If false, they are not printed. Useful to reduce output when running JUnit tests. +# If you need to troubleshoot a properties related problem, turning this on may help, +# but we leave it off for running JUnit tests. (It will be 'true' in the one delivered +# as part of production ESAPI, mostly for backward compatibility.) +ESAPI.printProperties=false + +# ESAPI is designed to be easily extensible. You can use the reference implementation +# or implement your own providers to take advantage of your enterprise's security +# infrastructure. The functions in ESAPI are referenced using the ESAPI locator, like: +# +# String ciphertext = +# ESAPI.encryptor().encrypt("Secret message"); // Deprecated in 2.0 +# CipherText cipherText = +# ESAPI.encryptor().encrypt(new PlainText("Secret message")); // Preferred +# +# Below you can specify the classname for the provider that you wish to use in your +# application. The only requirement is that it implement the appropriate ESAPI interface. +# This allows you to switch security implementations in the future without rewriting the +# entire application. +# +# ExperimentalAccessController requires ESAPI-AccessControlPolicy.xml in .esapi directory +ESAPI.AccessControl=org.owasp.esapi.reference.DefaultAccessController +# FileBasedAuthenticator requires users.txt file in .esapi directory +ESAPI.Authenticator=org.owasp.esapi.reference.FileBasedAuthenticator +ESAPI.Encoder=org.owasp.esapi.reference.DefaultEncoder +ESAPI.Encryptor=org.owasp.esapi.reference.crypto.JavaEncryptor + +ESAPI.Executor=org.owasp.esapi.reference.DefaultExecutor +ESAPI.HTTPUtilities=org.owasp.esapi.reference.DefaultHTTPUtilities +ESAPI.IntrusionDetector=org.owasp.esapi.reference.DefaultIntrusionDetector +# Log4JFactory Requires log4j.xml or log4j.properties in classpath - http://www.laliluna.de/log4j-tutorial.html +ESAPI.Logger=org.owasp.esapi.reference.Log4JLogFactory +#ESAPI.Logger=org.owasp.esapi.reference.JavaLogFactory +#ESAPI.Logger=org.owasp.esapi.reference.ExampleExtendedLog4JLogFactory +ESAPI.Randomizer=org.owasp.esapi.reference.DefaultRandomizer +ESAPI.Validator=org.owasp.esapi.reference.DefaultValidator + +#=========================================================================== +# ESAPI Authenticator +# +Authenticator.AllowedLoginAttempts=3 +Authenticator.MaxOldPasswordHashes=13 +Authenticator.UsernameParameterName=username +Authenticator.PasswordParameterName=password +# RememberTokenDuration (in days) +Authenticator.RememberTokenDuration=14 +# Session Timeouts (in minutes) +Authenticator.IdleTimeoutDuration=20 +Authenticator.AbsoluteTimeoutDuration=120 + +#=========================================================================== +# ESAPI Encoder +# +# ESAPI canonicalizes input before validation to prevent bypassing filters with encoded attacks. +# Failure to canonicalize input is a very common mistake when implementing validation schemes. +# Canonicalization is automatic when using the ESAPI Validator, but you can also use the +# following code to canonicalize data. +# +# ESAPI.Encoder().canonicalize( "%22hello world"" ); +# +# Multiple encoding is when a single encoding format is applied multiple times. Allowing +# multiple encoding is strongly discouraged. +Encoder.AllowMultipleEncoding=false + +# Mixed encoding is when multiple different encoding formats are applied, or when +# multiple formats are nested. Allowing multiple encoding is strongly discouraged. +Encoder.AllowMixedEncoding=false + +# The default list of codecs to apply when canonicalizing untrusted data. The list should include the codecs +# for all downstream interpreters or decoders. For example, if the data is likely to end up in a URL, HTML, or +# inside JavaScript, then the list of codecs below is appropriate. The order of the list is not terribly important. +Encoder.DefaultCodecList=HTMLEntityCodec,PercentCodec,JavaScriptCodec + + +#=========================================================================== +# ESAPI Encryption +# +# The ESAPI Encryptor provides basic cryptographic functions with a simplified API. +# To get started, generate a new key using java -classpath esapi.jar org.owasp.esapi.reference.crypto.JavaEncryptor +# There is not currently any support for key rotation, so be careful when changing your key and salt as it +# will invalidate all signed, encrypted, and hashed data. +# +# WARNING: Not all combinations of algorithms and key lengths are supported. +# If you choose to use a key length greater than 128, you MUST download the +# unlimited strength policy files and install in the lib directory of your JRE/JDK. +# See http://java.sun.com/javase/downloads/index.jsp for more information. +# +# Backward compatibility with ESAPI Java 1.4 is supported by the two deprecated API +# methods, Encryptor.encrypt(String) and Encryptor.decrypt(String). However, whenever +# possible, these methods should be avoided as they use ECB cipher mode, which in almost +# all circumstances a poor choice because of it's weakness. CBC cipher mode is the default +# for the new Encryptor encrypt / decrypt methods for ESAPI Java 2.0. In general, you +# should only use this compatibility setting if you have persistent data encrypted with +# version 1.4 and even then, you should ONLY set this compatibility mode UNTIL +# you have decrypted all of your old encrypted data and then re-encrypted it with +# ESAPI 2.0 using CBC mode. If you have some reason to mix the deprecated 1.4 mode +# with the new 2.0 methods, make sure that you use the same cipher algorithm for both +# (256-bit AES was the default for 1.4; 128-bit is the default for 2.0; see below for +# more details.) Otherwise, you will have to use the new 2.0 encrypt / decrypt methods +# where you can specify a SecretKey. (Note that if you are using the 256-bit AES, +# that requires downloading the special jurisdiction policy files mentioned above.) +# +# ***** IMPORTANT: These are for JUnit testing. Test files may have been +# encrypted using these values so do not change these or +# those tests will fail. The version under +# src/main/resources/.esapi/ESAPI.properties +# will be delivered with Encryptor.MasterKey and +# Encryptor.MasterSalt set to the empty string. +# +# FINAL NOTE: +# If Maven changes these when run, that needs to be fixed. +# 256-bit key... requires unlimited strength jurisdiction policy files +### Encryptor.MasterKey=pJhlri8JbuFYDgkqtHmm9s0Ziug2PE7ovZDyEPm4j14= +# 128-bit key +Encryptor.MasterKey=a6H9is3hEVGKB4Jut+lOVA== +Encryptor.MasterSalt=SbftnvmEWD5ZHHP+pX3fqugNysc= +# Encryptor.MasterSalt= + +# Provides the default JCE provider that ESAPI will "prefer" for its symmetric +# encryption and hashing. (That is it will look to this provider first, but it +# will defer to other providers if the requested algorithm is not implemented +# by this provider.) If left unset, ESAPI will just use your Java VM's current +# preferred JCE provider, which is generally set in the file +# "$JAVA_HOME/jre/lib/security/java.security". +# +# The main intent of this is to allow ESAPI symmetric encryption to be +# used with a FIPS 140-2 compliant crypto-module. For details, see the section +# "Using ESAPI Symmetric Encryption with FIPS 140-2 Cryptographic Modules" in +# the ESAPI 2.0 Symmetric Encryption User Guide, at: +# http://owasp-esapi-java.googlecode.com/svn/trunk/documentation/esapi4java-core-2.0-symmetric-crypto-user-guide.html +# However, this property also allows you to easily use an alternate JCE provider +# such as "Bouncy Castle" without having to make changes to "java.security". +# See Javadoc for SecurityProviderLoader for further details. If you wish to use +# a provider that is not known to SecurityProviderLoader, you may specify the +# fully-qualified class name of the JCE provider class that implements +# java.security.Provider. If the name contains a '.', this is interpreted as +# a fully-qualified class name that implements java.security.Provider. +# +# NOTE: Setting this property has the side-effect of changing it in your application +# as well, so if you are using JCE in your application directly rather than +# through ESAPI (you wouldn't do that, would you? ;-), it will change the +# preferred JCE provider there as well. +# +# Default: Keeps the JCE provider set to whatever JVM sets it to. +Encryptor.PreferredJCEProvider= + +# AES is the most widely used and strongest encryption algorithm. This +# should agree with your Encryptor.CipherTransformation property. +# By default, ESAPI Java 1.4 uses "PBEWithMD5AndDES" and which is +# very weak. It is essentially a password-based encryption key, hashed +# with MD5 around 1K times and then encrypted with the weak DES algorithm +# (56-bits) using ECB mode and an unspecified padding (it is +# JCE provider specific, but most likely "NoPadding"). However, 2.0 uses +# "AES/CBC/PKCSPadding". If you want to change these, change them here. +# Warning: This property does not control the default reference implementation for +# ESAPI 2.0 using JavaEncryptor. Also, this property will be dropped +# in the future. +# @deprecated +Encryptor.EncryptionAlgorithm=AES +# For ESAPI Java 2.0 - New encrypt / decrypt methods use this. +Encryptor.CipherTransformation=AES/CBC/PKCS5Padding + +# Applies to ESAPI 2.0 and later only! +# Comma-separated list of cipher modes that provide *BOTH* +# confidentiality *AND* message authenticity. (NIST refers to such cipher +# modes as "combined modes" so that's what we shall call them.) If any of these +# cipher modes are used then no MAC is calculated and stored +# in the CipherText upon encryption. Likewise, if one of these +# cipher modes is used with decryption, no attempt will be made +# to validate the MAC contained in the CipherText object regardless +# of whether it contains one or not. Since the expectation is that +# these cipher modes support support message authenticity already, +# injecting a MAC in the CipherText object would be at best redundant. +# +# Note that as of JDK 1.5, the SunJCE provider does not support *any* +# of these cipher modes. Of these listed, only GCM and CCM are currently +# NIST approved. YMMV for other JCE providers. E.g., Bouncy Castle supports +# GCM and CCM with "NoPadding" mode, but not with "PKCS5Padding" or other +# padding modes. +Encryptor.cipher_modes.combined_modes=GCM,CCM,IAPM,EAX,OCB,CWC + +# Applies to ESAPI 2.0 and later only! +# Additional cipher modes allowed for ESAPI 2.0 encryption. These +# cipher modes are in _addition_ to those specified by the property +# 'Encryptor.cipher_modes.combined_modes'. +# Note: We will add support for streaming modes like CFB & OFB once +# we add support for 'specified' to the property 'Encryptor.ChooseIVMethod' +# (probably in ESAPI 2.1). +# +# IMPORTANT NOTE: In the official ESAPI.properties we do *NOT* include ECB +# here as this is an extremely weak mode. However, we *must* +# allow it here so we can test ECB mode. That is important +# since the logic is somewhat different (i.e., ECB mode does +# not use an IV). +# DISCUSS: Better name? +# NOTE: ECB added only for testing purposes. Don't try this at home! +Encryptor.cipher_modes.additional_allowed=CBC,ECB + +# 128-bit is almost always sufficient and appears to be more resistant to +# related key attacks than is 256-bit AES. Use '_' to use default key size +# for cipher algorithms (where it makes sense because the algorithm supports +# a variable key size). Key length must agree to what's provided as the +# cipher transformation, otherwise this will be ignored after logging a +# warning. +# +# NOTE: This is what applies BOTH ESAPI 1.4 and 2.0. See warning above about mixing! +Encryptor.EncryptionKeyLength=128 + +# Because 2.0 uses CBC mode by default, it requires an initialization vector (IV). +# (All cipher modes except ECB require an IV.) There are two choices: we can either +# use a fixed IV known to both parties or allow ESAPI to choose a random IV. While +# the IV does not need to be hidden from adversaries, it is important that the +# adversary not be allowed to choose it. Also, random IVs are generally much more +# secure than fixed IVs. (In fact, it is essential that feed-back cipher modes +# such as CFB and OFB use a different IV for each encryption with a given key so +# in such cases, random IVs are much preferred. By default, ESAPI 2.0 uses random +# IVs. If you wish to use 'fixed' IVs, set 'Encryptor.ChooseIVMethod=fixed' and +# uncomment the Encryptor.fixedIV. +# +# Valid values: random|fixed|specified 'specified' not yet implemented; planned for 2.1 +Encryptor.ChooseIVMethod=random +# If you choose to use a fixed IV, then you must place a fixed IV here that +# is known to all others who are sharing your secret key. The format should +# be a hex string that is the same length as the cipher block size for the +# cipher algorithm that you are using. The following is an example for AES +# from an AES test vector for AES-128/CBC as described in: +# NIST Special Publication 800-38A (2001 Edition) +# "Recommendation for Block Cipher Modes of Operation". +# (Note that the block size for AES is 16 bytes == 128 bits.) +# +Encryptor.fixedIV=0x000102030405060708090a0b0c0d0e0f + +# Whether or not CipherText should use a message authentication code (MAC) with it. +# This prevents an adversary from altering the IV as well as allowing a more +# fool-proof way of determining the decryption failed because of an incorrect +# key being supplied. This refers to the "separate" MAC calculated and stored +# in CipherText, not part of any MAC that is calculated as a result of a +# "combined mode" cipher mode. +# +# If you are using ESAPI with a FIPS 140-2 cryptographic module, you *must* also +# set this property to false. +Encryptor.CipherText.useMAC=true + +# Whether or not the PlainText object may be overwritten and then marked +# eligible for garbage collection. If not set, this is still treated as 'true'. +Encryptor.PlainText.overwrite=true + +# Do not use DES except in a legacy situations. 56-bit is way too small key size. +#Encryptor.EncryptionKeyLength=56 +#Encryptor.EncryptionAlgorithm=DES + +# TripleDES is considered strong enough for most purposes. +# Note: There is also a 112-bit version of DESede. Using the 168-bit version +# requires downloading the special jurisdiction policy from Sun. +#Encryptor.EncryptionKeyLength=168 +#Encryptor.EncryptionAlgorithm=DESede + +Encryptor.HashAlgorithm=SHA-512 +Encryptor.HashIterations=1024 +Encryptor.DigitalSignatureAlgorithm=SHA1withDSA +Encryptor.DigitalSignatureKeyLength=1024 +Encryptor.RandomAlgorithm=SHA1PRNG +Encryptor.CharacterEncoding=UTF-8 +# Currently supported choices for JDK 1.5 and 1.6 are: +# HmacSHA1 (160 bits), HmacSHA256 (256 bits), HmacSHA384 (384 bits), and +# HmacSHA512 (512 bits). +# Note that HmacMD5 is *not* supported for the PRF used by the KDF even though +# these JDKs support it. +Encryptor.KDF.PRF=HmacSHA256 + +#=========================================================================== +# ESAPI HttpUtilties +# +# The HttpUtilities provide basic protections to HTTP requests and responses. Primarily these methods +# protect against malicious data from attackers, such as unprintable characters, escaped characters, +# and other simple attacks. The HttpUtilities also provides utility methods for dealing with cookies, +# headers, and CSRF tokens. +# +# Default file upload location (remember to escape backslashes with \\) +HttpUtilities.UploadDir=C:\\ESAPI\\testUpload +# let this default to java.io.tmpdir for testing +#HttpUtilities.UploadTempDir=C:\\temp +# Force flags on cookies, if you use HttpUtilities to set cookies +HttpUtilities.ForceHttpOnlySession=false +HttpUtilities.ForceSecureSession=false +HttpUtilities.ForceHttpOnlyCookies=true +HttpUtilities.ForceSecureCookies=true +# Maximum size of HTTP headers +HttpUtilities.MaxHeaderSize=4096 +# File upload configuration +HttpUtilities.ApprovedUploadExtensions=.zip,.pdf,.doc,.docx,.ppt,.pptx,.tar,.gz,.tgz,.rar,.war,.jar,.ear,.xls,.rtf,.properties,.java,.class,.txt,.xml,.jsp,.jsf,.exe,.dll +HttpUtilities.MaxUploadFileBytes=500000000 +# Using UTF-8 throughout your stack is highly recommended. That includes your database driver, +# container, and any other technologies you may be using. Failure to do this may expose you +# to Unicode transcoding injection attacks. Use of UTF-8 does not hinder internationalization. +HttpUtilities.ResponseContentType=text/html; charset=UTF-8 +# This is the name of the cookie used to represent the HTTP session +# Typically this will be the default "JSESSIONID" +HttpUtilities.HttpSessionIdName=JSESSIONID + + + +#=========================================================================== +# ESAPI Executor +# CHECKME - Not sure what this is used for, but surely it should be made OS independent. +Executor.WorkingDirectory=C:\\Windows\\Temp +Executor.ApprovedExecutables=C:\\Windows\\System32\\cmd.exe,C:\\Windows\\System32\\runas.exe + + +#=========================================================================== +# ESAPI Logging +# Set the application name if these logs are combined with other applications +Logger.ApplicationName=ExampleApplication +# If you use an HTML log viewer that does not properly HTML escape log data, you can set LogEncodingRequired to true +Logger.LogEncodingRequired=false +# Determines whether ESAPI should log the application name. This might be clutter in some single-server/single-app environments. +Logger.LogApplicationName=true +# Determines whether ESAPI should log the server IP and port. This might be clutter in some single-server environments. +Logger.LogServerIP=true +# LogFileName, the name of the logging file. Provide a full directory path (e.g., C:\\ESAPI\\ESAPI_logging_file) if you +# want to place it in a specific directory. +Logger.LogFileName=ESAPI_logging_file +# MaxLogFileSize, the max size (in bytes) of a single log file before it cuts over to a new one (default is 10,000,000) +Logger.MaxLogFileSize=10000000 + + +#=========================================================================== +# ESAPI Intrusion Detection +# +# Each event has a base to which .count, .interval, and .action are added +# The IntrusionException will fire if we receive "count" events within "interval" seconds +# The IntrusionDetector is configurable to take the following actions: log, logout, and disable +# (multiple actions separated by commas are allowed e.g. event.test.actions=log,disable +# +# Custom Events +# Names must start with "event." as the base +# Use IntrusionDetector.addEvent( "test" ) in your code to trigger "event.test" here +# You can also disable intrusion detection completely by changing +# the following parameter to true +# +IntrusionDetector.Disable=false +# +IntrusionDetector.event.test.count=2 +IntrusionDetector.event.test.interval=10 +IntrusionDetector.event.test.actions=disable,log + +# Exception Events +# All EnterpriseSecurityExceptions are registered automatically +# Call IntrusionDetector.getInstance().addException(e) for Exceptions that do not extend EnterpriseSecurityException +# Use the fully qualified classname of the exception as the base + +# any intrusion is an attack +IntrusionDetector.org.owasp.esapi.errors.IntrusionException.count=1 +IntrusionDetector.org.owasp.esapi.errors.IntrusionException.interval=1 +IntrusionDetector.org.owasp.esapi.errors.IntrusionException.actions=log,disable,logout + +# for test purposes +# CHECKME: Shouldn't there be something in the property name itself that designates +# that these are for testing??? +IntrusionDetector.org.owasp.esapi.errors.IntegrityException.count=10 +IntrusionDetector.org.owasp.esapi.errors.IntegrityException.interval=5 +IntrusionDetector.org.owasp.esapi.errors.IntegrityException.actions=log,disable,logout + +# rapid validation errors indicate scans or attacks in progress +# org.owasp.esapi.errors.ValidationException.count=10 +# org.owasp.esapi.errors.ValidationException.interval=10 +# org.owasp.esapi.errors.ValidationException.actions=log,logout + +# sessions jumping between hosts indicates session hijacking +IntrusionDetector.org.owasp.esapi.errors.AuthenticationHostException.count=2 +IntrusionDetector.org.owasp.esapi.errors.AuthenticationHostException.interval=10 +IntrusionDetector.org.owasp.esapi.errors.AuthenticationHostException.actions=log,logout + + +#=========================================================================== +# ESAPI Validation +# +# The ESAPI Validator works on regular expressions with defined names. You can define names +# either here, or you may define application specific patterns in a separate file defined below. +# This allows enterprises to specify both organizational standards as well as application specific +# validation rules. +# +#Validator.ConfigurationFile.MultiValued=false +Validator.ConfigurationFile=validation-test,comma.properties + +# Validators used by ESAPI +Validator.AccountName=^[a-zA-Z0-9]{3,20}$ +Validator.SystemCommand=^[a-zA-Z\\-\\/]{1,64}$ +Validator.RoleName=^[a-z]{1,20}$ +Validator.Redirect=^\\/test.*$ + +# Global HTTP Validation Rules +# Values with Base64 encoded data (e.g. encrypted state) will need at least [a-zA-Z0-9\/+=] +Validator.HTTPScheme=^(http|https)$ +Validator.HTTPServerName=^[a-zA-Z0-9_.\\-]*$ +Validator.HTTPCookieName=^[a-zA-Z0-9\\-_]{1,32}$ +Validator.HTTPCookieValue=^[a-zA-Z0-9\\-\\/+=_ ]*$ +Validator.HTTPHeaderName=^[a-zA-Z0-9\\-_]{1,32}$ +Validator.HTTPHeaderValue=^[a-zA-Z0-9()\\-=\\*\\.\\?;,+\\/:&_ ]*$ +Validator.HTTPServletPath=^[a-zA-Z0-9.\\-\\/_]*$ +Validator.HTTPPath=^[a-zA-Z0-9.\\-_]*$ +Validator.HTTPURL=^.*$ +Validator.HTTPJSESSIONID=^[A-Z0-9]{10,30}$ + +# Contributed by Fraenku@gmx.ch +# Googlecode Issue 116 (http://code.google.com/p/owasp-esapi-java/issues/detail?id=116) +Validator.HTTPParameterName=^[a-zA-Z0-9_\\-]{1,32}$ +Validator.HTTPParameterValue=^[\\p{L}\\p{N}.\\-/+=_ !$*?@]{0,1000}$ +Validator.HTTPContextPath=^/[a-zA-Z0-9.\\-_]*$ +Validator.HTTPQueryString=^([a-zA-Z0-9_\\-]{1,32}=[\\p{L}\\p{N}.\\-/+=_ !$*?@%]*&?)*$ +Validator.HTTPURI=^/([a-zA-Z0-9.\\-_]*/?)*$ + + +# Validation of file related input +Validator.FileName=^[a-zA-Z0-9!@#$%^&{}\\[\\]()_+\\-=,.~'` ]{1,255}$ +Validator.DirectoryName=^[a-zA-Z0-9:/\\\\!@#$%^&{}\\[\\]()_+\\-=,.~'` ]{1,255}$ + +# Validation of dates. Controls whether or not 'lenient' dates are accepted. +# See DataFormat.setLenient(boolean flag) for further details. +Validator.AcceptLenientDates=false \ No newline at end of file diff --git a/src/test/resources/esapi/ESAPI-DualValidatorFileChecker.properties b/src/test/resources/esapi/ESAPI-DualValidatorFileChecker.properties new file mode 100644 index 000000000..afa1d75f0 --- /dev/null +++ b/src/test/resources/esapi/ESAPI-DualValidatorFileChecker.properties @@ -0,0 +1,466 @@ +# +# OWASP Enterprise Security API (ESAPI) Properties file -- TEST Version +# +# This file is part of the Open Web Application Security Project (OWASP) +# Enterprise Security API (ESAPI) project. For details, please see +# http://www.owasp.org/index.php/ESAPI. +# +# Copyright (c) 2008,2009 - The OWASP Foundation +# +# DISCUSS: This may cause a major backwards compatibility issue, etc. but +# from a name space perspective, we probably should have prefaced +# all the property names with ESAPI or at least OWASP. Otherwise +# there could be problems is someone loads this properties file into +# the System properties. We could also put this file into the +# esapi.jar file (perhaps as a ResourceBundle) and then allow an external +# ESAPI properties be defined that would overwrite these defaults. +# That keeps the application's properties relatively simple as usually +# they will only want to override a few properties. If looks like we +# already support multiple override levels of this in the +# DefaultSecurityConfiguration class, but I'm suggesting placing the +# defaults in the esapi.jar itself. That way, if the jar is signed, +# we could detect if those properties had been tampered with. (The +# code to check the jar signatures is pretty simple... maybe 70-90 LOC, +# but off course there is an execution penalty (similar to the way +# that the separate sunjce.jar used to be when a class from it was +# first loaded). Thoughts? +############################################################################### +# +# WARNING: Operating system protection should be used to lock down the .esapi +# resources directory and all the files inside and all the directories all the +# way up to the root directory of the file system. Note that if you are using +# file-based implementations, that some files may need to be read-write as they +# get updated dynamically. +# +# Before using, be sure to update the MasterKey and MasterSalt as described below. +# N.B.: If you had stored data that you have previously encrypted with ESAPI 1.4, +# you *must* FIRST decrypt it using ESAPI 1.4 and then (if so desired) +# re-encrypt it with ESAPI 2.0. If you fail to do this, you will NOT be +# able to decrypt your data with ESAPI 2.0. +# +# YOU HAVE BEEN WARNED!!! More details are in the ESAPI 2.0 Release Notes. +# +#=========================================================================== +# ESAPI Configuration +# +# If true, then print all the ESAPI properties set here when they are loaded. +# If false, they are not printed. Useful to reduce output when running JUnit tests. +# If you need to troubleshoot a properties related problem, turning this on may help, +# but we leave it off for running JUnit tests. (It will be 'true' in the one delivered +# as part of production ESAPI, mostly for backward compatibility.) +ESAPI.printProperties=false + +# ESAPI is designed to be easily extensible. You can use the reference implementation +# or implement your own providers to take advantage of your enterprise's security +# infrastructure. The functions in ESAPI are referenced using the ESAPI locator, like: +# +# String ciphertext = +# ESAPI.encryptor().encrypt("Secret message"); // Deprecated in 2.0 +# CipherText cipherText = +# ESAPI.encryptor().encrypt(new PlainText("Secret message")); // Preferred +# +# Below you can specify the classname for the provider that you wish to use in your +# application. The only requirement is that it implement the appropriate ESAPI interface. +# This allows you to switch security implementations in the future without rewriting the +# entire application. +# +# ExperimentalAccessController requires ESAPI-AccessControlPolicy.xml in .esapi directory +ESAPI.AccessControl=org.owasp.esapi.reference.DefaultAccessController +# FileBasedAuthenticator requires users.txt file in .esapi directory +ESAPI.Authenticator=org.owasp.esapi.reference.FileBasedAuthenticator +ESAPI.Encoder=org.owasp.esapi.reference.DefaultEncoder +ESAPI.Encryptor=org.owasp.esapi.reference.crypto.JavaEncryptor + +ESAPI.Executor=org.owasp.esapi.reference.DefaultExecutor +ESAPI.HTTPUtilities=org.owasp.esapi.reference.DefaultHTTPUtilities +ESAPI.IntrusionDetector=org.owasp.esapi.reference.DefaultIntrusionDetector +# Log4JFactory Requires log4j.xml or log4j.properties in classpath - http://www.laliluna.de/log4j-tutorial.html +ESAPI.Logger=org.owasp.esapi.reference.Log4JLogFactory +#ESAPI.Logger=org.owasp.esapi.reference.JavaLogFactory +#ESAPI.Logger=org.owasp.esapi.reference.ExampleExtendedLog4JLogFactory +ESAPI.Randomizer=org.owasp.esapi.reference.DefaultRandomizer +ESAPI.Validator=org.owasp.esapi.reference.DefaultValidator + +#=========================================================================== +# ESAPI Authenticator +# +Authenticator.AllowedLoginAttempts=3 +Authenticator.MaxOldPasswordHashes=13 +Authenticator.UsernameParameterName=username +Authenticator.PasswordParameterName=password +# RememberTokenDuration (in days) +Authenticator.RememberTokenDuration=14 +# Session Timeouts (in minutes) +Authenticator.IdleTimeoutDuration=20 +Authenticator.AbsoluteTimeoutDuration=120 + +#=========================================================================== +# ESAPI Encoder +# +# ESAPI canonicalizes input before validation to prevent bypassing filters with encoded attacks. +# Failure to canonicalize input is a very common mistake when implementing validation schemes. +# Canonicalization is automatic when using the ESAPI Validator, but you can also use the +# following code to canonicalize data. +# +# ESAPI.Encoder().canonicalize( "%22hello world"" ); +# +# Multiple encoding is when a single encoding format is applied multiple times. Allowing +# multiple encoding is strongly discouraged. +Encoder.AllowMultipleEncoding=false + +# Mixed encoding is when multiple different encoding formats are applied, or when +# multiple formats are nested. Allowing multiple encoding is strongly discouraged. +Encoder.AllowMixedEncoding=false + +# The default list of codecs to apply when canonicalizing untrusted data. The list should include the codecs +# for all downstream interpreters or decoders. For example, if the data is likely to end up in a URL, HTML, or +# inside JavaScript, then the list of codecs below is appropriate. The order of the list is not terribly important. +Encoder.DefaultCodecList=HTMLEntityCodec,PercentCodec,JavaScriptCodec + + +#=========================================================================== +# ESAPI Encryption +# +# The ESAPI Encryptor provides basic cryptographic functions with a simplified API. +# To get started, generate a new key using java -classpath esapi.jar org.owasp.esapi.reference.crypto.JavaEncryptor +# There is not currently any support for key rotation, so be careful when changing your key and salt as it +# will invalidate all signed, encrypted, and hashed data. +# +# WARNING: Not all combinations of algorithms and key lengths are supported. +# If you choose to use a key length greater than 128, you MUST download the +# unlimited strength policy files and install in the lib directory of your JRE/JDK. +# See http://java.sun.com/javase/downloads/index.jsp for more information. +# +# Backward compatibility with ESAPI Java 1.4 is supported by the two deprecated API +# methods, Encryptor.encrypt(String) and Encryptor.decrypt(String). However, whenever +# possible, these methods should be avoided as they use ECB cipher mode, which in almost +# all circumstances a poor choice because of it's weakness. CBC cipher mode is the default +# for the new Encryptor encrypt / decrypt methods for ESAPI Java 2.0. In general, you +# should only use this compatibility setting if you have persistent data encrypted with +# version 1.4 and even then, you should ONLY set this compatibility mode UNTIL +# you have decrypted all of your old encrypted data and then re-encrypted it with +# ESAPI 2.0 using CBC mode. If you have some reason to mix the deprecated 1.4 mode +# with the new 2.0 methods, make sure that you use the same cipher algorithm for both +# (256-bit AES was the default for 1.4; 128-bit is the default for 2.0; see below for +# more details.) Otherwise, you will have to use the new 2.0 encrypt / decrypt methods +# where you can specify a SecretKey. (Note that if you are using the 256-bit AES, +# that requires downloading the special jurisdiction policy files mentioned above.) +# +# ***** IMPORTANT: These are for JUnit testing. Test files may have been +# encrypted using these values so do not change these or +# those tests will fail. The version under +# src/main/resources/.esapi/ESAPI.properties +# will be delivered with Encryptor.MasterKey and +# Encryptor.MasterSalt set to the empty string. +# +# FINAL NOTE: +# If Maven changes these when run, that needs to be fixed. +# 256-bit key... requires unlimited strength jurisdiction policy files +### Encryptor.MasterKey=pJhlri8JbuFYDgkqtHmm9s0Ziug2PE7ovZDyEPm4j14= +# 128-bit key +Encryptor.MasterKey=a6H9is3hEVGKB4Jut+lOVA== +Encryptor.MasterSalt=SbftnvmEWD5ZHHP+pX3fqugNysc= +# Encryptor.MasterSalt= + +# Provides the default JCE provider that ESAPI will "prefer" for its symmetric +# encryption and hashing. (That is it will look to this provider first, but it +# will defer to other providers if the requested algorithm is not implemented +# by this provider.) If left unset, ESAPI will just use your Java VM's current +# preferred JCE provider, which is generally set in the file +# "$JAVA_HOME/jre/lib/security/java.security". +# +# The main intent of this is to allow ESAPI symmetric encryption to be +# used with a FIPS 140-2 compliant crypto-module. For details, see the section +# "Using ESAPI Symmetric Encryption with FIPS 140-2 Cryptographic Modules" in +# the ESAPI 2.0 Symmetric Encryption User Guide, at: +# http://owasp-esapi-java.googlecode.com/svn/trunk/documentation/esapi4java-core-2.0-symmetric-crypto-user-guide.html +# However, this property also allows you to easily use an alternate JCE provider +# such as "Bouncy Castle" without having to make changes to "java.security". +# See Javadoc for SecurityProviderLoader for further details. If you wish to use +# a provider that is not known to SecurityProviderLoader, you may specify the +# fully-qualified class name of the JCE provider class that implements +# java.security.Provider. If the name contains a '.', this is interpreted as +# a fully-qualified class name that implements java.security.Provider. +# +# NOTE: Setting this property has the side-effect of changing it in your application +# as well, so if you are using JCE in your application directly rather than +# through ESAPI (you wouldn't do that, would you? ;-), it will change the +# preferred JCE provider there as well. +# +# Default: Keeps the JCE provider set to whatever JVM sets it to. +Encryptor.PreferredJCEProvider= + +# AES is the most widely used and strongest encryption algorithm. This +# should agree with your Encryptor.CipherTransformation property. +# By default, ESAPI Java 1.4 uses "PBEWithMD5AndDES" and which is +# very weak. It is essentially a password-based encryption key, hashed +# with MD5 around 1K times and then encrypted with the weak DES algorithm +# (56-bits) using ECB mode and an unspecified padding (it is +# JCE provider specific, but most likely "NoPadding"). However, 2.0 uses +# "AES/CBC/PKCSPadding". If you want to change these, change them here. +# Warning: This property does not control the default reference implementation for +# ESAPI 2.0 using JavaEncryptor. Also, this property will be dropped +# in the future. +# @deprecated +Encryptor.EncryptionAlgorithm=AES +# For ESAPI Java 2.0 - New encrypt / decrypt methods use this. +Encryptor.CipherTransformation=AES/CBC/PKCS5Padding + +# Applies to ESAPI 2.0 and later only! +# Comma-separated list of cipher modes that provide *BOTH* +# confidentiality *AND* message authenticity. (NIST refers to such cipher +# modes as "combined modes" so that's what we shall call them.) If any of these +# cipher modes are used then no MAC is calculated and stored +# in the CipherText upon encryption. Likewise, if one of these +# cipher modes is used with decryption, no attempt will be made +# to validate the MAC contained in the CipherText object regardless +# of whether it contains one or not. Since the expectation is that +# these cipher modes support support message authenticity already, +# injecting a MAC in the CipherText object would be at best redundant. +# +# Note that as of JDK 1.5, the SunJCE provider does not support *any* +# of these cipher modes. Of these listed, only GCM and CCM are currently +# NIST approved. YMMV for other JCE providers. E.g., Bouncy Castle supports +# GCM and CCM with "NoPadding" mode, but not with "PKCS5Padding" or other +# padding modes. +Encryptor.cipher_modes.combined_modes=GCM,CCM,IAPM,EAX,OCB,CWC + +# Applies to ESAPI 2.0 and later only! +# Additional cipher modes allowed for ESAPI 2.0 encryption. These +# cipher modes are in _addition_ to those specified by the property +# 'Encryptor.cipher_modes.combined_modes'. +# Note: We will add support for streaming modes like CFB & OFB once +# we add support for 'specified' to the property 'Encryptor.ChooseIVMethod' +# (probably in ESAPI 2.1). +# +# IMPORTANT NOTE: In the official ESAPI.properties we do *NOT* include ECB +# here as this is an extremely weak mode. However, we *must* +# allow it here so we can test ECB mode. That is important +# since the logic is somewhat different (i.e., ECB mode does +# not use an IV). +# DISCUSS: Better name? +# NOTE: ECB added only for testing purposes. Don't try this at home! +Encryptor.cipher_modes.additional_allowed=CBC,ECB + +# 128-bit is almost always sufficient and appears to be more resistant to +# related key attacks than is 256-bit AES. Use '_' to use default key size +# for cipher algorithms (where it makes sense because the algorithm supports +# a variable key size). Key length must agree to what's provided as the +# cipher transformation, otherwise this will be ignored after logging a +# warning. +# +# NOTE: This is what applies BOTH ESAPI 1.4 and 2.0. See warning above about mixing! +Encryptor.EncryptionKeyLength=128 + +# Because 2.0 uses CBC mode by default, it requires an initialization vector (IV). +# (All cipher modes except ECB require an IV.) There are two choices: we can either +# use a fixed IV known to both parties or allow ESAPI to choose a random IV. While +# the IV does not need to be hidden from adversaries, it is important that the +# adversary not be allowed to choose it. Also, random IVs are generally much more +# secure than fixed IVs. (In fact, it is essential that feed-back cipher modes +# such as CFB and OFB use a different IV for each encryption with a given key so +# in such cases, random IVs are much preferred. By default, ESAPI 2.0 uses random +# IVs. If you wish to use 'fixed' IVs, set 'Encryptor.ChooseIVMethod=fixed' and +# uncomment the Encryptor.fixedIV. +# +# Valid values: random|fixed|specified 'specified' not yet implemented; planned for 2.1 +Encryptor.ChooseIVMethod=random +# If you choose to use a fixed IV, then you must place a fixed IV here that +# is known to all others who are sharing your secret key. The format should +# be a hex string that is the same length as the cipher block size for the +# cipher algorithm that you are using. The following is an example for AES +# from an AES test vector for AES-128/CBC as described in: +# NIST Special Publication 800-38A (2001 Edition) +# "Recommendation for Block Cipher Modes of Operation". +# (Note that the block size for AES is 16 bytes == 128 bits.) +# +Encryptor.fixedIV=0x000102030405060708090a0b0c0d0e0f + +# Whether or not CipherText should use a message authentication code (MAC) with it. +# This prevents an adversary from altering the IV as well as allowing a more +# fool-proof way of determining the decryption failed because of an incorrect +# key being supplied. This refers to the "separate" MAC calculated and stored +# in CipherText, not part of any MAC that is calculated as a result of a +# "combined mode" cipher mode. +# +# If you are using ESAPI with a FIPS 140-2 cryptographic module, you *must* also +# set this property to false. +Encryptor.CipherText.useMAC=true + +# Whether or not the PlainText object may be overwritten and then marked +# eligible for garbage collection. If not set, this is still treated as 'true'. +Encryptor.PlainText.overwrite=true + +# Do not use DES except in a legacy situations. 56-bit is way too small key size. +#Encryptor.EncryptionKeyLength=56 +#Encryptor.EncryptionAlgorithm=DES + +# TripleDES is considered strong enough for most purposes. +# Note: There is also a 112-bit version of DESede. Using the 168-bit version +# requires downloading the special jurisdiction policy from Sun. +#Encryptor.EncryptionKeyLength=168 +#Encryptor.EncryptionAlgorithm=DESede + +Encryptor.HashAlgorithm=SHA-512 +Encryptor.HashIterations=1024 +Encryptor.DigitalSignatureAlgorithm=SHA1withDSA +Encryptor.DigitalSignatureKeyLength=1024 +Encryptor.RandomAlgorithm=SHA1PRNG +Encryptor.CharacterEncoding=UTF-8 +# Currently supported choices for JDK 1.5 and 1.6 are: +# HmacSHA1 (160 bits), HmacSHA256 (256 bits), HmacSHA384 (384 bits), and +# HmacSHA512 (512 bits). +# Note that HmacMD5 is *not* supported for the PRF used by the KDF even though +# these JDKs support it. +Encryptor.KDF.PRF=HmacSHA256 + +#=========================================================================== +# ESAPI HttpUtilties +# +# The HttpUtilities provide basic protections to HTTP requests and responses. Primarily these methods +# protect against malicious data from attackers, such as unprintable characters, escaped characters, +# and other simple attacks. The HttpUtilities also provides utility methods for dealing with cookies, +# headers, and CSRF tokens. +# +# Default file upload location (remember to escape backslashes with \\) +HttpUtilities.UploadDir=C:\\ESAPI\\testUpload +# let this default to java.io.tmpdir for testing +#HttpUtilities.UploadTempDir=C:\\temp +# Force flags on cookies, if you use HttpUtilities to set cookies +HttpUtilities.ForceHttpOnlySession=false +HttpUtilities.ForceSecureSession=false +HttpUtilities.ForceHttpOnlyCookies=true +HttpUtilities.ForceSecureCookies=true +# Maximum size of HTTP headers +HttpUtilities.MaxHeaderSize=4096 +# File upload configuration +HttpUtilities.ApprovedUploadExtensions=.zip,.pdf,.doc,.docx,.ppt,.pptx,.tar,.gz,.tgz,.rar,.war,.jar,.ear,.xls,.rtf,.properties,.java,.class,.txt,.xml,.jsp,.jsf,.exe,.dll +HttpUtilities.MaxUploadFileBytes=500000000 +# Using UTF-8 throughout your stack is highly recommended. That includes your database driver, +# container, and any other technologies you may be using. Failure to do this may expose you +# to Unicode transcoding injection attacks. Use of UTF-8 does not hinder internationalization. +HttpUtilities.ResponseContentType=text/html; charset=UTF-8 +# This is the name of the cookie used to represent the HTTP session +# Typically this will be the default "JSESSIONID" +HttpUtilities.HttpSessionIdName=JSESSIONID + + + +#=========================================================================== +# ESAPI Executor +# CHECKME - Not sure what this is used for, but surely it should be made OS independent. +Executor.WorkingDirectory=C:\\Windows\\Temp +Executor.ApprovedExecutables=C:\\Windows\\System32\\cmd.exe,C:\\Windows\\System32\\runas.exe + + +#=========================================================================== +# ESAPI Logging +# Set the application name if these logs are combined with other applications +Logger.ApplicationName=ExampleApplication +# If you use an HTML log viewer that does not properly HTML escape log data, you can set LogEncodingRequired to true +Logger.LogEncodingRequired=false +# Determines whether ESAPI should log the application name. This might be clutter in some single-server/single-app environments. +Logger.LogApplicationName=true +# Determines whether ESAPI should log the server IP and port. This might be clutter in some single-server environments. +Logger.LogServerIP=true +# LogFileName, the name of the logging file. Provide a full directory path (e.g., C:\\ESAPI\\ESAPI_logging_file) if you +# want to place it in a specific directory. +Logger.LogFileName=ESAPI_logging_file +# MaxLogFileSize, the max size (in bytes) of a single log file before it cuts over to a new one (default is 10,000,000) +Logger.MaxLogFileSize=10000000 + + +#=========================================================================== +# ESAPI Intrusion Detection +# +# Each event has a base to which .count, .interval, and .action are added +# The IntrusionException will fire if we receive "count" events within "interval" seconds +# The IntrusionDetector is configurable to take the following actions: log, logout, and disable +# (multiple actions separated by commas are allowed e.g. event.test.actions=log,disable +# +# Custom Events +# Names must start with "event." as the base +# Use IntrusionDetector.addEvent( "test" ) in your code to trigger "event.test" here +# You can also disable intrusion detection completely by changing +# the following parameter to true +# +IntrusionDetector.Disable=false +# +IntrusionDetector.event.test.count=2 +IntrusionDetector.event.test.interval=10 +IntrusionDetector.event.test.actions=disable,log + +# Exception Events +# All EnterpriseSecurityExceptions are registered automatically +# Call IntrusionDetector.getInstance().addException(e) for Exceptions that do not extend EnterpriseSecurityException +# Use the fully qualified classname of the exception as the base + +# any intrusion is an attack +IntrusionDetector.org.owasp.esapi.errors.IntrusionException.count=1 +IntrusionDetector.org.owasp.esapi.errors.IntrusionException.interval=1 +IntrusionDetector.org.owasp.esapi.errors.IntrusionException.actions=log,disable,logout + +# for test purposes +# CHECKME: Shouldn't there be something in the property name itself that designates +# that these are for testing??? +IntrusionDetector.org.owasp.esapi.errors.IntegrityException.count=10 +IntrusionDetector.org.owasp.esapi.errors.IntegrityException.interval=5 +IntrusionDetector.org.owasp.esapi.errors.IntegrityException.actions=log,disable,logout + +# rapid validation errors indicate scans or attacks in progress +# org.owasp.esapi.errors.ValidationException.count=10 +# org.owasp.esapi.errors.ValidationException.interval=10 +# org.owasp.esapi.errors.ValidationException.actions=log,logout + +# sessions jumping between hosts indicates session hijacking +IntrusionDetector.org.owasp.esapi.errors.AuthenticationHostException.count=2 +IntrusionDetector.org.owasp.esapi.errors.AuthenticationHostException.interval=10 +IntrusionDetector.org.owasp.esapi.errors.AuthenticationHostException.actions=log,logout + + +#=========================================================================== +# ESAPI Validation +# +# The ESAPI Validator works on regular expressions with defined names. You can define names +# either here, or you may define application specific patterns in a separate file defined below. +# This allows enterprises to specify both organizational standards as well as application specific +# validation rules. +# +Validator.ConfigurationFile.MultiValued=true +Validator.ConfigurationFile=validation-test1.properties,validation-test2.properties + +# Validators used by ESAPI +Validator.AccountName=^[a-zA-Z0-9]{3,20}$ +Validator.SystemCommand=^[a-zA-Z\\-\\/]{1,64}$ +Validator.RoleName=^[a-z]{1,20}$ +Validator.Redirect=^\\/test.*$ + +# Global HTTP Validation Rules +# Values with Base64 encoded data (e.g. encrypted state) will need at least [a-zA-Z0-9\/+=] +Validator.HTTPScheme=^(http|https)$ +Validator.HTTPServerName=^[a-zA-Z0-9_.\\-]*$ +Validator.HTTPCookieName=^[a-zA-Z0-9\\-_]{1,32}$ +Validator.HTTPCookieValue=^[a-zA-Z0-9\\-\\/+=_ ]*$ +Validator.HTTPHeaderName=^[a-zA-Z0-9\\-_]{1,32}$ +Validator.HTTPHeaderValue=^[a-zA-Z0-9()\\-=\\*\\.\\?;,+\\/:&_ ]*$ +Validator.HTTPServletPath=^[a-zA-Z0-9.\\-\\/_]*$ +Validator.HTTPPath=^[a-zA-Z0-9.\\-_]*$ +Validator.HTTPURL=^.*$ +Validator.HTTPJSESSIONID=^[A-Z0-9]{10,30}$ + +# Contributed by Fraenku@gmx.ch +# Googlecode Issue 116 (http://code.google.com/p/owasp-esapi-java/issues/detail?id=116) +Validator.HTTPParameterName=^[a-zA-Z0-9_\\-]{1,32}$ +Validator.HTTPParameterValue=^[\\p{L}\\p{N}.\\-/+=_ !$*?@]{0,1000}$ +Validator.HTTPContextPath=^/[a-zA-Z0-9.\\-_]*$ +Validator.HTTPQueryString=^([a-zA-Z0-9_\\-]{1,32}=[\\p{L}\\p{N}.\\-/+=_ !$*?@%]*&?)*$ +Validator.HTTPURI=^/([a-zA-Z0-9.\\-_]*/?)*$ + + +# Validation of file related input +Validator.FileName=^[a-zA-Z0-9!@#$%^&{}\\[\\]()_+\\-=,.~'` ]{1,255}$ +Validator.DirectoryName=^[a-zA-Z0-9:/\\\\!@#$%^&{}\\[\\]()_+\\-=,.~'` ]{1,255}$ + +# Validation of dates. Controls whether or not 'lenient' dates are accepted. +# See DataFormat.setLenient(boolean flag) for further details. +Validator.AcceptLenientDates=false \ No newline at end of file diff --git a/src/test/resources/esapi/ESAPI-QuotedValidatorFileChecker.properties b/src/test/resources/esapi/ESAPI-QuotedValidatorFileChecker.properties new file mode 100644 index 000000000..2dc8c5d15 --- /dev/null +++ b/src/test/resources/esapi/ESAPI-QuotedValidatorFileChecker.properties @@ -0,0 +1,466 @@ +# +# OWASP Enterprise Security API (ESAPI) Properties file -- TEST Version +# +# This file is part of the Open Web Application Security Project (OWASP) +# Enterprise Security API (ESAPI) project. For details, please see +# http://www.owasp.org/index.php/ESAPI. +# +# Copyright (c) 2008,2009 - The OWASP Foundation +# +# DISCUSS: This may cause a major backwards compatibility issue, etc. but +# from a name space perspective, we probably should have prefaced +# all the property names with ESAPI or at least OWASP. Otherwise +# there could be problems is someone loads this properties file into +# the System properties. We could also put this file into the +# esapi.jar file (perhaps as a ResourceBundle) and then allow an external +# ESAPI properties be defined that would overwrite these defaults. +# That keeps the application's properties relatively simple as usually +# they will only want to override a few properties. If looks like we +# already support multiple override levels of this in the +# DefaultSecurityConfiguration class, but I'm suggesting placing the +# defaults in the esapi.jar itself. That way, if the jar is signed, +# we could detect if those properties had been tampered with. (The +# code to check the jar signatures is pretty simple... maybe 70-90 LOC, +# but off course there is an execution penalty (similar to the way +# that the separate sunjce.jar used to be when a class from it was +# first loaded). Thoughts? +############################################################################### +# +# WARNING: Operating system protection should be used to lock down the .esapi +# resources directory and all the files inside and all the directories all the +# way up to the root directory of the file system. Note that if you are using +# file-based implementations, that some files may need to be read-write as they +# get updated dynamically. +# +# Before using, be sure to update the MasterKey and MasterSalt as described below. +# N.B.: If you had stored data that you have previously encrypted with ESAPI 1.4, +# you *must* FIRST decrypt it using ESAPI 1.4 and then (if so desired) +# re-encrypt it with ESAPI 2.0. If you fail to do this, you will NOT be +# able to decrypt your data with ESAPI 2.0. +# +# YOU HAVE BEEN WARNED!!! More details are in the ESAPI 2.0 Release Notes. +# +#=========================================================================== +# ESAPI Configuration +# +# If true, then print all the ESAPI properties set here when they are loaded. +# If false, they are not printed. Useful to reduce output when running JUnit tests. +# If you need to troubleshoot a properties related problem, turning this on may help, +# but we leave it off for running JUnit tests. (It will be 'true' in the one delivered +# as part of production ESAPI, mostly for backward compatibility.) +ESAPI.printProperties=false + +# ESAPI is designed to be easily extensible. You can use the reference implementation +# or implement your own providers to take advantage of your enterprise's security +# infrastructure. The functions in ESAPI are referenced using the ESAPI locator, like: +# +# String ciphertext = +# ESAPI.encryptor().encrypt("Secret message"); // Deprecated in 2.0 +# CipherText cipherText = +# ESAPI.encryptor().encrypt(new PlainText("Secret message")); // Preferred +# +# Below you can specify the classname for the provider that you wish to use in your +# application. The only requirement is that it implement the appropriate ESAPI interface. +# This allows you to switch security implementations in the future without rewriting the +# entire application. +# +# ExperimentalAccessController requires ESAPI-AccessControlPolicy.xml in .esapi directory +ESAPI.AccessControl=org.owasp.esapi.reference.DefaultAccessController +# FileBasedAuthenticator requires users.txt file in .esapi directory +ESAPI.Authenticator=org.owasp.esapi.reference.FileBasedAuthenticator +ESAPI.Encoder=org.owasp.esapi.reference.DefaultEncoder +ESAPI.Encryptor=org.owasp.esapi.reference.crypto.JavaEncryptor + +ESAPI.Executor=org.owasp.esapi.reference.DefaultExecutor +ESAPI.HTTPUtilities=org.owasp.esapi.reference.DefaultHTTPUtilities +ESAPI.IntrusionDetector=org.owasp.esapi.reference.DefaultIntrusionDetector +# Log4JFactory Requires log4j.xml or log4j.properties in classpath - http://www.laliluna.de/log4j-tutorial.html +ESAPI.Logger=org.owasp.esapi.reference.Log4JLogFactory +#ESAPI.Logger=org.owasp.esapi.reference.JavaLogFactory +#ESAPI.Logger=org.owasp.esapi.reference.ExampleExtendedLog4JLogFactory +ESAPI.Randomizer=org.owasp.esapi.reference.DefaultRandomizer +ESAPI.Validator=org.owasp.esapi.reference.DefaultValidator + +#=========================================================================== +# ESAPI Authenticator +# +Authenticator.AllowedLoginAttempts=3 +Authenticator.MaxOldPasswordHashes=13 +Authenticator.UsernameParameterName=username +Authenticator.PasswordParameterName=password +# RememberTokenDuration (in days) +Authenticator.RememberTokenDuration=14 +# Session Timeouts (in minutes) +Authenticator.IdleTimeoutDuration=20 +Authenticator.AbsoluteTimeoutDuration=120 + +#=========================================================================== +# ESAPI Encoder +# +# ESAPI canonicalizes input before validation to prevent bypassing filters with encoded attacks. +# Failure to canonicalize input is a very common mistake when implementing validation schemes. +# Canonicalization is automatic when using the ESAPI Validator, but you can also use the +# following code to canonicalize data. +# +# ESAPI.Encoder().canonicalize( "%22hello world"" ); +# +# Multiple encoding is when a single encoding format is applied multiple times. Allowing +# multiple encoding is strongly discouraged. +Encoder.AllowMultipleEncoding=false + +# Mixed encoding is when multiple different encoding formats are applied, or when +# multiple formats are nested. Allowing multiple encoding is strongly discouraged. +Encoder.AllowMixedEncoding=false + +# The default list of codecs to apply when canonicalizing untrusted data. The list should include the codecs +# for all downstream interpreters or decoders. For example, if the data is likely to end up in a URL, HTML, or +# inside JavaScript, then the list of codecs below is appropriate. The order of the list is not terribly important. +Encoder.DefaultCodecList=HTMLEntityCodec,PercentCodec,JavaScriptCodec + + +#=========================================================================== +# ESAPI Encryption +# +# The ESAPI Encryptor provides basic cryptographic functions with a simplified API. +# To get started, generate a new key using java -classpath esapi.jar org.owasp.esapi.reference.crypto.JavaEncryptor +# There is not currently any support for key rotation, so be careful when changing your key and salt as it +# will invalidate all signed, encrypted, and hashed data. +# +# WARNING: Not all combinations of algorithms and key lengths are supported. +# If you choose to use a key length greater than 128, you MUST download the +# unlimited strength policy files and install in the lib directory of your JRE/JDK. +# See http://java.sun.com/javase/downloads/index.jsp for more information. +# +# Backward compatibility with ESAPI Java 1.4 is supported by the two deprecated API +# methods, Encryptor.encrypt(String) and Encryptor.decrypt(String). However, whenever +# possible, these methods should be avoided as they use ECB cipher mode, which in almost +# all circumstances a poor choice because of it's weakness. CBC cipher mode is the default +# for the new Encryptor encrypt / decrypt methods for ESAPI Java 2.0. In general, you +# should only use this compatibility setting if you have persistent data encrypted with +# version 1.4 and even then, you should ONLY set this compatibility mode UNTIL +# you have decrypted all of your old encrypted data and then re-encrypted it with +# ESAPI 2.0 using CBC mode. If you have some reason to mix the deprecated 1.4 mode +# with the new 2.0 methods, make sure that you use the same cipher algorithm for both +# (256-bit AES was the default for 1.4; 128-bit is the default for 2.0; see below for +# more details.) Otherwise, you will have to use the new 2.0 encrypt / decrypt methods +# where you can specify a SecretKey. (Note that if you are using the 256-bit AES, +# that requires downloading the special jurisdiction policy files mentioned above.) +# +# ***** IMPORTANT: These are for JUnit testing. Test files may have been +# encrypted using these values so do not change these or +# those tests will fail. The version under +# src/main/resources/.esapi/ESAPI.properties +# will be delivered with Encryptor.MasterKey and +# Encryptor.MasterSalt set to the empty string. +# +# FINAL NOTE: +# If Maven changes these when run, that needs to be fixed. +# 256-bit key... requires unlimited strength jurisdiction policy files +### Encryptor.MasterKey=pJhlri8JbuFYDgkqtHmm9s0Ziug2PE7ovZDyEPm4j14= +# 128-bit key +Encryptor.MasterKey=a6H9is3hEVGKB4Jut+lOVA== +Encryptor.MasterSalt=SbftnvmEWD5ZHHP+pX3fqugNysc= +# Encryptor.MasterSalt= + +# Provides the default JCE provider that ESAPI will "prefer" for its symmetric +# encryption and hashing. (That is it will look to this provider first, but it +# will defer to other providers if the requested algorithm is not implemented +# by this provider.) If left unset, ESAPI will just use your Java VM's current +# preferred JCE provider, which is generally set in the file +# "$JAVA_HOME/jre/lib/security/java.security". +# +# The main intent of this is to allow ESAPI symmetric encryption to be +# used with a FIPS 140-2 compliant crypto-module. For details, see the section +# "Using ESAPI Symmetric Encryption with FIPS 140-2 Cryptographic Modules" in +# the ESAPI 2.0 Symmetric Encryption User Guide, at: +# http://owasp-esapi-java.googlecode.com/svn/trunk/documentation/esapi4java-core-2.0-symmetric-crypto-user-guide.html +# However, this property also allows you to easily use an alternate JCE provider +# such as "Bouncy Castle" without having to make changes to "java.security". +# See Javadoc for SecurityProviderLoader for further details. If you wish to use +# a provider that is not known to SecurityProviderLoader, you may specify the +# fully-qualified class name of the JCE provider class that implements +# java.security.Provider. If the name contains a '.', this is interpreted as +# a fully-qualified class name that implements java.security.Provider. +# +# NOTE: Setting this property has the side-effect of changing it in your application +# as well, so if you are using JCE in your application directly rather than +# through ESAPI (you wouldn't do that, would you? ;-), it will change the +# preferred JCE provider there as well. +# +# Default: Keeps the JCE provider set to whatever JVM sets it to. +Encryptor.PreferredJCEProvider= + +# AES is the most widely used and strongest encryption algorithm. This +# should agree with your Encryptor.CipherTransformation property. +# By default, ESAPI Java 1.4 uses "PBEWithMD5AndDES" and which is +# very weak. It is essentially a password-based encryption key, hashed +# with MD5 around 1K times and then encrypted with the weak DES algorithm +# (56-bits) using ECB mode and an unspecified padding (it is +# JCE provider specific, but most likely "NoPadding"). However, 2.0 uses +# "AES/CBC/PKCSPadding". If you want to change these, change them here. +# Warning: This property does not control the default reference implementation for +# ESAPI 2.0 using JavaEncryptor. Also, this property will be dropped +# in the future. +# @deprecated +Encryptor.EncryptionAlgorithm=AES +# For ESAPI Java 2.0 - New encrypt / decrypt methods use this. +Encryptor.CipherTransformation=AES/CBC/PKCS5Padding + +# Applies to ESAPI 2.0 and later only! +# Comma-separated list of cipher modes that provide *BOTH* +# confidentiality *AND* message authenticity. (NIST refers to such cipher +# modes as "combined modes" so that's what we shall call them.) If any of these +# cipher modes are used then no MAC is calculated and stored +# in the CipherText upon encryption. Likewise, if one of these +# cipher modes is used with decryption, no attempt will be made +# to validate the MAC contained in the CipherText object regardless +# of whether it contains one or not. Since the expectation is that +# these cipher modes support support message authenticity already, +# injecting a MAC in the CipherText object would be at best redundant. +# +# Note that as of JDK 1.5, the SunJCE provider does not support *any* +# of these cipher modes. Of these listed, only GCM and CCM are currently +# NIST approved. YMMV for other JCE providers. E.g., Bouncy Castle supports +# GCM and CCM with "NoPadding" mode, but not with "PKCS5Padding" or other +# padding modes. +Encryptor.cipher_modes.combined_modes=GCM,CCM,IAPM,EAX,OCB,CWC + +# Applies to ESAPI 2.0 and later only! +# Additional cipher modes allowed for ESAPI 2.0 encryption. These +# cipher modes are in _addition_ to those specified by the property +# 'Encryptor.cipher_modes.combined_modes'. +# Note: We will add support for streaming modes like CFB & OFB once +# we add support for 'specified' to the property 'Encryptor.ChooseIVMethod' +# (probably in ESAPI 2.1). +# +# IMPORTANT NOTE: In the official ESAPI.properties we do *NOT* include ECB +# here as this is an extremely weak mode. However, we *must* +# allow it here so we can test ECB mode. That is important +# since the logic is somewhat different (i.e., ECB mode does +# not use an IV). +# DISCUSS: Better name? +# NOTE: ECB added only for testing purposes. Don't try this at home! +Encryptor.cipher_modes.additional_allowed=CBC,ECB + +# 128-bit is almost always sufficient and appears to be more resistant to +# related key attacks than is 256-bit AES. Use '_' to use default key size +# for cipher algorithms (where it makes sense because the algorithm supports +# a variable key size). Key length must agree to what's provided as the +# cipher transformation, otherwise this will be ignored after logging a +# warning. +# +# NOTE: This is what applies BOTH ESAPI 1.4 and 2.0. See warning above about mixing! +Encryptor.EncryptionKeyLength=128 + +# Because 2.0 uses CBC mode by default, it requires an initialization vector (IV). +# (All cipher modes except ECB require an IV.) There are two choices: we can either +# use a fixed IV known to both parties or allow ESAPI to choose a random IV. While +# the IV does not need to be hidden from adversaries, it is important that the +# adversary not be allowed to choose it. Also, random IVs are generally much more +# secure than fixed IVs. (In fact, it is essential that feed-back cipher modes +# such as CFB and OFB use a different IV for each encryption with a given key so +# in such cases, random IVs are much preferred. By default, ESAPI 2.0 uses random +# IVs. If you wish to use 'fixed' IVs, set 'Encryptor.ChooseIVMethod=fixed' and +# uncomment the Encryptor.fixedIV. +# +# Valid values: random|fixed|specified 'specified' not yet implemented; planned for 2.1 +Encryptor.ChooseIVMethod=random +# If you choose to use a fixed IV, then you must place a fixed IV here that +# is known to all others who are sharing your secret key. The format should +# be a hex string that is the same length as the cipher block size for the +# cipher algorithm that you are using. The following is an example for AES +# from an AES test vector for AES-128/CBC as described in: +# NIST Special Publication 800-38A (2001 Edition) +# "Recommendation for Block Cipher Modes of Operation". +# (Note that the block size for AES is 16 bytes == 128 bits.) +# +Encryptor.fixedIV=0x000102030405060708090a0b0c0d0e0f + +# Whether or not CipherText should use a message authentication code (MAC) with it. +# This prevents an adversary from altering the IV as well as allowing a more +# fool-proof way of determining the decryption failed because of an incorrect +# key being supplied. This refers to the "separate" MAC calculated and stored +# in CipherText, not part of any MAC that is calculated as a result of a +# "combined mode" cipher mode. +# +# If you are using ESAPI with a FIPS 140-2 cryptographic module, you *must* also +# set this property to false. +Encryptor.CipherText.useMAC=true + +# Whether or not the PlainText object may be overwritten and then marked +# eligible for garbage collection. If not set, this is still treated as 'true'. +Encryptor.PlainText.overwrite=true + +# Do not use DES except in a legacy situations. 56-bit is way too small key size. +#Encryptor.EncryptionKeyLength=56 +#Encryptor.EncryptionAlgorithm=DES + +# TripleDES is considered strong enough for most purposes. +# Note: There is also a 112-bit version of DESede. Using the 168-bit version +# requires downloading the special jurisdiction policy from Sun. +#Encryptor.EncryptionKeyLength=168 +#Encryptor.EncryptionAlgorithm=DESede + +Encryptor.HashAlgorithm=SHA-512 +Encryptor.HashIterations=1024 +Encryptor.DigitalSignatureAlgorithm=SHA1withDSA +Encryptor.DigitalSignatureKeyLength=1024 +Encryptor.RandomAlgorithm=SHA1PRNG +Encryptor.CharacterEncoding=UTF-8 +# Currently supported choices for JDK 1.5 and 1.6 are: +# HmacSHA1 (160 bits), HmacSHA256 (256 bits), HmacSHA384 (384 bits), and +# HmacSHA512 (512 bits). +# Note that HmacMD5 is *not* supported for the PRF used by the KDF even though +# these JDKs support it. +Encryptor.KDF.PRF=HmacSHA256 + +#=========================================================================== +# ESAPI HttpUtilties +# +# The HttpUtilities provide basic protections to HTTP requests and responses. Primarily these methods +# protect against malicious data from attackers, such as unprintable characters, escaped characters, +# and other simple attacks. The HttpUtilities also provides utility methods for dealing with cookies, +# headers, and CSRF tokens. +# +# Default file upload location (remember to escape backslashes with \\) +HttpUtilities.UploadDir=C:\\ESAPI\\testUpload +# let this default to java.io.tmpdir for testing +#HttpUtilities.UploadTempDir=C:\\temp +# Force flags on cookies, if you use HttpUtilities to set cookies +HttpUtilities.ForceHttpOnlySession=false +HttpUtilities.ForceSecureSession=false +HttpUtilities.ForceHttpOnlyCookies=true +HttpUtilities.ForceSecureCookies=true +# Maximum size of HTTP headers +HttpUtilities.MaxHeaderSize=4096 +# File upload configuration +HttpUtilities.ApprovedUploadExtensions=.zip,.pdf,.doc,.docx,.ppt,.pptx,.tar,.gz,.tgz,.rar,.war,.jar,.ear,.xls,.rtf,.properties,.java,.class,.txt,.xml,.jsp,.jsf,.exe,.dll +HttpUtilities.MaxUploadFileBytes=500000000 +# Using UTF-8 throughout your stack is highly recommended. That includes your database driver, +# container, and any other technologies you may be using. Failure to do this may expose you +# to Unicode transcoding injection attacks. Use of UTF-8 does not hinder internationalization. +HttpUtilities.ResponseContentType=text/html; charset=UTF-8 +# This is the name of the cookie used to represent the HTTP session +# Typically this will be the default "JSESSIONID" +HttpUtilities.HttpSessionIdName=JSESSIONID + + + +#=========================================================================== +# ESAPI Executor +# CHECKME - Not sure what this is used for, but surely it should be made OS independent. +Executor.WorkingDirectory=C:\\Windows\\Temp +Executor.ApprovedExecutables=C:\\Windows\\System32\\cmd.exe,C:\\Windows\\System32\\runas.exe + + +#=========================================================================== +# ESAPI Logging +# Set the application name if these logs are combined with other applications +Logger.ApplicationName=ExampleApplication +# If you use an HTML log viewer that does not properly HTML escape log data, you can set LogEncodingRequired to true +Logger.LogEncodingRequired=false +# Determines whether ESAPI should log the application name. This might be clutter in some single-server/single-app environments. +Logger.LogApplicationName=true +# Determines whether ESAPI should log the server IP and port. This might be clutter in some single-server environments. +Logger.LogServerIP=true +# LogFileName, the name of the logging file. Provide a full directory path (e.g., C:\\ESAPI\\ESAPI_logging_file) if you +# want to place it in a specific directory. +Logger.LogFileName=ESAPI_logging_file +# MaxLogFileSize, the max size (in bytes) of a single log file before it cuts over to a new one (default is 10,000,000) +Logger.MaxLogFileSize=10000000 + + +#=========================================================================== +# ESAPI Intrusion Detection +# +# Each event has a base to which .count, .interval, and .action are added +# The IntrusionException will fire if we receive "count" events within "interval" seconds +# The IntrusionDetector is configurable to take the following actions: log, logout, and disable +# (multiple actions separated by commas are allowed e.g. event.test.actions=log,disable +# +# Custom Events +# Names must start with "event." as the base +# Use IntrusionDetector.addEvent( "test" ) in your code to trigger "event.test" here +# You can also disable intrusion detection completely by changing +# the following parameter to true +# +IntrusionDetector.Disable=false +# +IntrusionDetector.event.test.count=2 +IntrusionDetector.event.test.interval=10 +IntrusionDetector.event.test.actions=disable,log + +# Exception Events +# All EnterpriseSecurityExceptions are registered automatically +# Call IntrusionDetector.getInstance().addException(e) for Exceptions that do not extend EnterpriseSecurityException +# Use the fully qualified classname of the exception as the base + +# any intrusion is an attack +IntrusionDetector.org.owasp.esapi.errors.IntrusionException.count=1 +IntrusionDetector.org.owasp.esapi.errors.IntrusionException.interval=1 +IntrusionDetector.org.owasp.esapi.errors.IntrusionException.actions=log,disable,logout + +# for test purposes +# CHECKME: Shouldn't there be something in the property name itself that designates +# that these are for testing??? +IntrusionDetector.org.owasp.esapi.errors.IntegrityException.count=10 +IntrusionDetector.org.owasp.esapi.errors.IntegrityException.interval=5 +IntrusionDetector.org.owasp.esapi.errors.IntegrityException.actions=log,disable,logout + +# rapid validation errors indicate scans or attacks in progress +# org.owasp.esapi.errors.ValidationException.count=10 +# org.owasp.esapi.errors.ValidationException.interval=10 +# org.owasp.esapi.errors.ValidationException.actions=log,logout + +# sessions jumping between hosts indicates session hijacking +IntrusionDetector.org.owasp.esapi.errors.AuthenticationHostException.count=2 +IntrusionDetector.org.owasp.esapi.errors.AuthenticationHostException.interval=10 +IntrusionDetector.org.owasp.esapi.errors.AuthenticationHostException.actions=log,logout + + +#=========================================================================== +# ESAPI Validation +# +# The ESAPI Validator works on regular expressions with defined names. You can define names +# either here, or you may define application specific patterns in a separate file defined below. +# This allows enterprises to specify both organizational standards as well as application specific +# validation rules. +# +Validator.ConfigurationFile.MultiValued=true +Validator.ConfigurationFile="validation-test,comma.properties",validation-test1.properties,validation-test2.properties + +# Validators used by ESAPI +Validator.AccountName=^[a-zA-Z0-9]{3,20}$ +Validator.SystemCommand=^[a-zA-Z\\-\\/]{1,64}$ +Validator.RoleName=^[a-z]{1,20}$ +Validator.Redirect=^\\/test.*$ + +# Global HTTP Validation Rules +# Values with Base64 encoded data (e.g. encrypted state) will need at least [a-zA-Z0-9\/+=] +Validator.HTTPScheme=^(http|https)$ +Validator.HTTPServerName=^[a-zA-Z0-9_.\\-]*$ +Validator.HTTPCookieName=^[a-zA-Z0-9\\-_]{1,32}$ +Validator.HTTPCookieValue=^[a-zA-Z0-9\\-\\/+=_ ]*$ +Validator.HTTPHeaderName=^[a-zA-Z0-9\\-_]{1,32}$ +Validator.HTTPHeaderValue=^[a-zA-Z0-9()\\-=\\*\\.\\?;,+\\/:&_ ]*$ +Validator.HTTPServletPath=^[a-zA-Z0-9.\\-\\/_]*$ +Validator.HTTPPath=^[a-zA-Z0-9.\\-_]*$ +Validator.HTTPURL=^.*$ +Validator.HTTPJSESSIONID=^[A-Z0-9]{10,30}$ + +# Contributed by Fraenku@gmx.ch +# Googlecode Issue 116 (http://code.google.com/p/owasp-esapi-java/issues/detail?id=116) +Validator.HTTPParameterName=^[a-zA-Z0-9_\\-]{1,32}$ +Validator.HTTPParameterValue=^[\\p{L}\\p{N}.\\-/+=_ !$*?@]{0,1000}$ +Validator.HTTPContextPath=^/[a-zA-Z0-9.\\-_]*$ +Validator.HTTPQueryString=^([a-zA-Z0-9_\\-]{1,32}=[\\p{L}\\p{N}.\\-/+=_ !$*?@%]*&?)*$ +Validator.HTTPURI=^/([a-zA-Z0-9.\\-_]*/?)*$ + + +# Validation of file related input +Validator.FileName=^[a-zA-Z0-9!@#$%^&{}\\[\\]()_+\\-=,.~'` ]{1,255}$ +Validator.DirectoryName=^[a-zA-Z0-9:/\\\\!@#$%^&{}\\[\\]()_+\\-=,.~'` ]{1,255}$ + +# Validation of dates. Controls whether or not 'lenient' dates are accepted. +# See DataFormat.setLenient(boolean flag) for further details. +Validator.AcceptLenientDates=false \ No newline at end of file diff --git a/src/test/resources/esapi/ESAPI-SingleValidatorFileChecker.properties b/src/test/resources/esapi/ESAPI-SingleValidatorFileChecker.properties new file mode 100644 index 000000000..95cdb0056 --- /dev/null +++ b/src/test/resources/esapi/ESAPI-SingleValidatorFileChecker.properties @@ -0,0 +1,466 @@ +# +# OWASP Enterprise Security API (ESAPI) Properties file -- TEST Version +# +# This file is part of the Open Web Application Security Project (OWASP) +# Enterprise Security API (ESAPI) project. For details, please see +# http://www.owasp.org/index.php/ESAPI. +# +# Copyright (c) 2008,2009 - The OWASP Foundation +# +# DISCUSS: This may cause a major backwards compatibility issue, etc. but +# from a name space perspective, we probably should have prefaced +# all the property names with ESAPI or at least OWASP. Otherwise +# there could be problems is someone loads this properties file into +# the System properties. We could also put this file into the +# esapi.jar file (perhaps as a ResourceBundle) and then allow an external +# ESAPI properties be defined that would overwrite these defaults. +# That keeps the application's properties relatively simple as usually +# they will only want to override a few properties. If looks like we +# already support multiple override levels of this in the +# DefaultSecurityConfiguration class, but I'm suggesting placing the +# defaults in the esapi.jar itself. That way, if the jar is signed, +# we could detect if those properties had been tampered with. (The +# code to check the jar signatures is pretty simple... maybe 70-90 LOC, +# but off course there is an execution penalty (similar to the way +# that the separate sunjce.jar used to be when a class from it was +# first loaded). Thoughts? +############################################################################### +# +# WARNING: Operating system protection should be used to lock down the .esapi +# resources directory and all the files inside and all the directories all the +# way up to the root directory of the file system. Note that if you are using +# file-based implementations, that some files may need to be read-write as they +# get updated dynamically. +# +# Before using, be sure to update the MasterKey and MasterSalt as described below. +# N.B.: If you had stored data that you have previously encrypted with ESAPI 1.4, +# you *must* FIRST decrypt it using ESAPI 1.4 and then (if so desired) +# re-encrypt it with ESAPI 2.0. If you fail to do this, you will NOT be +# able to decrypt your data with ESAPI 2.0. +# +# YOU HAVE BEEN WARNED!!! More details are in the ESAPI 2.0 Release Notes. +# +#=========================================================================== +# ESAPI Configuration +# +# If true, then print all the ESAPI properties set here when they are loaded. +# If false, they are not printed. Useful to reduce output when running JUnit tests. +# If you need to troubleshoot a properties related problem, turning this on may help, +# but we leave it off for running JUnit tests. (It will be 'true' in the one delivered +# as part of production ESAPI, mostly for backward compatibility.) +ESAPI.printProperties=false + +# ESAPI is designed to be easily extensible. You can use the reference implementation +# or implement your own providers to take advantage of your enterprise's security +# infrastructure. The functions in ESAPI are referenced using the ESAPI locator, like: +# +# String ciphertext = +# ESAPI.encryptor().encrypt("Secret message"); // Deprecated in 2.0 +# CipherText cipherText = +# ESAPI.encryptor().encrypt(new PlainText("Secret message")); // Preferred +# +# Below you can specify the classname for the provider that you wish to use in your +# application. The only requirement is that it implement the appropriate ESAPI interface. +# This allows you to switch security implementations in the future without rewriting the +# entire application. +# +# ExperimentalAccessController requires ESAPI-AccessControlPolicy.xml in .esapi directory +ESAPI.AccessControl=org.owasp.esapi.reference.DefaultAccessController +# FileBasedAuthenticator requires users.txt file in .esapi directory +ESAPI.Authenticator=org.owasp.esapi.reference.FileBasedAuthenticator +ESAPI.Encoder=org.owasp.esapi.reference.DefaultEncoder +ESAPI.Encryptor=org.owasp.esapi.reference.crypto.JavaEncryptor + +ESAPI.Executor=org.owasp.esapi.reference.DefaultExecutor +ESAPI.HTTPUtilities=org.owasp.esapi.reference.DefaultHTTPUtilities +ESAPI.IntrusionDetector=org.owasp.esapi.reference.DefaultIntrusionDetector +# Log4JFactory Requires log4j.xml or log4j.properties in classpath - http://www.laliluna.de/log4j-tutorial.html +ESAPI.Logger=org.owasp.esapi.reference.Log4JLogFactory +#ESAPI.Logger=org.owasp.esapi.reference.JavaLogFactory +#ESAPI.Logger=org.owasp.esapi.reference.ExampleExtendedLog4JLogFactory +ESAPI.Randomizer=org.owasp.esapi.reference.DefaultRandomizer +ESAPI.Validator=org.owasp.esapi.reference.DefaultValidator + +#=========================================================================== +# ESAPI Authenticator +# +Authenticator.AllowedLoginAttempts=3 +Authenticator.MaxOldPasswordHashes=13 +Authenticator.UsernameParameterName=username +Authenticator.PasswordParameterName=password +# RememberTokenDuration (in days) +Authenticator.RememberTokenDuration=14 +# Session Timeouts (in minutes) +Authenticator.IdleTimeoutDuration=20 +Authenticator.AbsoluteTimeoutDuration=120 + +#=========================================================================== +# ESAPI Encoder +# +# ESAPI canonicalizes input before validation to prevent bypassing filters with encoded attacks. +# Failure to canonicalize input is a very common mistake when implementing validation schemes. +# Canonicalization is automatic when using the ESAPI Validator, but you can also use the +# following code to canonicalize data. +# +# ESAPI.Encoder().canonicalize( "%22hello world"" ); +# +# Multiple encoding is when a single encoding format is applied multiple times. Allowing +# multiple encoding is strongly discouraged. +Encoder.AllowMultipleEncoding=false + +# Mixed encoding is when multiple different encoding formats are applied, or when +# multiple formats are nested. Allowing multiple encoding is strongly discouraged. +Encoder.AllowMixedEncoding=false + +# The default list of codecs to apply when canonicalizing untrusted data. The list should include the codecs +# for all downstream interpreters or decoders. For example, if the data is likely to end up in a URL, HTML, or +# inside JavaScript, then the list of codecs below is appropriate. The order of the list is not terribly important. +Encoder.DefaultCodecList=HTMLEntityCodec,PercentCodec,JavaScriptCodec + + +#=========================================================================== +# ESAPI Encryption +# +# The ESAPI Encryptor provides basic cryptographic functions with a simplified API. +# To get started, generate a new key using java -classpath esapi.jar org.owasp.esapi.reference.crypto.JavaEncryptor +# There is not currently any support for key rotation, so be careful when changing your key and salt as it +# will invalidate all signed, encrypted, and hashed data. +# +# WARNING: Not all combinations of algorithms and key lengths are supported. +# If you choose to use a key length greater than 128, you MUST download the +# unlimited strength policy files and install in the lib directory of your JRE/JDK. +# See http://java.sun.com/javase/downloads/index.jsp for more information. +# +# Backward compatibility with ESAPI Java 1.4 is supported by the two deprecated API +# methods, Encryptor.encrypt(String) and Encryptor.decrypt(String). However, whenever +# possible, these methods should be avoided as they use ECB cipher mode, which in almost +# all circumstances a poor choice because of it's weakness. CBC cipher mode is the default +# for the new Encryptor encrypt / decrypt methods for ESAPI Java 2.0. In general, you +# should only use this compatibility setting if you have persistent data encrypted with +# version 1.4 and even then, you should ONLY set this compatibility mode UNTIL +# you have decrypted all of your old encrypted data and then re-encrypted it with +# ESAPI 2.0 using CBC mode. If you have some reason to mix the deprecated 1.4 mode +# with the new 2.0 methods, make sure that you use the same cipher algorithm for both +# (256-bit AES was the default for 1.4; 128-bit is the default for 2.0; see below for +# more details.) Otherwise, you will have to use the new 2.0 encrypt / decrypt methods +# where you can specify a SecretKey. (Note that if you are using the 256-bit AES, +# that requires downloading the special jurisdiction policy files mentioned above.) +# +# ***** IMPORTANT: These are for JUnit testing. Test files may have been +# encrypted using these values so do not change these or +# those tests will fail. The version under +# src/main/resources/.esapi/ESAPI.properties +# will be delivered with Encryptor.MasterKey and +# Encryptor.MasterSalt set to the empty string. +# +# FINAL NOTE: +# If Maven changes these when run, that needs to be fixed. +# 256-bit key... requires unlimited strength jurisdiction policy files +### Encryptor.MasterKey=pJhlri8JbuFYDgkqtHmm9s0Ziug2PE7ovZDyEPm4j14= +# 128-bit key +Encryptor.MasterKey=a6H9is3hEVGKB4Jut+lOVA== +Encryptor.MasterSalt=SbftnvmEWD5ZHHP+pX3fqugNysc= +# Encryptor.MasterSalt= + +# Provides the default JCE provider that ESAPI will "prefer" for its symmetric +# encryption and hashing. (That is it will look to this provider first, but it +# will defer to other providers if the requested algorithm is not implemented +# by this provider.) If left unset, ESAPI will just use your Java VM's current +# preferred JCE provider, which is generally set in the file +# "$JAVA_HOME/jre/lib/security/java.security". +# +# The main intent of this is to allow ESAPI symmetric encryption to be +# used with a FIPS 140-2 compliant crypto-module. For details, see the section +# "Using ESAPI Symmetric Encryption with FIPS 140-2 Cryptographic Modules" in +# the ESAPI 2.0 Symmetric Encryption User Guide, at: +# http://owasp-esapi-java.googlecode.com/svn/trunk/documentation/esapi4java-core-2.0-symmetric-crypto-user-guide.html +# However, this property also allows you to easily use an alternate JCE provider +# such as "Bouncy Castle" without having to make changes to "java.security". +# See Javadoc for SecurityProviderLoader for further details. If you wish to use +# a provider that is not known to SecurityProviderLoader, you may specify the +# fully-qualified class name of the JCE provider class that implements +# java.security.Provider. If the name contains a '.', this is interpreted as +# a fully-qualified class name that implements java.security.Provider. +# +# NOTE: Setting this property has the side-effect of changing it in your application +# as well, so if you are using JCE in your application directly rather than +# through ESAPI (you wouldn't do that, would you? ;-), it will change the +# preferred JCE provider there as well. +# +# Default: Keeps the JCE provider set to whatever JVM sets it to. +Encryptor.PreferredJCEProvider= + +# AES is the most widely used and strongest encryption algorithm. This +# should agree with your Encryptor.CipherTransformation property. +# By default, ESAPI Java 1.4 uses "PBEWithMD5AndDES" and which is +# very weak. It is essentially a password-based encryption key, hashed +# with MD5 around 1K times and then encrypted with the weak DES algorithm +# (56-bits) using ECB mode and an unspecified padding (it is +# JCE provider specific, but most likely "NoPadding"). However, 2.0 uses +# "AES/CBC/PKCSPadding". If you want to change these, change them here. +# Warning: This property does not control the default reference implementation for +# ESAPI 2.0 using JavaEncryptor. Also, this property will be dropped +# in the future. +# @deprecated +Encryptor.EncryptionAlgorithm=AES +# For ESAPI Java 2.0 - New encrypt / decrypt methods use this. +Encryptor.CipherTransformation=AES/CBC/PKCS5Padding + +# Applies to ESAPI 2.0 and later only! +# Comma-separated list of cipher modes that provide *BOTH* +# confidentiality *AND* message authenticity. (NIST refers to such cipher +# modes as "combined modes" so that's what we shall call them.) If any of these +# cipher modes are used then no MAC is calculated and stored +# in the CipherText upon encryption. Likewise, if one of these +# cipher modes is used with decryption, no attempt will be made +# to validate the MAC contained in the CipherText object regardless +# of whether it contains one or not. Since the expectation is that +# these cipher modes support support message authenticity already, +# injecting a MAC in the CipherText object would be at best redundant. +# +# Note that as of JDK 1.5, the SunJCE provider does not support *any* +# of these cipher modes. Of these listed, only GCM and CCM are currently +# NIST approved. YMMV for other JCE providers. E.g., Bouncy Castle supports +# GCM and CCM with "NoPadding" mode, but not with "PKCS5Padding" or other +# padding modes. +Encryptor.cipher_modes.combined_modes=GCM,CCM,IAPM,EAX,OCB,CWC + +# Applies to ESAPI 2.0 and later only! +# Additional cipher modes allowed for ESAPI 2.0 encryption. These +# cipher modes are in _addition_ to those specified by the property +# 'Encryptor.cipher_modes.combined_modes'. +# Note: We will add support for streaming modes like CFB & OFB once +# we add support for 'specified' to the property 'Encryptor.ChooseIVMethod' +# (probably in ESAPI 2.1). +# +# IMPORTANT NOTE: In the official ESAPI.properties we do *NOT* include ECB +# here as this is an extremely weak mode. However, we *must* +# allow it here so we can test ECB mode. That is important +# since the logic is somewhat different (i.e., ECB mode does +# not use an IV). +# DISCUSS: Better name? +# NOTE: ECB added only for testing purposes. Don't try this at home! +Encryptor.cipher_modes.additional_allowed=CBC,ECB + +# 128-bit is almost always sufficient and appears to be more resistant to +# related key attacks than is 256-bit AES. Use '_' to use default key size +# for cipher algorithms (where it makes sense because the algorithm supports +# a variable key size). Key length must agree to what's provided as the +# cipher transformation, otherwise this will be ignored after logging a +# warning. +# +# NOTE: This is what applies BOTH ESAPI 1.4 and 2.0. See warning above about mixing! +Encryptor.EncryptionKeyLength=128 + +# Because 2.0 uses CBC mode by default, it requires an initialization vector (IV). +# (All cipher modes except ECB require an IV.) There are two choices: we can either +# use a fixed IV known to both parties or allow ESAPI to choose a random IV. While +# the IV does not need to be hidden from adversaries, it is important that the +# adversary not be allowed to choose it. Also, random IVs are generally much more +# secure than fixed IVs. (In fact, it is essential that feed-back cipher modes +# such as CFB and OFB use a different IV for each encryption with a given key so +# in such cases, random IVs are much preferred. By default, ESAPI 2.0 uses random +# IVs. If you wish to use 'fixed' IVs, set 'Encryptor.ChooseIVMethod=fixed' and +# uncomment the Encryptor.fixedIV. +# +# Valid values: random|fixed|specified 'specified' not yet implemented; planned for 2.1 +Encryptor.ChooseIVMethod=random +# If you choose to use a fixed IV, then you must place a fixed IV here that +# is known to all others who are sharing your secret key. The format should +# be a hex string that is the same length as the cipher block size for the +# cipher algorithm that you are using. The following is an example for AES +# from an AES test vector for AES-128/CBC as described in: +# NIST Special Publication 800-38A (2001 Edition) +# "Recommendation for Block Cipher Modes of Operation". +# (Note that the block size for AES is 16 bytes == 128 bits.) +# +Encryptor.fixedIV=0x000102030405060708090a0b0c0d0e0f + +# Whether or not CipherText should use a message authentication code (MAC) with it. +# This prevents an adversary from altering the IV as well as allowing a more +# fool-proof way of determining the decryption failed because of an incorrect +# key being supplied. This refers to the "separate" MAC calculated and stored +# in CipherText, not part of any MAC that is calculated as a result of a +# "combined mode" cipher mode. +# +# If you are using ESAPI with a FIPS 140-2 cryptographic module, you *must* also +# set this property to false. +Encryptor.CipherText.useMAC=true + +# Whether or not the PlainText object may be overwritten and then marked +# eligible for garbage collection. If not set, this is still treated as 'true'. +Encryptor.PlainText.overwrite=true + +# Do not use DES except in a legacy situations. 56-bit is way too small key size. +#Encryptor.EncryptionKeyLength=56 +#Encryptor.EncryptionAlgorithm=DES + +# TripleDES is considered strong enough for most purposes. +# Note: There is also a 112-bit version of DESede. Using the 168-bit version +# requires downloading the special jurisdiction policy from Sun. +#Encryptor.EncryptionKeyLength=168 +#Encryptor.EncryptionAlgorithm=DESede + +Encryptor.HashAlgorithm=SHA-512 +Encryptor.HashIterations=1024 +Encryptor.DigitalSignatureAlgorithm=SHA1withDSA +Encryptor.DigitalSignatureKeyLength=1024 +Encryptor.RandomAlgorithm=SHA1PRNG +Encryptor.CharacterEncoding=UTF-8 +# Currently supported choices for JDK 1.5 and 1.6 are: +# HmacSHA1 (160 bits), HmacSHA256 (256 bits), HmacSHA384 (384 bits), and +# HmacSHA512 (512 bits). +# Note that HmacMD5 is *not* supported for the PRF used by the KDF even though +# these JDKs support it. +Encryptor.KDF.PRF=HmacSHA256 + +#=========================================================================== +# ESAPI HttpUtilties +# +# The HttpUtilities provide basic protections to HTTP requests and responses. Primarily these methods +# protect against malicious data from attackers, such as unprintable characters, escaped characters, +# and other simple attacks. The HttpUtilities also provides utility methods for dealing with cookies, +# headers, and CSRF tokens. +# +# Default file upload location (remember to escape backslashes with \\) +HttpUtilities.UploadDir=C:\\ESAPI\\testUpload +# let this default to java.io.tmpdir for testing +#HttpUtilities.UploadTempDir=C:\\temp +# Force flags on cookies, if you use HttpUtilities to set cookies +HttpUtilities.ForceHttpOnlySession=false +HttpUtilities.ForceSecureSession=false +HttpUtilities.ForceHttpOnlyCookies=true +HttpUtilities.ForceSecureCookies=true +# Maximum size of HTTP headers +HttpUtilities.MaxHeaderSize=4096 +# File upload configuration +HttpUtilities.ApprovedUploadExtensions=.zip,.pdf,.doc,.docx,.ppt,.pptx,.tar,.gz,.tgz,.rar,.war,.jar,.ear,.xls,.rtf,.properties,.java,.class,.txt,.xml,.jsp,.jsf,.exe,.dll +HttpUtilities.MaxUploadFileBytes=500000000 +# Using UTF-8 throughout your stack is highly recommended. That includes your database driver, +# container, and any other technologies you may be using. Failure to do this may expose you +# to Unicode transcoding injection attacks. Use of UTF-8 does not hinder internationalization. +HttpUtilities.ResponseContentType=text/html; charset=UTF-8 +# This is the name of the cookie used to represent the HTTP session +# Typically this will be the default "JSESSIONID" +HttpUtilities.HttpSessionIdName=JSESSIONID + + + +#=========================================================================== +# ESAPI Executor +# CHECKME - Not sure what this is used for, but surely it should be made OS independent. +Executor.WorkingDirectory=C:\\Windows\\Temp +Executor.ApprovedExecutables=C:\\Windows\\System32\\cmd.exe,C:\\Windows\\System32\\runas.exe + + +#=========================================================================== +# ESAPI Logging +# Set the application name if these logs are combined with other applications +Logger.ApplicationName=ExampleApplication +# If you use an HTML log viewer that does not properly HTML escape log data, you can set LogEncodingRequired to true +Logger.LogEncodingRequired=false +# Determines whether ESAPI should log the application name. This might be clutter in some single-server/single-app environments. +Logger.LogApplicationName=true +# Determines whether ESAPI should log the server IP and port. This might be clutter in some single-server environments. +Logger.LogServerIP=true +# LogFileName, the name of the logging file. Provide a full directory path (e.g., C:\\ESAPI\\ESAPI_logging_file) if you +# want to place it in a specific directory. +Logger.LogFileName=ESAPI_logging_file +# MaxLogFileSize, the max size (in bytes) of a single log file before it cuts over to a new one (default is 10,000,000) +Logger.MaxLogFileSize=10000000 + + +#=========================================================================== +# ESAPI Intrusion Detection +# +# Each event has a base to which .count, .interval, and .action are added +# The IntrusionException will fire if we receive "count" events within "interval" seconds +# The IntrusionDetector is configurable to take the following actions: log, logout, and disable +# (multiple actions separated by commas are allowed e.g. event.test.actions=log,disable +# +# Custom Events +# Names must start with "event." as the base +# Use IntrusionDetector.addEvent( "test" ) in your code to trigger "event.test" here +# You can also disable intrusion detection completely by changing +# the following parameter to true +# +IntrusionDetector.Disable=false +# +IntrusionDetector.event.test.count=2 +IntrusionDetector.event.test.interval=10 +IntrusionDetector.event.test.actions=disable,log + +# Exception Events +# All EnterpriseSecurityExceptions are registered automatically +# Call IntrusionDetector.getInstance().addException(e) for Exceptions that do not extend EnterpriseSecurityException +# Use the fully qualified classname of the exception as the base + +# any intrusion is an attack +IntrusionDetector.org.owasp.esapi.errors.IntrusionException.count=1 +IntrusionDetector.org.owasp.esapi.errors.IntrusionException.interval=1 +IntrusionDetector.org.owasp.esapi.errors.IntrusionException.actions=log,disable,logout + +# for test purposes +# CHECKME: Shouldn't there be something in the property name itself that designates +# that these are for testing??? +IntrusionDetector.org.owasp.esapi.errors.IntegrityException.count=10 +IntrusionDetector.org.owasp.esapi.errors.IntegrityException.interval=5 +IntrusionDetector.org.owasp.esapi.errors.IntegrityException.actions=log,disable,logout + +# rapid validation errors indicate scans or attacks in progress +# org.owasp.esapi.errors.ValidationException.count=10 +# org.owasp.esapi.errors.ValidationException.interval=10 +# org.owasp.esapi.errors.ValidationException.actions=log,logout + +# sessions jumping between hosts indicates session hijacking +IntrusionDetector.org.owasp.esapi.errors.AuthenticationHostException.count=2 +IntrusionDetector.org.owasp.esapi.errors.AuthenticationHostException.interval=10 +IntrusionDetector.org.owasp.esapi.errors.AuthenticationHostException.actions=log,logout + + +#=========================================================================== +# ESAPI Validation +# +# The ESAPI Validator works on regular expressions with defined names. You can define names +# either here, or you may define application specific patterns in a separate file defined below. +# This allows enterprises to specify both organizational standards as well as application specific +# validation rules. +# +#Validator.ConfigurationFile.MultiValued=false +Validator.ConfigurationFile=validation-test1.properties + +# Validators used by ESAPI +Validator.AccountName=^[a-zA-Z0-9]{3,20}$ +Validator.SystemCommand=^[a-zA-Z\\-\\/]{1,64}$ +Validator.RoleName=^[a-z]{1,20}$ +Validator.Redirect=^\\/test.*$ + +# Global HTTP Validation Rules +# Values with Base64 encoded data (e.g. encrypted state) will need at least [a-zA-Z0-9\/+=] +Validator.HTTPScheme=^(http|https)$ +Validator.HTTPServerName=^[a-zA-Z0-9_.\\-]*$ +Validator.HTTPCookieName=^[a-zA-Z0-9\\-_]{1,32}$ +Validator.HTTPCookieValue=^[a-zA-Z0-9\\-\\/+=_ ]*$ +Validator.HTTPHeaderName=^[a-zA-Z0-9\\-_]{1,32}$ +Validator.HTTPHeaderValue=^[a-zA-Z0-9()\\-=\\*\\.\\?;,+\\/:&_ ]*$ +Validator.HTTPServletPath=^[a-zA-Z0-9.\\-\\/_]*$ +Validator.HTTPPath=^[a-zA-Z0-9.\\-_]*$ +Validator.HTTPURL=^.*$ +Validator.HTTPJSESSIONID=^[A-Z0-9]{10,30}$ + +# Contributed by Fraenku@gmx.ch +# Googlecode Issue 116 (http://code.google.com/p/owasp-esapi-java/issues/detail?id=116) +Validator.HTTPParameterName=^[a-zA-Z0-9_\\-]{1,32}$ +Validator.HTTPParameterValue=^[\\p{L}\\p{N}.\\-/+=_ !$*?@]{0,1000}$ +Validator.HTTPContextPath=^/[a-zA-Z0-9.\\-_]*$ +Validator.HTTPQueryString=^([a-zA-Z0-9_\\-]{1,32}=[\\p{L}\\p{N}.\\-/+=_ !$*?@%]*&?)*$ +Validator.HTTPURI=^/([a-zA-Z0-9.\\-_]*/?)*$ + + +# Validation of file related input +Validator.FileName=^[a-zA-Z0-9!@#$%^&{}\\[\\]()_+\\-=,.~'` ]{1,255}$ +Validator.DirectoryName=^[a-zA-Z0-9:/\\\\!@#$%^&{}\\[\\]()_+\\-=,.~'` ]{1,255}$ + +# Validation of dates. Controls whether or not 'lenient' dates are accepted. +# See DataFormat.setLenient(boolean flag) for further details. +Validator.AcceptLenientDates=false \ No newline at end of file diff --git a/src/test/resources/esapi/validation-test,comma.properties b/src/test/resources/esapi/validation-test,comma.properties new file mode 100644 index 000000000..99956e509 --- /dev/null +++ b/src/test/resources/esapi/validation-test,comma.properties @@ -0,0 +1 @@ +Validator.TestC=ValueFromCommaFile \ No newline at end of file diff --git a/src/test/resources/esapi/validation-test1.properties b/src/test/resources/esapi/validation-test1.properties new file mode 100644 index 000000000..ad678536d --- /dev/null +++ b/src/test/resources/esapi/validation-test1.properties @@ -0,0 +1 @@ +Validator.Test1=ValueFromFile1 \ No newline at end of file diff --git a/src/test/resources/esapi/validation-test2.properties b/src/test/resources/esapi/validation-test2.properties new file mode 100644 index 000000000..08146e85d --- /dev/null +++ b/src/test/resources/esapi/validation-test2.properties @@ -0,0 +1 @@ +Validator.Test2=ValueFromFile2 \ No newline at end of file From 423ebdaa0f20c8054523b0450373793875443dc8 Mon Sep 17 00:00:00 2001 From: "erluko@gmail.com" Date: Tue, 19 Nov 2013 20:50:32 +0000 Subject: [PATCH 031/812] Fixed javadoc for change in r1917 --- .../esapi/reference/DefaultSecurityConfiguration.java | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/src/main/java/org/owasp/esapi/reference/DefaultSecurityConfiguration.java b/src/main/java/org/owasp/esapi/reference/DefaultSecurityConfiguration.java index 995ad7007..fd95f04a6 100644 --- a/src/main/java/org/owasp/esapi/reference/DefaultSecurityConfiguration.java +++ b/src/main/java/org/owasp/esapi/reference/DefaultSecurityConfiguration.java @@ -223,9 +223,11 @@ public static SecurityConfiguration getInstance() { // private static long lastModified = -1; /** - * Instantiates a new configuration. + * Instantiates a new configuration, using the provided property file name + * + * @param resourceFile The name of the property file to load */ - protected DefaultSecurityConfiguration(String resourceFile) { + DefaultSecurityConfiguration(String resourceFile) { this.resourceFile = resourceFile; // load security configuration try { @@ -252,7 +254,7 @@ public DefaultSecurityConfiguration(Properties properties) { } /** - * + * Instantiates a new configuration. */ public DefaultSecurityConfiguration(){ this(DEFAULT_RESOURCE_FILE); From 3d284ec8930f0f13a939a23a97a2ab0c0bcdaa5d Mon Sep 17 00:00:00 2001 From: "kevin.w.wall@gmail.com" Date: Thu, 21 Nov 2013 17:20:14 +0000 Subject: [PATCH 032/812] Fix for Google Issue # 307. --- configuration/esapi/ESAPI.properties | 13 ++++++++++--- 1 file changed, 10 insertions(+), 3 deletions(-) diff --git a/configuration/esapi/ESAPI.properties b/configuration/esapi/ESAPI.properties index 49e63c608..35c9d0870 100644 --- a/configuration/esapi/ESAPI.properties +++ b/configuration/esapi/ESAPI.properties @@ -336,9 +336,16 @@ HttpUtilities.HttpSessionIdName=JSESSIONID #=========================================================================== # ESAPI Executor -# CHECKME - Not sure what this is used for, but surely it should be made OS independent. -Executor.WorkingDirectory=C:\\Windows\\Temp -Executor.ApprovedExecutables=C:\\Windows\\System32\\cmd.exe,C:\\Windows\\System32\\runas.exe +# CHECKME - This should be made OS independent. Don't use unsafe defaults. +# # Examples only -- do NOT blindly copy! +# For Windows: +# Executor.WorkingDirectory=C:\\Windows\\Temp +# Executor.ApprovedExecutables=C:\\Windows\\System32\\cmd.exe,C:\\Windows\\System32\\runas.exe +# For *nux, MacOS: +# Executor.WorkingDirectory=/tmp +# Executor.ApprovedExecutables=/bin/bash +Executor.WorkingDirectory= +Executor.ApprovedExecutables= #=========================================================================== From 4f5b1e364a67293d4eeeb668facd9ba4cc741023 Mon Sep 17 00:00:00 2001 From: "kevin.w.wall@gmail.com" Date: Fri, 2 May 2014 04:22:39 +0000 Subject: [PATCH 033/812] Fix for Google Issue 327. Thanks to Matt Seil for the fix. --- src/main/java/org/owasp/esapi/reference/Log4JLogger.java | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/src/main/java/org/owasp/esapi/reference/Log4JLogger.java b/src/main/java/org/owasp/esapi/reference/Log4JLogger.java index 3b4aa950a..7782f89c7 100644 --- a/src/main/java/org/owasp/esapi/reference/Log4JLogger.java +++ b/src/main/java/org/owasp/esapi/reference/Log4JLogger.java @@ -107,7 +107,8 @@ public void setLevel(int level) { * Hence we renamed it to {@code getESAPILevel()}. */ public int getESAPILevel() { - return super.getLevel().toInt(); + Level level = super.getLevel(); + return (level == null ) ? Level.OFF_INT : level.toInt(); } /** From 3ca93c5c1ee7ecc342b34d9eebf118701f9b9306 Mon Sep 17 00:00:00 2001 From: "planetlevel@gmail.com" Date: Sat, 28 Jun 2014 02:03:28 +0000 Subject: [PATCH 034/812] Fix issue 323 - ESAPI Random Number Generation and CSRF Protection Broken Problem was introduced in r722 - https://code.google.com/p/owasp-esapi-java/source/diff?spec=svn1942&r=722&format=side&path=/trunk/src/main/java/org/owasp/esapi/StringUtilities.java&old_path=/trunk/src/main/java/org/owasp/esapi/StringUtilities.java&old=561 --- .../java/org/owasp/esapi/StringUtilities.java | 12 +++--- .../org/owasp/esapi/StringUtilitiesTest.java | 17 ++++++++ .../owasp/esapi/reference/RandomizerTest.java | 41 +++++++++++++++++-- 3 files changed, 60 insertions(+), 10 deletions(-) diff --git a/src/main/java/org/owasp/esapi/StringUtilities.java b/src/main/java/org/owasp/esapi/StringUtilities.java index e41dd03e8..9d79a3ec4 100644 --- a/src/main/java/org/owasp/esapi/StringUtilities.java +++ b/src/main/java/org/owasp/esapi/StringUtilities.java @@ -61,12 +61,12 @@ public static String stripControls( String input ) { public static char[] union(char[]... list) { StringBuilder sb = new StringBuilder(); - for (char[] characters : list) { - for (int i = 0; i < list.length; i++) { - if (!contains(sb, characters[i])) - sb.append(list[i]); - } - } + for (char[] characters : list) { + for ( char c : characters ) { + if ( !contains( sb, c ) ) + sb.append( c ); + } + } char[] toReturn = new char[sb.length()]; sb.getChars(0, sb.length(), toReturn, 0); diff --git a/src/test/java/org/owasp/esapi/StringUtilitiesTest.java b/src/test/java/org/owasp/esapi/StringUtilitiesTest.java index de82b65f8..967b63263 100644 --- a/src/test/java/org/owasp/esapi/StringUtilitiesTest.java +++ b/src/test/java/org/owasp/esapi/StringUtilitiesTest.java @@ -1,5 +1,7 @@ package org.owasp.esapi; +import java.util.Arrays; + import junit.framework.Test; import junit.framework.TestCase; import junit.framework.TestSuite; @@ -42,7 +44,22 @@ public void testGetLevenshteinDistance() { assertTrue( ex.getClass().getName().equals( IllegalArgumentException.class.getName() )); } } + + /** Test the union() method. */ + public void testUnion() { + char[] a1 = { 'a', 'b', 'c' }; + char[] a2 = { 'c', 'd', 'e' }; + char[] union = StringUtilities.union(a1, a2); + assertTrue( Arrays.equals( union, new char[] {'a','b','c','d','e' } ) ); + } + /** Test the contains() method. */ + public void contains() { + StringBuilder sb = new StringBuilder( "abc" ); + assertTrue( StringUtilities.contains(sb, 'b') ); + assertFalse( StringUtilities.contains(sb, 'x') ); + } + /** Test the notNullOrEmpty() method. */ public void testNotNullOrEmpty() { String str = "A string"; diff --git a/src/test/java/org/owasp/esapi/reference/RandomizerTest.java b/src/test/java/org/owasp/esapi/reference/RandomizerTest.java index 2fc27f9de..605dfb3e8 100644 --- a/src/test/java/org/owasp/esapi/reference/RandomizerTest.java +++ b/src/test/java/org/owasp/esapi/reference/RandomizerTest.java @@ -15,6 +15,8 @@ */ package org.owasp.esapi.reference; +import java.io.FileWriter; +import java.io.IOException; import java.util.ArrayList; import junit.framework.Test; @@ -76,16 +78,28 @@ public static Test suite() { public void testGetRandomString() { System.out.println("getRandomString"); int length = 20; + int trials = 1000; Randomizer instance = ESAPI.randomizer(); - for ( int i = 0; i < 100; i++ ) { + int[] counts = new int[128]; + for ( int i = 0; i < 1000; i++ ) { String result = instance.getRandomString(length, EncoderConstants.CHAR_ALPHANUMERICS ); for ( int j=0;j max ) { max = counts[i]; } + if ( counts[i] > 0 && counts[i] < min ) { min = counts[i]; } + if ( max - min > trials/10 ) { + fail( "getRandomString randomness counts are off" ); + } + } } /** @@ -140,5 +154,24 @@ public void testGetRandomGUID() throws EncryptionException { } } + + /** + * Run this class to generate a file named "tokens.txt" with 20,000 random 20 character ALPHANUMERIC tokens. + * Use Burp Pro sequencer to load this file and run a series of randomness tests. + * + * NOTE: be careful not to include any CRLF characters (10 or 13 ASCII) because they'll create new tokens + * Check to be sure your analysis tool loads exactly 20,000 tokens of 20 characters each. + */ + + public static void main(String[] args) throws IOException { + FileWriter fw = new FileWriter("tokens.txt"); + for (int i = 0; i < 20000; i++) { + String token = ESAPI.randomizer().getRandomString(20, EncoderConstants.CHAR_ALPHANUMERICS); + fw.write(token + "\n"); + } + fw.close(); + } + + } From aea19ecfcfcc63af459adaf358cfc23fcba9cbbe Mon Sep 17 00:00:00 2001 From: "chris.schmidt@owasp.org" Date: Tue, 1 Jul 2014 04:35:29 +0000 Subject: [PATCH 035/812] pom.xml 1) Updated dependencies 2) Added OWASP Dependency Check plugin 3) Added Surefire Report Plugin 4) Updated all plugins to latest version 5) Updated req'd minimum Java Version to 1.6 MockServletContext.java 1) Added getContextPath() method to account for new servlet spec method. --- pom.xml | 116 +++++++++--------- .../owasp/esapi/http/MockServletContext.java | 5 + 2 files changed, 61 insertions(+), 60 deletions(-) diff --git a/pom.xml b/pom.xml index 5e0fdd4bb..89c9b250d 100644 --- a/pom.xml +++ b/pom.xml @@ -81,28 +81,14 @@ Jeff Williams Aspect Security - Project Owner - Architect - Developer - - - - Jim Manico - - Project Manager - BuildMaster - Developer - Architect + Project Inventor Chris Schmidt Aspect Security - Project Manager - Continuous Integration Admin - Architect - Developer + Project Owner @@ -110,9 +96,6 @@ Wells Fargo Project Manager - Architect - Developer - Crypto Guy @@ -121,11 +104,9 @@ Dave Wichers Aspect Security - - Documentation and Examples - Minor Code Contributions - Project Guidance - + + + Jim Manico @@ -137,23 +118,23 @@ commons-configuration commons-configuration - 1.5 + 1.10 commons-beanutils commons-beanutils-core - 1.7.0 + 1.8.3 junit junit - 4.4 + 4.5 test javax.servlet servlet-api - 2.4 + 2.5 provided @@ -165,23 +146,19 @@ commons-fileupload commons-fileupload - 1.2 + 1.3.1 compile - commons-io commons-io - 1.3 + 2.4 test commons-collections commons-collections - 3.2 + 3.2.1 compile @@ -204,7 +181,7 @@ org.owasp.antisamy antisamy - 1.4.3 + 1.5.3 @@ -212,10 +189,10 @@ maven-compiler-plugin - 2.3.2 + 3.1 - 1.5 - 1.5 + 1.6 + 1.6 true true false @@ -225,7 +202,7 @@ org.apache.maven.plugins maven-eclipse-plugin - 2.8 + 2.9 true @@ -233,7 +210,7 @@ maven-jar-plugin - 2.3.1 + 2.4 @@ -245,24 +222,23 @@ - display-dependency-updates display-plugin-updates - display-property-updates + ---> + @@ -271,7 +247,7 @@ org.codehaus.mojo findbugs-maven-plugin - 2.3.1 + 2.5.3 true true @@ -284,7 +260,7 @@ org.codehaus.mojo cobertura-maven-plugin - 2.4 + 2.6 html @@ -295,11 +271,11 @@ org.codehaus.mojo jdepend-maven-plugin - 2.0-beta-2 + 2.0 maven-pmd-plugin - 2.5 + 3.1 1.5 utf-8 @@ -308,7 +284,7 @@ org.apache.maven.plugins maven-javadoc-plugin - 2.7 + 2.9.1 false false @@ -328,14 +304,14 @@ http://code.google.com/p/owasp-esapi-java/issues/detail?id=%ISSUE% date - 2011-05-11 00:00:00 + 2013-09-02 00:00:00 org.codehaus.mojo versions-maven-plugin - 1.2 + 2.1 @@ -346,6 +322,19 @@ + + org.owasp + dependency-check-maven + 1.1.4 + + false + + + + org.apache.maven.plugins + maven-surefire-report-plugin + 2.17 + @@ -383,6 +372,7 @@ org.apache.maven.plugins maven-gpg-plugin + 1.5 sign-artifacts @@ -400,7 +390,8 @@ org.apache.maven.plugins maven-jar-plugin - 2.3.1 + 2.4 + + true @@ -425,11 +419,12 @@ - org.apache.maven.plugins maven-enforcer-plugin + 1.3.1 enforce-jdk-version @@ -439,10 +434,10 @@ - 1.5 + 1.6 - ESAPI 2.0 uses the JDK1.5 for it's baseline. Please make sure that your - JAVA_HOME environment variable is pointed to a JDK1.5 distribution. + ESAPI 2.1 uses the JDK1.6 for it's baseline. Please make sure that your + JAVA_HOME environment variable is pointed to a JDK1.6 distribution. @@ -455,6 +450,7 @@ org.apache.maven.plugins maven-javadoc-plugin + 2.9.1 attach-javadocs @@ -469,7 +465,7 @@ org.apache.maven.plugins maven-assembly-plugin - 2.2 + 2.4 src/main/assembly/dist.xml @@ -491,7 +487,7 @@ org.apache.maven.plugins maven-release-plugin - 2.1 + 2.5 https://owasp-esapi-java.googlecode.com/svn/tags/releases/ diff --git a/src/test/java/org/owasp/esapi/http/MockServletContext.java b/src/test/java/org/owasp/esapi/http/MockServletContext.java index 8c2c4f281..b577ab2bb 100644 --- a/src/test/java/org/owasp/esapi/http/MockServletContext.java +++ b/src/test/java/org/owasp/esapi/http/MockServletContext.java @@ -57,6 +57,11 @@ * @version $Rev: 46019 $ $Date: 2004-09-14 04:56:06 -0500 (Tue, 14 Sep 2004) $ */ public class MockServletContext implements ServletContext { + @Override + public String getContextPath() { + return "/"; + } + /** * Returns a ServletContext object that * corresponds to a specified URL on the server. From 50fdef49ea86cbdaa89db20e2231af73c84412e5 Mon Sep 17 00:00:00 2001 From: "planetlevel@gmail.com" Date: Tue, 1 Jul 2014 18:36:45 +0000 Subject: [PATCH 036/812] Grammatical error in error message --- src/main/java/org/owasp/esapi/crypto/CipherTextSerializer.java | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/main/java/org/owasp/esapi/crypto/CipherTextSerializer.java b/src/main/java/org/owasp/esapi/crypto/CipherTextSerializer.java index 2a6caebff..06a822607 100644 --- a/src/main/java/org/owasp/esapi/crypto/CipherTextSerializer.java +++ b/src/main/java/org/owasp/esapi/crypto/CipherTextSerializer.java @@ -302,7 +302,7 @@ private CipherText convertToCipherText(byte[] cipherTextSerializedBytes) debug("convertToCipherText: kdfPrf = " + kdfPrf + ", kdfVers = " + kdfVers); if ( ! versionIsCompatible( kdfVers) ) { - throw new EncryptionException("This version of ESAPI does is not compatible with the version of ESAPI that encrypted your data.", + throw new EncryptionException("This version of ESAPI is not compatible with the version of ESAPI that encrypted your data.", "KDF version " + kdfVers + " from serialized ciphertext not compatibile with current KDF version of " + KeyDerivationFunction.kdfVersion); } From 95d85be952ddb64e2a8997f6b862d6208d8ea9f2 Mon Sep 17 00:00:00 2001 From: "jim@manico.net" Date: Sat, 5 Jul 2014 07:47:33 +0000 Subject: [PATCH 037/812] Fixing JavaDoc URL's in setNoCacheHeaders to satisfy bug report https://code.google.com/p/owasp-esapi-java/issues/detail?id=22 --- src/main/java/org/owasp/esapi/HTTPUtilities.java | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/src/main/java/org/owasp/esapi/HTTPUtilities.java b/src/main/java/org/owasp/esapi/HTTPUtilities.java index f3eb169d8..77fcd8284 100644 --- a/src/main/java/org/owasp/esapi/HTTPUtilities.java +++ b/src/main/java/org/owasp/esapi/HTTPUtilities.java @@ -528,14 +528,14 @@ public interface HTTPUtilities * Note that the header "pragma: no-cache" is intended only for use in HTTP requests, not HTTP responses. However, Microsoft has chosen to * directly violate the standards, so we need to include that header here. For more information, please refer to the relevant standards: *

* * @param response From 02c95cd460af3254dc870a66f20dc82ad7064e21 Mon Sep 17 00:00:00 2001 From: karansanwal Date: Tue, 21 Oct 2014 17:14:53 +0530 Subject: [PATCH 038/812] Fix Issue # 195 : BaseValidationRule.assertValid(String context, String input) causes NPE if input is not valid. Made changes as required, also getvalid(string,string) should be called instead. Could not test the changes. Let me know if the error persists. Contact : karansanwal@gmail.com --- .../esapi/reference/validation/BaseValidationRule.java | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/src/main/java/org/owasp/esapi/reference/validation/BaseValidationRule.java b/src/main/java/org/owasp/esapi/reference/validation/BaseValidationRule.java index 1929ff02a..538c658c4 100644 --- a/src/main/java/org/owasp/esapi/reference/validation/BaseValidationRule.java +++ b/src/main/java/org/owasp/esapi/reference/validation/BaseValidationRule.java @@ -89,7 +89,7 @@ public final void setEncoder( Encoder encoder ) { * {@inheritDoc} */ public void assertValid( String context, String input ) throws ValidationException { - getValid( context, input, null ); + getValid( context, input ); } /** @@ -100,7 +100,11 @@ public Object getValid( String context, String input, ValidationErrorList errorL try { valid = getValid( context, input ); } catch (ValidationException e) { - errorList.addError(context, e); + if( errorList == null { + throw e; + } else { + errorList.addError(context, e); + } } return valid; } From 82715bf4e806fd8d5e7775c60f44cfa3e303ec69 Mon Sep 17 00:00:00 2001 From: karansanwal Date: Wed, 22 Oct 2014 19:07:29 +0530 Subject: [PATCH 039/812] Fix to Google Issue 212 to know if an uncaught exception is a security exception or usual runtime exception. --- src/main/java/org/owasp/esapi/errors/IntrusionException.java | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/main/java/org/owasp/esapi/errors/IntrusionException.java b/src/main/java/org/owasp/esapi/errors/IntrusionException.java index 4af7f4122..6332f297b 100644 --- a/src/main/java/org/owasp/esapi/errors/IntrusionException.java +++ b/src/main/java/org/owasp/esapi/errors/IntrusionException.java @@ -28,7 +28,7 @@ * * @author Jeff Williams (jeff.williams@aspectsecurity.com) */ -public class IntrusionException extends RuntimeException { +public class IntrusionException extends EnterpriseSecurityException { /** The Constant serialVersionUID. */ private static final long serialVersionUID = 1L; From c9120d595131af60cef043b5ccd75026061e0f25 Mon Sep 17 00:00:00 2001 From: Chris Schmidt Date: Thu, 23 Oct 2014 23:54:01 -0600 Subject: [PATCH 040/812] Create README.md --- README.md | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 000000000..48c8d3749 --- /dev/null +++ b/README.md @@ -0,0 +1,20 @@ +esapi-java-legacy +================= + +OWASP ESAPI (The OWASP Enterprise Security API) is a free, open source, web application security control library that makes it easier for programmers to write lower-risk applications. The ESAPI for Java library is designed to make it easier for programmers to retrofit security into existing applications. ESAPI for Java also serves as a solid foundation for new development. + +For more information, please visit our Wiki. + +You can view the latest version of our Javadocs here. + +You can see the status of what we are working on for the next release here. + +View Contributed ESAPI Components + +Realtime Support available on our IRC Channel: + +Server: irc.freenode.net + +Channel: #esapi + +Webchat http://webchat.freenode.net/ From 2364af13bf815799d376d79f96fb02a03922d0ea Mon Sep 17 00:00:00 2001 From: Chris Schmidt Date: Fri, 24 Oct 2014 00:03:10 -0600 Subject: [PATCH 041/812] Update README.md --- README.md | 7 +++---- 1 file changed, 3 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index 48c8d3749..1f63f0154 100644 --- a/README.md +++ b/README.md @@ -3,13 +3,12 @@ esapi-java-legacy OWASP ESAPI (The OWASP Enterprise Security API) is a free, open source, web application security control library that makes it easier for programmers to write lower-risk applications. The ESAPI for Java library is designed to make it easier for programmers to retrofit security into existing applications. ESAPI for Java also serves as a solid foundation for new development. -For more information, please visit our Wiki. +Wiki: https://www.owasp.org/index.php/Category:OWASP_Enterprise_Security_API -You can view the latest version of our Javadocs here. +Nightly Build: https://esapi.ci.cloudbees.com -You can see the status of what we are working on for the next release here. +JIRA: Coming Soon -View Contributed ESAPI Components Realtime Support available on our IRC Channel: From ec4d528bb0199e51f7aec854ea08b4f476ba1cc2 Mon Sep 17 00:00:00 2001 From: Chris Schmidt Date: Sun, 26 Oct 2014 10:11:09 -0600 Subject: [PATCH 042/812] Update README.md --- README.md | 26 ++++++++++++++++++-------- 1 file changed, 18 insertions(+), 8 deletions(-) diff --git a/README.md b/README.md index 1f63f0154..c016c94f1 100644 --- a/README.md +++ b/README.md @@ -1,7 +1,19 @@ -esapi-java-legacy +Enterprise Security API for Java (Legacy) ================= + + + +
+OWASP ESAPI (The OWASP Enterprise Security API) is a free, open source, web application security control library that makes it easier for programmers to write lower-risk applications. The ESAPI for Java library is designed to make it easier for programmers to retrofit security into existing applications. ESAPI for Java also serves as a solid foundation for new development.
-OWASP ESAPI (The OWASP Enterprise Security API) is a free, open source, web application security control library that makes it easier for programmers to write lower-risk applications. The ESAPI for Java library is designed to make it easier for programmers to retrofit security into existing applications. ESAPI for Java also serves as a solid foundation for new development. +What does Legacy mean?
+

This is the legacy branch of ESAPI which means it is an actively maintained branch of the project, however feature development for this branch will not be done. Features that have already been scheduled for the 2.x branch will move forward, but the main focus will be working on the ESAPI 3.x branch. + +Where can I find ESAPI 3.x
+https://github.com/ESAPI/esapi-java + +How can I contribute or fix bugs?
+Fork and submit a pull request! Simple as pi! Wiki: https://www.owasp.org/index.php/Category:OWASP_Enterprise_Security_API @@ -10,10 +22,8 @@ Nightly Build: https://esapi.ci.cloudbees.com JIRA: Coming Soon -Realtime Support available on our IRC Channel: - -Server: irc.freenode.net - -Channel: #esapi - +Realtime Support available on our IRC Channel:
+Server: irc.freenode.net
+Channel: #esapi
Webchat http://webchat.freenode.net/ + From 8ccc872f09d51f6a0ea2ad6b37fef143cbad3f51 Mon Sep 17 00:00:00 2001 From: Chris Schmidt Date: Sun, 26 Oct 2014 10:12:21 -0600 Subject: [PATCH 043/812] Update README.md --- README.md | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index c016c94f1..09d6a76c1 100644 --- a/README.md +++ b/README.md @@ -2,9 +2,11 @@ Enterprise Security API for Java (Legacy) ================= - -
-OWASP ESAPI (The OWASP Enterprise Security API) is a free, open source, web application security control library that makes it easier for programmers to write lower-risk applications. The ESAPI for Java library is designed to make it easier for programmers to retrofit security into existing applications. ESAPI for Java also serves as a solid foundation for new development.
+ +OWASP ESAPI (The OWASP Enterprise Security API) is a free, open source, web application security control library that makes it easier for programmers to write lower-risk applications. The ESAPI for Java library is designed to make it easier for programmers to retrofit security into existing applications. ESAPI for Java also serves as a solid foundation for new development. + + + What does Legacy mean?

This is the legacy branch of ESAPI which means it is an actively maintained branch of the project, however feature development for this branch will not be done. Features that have already been scheduled for the 2.x branch will move forward, but the main focus will be working on the ESAPI 3.x branch. From 7ac1c84151564c33706796a090084cb86db9b2ac Mon Sep 17 00:00:00 2001 From: karansanwal Date: Tue, 28 Oct 2014 00:43:49 +0530 Subject: [PATCH 044/812] Fix to Issue # 190 --- .../java/org/owasp/esapi/reference/DefaultHTTPUtilities.java | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/main/java/org/owasp/esapi/reference/DefaultHTTPUtilities.java b/src/main/java/org/owasp/esapi/reference/DefaultHTTPUtilities.java index dc99d76b3..767a49438 100644 --- a/src/main/java/org/owasp/esapi/reference/DefaultHTTPUtilities.java +++ b/src/main/java/org/owasp/esapi/reference/DefaultHTTPUtilities.java @@ -811,7 +811,7 @@ public void sendForward( String location ) throws AccessControlException,Servle public void sendRedirect(HttpServletResponse response, String location) throws AccessControlException, IOException { if (!ESAPI.validator().isValidRedirectLocation("Redirect", location, false)) { logger.fatal(Logger.SECURITY_FAILURE, "Bad redirect location: " + location); - throw new IOException("Redirect failed"); + throw new AccessControlException("Redirect failed"); } response.sendRedirect(location); } From 374e54264aae3d1628ae1a6732bd8874ff3cec81 Mon Sep 17 00:00:00 2001 From: Chris Schmidt Date: Mon, 10 Nov 2014 14:34:30 -0700 Subject: [PATCH 045/812] Update README.md --- README.md | 9 ++++++++- 1 file changed, 8 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 09d6a76c1..e4c8a3e3b 100644 --- a/README.md +++ b/README.md @@ -17,12 +17,19 @@ https://github.com/ESAPI/esapi-java How can I contribute or fix bugs?
Fork and submit a pull request! Simple as pi! +What happened to Google code?
+In mid-2014 ESAPI Migrated all code to GitHub, in November we started using JIRA/Confluence. + +What about the issues still located on Google Code
+We will be migrating the issues from Google Code to JIRA as time allows, in the meantime - if you would like to work on a Google Code issue, please create a new issue in JIRA and reference the Google Code issue in the issue Description. + Wiki: https://www.owasp.org/index.php/Category:OWASP_Enterprise_Security_API Nightly Build: https://esapi.ci.cloudbees.com -JIRA: Coming Soon +JIRA: https://owasp-esapi.atlassian.net/browse/ESAPILEG +Documentation: https://owasp-esapi.atlassian.net/wiki/display/ESAPILEG/ESAPI+Legacy (Coming Soon) Realtime Support available on our IRC Channel:
Server: irc.freenode.net
From 764dad9c96b2bc765a3cd7f3ca62706622724ae2 Mon Sep 17 00:00:00 2001 From: Constantino Cronemberger Date: Mon, 8 Dec 2014 14:13:34 -0200 Subject: [PATCH 046/812] fix issue 268: https://code.google.com/p/owasp-esapi-java/issues/detail?id=268 Log4JLogger.java doesn't output correct file & line number because FQCN isn't forwarded to Log4J --- src/main/java/org/owasp/esapi/reference/Log4JLogger.java | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/src/main/java/org/owasp/esapi/reference/Log4JLogger.java b/src/main/java/org/owasp/esapi/reference/Log4JLogger.java index 7782f89c7..af7045663 100644 --- a/src/main/java/org/owasp/esapi/reference/Log4JLogger.java +++ b/src/main/java/org/owasp/esapi/reference/Log4JLogger.java @@ -447,7 +447,9 @@ private void log(Level level, EventType type, String message, Throwable throwabl } // log the message - log(level, "[" + typeInfo + getUserInfo() + " -> " + appInfo + "] " + clean, throwable); + // Fix for https://code.google.com/p/owasp-esapi-java/issues/detail?id=268 + // need to pass callerFQCN so the log is not generated as if it were always generated from this wrapper class + log(Log4JLogger.class.getName(), level, "[" + typeInfo + getUserInfo() + " -> " + appInfo + "] " + clean, throwable); } /** From a543edb00bf22adc1ee08097389b0b9fbe4cedf4 Mon Sep 17 00:00:00 2001 From: Constantino Cronemberger Date: Mon, 8 Dec 2014 15:36:09 -0200 Subject: [PATCH 047/812] fix issue 268: test for this issue --- .../esapi/reference/Log4JLoggerTest.java | 23 +++++++++++++++++++ 1 file changed, 23 insertions(+) diff --git a/src/test/java/org/owasp/esapi/reference/Log4JLoggerTest.java b/src/test/java/org/owasp/esapi/reference/Log4JLoggerTest.java index cddf71e20..55734a9c8 100644 --- a/src/test/java/org/owasp/esapi/reference/Log4JLoggerTest.java +++ b/src/test/java/org/owasp/esapi/reference/Log4JLoggerTest.java @@ -16,12 +16,15 @@ package org.owasp.esapi.reference; import java.io.IOException; +import java.io.StringWriter; import java.util.Arrays; import junit.framework.Test; import junit.framework.TestCase; import junit.framework.TestSuite; +import org.apache.log4j.*; +import org.apache.log4j.xml.XMLLayout; import org.owasp.esapi.ESAPI; import org.owasp.esapi.Logger; import org.owasp.esapi.errors.AuthenticationException; @@ -460,4 +463,24 @@ public void testAlways() { } } + /** + * Validation for issue: https://code.google.com/p/owasp-esapi-java/issues/detail?id=268 + * Line number must be the line of the caller and not of the wrapper. + */ + public void testLine() { + StringWriter sw = new StringWriter(); + Layout layout = new PatternLayout("%d{ISO8601}%5p [%t] %C:%L - %m%n"); + Appender appender = new WriterAppender(layout, sw); + log4JLogger.addAppender(appender); + try { + log4JLogger.fatal("testLine"); + String generatedLine = sw.toString(); + System.out.println("-> " + generatedLine + " <-"); + assertTrue("generated line should not have the name of the wrapper class", + // need to add the ":" sufix otherwise the test would also fail with this test class name + !generatedLine.contains(Log4JLogger.class.getName()+":")); + } finally { + log4JLogger.removeAppender(appender); + } + } } From bc3b476ade2ccfb8b95ad1cb6b69614f9d1ccb7e Mon Sep 17 00:00:00 2001 From: Constantino Cronemberger Date: Mon, 8 Dec 2014 16:31:40 -0200 Subject: [PATCH 048/812] using a special Layout instance to make sure this test is more robust --- .../esapi/reference/Log4JLoggerTest.java | 40 +++++++++++++------ 1 file changed, 27 insertions(+), 13 deletions(-) diff --git a/src/test/java/org/owasp/esapi/reference/Log4JLoggerTest.java b/src/test/java/org/owasp/esapi/reference/Log4JLoggerTest.java index 55734a9c8..99c5faaf0 100644 --- a/src/test/java/org/owasp/esapi/reference/Log4JLoggerTest.java +++ b/src/test/java/org/owasp/esapi/reference/Log4JLoggerTest.java @@ -15,16 +15,13 @@ */ package org.owasp.esapi.reference; -import java.io.IOException; -import java.io.StringWriter; -import java.util.Arrays; - import junit.framework.Test; import junit.framework.TestCase; import junit.framework.TestSuite; - -import org.apache.log4j.*; -import org.apache.log4j.xml.XMLLayout; +import org.apache.log4j.Appender; +import org.apache.log4j.Layout; +import org.apache.log4j.WriterAppender; +import org.apache.log4j.spi.LoggingEvent; import org.owasp.esapi.ESAPI; import org.owasp.esapi.Logger; import org.owasp.esapi.errors.AuthenticationException; @@ -32,6 +29,10 @@ import org.owasp.esapi.http.MockHttpServletRequest; import org.owasp.esapi.http.MockHttpServletResponse; +import java.io.IOException; +import java.io.StringWriter; +import java.util.Arrays; + /** * The Class LoggerTest. * @@ -468,17 +469,30 @@ public void testAlways() { * Line number must be the line of the caller and not of the wrapper. */ public void testLine() { + final String message = "testing only"; StringWriter sw = new StringWriter(); - Layout layout = new PatternLayout("%d{ISO8601}%5p [%t] %C:%L - %m%n"); + Layout layout = new Layout() { + @Override + public String format(LoggingEvent event) { + assertEquals("the calling class is this test class", Log4JLoggerTest.class.getName(),event.getLocationInformation().getClassName()); + return message; + } + + @Override + public boolean ignoresThrowable() { + return false; + } + + @Override + public void activateOptions() { + + } + }; Appender appender = new WriterAppender(layout, sw); log4JLogger.addAppender(appender); try { log4JLogger.fatal("testLine"); - String generatedLine = sw.toString(); - System.out.println("-> " + generatedLine + " <-"); - assertTrue("generated line should not have the name of the wrapper class", - // need to add the ":" sufix otherwise the test would also fail with this test class name - !generatedLine.contains(Log4JLogger.class.getName()+":")); + assertEquals("message not generated as expected", message, sw.toString()); } finally { log4JLogger.removeAppender(appender); } From a0cf3e11d45b9abf64a93173ed24c00701e5e4c7 Mon Sep 17 00:00:00 2001 From: karansanwal Date: Tue, 16 Dec 2014 12:50:32 +0530 Subject: [PATCH 049/812] Update BaseValidationRule.java A minor mistake in previous commit --- .../owasp/esapi/reference/validation/BaseValidationRule.java | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/main/java/org/owasp/esapi/reference/validation/BaseValidationRule.java b/src/main/java/org/owasp/esapi/reference/validation/BaseValidationRule.java index 538c658c4..8201aafd7 100644 --- a/src/main/java/org/owasp/esapi/reference/validation/BaseValidationRule.java +++ b/src/main/java/org/owasp/esapi/reference/validation/BaseValidationRule.java @@ -100,7 +100,7 @@ public Object getValid( String context, String input, ValidationErrorList errorL try { valid = getValid( context, input ); } catch (ValidationException e) { - if( errorList == null { + if( errorList == null) { throw e; } else { errorList.addError(context, e); From 2dbb419112227e12b315c51ca21df9b61a808e0e Mon Sep 17 00:00:00 2001 From: Arpit Gupta Date: Thu, 1 Jan 2015 17:31:33 +0530 Subject: [PATCH 050/812] Fix for issue #289 https://github.com/ESAPI/esapi-java-legacy/issues/289 When using ClickJackFilter, In some cases response header is not set. http://stackoverflow.com/questions/11371755/clickjacking-filter-to-add-x -frame-options-in-response --- src/main/java/org/owasp/esapi/filters/ClickjackFilter.java | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/main/java/org/owasp/esapi/filters/ClickjackFilter.java b/src/main/java/org/owasp/esapi/filters/ClickjackFilter.java index 735d21ec0..86025b1dd 100644 --- a/src/main/java/org/owasp/esapi/filters/ClickjackFilter.java +++ b/src/main/java/org/owasp/esapi/filters/ClickjackFilter.java @@ -95,8 +95,8 @@ public void init(FilterConfig filterConfig) { public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain) throws IOException, ServletException { HttpServletResponse res = (HttpServletResponse)response; - chain.doFilter(request, response); res.addHeader("X-FRAME-OPTIONS", mode ); + chain.doFilter(request, response); } /** From 92c2e839f6fbab80318d29840e3eb69000f2b3eb Mon Sep 17 00:00:00 2001 From: Ben Sleek Date: Fri, 10 Apr 2015 15:13:13 -0400 Subject: [PATCH 051/812] Added test for Issue #195 --- .../validation/BaseValidationRuleTest.java | 101 ++++++++++++++++++ 1 file changed, 101 insertions(+) create mode 100644 src/test/java/org/owasp/esapi/reference/validation/BaseValidationRuleTest.java diff --git a/src/test/java/org/owasp/esapi/reference/validation/BaseValidationRuleTest.java b/src/test/java/org/owasp/esapi/reference/validation/BaseValidationRuleTest.java new file mode 100644 index 000000000..f7adfccdb --- /dev/null +++ b/src/test/java/org/owasp/esapi/reference/validation/BaseValidationRuleTest.java @@ -0,0 +1,101 @@ +/** + * OWASP Enterprise Security API (ESAPI) + * + * This file is part of the Open Web Application Security Project (OWASP) + * Enterprise Security API (ESAPI) project. For details, please see + * http://www.owasp.org/index.php/ESAPI. + * + * Copyright (c) 2007 - The OWASP Foundation + * + * The ESAPI is published by OWASP under the BSD license. You should read and accept the + * LICENSE before you use, modify, and/or redistribute this software. + * + * @author Ben Sleek Sparta Systems + * @created 2015 + */ +package org.owasp.esapi.reference.validation; + +import junit.framework.Test; +import junit.framework.TestCase; +import junit.framework.TestSuite; + +import org.owasp.esapi.Encoder; +import org.owasp.esapi.errors.ValidationException; + +public class BaseValidationRuleTest extends TestCase { + + /** + * Instantiates a new base validation rule test. + * + * @param testName + * the test name + */ + public BaseValidationRuleTest(String testName) { + super(testName); + } + + /** + * {@inheritDoc} + * + * @throws Exception + */ + protected void setUp() throws Exception { + // none + } + + /** + * {@inheritDoc} + * + * @throws Exception + */ + protected void tearDown() throws Exception { + // none + } + + /** + * Suite. + * + * @return the test + */ + public static Test suite() { + TestSuite suite = new TestSuite(BaseValidationRuleTest.class); + return suite; + } + + /** + * Verifies assertValid throws ValidationException on invalid input + * Validates fix for Google issue #195 + * + * @throws ValidationException + */ + public void testAssertValid() throws ValidationException { + SampleValidationRule rule = new SampleValidationRule("UnitTest"); + try { + rule.assertValid("testcontext", "badinput"); + fail(); + } catch (ValidationException e) { + // success + } + } + + public class SampleValidationRule extends BaseValidationRule { + + public SampleValidationRule(String typeName, Encoder encoder) { + super(typeName, encoder); + } + + public SampleValidationRule(String typeName) { + super(typeName); + } + + @Override + protected Object sanitize(String context, String input) { + return null; + } + + public Object getValid(String context, String input) throws ValidationException { + throw new ValidationException("Demonstration Exception", "Demonstration Exception"); + } + + } +} From 2e08dac45f166de8d3b4f86148897b1b6986e216 Mon Sep 17 00:00:00 2001 From: taringamberini Date: Sat, 25 Apr 2015 20:02:35 +0200 Subject: [PATCH 052/812] Set the locale suitable for US dates PROBLEM The org.owasp.esapi.errors.ValidationException is thrown with a logMessage: Invalid date: context=datetest1, format=java.text.SimpleDateFormat@2aca24a9, input=September 11, 2001 and a detailMessage: datetest1: Invalid date must follow the java.text.DecimalFormat@674dc format CAUSE The SimpleDateFormat.getDateInstance() is default locale dependent, so the date September 11, 2001 can't be correctly formatted on my Java Virtual Machine Locale which is it_IT. SOLUTION Use the US locale. Fixes ESAPI/esapi-java-legacy#345 --- src/test/java/org/owasp/esapi/reference/ValidatorTest.java | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/test/java/org/owasp/esapi/reference/ValidatorTest.java b/src/test/java/org/owasp/esapi/reference/ValidatorTest.java index 9402630bb..f1bf4b914 100644 --- a/src/test/java/org/owasp/esapi/reference/ValidatorTest.java +++ b/src/test/java/org/owasp/esapi/reference/ValidatorTest.java @@ -323,7 +323,7 @@ public void testIsInvalidFilename() { public void testIsValidDate() { System.out.println("isValidDate"); Validator instance = ESAPI.validator(); - DateFormat format = SimpleDateFormat.getDateInstance(); + DateFormat format = SimpleDateFormat.getDateInstance(SimpleDateFormat.MEDIUM, Locale.US); assertTrue(instance.isValidDate("datetest1", "September 11, 2001", format, true)); assertFalse(instance.isValidDate("datetest2", null, format, false)); assertFalse(instance.isValidDate("datetest3", "", format, false)); From 948592a763bece1434bc99c0ed2007cb27106a4e Mon Sep 17 00:00:00 2001 From: Kad DEMBELE Date: Mon, 27 Apr 2015 21:48:53 +0200 Subject: [PATCH 053/812] Fix for issue #344 --- src/test/java/org/owasp/esapi/reference/ValidatorTest.java | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/test/java/org/owasp/esapi/reference/ValidatorTest.java b/src/test/java/org/owasp/esapi/reference/ValidatorTest.java index 9402630bb..946962d6f 100644 --- a/src/test/java/org/owasp/esapi/reference/ValidatorTest.java +++ b/src/test/java/org/owasp/esapi/reference/ValidatorTest.java @@ -297,7 +297,7 @@ public void testGetValidSafeHTML() throws Exception { assertEquals("Test. <

load=alert()
", rule.getSafe("test", "Test. <
load=alert()")); assertEquals("Test.
b
", rule.getSafe("test", "Test.
b
")); - assertEquals("Test.", rule.getSafe("test", "Test. alert(document.cookie)")); + assertEquals("Test.", rule.getSafe("test", "Test. ")); assertEquals("Test. alert(document.cookie)", rule.getSafe("test", "Test. alert(document.cookie)")); assertEquals("Test. alert(document.cookie)", rule.getSafe("test", "Test. alert(document.cookie)")); // TODO: ENHANCE waiting for a way to validate text headed for an attribute for scripts From db106031cf3babe086dfb0b5e7d971a2d10fc242 Mon Sep 17 00:00:00 2001 From: Kad DEMBELE Date: Mon, 27 Apr 2015 23:14:02 +0200 Subject: [PATCH 054/812] Using the right AccessControlException class to throw Exception --- .../esapi/reference/DefaultHTTPUtilities.java | 48 +++++++++++++------ 1 file changed, 34 insertions(+), 14 deletions(-) diff --git a/src/main/java/org/owasp/esapi/reference/DefaultHTTPUtilities.java b/src/main/java/org/owasp/esapi/reference/DefaultHTTPUtilities.java index 767a49438..6c56ce2e9 100644 --- a/src/main/java/org/owasp/esapi/reference/DefaultHTTPUtilities.java +++ b/src/main/java/org/owasp/esapi/reference/DefaultHTTPUtilities.java @@ -15,15 +15,17 @@ */ package org.owasp.esapi.reference; -import org.apache.commons.fileupload.FileItem; -import org.apache.commons.fileupload.ProgressListener; -import org.apache.commons.fileupload.disk.DiskFileItemFactory; -import org.apache.commons.fileupload.servlet.ServletFileUpload; -import org.owasp.esapi.*; -import org.owasp.esapi.codecs.Hex; -import org.owasp.esapi.crypto.CipherText; -import org.owasp.esapi.crypto.PlainText; -import org.owasp.esapi.errors.*; +import java.io.File; +import java.io.IOException; +import java.util.ArrayList; +import java.util.Collections; +import java.util.Enumeration; +import java.util.HashMap; +import java.util.Iterator; +import java.util.List; +import java.util.Map; +import java.util.TreeMap; +import java.util.concurrent.ConcurrentHashMap; import javax.servlet.RequestDispatcher; import javax.servlet.ServletException; @@ -31,10 +33,28 @@ import javax.servlet.http.HttpServletRequest; import javax.servlet.http.HttpServletResponse; import javax.servlet.http.HttpSession; -import java.io.File; -import java.io.IOException; -import java.util.*; -import java.util.concurrent.ConcurrentHashMap; + +import org.apache.commons.fileupload.FileItem; +import org.apache.commons.fileupload.ProgressListener; +import org.apache.commons.fileupload.disk.DiskFileItemFactory; +import org.apache.commons.fileupload.servlet.ServletFileUpload; +import org.owasp.esapi.ESAPI; +import org.owasp.esapi.HTTPUtilities; +import org.owasp.esapi.Logger; +import org.owasp.esapi.StringUtilities; +import org.owasp.esapi.User; +import org.owasp.esapi.ValidationErrorList; +import org.owasp.esapi.codecs.Hex; +import org.owasp.esapi.crypto.CipherText; +import org.owasp.esapi.crypto.PlainText; +import org.owasp.esapi.errors.AccessControlException; +import org.owasp.esapi.errors.AuthenticationException; +import org.owasp.esapi.errors.EncodingException; +import org.owasp.esapi.errors.EncryptionException; +import org.owasp.esapi.errors.IntegrityException; +import org.owasp.esapi.errors.IntrusionException; +import org.owasp.esapi.errors.ValidationException; +import org.owasp.esapi.errors.ValidationUploadException; /** * Reference implementation of the HTTPUtilities interface. This implementation @@ -811,7 +831,7 @@ public void sendForward( String location ) throws AccessControlException,Servle public void sendRedirect(HttpServletResponse response, String location) throws AccessControlException, IOException { if (!ESAPI.validator().isValidRedirectLocation("Redirect", location, false)) { logger.fatal(Logger.SECURITY_FAILURE, "Bad redirect location: " + location); - throw new AccessControlException("Redirect failed"); + throw new AccessControlException("Redirect failed", "Bad Redirect location: " + location); } response.sendRedirect(location); } From fc101e4ca88b47fe0a8ab16a505bcf3ab4ccc4be Mon Sep 17 00:00:00 2001 From: Kad DEMBELE Date: Tue, 28 Apr 2015 00:30:32 +0200 Subject: [PATCH 055/812] Update ValidatorTest.java --- src/test/java/org/owasp/esapi/reference/ValidatorTest.java | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/test/java/org/owasp/esapi/reference/ValidatorTest.java b/src/test/java/org/owasp/esapi/reference/ValidatorTest.java index dbb754221..e272289f4 100644 --- a/src/test/java/org/owasp/esapi/reference/ValidatorTest.java +++ b/src/test/java/org/owasp/esapi/reference/ValidatorTest.java @@ -297,7 +297,7 @@ public void testGetValidSafeHTML() throws Exception { assertEquals("Test. <
load=alert()
", rule.getSafe("test", "Test. <
load=alert()")); assertEquals("Test.
b
", rule.getSafe("test", "Test.
b
")); - assertEquals("Test.", rule.getSafe("test", "Test. ")); + assertEquals("Test.alert(document.cookie)", rule.getSafe("test", "Test. alert(document.cookie)")); assertEquals("Test. alert(document.cookie)", rule.getSafe("test", "Test. alert(document.cookie)")); assertEquals("Test. alert(document.cookie)", rule.getSafe("test", "Test. alert(document.cookie)")); // TODO: ENHANCE waiting for a way to validate text headed for an attribute for scripts From 2bca895904eb6b2fd8a06c6d813110d331cfcdd2 Mon Sep 17 00:00:00 2001 From: Kad DEMBELE Date: Tue, 28 Apr 2015 00:34:21 +0200 Subject: [PATCH 056/812] Update ValidatorTest.java --- src/test/java/org/owasp/esapi/reference/ValidatorTest.java | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/test/java/org/owasp/esapi/reference/ValidatorTest.java b/src/test/java/org/owasp/esapi/reference/ValidatorTest.java index e272289f4..8a5359211 100644 --- a/src/test/java/org/owasp/esapi/reference/ValidatorTest.java +++ b/src/test/java/org/owasp/esapi/reference/ValidatorTest.java @@ -297,7 +297,7 @@ public void testGetValidSafeHTML() throws Exception { assertEquals("Test. <
load=alert()
", rule.getSafe("test", "Test. <
load=alert()")); assertEquals("Test.
b
", rule.getSafe("test", "Test.
b
")); - assertEquals("Test.alert(document.cookie)", rule.getSafe("test", "Test. alert(document.cookie)")); + assertEquals("Test. alert(document.cookie)", rule.getSafe("test", "Test. alert(document.cookie)")); assertEquals("Test. alert(document.cookie)", rule.getSafe("test", "Test. alert(document.cookie)")); assertEquals("Test. alert(document.cookie)", rule.getSafe("test", "Test. alert(document.cookie)")); // TODO: ENHANCE waiting for a way to validate text headed for an attribute for scripts From 20438dbae5ecf8a51f454f38d1e0525fe4b61eb6 Mon Sep 17 00:00:00 2001 From: Chris Schmidt Date: Sat, 30 May 2015 16:25:20 +0000 Subject: [PATCH 057/812] Fixed unit tests and DefaultHttpUtilities --- .codenvy/project.json | 1 + .../esapi/errors/AccessControlException.java | 114 +- .../esapi/reference/DefaultHTTPUtilities.java | 2044 +++++++-------- .../esapi/reference/HTTPUtilitiesTest.java | 1015 ++++---- .../owasp/esapi/reference/ValidatorTest.java | 2300 ++++++++--------- 5 files changed, 2738 insertions(+), 2736 deletions(-) create mode 100644 .codenvy/project.json diff --git a/.codenvy/project.json b/.codenvy/project.json new file mode 100644 index 000000000..df32873a0 --- /dev/null +++ b/.codenvy/project.json @@ -0,0 +1 @@ +{"builders":{"configs":{},"default":"maven"},"mixinTypes":["contribution"],"runners":{"configs":{"system:/java/codenvy-cli":{"ram":1000,"variables":{},"options":{}}},"default":"system:/java/codenvy-cli"},"type":"maven","attributes":{"languageVersion":["1.6"],"language":["java"],"contribute_branch":["master"],"contribute_mode":["contribute"]}} \ No newline at end of file diff --git a/src/main/java/org/owasp/esapi/errors/AccessControlException.java b/src/main/java/org/owasp/esapi/errors/AccessControlException.java index 2c54417ab..96eaf80c5 100644 --- a/src/main/java/org/owasp/esapi/errors/AccessControlException.java +++ b/src/main/java/org/owasp/esapi/errors/AccessControlException.java @@ -1,57 +1,57 @@ -/** - * OWASP Enterprise Security API (ESAPI) - * - * This file is part of the Open Web Application Security Project (OWASP) - * Enterprise Security API (ESAPI) project. For details, please see - * http://www.owasp.org/index.php/ESAPI. - * - * Copyright (c) 2007 - The OWASP Foundation - * - * The ESAPI is published by OWASP under the BSD license. You should read and accept the - * LICENSE before you use, modify, and/or redistribute this software. - * - * @author Jeff Williams Aspect Security - * @created 2007 - */ -package org.owasp.esapi.errors; - -/** - * An AccessControlException should be thrown when a user attempts to access a - * resource that they are not authorized for. - * - * @author Jeff Williams (jeff.williams@aspectsecurity.com) - */ -public class AccessControlException extends EnterpriseSecurityException { - - /** The Constant serialVersionUID. */ - private static final long serialVersionUID = 1L; - - /** - * Instantiates a new access control exception. - */ - protected AccessControlException() { - // hidden - } - - /** - * Creates a new instance of {@code AccessControlException}. - * - * @param userMessage - * @param logMessage - */ - public AccessControlException(String userMessage, String logMessage) { - super(userMessage, logMessage); - } - - /** - * Instantiates a new access control exception. - * - * @param userMessage the message displayed to the user - * @param logMessage the message logged - * @param cause the root cause - */ - public AccessControlException(String userMessage, String logMessage, Throwable cause) { - super(userMessage, logMessage, cause); - } - -} +/** + * OWASP Enterprise Security API (ESAPI) + * + * This file is part of the Open Web Application Security Project (OWASP) + * Enterprise Security API (ESAPI) project. For details, please see + * http://www.owasp.org/index.php/ESAPI. + * + * Copyright (c) 2007 - The OWASP Foundation + * + * The ESAPI is published by OWASP under the BSD license. You should read and accept the + * LICENSE before you use, modify, and/or redistribute this software. + * + * @author Jeff Williams Aspect Security + * @created 2007 + */ +package org.owasp.esapi.errors; + +/** + * An AccessControlException should be thrown when a user attempts to access a + * resource that they are not authorized for. + * + * @author Jeff Williams (jeff.williams@aspectsecurity.com) + */ +public class AccessControlException extends EnterpriseSecurityException { + + /** The Constant serialVersionUID. */ + private static final long serialVersionUID = 1L; + + /** + * Instantiates a new access control exception. + */ + protected AccessControlException() { + // hidden + } + + /** + * Creates a new instance of {@code AccessControlException}. + * + * @param userMessage + * @param logMessage + */ + public AccessControlException(String userMessage, String logMessage) { + super(userMessage, logMessage); + } + + /** + * Instantiates a new access control exception. + * + * @param userMessage the message displayed to the user + * @param logMessage the message logged + * @param cause the root cause + */ + public AccessControlException(String userMessage, String logMessage, Throwable cause) { + super(userMessage, logMessage, cause); + } + +} diff --git a/src/main/java/org/owasp/esapi/reference/DefaultHTTPUtilities.java b/src/main/java/org/owasp/esapi/reference/DefaultHTTPUtilities.java index 767a49438..654a7216a 100644 --- a/src/main/java/org/owasp/esapi/reference/DefaultHTTPUtilities.java +++ b/src/main/java/org/owasp/esapi/reference/DefaultHTTPUtilities.java @@ -1,1022 +1,1022 @@ -/** - * OWASP Enterprise Security API (ESAPI) - * - * This file is part of the Open Web Application Security Project (OWASP) - * Enterprise Security API (ESAPI) project. For details, please see - * http://www.owasp.org/index.php/ESAPI. - * - * Copyright (c) 2007 - The OWASP Foundation - * - * The ESAPI is published by OWASP under the BSD license. You should read and accept the - * LICENSE before you use, modify, and/or redistribute this software. - * - * @author Jeff Williams Aspect Security - * @created 2007 - */ -package org.owasp.esapi.reference; - -import org.apache.commons.fileupload.FileItem; -import org.apache.commons.fileupload.ProgressListener; -import org.apache.commons.fileupload.disk.DiskFileItemFactory; -import org.apache.commons.fileupload.servlet.ServletFileUpload; -import org.owasp.esapi.*; -import org.owasp.esapi.codecs.Hex; -import org.owasp.esapi.crypto.CipherText; -import org.owasp.esapi.crypto.PlainText; -import org.owasp.esapi.errors.*; - -import javax.servlet.RequestDispatcher; -import javax.servlet.ServletException; -import javax.servlet.http.Cookie; -import javax.servlet.http.HttpServletRequest; -import javax.servlet.http.HttpServletResponse; -import javax.servlet.http.HttpSession; -import java.io.File; -import java.io.IOException; -import java.util.*; -import java.util.concurrent.ConcurrentHashMap; - -/** - * Reference implementation of the HTTPUtilities interface. This implementation - * uses the Apache Commons FileUploader library, which in turn uses the Apache - * Commons IO library. - *

- * To simplify the interface, some methods use the current request and response that - * are tracked by ThreadLocal variables in the Authenticator. This means that you - * must have called ESAPI.authenticator().setCurrentHTTP(request, response) before - * calling these methods. - *

- * Typically, this is done by calling the Authenticator.login() method, which - * calls setCurrentHTTP() automatically. However if you want to use these methods - * in another application, you should explicitly call setCurrentHTTP() in your - * own code. In either case, you *must* call ESAPI.clearCurrent() to clear threadlocal - * variables before the thread is reused. The advantages of having identity everywhere - * outweigh the disadvantages of this approach. - * - * @author Jeff Williams (jeff.williams .at. aspectsecurity.com) Aspect Security - * @since June 1, 2007 - * @see org.owasp.esapi.HTTPUtilities - */ -public class DefaultHTTPUtilities implements org.owasp.esapi.HTTPUtilities { - private static volatile HTTPUtilities instance = null; - - public static HTTPUtilities getInstance() { - if ( instance == null ) { - synchronized ( DefaultHTTPUtilities.class ) { - if ( instance == null ) { - instance = new DefaultHTTPUtilities(); - } - } - } - return instance; - } - - /** - * Defines the ThreadLocalRequest to store the current request for this thread. - */ - private class ThreadLocalRequest extends InheritableThreadLocal { - - public HttpServletRequest getRequest() { - return super.get(); - } - - public HttpServletRequest initialValue() { - return null; - } - - public void setRequest(HttpServletRequest newRequest) { - super.set(newRequest); - } - } - - /** - * Defines the ThreadLocalResponse to store the current response for this thread. - */ - private class ThreadLocalResponse extends InheritableThreadLocal { - - public HttpServletResponse getResponse() { - return super.get(); - } - - public HttpServletResponse initialValue() { - return null; - } - - public void setResponse(HttpServletResponse newResponse) { - super.set(newResponse); - } - } - - /** The logger. */ - private final Logger logger = ESAPI.getLogger("HTTPUtilities"); - - /** The max bytes. */ - static final int maxBytes = ESAPI.securityConfiguration().getAllowedFileUploadSize(); - - - /* - * The currentRequest ThreadLocal variable is used to make the currentRequest available to any call in any part of an - * application. This enables API's for actions that require the request to be much simpler. For example, the logout() - * method in the Authenticator class requires the currentRequest to get the session in order to invalidate it. - */ - private ThreadLocalRequest currentRequest = new ThreadLocalRequest(); - - /* - * The currentResponse ThreadLocal variable is used to make the currentResponse available to any call in any part of an - * application. This enables API's for actions that require the response to be much simpler. For example, the logout() - * method in the Authenticator class requires the currentResponse to kill the Session ID cookie. - */ - private ThreadLocalResponse currentResponse = new ThreadLocalResponse(); - - - - /** - * No arg constructor. - */ - public DefaultHTTPUtilities() { - } - - - /** - * {@inheritDoc} - * This implementation uses a custom "set-cookie" header rather than Java's - * cookie interface which doesn't allow the use of HttpOnly. Configure the - * HttpOnly and Secure settings in ESAPI.properties. - */ - public void addCookie( Cookie cookie ) { - addCookie( getCurrentResponse(), cookie ); - } - - /** - * {@inheritDoc} - * This implementation uses a custom "set-cookie" header rather than Java's - * cookie interface which doesn't allow the use of HttpOnly. Configure the - * HttpOnly and Secure settings in ESAPI.properties. - */ - public void addCookie(HttpServletResponse response, Cookie cookie) { - String name = cookie.getName(); - String value = cookie.getValue(); - int maxAge = cookie.getMaxAge(); - String domain = cookie.getDomain(); - String path = cookie.getPath(); - boolean secure = cookie.getSecure(); - - // validate the name and value - ValidationErrorList errors = new ValidationErrorList(); - String cookieName = ESAPI.validator().getValidInput("cookie name", name, "HTTPCookieName", 50, false, errors); - String cookieValue = ESAPI.validator().getValidInput("cookie value", value, "HTTPCookieValue", 5000, false, errors); - - // if there are no errors, then set the cookie either with a header or normally - if (errors.size() == 0) { - if ( ESAPI.securityConfiguration().getForceHttpOnlyCookies() ) { - String header = createCookieHeader(cookieName, cookieValue, maxAge, domain, path, secure); - addHeader(response, "Set-Cookie", header); - } else { - // Issue 23 - If the ESAPI Configuration is set to force secure cookies, force the secure flag on the cookie before setting it - cookie.setSecure( secure || ESAPI.securityConfiguration().getForceSecureCookies() ); - response.addCookie(cookie); - } - return; - } - logger.warning(Logger.SECURITY_FAILURE, "Attempt to add unsafe data to cookie (skip mode). Skipping cookie and continuing."); - } - - - - /** - * {@inheritDoc} - */ - public String addCSRFToken(String href) { - User user = ESAPI.authenticator().getCurrentUser(); - if (user.isAnonymous()) { - return href; - } - - // if there are already parameters append with &, otherwise append with ? - String token = CSRF_TOKEN_NAME + "=" + user.getCSRFToken(); - return href.indexOf( '?') != -1 ? href + "&" + token : href + "?" + token; - } - - /** - * {@inheritDoc} - */ - public void addHeader(String name, String value) { - addHeader( getCurrentResponse(), name, value ); - } - - /** - * {@inheritDoc} - */ - public void addHeader(HttpServletResponse response, String name, String value) { - try { - String strippedName = StringUtilities.replaceLinearWhiteSpace(name); - String strippedValue = StringUtilities.replaceLinearWhiteSpace(value); - String safeName = ESAPI.validator().getValidInput("addHeader", strippedName, "HTTPHeaderName", 20, false); - String safeValue = ESAPI.validator().getValidInput("addHeader", strippedValue, "HTTPHeaderValue", 500, false); - response.addHeader(safeName, safeValue); - } catch (ValidationException e) { - logger.warning(Logger.SECURITY_FAILURE, "Attempt to add invalid header denied", e); - } - } - - /** - * {@inheritDoc} - */ - public void assertSecureChannel() throws AccessControlException { - assertSecureChannel( getCurrentRequest() ); - } - - /** - * {@inheritDoc} - * - * This implementation ignores the built-in isSecure() method - * and uses the URL to determine if the request was transmitted over SSL. - * This is because SSL may have been terminated somewhere outside the - * container. - */ - public void assertSecureChannel(HttpServletRequest request) throws AccessControlException { - if ( request == null ) { - throw new AccessControlException( "Insecure request received", "HTTP request was null" ); - } - StringBuffer sb = request.getRequestURL(); - if ( sb == null ) { - throw new AccessControlException( "Insecure request received", "HTTP request URL was null" ); - } - String url = sb.toString(); - if ( !url.startsWith( "https" ) ) { - throw new AccessControlException( "Insecure request received", "HTTP request did not use SSL" ); - } - } - - /** - * {@inheritDoc} - */ - public void assertSecureRequest() throws AccessControlException { - assertSecureRequest( getCurrentRequest() ); - } - - /** - * {@inheritDoc} - */ - public void assertSecureRequest(HttpServletRequest request) throws AccessControlException { - assertSecureChannel( request ); - String receivedMethod = request.getMethod(); - String requiredMethod = "POST"; - if ( !receivedMethod.equals( requiredMethod ) ) { - throw new AccessControlException( "Insecure request received", "Received request using " + receivedMethod + " when only " + requiredMethod + " is allowed" ); - } - } - - /** - * {@inheritDoc} - */ - public HttpSession changeSessionIdentifier() throws AuthenticationException { - return changeSessionIdentifier( getCurrentRequest() ); - } - - /** - * {@inheritDoc} - */ - public HttpSession changeSessionIdentifier(HttpServletRequest request) throws AuthenticationException { - - // get the current session - HttpSession oldSession = request.getSession(); - - // make a copy of the session content - Map temp = new ConcurrentHashMap(); - Enumeration e = oldSession.getAttributeNames(); - while (e != null && e.hasMoreElements()) { - String name = (String) e.nextElement(); - Object value = oldSession.getAttribute(name); - temp.put(name, value); - } - - // kill the old session and create a new one - oldSession.invalidate(); - HttpSession newSession = request.getSession(); - User user = ESAPI.authenticator().getCurrentUser(); - user.addSession( newSession ); - user.removeSession( oldSession ); - - // copy back the session content - for (Map.Entry stringObjectEntry : temp.entrySet()) - { - newSession.setAttribute(stringObjectEntry.getKey(), stringObjectEntry.getValue()); - } - return newSession; - } - - /** - * {@inheritDoc} - */ - public void clearCurrent() { - currentRequest.set(null); - currentResponse.set(null); - } - - private String createCookieHeader(String name, String value, int maxAge, String domain, String path, boolean secure) { - // create the special cookie header instead of creating a Java cookie - // Set-Cookie:=[; =][; expires=][; - // domain=][; path=][; secure][;HttpOnly] - String header = name + "=" + value; - header += "; Max-Age=" + maxAge; - if (domain != null) { - header += "; Domain=" + domain; - } - if (path != null) { - header += "; Path=" + path; - } - if ( secure || ESAPI.securityConfiguration().getForceSecureCookies() ) { - header += "; Secure"; - } - if ( ESAPI.securityConfiguration().getForceHttpOnlyCookies() ) { - header += "; HttpOnly"; - } - return header; - } - - /** - * {@inheritDoc} - */ - public String decryptHiddenField(String encrypted) { - try { - return decryptString(encrypted); - } catch( EncryptionException e ) { - throw new IntrusionException("Invalid request","Tampering detected. Hidden field data did not decrypt properly.", e); - } - } - - /** - * {@inheritDoc} - */ - public Map decryptQueryString(String encrypted) throws EncryptionException { - String plaintext = decryptString(encrypted); - return queryToMap(plaintext); - } - - /** - * {@inheritDoc} - */ - public Map decryptStateFromCookie() throws EncryptionException { - return decryptStateFromCookie( getCurrentRequest() ); - } - - /** - * {@inheritDoc} - * - * @param request - */ - public Map decryptStateFromCookie(HttpServletRequest request) throws EncryptionException { - try { - String encrypted = getCookie( request, ESAPI_STATE ); - if ( encrypted == null ) return new HashMap(); - String plaintext = decryptString(encrypted); - return queryToMap( plaintext ); - } catch( ValidationException e ) { - return null; - } - } - - /** - * {@inheritDoc} - */ - public String encryptHiddenField(String value) throws EncryptionException { - return encryptString(value); - } - - /** - * {@inheritDoc} - */ - public String encryptQueryString(String query) throws EncryptionException { - return encryptString(query); - } - - /** - * {@inheritDoc} - */ - public void encryptStateInCookie(HttpServletResponse response, Map cleartext) throws EncryptionException { - StringBuilder sb = new StringBuilder(); - Iterator i = cleartext.entrySet().iterator(); - while ( i.hasNext() ) { - try { - Map.Entry entry = (Map.Entry)i.next(); - - // What do these need to be URL encoded? They are encrypted! - String name = ESAPI.encoder().encodeForURL( entry.getKey().toString() ); - String value = ESAPI.encoder().encodeForURL( entry.getValue().toString() ); - sb.append(name).append("=").append(value); - if ( i.hasNext() ) sb.append( "&" ); - } catch( EncodingException e ) { - logger.error(Logger.SECURITY_FAILURE, "Problem encrypting state in cookie - skipping entry", e ); - } - } - - String encrypted = encryptString(sb.toString()); - - if ( encrypted.length() > (MAX_COOKIE_LEN ) ) { - logger.error(Logger.SECURITY_FAILURE, "Problem encrypting state in cookie - skipping entry"); - throw new EncryptionException("Encryption failure", "Encrypted cookie state of " + encrypted.length() + " longer than allowed " + MAX_COOKIE_LEN ); - } - - Cookie cookie = new Cookie( ESAPI_STATE, encrypted ); - addCookie( response, cookie ); - } - - /** - * {@inheritDoc} - */ - public void encryptStateInCookie( Map cleartext ) throws EncryptionException { - encryptStateInCookie( getCurrentResponse(), cleartext ); - } - - - /** - * {@inheritDoc} - */ - public String getCookie( HttpServletRequest request, String name ) throws ValidationException { - Cookie c = getFirstCookie( request, name ); - if ( c == null ) return null; - String value = c.getValue(); - return ESAPI.validator().getValidInput("HTTP cookie value: " + value, value, "HTTPCookieValue", 1000, false); - } - - /** - * {@inheritDoc} - */ - public String getCookie( String name ) throws ValidationException { - return getCookie( getCurrentRequest(), name ); - } - - /** - * {@inheritDoc} - */ - public String getCSRFToken() { - User user = ESAPI.authenticator().getCurrentUser(); - if (user == null) return null; - return user.getCSRFToken(); - } - - - /** - * {@inheritDoc} - */ - public HttpServletRequest getCurrentRequest() { - return currentRequest.getRequest(); - } - - - /** - * {@inheritDoc} - */ - public HttpServletResponse getCurrentResponse() { - return currentResponse.getResponse(); - } - - /** - * {@inheritDoc} - */ - public List getFileUploads() throws ValidationException { - return getFileUploads( getCurrentRequest(), ESAPI.securityConfiguration().getUploadDirectory(), ESAPI.securityConfiguration().getAllowedFileExtensions() ); - } - - /** - * {@inheritDoc} - */ - public List getFileUploads(HttpServletRequest request) throws ValidationException { - return getFileUploads(request, ESAPI.securityConfiguration().getUploadDirectory(), ESAPI.securityConfiguration().getAllowedFileExtensions()); - } - - /** - * {@inheritDoc} - */ - public List getFileUploads(HttpServletRequest request, File finalDir ) throws ValidationException { - return getFileUploads(request, finalDir, ESAPI.securityConfiguration().getAllowedFileExtensions()); - } - - /** - * {@inheritDoc} - */ - public List getFileUploads(HttpServletRequest request, File finalDir, List allowedExtensions) throws ValidationException { - File tempDir = ESAPI.securityConfiguration().getUploadTempDirectory(); - if ( !tempDir.exists() ) { - if ( !tempDir.mkdirs() ) throw new ValidationUploadException( "Upload failed", "Could not create temp directory: " + tempDir.getAbsolutePath() ); - } - - if( finalDir != null){ - if ( !finalDir.exists() ) { - if ( !finalDir.mkdirs() ) throw new ValidationUploadException( "Upload failed", "Could not create final upload directory: " + finalDir.getAbsolutePath() ); - } - } - else { - if ( !ESAPI.securityConfiguration().getUploadDirectory().exists()) { - if ( !ESAPI.securityConfiguration().getUploadDirectory().mkdirs() ) throw new ValidationUploadException( "Upload failed", "Could not create final upload directory: " + ESAPI.securityConfiguration().getUploadDirectory().getAbsolutePath() ); - } - finalDir = ESAPI.securityConfiguration().getUploadDirectory(); - } - - List newFiles = new ArrayList(); - try { - final HttpSession session = request.getSession(false); - if (!ServletFileUpload.isMultipartContent(request)) { - throw new ValidationUploadException("Upload failed", "Not a multipart request"); - } - - // this factory will store ALL files in the temp directory, - // regardless of size - DiskFileItemFactory factory = new DiskFileItemFactory(0, tempDir); - ServletFileUpload upload = new ServletFileUpload(factory); - upload.setSizeMax(maxBytes); - - // Create a progress listener - ProgressListener progressListener = new ProgressListener() { - private long megaBytes = -1; - private long progress = 0; - - public void update(long pBytesRead, long pContentLength, int pItems) { - if (pItems == 0) - return; - long mBytes = pBytesRead / 1000000; - if (megaBytes == mBytes) - return; - megaBytes = mBytes; - progress = (long) (((double) pBytesRead / (double) pContentLength) * 100); - if ( session != null ) { - session.setAttribute("progress", Long.toString(progress)); - } - // logger.logSuccess(Logger.SECURITY, " Item " + pItems + " (" + progress + "% of " + pContentLength + " bytes]"); - } - }; - upload.setProgressListener(progressListener); - - List items = upload.parseRequest(request); - for (FileItem item : items) - { - if (!item.isFormField() && item.getName() != null && !(item.getName().equals(""))) - { - String[] fparts = item.getName().split("[\\/\\\\]"); - String filename = fparts[fparts.length - 1]; - - if (!ESAPI.validator().isValidFileName("upload", filename, allowedExtensions, false)) - { - throw new ValidationUploadException("Upload only simple filenames with the following extensions " + allowedExtensions, "Upload failed isValidFileName check"); - } - - logger.info(Logger.SECURITY_SUCCESS, "File upload requested: " + filename); - File f = new File(finalDir, filename); - if (f.exists()) - { - String[] parts = filename.split("\\/."); - String extension = ""; - if (parts.length > 1) - { - extension = parts[parts.length - 1]; - } - String filenm = filename.substring(0, filename.length() - extension.length()); - f = File.createTempFile(filenm, "." + extension, finalDir); - } - item.write(f); - newFiles.add(f); - // delete temporary file - item.delete(); - logger.fatal(Logger.SECURITY_SUCCESS, "File successfully uploaded: " + f); - if (session != null) - { - session.setAttribute("progress", Long.toString(0)); - } - } - } - } catch (Exception e) { - if (e instanceof ValidationUploadException) { - throw (ValidationException)e; - } - throw new ValidationUploadException("Upload failure", "Problem during upload:" + e.getMessage(), e); - } - return Collections.synchronizedList(newFiles); - } - - - - /** - * Utility to return the first cookie matching the provided name. - * @param request - * @param name - */ - private Cookie getFirstCookie(HttpServletRequest request, String name) { - Cookie[] cookies = request.getCookies(); - if (cookies != null) { - for (Cookie cookie : cookies) - { - if (cookie.getName().equals(name)) - { - return cookie; - } - } - } - return null; - } - - /** - * {@inheritDoc} - */ - public String getHeader( HttpServletRequest request, String name ) throws ValidationException { - String value = request.getHeader(name); - return ESAPI.validator().getValidInput("HTTP header value: " + value, value, "HTTPHeaderValue", 150, false); - } - - - /** - * {@inheritDoc} - */ - public String getHeader( String name ) throws ValidationException { - return getHeader( getCurrentRequest(), name ); - } - - - /** - * {@inheritDoc} - */ - public String getParameter( HttpServletRequest request, String name ) throws ValidationException { - String value = request.getParameter(name); - return ESAPI.validator().getValidInput("HTTP parameter value: " + value, value, "HTTPParameterValue", 2000, true); - } - - /** - * {@inheritDoc} - */ - public String getParameter( String name ) throws ValidationException { - return getParameter( getCurrentRequest(), name ); - } - - /** - * {@inheritDoc} - */ - public void killAllCookies() { - killAllCookies( getCurrentRequest(), getCurrentResponse() ); - } - - /** - * {@inheritDoc} - * - * @param request - * @param response - */ - public void killAllCookies(HttpServletRequest request, HttpServletResponse response) { - Cookie[] cookies = request.getCookies(); - if (cookies != null) { - for (Cookie cookie : cookies) - { - killCookie(request, response, cookie.getName()); - } - } - } - - - /** - * {@inheritDoc} - * - * @param request - * @param response - * @param name - */ - public void killCookie(HttpServletRequest request, HttpServletResponse response, String name) { - String path = "//"; - String domain=""; - Cookie cookie = getFirstCookie(request, name); - if ( cookie != null ) { - path = cookie.getPath(); - domain = cookie.getDomain(); - } - Cookie deleter = new Cookie( name, "deleted" ); - deleter.setMaxAge( 0 ); - if ( domain != null ) deleter.setDomain( domain ); - if ( path != null ) deleter.setPath( path ); - response.addCookie( deleter ); - } - - - /** - * {@inheritDoc} - */ - public void killCookie( String name ) { - killCookie( getCurrentRequest(), getCurrentResponse(), name ); - } - - - /** - * {@inheritDoc} - */ - public void logHTTPRequest() { - logHTTPRequest( getCurrentRequest(), logger, null ); - } - - /** - * {@inheritDoc} - */ - public void logHTTPRequest(HttpServletRequest request, Logger logger) { - logHTTPRequest( request, logger, null ); - } - - /** - * Formats an HTTP request into a log suitable string. This implementation logs the remote host IP address (or - * hostname if available), the request method (GET/POST), the URL, and all the querystring and form parameters. All - * the parameters are presented as though they were in the URL even if they were in a form. Any parameters that - * match items in the parameterNamesToObfuscate are shown as eight asterisks. - * - * - * @param request - */ - public void logHTTPRequest(HttpServletRequest request, Logger logger, List parameterNamesToObfuscate) { - StringBuilder params = new StringBuilder(); - Iterator i = request.getParameterMap().keySet().iterator(); - while (i.hasNext()) { - String key = (String) i.next(); - String[] value = (String[]) request.getParameterMap().get(key); - for (int j = 0; j < value.length; j++) { - params.append(key).append("="); - if (parameterNamesToObfuscate != null && parameterNamesToObfuscate.contains(key)) { - params.append("********"); - } else { - params.append(value[j]); - } - if (j < value.length - 1) { - params.append("&"); - } - } - if (i.hasNext()) - params.append("&"); - } - Cookie[] cookies = request.getCookies(); - if ( cookies != null ) { - for (Cookie cooky : cookies) - { - if (!cooky.getName().equals(ESAPI.securityConfiguration().getHttpSessionIdName())) - { - params.append("+").append(cooky.getName()).append("=").append(cooky.getValue()); - } - } - } - String msg = request.getMethod() + " " + request.getRequestURL() + (params.length() > 0 ? "?" + params : ""); - logger.info(Logger.SECURITY_SUCCESS, msg); - } - - private Map queryToMap(String query) { - TreeMap map = new TreeMap(); - String[] parts = query.split("&"); - for (String part : parts) - { - try - { - String[] nvpair = part.split("="); - String name = ESAPI.encoder().decodeFromURL(nvpair[0]); - String value = ESAPI.encoder().decodeFromURL(nvpair[1]); - map.put(name, value); - } - catch (EncodingException e) - { - // skip the nvpair with the encoding problem - note this is already logged. - } - } - return map; - } - - /** - * {@inheritDoc} - * - * This implementation simply checks to make sure that the forward location starts with "WEB-INF" and - * is intended for use in frameworks that forward to JSP files inside the WEB-INF folder. - */ - public void sendForward(HttpServletRequest request, HttpServletResponse response, String location) throws AccessControlException,ServletException,IOException { - if (!location.startsWith("WEB-INF")) { - throw new AccessControlException("Forward failed", "Bad forward location: " + location); - } - RequestDispatcher dispatcher = request.getRequestDispatcher(location); - dispatcher.forward( request, response ); - } - - /** - * {@inheritDoc} - */ - public void sendForward( String location ) throws AccessControlException,ServletException,IOException { - sendForward( getCurrentRequest(), getCurrentResponse(), location); - } - - /** - * {@inheritDoc} - * - * This implementation checks against the list of safe redirect locations defined in ESAPI.properties. - * - * @param response - */ - public void sendRedirect(HttpServletResponse response, String location) throws AccessControlException, IOException { - if (!ESAPI.validator().isValidRedirectLocation("Redirect", location, false)) { - logger.fatal(Logger.SECURITY_FAILURE, "Bad redirect location: " + location); - throw new AccessControlException("Redirect failed"); - } - response.sendRedirect(location); - } - - /** - * {@inheritDoc} - */ - public void sendRedirect( String location ) throws AccessControlException,IOException { - sendRedirect( getCurrentResponse(), location); - } - - /** - * {@inheritDoc} - */ - public void setContentType() { - setContentType( getCurrentResponse() ); - } - - - /** - * {@inheritDoc} - */ - public void setContentType(HttpServletResponse response) { - response.setContentType((ESAPI.securityConfiguration()).getResponseContentType()); - } - - /** - * {@inheritDoc} - */ - public void setCurrentHTTP(HttpServletRequest request, HttpServletResponse response) { - currentRequest.setRequest(request); - currentResponse.setResponse(response); - } - - /** - * {@inheritDoc} - */ - public void setHeader(HttpServletResponse response, String name, String value) { - try { - String strippedName = StringUtilities.replaceLinearWhiteSpace(name); - String strippedValue = StringUtilities.replaceLinearWhiteSpace(value); - String safeName = ESAPI.validator().getValidInput("setHeader", strippedName, "HTTPHeaderName", 20, false); - String safeValue = ESAPI.validator().getValidInput("setHeader", strippedValue, "HTTPHeaderValue", 500, false); - response.setHeader(safeName, safeValue); - } catch (ValidationException e) { - logger.warning(Logger.SECURITY_FAILURE, "Attempt to set invalid header denied", e); - } - } - - - /** - * {@inheritDoc} - */ - public void setHeader( String name, String value ) { - setHeader( getCurrentResponse(), name, value ); - } - - - /** - * {@inheritDoc} - */ - public void setNoCacheHeaders() { - setNoCacheHeaders( getCurrentResponse() ); - } - - /** - * {@inheritDoc} - * - * @param response - */ - public void setNoCacheHeaders(HttpServletResponse response) { - // HTTP 1.1 - response.setHeader("Cache-Control", "no-store, no-cache, must-revalidate"); - - // HTTP 1.0 - response.setHeader("Pragma","no-cache"); - response.setDateHeader("Expires", -1); - } - - /** - * {@inheritDoc} - * - * Save the user's remember me data in an encrypted cookie and send it to the user. - * Any old remember me cookie is destroyed first. Setting this cookie will keep the user - * logged in until the maxAge passes, the password is changed, or the cookie is deleted. - * If the cookie exists for the current user, it will automatically be used by ESAPI to - * log the user in, if the data is valid and not expired. - * - * @param request - * @param response - */ - public String setRememberToken( HttpServletRequest request, HttpServletResponse response, String password, int maxAge, String domain, String path ) { - User user = ESAPI.authenticator().getCurrentUser(); - try { - killCookie(request, response, REMEMBER_TOKEN_COOKIE_NAME ); - // seal already contains random data - String clearToken = user.getAccountName() + "|" + password; - long expiry = ESAPI.encryptor().getRelativeTimeStamp(maxAge * 1000); - String cryptToken = ESAPI.encryptor().seal(clearToken, expiry); - - // Do NOT URLEncode cryptToken before creating cookie. See Google Issue # 144, - // which was marked as "WontFix". - - Cookie cookie = new Cookie( REMEMBER_TOKEN_COOKIE_NAME, cryptToken ); - cookie.setMaxAge( maxAge ); - cookie.setDomain( domain ); - cookie.setPath( path ); - response.addCookie( cookie ); - logger.info(Logger.SECURITY_SUCCESS, "Enabled remember me token for " + user.getAccountName() ); - return cryptToken; - } catch( IntegrityException e ) { - logger.warning(Logger.SECURITY_FAILURE, "Attempt to set remember me token failed for " + user.getAccountName(), e ); - return null; - } - } - - /** - * {@inheritDoc} - */ - public String setRememberToken( String password, int maxAge, String domain, String path ) { - return setRememberToken( getCurrentRequest(), getCurrentResponse(), password, maxAge, domain, path ); - } - - - /** - * {@inheritDoc} - */ - public void verifyCSRFToken() throws IntrusionException { - verifyCSRFToken( getCurrentRequest() ); - } - - /** - * {@inheritDoc} - * - * This implementation uses the CSRF_TOKEN_NAME parameter for the token. - * - * @param request - */ - public void verifyCSRFToken(HttpServletRequest request) throws IntrusionException { - User user = ESAPI.authenticator().getCurrentUser(); - - // check if user authenticated with this request - no CSRF protection required - if( request.getAttribute(user.getCSRFToken()) != null ) { - return; - } - String token = request.getParameter(CSRF_TOKEN_NAME); - if ( !user.getCSRFToken().equals( token ) ) { - throw new IntrusionException("Authentication failed", "Possibly forged HTTP request without proper CSRF token detected"); - } - } - - /** - * {@inheritDoc} - */ - public T getSessionAttribute( String key ) { - final HttpSession session = ESAPI.currentRequest().getSession(false); - if ( session != null ) - return (T) session.getAttribute(key); - return null; - } - - /** - * {@inheritDoc} - */ - public T getSessionAttribute(HttpSession session, String key) - { - return (T) session.getAttribute(key); - } - - /** - * {@inheritDoc} - */ - public T getRequestAttribute(String key) - { - return (T) ESAPI.currentRequest().getAttribute(key); - } - - /** - * {@inheritDoc} - */ - public T getRequestAttribute(HttpServletRequest request, String key) - { - return (T) request.getAttribute( key ); - } - - ///////////////////// - - /* Helper method to encrypt using new Encryptor encryption methods and - * return the serialized ciphertext as a hex-encoded string. - */ - private String encryptString(String plaintext) throws EncryptionException { - PlainText pt = new PlainText(plaintext); - CipherText ct = ESAPI.encryptor().encrypt(pt); - byte[] serializedCiphertext = ct.asPortableSerializedByteArray(); - return Hex.encode(serializedCiphertext, false); - } - - /* Helper method to decrypt a hex-encode serialized ciphertext string and - * to decrypt it using the new Encryptor decryption methods. - */ - private String decryptString(String ciphertext) throws EncryptionException { - byte[] serializedCiphertext = Hex.decode(ciphertext); - CipherText restoredCipherText = - CipherText.fromPortableSerializedBytes(serializedCiphertext); - PlainText plaintext = ESAPI.encryptor().decrypt(restoredCipherText); - return plaintext.toString(); - } -} +/** + * OWASP Enterprise Security API (ESAPI) + * + * This file is part of the Open Web Application Security Project (OWASP) + * Enterprise Security API (ESAPI) project. For details, please see + * http://www.owasp.org/index.php/ESAPI. + * + * Copyright (c) 2007 - The OWASP Foundation + * + * The ESAPI is published by OWASP under the BSD license. You should read and accept the + * LICENSE before you use, modify, and/or redistribute this software. + * + * @author Jeff Williams Aspect Security + * @created 2007 + */ +package org.owasp.esapi.reference; + +import org.apache.commons.fileupload.FileItem; +import org.apache.commons.fileupload.ProgressListener; +import org.apache.commons.fileupload.disk.DiskFileItemFactory; +import org.apache.commons.fileupload.servlet.ServletFileUpload; +import org.owasp.esapi.*; +import org.owasp.esapi.codecs.Hex; +import org.owasp.esapi.crypto.CipherText; +import org.owasp.esapi.crypto.PlainText; +import org.owasp.esapi.errors.*; + +import javax.servlet.RequestDispatcher; +import javax.servlet.ServletException; +import javax.servlet.http.Cookie; +import javax.servlet.http.HttpServletRequest; +import javax.servlet.http.HttpServletResponse; +import javax.servlet.http.HttpSession; +import java.io.File; +import java.io.IOException; +import java.util.*; +import java.util.concurrent.ConcurrentHashMap; + +/** + * Reference implementation of the HTTPUtilities interface. This implementation + * uses the Apache Commons FileUploader library, which in turn uses the Apache + * Commons IO library. + *

+ * To simplify the interface, some methods use the current request and response that + * are tracked by ThreadLocal variables in the Authenticator. This means that you + * must have called ESAPI.authenticator().setCurrentHTTP(request, response) before + * calling these methods. + *

+ * Typically, this is done by calling the Authenticator.login() method, which + * calls setCurrentHTTP() automatically. However if you want to use these methods + * in another application, you should explicitly call setCurrentHTTP() in your + * own code. In either case, you *must* call ESAPI.clearCurrent() to clear threadlocal + * variables before the thread is reused. The advantages of having identity everywhere + * outweigh the disadvantages of this approach. + * + * @author Jeff Williams (jeff.williams .at. aspectsecurity.com) Aspect Security + * @since June 1, 2007 + * @see org.owasp.esapi.HTTPUtilities + */ +public class DefaultHTTPUtilities implements org.owasp.esapi.HTTPUtilities { + private static volatile HTTPUtilities instance = null; + + public static HTTPUtilities getInstance() { + if ( instance == null ) { + synchronized ( DefaultHTTPUtilities.class ) { + if ( instance == null ) { + instance = new DefaultHTTPUtilities(); + } + } + } + return instance; + } + + /** + * Defines the ThreadLocalRequest to store the current request for this thread. + */ + private class ThreadLocalRequest extends InheritableThreadLocal { + + public HttpServletRequest getRequest() { + return super.get(); + } + + public HttpServletRequest initialValue() { + return null; + } + + public void setRequest(HttpServletRequest newRequest) { + super.set(newRequest); + } + } + + /** + * Defines the ThreadLocalResponse to store the current response for this thread. + */ + private class ThreadLocalResponse extends InheritableThreadLocal { + + public HttpServletResponse getResponse() { + return super.get(); + } + + public HttpServletResponse initialValue() { + return null; + } + + public void setResponse(HttpServletResponse newResponse) { + super.set(newResponse); + } + } + + /** The logger. */ + private final Logger logger = ESAPI.getLogger("HTTPUtilities"); + + /** The max bytes. */ + static final int maxBytes = ESAPI.securityConfiguration().getAllowedFileUploadSize(); + + + /* + * The currentRequest ThreadLocal variable is used to make the currentRequest available to any call in any part of an + * application. This enables API's for actions that require the request to be much simpler. For example, the logout() + * method in the Authenticator class requires the currentRequest to get the session in order to invalidate it. + */ + private ThreadLocalRequest currentRequest = new ThreadLocalRequest(); + + /* + * The currentResponse ThreadLocal variable is used to make the currentResponse available to any call in any part of an + * application. This enables API's for actions that require the response to be much simpler. For example, the logout() + * method in the Authenticator class requires the currentResponse to kill the Session ID cookie. + */ + private ThreadLocalResponse currentResponse = new ThreadLocalResponse(); + + + + /** + * No arg constructor. + */ + public DefaultHTTPUtilities() { + } + + + /** + * {@inheritDoc} + * This implementation uses a custom "set-cookie" header rather than Java's + * cookie interface which doesn't allow the use of HttpOnly. Configure the + * HttpOnly and Secure settings in ESAPI.properties. + */ + public void addCookie( Cookie cookie ) { + addCookie( getCurrentResponse(), cookie ); + } + + /** + * {@inheritDoc} + * This implementation uses a custom "set-cookie" header rather than Java's + * cookie interface which doesn't allow the use of HttpOnly. Configure the + * HttpOnly and Secure settings in ESAPI.properties. + */ + public void addCookie(HttpServletResponse response, Cookie cookie) { + String name = cookie.getName(); + String value = cookie.getValue(); + int maxAge = cookie.getMaxAge(); + String domain = cookie.getDomain(); + String path = cookie.getPath(); + boolean secure = cookie.getSecure(); + + // validate the name and value + ValidationErrorList errors = new ValidationErrorList(); + String cookieName = ESAPI.validator().getValidInput("cookie name", name, "HTTPCookieName", 50, false, errors); + String cookieValue = ESAPI.validator().getValidInput("cookie value", value, "HTTPCookieValue", 5000, false, errors); + + // if there are no errors, then set the cookie either with a header or normally + if (errors.size() == 0) { + if ( ESAPI.securityConfiguration().getForceHttpOnlyCookies() ) { + String header = createCookieHeader(cookieName, cookieValue, maxAge, domain, path, secure); + addHeader(response, "Set-Cookie", header); + } else { + // Issue 23 - If the ESAPI Configuration is set to force secure cookies, force the secure flag on the cookie before setting it + cookie.setSecure( secure || ESAPI.securityConfiguration().getForceSecureCookies() ); + response.addCookie(cookie); + } + return; + } + logger.warning(Logger.SECURITY_FAILURE, "Attempt to add unsafe data to cookie (skip mode). Skipping cookie and continuing."); + } + + + + /** + * {@inheritDoc} + */ + public String addCSRFToken(String href) { + User user = ESAPI.authenticator().getCurrentUser(); + if (user.isAnonymous()) { + return href; + } + + // if there are already parameters append with &, otherwise append with ? + String token = CSRF_TOKEN_NAME + "=" + user.getCSRFToken(); + return href.indexOf( '?') != -1 ? href + "&" + token : href + "?" + token; + } + + /** + * {@inheritDoc} + */ + public void addHeader(String name, String value) { + addHeader( getCurrentResponse(), name, value ); + } + + /** + * {@inheritDoc} + */ + public void addHeader(HttpServletResponse response, String name, String value) { + try { + String strippedName = StringUtilities.replaceLinearWhiteSpace(name); + String strippedValue = StringUtilities.replaceLinearWhiteSpace(value); + String safeName = ESAPI.validator().getValidInput("addHeader", strippedName, "HTTPHeaderName", 20, false); + String safeValue = ESAPI.validator().getValidInput("addHeader", strippedValue, "HTTPHeaderValue", 500, false); + response.addHeader(safeName, safeValue); + } catch (ValidationException e) { + logger.warning(Logger.SECURITY_FAILURE, "Attempt to add invalid header denied", e); + } + } + + /** + * {@inheritDoc} + */ + public void assertSecureChannel() throws AccessControlException { + assertSecureChannel( getCurrentRequest() ); + } + + /** + * {@inheritDoc} + * + * This implementation ignores the built-in isSecure() method + * and uses the URL to determine if the request was transmitted over SSL. + * This is because SSL may have been terminated somewhere outside the + * container. + */ + public void assertSecureChannel(HttpServletRequest request) throws AccessControlException { + if ( request == null ) { + throw new AccessControlException( "Insecure request received", "HTTP request was null" ); + } + StringBuffer sb = request.getRequestURL(); + if ( sb == null ) { + throw new AccessControlException( "Insecure request received", "HTTP request URL was null" ); + } + String url = sb.toString(); + if ( !url.startsWith( "https" ) ) { + throw new AccessControlException( "Insecure request received", "HTTP request did not use SSL" ); + } + } + + /** + * {@inheritDoc} + */ + public void assertSecureRequest() throws AccessControlException { + assertSecureRequest( getCurrentRequest() ); + } + + /** + * {@inheritDoc} + */ + public void assertSecureRequest(HttpServletRequest request) throws AccessControlException { + assertSecureChannel( request ); + String receivedMethod = request.getMethod(); + String requiredMethod = "POST"; + if ( !receivedMethod.equals( requiredMethod ) ) { + throw new AccessControlException( "Insecure request received", "Received request using " + receivedMethod + " when only " + requiredMethod + " is allowed" ); + } + } + + /** + * {@inheritDoc} + */ + public HttpSession changeSessionIdentifier() throws AuthenticationException { + return changeSessionIdentifier( getCurrentRequest() ); + } + + /** + * {@inheritDoc} + */ + public HttpSession changeSessionIdentifier(HttpServletRequest request) throws AuthenticationException { + + // get the current session + HttpSession oldSession = request.getSession(); + + // make a copy of the session content + Map temp = new ConcurrentHashMap(); + Enumeration e = oldSession.getAttributeNames(); + while (e != null && e.hasMoreElements()) { + String name = (String) e.nextElement(); + Object value = oldSession.getAttribute(name); + temp.put(name, value); + } + + // kill the old session and create a new one + oldSession.invalidate(); + HttpSession newSession = request.getSession(); + User user = ESAPI.authenticator().getCurrentUser(); + user.addSession( newSession ); + user.removeSession( oldSession ); + + // copy back the session content + for (Map.Entry stringObjectEntry : temp.entrySet()) + { + newSession.setAttribute(stringObjectEntry.getKey(), stringObjectEntry.getValue()); + } + return newSession; + } + + /** + * {@inheritDoc} + */ + public void clearCurrent() { + currentRequest.set(null); + currentResponse.set(null); + } + + private String createCookieHeader(String name, String value, int maxAge, String domain, String path, boolean secure) { + // create the special cookie header instead of creating a Java cookie + // Set-Cookie:=[; =][; expires=][; + // domain=][; path=][; secure][;HttpOnly] + String header = name + "=" + value; + header += "; Max-Age=" + maxAge; + if (domain != null) { + header += "; Domain=" + domain; + } + if (path != null) { + header += "; Path=" + path; + } + if ( secure || ESAPI.securityConfiguration().getForceSecureCookies() ) { + header += "; Secure"; + } + if ( ESAPI.securityConfiguration().getForceHttpOnlyCookies() ) { + header += "; HttpOnly"; + } + return header; + } + + /** + * {@inheritDoc} + */ + public String decryptHiddenField(String encrypted) { + try { + return decryptString(encrypted); + } catch( EncryptionException e ) { + throw new IntrusionException("Invalid request","Tampering detected. Hidden field data did not decrypt properly.", e); + } + } + + /** + * {@inheritDoc} + */ + public Map decryptQueryString(String encrypted) throws EncryptionException { + String plaintext = decryptString(encrypted); + return queryToMap(plaintext); + } + + /** + * {@inheritDoc} + */ + public Map decryptStateFromCookie() throws EncryptionException { + return decryptStateFromCookie( getCurrentRequest() ); + } + + /** + * {@inheritDoc} + * + * @param request + */ + public Map decryptStateFromCookie(HttpServletRequest request) throws EncryptionException { + try { + String encrypted = getCookie( request, ESAPI_STATE ); + if ( encrypted == null ) return new HashMap(); + String plaintext = decryptString(encrypted); + return queryToMap( plaintext ); + } catch( ValidationException e ) { + return null; + } + } + + /** + * {@inheritDoc} + */ + public String encryptHiddenField(String value) throws EncryptionException { + return encryptString(value); + } + + /** + * {@inheritDoc} + */ + public String encryptQueryString(String query) throws EncryptionException { + return encryptString(query); + } + + /** + * {@inheritDoc} + */ + public void encryptStateInCookie(HttpServletResponse response, Map cleartext) throws EncryptionException { + StringBuilder sb = new StringBuilder(); + Iterator i = cleartext.entrySet().iterator(); + while ( i.hasNext() ) { + try { + Map.Entry entry = (Map.Entry)i.next(); + + // What do these need to be URL encoded? They are encrypted! + String name = ESAPI.encoder().encodeForURL( entry.getKey().toString() ); + String value = ESAPI.encoder().encodeForURL( entry.getValue().toString() ); + sb.append(name).append("=").append(value); + if ( i.hasNext() ) sb.append( "&" ); + } catch( EncodingException e ) { + logger.error(Logger.SECURITY_FAILURE, "Problem encrypting state in cookie - skipping entry", e ); + } + } + + String encrypted = encryptString(sb.toString()); + + if ( encrypted.length() > (MAX_COOKIE_LEN ) ) { + logger.error(Logger.SECURITY_FAILURE, "Problem encrypting state in cookie - skipping entry"); + throw new EncryptionException("Encryption failure", "Encrypted cookie state of " + encrypted.length() + " longer than allowed " + MAX_COOKIE_LEN ); + } + + Cookie cookie = new Cookie( ESAPI_STATE, encrypted ); + addCookie( response, cookie ); + } + + /** + * {@inheritDoc} + */ + public void encryptStateInCookie( Map cleartext ) throws EncryptionException { + encryptStateInCookie( getCurrentResponse(), cleartext ); + } + + + /** + * {@inheritDoc} + */ + public String getCookie( HttpServletRequest request, String name ) throws ValidationException { + Cookie c = getFirstCookie( request, name ); + if ( c == null ) return null; + String value = c.getValue(); + return ESAPI.validator().getValidInput("HTTP cookie value: " + value, value, "HTTPCookieValue", 1000, false); + } + + /** + * {@inheritDoc} + */ + public String getCookie( String name ) throws ValidationException { + return getCookie( getCurrentRequest(), name ); + } + + /** + * {@inheritDoc} + */ + public String getCSRFToken() { + User user = ESAPI.authenticator().getCurrentUser(); + if (user == null) return null; + return user.getCSRFToken(); + } + + + /** + * {@inheritDoc} + */ + public HttpServletRequest getCurrentRequest() { + return currentRequest.getRequest(); + } + + + /** + * {@inheritDoc} + */ + public HttpServletResponse getCurrentResponse() { + return currentResponse.getResponse(); + } + + /** + * {@inheritDoc} + */ + public List getFileUploads() throws ValidationException { + return getFileUploads( getCurrentRequest(), ESAPI.securityConfiguration().getUploadDirectory(), ESAPI.securityConfiguration().getAllowedFileExtensions() ); + } + + /** + * {@inheritDoc} + */ + public List getFileUploads(HttpServletRequest request) throws ValidationException { + return getFileUploads(request, ESAPI.securityConfiguration().getUploadDirectory(), ESAPI.securityConfiguration().getAllowedFileExtensions()); + } + + /** + * {@inheritDoc} + */ + public List getFileUploads(HttpServletRequest request, File finalDir ) throws ValidationException { + return getFileUploads(request, finalDir, ESAPI.securityConfiguration().getAllowedFileExtensions()); + } + + /** + * {@inheritDoc} + */ + public List getFileUploads(HttpServletRequest request, File finalDir, List allowedExtensions) throws ValidationException { + File tempDir = ESAPI.securityConfiguration().getUploadTempDirectory(); + if ( !tempDir.exists() ) { + if ( !tempDir.mkdirs() ) throw new ValidationUploadException( "Upload failed", "Could not create temp directory: " + tempDir.getAbsolutePath() ); + } + + if( finalDir != null){ + if ( !finalDir.exists() ) { + if ( !finalDir.mkdirs() ) throw new ValidationUploadException( "Upload failed", "Could not create final upload directory: " + finalDir.getAbsolutePath() ); + } + } + else { + if ( !ESAPI.securityConfiguration().getUploadDirectory().exists()) { + if ( !ESAPI.securityConfiguration().getUploadDirectory().mkdirs() ) throw new ValidationUploadException( "Upload failed", "Could not create final upload directory: " + ESAPI.securityConfiguration().getUploadDirectory().getAbsolutePath() ); + } + finalDir = ESAPI.securityConfiguration().getUploadDirectory(); + } + + List newFiles = new ArrayList(); + try { + final HttpSession session = request.getSession(false); + if (!ServletFileUpload.isMultipartContent(request)) { + throw new ValidationUploadException("Upload failed", "Not a multipart request"); + } + + // this factory will store ALL files in the temp directory, + // regardless of size + DiskFileItemFactory factory = new DiskFileItemFactory(0, tempDir); + ServletFileUpload upload = new ServletFileUpload(factory); + upload.setSizeMax(maxBytes); + + // Create a progress listener + ProgressListener progressListener = new ProgressListener() { + private long megaBytes = -1; + private long progress = 0; + + public void update(long pBytesRead, long pContentLength, int pItems) { + if (pItems == 0) + return; + long mBytes = pBytesRead / 1000000; + if (megaBytes == mBytes) + return; + megaBytes = mBytes; + progress = (long) (((double) pBytesRead / (double) pContentLength) * 100); + if ( session != null ) { + session.setAttribute("progress", Long.toString(progress)); + } + // logger.logSuccess(Logger.SECURITY, " Item " + pItems + " (" + progress + "% of " + pContentLength + " bytes]"); + } + }; + upload.setProgressListener(progressListener); + + List items = upload.parseRequest(request); + for (FileItem item : items) + { + if (!item.isFormField() && item.getName() != null && !(item.getName().equals(""))) + { + String[] fparts = item.getName().split("[\\/\\\\]"); + String filename = fparts[fparts.length - 1]; + + if (!ESAPI.validator().isValidFileName("upload", filename, allowedExtensions, false)) + { + throw new ValidationUploadException("Upload only simple filenames with the following extensions " + allowedExtensions, "Upload failed isValidFileName check"); + } + + logger.info(Logger.SECURITY_SUCCESS, "File upload requested: " + filename); + File f = new File(finalDir, filename); + if (f.exists()) + { + String[] parts = filename.split("\\/."); + String extension = ""; + if (parts.length > 1) + { + extension = parts[parts.length - 1]; + } + String filenm = filename.substring(0, filename.length() - extension.length()); + f = File.createTempFile(filenm, "." + extension, finalDir); + } + item.write(f); + newFiles.add(f); + // delete temporary file + item.delete(); + logger.fatal(Logger.SECURITY_SUCCESS, "File successfully uploaded: " + f); + if (session != null) + { + session.setAttribute("progress", Long.toString(0)); + } + } + } + } catch (Exception e) { + if (e instanceof ValidationUploadException) { + throw (ValidationException)e; + } + throw new ValidationUploadException("Upload failure", "Problem during upload:" + e.getMessage(), e); + } + return Collections.synchronizedList(newFiles); + } + + + + /** + * Utility to return the first cookie matching the provided name. + * @param request + * @param name + */ + private Cookie getFirstCookie(HttpServletRequest request, String name) { + Cookie[] cookies = request.getCookies(); + if (cookies != null) { + for (Cookie cookie : cookies) + { + if (cookie.getName().equals(name)) + { + return cookie; + } + } + } + return null; + } + + /** + * {@inheritDoc} + */ + public String getHeader( HttpServletRequest request, String name ) throws ValidationException { + String value = request.getHeader(name); + return ESAPI.validator().getValidInput("HTTP header value: " + value, value, "HTTPHeaderValue", 150, false); + } + + + /** + * {@inheritDoc} + */ + public String getHeader( String name ) throws ValidationException { + return getHeader( getCurrentRequest(), name ); + } + + + /** + * {@inheritDoc} + */ + public String getParameter( HttpServletRequest request, String name ) throws ValidationException { + String value = request.getParameter(name); + return ESAPI.validator().getValidInput("HTTP parameter value: " + value, value, "HTTPParameterValue", 2000, true); + } + + /** + * {@inheritDoc} + */ + public String getParameter( String name ) throws ValidationException { + return getParameter( getCurrentRequest(), name ); + } + + /** + * {@inheritDoc} + */ + public void killAllCookies() { + killAllCookies( getCurrentRequest(), getCurrentResponse() ); + } + + /** + * {@inheritDoc} + * + * @param request + * @param response + */ + public void killAllCookies(HttpServletRequest request, HttpServletResponse response) { + Cookie[] cookies = request.getCookies(); + if (cookies != null) { + for (Cookie cookie : cookies) + { + killCookie(request, response, cookie.getName()); + } + } + } + + + /** + * {@inheritDoc} + * + * @param request + * @param response + * @param name + */ + public void killCookie(HttpServletRequest request, HttpServletResponse response, String name) { + String path = "//"; + String domain=""; + Cookie cookie = getFirstCookie(request, name); + if ( cookie != null ) { + path = cookie.getPath(); + domain = cookie.getDomain(); + } + Cookie deleter = new Cookie( name, "deleted" ); + deleter.setMaxAge( 0 ); + if ( domain != null ) deleter.setDomain( domain ); + if ( path != null ) deleter.setPath( path ); + response.addCookie( deleter ); + } + + + /** + * {@inheritDoc} + */ + public void killCookie( String name ) { + killCookie( getCurrentRequest(), getCurrentResponse(), name ); + } + + + /** + * {@inheritDoc} + */ + public void logHTTPRequest() { + logHTTPRequest( getCurrentRequest(), logger, null ); + } + + /** + * {@inheritDoc} + */ + public void logHTTPRequest(HttpServletRequest request, Logger logger) { + logHTTPRequest( request, logger, null ); + } + + /** + * Formats an HTTP request into a log suitable string. This implementation logs the remote host IP address (or + * hostname if available), the request method (GET/POST), the URL, and all the querystring and form parameters. All + * the parameters are presented as though they were in the URL even if they were in a form. Any parameters that + * match items in the parameterNamesToObfuscate are shown as eight asterisks. + * + * + * @param request + */ + public void logHTTPRequest(HttpServletRequest request, Logger logger, List parameterNamesToObfuscate) { + StringBuilder params = new StringBuilder(); + Iterator i = request.getParameterMap().keySet().iterator(); + while (i.hasNext()) { + String key = (String) i.next(); + String[] value = (String[]) request.getParameterMap().get(key); + for (int j = 0; j < value.length; j++) { + params.append(key).append("="); + if (parameterNamesToObfuscate != null && parameterNamesToObfuscate.contains(key)) { + params.append("********"); + } else { + params.append(value[j]); + } + if (j < value.length - 1) { + params.append("&"); + } + } + if (i.hasNext()) + params.append("&"); + } + Cookie[] cookies = request.getCookies(); + if ( cookies != null ) { + for (Cookie cooky : cookies) + { + if (!cooky.getName().equals(ESAPI.securityConfiguration().getHttpSessionIdName())) + { + params.append("+").append(cooky.getName()).append("=").append(cooky.getValue()); + } + } + } + String msg = request.getMethod() + " " + request.getRequestURL() + (params.length() > 0 ? "?" + params : ""); + logger.info(Logger.SECURITY_SUCCESS, msg); + } + + private Map queryToMap(String query) { + TreeMap map = new TreeMap(); + String[] parts = query.split("&"); + for (String part : parts) + { + try + { + String[] nvpair = part.split("="); + String name = ESAPI.encoder().decodeFromURL(nvpair[0]); + String value = ESAPI.encoder().decodeFromURL(nvpair[1]); + map.put(name, value); + } + catch (EncodingException e) + { + // skip the nvpair with the encoding problem - note this is already logged. + } + } + return map; + } + + /** + * {@inheritDoc} + * + * This implementation simply checks to make sure that the forward location starts with "WEB-INF" and + * is intended for use in frameworks that forward to JSP files inside the WEB-INF folder. + */ + public void sendForward(HttpServletRequest request, HttpServletResponse response, String location) throws AccessControlException,ServletException,IOException { + if (!location.startsWith("WEB-INF")) { + throw new AccessControlException("Forward failed", "Bad forward location: " + location); + } + RequestDispatcher dispatcher = request.getRequestDispatcher(location); + dispatcher.forward( request, response ); + } + + /** + * {@inheritDoc} + */ + public void sendForward( String location ) throws AccessControlException,ServletException,IOException { + sendForward( getCurrentRequest(), getCurrentResponse(), location); + } + + /** + * {@inheritDoc} + * + * This implementation checks against the list of safe redirect locations defined in ESAPI.properties. + * + * @param response + */ + public void sendRedirect(HttpServletResponse response, String location) throws AccessControlException, IOException { + if (!ESAPI.validator().isValidRedirectLocation("Redirect", location, false)) { + logger.fatal(Logger.SECURITY_FAILURE, "Bad redirect location: " + location); + throw new AccessControlException("Redirect failed", "Bad redirect location: " + location); + } + response.sendRedirect(location); + } + + /** + * {@inheritDoc} + */ + public void sendRedirect( String location ) throws AccessControlException,IOException { + sendRedirect( getCurrentResponse(), location); + } + + /** + * {@inheritDoc} + */ + public void setContentType() { + setContentType( getCurrentResponse() ); + } + + + /** + * {@inheritDoc} + */ + public void setContentType(HttpServletResponse response) { + response.setContentType((ESAPI.securityConfiguration()).getResponseContentType()); + } + + /** + * {@inheritDoc} + */ + public void setCurrentHTTP(HttpServletRequest request, HttpServletResponse response) { + currentRequest.setRequest(request); + currentResponse.setResponse(response); + } + + /** + * {@inheritDoc} + */ + public void setHeader(HttpServletResponse response, String name, String value) { + try { + String strippedName = StringUtilities.replaceLinearWhiteSpace(name); + String strippedValue = StringUtilities.replaceLinearWhiteSpace(value); + String safeName = ESAPI.validator().getValidInput("setHeader", strippedName, "HTTPHeaderName", 20, false); + String safeValue = ESAPI.validator().getValidInput("setHeader", strippedValue, "HTTPHeaderValue", 500, false); + response.setHeader(safeName, safeValue); + } catch (ValidationException e) { + logger.warning(Logger.SECURITY_FAILURE, "Attempt to set invalid header denied", e); + } + } + + + /** + * {@inheritDoc} + */ + public void setHeader( String name, String value ) { + setHeader( getCurrentResponse(), name, value ); + } + + + /** + * {@inheritDoc} + */ + public void setNoCacheHeaders() { + setNoCacheHeaders( getCurrentResponse() ); + } + + /** + * {@inheritDoc} + * + * @param response + */ + public void setNoCacheHeaders(HttpServletResponse response) { + // HTTP 1.1 + response.setHeader("Cache-Control", "no-store, no-cache, must-revalidate"); + + // HTTP 1.0 + response.setHeader("Pragma","no-cache"); + response.setDateHeader("Expires", -1); + } + + /** + * {@inheritDoc} + * + * Save the user's remember me data in an encrypted cookie and send it to the user. + * Any old remember me cookie is destroyed first. Setting this cookie will keep the user + * logged in until the maxAge passes, the password is changed, or the cookie is deleted. + * If the cookie exists for the current user, it will automatically be used by ESAPI to + * log the user in, if the data is valid and not expired. + * + * @param request + * @param response + */ + public String setRememberToken( HttpServletRequest request, HttpServletResponse response, String password, int maxAge, String domain, String path ) { + User user = ESAPI.authenticator().getCurrentUser(); + try { + killCookie(request, response, REMEMBER_TOKEN_COOKIE_NAME ); + // seal already contains random data + String clearToken = user.getAccountName() + "|" + password; + long expiry = ESAPI.encryptor().getRelativeTimeStamp(maxAge * 1000); + String cryptToken = ESAPI.encryptor().seal(clearToken, expiry); + + // Do NOT URLEncode cryptToken before creating cookie. See Google Issue # 144, + // which was marked as "WontFix". + + Cookie cookie = new Cookie( REMEMBER_TOKEN_COOKIE_NAME, cryptToken ); + cookie.setMaxAge( maxAge ); + cookie.setDomain( domain ); + cookie.setPath( path ); + response.addCookie( cookie ); + logger.info(Logger.SECURITY_SUCCESS, "Enabled remember me token for " + user.getAccountName() ); + return cryptToken; + } catch( IntegrityException e ) { + logger.warning(Logger.SECURITY_FAILURE, "Attempt to set remember me token failed for " + user.getAccountName(), e ); + return null; + } + } + + /** + * {@inheritDoc} + */ + public String setRememberToken( String password, int maxAge, String domain, String path ) { + return setRememberToken( getCurrentRequest(), getCurrentResponse(), password, maxAge, domain, path ); + } + + + /** + * {@inheritDoc} + */ + public void verifyCSRFToken() throws IntrusionException { + verifyCSRFToken( getCurrentRequest() ); + } + + /** + * {@inheritDoc} + * + * This implementation uses the CSRF_TOKEN_NAME parameter for the token. + * + * @param request + */ + public void verifyCSRFToken(HttpServletRequest request) throws IntrusionException { + User user = ESAPI.authenticator().getCurrentUser(); + + // check if user authenticated with this request - no CSRF protection required + if( request.getAttribute(user.getCSRFToken()) != null ) { + return; + } + String token = request.getParameter(CSRF_TOKEN_NAME); + if ( !user.getCSRFToken().equals( token ) ) { + throw new IntrusionException("Authentication failed", "Possibly forged HTTP request without proper CSRF token detected"); + } + } + + /** + * {@inheritDoc} + */ + public T getSessionAttribute( String key ) { + final HttpSession session = ESAPI.currentRequest().getSession(false); + if ( session != null ) + return (T) session.getAttribute(key); + return null; + } + + /** + * {@inheritDoc} + */ + public T getSessionAttribute(HttpSession session, String key) + { + return (T) session.getAttribute(key); + } + + /** + * {@inheritDoc} + */ + public T getRequestAttribute(String key) + { + return (T) ESAPI.currentRequest().getAttribute(key); + } + + /** + * {@inheritDoc} + */ + public T getRequestAttribute(HttpServletRequest request, String key) + { + return (T) request.getAttribute( key ); + } + + ///////////////////// + + /* Helper method to encrypt using new Encryptor encryption methods and + * return the serialized ciphertext as a hex-encoded string. + */ + private String encryptString(String plaintext) throws EncryptionException { + PlainText pt = new PlainText(plaintext); + CipherText ct = ESAPI.encryptor().encrypt(pt); + byte[] serializedCiphertext = ct.asPortableSerializedByteArray(); + return Hex.encode(serializedCiphertext, false); + } + + /* Helper method to decrypt a hex-encode serialized ciphertext string and + * to decrypt it using the new Encryptor decryption methods. + */ + private String decryptString(String ciphertext) throws EncryptionException { + byte[] serializedCiphertext = Hex.decode(ciphertext); + CipherText restoredCipherText = + CipherText.fromPortableSerializedBytes(serializedCiphertext); + PlainText plaintext = ESAPI.encryptor().decrypt(restoredCipherText); + return plaintext.toString(); + } +} diff --git a/src/test/java/org/owasp/esapi/reference/HTTPUtilitiesTest.java b/src/test/java/org/owasp/esapi/reference/HTTPUtilitiesTest.java index 40f9e219e..2c89a8e10 100644 --- a/src/test/java/org/owasp/esapi/reference/HTTPUtilitiesTest.java +++ b/src/test/java/org/owasp/esapi/reference/HTTPUtilitiesTest.java @@ -1,507 +1,508 @@ -/** - * OWASP Enterprise Security API (ESAPI) - * - * This file is part of the Open Web Application Security Project (OWASP) - * Enterprise Security API (ESAPI) project. For details, please see - * http://www.owasp.org/index.php/ESAPI. - * - * Copyright (c) 2007 - The OWASP Foundation - * - * The ESAPI is published by OWASP under the BSD license. You should read and accept the - * LICENSE before you use, modify, and/or redistribute this software. - * - * @author Jeff Williams Aspect Security - * @created 2007 - */ -package org.owasp.esapi.reference; - -import junit.framework.Test; -import junit.framework.TestCase; -import junit.framework.TestSuite; -import org.owasp.esapi.Authenticator; -import org.owasp.esapi.ESAPI; -import org.owasp.esapi.EncoderConstants; -import org.owasp.esapi.HTTPUtilities; -import org.owasp.esapi.User; -import org.owasp.esapi.codecs.Hex; -import org.owasp.esapi.crypto.CipherText; -import org.owasp.esapi.crypto.PlainText; -import org.owasp.esapi.errors.AuthenticationException; -import org.owasp.esapi.errors.EncryptionException; -import org.owasp.esapi.errors.EnterpriseSecurityException; -import org.owasp.esapi.errors.ValidationException; -import org.owasp.esapi.http.MockHttpServletRequest; -import org.owasp.esapi.http.MockHttpServletResponse; -import org.owasp.esapi.http.MockHttpSession; -import org.owasp.esapi.util.FileTestUtils; - -import javax.servlet.http.Cookie; -import javax.servlet.http.HttpServletRequest; -import javax.servlet.http.HttpSession; -import java.io.File; -import java.io.IOException; -import java.util.*; - -/** - * The Class HTTPUtilitiesTest. - * - * @author Jeff Williams (jeff.williams@aspectsecurity.com) - */ -public class HTTPUtilitiesTest extends TestCase -{ - private static final Class CLASS = HTTPUtilitiesTest.class; - private static final String CLASS_NAME = CLASS.getName(); - - /** - * Suite. - * - * @return the test - */ - public static Test suite() { - return new TestSuite(HTTPUtilitiesTest.class); - } - - /** - * Instantiates a new HTTP utilities test. - * - * @param testName the test name - */ - public HTTPUtilitiesTest(String testName) { - super(testName); - } - - /** - * {@inheritDoc} - * @throws Exception - */ - protected void setUp() throws Exception { - // none - } - - /** - * {@inheritDoc} - * @throws Exception - */ - protected void tearDown() throws Exception { - // none - } - - public void testCSRFToken() throws Exception { - System.out.println( "CSRFToken"); - String username = ESAPI.randomizer().getRandomString(8, EncoderConstants.CHAR_ALPHANUMERICS); - User user = ESAPI.authenticator().createUser(username, "addCSRFToken", "addCSRFToken"); - ESAPI.authenticator().setCurrentUser( user ); - String token = ESAPI.httpUtilities().getCSRFToken(); - assertEquals( 8, token.length() ); - MockHttpServletRequest request = new MockHttpServletRequest(); - try { - ESAPI.httpUtilities().verifyCSRFToken(request); - fail(); - } catch( Exception e ) { - // expected - } - request.addParameter( DefaultHTTPUtilities.CSRF_TOKEN_NAME, token ); - ESAPI.httpUtilities().verifyCSRFToken(request); - } - - /** - * Test of addCSRFToken method, of class org.owasp.esapi.HTTPUtilities. - * @throws AuthenticationException - */ - public void testAddCSRFToken() throws AuthenticationException { - Authenticator instance = ESAPI.authenticator(); - String username = ESAPI.randomizer().getRandomString(8, EncoderConstants.CHAR_ALPHANUMERICS); - User user = instance.createUser(username, "addCSRFToken", "addCSRFToken"); - instance.setCurrentUser( user ); - - System.out.println("addCSRFToken"); - String csrf1=ESAPI.httpUtilities().addCSRFToken("/test1"); - System.out.println( "CSRF1:" + csrf1); - assertTrue(csrf1.indexOf("?") > -1); - - String csrf2=ESAPI.httpUtilities().addCSRFToken("/test1?one=two"); - System.out.println( "CSRF1:" + csrf1); - assertTrue(csrf2.indexOf("&") > -1); - } - - - /** - * Test of assertSecureRequest method, of class org.owasp.esapi.HTTPUtilities. - */ - public void testAssertSecureRequest() { - System.out.println("assertSecureRequest"); - MockHttpServletRequest request = new MockHttpServletRequest(); - try { - request.setRequestURL( "http://example.com"); - ESAPI.httpUtilities().assertSecureRequest( request ); - fail(); - } catch( Exception e ) { - // pass - } - try { - request.setRequestURL( "ftp://example.com"); - ESAPI.httpUtilities().assertSecureRequest( request ); - fail(); - } catch( Exception e ) { - // pass - } - try { - request.setRequestURL( ""); - ESAPI.httpUtilities().assertSecureRequest( request ); - fail(); - } catch( Exception e ) { - // pass - } - try { - request.setRequestURL( null ); - ESAPI.httpUtilities().assertSecureRequest( request ); - fail(); - } catch( Exception e ) { - // pass - } - try { - request.setRequestURL( "https://example.com"); - ESAPI.httpUtilities().assertSecureRequest( request ); - // pass - } catch( Exception e ) { - fail(); - } - } - - - /** - * Test of sendRedirect method, of class org.owasp.esapi.HTTPUtilities. - * - * @throws EnterpriseSecurityException - */ - public void testChangeSessionIdentifier() throws EnterpriseSecurityException { - System.out.println("changeSessionIdentifier"); - MockHttpServletRequest request = new MockHttpServletRequest(); - MockHttpServletResponse response = new MockHttpServletResponse(); - MockHttpSession session = (MockHttpSession) request.getSession(); - ESAPI.httpUtilities().setCurrentHTTP(request, response); - session.setAttribute("one", "one"); - session.setAttribute("two", "two"); - session.setAttribute("three", "three"); - String id1 = session.getId(); - session = (MockHttpSession) ESAPI.httpUtilities().changeSessionIdentifier( request ); - String id2 = session.getId(); - assertTrue(!id1.equals(id2)); - assertEquals("one", (String) session.getAttribute("one")); - } - - /** - * Test of formatHttpRequestForLog method, of class org.owasp.esapi.HTTPUtilities. - * @throws IOException - */ - public void testGetFileUploads() throws IOException { - File home = null; - - try - { - home = FileTestUtils.createTmpDirectory(CLASS_NAME); - String content = "--ridiculous\r\nContent-Disposition: form-data; name=\"upload\"; filename=\"testupload.txt\"\r\nContent-Type: application/octet-stream\r\n\r\nThis is a test of the multipart broadcast system.\r\nThis is only a test.\r\nStop.\r\n\r\n--ridiculous\r\nContent-Disposition: form-data; name=\"submit\"\r\n\r\nSubmit Query\r\n--ridiculous--\r\nEpilogue"; - - MockHttpServletResponse response = new MockHttpServletResponse(); - MockHttpServletRequest request1 = new MockHttpServletRequest("/test", content.getBytes(response.getCharacterEncoding())); - ESAPI.httpUtilities().setCurrentHTTP(request1, response); - try { - ESAPI.httpUtilities().getFileUploads(request1, home); - fail(); - } catch( ValidationException e ) { - // expected - } - - MockHttpServletRequest request2 = new MockHttpServletRequest("/test", content.getBytes(response.getCharacterEncoding())); - request2.setContentType( "multipart/form-data; boundary=ridiculous"); - ESAPI.httpUtilities().setCurrentHTTP(request2, response); - try { - List list = ESAPI.httpUtilities().getFileUploads(request2, home); - Iterator i = list.iterator(); - while ( i.hasNext() ) { - File f = (File)i.next(); - System.out.println( " " + f.getAbsolutePath() ); - } - assertTrue( list.size() > 0 ); - } catch (ValidationException e) { - fail(); - } - - MockHttpServletRequest request4 = new MockHttpServletRequest("/test", content.getBytes(response.getCharacterEncoding())); - request4.setContentType( "multipart/form-data; boundary=ridiculous"); - ESAPI.httpUtilities().setCurrentHTTP(request4, response); - System.err.println("UPLOAD DIRECTORY: " + ESAPI.securityConfiguration().getUploadDirectory()); - try { - List list = ESAPI.httpUtilities().getFileUploads(request4, home); - Iterator i = list.iterator(); - while ( i.hasNext() ) { - File f = (File)i.next(); - System.out.println( " " + f.getAbsolutePath() ); - } - assertTrue( list.size() > 0 ); - } catch (ValidationException e) { - System.err.println("ERROR: " + e.toString()); - fail(); - } - - MockHttpServletRequest request3 = new MockHttpServletRequest("/test", content.replaceAll("txt", "ridiculous").getBytes(response.getCharacterEncoding())); - request3.setContentType( "multipart/form-data; boundary=ridiculous"); - ESAPI.httpUtilities().setCurrentHTTP(request3, response); - try { - ESAPI.httpUtilities().getFileUploads(request3, home); - fail(); - } catch (ValidationException e) { - // expected - } - } - finally - { - FileTestUtils.deleteRecursively(home); - } - - } - - - - /** - * Test of killAllCookies method, of class org.owasp.esapi.HTTPUtilities. - */ - public void testKillAllCookies() { - System.out.println("killAllCookies"); - MockHttpServletRequest request = new MockHttpServletRequest(); - MockHttpServletResponse response = new MockHttpServletResponse(); - assertTrue(response.getCookies().isEmpty()); - ArrayList list = new ArrayList(); - list.add(new Cookie("test1", "1")); - list.add(new Cookie("test2", "2")); - list.add(new Cookie("test3", "3")); - request.setCookies(list); - ESAPI.httpUtilities().killAllCookies(request, response); - assertTrue(response.getCookies().size() == 3); - } - - /** - * Test of killCookie method, of class org.owasp.esapi.HTTPUtilities. - */ - public void testKillCookie() { - System.out.println("killCookie"); - MockHttpServletRequest request = new MockHttpServletRequest(); - MockHttpServletResponse response = new MockHttpServletResponse(); - ESAPI.httpUtilities().setCurrentHTTP(request, response); - assertTrue(response.getCookies().isEmpty()); - ArrayList list = new ArrayList(); - list.add(new Cookie("test1", "1")); - list.add(new Cookie("test2", "2")); - list.add(new Cookie("test3", "3")); - request.setCookies(list); - ESAPI.httpUtilities().killCookie( request, response, "test1" ); - assertTrue(response.getCookies().size() == 1); - } - - /** - * Test of sendRedirect method, of class org.owasp.esapi.HTTPUtilities. - * - * @throws ValidationException the validation exception - * @throws IOException Signals that an I/O exception has occurred. - */ - public void testSendSafeRedirect() throws Exception { - System.out.println("sendSafeRedirect"); - MockHttpServletResponse response = new MockHttpServletResponse(); - try { - ESAPI.httpUtilities().sendRedirect(response, "/test1/abcdefg"); - ESAPI.httpUtilities().sendRedirect(response,"/test2/1234567"); - } catch (IOException e) { - fail(); - } - try { - ESAPI.httpUtilities().sendRedirect(response,"http://www.aspectsecurity.com"); - fail(); - } catch (IOException e) { - // expected - } - try { - ESAPI.httpUtilities().sendRedirect(response,"/ridiculous"); - fail(); - } catch (IOException e) { - // expected - } - } - - /** - * Test of setCookie method, of class org.owasp.esapi.HTTPUtilities. - */ - public void testSetCookie() { - System.out.println("setCookie"); - HTTPUtilities instance = ESAPI.httpUtilities(); - MockHttpServletResponse response = new MockHttpServletResponse(); - assertTrue(response.getHeaderNames().isEmpty()); - - instance.addCookie( response, new Cookie( "test1", "test1" ) ); - assertTrue(response.getHeaderNames().size() == 1); - - instance.addCookie( response, new Cookie( "test2", "test2" ) ); - assertTrue(response.getHeaderNames().size() == 2); - - // test illegal name - instance.addCookie( response, new Cookie( "teshttp://www.owasp.org/index.php/ESAPI. + * + * Copyright (c) 2007 - The OWASP Foundation + * + * The ESAPI is published by OWASP under the BSD license. You should read and accept the + * LICENSE before you use, modify, and/or redistribute this software. + * + * @author Jeff Williams Aspect Security + * @created 2007 + */ +package org.owasp.esapi.reference; + +import junit.framework.Test; +import junit.framework.TestCase; +import junit.framework.TestSuite; +import org.owasp.esapi.Authenticator; +import org.owasp.esapi.ESAPI; +import org.owasp.esapi.EncoderConstants; +import org.owasp.esapi.HTTPUtilities; +import org.owasp.esapi.User; +import org.owasp.esapi.codecs.Hex; +import org.owasp.esapi.crypto.CipherText; +import org.owasp.esapi.crypto.PlainText; +import org.owasp.esapi.errors.AccessControlException; +import org.owasp.esapi.errors.AuthenticationException; +import org.owasp.esapi.errors.EncryptionException; +import org.owasp.esapi.errors.EnterpriseSecurityException; +import org.owasp.esapi.errors.ValidationException; +import org.owasp.esapi.http.MockHttpServletRequest; +import org.owasp.esapi.http.MockHttpServletResponse; +import org.owasp.esapi.http.MockHttpSession; +import org.owasp.esapi.util.FileTestUtils; + +import javax.servlet.http.Cookie; +import javax.servlet.http.HttpServletRequest; +import javax.servlet.http.HttpSession; +import java.io.File; +import java.io.IOException; +import java.util.*; + +/** + * The Class HTTPUtilitiesTest. + * + * @author Jeff Williams (jeff.williams@aspectsecurity.com) + */ +public class HTTPUtilitiesTest extends TestCase +{ + private static final Class CLASS = HTTPUtilitiesTest.class; + private static final String CLASS_NAME = CLASS.getName(); + + /** + * Suite. + * + * @return the test + */ + public static Test suite() { + return new TestSuite(HTTPUtilitiesTest.class); + } + + /** + * Instantiates a new HTTP utilities test. + * + * @param testName the test name + */ + public HTTPUtilitiesTest(String testName) { + super(testName); + } + + /** + * {@inheritDoc} + * @throws Exception + */ + protected void setUp() throws Exception { + // none + } + + /** + * {@inheritDoc} + * @throws Exception + */ + protected void tearDown() throws Exception { + // none + } + + public void testCSRFToken() throws Exception { + System.out.println( "CSRFToken"); + String username = ESAPI.randomizer().getRandomString(8, EncoderConstants.CHAR_ALPHANUMERICS); + User user = ESAPI.authenticator().createUser(username, "addCSRFToken", "addCSRFToken"); + ESAPI.authenticator().setCurrentUser( user ); + String token = ESAPI.httpUtilities().getCSRFToken(); + assertEquals( 8, token.length() ); + MockHttpServletRequest request = new MockHttpServletRequest(); + try { + ESAPI.httpUtilities().verifyCSRFToken(request); + fail(); + } catch( Exception e ) { + // expected + } + request.addParameter( DefaultHTTPUtilities.CSRF_TOKEN_NAME, token ); + ESAPI.httpUtilities().verifyCSRFToken(request); + } + + /** + * Test of addCSRFToken method, of class org.owasp.esapi.HTTPUtilities. + * @throws AuthenticationException + */ + public void testAddCSRFToken() throws AuthenticationException { + Authenticator instance = ESAPI.authenticator(); + String username = ESAPI.randomizer().getRandomString(8, EncoderConstants.CHAR_ALPHANUMERICS); + User user = instance.createUser(username, "addCSRFToken", "addCSRFToken"); + instance.setCurrentUser( user ); + + System.out.println("addCSRFToken"); + String csrf1=ESAPI.httpUtilities().addCSRFToken("/test1"); + System.out.println( "CSRF1:" + csrf1); + assertTrue(csrf1.indexOf("?") > -1); + + String csrf2=ESAPI.httpUtilities().addCSRFToken("/test1?one=two"); + System.out.println( "CSRF1:" + csrf1); + assertTrue(csrf2.indexOf("&") > -1); + } + + + /** + * Test of assertSecureRequest method, of class org.owasp.esapi.HTTPUtilities. + */ + public void testAssertSecureRequest() { + System.out.println("assertSecureRequest"); + MockHttpServletRequest request = new MockHttpServletRequest(); + try { + request.setRequestURL( "http://example.com"); + ESAPI.httpUtilities().assertSecureRequest( request ); + fail(); + } catch( Exception e ) { + // pass + } + try { + request.setRequestURL( "ftp://example.com"); + ESAPI.httpUtilities().assertSecureRequest( request ); + fail(); + } catch( Exception e ) { + // pass + } + try { + request.setRequestURL( ""); + ESAPI.httpUtilities().assertSecureRequest( request ); + fail(); + } catch( Exception e ) { + // pass + } + try { + request.setRequestURL( null ); + ESAPI.httpUtilities().assertSecureRequest( request ); + fail(); + } catch( Exception e ) { + // pass + } + try { + request.setRequestURL( "https://example.com"); + ESAPI.httpUtilities().assertSecureRequest( request ); + // pass + } catch( Exception e ) { + fail(); + } + } + + + /** + * Test of sendRedirect method, of class org.owasp.esapi.HTTPUtilities. + * + * @throws EnterpriseSecurityException + */ + public void testChangeSessionIdentifier() throws EnterpriseSecurityException { + System.out.println("changeSessionIdentifier"); + MockHttpServletRequest request = new MockHttpServletRequest(); + MockHttpServletResponse response = new MockHttpServletResponse(); + MockHttpSession session = (MockHttpSession) request.getSession(); + ESAPI.httpUtilities().setCurrentHTTP(request, response); + session.setAttribute("one", "one"); + session.setAttribute("two", "two"); + session.setAttribute("three", "three"); + String id1 = session.getId(); + session = (MockHttpSession) ESAPI.httpUtilities().changeSessionIdentifier( request ); + String id2 = session.getId(); + assertTrue(!id1.equals(id2)); + assertEquals("one", (String) session.getAttribute("one")); + } + + /** + * Test of formatHttpRequestForLog method, of class org.owasp.esapi.HTTPUtilities. + * @throws IOException + */ + public void testGetFileUploads() throws IOException { + File home = null; + + try + { + home = FileTestUtils.createTmpDirectory(CLASS_NAME); + String content = "--ridiculous\r\nContent-Disposition: form-data; name=\"upload\"; filename=\"testupload.txt\"\r\nContent-Type: application/octet-stream\r\n\r\nThis is a test of the multipart broadcast system.\r\nThis is only a test.\r\nStop.\r\n\r\n--ridiculous\r\nContent-Disposition: form-data; name=\"submit\"\r\n\r\nSubmit Query\r\n--ridiculous--\r\nEpilogue"; + + MockHttpServletResponse response = new MockHttpServletResponse(); + MockHttpServletRequest request1 = new MockHttpServletRequest("/test", content.getBytes(response.getCharacterEncoding())); + ESAPI.httpUtilities().setCurrentHTTP(request1, response); + try { + ESAPI.httpUtilities().getFileUploads(request1, home); + fail(); + } catch( ValidationException e ) { + // expected + } + + MockHttpServletRequest request2 = new MockHttpServletRequest("/test", content.getBytes(response.getCharacterEncoding())); + request2.setContentType( "multipart/form-data; boundary=ridiculous"); + ESAPI.httpUtilities().setCurrentHTTP(request2, response); + try { + List list = ESAPI.httpUtilities().getFileUploads(request2, home); + Iterator i = list.iterator(); + while ( i.hasNext() ) { + File f = (File)i.next(); + System.out.println( " " + f.getAbsolutePath() ); + } + assertTrue( list.size() > 0 ); + } catch (ValidationException e) { + fail(); + } + + MockHttpServletRequest request4 = new MockHttpServletRequest("/test", content.getBytes(response.getCharacterEncoding())); + request4.setContentType( "multipart/form-data; boundary=ridiculous"); + ESAPI.httpUtilities().setCurrentHTTP(request4, response); + System.err.println("UPLOAD DIRECTORY: " + ESAPI.securityConfiguration().getUploadDirectory()); + try { + List list = ESAPI.httpUtilities().getFileUploads(request4, home); + Iterator i = list.iterator(); + while ( i.hasNext() ) { + File f = (File)i.next(); + System.out.println( " " + f.getAbsolutePath() ); + } + assertTrue( list.size() > 0 ); + } catch (ValidationException e) { + System.err.println("ERROR: " + e.toString()); + fail(); + } + + MockHttpServletRequest request3 = new MockHttpServletRequest("/test", content.replaceAll("txt", "ridiculous").getBytes(response.getCharacterEncoding())); + request3.setContentType( "multipart/form-data; boundary=ridiculous"); + ESAPI.httpUtilities().setCurrentHTTP(request3, response); + try { + ESAPI.httpUtilities().getFileUploads(request3, home); + fail(); + } catch (ValidationException e) { + // expected + } + } + finally + { + FileTestUtils.deleteRecursively(home); + } + + } + + + + /** + * Test of killAllCookies method, of class org.owasp.esapi.HTTPUtilities. + */ + public void testKillAllCookies() { + System.out.println("killAllCookies"); + MockHttpServletRequest request = new MockHttpServletRequest(); + MockHttpServletResponse response = new MockHttpServletResponse(); + assertTrue(response.getCookies().isEmpty()); + ArrayList list = new ArrayList(); + list.add(new Cookie("test1", "1")); + list.add(new Cookie("test2", "2")); + list.add(new Cookie("test3", "3")); + request.setCookies(list); + ESAPI.httpUtilities().killAllCookies(request, response); + assertTrue(response.getCookies().size() == 3); + } + + /** + * Test of killCookie method, of class org.owasp.esapi.HTTPUtilities. + */ + public void testKillCookie() { + System.out.println("killCookie"); + MockHttpServletRequest request = new MockHttpServletRequest(); + MockHttpServletResponse response = new MockHttpServletResponse(); + ESAPI.httpUtilities().setCurrentHTTP(request, response); + assertTrue(response.getCookies().isEmpty()); + ArrayList list = new ArrayList(); + list.add(new Cookie("test1", "1")); + list.add(new Cookie("test2", "2")); + list.add(new Cookie("test3", "3")); + request.setCookies(list); + ESAPI.httpUtilities().killCookie( request, response, "test1" ); + assertTrue(response.getCookies().size() == 1); + } + + /** + * Test of sendRedirect method, of class org.owasp.esapi.HTTPUtilities. + * + * @throws ValidationException the validation exception + * @throws IOException Signals that an I/O exception has occurred. + */ + public void testSendSafeRedirect() throws Exception { + System.out.println("sendSafeRedirect"); + MockHttpServletResponse response = new MockHttpServletResponse(); + try { + ESAPI.httpUtilities().sendRedirect(response, "/test1/abcdefg"); + ESAPI.httpUtilities().sendRedirect(response,"/test2/1234567"); + } catch (AccessControlException e) { + fail(); + } + try { + ESAPI.httpUtilities().sendRedirect(response,"http://www.aspectsecurity.com"); + fail(); + } catch (AccessControlException e) { + // expected + } + try { + ESAPI.httpUtilities().sendRedirect(response,"/ridiculous"); + fail(); + } catch (AccessControlException e) { + // expected + } + } + + /** + * Test of setCookie method, of class org.owasp.esapi.HTTPUtilities. + */ + public void testSetCookie() { + System.out.println("setCookie"); + HTTPUtilities instance = ESAPI.httpUtilities(); + MockHttpServletResponse response = new MockHttpServletResponse(); + assertTrue(response.getHeaderNames().isEmpty()); + + instance.addCookie( response, new Cookie( "test1", "test1" ) ); + assertTrue(response.getHeaderNames().size() == 1); + + instance.addCookie( response, new Cookie( "test2", "test2" ) ); + assertTrue(response.getHeaderNames().size() == 2); + + // test illegal name + instance.addCookie( response, new Cookie( "teshttp://www.owasp.org/index.php/ESAPI. - * - * Copyright (c) 2007 - The OWASP Foundation - * - * The ESAPI is published by OWASP under the BSD license. You should read and accept the - * LICENSE before you use, modify, and/or redistribute this software. - * - * @author Jeff Williams Aspect Security - * @created 2007 - */ -package org.owasp.esapi.reference; - -import java.io.BufferedReader; -import java.io.ByteArrayInputStream; -import java.io.File; -import java.io.IOException; -import java.io.InputStreamReader; -import java.io.UnsupportedEncodingException; -import java.text.DateFormat; -import java.text.SimpleDateFormat; -import java.util.*; - -import junit.framework.Test; -import junit.framework.TestCase; -import junit.framework.TestSuite; - -import org.owasp.esapi.*; -import org.owasp.esapi.errors.ValidationException; -import org.owasp.esapi.filters.SecurityWrapperRequest; -import org.owasp.esapi.http.MockHttpServletRequest; -import org.owasp.esapi.http.MockHttpServletResponse; -import org.owasp.esapi.reference.validation.HTMLValidationRule; -import org.owasp.esapi.reference.validation.StringValidationRule; - -import javax.servlet.http.Cookie; -import javax.servlet.http.HttpServletRequest; - -/** - * The Class ValidatorTest. - * - * @author Mike Fauzy (mike.fauzy@aspectsecurity.com) - * @author Jeff Williams (jeff.williams@aspectsecurity.com) - */ -public class ValidatorTest extends TestCase { - - private static final String PREFERRED_ENCODING = "UTF-8"; - - public static Test suite() { - return new TestSuite(ValidatorTest.class); - } - - /** - * Instantiates a new HTTP utilities test. - * - * @param testName the test name - */ - public ValidatorTest(String testName) { - super(testName); - } - - /** - * {@inheritDoc} - * - * @throws Exception - */ - protected void setUp() throws Exception { - // none - } - - /** - * {@inheritDoc} - * - * @throws Exception - */ - protected void tearDown() throws Exception { - // none - } - - public void testAddRule() { - Validator validator = ESAPI.validator(); - ValidationRule rule = new StringValidationRule("ridiculous"); - validator.addRule(rule); - assertEquals(rule, validator.getRule("ridiculous")); - } - - public void testAssertValidFileUpload() { - // assertValidFileUpload(String, String, String, byte[], int, boolean, ValidationErrorList) - } - - public void testGetPrintable1() { - // getValidPrintable(String, char[], int, boolean, ValidationErrorList) - } - - public void testGetPrintable2() { - // getValidPrintable(String, String, int, boolean, ValidationErrorList) - } - - public void testGetRule() { - Validator validator = ESAPI.validator(); - ValidationRule rule = new StringValidationRule("rule"); - validator.addRule(rule); - assertEquals(rule, validator.getRule("rule")); - assertFalse(rule == validator.getRule("ridiculous")); - } - - public void testGetValidCreditCard() { - System.out.println("getValidCreditCard"); - Validator instance = ESAPI.validator(); - ValidationErrorList errors = new ValidationErrorList(); - - assertTrue(instance.isValidCreditCard("cctest1", "1234 9876 0000 0008", false)); - assertTrue(instance.isValidCreditCard("cctest2", "1234987600000008", false)); - assertFalse(instance.isValidCreditCard("cctest3", "12349876000000081", false)); - assertFalse(instance.isValidCreditCard("cctest4", "4417 1234 5678 9112", false)); - - instance.getValidCreditCard("cctest5", "1234 9876 0000 0008", false, errors); - assertEquals(0, errors.size()); - instance.getValidCreditCard("cctest6", "1234987600000008", false, errors); - assertEquals(0, errors.size()); - instance.getValidCreditCard("cctest7", "12349876000000081", false, errors); - assertEquals(1, errors.size()); - instance.getValidCreditCard("cctest8", "4417 1234 5678 9112", false, errors); - assertEquals(2, errors.size()); - - assertTrue(instance.isValidCreditCard("cctest1", "1234 9876 0000 0008", false, errors)); - assertTrue(errors.size()==2); - assertTrue(instance.isValidCreditCard("cctest2", "1234987600000008", false, errors)); - assertTrue(errors.size()==2); - assertFalse(instance.isValidCreditCard("cctest3", "12349876000000081", false, errors)); - assertTrue(errors.size()==3); - assertFalse(instance.isValidCreditCard("cctest4", "4417 1234 5678 9112", false, errors)); - assertTrue(errors.size()==4); - } - - public void testGetValidDate() throws Exception { - System.out.println("getValidDate"); - Validator instance = ESAPI.validator(); - ValidationErrorList errors = new ValidationErrorList(); - assertTrue(instance.getValidDate("datetest1", "June 23, 1967", DateFormat.getDateInstance(DateFormat.MEDIUM, Locale.US), false) != null); - instance.getValidDate("datetest2", "freakshow", DateFormat.getDateInstance(), false, errors); - assertEquals(1, errors.size()); - - // TODO: This test case fails due to an apparent bug in SimpleDateFormat - // Note: This seems to be fixed in JDK 6. Will leave it commented out since - // we only require JDK 5. -kww - instance.getValidDate("test", "June 32, 2008", DateFormat.getDateInstance(), false, errors); - // assertEquals( 2, errors.size() ); - } - - // FIXME: Should probably use SecurityConfigurationWrapper and force - // Validator.AcceptLenientDates to be false. - public void testLenientDate() { - System.out.println("testLenientDate"); - boolean acceptLenientDates = ESAPI.securityConfiguration().getLenientDatesAccepted(); - if ( acceptLenientDates ) { - assertTrue("Lenient date test skipped because Validator.AcceptLenientDates set to true", true); - return; - } - - Date lenientDateTest = null; - try { - // lenientDateTest will be null when Validator.AcceptLenientDates - // is set to false (the default). - Validator instance = ESAPI.validator(); - lenientDateTest = instance.getValidDate("datatest3-lenient", "15/2/2009 11:83:00", - DateFormat.getDateInstance(DateFormat.SHORT, Locale.US), - false); - fail("Failed to throw expected ValidationException when Validator.AcceptLenientDates set to false."); - } catch (ValidationException ve) { - assertNull( lenientDateTest ); - Throwable cause = ve.getCause(); - assertTrue( cause.getClass().getName().equals("java.text.ParseException") ); - } catch (Exception e) { - fail("Caught unexpected exception: " + e.getClass().getName() + "; msg: " + e); - } - } - - public void testGetValidDirectoryPath() throws Exception { - System.out.println("getValidDirectoryPath"); - Validator instance = ESAPI.validator(); - ValidationErrorList errors = new ValidationErrorList(); - // find a directory that exists - File parent = new File("/"); - String path = ESAPI.securityConfiguration().getResourceFile("ESAPI.properties").getParentFile().getCanonicalPath(); - instance.getValidDirectoryPath("dirtest1", path, parent, true, errors); - assertEquals(0, errors.size()); - instance.getValidDirectoryPath("dirtest2", null, parent, false, errors); - assertEquals(1, errors.size()); - instance.getValidDirectoryPath("dirtest3", "ridicul%00ous", parent, false, errors); - assertEquals(2, errors.size()); - } - - public void testGetValidDouble() { - System.out.println("getValidDouble"); - Validator instance = ESAPI.validator(); - ValidationErrorList errors = new ValidationErrorList(); - instance.getValidDouble("dtest1", "1.0", 0, 20, true, errors); - assertEquals(0, errors.size()); - instance.getValidDouble("dtest2", null, 0, 20, true, errors); - assertEquals(0, errors.size()); - instance.getValidDouble("dtest3", null, 0, 20, false, errors); - assertEquals(1, errors.size()); - instance.getValidDouble("dtest4", "ridiculous", 0, 20, true, errors); - assertEquals(2, errors.size()); - instance.getValidDouble("dtest5", "" + (Double.MAX_VALUE), 0, 20, true, errors); - assertEquals(3, errors.size()); - instance.getValidDouble("dtest6", "" + (Double.MAX_VALUE + .00001), 0, 20, true, errors); - assertEquals(4, errors.size()); - } - - public void testGetValidFileContent() { - System.out.println("getValidFileContent"); - Validator instance = ESAPI.validator(); - ValidationErrorList errors = new ValidationErrorList(); - byte[] bytes = null; - try { - bytes = "12345".getBytes(PREFERRED_ENCODING); - } - catch (UnsupportedEncodingException e) { - fail(PREFERRED_ENCODING + " not a supported encoding?!?!!"); - } - instance.getValidFileContent("test", bytes, 5, true, errors); - assertEquals(0, errors.size()); - instance.getValidFileContent("test", bytes, 4, true, errors); - assertEquals(1, errors.size()); - } - - public void testGetValidFileName() throws Exception { - System.out.println("getValidFileName"); - Validator instance = ESAPI.validator(); - ValidationErrorList errors = new ValidationErrorList(); - String testName = "aspe%20ct.jar"; - assertEquals("Percent encoding is not changed", testName, instance.getValidFileName("test", testName, ESAPI.securityConfiguration().getAllowedFileExtensions(), false, errors)); - } - - public void testGetValidInput() { - System.out.println("getValidInput"); - Validator instance = ESAPI.validator(); - ValidationErrorList errors = new ValidationErrorList(); - // instance.getValidInput(String, String, String, int, boolean, ValidationErrorList) - } - - public void testGetValidInteger() { - System.out.println("getValidInteger"); - Validator instance = ESAPI.validator(); - ValidationErrorList errors = new ValidationErrorList(); - // instance.getValidInteger(String, String, int, int, boolean, ValidationErrorList) - } - - public void testGetValidListItem() { - System.out.println("getValidListItem"); - Validator instance = ESAPI.validator(); - ValidationErrorList errors = new ValidationErrorList(); - // instance.getValidListItem(String, String, List, ValidationErrorList) - } - - public void testGetValidNumber() { - System.out.println("getValidNumber"); - Validator instance = ESAPI.validator(); - ValidationErrorList errors = new ValidationErrorList(); - // instance.getValidNumber(String, String, long, long, boolean, ValidationErrorList) - } - - public void testGetValidRedirectLocation() { - System.out.println("getValidRedirectLocation"); - Validator instance = ESAPI.validator(); - ValidationErrorList errors = new ValidationErrorList(); - // instance.getValidRedirectLocation(String, String, boolean, ValidationErrorList) - } - - public void testGetValidSafeHTML() throws Exception { - System.out.println("getValidSafeHTML"); - Validator instance = ESAPI.validator(); - ValidationErrorList errors = new ValidationErrorList(); - - // new school test case setup - HTMLValidationRule rule = new HTMLValidationRule("test"); - ESAPI.validator().addRule(rule); - - assertEquals("Test.", ESAPI.validator().getRule("test").getValid("test", "Test. ")); - - String test1 = "Jeff"; - String result1 = instance.getValidSafeHTML("test", test1, 100, false, errors); - assertEquals(test1, result1); - - String test2 = "Aspect Security"; - String result2 = instance.getValidSafeHTML("test", test2, 100, false, errors); - assertEquals(test2, result2); - - String test3 = "Test. "; - assertEquals("Test.", rule.getSafe("test", test3)); - - assertEquals("Test. <

load=alert()
", rule.getSafe("test", "Test. <
load=alert()")); - assertEquals("Test.
b
", rule.getSafe("test", "Test.
b
")); - assertEquals("Test.", rule.getSafe("test", "Test. alert(document.cookie)")); - assertEquals("Test. alert(document.cookie)", rule.getSafe("test", "Test. alert(document.cookie)")); - assertEquals("Test. alert(document.cookie)", rule.getSafe("test", "Test. alert(document.cookie)")); - // TODO: ENHANCE waiting for a way to validate text headed for an attribute for scripts - // This would be nice to catch, but just looks like text to AntiSamy - // assertFalse(instance.isValidSafeHTML("test", "\" onload=\"alert(document.cookie)\" ")); - // String result4 = instance.getValidSafeHTML("test", test4); - // assertEquals("", result4); - } - - public void testIsInvalidFilename() { - System.out.println("testIsInvalidFilename"); - Validator instance = ESAPI.validator(); - char invalidChars[] = "/\\:*?\"<>|".toCharArray(); - for (int i = 0; i < invalidChars.length; i++) { - assertFalse(invalidChars[i] + " is an invalid character for a filename", - instance.isValidFileName("test", "as" + invalidChars[i] + "pect.jar", false)); - } - assertFalse("Files must have an extension", instance.isValidFileName("test", "", false)); - assertFalse("Files must have a valid extension", instance.isValidFileName("test.invalidExtension", "", false)); - assertFalse("Filennames cannot be the empty string", instance.isValidFileName("test", "", false)); - } - - public void testIsValidDate() { - System.out.println("isValidDate"); - Validator instance = ESAPI.validator(); - DateFormat format = SimpleDateFormat.getDateInstance(SimpleDateFormat.MEDIUM, Locale.US); - assertTrue(instance.isValidDate("datetest1", "September 11, 2001", format, true)); - assertFalse(instance.isValidDate("datetest2", null, format, false)); - assertFalse(instance.isValidDate("datetest3", "", format, false)); - - ValidationErrorList errors = new ValidationErrorList(); - assertTrue(instance.isValidDate("datetest1", "September 11, 2001", format, true, errors)); - assertTrue(errors.size()==0); - assertFalse(instance.isValidDate("datetest2", null, format, false, errors)); - assertTrue(errors.size()==1); - assertFalse(instance.isValidDate("datetest3", "", format, false, errors)); - assertTrue(errors.size()==2); - - } - - public void testIsValidDirectoryPath() throws IOException { - System.out.println("isValidDirectoryPath"); - - // get an encoder with a special list of codecs and make a validator out of it - List list = new ArrayList(); - list.add("HTMLEntityCodec"); - Encoder encoder = new DefaultEncoder(list); - Validator instance = new DefaultValidator(encoder); - - boolean isWindows = (System.getProperty("os.name").indexOf("Windows") != -1) ? true : false; - File parent = new File("/"); - - ValidationErrorList errors = new ValidationErrorList(); - - if (isWindows) { - String sysRoot = new File(System.getenv("SystemRoot")).getCanonicalPath(); - // Windows paths that don't exist and thus should fail - assertFalse(instance.isValidDirectoryPath("test", "c:\\ridiculous", parent, false)); - assertFalse(instance.isValidDirectoryPath("test", "c:\\jeff", parent, false)); - assertFalse(instance.isValidDirectoryPath("test", "c:\\temp\\..\\etc", parent, false)); - - // Windows paths - assertTrue(instance.isValidDirectoryPath("test", "C:\\", parent, false)); // Windows root directory - assertTrue(instance.isValidDirectoryPath("test", sysRoot, parent, false)); // Windows always exist directory - assertFalse(instance.isValidDirectoryPath("test", sysRoot + "\\System32\\cmd.exe", parent, false)); // Windows command shell - - // Unix specific paths should not pass - assertFalse(instance.isValidDirectoryPath("test", "/tmp", parent, false)); // Unix Temporary directory - assertFalse(instance.isValidDirectoryPath("test", "/bin/sh", parent, false)); // Unix Standard shell - assertFalse(instance.isValidDirectoryPath("test", "/etc/config", parent, false)); - - // Unix specific paths that should not exist or work - assertFalse(instance.isValidDirectoryPath("test", "/etc/ridiculous", parent, false)); - assertFalse(instance.isValidDirectoryPath("test", "/tmp/../etc", parent, false)); - - assertFalse(instance.isValidDirectoryPath("test1", "c:\\ridiculous", parent, false, errors)); - assertTrue(errors.size()==1); - assertFalse(instance.isValidDirectoryPath("test2", "c:\\jeff", parent, false, errors)); - assertTrue(errors.size()==2); - assertFalse(instance.isValidDirectoryPath("test3", "c:\\temp\\..\\etc", parent, false, errors)); - assertTrue(errors.size()==3); - - // Windows paths - assertTrue(instance.isValidDirectoryPath("test4", "C:\\", parent, false, errors)); // Windows root directory - assertTrue(errors.size()==3); - assertTrue(instance.isValidDirectoryPath("test5", sysRoot, parent, false, errors)); // Windows always exist directory - assertTrue(errors.size()==3); - assertFalse(instance.isValidDirectoryPath("test6", sysRoot + "\\System32\\cmd.exe", parent, false, errors)); // Windows command shell - assertTrue(errors.size()==4); - - // Unix specific paths should not pass - assertFalse(instance.isValidDirectoryPath("test7", "/tmp", parent, false, errors)); // Unix Temporary directory - assertTrue(errors.size()==5); - assertFalse(instance.isValidDirectoryPath("test8", "/bin/sh", parent, false, errors)); // Unix Standard shell - assertTrue(errors.size()==6); - assertFalse(instance.isValidDirectoryPath("test9", "/etc/config", parent, false, errors)); - assertTrue(errors.size()==7); - - // Unix specific paths that should not exist or work - assertFalse(instance.isValidDirectoryPath("test10", "/etc/ridiculous", parent, false, errors)); - assertTrue(errors.size()==8); - assertFalse(instance.isValidDirectoryPath("test11", "/tmp/../etc", parent, false, errors)); - assertTrue(errors.size()==9); - - } else { - // Windows paths should fail - assertFalse(instance.isValidDirectoryPath("test", "c:\\ridiculous", parent, false)); - assertFalse(instance.isValidDirectoryPath("test", "c:\\temp\\..\\etc", parent, false)); - - // Standard Windows locations should fail - assertFalse(instance.isValidDirectoryPath("test", "c:\\", parent, false)); // Windows root directory - assertFalse(instance.isValidDirectoryPath("test", "c:\\Windows\\temp", parent, false)); // Windows temporary directory - assertFalse(instance.isValidDirectoryPath("test", "c:\\Windows\\System32\\cmd.exe", parent, false)); // Windows command shell - - // Unix specific paths should pass - assertTrue(instance.isValidDirectoryPath("test", "/", parent, false)); // Root directory - assertTrue(instance.isValidDirectoryPath("test", "/bin", parent, false)); // Always exist directory - - // Unix specific paths that should not exist or work - assertFalse(instance.isValidDirectoryPath("test", "/bin/sh", parent, false)); // Standard shell, not dir - assertFalse(instance.isValidDirectoryPath("test", "/etc/ridiculous", parent, false)); - assertFalse(instance.isValidDirectoryPath("test", "/tmp/../etc", parent, false)); - - // Windows paths should fail - assertFalse(instance.isValidDirectoryPath("test1", "c:\\ridiculous", parent, false, errors)); - assertTrue(errors.size()==1); - assertFalse(instance.isValidDirectoryPath("test2", "c:\\temp\\..\\etc", parent, false, errors)); - assertTrue(errors.size()==2); - - // Standard Windows locations should fail - assertFalse(instance.isValidDirectoryPath("test3", "c:\\", parent, false, errors)); // Windows root directory - assertTrue(errors.size()==3); - assertFalse(instance.isValidDirectoryPath("test4", "c:\\Windows\\temp", parent, false, errors)); // Windows temporary directory - assertTrue(errors.size()==4); - assertFalse(instance.isValidDirectoryPath("test5", "c:\\Windows\\System32\\cmd.exe", parent, false, errors)); // Windows command shell - assertTrue(errors.size()==5); - - // Unix specific paths should pass - assertTrue(instance.isValidDirectoryPath("test6", "/", parent, false, errors)); // Root directory - assertTrue(errors.size()==5); - assertTrue(instance.isValidDirectoryPath("test7", "/bin", parent, false, errors)); // Always exist directory - assertTrue(errors.size()==5); - - // Unix specific paths that should not exist or work - assertFalse(instance.isValidDirectoryPath("test8", "/bin/sh", parent, false, errors)); // Standard shell, not dir - assertTrue(errors.size()==6); - assertFalse(instance.isValidDirectoryPath("test9", "/etc/ridiculous", parent, false, errors)); - assertTrue(errors.size()==7); - assertFalse(instance.isValidDirectoryPath("test10", "/tmp/../etc", parent, false, errors)); - assertTrue(errors.size()==8); - } - } - - public void TestIsValidDirectoryPath() { - // isValidDirectoryPath(String, String, boolean) - } - - public void testIsValidDouble() { - // isValidDouble(String, String, double, double, boolean) - Validator instance = ESAPI.validator(); - ValidationErrorList errors = new ValidationErrorList(); - //testing negative range - assertFalse(instance.isValidDouble("test1", "-4", 1, 10, false, errors)); - assertTrue(errors.size() == 1); - assertTrue(instance.isValidDouble("test2", "-4", -10, 10, false, errors)); - assertTrue(errors.size() == 1); - //testing null value - assertTrue(instance.isValidDouble("test3", null, -10, 10, true, errors)); - assertTrue(errors.size() == 1); - assertFalse(instance.isValidDouble("test4", null, -10, 10, false, errors)); - assertTrue(errors.size() == 2); - //testing empty string - assertTrue(instance.isValidDouble("test5", "", -10, 10, true, errors)); - assertTrue(errors.size() == 2); - assertFalse(instance.isValidDouble("test6", "", -10, 10, false, errors)); - assertTrue(errors.size() == 3); - //testing improper range - assertFalse(instance.isValidDouble("test7", "50.0", 10, -10, false, errors)); - assertTrue(errors.size() == 4); - //testing non-integers - assertTrue(instance.isValidDouble("test8", "4.3214", -10, 10, true, errors)); - assertTrue(errors.size() == 4); - assertTrue(instance.isValidDouble("test9", "-1.65", -10, 10, true, errors)); - assertTrue(errors.size() == 4); - //other testing - assertTrue(instance.isValidDouble("test10", "4", 1, 10, false, errors)); - assertTrue(errors.size() == 4); - assertTrue(instance.isValidDouble("test11", "400", 1, 10000, false, errors)); - assertTrue(errors.size() == 4); - assertTrue(instance.isValidDouble("test12", "400000000", 1, 400000000, false, errors)); - assertTrue(errors.size() == 4); - assertFalse(instance.isValidDouble("test13", "4000000000000", 1, 10000, false, errors)); - assertTrue(errors.size() == 5); - assertFalse(instance.isValidDouble("test14", "alsdkf", 10, 10000, false, errors)); - assertTrue(errors.size() == 6); - assertFalse(instance.isValidDouble("test15", "--10", 10, 10000, false, errors)); - assertTrue(errors.size() == 7); - assertFalse(instance.isValidDouble("test16", "14.1414234x", 10, 10000, false, errors)); - assertTrue(errors.size() == 8); - assertFalse(instance.isValidDouble("test17", "Infinity", 10, 10000, false, errors)); - assertTrue(errors.size() == 9); - assertFalse(instance.isValidDouble("test18", "-Infinity", 10, 10000, false, errors)); - assertTrue(errors.size() == 10); - assertFalse(instance.isValidDouble("test19", "NaN", 10, 10000, false, errors)); - assertTrue(errors.size() == 11); - assertFalse(instance.isValidDouble("test20", "-NaN", 10, 10000, false, errors)); - assertTrue(errors.size() == 12); - assertFalse(instance.isValidDouble("test21", "+NaN", 10, 10000, false, errors)); - assertTrue(errors.size() == 13); - assertTrue(instance.isValidDouble("test22", "1e-6", -999999999, 999999999, false, errors)); - assertTrue(errors.size() == 13); - assertTrue(instance.isValidDouble("test23", "-1e-6", -999999999, 999999999, false, errors)); - assertTrue(errors.size() == 13); - } - - public void testIsValidFileContent() { - System.out.println("isValidFileContent"); - byte[] content = null; - try { - content = "This is some file content".getBytes(PREFERRED_ENCODING); - } - catch (UnsupportedEncodingException e) { - fail(PREFERRED_ENCODING + " not a supported encoding?!?!!!"); - } - Validator instance = ESAPI.validator(); - assertTrue(instance.isValidFileContent("test", content, 100, false)); - } - - public void testIsValidFileName() { - System.out.println("isValidFileName"); - Validator instance = ESAPI.validator(); - assertTrue("Simple valid filename with a valid extension", instance.isValidFileName("test", "aspect.jar", false)); - assertTrue("All valid filename characters are accepted", instance.isValidFileName("test", "!@#$%^&{}[]()_+-=,.~'` abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ1234567890.jar", false)); - assertTrue("Legal filenames that decode to legal filenames are accepted", instance.isValidFileName("test", "aspe%20ct.jar", false)); - - ValidationErrorList errors = new ValidationErrorList(); - assertTrue("Simple valid filename with a valid extension", instance.isValidFileName("test", "aspect.jar", false, errors)); - assertTrue("All valid filename characters are accepted", instance.isValidFileName("test", "!@#$%^&{}[]()_+-=,.~'` abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ1234567890.jar", false, errors)); - assertTrue("Legal filenames that decode to legal filenames are accepted", instance.isValidFileName("test", "aspe%20ct.jar", false, errors)); - assertTrue(errors.size() == 0); - } - - public void testIsValidFileUpload() throws IOException { - System.out.println("isValidFileUpload"); - String filepath = new File(System.getProperty("user.dir")).getCanonicalPath(); - String filename = "aspect.jar"; - File parent = new File("/").getCanonicalFile(); - ValidationErrorList errors = new ValidationErrorList(); - byte[] content = null; - try { - content = "This is some file content".getBytes(PREFERRED_ENCODING); - } - catch (UnsupportedEncodingException e) { - fail(PREFERRED_ENCODING + " not a supported encoding?!?!!!"); - } - Validator instance = ESAPI.validator(); - assertTrue(instance.isValidFileUpload("test", filepath, filename, parent, content, 100, false)); - assertTrue(instance.isValidFileUpload("test", filepath, filename, parent, content, 100, false, errors)); - assertTrue(errors.size() == 0); - - filepath = "/ridiculous"; - filename = "aspect.jar"; - try { - content = "This is some file content".getBytes(PREFERRED_ENCODING); - } - catch (UnsupportedEncodingException e) { - fail(PREFERRED_ENCODING + " not a supported encoding?!?!!!"); - } - assertFalse(instance.isValidFileUpload("test", filepath, filename, parent, content, 100, false)); - assertFalse(instance.isValidFileUpload("test", filepath, filename, parent, content, 100, false, errors)); - assertTrue(errors.size() == 1); - } - - public void testIsValidHTTPRequestParameterSet() { - // isValidHTTPRequestParameterSet(String, Set, Set) - } - - public void testisValidInput() { - System.out.println("isValidInput"); - Validator instance = ESAPI.validator(); - assertTrue(instance.isValidInput("test", "jeff.williams@aspectsecurity.com", "Email", 100, false)); - assertFalse(instance.isValidInput("test", "jeff.williams@@aspectsecurity.com", "Email", 100, false)); - assertFalse(instance.isValidInput("test", "jeff.williams@aspectsecurity", "Email", 100, false)); - assertTrue(instance.isValidInput("test", "jeff.wil'liams@aspectsecurity.com", "Email", 100, false)); - assertTrue(instance.isValidInput("test", "jeff.wil''liams@aspectsecurity.com", "Email", 100, false)); - assertTrue(instance.isValidInput("test", "123.168.100.234", "IPAddress", 100, false)); - assertTrue(instance.isValidInput("test", "192.168.1.234", "IPAddress", 100, false)); - assertFalse(instance.isValidInput("test", "..168.1.234", "IPAddress", 100, false)); - assertFalse(instance.isValidInput("test", "10.x.1.234", "IPAddress", 100, false)); - assertTrue(instance.isValidInput("test", "http://www.aspectsecurity.com", "URL", 100, false)); - assertFalse(instance.isValidInput("test", "http:///www.aspectsecurity.com", "URL", 100, false)); - assertFalse(instance.isValidInput("test", "http://www.aspect security.com", "URL", 100, false)); - assertTrue(instance.isValidInput("test", "078-05-1120", "SSN", 100, false)); - assertTrue(instance.isValidInput("test", "078 05 1120", "SSN", 100, false)); - assertTrue(instance.isValidInput("test", "078051120", "SSN", 100, false)); - assertFalse(instance.isValidInput("test", "987-65-4320", "SSN", 100, false)); - assertFalse(instance.isValidInput("test", "000-00-0000", "SSN", 100, false)); - assertFalse(instance.isValidInput("test", "(555) 555-5555", "SSN", 100, false)); - assertFalse(instance.isValidInput("test", "test", "SSN", 100, false)); - assertTrue(instance.isValidInput("test", "jeffWILLIAMS123", "HTTPParameterValue", 100, false)); - assertTrue(instance.isValidInput("test", "jeff .-/+=@_ WILLIAMS", "HTTPParameterValue", 100, false)); - // Removed per Issue 116 - The '*' character is valid as a parameter character -// assertFalse(instance.isValidInput("test", "jeff*WILLIAMS", "HTTPParameterValue", 100, false)); - assertFalse(instance.isValidInput("test", "jeff^WILLIAMS", "HTTPParameterValue", 100, false)); - assertFalse(instance.isValidInput("test", "jeff\\WILLIAMS", "HTTPParameterValue", 100, false)); - - assertTrue(instance.isValidInput("test", null, "Email", 100, true)); - assertFalse(instance.isValidInput("test", null, "Email", 100, false)); - - ValidationErrorList errors = new ValidationErrorList(); - - assertTrue(instance.isValidInput("test1", "jeff.williams@aspectsecurity.com", "Email", 100, false, errors)); - assertTrue(errors.size()==0); - assertFalse(instance.isValidInput("test2", "jeff.williams@@aspectsecurity.com", "Email", 100, false, errors)); - assertTrue(errors.size()==1); - assertFalse(instance.isValidInput("test3", "jeff.williams@aspectsecurity", "Email", 100, false, errors)); - assertTrue(errors.size()==2); - assertTrue(instance.isValidInput("test4", "jeff.wil'liams@aspectsecurity.com", "Email", 100, false, errors)); - assertTrue(errors.size()==2); - assertTrue(instance.isValidInput("test5", "jeff.wil''liams@aspectsecurity.com", "Email", 100, false, errors)); - assertTrue(errors.size()==2); - assertTrue(instance.isValidInput("test6", "123.168.100.234", "IPAddress", 100, false, errors)); - assertTrue(errors.size()==2); - assertTrue(instance.isValidInput("test7", "192.168.1.234", "IPAddress", 100, false, errors)); - assertTrue(errors.size()==2); - assertFalse(instance.isValidInput("test8", "..168.1.234", "IPAddress", 100, false, errors)); - assertTrue(errors.size()==3); - assertFalse(instance.isValidInput("test9", "10.x.1.234", "IPAddress", 100, false, errors)); - assertTrue(errors.size()==4); - assertTrue(instance.isValidInput("test10", "http://www.aspectsecurity.com", "URL", 100, false, errors)); - assertTrue(errors.size()==4); - assertFalse(instance.isValidInput("test11", "http:///www.aspectsecurity.com", "URL", 100, false, errors)); - assertTrue(errors.size()==5); - assertFalse(instance.isValidInput("test12", "http://www.aspect security.com", "URL", 100, false, errors)); - assertTrue(errors.size()==6); - assertTrue(instance.isValidInput("test13", "078-05-1120", "SSN", 100, false, errors)); - assertTrue(errors.size()==6); - assertTrue(instance.isValidInput("test14", "078 05 1120", "SSN", 100, false, errors)); - assertTrue(errors.size()==6); - assertTrue(instance.isValidInput("test15", "078051120", "SSN", 100, false, errors)); - assertTrue(errors.size()==6); - assertFalse(instance.isValidInput("test16", "987-65-4320", "SSN", 100, false, errors)); - assertTrue(errors.size()==7); - assertFalse(instance.isValidInput("test17", "000-00-0000", "SSN", 100, false, errors)); - assertTrue(errors.size()==8); - assertFalse(instance.isValidInput("test18", "(555) 555-5555", "SSN", 100, false, errors)); - assertTrue(errors.size()==9); - assertFalse(instance.isValidInput("test19", "test", "SSN", 100, false, errors)); - assertTrue(errors.size()==10); - assertTrue(instance.isValidInput("test20", "jeffWILLIAMS123", "HTTPParameterValue", 100, false, errors)); - assertTrue(errors.size()==10); - assertTrue(instance.isValidInput("test21", "jeff .-/+=@_ WILLIAMS", "HTTPParameterValue", 100, false, errors)); - assertTrue(errors.size()==10); - // Removed per Issue 116 - The '*' character is valid as a parameter character -// assertFalse(instance.isValidInput("test", "jeff*WILLIAMS", "HTTPParameterValue", 100, false)); - assertFalse(instance.isValidInput("test22", "jeff^WILLIAMS", "HTTPParameterValue", 100, false, errors)); - assertTrue(errors.size()==11); - assertFalse(instance.isValidInput("test23", "jeff\\WILLIAMS", "HTTPParameterValue", 100, false, errors)); - assertTrue(errors.size()==12); - - assertTrue(instance.isValidInput("test", null, "Email", 100, true, errors)); - assertFalse(instance.isValidInput("test", null, "Email", 100, false, errors)); - } - - public void testIsValidInteger() { - System.out.println("isValidInteger"); - Validator instance = ESAPI.validator(); - //testing negative range - assertFalse(instance.isValidInteger("test", "-4", 1, 10, false)); - assertTrue(instance.isValidInteger("test", "-4", -10, 10, false)); - //testing null value - assertTrue(instance.isValidInteger("test", null, -10, 10, true)); - assertFalse(instance.isValidInteger("test", null, -10, 10, false)); - //testing empty string - assertTrue(instance.isValidInteger("test", "", -10, 10, true)); - assertFalse(instance.isValidInteger("test", "", -10, 10, false)); - //testing improper range - assertFalse(instance.isValidInteger("test", "50", 10, -10, false)); - //testing non-integers - assertFalse(instance.isValidInteger("test", "4.3214", -10, 10, true)); - assertFalse(instance.isValidInteger("test", "-1.65", -10, 10, true)); - //other testing - assertTrue(instance.isValidInteger("test", "4", 1, 10, false)); - assertTrue(instance.isValidInteger("test", "400", 1, 10000, false)); - assertTrue(instance.isValidInteger("test", "400000000", 1, 400000000, false)); - assertFalse(instance.isValidInteger("test", "4000000000000", 1, 10000, false)); - assertFalse(instance.isValidInteger("test", "alsdkf", 10, 10000, false)); - assertFalse(instance.isValidInteger("test", "--10", 10, 10000, false)); - assertFalse(instance.isValidInteger("test", "14.1414234x", 10, 10000, false)); - assertFalse(instance.isValidInteger("test", "Infinity", 10, 10000, false)); - assertFalse(instance.isValidInteger("test", "-Infinity", 10, 10000, false)); - assertFalse(instance.isValidInteger("test", "NaN", 10, 10000, false)); - assertFalse(instance.isValidInteger("test", "-NaN", 10, 10000, false)); - assertFalse(instance.isValidInteger("test", "+NaN", 10, 10000, false)); - assertFalse(instance.isValidInteger("test", "1e-6", -999999999, 999999999, false)); - assertFalse(instance.isValidInteger("test", "-1e-6", -999999999, 999999999, false)); - - ValidationErrorList errors = new ValidationErrorList(); - //testing negative range - assertFalse(instance.isValidInteger("test1", "-4", 1, 10, false, errors)); - assertTrue(errors.size() == 1); - assertTrue(instance.isValidInteger("test2", "-4", -10, 10, false, errors)); - assertTrue(errors.size() == 1); - //testing null value - assertTrue(instance.isValidInteger("test3", null, -10, 10, true, errors)); - assertTrue(errors.size() == 1); - assertFalse(instance.isValidInteger("test4", null, -10, 10, false, errors)); - assertTrue(errors.size() == 2); - //testing empty string - assertTrue(instance.isValidInteger("test5", "", -10, 10, true, errors)); - assertTrue(errors.size() == 2); - assertFalse(instance.isValidInteger("test6", "", -10, 10, false, errors)); - assertTrue(errors.size() == 3); - //testing improper range - assertFalse(instance.isValidInteger("test7", "50", 10, -10, false, errors)); - assertTrue(errors.size() == 4); - //testing non-integers - assertFalse(instance.isValidInteger("test8", "4.3214", -10, 10, true, errors)); - assertTrue(errors.size() == 5); - assertFalse(instance.isValidInteger("test9", "-1.65", -10, 10, true, errors)); - assertTrue(errors.size() == 6); - //other testing - assertTrue(instance.isValidInteger("test10", "4", 1, 10, false, errors)); - assertTrue(errors.size() == 6); - assertTrue(instance.isValidInteger("test11", "400", 1, 10000, false, errors)); - assertTrue(errors.size() == 6); - assertTrue(instance.isValidInteger("test12", "400000000", 1, 400000000, false, errors)); - assertTrue(errors.size() == 6); - assertFalse(instance.isValidInteger("test13", "4000000000000", 1, 10000, false, errors)); - assertTrue(errors.size() == 7); - assertFalse(instance.isValidInteger("test14", "alsdkf", 10, 10000, false, errors)); - assertTrue(errors.size() == 8); - assertFalse(instance.isValidInteger("test15", "--10", 10, 10000, false, errors)); - assertTrue(errors.size() == 9); - assertFalse(instance.isValidInteger("test16", "14.1414234x", 10, 10000, false, errors)); - assertTrue(errors.size() == 10); - assertFalse(instance.isValidInteger("test17", "Infinity", 10, 10000, false, errors)); - assertTrue(errors.size() == 11); - assertFalse(instance.isValidInteger("test18", "-Infinity", 10, 10000, false, errors)); - assertTrue(errors.size() == 12); - assertFalse(instance.isValidInteger("test19", "NaN", 10, 10000, false, errors)); - assertTrue(errors.size() == 13); - assertFalse(instance.isValidInteger("test20", "-NaN", 10, 10000, false, errors)); - assertTrue(errors.size() == 14); - assertFalse(instance.isValidInteger("test21", "+NaN", 10, 10000, false, errors)); - assertTrue(errors.size() == 15); - assertFalse(instance.isValidInteger("test22", "1e-6", -999999999, 999999999, false, errors)); - assertTrue(errors.size() == 16); - assertFalse(instance.isValidInteger("test23", "-1e-6", -999999999, 999999999, false, errors)); - assertTrue(errors.size() == 17); - - } - - public void testIsValidListItem() { - System.out.println("isValidListItem"); - Validator instance = ESAPI.validator(); - List list = new ArrayList(); - list.add("one"); - list.add("two"); - assertTrue(instance.isValidListItem("test", "one", list)); - assertFalse(instance.isValidListItem("test", "three", list)); - - ValidationErrorList errors = new ValidationErrorList(); - assertTrue(instance.isValidListItem("test1", "one", list, errors)); - assertTrue(errors.size()==0); - assertFalse(instance.isValidListItem("test2", "three", list, errors)); - assertTrue(errors.size()==1); - } - - public void testIsValidNumber() { - System.out.println("isValidNumber"); - Validator instance = ESAPI.validator(); - //testing negative range - assertFalse(instance.isValidNumber("test", "-4", 1, 10, false)); - assertTrue(instance.isValidNumber("test", "-4", -10, 10, false)); - //testing null value - assertTrue(instance.isValidNumber("test", null, -10, 10, true)); - assertFalse(instance.isValidNumber("test", null, -10, 10, false)); - //testing empty string - assertTrue(instance.isValidNumber("test", "", -10, 10, true)); - assertFalse(instance.isValidNumber("test", "", -10, 10, false)); - //testing improper range - assertFalse(instance.isValidNumber("test", "5", 10, -10, false)); - //testing non-integers - assertTrue(instance.isValidNumber("test", "4.3214", -10, 10, true)); - assertTrue(instance.isValidNumber("test", "-1.65", -10, 10, true)); - //other testing - assertTrue(instance.isValidNumber("test", "4", 1, 10, false)); - assertTrue(instance.isValidNumber("test", "400", 1, 10000, false)); - assertTrue(instance.isValidNumber("test", "400000000", 1, 400000000, false)); - assertFalse(instance.isValidNumber("test", "4000000000000", 1, 10000, false)); - assertFalse(instance.isValidNumber("test", "alsdkf", 10, 10000, false)); - assertFalse(instance.isValidNumber("test", "--10", 10, 10000, false)); - assertFalse(instance.isValidNumber("test", "14.1414234x", 10, 10000, false)); - assertFalse(instance.isValidNumber("test", "Infinity", 10, 10000, false)); - assertFalse(instance.isValidNumber("test", "-Infinity", 10, 10000, false)); - assertFalse(instance.isValidNumber("test", "NaN", 10, 10000, false)); - assertFalse(instance.isValidNumber("test", "-NaN", 10, 10000, false)); - assertFalse(instance.isValidNumber("test", "+NaN", 10, 10000, false)); - assertTrue(instance.isValidNumber("test", "1e-6", -999999999, 999999999, false)); - assertTrue(instance.isValidNumber("test", "-1e-6", -999999999, 999999999, false)); - - ValidationErrorList errors = new ValidationErrorList(); - //testing negative range - assertFalse(instance.isValidNumber("test1", "-4", 1, 10, false, errors)); - assertTrue(errors.size()==1); - assertTrue(instance.isValidNumber("test2", "-4", -10, 10, false, errors)); - assertTrue(errors.size()==1); - //testing null value - assertTrue(instance.isValidNumber("test3", null, -10, 10, true, errors)); - assertTrue(errors.size()==1); - assertFalse(instance.isValidNumber("test4", null, -10, 10, false, errors)); - assertTrue(errors.size()==2); - //testing empty string - assertTrue(instance.isValidNumber("test5", "", -10, 10, true, errors)); - assertTrue(errors.size()==2); - assertFalse(instance.isValidNumber("test6", "", -10, 10, false, errors)); - assertTrue(errors.size()==3); - //testing improper range - assertFalse(instance.isValidNumber("test7", "5", 10, -10, false, errors)); - assertTrue(errors.size()==4); - //testing non-integers - assertTrue(instance.isValidNumber("test8", "4.3214", -10, 10, true, errors)); - assertTrue(errors.size()==4); - assertTrue(instance.isValidNumber("test9", "-1.65", -10, 10, true, errors)); - assertTrue(errors.size()==4); - //other testing - assertTrue(instance.isValidNumber("test10", "4", 1, 10, false, errors)); - assertTrue(errors.size()==4); - assertTrue(instance.isValidNumber("test11", "400", 1, 10000, false, errors)); - assertTrue(errors.size()==4); - assertTrue(instance.isValidNumber("test12", "400000000", 1, 400000000, false, errors)); - assertTrue(errors.size()==4); - assertFalse(instance.isValidNumber("test13", "4000000000000", 1, 10000, false, errors)); - assertTrue(errors.size()==5); - assertFalse(instance.isValidNumber("test14", "alsdkf", 10, 10000, false, errors)); - assertTrue(errors.size()==6); - assertFalse(instance.isValidNumber("test15", "--10", 10, 10000, false, errors)); - assertTrue(errors.size()==7); - assertFalse(instance.isValidNumber("test16", "14.1414234x", 10, 10000, false, errors)); - assertTrue(errors.size()==8); - assertFalse(instance.isValidNumber("test17", "Infinity", 10, 10000, false, errors)); - assertTrue(errors.size()==9); - assertFalse(instance.isValidNumber("test18", "-Infinity", 10, 10000, false, errors)); - assertTrue(errors.size()==10); - assertFalse(instance.isValidNumber("test19", "NaN", 10, 10000, false, errors)); - assertTrue(errors.size()==11); - assertFalse(instance.isValidNumber("test20", "-NaN", 10, 10000, false, errors)); - assertTrue(errors.size()==12); - assertFalse(instance.isValidNumber("test21", "+NaN", 10, 10000, false, errors)); - assertTrue(errors.size()==13); - assertTrue(instance.isValidNumber("test22", "1e-6", -999999999, 999999999, false, errors)); - assertTrue(errors.size()==13); - assertTrue(instance.isValidNumber("test23", "-1e-6", -999999999, 999999999, false, errors)); - assertTrue(errors.size()==13); - } - - public void testIsValidParameterSet() { - System.out.println("isValidParameterSet"); - Set requiredNames = new HashSet(); - requiredNames.add("p1"); - requiredNames.add("p2"); - requiredNames.add("p3"); - Set optionalNames = new HashSet(); - optionalNames.add("p4"); - optionalNames.add("p5"); - optionalNames.add("p6"); - MockHttpServletRequest request = new MockHttpServletRequest(); - MockHttpServletResponse response = new MockHttpServletResponse(); - request.addParameter("p1", "value"); - request.addParameter("p2", "value"); - request.addParameter("p3", "value"); - ESAPI.httpUtilities().setCurrentHTTP(request, response); - Validator instance = ESAPI.validator(); - ValidationErrorList errors = new ValidationErrorList(); - assertTrue(instance.isValidHTTPRequestParameterSet("HTTPParameters", request, requiredNames, optionalNames)); - assertTrue(instance.isValidHTTPRequestParameterSet("HTTPParameters", request, requiredNames, optionalNames,errors)); - assertTrue(errors.size()==0); - request.addParameter("p4", "value"); - request.addParameter("p5", "value"); - request.addParameter("p6", "value"); - assertTrue(instance.isValidHTTPRequestParameterSet("HTTPParameters", request, requiredNames, optionalNames)); - assertTrue(instance.isValidHTTPRequestParameterSet("HTTPParameters", request, requiredNames, optionalNames, errors)); - assertTrue(errors.size()==0); - request.removeParameter("p1"); - assertFalse(instance.isValidHTTPRequestParameterSet("HTTPParameters", request, requiredNames, optionalNames)); - assertFalse(instance.isValidHTTPRequestParameterSet("HTTPParameters", request, requiredNames, optionalNames, errors)); - assertTrue(errors.size() ==1); - } - - public void testIsValidPrintable() { - System.out.println("isValidPrintable"); - Validator instance = ESAPI.validator(); - assertTrue(instance.isValidPrintable("name", "abcDEF", 100, false)); - assertTrue(instance.isValidPrintable("name", "!@#R()*$;><()", 100, false)); - char[] chars = {0x60, (char) 0xFF, 0x10, 0x25}; - assertFalse(instance.isValidPrintable("name", chars, 100, false)); - assertFalse(instance.isValidPrintable("name", "%08", 100, false)); - - ValidationErrorList errors = new ValidationErrorList(); - assertTrue(instance.isValidPrintable("name1", "abcDEF", 100, false, errors)); - assertTrue(errors.size()==0); - assertTrue(instance.isValidPrintable("name2", "!@#R()*$;><()", 100, false, errors)); - assertTrue(errors.size()==0); - assertFalse(instance.isValidPrintable("name3", chars, 100, false, errors)); - assertTrue(errors.size()==1); - assertFalse(instance.isValidPrintable("name4", "%08", 100, false, errors)); - assertTrue(errors.size()==2); - - } - - public void testIsValidRedirectLocation() { - // isValidRedirectLocation(String, String, boolean) - } - - public void testIsValidSafeHTML() { - System.out.println("isValidSafeHTML"); - Validator instance = ESAPI.validator(); - - assertTrue(instance.isValidSafeHTML("test", "Jeff", 100, false)); - assertTrue(instance.isValidSafeHTML("test", "Aspect Security", 100, false)); - assertTrue(instance.isValidSafeHTML("test", "Test. ", 100, false)); - assertTrue(instance.isValidSafeHTML("test", "Test.
", 100, false)); - assertTrue(instance.isValidSafeHTML("test", "Test. alert(document.cookie)", 100, false)); - assertTrue(instance.isValidSafeHTML("test", "Test. alert(document.cookie)", 100, false)); - assertTrue(instance.isValidSafeHTML("test", "Test. alert(document.cookie)", 100, false)); - - // TODO: waiting for a way to validate text headed for an attribute for scripts - // This would be nice to catch, but just looks like text to AntiSamy - // assertFalse(instance.isValidSafeHTML("test", "\" onload=\"alert(document.cookie)\" ")); - ValidationErrorList errors = new ValidationErrorList(); - assertTrue(instance.isValidSafeHTML("test1", "Jeff", 100, false, errors)); - assertTrue(instance.isValidSafeHTML("test2", "Aspect Security", 100, false, errors)); - assertTrue(instance.isValidSafeHTML("test3", "Test. ", 100, false, errors)); - assertTrue(instance.isValidSafeHTML("test4", "Test.
", 100, false, errors)); - assertTrue(instance.isValidSafeHTML("test5", "Test. alert(document.cookie)", 100, false, errors)); - assertTrue(instance.isValidSafeHTML("test6", "Test. alert(document.cookie)", 100, false, errors)); - assertTrue(instance.isValidSafeHTML("test7", "Test. alert(document.cookie)", 100, false, errors)); - assertTrue(errors.size() == 0); - - } - - public void testSafeReadLine() { - System.out.println("safeReadLine"); - - byte[] bytes = null; - try { - bytes = "testString".getBytes(PREFERRED_ENCODING); - } - catch (UnsupportedEncodingException e1) { - fail(PREFERRED_ENCODING + " not a supported encoding?!?!!!"); - } - ByteArrayInputStream s = new ByteArrayInputStream(bytes); - Validator instance = ESAPI.validator(); - try { - instance.safeReadLine(s, -1); - fail(); - } - catch (ValidationException e) { - // Expected - } - s.reset(); - try { - instance.safeReadLine(s, 4); - fail(); - } - catch (ValidationException e) { - // Expected - } - s.reset(); - try { - String u = instance.safeReadLine(s, 20); - assertEquals("testString", u); - } - catch (ValidationException e) { - fail(); - } - - // This sub-test attempts to validate that BufferedReader.readLine() and safeReadLine() are similar in operation - // for the nominal case - try { - s.reset(); - InputStreamReader isr = new InputStreamReader(s); - BufferedReader br = new BufferedReader(isr); - String u = br.readLine(); - s.reset(); - String v = instance.safeReadLine(s, 20); - assertEquals(u, v); - } - catch (IOException e) { - fail(); - } - catch (ValidationException e) { - fail(); - } - } - - public void testIssue82_SafeString_Bad_Regex() { - Validator instance = ESAPI.validator(); - try { - instance.getValidInput("address", "55 main st. pasadena ak", "SafeString", 512, false); - } - catch (ValidationException e) { - fail(e.getLogMessage()); - } - } - - public void testGetParameterMap() { -//testing Validator.HTTPParameterName and Validator.HTTPParameterValue - MockHttpServletRequest request = new MockHttpServletRequest(); - SecurityWrapperRequest safeRequest = new SecurityWrapperRequest(request); -//an example of a parameter from displaytag, should pass - request.addParameter("d-49653-p", "pass"); - request.addParameter(""); - request.addParameter("f2", ""); - request.addParameter("f3", ""); - for (int i = 1; i <= 4; i++) { - assertTrue(safeRequest.getParameter("p" + i).equals(request.getParameter("p" + i))); - } - for (int i = 1; i <= 2; i++) { - boolean testResult = false; - try { - testResult = safeRequest.getParameter("f" + i).equals(request.getParameter("f" + i)); - } catch (NullPointerException npe) { - //the test is this block SHOULD fail. a NPE is an acceptable failure state - testResult = false; //redundant, just being descriptive here - } - assertFalse(testResult); - } - assertNull(safeRequest.getParameter("e1")); - - //This is revealing problems with Jeff's original SafeRequest - //mishandling of the AllowNull parameter. I'm adding a new Google code - //bug to track this. - // - //assertNotNull(safeRequest.getParameter("e1", false)); - } - - public void testGetCookies() { -//testing Validator.HTTPCookieName and Validator.HTTPCookieValue - MockHttpServletRequest request = new MockHttpServletRequest(); - SecurityWrapperRequest safeRequest = new SecurityWrapperRequest(request); -//should support a base64-encode value - request.setCookie("p1", "34=VJhjv7jiDu7tsdLrQQ2KcUwpfWUM2_mBae6UA8ttk4wBHdxxQ-1IBxyCOn3LWE08SDhpnBcJ7N5Vze48F2t8a1R_hXt7PX1BvgTM0pn-T4JkqGTm_tlmV4RmU3GT-dgn"); - request.setCookie("f1", "XSS"); - request.setCookie("load-balancing", "pass"); - request.setCookie("'bypass", "fail"); - Cookie[] cookies = safeRequest.getCookies(); - assertEquals(cookies[0].getValue(), request.getCookies()[0].getValue()); - assertEquals(cookies[1].getName(), request.getCookies()[2].getName()); - assertTrue(cookies.length == 2); - } - - public void testGetHeader() { -//testing Validator.HTTPHeaderValue - MockHttpServletRequest request = new MockHttpServletRequest(); - SecurityWrapperRequest safeRequest = new SecurityWrapperRequest(request); - request.addHeader("p1", "login"); - request.addHeader("f1", "XSS"); - request.addHeader("p2", generateStringOfLength(150)); - request.addHeader("f2", generateStringOfLength(151)); - assertEquals(safeRequest.getHeader("p1"), request.getHeader("p1")); - assertEquals(safeRequest.getHeader("p2"), request.getHeader("p2")); - assertFalse(safeRequest.getHeader("f1").equals(request.getHeader("f1"))); - assertFalse(safeRequest.getHeader("f2").equals(request.getHeader("f2"))); - assertNull(safeRequest.getHeader("p3")); - } - - public void testGetHeaderNames() { -//testing Validator.HTTPHeaderName - MockHttpServletRequest request = new MockHttpServletRequest(); - SecurityWrapperRequest safeRequest = new SecurityWrapperRequest(request); - request.addHeader("d-49653-p", "pass"); - request.addHeader(""); - assertFalse(safeRequest.getQueryString().equals(request.getQueryString())); - request.setQueryString("mail=bob@alice.com-passwd=johny"); - assertTrue(safeRequest.getQueryString().equals(request.getQueryString())); - request.setQueryString("mail=bob@alice.com-passwd=johny&special"); //= is missing! - assertFalse(safeRequest.getQueryString().equals(request.getQueryString())); - } - - public void testGetRequestURI() { -//testing Validator.HTTPURI - MockHttpServletRequest request = new MockHttpServletRequest(); - SecurityWrapperRequest safeRequest = new SecurityWrapperRequest(request); - try { - request.setRequestURI("/app/page.jsp"); - } catch (UnsupportedEncodingException ignored) { - } - assertEquals(safeRequest.getRequestURI(), request.getRequestURI()); - } - - private String generateStringOfLength(int length) { - StringBuilder longString = new StringBuilder(); - for (int i = 0; i < length; i++) { - longString.append("a"); - } - return longString.toString(); - } - - public void testGetContextPath() { - // Root Context Path ("") - assertTrue(ESAPI.validator().isValidInput("HTTPContextPath", "", "HTTPContextPath", 512, true)); - // Deployed Context Path ("/context") - assertTrue(ESAPI.validator().isValidInput("HTTPContextPath", "/context", "HTTPContextPath", 512, true)); - // Fail-case - URL Splitting - assertFalse(ESAPI.validator().isValidInput("HTTPContextPath", "/\\nGET http://evil.com", "HTTPContextPath", 512, true)); - } -} +/** + * OWASP Enterprise Security API (ESAPI) + * + * This file is part of the Open Web Application Security Project (OWASP) + * Enterprise Security API (ESAPI) project. For details, please see + * http://www.owasp.org/index.php/ESAPI. + * + * Copyright (c) 2007 - The OWASP Foundation + * + * The ESAPI is published by OWASP under the BSD license. You should read and accept the + * LICENSE before you use, modify, and/or redistribute this software. + * + * @author Jeff Williams Aspect Security + * @created 2007 + */ +package org.owasp.esapi.reference; + +import java.io.BufferedReader; +import java.io.ByteArrayInputStream; +import java.io.File; +import java.io.IOException; +import java.io.InputStreamReader; +import java.io.UnsupportedEncodingException; +import java.text.DateFormat; +import java.text.SimpleDateFormat; +import java.util.*; + +import junit.framework.Test; +import junit.framework.TestCase; +import junit.framework.TestSuite; + +import org.owasp.esapi.*; +import org.owasp.esapi.errors.ValidationException; +import org.owasp.esapi.filters.SecurityWrapperRequest; +import org.owasp.esapi.http.MockHttpServletRequest; +import org.owasp.esapi.http.MockHttpServletResponse; +import org.owasp.esapi.reference.validation.HTMLValidationRule; +import org.owasp.esapi.reference.validation.StringValidationRule; + +import javax.servlet.http.Cookie; +import javax.servlet.http.HttpServletRequest; + +/** + * The Class ValidatorTest. + * + * @author Mike Fauzy (mike.fauzy@aspectsecurity.com) + * @author Jeff Williams (jeff.williams@aspectsecurity.com) + */ +public class ValidatorTest extends TestCase { + + private static final String PREFERRED_ENCODING = "UTF-8"; + + public static Test suite() { + return new TestSuite(ValidatorTest.class); + } + + /** + * Instantiates a new HTTP utilities test. + * + * @param testName the test name + */ + public ValidatorTest(String testName) { + super(testName); + } + + /** + * {@inheritDoc} + * + * @throws Exception + */ + protected void setUp() throws Exception { + // none + } + + /** + * {@inheritDoc} + * + * @throws Exception + */ + protected void tearDown() throws Exception { + // none + } + + public void testAddRule() { + Validator validator = ESAPI.validator(); + ValidationRule rule = new StringValidationRule("ridiculous"); + validator.addRule(rule); + assertEquals(rule, validator.getRule("ridiculous")); + } + + public void testAssertValidFileUpload() { + // assertValidFileUpload(String, String, String, byte[], int, boolean, ValidationErrorList) + } + + public void testGetPrintable1() { + // getValidPrintable(String, char[], int, boolean, ValidationErrorList) + } + + public void testGetPrintable2() { + // getValidPrintable(String, String, int, boolean, ValidationErrorList) + } + + public void testGetRule() { + Validator validator = ESAPI.validator(); + ValidationRule rule = new StringValidationRule("rule"); + validator.addRule(rule); + assertEquals(rule, validator.getRule("rule")); + assertFalse(rule == validator.getRule("ridiculous")); + } + + public void testGetValidCreditCard() { + System.out.println("getValidCreditCard"); + Validator instance = ESAPI.validator(); + ValidationErrorList errors = new ValidationErrorList(); + + assertTrue(instance.isValidCreditCard("cctest1", "1234 9876 0000 0008", false)); + assertTrue(instance.isValidCreditCard("cctest2", "1234987600000008", false)); + assertFalse(instance.isValidCreditCard("cctest3", "12349876000000081", false)); + assertFalse(instance.isValidCreditCard("cctest4", "4417 1234 5678 9112", false)); + + instance.getValidCreditCard("cctest5", "1234 9876 0000 0008", false, errors); + assertEquals(0, errors.size()); + instance.getValidCreditCard("cctest6", "1234987600000008", false, errors); + assertEquals(0, errors.size()); + instance.getValidCreditCard("cctest7", "12349876000000081", false, errors); + assertEquals(1, errors.size()); + instance.getValidCreditCard("cctest8", "4417 1234 5678 9112", false, errors); + assertEquals(2, errors.size()); + + assertTrue(instance.isValidCreditCard("cctest1", "1234 9876 0000 0008", false, errors)); + assertTrue(errors.size()==2); + assertTrue(instance.isValidCreditCard("cctest2", "1234987600000008", false, errors)); + assertTrue(errors.size()==2); + assertFalse(instance.isValidCreditCard("cctest3", "12349876000000081", false, errors)); + assertTrue(errors.size()==3); + assertFalse(instance.isValidCreditCard("cctest4", "4417 1234 5678 9112", false, errors)); + assertTrue(errors.size()==4); + } + + public void testGetValidDate() throws Exception { + System.out.println("getValidDate"); + Validator instance = ESAPI.validator(); + ValidationErrorList errors = new ValidationErrorList(); + assertTrue(instance.getValidDate("datetest1", "June 23, 1967", DateFormat.getDateInstance(DateFormat.MEDIUM, Locale.US), false) != null); + instance.getValidDate("datetest2", "freakshow", DateFormat.getDateInstance(), false, errors); + assertEquals(1, errors.size()); + + // TODO: This test case fails due to an apparent bug in SimpleDateFormat + // Note: This seems to be fixed in JDK 6. Will leave it commented out since + // we only require JDK 5. -kww + instance.getValidDate("test", "June 32, 2008", DateFormat.getDateInstance(), false, errors); + // assertEquals( 2, errors.size() ); + } + + // FIXME: Should probably use SecurityConfigurationWrapper and force + // Validator.AcceptLenientDates to be false. + public void testLenientDate() { + System.out.println("testLenientDate"); + boolean acceptLenientDates = ESAPI.securityConfiguration().getLenientDatesAccepted(); + if ( acceptLenientDates ) { + assertTrue("Lenient date test skipped because Validator.AcceptLenientDates set to true", true); + return; + } + + Date lenientDateTest = null; + try { + // lenientDateTest will be null when Validator.AcceptLenientDates + // is set to false (the default). + Validator instance = ESAPI.validator(); + lenientDateTest = instance.getValidDate("datatest3-lenient", "15/2/2009 11:83:00", + DateFormat.getDateInstance(DateFormat.SHORT, Locale.US), + false); + fail("Failed to throw expected ValidationException when Validator.AcceptLenientDates set to false."); + } catch (ValidationException ve) { + assertNull( lenientDateTest ); + Throwable cause = ve.getCause(); + assertTrue( cause.getClass().getName().equals("java.text.ParseException") ); + } catch (Exception e) { + fail("Caught unexpected exception: " + e.getClass().getName() + "; msg: " + e); + } + } + + public void testGetValidDirectoryPath() throws Exception { + System.out.println("getValidDirectoryPath"); + Validator instance = ESAPI.validator(); + ValidationErrorList errors = new ValidationErrorList(); + // find a directory that exists + File parent = new File("/"); + String path = ESAPI.securityConfiguration().getResourceFile("ESAPI.properties").getParentFile().getCanonicalPath(); + instance.getValidDirectoryPath("dirtest1", path, parent, true, errors); + assertEquals(0, errors.size()); + instance.getValidDirectoryPath("dirtest2", null, parent, false, errors); + assertEquals(1, errors.size()); + instance.getValidDirectoryPath("dirtest3", "ridicul%00ous", parent, false, errors); + assertEquals(2, errors.size()); + } + + public void testGetValidDouble() { + System.out.println("getValidDouble"); + Validator instance = ESAPI.validator(); + ValidationErrorList errors = new ValidationErrorList(); + instance.getValidDouble("dtest1", "1.0", 0, 20, true, errors); + assertEquals(0, errors.size()); + instance.getValidDouble("dtest2", null, 0, 20, true, errors); + assertEquals(0, errors.size()); + instance.getValidDouble("dtest3", null, 0, 20, false, errors); + assertEquals(1, errors.size()); + instance.getValidDouble("dtest4", "ridiculous", 0, 20, true, errors); + assertEquals(2, errors.size()); + instance.getValidDouble("dtest5", "" + (Double.MAX_VALUE), 0, 20, true, errors); + assertEquals(3, errors.size()); + instance.getValidDouble("dtest6", "" + (Double.MAX_VALUE + .00001), 0, 20, true, errors); + assertEquals(4, errors.size()); + } + + public void testGetValidFileContent() { + System.out.println("getValidFileContent"); + Validator instance = ESAPI.validator(); + ValidationErrorList errors = new ValidationErrorList(); + byte[] bytes = null; + try { + bytes = "12345".getBytes(PREFERRED_ENCODING); + } + catch (UnsupportedEncodingException e) { + fail(PREFERRED_ENCODING + " not a supported encoding?!?!!"); + } + instance.getValidFileContent("test", bytes, 5, true, errors); + assertEquals(0, errors.size()); + instance.getValidFileContent("test", bytes, 4, true, errors); + assertEquals(1, errors.size()); + } + + public void testGetValidFileName() throws Exception { + System.out.println("getValidFileName"); + Validator instance = ESAPI.validator(); + ValidationErrorList errors = new ValidationErrorList(); + String testName = "aspe%20ct.jar"; + assertEquals("Percent encoding is not changed", testName, instance.getValidFileName("test", testName, ESAPI.securityConfiguration().getAllowedFileExtensions(), false, errors)); + } + + public void testGetValidInput() { + System.out.println("getValidInput"); + Validator instance = ESAPI.validator(); + ValidationErrorList errors = new ValidationErrorList(); + // instance.getValidInput(String, String, String, int, boolean, ValidationErrorList) + } + + public void testGetValidInteger() { + System.out.println("getValidInteger"); + Validator instance = ESAPI.validator(); + ValidationErrorList errors = new ValidationErrorList(); + // instance.getValidInteger(String, String, int, int, boolean, ValidationErrorList) + } + + public void testGetValidListItem() { + System.out.println("getValidListItem"); + Validator instance = ESAPI.validator(); + ValidationErrorList errors = new ValidationErrorList(); + // instance.getValidListItem(String, String, List, ValidationErrorList) + } + + public void testGetValidNumber() { + System.out.println("getValidNumber"); + Validator instance = ESAPI.validator(); + ValidationErrorList errors = new ValidationErrorList(); + // instance.getValidNumber(String, String, long, long, boolean, ValidationErrorList) + } + + public void testGetValidRedirectLocation() { + System.out.println("getValidRedirectLocation"); + Validator instance = ESAPI.validator(); + ValidationErrorList errors = new ValidationErrorList(); + // instance.getValidRedirectLocation(String, String, boolean, ValidationErrorList) + } + + public void testGetValidSafeHTML() throws Exception { + System.out.println("getValidSafeHTML"); + Validator instance = ESAPI.validator(); + ValidationErrorList errors = new ValidationErrorList(); + + // new school test case setup + HTMLValidationRule rule = new HTMLValidationRule("test"); + ESAPI.validator().addRule(rule); + + assertEquals("Test.", ESAPI.validator().getRule("test").getValid("test", "Test. ")); + + String test1 = "Jeff"; + String result1 = instance.getValidSafeHTML("test", test1, 100, false, errors); + assertEquals(test1, result1); + + String test2 = "Aspect Security"; + String result2 = instance.getValidSafeHTML("test", test2, 100, false, errors); + assertEquals(test2, result2); + + String test3 = "Test. "; + assertEquals("Test.", rule.getSafe("test", test3)); + + assertEquals("Test. <
load=alert()
", rule.getSafe("test", "Test. <
load=alert()")); + assertEquals("Test.
b
", rule.getSafe("test", "Test.
b
")); + assertEquals("Test. alert(document.cookie)", rule.getSafe("test", "Test. alert(document.cookie)")); + assertEquals("Test. alert(document.cookie)", rule.getSafe("test", "Test. alert(document.cookie)")); + assertEquals("Test. alert(document.cookie)", rule.getSafe("test", "Test. alert(document.cookie)")); + // TODO: ENHANCE waiting for a way to validate text headed for an attribute for scripts + // This would be nice to catch, but just looks like text to AntiSamy + // assertFalse(instance.isValidSafeHTML("test", "\" onload=\"alert(document.cookie)\" ")); + // String result4 = instance.getValidSafeHTML("test", test4); + // assertEquals("", result4); + } + + public void testIsInvalidFilename() { + System.out.println("testIsInvalidFilename"); + Validator instance = ESAPI.validator(); + char invalidChars[] = "/\\:*?\"<>|".toCharArray(); + for (int i = 0; i < invalidChars.length; i++) { + assertFalse(invalidChars[i] + " is an invalid character for a filename", + instance.isValidFileName("test", "as" + invalidChars[i] + "pect.jar", false)); + } + assertFalse("Files must have an extension", instance.isValidFileName("test", "", false)); + assertFalse("Files must have a valid extension", instance.isValidFileName("test.invalidExtension", "", false)); + assertFalse("Filennames cannot be the empty string", instance.isValidFileName("test", "", false)); + } + + public void testIsValidDate() { + System.out.println("isValidDate"); + Validator instance = ESAPI.validator(); + DateFormat format = SimpleDateFormat.getDateInstance(SimpleDateFormat.MEDIUM, Locale.US); + assertTrue(instance.isValidDate("datetest1", "September 11, 2001", format, true)); + assertFalse(instance.isValidDate("datetest2", null, format, false)); + assertFalse(instance.isValidDate("datetest3", "", format, false)); + + ValidationErrorList errors = new ValidationErrorList(); + assertTrue(instance.isValidDate("datetest1", "September 11, 2001", format, true, errors)); + assertTrue(errors.size()==0); + assertFalse(instance.isValidDate("datetest2", null, format, false, errors)); + assertTrue(errors.size()==1); + assertFalse(instance.isValidDate("datetest3", "", format, false, errors)); + assertTrue(errors.size()==2); + + } + + public void testIsValidDirectoryPath() throws IOException { + System.out.println("isValidDirectoryPath"); + + // get an encoder with a special list of codecs and make a validator out of it + List list = new ArrayList(); + list.add("HTMLEntityCodec"); + Encoder encoder = new DefaultEncoder(list); + Validator instance = new DefaultValidator(encoder); + + boolean isWindows = (System.getProperty("os.name").indexOf("Windows") != -1) ? true : false; + File parent = new File("/"); + + ValidationErrorList errors = new ValidationErrorList(); + + if (isWindows) { + String sysRoot = new File(System.getenv("SystemRoot")).getCanonicalPath(); + // Windows paths that don't exist and thus should fail + assertFalse(instance.isValidDirectoryPath("test", "c:\\ridiculous", parent, false)); + assertFalse(instance.isValidDirectoryPath("test", "c:\\jeff", parent, false)); + assertFalse(instance.isValidDirectoryPath("test", "c:\\temp\\..\\etc", parent, false)); + + // Windows paths + assertTrue(instance.isValidDirectoryPath("test", "C:\\", parent, false)); // Windows root directory + assertTrue(instance.isValidDirectoryPath("test", sysRoot, parent, false)); // Windows always exist directory + assertFalse(instance.isValidDirectoryPath("test", sysRoot + "\\System32\\cmd.exe", parent, false)); // Windows command shell + + // Unix specific paths should not pass + assertFalse(instance.isValidDirectoryPath("test", "/tmp", parent, false)); // Unix Temporary directory + assertFalse(instance.isValidDirectoryPath("test", "/bin/sh", parent, false)); // Unix Standard shell + assertFalse(instance.isValidDirectoryPath("test", "/etc/config", parent, false)); + + // Unix specific paths that should not exist or work + assertFalse(instance.isValidDirectoryPath("test", "/etc/ridiculous", parent, false)); + assertFalse(instance.isValidDirectoryPath("test", "/tmp/../etc", parent, false)); + + assertFalse(instance.isValidDirectoryPath("test1", "c:\\ridiculous", parent, false, errors)); + assertTrue(errors.size()==1); + assertFalse(instance.isValidDirectoryPath("test2", "c:\\jeff", parent, false, errors)); + assertTrue(errors.size()==2); + assertFalse(instance.isValidDirectoryPath("test3", "c:\\temp\\..\\etc", parent, false, errors)); + assertTrue(errors.size()==3); + + // Windows paths + assertTrue(instance.isValidDirectoryPath("test4", "C:\\", parent, false, errors)); // Windows root directory + assertTrue(errors.size()==3); + assertTrue(instance.isValidDirectoryPath("test5", sysRoot, parent, false, errors)); // Windows always exist directory + assertTrue(errors.size()==3); + assertFalse(instance.isValidDirectoryPath("test6", sysRoot + "\\System32\\cmd.exe", parent, false, errors)); // Windows command shell + assertTrue(errors.size()==4); + + // Unix specific paths should not pass + assertFalse(instance.isValidDirectoryPath("test7", "/tmp", parent, false, errors)); // Unix Temporary directory + assertTrue(errors.size()==5); + assertFalse(instance.isValidDirectoryPath("test8", "/bin/sh", parent, false, errors)); // Unix Standard shell + assertTrue(errors.size()==6); + assertFalse(instance.isValidDirectoryPath("test9", "/etc/config", parent, false, errors)); + assertTrue(errors.size()==7); + + // Unix specific paths that should not exist or work + assertFalse(instance.isValidDirectoryPath("test10", "/etc/ridiculous", parent, false, errors)); + assertTrue(errors.size()==8); + assertFalse(instance.isValidDirectoryPath("test11", "/tmp/../etc", parent, false, errors)); + assertTrue(errors.size()==9); + + } else { + // Windows paths should fail + assertFalse(instance.isValidDirectoryPath("test", "c:\\ridiculous", parent, false)); + assertFalse(instance.isValidDirectoryPath("test", "c:\\temp\\..\\etc", parent, false)); + + // Standard Windows locations should fail + assertFalse(instance.isValidDirectoryPath("test", "c:\\", parent, false)); // Windows root directory + assertFalse(instance.isValidDirectoryPath("test", "c:\\Windows\\temp", parent, false)); // Windows temporary directory + assertFalse(instance.isValidDirectoryPath("test", "c:\\Windows\\System32\\cmd.exe", parent, false)); // Windows command shell + + // Unix specific paths should pass + assertTrue(instance.isValidDirectoryPath("test", "/", parent, false)); // Root directory + assertTrue(instance.isValidDirectoryPath("test", "/bin", parent, false)); // Always exist directory + + // Unix specific paths that should not exist or work + assertFalse(instance.isValidDirectoryPath("test", "/bin/sh", parent, false)); // Standard shell, not dir + assertFalse(instance.isValidDirectoryPath("test", "/etc/ridiculous", parent, false)); + assertFalse(instance.isValidDirectoryPath("test", "/tmp/../etc", parent, false)); + + // Windows paths should fail + assertFalse(instance.isValidDirectoryPath("test1", "c:\\ridiculous", parent, false, errors)); + assertTrue(errors.size()==1); + assertFalse(instance.isValidDirectoryPath("test2", "c:\\temp\\..\\etc", parent, false, errors)); + assertTrue(errors.size()==2); + + // Standard Windows locations should fail + assertFalse(instance.isValidDirectoryPath("test3", "c:\\", parent, false, errors)); // Windows root directory + assertTrue(errors.size()==3); + assertFalse(instance.isValidDirectoryPath("test4", "c:\\Windows\\temp", parent, false, errors)); // Windows temporary directory + assertTrue(errors.size()==4); + assertFalse(instance.isValidDirectoryPath("test5", "c:\\Windows\\System32\\cmd.exe", parent, false, errors)); // Windows command shell + assertTrue(errors.size()==5); + + // Unix specific paths should pass + assertTrue(instance.isValidDirectoryPath("test6", "/", parent, false, errors)); // Root directory + assertTrue(errors.size()==5); + assertTrue(instance.isValidDirectoryPath("test7", "/bin", parent, false, errors)); // Always exist directory + assertTrue(errors.size()==5); + + // Unix specific paths that should not exist or work + assertFalse(instance.isValidDirectoryPath("test8", "/bin/sh", parent, false, errors)); // Standard shell, not dir + assertTrue(errors.size()==6); + assertFalse(instance.isValidDirectoryPath("test9", "/etc/ridiculous", parent, false, errors)); + assertTrue(errors.size()==7); + assertFalse(instance.isValidDirectoryPath("test10", "/tmp/../etc", parent, false, errors)); + assertTrue(errors.size()==8); + } + } + + public void TestIsValidDirectoryPath() { + // isValidDirectoryPath(String, String, boolean) + } + + public void testIsValidDouble() { + // isValidDouble(String, String, double, double, boolean) + Validator instance = ESAPI.validator(); + ValidationErrorList errors = new ValidationErrorList(); + //testing negative range + assertFalse(instance.isValidDouble("test1", "-4", 1, 10, false, errors)); + assertTrue(errors.size() == 1); + assertTrue(instance.isValidDouble("test2", "-4", -10, 10, false, errors)); + assertTrue(errors.size() == 1); + //testing null value + assertTrue(instance.isValidDouble("test3", null, -10, 10, true, errors)); + assertTrue(errors.size() == 1); + assertFalse(instance.isValidDouble("test4", null, -10, 10, false, errors)); + assertTrue(errors.size() == 2); + //testing empty string + assertTrue(instance.isValidDouble("test5", "", -10, 10, true, errors)); + assertTrue(errors.size() == 2); + assertFalse(instance.isValidDouble("test6", "", -10, 10, false, errors)); + assertTrue(errors.size() == 3); + //testing improper range + assertFalse(instance.isValidDouble("test7", "50.0", 10, -10, false, errors)); + assertTrue(errors.size() == 4); + //testing non-integers + assertTrue(instance.isValidDouble("test8", "4.3214", -10, 10, true, errors)); + assertTrue(errors.size() == 4); + assertTrue(instance.isValidDouble("test9", "-1.65", -10, 10, true, errors)); + assertTrue(errors.size() == 4); + //other testing + assertTrue(instance.isValidDouble("test10", "4", 1, 10, false, errors)); + assertTrue(errors.size() == 4); + assertTrue(instance.isValidDouble("test11", "400", 1, 10000, false, errors)); + assertTrue(errors.size() == 4); + assertTrue(instance.isValidDouble("test12", "400000000", 1, 400000000, false, errors)); + assertTrue(errors.size() == 4); + assertFalse(instance.isValidDouble("test13", "4000000000000", 1, 10000, false, errors)); + assertTrue(errors.size() == 5); + assertFalse(instance.isValidDouble("test14", "alsdkf", 10, 10000, false, errors)); + assertTrue(errors.size() == 6); + assertFalse(instance.isValidDouble("test15", "--10", 10, 10000, false, errors)); + assertTrue(errors.size() == 7); + assertFalse(instance.isValidDouble("test16", "14.1414234x", 10, 10000, false, errors)); + assertTrue(errors.size() == 8); + assertFalse(instance.isValidDouble("test17", "Infinity", 10, 10000, false, errors)); + assertTrue(errors.size() == 9); + assertFalse(instance.isValidDouble("test18", "-Infinity", 10, 10000, false, errors)); + assertTrue(errors.size() == 10); + assertFalse(instance.isValidDouble("test19", "NaN", 10, 10000, false, errors)); + assertTrue(errors.size() == 11); + assertFalse(instance.isValidDouble("test20", "-NaN", 10, 10000, false, errors)); + assertTrue(errors.size() == 12); + assertFalse(instance.isValidDouble("test21", "+NaN", 10, 10000, false, errors)); + assertTrue(errors.size() == 13); + assertTrue(instance.isValidDouble("test22", "1e-6", -999999999, 999999999, false, errors)); + assertTrue(errors.size() == 13); + assertTrue(instance.isValidDouble("test23", "-1e-6", -999999999, 999999999, false, errors)); + assertTrue(errors.size() == 13); + } + + public void testIsValidFileContent() { + System.out.println("isValidFileContent"); + byte[] content = null; + try { + content = "This is some file content".getBytes(PREFERRED_ENCODING); + } + catch (UnsupportedEncodingException e) { + fail(PREFERRED_ENCODING + " not a supported encoding?!?!!!"); + } + Validator instance = ESAPI.validator(); + assertTrue(instance.isValidFileContent("test", content, 100, false)); + } + + public void testIsValidFileName() { + System.out.println("isValidFileName"); + Validator instance = ESAPI.validator(); + assertTrue("Simple valid filename with a valid extension", instance.isValidFileName("test", "aspect.jar", false)); + assertTrue("All valid filename characters are accepted", instance.isValidFileName("test", "!@#$%^&{}[]()_+-=,.~'` abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ1234567890.jar", false)); + assertTrue("Legal filenames that decode to legal filenames are accepted", instance.isValidFileName("test", "aspe%20ct.jar", false)); + + ValidationErrorList errors = new ValidationErrorList(); + assertTrue("Simple valid filename with a valid extension", instance.isValidFileName("test", "aspect.jar", false, errors)); + assertTrue("All valid filename characters are accepted", instance.isValidFileName("test", "!@#$%^&{}[]()_+-=,.~'` abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ1234567890.jar", false, errors)); + assertTrue("Legal filenames that decode to legal filenames are accepted", instance.isValidFileName("test", "aspe%20ct.jar", false, errors)); + assertTrue(errors.size() == 0); + } + + public void testIsValidFileUpload() throws IOException { + System.out.println("isValidFileUpload"); + String filepath = new File(System.getProperty("user.dir")).getCanonicalPath(); + String filename = "aspect.jar"; + File parent = new File("/").getCanonicalFile(); + ValidationErrorList errors = new ValidationErrorList(); + byte[] content = null; + try { + content = "This is some file content".getBytes(PREFERRED_ENCODING); + } + catch (UnsupportedEncodingException e) { + fail(PREFERRED_ENCODING + " not a supported encoding?!?!!!"); + } + Validator instance = ESAPI.validator(); + assertTrue(instance.isValidFileUpload("test", filepath, filename, parent, content, 100, false)); + assertTrue(instance.isValidFileUpload("test", filepath, filename, parent, content, 100, false, errors)); + assertTrue(errors.size() == 0); + + filepath = "/ridiculous"; + filename = "aspect.jar"; + try { + content = "This is some file content".getBytes(PREFERRED_ENCODING); + } + catch (UnsupportedEncodingException e) { + fail(PREFERRED_ENCODING + " not a supported encoding?!?!!!"); + } + assertFalse(instance.isValidFileUpload("test", filepath, filename, parent, content, 100, false)); + assertFalse(instance.isValidFileUpload("test", filepath, filename, parent, content, 100, false, errors)); + assertTrue(errors.size() == 1); + } + + public void testIsValidHTTPRequestParameterSet() { + // isValidHTTPRequestParameterSet(String, Set, Set) + } + + public void testisValidInput() { + System.out.println("isValidInput"); + Validator instance = ESAPI.validator(); + assertTrue(instance.isValidInput("test", "jeff.williams@aspectsecurity.com", "Email", 100, false)); + assertFalse(instance.isValidInput("test", "jeff.williams@@aspectsecurity.com", "Email", 100, false)); + assertFalse(instance.isValidInput("test", "jeff.williams@aspectsecurity", "Email", 100, false)); + assertTrue(instance.isValidInput("test", "jeff.wil'liams@aspectsecurity.com", "Email", 100, false)); + assertTrue(instance.isValidInput("test", "jeff.wil''liams@aspectsecurity.com", "Email", 100, false)); + assertTrue(instance.isValidInput("test", "123.168.100.234", "IPAddress", 100, false)); + assertTrue(instance.isValidInput("test", "192.168.1.234", "IPAddress", 100, false)); + assertFalse(instance.isValidInput("test", "..168.1.234", "IPAddress", 100, false)); + assertFalse(instance.isValidInput("test", "10.x.1.234", "IPAddress", 100, false)); + assertTrue(instance.isValidInput("test", "http://www.aspectsecurity.com", "URL", 100, false)); + assertFalse(instance.isValidInput("test", "http:///www.aspectsecurity.com", "URL", 100, false)); + assertFalse(instance.isValidInput("test", "http://www.aspect security.com", "URL", 100, false)); + assertTrue(instance.isValidInput("test", "078-05-1120", "SSN", 100, false)); + assertTrue(instance.isValidInput("test", "078 05 1120", "SSN", 100, false)); + assertTrue(instance.isValidInput("test", "078051120", "SSN", 100, false)); + assertFalse(instance.isValidInput("test", "987-65-4320", "SSN", 100, false)); + assertFalse(instance.isValidInput("test", "000-00-0000", "SSN", 100, false)); + assertFalse(instance.isValidInput("test", "(555) 555-5555", "SSN", 100, false)); + assertFalse(instance.isValidInput("test", "test", "SSN", 100, false)); + assertTrue(instance.isValidInput("test", "jeffWILLIAMS123", "HTTPParameterValue", 100, false)); + assertTrue(instance.isValidInput("test", "jeff .-/+=@_ WILLIAMS", "HTTPParameterValue", 100, false)); + // Removed per Issue 116 - The '*' character is valid as a parameter character +// assertFalse(instance.isValidInput("test", "jeff*WILLIAMS", "HTTPParameterValue", 100, false)); + assertFalse(instance.isValidInput("test", "jeff^WILLIAMS", "HTTPParameterValue", 100, false)); + assertFalse(instance.isValidInput("test", "jeff\\WILLIAMS", "HTTPParameterValue", 100, false)); + + assertTrue(instance.isValidInput("test", null, "Email", 100, true)); + assertFalse(instance.isValidInput("test", null, "Email", 100, false)); + + ValidationErrorList errors = new ValidationErrorList(); + + assertTrue(instance.isValidInput("test1", "jeff.williams@aspectsecurity.com", "Email", 100, false, errors)); + assertTrue(errors.size()==0); + assertFalse(instance.isValidInput("test2", "jeff.williams@@aspectsecurity.com", "Email", 100, false, errors)); + assertTrue(errors.size()==1); + assertFalse(instance.isValidInput("test3", "jeff.williams@aspectsecurity", "Email", 100, false, errors)); + assertTrue(errors.size()==2); + assertTrue(instance.isValidInput("test4", "jeff.wil'liams@aspectsecurity.com", "Email", 100, false, errors)); + assertTrue(errors.size()==2); + assertTrue(instance.isValidInput("test5", "jeff.wil''liams@aspectsecurity.com", "Email", 100, false, errors)); + assertTrue(errors.size()==2); + assertTrue(instance.isValidInput("test6", "123.168.100.234", "IPAddress", 100, false, errors)); + assertTrue(errors.size()==2); + assertTrue(instance.isValidInput("test7", "192.168.1.234", "IPAddress", 100, false, errors)); + assertTrue(errors.size()==2); + assertFalse(instance.isValidInput("test8", "..168.1.234", "IPAddress", 100, false, errors)); + assertTrue(errors.size()==3); + assertFalse(instance.isValidInput("test9", "10.x.1.234", "IPAddress", 100, false, errors)); + assertTrue(errors.size()==4); + assertTrue(instance.isValidInput("test10", "http://www.aspectsecurity.com", "URL", 100, false, errors)); + assertTrue(errors.size()==4); + assertFalse(instance.isValidInput("test11", "http:///www.aspectsecurity.com", "URL", 100, false, errors)); + assertTrue(errors.size()==5); + assertFalse(instance.isValidInput("test12", "http://www.aspect security.com", "URL", 100, false, errors)); + assertTrue(errors.size()==6); + assertTrue(instance.isValidInput("test13", "078-05-1120", "SSN", 100, false, errors)); + assertTrue(errors.size()==6); + assertTrue(instance.isValidInput("test14", "078 05 1120", "SSN", 100, false, errors)); + assertTrue(errors.size()==6); + assertTrue(instance.isValidInput("test15", "078051120", "SSN", 100, false, errors)); + assertTrue(errors.size()==6); + assertFalse(instance.isValidInput("test16", "987-65-4320", "SSN", 100, false, errors)); + assertTrue(errors.size()==7); + assertFalse(instance.isValidInput("test17", "000-00-0000", "SSN", 100, false, errors)); + assertTrue(errors.size()==8); + assertFalse(instance.isValidInput("test18", "(555) 555-5555", "SSN", 100, false, errors)); + assertTrue(errors.size()==9); + assertFalse(instance.isValidInput("test19", "test", "SSN", 100, false, errors)); + assertTrue(errors.size()==10); + assertTrue(instance.isValidInput("test20", "jeffWILLIAMS123", "HTTPParameterValue", 100, false, errors)); + assertTrue(errors.size()==10); + assertTrue(instance.isValidInput("test21", "jeff .-/+=@_ WILLIAMS", "HTTPParameterValue", 100, false, errors)); + assertTrue(errors.size()==10); + // Removed per Issue 116 - The '*' character is valid as a parameter character +// assertFalse(instance.isValidInput("test", "jeff*WILLIAMS", "HTTPParameterValue", 100, false)); + assertFalse(instance.isValidInput("test22", "jeff^WILLIAMS", "HTTPParameterValue", 100, false, errors)); + assertTrue(errors.size()==11); + assertFalse(instance.isValidInput("test23", "jeff\\WILLIAMS", "HTTPParameterValue", 100, false, errors)); + assertTrue(errors.size()==12); + + assertTrue(instance.isValidInput("test", null, "Email", 100, true, errors)); + assertFalse(instance.isValidInput("test", null, "Email", 100, false, errors)); + } + + public void testIsValidInteger() { + System.out.println("isValidInteger"); + Validator instance = ESAPI.validator(); + //testing negative range + assertFalse(instance.isValidInteger("test", "-4", 1, 10, false)); + assertTrue(instance.isValidInteger("test", "-4", -10, 10, false)); + //testing null value + assertTrue(instance.isValidInteger("test", null, -10, 10, true)); + assertFalse(instance.isValidInteger("test", null, -10, 10, false)); + //testing empty string + assertTrue(instance.isValidInteger("test", "", -10, 10, true)); + assertFalse(instance.isValidInteger("test", "", -10, 10, false)); + //testing improper range + assertFalse(instance.isValidInteger("test", "50", 10, -10, false)); + //testing non-integers + assertFalse(instance.isValidInteger("test", "4.3214", -10, 10, true)); + assertFalse(instance.isValidInteger("test", "-1.65", -10, 10, true)); + //other testing + assertTrue(instance.isValidInteger("test", "4", 1, 10, false)); + assertTrue(instance.isValidInteger("test", "400", 1, 10000, false)); + assertTrue(instance.isValidInteger("test", "400000000", 1, 400000000, false)); + assertFalse(instance.isValidInteger("test", "4000000000000", 1, 10000, false)); + assertFalse(instance.isValidInteger("test", "alsdkf", 10, 10000, false)); + assertFalse(instance.isValidInteger("test", "--10", 10, 10000, false)); + assertFalse(instance.isValidInteger("test", "14.1414234x", 10, 10000, false)); + assertFalse(instance.isValidInteger("test", "Infinity", 10, 10000, false)); + assertFalse(instance.isValidInteger("test", "-Infinity", 10, 10000, false)); + assertFalse(instance.isValidInteger("test", "NaN", 10, 10000, false)); + assertFalse(instance.isValidInteger("test", "-NaN", 10, 10000, false)); + assertFalse(instance.isValidInteger("test", "+NaN", 10, 10000, false)); + assertFalse(instance.isValidInteger("test", "1e-6", -999999999, 999999999, false)); + assertFalse(instance.isValidInteger("test", "-1e-6", -999999999, 999999999, false)); + + ValidationErrorList errors = new ValidationErrorList(); + //testing negative range + assertFalse(instance.isValidInteger("test1", "-4", 1, 10, false, errors)); + assertTrue(errors.size() == 1); + assertTrue(instance.isValidInteger("test2", "-4", -10, 10, false, errors)); + assertTrue(errors.size() == 1); + //testing null value + assertTrue(instance.isValidInteger("test3", null, -10, 10, true, errors)); + assertTrue(errors.size() == 1); + assertFalse(instance.isValidInteger("test4", null, -10, 10, false, errors)); + assertTrue(errors.size() == 2); + //testing empty string + assertTrue(instance.isValidInteger("test5", "", -10, 10, true, errors)); + assertTrue(errors.size() == 2); + assertFalse(instance.isValidInteger("test6", "", -10, 10, false, errors)); + assertTrue(errors.size() == 3); + //testing improper range + assertFalse(instance.isValidInteger("test7", "50", 10, -10, false, errors)); + assertTrue(errors.size() == 4); + //testing non-integers + assertFalse(instance.isValidInteger("test8", "4.3214", -10, 10, true, errors)); + assertTrue(errors.size() == 5); + assertFalse(instance.isValidInteger("test9", "-1.65", -10, 10, true, errors)); + assertTrue(errors.size() == 6); + //other testing + assertTrue(instance.isValidInteger("test10", "4", 1, 10, false, errors)); + assertTrue(errors.size() == 6); + assertTrue(instance.isValidInteger("test11", "400", 1, 10000, false, errors)); + assertTrue(errors.size() == 6); + assertTrue(instance.isValidInteger("test12", "400000000", 1, 400000000, false, errors)); + assertTrue(errors.size() == 6); + assertFalse(instance.isValidInteger("test13", "4000000000000", 1, 10000, false, errors)); + assertTrue(errors.size() == 7); + assertFalse(instance.isValidInteger("test14", "alsdkf", 10, 10000, false, errors)); + assertTrue(errors.size() == 8); + assertFalse(instance.isValidInteger("test15", "--10", 10, 10000, false, errors)); + assertTrue(errors.size() == 9); + assertFalse(instance.isValidInteger("test16", "14.1414234x", 10, 10000, false, errors)); + assertTrue(errors.size() == 10); + assertFalse(instance.isValidInteger("test17", "Infinity", 10, 10000, false, errors)); + assertTrue(errors.size() == 11); + assertFalse(instance.isValidInteger("test18", "-Infinity", 10, 10000, false, errors)); + assertTrue(errors.size() == 12); + assertFalse(instance.isValidInteger("test19", "NaN", 10, 10000, false, errors)); + assertTrue(errors.size() == 13); + assertFalse(instance.isValidInteger("test20", "-NaN", 10, 10000, false, errors)); + assertTrue(errors.size() == 14); + assertFalse(instance.isValidInteger("test21", "+NaN", 10, 10000, false, errors)); + assertTrue(errors.size() == 15); + assertFalse(instance.isValidInteger("test22", "1e-6", -999999999, 999999999, false, errors)); + assertTrue(errors.size() == 16); + assertFalse(instance.isValidInteger("test23", "-1e-6", -999999999, 999999999, false, errors)); + assertTrue(errors.size() == 17); + + } + + public void testIsValidListItem() { + System.out.println("isValidListItem"); + Validator instance = ESAPI.validator(); + List list = new ArrayList(); + list.add("one"); + list.add("two"); + assertTrue(instance.isValidListItem("test", "one", list)); + assertFalse(instance.isValidListItem("test", "three", list)); + + ValidationErrorList errors = new ValidationErrorList(); + assertTrue(instance.isValidListItem("test1", "one", list, errors)); + assertTrue(errors.size()==0); + assertFalse(instance.isValidListItem("test2", "three", list, errors)); + assertTrue(errors.size()==1); + } + + public void testIsValidNumber() { + System.out.println("isValidNumber"); + Validator instance = ESAPI.validator(); + //testing negative range + assertFalse(instance.isValidNumber("test", "-4", 1, 10, false)); + assertTrue(instance.isValidNumber("test", "-4", -10, 10, false)); + //testing null value + assertTrue(instance.isValidNumber("test", null, -10, 10, true)); + assertFalse(instance.isValidNumber("test", null, -10, 10, false)); + //testing empty string + assertTrue(instance.isValidNumber("test", "", -10, 10, true)); + assertFalse(instance.isValidNumber("test", "", -10, 10, false)); + //testing improper range + assertFalse(instance.isValidNumber("test", "5", 10, -10, false)); + //testing non-integers + assertTrue(instance.isValidNumber("test", "4.3214", -10, 10, true)); + assertTrue(instance.isValidNumber("test", "-1.65", -10, 10, true)); + //other testing + assertTrue(instance.isValidNumber("test", "4", 1, 10, false)); + assertTrue(instance.isValidNumber("test", "400", 1, 10000, false)); + assertTrue(instance.isValidNumber("test", "400000000", 1, 400000000, false)); + assertFalse(instance.isValidNumber("test", "4000000000000", 1, 10000, false)); + assertFalse(instance.isValidNumber("test", "alsdkf", 10, 10000, false)); + assertFalse(instance.isValidNumber("test", "--10", 10, 10000, false)); + assertFalse(instance.isValidNumber("test", "14.1414234x", 10, 10000, false)); + assertFalse(instance.isValidNumber("test", "Infinity", 10, 10000, false)); + assertFalse(instance.isValidNumber("test", "-Infinity", 10, 10000, false)); + assertFalse(instance.isValidNumber("test", "NaN", 10, 10000, false)); + assertFalse(instance.isValidNumber("test", "-NaN", 10, 10000, false)); + assertFalse(instance.isValidNumber("test", "+NaN", 10, 10000, false)); + assertTrue(instance.isValidNumber("test", "1e-6", -999999999, 999999999, false)); + assertTrue(instance.isValidNumber("test", "-1e-6", -999999999, 999999999, false)); + + ValidationErrorList errors = new ValidationErrorList(); + //testing negative range + assertFalse(instance.isValidNumber("test1", "-4", 1, 10, false, errors)); + assertTrue(errors.size()==1); + assertTrue(instance.isValidNumber("test2", "-4", -10, 10, false, errors)); + assertTrue(errors.size()==1); + //testing null value + assertTrue(instance.isValidNumber("test3", null, -10, 10, true, errors)); + assertTrue(errors.size()==1); + assertFalse(instance.isValidNumber("test4", null, -10, 10, false, errors)); + assertTrue(errors.size()==2); + //testing empty string + assertTrue(instance.isValidNumber("test5", "", -10, 10, true, errors)); + assertTrue(errors.size()==2); + assertFalse(instance.isValidNumber("test6", "", -10, 10, false, errors)); + assertTrue(errors.size()==3); + //testing improper range + assertFalse(instance.isValidNumber("test7", "5", 10, -10, false, errors)); + assertTrue(errors.size()==4); + //testing non-integers + assertTrue(instance.isValidNumber("test8", "4.3214", -10, 10, true, errors)); + assertTrue(errors.size()==4); + assertTrue(instance.isValidNumber("test9", "-1.65", -10, 10, true, errors)); + assertTrue(errors.size()==4); + //other testing + assertTrue(instance.isValidNumber("test10", "4", 1, 10, false, errors)); + assertTrue(errors.size()==4); + assertTrue(instance.isValidNumber("test11", "400", 1, 10000, false, errors)); + assertTrue(errors.size()==4); + assertTrue(instance.isValidNumber("test12", "400000000", 1, 400000000, false, errors)); + assertTrue(errors.size()==4); + assertFalse(instance.isValidNumber("test13", "4000000000000", 1, 10000, false, errors)); + assertTrue(errors.size()==5); + assertFalse(instance.isValidNumber("test14", "alsdkf", 10, 10000, false, errors)); + assertTrue(errors.size()==6); + assertFalse(instance.isValidNumber("test15", "--10", 10, 10000, false, errors)); + assertTrue(errors.size()==7); + assertFalse(instance.isValidNumber("test16", "14.1414234x", 10, 10000, false, errors)); + assertTrue(errors.size()==8); + assertFalse(instance.isValidNumber("test17", "Infinity", 10, 10000, false, errors)); + assertTrue(errors.size()==9); + assertFalse(instance.isValidNumber("test18", "-Infinity", 10, 10000, false, errors)); + assertTrue(errors.size()==10); + assertFalse(instance.isValidNumber("test19", "NaN", 10, 10000, false, errors)); + assertTrue(errors.size()==11); + assertFalse(instance.isValidNumber("test20", "-NaN", 10, 10000, false, errors)); + assertTrue(errors.size()==12); + assertFalse(instance.isValidNumber("test21", "+NaN", 10, 10000, false, errors)); + assertTrue(errors.size()==13); + assertTrue(instance.isValidNumber("test22", "1e-6", -999999999, 999999999, false, errors)); + assertTrue(errors.size()==13); + assertTrue(instance.isValidNumber("test23", "-1e-6", -999999999, 999999999, false, errors)); + assertTrue(errors.size()==13); + } + + public void testIsValidParameterSet() { + System.out.println("isValidParameterSet"); + Set requiredNames = new HashSet(); + requiredNames.add("p1"); + requiredNames.add("p2"); + requiredNames.add("p3"); + Set optionalNames = new HashSet(); + optionalNames.add("p4"); + optionalNames.add("p5"); + optionalNames.add("p6"); + MockHttpServletRequest request = new MockHttpServletRequest(); + MockHttpServletResponse response = new MockHttpServletResponse(); + request.addParameter("p1", "value"); + request.addParameter("p2", "value"); + request.addParameter("p3", "value"); + ESAPI.httpUtilities().setCurrentHTTP(request, response); + Validator instance = ESAPI.validator(); + ValidationErrorList errors = new ValidationErrorList(); + assertTrue(instance.isValidHTTPRequestParameterSet("HTTPParameters", request, requiredNames, optionalNames)); + assertTrue(instance.isValidHTTPRequestParameterSet("HTTPParameters", request, requiredNames, optionalNames,errors)); + assertTrue(errors.size()==0); + request.addParameter("p4", "value"); + request.addParameter("p5", "value"); + request.addParameter("p6", "value"); + assertTrue(instance.isValidHTTPRequestParameterSet("HTTPParameters", request, requiredNames, optionalNames)); + assertTrue(instance.isValidHTTPRequestParameterSet("HTTPParameters", request, requiredNames, optionalNames, errors)); + assertTrue(errors.size()==0); + request.removeParameter("p1"); + assertFalse(instance.isValidHTTPRequestParameterSet("HTTPParameters", request, requiredNames, optionalNames)); + assertFalse(instance.isValidHTTPRequestParameterSet("HTTPParameters", request, requiredNames, optionalNames, errors)); + assertTrue(errors.size() ==1); + } + + public void testIsValidPrintable() { + System.out.println("isValidPrintable"); + Validator instance = ESAPI.validator(); + assertTrue(instance.isValidPrintable("name", "abcDEF", 100, false)); + assertTrue(instance.isValidPrintable("name", "!@#R()*$;><()", 100, false)); + char[] chars = {0x60, (char) 0xFF, 0x10, 0x25}; + assertFalse(instance.isValidPrintable("name", chars, 100, false)); + assertFalse(instance.isValidPrintable("name", "%08", 100, false)); + + ValidationErrorList errors = new ValidationErrorList(); + assertTrue(instance.isValidPrintable("name1", "abcDEF", 100, false, errors)); + assertTrue(errors.size()==0); + assertTrue(instance.isValidPrintable("name2", "!@#R()*$;><()", 100, false, errors)); + assertTrue(errors.size()==0); + assertFalse(instance.isValidPrintable("name3", chars, 100, false, errors)); + assertTrue(errors.size()==1); + assertFalse(instance.isValidPrintable("name4", "%08", 100, false, errors)); + assertTrue(errors.size()==2); + + } + + public void testIsValidRedirectLocation() { + // isValidRedirectLocation(String, String, boolean) + } + + public void testIsValidSafeHTML() { + System.out.println("isValidSafeHTML"); + Validator instance = ESAPI.validator(); + + assertTrue(instance.isValidSafeHTML("test", "Jeff", 100, false)); + assertTrue(instance.isValidSafeHTML("test", "Aspect Security", 100, false)); + assertTrue(instance.isValidSafeHTML("test", "Test. ", 100, false)); + assertTrue(instance.isValidSafeHTML("test", "Test.
", 100, false)); + assertTrue(instance.isValidSafeHTML("test", "Test. alert(document.cookie)", 100, false)); + assertTrue(instance.isValidSafeHTML("test", "Test. alert(document.cookie)", 100, false)); + assertTrue(instance.isValidSafeHTML("test", "Test. alert(document.cookie)", 100, false)); + + // TODO: waiting for a way to validate text headed for an attribute for scripts + // This would be nice to catch, but just looks like text to AntiSamy + // assertFalse(instance.isValidSafeHTML("test", "\" onload=\"alert(document.cookie)\" ")); + ValidationErrorList errors = new ValidationErrorList(); + assertTrue(instance.isValidSafeHTML("test1", "Jeff", 100, false, errors)); + assertTrue(instance.isValidSafeHTML("test2", "Aspect Security", 100, false, errors)); + assertTrue(instance.isValidSafeHTML("test3", "Test. ", 100, false, errors)); + assertTrue(instance.isValidSafeHTML("test4", "Test.
", 100, false, errors)); + assertTrue(instance.isValidSafeHTML("test5", "Test. alert(document.cookie)", 100, false, errors)); + assertTrue(instance.isValidSafeHTML("test6", "Test. alert(document.cookie)", 100, false, errors)); + assertTrue(instance.isValidSafeHTML("test7", "Test. alert(document.cookie)", 100, false, errors)); + assertTrue(errors.size() == 0); + + } + + public void testSafeReadLine() { + System.out.println("safeReadLine"); + + byte[] bytes = null; + try { + bytes = "testString".getBytes(PREFERRED_ENCODING); + } + catch (UnsupportedEncodingException e1) { + fail(PREFERRED_ENCODING + " not a supported encoding?!?!!!"); + } + ByteArrayInputStream s = new ByteArrayInputStream(bytes); + Validator instance = ESAPI.validator(); + try { + instance.safeReadLine(s, -1); + fail(); + } + catch (ValidationException e) { + // Expected + } + s.reset(); + try { + instance.safeReadLine(s, 4); + fail(); + } + catch (ValidationException e) { + // Expected + } + s.reset(); + try { + String u = instance.safeReadLine(s, 20); + assertEquals("testString", u); + } + catch (ValidationException e) { + fail(); + } + + // This sub-test attempts to validate that BufferedReader.readLine() and safeReadLine() are similar in operation + // for the nominal case + try { + s.reset(); + InputStreamReader isr = new InputStreamReader(s); + BufferedReader br = new BufferedReader(isr); + String u = br.readLine(); + s.reset(); + String v = instance.safeReadLine(s, 20); + assertEquals(u, v); + } + catch (IOException e) { + fail(); + } + catch (ValidationException e) { + fail(); + } + } + + public void testIssue82_SafeString_Bad_Regex() { + Validator instance = ESAPI.validator(); + try { + instance.getValidInput("address", "55 main st. pasadena ak", "SafeString", 512, false); + } + catch (ValidationException e) { + fail(e.getLogMessage()); + } + } + + public void testGetParameterMap() { +//testing Validator.HTTPParameterName and Validator.HTTPParameterValue + MockHttpServletRequest request = new MockHttpServletRequest(); + SecurityWrapperRequest safeRequest = new SecurityWrapperRequest(request); +//an example of a parameter from displaytag, should pass + request.addParameter("d-49653-p", "pass"); + request.addParameter(""); + request.addParameter("f2", ""); + request.addParameter("f3", ""); + for (int i = 1; i <= 4; i++) { + assertTrue(safeRequest.getParameter("p" + i).equals(request.getParameter("p" + i))); + } + for (int i = 1; i <= 2; i++) { + boolean testResult = false; + try { + testResult = safeRequest.getParameter("f" + i).equals(request.getParameter("f" + i)); + } catch (NullPointerException npe) { + //the test is this block SHOULD fail. a NPE is an acceptable failure state + testResult = false; //redundant, just being descriptive here + } + assertFalse(testResult); + } + assertNull(safeRequest.getParameter("e1")); + + //This is revealing problems with Jeff's original SafeRequest + //mishandling of the AllowNull parameter. I'm adding a new Google code + //bug to track this. + // + //assertNotNull(safeRequest.getParameter("e1", false)); + } + + public void testGetCookies() { +//testing Validator.HTTPCookieName and Validator.HTTPCookieValue + MockHttpServletRequest request = new MockHttpServletRequest(); + SecurityWrapperRequest safeRequest = new SecurityWrapperRequest(request); +//should support a base64-encode value + request.setCookie("p1", "34=VJhjv7jiDu7tsdLrQQ2KcUwpfWUM2_mBae6UA8ttk4wBHdxxQ-1IBxyCOn3LWE08SDhpnBcJ7N5Vze48F2t8a1R_hXt7PX1BvgTM0pn-T4JkqGTm_tlmV4RmU3GT-dgn"); + request.setCookie("f1", "XSS"); + request.setCookie("load-balancing", "pass"); + request.setCookie("'bypass", "fail"); + Cookie[] cookies = safeRequest.getCookies(); + assertEquals(cookies[0].getValue(), request.getCookies()[0].getValue()); + assertEquals(cookies[1].getName(), request.getCookies()[2].getName()); + assertTrue(cookies.length == 2); + } + + public void testGetHeader() { +//testing Validator.HTTPHeaderValue + MockHttpServletRequest request = new MockHttpServletRequest(); + SecurityWrapperRequest safeRequest = new SecurityWrapperRequest(request); + request.addHeader("p1", "login"); + request.addHeader("f1", "XSS"); + request.addHeader("p2", generateStringOfLength(150)); + request.addHeader("f2", generateStringOfLength(151)); + assertEquals(safeRequest.getHeader("p1"), request.getHeader("p1")); + assertEquals(safeRequest.getHeader("p2"), request.getHeader("p2")); + assertFalse(safeRequest.getHeader("f1").equals(request.getHeader("f1"))); + assertFalse(safeRequest.getHeader("f2").equals(request.getHeader("f2"))); + assertNull(safeRequest.getHeader("p3")); + } + + public void testGetHeaderNames() { +//testing Validator.HTTPHeaderName + MockHttpServletRequest request = new MockHttpServletRequest(); + SecurityWrapperRequest safeRequest = new SecurityWrapperRequest(request); + request.addHeader("d-49653-p", "pass"); + request.addHeader(""); + assertFalse(safeRequest.getQueryString().equals(request.getQueryString())); + request.setQueryString("mail=bob@alice.com-passwd=johny"); + assertTrue(safeRequest.getQueryString().equals(request.getQueryString())); + request.setQueryString("mail=bob@alice.com-passwd=johny&special"); //= is missing! + assertFalse(safeRequest.getQueryString().equals(request.getQueryString())); + } + + public void testGetRequestURI() { +//testing Validator.HTTPURI + MockHttpServletRequest request = new MockHttpServletRequest(); + SecurityWrapperRequest safeRequest = new SecurityWrapperRequest(request); + try { + request.setRequestURI("/app/page.jsp"); + } catch (UnsupportedEncodingException ignored) { + } + assertEquals(safeRequest.getRequestURI(), request.getRequestURI()); + } + + private String generateStringOfLength(int length) { + StringBuilder longString = new StringBuilder(); + for (int i = 0; i < length; i++) { + longString.append("a"); + } + return longString.toString(); + } + + public void testGetContextPath() { + // Root Context Path ("") + assertTrue(ESAPI.validator().isValidInput("HTTPContextPath", "", "HTTPContextPath", 512, true)); + // Deployed Context Path ("/context") + assertTrue(ESAPI.validator().isValidInput("HTTPContextPath", "/context", "HTTPContextPath", 512, true)); + // Fail-case - URL Splitting + assertFalse(ESAPI.validator().isValidInput("HTTPContextPath", "/\\nGET http://evil.com", "HTTPContextPath", 512, true)); + } +} From 7b50eb7794827e4d08b0df89cd6b3055a84a3d2c Mon Sep 17 00:00:00 2001 From: kwwall Date: Wed, 30 Dec 2015 00:42:39 -0500 Subject: [PATCH 058/812] Specified minimum version # of 3.0 for Maven based on this error message: [ERROR] Project does not define required minimum version of Maven. [ERROR] Update the pom.xml to contain [ERROR] [ERROR] 3.0 [ERROR] --- pom.xml | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/pom.xml b/pom.xml index 89c9b250d..8ef61a99f 100644 --- a/pom.xml +++ b/pom.xml @@ -6,6 +6,10 @@ 2.1.1-SNAPSHOT jar + + 3.0 + + org.sonatype.oss oss-parent From ffe93c79ed386f70d4c0c06acfac5c41e19e1bac Mon Sep 17 00:00:00 2001 From: kwwall Date: Wed, 30 Dec 2015 00:45:03 -0500 Subject: [PATCH 059/812] Added protected CTORs taking (String userMessage) and (String userMessage, Throwable cause) arguments so that classes (e.g., such as IntrusionException) could sub-class these classes without compilation errors. --- .../errors/EnterpriseSecurityException.java | 28 +++++++++++++++++- .../EnterpriseSecurityRuntimeException.java | 29 ++++++++++++++++++- 2 files changed, 55 insertions(+), 2 deletions(-) diff --git a/src/main/java/org/owasp/esapi/errors/EnterpriseSecurityException.java b/src/main/java/org/owasp/esapi/errors/EnterpriseSecurityException.java index a09df2c41..8c6d46114 100644 --- a/src/main/java/org/owasp/esapi/errors/EnterpriseSecurityException.java +++ b/src/main/java/org/owasp/esapi/errors/EnterpriseSecurityException.java @@ -48,12 +48,38 @@ public class EnterpriseSecurityException extends Exception { protected String logMessage = null; /** - * Instantiates a new security exception. + * Instantiates a new enterprise security exception. */ protected EnterpriseSecurityException() { // hidden } + /** + * Instantiates a new enterprise security exception with a user message. + * (Needed by anything which subclasses this.) + * + * @param userMessage Message displayed to user. + */ + protected EnterpriseSecurityException(String userMessage) { + // hidden + super(userMessage); + } + + /** + * Instantiates a new enterprise security exception with a user message + * and cause. (Needed by anything which subclasses this.) + * + * @param userMessage Message displayed to user. + * @param cause The cause (which is saved for later retrieval by the + * getCause() method). (A null value is permitted, and indicates that the + * cause is nonexistent or unknown.) + */ + protected EnterpriseSecurityException(String userMessage, Throwable cause) + { + // hidden + super(userMessage, cause); + } + /** * Creates a new instance of EnterpriseSecurityException. This exception is automatically logged, so that simply by * using this API, applications will generate an extensive security log. In addition, this exception is diff --git a/src/main/java/org/owasp/esapi/errors/EnterpriseSecurityRuntimeException.java b/src/main/java/org/owasp/esapi/errors/EnterpriseSecurityRuntimeException.java index 5f746f4b6..6dab2a54c 100644 --- a/src/main/java/org/owasp/esapi/errors/EnterpriseSecurityRuntimeException.java +++ b/src/main/java/org/owasp/esapi/errors/EnterpriseSecurityRuntimeException.java @@ -50,12 +50,39 @@ public class EnterpriseSecurityRuntimeException extends java.lang.RuntimeExcepti protected String logMessage = null; /** - * Instantiates a new security exception. + * Instantiates a new enterprise security runtime exception. */ protected EnterpriseSecurityRuntimeException() { // hidden } + /** + * Instantiates a new enterprise security runtime exception with a user + * message. (Needed by anything which subclasses this.) + * + * @param userMessage Message displayed to user. + */ + protected EnterpriseSecurityRuntimeException(String userMessage) { + super(userMessage); + } + + /** + * Instantiates a new enterprise security runtime exception with a + * user message and cause. (Needed by anything which subclasses this.) + * + * @param userMessage Message displayed to user. + * @param cause The cause (which is saved for later retrieval by the + * getCause() method). (A null value is permitted, and indicates that the + * cause is nonexistent or unknown.) + */ + protected EnterpriseSecurityRuntimeException(String userMessage, + Throwable cause) + { + // hidden + super(userMessage, cause); + } + + /** * Creates a new instance of EnterpriseSecurityException. This exception is automatically logged, so that simply by * using this API, applications will generate an extensive security log. In addition, this exception is From cd9d412fe51bf0a2826fdbc0abfdce23faf2fffe Mon Sep 17 00:00:00 2001 From: kwwall Date: Wed, 30 Dec 2015 00:50:27 -0500 Subject: [PATCH 060/812] To properly fix Google Issue #212 (i.e., GitHub issue #229), IntrusionException needed to subclass EnterpriseSecurityRuntimeException, not EnterpriseSecurityException. --- src/main/java/org/owasp/esapi/errors/IntrusionException.java | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/main/java/org/owasp/esapi/errors/IntrusionException.java b/src/main/java/org/owasp/esapi/errors/IntrusionException.java index 6332f297b..718f8a7c3 100644 --- a/src/main/java/org/owasp/esapi/errors/IntrusionException.java +++ b/src/main/java/org/owasp/esapi/errors/IntrusionException.java @@ -28,7 +28,7 @@ * * @author Jeff Williams (jeff.williams@aspectsecurity.com) */ -public class IntrusionException extends EnterpriseSecurityException { +public class IntrusionException extends EnterpriseSecurityRuntimeException { /** The Constant serialVersionUID. */ private static final long serialVersionUID = 1L; From c644f320d1d0f2bad11340845bf55d7747025200 Mon Sep 17 00:00:00 2001 From: kwwall Date: Thu, 31 Dec 2015 01:00:27 -0500 Subject: [PATCH 061/812] Changes being committed: Modified files: pom.xml Updated to newer version of dependency-check and some 3rd party jars have been updated. src/main/java/org/owasp/esapi/HTTPUtilities.java Javadoc updated. src/main/java/org/owasp/esapi/SecurityConfiguration.java Changed to extend the new EsapiPropertyLoader class. Deprecated many methods in favor of the new API to that the interface is not so bloated. src/main/java/org/owasp/esapi/reference/DefaultHTTPUtilities.java Minor changes to import statements and sendRedirect(HttpServletResponse,String) method. src/test/java/org/owasp/esapi/SecurityConfigurationWrapper.java Implements the 4 new methods (getIntProp(), getByteArrayProp(), etc.) from EsapiPropertyLoader interface. src/test/java/org/owasp/esapi/reference/ValidatorTest.java Cleanup of import statements. src/test/java/org/owasp/esapi/reference/HTTPUtilitiesTest.java Cleanup of import statements. ======================== New files: documentation/ESAPI-configuration-user-guide.md User documentation for new configuration features. src/main/java/org/owasp/esapi/configuration/AbstractPrioritizedPropertyLoader.java src/main/java/org/owasp/esapi/configuration/EsapiPropertyLoader.java src/main/java/org/owasp/esapi/configuration/EsapiPropertyLoaderFactory.java src/main/java/org/owasp/esapi/configuration/EsapiPropertyManager.java src/main/java/org/owasp/esapi/configuration/StandardEsapiPropertyLoader.java src/main/java/org/owasp/esapi/configuration/XmlEsapiPropertyLoader.java src/main/java/org/owasp/esapi/configuration/consts/EsapiConfiguration.java src/main/java/org/owasp/esapi/configuration/consts/EsapiConfigurationType.java src/main/resources/ESAPI-properties.xsd src/test/java/org/owasp/esapi/configuration/EsapiPropertyManagerTest.java src/test/java/org/owasp/esapi/configuration/StandardEsapiPropertyLoaderTest.java src/test/java/org/owasp/esapi/configuration/XmlEsapiPropertyLoaderTest.java src/test/resources/ESAPI-properties.xsd src/test/resources/esapi/ESAPI-test-2.properties src/test/resources/esapi/ESAPI-test-2.xml src/test/resources/esapi/ESAPI-test-invalid-content.xml src/test/resources/esapi/ESAPI-test.properties src/test/resources/esapi/ESAPI-test.xml Files used in implementing or testing new configuration properties. --- .../ESAPI-configuration-user-guide.md | 138 ++++++++ pom.xml | 10 +- .../java/org/owasp/esapi/HTTPUtilities.java | 1 - .../owasp/esapi/SecurityConfiguration.java | 132 ++++++- .../AbstractPrioritizedPropertyLoader.java | 62 ++++ .../configuration/EsapiPropertyLoader.java | 43 +++ .../EsapiPropertyLoaderFactory.java | 36 ++ .../configuration/EsapiPropertyManager.java | 99 ++++++ .../StandardEsapiPropertyLoader.java | 105 ++++++ .../configuration/XmlEsapiPropertyLoader.java | 134 +++++++ .../consts/EsapiConfiguration.java | 33 ++ .../consts/EsapiConfigurationType.java | 19 + .../esapi/reference/DefaultHTTPUtilities.java | 5 +- .../DefaultSecurityConfiguration.java | 130 +++++-- src/main/resources/ESAPI-properties.xsd | 17 + .../esapi/SecurityConfigurationWrapper.java | 22 ++ .../EsapiPropertyManagerTest.java | 327 ++++++++++++++++++ .../StandardEsapiPropertyLoaderTest.java | 268 ++++++++++++++ .../XmlEsapiPropertyLoaderTest.java | 269 ++++++++++++++ .../esapi/reference/HTTPUtilitiesTest.java | 14 +- .../owasp/esapi/reference/ValidatorTest.java | 17 +- src/test/resources/ESAPI-properties.xsd | 17 + .../resources/esapi/ESAPI-test-2.properties | 5 + src/test/resources/esapi/ESAPI-test-2.xml | 6 + .../esapi/ESAPI-test-invalid-content.xml | 7 + .../resources/esapi/ESAPI-test.properties | 8 + src/test/resources/esapi/ESAPI-test.xml | 10 + 27 files changed, 1875 insertions(+), 59 deletions(-) create mode 100644 documentation/ESAPI-configuration-user-guide.md create mode 100644 src/main/java/org/owasp/esapi/configuration/AbstractPrioritizedPropertyLoader.java create mode 100644 src/main/java/org/owasp/esapi/configuration/EsapiPropertyLoader.java create mode 100644 src/main/java/org/owasp/esapi/configuration/EsapiPropertyLoaderFactory.java create mode 100644 src/main/java/org/owasp/esapi/configuration/EsapiPropertyManager.java create mode 100644 src/main/java/org/owasp/esapi/configuration/StandardEsapiPropertyLoader.java create mode 100644 src/main/java/org/owasp/esapi/configuration/XmlEsapiPropertyLoader.java create mode 100644 src/main/java/org/owasp/esapi/configuration/consts/EsapiConfiguration.java create mode 100644 src/main/java/org/owasp/esapi/configuration/consts/EsapiConfigurationType.java create mode 100644 src/main/resources/ESAPI-properties.xsd create mode 100644 src/test/java/org/owasp/esapi/configuration/EsapiPropertyManagerTest.java create mode 100644 src/test/java/org/owasp/esapi/configuration/StandardEsapiPropertyLoaderTest.java create mode 100644 src/test/java/org/owasp/esapi/configuration/XmlEsapiPropertyLoaderTest.java create mode 100644 src/test/resources/ESAPI-properties.xsd create mode 100644 src/test/resources/esapi/ESAPI-test-2.properties create mode 100644 src/test/resources/esapi/ESAPI-test-2.xml create mode 100644 src/test/resources/esapi/ESAPI-test-invalid-content.xml create mode 100644 src/test/resources/esapi/ESAPI-test.properties create mode 100644 src/test/resources/esapi/ESAPI-test.xml diff --git a/documentation/ESAPI-configuration-user-guide.md b/documentation/ESAPI-configuration-user-guide.md new file mode 100644 index 000000000..72694bb05 --- /dev/null +++ b/documentation/ESAPI-configuration-user-guide.md @@ -0,0 +1,138 @@ +# ESAPI security configuration API enhancements - user guide + +## Motivation +High number of open Google Issues against security configuration component +highlighted problem with ESAPI configuration. Moreover, the rules for how and +where the ESAPI.properties file is found are overly complicated making questions +about it one of the most frequently asked questions. + +The ESAPI interface for its configuration (SecurityConfiguration) is overly +complicated; it has a 'getter' method specific to almost every ESAPI +configuration property. This complication leads to a unduly intricate, +non-modular reference implementation (DefaultSecurityConfiguration) that makes +it difficult to extend in terms of new functionality; e.g., when desiring to +introduce a new ESAPI property name in ESAPI.properties. + +A new, simpler security configuration interface and implementation is needed. +Such an implementation would not only be useful for ESAPI 2.x, but could very +well be used to build the configurator needed by ESAPI 3. + +This document describes following changes to ESAPI security API: + +1. API simplification +2. XML configuration support. +3. Multiple configuration files support. + +## API simplification + +New interface is introduced: EsapiPropertyLoader, which contains four general +methods for extraction of configuration properties: + +``` +public int getIntProp(String propertyName) throws ConfigurationException; +public byte[] getByteArrayProp(String propertyName) throws ConfigurationException; +public Boolean getBooleanProp(String propertyName) throws ConfigurationException; +public String getStringProp(String propertyName) throws ConfigurationException; +``` + +SecurityConfiguration interface is extended with this new contract. Old methods +have been deprecated as a result, in favor of these new methods. (TBD how long +until these deprecated methods are removed, but it will be a minumum of 2 years +or 1 major release [e.g., 3.x], whichever comes first. Also, we may not +necessarily remove all of them at once, depending on community feedback.) + +DefaultSecurityConfiguration implements the new contract. New contract methods implementations work as described in +'Multiple configuration files support' paragraph. + +## Multiple configuration files support + +EsapiPropertyManager is the new implementation for getting properties, which uses prioritized property loaders (each one associated with a specific configuration file). This allows to have multiple configuration files existing with priority connected to each one. At this moment, there +are two configuration files possible to use, the path to them is set through following Java +system properties: + +* org.owasp.esapi.opsteam = (higher priority config) +* org.owasp.esapi.devteam = (lower priority config) + +The first is intended for deployment by an operations team responsible for +enforcing security for configuration management enterprise-wide. The intent here +is to allow this operations team to enforce global / company-wide policies such +as the minimum encryption key size or permitted cryptographic algorithms. + +The second is intended for deployment by development teams and is more likely to +be useful and be tailored for each individual project based on project needs. + +If an ESAPI property is set via the configuration file identified by +org.owasp.esapi.opsteam then that property takes precedence over any property +set by the configuration file identified by org.owasp.esapi.devteam system +property. (A warning message will be logged if a property defined in the higher +priority configuration file is also defined in the configuration file of lower +priority.) + +The DefaultSecurityConfiguration class now uses this mechanism through the new +API for retrieving properties. + +It is not mandatory to have both files configured or even any of them for +DefaultSecurityConfiguration to work property. It can still use the single +ESAPI.properties to search for a property. In case of any of the configurations +or both of the existing, ESAPI.properties has LOWEST priority, so it will be +searched as last. + +### Example properties extraction through DefaultSecurityConfiguration + +```java +ESAPI.securityConfiguration().getBooleanProp("propertyXXX"); +``` + +where "propertyXXX" is some property name relevant to ESAPI (and +in this case, one that would hold a boolean value). See ESAPI.properties +for a list of current property names known to ESAPI. + +In above example, following happens: + +1. org.owasp.esapi.opsteam configuration is used to get propertyXXX and return it as boolean. +2. If (1) fails to find property, org.owasp.esapi.devteam is used to get propertyXXX and return it as boolean. +3. If (2) fails to find property, ESAPI.properties is used to get propertyXXX and return it as boolean. +4. If (3) fails to find property, unchecked ConfigurationException will be thrown. + +A ConfigurationException will be also thrown if propertyXXX was found in one +of the configurations, but it is impossible to convert it to boolean value. + +## XML configuration support + +XML configuration storage is supported. Both org.owasp.esapi.opsteam and +org.owasp.esapi.devteam can be XML files, but they must comply to the +following XSD schema: + +```xml + + + + + + + + + + + + + + + + + +``` + +### XML configuration example: +``` + + + test_string_property + 5 + invalid int + true + yes + no + invalid boolean + +``` diff --git a/pom.xml b/pom.xml index 8ef61a99f..79f870d2f 100644 --- a/pom.xml +++ b/pom.xml @@ -187,6 +187,14 @@ antisamy 1.5.3 + + + org.apache.xmlgraphics + batik-css + 1.8 + + + @@ -329,7 +337,7 @@ org.owasp dependency-check-maven - 1.1.4 + 1.2.11 false diff --git a/src/main/java/org/owasp/esapi/HTTPUtilities.java b/src/main/java/org/owasp/esapi/HTTPUtilities.java index 77fcd8284..6402796c8 100644 --- a/src/main/java/org/owasp/esapi/HTTPUtilities.java +++ b/src/main/java/org/owasp/esapi/HTTPUtilities.java @@ -445,7 +445,6 @@ public interface HTTPUtilities * @param response * @param location the URL to forward to, including parameters * @throws AccessControlException - * @throws ServletException * @throws IOException */ void sendRedirect(HttpServletResponse response, String location) throws AccessControlException, IOException; diff --git a/src/main/java/org/owasp/esapi/SecurityConfiguration.java b/src/main/java/org/owasp/esapi/SecurityConfiguration.java index 9c54acb9c..9d37c2580 100644 --- a/src/main/java/org/owasp/esapi/SecurityConfiguration.java +++ b/src/main/java/org/owasp/esapi/SecurityConfiguration.java @@ -16,6 +16,8 @@ */ package org.owasp.esapi; +import org.owasp.esapi.configuration.EsapiPropertyLoader; + import java.io.File; import java.io.IOException; import java.io.InputStream; @@ -48,53 +50,71 @@ * href="http://www.aspectsecurity.com">Aspect Security * @since June 1, 2007 */ -public interface SecurityConfiguration { +public interface SecurityConfiguration extends EsapiPropertyLoader { /** * Gets the application name, used for logging * * @return the name of the current application + * @deprecated Use SecurityConfiguration.getStringProp("appropriate_esapi_prop_name") instead. */ + @Deprecated public String getApplicationName(); /** * Returns the fully qualified classname of the ESAPI Logging implementation. + * @deprecated Use SecurityConfiguration.getStringProp("appropriate_esapi_prop_name") instead. */ + @Deprecated public String getLogImplementation(); /** * Returns the fully qualified classname of the ESAPI Authentication implementation. + * @deprecated Use SecurityConfiguration.getStringProp("appropriate_esapi_prop_name") instead. */ + @Deprecated public String getAuthenticationImplementation(); /** * Returns the fully qualified classname of the ESAPI Encoder implementation. + * @deprecated Use SecurityConfiguration.getStringProp("appropriate_esapi_prop_name") instead. */ + @Deprecated public String getEncoderImplementation(); /** * Returns the fully qualified classname of the ESAPI Access Control implementation. + * @deprecated Use SecurityConfiguration.getStringProp("appropriate_esapi_prop_name") instead. */ + @Deprecated public String getAccessControlImplementation(); /** * Returns the fully qualified classname of the ESAPI Intrusion Detection implementation. + * @deprecated Use SecurityConfiguration.getStringProp("appropriate_esapi_prop_name") instead. */ + @Deprecated public String getIntrusionDetectionImplementation(); /** * Returns the fully qualified classname of the ESAPI Randomizer implementation. + * @deprecated Use SecurityConfiguration.getStringProp("appropriate_esapi_prop_name") instead. */ + @Deprecated public String getRandomizerImplementation(); /** * Returns the fully qualified classname of the ESAPI Encryption implementation. + * @deprecated Use SecurityConfiguration.getStringProp("appropriate_esapi_prop_name") instead. */ + @Deprecated public String getEncryptionImplementation(); /** * Returns the fully qualified classname of the ESAPI Validation implementation. + * @deprecated Use SecurityConfiguration.getStringProp("appropriate_esapi_prop_name") instead. */ + @Deprecated public String getValidationImplementation(); /** @@ -112,17 +132,23 @@ public interface SecurityConfiguration { * * @return True if lenient dates are accepted; false otherwise. * @see java.text.DateFormat#setLenient(boolean) + * @deprecated Use SecurityConfiguration.getBooleanProp("appropriate_esapi_prop_name") instead. */ + @Deprecated public boolean getLenientDatesAccepted(); /** * Returns the fully qualified classname of the ESAPI OS Execution implementation. + * @deprecated Use SecurityConfiguration.getStringProp("appropriate_esapi_prop_name") instead. */ + @Deprecated public String getExecutorImplementation(); /** * Returns the fully qualified classname of the ESAPI HTTPUtilities implementation. + * @deprecated Use SecurityConfiguration.getStringProp("appropriate_esapi_prop_name") instead. */ + @Deprecated public String getHTTPUtilitiesImplementation(); /** @@ -130,7 +156,9 @@ public interface SecurityConfiguration { * of data that need to be protected by your application. * * @return the current master key + * @deprecated Use SecurityConfiguration.getByteArrayProp("appropriate_esapi_prop_name") instead. */ + @Deprecated public byte[] getMasterKey(); /** @@ -149,7 +177,9 @@ public interface SecurityConfiguration { * Gets the key length to use in cryptographic operations declared in the ESAPI properties file. * * @return the key length. + * @deprecated Use SecurityConfiguration.getIntProp("appropriate_esapi_prop_name") instead. */ + @Deprecated public int getEncryptionKeyLength(); /** @@ -157,7 +187,9 @@ public interface SecurityConfiguration { * where a salt is needed. * * @return the current master salt + * @deprecated Use SecurityConfiguration.getByteArrayProp("appropriate_esapi_prop_name") instead. */ + @Deprecated public byte[] getMasterSalt(); /** @@ -178,21 +210,27 @@ public interface SecurityConfiguration { * Gets the maximum allowed file upload size. * * @return the current allowed file upload size + * @deprecated Use SecurityConfiguration.getIntProp("appropriate_esapi_prop_name") instead. */ + @Deprecated public int getAllowedFileUploadSize(); /** * Gets the name of the password parameter used during user authentication. * * @return the name of the password parameter + * @deprecated Use SecurityConfiguration.getStringProp("appropriate_esapi_prop_name") instead. */ + @Deprecated public String getPasswordParameterName(); /** * Gets the name of the username parameter used during user authentication. * * @return the name of the username parameter + * @deprecated Use SecurityConfiguration.getStringProp("appropriate_esapi_prop_name") instead. */ + @Deprecated public String getUsernameParameterName(); /** @@ -202,7 +240,9 @@ public interface SecurityConfiguration { * and padding schemes. * * @return the current encryption algorithm + * @deprecated Use SecurityConfiguration.getStringProp("appropriate_esapi_prop_name") instead. */ + @Deprecated public String getEncryptionAlgorithm(); /** @@ -244,7 +284,9 @@ public interface SecurityConfiguration { * not the reference JCE implementation of "SunJCE"), and therefore it * should be avoided. * @return The cipher transformation. + * @deprecated Use SecurityConfiguration.getStringProp("appropriate_esapi_prop_name") instead. */ + @Deprecated public String getCipherTransformation(); /** @@ -269,7 +311,9 @@ public interface SecurityConfiguration { * completed the encryption / decryption with the new cipher * transformation. * @deprecated To be replaced by new class in ESAPI 2.1, but here if you need it - * until then. Details of replacement forthcoming to ESAPI-Dev list. + * until then. Details of replacement forthcoming to ESAPI-Dev + * list. Most likely to be replaced by a new public CTOR for + * JavaEncryptor that takes a list of properties to override. */ @Deprecated public String setCipherTransformation(String cipherXform); @@ -289,7 +333,9 @@ public interface SecurityConfiguration { * changed. * @return The property {@code Encryptor.PreferredJCEProvider} is returned. * @see org.owasp.esapi.crypto.SecurityProviderLoader + * @deprecated Use SecurityConfiguration.getStringProp("appropriate_esapi_prop_name") instead. */ + @Deprecated public String getPreferredJCEProvider(); // TODO - DISCUSS: Where should this web page (below) go? Maybe with the Javadoc? But where? @@ -306,7 +352,9 @@ public interface SecurityConfiguration { * "Why Is OWASP Changing ESAPI Encryption?". *

* @return {@code true} if a you want a MAC to be used, otherwise {@code false}. + * @deprecated Use SecurityConfiguration.getBooleanProp("appropriate_esapi_prop_name") instead. */ + @Deprecated public boolean useMACforCipherText(); /** @@ -322,7 +370,9 @@ public interface SecurityConfiguration { *

* @return True if it is OK to overwrite the {@code PlainText} objects * after encrypting, false otherwise. + * @deprecated Use SecurityConfiguration.getBooleanProp("appropriate_esapi_prop_name") instead. */ + @Deprecated public boolean overwritePlainText(); /** @@ -335,14 +385,23 @@ public interface SecurityConfiguration { * @return A string specifying the IV type. Should be "random" or "fixed". * * @see #getFixedIV() + * @deprecated Use SecurityConfiguration.getStringProp("appropriate_esapi_prop_name") instead. */ + @Deprecated public String getIVType(); /** * If a "fixed" (i.e., static) Initialization Vector (IV) is to be used, * this will return the IV value as a hex-encoded string. * @return The fixed IV as a hex-encoded string. + * @deprecated Short term: use SecurityConfiguration.getByteArrayProp("appropriate_esapi_prop_name") + * instead. Longer term: There will be a more general method in JavaEncryptor + * to explicitly set an IV. This whole concept of a single fixed IV has + * always been a kludge at best, as a concession to those who have used + * a single fixed IV in the past. It's time to put it to death + * as it was never intended for production in the first place. */ + @Deprecated public String getFixedIV(); /** @@ -366,7 +425,7 @@ public interface SecurityConfiguration { /** * Return {@code List} of strings of additional cipher modes that are * permitted (i.e., in addition to those returned by - * {@link #getPreferredCipherModes()}) to be used for encryption and + * {@link #getCombinedCipherModes()}) to be used for encryption and * decryption operations. *

* The list is taken from the comma-separated list of cipher modes specified @@ -377,7 +436,7 @@ public interface SecurityConfiguration { * was specified in {@code ESAPI.properties}; otherwise the empty list is * returned. * - * @see #getPreferredCipherModes() + * @see #getCombinedCipherModes() */ public List getAdditionalAllowedCipherModes(); @@ -385,14 +444,18 @@ public interface SecurityConfiguration { * Gets the hashing algorithm used by ESAPI to hash data. * * @return the current hashing algorithm + * @deprecated Use SecurityConfiguration.getStringProp("appropriate_esapi_prop_name") instead. */ + @Deprecated public String getHashAlgorithm(); /** * Gets the hash iterations used by ESAPI to hash data. * * @return the current hashing algorithm + * @deprecated Use SecurityConfiguration.getIntProp("appropriate_esapi_prop_name") instead. */ + @Deprecated public int getHashIterations(); /** @@ -400,7 +463,9 @@ public interface SecurityConfiguration { * Key Derivation Function (KDF). * * @return The KDF PRF algorithm name. + * @deprecated Use SecurityConfiguration.getStringProp("appropriate_esapi_prop_name") instead. */ + @Deprecated public String getKDFPseudoRandomFunction(); /** @@ -413,21 +478,27 @@ public interface SecurityConfiguration { * getResponseContentType(). * * @return the current character encoding scheme + * @deprecated Use SecurityConfiguration.getStringProp("appropriate_esapi_prop_name") instead. */ + @Deprecated public String getCharacterEncoding(); /** * Return true if multiple encoding is allowed * * @return whether multiple encoding is allowed when canonicalizing data + * @deprecated Use SecurityConfiguration.getBooleanProp("appropriate_esapi_prop_name") instead. */ + @Deprecated public boolean getAllowMultipleEncoding(); /** * Return true if mixed encoding is allowed * * @return whether mixed encoding is allowed when canonicalizing data + * @deprecated Use SecurityConfiguration.getBooleanProp("appropriate_esapi_prop_name") instead. */ + @Deprecated public boolean getAllowMixedEncoding(); /** @@ -441,21 +512,27 @@ public interface SecurityConfiguration { * Gets the digital signature algorithm used by ESAPI to generate and verify signatures. * * @return the current digital signature algorithm + * @deprecated Use SecurityConfiguration.getStringProp("appropriate_esapi_prop_name") instead. */ + @Deprecated public String getDigitalSignatureAlgorithm(); /** * Gets the digital signature key length used by ESAPI to generate and verify signatures. * * @return the current digital signature key length + * @deprecated Use SecurityConfiguration.getIntProp("appropriate_esapi_prop_name") instead. */ + @Deprecated public int getDigitalSignatureKeyLength(); /** * Gets the random number generation algorithm used to generate random numbers where needed. * * @return the current random number generation algorithm + * @deprecated Use SecurityConfiguration.getStringProp("appropriate_esapi_prop_name") instead. */ + @Deprecated public String getRandomAlgorithm(); /** @@ -463,7 +540,9 @@ public interface SecurityConfiguration { * many failures are detected within the alloted time period, the user's account will be locked. * * @return the number of failed login attempts that cause an account to be locked + * @deprecated Use SecurityConfiguration.getIntProp("appropriate_esapi_prop_name") instead. */ + @Deprecated public int getAllowedLoginAttempts(); /** @@ -472,14 +551,18 @@ public interface SecurityConfiguration { * when they change their password. * * @return the number of old hashed passwords to retain + * @deprecated Use SecurityConfiguration.getIntProp("appropriate_esapi_prop_name") instead. */ + @Deprecated public int getMaxOldPasswordHashes(); /** * Allows for complete disabling of all intrusion detection mechanisms * * @return true if intrusion detection should be disabled + * @deprecated Use SecurityConfiguration.getBooleanProp("appropriate_esapi_prop_name") instead. */ + @Deprecated public boolean getDisableIntrusionDetection(); /** @@ -500,28 +583,38 @@ public interface SecurityConfiguration { public File getResourceFile( String filename ); /** - * Forces new cookies to have HttpOnly flag set. + * Returns true if session cookies are required to have HttpOnly flag set. + * @deprecated Use SecurityConfiguration.getBooleanProp("appropriate_esapi_prop_name") instead. */ + @Deprecated public boolean getForceHttpOnlySession() ; /** - * Forces session cookies to have Secure flag set. + * Returns true if session cookies are required to have Secure flag set. + * @deprecated Use SecurityConfiguration.getBooleanProp("appropriate_esapi_prop_name") instead. */ + @Deprecated public boolean getForceSecureSession() ; /** - * Forces new cookies to have HttpOnly flag set. + * Returns true if new cookies are required to have HttpOnly flag set. + * @deprecated Use SecurityConfiguration.getBooleanProp("appropriate_esapi_prop_name") instead. */ + @Deprecated public boolean getForceHttpOnlyCookies() ; /** - * Forces new cookies to have Secure flag set. + * Returns true if new cookies are required to have Secure flag set. + * @deprecated Use SecurityConfiguration.getBooleanProp("appropriate_esapi_prop_name") instead. */ + @Deprecated public boolean getForceSecureCookies() ; /** * Returns the maximum allowable HTTP header size. + * @deprecated Use SecurityConfiguration.getIntProp("appropriate_esapi_prop_name") instead. */ + @Deprecated public int getMaxHttpHeaderSize() ; /** @@ -548,7 +641,9 @@ public interface SecurityConfiguration { * getCharacterEncoding(). * * @return The current content-type set for responses. + * @deprecated Use SecurityConfiguration.getStringProp("appropriate_esapi_prop_name") instead. */ + @Deprecated public String getResponseContentType(); /** @@ -556,14 +651,17 @@ public interface SecurityConfiguration { * likely "JSESSIONID" though this can be overridden. * * @return The name of the session identifier, like "JSESSIONID" + * @deprecated Use SecurityConfiguration.getStringProp("appropriate_esapi_prop_name") instead. */ + @Deprecated public String getHttpSessionIdName(); /** * Gets the length of the time to live window for remember me tokens (in milliseconds). * - * @return The time to live length for generated remember me tokens. + * @return The time to live length for generated "remember me" tokens. */ + // OPEN ISSUE: Can we replace w/ SecurityConfiguration.getIntProp("appropriate_esapi_prop_name") instead? public long getRememberTokenDuration(); @@ -573,7 +671,9 @@ public interface SecurityConfiguration { * function that enables a session to continue after reauthentication. * * @return The session idle timeout length. + * @deprecated Use SecurityConfiguration.getIntProp("appropriate_esapi_prop_name") instead. */ + @Deprecated public int getSessionIdleTimeoutLength(); /** @@ -582,7 +682,9 @@ public interface SecurityConfiguration { * provide a reauthenticate function that enables a session to continue after reauthentication. * * @return The session absolute timeout length. + * @deprecated Use SecurityConfiguration.getIntProp("appropriate_esapi_prop_name") instead. */ + @Deprecated public int getSessionAbsoluteTimeoutLength(); @@ -590,7 +692,9 @@ public interface SecurityConfiguration { * Returns whether HTML entity encoding should be applied to log entries. * * @return True if log entries are to be HTML Entity encoded. False otherwise. + * @deprecated Use SecurityConfiguration.getBooleanProp("appropriate_esapi_prop_name") instead. */ + @Deprecated public boolean getLogEncodingRequired(); /** @@ -598,7 +702,9 @@ public interface SecurityConfiguration { * single-server/single-app environments. * * @return True if ESAPI should log the application name, False otherwise + * @deprecated Use SecurityConfiguration.getBooleanProp("appropriate_esapi_prop_name") instead. */ + @Deprecated public boolean getLogApplicationName(); /** @@ -606,13 +712,17 @@ public interface SecurityConfiguration { * single-server environments. * * @return True if ESAPI should log the server IP and port, False otherwise + * @deprecated Use SecurityConfiguration.getBooleanProp("appropriate_esapi_prop_name") instead. */ + @Deprecated public boolean getLogServerIP(); /** * Returns the current log level. * @return An integer representing the current log level. + * @deprecated Use SecurityConfiguration.getIntProp("appropriate_esapi_prop_name") instead. */ + @Deprecated public int getLogLevel(); /** @@ -620,7 +730,9 @@ public interface SecurityConfiguration { * if it is not specified. * * @return the log file name defined in the properties file. + * @deprecated Use SecurityConfiguration.getStringProp("appropriate_esapi_prop_name") instead. */ + @Deprecated public String getLogFileName(); /** @@ -628,7 +740,9 @@ public interface SecurityConfiguration { * if it is not specified. Once the log hits this file size, it will roll over into a new log. * * @return the maximum size of a single log file (in bytes). + * @deprecated Use SecurityConfiguration.getIntProp("appropriate_esapi_prop_name") instead. */ + @Deprecated public int getMaxLogFileSize(); /** diff --git a/src/main/java/org/owasp/esapi/configuration/AbstractPrioritizedPropertyLoader.java b/src/main/java/org/owasp/esapi/configuration/AbstractPrioritizedPropertyLoader.java new file mode 100644 index 000000000..75e6497c7 --- /dev/null +++ b/src/main/java/org/owasp/esapi/configuration/AbstractPrioritizedPropertyLoader.java @@ -0,0 +1,62 @@ +package org.owasp.esapi.configuration; + + +import java.io.File; +import java.util.Properties; + +public abstract class AbstractPrioritizedPropertyLoader implements EsapiPropertyLoader, + Comparable { + + protected final String filename; + protected Properties properties; + + private final int priority; + + public AbstractPrioritizedPropertyLoader(String filename, int priority) { + this.priority = priority; + this.filename = filename; + initProperties(); + } + + /** + * Get priority of this property loader. If two and more loaders can return value for the same property key, + * the one with highest priority will be chosen. + * @return priority of this property loader + */ + public int priority() { + return priority; + } + + @Override + public int compareTo(AbstractPrioritizedPropertyLoader compared) { + if (this.priority > compared.priority()) { + return 1; + } else if (this.priority < compared.priority()) { + return -1; + } + return 0; + } + + public String name() { + return filename; + } + + /** + * Initializes properties object and fills it with data from configuration file. + */ + protected void initProperties() { + properties = new Properties(); + File file = new File(filename); + if (file.exists() && file.isFile()) { + loadPropertiesFromFile(file); + } else { + System.err.println("Configuration file " + filename + " does not exist"); + } + } + + /** + * Method that loads the data from configuration file to properties object. + * @param file + */ + protected abstract void loadPropertiesFromFile(File file); +} diff --git a/src/main/java/org/owasp/esapi/configuration/EsapiPropertyLoader.java b/src/main/java/org/owasp/esapi/configuration/EsapiPropertyLoader.java new file mode 100644 index 000000000..aafa89012 --- /dev/null +++ b/src/main/java/org/owasp/esapi/configuration/EsapiPropertyLoader.java @@ -0,0 +1,43 @@ +package org.owasp.esapi.configuration; + +import org.owasp.esapi.errors.ConfigurationException; + +/** + * Generic interface for loading security configuration properties. + */ +public interface EsapiPropertyLoader { + + /** + * Get any int type property from security configuration. + * + * @return property value. + * @throws ConfigurationException when property does not exist in configuration or has incorrect type. + */ + public int getIntProp(String propertyName) throws ConfigurationException; + + /** + * Get any byte array type property from security configuration. + * + * @return property value. + * @throws ConfigurationException when property does not exist in configuration or has incorrect type. + */ + public byte[] getByteArrayProp(String propertyName) throws ConfigurationException; + + /** + * Get any Boolean type property from security configuration. + * + * @return property value. + * @throws ConfigurationException when property does not exist in configuration or has incorrect type. + */ + public Boolean getBooleanProp(String propertyName) throws ConfigurationException; + + /** + * Get any property from security configuration. As every property can be returned as string, this method + * throws exception only when property does not exist. + * + * @return property value. + * @throws ConfigurationException when property does not exist in configuration. + */ + public String getStringProp(String propertyName) throws ConfigurationException; + +} diff --git a/src/main/java/org/owasp/esapi/configuration/EsapiPropertyLoaderFactory.java b/src/main/java/org/owasp/esapi/configuration/EsapiPropertyLoaderFactory.java new file mode 100644 index 000000000..19bc581bd --- /dev/null +++ b/src/main/java/org/owasp/esapi/configuration/EsapiPropertyLoaderFactory.java @@ -0,0 +1,36 @@ +package org.owasp.esapi.configuration; + +import org.owasp.esapi.configuration.consts.EsapiConfiguration; +import org.owasp.esapi.errors.ConfigurationException; + +import java.io.FileNotFoundException; + +import static org.owasp.esapi.configuration.consts.EsapiConfigurationType.PROPERTIES; +import static org.owasp.esapi.configuration.consts.EsapiConfigurationType.XML; + +/** + * Factory class that takes care of initialization of proper instance of EsapiPropertyLoader + * based on EsapiPropertiesStore + */ +public class EsapiPropertyLoaderFactory { + + public static AbstractPrioritizedPropertyLoader createPropertyLoader(EsapiConfiguration cfg) + throws ConfigurationException, FileNotFoundException { + String cfgPath = System.getProperty(cfg.getConfigName()); + if (cfgPath == null) { + throw new ConfigurationException("System property [" + cfg.getConfigName() + "] is not set"); + } + String fileExtension = cfgPath.substring(cfgPath.lastIndexOf('.') + 1); + + if (XML.getTypeName().equals(fileExtension)) { + return new XmlEsapiPropertyLoader(cfgPath, cfg.getPriority()); + } + if (PROPERTIES.getTypeName().equals(fileExtension)) { + return new StandardEsapiPropertyLoader(cfgPath, cfg.getPriority()); + } else { + throw new ConfigurationException("Configuration storage type [" + fileExtension + "] is not " + + "supported"); + } + } + +} diff --git a/src/main/java/org/owasp/esapi/configuration/EsapiPropertyManager.java b/src/main/java/org/owasp/esapi/configuration/EsapiPropertyManager.java new file mode 100644 index 000000000..d4020aeed --- /dev/null +++ b/src/main/java/org/owasp/esapi/configuration/EsapiPropertyManager.java @@ -0,0 +1,99 @@ +package org.owasp.esapi.configuration; + +import org.owasp.esapi.configuration.consts.EsapiConfiguration; +import org.owasp.esapi.errors.ConfigurationException; + +import java.util.TreeSet; + +import static org.owasp.esapi.configuration.EsapiPropertyLoaderFactory.createPropertyLoader; + +/** + * Manager used for loading security configuration properties. Does all the logic to obtain the correct property from + * correct source. Uses following system properties to find configuration files: + * - org.owasp.esapi.devteam - lower priority dev file path + * - org.owasp.esapi.opsteam - higher priority ops file path + */ +public class EsapiPropertyManager implements EsapiPropertyLoader { + + protected TreeSet loaders; + + public EsapiPropertyManager() { + initLoaders(); + } + + /** + * {@inheritDoc} + */ + @Override + public int getIntProp(String propertyName) throws ConfigurationException { + for (AbstractPrioritizedPropertyLoader loader : loaders) { + try { + return loader.getIntProp(propertyName); + } catch (ConfigurationException e) { + System.err.println("Property not found in " + loader.name()); + } + } + throw new ConfigurationException("Could not find property " + propertyName + " in configuration"); + } + + /** + * {@inheritDoc} + */ + @Override + public byte[] getByteArrayProp(String propertyName) throws ConfigurationException { + for (AbstractPrioritizedPropertyLoader loader : loaders) { + try { + return loader.getByteArrayProp(propertyName); + } catch (ConfigurationException e) { + System.err.println("Property not found in " + loader.name()); + } + } + throw new ConfigurationException("Could not find property " + propertyName + " in configuration"); + } + + /** + * {@inheritDoc} + */ + @Override + public Boolean getBooleanProp(String propertyName) throws ConfigurationException { + for (AbstractPrioritizedPropertyLoader loader : loaders) { + try { + return loader.getBooleanProp(propertyName); + } catch (ConfigurationException e) { + System.err.println("Property not found in " + loader.name()); + } + } + throw new ConfigurationException("Could not find property " + propertyName + " in configuration"); + } + + /** + * {@inheritDoc} + */ + @Override + public String getStringProp(String propertyName) throws ConfigurationException { + for (AbstractPrioritizedPropertyLoader loader : loaders) { + try { + return loader.getStringProp(propertyName); + } catch (ConfigurationException e) { + System.err.println("Property : " + propertyName + " not found in " + loader.name()); + } + } + throw new ConfigurationException("Could not find property " + propertyName + " in configuration"); + } + + private void initLoaders() { + loaders = new TreeSet(); + try { + loaders.add(createPropertyLoader(EsapiConfiguration.OPSTEAM_ESAPI_CFG)); + } catch (Exception e) { + System.err.println(e.getMessage()); + } + try { + loaders.add(createPropertyLoader(EsapiConfiguration.DEVTEAM_ESAPI_CFG)); + } catch (Exception e) { + System.err.println(e.getMessage()); + } + } + + +} diff --git a/src/main/java/org/owasp/esapi/configuration/StandardEsapiPropertyLoader.java b/src/main/java/org/owasp/esapi/configuration/StandardEsapiPropertyLoader.java new file mode 100644 index 000000000..6a896a2cd --- /dev/null +++ b/src/main/java/org/owasp/esapi/configuration/StandardEsapiPropertyLoader.java @@ -0,0 +1,105 @@ +package org.owasp.esapi.configuration; + +import org.owasp.esapi.ESAPI; +import org.owasp.esapi.errors.ConfigurationException; + +import java.io.*; + +/** + * Loader capable of loading single security configuration property from standard java properties configuration file. + */ +public class StandardEsapiPropertyLoader extends AbstractPrioritizedPropertyLoader { + + public StandardEsapiPropertyLoader(String filename, int priority) { + super(filename, priority); + } + + /** + * {@inheritDoc} + */ + @Override + public int getIntProp(String propertyName) throws ConfigurationException { + String property = properties.getProperty(propertyName); + if (property == null) { + throw new ConfigurationException("Property : " + propertyName + "not found in configuration"); + } + try { + return Integer.parseInt(property); + } catch (NumberFormatException e) { + throw new ConfigurationException("Incorrect type of : " + propertyName + ". Value " + property + + "cannot be converted to integer", e); + } + } + + /** + * {@inheritDoc} + */ + @Override + public byte[] getByteArrayProp(String propertyName) throws ConfigurationException { + String property = properties.getProperty(propertyName); + if (property == null) { + throw new ConfigurationException("Property : " + propertyName + "not found in default configuration"); + } + try { + return ESAPI.encoder().decodeFromBase64(property); + } catch (IOException e) { + throw new ConfigurationException("Incorrect type of : " + propertyName + ". Value " + property + + "cannot be converted to byte array", e); + } + } + + /** + * {@inheritDoc} + */ + @Override + public Boolean getBooleanProp(String propertyName) throws ConfigurationException { + String property = properties.getProperty(propertyName); + if (property == null) { + throw new ConfigurationException("Property : " + propertyName + "not found in default configuration"); + } + if (property.equalsIgnoreCase("true") || property.equalsIgnoreCase("yes")) { + return true; + } + if (property.equalsIgnoreCase("false") || property.equalsIgnoreCase("no")) { + return false; + } else { + throw new ConfigurationException("Incorrect type of : " + propertyName + ". Value " + property + + "cannot be converted to boolean"); + } + } + + /** + * {@inheritDoc} + */ + @Override + public String getStringProp(String propertyName) throws ConfigurationException { + String property = properties.getProperty(propertyName); + if (property == null) { + throw new ConfigurationException("Property : " + propertyName + "not found in default configuration"); + } + return property; + } + + /** + * Methods loads configuration from .properties file. + * @param file + */ + protected void loadPropertiesFromFile(File file) { + InputStream input = null; + try { + input = new FileInputStream(file); + properties.load(input); + } catch (IOException ex) { + System.err.println("Loading " + file.getName() + " via file I/O failed. Exception was: " + ex); + } finally { + if (input != null) { + try { + input.close(); + } catch (IOException e) { + System.err.println("Could not close stream"); + } + } + } + } + +} diff --git a/src/main/java/org/owasp/esapi/configuration/XmlEsapiPropertyLoader.java b/src/main/java/org/owasp/esapi/configuration/XmlEsapiPropertyLoader.java new file mode 100644 index 000000000..c48be38fc --- /dev/null +++ b/src/main/java/org/owasp/esapi/configuration/XmlEsapiPropertyLoader.java @@ -0,0 +1,134 @@ +package org.owasp.esapi.configuration; + +import org.owasp.esapi.ESAPI; +import org.owasp.esapi.errors.ConfigurationException; +import org.w3c.dom.Document; +import org.w3c.dom.Element; +import org.w3c.dom.Node; +import org.w3c.dom.NodeList; + +import javax.xml.XMLConstants; +import javax.xml.parsers.DocumentBuilder; +import javax.xml.parsers.DocumentBuilderFactory; +import javax.xml.transform.stream.StreamSource; +import javax.xml.validation.Schema; +import javax.xml.validation.SchemaFactory; +import javax.xml.validation.Validator; +import java.io.File; +import java.io.FileInputStream; +import java.io.IOException; +import java.io.InputStream; + +/** + * Loader capable of loading single security configuration property from xml configuration file. + */ +public class XmlEsapiPropertyLoader extends AbstractPrioritizedPropertyLoader { + + public XmlEsapiPropertyLoader(String filename, int priority) { + super(filename, priority); + } + + /** + * {@inheritDoc} + */ + @Override + public int getIntProp(String propertyName) throws ConfigurationException { + String property = properties.getProperty(propertyName); + if (property == null) { + throw new ConfigurationException("Property : " + propertyName + " not found in default configuration"); + } + try { + return Integer.parseInt(property); + } catch (NumberFormatException e) { + throw new ConfigurationException("Incorrect type of : " + propertyName + ". Value " + property + + "cannot be converted to integer", e); + } + } + + /** + * {@inheritDoc} + */ + @Override + public byte[] getByteArrayProp(String propertyName) throws ConfigurationException { + String property = properties.getProperty(propertyName); + if (property == null) { + throw new ConfigurationException("Property : " + propertyName + " not found in default configuration"); + } + try { + return ESAPI.encoder().decodeFromBase64(property); + } catch (IOException e) { + throw new ConfigurationException("Incorrect type of : " + propertyName + ". Value " + property + + "cannot be converted to byte array", e); + } + } + + /** + * {@inheritDoc} + */ + @Override + public Boolean getBooleanProp(String propertyName) throws ConfigurationException { + String property = properties.getProperty(propertyName); + if (property == null) { + throw new ConfigurationException("Property : " + propertyName + " not found in default configuration"); + } + if (property.equalsIgnoreCase("true") || property.equalsIgnoreCase("yes")) { + return true; + } + if (property.equalsIgnoreCase("false") || property.equalsIgnoreCase("no")) { + return false; + } else { + throw new ConfigurationException("Incorrect type of : " + propertyName + ". Value " + property + + "cannot be converted to boolean"); + } + } + + /** + * {@inheritDoc} + */ + @Override + public String getStringProp(String propertyName) throws ConfigurationException { + String property = properties.getProperty(propertyName); + if (property == null) { + throw new ConfigurationException("Property : " + propertyName + " not found in default configuration"); + } + return property; + } + + /** + * Methods loads configuration from .xml file. + * @param file + */ + protected void loadPropertiesFromFile(File file) throws ConfigurationException { + try { + validateAgainstXSD(new FileInputStream(file)); + + DocumentBuilderFactory dbFactory = DocumentBuilderFactory.newInstance(); + DocumentBuilder dBuilder = dbFactory.newDocumentBuilder(); + Document doc = dBuilder.parse(file); + doc.getDocumentElement().normalize(); + + NodeList nodeList = doc.getElementsByTagName("property"); + for (int i = 0; i < nodeList.getLength(); i++) { + Node node = nodeList.item(i); + if (node.getNodeType() == Node.ELEMENT_NODE) { + Element element = (Element) node; + String propertyKey = element.getAttribute("name"); + String propertyValue = element.getTextContent(); + properties.put(propertyKey, propertyValue); + } + } + } catch (Exception e) { + throw new ConfigurationException("Configuration file : " + filename + " has invalid schema." + e.getMessage(), e); + } + } + + private void validateAgainstXSD(InputStream xml) throws Exception { + InputStream xsd = getClass().getResourceAsStream("/ESAPI-properties.xsd"); + SchemaFactory factory = + SchemaFactory.newInstance(XMLConstants.W3C_XML_SCHEMA_NS_URI); + Schema schema = factory.newSchema(new StreamSource(xsd)); + Validator validator = schema.newValidator(); + validator.validate(new StreamSource(xml)); + } + +} diff --git a/src/main/java/org/owasp/esapi/configuration/consts/EsapiConfiguration.java b/src/main/java/org/owasp/esapi/configuration/consts/EsapiConfiguration.java new file mode 100644 index 000000000..025700e76 --- /dev/null +++ b/src/main/java/org/owasp/esapi/configuration/consts/EsapiConfiguration.java @@ -0,0 +1,33 @@ +package org.owasp.esapi.configuration.consts; + +/** + * Enum used for initialization of esapi configuration files. + */ +public enum EsapiConfiguration { + + OPSTEAM_ESAPI_CFG("org.owasp.esapi.opsteam", 1), + DEVTEAM_ESAPI_CFG("org.owasp.esapi.devteam", 2); + + /** + * Key of system property pointing to path esapi to configuration file. + */ + String configName; + + /** + * Priority of configuration (higher numer - higher priority). + */ + int priority; + + EsapiConfiguration(String configName, int priority) { + this.configName = configName; + this.priority = priority; + } + + public String getConfigName() { + return configName; + } + + public int getPriority() { + return priority; + } +} diff --git a/src/main/java/org/owasp/esapi/configuration/consts/EsapiConfigurationType.java b/src/main/java/org/owasp/esapi/configuration/consts/EsapiConfigurationType.java new file mode 100644 index 000000000..df3899c8a --- /dev/null +++ b/src/main/java/org/owasp/esapi/configuration/consts/EsapiConfigurationType.java @@ -0,0 +1,19 @@ +package org.owasp.esapi.configuration.consts; + + +/** + * Supported esapi configuration file types. + */ +public enum EsapiConfigurationType { + PROPERTIES("properties"), XML("xml"); + + String typeName; + + EsapiConfigurationType(String typeName) { + this.typeName = typeName; + } + + public String getTypeName() { + return typeName; + } +} diff --git a/src/main/java/org/owasp/esapi/reference/DefaultHTTPUtilities.java b/src/main/java/org/owasp/esapi/reference/DefaultHTTPUtilities.java index dddf41c95..b68c613bc 100644 --- a/src/main/java/org/owasp/esapi/reference/DefaultHTTPUtilities.java +++ b/src/main/java/org/owasp/esapi/reference/DefaultHTTPUtilities.java @@ -825,13 +825,11 @@ public void sendForward( String location ) throws AccessControlException,Servle * {@inheritDoc} * * This implementation checks against the list of safe redirect locations defined in ESAPI.properties. - * - * @param response */ public void sendRedirect(HttpServletResponse response, String location) throws AccessControlException, IOException { if (!ESAPI.validator().isValidRedirectLocation("Redirect", location, false)) { logger.fatal(Logger.SECURITY_FAILURE, "Bad redirect location: " + location); - throw new AccessControlException("Redirect failed", "Bad Redirect location: " + location); + throw new AccessControlException("Redirect failed", "Bad redirect location: " + location); } response.sendRedirect(location); } @@ -1040,3 +1038,4 @@ private String decryptString(String ciphertext) throws EncryptionException { return plaintext.toString(); } } + diff --git a/src/main/java/org/owasp/esapi/reference/DefaultSecurityConfiguration.java b/src/main/java/org/owasp/esapi/reference/DefaultSecurityConfiguration.java index fd95f04a6..21a5cb345 100644 --- a/src/main/java/org/owasp/esapi/reference/DefaultSecurityConfiguration.java +++ b/src/main/java/org/owasp/esapi/reference/DefaultSecurityConfiguration.java @@ -15,29 +15,19 @@ */ package org.owasp.esapi.reference; -import java.io.File; -import java.io.FileInputStream; -import java.io.FileNotFoundException; -import java.io.IOException; -import java.io.InputStream; -import java.net.URL; -import java.util.ArrayList; -import java.util.Arrays; -import java.util.Collections; -import java.util.HashMap; -import java.util.Iterator; -import java.util.List; -import java.util.Map; -import java.util.Properties; -import java.util.regex.Pattern; -import java.util.regex.PatternSyntaxException; - import org.apache.commons.lang.text.StrTokenizer; import org.owasp.esapi.ESAPI; import org.owasp.esapi.Logger; import org.owasp.esapi.SecurityConfiguration; +import org.owasp.esapi.configuration.EsapiPropertyManager; import org.owasp.esapi.errors.ConfigurationException; +import java.io.*; +import java.net.URL; +import java.util.*; +import java.util.regex.Pattern; +import java.util.regex.PatternSyntaxException; + /** * The reference {@code SecurityConfiguration} manages all the settings used by the ESAPI in a single place. In this reference * implementation, resources can be put in several locations, which are searched in the following order: @@ -219,6 +209,7 @@ public static SecurityConfiguration getInstance() { */ private String resourceDirectory = ".esapi"; // For backward compatibility (vs. "esapi") private final String resourceFile; + private EsapiPropertyManager esapiPropertyManager; // private static long lastModified = -1; @@ -229,6 +220,7 @@ public static SecurityConfiguration getInstance() { */ DefaultSecurityConfiguration(String resourceFile) { this.resourceFile = resourceFile; + this.esapiPropertyManager = new EsapiPropertyManager(); // load security configuration try { loadConfiguration(); @@ -661,8 +653,8 @@ private Properties loadConfigurationFromClasspath(String fileName) throws Illega // try resources folder if (in == null) { - currentClasspathSearchLocation = "resources/"; - in = currentLoader.getResourceAsStream("resources/" + fileName); + currentClasspathSearchLocation = "src/main/resources/"; + in = currentLoader.getResourceAsStream("src/main/resources/" + fileName); } // now load the properties @@ -998,8 +990,7 @@ public String getLogFileName() { public int getMaxLogFileSize() { return getESAPIProperty( MAX_LOG_FILE_SIZE, DEFAULT_MAX_LOG_FILE_SIZE ); } - - + /** * {@inheritDoc} */ @@ -1237,7 +1228,102 @@ protected List getESAPIProperty( String key, List def ) { return Arrays.asList( parts ); } - protected boolean shouldPrintProperties() { + /** + * {@inheritDoc} + * Looks for property in three configuration files in following order: + * 1.) In file defined as org.owasp.esapi.opsteam system property + * 2.) In file defined as org.owasp.esapi.devteam system property + * 3.) In ESAPI.properties* + */ + @Override + public int getIntProp(String propertyName) throws ConfigurationException { + try { + return esapiPropertyManager.getIntProp(propertyName); + } catch (ConfigurationException ex) { + String property = properties.getProperty(propertyName); + try { + return Integer.parseInt(property); + } catch (NumberFormatException e) { + throw new ConfigurationException( "SecurityConfiguration for " + propertyName + " has incorrect " + + "type"); + } + } + } + + /** + * {@inheritDoc} + * Looks for property in three configuration files in following order: + * 1.) In file defined as org.owasp.esapi.opsteam system property + * 2.) In file defined as org.owasp.esapi.devteam system property + * 3.) In ESAPI.properties + */ + @Override + public byte[] getByteArrayProp(String propertyName) throws ConfigurationException { + try { + return esapiPropertyManager.getByteArrayProp(propertyName); + } catch (ConfigurationException ex) { + String property = properties.getProperty(propertyName); + if ( property == null ) { + throw new ConfigurationException( "SecurityConfiguration for " + propertyName + " not found in ESAPI.properties"); + } + try { + return ESAPI.encoder().decodeFromBase64(property); + } catch( IOException e ) { + throw new ConfigurationException( "SecurityConfiguration for " + propertyName + " has incorrect " + + "type"); + } + } + } + + /** + * {@inheritDoc} + * Looks for property in three configuration files in following order: + * 1.) In file defined as org.owasp.esapi.opsteam system property + * 2.) In file defined as org.owasp.esapi.devteam system property + * 3.) In ESAPI.properties + */ + @Override + public Boolean getBooleanProp(String propertyName) throws ConfigurationException { + try { + return esapiPropertyManager.getBooleanProp(propertyName); + } catch (ConfigurationException ex) { + String property = properties.getProperty( propertyName ); + if ( property == null ) { + throw new ConfigurationException( "SecurityConfiguration for " + propertyName + " not found in ESAPI.properties"); + } + if ( property.equalsIgnoreCase("true") || property.equalsIgnoreCase("yes" ) ) { + return true; + } + if ( property.equalsIgnoreCase("false") || property.equalsIgnoreCase( "no" ) ) { + return false; + } + throw new ConfigurationException( "SecurityConfiguration for " + propertyName + " has incorrect " + + "type"); + } + } + + /** + * {@inheritDoc} + * Looks for property in three configuration files in following order: + * 1.) In file defined as org.owasp.esapi.opsteam system property + * 2.) In file defined as org.owasp.esapi.devteam system property + * 3.) In ESAPI.properties + */ + @Override + public String getStringProp(String propertyName) throws ConfigurationException { + try { + return esapiPropertyManager.getStringProp(propertyName); + } catch (ConfigurationException ex) { + String property = properties.getProperty( propertyName ); + if ( property == null ) { + throw new ConfigurationException( "SecurityConfiguration for " + propertyName + " not found in ESAPI.properties"); + } + return property; + } + } + + + protected boolean shouldPrintProperties() { return getESAPIProperty(PRINT_PROPERTIES_WHEN_LOADED, false); } diff --git a/src/main/resources/ESAPI-properties.xsd b/src/main/resources/ESAPI-properties.xsd new file mode 100644 index 000000000..523d3a124 --- /dev/null +++ b/src/main/resources/ESAPI-properties.xsd @@ -0,0 +1,17 @@ + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/src/test/java/org/owasp/esapi/SecurityConfigurationWrapper.java b/src/test/java/org/owasp/esapi/SecurityConfigurationWrapper.java index eb9c0c9f9..769c9eced 100644 --- a/src/test/java/org/owasp/esapi/SecurityConfigurationWrapper.java +++ b/src/test/java/org/owasp/esapi/SecurityConfigurationWrapper.java @@ -1,5 +1,7 @@ package org.owasp.esapi; +import org.owasp.esapi.errors.ConfigurationException; + import java.io.File; import java.io.IOException; import java.io.InputStream; @@ -576,6 +578,26 @@ public int getMaxLogFileSize() return wrapped.getMaxLogFileSize(); } + @Override + public int getIntProp(String propertyName) throws ConfigurationException { + return wrapped.getIntProp(propertyName); + } + + @Override + public byte[] getByteArrayProp(String propertyName) throws ConfigurationException { + return wrapped.getByteArrayProp(propertyName); + } + + @Override + public Boolean getBooleanProp(String propertyName) throws ConfigurationException { + return wrapped.getBooleanProp(propertyName); + } + + @Override + public String getStringProp(String propertyName) throws ConfigurationException { + return wrapped.getStringProp(propertyName); + } + /** * {@inheritDoc} */ diff --git a/src/test/java/org/owasp/esapi/configuration/EsapiPropertyManagerTest.java b/src/test/java/org/owasp/esapi/configuration/EsapiPropertyManagerTest.java new file mode 100644 index 000000000..09096a424 --- /dev/null +++ b/src/test/java/org/owasp/esapi/configuration/EsapiPropertyManagerTest.java @@ -0,0 +1,327 @@ +package org.owasp.esapi.configuration; + +import org.junit.Before; +import org.junit.Test; +import org.owasp.esapi.ESAPI; +import org.owasp.esapi.configuration.consts.EsapiConfiguration; +import org.owasp.esapi.errors.ConfigurationException; + +import java.io.File; +import java.io.IOException; + +import static junit.framework.Assert.*; + +public class EsapiPropertyManagerTest { + + private static String propFilename1; + private static String propFilename2; + private static String xmlFilename1; + private static String xmlFilename2; + + private EsapiPropertyManager testPropertyManager; + + @Before + public void init() { + System.setProperty(EsapiConfiguration.DEVTEAM_ESAPI_CFG.getConfigName(), ""); + System.setProperty(EsapiConfiguration.OPSTEAM_ESAPI_CFG.getConfigName(), ""); + propFilename1 = "src" + File.separator + "test" + File.separator + "resources" + File.separator + + "esapi" + File.separator + "ESAPI-test.properties"; + propFilename2 = "src" + File.separator + "test" + File.separator + "resources" + File.separator + + "esapi" + File.separator + "ESAPI-test-2.properties"; + xmlFilename1 = "src" + File.separator + "test" + File.separator + "resources" + File.separator + + "esapi" + File.separator + "ESAPI-test.xml"; + xmlFilename2 = "src" + File.separator + "test" + File.separator + "resources" + File.separator + + "esapi" + File.separator + "ESAPI-test-2.xml"; + } + + @Test + public void testPropertyManagerInitialized() { + // given + System.setProperty(EsapiConfiguration.DEVTEAM_ESAPI_CFG.getConfigName(), propFilename1); + System.setProperty(EsapiConfiguration.OPSTEAM_ESAPI_CFG.getConfigName(), propFilename2); + + // when + testPropertyManager = new EsapiPropertyManager(); + + // then + assertNotNull(testPropertyManager.loaders); + assertNotSame(0, testPropertyManager.loaders.size()); + } + + @Test + public void testStringPropFoundInLoader() { + // given + System.setProperty(EsapiConfiguration.DEVTEAM_ESAPI_CFG.getConfigName(), xmlFilename1); + String propertyKey = "string_property"; + String expectedPropertyValue = "test_string_property"; + + // when + testPropertyManager = new EsapiPropertyManager(); + String propertyValue = testPropertyManager.getStringProp(propertyKey); + + // then + assertEquals(expectedPropertyValue, propertyValue); + } + + @Test + public void testStringPropertyLoadedFromFileWithHigherPriority() { + // given + System.setProperty(EsapiConfiguration.DEVTEAM_ESAPI_CFG.getConfigName(), propFilename1); + System.setProperty(EsapiConfiguration.OPSTEAM_ESAPI_CFG.getConfigName(), xmlFilename2); + + String propertyKey = "string_property"; + String expectedValue = "test_string_property_2"; + + // when + testPropertyManager = new EsapiPropertyManager(); + String propertyValue = testPropertyManager.getStringProp(propertyKey); + + // then + assertEquals(expectedValue, propertyValue); + } + + @Test + public void testStringPropertyLoadedFromPropFileWithHigherPriority() { + // given + System.setProperty(EsapiConfiguration.DEVTEAM_ESAPI_CFG.getConfigName(), propFilename1); + System.setProperty(EsapiConfiguration.OPSTEAM_ESAPI_CFG.getConfigName(), propFilename2); + String propertyKey = "string_property"; + String expectedValue = "test_string_property_2"; + + // when + testPropertyManager = new EsapiPropertyManager(); + String propertyValue = testPropertyManager.getStringProp(propertyKey); + + // then + assertEquals(expectedValue, propertyValue); + } + + @Test + public void testStringPropertyLoadedFromXmlFileWithHigherPriority() { + // given + System.setProperty(EsapiConfiguration.DEVTEAM_ESAPI_CFG.getConfigName(), xmlFilename1); + System.setProperty(EsapiConfiguration.OPSTEAM_ESAPI_CFG.getConfigName(), xmlFilename2); + String propertyKey = "string_property"; + String expectedValue = "test_string_property_2"; + + // when + testPropertyManager = new EsapiPropertyManager(); + String propertyValue = testPropertyManager.getStringProp(propertyKey); + + // then + assertEquals(expectedValue, propertyValue); + } + + + @Test(expected = ConfigurationException.class) + public void testStringPropertyNotFoundByLoaderAndThrowException() { + // given + System.setProperty(EsapiConfiguration.DEVTEAM_ESAPI_CFG.getConfigName(), propFilename1); + String propertyKey = "non.existing.property"; + + // when + testPropertyManager = new EsapiPropertyManager(); + testPropertyManager.getStringProp(propertyKey); + + // then expect exception + } + + @Test + public void testIntPropFoundInLoader() { + // given + System.setProperty(EsapiConfiguration.DEVTEAM_ESAPI_CFG.getConfigName(), xmlFilename1); + String propertyKey = "int_property"; + int expectedPropertyValue = 5; + + // when + testPropertyManager = new EsapiPropertyManager(); + int propertyValue = testPropertyManager.getIntProp(propertyKey); + + // then + assertEquals(expectedPropertyValue, propertyValue); + } + + @Test + public void testIntPropertyLoadedFromFileWithHigherPriority() { + // given + System.setProperty(EsapiConfiguration.DEVTEAM_ESAPI_CFG.getConfigName(), propFilename1); + System.setProperty(EsapiConfiguration.OPSTEAM_ESAPI_CFG.getConfigName(), xmlFilename2); + String propertyKey = "int_property"; + int expectedValue = 52; + + // when + testPropertyManager = new EsapiPropertyManager(); + int propertyValue = testPropertyManager.getIntProp(propertyKey); + + // then + assertEquals(expectedValue, propertyValue); + } + + @Test + public void testIntPropertyLoadedFromPropFileWithHigherPriority() { + // given + System.setProperty(EsapiConfiguration.DEVTEAM_ESAPI_CFG.getConfigName(), propFilename1); + System.setProperty(EsapiConfiguration.OPSTEAM_ESAPI_CFG.getConfigName(), propFilename2); + String propertyKey = "int_property"; + int expectedValue = 52; // value from ESAPI-test-2.properties file + + // when + testPropertyManager = new EsapiPropertyManager(); + int propertyValue = testPropertyManager.getIntProp(propertyKey); + + // then + assertEquals(expectedValue, propertyValue); + } + + @Test + public void testIntPropertyLoadedFromXmlFileWithHigherPriority() { + // given + System.setProperty(EsapiConfiguration.DEVTEAM_ESAPI_CFG.getConfigName(), xmlFilename1); + System.setProperty(EsapiConfiguration.OPSTEAM_ESAPI_CFG.getConfigName(), xmlFilename2); + String propertyKey = "int_property"; + int expectedValue = 52; + + // when + testPropertyManager = new EsapiPropertyManager(); + int propertyValue = testPropertyManager.getIntProp(propertyKey); + + // then + assertEquals(expectedValue, propertyValue); + } + + + @Test(expected = ConfigurationException.class) + public void testIntPropertyNotFoundByLoaderAndThrowException() { + // given + String propertyKey = "non.existing.property"; + + // when + testPropertyManager = new EsapiPropertyManager(); + testPropertyManager.getIntProp(propertyKey); + + // then expect exception + } + + @Test + public void testBooleanPropFoundInLoader() { + // given + System.setProperty(EsapiConfiguration.DEVTEAM_ESAPI_CFG.getConfigName(), xmlFilename1); + String propertyKey = "boolean_property"; + boolean expectedPropertyValue = true; + + // when + testPropertyManager = new EsapiPropertyManager(); + boolean propertyValue = testPropertyManager.getBooleanProp(propertyKey); + + // then + assertEquals(expectedPropertyValue, propertyValue); + } + + @Test(expected = ConfigurationException.class) + public void testBooleanPropertyNotFoundByLoaderAndThrowException() { + // given + String propertyKey = "non.existing.property"; + + // when + testPropertyManager = new EsapiPropertyManager(); + testPropertyManager.getBooleanProp(propertyKey); + + // then expect exception + } + + @Test + public void testByteArrayPropFoundInLoader() { + // given + System.setProperty(EsapiConfiguration.DEVTEAM_ESAPI_CFG.getConfigName(), propFilename1); + String propertyKey = "string_property"; + byte[] expectedValue = new byte[0]; + try { + expectedValue = ESAPI.encoder().decodeFromBase64("test_string_property"); + } catch (IOException e) { + fail(e.getMessage()); + } + + // when + testPropertyManager = new EsapiPropertyManager(); + byte[] propertyValue = testPropertyManager.getByteArrayProp(propertyKey); + + // then + assertEquals(expectedValue, propertyValue); + } + + @Test + public void testByteArrayPropertyLoadedFromFileWithHigherPriority() { + // given + System.setProperty(EsapiConfiguration.DEVTEAM_ESAPI_CFG.getConfigName(), propFilename1); + System.setProperty(EsapiConfiguration.OPSTEAM_ESAPI_CFG.getConfigName(), xmlFilename2); + String propertyKey = "string_property"; + byte[] expectedValue = new byte[0]; + try { + expectedValue = ESAPI.encoder().decodeFromBase64("test_string_property_2"); + } catch (IOException e) { + fail(e.getMessage()); + } + + // when + testPropertyManager = new EsapiPropertyManager(); + byte[] propertyValue = testPropertyManager.getByteArrayProp(propertyKey); + + // then + assertEquals(expectedValue, propertyValue); + } + + @Test + public void testByteArrayPropertyLoadedFromPropFileWithHigherPriority() { + // given + System.setProperty(EsapiConfiguration.DEVTEAM_ESAPI_CFG.getConfigName(), propFilename1); + System.setProperty(EsapiConfiguration.OPSTEAM_ESAPI_CFG.getConfigName(), propFilename2); + String propertyKey = "string_property"; + byte[] expectedValue = new byte[0]; + try { + expectedValue = ESAPI.encoder().decodeFromBase64("test_string_property_2"); + } catch (IOException e) { + fail(e.getMessage()); + } + + // when + testPropertyManager = new EsapiPropertyManager(); + byte[] propertyValue = testPropertyManager.getByteArrayProp(propertyKey); + + // then + assertEquals(expectedValue, propertyValue); + } + + @Test + public void testByteArrayPropertyLoadedFromXmlFileWithHigherPriority() { + // given + System.setProperty(EsapiConfiguration.DEVTEAM_ESAPI_CFG.getConfigName(), xmlFilename1); + System.setProperty(EsapiConfiguration.OPSTEAM_ESAPI_CFG.getConfigName(), xmlFilename2); + String propertyKey = "string_property"; + byte[] expectedValue = new byte[0]; + try { + expectedValue = ESAPI.encoder().decodeFromBase64("test_string_property_2"); + } catch (IOException e) { + fail(e.getMessage()); + } + + // when + testPropertyManager = new EsapiPropertyManager(); + byte[] propertyValue = testPropertyManager.getByteArrayProp(propertyKey); + + // then + assertEquals(expectedValue, propertyValue); + } + + @Test(expected = ConfigurationException.class) + public void testByteArrayPropertyNotFoundByLoaderAndThrowException() { + // given + String propertyKey = "non.existing.property"; + + // when + testPropertyManager = new EsapiPropertyManager(); + testPropertyManager.getByteArrayProp(propertyKey); + + // then expect exception + } + +} diff --git a/src/test/java/org/owasp/esapi/configuration/StandardEsapiPropertyLoaderTest.java b/src/test/java/org/owasp/esapi/configuration/StandardEsapiPropertyLoaderTest.java new file mode 100644 index 000000000..cf0cffca9 --- /dev/null +++ b/src/test/java/org/owasp/esapi/configuration/StandardEsapiPropertyLoaderTest.java @@ -0,0 +1,268 @@ +package org.owasp.esapi.configuration; + + +import org.junit.Before; +import org.junit.Test; +import org.owasp.esapi.ESAPI; +import org.owasp.esapi.configuration.consts.EsapiConfiguration; +import org.owasp.esapi.errors.ConfigurationException; + +import java.io.File; +import java.io.IOException; + +import static junit.framework.Assert.*; + +public class StandardEsapiPropertyLoaderTest { + + private static String filename; + private static int priority; + + private StandardEsapiPropertyLoader testPropertyLoader; + + @Before + public void init() { + System.setProperty(EsapiConfiguration.DEVTEAM_ESAPI_CFG.getConfigName(), ""); + System.setProperty(EsapiConfiguration.OPSTEAM_ESAPI_CFG.getConfigName(), ""); + filename = "src" + File.separator + "test" + File.separator + "resources" + File.separator + + "esapi" + File.separator + "ESAPI-test.properties"; + priority = 1; + } + + @Test + public void testPropertiesLoaded() { + // when + testPropertyLoader = new StandardEsapiPropertyLoader(filename, priority); + + // then + assertFalse(testPropertyLoader.properties.isEmpty()); + } + + @Test + public void testPriority() { + // given + int expectedValue = 1; + + // when + testPropertyLoader = new StandardEsapiPropertyLoader(filename, priority); + int value = testPropertyLoader.priority(); + + // then + assertEquals(expectedValue, value); + } + + @Test + public void testLoadersAreEqual() { + // given + int expectedValue = 0; + + // when + testPropertyLoader = new StandardEsapiPropertyLoader(filename, priority); + StandardEsapiPropertyLoader otherPropertyLoader = new StandardEsapiPropertyLoader(filename, priority); + int value = testPropertyLoader.compareTo(otherPropertyLoader); + + // then + assertEquals(expectedValue, value); + } + + @Test + public void testCompareWithOtherLoaderWithHigherPriority() { + // given + int expectedValue = -1; + int higherPriority = 2; + + // when + testPropertyLoader = new StandardEsapiPropertyLoader(filename, priority); + StandardEsapiPropertyLoader otherPropertyLoader = new StandardEsapiPropertyLoader(filename, higherPriority); + int value = testPropertyLoader.compareTo(otherPropertyLoader); + + // then + assertEquals(expectedValue, value); + } + + @Test + public void testCompareWithOtherLoaderWithLowerPriority() { + // given + int expectedValue = 1; + int lowerPriority = 0; + + // when + testPropertyLoader = new StandardEsapiPropertyLoader(filename, priority); + StandardEsapiPropertyLoader otherPropertyLoader = new StandardEsapiPropertyLoader(filename, lowerPriority); + int value = testPropertyLoader.compareTo(otherPropertyLoader); + + // then + assertEquals(expectedValue, value); + } + + @Test + public void testGetIntProp() { + // given + String propertyKey = "int_property"; + + // when + testPropertyLoader = new StandardEsapiPropertyLoader(filename, priority); + int propertyValue = testPropertyLoader.getIntProp(propertyKey); + + // then + assertEquals(5, propertyValue); + } + + @Test(expected = ConfigurationException.class) + public void testIntPropertyNotFound() throws ConfigurationException { + // given + String propertyKey = "non-existing-key"; + + // when + testPropertyLoader = new StandardEsapiPropertyLoader(filename, priority); + testPropertyLoader.getIntProp(propertyKey); + + // then expect exception + } + + @Test(expected = ConfigurationException.class) + public void testIncorrectIntPropertyType() { + // given + String key = "invalid_int_property"; + + // when + testPropertyLoader = new StandardEsapiPropertyLoader(filename, priority); + testPropertyLoader.getIntProp(key); + + // then expect exception + } + + @Test + public void testGetStringProp() { + // given + String propertyKey = "string_property"; + String expectedValue = "test_string_property"; + + // when + testPropertyLoader = new StandardEsapiPropertyLoader(filename, priority); + String propertyValue = testPropertyLoader.getStringProp(propertyKey); + + // then + assertEquals(expectedValue, propertyValue); + } + + @Test(expected = ConfigurationException.class) + public void testStringPropertyNotFound() throws ConfigurationException { + // given + String propertyKey = "non-existing-key"; + + // when + testPropertyLoader = new StandardEsapiPropertyLoader(filename, priority); + testPropertyLoader.getStringProp(propertyKey); + + // then expect exception + } + + @Test + public void testGetBooleanProp() { + // given + String filename = "src" + File.separator + "test" + File.separator + "resources" + File.separator + + "esapi" + File.separator + "ESAPI-test.properties"; + int priority = 1; + String propertyKey = "boolean_property"; + boolean expectedValue = true; + + // when + testPropertyLoader = new StandardEsapiPropertyLoader(filename, priority); + boolean value = testPropertyLoader.getBooleanProp(propertyKey); + + // then + assertEquals(expectedValue, value); + } + + @Test + public void testGetBooleanYesProperty() { + // given + String key = "boolean_yes_property"; + boolean expectedValue = true; + + // when + testPropertyLoader = new StandardEsapiPropertyLoader(filename, priority); + boolean value = testPropertyLoader.getBooleanProp(key); + + // then + assertEquals(expectedValue, value); + } + + @Test + public void testGetBooleanNoProperty() { + // given + String key = "boolean_no_property"; + boolean expectedValue = false; + + // when + testPropertyLoader = new StandardEsapiPropertyLoader(filename, priority); + boolean value = testPropertyLoader.getBooleanProp(key); + + // then + assertEquals(expectedValue, value); + } + + @Test(expected = ConfigurationException.class) + public void testBooleanPropertyNotFound() throws ConfigurationException { + // given + String filename = "src" + File.separator + "test" + File.separator + "src/main/resources" + File.separator + + "esapi" + File.separator + "ESAPI-test.properties"; int priority = 1; + String propertyKey = "non-existing-key"; + + // when + testPropertyLoader = new StandardEsapiPropertyLoader(filename, priority); + testPropertyLoader.getBooleanProp(propertyKey); + + // then expect exception + } + + @Test(expected = ConfigurationException.class) + public void testIncorrectBooleanPropertyType() throws ConfigurationException { + // given + String key = "invalid_boolean_property"; + + // when + testPropertyLoader = new StandardEsapiPropertyLoader(filename, priority); + testPropertyLoader.getBooleanProp(key); + + // then expect exception + } + + @Test + public void testGetByteArrayProp() { + // given + String filename = "src" + File.separator + "test" + File.separator + "resources" + File.separator + + "esapi" + File.separator + "ESAPI-test.properties"; + int priority = 1; + String propertyKey = "string_property"; + + byte[] expectedValue = new byte[0]; + try { + expectedValue = ESAPI.encoder().decodeFromBase64("test_string_property"); + } catch (IOException e) { + fail(e.getMessage()); + } + + // when + testPropertyLoader = new StandardEsapiPropertyLoader(filename, priority); + byte[] value = testPropertyLoader.getByteArrayProp(propertyKey); + + // then + assertEquals(expectedValue, value); + } + + @Test(expected = ConfigurationException.class) + public void testByteArrayPropertyNotFound() throws ConfigurationException { + // given + String filename = "src" + File.separator + "test" + File.separator + "src/main/resources" + File.separator + + "esapi" + File.separator + "ESAPI-test.properties"; int priority = 1; + String propertyKey = "non-existing-key"; + + // when + testPropertyLoader = new StandardEsapiPropertyLoader(filename, priority); + testPropertyLoader.getByteArrayProp(propertyKey); + + // then expect exception + } + +} diff --git a/src/test/java/org/owasp/esapi/configuration/XmlEsapiPropertyLoaderTest.java b/src/test/java/org/owasp/esapi/configuration/XmlEsapiPropertyLoaderTest.java new file mode 100644 index 000000000..9a60f182b --- /dev/null +++ b/src/test/java/org/owasp/esapi/configuration/XmlEsapiPropertyLoaderTest.java @@ -0,0 +1,269 @@ +package org.owasp.esapi.configuration; + +import org.junit.Before; +import org.junit.Test; +import org.owasp.esapi.ESAPI; +import org.owasp.esapi.configuration.consts.EsapiConfiguration; +import org.owasp.esapi.errors.ConfigurationException; + +import java.io.File; +import java.io.IOException; + +import static junit.framework.Assert.*; + +public class XmlEsapiPropertyLoaderTest { + + private static String filename; + private static int priority; + + private XmlEsapiPropertyLoader testPropertyLoader; + + @Before + public void init() { + System.setProperty(EsapiConfiguration.DEVTEAM_ESAPI_CFG.getConfigName(), ""); + System.setProperty(EsapiConfiguration.OPSTEAM_ESAPI_CFG.getConfigName(), ""); + filename = "src" + File.separator + "test" + File.separator + "resources" + File.separator + + "esapi" + File.separator + "ESAPI-test.xml"; + priority = 1; + } + + @Test + public void testPropertiesLoaded() { + // when + testPropertyLoader = new XmlEsapiPropertyLoader(filename, priority); + + // then + assertFalse(testPropertyLoader.properties.isEmpty()); + } + + @Test(expected = ConfigurationException.class) + public void testInvalidPropertyFile() { + // given + String invalidFilename = "src" + File.separator + "test" + File.separator + "resources" + File.separator + + "esapi" + File.separator + "ESAPI-test-invalid-content.xml"; + + // when + testPropertyLoader = new XmlEsapiPropertyLoader(invalidFilename, priority); + + // then expect exception + } + + @Test + public void testPriority() { + // given + int expectedValue = 1; + + // when + testPropertyLoader = new XmlEsapiPropertyLoader(filename, priority); + int value = testPropertyLoader.priority(); + + // then + assertEquals(expectedValue, value); + } + + @Test + public void testLoadersAreEqual() { + // given + int expectedValue = 0; + + // when + testPropertyLoader = new XmlEsapiPropertyLoader(filename, priority); + StandardEsapiPropertyLoader otherPropertyLoader = new StandardEsapiPropertyLoader(filename, priority); + int value = testPropertyLoader.compareTo(otherPropertyLoader); + + // then + assertEquals(expectedValue, value); + } + + @Test + public void testCompareWithOtherLoaderWithHigherPriority() { + // given + int expectedValue = -1; + int higherPriority = 2; + + // when + testPropertyLoader = new XmlEsapiPropertyLoader(filename, priority); + StandardEsapiPropertyLoader otherPropertyLoader = new StandardEsapiPropertyLoader(filename, higherPriority); + int value = testPropertyLoader.compareTo(otherPropertyLoader); + + // then + assertEquals(expectedValue, value); + } + + @Test + public void testCompareWithOtherLoaderWithLowerPriority() { + // given + int expectedValue = 1; + int lowerPriority = 0; + + // when + testPropertyLoader = new XmlEsapiPropertyLoader(filename, priority); + StandardEsapiPropertyLoader otherPropertyLoader = new StandardEsapiPropertyLoader(filename, lowerPriority); + int value = testPropertyLoader.compareTo(otherPropertyLoader); + + // then + assertEquals(expectedValue, value); + } + + @Test + public void testGetIntProp() { + // given + String key = "int_property"; + int expectedValue = 5; + + // when + testPropertyLoader = new XmlEsapiPropertyLoader(filename, priority); + int value = testPropertyLoader.getIntProp(key); + + // then + assertEquals(expectedValue, value); + } + + @Test(expected = ConfigurationException.class) + public void testIntPropertyNotFound() throws ConfigurationException { + // given + String key = "non-existing-key"; + + // when + testPropertyLoader = new XmlEsapiPropertyLoader(filename, priority); + testPropertyLoader.getIntProp(key); + + // then expect exception + } + + @Test(expected = ConfigurationException.class) + public void testIncorrectIntPropertyType() { + // given + String key = "invalid_int_property"; + + // when + testPropertyLoader = new XmlEsapiPropertyLoader(filename, priority); + testPropertyLoader.getIntProp(key); + + // then expect exception + } + + @Test + public void testGetStringProp() { + // given + String key = "string_property"; + String expectedValue = "test_string_property"; + + // when + testPropertyLoader = new XmlEsapiPropertyLoader(filename, priority); + String value = testPropertyLoader.getStringProp(key); + + // then + assertEquals(expectedValue, value); + } + + @Test(expected = ConfigurationException.class) + public void testStringPropertyNotFound() throws ConfigurationException { + // given + String key = "non-existing-key"; + + // when + testPropertyLoader = new XmlEsapiPropertyLoader(filename, priority); + testPropertyLoader.getStringProp(key); + + // then expect exception + } + + @Test + public void testGetBooleanProp() { + // given + String key = "boolean_property"; + boolean expectedValue = true; + + // when + testPropertyLoader = new XmlEsapiPropertyLoader(filename, priority); + boolean value = testPropertyLoader.getBooleanProp(key); + + // then + assertEquals(expectedValue, value); + } + + @Test + public void testGetBooleanYesProperty() { + // given + String key = "boolean_yes_property"; + boolean expectedValue = true; + + // when + testPropertyLoader = new XmlEsapiPropertyLoader(filename, priority); + boolean value = testPropertyLoader.getBooleanProp(key); + + // then + assertEquals(expectedValue, value); + } + + @Test + public void testGetBooleanNoProperty() { + // given + String key = "boolean_no_property"; + boolean expectedValue = false; + + // when + testPropertyLoader = new XmlEsapiPropertyLoader(filename, priority); + boolean value = testPropertyLoader.getBooleanProp(key); + + // then + assertEquals(expectedValue, value); + } + + @Test(expected = ConfigurationException.class) + public void testBooleanPropertyNotFound() throws ConfigurationException { + // given + String key = "non-existing-key"; + + // when + testPropertyLoader = new XmlEsapiPropertyLoader(filename, priority); + testPropertyLoader.getBooleanProp(key); + + // then expect exception + } + + @Test(expected = ConfigurationException.class) + public void testIncorrectBooleanPropertyType() throws ConfigurationException { + // given + String key = "invalid_boolean_property"; + + // when + testPropertyLoader = new XmlEsapiPropertyLoader(filename, priority); + testPropertyLoader.getBooleanProp(key); + + // then expect exception + } + + @Test + public void testGetByteArrayProp() { + // given + String key = "string_property"; + byte[] expectedValue = new byte[0]; + try { + expectedValue = ESAPI.encoder().decodeFromBase64("test_string_property"); + } catch (IOException e) { + fail(e.getMessage()); + } + + // when + testPropertyLoader = new XmlEsapiPropertyLoader(filename, priority); + byte[] value = testPropertyLoader.getByteArrayProp(key); + + // then + assertEquals(expectedValue, value); + } + + @Test(expected = ConfigurationException.class) + public void testByteArrayPropertyNotFound() throws ConfigurationException { + // given + String key = "non-existing-key"; + + // when + testPropertyLoader = new XmlEsapiPropertyLoader(filename, priority); + testPropertyLoader.getByteArrayProp(key); + + // then expect exception + } + +} diff --git a/src/test/java/org/owasp/esapi/reference/HTTPUtilitiesTest.java b/src/test/java/org/owasp/esapi/reference/HTTPUtilitiesTest.java index 2c89a8e10..d86f98ba4 100644 --- a/src/test/java/org/owasp/esapi/reference/HTTPUtilitiesTest.java +++ b/src/test/java/org/owasp/esapi/reference/HTTPUtilitiesTest.java @@ -18,19 +18,10 @@ import junit.framework.Test; import junit.framework.TestCase; import junit.framework.TestSuite; -import org.owasp.esapi.Authenticator; -import org.owasp.esapi.ESAPI; -import org.owasp.esapi.EncoderConstants; -import org.owasp.esapi.HTTPUtilities; -import org.owasp.esapi.User; +import org.owasp.esapi.*; import org.owasp.esapi.codecs.Hex; import org.owasp.esapi.crypto.CipherText; -import org.owasp.esapi.crypto.PlainText; -import org.owasp.esapi.errors.AccessControlException; -import org.owasp.esapi.errors.AuthenticationException; -import org.owasp.esapi.errors.EncryptionException; -import org.owasp.esapi.errors.EnterpriseSecurityException; -import org.owasp.esapi.errors.ValidationException; +import org.owasp.esapi.errors.*; import org.owasp.esapi.http.MockHttpServletRequest; import org.owasp.esapi.http.MockHttpServletResponse; import org.owasp.esapi.http.MockHttpSession; @@ -506,3 +497,4 @@ public void testGetRequestAttribute() throws Exception { assertEquals( test2, 43f ); } } + diff --git a/src/test/java/org/owasp/esapi/reference/ValidatorTest.java b/src/test/java/org/owasp/esapi/reference/ValidatorTest.java index 8ac1e26b9..1c3916a41 100644 --- a/src/test/java/org/owasp/esapi/reference/ValidatorTest.java +++ b/src/test/java/org/owasp/esapi/reference/ValidatorTest.java @@ -15,20 +15,9 @@ */ package org.owasp.esapi.reference; -import java.io.BufferedReader; -import java.io.ByteArrayInputStream; -import java.io.File; -import java.io.IOException; -import java.io.InputStreamReader; -import java.io.UnsupportedEncodingException; -import java.text.DateFormat; -import java.text.SimpleDateFormat; -import java.util.*; - import junit.framework.Test; import junit.framework.TestCase; import junit.framework.TestSuite; - import org.owasp.esapi.*; import org.owasp.esapi.errors.ValidationException; import org.owasp.esapi.filters.SecurityWrapperRequest; @@ -38,7 +27,10 @@ import org.owasp.esapi.reference.validation.StringValidationRule; import javax.servlet.http.Cookie; -import javax.servlet.http.HttpServletRequest; +import java.io.*; +import java.text.DateFormat; +import java.text.SimpleDateFormat; +import java.util.*; /** * The Class ValidatorTest. @@ -1148,3 +1140,4 @@ public void testGetContextPath() { assertFalse(ESAPI.validator().isValidInput("HTTPContextPath", "/\\nGET http://evil.com", "HTTPContextPath", 512, true)); } } + diff --git a/src/test/resources/ESAPI-properties.xsd b/src/test/resources/ESAPI-properties.xsd new file mode 100644 index 000000000..523d3a124 --- /dev/null +++ b/src/test/resources/ESAPI-properties.xsd @@ -0,0 +1,17 @@ + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/src/test/resources/esapi/ESAPI-test-2.properties b/src/test/resources/esapi/ESAPI-test-2.properties new file mode 100644 index 000000000..fb2e582b6 --- /dev/null +++ b/src/test/resources/esapi/ESAPI-test-2.properties @@ -0,0 +1,5 @@ +# Random properties for test purpose - all property keys could be found in ESAPI-test.properties but with +# different values. Used for test property files priorities. +string_property=test_string_property_2 +int_property=52 +boolean_property=false diff --git a/src/test/resources/esapi/ESAPI-test-2.xml b/src/test/resources/esapi/ESAPI-test-2.xml new file mode 100644 index 000000000..bec5597a4 --- /dev/null +++ b/src/test/resources/esapi/ESAPI-test-2.xml @@ -0,0 +1,6 @@ + + + test_string_property_2 + 52 + false + \ No newline at end of file diff --git a/src/test/resources/esapi/ESAPI-test-invalid-content.xml b/src/test/resources/esapi/ESAPI-test-invalid-content.xml new file mode 100644 index 000000000..d6dc1f74b --- /dev/null +++ b/src/test/resources/esapi/ESAPI-test-invalid-content.xml @@ -0,0 +1,7 @@ + + + test_string_property + 5 + true + invalid + \ No newline at end of file diff --git a/src/test/resources/esapi/ESAPI-test.properties b/src/test/resources/esapi/ESAPI-test.properties new file mode 100644 index 000000000..72dd9e50a --- /dev/null +++ b/src/test/resources/esapi/ESAPI-test.properties @@ -0,0 +1,8 @@ +# random properties for test purpose +string_property=test_string_property +int_property=5 +invalid_int_property=invalid int +boolean_property=true +boolean_yes_property=yes +boolean_no_property=no +invalid_boolean_property=invalid boolean \ No newline at end of file diff --git a/src/test/resources/esapi/ESAPI-test.xml b/src/test/resources/esapi/ESAPI-test.xml new file mode 100644 index 000000000..097f87eaf --- /dev/null +++ b/src/test/resources/esapi/ESAPI-test.xml @@ -0,0 +1,10 @@ + + + test_string_property + 5 + invalid int + true + yes + no + invalid boolean + \ No newline at end of file From 6de54c2c88a9bf857dc967e08bdfdbf6a7ebc712 Mon Sep 17 00:00:00 2001 From: "Kevin W. Wall" Date: Thu, 7 Jan 2016 22:37:36 -0500 Subject: [PATCH 062/812] updated how to create issues for ESAPI/esapi-java/legacy No one appears to be using JIRA, so until / unless the Atlassian JIRA instance is automatically synchronized with the GitHub issues (which is apparently possible; any volunteers?), I'm striking out the instructions to use if for bug tracking and enhancement requests. --- README.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index e4c8a3e3b..96ce300c8 100644 --- a/README.md +++ b/README.md @@ -27,7 +27,8 @@ Wiki: https://www.owasp.org/index.php/Category:OWASP_Enterprise_Security_API Nightly Build: https://esapi.ci.cloudbees.com -JIRA: https://owasp-esapi.atlassian.net/browse/ESAPILEG +~~JIRA: https://owasp-esapi.atlassian.net/browse/ESAPILEG~~
Issues: Until further notice, use the GitHub issues for reporting bugs and enhancement requests. + Documentation: https://owasp-esapi.atlassian.net/wiki/display/ESAPILEG/ESAPI+Legacy (Coming Soon) From 00cd34b8c87018d44f898d20f3608caeb7dc184d Mon Sep 17 00:00:00 2001 From: kwwall Date: Thu, 7 Jan 2016 22:56:27 -0500 Subject: [PATCH 063/812] Fix #354. --- .../java/org/owasp/esapi/codecs/Base64.java | 23 +++++++++++++++++-- 1 file changed, 21 insertions(+), 2 deletions(-) diff --git a/src/main/java/org/owasp/esapi/codecs/Base64.java b/src/main/java/org/owasp/esapi/codecs/Base64.java index 3f2d384da..e470ac6e8 100644 --- a/src/main/java/org/owasp/esapi/codecs/Base64.java +++ b/src/main/java/org/owasp/esapi/codecs/Base64.java @@ -12,7 +12,8 @@ /** *

Encodes and decodes to and from Base64 notation.

- *

Homepage: http://iharder.net/base64.

+ *

Homepage: http://iharder.net/base64 + * (based on version 2.2.2).

* *

The options parameter, which appears in a few places, is used to pass * several pieces of information to the encoder. In the "higher level" methods such as @@ -30,7 +31,7 @@ * * *

- * Change Log: + * Original change Log: *

*
    *
  • v2.2.2 - Fixed encodeFileToFile and decodeFileToFile to use the @@ -1085,10 +1086,28 @@ public static byte[] decode( String s, int options ) * Attempts to decode Base64 data and deserialize a Java * Object within. Returns null if there was an error. * + *

    + * WARNING: Using this method to decode non-validated / + * untrusted data from a string and deserialize it into + * an object can potentially result in remote command + * injection vulnerabilities. Use at your own risk! + *

    + * * @param encodedObject The Base64 data to decode * @return The decoded and deserialized object * @since 1.5 + * + * @deprecated Because of security issues, this method will be + * removed from ESAPI in a future release and no substitute + * is planned. Because as of JDK 8 (in 1Q2016) there is + * currently no way to restrict which objects + * ObjectInputStream.readObject() + * may safely deserialize in the general case. Oracle + * may decide to address this deficiency in a future Java + * release, but until they do, there is no simple way for + * a general class library like ESAPI to address this. */ + @Deprecated public static Object decodeToObject( String encodedObject ) { // Decode and gunzip if necessary From 426ea65acaecf286665428cf931b41421f4a062b Mon Sep 17 00:00:00 2001 From: kwwall Date: Thu, 7 Jan 2016 23:03:58 -0500 Subject: [PATCH 064/812] Fix #351 as suggested by xeno6696. This really should probably be a tunable property in the ESAPI.properties file, but saving that for a different day. --- .../java/org/owasp/esapi/filters/SecurityWrapperRequest.java | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/src/main/java/org/owasp/esapi/filters/SecurityWrapperRequest.java b/src/main/java/org/owasp/esapi/filters/SecurityWrapperRequest.java index 2777e4253..acf5375a2 100644 --- a/src/main/java/org/owasp/esapi/filters/SecurityWrapperRequest.java +++ b/src/main/java/org/owasp/esapi/filters/SecurityWrapperRequest.java @@ -192,7 +192,8 @@ public String getHeader(String name) { String value = getHttpServletRequest().getHeader(name); String clean = ""; try { - clean = ESAPI.validator().getValidInput("HTTP header value: " + value, value, "HTTPHeaderValue", 150, true); + clean = ESAPI.validator().getValidInput("HTTP header value: " + + value, value, "HTTPHeaderValue", 200, true); } catch (ValidationException e) { // already logged } From 068cecb6a05edefe7d4c940303f26b0057fe98ee Mon Sep 17 00:00:00 2001 From: kwwall Date: Thu, 7 Jan 2016 23:09:42 -0500 Subject: [PATCH 065/812] Fix #341 as per xeno6696 patch. --- src/main/assembly/dist.xml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/src/main/assembly/dist.xml b/src/main/assembly/dist.xml index b192b906f..3b2ee8e57 100644 --- a/src/main/assembly/dist.xml +++ b/src/main/assembly/dist.xml @@ -37,7 +37,7 @@ configuration configuration - .esapi/**/* + esapi/**/* log4j.dtd log4j.xml properties/**/* @@ -52,4 +52,4 @@ false - \ No newline at end of file + From 2f65182d3c7e46e5912514899e539c130a674075 Mon Sep 17 00:00:00 2001 From: kwwall Date: Thu, 7 Jan 2016 23:30:48 -0500 Subject: [PATCH 066/812] Sort of fixed #330. Changed allowed HTTP name name length from 20 to 50. --- .../java/org/owasp/esapi/filters/SecurityWrapperResponse.java | 2 +- .../java/org/owasp/esapi/reference/DefaultHTTPUtilities.java | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/src/main/java/org/owasp/esapi/filters/SecurityWrapperResponse.java b/src/main/java/org/owasp/esapi/filters/SecurityWrapperResponse.java index efc001372..71a9e7080 100644 --- a/src/main/java/org/owasp/esapi/filters/SecurityWrapperResponse.java +++ b/src/main/java/org/owasp/esapi/filters/SecurityWrapperResponse.java @@ -444,7 +444,7 @@ public void setHeader(String name, String value) { try { String strippedName = StringUtilities.stripControls(name); String strippedValue = StringUtilities.stripControls(value); - String safeName = ESAPI.validator().getValidInput("setHeader", strippedName, "HTTPHeaderName", 20, false); + String safeName = ESAPI.validator().getValidInput("setHeader", strippedName, "HTTPHeaderName", 50, false); String safeValue = ESAPI.validator().getValidInput("setHeader", strippedValue, "HTTPHeaderValue", ESAPI.securityConfiguration().getMaxHttpHeaderSize(), false); getHttpServletResponse().setHeader(safeName, safeValue); } catch (ValidationException e) { diff --git a/src/main/java/org/owasp/esapi/reference/DefaultHTTPUtilities.java b/src/main/java/org/owasp/esapi/reference/DefaultHTTPUtilities.java index b68c613bc..afad650cd 100644 --- a/src/main/java/org/owasp/esapi/reference/DefaultHTTPUtilities.java +++ b/src/main/java/org/owasp/esapi/reference/DefaultHTTPUtilities.java @@ -871,7 +871,7 @@ public void setHeader(HttpServletResponse response, String name, String value) { try { String strippedName = StringUtilities.replaceLinearWhiteSpace(name); String strippedValue = StringUtilities.replaceLinearWhiteSpace(value); - String safeName = ESAPI.validator().getValidInput("setHeader", strippedName, "HTTPHeaderName", 20, false); + String safeName = ESAPI.validator().getValidInput("setHeader", strippedName, "HTTPHeaderName", 50, false); String safeValue = ESAPI.validator().getValidInput("setHeader", strippedValue, "HTTPHeaderValue", 500, false); response.setHeader(safeName, safeValue); } catch (ValidationException e) { From 165a00d8ece0f5ebcaf8aa913981fd0dddc16f72 Mon Sep 17 00:00:00 2001 From: kwwall Date: Fri, 8 Jan 2016 02:35:47 -0500 Subject: [PATCH 067/812] Upgrade log4j from 1.2.16 6o 1.2.17. Upgrade Apache Commons Collection from 3.2.1 to 3.2.2 to pick up patch for COLLECTIONS-580 issue. --- pom.xml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/pom.xml b/pom.xml index 79f870d2f..dea265185 100644 --- a/pom.xml +++ b/pom.xml @@ -162,13 +162,13 @@ commons-collections commons-collections - 3.2.1 + 3.2.2 compile log4j log4j - 1.2.16 + 1.2.17 compile jar From b108050e5dca3552d2d78db0958ecdfa9da5f285 Mon Sep 17 00:00:00 2001 From: kwwall Date: Fri, 8 Jan 2016 03:07:04 -0500 Subject: [PATCH 068/812] Changed regex for Validation.HTTPHeaderName to allow 50 char header name for fix #351. --- configuration/esapi/ESAPI.properties | 5 +++-- src/test/resources/esapi/ESAPI.properties | 5 +++-- 2 files changed, 6 insertions(+), 4 deletions(-) diff --git a/configuration/esapi/ESAPI.properties b/configuration/esapi/ESAPI.properties index 35c9d0870..6511f0e15 100644 --- a/configuration/esapi/ESAPI.properties +++ b/configuration/esapi/ESAPI.properties @@ -440,7 +440,8 @@ Validator.HTTPParameterName=^[a-zA-Z0-9_]{1,32}$ Validator.HTTPParameterValue=^[a-zA-Z0-9.\\-\\/+=@_ ]*$ Validator.HTTPCookieName=^[a-zA-Z0-9\\-_]{1,32}$ Validator.HTTPCookieValue=^[a-zA-Z0-9\\-\\/+=_ ]*$ -Validator.HTTPHeaderName=^[a-zA-Z0-9\\-_]{1,32}$ +# Note that max header name capped at 150 in SecurityRequestWrapper! +Validator.HTTPHeaderName=^[a-zA-Z0-9\\-_]{1,50}$ Validator.HTTPHeaderValue=^[a-zA-Z0-9()\\-=\\*\\.\\?;,+\\/:&_ ]*$ Validator.HTTPContextPath=^\\/?[a-zA-Z0-9.\\-\\/_]*$ Validator.HTTPServletPath=^[a-zA-Z0-9.\\-\\/_]*$ @@ -456,4 +457,4 @@ Validator.DirectoryName=^[a-zA-Z0-9:/\\\\!@#$%^&{}\\[\\]()_+\\-=,.~'` ]{1,255}$ # Validation of dates. Controls whether or not 'lenient' dates are accepted. # See DataFormat.setLenient(boolean flag) for further details. -Validator.AcceptLenientDates=false \ No newline at end of file +Validator.AcceptLenientDates=false diff --git a/src/test/resources/esapi/ESAPI.properties b/src/test/resources/esapi/ESAPI.properties index 1435b7c6d..a33b532fa 100644 --- a/src/test/resources/esapi/ESAPI.properties +++ b/src/test/resources/esapi/ESAPI.properties @@ -440,7 +440,8 @@ Validator.HTTPScheme=^(http|https)$ Validator.HTTPServerName=^[a-zA-Z0-9_.\\-]*$ Validator.HTTPCookieName=^[a-zA-Z0-9\\-_]{1,32}$ Validator.HTTPCookieValue=^[a-zA-Z0-9\\-\\/+=_ ]*$ -Validator.HTTPHeaderName=^[a-zA-Z0-9\\-_]{1,32}$ +# Note that max header name capped at 150 in SecurityRequestWrapper! +Validator.HTTPHeaderName=^[a-zA-Z0-9\\-_]{1,50}$ Validator.HTTPHeaderValue=^[a-zA-Z0-9()\\-=\\*\\.\\?;,+\\/:&_ ]*$ Validator.HTTPServletPath=^[a-zA-Z0-9.\\-\\/_]*$ Validator.HTTPPath=^[a-zA-Z0-9.\\-_]*$ @@ -462,4 +463,4 @@ Validator.DirectoryName=^[a-zA-Z0-9:/\\\\!@#$%^&{}\\[\\]()_+\\-=,.~'` ]{1,255}$ # Validation of dates. Controls whether or not 'lenient' dates are accepted. # See DataFormat.setLenient(boolean flag) for further details. -Validator.AcceptLenientDates=false \ No newline at end of file +Validator.AcceptLenientDates=false From f2dd5d7050034a8c1b7c6f76dbf5ad2edf8daa1c Mon Sep 17 00:00:00 2001 From: kwwall Date: Fri, 8 Jan 2016 03:19:49 -0500 Subject: [PATCH 069/812] Fix #330. Fix #351. --- .../esapi/filters/SecurityWrapperRequest.java | 15 ++++++++++++--- .../org/owasp/esapi/reference/ValidatorTest.java | 14 +++++++++----- 2 files changed, 21 insertions(+), 8 deletions(-) diff --git a/src/main/java/org/owasp/esapi/filters/SecurityWrapperRequest.java b/src/main/java/org/owasp/esapi/filters/SecurityWrapperRequest.java index acf5375a2..f9b3a7cf0 100644 --- a/src/main/java/org/owasp/esapi/filters/SecurityWrapperRequest.java +++ b/src/main/java/org/owasp/esapi/filters/SecurityWrapperRequest.java @@ -38,6 +38,12 @@ import org.owasp.esapi.errors.ValidationException; import org.owasp.esapi.errors.AccessControlException; +// TODO: Parameterize these various lengths in calls to ESAPI.validator().getValidInput() +// so that they can be placed in ESAPI.properties file (or other property file, +// such as Validator.properties) rather than being hard-coded. This is desirable +// because many of the values are well less than the commonly accepted maximum +// values. + /** * This request wrapper simply overrides unsafe methods in the * HttpServletRequest API with safe versions that return canonicalized data @@ -157,9 +163,13 @@ public Cookie[] getCookies() { n.setMaxAge(maxAge); if (domain != null) { + // kww TODO: HTTPHeaderValue seems way too liberal of a regex for cookie domain + // as it allows invalid characters for a domain name. Maybe create a new custom + // HTTPCookieDomain regex??? n.setDomain(ESAPI.validator().getValidInput("Cookie domain: " + domain, domain, "HTTPHeaderValue", 200, false)); } if (path != null) { + // kww TODO: OPEN ISSUE: Would not HTTPServletPath make more sense here??? n.setPath(ESAPI.validator().getValidInput("Cookie path: " + path, path, "HTTPHeaderValue", 200, false)); } newCookies.add(n); @@ -192,8 +202,7 @@ public String getHeader(String name) { String value = getHttpServletRequest().getHeader(name); String clean = ""; try { - clean = ESAPI.validator().getValidInput("HTTP header value: " + - value, value, "HTTPHeaderValue", 200, true); + clean = ESAPI.validator().getValidInput("HTTP header value: " + value, value, "HTTPHeaderValue", 200, true); } catch (ValidationException e) { // already logged } @@ -233,7 +242,7 @@ public Enumeration getHeaders(String name) { while (en.hasMoreElements()) { try { String value = (String) en.nextElement(); - String clean = ESAPI.validator().getValidInput("HTTP header value (" + name + "): " + value, value, "HTTPHeaderValue", 150, true); + String clean = ESAPI.validator().getValidInput("HTTP header value (" + name + "): " + value, value, "HTTPHeaderValue", 200, true); v.add(clean); } catch (ValidationException e) { // already logged diff --git a/src/test/java/org/owasp/esapi/reference/ValidatorTest.java b/src/test/java/org/owasp/esapi/reference/ValidatorTest.java index 1c3916a41..8c37835d9 100644 --- a/src/test/java/org/owasp/esapi/reference/ValidatorTest.java +++ b/src/test/java/org/owasp/esapi/reference/ValidatorTest.java @@ -1078,8 +1078,8 @@ public void testGetHeader() { SecurityWrapperRequest safeRequest = new SecurityWrapperRequest(request); request.addHeader("p1", "login"); request.addHeader("f1", "XSS"); - request.addHeader("p2", generateStringOfLength(150)); - request.addHeader("f2", generateStringOfLength(151)); + request.addHeader("p2", generateStringOfLength(200)); // Upper limit increased from 150 -> 200, GitHub issue #351 + request.addHeader("f2", generateStringOfLength(201)); assertEquals(safeRequest.getHeader("p1"), request.getHeader("p1")); assertEquals(safeRequest.getHeader("p2"), request.getHeader("p2")); assertFalse(safeRequest.getHeader("f1").equals(request.getHeader("f1"))); @@ -1093,8 +1093,11 @@ public void testGetHeaderNames() { SecurityWrapperRequest safeRequest = new SecurityWrapperRequest(request); request.addHeader("d-49653-p", "pass"); request.addHeader("= 0 : "length must be >= 0"; + StringBuilder longString = new StringBuilder(length); for (int i = 0; i < length; i++) { longString.append("a"); } From 02aa0c7e49b5cb8171e0df2a0636a25fea9050a1 Mon Sep 17 00:00:00 2001 From: kwwall Date: Wed, 13 Jan 2016 02:00:01 -0500 Subject: [PATCH 070/812] Comments to help w/ Unicode regex matching as mentioned in issue #334. --- configuration/esapi/ESAPI.properties | 5 +++++ src/test/resources/esapi/ESAPI.properties | 5 +++++ 2 files changed, 10 insertions(+) diff --git a/configuration/esapi/ESAPI.properties b/configuration/esapi/ESAPI.properties index 6511f0e15..baa8e6933 100644 --- a/configuration/esapi/ESAPI.properties +++ b/configuration/esapi/ESAPI.properties @@ -421,6 +421,11 @@ IntrusionDetector.org.owasp.esapi.errors.AuthenticationHostException.actions=log # This allows enterprises to specify both organizational standards as well as application specific # validation rules. # +# Use '\p{L}' (without the quotes) within the character class to match +# any Unicode LETTER. You can also use a range, like: \u00C0-\u017F +# You can also use any of the regex flags as documented at +# https://docs.oracle.com/javase/tutorial/essential/regex/pattern.html, e.g. (?u) +# Validator.ConfigurationFile=validation.properties # Validators used by ESAPI diff --git a/src/test/resources/esapi/ESAPI.properties b/src/test/resources/esapi/ESAPI.properties index a33b532fa..1a0506ebf 100644 --- a/src/test/resources/esapi/ESAPI.properties +++ b/src/test/resources/esapi/ESAPI.properties @@ -426,6 +426,11 @@ IntrusionDetector.org.owasp.esapi.errors.AuthenticationHostException.actions=log # This allows enterprises to specify both organizational standards as well as application specific # validation rules. # +# Use '\p{L}' (without the quotes) within the character class to match +# any Unicode LETTER. You can also use a range, like: \u00C0-\u017F +# You can also use any of the regex flags as documented at +# https://docs.oracle.com/javase/tutorial/essential/regex/pattern.html, e.g. (?u) +# Validator.ConfigurationFile=validation.properties # Validators used by ESAPI From c45325d0b51da5aa5faecab20cd4b5b2caaedf13 Mon Sep 17 00:00:00 2001 From: kwwall Date: Wed, 13 Jan 2016 02:01:42 -0500 Subject: [PATCH 071/812] Change assertions into what should have been explicit runtime checks and throw an appropriate exception if violated. --- .../org/owasp/esapi/crypto/CipherSpec.java | 34 +++++++++++++++---- .../org/owasp/esapi/crypto/CipherText.java | 25 ++++++++++++-- 2 files changed, 51 insertions(+), 8 deletions(-) diff --git a/src/main/java/org/owasp/esapi/crypto/CipherSpec.java b/src/main/java/org/owasp/esapi/crypto/CipherSpec.java index 556ef8edb..e8836a38b 100644 --- a/src/main/java/org/owasp/esapi/crypto/CipherSpec.java +++ b/src/main/java/org/owasp/esapi/crypto/CipherSpec.java @@ -45,6 +45,8 @@ public final class CipherSpec implements Serializable { private int keySize_ = ESAPI.securityConfiguration().getEncryptionKeyLength(); // In bits private int blockSize_ = 16; // In bytes! I.e., 128 bits!!! private byte[] iv_ = null; + + private boolean blockSizeExplicitlySet = false; // Used for check in setIV(). // Cipher transformation component. Format is ALG/MODE/PADDING private enum CipherTransformationComponent { ALG, MODE, PADDING } @@ -72,7 +74,7 @@ public CipherSpec(String cipherXform, int keySize, int blockSize, final byte[] i public CipherSpec(String cipherXform, int keySize, int blockSize) { // Note: Do NOT use // this(cipherXform, keySize, blockSize, null); - // because of assertion in setIV(). + // because of checks in setIV(). // setCipherTransformation(cipherXform); setKeySize(keySize); @@ -194,7 +196,9 @@ public String getCipherTransformation() { * @return This current {@code CipherSpec} object. */ public CipherSpec setKeySize(int keySize) { - assert keySize > 0 : "keySize must be > 0; keySize=" + keySize; + if ( keySize <= 0 ) { + throw new IllegalArgumentException("keySize must be > 0; keySize=" + keySize); + } this.keySize_ = keySize; return this; } @@ -209,12 +213,16 @@ public int getKeySize() { /** * Set the block size for this {@code CipherSpec}. - * @param blockSize The block size, in bytes. Must be positive integer. + * @param blockSize The block size, in bytes. Must be positive integer appropriate + * for the specified cipher algorithm. * @return This current {@code CipherSpec} object. */ public CipherSpec setBlockSize(int blockSize) { - assert blockSize > 0 : "blockSize must be > 0; blockSize=" + blockSize; + if ( blockSize <= 0 ) { + throw new IllegalArgumentException("blockSize must be > 0; blockSize=" + blockSize); + } this.blockSize_ = blockSize; + blockSizeExplicitlySet = true; return this; } @@ -266,9 +274,23 @@ public byte[] getIV() { * @return This current {@code CipherSpec} object. */ public CipherSpec setIV(final byte[] iv) { - assert requiresIV() && (iv != null && iv.length != 0) : "Required IV cannot be null or 0 length"; - // Don't store a reference, but make a copy! + if ( ! ( requiresIV() && (iv != null && iv.length != 0) ) ) { + throw new IllegalArgumentException("Required IV cannot be null or 0 length."); + } + + // Don't store a reference, but make a copy! When an IV is provided, it generally should + // be the same length as the block size of the cipher. if ( iv != null ) { // Allow null IV for ECB mode. + // TODO: FIXME: As per email from Jeff Walton to Kevin Wall dated 12/03/2013, + // this is not always true. E.g., for CCM, the IV length is supposed + // to be 7, 8, 9, 10, 11, 12, or 13 octets because of + // it's formatting function. +/*** + if ( iv.length != this.getBlockSize() && blockSizeExplicitlySet ) { + throw new IllegalArgumentException("IV must be same length as cipher block size (" + + this.getBlockSize() + " bytes)"); + } +***/ iv_ = new byte[ iv.length ]; CryptoHelper.copyByteArray(iv, iv_); } diff --git a/src/main/java/org/owasp/esapi/crypto/CipherText.java b/src/main/java/org/owasp/esapi/crypto/CipherText.java index 47e6fc78f..66242d78f 100644 --- a/src/main/java/org/owasp/esapi/crypto/CipherText.java +++ b/src/main/java/org/owasp/esapi/crypto/CipherText.java @@ -26,6 +26,7 @@ import org.owasp.esapi.Encryptor; import org.owasp.esapi.Logger; import org.owasp.esapi.errors.EncryptionException; +import org.owasp.esapi.errors.EnterpriseSecurityRuntimeException; // CHECKME: Some of these assertions probably should be actual runtime checks // with suitable exceptions to account for cases where programmers @@ -457,7 +458,18 @@ public boolean validateMAC(SecretKey authKey) { // compare to stored value (separate_mac_). If same, then return true, // else return false. byte[] mac = computeMAC(authKey); - assert mac.length == separate_mac_.length : "MACs are of differnt lengths. Should both be the same."; + if ( mac.length != separate_mac_.length ) { + // Note: We want some type of unchecked exception + // here so this will not require code changes. + // Unfortunately, EncryptionException, which might + // make more sense here, is not a RuntimeException. + String exm = "MACs are of different lengths. " + + "Should both be the same length"; + throw new EnterpriseSecurityRuntimeException(exm, + "Possible tampering of MAC? " + exm + + "computed MAC len: " + mac.length + + ", received MAC len: " + separate_mac_.length); + } return CryptoHelper.arrayCompare(mac, separate_mac_); // Safe compare!!! } else if ( ! requiresMAC ) { // Doesn't require a MAC return true; @@ -593,6 +605,9 @@ int kdfPRFAsInt() { public void setKDF_PRF(int prfSelection) { assert prfSelection >= 0 && prfSelection <= 15 : "kdfPrf == " + prfSelection + " must be between 0 and 15."; + if ( prfSelection < 0 || prfSelection > 15 ) { + throw new IllegalArgumentException("kdfPrf == " + prfSelection + " must be between 0 and 15, inclusive."); + } kdfPrfSelection_ = prfSelection; } @@ -629,7 +644,9 @@ private void setEncryptionTimestamp() { * January 1, 1970 GMT). */ // Package level access. ESAPI jar should be sealed and signed. void setEncryptionTimestamp(long timestamp) { - assert timestamp > 0 : "Timestamp must be greater than zero."; + if ( timestamp <= 0 ) { + throw new IllegalArgumentException("Timestamp must be greater than zero."); + } if ( encryption_timestamp_ == 0 ) { // Only set it if it's not yet been set. logger.warning(Logger.EVENT_FAILURE, "Attempt to reset non-zero " + "CipherText encryption timestamp to " + new Date(timestamp) + "!"); @@ -767,6 +784,10 @@ protected boolean canEqual(Object other) { * @return The value for the MAC. */ private byte[] computeMAC(SecretKey authKey) { + // These assertions are okay and leaving them as assertions rather than + // changing the to conditional statements that throw should be all right + // because this is private method and presumably we should have already + // checked things in the public or protected methods where appropriate. assert raw_ciphertext_ != null && raw_ciphertext_.length != 0 : "Raw ciphertext may not be null or empty."; assert authKey != null && authKey.getEncoded().length != 0 : "Authenticity secret key may not be null or zero length."; try { From 79a3f593abf8dcf0b26a12b712be65e756bcde11 Mon Sep 17 00:00:00 2001 From: kwwall Date: Wed, 13 Jan 2016 02:07:25 -0500 Subject: [PATCH 072/812] Closes #318. --- src/main/java/org/owasp/esapi/waf/rules/RuleUtil.java | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/src/main/java/org/owasp/esapi/waf/rules/RuleUtil.java b/src/main/java/org/owasp/esapi/waf/rules/RuleUtil.java index 45201014f..e2a216707 100644 --- a/src/main/java/org/owasp/esapi/waf/rules/RuleUtil.java +++ b/src/main/java/org/owasp/esapi/waf/rules/RuleUtil.java @@ -76,7 +76,7 @@ public static boolean isInList(Collection c, String s) { } else if ( o instanceof Double ) { try { - if ( Double.parseDouble(s) == ((Double)o).doubleValue() ) { + if ( Double.compare(Double.parseDouble(s), ((Double)o).doubleValue()) == 0 ) { return true; } } catch (Exception e) {} @@ -121,7 +121,7 @@ public static boolean isInList(Enumeration en, String s) { } else if ( o instanceof Double ) { try { - if ( Double.parseDouble(s) == ((Double)o).doubleValue() ) { + if ( Double.compare(Double.parseDouble(s), ((Double)o).doubleValue()) == 0 ) { return true; } } catch (Exception e) {} From dffaddbb59946fb4ba46d5fb97830af277b408d7 Mon Sep 17 00:00:00 2001 From: kwwall Date: Wed, 13 Jan 2016 02:14:11 -0500 Subject: [PATCH 073/812] Closes issue #319. --- .../ESAPIWebApplicationFirewallFilter.java | 973 +++++++++--------- 1 file changed, 507 insertions(+), 466 deletions(-) diff --git a/src/main/java/org/owasp/esapi/waf/ESAPIWebApplicationFirewallFilter.java b/src/main/java/org/owasp/esapi/waf/ESAPIWebApplicationFirewallFilter.java index 4563c0d57..82bd7e079 100644 --- a/src/main/java/org/owasp/esapi/waf/ESAPIWebApplicationFirewallFilter.java +++ b/src/main/java/org/owasp/esapi/waf/ESAPIWebApplicationFirewallFilter.java @@ -1,466 +1,507 @@ -/** - * OWASP Enterprise Security API (ESAPI) - * - * This file is part of the Open Web Application Security Project (OWASP) - * Enterprise Security API (ESAPI) project. For details, please see - * http://www.owasp.org/index.php/ESAPI. - * - * Copyright (c) 2009 - The OWASP Foundation - * - * The ESAPI is published by OWASP under the BSD license. You should read and accept the - * LICENSE before you use, modify, and/or redistribute this software. - * - * @author Arshan Dabirsiaghi Aspect Security - * @created 2009 - */ -package org.owasp.esapi.waf; - -import java.io.File; - -import java.io.FileInputStream; -import java.io.FileNotFoundException; -import java.io.IOException; -import java.util.List; - -import javax.servlet.Filter; -import javax.servlet.FilterChain; -import javax.servlet.FilterConfig; -import javax.servlet.ServletException; -import javax.servlet.ServletRequest; -import javax.servlet.ServletResponse; -import javax.servlet.http.HttpServletRequest; -import javax.servlet.http.HttpServletResponse; - -import org.apache.commons.fileupload.FileUploadException; -import org.apache.log4j.xml.DOMConfigurator; -import org.owasp.esapi.ESAPI; -import org.owasp.esapi.Logger; -import org.owasp.esapi.waf.actions.Action; -import org.owasp.esapi.waf.actions.BlockAction; -import org.owasp.esapi.waf.actions.DefaultAction; -import org.owasp.esapi.waf.actions.RedirectAction; -import org.owasp.esapi.waf.configuration.AppGuardianConfiguration; -import org.owasp.esapi.waf.configuration.ConfigurationParser; -import org.owasp.esapi.waf.internal.InterceptingHTTPServletRequest; -import org.owasp.esapi.waf.internal.InterceptingHTTPServletResponse; -import org.owasp.esapi.waf.rules.Rule; - -/** - * This is the main class for the ESAPI Web Application Firewall (WAF). It is a standard J2EE servlet filter - * that, in different methods, invokes the reading of the configuration file and handles the runtime processing - * and enforcing of the developer-specified rules. - * - * Ideally the filter should be configured to catch all requests (/*) in web.xml. If there are URL segments that - * need to be extremely fast and don't require any protection, the pattern may be modified with extreme caution. - * - * @author Arshan Dabirsiaghi - * - */ -public class ESAPIWebApplicationFirewallFilter implements Filter { - - private AppGuardianConfiguration appGuardConfig; - - private static final String CONFIGURATION_FILE_PARAM = "configuration"; - private static final String LOGGING_FILE_PARAM = "log_settings"; - private static final String POLLING_TIME_PARAM = "polling_time"; - - private static final int DEFAULT_POLLING_TIME = 30000; - - private String configurationFilename = null; - - private long pollingTime; - - private long lastConfigReadTime; - - //private static final String FAUX_SESSION_COOKIE = "FAUXSC"; - //private static final String SESSION_COOKIE_CANARY = "org.owasp.esapi.waf.canary"; - - private FilterConfig fc; - - private final Logger logger = ESAPI.getLogger(ESAPIWebApplicationFirewallFilter.class); - - /** - * This function is used in testing to dynamically alter the configuration. - * @param policyFilePath The path to the policy file - * @param webRootDir The root directory of the web application. - * @throws FileNotFoundException if the policy file cannot be located - */ - public void setConfiguration( String policyFilePath, String webRootDir ) throws FileNotFoundException { - try { - appGuardConfig = ConfigurationParser.readConfigurationFile(new FileInputStream(new File(policyFilePath)), webRootDir); - lastConfigReadTime = System.currentTimeMillis(); - configurationFilename = policyFilePath; - } catch (ConfigurationException e ) { - // TODO: It would be ideal if this method through the ConfigurationException rather than catching it and - // writing the error to the console. - e.printStackTrace(); - } - } - - public AppGuardianConfiguration getConfiguration() { - return appGuardConfig; - } - - - /** - * - * This function is invoked at application startup and when the configuration file - * polling period has elapsed and a change in the configuration file has been detected. - * - * It's main purpose is to read the configuration file and establish the configuration - * object model for use at runtime during the doFilter() method. - */ - public void init(FilterConfig fc) throws ServletException { - - /* - * This variable is saved so that we can retrieve it later to re-invoke this function. - */ - this.fc = fc; - - logger.debug(Logger.EVENT_SUCCESS, ">> Initializing WAF" ); - /* - * Pull logging file. - */ - - // Demoted scope to a local since this is the only place it is referenced - String logSettingsFilename = fc.getInitParameter(LOGGING_FILE_PARAM); - - String realLogSettingsFilename = fc.getServletContext().getRealPath(logSettingsFilename); - - if ( realLogSettingsFilename == null || (! new File(realLogSettingsFilename).exists()) ) { - throw new ServletException("[ESAPI WAF] Could not find log file at resolved path: " + realLogSettingsFilename); - } - - /* - * Pull main configuration file. - */ - - configurationFilename = fc.getInitParameter(CONFIGURATION_FILE_PARAM); - - configurationFilename = fc.getServletContext().getRealPath(configurationFilename); - - if ( configurationFilename == null || ! new File(configurationFilename).exists() ) { - throw new ServletException("[ESAPI WAF] Could not find configuration file at resolved path: " + configurationFilename); - } - - /* - * Find out polling time from a parameter. If none is provided, use - * the default (10 seconds). - */ - - String sPollingTime = fc.getInitParameter(POLLING_TIME_PARAM); - - if ( sPollingTime != null ) { - pollingTime = Long.parseLong(sPollingTime); - } else { - pollingTime = DEFAULT_POLLING_TIME; - } - - /* - * Open up configuration file and populate the AppGuardian configuration object. - */ - - try { - - String webRootDir = fc.getServletContext().getRealPath("/"); - appGuardConfig = ConfigurationParser.readConfigurationFile(new FileInputStream(configurationFilename),webRootDir); - - DOMConfigurator.configure(realLogSettingsFilename); - - lastConfigReadTime = System.currentTimeMillis(); - - } catch (FileNotFoundException e) { - throw new ServletException(e); - } catch (ConfigurationException e) { - throw new ServletException(e); - } - - } - - - /** - * This is the where the main interception and rule-checking logic of the WAF resides. - */ - public void doFilter(ServletRequest servletRequest, ServletResponse servletResponse, - FilterChain chain) throws IOException, ServletException { - - /* - * Check to see if polling time has elapsed. If it has, that means - * we should check to see if the config file has been changed. If - * it has, then re-read it. - * - * // TODO: Any reason this logic shouldn't be moved into a polling thread class? - */ - - if ( (System.currentTimeMillis() - lastConfigReadTime) > pollingTime ) { - File f = new File(configurationFilename); - long lastModified = f.lastModified(); - if ( lastModified > lastConfigReadTime ) { - /* - * The file has been altered since it was - * read in the last time. Must re-read it. - */ - logger.debug(Logger.EVENT_SUCCESS, ">> Re-reading WAF policy"); - init(fc); - } - } - - logger.debug(Logger.EVENT_SUCCESS, ">>In WAF doFilter"); - - HttpServletRequest httpRequest = (HttpServletRequest)servletRequest; - HttpServletResponse httpResponse = (HttpServletResponse)servletResponse; - - InterceptingHTTPServletRequest request = null; - InterceptingHTTPServletResponse response = null; - - /* - * First thing to do is create the InterceptingHTTPServletResponse, since - * we'll need that possibly before the InterceptingHTTPServletRequest. - * - * The normal HttpRequest-type objects will suffice us until we get to - * stage 2. - * - * 1st argument = the response to base the instance on - * 2nd argument = should we bother intercepting the egress response? - * 3rd argument = cookie rules because thats where they mostly get acted on - */ - - if ( appGuardConfig.getCookieRules().size() + - appGuardConfig.getBeforeResponseRules().size() > 0) { - response = new InterceptingHTTPServletResponse(httpResponse, true, appGuardConfig.getCookieRules()); - } - - /* - * Stage 1: Rules that do not need the request body. - */ - logger.debug(Logger.EVENT_SUCCESS, ">> Starting stage 1" ); - - List rules = this.appGuardConfig.getBeforeBodyRules(); - - for(int i=0;i> Starting Stage 2" ); - - rules = this.appGuardConfig.getAfterBodyRules(); - - for(int i=0;i> Calling the FilterChain: " + chain ); - chain.doFilter(request, response != null ? response : httpResponse); - - /* - * Stage 3: Before the response has been sent back to the user. - */ - logger.debug(Logger.EVENT_SUCCESS, ">> Starting Stage 3" ); - - rules = this.appGuardConfig.getBeforeResponseRules(); - - for(int i=0;i>> committing reponse" ); - response.commit(); - } - } - - /* - * Utility method to send HTTP redirects that automatically determines which response class to use. - */ - private void sendRedirect(InterceptingHTTPServletResponse response, - HttpServletResponse httpResponse, String redirectURL) throws IOException { - - if ( response != null ) { // if we've been buffering everything we clean it all out before sending back. - response.reset(); - response.resetBuffer(); - response.sendRedirect(redirectURL); - response.commit(); - } else { - httpResponse.sendRedirect(redirectURL); - } - - } - - public void destroy() { - /* - * Any cleanup necessary? - */ - } - - - private void sendRedirect(InterceptingHTTPServletResponse response, HttpServletResponse httpResponse) throws IOException { - /* [chrisisbeef] - commented out as this is not currently used. Minor performance tweak. - String finalJavaScript = AppGuardianConfiguration.JAVASCRIPT_REDIRECT; - finalJavaScript = finalJavaScript.replaceAll(AppGuardianConfiguration.JAVASCRIPT_TARGET_TOKEN, appGuardConfig.getDefaultErrorPage()); - */ - - if ( response != null ) { - response.reset(); - response.resetBuffer(); - /* - response.setStatus(appGuardConfig.getDefaultResponseCode()); - response.getOutputStream().write(finalJavaScript.getBytes()); - */ - response.sendRedirect(appGuardConfig.getDefaultErrorPage()); - - } else { - if ( ! httpResponse.isCommitted() ) { - httpResponse.sendRedirect(appGuardConfig.getDefaultErrorPage()); - } else { - /* - * Can't send redirect because response is already committed. I'm not sure - * how this could happen, but I didn't want to cause IOExceptions in case - * if it ever does. - */ - } - - } - } - -} +/** + * OWASP Enterprise Security API (ESAPI) + * + * This file is part of the Open Web Application Security Project (OWASP) + * Enterprise Security API (ESAPI) project. For details, please see + * http://www.owasp.org/index.php/ESAPI. + * + * Copyright (c) 2009 - The OWASP Foundation + * + * The ESAPI is published by OWASP under the BSD license. You should read and accept the + * LICENSE before you use, modify, and/or redistribute this software. + * + * @author Arshan Dabirsiaghi Aspect Security + * @created 2009 + */ +package org.owasp.esapi.waf; + +import java.io.File; + +import java.io.FileInputStream; +import java.io.FileNotFoundException; +import java.io.IOException; +import java.util.List; + +import javax.servlet.Filter; +import javax.servlet.FilterChain; +import javax.servlet.FilterConfig; +import javax.servlet.ServletException; +import javax.servlet.ServletRequest; +import javax.servlet.ServletResponse; +import javax.servlet.http.HttpServletRequest; +import javax.servlet.http.HttpServletResponse; + +import org.apache.commons.fileupload.FileUploadException; +import org.apache.log4j.xml.DOMConfigurator; +import org.owasp.esapi.ESAPI; +import org.owasp.esapi.Logger; +import org.owasp.esapi.waf.actions.Action; +import org.owasp.esapi.waf.actions.BlockAction; +import org.owasp.esapi.waf.actions.DefaultAction; +import org.owasp.esapi.waf.actions.RedirectAction; +import org.owasp.esapi.waf.configuration.AppGuardianConfiguration; +import org.owasp.esapi.waf.configuration.ConfigurationParser; +import org.owasp.esapi.waf.internal.InterceptingHTTPServletRequest; +import org.owasp.esapi.waf.internal.InterceptingHTTPServletResponse; +import org.owasp.esapi.waf.rules.Rule; + +/** + * This is the main class for the ESAPI Web Application Firewall (WAF). It is a + * standard J2EE servlet filter that, in different methods, invokes the reading + * of the configuration file and handles the runtime processing and enforcing of + * the developer-specified rules. + * + * Ideally the filter should be configured to catch all requests (/*) in + * web.xml. If there are URL segments that need to be extremely fast and don't + * require any protection, the pattern may be modified with extreme caution. + * + * @author Arshan Dabirsiaghi + * + */ +public class ESAPIWebApplicationFirewallFilter implements Filter { + + private AppGuardianConfiguration appGuardConfig; + + private static final String CONFIGURATION_FILE_PARAM = "configuration"; + private static final String LOGGING_FILE_PARAM = "log_settings"; + private static final String POLLING_TIME_PARAM = "polling_time"; + + private static final int DEFAULT_POLLING_TIME = 30000; + + private String configurationFilename = null; + + private long pollingTime; + + private long lastConfigReadTime; + + // private static final String FAUX_SESSION_COOKIE = "FAUXSC"; + // private static final String SESSION_COOKIE_CANARY = + // "org.owasp.esapi.waf.canary"; + + private FilterConfig fc; + + private final Logger logger = ESAPI.getLogger(ESAPIWebApplicationFirewallFilter.class); + + /** + * This function is used in testing to dynamically alter the configuration. + * + * @param policyFilePath + * The path to the policy file + * @param webRootDir + * The root directory of the web application. + * @throws FileNotFoundException + * if the policy file cannot be located + */ + public void setConfiguration(String policyFilePath, String webRootDir) throws FileNotFoundException { + + FileInputStream inputStream = null; + + try { + inputStream = new FileInputStream(new File(policyFilePath)); + appGuardConfig = ConfigurationParser.readConfigurationFile(inputStream, webRootDir); + lastConfigReadTime = System.currentTimeMillis(); + configurationFilename = policyFilePath; + } catch (ConfigurationException e) { + // TODO: It would be ideal if this method through the + // ConfigurationException rather than catching it and + // writing the error to the console. + e.printStackTrace(); + } finally { + if (inputStream != null) { + try { + inputStream.close(); + } catch (IOException e) { + e.printStackTrace(); + } + } + } + } + + public AppGuardianConfiguration getConfiguration() { + return appGuardConfig; + } + + /** + * + * This function is invoked at application startup and when the + * configuration file polling period has elapsed and a change in the + * configuration file has been detected. + * + * It's main purpose is to read the configuration file and establish the + * configuration object model for use at runtime during the + * doFilter() method. + */ + public void init(FilterConfig fc) throws ServletException { + + /* + * This variable is saved so that we can retrieve it later to re-invoke + * this function. + */ + this.fc = fc; + + logger.debug(Logger.EVENT_SUCCESS, ">> Initializing WAF"); + /* + * Pull logging file. + */ + + // Demoted scope to a local since this is the only place it is + // referenced + String logSettingsFilename = fc.getInitParameter(LOGGING_FILE_PARAM); + + String realLogSettingsFilename = fc.getServletContext().getRealPath(logSettingsFilename); + + if (realLogSettingsFilename == null || (!new File(realLogSettingsFilename).exists())) { + throw new ServletException( + "[ESAPI WAF] Could not find log file at resolved path: " + realLogSettingsFilename); + } + + /* + * Pull main configuration file. + */ + + configurationFilename = fc.getInitParameter(CONFIGURATION_FILE_PARAM); + + configurationFilename = fc.getServletContext().getRealPath(configurationFilename); + + if (configurationFilename == null || !new File(configurationFilename).exists()) { + throw new ServletException( + "[ESAPI WAF] Could not find configuration file at resolved path: " + configurationFilename); + } + + /* + * Find out polling time from a parameter. If none is provided, use the + * default (10 seconds). + */ + + String sPollingTime = fc.getInitParameter(POLLING_TIME_PARAM); + + if (sPollingTime != null) { + pollingTime = Long.parseLong(sPollingTime); + } else { + pollingTime = DEFAULT_POLLING_TIME; + } + + /* + * Open up configuration file and populate the AppGuardian configuration + * object. + */ + + FileInputStream inputStream = null; + + try { + String webRootDir = fc.getServletContext().getRealPath("/"); + inputStream = new FileInputStream(configurationFilename); + appGuardConfig = ConfigurationParser.readConfigurationFile(inputStream, webRootDir); + DOMConfigurator.configure(realLogSettingsFilename); + lastConfigReadTime = System.currentTimeMillis(); + } catch (FileNotFoundException e) { + throw new ServletException(e); + } catch (ConfigurationException e) { + throw new ServletException(e); + } finally { + if (inputStream != null) { + try { + inputStream.close(); + } catch (IOException e) { + e.printStackTrace(); + } + } + } + } + + /** + * This is the where the main interception and rule-checking logic of the + * WAF resides. + */ + public void doFilter(ServletRequest servletRequest, ServletResponse servletResponse, FilterChain chain) + throws IOException, ServletException { + + /* + * Check to see if polling time has elapsed. If it has, that means we + * should check to see if the config file has been changed. If it has, + * then re-read it. + * + * // TODO: Any reason this logic shouldn't be moved into a polling + * thread class? + */ + + if ((System.currentTimeMillis() - lastConfigReadTime) > pollingTime) { + File f = new File(configurationFilename); + long lastModified = f.lastModified(); + if (lastModified > lastConfigReadTime) { + /* + * The file has been altered since it was read in the last time. + * Must re-read it. + */ + logger.debug(Logger.EVENT_SUCCESS, ">> Re-reading WAF policy"); + init(fc); + } + } + + logger.debug(Logger.EVENT_SUCCESS, ">>In WAF doFilter"); + + HttpServletRequest httpRequest = (HttpServletRequest) servletRequest; + HttpServletResponse httpResponse = (HttpServletResponse) servletResponse; + + InterceptingHTTPServletRequest request = null; + InterceptingHTTPServletResponse response = null; + + /* + * First thing to do is create the InterceptingHTTPServletResponse, + * since we'll need that possibly before the + * InterceptingHTTPServletRequest. + * + * The normal HttpRequest-type objects will suffice us until we get to + * stage 2. + * + * 1st argument = the response to base the instance on 2nd argument = + * should we bother intercepting the egress response? 3rd argument = + * cookie rules because thats where they mostly get acted on + */ + + if (appGuardConfig.getCookieRules().size() + appGuardConfig.getBeforeResponseRules().size() > 0) { + response = new InterceptingHTTPServletResponse(httpResponse, true, appGuardConfig.getCookieRules()); + } + + /* + * Stage 1: Rules that do not need the request body. + */ + logger.debug(Logger.EVENT_SUCCESS, ">> Starting stage 1"); + + List rules = this.appGuardConfig.getBeforeBodyRules(); + + for (int i = 0; i < rules.size(); i++) { + + Rule rule = rules.get(i); + logger.debug(Logger.EVENT_SUCCESS, " Applying BEFORE rule: " + rule.getClass().getName()); + + /* + * The rules execute in check(). The check() method will also log. + * All we have to do is decide what other actions to take. + */ + Action action = rule.check(httpRequest, response, httpResponse); + + if (action.isActionNecessary()) { + + if (action instanceof BlockAction) { + if (response != null) { + response.setStatus(appGuardConfig.getDefaultResponseCode()); + } else { + httpResponse.setStatus(appGuardConfig.getDefaultResponseCode()); + } + return; + + } else if (action instanceof RedirectAction) { + sendRedirect(response, httpResponse, ((RedirectAction) action).getRedirectURL()); + return; + + } else if (action instanceof DefaultAction) { + + switch (AppGuardianConfiguration.DEFAULT_FAIL_ACTION) { + case AppGuardianConfiguration.BLOCK: + if (response != null) { + response.setStatus(appGuardConfig.getDefaultResponseCode()); + } else { + httpResponse.setStatus(appGuardConfig.getDefaultResponseCode()); + } + return; + + case AppGuardianConfiguration.REDIRECT: + sendRedirect(response, httpResponse); + return; + } + } + } + } + + /* + * Create the InterceptingHTTPServletRequest. + */ + + try { + request = new InterceptingHTTPServletRequest((HttpServletRequest) servletRequest); + } catch (FileUploadException fue) { + logger.error(Logger.EVENT_SUCCESS, "Error Wrapping Request", fue); + } + + /* + * Stage 2: After the body has been read, but before the the application + * has gotten it. + */ + logger.debug(Logger.EVENT_SUCCESS, ">> Starting Stage 2"); + + rules = this.appGuardConfig.getAfterBodyRules(); + + for (int i = 0; i < rules.size(); i++) { + + Rule rule = rules.get(i); + logger.debug(Logger.EVENT_SUCCESS, " Applying BEFORE CHAIN rule: " + rule.getClass().getName()); + + /* + * The rules execute in check(). The check() method will take care + * of logging. All we have to do is decide what other actions to + * take. + */ + Action action = rule.check(request, response, httpResponse); + + if (action.isActionNecessary()) { + + if (action instanceof BlockAction) { + if (response != null) { + response.setStatus(appGuardConfig.getDefaultResponseCode()); + } else { + httpResponse.setStatus(appGuardConfig.getDefaultResponseCode()); + } + return; + + } else if (action instanceof RedirectAction) { + sendRedirect(response, httpResponse, ((RedirectAction) action).getRedirectURL()); + return; + + } else if (action instanceof DefaultAction) { + + switch (AppGuardianConfiguration.DEFAULT_FAIL_ACTION) { + case AppGuardianConfiguration.BLOCK: + if (response != null) { + response.setStatus(appGuardConfig.getDefaultResponseCode()); + } else { + httpResponse.setStatus(appGuardConfig.getDefaultResponseCode()); + } + return; + + case AppGuardianConfiguration.REDIRECT: + sendRedirect(response, httpResponse); + return; + } + } + } + } + + /* + * In between stages 2 and 3 is the application's processing of the + * input. + */ + logger.debug(Logger.EVENT_SUCCESS, ">> Calling the FilterChain: " + chain); + chain.doFilter(request, response != null ? response : httpResponse); + + /* + * Stage 3: Before the response has been sent back to the user. + */ + logger.debug(Logger.EVENT_SUCCESS, ">> Starting Stage 3"); + + rules = this.appGuardConfig.getBeforeResponseRules(); + + for (int i = 0; i < rules.size(); i++) { + + Rule rule = rules.get(i); + logger.debug(Logger.EVENT_SUCCESS, " Applying AFTER CHAIN rule: " + rule.getClass().getName()); + + /* + * The rules execute in check(). The check() method will also log. + * All we have to do is decide what other actions to take. + */ + Action action = rule.check(request, response, httpResponse); + + if (action.isActionNecessary()) { + + if (action instanceof BlockAction) { + if (response != null) { + response.setStatus(appGuardConfig.getDefaultResponseCode()); + } else { + httpResponse.setStatus(appGuardConfig.getDefaultResponseCode()); + } + return; + + } else if (action instanceof RedirectAction) { + sendRedirect(response, httpResponse, ((RedirectAction) action).getRedirectURL()); + return; + + } else if (action instanceof DefaultAction) { + + switch (AppGuardianConfiguration.DEFAULT_FAIL_ACTION) { + case AppGuardianConfiguration.BLOCK: + if (response != null) { + response.setStatus(appGuardConfig.getDefaultResponseCode()); + } else { + httpResponse.setStatus(appGuardConfig.getDefaultResponseCode()); + } + return; + + case AppGuardianConfiguration.REDIRECT: + sendRedirect(response, httpResponse); + return; + } + } + } + } + + /* + * Now that we've run our last set of rules we can allow the response to + * go through if we were intercepting. + */ + + if (response != null) { + logger.debug(Logger.EVENT_SUCCESS, ">>> committing reponse"); + response.commit(); + } + } + + /* + * Utility method to send HTTP redirects that automatically determines which + * response class to use. + */ + private void sendRedirect(InterceptingHTTPServletResponse response, HttpServletResponse httpResponse, + String redirectURL) throws IOException { + + if (response != null) { // if we've been buffering everything we clean + // it all out before sending back. + response.reset(); + response.resetBuffer(); + response.sendRedirect(redirectURL); + response.commit(); + } else { + httpResponse.sendRedirect(redirectURL); + } + + } + + public void destroy() { + /* + * Any cleanup necessary? + */ + } + + private void sendRedirect(InterceptingHTTPServletResponse response, HttpServletResponse httpResponse) + throws IOException { + /* + * [chrisisbeef] - commented out as this is not currently used. Minor + * performance tweak. String finalJavaScript = + * AppGuardianConfiguration.JAVASCRIPT_REDIRECT; finalJavaScript = + * finalJavaScript.replaceAll(AppGuardianConfiguration. + * JAVASCRIPT_TARGET_TOKEN, appGuardConfig.getDefaultErrorPage()); + */ + + if (response != null) { + response.reset(); + response.resetBuffer(); + /* + * response.setStatus(appGuardConfig.getDefaultResponseCode()); + * response.getOutputStream().write(finalJavaScript.getBytes()); + */ + response.sendRedirect(appGuardConfig.getDefaultErrorPage()); + + } else { + if (!httpResponse.isCommitted()) { + httpResponse.sendRedirect(appGuardConfig.getDefaultErrorPage()); + } else { + /* + * Can't send redirect because response is already committed. + * I'm not sure how this could happen, but I didn't want to + * cause IOExceptions in case if it ever does. + */ + } + + } + } + +} From 12ac88ccd92a606593bfb1bfe678a70b3cf0d80e Mon Sep 17 00:00:00 2001 From: kwwall Date: Sat, 16 Jan 2016 15:13:27 -0500 Subject: [PATCH 074/812] Make getProperty(String,String) synchronized. Closes #321. --- .../esapi/reference/crypto/ReferenceEncryptedProperties.java | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/main/java/org/owasp/esapi/reference/crypto/ReferenceEncryptedProperties.java b/src/main/java/org/owasp/esapi/reference/crypto/ReferenceEncryptedProperties.java index cffc14963..0d35b25dd 100644 --- a/src/main/java/org/owasp/esapi/reference/crypto/ReferenceEncryptedProperties.java +++ b/src/main/java/org/owasp/esapi/reference/crypto/ReferenceEncryptedProperties.java @@ -129,7 +129,7 @@ public synchronized String getProperty(String key) throws EncryptionRuntimeExcep * @throws EncryptionRuntimeException Thrown if decryption fails. */ @Override - public String getProperty(String key, String defaultValue) throws EncryptionRuntimeException { + public synchronized String getProperty(String key, String defaultValue) throws EncryptionRuntimeException { String value = getProperty(key); if (value == null) return defaultValue; From 644cd4d36be35ec756ddbce9588c65f6358d1ed6 Mon Sep 17 00:00:00 2001 From: kwwall Date: Sat, 16 Jan 2016 17:51:26 -0500 Subject: [PATCH 075/812] Applied patches from Eric Citaire and Matt Seil. Fixes #322. --- .../filters/RequestRateThrottleFilter.java | 43 ++++++++----------- 1 file changed, 19 insertions(+), 24 deletions(-) diff --git a/src/main/java/org/owasp/esapi/filters/RequestRateThrottleFilter.java b/src/main/java/org/owasp/esapi/filters/RequestRateThrottleFilter.java index 0ca121ec6..4ac188979 100644 --- a/src/main/java/org/owasp/esapi/filters/RequestRateThrottleFilter.java +++ b/src/main/java/org/owasp/esapi/filters/RequestRateThrottleFilter.java @@ -53,8 +53,8 @@ public class RequestRateThrottleFilter implements Filter */ public void init(FilterConfig filterConfig) { - hits = Integer.parseInt(filterConfig.getInitParameter(HITS)); - period = Integer.parseInt(filterConfig.getInitParameter(PERIOD)); + hits = filterConfig.getInitParameter(HITS) == null ? 5 : Integer.parseInt(filterConfig.getInitParameter(HITS)); + period = filterConfig.getInitParameter(PERIOD) == null ? 10 : Integer.parseInt(filterConfig.getInitParameter(PERIOD)); } /** @@ -75,27 +75,22 @@ public void doFilter(ServletRequest request, ServletResponse response, FilterCha HttpSession session = httpRequest.getSession(true); synchronized( session.getId().intern() ) { - Stack times = ESAPI.httpUtilities().getSessionAttribute("times"); - if (times == null) - { - times = new Stack(); - times.push(new Date(0)); - session.setAttribute("times", times); - } - times.push(new Date()); - if (times.size() >= hits) - { - times.removeElementAt(0); - } - Date newest = times.get(times.size() - 1); - Date oldest = times.get(0); - long elapsed = newest.getTime() - oldest.getTime(); - if (elapsed < period * 1000) // seconds - { - response.getWriter().println("Request rate too high"); - return; - } - } + List times = ESAPI.httpUtilities().getSessionAttribute("times"); + if (times == null) { + times = new LinkedList(); + session.setAttribute("times", times); + } + Long newest = System.currentTimeMillis(); + times.add(newest); + if (times.size() > hits) { + Long oldest = times.remove(0); + long elapsed = newest - oldest; + if (elapsed < period * 1000) { + response.getWriter().println("Request rate too high"); + return; + } + } + } chain.doFilter(request, response); } @@ -111,4 +106,4 @@ public void destroy() // finalize } -} \ No newline at end of file +} From 14fd61a7a29824c2bd3ee27e755ccf4253bdf141 Mon Sep 17 00:00:00 2001 From: kwwall Date: Sat, 16 Jan 2016 21:32:49 -0500 Subject: [PATCH 076/812] JUnit changes made because of changes to CipherSpec class and changing assertions to exlicit runtime checks resulting in IllegalArgumentExceptions. --- .../owasp/esapi/crypto/CipherSpecTest.java | 19 ++++++++++--------- 1 file changed, 10 insertions(+), 9 deletions(-) diff --git a/src/test/java/org/owasp/esapi/crypto/CipherSpecTest.java b/src/test/java/org/owasp/esapi/crypto/CipherSpecTest.java index b842aaec6..8f808880f 100644 --- a/src/test/java/org/owasp/esapi/crypto/CipherSpecTest.java +++ b/src/test/java/org/owasp/esapi/crypto/CipherSpecTest.java @@ -144,14 +144,14 @@ public class CipherSpecTest extends TestCase { /** Test setBlockSize() */ @Test public void testSetBlockSize() { try { - cipherSpec.setBlockSize(0); // Throws AssertionError - } catch (AssertionError e) { - assertTrue(true); // Doesn't work w/ @Test(expected=AssertionError.class) + cipherSpec.setBlockSize(0); // Throws IllegalArgumentException + } catch (IllegalArgumentException e) { + assertTrue(true); } try { - cipherSpec.setBlockSize(-1); // Throws AssertionError - } catch (AssertionError e) { - assertTrue(true); // Doesn't work w/ @Test(expected=AssertionError.class) + cipherSpec.setBlockSize(-1); // Throws IllegalArgumentException + } catch (IllegalArgumentException e) { + assertTrue(true); } assertTrue( cipherSpec.setBlockSize(4).getBlockSize() == 4 ); } @@ -181,9 +181,10 @@ public class CipherSpecTest extends TestCase { try { // Test that ECB mode allows a null IV cipherSpec = new CipherSpec(dfltECBCipher); + assertTrue( cipherSpec.getCipherMode().equals("ECB") ); cipherSpec.setIV(null); assertTrue(true); - } catch ( AssertionError e) { + } catch ( IllegalArgumentException e) { assertFalse("Test failed; unexpected exception", false); } try { @@ -191,7 +192,7 @@ public class CipherSpecTest extends TestCase { cipherSpec = new CipherSpec(dfltAESCipher); cipherSpec.setIV(null); assertFalse("Test failed; Expected exception not thrown", false); - } catch ( AssertionError e) { + } catch ( IllegalArgumentException e) { assertTrue(true); } } @@ -270,4 +271,4 @@ public static junit.framework.Test suite() { return suite; } -} \ No newline at end of file +} From 3c8e18d726095fbc88dc42c1c7a7c5e8d5943e45 Mon Sep 17 00:00:00 2001 From: kwwall Date: Sat, 16 Jan 2016 21:34:50 -0500 Subject: [PATCH 077/812] Forgot to add imports for List and LinkedList. Fixes issue #322. --- .../org/owasp/esapi/filters/RequestRateThrottleFilter.java | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/src/main/java/org/owasp/esapi/filters/RequestRateThrottleFilter.java b/src/main/java/org/owasp/esapi/filters/RequestRateThrottleFilter.java index 4ac188979..4d78551fd 100644 --- a/src/main/java/org/owasp/esapi/filters/RequestRateThrottleFilter.java +++ b/src/main/java/org/owasp/esapi/filters/RequestRateThrottleFilter.java @@ -22,7 +22,8 @@ import javax.servlet.http.HttpSession; import java.io.IOException; import java.util.Date; -import java.util.Stack; +import java.util.List; +import java.util.LinkedList; /** * A simple servlet filter that limits the request rate to a certain threshold of requests per second. From 86c6fa54bde1aca91c7bd08b9ee96c1a5fdb99e5 Mon Sep 17 00:00:00 2001 From: kwwall Date: Sat, 16 Jan 2016 22:08:06 -0500 Subject: [PATCH 078/812] Ignore everything in 'target' directory. --- .gitignore | 1 + 1 file changed, 1 insertion(+) create mode 100644 .gitignore diff --git a/.gitignore b/.gitignore new file mode 100644 index 000000000..ea8c4bf7f --- /dev/null +++ b/.gitignore @@ -0,0 +1 @@ +/target From e0220902fc0e1a5ecb96587b1ae39931d11fcffb Mon Sep 17 00:00:00 2001 From: kwwall Date: Sat, 16 Jan 2016 22:17:10 -0500 Subject: [PATCH 079/812] Configure line endings and file types for common file extensions as discussed with Matt Seil via Gmail on 12/31/2015. --- .gitattributes | 40 ++++++++++++++++++++++++++++++++++++++++ 1 file changed, 40 insertions(+) create mode 100644 .gitattributes diff --git a/.gitattributes b/.gitattributes new file mode 100644 index 000000000..596f92708 --- /dev/null +++ b/.gitattributes @@ -0,0 +1,40 @@ +# Set the default behavior, in case people don't have core.autocrlf set. +* text=auto + +# Explicitly declare text files you want to always be normalized and converted +# to native line endings on checkout. +*.java text +*.properties text +*.xml text +*.xsd text +*.dtd text +*.MF text +*.md text +*.html text +*.tld text +*.json text + +# Declare files that will always have CRLF line endings on checkout. +*.cmd text eol=crlf +*.bat text eol=crlf +# Because *nix editors / paginators can handle either way, but braindead +# Windoze notepad, the default to open .txt files, not so much. +*.txt text eol=crlf + +# Declare files that will always have LF line endings on checkout +*.sh text eol=lf +*.bsh text eol=lf + +# Denote all files that are truly binary and should not be modified, +# or simply replaced in whole if committed. +*.jpg binary +*.JPG binary +*.jks binary +*.ser binary +*.doc binary +*.docx binary +*.xls binary +*.xlsx binary +*.pptx binary +*.odt binary +*.pdf binary From e3f09d8ec48986b5fcc9f675bb3933a0467e152c Mon Sep 17 00:00:00 2001 From: Matt Date: Mon, 18 Jan 2016 09:46:04 -0600 Subject: [PATCH 080/812] Commented text=auto in .gitattributes. --- .gitattributes | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.gitattributes b/.gitattributes index 596f92708..82f8b6ca8 100644 --- a/.gitattributes +++ b/.gitattributes @@ -1,5 +1,5 @@ # Set the default behavior, in case people don't have core.autocrlf set. -* text=auto +#* text=auto # Explicitly declare text files you want to always be normalized and converted # to native line endings on checkout. From 84dfcb75e9fb819c5a00814d81923b2c124db966 Mon Sep 17 00:00:00 2001 From: Matt Date: Mon, 18 Jan 2016 13:12:06 -0600 Subject: [PATCH 081/812] Removed comment from .gitattribute --- .gitattributes | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.gitattributes b/.gitattributes index 82f8b6ca8..596f92708 100644 --- a/.gitattributes +++ b/.gitattributes @@ -1,5 +1,5 @@ # Set the default behavior, in case people don't have core.autocrlf set. -#* text=auto +* text=auto # Explicitly declare text files you want to always be normalized and converted # to native line endings on checkout. From 2d810cebb1093a795f375e7bc947b8030624d01c Mon Sep 17 00:00:00 2001 From: Matt Seil Date: Mon, 18 Jan 2016 13:25:28 -0600 Subject: [PATCH 082/812] Changed java eol to 'LF' --- .gitattributes | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.gitattributes b/.gitattributes index 596f92708..b22d37b11 100644 --- a/.gitattributes +++ b/.gitattributes @@ -3,7 +3,7 @@ # Explicitly declare text files you want to always be normalized and converted # to native line endings on checkout. -*.java text +*.java eol=lf *.properties text *.xml text *.xsd text From 5092bbf5f7177779bbe20dd7d5931814c3a80a60 Mon Sep 17 00:00:00 2001 From: Matt Seil Date: Mon, 18 Jan 2016 13:27:50 -0600 Subject: [PATCH 083/812] Changed .java to crlf for testing. --- .gitattributes | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.gitattributes b/.gitattributes index b22d37b11..2b98a25d6 100644 --- a/.gitattributes +++ b/.gitattributes @@ -3,7 +3,7 @@ # Explicitly declare text files you want to always be normalized and converted # to native line endings on checkout. -*.java eol=lf +*.java eol=crlf *.properties text *.xml text *.xsd text From 54fca07bbb54195c94f4e95290d353436239be04 Mon Sep 17 00:00:00 2001 From: Matt Seil Date: Mon, 18 Jan 2016 14:54:42 -0600 Subject: [PATCH 084/812] Revert "Changed .java to crlf for testing." This reverts commit 5092bbf5f7177779bbe20dd7d5931814c3a80a60. --- .gitattributes | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.gitattributes b/.gitattributes index 2b98a25d6..b22d37b11 100644 --- a/.gitattributes +++ b/.gitattributes @@ -3,7 +3,7 @@ # Explicitly declare text files you want to always be normalized and converted # to native line endings on checkout. -*.java eol=crlf +*.java eol=lf *.properties text *.xml text *.xsd text From 38053aae32f648170ceada2a24b7ef4c1a324bfe Mon Sep 17 00:00:00 2001 From: kwwall Date: Mon, 18 Jan 2016 22:54:09 -0500 Subject: [PATCH 085/812] Try to fix the CRLF mess that we're in via .gitattributes. --- .gitattributes | 24 +++++++++++++++++++++--- 1 file changed, 21 insertions(+), 3 deletions(-) diff --git a/.gitattributes b/.gitattributes index b22d37b11..a90ca1d70 100644 --- a/.gitattributes +++ b/.gitattributes @@ -1,9 +1,22 @@ -# Set the default behavior, in case people don't have core.autocrlf set. +# Autodetect text files +# +# In addition: +# Windows developers should set: +# git config --global core.autocrlf true +# UNIX / MacOS develoers should set: +# git config --global core.autocrlf input * text=auto +# And configure default EOL terminators. +# +# Force the following filetypes to have Unix eols, so Windows does not break them +# Those that are not explicitly set to use Windows EOL will use LF as EOL terminator. +# (e.g., see *.bat, below). +*.* text eol=lf + # Explicitly declare text files you want to always be normalized and converted # to native line endings on checkout. -*.java eol=lf +*.java text *.properties text *.xml text *.xsd text @@ -18,17 +31,22 @@ *.cmd text eol=crlf *.bat text eol=crlf # Because *nix editors / paginators can handle either way, but braindead -# Windoze notepad, the default to open .txt files, not so much. +# Windoze notepad which is used by default to handle text files in Windows, +# not so much, we also make the concession here to use CRLF for EOL. *.txt text eol=crlf +# Ditto for Eclipse related preferences +*.prefs text eol=crlf # Declare files that will always have LF line endings on checkout *.sh text eol=lf *.bsh text eol=lf +*.ksh text eol=lf # Denote all files that are truly binary and should not be modified, # or simply replaced in whole if committed. *.jpg binary *.JPG binary +*.png binary *.jks binary *.ser binary *.doc binary From ca5723b81c6a4ccaccd6f02c4ff5c98628096f4b Mon Sep 17 00:00:00 2001 From: kwwall Date: Mon, 18 Jan 2016 23:26:01 -0500 Subject: [PATCH 086/812] Test case for issue 356. If this works, will do mass updates. --- .../org/owasp/esapi/waf/WAFTestUtility.java | 182 +++++++++--------- 1 file changed, 91 insertions(+), 91 deletions(-) diff --git a/src/test/java/org/owasp/esapi/waf/WAFTestUtility.java b/src/test/java/org/owasp/esapi/waf/WAFTestUtility.java index 3a58b387c..205d0d564 100644 --- a/src/test/java/org/owasp/esapi/waf/WAFTestUtility.java +++ b/src/test/java/org/owasp/esapi/waf/WAFTestUtility.java @@ -1,91 +1,91 @@ -/** - * OWASP Enterprise Security API (ESAPI) - * - * This file is part of the Open Web Application Security Project (OWASP) - * Enterprise Security API (ESAPI) project. For details, please see - * http://www.owasp.org/index.php/ESAPI. - * - * Copyright (c) 2009 - The OWASP Foundation - * - * The ESAPI is published by OWASP under the BSD license. You should read and accept the - * LICENSE before you use, modify, and/or redistribute this software. - * - * @author Arshan Dabirsiaghi Aspect Security - * - * @created 2009 - */ -package org.owasp.esapi.waf; - -import java.io.File; -import java.io.FileInputStream; -import java.io.InputStream; -import java.util.HashMap; -import java.util.Map; - -import javax.servlet.FilterConfig; - -import org.owasp.esapi.ESAPI; -import org.owasp.esapi.http.MockFilterChain; -import org.owasp.esapi.http.MockFilterConfig; -import org.owasp.esapi.http.MockHttpServletRequest; -import org.owasp.esapi.http.MockHttpServletResponse; - -/** - * This class holds a number of static utilities to make writing WAF test cases easy. Definitely not useful - * for anything other than testing. - */ -public class WAFTestUtility { - - public static void setWAFPolicy( ESAPIWebApplicationFirewallFilter waf, String policyFile ) throws Exception { - Map map = new HashMap(); - map.put( "configuration", policyFile ); - map.put( "log_settings", "../log4j.xml"); - FilterConfig mfc = new MockWafFilterConfig( map ); - waf.init( mfc ); - } - - public static int checkWAFResult( ESAPIWebApplicationFirewallFilter waf, MockHttpServletRequest request, MockHttpServletResponse response, MockFilterChain chain ) throws Exception { - - //request.dump(); - waf.doFilter(request, response, chain); - //response.dump(); - - return response.getStatus(); - - } - - public static int createAndExecuteWAFTransaction ( ESAPIWebApplicationFirewallFilter waf, MockHttpServletRequest request, MockHttpServletResponse response ) throws Exception { - - MockFilterChain chain = new MockFilterChain(); - - return WAFTestUtility.checkWAFResult(waf, request, response, chain); - - } - - public static int createAndExecuteWAFTransaction ( ESAPIWebApplicationFirewallFilter waf, MockHttpServletRequest request, MockHttpServletResponse response, MockFilterChain filterChain ) throws Exception { - - - return WAFTestUtility.checkWAFResult(waf, request, response, filterChain); - - } - - public static int createAndExecuteWAFTransaction ( String policy, MockHttpServletRequest request, MockHttpServletResponse response ) throws Exception { - - ESAPIWebApplicationFirewallFilter waf = new ESAPIWebApplicationFirewallFilter(); - File f = ESAPI.securityConfiguration().getResourceFile(policy); - waf.setConfiguration(f.getAbsolutePath(),""); - - return createAndExecuteWAFTransaction(waf, request, response ); - - } - - public static int createAndExecuteWAFTransaction ( String policy, MockHttpServletRequest request, MockHttpServletResponse response, MockFilterChain filterChain ) throws Exception { - - ESAPIWebApplicationFirewallFilter waf = new ESAPIWebApplicationFirewallFilter(); - File f = ESAPI.securityConfiguration().getResourceFile(policy); - waf.setConfiguration(f.getAbsolutePath(),""); - - return createAndExecuteWAFTransaction(waf, request, response, filterChain ); - - } -} +/** + * OWASP Enterprise Security API (ESAPI) + * + * This file is part of the Open Web Application Security Project (OWASP) + * Enterprise Security API (ESAPI) project. For details, please see + * http://www.owasp.org/index.php/ESAPI. + * + * Copyright (c) 2009 - The OWASP Foundation + * + * The ESAPI is published by OWASP under the BSD license. You should read and accept the + * LICENSE before you use, modify, and/or redistribute this software. + * + * @author Arshan Dabirsiaghi Aspect Security + * + * @created 2009 + */ +package org.owasp.esapi.waf; + +import java.io.File; +import java.io.FileInputStream; +import java.io.InputStream; +import java.util.HashMap; +import java.util.Map; + +import javax.servlet.FilterConfig; + +import org.owasp.esapi.ESAPI; +import org.owasp.esapi.http.MockFilterChain; +import org.owasp.esapi.http.MockFilterConfig; +import org.owasp.esapi.http.MockHttpServletRequest; +import org.owasp.esapi.http.MockHttpServletResponse; + +/** + * This class holds a number of static utilities to make writing WAF test cases easy. Definitely not useful + * for anything other than testing. + */ +public class WAFTestUtility { + + public static void setWAFPolicy( ESAPIWebApplicationFirewallFilter waf, String policyFile ) throws Exception { + Map map = new HashMap(); + map.put( "configuration", policyFile ); + map.put( "log_settings", "../log4j.xml"); + FilterConfig mfc = new MockWafFilterConfig( map ); + waf.init( mfc ); + } + + public static int checkWAFResult( ESAPIWebApplicationFirewallFilter waf, MockHttpServletRequest request, MockHttpServletResponse response, MockFilterChain chain ) throws Exception { + + //request.dump(); + waf.doFilter(request, response, chain); + //response.dump(); + + return response.getStatus(); + + } + + public static int createAndExecuteWAFTransaction ( ESAPIWebApplicationFirewallFilter waf, MockHttpServletRequest request, MockHttpServletResponse response ) throws Exception { + + MockFilterChain chain = new MockFilterChain(); + + return WAFTestUtility.checkWAFResult(waf, request, response, chain); + + } + + public static int createAndExecuteWAFTransaction ( ESAPIWebApplicationFirewallFilter waf, MockHttpServletRequest request, MockHttpServletResponse response, MockFilterChain filterChain ) throws Exception { + + + return WAFTestUtility.checkWAFResult(waf, request, response, filterChain); + + } + + public static int createAndExecuteWAFTransaction ( String policy, MockHttpServletRequest request, MockHttpServletResponse response ) throws Exception { + + ESAPIWebApplicationFirewallFilter waf = new ESAPIWebApplicationFirewallFilter(); + File f = ESAPI.securityConfiguration().getResourceFile(policy); + waf.setConfiguration(f.getAbsolutePath(),""); + + return createAndExecuteWAFTransaction(waf, request, response ); + + } + + public static int createAndExecuteWAFTransaction ( String policy, MockHttpServletRequest request, MockHttpServletResponse response, MockFilterChain filterChain ) throws Exception { + + ESAPIWebApplicationFirewallFilter waf = new ESAPIWebApplicationFirewallFilter(); + File f = ESAPI.securityConfiguration().getResourceFile(policy); + waf.setConfiguration(f.getAbsolutePath(),""); + + return createAndExecuteWAFTransaction(waf, request, response, filterChain ); + + } +} From f5a66275bdd3d5be246d0bc024077ddb0d050287 Mon Sep 17 00:00:00 2001 From: kwwall Date: Mon, 18 Jan 2016 23:33:47 -0500 Subject: [PATCH 087/812] Change CRLF to LF for issue 356. --- .../org/owasp/esapi/AccessController.java | 702 +++++++++--------- 1 file changed, 351 insertions(+), 351 deletions(-) diff --git a/src/main/java/org/owasp/esapi/AccessController.java b/src/main/java/org/owasp/esapi/AccessController.java index e6269e1d5..2d9e4dac8 100644 --- a/src/main/java/org/owasp/esapi/AccessController.java +++ b/src/main/java/org/owasp/esapi/AccessController.java @@ -1,351 +1,351 @@ -/** - * OWASP Enterprise Security API (ESAPI) - * - * This file is part of the Open Web Application Security Project (OWASP) - * Enterprise Security API (ESAPI) project. For details, please see - * http://www.owasp.org/index.php/ESAPI. - * - * Copyright (c) 2007 - The OWASP Foundation - * - * The ESAPI is published by OWASP under the BSD license. You should read and accept the - * LICENSE before you use, modify, and/or redistribute this software. - * - * @author Jeff Williams Aspect Security - * @created 2007 - */ -package org.owasp.esapi; - -import org.owasp.esapi.errors.AccessControlException; - - - -/** - * The AccessController interface defines a set of methods that can be used in a wide variety of applications to - * enforce access control. In most applications, access control must be performed in multiple different locations across - * the various application layers. This class provides access control for URLs, business functions, data, services, and - * files. - *

    - * The implementation of this interface will need to access the current User object (from Authenticator.getCurrentUser()) - * to determine roles or permissions. In addition, the implementation - * will also need information about the resources that are being accessed. Using the user information and the resource - * information, the implementation should return an access control decision. - *

    - * Implementers are encouraged to implement the ESAPI access control rules, like assertAuthorizedForFunction() using - * existing access control mechanisms, such as methods like isUserInRole() or hasPrivilege(). While powerful, - * methods like isUserInRole() can be confusing for developers, as users may be in multiple roles or possess multiple - * overlapping privileges. Direct use of these finer grained access control methods encourages the use of complex boolean - * tests throughout the code, which can easily lead to developer mistakes. - *

    - * The point of the ESAPI access control interface is to centralize access control logic behind easy to use calls like - * assertAuthorized() so that access control is easy to use and easy to verify. Here is an example of a very - * straightforward to implement, understand, and verify ESAPI access control check: - * - * 

    - * try {
- *     ESAPI.accessController().assertAuthorized("businessFunction", runtimeData);
- *     // execute BUSINESS_FUNCTION
- * } catch (AccessControlException ace) {
- * ... attack in progress
- * }
- *
    - * - * Note that in the user interface layer, access control checks can be used to control whether particular controls are - * rendered or not. These checks are supposed to fail when an unauthorized user is logged in, and do not represent - * attacks. Remember that regardless of how the user interface appears, an attacker can attempt to invoke any business - * function or access any data in your application. Therefore, access control checks in the user interface should be - * repeated in both the business logic and data layers. - * - * 
    - * <% if ( ESAPI.accessController().isAuthorized( "businessFunction", runtimeData ) ) { %>
- * <a href="/doAdminFunction">ADMIN</a>
- * <% } else { %>
- * <a href="/doNormalFunction">NORMAL</a>
- * <% } %>
- *
    - * - * @author Mike H. Fauzy (mike.fauzy@aspectsecurity.com) ESAPI v1.6- - * @author Jeff Williams (jeff.williams@aspectsecurity.com) ESAPI v0-1.5 - */ -public interface AccessController { - - /** - * isAuthorized executes the AccessControlRule - * that is identified by key and listed in the - * resources/ESAPI-AccessControlPolicy.xml file. It returns - * true if the AccessControlRule decides that the operation - * should be allowed. Otherwise, it returns false. Any exception thrown by - * the AccessControlRule must result in false. If - * key does not map to an AccessControlRule, then - * false is returned. - * - * Developers should call isAuthorized to control execution flow. For - * example, if you want to decide whether to display a UI widget in the - * browser using the same logic that you will use to enforce permissions - * on the server, then isAuthorized is the method that you want to use. - * - * Typically, assertAuthorized should be used to enforce permissions on the - * server. - * - * @param key key maps to - * <AccessControlPolicy><AccessControlRules> - * <AccessControlRule name="key" - * @param runtimeParameter runtimeParameter can contain anything that - * the AccessControlRule needs from the runtime system. - * @return Returns true if and only if the AccessControlRule specified - * by key exists and returned true. - * Otherwise returns false - */ - public boolean isAuthorized(Object key, Object runtimeParameter); - - /** - * assertAuthorized executes the AccessControlRule - * that is identified by key and listed in the - * resources/ESAPI-AccessControlPolicy.xml file. It does - * nothing if the AccessControlRule decides that the operation - * should be allowed. Otherwise, it throws an - * org.owasp.esapi.errors.AccessControlException. Any exception - * thrown by the AccessControlRule will also result in an - * AccesControlException. If key does not map to - * an AccessControlRule, then an AccessControlException - * is thrown. - * - * Developers should call {@code assertAuthorized} to enforce privileged access to - * the system. It should be used to answer the question: "Should execution - * continue." Ideally, the call to assertAuthorized should - * be integrated into the application framework so that it is called - * automatically. - * - * @param key key maps to - * <AccessControlPolicy><AccessControlRules> - * <AccessControlRule name="key" - * @param runtimeParameter runtimeParameter can contain anything that - * the AccessControlRule needs from the runtime system. - */ - public void assertAuthorized(Object key, Object runtimeParameter) - throws AccessControlException; - - - - - /*** Below this line has been deprecated as of ESAPI 1.6 ***/ - - - - - /** - * Checks if the current user is authorized to access the referenced URL. Generally, this method should be invoked in the - * application's controller or a filter as follows: - * 
    ESAPI.accessController().isAuthorizedForURL(request.getRequestURI().toString());
    - * - * The implementation of this method should call assertAuthorizedForURL(String url), and if an AccessControlException is - * not thrown, this method should return true. This way, if the user is not authorized, false would be returned, and the - * exception would be logged. - * - * @param url - * the URL as returned by request.getRequestURI().toString() - * - * @return - * true, if is authorized for URL - */ - boolean isAuthorizedForURL(String url); - - /** - * Checks if the current user is authorized to access the referenced function. - * - * The implementation of this method should call assertAuthorizedForFunction(String functionName), and if an - * AccessControlException is not thrown, this method should return true. - * - * @param functionName - * the name of the function - * - * @return - * true, if is authorized for function - */ - boolean isAuthorizedForFunction(String functionName); - - - /** - * Checks if the current user is authorized to access the referenced data, represented as an Object. - * - * The implementation of this method should call assertAuthorizedForData(String action, Object data), and if an - * AccessControlException is not thrown, this method should return true. - * - * @param action - * The action to verify for an access control decision, such as a role, or an action being performed on the object - * (e.g., Read, Write, etc.), or the name of the function the data is being passed to. - * - * @param data - * The actual object or object identifier being accessed or a reference to the object being accessed. - * - * @return - * true, if is authorized for the data - */ - boolean isAuthorizedForData(String action, Object data); - - /** - * Checks if the current user is authorized to access the referenced file. - * - * The implementation of this method should call assertAuthorizedForFile(String filepath), and if an AccessControlException - * is not thrown, this method should return true. - * - * @param filepath - * the path of the file to be checked, including filename - * - * @return - * true, if is authorized for the file - */ - boolean isAuthorizedForFile(String filepath); - - /** - * Checks if the current user is authorized to access the referenced service. This can be used in applications that - * provide access to a variety of back end services. - * - * The implementation of this method should call assertAuthorizedForService(String serviceName), and if an - * AccessControlException is not thrown, this method should return true. - * - * @param serviceName - * the service name - * - * @return - * true, if is authorized for the service - */ - boolean isAuthorizedForService(String serviceName); - - /** - * Checks if the current user is authorized to access the referenced URL. The implementation should allow - * access to be granted to any part of the URL. Generally, this method should be invoked in the - * application's controller or a filter as follows: - * 
    ESAPI.accessController().assertAuthorizedForURL(request.getRequestURI().toString());
    - * - * This method throws an AccessControlException if access is not authorized, or if the referenced URL does not exist. - * If the User is authorized, this method simply returns. - *

    - * Specification: The implementation should do the following: - *

      - *
    1. Check to see if the resource exists and if not, throw an AccessControlException
      2. - *
    2. Use available information to make an access control decision
      3. - *
        - *
      1. Ideally, this policy would be data driven
        2. - *
      2. You can use the current User, roles, data type, data name, time of day, etc.
        3. - *
      3. Access control decisions must deny by default
        4. - *
      - *
    3. If access is not permitted, throw an AccessControlException with details
      4. - *
    - * @param url - * the URL as returned by request.getRequestURI().toString() - * - * @throws AccessControlException - * if access is not permitted - */ - void assertAuthorizedForURL(String url) throws AccessControlException; - - /** - * Checks if the current user is authorized to access the referenced function. The implementation should define the - * function "namespace" to be enforced. Choosing something simple like the class name of action classes or menu item - * names will make this implementation easier to use. - *

    - * This method throws an AccessControlException if access is not authorized, or if the referenced function does not exist. - * If the User is authorized, this method simply returns. - *

    - * Specification: The implementation should do the following: - *

      - *
    1. Check to see if the function exists and if not, throw an AccessControlException
      2. - *
    2. Use available information to make an access control decision
      3. - *
        - *
      1. Ideally, this policy would be data driven
        2. - *
      2. You can use the current User, roles, data type, data name, time of day, etc.
        3. - *
      3. Access control decisions must deny by default
        4. - *
      - *
    3. If access is not permitted, throw an AccessControlException with details
      4. - *
    - * - * @param functionName - * the function name - * - * @throws AccessControlException - * if access is not permitted - */ - void assertAuthorizedForFunction(String functionName) throws AccessControlException; - - - /** - * Checks if the current user is authorized to access the referenced data. This method simply returns if access is authorized. - * It throws an AccessControlException if access is not authorized, or if the referenced data does not exist. - *

    - * Specification: The implementation should do the following: - *

      - *
    1. Check to see if the resource exists and if not, throw an AccessControlException
      2. - *
    2. Use available information to make an access control decision
      3. - *
        - *
      1. Ideally, this policy would be data driven
        2. - *
      2. You can use the current User, roles, data type, data name, time of day, etc.
        3. - *
      3. Access control decisions must deny by default
        4. - *
      - *
    3. If access is not permitted, throw an AccessControlException with details
      4. - *
    - * - * @param action - * The action to verify for an access control decision, such as a role, or an action being performed on the object - * (e.g., Read, Write, etc.), or the name of the function the data is being passed to. - * - * @param data - * The actual object or object identifier being accessed or a reference to the object being accessed. - * - * @throws AccessControlException - * if access is not permitted - */ - void assertAuthorizedForData(String action, Object data) throws AccessControlException; - - /** - * Checks if the current user is authorized to access the referenced file. The implementation should validate and canonicalize the - * input to be sure the filepath is not malicious. - *

    - * This method throws an AccessControlException if access is not authorized, or if the referenced File does not exist. - * If the User is authorized, this method simply returns. - *

    - * Specification: The implementation should do the following: - *

      - *
    1. Check to see if the File exists and if not, throw an AccessControlException
      2. - *
    2. Use available information to make an access control decision
      3. - *
        - *
      1. Ideally, this policy would be data driven
        2. - *
      2. You can use the current User, roles, data type, data name, time of day, etc.
        3. - *
      3. Access control decisions must deny by default
        4. - *
      - *
    3. If access is not permitted, throw an AccessControlException with details
      4. - *
    - * - * @param filepath - * Path to the file to be checked - * @throws AccessControlException if access is denied - */ - void assertAuthorizedForFile(String filepath) throws AccessControlException; - - /** - * Checks if the current user is authorized to access the referenced service. This can be used in applications that - * provide access to a variety of backend services. - *

    - * This method throws an AccessControlException if access is not authorized, or if the referenced service does not exist. - * If the User is authorized, this method simply returns. - *

    - * Specification: The implementation should do the following: - *

      - *
    1. Check to see if the service exists and if not, throw an AccessControlException
      2. - *
    2. Use available information to make an access control decision
      3. - *
        - *
      1. Ideally, this policy would be data driven
        2. - *
      2. You can use the current User, roles, data type, data name, time of day, etc.
        3. - *
      3. Access control decisions must deny by default
        4. - *
      - *
    3. If access is not permitted, throw an AccessControlException with details
      4. - *
    - * - * @param serviceName - * the service name - * - * @throws AccessControlException - * if access is not permitted - */ - void assertAuthorizedForService(String serviceName) throws AccessControlException; - -} +/** + * OWASP Enterprise Security API (ESAPI) + * + * This file is part of the Open Web Application Security Project (OWASP) + * Enterprise Security API (ESAPI) project. For details, please see + * http://www.owasp.org/index.php/ESAPI. + * + * Copyright (c) 2007 - The OWASP Foundation + * + * The ESAPI is published by OWASP under the BSD license. You should read and accept the + * LICENSE before you use, modify, and/or redistribute this software. + * + * @author Jeff Williams Aspect Security + * @created 2007 + */ +package org.owasp.esapi; + +import org.owasp.esapi.errors.AccessControlException; + + + +/** + * The AccessController interface defines a set of methods that can be used in a wide variety of applications to + * enforce access control. In most applications, access control must be performed in multiple different locations across + * the various application layers. This class provides access control for URLs, business functions, data, services, and + * files. + *

    + * The implementation of this interface will need to access the current User object (from Authenticator.getCurrentUser()) + * to determine roles or permissions. In addition, the implementation + * will also need information about the resources that are being accessed. Using the user information and the resource + * information, the implementation should return an access control decision. + *

    + * Implementers are encouraged to implement the ESAPI access control rules, like assertAuthorizedForFunction() using + * existing access control mechanisms, such as methods like isUserInRole() or hasPrivilege(). While powerful, + * methods like isUserInRole() can be confusing for developers, as users may be in multiple roles or possess multiple + * overlapping privileges. Direct use of these finer grained access control methods encourages the use of complex boolean + * tests throughout the code, which can easily lead to developer mistakes. + *

    + * The point of the ESAPI access control interface is to centralize access control logic behind easy to use calls like + * assertAuthorized() so that access control is easy to use and easy to verify. Here is an example of a very + * straightforward to implement, understand, and verify ESAPI access control check: + * + * 

    + * try {
+ *     ESAPI.accessController().assertAuthorized("businessFunction", runtimeData);
+ *     // execute BUSINESS_FUNCTION
+ * } catch (AccessControlException ace) {
+ * ... attack in progress
+ * }
+ *
    + * + * Note that in the user interface layer, access control checks can be used to control whether particular controls are + * rendered or not. These checks are supposed to fail when an unauthorized user is logged in, and do not represent + * attacks. Remember that regardless of how the user interface appears, an attacker can attempt to invoke any business + * function or access any data in your application. Therefore, access control checks in the user interface should be + * repeated in both the business logic and data layers. + * + * 
    + * <% if ( ESAPI.accessController().isAuthorized( "businessFunction", runtimeData ) ) { %>
+ * <a href="/doAdminFunction">ADMIN</a>
+ * <% } else { %>
+ * <a href="/doNormalFunction">NORMAL</a>
+ * <% } %>
+ *
    + * + * @author Mike H. Fauzy (mike.fauzy@aspectsecurity.com) ESAPI v1.6- + * @author Jeff Williams (jeff.williams@aspectsecurity.com) ESAPI v0-1.5 + */ +public interface AccessController { + + /** + * isAuthorized executes the AccessControlRule + * that is identified by key and listed in the + * resources/ESAPI-AccessControlPolicy.xml file. It returns + * true if the AccessControlRule decides that the operation + * should be allowed. Otherwise, it returns false. Any exception thrown by + * the AccessControlRule must result in false. If + * key does not map to an AccessControlRule, then + * false is returned. + * + * Developers should call isAuthorized to control execution flow. For + * example, if you want to decide whether to display a UI widget in the + * browser using the same logic that you will use to enforce permissions + * on the server, then isAuthorized is the method that you want to use. + * + * Typically, assertAuthorized should be used to enforce permissions on the + * server. + * + * @param key key maps to + * <AccessControlPolicy><AccessControlRules> + * <AccessControlRule name="key" + * @param runtimeParameter runtimeParameter can contain anything that + * the AccessControlRule needs from the runtime system. + * @return Returns true if and only if the AccessControlRule specified + * by key exists and returned true. + * Otherwise returns false + */ + public boolean isAuthorized(Object key, Object runtimeParameter); + + /** + * assertAuthorized executes the AccessControlRule + * that is identified by key and listed in the + * resources/ESAPI-AccessControlPolicy.xml file. It does + * nothing if the AccessControlRule decides that the operation + * should be allowed. Otherwise, it throws an + * org.owasp.esapi.errors.AccessControlException. Any exception + * thrown by the AccessControlRule will also result in an + * AccesControlException. If key does not map to + * an AccessControlRule, then an AccessControlException + * is thrown. + * + * Developers should call {@code assertAuthorized} to enforce privileged access to + * the system. It should be used to answer the question: "Should execution + * continue." Ideally, the call to assertAuthorized should + * be integrated into the application framework so that it is called + * automatically. + * + * @param key key maps to + * <AccessControlPolicy><AccessControlRules> + * <AccessControlRule name="key" + * @param runtimeParameter runtimeParameter can contain anything that + * the AccessControlRule needs from the runtime system. + */ + public void assertAuthorized(Object key, Object runtimeParameter) + throws AccessControlException; + + + + + /*** Below this line has been deprecated as of ESAPI 1.6 ***/ + + + + + /** + * Checks if the current user is authorized to access the referenced URL. Generally, this method should be invoked in the + * application's controller or a filter as follows: + * 
    ESAPI.accessController().isAuthorizedForURL(request.getRequestURI().toString());
    + * + * The implementation of this method should call assertAuthorizedForURL(String url), and if an AccessControlException is + * not thrown, this method should return true. This way, if the user is not authorized, false would be returned, and the + * exception would be logged. + * + * @param url + * the URL as returned by request.getRequestURI().toString() + * + * @return + * true, if is authorized for URL + */ + boolean isAuthorizedForURL(String url); + + /** + * Checks if the current user is authorized to access the referenced function. + * + * The implementation of this method should call assertAuthorizedForFunction(String functionName), and if an + * AccessControlException is not thrown, this method should return true. + * + * @param functionName + * the name of the function + * + * @return + * true, if is authorized for function + */ + boolean isAuthorizedForFunction(String functionName); + + + /** + * Checks if the current user is authorized to access the referenced data, represented as an Object. + * + * The implementation of this method should call assertAuthorizedForData(String action, Object data), and if an + * AccessControlException is not thrown, this method should return true. + * + * @param action + * The action to verify for an access control decision, such as a role, or an action being performed on the object + * (e.g., Read, Write, etc.), or the name of the function the data is being passed to. + * + * @param data + * The actual object or object identifier being accessed or a reference to the object being accessed. + * + * @return + * true, if is authorized for the data + */ + boolean isAuthorizedForData(String action, Object data); + + /** + * Checks if the current user is authorized to access the referenced file. + * + * The implementation of this method should call assertAuthorizedForFile(String filepath), and if an AccessControlException + * is not thrown, this method should return true. + * + * @param filepath + * the path of the file to be checked, including filename + * + * @return + * true, if is authorized for the file + */ + boolean isAuthorizedForFile(String filepath); + + /** + * Checks if the current user is authorized to access the referenced service. This can be used in applications that + * provide access to a variety of back end services. + * + * The implementation of this method should call assertAuthorizedForService(String serviceName), and if an + * AccessControlException is not thrown, this method should return true. + * + * @param serviceName + * the service name + * + * @return + * true, if is authorized for the service + */ + boolean isAuthorizedForService(String serviceName); + + /** + * Checks if the current user is authorized to access the referenced URL. The implementation should allow + * access to be granted to any part of the URL. Generally, this method should be invoked in the + * application's controller or a filter as follows: + * 
    ESAPI.accessController().assertAuthorizedForURL(request.getRequestURI().toString());
    + * + * This method throws an AccessControlException if access is not authorized, or if the referenced URL does not exist. + * If the User is authorized, this method simply returns. + *

    + * Specification: The implementation should do the following: + *

      + *
    1. Check to see if the resource exists and if not, throw an AccessControlException
      2. + *
    2. Use available information to make an access control decision
      3. + *
        + *
      1. Ideally, this policy would be data driven
        2. + *
      2. You can use the current User, roles, data type, data name, time of day, etc.
        3. + *
      3. Access control decisions must deny by default
        4. + *
      + *
    3. If access is not permitted, throw an AccessControlException with details
      4. + *
    + * @param url + * the URL as returned by request.getRequestURI().toString() + * + * @throws AccessControlException + * if access is not permitted + */ + void assertAuthorizedForURL(String url) throws AccessControlException; + + /** + * Checks if the current user is authorized to access the referenced function. The implementation should define the + * function "namespace" to be enforced. Choosing something simple like the class name of action classes or menu item + * names will make this implementation easier to use. + *

    + * This method throws an AccessControlException if access is not authorized, or if the referenced function does not exist. + * If the User is authorized, this method simply returns. + *

    + * Specification: The implementation should do the following: + *

      + *
    1. Check to see if the function exists and if not, throw an AccessControlException
      2. + *
    2. Use available information to make an access control decision
      3. + *
        + *
      1. Ideally, this policy would be data driven
        2. + *
      2. You can use the current User, roles, data type, data name, time of day, etc.
        3. + *
      3. Access control decisions must deny by default
        4. + *
      + *
    3. If access is not permitted, throw an AccessControlException with details
      4. + *
    + * + * @param functionName + * the function name + * + * @throws AccessControlException + * if access is not permitted + */ + void assertAuthorizedForFunction(String functionName) throws AccessControlException; + + + /** + * Checks if the current user is authorized to access the referenced data. This method simply returns if access is authorized. + * It throws an AccessControlException if access is not authorized, or if the referenced data does not exist. + *

    + * Specification: The implementation should do the following: + *

      + *
    1. Check to see if the resource exists and if not, throw an AccessControlException
      2. + *
    2. Use available information to make an access control decision
      3. + *
        + *
      1. Ideally, this policy would be data driven
        2. + *
      2. You can use the current User, roles, data type, data name, time of day, etc.
        3. + *
      3. Access control decisions must deny by default
        4. + *
      + *
    3. If access is not permitted, throw an AccessControlException with details
      4. + *
    + * + * @param action + * The action to verify for an access control decision, such as a role, or an action being performed on the object + * (e.g., Read, Write, etc.), or the name of the function the data is being passed to. + * + * @param data + * The actual object or object identifier being accessed or a reference to the object being accessed. + * + * @throws AccessControlException + * if access is not permitted + */ + void assertAuthorizedForData(String action, Object data) throws AccessControlException; + + /** + * Checks if the current user is authorized to access the referenced file. The implementation should validate and canonicalize the + * input to be sure the filepath is not malicious. + *

    + * This method throws an AccessControlException if access is not authorized, or if the referenced File does not exist. + * If the User is authorized, this method simply returns. + *

    + * Specification: The implementation should do the following: + *

      + *
    1. Check to see if the File exists and if not, throw an AccessControlException
      2. + *
    2. Use available information to make an access control decision
      3. + *
        + *
      1. Ideally, this policy would be data driven
        2. + *
      2. You can use the current User, roles, data type, data name, time of day, etc.
        3. + *
      3. Access control decisions must deny by default
        4. + *
      + *
    3. If access is not permitted, throw an AccessControlException with details
      4. + *
    + * + * @param filepath + * Path to the file to be checked + * @throws AccessControlException if access is denied + */ + void assertAuthorizedForFile(String filepath) throws AccessControlException; + + /** + * Checks if the current user is authorized to access the referenced service. This can be used in applications that + * provide access to a variety of backend services. + *

    + * This method throws an AccessControlException if access is not authorized, or if the referenced service does not exist. + * If the User is authorized, this method simply returns. + *

    + * Specification: The implementation should do the following: + *

      + *
    1. Check to see if the service exists and if not, throw an AccessControlException
      2. + *
    2. Use available information to make an access control decision
      3. + *
        + *
      1. Ideally, this policy would be data driven
        2. + *
      2. You can use the current User, roles, data type, data name, time of day, etc.
        3. + *
      3. Access control decisions must deny by default
        4. + *
      + *
    3. If access is not permitted, throw an AccessControlException with details
      4. + *
    + * + * @param serviceName + * the service name + * + * @throws AccessControlException + * if access is not permitted + */ + void assertAuthorizedForService(String serviceName) throws AccessControlException; + +} From b7859f80e540b37d8ada9967eb47abe4645ec3ce Mon Sep 17 00:00:00 2001 From: kwwall Date: Mon, 18 Jan 2016 23:33:47 -0500 Subject: [PATCH 088/812] Change CRLF to LF for issue 356. --- .../java/org/owasp/esapi/AccessControlRule.java | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/src/main/java/org/owasp/esapi/AccessControlRule.java b/src/main/java/org/owasp/esapi/AccessControlRule.java index becdb9971..b10940369 100644 --- a/src/main/java/org/owasp/esapi/AccessControlRule.java +++ b/src/main/java/org/owasp/esapi/AccessControlRule.java @@ -1,8 +1,8 @@ -package org.owasp.esapi; - - -public interface AccessControlRule { - public void setPolicyParameters(P policyParameter); - public P getPolicyParameters(); - public boolean isAuthorized(R runtimeParameter) throws Exception; -} +package org.owasp.esapi; + + +public interface AccessControlRule { + public void setPolicyParameters(P policyParameter); + public P getPolicyParameters(); + public boolean isAuthorized(R runtimeParameter) throws Exception; +} From 4c731447a5481207b8ff6c7a09debb91cef6351c Mon Sep 17 00:00:00 2001 From: kwwall Date: Mon, 18 Jan 2016 23:33:47 -0500 Subject: [PATCH 089/812] Change CRLF to LF for issue 356. --- .../org/owasp/esapi/AccessReferenceMap.java | 352 +++++++++--------- 1 file changed, 176 insertions(+), 176 deletions(-) diff --git a/src/main/java/org/owasp/esapi/AccessReferenceMap.java b/src/main/java/org/owasp/esapi/AccessReferenceMap.java index a20338e18..4fd74e01e 100644 --- a/src/main/java/org/owasp/esapi/AccessReferenceMap.java +++ b/src/main/java/org/owasp/esapi/AccessReferenceMap.java @@ -1,176 +1,176 @@ -/** - * OWASP Enterprise Security API (ESAPI) - * - * This file is part of the Open Web Application Security Project (OWASP) - * Enterprise Security API (ESAPI) project. For details, please see - * http://www.owasp.org/index.php/ESAPI. - * - * Copyright (c) 2007 - The OWASP Foundation - * - * The ESAPI is published by OWASP under the BSD license. You should read and accept the - * LICENSE before you use, modify, and/or redistribute this software. - * - * @author Jeff Williams Aspect Security - * @created 2007 - */ -package org.owasp.esapi; - -import org.owasp.esapi.errors.AccessControlException; - -import java.io.Serializable; -import java.util.Iterator; -import java.util.Set; - - -/** - * The AccessReferenceMap interface is used to map from a set of internal - * direct object references to a set of indirect references that are safe to - * disclose publicly. This can be used to help protect database keys, - * filenames, and other types of direct object references. As a rule, developers - * should not expose their direct object references as it enables attackers to - * attempt to manipulate them. - *

    - * Indirect references are handled as strings, to facilitate their use in HTML. - * Implementations can generate simple integers or more complicated random - * character strings as indirect references. Implementations should probably add - * a constructor that takes a list of direct references. - *

    - * Note that in addition to defeating all forms of parameter tampering attacks, - * there is a side benefit of the AccessReferenceMap. Using random strings as indirect object - * references, as opposed to simple integers makes it impossible for an attacker to - * guess valid identifiers. So if per-user AccessReferenceMaps are used, then request - * forgery (CSRF) attacks will also be prevented. - * - * 

    - * Set fileSet = new HashSet();
- * fileSet.addAll(...); // add direct references (e.g. File objects)
- * AccessReferenceMap map = new AccessReferenceMap( fileSet );
- * // store the map somewhere safe - like the session!
- * String indRef = map.getIndirectReference( file1 );
- * String href = "http://www.aspectsecurity.com/esapi?file=" + indRef );
- * ...
- * // if the indirect reference doesn't exist, it's likely an attack
- * // getDirectReference throws an AccessControlException
- * // you should handle as appropriate
- * String indref = request.getParameter( "file" );
- * File file = (File)map.getDirectReference( indref );
- *
    - * - *

    - * - * @author Jeff Williams (jeff.williams@aspectsecurity.com) - * @author Chris Schmidt (chrisisbeef@gmail.com) - */ -public interface AccessReferenceMap extends Serializable { - - /** - * Get an iterator through the direct object references. No guarantee is made as - * to the order of items returned. - * - * @return the iterator - */ - Iterator iterator(); - - /** - * Get a safe indirect reference to use in place of a potentially sensitive - * direct object reference. Developers should use this call when building - * URL's, form fields, hidden fields, etc... to help protect their private - * implementation information. - * - * @param directReference - * the direct reference - * - * @return - * the indirect reference - */ - K getIndirectReference(T directReference); - - /** - * Get the original direct object reference from an indirect reference. - * Developers should use this when they get an indirect reference from a - * request to translate it back into the real direct reference. If an - * invalid indirect reference is requested, then an AccessControlException is - * thrown. - * - * If a type is implied the requested object will be cast to that type, if the - * object is not of the requested type, a AccessControlException will be thrown to - * the caller. - * - * For example: - * 

    -    * UserProfile profile = arm.getDirectReference( indirectRef );
-    *
    - * - * Will throw a AccessControlException if the object stored in memory is not of type - * UserProfile. - * - * However, - * 
    -    * Object uncastObject = arm.getDirectReference( indirectRef );
-    *
    - * - * Will never throw a AccessControlException as long as the object exists. If you are - * unsure of the object type of that an indirect reference references you should get - * the uncast object and test for type in the calling code. - * 
    -    * Object uncastProfile = arm.getDirectReference( indirectRef );
-    * if ( uncastProfile instanceof UserProfile ) {
-    *     UserProfile userProfile = (UserProfile) uncastProfile;
-    *     // ...
-    * } else {
-    *     EmployeeProfile employeeProfile = (EmployeeProfile) uncastProfile;
-    *     // ...
-    * }
-    *
    - * - * @param indirectReference - * the indirect reference - * - * @return - * the direct reference - * - * @throws AccessControlException - * if no direct reference exists for the specified indirect reference - * @throws ClassCastException - * if the implied type is not the same as the referenced object type - */ - T getDirectReference(K indirectReference) throws AccessControlException; - - /** - * Adds a direct reference to the AccessReferenceMap, then generates and returns - * an associated indirect reference. - * - * @param direct - * the direct reference - * - * @return - * the corresponding indirect reference - */ - K addDirectReference(T direct); - - /** - * Removes a direct reference and its associated indirect reference from the AccessReferenceMap. - * - * @param direct - * the direct reference to remove - * - * @return - * the corresponding indirect reference - * - * @throws AccessControlException - * if the reference does not exist. - */ - K removeDirectReference(T direct) throws AccessControlException; - - /** - * Updates the access reference map with a new set of direct references, maintaining - * any existing indirect references associated with items that are in the new list. - * New indirect references could be generated every time, but that - * might mess up anything that previously used an indirect reference, such - * as a URL parameter. - * - * @param directReferences - * a Set of direct references to add - */ - void update(Set directReferences); -} +/** + * OWASP Enterprise Security API (ESAPI) + * + * This file is part of the Open Web Application Security Project (OWASP) + * Enterprise Security API (ESAPI) project. For details, please see + * http://www.owasp.org/index.php/ESAPI. + * + * Copyright (c) 2007 - The OWASP Foundation + * + * The ESAPI is published by OWASP under the BSD license. You should read and accept the + * LICENSE before you use, modify, and/or redistribute this software. + * + * @author Jeff Williams Aspect Security + * @created 2007 + */ +package org.owasp.esapi; + +import org.owasp.esapi.errors.AccessControlException; + +import java.io.Serializable; +import java.util.Iterator; +import java.util.Set; + + +/** + * The AccessReferenceMap interface is used to map from a set of internal + * direct object references to a set of indirect references that are safe to + * disclose publicly. This can be used to help protect database keys, + * filenames, and other types of direct object references. As a rule, developers + * should not expose their direct object references as it enables attackers to + * attempt to manipulate them. + *

    + * Indirect references are handled as strings, to facilitate their use in HTML. + * Implementations can generate simple integers or more complicated random + * character strings as indirect references. Implementations should probably add + * a constructor that takes a list of direct references. + *

    + * Note that in addition to defeating all forms of parameter tampering attacks, + * there is a side benefit of the AccessReferenceMap. Using random strings as indirect object + * references, as opposed to simple integers makes it impossible for an attacker to + * guess valid identifiers. So if per-user AccessReferenceMaps are used, then request + * forgery (CSRF) attacks will also be prevented. + * + * 

    + * Set fileSet = new HashSet();
+ * fileSet.addAll(...); // add direct references (e.g. File objects)
+ * AccessReferenceMap map = new AccessReferenceMap( fileSet );
+ * // store the map somewhere safe - like the session!
+ * String indRef = map.getIndirectReference( file1 );
+ * String href = "http://www.aspectsecurity.com/esapi?file=" + indRef );
+ * ...
+ * // if the indirect reference doesn't exist, it's likely an attack
+ * // getDirectReference throws an AccessControlException
+ * // you should handle as appropriate
+ * String indref = request.getParameter( "file" );
+ * File file = (File)map.getDirectReference( indref );
+ *
    + * + *

    + * + * @author Jeff Williams (jeff.williams@aspectsecurity.com) + * @author Chris Schmidt (chrisisbeef@gmail.com) + */ +public interface AccessReferenceMap extends Serializable { + + /** + * Get an iterator through the direct object references. No guarantee is made as + * to the order of items returned. + * + * @return the iterator + */ + Iterator iterator(); + + /** + * Get a safe indirect reference to use in place of a potentially sensitive + * direct object reference. Developers should use this call when building + * URL's, form fields, hidden fields, etc... to help protect their private + * implementation information. + * + * @param directReference + * the direct reference + * + * @return + * the indirect reference + */ + K getIndirectReference(T directReference); + + /** + * Get the original direct object reference from an indirect reference. + * Developers should use this when they get an indirect reference from a + * request to translate it back into the real direct reference. If an + * invalid indirect reference is requested, then an AccessControlException is + * thrown. + * + * If a type is implied the requested object will be cast to that type, if the + * object is not of the requested type, a AccessControlException will be thrown to + * the caller. + * + * For example: + * 

    +    * UserProfile profile = arm.getDirectReference( indirectRef );
+    *
    + * + * Will throw a AccessControlException if the object stored in memory is not of type + * UserProfile. + * + * However, + * 
    +    * Object uncastObject = arm.getDirectReference( indirectRef );
+    *
    + * + * Will never throw a AccessControlException as long as the object exists. If you are + * unsure of the object type of that an indirect reference references you should get + * the uncast object and test for type in the calling code. + * 
    +    * Object uncastProfile = arm.getDirectReference( indirectRef );
+    * if ( uncastProfile instanceof UserProfile ) {
+    *     UserProfile userProfile = (UserProfile) uncastProfile;
+    *     // ...
+    * } else {
+    *     EmployeeProfile employeeProfile = (EmployeeProfile) uncastProfile;
+    *     // ...
+    * }
+    *
    + * + * @param indirectReference + * the indirect reference + * + * @return + * the direct reference + * + * @throws AccessControlException + * if no direct reference exists for the specified indirect reference + * @throws ClassCastException + * if the implied type is not the same as the referenced object type + */ + T getDirectReference(K indirectReference) throws AccessControlException; + + /** + * Adds a direct reference to the AccessReferenceMap, then generates and returns + * an associated indirect reference. + * + * @param direct + * the direct reference + * + * @return + * the corresponding indirect reference + */ + K addDirectReference(T direct); + + /** + * Removes a direct reference and its associated indirect reference from the AccessReferenceMap. + * + * @param direct + * the direct reference to remove + * + * @return + * the corresponding indirect reference + * + * @throws AccessControlException + * if the reference does not exist. + */ + K removeDirectReference(T direct) throws AccessControlException; + + /** + * Updates the access reference map with a new set of direct references, maintaining + * any existing indirect references associated with items that are in the new list. + * New indirect references could be generated every time, but that + * might mess up anything that previously used an indirect reference, such + * as a URL parameter. + * + * @param directReferences + * a Set of direct references to add + */ + void update(Set directReferences); +} From cb65cf0d83cca62a011f33cc1b2de730529182e4 Mon Sep 17 00:00:00 2001 From: kwwall Date: Mon, 18 Jan 2016 23:33:47 -0500 Subject: [PATCH 090/812] Change CRLF to LF for issue 356. --- .../java/org/owasp/esapi/Authenticator.java | 648 +++++++++--------- 1 file changed, 324 insertions(+), 324 deletions(-) diff --git a/src/main/java/org/owasp/esapi/Authenticator.java b/src/main/java/org/owasp/esapi/Authenticator.java index 9cb401345..907739db1 100644 --- a/src/main/java/org/owasp/esapi/Authenticator.java +++ b/src/main/java/org/owasp/esapi/Authenticator.java @@ -1,324 +1,324 @@ -/** - * OWASP Enterprise Security API (ESAPI) - * - * This file is part of the Open Web Application Security Project (OWASP) - * Enterprise Security API (ESAPI) project. For details, please see - * http://www.owasp.org/index.php/ESAPI. - * - * Copyright (c) 2007 - The OWASP Foundation - * - * The ESAPI is published by OWASP under the BSD license. You should read and accept the - * LICENSE before you use, modify, and/or redistribute this software. - * - * @author Jeff Williams Aspect Security - * @created 2007 - */ -package org.owasp.esapi; - -import org.owasp.esapi.errors.AuthenticationException; -import org.owasp.esapi.errors.EncryptionException; - -import javax.servlet.http.HttpServletRequest; -import javax.servlet.http.HttpServletResponse; -import java.util.Set; - - -/** - * The Authenticator interface defines a set of methods for generating and - * handling account credentials and session identifiers. The goal of this - * interface is to encourage developers to protect credentials from disclosure - * to the maximum extent possible. - *

    - * One possible implementation relies on the use of a thread local variable to - * store the current user's identity. The application is responsible for calling - * setCurrentUser() as soon as possible after each HTTP request is received. The - * value of getCurrentUser() is used in several other places in this API. This - * eliminates the need to pass a user object to methods throughout the library. - * For example, all of the logging, access control, and exception calls need - * access to the currently logged in user. - *

    - * The goal is to minimize the responsibility of the developer for - * authentication. In this example, the user simply calls authenticate with the - * current request and the name of the parameters containing the username and - * password. The implementation should verify the password if necessary, create - * a session if necessary, and set the user as the current user. - * - * 

    - * public void doPost(ServletRequest request, ServletResponse response) {
- * try {
- * User user = ESAPI.authenticator().login(request, response);
- * // continue with authenticated user
- * } catch (AuthenticationException e) {
- * // handle failed authentication (it's already been logged)
- * }
- *
    - * - * @author Jeff Williams (jeff.williams .at. aspectsecurity.com) Aspect Security - * @since June 1, 2007 - */ -public interface Authenticator { - - /** - * Clears the current User. This allows the thread to be reused safely. - * - * This clears all threadlocal variables from the thread. This should ONLY be called after - * all possible ESAPI operations have concluded. If you clear too early, many calls will - * fail, including logging, which requires the user identity. - */ - void clearCurrent(); - - /** - * Calls login with the *current* request and response. - * @return Authenticated {@code User} if login is successful. - * @see HTTPUtilities#setCurrentHTTP(javax.servlet.http.HttpServletRequest, javax.servlet.http.HttpServletResponse) - */ - User login() throws AuthenticationException; - - /** - * This method should be called for every HTTP request, to login the current user either from the session of HTTP - * request. This method will set the current user so that getCurrentUser() will work properly. - * - * Authenticates the user's credentials from the HttpServletRequest if - * necessary, creates a session if necessary, and sets the user as the - * current user. - * - * Specification: The implementation should do the following: - * 1) Check if the User is already stored in the session - * a. If so, check that session absolute and inactivity timeout have not expired - * b. Step 2 may not be required if 1a has been satisfied - * 2) Verify User credentials - * a. It is recommended that you use - * loginWithUsernameAndPassword(HttpServletRequest, HttpServletResponse) to verify credentials - * 3) Set the last host of the User (ex. user.setLastHostAddress(address) ) - * 4) Verify that the request is secure (ex. over SSL) - * 5) Verify the User account is allowed to be logged in - * a. Verify the User is not disabled, expired or locked - * 6) Assign User to session variable - * - * @param request - * the current HTTP request - * @param response - * the HTTP response - * - * @return - * the User - * - * @throws AuthenticationException - * if the credentials are not verified, or if the account is disabled, locked, expired, or timed out - */ - User login(HttpServletRequest request, HttpServletResponse response) throws AuthenticationException; - - /** - * Verify that the supplied password matches the password for this user. Password should - * be stored as a hash. It is recommended you use the hashPassword(password, accountName) method - * in this class. - * This method is typically used for "reauthentication" for the most sensitive functions, such - * as transactions, changing email address, and changing other account information. - * - * @param user - * the user who requires verification - * @param password - * the hashed user-supplied password - * - * @return - * true, if the password is correct for the specified user - */ - boolean verifyPassword(User user, String password); - - /** - * Logs out the current user. - * - * This is usually done by calling User.logout on the current User. - */ - void logout(); - - /** - * Creates a new User with the information provided. Implementations should check - * accountName and password for proper format and strength against brute force - * attacks ( verifyAccountNameStrength(String), verifyPasswordStrength(String, String) ). - * - * Two copies of the new password are required to encourage user interface designers to - * include a "re-type password" field in their forms. Implementations should verify that - * both are the same. - * - * @param accountName - * the account name of the new user - * @param password1 - * the password of the new user - * @param password2 - * the password of the new user. This field is to encourage user interface designers to include two password fields in their forms. - * - * @return - * the User that has been created - * - * @throws AuthenticationException - * if user creation fails due to any of the qualifications listed in this method's description - */ - User createUser(String accountName, String password1, String password2) throws AuthenticationException; - - /** - * Generate a strong password. Implementations should use a large character set that does not - * include confusing characters, such as i I 1 l 0 o and O. There are many algorithms to - * generate strong memorable passwords that have been studied in the past. - * - * @return - * a password with strong password strength - */ - String generateStrongPassword(); - - /** - * Generate strong password that takes into account the user's information and old password. Implementations - * should verify that the new password does not include information such as the username, fragments of the - * old password, and other information that could be used to weaken the strength of the password. - * - * @param user - * the user whose information to use when generating password - * @param oldPassword - * the old password to use when verifying strength of new password. The new password may be checked for fragments of oldPassword. - * - * @return - * a password with strong password strength - */ - String generateStrongPassword(User user, String oldPassword); - - /** - * Changes the password for the specified user. This requires the current password, as well as - * the password to replace it with. The new password should be checked against old hashes to be sure the new password does not closely resemble or equal any recent passwords for that User. - * Password strength should also be verified. This new password must be repeated to ensure that the user has typed it in correctly. - * - * @param user - * the user to change the password for - * @param currentPassword - * the current password for the specified user - * @param newPassword - * the new password to use - * @param newPassword2 - * a verification copy of the new password - * - * @throws AuthenticationException - * if any errors occur - */ - void changePassword(User user, String currentPassword, String newPassword, String newPassword2) throws AuthenticationException; - - /** - * Returns the User matching the provided accountId. If the accoundId is not found, an Anonymous - * User or null may be returned. - * - * @param accountId - * the account id - * - * @return - * the matching User object, or the Anonymous User if no match exists - */ - User getUser(long accountId); - - /** - * Returns the User matching the provided accountName. If the accoundId is not found, an Anonymous - * User or null may be returned. - * - * @param accountName - * the account name - * - * @return - * the matching User object, or the Anonymous User if no match exists - */ - User getUser(String accountName); - - /** - * Gets a collection containing all the existing user names. - * - * @return - * a set of all user names - */ - Set getUserNames(); - - /** - * Returns the currently logged in User. - * - * @return - * the matching User object, or the Anonymous User if no match - * exists - */ - User getCurrentUser(); - - /** - * Sets the currently logged in User. - * - * @param user - * the user to set as the current user - */ - void setCurrentUser(User user); - - /** - * Returns a string representation of the hashed password, using the - * accountName as the salt. The salt helps to prevent against "rainbow" - * table attacks where the attacker pre-calculates hashes for known strings. - * This method specifies the use of the user's account name as the "salt" - * value. The Encryptor.hash method can be used if a different salt is - * required. - * - * @param password - * the password to hash - * @param accountName - * the account name to use as the salt - * - * @return - * the hashed password - * @throws EncryptionException - */ - String hashPassword(String password, String accountName) throws EncryptionException; - - /** - * Removes the account of the specified accountName. - * - * @param accountName - * the account name to remove - * - * @throws AuthenticationException - * the authentication exception if user does not exist - */ - void removeUser(String accountName) throws AuthenticationException; - - /** - * Ensures that the account name passes site-specific complexity requirements, like minimum length. - * - * @param accountName - * the account name - * - * @throws AuthenticationException - * if account name does not meet complexity requirements - */ - void verifyAccountNameStrength(String accountName) throws AuthenticationException; - - /** - * Ensures that the password meets site-specific complexity requirements, like length or number - * of character sets. This method takes the old password so that the algorithm can analyze the - * new password to see if it is too similar to the old password. Note that this has to be - * invoked when the user has entered the old password, as the list of old - * credentials stored by ESAPI is all hashed. - * Additionally, the user object is taken in order to verify the password and account name differ. - * - * @param oldPassword - * the old password - * @param newPassword - * the new password - * @param user - * the user - * - * @throws AuthenticationException - * if newPassword is too similar to oldPassword or if newPassword does not meet complexity requirements - */ - void verifyPasswordStrength(String oldPassword, String newPassword, User user) throws AuthenticationException; - - /** - * Determine if the account exists. - * - * @param accountName - * the account name - * - * @return true, if the account exists - */ - boolean exists(String accountName); - -} +/** + * OWASP Enterprise Security API (ESAPI) + * + * This file is part of the Open Web Application Security Project (OWASP) + * Enterprise Security API (ESAPI) project. For details, please see + * http://www.owasp.org/index.php/ESAPI. + * + * Copyright (c) 2007 - The OWASP Foundation + * + * The ESAPI is published by OWASP under the BSD license. You should read and accept the + * LICENSE before you use, modify, and/or redistribute this software. + * + * @author Jeff Williams Aspect Security + * @created 2007 + */ +package org.owasp.esapi; + +import org.owasp.esapi.errors.AuthenticationException; +import org.owasp.esapi.errors.EncryptionException; + +import javax.servlet.http.HttpServletRequest; +import javax.servlet.http.HttpServletResponse; +import java.util.Set; + + +/** + * The Authenticator interface defines a set of methods for generating and + * handling account credentials and session identifiers. The goal of this + * interface is to encourage developers to protect credentials from disclosure + * to the maximum extent possible. + *

    + * One possible implementation relies on the use of a thread local variable to + * store the current user's identity. The application is responsible for calling + * setCurrentUser() as soon as possible after each HTTP request is received. The + * value of getCurrentUser() is used in several other places in this API. This + * eliminates the need to pass a user object to methods throughout the library. + * For example, all of the logging, access control, and exception calls need + * access to the currently logged in user. + *

    + * The goal is to minimize the responsibility of the developer for + * authentication. In this example, the user simply calls authenticate with the + * current request and the name of the parameters containing the username and + * password. The implementation should verify the password if necessary, create + * a session if necessary, and set the user as the current user. + * + * 

    + * public void doPost(ServletRequest request, ServletResponse response) {
+ * try {
+ * User user = ESAPI.authenticator().login(request, response);
+ * // continue with authenticated user
+ * } catch (AuthenticationException e) {
+ * // handle failed authentication (it's already been logged)
+ * }
+ *
    + * + * @author Jeff Williams (jeff.williams .at. aspectsecurity.com) Aspect Security + * @since June 1, 2007 + */ +public interface Authenticator { + + /** + * Clears the current User. This allows the thread to be reused safely. + * + * This clears all threadlocal variables from the thread. This should ONLY be called after + * all possible ESAPI operations have concluded. If you clear too early, many calls will + * fail, including logging, which requires the user identity. + */ + void clearCurrent(); + + /** + * Calls login with the *current* request and response. + * @return Authenticated {@code User} if login is successful. + * @see HTTPUtilities#setCurrentHTTP(javax.servlet.http.HttpServletRequest, javax.servlet.http.HttpServletResponse) + */ + User login() throws AuthenticationException; + + /** + * This method should be called for every HTTP request, to login the current user either from the session of HTTP + * request. This method will set the current user so that getCurrentUser() will work properly. + * + * Authenticates the user's credentials from the HttpServletRequest if + * necessary, creates a session if necessary, and sets the user as the + * current user. + * + * Specification: The implementation should do the following: + * 1) Check if the User is already stored in the session + * a. If so, check that session absolute and inactivity timeout have not expired + * b. Step 2 may not be required if 1a has been satisfied + * 2) Verify User credentials + * a. It is recommended that you use + * loginWithUsernameAndPassword(HttpServletRequest, HttpServletResponse) to verify credentials + * 3) Set the last host of the User (ex. user.setLastHostAddress(address) ) + * 4) Verify that the request is secure (ex. over SSL) + * 5) Verify the User account is allowed to be logged in + * a. Verify the User is not disabled, expired or locked + * 6) Assign User to session variable + * + * @param request + * the current HTTP request + * @param response + * the HTTP response + * + * @return + * the User + * + * @throws AuthenticationException + * if the credentials are not verified, or if the account is disabled, locked, expired, or timed out + */ + User login(HttpServletRequest request, HttpServletResponse response) throws AuthenticationException; + + /** + * Verify that the supplied password matches the password for this user. Password should + * be stored as a hash. It is recommended you use the hashPassword(password, accountName) method + * in this class. + * This method is typically used for "reauthentication" for the most sensitive functions, such + * as transactions, changing email address, and changing other account information. + * + * @param user + * the user who requires verification + * @param password + * the hashed user-supplied password + * + * @return + * true, if the password is correct for the specified user + */ + boolean verifyPassword(User user, String password); + + /** + * Logs out the current user. + * + * This is usually done by calling User.logout on the current User. + */ + void logout(); + + /** + * Creates a new User with the information provided. Implementations should check + * accountName and password for proper format and strength against brute force + * attacks ( verifyAccountNameStrength(String), verifyPasswordStrength(String, String) ). + * + * Two copies of the new password are required to encourage user interface designers to + * include a "re-type password" field in their forms. Implementations should verify that + * both are the same. + * + * @param accountName + * the account name of the new user + * @param password1 + * the password of the new user + * @param password2 + * the password of the new user. This field is to encourage user interface designers to include two password fields in their forms. + * + * @return + * the User that has been created + * + * @throws AuthenticationException + * if user creation fails due to any of the qualifications listed in this method's description + */ + User createUser(String accountName, String password1, String password2) throws AuthenticationException; + + /** + * Generate a strong password. Implementations should use a large character set that does not + * include confusing characters, such as i I 1 l 0 o and O. There are many algorithms to + * generate strong memorable passwords that have been studied in the past. + * + * @return + * a password with strong password strength + */ + String generateStrongPassword(); + + /** + * Generate strong password that takes into account the user's information and old password. Implementations + * should verify that the new password does not include information such as the username, fragments of the + * old password, and other information that could be used to weaken the strength of the password. + * + * @param user + * the user whose information to use when generating password + * @param oldPassword + * the old password to use when verifying strength of new password. The new password may be checked for fragments of oldPassword. + * + * @return + * a password with strong password strength + */ + String generateStrongPassword(User user, String oldPassword); + + /** + * Changes the password for the specified user. This requires the current password, as well as + * the password to replace it with. The new password should be checked against old hashes to be sure the new password does not closely resemble or equal any recent passwords for that User. + * Password strength should also be verified. This new password must be repeated to ensure that the user has typed it in correctly. + * + * @param user + * the user to change the password for + * @param currentPassword + * the current password for the specified user + * @param newPassword + * the new password to use + * @param newPassword2 + * a verification copy of the new password + * + * @throws AuthenticationException + * if any errors occur + */ + void changePassword(User user, String currentPassword, String newPassword, String newPassword2) throws AuthenticationException; + + /** + * Returns the User matching the provided accountId. If the accoundId is not found, an Anonymous + * User or null may be returned. + * + * @param accountId + * the account id + * + * @return + * the matching User object, or the Anonymous User if no match exists + */ + User getUser(long accountId); + + /** + * Returns the User matching the provided accountName. If the accoundId is not found, an Anonymous + * User or null may be returned. + * + * @param accountName + * the account name + * + * @return + * the matching User object, or the Anonymous User if no match exists + */ + User getUser(String accountName); + + /** + * Gets a collection containing all the existing user names. + * + * @return + * a set of all user names + */ + Set getUserNames(); + + /** + * Returns the currently logged in User. + * + * @return + * the matching User object, or the Anonymous User if no match + * exists + */ + User getCurrentUser(); + + /** + * Sets the currently logged in User. + * + * @param user + * the user to set as the current user + */ + void setCurrentUser(User user); + + /** + * Returns a string representation of the hashed password, using the + * accountName as the salt. The salt helps to prevent against "rainbow" + * table attacks where the attacker pre-calculates hashes for known strings. + * This method specifies the use of the user's account name as the "salt" + * value. The Encryptor.hash method can be used if a different salt is + * required. + * + * @param password + * the password to hash + * @param accountName + * the account name to use as the salt + * + * @return + * the hashed password + * @throws EncryptionException + */ + String hashPassword(String password, String accountName) throws EncryptionException; + + /** + * Removes the account of the specified accountName. + * + * @param accountName + * the account name to remove + * + * @throws AuthenticationException + * the authentication exception if user does not exist + */ + void removeUser(String accountName) throws AuthenticationException; + + /** + * Ensures that the account name passes site-specific complexity requirements, like minimum length. + * + * @param accountName + * the account name + * + * @throws AuthenticationException + * if account name does not meet complexity requirements + */ + void verifyAccountNameStrength(String accountName) throws AuthenticationException; + + /** + * Ensures that the password meets site-specific complexity requirements, like length or number + * of character sets. This method takes the old password so that the algorithm can analyze the + * new password to see if it is too similar to the old password. Note that this has to be + * invoked when the user has entered the old password, as the list of old + * credentials stored by ESAPI is all hashed. + * Additionally, the user object is taken in order to verify the password and account name differ. + * + * @param oldPassword + * the old password + * @param newPassword + * the new password + * @param user + * the user + * + * @throws AuthenticationException + * if newPassword is too similar to oldPassword or if newPassword does not meet complexity requirements + */ + void verifyPasswordStrength(String oldPassword, String newPassword, User user) throws AuthenticationException; + + /** + * Determine if the account exists. + * + * @param accountName + * the account name + * + * @return true, if the account exists + */ + boolean exists(String accountName); + +} From 5762feafcab321a134f71765827405596c8c3282 Mon Sep 17 00:00:00 2001 From: kwwall Date: Mon, 18 Jan 2016 23:33:47 -0500 Subject: [PATCH 091/812] Change CRLF to LF for issue 356. --- .../java/org/owasp/esapi/codecs/Base64.java | 3748 ++++++++--------- 1 file changed, 1874 insertions(+), 1874 deletions(-) diff --git a/src/main/java/org/owasp/esapi/codecs/Base64.java b/src/main/java/org/owasp/esapi/codecs/Base64.java index e470ac6e8..624d23c3d 100644 --- a/src/main/java/org/owasp/esapi/codecs/Base64.java +++ b/src/main/java/org/owasp/esapi/codecs/Base64.java @@ -1,1874 +1,1874 @@ -package org.owasp.esapi.codecs; - -import org.owasp.esapi.ESAPI; -import org.owasp.esapi.Logger; - -// CHECKME: Version at http://iharder.net/base64 is up to v2.3.3. Some semantic changes -// starting with v2.3. Should we upgrade and then add ESAPI logging or stay at 2.2.2 base? -// I think that really depends on how much OWASP ESAPI plans on tracking changes to this -// version vs. if the plan was just to fork from it and maintain OWASP's own version. -// At this point, I think I prefer split from tracking Harder's original, but I'm easily -// persuaded otherwise. - Kevin Wall - -/** - *

    Encodes and decodes to and from Base64 notation.

    - *

    Homepage: http://iharder.net/base64 - * (based on version 2.2.2).

    - * - *

    The options parameter, which appears in a few places, is used to pass - * several pieces of information to the encoder. In the "higher level" methods such as - * encodeBytes( bytes, options ) the options parameter can be used to indicate such - * things as first gzipping the bytes before encoding them, not inserting linefeeds - * (though that breaks strict Base64 compatibility), and encoding using the URL-safe - * and Ordered dialects.

    - * - *

    The constants defined in Base64 can be OR-ed together to combine options, so you - * might make a call like this:

    - * - * String encoded = Base64.encodeBytes( mybytes, Base64.GZIP | Base64.DONT_BREAK_LINES ); - * - *

    to compress the data before encoding it and then making the output have no newline characters.

    - * - * - *

    - * Original change Log: - *

    - *
      - *
    • v2.2.2 - Fixed encodeFileToFile and decodeFileToFile to use the - * Base64.InputStream class to encode and decode on the fly which uses - * less memory than encoding/decoding an entire file into memory before writing.
      • - *
    • v2.2.1 - Fixed bug using URL_SAFE and ORDERED encodings. Fixed bug - * when using very small files (~< 40 bytes).
      • - *
    • v2.2 - Added some helper methods for encoding/decoding directly from - * one file to the next. Also added a main() method to support command line - * encoding/decoding from one file to the next. Also added these Base64 dialects: - *
        - *
      1. The default is RFC3548 format.
        2. - *
      2. Calling Base64.setFormat(Base64.BASE64_FORMAT.URLSAFE_FORMAT) generates - * URL and file name friendly format as described in Section 4 of RFC3548. - * http://www.faqs.org/rfcs/rfc3548.html
        3. - *
      3. Calling Base64.setFormat(Base64.BASE64_FORMAT.ORDERED_FORMAT) generates - * URL and file name friendly format that preserves lexical ordering as described - * in http://www.faqs.org/qa/rfcc-1940.html
        4. - *
      - * Special thanks to Jim Kellerman at http://www.powerset.com/ - * for contributing the new Base64 dialects. - *
      • - * - *
    • v2.1 - Cleaned up javadoc comments and unused variables and methods. Added - * some convenience methods for reading and writing to and from files.
      • - *
    • v2.0.2 - Now specifies UTF-8 encoding in places where the code fails on systems - * with other encodings (like EBCDIC).
      • - *
    • v2.0.1 - Fixed an error when decoding a single byte, that is, when the - * encoded data was a single byte.
      • - *
    • v2.0 - I got rid of methods that used booleans to set options. - * Now everything is more consolidated and cleaner. The code now detects - * when data that's being decoded is gzip-compressed and will decompress it - * automatically. Generally things are cleaner. You'll probably have to - * change some method calls that you were making to support the new - * options format (ints that you "OR" together).
      • - *
    • v1.5.1 - Fixed bug when decompressing and decoding to a - * byte[] using decode( String s, boolean gzipCompressed ). - * Added the ability to "suspend" encoding in the Output Stream so - * you can turn on and off the encoding if you need to embed base64 - * data in an otherwise "normal" stream (like an XML file).
      • - *
    • v1.5 - Output stream pases on flush() command but doesn't do anything itself. - * This helps when using GZIP streams. - * Added the ability to GZip-compress objects before encoding them.
      • - *
    • v1.4 - Added helper methods to read/write files.
      • - *
    • v1.3.6 - Fixed OutputStream.flush() so that 'position' is reset.
      • - *
    • v1.3.5 - Added flag to turn on and off line breaks. Fixed bug in input stream - * where last buffer being read, if not completely full, was not returned.
      • - *
    • v1.3.4 - Fixed when "improperly padded stream" error was thrown at the wrong time.
      • - *
    • v1.3.3 - Fixed I/O streams which were totally messed up.
      • - *
    - * - *

    - * I am placing this code in the Public Domain. Do with it as you will. - * This software comes with no guarantees or warranties but with - * plenty of well-wishing instead! - * Please visit http://iharder.net/base64 - * periodically to check for updates or to contribute improvements. - *

    - * - * @author Robert Harder - * @author rob@iharder.net - * @version 2.2.2 - */ -public class Base64 -{ - -/* ******** P U B L I C F I E L D S ******** */ - - - /** No options specified. Value is zero. */ - public final static int NO_OPTIONS = 0; - - /** Specify encoding. */ - public final static int ENCODE = 1; - - - /** Specify decoding. */ - public final static int DECODE = 0; - - - /** Specify that data should be gzip-compressed. */ - public final static int GZIP = 2; - - - /** Don't break lines when encoding (violates strict Base64 specification) */ - public final static int DONT_BREAK_LINES = 8; - - /** - * Encode using Base64-like encoding that is URL- and Filename-safe as described - * in Section 4 of RFC3548: - * http://www.faqs.org/rfcs/rfc3548.html. - * It is important to note that data encoded this way is not officially valid Base64, - * or at the very least should not be called Base64 without also specifying that is - * was encoded using the URL- and Filename-safe dialect. - */ - public final static int URL_SAFE = 16; - - - /** - * Encode using the special "ordered" dialect of Base64 described here: - * http://www.faqs.org/qa/rfcc-1940.html. - */ - public final static int ORDERED = 32; - - -/* ******** P R I V A T E F I E L D S ******** */ - - - /** Maximum line length (76) of Base64 output. */ - private final static int MAX_LINE_LENGTH = 76; - - - /** The equals sign (=) as a byte. */ - private final static byte EQUALS_SIGN = (byte)'='; - - - /** The new line character (\n) as a byte. */ - private final static byte NEW_LINE = (byte)'\n'; - - - /** Preferred encoding. */ - private final static String PREFERRED_ENCODING = "UTF-8"; - - /** End of line character. */ - private final static String EOL = System.getProperty("line.separator", "\n"); - - - // I think I end up not using the BAD_ENCODING indicator. - //private final static byte BAD_ENCODING = -9; // Indicates error in encoding - private final static byte WHITE_SPACE_ENC = -5; // Indicates white space in encoding - private final static byte EQUALS_SIGN_ENC = -1; // Indicates equals sign in encoding - - private static final Logger logger = ESAPI.getLogger("Base64"); - - -/* ******** S T A N D A R D B A S E 6 4 A L P H A B E T ******** */ - - /** The 64 valid Base64 values. */ - //private final static byte[] ALPHABET; - /* Host platform me be something funny like EBCDIC, so we hard code these values. */ - private final static byte[] _STANDARD_ALPHABET = - { - (byte)'A', (byte)'B', (byte)'C', (byte)'D', (byte)'E', (byte)'F', (byte)'G', - (byte)'H', (byte)'I', (byte)'J', (byte)'K', (byte)'L', (byte)'M', (byte)'N', - (byte)'O', (byte)'P', (byte)'Q', (byte)'R', (byte)'S', (byte)'T', (byte)'U', - (byte)'V', (byte)'W', (byte)'X', (byte)'Y', (byte)'Z', - (byte)'a', (byte)'b', (byte)'c', (byte)'d', (byte)'e', (byte)'f', (byte)'g', - (byte)'h', (byte)'i', (byte)'j', (byte)'k', (byte)'l', (byte)'m', (byte)'n', - (byte)'o', (byte)'p', (byte)'q', (byte)'r', (byte)'s', (byte)'t', (byte)'u', - (byte)'v', (byte)'w', (byte)'x', (byte)'y', (byte)'z', - (byte)'0', (byte)'1', (byte)'2', (byte)'3', (byte)'4', (byte)'5', - (byte)'6', (byte)'7', (byte)'8', (byte)'9', (byte)'+', (byte)'/' - }; - - - /** - * Translates a Base64 value to either its 6-bit reconstruction value - * or a negative number indicating some other meaning. - **/ - private final static byte[] _STANDARD_DECODABET = - { - -9,-9,-9,-9,-9,-9,-9,-9,-9, // Decimal 0 - 8 - -5,-5, // Whitespace: Tab and Linefeed - -9,-9, // Decimal 11 - 12 - -5, // Whitespace: Carriage Return - -9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9, // Decimal 14 - 26 - -9,-9,-9,-9,-9, // Decimal 27 - 31 - -5, // Whitespace: Space - -9,-9,-9,-9,-9,-9,-9,-9,-9,-9, // Decimal 33 - 42 - 62, // Plus sign at decimal 43 - -9,-9,-9, // Decimal 44 - 46 - 63, // Slash at decimal 47 - 52,53,54,55,56,57,58,59,60,61, // Numbers zero through nine - -9,-9,-9, // Decimal 58 - 60 - -1, // Equals sign at decimal 61 - -9,-9,-9, // Decimal 62 - 64 - 0,1,2,3,4,5,6,7,8,9,10,11,12,13, // Letters 'A' through 'N' - 14,15,16,17,18,19,20,21,22,23,24,25, // Letters 'O' through 'Z' - -9,-9,-9,-9,-9,-9, // Decimal 91 - 96 - 26,27,28,29,30,31,32,33,34,35,36,37,38, // Letters 'a' through 'm' - 39,40,41,42,43,44,45,46,47,48,49,50,51, // Letters 'n' through 'z' - -9,-9,-9,-9 // Decimal 123 - 126 - /*,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9, // Decimal 127 - 139 - -9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9, // Decimal 140 - 152 - -9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9, // Decimal 153 - 165 - -9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9, // Decimal 166 - 178 - -9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9, // Decimal 179 - 191 - -9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9, // Decimal 192 - 204 - -9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9, // Decimal 205 - 217 - -9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9, // Decimal 218 - 230 - -9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9, // Decimal 231 - 243 - -9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9 // Decimal 244 - 255 */ - }; - - -/* ******** U R L S A F E B A S E 6 4 A L P H A B E T ******** */ - - /** - * Used in the URL- and Filename-safe dialect described in Section 4 of RFC3548: - * http://www.faqs.org/rfcs/rfc3548.html. - * Notice that the last two bytes become "hyphen" and "underscore" instead of "plus" and "slash." - */ - private final static byte[] _URL_SAFE_ALPHABET = - { - (byte)'A', (byte)'B', (byte)'C', (byte)'D', (byte)'E', (byte)'F', (byte)'G', - (byte)'H', (byte)'I', (byte)'J', (byte)'K', (byte)'L', (byte)'M', (byte)'N', - (byte)'O', (byte)'P', (byte)'Q', (byte)'R', (byte)'S', (byte)'T', (byte)'U', - (byte)'V', (byte)'W', (byte)'X', (byte)'Y', (byte)'Z', - (byte)'a', (byte)'b', (byte)'c', (byte)'d', (byte)'e', (byte)'f', (byte)'g', - (byte)'h', (byte)'i', (byte)'j', (byte)'k', (byte)'l', (byte)'m', (byte)'n', - (byte)'o', (byte)'p', (byte)'q', (byte)'r', (byte)'s', (byte)'t', (byte)'u', - (byte)'v', (byte)'w', (byte)'x', (byte)'y', (byte)'z', - (byte)'0', (byte)'1', (byte)'2', (byte)'3', (byte)'4', (byte)'5', - (byte)'6', (byte)'7', (byte)'8', (byte)'9', (byte)'-', (byte)'_' - }; - - /** - * Used in decoding URL- and Filename-safe dialects of Base64. - */ - private final static byte[] _URL_SAFE_DECODABET = - { - -9,-9,-9,-9,-9,-9,-9,-9,-9, // Decimal 0 - 8 - -5,-5, // Whitespace: Tab and Linefeed - -9,-9, // Decimal 11 - 12 - -5, // Whitespace: Carriage Return - -9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9, // Decimal 14 - 26 - -9,-9,-9,-9,-9, // Decimal 27 - 31 - -5, // Whitespace: Space - -9,-9,-9,-9,-9,-9,-9,-9,-9,-9, // Decimal 33 - 42 - -9, // Plus sign at decimal 43 - -9, // Decimal 44 - 62, // Minus sign at decimal 45 - -9, // Decimal 46 - -9, // Slash at decimal 47 - 52,53,54,55,56,57,58,59,60,61, // Numbers zero through nine - -9,-9,-9, // Decimal 58 - 60 - -1, // Equals sign at decimal 61 - -9,-9,-9, // Decimal 62 - 64 - 0,1,2,3,4,5,6,7,8,9,10,11,12,13, // Letters 'A' through 'N' - 14,15,16,17,18,19,20,21,22,23,24,25, // Letters 'O' through 'Z' - -9,-9,-9,-9, // Decimal 91 - 94 - 63, // Underscore at decimal 95 - -9, // Decimal 96 - 26,27,28,29,30,31,32,33,34,35,36,37,38, // Letters 'a' through 'm' - 39,40,41,42,43,44,45,46,47,48,49,50,51, // Letters 'n' through 'z' - -9,-9,-9,-9 // Decimal 123 - 126 - /*,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9, // Decimal 127 - 139 - -9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9, // Decimal 140 - 152 - -9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9, // Decimal 153 - 165 - -9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9, // Decimal 166 - 178 - -9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9, // Decimal 179 - 191 - -9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9, // Decimal 192 - 204 - -9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9, // Decimal 205 - 217 - -9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9, // Decimal 218 - 230 - -9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9, // Decimal 231 - 243 - -9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9 // Decimal 244 - 255 */ - }; - - - -/* ******** O R D E R E D B A S E 6 4 A L P H A B E T ******** */ - - /** - * I don't get the point of this technique, but it is described here: - * http://www.faqs.org/qa/rfcc-1940.html. - */ - private final static byte[] _ORDERED_ALPHABET = - { - (byte)'-', - (byte)'0', (byte)'1', (byte)'2', (byte)'3', (byte)'4', - (byte)'5', (byte)'6', (byte)'7', (byte)'8', (byte)'9', - (byte)'A', (byte)'B', (byte)'C', (byte)'D', (byte)'E', (byte)'F', (byte)'G', - (byte)'H', (byte)'I', (byte)'J', (byte)'K', (byte)'L', (byte)'M', (byte)'N', - (byte)'O', (byte)'P', (byte)'Q', (byte)'R', (byte)'S', (byte)'T', (byte)'U', - (byte)'V', (byte)'W', (byte)'X', (byte)'Y', (byte)'Z', - (byte)'_', - (byte)'a', (byte)'b', (byte)'c', (byte)'d', (byte)'e', (byte)'f', (byte)'g', - (byte)'h', (byte)'i', (byte)'j', (byte)'k', (byte)'l', (byte)'m', (byte)'n', - (byte)'o', (byte)'p', (byte)'q', (byte)'r', (byte)'s', (byte)'t', (byte)'u', - (byte)'v', (byte)'w', (byte)'x', (byte)'y', (byte)'z' - }; - - /** - * Used in decoding the "ordered" dialect of Base64. - */ - private final static byte[] _ORDERED_DECODABET = - { - -9,-9,-9,-9,-9,-9,-9,-9,-9, // Decimal 0 - 8 - -5,-5, // Whitespace: Tab and Linefeed - -9,-9, // Decimal 11 - 12 - -5, // Whitespace: Carriage Return - -9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9, // Decimal 14 - 26 - -9,-9,-9,-9,-9, // Decimal 27 - 31 - -5, // Whitespace: Space - -9,-9,-9,-9,-9,-9,-9,-9,-9,-9, // Decimal 33 - 42 - -9, // Plus sign at decimal 43 - -9, // Decimal 44 - 0, // Minus sign at decimal 45 - -9, // Decimal 46 - -9, // Slash at decimal 47 - 1,2,3,4,5,6,7,8,9,10, // Numbers zero through nine - -9,-9,-9, // Decimal 58 - 60 - -1, // Equals sign at decimal 61 - -9,-9,-9, // Decimal 62 - 64 - 11,12,13,14,15,16,17,18,19,20,21,22,23, // Letters 'A' through 'M' - 24,25,26,27,28,29,30,31,32,33,34,35,36, // Letters 'N' through 'Z' - -9,-9,-9,-9, // Decimal 91 - 94 - 37, // Underscore at decimal 95 - -9, // Decimal 96 - 38,39,40,41,42,43,44,45,46,47,48,49,50, // Letters 'a' through 'm' - 51,52,53,54,55,56,57,58,59,60,61,62,63, // Letters 'n' through 'z' - -9,-9,-9,-9 // Decimal 123 - 126 - /*,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9, // Decimal 127 - 139 - -9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9, // Decimal 140 - 152 - -9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9, // Decimal 153 - 165 - -9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9, // Decimal 166 - 178 - -9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9, // Decimal 179 - 191 - -9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9, // Decimal 192 - 204 - -9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9, // Decimal 205 - 217 - -9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9, // Decimal 218 - 230 - -9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9, // Decimal 231 - 243 - -9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9 // Decimal 244 - 255 */ - }; - - -/* ******** D E T E R M I N E W H I C H A L H A B E T ******** */ - - - /** - * Returns one of the _SOMETHING_ALPHABET byte arrays depending on - * the options specified. - * It's possible, though silly, to specify ORDERED and URLSAFE - * in which case one of them will be picked, though there is - * no guarantee as to which one will be picked. - */ - private final static byte[] getAlphabet( int options ) - { - if( (options & URL_SAFE) == URL_SAFE ) return _URL_SAFE_ALPHABET; - else if( (options & ORDERED) == ORDERED ) return _ORDERED_ALPHABET; - else return _STANDARD_ALPHABET; - - } // end getAlphabet - - - /** - * Returns one of the _SOMETHING_DECODABET byte arrays depending on - * the options specified. - * It's possible, though silly, to specify ORDERED and URL_SAFE - * in which case one of them will be picked, though there is - * no guarantee as to which one will be picked. - */ - private final static byte[] getDecodabet( int options ) - { - if( (options & URL_SAFE) == URL_SAFE ) return _URL_SAFE_DECODABET; - else if( (options & ORDERED) == ORDERED ) return _ORDERED_DECODABET; - else return _STANDARD_DECODABET; - - } // end getAlphabet - - - - /** Defeats instantiation. */ - private Base64(){} - - - /** - * Encodes or decodes two files from the command line; - * feel free to delete this method (in fact you probably should) - * if you're embedding this code into a larger program. - * @param args - */ - public final static void main( String[] args ) - { - if( args.length < 3 ){ - usage("Not enough arguments."); - } // end if: args.length < 3 - else { - String flag = args[0]; - String infile = args[1]; - String outfile = args[2]; - if( flag.equals( "-e" ) ){ - Base64.encodeFileToFile( infile, outfile ); - } // end if: encode - else if( flag.equals( "-d" ) ) { - Base64.decodeFileToFile( infile, outfile ); - } // end else if: decode - else { - usage( "Unknown flag: " + flag ); - } // end else - } // end else - } // end main - - /** - * Prints command line usage. - * - * @param msg A message to include with usage info. - */ - private final static void usage( String msg ) - { - System.err.println( msg ); - System.err.println( "Usage: java Base64 -e|-d inputfile outputfile" ); - } // end usage - - -/* ******** E N C O D I N G M E T H O D S ******** */ - - - /** - * Encodes up to the first three bytes of array threeBytes - * and returns a four-byte array in Base64 notation. - * The actual number of significant bytes in your array is - * given by numSigBytes. - * The array threeBytes needs only be as big as - * numSigBytes. - * Code can reuse a byte array by passing a four-byte array as b4. - * - * @param b4 A reusable byte array to reduce array instantiation - * @param threeBytes the array to convert - * @param numSigBytes the number of significant bytes in your array - * @return four byte array in Base64 notation. - * @since 1.5.1 - */ - private static byte[] encode3to4( byte[] b4, byte[] threeBytes, int numSigBytes, int options ) - { - encode3to4( threeBytes, 0, numSigBytes, b4, 0, options ); - return b4; - } // end encode3to4 - - - /** - *

    Encodes up to three bytes of the array source - * and writes the resulting four Base64 bytes to destination. - * The source and destination arrays can be manipulated - * anywhere along their length by specifying - * srcOffset and destOffset. - * This method does not check to make sure your arrays - * are large enough to accomodate srcOffset + 3 for - * the source array or destOffset + 4 for - * the destination array. - * The actual number of significant bytes in your array is - * given by numSigBytes.

    - *

    This is the lowest level of the encoding methods with - * all possible parameters.

    - * - * @param source the array to convert - * @param srcOffset the index where conversion begins - * @param numSigBytes the number of significant bytes in your array - * @param destination the array to hold the conversion - * @param destOffset the index where output will be put - * @return the destination array - * @since 1.3 - */ - private static byte[] encode3to4( - byte[] source, int srcOffset, int numSigBytes, - byte[] destination, int destOffset, int options ) - { - byte[] ALPHABET = getAlphabet( options ); - - // 1 2 3 - // 01234567890123456789012345678901 Bit position - // --------000000001111111122222222 Array position from threeBytes - // --------| || || || | Six bit groups to index ALPHABET - // >>18 >>12 >> 6 >> 0 Right shift necessary - // 0x3f 0x3f 0x3f Additional AND - - // Create buffer with zero-padding if there are only one or two - // significant bytes passed in the array. - // We have to shift left 24 in order to flush out the 1's that appear - // when Java treats a value as negative that is cast from a byte to an int. - int inBuff = ( numSigBytes > 0 ? ((source[ srcOffset ] << 24) >>> 8) : 0 ) - | ( numSigBytes > 1 ? ((source[ srcOffset + 1 ] << 24) >>> 16) : 0 ) - | ( numSigBytes > 2 ? ((source[ srcOffset + 2 ] << 24) >>> 24) : 0 ); - - switch( numSigBytes ) - { - case 3: - destination[ destOffset ] = ALPHABET[ (inBuff >>> 18) ]; - destination[ destOffset + 1 ] = ALPHABET[ (inBuff >>> 12) & 0x3f ]; - destination[ destOffset + 2 ] = ALPHABET[ (inBuff >>> 6) & 0x3f ]; - destination[ destOffset + 3 ] = ALPHABET[ (inBuff ) & 0x3f ]; - return destination; - - case 2: - destination[ destOffset ] = ALPHABET[ (inBuff >>> 18) ]; - destination[ destOffset + 1 ] = ALPHABET[ (inBuff >>> 12) & 0x3f ]; - destination[ destOffset + 2 ] = ALPHABET[ (inBuff >>> 6) & 0x3f ]; - destination[ destOffset + 3 ] = EQUALS_SIGN; - return destination; - - case 1: - destination[ destOffset ] = ALPHABET[ (inBuff >>> 18) ]; - destination[ destOffset + 1 ] = ALPHABET[ (inBuff >>> 12) & 0x3f ]; - destination[ destOffset + 2 ] = EQUALS_SIGN; - destination[ destOffset + 3 ] = EQUALS_SIGN; - return destination; - - default: - return destination; - } // end switch - } // end encode3to4 - - - - /** - * Serializes an object and returns the Base64-encoded - * version of that serialized object. If the object - * cannot be serialized or there is another error, - * the method will return null. - * The object is not GZip-compressed before being encoded. - * - * @param serializableObject The object to encode - * @return The Base64-encoded object - * @since 1.4 - */ - public static String encodeObject( java.io.Serializable serializableObject ) - { - return encodeObject( serializableObject, NO_OPTIONS ); - } // end encodeObject - - - - /** - * Serializes an object and returns the Base64-encoded - * version of that serialized object. If the object - * cannot be serialized or there is another error, - * the method will return null. - *

    - * Valid options:

    -     *   GZIP: gzip-compresses object before encoding it.
-     *   DONT_BREAK_LINES: don't break lines at 76 characters
-     *     Note: Technically, this makes your encoding non-compliant.
-     *
    - *

    - * Example: encodeObject( myObj, Base64.GZIP ) or - *

    - * Example: encodeObject( myObj, Base64.GZIP | Base64.DONT_BREAK_LINES ) - * - * @param serializableObject The object to encode - * @param options Specified options - * @return The Base64-encoded object - * @see Base64#GZIP - * @see Base64#DONT_BREAK_LINES - * @since 2.0 - */ - public static String encodeObject( java.io.Serializable serializableObject, int options ) - { - // Streams - java.io.ByteArrayOutputStream baos = null; - java.io.OutputStream b64os = null; - java.io.ObjectOutputStream oos = null; - java.util.zip.GZIPOutputStream gzos = null; - - // Isolate options - int gzip = (options & GZIP); - //int dontBreakLines = (options & DONT_BREAK_LINES); - - try - { - // ObjectOutputStream -> (GZIP) -> Base64 -> ByteArrayOutputStream - baos = new java.io.ByteArrayOutputStream(); - b64os = new Base64.OutputStream( baos, ENCODE | options ); - - // GZip? - if( gzip == GZIP ) - { - gzos = new java.util.zip.GZIPOutputStream( b64os ); - oos = new java.io.ObjectOutputStream( gzos ); - } // end if: gzip - else - oos = new java.io.ObjectOutputStream( b64os ); - - oos.writeObject( serializableObject ); - } // end try - catch( java.io.IOException e ) - { - logger.error( Logger.SECURITY_FAILURE, "Problem writing object", e ); - return null; - } // end catch - finally - { - try{ oos.close(); } catch( Exception e ){} - try{ gzos.close(); } catch( Exception e ){} - try{ b64os.close(); } catch( Exception e ){} - try{ baos.close(); } catch( Exception e ){} - } // end finally - - // Return value according to relevant encoding. - try - { - return new String( baos.toByteArray(), PREFERRED_ENCODING ); - } // end try - catch (java.io.UnsupportedEncodingException uue) - { - return new String( baos.toByteArray() ); - } // end catch - - } // end encode - - - - /** - * Encodes a byte array into Base64 notation. - * Does not GZip-compress data. - * - * @param source The data to convert - * @return The Base64-encoded resulting string - * @since 1.4 - */ - public static String encodeBytes( byte[] source ) - { - return encodeBytes( source, 0, source.length, NO_OPTIONS ); - } // end encodeBytes - - - - /** - * Encodes a byte array into Base64 notation. - *

    - * Valid options:

    -     *   GZIP: gzip-compresses object before encoding it.
-     *   DONT_BREAK_LINES: don't break lines at 76 characters
-     *     Note: Technically, this makes your encoding non-compliant.
-     *
    - *

    - * Example: encodeBytes( myData, Base64.GZIP ) or - *

    - * Example: encodeBytes( myData, Base64.GZIP | Base64.DONT_BREAK_LINES ) - * - * - * @param source The data to convert - * @param options Specified options - * @return The Base64-encoded resulting string - * @see Base64#GZIP - * @see Base64#DONT_BREAK_LINES - * @since 2.0 - */ - public static String encodeBytes( byte[] source, int options ) - { - return encodeBytes( source, 0, source.length, options ); - } // end encodeBytes - - - /** - * Encodes a byte array into Base64 notation. - * Does not GZip-compress data. - * - * @param source The data to convert - * @param off Offset in array where conversion should begin - * @param len Length of data to convert - * @return The Base64-encoded resulting string - * @since 1.4 - */ - public static String encodeBytes( byte[] source, int off, int len ) - { - return encodeBytes( source, off, len, NO_OPTIONS ); - } // end encodeBytes - - - - /** - * Encodes a byte array into Base64 notation. - *

    - * Valid options:

    -     *   GZIP: gzip-compresses object before encoding it.
-     *   DONT_BREAK_LINES: don't break lines at 76 characters
-     *     Note: Technically, this makes your encoding non-compliant.
-     *
    - *

    - * Example: encodeBytes( myData, Base64.GZIP ) or - *

    - * Example: encodeBytes( myData, Base64.GZIP | Base64.DONT_BREAK_LINES ) - * - * - * @param source The data to convert - * @param off Offset in array where conversion should begin - * @param len Length of data to convert - * @param options alphabet type is pulled from this (standard, url-safe, ordered) - * @return The Base64-encoded resulting string - * @see Base64#GZIP - * @see Base64#DONT_BREAK_LINES - * @since 2.0 - */ - public static String encodeBytes( byte[] source, int off, int len, int options ) - { - // Isolate options - int dontBreakLines = ( options & DONT_BREAK_LINES ); - int gzip = ( options & GZIP ); - - // Compress? - if( gzip == GZIP ) - { - java.io.ByteArrayOutputStream baos = null; - java.util.zip.GZIPOutputStream gzos = null; - Base64.OutputStream b64os = null; - - - try - { - // GZip -> Base64 -> ByteArray - baos = new java.io.ByteArrayOutputStream(); - b64os = new Base64.OutputStream( baos, ENCODE | options ); - gzos = new java.util.zip.GZIPOutputStream( b64os ); - - gzos.write( source, off, len ); - gzos.close(); - } // end try - catch( java.io.IOException e ) - { - logger.error( Logger.SECURITY_FAILURE, "Problem writing gzip stream", e ); - return null; - } // end catch - finally - { - try{ gzos.close(); } catch( Exception e ){} - try{ b64os.close(); } catch( Exception e ){} - try{ baos.close(); } catch( Exception e ){} - } // end finally - - // Return value according to relevant encoding. - try - { - return new String( baos.toByteArray(), PREFERRED_ENCODING ); - } // end try - catch (java.io.UnsupportedEncodingException uue) - { - return new String( baos.toByteArray() ); - } // end catch - } // end if: compress - - // Else, don't compress. Better not to use streams at all then. - else - { - // Convert option to boolean in way that code likes it. - boolean breakLines = dontBreakLines == 0; - - int len43 = len * 4 / 3; - byte[] outBuff = new byte[ ( len43 ) // Main 4:3 - + ( (len % 3) > 0 ? 4 : 0 ) // Account for padding - + (breakLines ? ( len43 / MAX_LINE_LENGTH ) : 0) ]; // New lines - int d = 0; - int e = 0; - int len2 = len - 2; - int lineLength = 0; - for( ; d < len2; d+=3, e+=4 ) - { - encode3to4( source, d+off, 3, outBuff, e, options ); - - lineLength += 4; - if( breakLines && lineLength == MAX_LINE_LENGTH ) - { - outBuff[e+4] = NEW_LINE; - e++; - lineLength = 0; - } // end if: end of line - } // en dfor: each piece of array - - if( d < len ) - { - encode3to4( source, d+off, len - d, outBuff, e, options ); - e += 4; - } // end if: some padding needed - - - // Return value according to relevant encoding. - try - { - return new String( outBuff, 0, e, PREFERRED_ENCODING ); - } // end try - catch (java.io.UnsupportedEncodingException uue) - { - return new String( outBuff, 0, e ); - } // end catch - - } // end else: don't compress - - } // end encodeBytes - - - - - -/* ******** D E C O D I N G M E T H O D S ******** */ - - - /** - * Decodes four bytes from array source - * and writes the resulting bytes (up to three of them) - * to destination. - * The source and destination arrays can be manipulated - * anywhere along their length by specifying - * srcOffset and destOffset. - * This method does not check to make sure your arrays - * are large enough to accomodate srcOffset + 4 for - * the source array or destOffset + 3 for - * the destination array. - * This method returns the actual number of bytes that - * were converted from the Base64 encoding. - *

    This is the lowest level of the decoding methods with - * all possible parameters.

    - * - * - * @param source the array to convert - * @param srcOffset the index where conversion begins - * @param destination the array to hold the conversion - * @param destOffset the index where output will be put - * @param options alphabet type is pulled from this (standard, url-safe, ordered) - * @return the number of decoded bytes converted - * @since 1.3 - */ - private static int decode4to3( byte[] source, int srcOffset, byte[] destination, int destOffset, int options ) - { - byte[] DECODABET = getDecodabet( options ); - - // Example: Dk== - if( source[ srcOffset + 2] == EQUALS_SIGN ) - { - // Two ways to do the same thing. Don't know which way I like best. - //int outBuff = ( ( DECODABET[ source[ srcOffset ] ] << 24 ) >>> 6 ) - // | ( ( DECODABET[ source[ srcOffset + 1] ] << 24 ) >>> 12 ); - int outBuff = ( ( DECODABET[ source[ srcOffset ] ] & 0xFF ) << 18 ) - | ( ( DECODABET[ source[ srcOffset + 1] ] & 0xFF ) << 12 ); - - destination[ destOffset ] = (byte)( outBuff >>> 16 ); - return 1; - } - - // Example: DkL= - else if( source[ srcOffset + 3 ] == EQUALS_SIGN ) - { - // Two ways to do the same thing. Don't know which way I like best. - //int outBuff = ( ( DECODABET[ source[ srcOffset ] ] << 24 ) >>> 6 ) - // | ( ( DECODABET[ source[ srcOffset + 1 ] ] << 24 ) >>> 12 ) - // | ( ( DECODABET[ source[ srcOffset + 2 ] ] << 24 ) >>> 18 ); - int outBuff = ( ( DECODABET[ source[ srcOffset ] ] & 0xFF ) << 18 ) - | ( ( DECODABET[ source[ srcOffset + 1 ] ] & 0xFF ) << 12 ) - | ( ( DECODABET[ source[ srcOffset + 2 ] ] & 0xFF ) << 6 ); - - destination[ destOffset ] = (byte)( outBuff >>> 16 ); - destination[ destOffset + 1 ] = (byte)( outBuff >>> 8 ); - return 2; - } - - // Example: DkLE - else - { - try{ - // Two ways to do the same thing. Don't know which way I like best. - //int outBuff = ( ( DECODABET[ source[ srcOffset ] ] << 24 ) >>> 6 ) - // | ( ( DECODABET[ source[ srcOffset + 1 ] ] << 24 ) >>> 12 ) - // | ( ( DECODABET[ source[ srcOffset + 2 ] ] << 24 ) >>> 18 ) - // | ( ( DECODABET[ source[ srcOffset + 3 ] ] << 24 ) >>> 24 ); - int outBuff = ( ( DECODABET[ source[ srcOffset ] ] & 0xFF ) << 18 ) - | ( ( DECODABET[ source[ srcOffset + 1 ] ] & 0xFF ) << 12 ) - | ( ( DECODABET[ source[ srcOffset + 2 ] ] & 0xFF ) << 6) - | ( ( DECODABET[ source[ srcOffset + 3 ] ] & 0xFF ) ); - - - destination[ destOffset ] = (byte)( outBuff >> 16 ); - destination[ destOffset + 1 ] = (byte)( outBuff >> 8 ); - destination[ destOffset + 2 ] = (byte)( outBuff ); - - return 3; - }catch( Exception e){ - - // Remove these after checking -- for context only. - // logger.error( Logger.SECURITY_FAILURE, "Problem writing object", e ); - // logger.error( Logger.SECURITY_FAILURE, ""+source[srcOffset]+ ": " + ( DECODABET[ source[ srcOffset ] ] ) ); - // logger.error( Logger.SECURITY_FAILURE, ""+source[srcOffset+1]+ ": " + ( DECODABET[ source[ srcOffset + 1 ] ] ) ); - // logger.error( Logger.SECURITY_FAILURE, ""+source[srcOffset+2]+ ": " + ( DECODABET[ source[ srcOffset + 2 ] ] ) ); - // logger.error( Logger.SECURITY_FAILURE, ""+source[srcOffset+3]+ ": " + ( DECODABET[ source[ srcOffset + 3 ] ] ) ); - - // CHECKME: I replaced the 5 separate logger.error() calls above with a single logger.error() call so they can't - // become interleaved with other log entries from other threads. Normally this would have placed log entries - // on separate lines, so I also added line terminators here as well. (Probably don't want it all on one single - // really long log entry, do we?) Anyhow, somebody should check the formatting to ensure that it's - // esthetically pleasing, etc. But this works for me. I'm also OK if you want to remove all the line terminators - // in which case the declaration for EOL should be removed as well. - Kevin Wall - - StringBuilder sb = new StringBuilder("Problem writing object:"); - sb.append(EOL); - sb.append( source[srcOffset] ).append(": ").append( ( DECODABET[ source[ srcOffset ] ] ) ).append(EOL); - sb.append( source[srcOffset+1] ).append(": ").append( ( DECODABET[ source[ srcOffset + 1 ] ] ) ).append(EOL); - sb.append( source[srcOffset+2] ).append(": ").append( ( DECODABET[ source[ srcOffset + 2 ] ] ) ).append(EOL); - sb.append( source[srcOffset+3] ).append(": ").append( ( DECODABET[ source[ srcOffset + 3 ] ] ) ).append(EOL); - - logger.error( Logger.SECURITY_FAILURE, sb.toString(), e ); - return -1; - } // end catch - } - } // end decodeToBytes - - - - - /** - * Very low-level access to decoding ASCII characters in - * the form of a byte array. Does not support automatically - * gunzipping or any other "fancy" features. - * - * @param source The Base64 encoded data - * @param off The offset of where to begin decoding - * @param len The length of characters to decode - * @param options - * @return decoded data - * @since 1.3 - */ - public static byte[] decode( byte[] source, int off, int len, int options ) - { - byte[] DECODABET = getDecodabet( options ); - - int len34 = len * 3 / 4; - byte[] outBuff = new byte[ len34 ]; // Upper limit on size of output - int outBuffPosn = 0; - - byte[] b4 = new byte[4]; - int b4Posn = 0; - int i = 0; - byte sbiCrop = 0; - byte sbiDecode = 0; - for( i = off; i < off+len; i++ ) - { - sbiCrop = (byte)(source[i] & 0x7f); // Only the low seven bits - sbiDecode = DECODABET[ sbiCrop ]; - - if( sbiDecode >= WHITE_SPACE_ENC ) // White space, Equals sign or better - { - if( sbiDecode >= EQUALS_SIGN_ENC ) - { - b4[ b4Posn++ ] = sbiCrop; - if( b4Posn > 3 ) - { - outBuffPosn += decode4to3( b4, 0, outBuff, outBuffPosn, options ); - b4Posn = 0; - - // If that was the equals sign, break out of 'for' loop - if( sbiCrop == EQUALS_SIGN ) - break; - } // end if: quartet built - - } // end if: equals sign or better - - } // end if: white space, equals sign or better - else - { - logger.error( Logger.SECURITY_FAILURE, "Bad Base64 input character at " + i + ": " + source[i] + "(decimal)" ); - return null; - } // end else: - } // each input character - - byte[] out = new byte[ outBuffPosn ]; - System.arraycopy( outBuff, 0, out, 0, outBuffPosn ); - return out; - } // end decode - - - - - /** - * Decodes data from Base64 notation, automatically - * detecting gzip-compressed data and decompressing it. - * - * @param s the string to decode - * @return the decoded data - * @since 1.4 - */ - public static byte[] decode( String s ) - { - return decode( s, NO_OPTIONS ); - } - - - /** - * Decodes data from Base64 notation, automatically - * detecting gzip-compressed data and decompressing it. - * - * @param s the string to decode - * @param options encode options such as URL_SAFE - * @return the decoded data - * @since 1.4 - */ - public static byte[] decode( String s, int options ) - { - byte[] bytes; - try - { - bytes = s.getBytes( PREFERRED_ENCODING ); - } - catch( java.io.UnsupportedEncodingException uee ) - { - bytes = s.getBytes(); // Uses native encoding - // CHECKME: Is this correct? I think it should be a warning instead of an error since nothing - // is re-thrown. I do think that *some* sort of logging is in order here especially since UTF-8 should - // always be available on all platforms. If it's not, then all bets are off on your runtime env. - Kevin Wall - logger.warning( Logger.SECURITY_FAILURE, "Problem decoding string using " + - PREFERRED_ENCODING + "; substituting native platform encoding instead", uee ); - } - - // Decode - bytes = decode( bytes, 0, bytes.length, options ); - - - // Check to see if it's gzip-compressed - // GZIP Magic Two-Byte Number: 0x8b1f (35615) - if( bytes != null && bytes.length >= 4 ) - { - - int head = ((int)bytes[0] & 0xff) | ((bytes[1] << 8) & 0xff00); - if( java.util.zip.GZIPInputStream.GZIP_MAGIC == head ) - { - java.io.ByteArrayInputStream bais = null; - java.util.zip.GZIPInputStream gzis = null; - java.io.ByteArrayOutputStream baos = null; - byte[] buffer = new byte[2048]; - int length = 0; - - try - { - baos = new java.io.ByteArrayOutputStream(); - bais = new java.io.ByteArrayInputStream( bytes ); - gzis = new java.util.zip.GZIPInputStream( bais ); - - while( ( length = gzis.read( buffer ) ) >= 0 ) - { - baos.write(buffer,0,length); - } // end while: reading input - - // No error? Get new bytes. - bytes = baos.toByteArray(); - - } // end try - catch( java.io.IOException e ) - { - // Just return originally-decoded bytes - } // end catch - finally - { - try{ baos.close(); } catch( Exception e ){} - try{ gzis.close(); } catch( Exception e ){} - try{ bais.close(); } catch( Exception e ){} - } // end finally - - } // end if: gzipped - } // end if: bytes.length >= 2 - - return bytes; - } // end decode - - - - - /** - * Attempts to decode Base64 data and deserialize a Java - * Object within. Returns null if there was an error. - * - *

    - * WARNING: Using this method to decode non-validated / - * untrusted data from a string and deserialize it into - * an object can potentially result in remote command - * injection vulnerabilities. Use at your own risk! - *

    - * - * @param encodedObject The Base64 data to decode - * @return The decoded and deserialized object - * @since 1.5 - * - * @deprecated Because of security issues, this method will be - * removed from ESAPI in a future release and no substitute - * is planned. Because as of JDK 8 (in 1Q2016) there is - * currently no way to restrict which objects - * ObjectInputStream.readObject() - * may safely deserialize in the general case. Oracle - * may decide to address this deficiency in a future Java - * release, but until they do, there is no simple way for - * a general class library like ESAPI to address this. - */ - @Deprecated - public static Object decodeToObject( String encodedObject ) - { - // Decode and gunzip if necessary - byte[] objBytes = decode( encodedObject ); - - java.io.ByteArrayInputStream bais = null; - java.io.ObjectInputStream ois = null; - Object obj = null; - - try - { - bais = new java.io.ByteArrayInputStream( objBytes ); - ois = new java.io.ObjectInputStream( bais ); - - obj = ois.readObject(); - } // end try - catch( java.io.IOException e ) - { - logger.error( Logger.SECURITY_FAILURE, "Problem reading object", e ); - obj = null; - } // end catch - catch( java.lang.ClassNotFoundException e ) - { - logger.error( Logger.SECURITY_FAILURE, "Problem reading object", e ); - obj = null; - } // end catch - finally - { - try{ bais.close(); } catch( Exception e ){} - try{ ois.close(); } catch( Exception e ){} - } // end finally - - return obj; - } // end decodeObject - - - - /** - * Convenience method for encoding data to a file. - * - * @param dataToEncode byte array of data to encode in base64 form - * @param filename Filename for saving encoded data - * @return true if successful, false otherwise - * - * @since 2.1 - */ - public static boolean encodeToFile( byte[] dataToEncode, String filename ) - { - boolean success = false; - Base64.OutputStream bos = null; - try - { - bos = new Base64.OutputStream( - new java.io.FileOutputStream( filename ), Base64.ENCODE ); - bos.write( dataToEncode ); - success = true; - } // end try - catch( java.io.IOException e ) - { - - success = false; - } // end catch: IOException - finally - { - try{ bos.close(); } catch( Exception e ){} - } // end finally - - return success; - } // end encodeToFile - - - /** - * Convenience method for decoding data to a file. - * - * @param dataToDecode Base64-encoded data as a string - * @param filename Filename for saving decoded data - * @return true if successful, false otherwise - * - * @since 2.1 - */ - public static boolean decodeToFile( String dataToDecode, String filename ) - { - boolean success = false; - Base64.OutputStream bos = null; - try - { - bos = new Base64.OutputStream( - new java.io.FileOutputStream( filename ), Base64.DECODE ); - bos.write( dataToDecode.getBytes( PREFERRED_ENCODING ) ); - success = true; - } // end try - catch( java.io.IOException e ) - { - success = false; - } // end catch: IOException - finally - { - try{ bos.close(); } catch( Exception e ){} - } // end finally - - return success; - } // end decodeToFile - - - - - /** - * Convenience method for reading a base64-encoded - * file and decoding it. - * - * @param filename Filename for reading encoded data - * @return decoded byte array or null if unsuccessful - * - * @since 2.1 - */ - public static byte[] decodeFromFile( String filename ) - { - byte[] decodedData = null; - Base64.InputStream bis = null; - try - { - // Set up some useful variables - java.io.File file = new java.io.File( filename ); - byte[] buffer = null; - int length = 0; - int numBytes = 0; - - // Check for size of file - if( file.length() > Integer.MAX_VALUE ) - { - logger.error( Logger.SECURITY_FAILURE, "File is too big for this convenience method (" + file.length() + " bytes)." ); - return null; - } // end if: file too big for int index - buffer = new byte[ (int)file.length() ]; - - // Open a stream - bis = new Base64.InputStream( - new java.io.BufferedInputStream( - new java.io.FileInputStream( file ) ), Base64.DECODE ); - - // Read until done - while( ( numBytes = bis.read( buffer, length, 4096 ) ) >= 0 ) - length += numBytes; - - // Save in a variable to return - decodedData = new byte[ length ]; - System.arraycopy( buffer, 0, decodedData, 0, length ); - - } // end try - catch( java.io.IOException e ) - { - logger.error( Logger.SECURITY_FAILURE, "Error decoding from file " + filename, e ); - } // end catch: IOException - finally - { - try{ if (bis != null ) bis.close(); } catch( Exception e) {} - } // end finally - - return decodedData; - } // end decodeFromFile - - - - /** - * Convenience method for reading a binary file - * and base64-encoding it. - * - * @param filename Filename for reading binary data - * @return base64-encoded string or null if unsuccessful - * - * @since 2.1 - */ - public static String encodeFromFile( String filename ) - { - String encodedData = null; - Base64.InputStream bis = null; - try - { - // Set up some useful variables - java.io.File file = new java.io.File( filename ); - byte[] buffer = new byte[ Math.max((int)(file.length() * 1.4),40) ]; // Need max() for math on small files (v2.2.1) - int length = 0; - int numBytes = 0; - - // Open a stream - bis = new Base64.InputStream( - new java.io.BufferedInputStream( - new java.io.FileInputStream( file ) ), Base64.ENCODE ); - - // Read until done - while( ( numBytes = bis.read( buffer, length, 4096 ) ) >= 0 ) - length += numBytes; - - // Save in a variable to return - encodedData = new String( buffer, 0, length, Base64.PREFERRED_ENCODING ); - - } // end try - catch( java.io.IOException e ) - { - logger.error( Logger.SECURITY_FAILURE, "Error encoding from file " + filename, e ); - } // end catch: IOException - finally - { - try{ bis.close(); } catch( Exception e) {} - } // end finally - - return encodedData; - } // end encodeFromFile - - - - - /** - * Reads infile and encodes it to outfile. - * - * @param infile Input file - * @param outfile Output file - * @return true if the operation is successful - * @since 2.2 - */ - public static boolean encodeFileToFile( String infile, String outfile ) - { - boolean success = false; - java.io.InputStream in = null; - java.io.OutputStream out = null; - try{ - in = new Base64.InputStream( - new java.io.BufferedInputStream( - new java.io.FileInputStream( infile ) ), - Base64.ENCODE ); - out = new java.io.BufferedOutputStream( new java.io.FileOutputStream( outfile ) ); - byte[] buffer = new byte[65536]; // 64K - int read = -1; - while( ( read = in.read(buffer) ) >= 0 ){ - out.write( buffer,0,read ); - } // end while: through file - success = true; - } catch( java.io.IOException exc ){ - logger.error( Logger.SECURITY_FAILURE, "Problem encoding file to file", exc ); - } finally{ - try{ in.close(); } catch( Exception exc ){} - try{ out.close(); } catch( Exception exc ){} - } // end finally - - return success; - } // end encodeFileToFile - - - - /** - * Reads infile and decodes it to outfile. - * - * @param infile Input file - * @param outfile Output file - * @return true if the operation is successful - * @since 2.2 - */ - public static boolean decodeFileToFile( String infile, String outfile ) - { - boolean success = false; - java.io.InputStream in = null; - java.io.OutputStream out = null; - try{ - in = new Base64.InputStream( - new java.io.BufferedInputStream( - new java.io.FileInputStream( infile ) ), - Base64.DECODE ); - out = new java.io.BufferedOutputStream( new java.io.FileOutputStream( outfile ) ); - byte[] buffer = new byte[65536]; // 64K - int read = -1; - while( ( read = in.read(buffer) ) >= 0 ){ - out.write( buffer,0,read ); - } // end while: through file - success = true; - } catch( java.io.IOException exc ){ - logger.error( Logger.SECURITY_FAILURE, "Problem decoding file to file", exc ); - } finally{ - try{ in.close(); } catch( Exception exc ){} - try{ out.close(); } catch( Exception exc ){} - } // end finally - - return success; - } // end decodeFileToFile - - - /* ******** I N N E R C L A S S I N P U T S T R E A M ******** */ - - - - /** - * A {@link Base64.InputStream} will read data from another - * java.io.InputStream, given in the constructor, - * and encode/decode to/from Base64 notation on the fly. - * - * @see Base64 - * @since 1.3 - */ - public static class InputStream extends java.io.FilterInputStream - { - private boolean encode; // Encoding or decoding - private int position; // Current position in the buffer - private byte[] buffer; // Small buffer holding converted data - private int bufferLength; // Length of buffer (3 or 4) - private int numSigBytes; // Number of meaningful bytes in the buffer - private int lineLength; - private boolean breakLines; // Break lines at less than 80 characters - private int options; // Record options used to create the stream. - private byte[] decodabet; // Local copies to avoid extra method calls - - - /** - * Constructs a {@link Base64.InputStream} in DECODE mode. - * - * @param in the java.io.InputStream from which to read data. - * @since 1.3 - */ - public InputStream( java.io.InputStream in ) - { - this( in, DECODE ); - } // end constructor - - - /** - * Constructs a {@link Base64.InputStream} in - * either ENCODE or DECODE mode. - *

    - * Valid options:

    -         *   ENCODE or DECODE: Encode or Decode as data is read.
-         *   DONT_BREAK_LINES: don't break lines at 76 characters
-         *     (only meaningful when encoding)
-         *     Note: Technically, this makes your encoding non-compliant.
-         *
    - *

    - * Example: new Base64.InputStream( in, Base64.DECODE ) - * - * - * @param in the java.io.InputStream from which to read data. - * @param options Specified options - * @see Base64#ENCODE - * @see Base64#DECODE - * @see Base64#DONT_BREAK_LINES - * @since 2.0 - */ - public InputStream( java.io.InputStream in, int options ) - { - super( in ); - this.breakLines = (options & DONT_BREAK_LINES) != DONT_BREAK_LINES; - this.encode = (options & ENCODE) == ENCODE; - this.bufferLength = encode ? 4 : 3; - this.buffer = new byte[ bufferLength ]; - this.position = -1; - this.lineLength = 0; - this.options = options; // Record for later, mostly to determine which alphabet to use - this.decodabet = getDecodabet(options); - } // end constructor - - /** - * Reads enough of the input stream to convert - * to/from Base64 and returns the next byte. - * - * @return next byte - * @throws java.io.IOException - * @since 1.3 - */ - public int read() throws java.io.IOException - { - // Do we need to get data? - if( position < 0 ) - { - if( encode ) - { - byte[] b3 = new byte[3]; - int numBinaryBytes = 0; - for( int i = 0; i < 3; i++ ) - { - try - { - int b = in.read(); - - // If end of stream, b is -1. - if( b >= 0 ) - { - b3[i] = (byte)b; - numBinaryBytes++; - } // end if: not end of stream - - } // end try: read - catch( java.io.IOException e ) - { - // Only a problem if we got no data at all. - if( i == 0 ) - throw e; - - } // end catch - } // end for: each needed input byte - - if( numBinaryBytes > 0 ) - { - encode3to4( b3, 0, numBinaryBytes, buffer, 0, options ); - position = 0; - numSigBytes = 4; - } // end if: got data - else - { - return -1; - } // end else - } // end if: encoding - - // Else decoding - else - { - byte[] b4 = new byte[4]; - int i = 0; - for( i = 0; i < 4; i++ ) - { - // Read four "meaningful" bytes: - int b = 0; - do{ b = in.read(); } - while( b >= 0 && decodabet[ b & 0x7f ] <= WHITE_SPACE_ENC ); - - if( b < 0 ) - break; // Reads a -1 if end of stream - - b4[i] = (byte)b; - } // end for: each needed input byte - - if( i == 4 ) - { - numSigBytes = decode4to3( b4, 0, buffer, 0, options ); - position = 0; - } // end if: got four characters - else if( i == 0 ){ - return -1; - } // end else if: also padded correctly - else - { - // Must have broken out from above. - throw new java.io.IOException( "Improperly padded Base64 input." ); - } // end - - } // end else: decode - } // end else: get data - - // Got data? - if( position >= 0 ) - { - // End of relevant data? - if( /*!encode &&*/ position >= numSigBytes ) - return -1; - - if( encode && breakLines && lineLength >= MAX_LINE_LENGTH ) - { - lineLength = 0; - return '\n'; - } // end if - else - { - lineLength++; // This isn't important when decoding - // but throwing an extra "if" seems - // just as wasteful. - - int b = buffer[ position++ ]; - - if( position >= bufferLength ) - position = -1; - - return b & 0xFF; // This is how you "cast" a byte that's - // intended to be unsigned. - } // end else - } // end if: position >= 0 - - // Else error - else - { - // When JDK1.4 is more accepted, use an assertion here. - throw new java.io.IOException( "Error in Base64 code reading stream." ); - } // end else - } // end read - - - /** - * Calls {@link #read()} repeatedly until the end of stream - * is reached or len bytes are read. - * Returns number of bytes read into array or -1 if - * end of stream is encountered. - * - * @param dest array to hold values - * @param off offset for array - * @param len max number of bytes to read into array - * @return bytes read into array or -1 if end of stream is encountered. - * @throws java.io.IOException - * @since 1.3 - */ - public int read( byte[] dest, int off, int len ) throws java.io.IOException - { - int i; - int b; - for( i = 0; i < len; i++ ) - { - b = read(); - - //if( b < 0 && i == 0 ) - // return -1; - - if( b >= 0 ) - dest[off + i] = (byte)b; - else if( i == 0 ) - return -1; - else - break; // Out of 'for' loop - } // end for: each byte read - return i; - } // end read - - } // end inner class InputStream - - - - - - - /* ******** I N N E R C L A S S O U T P U T S T R E A M ******** */ - - - - /** - * A {@link Base64.OutputStream} will write data to another - * java.io.OutputStream, given in the constructor, - * and encode/decode to/from Base64 notation on the fly. - * - * @see Base64 - * @since 1.3 - */ - public static class OutputStream extends java.io.FilterOutputStream - { - private boolean encode; - private int position; - private byte[] buffer; - private int bufferLength; - private int lineLength; - private boolean breakLines; - private byte[] b4; // Scratch used in a few places - private boolean suspendEncoding; - private int options; // Record for later - private byte[] decodabet; // Local copies to avoid extra method calls - - /** - * Constructs a {@link Base64.OutputStream} in ENCODE mode. - * - * @param out the java.io.OutputStream to which data will be written. - * @since 1.3 - */ - public OutputStream( java.io.OutputStream out ) - { - this( out, ENCODE ); - } // end constructor - - - /** - * Constructs a {@link Base64.OutputStream} in - * either ENCODE or DECODE mode. - *

    - * Valid options:

    -         *   ENCODE or DECODE: Encode or Decode as data is read.
-         *   DONT_BREAK_LINES: don't break lines at 76 characters
-         *     (only meaningful when encoding)
-         *     Note: Technically, this makes your encoding non-compliant.
-         *
    - *

    - * Example: new Base64.OutputStream( out, Base64.ENCODE ) - * - * @param out the java.io.OutputStream to which data will be written. - * @param options Specified options. - * @see Base64#ENCODE - * @see Base64#DECODE - * @see Base64#DONT_BREAK_LINES - * @since 1.3 - */ - public OutputStream( java.io.OutputStream out, int options ) - { - super( out ); - this.breakLines = (options & DONT_BREAK_LINES) != DONT_BREAK_LINES; - this.encode = (options & ENCODE) == ENCODE; - this.bufferLength = encode ? 3 : 4; - this.buffer = new byte[ bufferLength ]; - this.position = 0; - this.lineLength = 0; - this.suspendEncoding = false; - this.b4 = new byte[4]; - this.options = options; - this.decodabet = getDecodabet(options); - } // end constructor - - - /** - * Writes the byte to the output stream after - * converting to/from Base64 notation. - * When encoding, bytes are buffered three - * at a time before the output stream actually - * gets a write() call. - * When decoding, bytes are buffered four - * at a time. - * - * @param theByte the byte to write - * @throws java.io.IOException - * @since 1.3 - */ - public void write(int theByte) throws java.io.IOException - { - // Encoding suspended? - if( suspendEncoding ) - { - super.out.write( theByte ); - return; - } // end if: supsended - - // Encode? - if( encode ) - { - buffer[ position++ ] = (byte)theByte; - if( position >= bufferLength ) // Enough to encode. - { - out.write( encode3to4( b4, buffer, bufferLength, options ) ); - - lineLength += 4; - if( breakLines && lineLength >= MAX_LINE_LENGTH ) - { - out.write( NEW_LINE ); - lineLength = 0; - } // end if: end of line - - position = 0; - } // end if: enough to output - } // end if: encoding - - // Else, Decoding - else - { - // Meaningful Base64 character? - if( decodabet[ theByte & 0x7f ] > WHITE_SPACE_ENC ) - { - buffer[ position++ ] = (byte)theByte; - if( position >= bufferLength ) // Enough to output. - { - int len = Base64.decode4to3( buffer, 0, b4, 0, options ); - out.write( b4, 0, len ); - //out.write( Base64.decode4to3( buffer ) ); - position = 0; - } // end if: enough to output - } // end if: meaningful base64 character - else if( decodabet[ theByte & 0x7f ] != WHITE_SPACE_ENC ) - { - throw new java.io.IOException( "Invalid character in Base64 data." ); - } // end else: not white space either - } // end else: decoding - } // end write - - - - /** - * Calls {@link #write(int)} repeatedly until len - * bytes are written. - * - * @param theBytes array from which to read bytes - * @param off offset for array - * @param len max number of bytes to read into array - * @throws java.io.IOException - * @since 1.3 - */ - public void write( byte[] theBytes, int off, int len ) throws java.io.IOException - { - // Encoding suspended? - if( suspendEncoding ) - { - super.out.write( theBytes, off, len ); - return; - } // end if: supsended - - for( int i = 0; i < len; i++ ) - { - write( theBytes[ off + i ] ); - } // end for: each byte written - - } // end write - - - - /** - * Method added by PHIL. [Thanks, PHIL. -Rob] - * This pads the buffer without closing the stream. - * @throws java.io.IOException - */ - public void flushBase64() throws java.io.IOException - { - if( position > 0 ) - { - if( encode ) - { - out.write( encode3to4( b4, buffer, position, options ) ); - position = 0; - } // end if: encoding - else - { - throw new java.io.IOException( "Base64 input not properly padded." ); - } // end else: decoding - } // end if: buffer partially full - - } // end flush - - - /** - * Flushes and closes (I think, in the superclass) the stream. - * - * @throws java.io.IOException - * @since 1.3 - */ - public void close() throws java.io.IOException - { - // 1. Ensure that pending characters are written - flushBase64(); - - // 2. Actually close the stream - // Base class both flushes and closes. - super.close(); - - buffer = null; - out = null; - } // end close - - - - /** - * Suspends encoding of the stream. - * May be helpful if you need to embed a piece of - * base640-encoded data in a stream. - * - * @throws java.io.IOException - * @since 1.5.1 - */ - public void suspendEncoding() throws java.io.IOException - { - flushBase64(); - this.suspendEncoding = true; - } // end suspendEncoding - - - /** - * Resumes encoding of the stream. - * May be helpful if you need to embed a piece of - * base640-encoded data in a stream. - * - * @since 1.5.1 - */ - public void resumeEncoding() - { - this.suspendEncoding = false; - } // end resumeEncoding - - - - } // end inner class OutputStream - - -} // end class Base64 +package org.owasp.esapi.codecs; + +import org.owasp.esapi.ESAPI; +import org.owasp.esapi.Logger; + +// CHECKME: Version at http://iharder.net/base64 is up to v2.3.3. Some semantic changes +// starting with v2.3. Should we upgrade and then add ESAPI logging or stay at 2.2.2 base? +// I think that really depends on how much OWASP ESAPI plans on tracking changes to this +// version vs. if the plan was just to fork from it and maintain OWASP's own version. +// At this point, I think I prefer split from tracking Harder's original, but I'm easily +// persuaded otherwise. - Kevin Wall + +/** + *

    Encodes and decodes to and from Base64 notation.

    + *

    Homepage: http://iharder.net/base64 + * (based on version 2.2.2).

    + * + *

    The options parameter, which appears in a few places, is used to pass + * several pieces of information to the encoder. In the "higher level" methods such as + * encodeBytes( bytes, options ) the options parameter can be used to indicate such + * things as first gzipping the bytes before encoding them, not inserting linefeeds + * (though that breaks strict Base64 compatibility), and encoding using the URL-safe + * and Ordered dialects.

    + * + *

    The constants defined in Base64 can be OR-ed together to combine options, so you + * might make a call like this:

    + * + * String encoded = Base64.encodeBytes( mybytes, Base64.GZIP | Base64.DONT_BREAK_LINES ); + * + *

    to compress the data before encoding it and then making the output have no newline characters.

    + * + * + *

    + * Original change Log: + *

    + *
      + *
    • v2.2.2 - Fixed encodeFileToFile and decodeFileToFile to use the + * Base64.InputStream class to encode and decode on the fly which uses + * less memory than encoding/decoding an entire file into memory before writing.
      • + *
    • v2.2.1 - Fixed bug using URL_SAFE and ORDERED encodings. Fixed bug + * when using very small files (~< 40 bytes).
      • + *
    • v2.2 - Added some helper methods for encoding/decoding directly from + * one file to the next. Also added a main() method to support command line + * encoding/decoding from one file to the next. Also added these Base64 dialects: + *
        + *
      1. The default is RFC3548 format.
        2. + *
      2. Calling Base64.setFormat(Base64.BASE64_FORMAT.URLSAFE_FORMAT) generates + * URL and file name friendly format as described in Section 4 of RFC3548. + * http://www.faqs.org/rfcs/rfc3548.html
        3. + *
      3. Calling Base64.setFormat(Base64.BASE64_FORMAT.ORDERED_FORMAT) generates + * URL and file name friendly format that preserves lexical ordering as described + * in http://www.faqs.org/qa/rfcc-1940.html
        4. + *
      + * Special thanks to Jim Kellerman at http://www.powerset.com/ + * for contributing the new Base64 dialects. + *
      • + * + *
    • v2.1 - Cleaned up javadoc comments and unused variables and methods. Added + * some convenience methods for reading and writing to and from files.
      • + *
    • v2.0.2 - Now specifies UTF-8 encoding in places where the code fails on systems + * with other encodings (like EBCDIC).
      • + *
    • v2.0.1 - Fixed an error when decoding a single byte, that is, when the + * encoded data was a single byte.
      • + *
    • v2.0 - I got rid of methods that used booleans to set options. + * Now everything is more consolidated and cleaner. The code now detects + * when data that's being decoded is gzip-compressed and will decompress it + * automatically. Generally things are cleaner. You'll probably have to + * change some method calls that you were making to support the new + * options format (ints that you "OR" together).
      • + *
    • v1.5.1 - Fixed bug when decompressing and decoding to a + * byte[] using decode( String s, boolean gzipCompressed ). + * Added the ability to "suspend" encoding in the Output Stream so + * you can turn on and off the encoding if you need to embed base64 + * data in an otherwise "normal" stream (like an XML file).
      • + *
    • v1.5 - Output stream pases on flush() command but doesn't do anything itself. + * This helps when using GZIP streams. + * Added the ability to GZip-compress objects before encoding them.
      • + *
    • v1.4 - Added helper methods to read/write files.
      • + *
    • v1.3.6 - Fixed OutputStream.flush() so that 'position' is reset.
      • + *
    • v1.3.5 - Added flag to turn on and off line breaks. Fixed bug in input stream + * where last buffer being read, if not completely full, was not returned.
      • + *
    • v1.3.4 - Fixed when "improperly padded stream" error was thrown at the wrong time.
      • + *
    • v1.3.3 - Fixed I/O streams which were totally messed up.
      • + *
    + * + *

    + * I am placing this code in the Public Domain. Do with it as you will. + * This software comes with no guarantees or warranties but with + * plenty of well-wishing instead! + * Please visit http://iharder.net/base64 + * periodically to check for updates or to contribute improvements. + *

    + * + * @author Robert Harder + * @author rob@iharder.net + * @version 2.2.2 + */ +public class Base64 +{ + +/* ******** P U B L I C F I E L D S ******** */ + + + /** No options specified. Value is zero. */ + public final static int NO_OPTIONS = 0; + + /** Specify encoding. */ + public final static int ENCODE = 1; + + + /** Specify decoding. */ + public final static int DECODE = 0; + + + /** Specify that data should be gzip-compressed. */ + public final static int GZIP = 2; + + + /** Don't break lines when encoding (violates strict Base64 specification) */ + public final static int DONT_BREAK_LINES = 8; + + /** + * Encode using Base64-like encoding that is URL- and Filename-safe as described + * in Section 4 of RFC3548: + * http://www.faqs.org/rfcs/rfc3548.html. + * It is important to note that data encoded this way is not officially valid Base64, + * or at the very least should not be called Base64 without also specifying that is + * was encoded using the URL- and Filename-safe dialect. + */ + public final static int URL_SAFE = 16; + + + /** + * Encode using the special "ordered" dialect of Base64 described here: + * http://www.faqs.org/qa/rfcc-1940.html. + */ + public final static int ORDERED = 32; + + +/* ******** P R I V A T E F I E L D S ******** */ + + + /** Maximum line length (76) of Base64 output. */ + private final static int MAX_LINE_LENGTH = 76; + + + /** The equals sign (=) as a byte. */ + private final static byte EQUALS_SIGN = (byte)'='; + + + /** The new line character (\n) as a byte. */ + private final static byte NEW_LINE = (byte)'\n'; + + + /** Preferred encoding. */ + private final static String PREFERRED_ENCODING = "UTF-8"; + + /** End of line character. */ + private final static String EOL = System.getProperty("line.separator", "\n"); + + + // I think I end up not using the BAD_ENCODING indicator. + //private final static byte BAD_ENCODING = -9; // Indicates error in encoding + private final static byte WHITE_SPACE_ENC = -5; // Indicates white space in encoding + private final static byte EQUALS_SIGN_ENC = -1; // Indicates equals sign in encoding + + private static final Logger logger = ESAPI.getLogger("Base64"); + + +/* ******** S T A N D A R D B A S E 6 4 A L P H A B E T ******** */ + + /** The 64 valid Base64 values. */ + //private final static byte[] ALPHABET; + /* Host platform me be something funny like EBCDIC, so we hard code these values. */ + private final static byte[] _STANDARD_ALPHABET = + { + (byte)'A', (byte)'B', (byte)'C', (byte)'D', (byte)'E', (byte)'F', (byte)'G', + (byte)'H', (byte)'I', (byte)'J', (byte)'K', (byte)'L', (byte)'M', (byte)'N', + (byte)'O', (byte)'P', (byte)'Q', (byte)'R', (byte)'S', (byte)'T', (byte)'U', + (byte)'V', (byte)'W', (byte)'X', (byte)'Y', (byte)'Z', + (byte)'a', (byte)'b', (byte)'c', (byte)'d', (byte)'e', (byte)'f', (byte)'g', + (byte)'h', (byte)'i', (byte)'j', (byte)'k', (byte)'l', (byte)'m', (byte)'n', + (byte)'o', (byte)'p', (byte)'q', (byte)'r', (byte)'s', (byte)'t', (byte)'u', + (byte)'v', (byte)'w', (byte)'x', (byte)'y', (byte)'z', + (byte)'0', (byte)'1', (byte)'2', (byte)'3', (byte)'4', (byte)'5', + (byte)'6', (byte)'7', (byte)'8', (byte)'9', (byte)'+', (byte)'/' + }; + + + /** + * Translates a Base64 value to either its 6-bit reconstruction value + * or a negative number indicating some other meaning. + **/ + private final static byte[] _STANDARD_DECODABET = + { + -9,-9,-9,-9,-9,-9,-9,-9,-9, // Decimal 0 - 8 + -5,-5, // Whitespace: Tab and Linefeed + -9,-9, // Decimal 11 - 12 + -5, // Whitespace: Carriage Return + -9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9, // Decimal 14 - 26 + -9,-9,-9,-9,-9, // Decimal 27 - 31 + -5, // Whitespace: Space + -9,-9,-9,-9,-9,-9,-9,-9,-9,-9, // Decimal 33 - 42 + 62, // Plus sign at decimal 43 + -9,-9,-9, // Decimal 44 - 46 + 63, // Slash at decimal 47 + 52,53,54,55,56,57,58,59,60,61, // Numbers zero through nine + -9,-9,-9, // Decimal 58 - 60 + -1, // Equals sign at decimal 61 + -9,-9,-9, // Decimal 62 - 64 + 0,1,2,3,4,5,6,7,8,9,10,11,12,13, // Letters 'A' through 'N' + 14,15,16,17,18,19,20,21,22,23,24,25, // Letters 'O' through 'Z' + -9,-9,-9,-9,-9,-9, // Decimal 91 - 96 + 26,27,28,29,30,31,32,33,34,35,36,37,38, // Letters 'a' through 'm' + 39,40,41,42,43,44,45,46,47,48,49,50,51, // Letters 'n' through 'z' + -9,-9,-9,-9 // Decimal 123 - 126 + /*,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9, // Decimal 127 - 139 + -9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9, // Decimal 140 - 152 + -9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9, // Decimal 153 - 165 + -9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9, // Decimal 166 - 178 + -9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9, // Decimal 179 - 191 + -9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9, // Decimal 192 - 204 + -9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9, // Decimal 205 - 217 + -9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9, // Decimal 218 - 230 + -9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9, // Decimal 231 - 243 + -9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9 // Decimal 244 - 255 */ + }; + + +/* ******** U R L S A F E B A S E 6 4 A L P H A B E T ******** */ + + /** + * Used in the URL- and Filename-safe dialect described in Section 4 of RFC3548: + * http://www.faqs.org/rfcs/rfc3548.html. + * Notice that the last two bytes become "hyphen" and "underscore" instead of "plus" and "slash." + */ + private final static byte[] _URL_SAFE_ALPHABET = + { + (byte)'A', (byte)'B', (byte)'C', (byte)'D', (byte)'E', (byte)'F', (byte)'G', + (byte)'H', (byte)'I', (byte)'J', (byte)'K', (byte)'L', (byte)'M', (byte)'N', + (byte)'O', (byte)'P', (byte)'Q', (byte)'R', (byte)'S', (byte)'T', (byte)'U', + (byte)'V', (byte)'W', (byte)'X', (byte)'Y', (byte)'Z', + (byte)'a', (byte)'b', (byte)'c', (byte)'d', (byte)'e', (byte)'f', (byte)'g', + (byte)'h', (byte)'i', (byte)'j', (byte)'k', (byte)'l', (byte)'m', (byte)'n', + (byte)'o', (byte)'p', (byte)'q', (byte)'r', (byte)'s', (byte)'t', (byte)'u', + (byte)'v', (byte)'w', (byte)'x', (byte)'y', (byte)'z', + (byte)'0', (byte)'1', (byte)'2', (byte)'3', (byte)'4', (byte)'5', + (byte)'6', (byte)'7', (byte)'8', (byte)'9', (byte)'-', (byte)'_' + }; + + /** + * Used in decoding URL- and Filename-safe dialects of Base64. + */ + private final static byte[] _URL_SAFE_DECODABET = + { + -9,-9,-9,-9,-9,-9,-9,-9,-9, // Decimal 0 - 8 + -5,-5, // Whitespace: Tab and Linefeed + -9,-9, // Decimal 11 - 12 + -5, // Whitespace: Carriage Return + -9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9, // Decimal 14 - 26 + -9,-9,-9,-9,-9, // Decimal 27 - 31 + -5, // Whitespace: Space + -9,-9,-9,-9,-9,-9,-9,-9,-9,-9, // Decimal 33 - 42 + -9, // Plus sign at decimal 43 + -9, // Decimal 44 + 62, // Minus sign at decimal 45 + -9, // Decimal 46 + -9, // Slash at decimal 47 + 52,53,54,55,56,57,58,59,60,61, // Numbers zero through nine + -9,-9,-9, // Decimal 58 - 60 + -1, // Equals sign at decimal 61 + -9,-9,-9, // Decimal 62 - 64 + 0,1,2,3,4,5,6,7,8,9,10,11,12,13, // Letters 'A' through 'N' + 14,15,16,17,18,19,20,21,22,23,24,25, // Letters 'O' through 'Z' + -9,-9,-9,-9, // Decimal 91 - 94 + 63, // Underscore at decimal 95 + -9, // Decimal 96 + 26,27,28,29,30,31,32,33,34,35,36,37,38, // Letters 'a' through 'm' + 39,40,41,42,43,44,45,46,47,48,49,50,51, // Letters 'n' through 'z' + -9,-9,-9,-9 // Decimal 123 - 126 + /*,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9, // Decimal 127 - 139 + -9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9, // Decimal 140 - 152 + -9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9, // Decimal 153 - 165 + -9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9, // Decimal 166 - 178 + -9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9, // Decimal 179 - 191 + -9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9, // Decimal 192 - 204 + -9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9, // Decimal 205 - 217 + -9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9, // Decimal 218 - 230 + -9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9, // Decimal 231 - 243 + -9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9 // Decimal 244 - 255 */ + }; + + + +/* ******** O R D E R E D B A S E 6 4 A L P H A B E T ******** */ + + /** + * I don't get the point of this technique, but it is described here: + * http://www.faqs.org/qa/rfcc-1940.html. + */ + private final static byte[] _ORDERED_ALPHABET = + { + (byte)'-', + (byte)'0', (byte)'1', (byte)'2', (byte)'3', (byte)'4', + (byte)'5', (byte)'6', (byte)'7', (byte)'8', (byte)'9', + (byte)'A', (byte)'B', (byte)'C', (byte)'D', (byte)'E', (byte)'F', (byte)'G', + (byte)'H', (byte)'I', (byte)'J', (byte)'K', (byte)'L', (byte)'M', (byte)'N', + (byte)'O', (byte)'P', (byte)'Q', (byte)'R', (byte)'S', (byte)'T', (byte)'U', + (byte)'V', (byte)'W', (byte)'X', (byte)'Y', (byte)'Z', + (byte)'_', + (byte)'a', (byte)'b', (byte)'c', (byte)'d', (byte)'e', (byte)'f', (byte)'g', + (byte)'h', (byte)'i', (byte)'j', (byte)'k', (byte)'l', (byte)'m', (byte)'n', + (byte)'o', (byte)'p', (byte)'q', (byte)'r', (byte)'s', (byte)'t', (byte)'u', + (byte)'v', (byte)'w', (byte)'x', (byte)'y', (byte)'z' + }; + + /** + * Used in decoding the "ordered" dialect of Base64. + */ + private final static byte[] _ORDERED_DECODABET = + { + -9,-9,-9,-9,-9,-9,-9,-9,-9, // Decimal 0 - 8 + -5,-5, // Whitespace: Tab and Linefeed + -9,-9, // Decimal 11 - 12 + -5, // Whitespace: Carriage Return + -9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9, // Decimal 14 - 26 + -9,-9,-9,-9,-9, // Decimal 27 - 31 + -5, // Whitespace: Space + -9,-9,-9,-9,-9,-9,-9,-9,-9,-9, // Decimal 33 - 42 + -9, // Plus sign at decimal 43 + -9, // Decimal 44 + 0, // Minus sign at decimal 45 + -9, // Decimal 46 + -9, // Slash at decimal 47 + 1,2,3,4,5,6,7,8,9,10, // Numbers zero through nine + -9,-9,-9, // Decimal 58 - 60 + -1, // Equals sign at decimal 61 + -9,-9,-9, // Decimal 62 - 64 + 11,12,13,14,15,16,17,18,19,20,21,22,23, // Letters 'A' through 'M' + 24,25,26,27,28,29,30,31,32,33,34,35,36, // Letters 'N' through 'Z' + -9,-9,-9,-9, // Decimal 91 - 94 + 37, // Underscore at decimal 95 + -9, // Decimal 96 + 38,39,40,41,42,43,44,45,46,47,48,49,50, // Letters 'a' through 'm' + 51,52,53,54,55,56,57,58,59,60,61,62,63, // Letters 'n' through 'z' + -9,-9,-9,-9 // Decimal 123 - 126 + /*,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9, // Decimal 127 - 139 + -9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9, // Decimal 140 - 152 + -9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9, // Decimal 153 - 165 + -9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9, // Decimal 166 - 178 + -9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9, // Decimal 179 - 191 + -9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9, // Decimal 192 - 204 + -9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9, // Decimal 205 - 217 + -9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9, // Decimal 218 - 230 + -9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9, // Decimal 231 - 243 + -9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9 // Decimal 244 - 255 */ + }; + + +/* ******** D E T E R M I N E W H I C H A L H A B E T ******** */ + + + /** + * Returns one of the _SOMETHING_ALPHABET byte arrays depending on + * the options specified. + * It's possible, though silly, to specify ORDERED and URLSAFE + * in which case one of them will be picked, though there is + * no guarantee as to which one will be picked. + */ + private final static byte[] getAlphabet( int options ) + { + if( (options & URL_SAFE) == URL_SAFE ) return _URL_SAFE_ALPHABET; + else if( (options & ORDERED) == ORDERED ) return _ORDERED_ALPHABET; + else return _STANDARD_ALPHABET; + + } // end getAlphabet + + + /** + * Returns one of the _SOMETHING_DECODABET byte arrays depending on + * the options specified. + * It's possible, though silly, to specify ORDERED and URL_SAFE + * in which case one of them will be picked, though there is + * no guarantee as to which one will be picked. + */ + private final static byte[] getDecodabet( int options ) + { + if( (options & URL_SAFE) == URL_SAFE ) return _URL_SAFE_DECODABET; + else if( (options & ORDERED) == ORDERED ) return _ORDERED_DECODABET; + else return _STANDARD_DECODABET; + + } // end getAlphabet + + + + /** Defeats instantiation. */ + private Base64(){} + + + /** + * Encodes or decodes two files from the command line; + * feel free to delete this method (in fact you probably should) + * if you're embedding this code into a larger program. + * @param args + */ + public final static void main( String[] args ) + { + if( args.length < 3 ){ + usage("Not enough arguments."); + } // end if: args.length < 3 + else { + String flag = args[0]; + String infile = args[1]; + String outfile = args[2]; + if( flag.equals( "-e" ) ){ + Base64.encodeFileToFile( infile, outfile ); + } // end if: encode + else if( flag.equals( "-d" ) ) { + Base64.decodeFileToFile( infile, outfile ); + } // end else if: decode + else { + usage( "Unknown flag: " + flag ); + } // end else + } // end else + } // end main + + /** + * Prints command line usage. + * + * @param msg A message to include with usage info. + */ + private final static void usage( String msg ) + { + System.err.println( msg ); + System.err.println( "Usage: java Base64 -e|-d inputfile outputfile" ); + } // end usage + + +/* ******** E N C O D I N G M E T H O D S ******** */ + + + /** + * Encodes up to the first three bytes of array threeBytes + * and returns a four-byte array in Base64 notation. + * The actual number of significant bytes in your array is + * given by numSigBytes. + * The array threeBytes needs only be as big as + * numSigBytes. + * Code can reuse a byte array by passing a four-byte array as b4. + * + * @param b4 A reusable byte array to reduce array instantiation + * @param threeBytes the array to convert + * @param numSigBytes the number of significant bytes in your array + * @return four byte array in Base64 notation. + * @since 1.5.1 + */ + private static byte[] encode3to4( byte[] b4, byte[] threeBytes, int numSigBytes, int options ) + { + encode3to4( threeBytes, 0, numSigBytes, b4, 0, options ); + return b4; + } // end encode3to4 + + + /** + *

    Encodes up to three bytes of the array source + * and writes the resulting four Base64 bytes to destination. + * The source and destination arrays can be manipulated + * anywhere along their length by specifying + * srcOffset and destOffset. + * This method does not check to make sure your arrays + * are large enough to accomodate srcOffset + 3 for + * the source array or destOffset + 4 for + * the destination array. + * The actual number of significant bytes in your array is + * given by numSigBytes.

    + *

    This is the lowest level of the encoding methods with + * all possible parameters.

    + * + * @param source the array to convert + * @param srcOffset the index where conversion begins + * @param numSigBytes the number of significant bytes in your array + * @param destination the array to hold the conversion + * @param destOffset the index where output will be put + * @return the destination array + * @since 1.3 + */ + private static byte[] encode3to4( + byte[] source, int srcOffset, int numSigBytes, + byte[] destination, int destOffset, int options ) + { + byte[] ALPHABET = getAlphabet( options ); + + // 1 2 3 + // 01234567890123456789012345678901 Bit position + // --------000000001111111122222222 Array position from threeBytes + // --------| || || || | Six bit groups to index ALPHABET + // >>18 >>12 >> 6 >> 0 Right shift necessary + // 0x3f 0x3f 0x3f Additional AND + + // Create buffer with zero-padding if there are only one or two + // significant bytes passed in the array. + // We have to shift left 24 in order to flush out the 1's that appear + // when Java treats a value as negative that is cast from a byte to an int. + int inBuff = ( numSigBytes > 0 ? ((source[ srcOffset ] << 24) >>> 8) : 0 ) + | ( numSigBytes > 1 ? ((source[ srcOffset + 1 ] << 24) >>> 16) : 0 ) + | ( numSigBytes > 2 ? ((source[ srcOffset + 2 ] << 24) >>> 24) : 0 ); + + switch( numSigBytes ) + { + case 3: + destination[ destOffset ] = ALPHABET[ (inBuff >>> 18) ]; + destination[ destOffset + 1 ] = ALPHABET[ (inBuff >>> 12) & 0x3f ]; + destination[ destOffset + 2 ] = ALPHABET[ (inBuff >>> 6) & 0x3f ]; + destination[ destOffset + 3 ] = ALPHABET[ (inBuff ) & 0x3f ]; + return destination; + + case 2: + destination[ destOffset ] = ALPHABET[ (inBuff >>> 18) ]; + destination[ destOffset + 1 ] = ALPHABET[ (inBuff >>> 12) & 0x3f ]; + destination[ destOffset + 2 ] = ALPHABET[ (inBuff >>> 6) & 0x3f ]; + destination[ destOffset + 3 ] = EQUALS_SIGN; + return destination; + + case 1: + destination[ destOffset ] = ALPHABET[ (inBuff >>> 18) ]; + destination[ destOffset + 1 ] = ALPHABET[ (inBuff >>> 12) & 0x3f ]; + destination[ destOffset + 2 ] = EQUALS_SIGN; + destination[ destOffset + 3 ] = EQUALS_SIGN; + return destination; + + default: + return destination; + } // end switch + } // end encode3to4 + + + + /** + * Serializes an object and returns the Base64-encoded + * version of that serialized object. If the object + * cannot be serialized or there is another error, + * the method will return null. + * The object is not GZip-compressed before being encoded. + * + * @param serializableObject The object to encode + * @return The Base64-encoded object + * @since 1.4 + */ + public static String encodeObject( java.io.Serializable serializableObject ) + { + return encodeObject( serializableObject, NO_OPTIONS ); + } // end encodeObject + + + + /** + * Serializes an object and returns the Base64-encoded + * version of that serialized object. If the object + * cannot be serialized or there is another error, + * the method will return null. + *

    + * Valid options:

    +     *   GZIP: gzip-compresses object before encoding it.
+     *   DONT_BREAK_LINES: don't break lines at 76 characters
+     *     Note: Technically, this makes your encoding non-compliant.
+     *
    + *

    + * Example: encodeObject( myObj, Base64.GZIP ) or + *

    + * Example: encodeObject( myObj, Base64.GZIP | Base64.DONT_BREAK_LINES ) + * + * @param serializableObject The object to encode + * @param options Specified options + * @return The Base64-encoded object + * @see Base64#GZIP + * @see Base64#DONT_BREAK_LINES + * @since 2.0 + */ + public static String encodeObject( java.io.Serializable serializableObject, int options ) + { + // Streams + java.io.ByteArrayOutputStream baos = null; + java.io.OutputStream b64os = null; + java.io.ObjectOutputStream oos = null; + java.util.zip.GZIPOutputStream gzos = null; + + // Isolate options + int gzip = (options & GZIP); + //int dontBreakLines = (options & DONT_BREAK_LINES); + + try + { + // ObjectOutputStream -> (GZIP) -> Base64 -> ByteArrayOutputStream + baos = new java.io.ByteArrayOutputStream(); + b64os = new Base64.OutputStream( baos, ENCODE | options ); + + // GZip? + if( gzip == GZIP ) + { + gzos = new java.util.zip.GZIPOutputStream( b64os ); + oos = new java.io.ObjectOutputStream( gzos ); + } // end if: gzip + else + oos = new java.io.ObjectOutputStream( b64os ); + + oos.writeObject( serializableObject ); + } // end try + catch( java.io.IOException e ) + { + logger.error( Logger.SECURITY_FAILURE, "Problem writing object", e ); + return null; + } // end catch + finally + { + try{ oos.close(); } catch( Exception e ){} + try{ gzos.close(); } catch( Exception e ){} + try{ b64os.close(); } catch( Exception e ){} + try{ baos.close(); } catch( Exception e ){} + } // end finally + + // Return value according to relevant encoding. + try + { + return new String( baos.toByteArray(), PREFERRED_ENCODING ); + } // end try + catch (java.io.UnsupportedEncodingException uue) + { + return new String( baos.toByteArray() ); + } // end catch + + } // end encode + + + + /** + * Encodes a byte array into Base64 notation. + * Does not GZip-compress data. + * + * @param source The data to convert + * @return The Base64-encoded resulting string + * @since 1.4 + */ + public static String encodeBytes( byte[] source ) + { + return encodeBytes( source, 0, source.length, NO_OPTIONS ); + } // end encodeBytes + + + + /** + * Encodes a byte array into Base64 notation. + *

    + * Valid options:

    +     *   GZIP: gzip-compresses object before encoding it.
+     *   DONT_BREAK_LINES: don't break lines at 76 characters
+     *     Note: Technically, this makes your encoding non-compliant.
+     *
    + *

    + * Example: encodeBytes( myData, Base64.GZIP ) or + *

    + * Example: encodeBytes( myData, Base64.GZIP | Base64.DONT_BREAK_LINES ) + * + * + * @param source The data to convert + * @param options Specified options + * @return The Base64-encoded resulting string + * @see Base64#GZIP + * @see Base64#DONT_BREAK_LINES + * @since 2.0 + */ + public static String encodeBytes( byte[] source, int options ) + { + return encodeBytes( source, 0, source.length, options ); + } // end encodeBytes + + + /** + * Encodes a byte array into Base64 notation. + * Does not GZip-compress data. + * + * @param source The data to convert + * @param off Offset in array where conversion should begin + * @param len Length of data to convert + * @return The Base64-encoded resulting string + * @since 1.4 + */ + public static String encodeBytes( byte[] source, int off, int len ) + { + return encodeBytes( source, off, len, NO_OPTIONS ); + } // end encodeBytes + + + + /** + * Encodes a byte array into Base64 notation. + *

    + * Valid options:

    +     *   GZIP: gzip-compresses object before encoding it.
+     *   DONT_BREAK_LINES: don't break lines at 76 characters
+     *     Note: Technically, this makes your encoding non-compliant.
+     *
    + *

    + * Example: encodeBytes( myData, Base64.GZIP ) or + *

    + * Example: encodeBytes( myData, Base64.GZIP | Base64.DONT_BREAK_LINES ) + * + * + * @param source The data to convert + * @param off Offset in array where conversion should begin + * @param len Length of data to convert + * @param options alphabet type is pulled from this (standard, url-safe, ordered) + * @return The Base64-encoded resulting string + * @see Base64#GZIP + * @see Base64#DONT_BREAK_LINES + * @since 2.0 + */ + public static String encodeBytes( byte[] source, int off, int len, int options ) + { + // Isolate options + int dontBreakLines = ( options & DONT_BREAK_LINES ); + int gzip = ( options & GZIP ); + + // Compress? + if( gzip == GZIP ) + { + java.io.ByteArrayOutputStream baos = null; + java.util.zip.GZIPOutputStream gzos = null; + Base64.OutputStream b64os = null; + + + try + { + // GZip -> Base64 -> ByteArray + baos = new java.io.ByteArrayOutputStream(); + b64os = new Base64.OutputStream( baos, ENCODE | options ); + gzos = new java.util.zip.GZIPOutputStream( b64os ); + + gzos.write( source, off, len ); + gzos.close(); + } // end try + catch( java.io.IOException e ) + { + logger.error( Logger.SECURITY_FAILURE, "Problem writing gzip stream", e ); + return null; + } // end catch + finally + { + try{ gzos.close(); } catch( Exception e ){} + try{ b64os.close(); } catch( Exception e ){} + try{ baos.close(); } catch( Exception e ){} + } // end finally + + // Return value according to relevant encoding. + try + { + return new String( baos.toByteArray(), PREFERRED_ENCODING ); + } // end try + catch (java.io.UnsupportedEncodingException uue) + { + return new String( baos.toByteArray() ); + } // end catch + } // end if: compress + + // Else, don't compress. Better not to use streams at all then. + else + { + // Convert option to boolean in way that code likes it. + boolean breakLines = dontBreakLines == 0; + + int len43 = len * 4 / 3; + byte[] outBuff = new byte[ ( len43 ) // Main 4:3 + + ( (len % 3) > 0 ? 4 : 0 ) // Account for padding + + (breakLines ? ( len43 / MAX_LINE_LENGTH ) : 0) ]; // New lines + int d = 0; + int e = 0; + int len2 = len - 2; + int lineLength = 0; + for( ; d < len2; d+=3, e+=4 ) + { + encode3to4( source, d+off, 3, outBuff, e, options ); + + lineLength += 4; + if( breakLines && lineLength == MAX_LINE_LENGTH ) + { + outBuff[e+4] = NEW_LINE; + e++; + lineLength = 0; + } // end if: end of line + } // en dfor: each piece of array + + if( d < len ) + { + encode3to4( source, d+off, len - d, outBuff, e, options ); + e += 4; + } // end if: some padding needed + + + // Return value according to relevant encoding. + try + { + return new String( outBuff, 0, e, PREFERRED_ENCODING ); + } // end try + catch (java.io.UnsupportedEncodingException uue) + { + return new String( outBuff, 0, e ); + } // end catch + + } // end else: don't compress + + } // end encodeBytes + + + + + +/* ******** D E C O D I N G M E T H O D S ******** */ + + + /** + * Decodes four bytes from array source + * and writes the resulting bytes (up to three of them) + * to destination. + * The source and destination arrays can be manipulated + * anywhere along their length by specifying + * srcOffset and destOffset. + * This method does not check to make sure your arrays + * are large enough to accomodate srcOffset + 4 for + * the source array or destOffset + 3 for + * the destination array. + * This method returns the actual number of bytes that + * were converted from the Base64 encoding. + *

    This is the lowest level of the decoding methods with + * all possible parameters.

    + * + * + * @param source the array to convert + * @param srcOffset the index where conversion begins + * @param destination the array to hold the conversion + * @param destOffset the index where output will be put + * @param options alphabet type is pulled from this (standard, url-safe, ordered) + * @return the number of decoded bytes converted + * @since 1.3 + */ + private static int decode4to3( byte[] source, int srcOffset, byte[] destination, int destOffset, int options ) + { + byte[] DECODABET = getDecodabet( options ); + + // Example: Dk== + if( source[ srcOffset + 2] == EQUALS_SIGN ) + { + // Two ways to do the same thing. Don't know which way I like best. + //int outBuff = ( ( DECODABET[ source[ srcOffset ] ] << 24 ) >>> 6 ) + // | ( ( DECODABET[ source[ srcOffset + 1] ] << 24 ) >>> 12 ); + int outBuff = ( ( DECODABET[ source[ srcOffset ] ] & 0xFF ) << 18 ) + | ( ( DECODABET[ source[ srcOffset + 1] ] & 0xFF ) << 12 ); + + destination[ destOffset ] = (byte)( outBuff >>> 16 ); + return 1; + } + + // Example: DkL= + else if( source[ srcOffset + 3 ] == EQUALS_SIGN ) + { + // Two ways to do the same thing. Don't know which way I like best. + //int outBuff = ( ( DECODABET[ source[ srcOffset ] ] << 24 ) >>> 6 ) + // | ( ( DECODABET[ source[ srcOffset + 1 ] ] << 24 ) >>> 12 ) + // | ( ( DECODABET[ source[ srcOffset + 2 ] ] << 24 ) >>> 18 ); + int outBuff = ( ( DECODABET[ source[ srcOffset ] ] & 0xFF ) << 18 ) + | ( ( DECODABET[ source[ srcOffset + 1 ] ] & 0xFF ) << 12 ) + | ( ( DECODABET[ source[ srcOffset + 2 ] ] & 0xFF ) << 6 ); + + destination[ destOffset ] = (byte)( outBuff >>> 16 ); + destination[ destOffset + 1 ] = (byte)( outBuff >>> 8 ); + return 2; + } + + // Example: DkLE + else + { + try{ + // Two ways to do the same thing. Don't know which way I like best. + //int outBuff = ( ( DECODABET[ source[ srcOffset ] ] << 24 ) >>> 6 ) + // | ( ( DECODABET[ source[ srcOffset + 1 ] ] << 24 ) >>> 12 ) + // | ( ( DECODABET[ source[ srcOffset + 2 ] ] << 24 ) >>> 18 ) + // | ( ( DECODABET[ source[ srcOffset + 3 ] ] << 24 ) >>> 24 ); + int outBuff = ( ( DECODABET[ source[ srcOffset ] ] & 0xFF ) << 18 ) + | ( ( DECODABET[ source[ srcOffset + 1 ] ] & 0xFF ) << 12 ) + | ( ( DECODABET[ source[ srcOffset + 2 ] ] & 0xFF ) << 6) + | ( ( DECODABET[ source[ srcOffset + 3 ] ] & 0xFF ) ); + + + destination[ destOffset ] = (byte)( outBuff >> 16 ); + destination[ destOffset + 1 ] = (byte)( outBuff >> 8 ); + destination[ destOffset + 2 ] = (byte)( outBuff ); + + return 3; + }catch( Exception e){ + + // Remove these after checking -- for context only. + // logger.error( Logger.SECURITY_FAILURE, "Problem writing object", e ); + // logger.error( Logger.SECURITY_FAILURE, ""+source[srcOffset]+ ": " + ( DECODABET[ source[ srcOffset ] ] ) ); + // logger.error( Logger.SECURITY_FAILURE, ""+source[srcOffset+1]+ ": " + ( DECODABET[ source[ srcOffset + 1 ] ] ) ); + // logger.error( Logger.SECURITY_FAILURE, ""+source[srcOffset+2]+ ": " + ( DECODABET[ source[ srcOffset + 2 ] ] ) ); + // logger.error( Logger.SECURITY_FAILURE, ""+source[srcOffset+3]+ ": " + ( DECODABET[ source[ srcOffset + 3 ] ] ) ); + + // CHECKME: I replaced the 5 separate logger.error() calls above with a single logger.error() call so they can't + // become interleaved with other log entries from other threads. Normally this would have placed log entries + // on separate lines, so I also added line terminators here as well. (Probably don't want it all on one single + // really long log entry, do we?) Anyhow, somebody should check the formatting to ensure that it's + // esthetically pleasing, etc. But this works for me. I'm also OK if you want to remove all the line terminators + // in which case the declaration for EOL should be removed as well. - Kevin Wall + + StringBuilder sb = new StringBuilder("Problem writing object:"); + sb.append(EOL); + sb.append( source[srcOffset] ).append(": ").append( ( DECODABET[ source[ srcOffset ] ] ) ).append(EOL); + sb.append( source[srcOffset+1] ).append(": ").append( ( DECODABET[ source[ srcOffset + 1 ] ] ) ).append(EOL); + sb.append( source[srcOffset+2] ).append(": ").append( ( DECODABET[ source[ srcOffset + 2 ] ] ) ).append(EOL); + sb.append( source[srcOffset+3] ).append(": ").append( ( DECODABET[ source[ srcOffset + 3 ] ] ) ).append(EOL); + + logger.error( Logger.SECURITY_FAILURE, sb.toString(), e ); + return -1; + } // end catch + } + } // end decodeToBytes + + + + + /** + * Very low-level access to decoding ASCII characters in + * the form of a byte array. Does not support automatically + * gunzipping or any other "fancy" features. + * + * @param source The Base64 encoded data + * @param off The offset of where to begin decoding + * @param len The length of characters to decode + * @param options + * @return decoded data + * @since 1.3 + */ + public static byte[] decode( byte[] source, int off, int len, int options ) + { + byte[] DECODABET = getDecodabet( options ); + + int len34 = len * 3 / 4; + byte[] outBuff = new byte[ len34 ]; // Upper limit on size of output + int outBuffPosn = 0; + + byte[] b4 = new byte[4]; + int b4Posn = 0; + int i = 0; + byte sbiCrop = 0; + byte sbiDecode = 0; + for( i = off; i < off+len; i++ ) + { + sbiCrop = (byte)(source[i] & 0x7f); // Only the low seven bits + sbiDecode = DECODABET[ sbiCrop ]; + + if( sbiDecode >= WHITE_SPACE_ENC ) // White space, Equals sign or better + { + if( sbiDecode >= EQUALS_SIGN_ENC ) + { + b4[ b4Posn++ ] = sbiCrop; + if( b4Posn > 3 ) + { + outBuffPosn += decode4to3( b4, 0, outBuff, outBuffPosn, options ); + b4Posn = 0; + + // If that was the equals sign, break out of 'for' loop + if( sbiCrop == EQUALS_SIGN ) + break; + } // end if: quartet built + + } // end if: equals sign or better + + } // end if: white space, equals sign or better + else + { + logger.error( Logger.SECURITY_FAILURE, "Bad Base64 input character at " + i + ": " + source[i] + "(decimal)" ); + return null; + } // end else: + } // each input character + + byte[] out = new byte[ outBuffPosn ]; + System.arraycopy( outBuff, 0, out, 0, outBuffPosn ); + return out; + } // end decode + + + + + /** + * Decodes data from Base64 notation, automatically + * detecting gzip-compressed data and decompressing it. + * + * @param s the string to decode + * @return the decoded data + * @since 1.4 + */ + public static byte[] decode( String s ) + { + return decode( s, NO_OPTIONS ); + } + + + /** + * Decodes data from Base64 notation, automatically + * detecting gzip-compressed data and decompressing it. + * + * @param s the string to decode + * @param options encode options such as URL_SAFE + * @return the decoded data + * @since 1.4 + */ + public static byte[] decode( String s, int options ) + { + byte[] bytes; + try + { + bytes = s.getBytes( PREFERRED_ENCODING ); + } + catch( java.io.UnsupportedEncodingException uee ) + { + bytes = s.getBytes(); // Uses native encoding + // CHECKME: Is this correct? I think it should be a warning instead of an error since nothing + // is re-thrown. I do think that *some* sort of logging is in order here especially since UTF-8 should + // always be available on all platforms. If it's not, then all bets are off on your runtime env. - Kevin Wall + logger.warning( Logger.SECURITY_FAILURE, "Problem decoding string using " + + PREFERRED_ENCODING + "; substituting native platform encoding instead", uee ); + } + + // Decode + bytes = decode( bytes, 0, bytes.length, options ); + + + // Check to see if it's gzip-compressed + // GZIP Magic Two-Byte Number: 0x8b1f (35615) + if( bytes != null && bytes.length >= 4 ) + { + + int head = ((int)bytes[0] & 0xff) | ((bytes[1] << 8) & 0xff00); + if( java.util.zip.GZIPInputStream.GZIP_MAGIC == head ) + { + java.io.ByteArrayInputStream bais = null; + java.util.zip.GZIPInputStream gzis = null; + java.io.ByteArrayOutputStream baos = null; + byte[] buffer = new byte[2048]; + int length = 0; + + try + { + baos = new java.io.ByteArrayOutputStream(); + bais = new java.io.ByteArrayInputStream( bytes ); + gzis = new java.util.zip.GZIPInputStream( bais ); + + while( ( length = gzis.read( buffer ) ) >= 0 ) + { + baos.write(buffer,0,length); + } // end while: reading input + + // No error? Get new bytes. + bytes = baos.toByteArray(); + + } // end try + catch( java.io.IOException e ) + { + // Just return originally-decoded bytes + } // end catch + finally + { + try{ baos.close(); } catch( Exception e ){} + try{ gzis.close(); } catch( Exception e ){} + try{ bais.close(); } catch( Exception e ){} + } // end finally + + } // end if: gzipped + } // end if: bytes.length >= 2 + + return bytes; + } // end decode + + + + + /** + * Attempts to decode Base64 data and deserialize a Java + * Object within. Returns null if there was an error. + * + *

    + * WARNING: Using this method to decode non-validated / + * untrusted data from a string and deserialize it into + * an object can potentially result in remote command + * injection vulnerabilities. Use at your own risk! + *

    + * + * @param encodedObject The Base64 data to decode + * @return The decoded and deserialized object + * @since 1.5 + * + * @deprecated Because of security issues, this method will be + * removed from ESAPI in a future release and no substitute + * is planned. Because as of JDK 8 (in 1Q2016) there is + * currently no way to restrict which objects + * ObjectInputStream.readObject() + * may safely deserialize in the general case. Oracle + * may decide to address this deficiency in a future Java + * release, but until they do, there is no simple way for + * a general class library like ESAPI to address this. + */ + @Deprecated + public static Object decodeToObject( String encodedObject ) + { + // Decode and gunzip if necessary + byte[] objBytes = decode( encodedObject ); + + java.io.ByteArrayInputStream bais = null; + java.io.ObjectInputStream ois = null; + Object obj = null; + + try + { + bais = new java.io.ByteArrayInputStream( objBytes ); + ois = new java.io.ObjectInputStream( bais ); + + obj = ois.readObject(); + } // end try + catch( java.io.IOException e ) + { + logger.error( Logger.SECURITY_FAILURE, "Problem reading object", e ); + obj = null; + } // end catch + catch( java.lang.ClassNotFoundException e ) + { + logger.error( Logger.SECURITY_FAILURE, "Problem reading object", e ); + obj = null; + } // end catch + finally + { + try{ bais.close(); } catch( Exception e ){} + try{ ois.close(); } catch( Exception e ){} + } // end finally + + return obj; + } // end decodeObject + + + + /** + * Convenience method for encoding data to a file. + * + * @param dataToEncode byte array of data to encode in base64 form + * @param filename Filename for saving encoded data + * @return true if successful, false otherwise + * + * @since 2.1 + */ + public static boolean encodeToFile( byte[] dataToEncode, String filename ) + { + boolean success = false; + Base64.OutputStream bos = null; + try + { + bos = new Base64.OutputStream( + new java.io.FileOutputStream( filename ), Base64.ENCODE ); + bos.write( dataToEncode ); + success = true; + } // end try + catch( java.io.IOException e ) + { + + success = false; + } // end catch: IOException + finally + { + try{ bos.close(); } catch( Exception e ){} + } // end finally + + return success; + } // end encodeToFile + + + /** + * Convenience method for decoding data to a file. + * + * @param dataToDecode Base64-encoded data as a string + * @param filename Filename for saving decoded data + * @return true if successful, false otherwise + * + * @since 2.1 + */ + public static boolean decodeToFile( String dataToDecode, String filename ) + { + boolean success = false; + Base64.OutputStream bos = null; + try + { + bos = new Base64.OutputStream( + new java.io.FileOutputStream( filename ), Base64.DECODE ); + bos.write( dataToDecode.getBytes( PREFERRED_ENCODING ) ); + success = true; + } // end try + catch( java.io.IOException e ) + { + success = false; + } // end catch: IOException + finally + { + try{ bos.close(); } catch( Exception e ){} + } // end finally + + return success; + } // end decodeToFile + + + + + /** + * Convenience method for reading a base64-encoded + * file and decoding it. + * + * @param filename Filename for reading encoded data + * @return decoded byte array or null if unsuccessful + * + * @since 2.1 + */ + public static byte[] decodeFromFile( String filename ) + { + byte[] decodedData = null; + Base64.InputStream bis = null; + try + { + // Set up some useful variables + java.io.File file = new java.io.File( filename ); + byte[] buffer = null; + int length = 0; + int numBytes = 0; + + // Check for size of file + if( file.length() > Integer.MAX_VALUE ) + { + logger.error( Logger.SECURITY_FAILURE, "File is too big for this convenience method (" + file.length() + " bytes)." ); + return null; + } // end if: file too big for int index + buffer = new byte[ (int)file.length() ]; + + // Open a stream + bis = new Base64.InputStream( + new java.io.BufferedInputStream( + new java.io.FileInputStream( file ) ), Base64.DECODE ); + + // Read until done + while( ( numBytes = bis.read( buffer, length, 4096 ) ) >= 0 ) + length += numBytes; + + // Save in a variable to return + decodedData = new byte[ length ]; + System.arraycopy( buffer, 0, decodedData, 0, length ); + + } // end try + catch( java.io.IOException e ) + { + logger.error( Logger.SECURITY_FAILURE, "Error decoding from file " + filename, e ); + } // end catch: IOException + finally + { + try{ if (bis != null ) bis.close(); } catch( Exception e) {} + } // end finally + + return decodedData; + } // end decodeFromFile + + + + /** + * Convenience method for reading a binary file + * and base64-encoding it. + * + * @param filename Filename for reading binary data + * @return base64-encoded string or null if unsuccessful + * + * @since 2.1 + */ + public static String encodeFromFile( String filename ) + { + String encodedData = null; + Base64.InputStream bis = null; + try + { + // Set up some useful variables + java.io.File file = new java.io.File( filename ); + byte[] buffer = new byte[ Math.max((int)(file.length() * 1.4),40) ]; // Need max() for math on small files (v2.2.1) + int length = 0; + int numBytes = 0; + + // Open a stream + bis = new Base64.InputStream( + new java.io.BufferedInputStream( + new java.io.FileInputStream( file ) ), Base64.ENCODE ); + + // Read until done + while( ( numBytes = bis.read( buffer, length, 4096 ) ) >= 0 ) + length += numBytes; + + // Save in a variable to return + encodedData = new String( buffer, 0, length, Base64.PREFERRED_ENCODING ); + + } // end try + catch( java.io.IOException e ) + { + logger.error( Logger.SECURITY_FAILURE, "Error encoding from file " + filename, e ); + } // end catch: IOException + finally + { + try{ bis.close(); } catch( Exception e) {} + } // end finally + + return encodedData; + } // end encodeFromFile + + + + + /** + * Reads infile and encodes it to outfile. + * + * @param infile Input file + * @param outfile Output file + * @return true if the operation is successful + * @since 2.2 + */ + public static boolean encodeFileToFile( String infile, String outfile ) + { + boolean success = false; + java.io.InputStream in = null; + java.io.OutputStream out = null; + try{ + in = new Base64.InputStream( + new java.io.BufferedInputStream( + new java.io.FileInputStream( infile ) ), + Base64.ENCODE ); + out = new java.io.BufferedOutputStream( new java.io.FileOutputStream( outfile ) ); + byte[] buffer = new byte[65536]; // 64K + int read = -1; + while( ( read = in.read(buffer) ) >= 0 ){ + out.write( buffer,0,read ); + } // end while: through file + success = true; + } catch( java.io.IOException exc ){ + logger.error( Logger.SECURITY_FAILURE, "Problem encoding file to file", exc ); + } finally{ + try{ in.close(); } catch( Exception exc ){} + try{ out.close(); } catch( Exception exc ){} + } // end finally + + return success; + } // end encodeFileToFile + + + + /** + * Reads infile and decodes it to outfile. + * + * @param infile Input file + * @param outfile Output file + * @return true if the operation is successful + * @since 2.2 + */ + public static boolean decodeFileToFile( String infile, String outfile ) + { + boolean success = false; + java.io.InputStream in = null; + java.io.OutputStream out = null; + try{ + in = new Base64.InputStream( + new java.io.BufferedInputStream( + new java.io.FileInputStream( infile ) ), + Base64.DECODE ); + out = new java.io.BufferedOutputStream( new java.io.FileOutputStream( outfile ) ); + byte[] buffer = new byte[65536]; // 64K + int read = -1; + while( ( read = in.read(buffer) ) >= 0 ){ + out.write( buffer,0,read ); + } // end while: through file + success = true; + } catch( java.io.IOException exc ){ + logger.error( Logger.SECURITY_FAILURE, "Problem decoding file to file", exc ); + } finally{ + try{ in.close(); } catch( Exception exc ){} + try{ out.close(); } catch( Exception exc ){} + } // end finally + + return success; + } // end decodeFileToFile + + + /* ******** I N N E R C L A S S I N P U T S T R E A M ******** */ + + + + /** + * A {@link Base64.InputStream} will read data from another + * java.io.InputStream, given in the constructor, + * and encode/decode to/from Base64 notation on the fly. + * + * @see Base64 + * @since 1.3 + */ + public static class InputStream extends java.io.FilterInputStream + { + private boolean encode; // Encoding or decoding + private int position; // Current position in the buffer + private byte[] buffer; // Small buffer holding converted data + private int bufferLength; // Length of buffer (3 or 4) + private int numSigBytes; // Number of meaningful bytes in the buffer + private int lineLength; + private boolean breakLines; // Break lines at less than 80 characters + private int options; // Record options used to create the stream. + private byte[] decodabet; // Local copies to avoid extra method calls + + + /** + * Constructs a {@link Base64.InputStream} in DECODE mode. + * + * @param in the java.io.InputStream from which to read data. + * @since 1.3 + */ + public InputStream( java.io.InputStream in ) + { + this( in, DECODE ); + } // end constructor + + + /** + * Constructs a {@link Base64.InputStream} in + * either ENCODE or DECODE mode. + *

    + * Valid options:

    +         *   ENCODE or DECODE: Encode or Decode as data is read.
+         *   DONT_BREAK_LINES: don't break lines at 76 characters
+         *     (only meaningful when encoding)
+         *     Note: Technically, this makes your encoding non-compliant.
+         *
    + *

    + * Example: new Base64.InputStream( in, Base64.DECODE ) + * + * + * @param in the java.io.InputStream from which to read data. + * @param options Specified options + * @see Base64#ENCODE + * @see Base64#DECODE + * @see Base64#DONT_BREAK_LINES + * @since 2.0 + */ + public InputStream( java.io.InputStream in, int options ) + { + super( in ); + this.breakLines = (options & DONT_BREAK_LINES) != DONT_BREAK_LINES; + this.encode = (options & ENCODE) == ENCODE; + this.bufferLength = encode ? 4 : 3; + this.buffer = new byte[ bufferLength ]; + this.position = -1; + this.lineLength = 0; + this.options = options; // Record for later, mostly to determine which alphabet to use + this.decodabet = getDecodabet(options); + } // end constructor + + /** + * Reads enough of the input stream to convert + * to/from Base64 and returns the next byte. + * + * @return next byte + * @throws java.io.IOException + * @since 1.3 + */ + public int read() throws java.io.IOException + { + // Do we need to get data? + if( position < 0 ) + { + if( encode ) + { + byte[] b3 = new byte[3]; + int numBinaryBytes = 0; + for( int i = 0; i < 3; i++ ) + { + try + { + int b = in.read(); + + // If end of stream, b is -1. + if( b >= 0 ) + { + b3[i] = (byte)b; + numBinaryBytes++; + } // end if: not end of stream + + } // end try: read + catch( java.io.IOException e ) + { + // Only a problem if we got no data at all. + if( i == 0 ) + throw e; + + } // end catch + } // end for: each needed input byte + + if( numBinaryBytes > 0 ) + { + encode3to4( b3, 0, numBinaryBytes, buffer, 0, options ); + position = 0; + numSigBytes = 4; + } // end if: got data + else + { + return -1; + } // end else + } // end if: encoding + + // Else decoding + else + { + byte[] b4 = new byte[4]; + int i = 0; + for( i = 0; i < 4; i++ ) + { + // Read four "meaningful" bytes: + int b = 0; + do{ b = in.read(); } + while( b >= 0 && decodabet[ b & 0x7f ] <= WHITE_SPACE_ENC ); + + if( b < 0 ) + break; // Reads a -1 if end of stream + + b4[i] = (byte)b; + } // end for: each needed input byte + + if( i == 4 ) + { + numSigBytes = decode4to3( b4, 0, buffer, 0, options ); + position = 0; + } // end if: got four characters + else if( i == 0 ){ + return -1; + } // end else if: also padded correctly + else + { + // Must have broken out from above. + throw new java.io.IOException( "Improperly padded Base64 input." ); + } // end + + } // end else: decode + } // end else: get data + + // Got data? + if( position >= 0 ) + { + // End of relevant data? + if( /*!encode &&*/ position >= numSigBytes ) + return -1; + + if( encode && breakLines && lineLength >= MAX_LINE_LENGTH ) + { + lineLength = 0; + return '\n'; + } // end if + else + { + lineLength++; // This isn't important when decoding + // but throwing an extra "if" seems + // just as wasteful. + + int b = buffer[ position++ ]; + + if( position >= bufferLength ) + position = -1; + + return b & 0xFF; // This is how you "cast" a byte that's + // intended to be unsigned. + } // end else + } // end if: position >= 0 + + // Else error + else + { + // When JDK1.4 is more accepted, use an assertion here. + throw new java.io.IOException( "Error in Base64 code reading stream." ); + } // end else + } // end read + + + /** + * Calls {@link #read()} repeatedly until the end of stream + * is reached or len bytes are read. + * Returns number of bytes read into array or -1 if + * end of stream is encountered. + * + * @param dest array to hold values + * @param off offset for array + * @param len max number of bytes to read into array + * @return bytes read into array or -1 if end of stream is encountered. + * @throws java.io.IOException + * @since 1.3 + */ + public int read( byte[] dest, int off, int len ) throws java.io.IOException + { + int i; + int b; + for( i = 0; i < len; i++ ) + { + b = read(); + + //if( b < 0 && i == 0 ) + // return -1; + + if( b >= 0 ) + dest[off + i] = (byte)b; + else if( i == 0 ) + return -1; + else + break; // Out of 'for' loop + } // end for: each byte read + return i; + } // end read + + } // end inner class InputStream + + + + + + + /* ******** I N N E R C L A S S O U T P U T S T R E A M ******** */ + + + + /** + * A {@link Base64.OutputStream} will write data to another + * java.io.OutputStream, given in the constructor, + * and encode/decode to/from Base64 notation on the fly. + * + * @see Base64 + * @since 1.3 + */ + public static class OutputStream extends java.io.FilterOutputStream + { + private boolean encode; + private int position; + private byte[] buffer; + private int bufferLength; + private int lineLength; + private boolean breakLines; + private byte[] b4; // Scratch used in a few places + private boolean suspendEncoding; + private int options; // Record for later + private byte[] decodabet; // Local copies to avoid extra method calls + + /** + * Constructs a {@link Base64.OutputStream} in ENCODE mode. + * + * @param out the java.io.OutputStream to which data will be written. + * @since 1.3 + */ + public OutputStream( java.io.OutputStream out ) + { + this( out, ENCODE ); + } // end constructor + + + /** + * Constructs a {@link Base64.OutputStream} in + * either ENCODE or DECODE mode. + *

    + * Valid options:

    +         *   ENCODE or DECODE: Encode or Decode as data is read.
+         *   DONT_BREAK_LINES: don't break lines at 76 characters
+         *     (only meaningful when encoding)
+         *     Note: Technically, this makes your encoding non-compliant.
+         *
    + *

    + * Example: new Base64.OutputStream( out, Base64.ENCODE ) + * + * @param out the java.io.OutputStream to which data will be written. + * @param options Specified options. + * @see Base64#ENCODE + * @see Base64#DECODE + * @see Base64#DONT_BREAK_LINES + * @since 1.3 + */ + public OutputStream( java.io.OutputStream out, int options ) + { + super( out ); + this.breakLines = (options & DONT_BREAK_LINES) != DONT_BREAK_LINES; + this.encode = (options & ENCODE) == ENCODE; + this.bufferLength = encode ? 3 : 4; + this.buffer = new byte[ bufferLength ]; + this.position = 0; + this.lineLength = 0; + this.suspendEncoding = false; + this.b4 = new byte[4]; + this.options = options; + this.decodabet = getDecodabet(options); + } // end constructor + + + /** + * Writes the byte to the output stream after + * converting to/from Base64 notation. + * When encoding, bytes are buffered three + * at a time before the output stream actually + * gets a write() call. + * When decoding, bytes are buffered four + * at a time. + * + * @param theByte the byte to write + * @throws java.io.IOException + * @since 1.3 + */ + public void write(int theByte) throws java.io.IOException + { + // Encoding suspended? + if( suspendEncoding ) + { + super.out.write( theByte ); + return; + } // end if: supsended + + // Encode? + if( encode ) + { + buffer[ position++ ] = (byte)theByte; + if( position >= bufferLength ) // Enough to encode. + { + out.write( encode3to4( b4, buffer, bufferLength, options ) ); + + lineLength += 4; + if( breakLines && lineLength >= MAX_LINE_LENGTH ) + { + out.write( NEW_LINE ); + lineLength = 0; + } // end if: end of line + + position = 0; + } // end if: enough to output + } // end if: encoding + + // Else, Decoding + else + { + // Meaningful Base64 character? + if( decodabet[ theByte & 0x7f ] > WHITE_SPACE_ENC ) + { + buffer[ position++ ] = (byte)theByte; + if( position >= bufferLength ) // Enough to output. + { + int len = Base64.decode4to3( buffer, 0, b4, 0, options ); + out.write( b4, 0, len ); + //out.write( Base64.decode4to3( buffer ) ); + position = 0; + } // end if: enough to output + } // end if: meaningful base64 character + else if( decodabet[ theByte & 0x7f ] != WHITE_SPACE_ENC ) + { + throw new java.io.IOException( "Invalid character in Base64 data." ); + } // end else: not white space either + } // end else: decoding + } // end write + + + + /** + * Calls {@link #write(int)} repeatedly until len + * bytes are written. + * + * @param theBytes array from which to read bytes + * @param off offset for array + * @param len max number of bytes to read into array + * @throws java.io.IOException + * @since 1.3 + */ + public void write( byte[] theBytes, int off, int len ) throws java.io.IOException + { + // Encoding suspended? + if( suspendEncoding ) + { + super.out.write( theBytes, off, len ); + return; + } // end if: supsended + + for( int i = 0; i < len; i++ ) + { + write( theBytes[ off + i ] ); + } // end for: each byte written + + } // end write + + + + /** + * Method added by PHIL. [Thanks, PHIL. -Rob] + * This pads the buffer without closing the stream. + * @throws java.io.IOException + */ + public void flushBase64() throws java.io.IOException + { + if( position > 0 ) + { + if( encode ) + { + out.write( encode3to4( b4, buffer, position, options ) ); + position = 0; + } // end if: encoding + else + { + throw new java.io.IOException( "Base64 input not properly padded." ); + } // end else: decoding + } // end if: buffer partially full + + } // end flush + + + /** + * Flushes and closes (I think, in the superclass) the stream. + * + * @throws java.io.IOException + * @since 1.3 + */ + public void close() throws java.io.IOException + { + // 1. Ensure that pending characters are written + flushBase64(); + + // 2. Actually close the stream + // Base class both flushes and closes. + super.close(); + + buffer = null; + out = null; + } // end close + + + + /** + * Suspends encoding of the stream. + * May be helpful if you need to embed a piece of + * base640-encoded data in a stream. + * + * @throws java.io.IOException + * @since 1.5.1 + */ + public void suspendEncoding() throws java.io.IOException + { + flushBase64(); + this.suspendEncoding = true; + } // end suspendEncoding + + + /** + * Resumes encoding of the stream. + * May be helpful if you need to embed a piece of + * base640-encoded data in a stream. + * + * @since 1.5.1 + */ + public void resumeEncoding() + { + this.suspendEncoding = false; + } // end resumeEncoding + + + + } // end inner class OutputStream + + +} // end class Base64 From 9bb8d205a0c28ece62a045dae24fd93d29d75585 Mon Sep 17 00:00:00 2001 From: kwwall Date: Mon, 18 Jan 2016 23:33:47 -0500 Subject: [PATCH 092/812] Change CRLF to LF for issue 356. --- .../java/org/owasp/esapi/codecs/Codec.java | 318 +++++++++--------- 1 file changed, 159 insertions(+), 159 deletions(-) diff --git a/src/main/java/org/owasp/esapi/codecs/Codec.java b/src/main/java/org/owasp/esapi/codecs/Codec.java index 8e5fac8a3..ec02a806a 100644 --- a/src/main/java/org/owasp/esapi/codecs/Codec.java +++ b/src/main/java/org/owasp/esapi/codecs/Codec.java @@ -1,159 +1,159 @@ -/** - * OWASP Enterprise Security API (ESAPI) - * - * This file is part of the Open Web Application Security Project (OWASP) - * Enterprise Security API (ESAPI) project. For details, please see - * http://www.owasp.org/index.php/ESAPI. - * - * Copyright (c) 2007 - The OWASP Foundation - * - * The ESAPI is published by OWASP under the BSD license. You should read and accept the - * LICENSE before you use, modify, and/or redistribute this software. - * - * @author Jeff Williams Aspect Security - * @created 2007 - */ -package org.owasp.esapi.codecs; - - -/** - * The Codec interface defines a set of methods for encoding and decoding application level encoding schemes, - * such as HTML entity encoding and percent encoding (aka URL encoding). Codecs are used in output encoding - * and canonicalization. The design of these codecs allows for character-by-character decoding, which is - * necessary to detect double-encoding and the use of multiple encoding schemes, both of which are techniques - * used by attackers to bypass validation and bury encoded attacks in data. - * - * @author Jeff Williams (jeff.williams .at. aspectsecurity.com) Aspect Security - * @since June 1, 2007 - * @see org.owasp.esapi.Encoder - */ -public abstract class Codec { - - /** - * Initialize an array to mark which characters are to be encoded. Store the hex - * string for that character to save time later. If the character shouldn't be - * encoded, then store null. - */ - private static final String[] hex = new String[256]; - - static { - for ( char c = 0; c < 0xFF; c++ ) { - if ( c >= 0x30 && c <= 0x39 || c >= 0x41 && c <= 0x5A || c >= 0x61 && c <= 0x7A ) { - hex[c] = null; - } else { - hex[c] = toHex(c).intern(); - } - } - } - - - /** - * Default constructor - */ - public Codec() { - } - - /** - * Encode a String so that it can be safely used in a specific context. - * - * @param immune - * @param input - * the String to encode - * @return the encoded String - */ - public String encode(char[] immune, String input) { - StringBuilder sb = new StringBuilder(); - for (int i = 0; i < input.length(); i++) { - char c = input.charAt(i); - sb.append(encodeCharacter(immune, c)); - } - return sb.toString(); - } - - /** - * Default implementation that should be overridden in specific codecs. - * - * @param immune - * @param c - * the Character to encode - * @return - * the encoded Character - */ - public String encodeCharacter( char[] immune, Character c ) { - return ""+c; - } - - /** - * Decode a String that was encoded using the encode method in this Class - * - * @param input - * the String to decode - * @return - * the decoded String - */ - public String decode(String input) { - StringBuilder sb = new StringBuilder(); - PushbackString pbs = new PushbackString(input); - while (pbs.hasNext()) { - Character c = decodeCharacter(pbs); - if (c != null) { - sb.append(c); - } else { - sb.append(pbs.next()); - } - } - return sb.toString(); - } - - /** - * Returns the decoded version of the next character from the input string and advances the - * current character in the PushbackString. If the current character is not encoded, this - * method MUST reset the PushbackString. - * - * @param input the Character to decode - * - * @return the decoded Character - */ - public Character decodeCharacter( PushbackString input ) { - return input.next(); - } - - /** - * Lookup the hex value of any character that is not alphanumeric. - * @param c The character to lookup. - * @return, return null if alphanumeric or the character code - * in hex. - */ - public static String getHexForNonAlphanumeric(char c) - { - if(c<0xFF) - return hex[c]; - return toHex(c); - } - - public static String toOctal(char c) - { - return Integer.toOctalString(c); - } - - public static String toHex(char c) - { - return Integer.toHexString(c); - } - - /** - * Utility to search a char[] for a specific char. - * - * @param c - * @param array - * @return - */ - public static boolean containsCharacter( char c, char[] array ) { - for (char ch : array) { - if (c == ch) return true; - } - return false; - } - -} +/** + * OWASP Enterprise Security API (ESAPI) + * + * This file is part of the Open Web Application Security Project (OWASP) + * Enterprise Security API (ESAPI) project. For details, please see + * http://www.owasp.org/index.php/ESAPI. + * + * Copyright (c) 2007 - The OWASP Foundation + * + * The ESAPI is published by OWASP under the BSD license. You should read and accept the + * LICENSE before you use, modify, and/or redistribute this software. + * + * @author Jeff Williams Aspect Security + * @created 2007 + */ +package org.owasp.esapi.codecs; + + +/** + * The Codec interface defines a set of methods for encoding and decoding application level encoding schemes, + * such as HTML entity encoding and percent encoding (aka URL encoding). Codecs are used in output encoding + * and canonicalization. The design of these codecs allows for character-by-character decoding, which is + * necessary to detect double-encoding and the use of multiple encoding schemes, both of which are techniques + * used by attackers to bypass validation and bury encoded attacks in data. + * + * @author Jeff Williams (jeff.williams .at. aspectsecurity.com) Aspect Security + * @since June 1, 2007 + * @see org.owasp.esapi.Encoder + */ +public abstract class Codec { + + /** + * Initialize an array to mark which characters are to be encoded. Store the hex + * string for that character to save time later. If the character shouldn't be + * encoded, then store null. + */ + private static final String[] hex = new String[256]; + + static { + for ( char c = 0; c < 0xFF; c++ ) { + if ( c >= 0x30 && c <= 0x39 || c >= 0x41 && c <= 0x5A || c >= 0x61 && c <= 0x7A ) { + hex[c] = null; + } else { + hex[c] = toHex(c).intern(); + } + } + } + + + /** + * Default constructor + */ + public Codec() { + } + + /** + * Encode a String so that it can be safely used in a specific context. + * + * @param immune + * @param input + * the String to encode + * @return the encoded String + */ + public String encode(char[] immune, String input) { + StringBuilder sb = new StringBuilder(); + for (int i = 0; i < input.length(); i++) { + char c = input.charAt(i); + sb.append(encodeCharacter(immune, c)); + } + return sb.toString(); + } + + /** + * Default implementation that should be overridden in specific codecs. + * + * @param immune + * @param c + * the Character to encode + * @return + * the encoded Character + */ + public String encodeCharacter( char[] immune, Character c ) { + return ""+c; + } + + /** + * Decode a String that was encoded using the encode method in this Class + * + * @param input + * the String to decode + * @return + * the decoded String + */ + public String decode(String input) { + StringBuilder sb = new StringBuilder(); + PushbackString pbs = new PushbackString(input); + while (pbs.hasNext()) { + Character c = decodeCharacter(pbs); + if (c != null) { + sb.append(c); + } else { + sb.append(pbs.next()); + } + } + return sb.toString(); + } + + /** + * Returns the decoded version of the next character from the input string and advances the + * current character in the PushbackString. If the current character is not encoded, this + * method MUST reset the PushbackString. + * + * @param input the Character to decode + * + * @return the decoded Character + */ + public Character decodeCharacter( PushbackString input ) { + return input.next(); + } + + /** + * Lookup the hex value of any character that is not alphanumeric. + * @param c The character to lookup. + * @return, return null if alphanumeric or the character code + * in hex. + */ + public static String getHexForNonAlphanumeric(char c) + { + if(c<0xFF) + return hex[c]; + return toHex(c); + } + + public static String toOctal(char c) + { + return Integer.toOctalString(c); + } + + public static String toHex(char c) + { + return Integer.toHexString(c); + } + + /** + * Utility to search a char[] for a specific char. + * + * @param c + * @param array + * @return + */ + public static boolean containsCharacter( char c, char[] array ) { + for (char ch : array) { + if (c == ch) return true; + } + return false; + } + +} From 53d1d2c32d75745f319eff01a86b6ac09d5c9f2f Mon Sep 17 00:00:00 2001 From: kwwall Date: Mon, 18 Jan 2016 23:33:47 -0500 Subject: [PATCH 093/812] Change CRLF to LF for issue 356. --- .../java/org/owasp/esapi/codecs/CSSCodec.java | 362 +++++++++--------- 1 file changed, 181 insertions(+), 181 deletions(-) diff --git a/src/main/java/org/owasp/esapi/codecs/CSSCodec.java b/src/main/java/org/owasp/esapi/codecs/CSSCodec.java index 9e5d0af19..cee77ccaf 100644 --- a/src/main/java/org/owasp/esapi/codecs/CSSCodec.java +++ b/src/main/java/org/owasp/esapi/codecs/CSSCodec.java @@ -1,181 +1,181 @@ -/** - * OWASP Enterprise Security API (ESAPI) - * - * This file is part of the Open Web Application Security Project (OWASP) Enterprise Security API - * (ESAPI) project. For details, please see http://www.owasp.org/index.php/ESAPI. - * - * Copyright (c) 2007 - The OWASP Foundation - * - * The ESAPI is published by OWASP under the BSD license. You should read and accept the LICENSE - * before you use, modify, and/or redistribute this software. - * - * @author Jeff Williams Aspect Security - * @created 2007 - */ -package org.owasp.esapi.codecs; - -/** - * Implementation of the Codec interface for backslash encoding used in CSS. - * - * @author Jeff Williams (jeff.williams .at. aspectsecurity.com) Aspect Security - * @since June 1, 2007 - * @see org.owasp.esapi.Encoder - */ -public class CSSCodec extends Codec -{ - private static final Character REPLACEMENT = '\ufffd'; - - - /** - * {@inheritDoc} - * - * Returns backslash encoded character. - * - * @param immune - */ - public String encodeCharacter(char[] immune, Character c) { - // check for immune characters - if ( containsCharacter(c, immune ) ) { - return ""+c; - } - - // check for alphanumeric characters - String hex = Codec.getHexForNonAlphanumeric(c); - if ( hex == null ) { - return ""+c; - } - - // return the hex and end in whitespace to terminate - return "\\" + hex + " "; - } - - - /** - * {@inheritDoc} - * - * Returns the decoded version of the character starting at index, - * or null if no decoding is possible. - */ - public Character decodeCharacter(PushbackString input) - { - input.mark(); - Character first = input.next(); - if (first == null || first != '\\') - { - input.reset(); - return null; - } - - Character second = input.next(); - if (second == null) { - input.reset(); - return null; - } - - /* From css 2.1 spec: - * http://www.w3.org/TR/CSS21/syndata.html#characters - * - * First, inside a string, a backslash followed by a - * newline is ignored (i.e., the string is deemed not - * to contain either the backslash or the newline). - * - * Second, it cancels the meaning of special CSS - * characters. Except within CSS comments, any character - * (except a hexadecimal digit, linefeed, carriage return, - * or form feed) can be escaped with a backslash to - * remove its special meaning. For example, "\"" is a string - * consisting of one double quote. Style sheet - * preprocessors must not remove these backslashes - * from a style sheet since that would change the style - * sheet's meaning. - * - * Third, backslash escapes allow authors to refer to - * characters they cannot easily put in a document. In - * this case, the backslash is followed by at most six - * hexadecimal digits (0..9A..F), which stand for the ISO - * 10646 ([ISO10646]) character with that number, which - * must not be zero. (It is undefined in CSS 2.1 what - * happens if a style sheet does contain a character with - * Unicode codepoint zero.) If a character in the range - * [0-9a-fA-F] follows the hexadecimal number, the end - * of the number needs to be made clear. There are two - * ways to do that: - * - * 1. with a space (or other white space character): - * "\26 B" ("&B"). In this case, user agents should - * treat a "CR/LF" pair (U+000D/U+000A) as a single - * white space character. - * - * 2. by providing exactly 6 hexadecimal digits: - * "\000026B" ("&B") - * - * In fact, these two methods may be combined. Only one - * white space character is ignored after a hexadecimal - * escape. Note that this means that a "real" space - * after the escape sequence must itself either be - * escaped or doubled. - * - * If the number is outside the range allowed by Unicode - * (e.g., "\110000" is above the maximum 10FFFF allowed in - * current Unicode), the UA may replace the escape with - * the "replacement character" (U+FFFD). If the character - * is to be displayed, the UA should show a visible - * symbol, such as a "missing character" glyph (cf. 15.2, - * point 5). - */ - - switch(second) - { // special whitespace cases. I assume they mean - // for all of these to qualify as a "new - // line." Otherwise there is no specification - // of what to do for \f - case '\r': - if(input.peek('\n')) - input.next(); - // fall through - case '\n': - case '\f': - // bs follwed by new line replaced by nothing - case '\u0000': // skip NUL for now too - return decodeCharacter(input); - } - - if (!PushbackString.isHexDigit(second)) - { // non hex digit - return second; - } - - // Search for up to 6 hex digits following until a space - StringBuilder sb = new StringBuilder(); - sb.append(second); - for (int i = 0; i < 5; i++) - { - Character c = input.next(); - if(c == null || Character.isWhitespace(c)) - break; - if(PushbackString.isHexDigit(c)) - sb.append(c); - else - { - input.pushback(c); - break; - } - } - try - { - // parse the hex digit and create a character - int i = Integer.parseInt(sb.toString(), 16); - - if (Character.isValidCodePoint(i)) - return (char)i; - return REPLACEMENT; - } - catch (NumberFormatException e) - { - throw new IllegalStateException("Received a NumberFormateException parsing a string verified to be hex", e); - } - } - -} +/** + * OWASP Enterprise Security API (ESAPI) + * + * This file is part of the Open Web Application Security Project (OWASP) Enterprise Security API + * (ESAPI) project. For details, please see http://www.owasp.org/index.php/ESAPI. + * + * Copyright (c) 2007 - The OWASP Foundation + * + * The ESAPI is published by OWASP under the BSD license. You should read and accept the LICENSE + * before you use, modify, and/or redistribute this software. + * + * @author Jeff Williams Aspect Security + * @created 2007 + */ +package org.owasp.esapi.codecs; + +/** + * Implementation of the Codec interface for backslash encoding used in CSS. + * + * @author Jeff Williams (jeff.williams .at. aspectsecurity.com) Aspect Security + * @since June 1, 2007 + * @see org.owasp.esapi.Encoder + */ +public class CSSCodec extends Codec +{ + private static final Character REPLACEMENT = '\ufffd'; + + + /** + * {@inheritDoc} + * + * Returns backslash encoded character. + * + * @param immune + */ + public String encodeCharacter(char[] immune, Character c) { + // check for immune characters + if ( containsCharacter(c, immune ) ) { + return ""+c; + } + + // check for alphanumeric characters + String hex = Codec.getHexForNonAlphanumeric(c); + if ( hex == null ) { + return ""+c; + } + + // return the hex and end in whitespace to terminate + return "\\" + hex + " "; + } + + + /** + * {@inheritDoc} + * + * Returns the decoded version of the character starting at index, + * or null if no decoding is possible. + */ + public Character decodeCharacter(PushbackString input) + { + input.mark(); + Character first = input.next(); + if (first == null || first != '\\') + { + input.reset(); + return null; + } + + Character second = input.next(); + if (second == null) { + input.reset(); + return null; + } + + /* From css 2.1 spec: + * http://www.w3.org/TR/CSS21/syndata.html#characters + * + * First, inside a string, a backslash followed by a + * newline is ignored (i.e., the string is deemed not + * to contain either the backslash or the newline). + * + * Second, it cancels the meaning of special CSS + * characters. Except within CSS comments, any character + * (except a hexadecimal digit, linefeed, carriage return, + * or form feed) can be escaped with a backslash to + * remove its special meaning. For example, "\"" is a string + * consisting of one double quote. Style sheet + * preprocessors must not remove these backslashes + * from a style sheet since that would change the style + * sheet's meaning. + * + * Third, backslash escapes allow authors to refer to + * characters they cannot easily put in a document. In + * this case, the backslash is followed by at most six + * hexadecimal digits (0..9A..F), which stand for the ISO + * 10646 ([ISO10646]) character with that number, which + * must not be zero. (It is undefined in CSS 2.1 what + * happens if a style sheet does contain a character with + * Unicode codepoint zero.) If a character in the range + * [0-9a-fA-F] follows the hexadecimal number, the end + * of the number needs to be made clear. There are two + * ways to do that: + * + * 1. with a space (or other white space character): + * "\26 B" ("&B"). In this case, user agents should + * treat a "CR/LF" pair (U+000D/U+000A) as a single + * white space character. + * + * 2. by providing exactly 6 hexadecimal digits: + * "\000026B" ("&B") + * + * In fact, these two methods may be combined. Only one + * white space character is ignored after a hexadecimal + * escape. Note that this means that a "real" space + * after the escape sequence must itself either be + * escaped or doubled. + * + * If the number is outside the range allowed by Unicode + * (e.g., "\110000" is above the maximum 10FFFF allowed in + * current Unicode), the UA may replace the escape with + * the "replacement character" (U+FFFD). If the character + * is to be displayed, the UA should show a visible + * symbol, such as a "missing character" glyph (cf. 15.2, + * point 5). + */ + + switch(second) + { // special whitespace cases. I assume they mean + // for all of these to qualify as a "new + // line." Otherwise there is no specification + // of what to do for \f + case '\r': + if(input.peek('\n')) + input.next(); + // fall through + case '\n': + case '\f': + // bs follwed by new line replaced by nothing + case '\u0000': // skip NUL for now too + return decodeCharacter(input); + } + + if (!PushbackString.isHexDigit(second)) + { // non hex digit + return second; + } + + // Search for up to 6 hex digits following until a space + StringBuilder sb = new StringBuilder(); + sb.append(second); + for (int i = 0; i < 5; i++) + { + Character c = input.next(); + if(c == null || Character.isWhitespace(c)) + break; + if(PushbackString.isHexDigit(c)) + sb.append(c); + else + { + input.pushback(c); + break; + } + } + try + { + // parse the hex digit and create a character + int i = Integer.parseInt(sb.toString(), 16); + + if (Character.isValidCodePoint(i)) + return (char)i; + return REPLACEMENT; + } + catch (NumberFormatException e) + { + throw new IllegalStateException("Received a NumberFormateException parsing a string verified to be hex", e); + } + } + +} From 4a984b0e7fca75fb0667fc03c16f11a193a53872 Mon Sep 17 00:00:00 2001 From: kwwall Date: Mon, 18 Jan 2016 23:33:47 -0500 Subject: [PATCH 094/812] Change CRLF to LF for issue 356. --- .../java/org/owasp/esapi/codecs/DB2Codec.java | 134 +++++++++--------- 1 file changed, 67 insertions(+), 67 deletions(-) diff --git a/src/main/java/org/owasp/esapi/codecs/DB2Codec.java b/src/main/java/org/owasp/esapi/codecs/DB2Codec.java index a99818c27..4ff63ea1a 100644 --- a/src/main/java/org/owasp/esapi/codecs/DB2Codec.java +++ b/src/main/java/org/owasp/esapi/codecs/DB2Codec.java @@ -1,68 +1,68 @@ -/** - * OWASP Enterprise Security API (ESAPI) - * - * This file is part of the Open Web Application Security Project (OWASP) - * Enterprise Security API (ESAPI) project. For details, please see - * http://www.owasp.org/index.php/ESAPI. - * - * Copyright (c) 2007 - The OWASP Foundation - * - * The ESAPI is published by OWASP under the BSD license. You should read and accept the - * LICENSE before you use, modify, and/or redistribute this software. - */ -package org.owasp.esapi.codecs; - - -/** - * Implementation of the Codec interface for DB2 strings. This function will only protect you from SQLi in limited situations. - * - * @author Sivasankar Tanakala (stanakal@TRS.NYC.NY.US) - * @since October 26, 2010 - * @see org.owasp.esapi.Encoder - */ -public class DB2Codec extends Codec { - - public String encodeCharacter(char[] immune, Character c) { - - if (c.charValue() == '\'') - return "\'\'"; - - if (c.charValue() == ';') - return "."; - - return "" + c; - } - - public Character decodeCharacter(PushbackString input) { - - input.mark(); - Character first = input.next(); - - if (first == null) { - input.reset(); - return null; - } - - // if this is not an encoded character, return null - - if (first.charValue() != '\'') { - input.reset(); - return null; - } - - Character second = input.next(); - - if (second == null) { - input.reset(); - return null; - } - - // if this is not an encoded character, return null - if (second.charValue() != '\'') { - input.reset(); - return null; - } - - return (Character.valueOf('\'')); - } +/** + * OWASP Enterprise Security API (ESAPI) + * + * This file is part of the Open Web Application Security Project (OWASP) + * Enterprise Security API (ESAPI) project. For details, please see + * http://www.owasp.org/index.php/ESAPI. + * + * Copyright (c) 2007 - The OWASP Foundation + * + * The ESAPI is published by OWASP under the BSD license. You should read and accept the + * LICENSE before you use, modify, and/or redistribute this software. + */ +package org.owasp.esapi.codecs; + + +/** + * Implementation of the Codec interface for DB2 strings. This function will only protect you from SQLi in limited situations. + * + * @author Sivasankar Tanakala (stanakal@TRS.NYC.NY.US) + * @since October 26, 2010 + * @see org.owasp.esapi.Encoder + */ +public class DB2Codec extends Codec { + + public String encodeCharacter(char[] immune, Character c) { + + if (c.charValue() == '\'') + return "\'\'"; + + if (c.charValue() == ';') + return "."; + + return "" + c; + } + + public Character decodeCharacter(PushbackString input) { + + input.mark(); + Character first = input.next(); + + if (first == null) { + input.reset(); + return null; + } + + // if this is not an encoded character, return null + + if (first.charValue() != '\'') { + input.reset(); + return null; + } + + Character second = input.next(); + + if (second == null) { + input.reset(); + return null; + } + + // if this is not an encoded character, return null + if (second.charValue() != '\'') { + input.reset(); + return null; + } + + return (Character.valueOf('\'')); + } } \ No newline at end of file From 68db04bb6e323f3597e196e18e4b9909c60f8efd Mon Sep 17 00:00:00 2001 From: kwwall Date: Mon, 18 Jan 2016 23:33:47 -0500 Subject: [PATCH 095/812] Change CRLF to LF for issue 356. --- .../owasp/esapi/codecs/HTMLEntityCodec.java | 1100 ++++++++--------- 1 file changed, 550 insertions(+), 550 deletions(-) diff --git a/src/main/java/org/owasp/esapi/codecs/HTMLEntityCodec.java b/src/main/java/org/owasp/esapi/codecs/HTMLEntityCodec.java index 36d5876a9..b4337968a 100644 --- a/src/main/java/org/owasp/esapi/codecs/HTMLEntityCodec.java +++ b/src/main/java/org/owasp/esapi/codecs/HTMLEntityCodec.java @@ -1,550 +1,550 @@ -/** - * OWASP Enterprise Security API (ESAPI) - * - * This file is part of the Open Web Application Security Project (OWASP) - * Enterprise Security API (ESAPI) project. For details, please see - * http://www.owasp.org/index.php/ESAPI. - * - * Copyright (c) 2007 - The OWASP Foundation - * - * The ESAPI is published by OWASP under the BSD license. You should read and accept the - * LICENSE before you use, modify, and/or redistribute this software. - * - * @author Jeff Williams Aspect Security - * @created 2007 - */ -package org.owasp.esapi.codecs; - -import java.util.HashMap; -import java.util.Collections; -import java.util.Map; - -/** - * Implementation of the Codec interface for HTML entity encoding. - * - * @author Jeff Williams (jeff.williams .at. aspectsecurity.com) Aspect Security - * @since June 1, 2007 - * @see org.owasp.esapi.Encoder - */ -public class HTMLEntityCodec extends Codec -{ - private static final char REPLACEMENT_CHAR = '\ufffd'; - private static final String REPLACEMENT_HEX = "fffd"; - private static final String REPLACEMENT_STR = "" + REPLACEMENT_CHAR; - private static final Map characterToEntityMap = mkCharacterToEntityMap(); - - private static final Trie entityToCharacterTrie = mkEntityToCharacterTrie(); - - /** - * - */ - public HTMLEntityCodec() { - } - - /** - * {@inheritDoc} - * - * Encodes a Character for safe use in an HTML entity field. - * @param immune - */ - public String encodeCharacter( char[] immune, Character c ) { - - // check for immune characters - if ( containsCharacter(c, immune ) ) { - return ""+c; - } - - // check for alphanumeric characters - String hex = Codec.getHexForNonAlphanumeric(c); - if ( hex == null ) { - return ""+c; - } - - // check for illegal characters - if ( ( c <= 0x1f && c != '\t' && c != '\n' && c != '\r' ) || ( c >= 0x7f && c <= 0x9f ) ) - { - hex = REPLACEMENT_HEX; // Let's entity encode this instead of returning it - c = REPLACEMENT_CHAR; - } - - // check if there's a defined entity - String entityName = (String) characterToEntityMap.get(c); - if (entityName != null) { - return "&" + entityName + ";"; - } - - // return the hex entity as suggested in the spec - return "&#x" + hex + ";"; - } - - /** - * {@inheritDoc} - * - * Returns the decoded version of the character starting at index, or - * null if no decoding is possible. - * - * Formats all are legal both with and without semi-colon, upper/lower case: - * &#dddd; - * &#xhhhh; - * &name; - */ - public Character decodeCharacter( PushbackString input ) { - input.mark(); - Character first = input.next(); - if ( first == null ) { - input.reset(); - return null; - } - - // if this is not an encoded character, return null - if (first != '&' ) { - input.reset(); - return null; - } - - // test for numeric encodings - Character second = input.next(); - if ( second == null ) { - input.reset(); - return null; - } - - if (second == '#' ) { - // handle numbers - Character c = getNumericEntity( input ); - if ( c != null ) return c; - } else if ( Character.isLetter( second.charValue() ) ) { - // handle entities - input.pushback( second ); - Character c = getNamedEntity( input ); - if ( c != null ) return c; - } - input.reset(); - return null; - } - - /** - * getNumericEntry checks input to see if it is a numeric entity - * - * @param input - * The input to test for being a numeric entity - * - * @return - * null if input is null, the character of input after decoding - */ - private Character getNumericEntity( PushbackString input ) { - Character first = input.peek(); - if ( first == null ) return null; - - if (first == 'x' || first == 'X' ) { - input.next(); - return parseHex( input ); - } - return parseNumber( input ); - } - - /** - * Parse a decimal number, such as those from JavaScript's String.fromCharCode(value) - * - * @param input - * decimal encoded string, such as 65 - * @return - * character representation of this decimal value, e.g. A - * @throws NumberFormatException - */ - private Character parseNumber( PushbackString input ) { - StringBuilder sb = new StringBuilder(); - while( input.hasNext() ) { - Character c = input.peek(); - - // if character is a digit then add it on and keep going - if ( Character.isDigit( c.charValue() ) ) { - sb.append( c ); - input.next(); - - // if character is a semi-colon, eat it and quit - } else if (c == ';' ) { - input.next(); - break; - - // otherwise just quit - } else { - break; - } - } - try { - int i = Integer.parseInt(sb.toString()); - if (Character.isValidCodePoint(i)) { - return (char) i; - } - } catch( NumberFormatException e ) { - // throw an exception for malformed entity? - } - return null; - } - - /** - * Parse a hex encoded entity - * - * @param input - * Hex encoded input (such as 437ae;) - * @return - * A single character from the string - * @throws NumberFormatException - */ - private Character parseHex( PushbackString input ) { - StringBuilder sb = new StringBuilder(); - while( input.hasNext() ) { - Character c = input.peek(); - - // if character is a hex digit then add it on and keep going - if ( "0123456789ABCDEFabcdef".indexOf(c) != -1 ) { - sb.append( c ); - input.next(); - - // if character is a semi-colon, eat it and quit - } else if (c == ';' ) { - input.next(); - break; - - // otherwise just quit - } else { - break; - } - } - try { - int i = Integer.parseInt(sb.toString(), 16); - if (Character.isValidCodePoint(i)) { - return (char) i; - } - } catch( NumberFormatException e ) { - // throw an exception for malformed entity? - } - return null; - } - - /** - * - * Returns the decoded version of the character starting at index, or - * null if no decoding is possible. - * - * Formats all are legal both with and without semi-colon, upper/lower case: - * &aa; - * &aaa; - * &aaaa; - * &aaaaa; - * &aaaaaa; - * &aaaaaaa; - * - * @param input - * A string containing a named entity like " - * @return - * Returns the decoded version of the character starting at index, or null if no decoding is possible. - */ - private Character getNamedEntity( PushbackString input ) { - StringBuilder possible = new StringBuilder(); - Map.Entry entry; - int len; - - // kludge around PushbackString.... - len = Math.min(input.remainder().length(), entityToCharacterTrie.getMaxKeyLength()); - for(int i=0;i mkCharacterToEntityMap() - { - Map map = new HashMap(252); - - map.put((char)34, "quot"); /* quotation mark */ - map.put((char)38, "amp"); /* ampersand */ - map.put((char)60, "lt"); /* less-than sign */ - map.put((char)62, "gt"); /* greater-than sign */ - map.put((char)160, "nbsp"); /* no-break space */ - map.put((char)161, "iexcl"); /* inverted exclamation mark */ - map.put((char)162, "cent"); /* cent sign */ - map.put((char)163, "pound"); /* pound sign */ - map.put((char)164, "curren"); /* currency sign */ - map.put((char)165, "yen"); /* yen sign */ - map.put((char)166, "brvbar"); /* broken bar */ - map.put((char)167, "sect"); /* section sign */ - map.put((char)168, "uml"); /* diaeresis */ - map.put((char)169, "copy"); /* copyright sign */ - map.put((char)170, "ordf"); /* feminine ordinal indicator */ - map.put((char)171, "laquo"); /* left-pointing double angle quotation mark */ - map.put((char)172, "not"); /* not sign */ - map.put((char)173, "shy"); /* soft hyphen */ - map.put((char)174, "reg"); /* registered sign */ - map.put((char)175, "macr"); /* macron */ - map.put((char)176, "deg"); /* degree sign */ - map.put((char)177, "plusmn"); /* plus-minus sign */ - map.put((char)178, "sup2"); /* superscript two */ - map.put((char)179, "sup3"); /* superscript three */ - map.put((char)180, "acute"); /* acute accent */ - map.put((char)181, "micro"); /* micro sign */ - map.put((char)182, "para"); /* pilcrow sign */ - map.put((char)183, "middot"); /* middle dot */ - map.put((char)184, "cedil"); /* cedilla */ - map.put((char)185, "sup1"); /* superscript one */ - map.put((char)186, "ordm"); /* masculine ordinal indicator */ - map.put((char)187, "raquo"); /* right-pointing double angle quotation mark */ - map.put((char)188, "frac14"); /* vulgar fraction one quarter */ - map.put((char)189, "frac12"); /* vulgar fraction one half */ - map.put((char)190, "frac34"); /* vulgar fraction three quarters */ - map.put((char)191, "iquest"); /* inverted question mark */ - map.put((char)192, "Agrave"); /* Latin capital letter a with grave */ - map.put((char)193, "Aacute"); /* Latin capital letter a with acute */ - map.put((char)194, "Acirc"); /* Latin capital letter a with circumflex */ - map.put((char)195, "Atilde"); /* Latin capital letter a with tilde */ - map.put((char)196, "Auml"); /* Latin capital letter a with diaeresis */ - map.put((char)197, "Aring"); /* Latin capital letter a with ring above */ - map.put((char)198, "AElig"); /* Latin capital letter ae */ - map.put((char)199, "Ccedil"); /* Latin capital letter c with cedilla */ - map.put((char)200, "Egrave"); /* Latin capital letter e with grave */ - map.put((char)201, "Eacute"); /* Latin capital letter e with acute */ - map.put((char)202, "Ecirc"); /* Latin capital letter e with circumflex */ - map.put((char)203, "Euml"); /* Latin capital letter e with diaeresis */ - map.put((char)204, "Igrave"); /* Latin capital letter i with grave */ - map.put((char)205, "Iacute"); /* Latin capital letter i with acute */ - map.put((char)206, "Icirc"); /* Latin capital letter i with circumflex */ - map.put((char)207, "Iuml"); /* Latin capital letter i with diaeresis */ - map.put((char)208, "ETH"); /* Latin capital letter eth */ - map.put((char)209, "Ntilde"); /* Latin capital letter n with tilde */ - map.put((char)210, "Ograve"); /* Latin capital letter o with grave */ - map.put((char)211, "Oacute"); /* Latin capital letter o with acute */ - map.put((char)212, "Ocirc"); /* Latin capital letter o with circumflex */ - map.put((char)213, "Otilde"); /* Latin capital letter o with tilde */ - map.put((char)214, "Ouml"); /* Latin capital letter o with diaeresis */ - map.put((char)215, "times"); /* multiplication sign */ - map.put((char)216, "Oslash"); /* Latin capital letter o with stroke */ - map.put((char)217, "Ugrave"); /* Latin capital letter u with grave */ - map.put((char)218, "Uacute"); /* Latin capital letter u with acute */ - map.put((char)219, "Ucirc"); /* Latin capital letter u with circumflex */ - map.put((char)220, "Uuml"); /* Latin capital letter u with diaeresis */ - map.put((char)221, "Yacute"); /* Latin capital letter y with acute */ - map.put((char)222, "THORN"); /* Latin capital letter thorn */ - map.put((char)223, "szlig"); /* Latin small letter sharp sXCOMMAX German Eszett */ - map.put((char)224, "agrave"); /* Latin small letter a with grave */ - map.put((char)225, "aacute"); /* Latin small letter a with acute */ - map.put((char)226, "acirc"); /* Latin small letter a with circumflex */ - map.put((char)227, "atilde"); /* Latin small letter a with tilde */ - map.put((char)228, "auml"); /* Latin small letter a with diaeresis */ - map.put((char)229, "aring"); /* Latin small letter a with ring above */ - map.put((char)230, "aelig"); /* Latin lowercase ligature ae */ - map.put((char)231, "ccedil"); /* Latin small letter c with cedilla */ - map.put((char)232, "egrave"); /* Latin small letter e with grave */ - map.put((char)233, "eacute"); /* Latin small letter e with acute */ - map.put((char)234, "ecirc"); /* Latin small letter e with circumflex */ - map.put((char)235, "euml"); /* Latin small letter e with diaeresis */ - map.put((char)236, "igrave"); /* Latin small letter i with grave */ - map.put((char)237, "iacute"); /* Latin small letter i with acute */ - map.put((char)238, "icirc"); /* Latin small letter i with circumflex */ - map.put((char)239, "iuml"); /* Latin small letter i with diaeresis */ - map.put((char)240, "eth"); /* Latin small letter eth */ - map.put((char)241, "ntilde"); /* Latin small letter n with tilde */ - map.put((char)242, "ograve"); /* Latin small letter o with grave */ - map.put((char)243, "oacute"); /* Latin small letter o with acute */ - map.put((char)244, "ocirc"); /* Latin small letter o with circumflex */ - map.put((char)245, "otilde"); /* Latin small letter o with tilde */ - map.put((char)246, "ouml"); /* Latin small letter o with diaeresis */ - map.put((char)247, "divide"); /* division sign */ - map.put((char)248, "oslash"); /* Latin small letter o with stroke */ - map.put((char)249, "ugrave"); /* Latin small letter u with grave */ - map.put((char)250, "uacute"); /* Latin small letter u with acute */ - map.put((char)251, "ucirc"); /* Latin small letter u with circumflex */ - map.put((char)252, "uuml"); /* Latin small letter u with diaeresis */ - map.put((char)253, "yacute"); /* Latin small letter y with acute */ - map.put((char)254, "thorn"); /* Latin small letter thorn */ - map.put((char)255, "yuml"); /* Latin small letter y with diaeresis */ - map.put((char)338, "OElig"); /* Latin capital ligature oe */ - map.put((char)339, "oelig"); /* Latin small ligature oe */ - map.put((char)352, "Scaron"); /* Latin capital letter s with caron */ - map.put((char)353, "scaron"); /* Latin small letter s with caron */ - map.put((char)376, "Yuml"); /* Latin capital letter y with diaeresis */ - map.put((char)402, "fnof"); /* Latin small letter f with hook */ - map.put((char)710, "circ"); /* modifier letter circumflex accent */ - map.put((char)732, "tilde"); /* small tilde */ - map.put((char)913, "Alpha"); /* Greek capital letter alpha */ - map.put((char)914, "Beta"); /* Greek capital letter beta */ - map.put((char)915, "Gamma"); /* Greek capital letter gamma */ - map.put((char)916, "Delta"); /* Greek capital letter delta */ - map.put((char)917, "Epsilon"); /* Greek capital letter epsilon */ - map.put((char)918, "Zeta"); /* Greek capital letter zeta */ - map.put((char)919, "Eta"); /* Greek capital letter eta */ - map.put((char)920, "Theta"); /* Greek capital letter theta */ - map.put((char)921, "Iota"); /* Greek capital letter iota */ - map.put((char)922, "Kappa"); /* Greek capital letter kappa */ - map.put((char)923, "Lambda"); /* Greek capital letter lambda */ - map.put((char)924, "Mu"); /* Greek capital letter mu */ - map.put((char)925, "Nu"); /* Greek capital letter nu */ - map.put((char)926, "Xi"); /* Greek capital letter xi */ - map.put((char)927, "Omicron"); /* Greek capital letter omicron */ - map.put((char)928, "Pi"); /* Greek capital letter pi */ - map.put((char)929, "Rho"); /* Greek capital letter rho */ - map.put((char)931, "Sigma"); /* Greek capital letter sigma */ - map.put((char)932, "Tau"); /* Greek capital letter tau */ - map.put((char)933, "Upsilon"); /* Greek capital letter upsilon */ - map.put((char)934, "Phi"); /* Greek capital letter phi */ - map.put((char)935, "Chi"); /* Greek capital letter chi */ - map.put((char)936, "Psi"); /* Greek capital letter psi */ - map.put((char)937, "Omega"); /* Greek capital letter omega */ - map.put((char)945, "alpha"); /* Greek small letter alpha */ - map.put((char)946, "beta"); /* Greek small letter beta */ - map.put((char)947, "gamma"); /* Greek small letter gamma */ - map.put((char)948, "delta"); /* Greek small letter delta */ - map.put((char)949, "epsilon"); /* Greek small letter epsilon */ - map.put((char)950, "zeta"); /* Greek small letter zeta */ - map.put((char)951, "eta"); /* Greek small letter eta */ - map.put((char)952, "theta"); /* Greek small letter theta */ - map.put((char)953, "iota"); /* Greek small letter iota */ - map.put((char)954, "kappa"); /* Greek small letter kappa */ - map.put((char)955, "lambda"); /* Greek small letter lambda */ - map.put((char)956, "mu"); /* Greek small letter mu */ - map.put((char)957, "nu"); /* Greek small letter nu */ - map.put((char)958, "xi"); /* Greek small letter xi */ - map.put((char)959, "omicron"); /* Greek small letter omicron */ - map.put((char)960, "pi"); /* Greek small letter pi */ - map.put((char)961, "rho"); /* Greek small letter rho */ - map.put((char)962, "sigmaf"); /* Greek small letter final sigma */ - map.put((char)963, "sigma"); /* Greek small letter sigma */ - map.put((char)964, "tau"); /* Greek small letter tau */ - map.put((char)965, "upsilon"); /* Greek small letter upsilon */ - map.put((char)966, "phi"); /* Greek small letter phi */ - map.put((char)967, "chi"); /* Greek small letter chi */ - map.put((char)968, "psi"); /* Greek small letter psi */ - map.put((char)969, "omega"); /* Greek small letter omega */ - map.put((char)977, "thetasym"); /* Greek theta symbol */ - map.put((char)978, "upsih"); /* Greek upsilon with hook symbol */ - map.put((char)982, "piv"); /* Greek pi symbol */ - map.put((char)8194, "ensp"); /* en space */ - map.put((char)8195, "emsp"); /* em space */ - map.put((char)8201, "thinsp"); /* thin space */ - map.put((char)8204, "zwnj"); /* zero width non-joiner */ - map.put((char)8205, "zwj"); /* zero width joiner */ - map.put((char)8206, "lrm"); /* left-to-right mark */ - map.put((char)8207, "rlm"); /* right-to-left mark */ - map.put((char)8211, "ndash"); /* en dash */ - map.put((char)8212, "mdash"); /* em dash */ - map.put((char)8216, "lsquo"); /* left single quotation mark */ - map.put((char)8217, "rsquo"); /* right single quotation mark */ - map.put((char)8218, "sbquo"); /* single low-9 quotation mark */ - map.put((char)8220, "ldquo"); /* left double quotation mark */ - map.put((char)8221, "rdquo"); /* right double quotation mark */ - map.put((char)8222, "bdquo"); /* double low-9 quotation mark */ - map.put((char)8224, "dagger"); /* dagger */ - map.put((char)8225, "Dagger"); /* double dagger */ - map.put((char)8226, "bull"); /* bullet */ - map.put((char)8230, "hellip"); /* horizontal ellipsis */ - map.put((char)8240, "permil"); /* per mille sign */ - map.put((char)8242, "prime"); /* prime */ - map.put((char)8243, "Prime"); /* double prime */ - map.put((char)8249, "lsaquo"); /* single left-pointing angle quotation mark */ - map.put((char)8250, "rsaquo"); /* single right-pointing angle quotation mark */ - map.put((char)8254, "oline"); /* overline */ - map.put((char)8260, "frasl"); /* fraction slash */ - map.put((char)8364, "euro"); /* euro sign */ - map.put((char)8465, "image"); /* black-letter capital i */ - map.put((char)8472, "weierp"); /* script capital pXCOMMAX Weierstrass p */ - map.put((char)8476, "real"); /* black-letter capital r */ - map.put((char)8482, "trade"); /* trademark sign */ - map.put((char)8501, "alefsym"); /* alef symbol */ - map.put((char)8592, "larr"); /* leftwards arrow */ - map.put((char)8593, "uarr"); /* upwards arrow */ - map.put((char)8594, "rarr"); /* rightwards arrow */ - map.put((char)8595, "darr"); /* downwards arrow */ - map.put((char)8596, "harr"); /* left right arrow */ - map.put((char)8629, "crarr"); /* downwards arrow with corner leftwards */ - map.put((char)8656, "lArr"); /* leftwards double arrow */ - map.put((char)8657, "uArr"); /* upwards double arrow */ - map.put((char)8658, "rArr"); /* rightwards double arrow */ - map.put((char)8659, "dArr"); /* downwards double arrow */ - map.put((char)8660, "hArr"); /* left right double arrow */ - map.put((char)8704, "forall"); /* for all */ - map.put((char)8706, "part"); /* partial differential */ - map.put((char)8707, "exist"); /* there exists */ - map.put((char)8709, "empty"); /* empty set */ - map.put((char)8711, "nabla"); /* nabla */ - map.put((char)8712, "isin"); /* element of */ - map.put((char)8713, "notin"); /* not an element of */ - map.put((char)8715, "ni"); /* contains as member */ - map.put((char)8719, "prod"); /* n-ary product */ - map.put((char)8721, "sum"); /* n-ary summation */ - map.put((char)8722, "minus"); /* minus sign */ - map.put((char)8727, "lowast"); /* asterisk operator */ - map.put((char)8730, "radic"); /* square root */ - map.put((char)8733, "prop"); /* proportional to */ - map.put((char)8734, "infin"); /* infinity */ - map.put((char)8736, "ang"); /* angle */ - map.put((char)8743, "and"); /* logical and */ - map.put((char)8744, "or"); /* logical or */ - map.put((char)8745, "cap"); /* intersection */ - map.put((char)8746, "cup"); /* union */ - map.put((char)8747, "int"); /* integral */ - map.put((char)8756, "there4"); /* therefore */ - map.put((char)8764, "sim"); /* tilde operator */ - map.put((char)8773, "cong"); /* congruent to */ - map.put((char)8776, "asymp"); /* almost equal to */ - map.put((char)8800, "ne"); /* not equal to */ - map.put((char)8801, "equiv"); /* identical toXCOMMAX equivalent to */ - map.put((char)8804, "le"); /* less-than or equal to */ - map.put((char)8805, "ge"); /* greater-than or equal to */ - map.put((char)8834, "sub"); /* subset of */ - map.put((char)8835, "sup"); /* superset of */ - map.put((char)8836, "nsub"); /* not a subset of */ - map.put((char)8838, "sube"); /* subset of or equal to */ - map.put((char)8839, "supe"); /* superset of or equal to */ - map.put((char)8853, "oplus"); /* circled plus */ - map.put((char)8855, "otimes"); /* circled times */ - map.put((char)8869, "perp"); /* up tack */ - map.put((char)8901, "sdot"); /* dot operator */ - map.put((char)8968, "lceil"); /* left ceiling */ - map.put((char)8969, "rceil"); /* right ceiling */ - map.put((char)8970, "lfloor"); /* left floor */ - map.put((char)8971, "rfloor"); /* right floor */ - map.put((char)9001, "lang"); /* left-pointing angle bracket */ - map.put((char)9002, "rang"); /* right-pointing angle bracket */ - map.put((char)9674, "loz"); /* lozenge */ - map.put((char)9824, "spades"); /* black spade suit */ - map.put((char)9827, "clubs"); /* black club suit */ - map.put((char)9829, "hearts"); /* black heart suit */ - map.put((char)9830, "diams"); /* black diamond suit */ - - return Collections.unmodifiableMap(map); - } - - /** - * Build a unmodifiable Trie from entitiy Name to Character - * @return Unmodifiable trie. - */ - private static synchronized Trie mkEntityToCharacterTrie() - { - Trie trie = new HashTrie(); - - for(Map.Entry entry : characterToEntityMap.entrySet()) - trie.put(entry.getValue(),entry.getKey()); - return Trie.Util.unmodifiable(trie); - } -} +/** + * OWASP Enterprise Security API (ESAPI) + * + * This file is part of the Open Web Application Security Project (OWASP) + * Enterprise Security API (ESAPI) project. For details, please see + * http://www.owasp.org/index.php/ESAPI. + * + * Copyright (c) 2007 - The OWASP Foundation + * + * The ESAPI is published by OWASP under the BSD license. You should read and accept the + * LICENSE before you use, modify, and/or redistribute this software. + * + * @author Jeff Williams Aspect Security + * @created 2007 + */ +package org.owasp.esapi.codecs; + +import java.util.HashMap; +import java.util.Collections; +import java.util.Map; + +/** + * Implementation of the Codec interface for HTML entity encoding. + * + * @author Jeff Williams (jeff.williams .at. aspectsecurity.com) Aspect Security + * @since June 1, 2007 + * @see org.owasp.esapi.Encoder + */ +public class HTMLEntityCodec extends Codec +{ + private static final char REPLACEMENT_CHAR = '\ufffd'; + private static final String REPLACEMENT_HEX = "fffd"; + private static final String REPLACEMENT_STR = "" + REPLACEMENT_CHAR; + private static final Map characterToEntityMap = mkCharacterToEntityMap(); + + private static final Trie entityToCharacterTrie = mkEntityToCharacterTrie(); + + /** + * + */ + public HTMLEntityCodec() { + } + + /** + * {@inheritDoc} + * + * Encodes a Character for safe use in an HTML entity field. + * @param immune + */ + public String encodeCharacter( char[] immune, Character c ) { + + // check for immune characters + if ( containsCharacter(c, immune ) ) { + return ""+c; + } + + // check for alphanumeric characters + String hex = Codec.getHexForNonAlphanumeric(c); + if ( hex == null ) { + return ""+c; + } + + // check for illegal characters + if ( ( c <= 0x1f && c != '\t' && c != '\n' && c != '\r' ) || ( c >= 0x7f && c <= 0x9f ) ) + { + hex = REPLACEMENT_HEX; // Let's entity encode this instead of returning it + c = REPLACEMENT_CHAR; + } + + // check if there's a defined entity + String entityName = (String) characterToEntityMap.get(c); + if (entityName != null) { + return "&" + entityName + ";"; + } + + // return the hex entity as suggested in the spec + return "&#x" + hex + ";"; + } + + /** + * {@inheritDoc} + * + * Returns the decoded version of the character starting at index, or + * null if no decoding is possible. + * + * Formats all are legal both with and without semi-colon, upper/lower case: + * &#dddd; + * &#xhhhh; + * &name; + */ + public Character decodeCharacter( PushbackString input ) { + input.mark(); + Character first = input.next(); + if ( first == null ) { + input.reset(); + return null; + } + + // if this is not an encoded character, return null + if (first != '&' ) { + input.reset(); + return null; + } + + // test for numeric encodings + Character second = input.next(); + if ( second == null ) { + input.reset(); + return null; + } + + if (second == '#' ) { + // handle numbers + Character c = getNumericEntity( input ); + if ( c != null ) return c; + } else if ( Character.isLetter( second.charValue() ) ) { + // handle entities + input.pushback( second ); + Character c = getNamedEntity( input ); + if ( c != null ) return c; + } + input.reset(); + return null; + } + + /** + * getNumericEntry checks input to see if it is a numeric entity + * + * @param input + * The input to test for being a numeric entity + * + * @return + * null if input is null, the character of input after decoding + */ + private Character getNumericEntity( PushbackString input ) { + Character first = input.peek(); + if ( first == null ) return null; + + if (first == 'x' || first == 'X' ) { + input.next(); + return parseHex( input ); + } + return parseNumber( input ); + } + + /** + * Parse a decimal number, such as those from JavaScript's String.fromCharCode(value) + * + * @param input + * decimal encoded string, such as 65 + * @return + * character representation of this decimal value, e.g. A + * @throws NumberFormatException + */ + private Character parseNumber( PushbackString input ) { + StringBuilder sb = new StringBuilder(); + while( input.hasNext() ) { + Character c = input.peek(); + + // if character is a digit then add it on and keep going + if ( Character.isDigit( c.charValue() ) ) { + sb.append( c ); + input.next(); + + // if character is a semi-colon, eat it and quit + } else if (c == ';' ) { + input.next(); + break; + + // otherwise just quit + } else { + break; + } + } + try { + int i = Integer.parseInt(sb.toString()); + if (Character.isValidCodePoint(i)) { + return (char) i; + } + } catch( NumberFormatException e ) { + // throw an exception for malformed entity? + } + return null; + } + + /** + * Parse a hex encoded entity + * + * @param input + * Hex encoded input (such as 437ae;) + * @return + * A single character from the string + * @throws NumberFormatException + */ + private Character parseHex( PushbackString input ) { + StringBuilder sb = new StringBuilder(); + while( input.hasNext() ) { + Character c = input.peek(); + + // if character is a hex digit then add it on and keep going + if ( "0123456789ABCDEFabcdef".indexOf(c) != -1 ) { + sb.append( c ); + input.next(); + + // if character is a semi-colon, eat it and quit + } else if (c == ';' ) { + input.next(); + break; + + // otherwise just quit + } else { + break; + } + } + try { + int i = Integer.parseInt(sb.toString(), 16); + if (Character.isValidCodePoint(i)) { + return (char) i; + } + } catch( NumberFormatException e ) { + // throw an exception for malformed entity? + } + return null; + } + + /** + * + * Returns the decoded version of the character starting at index, or + * null if no decoding is possible. + * + * Formats all are legal both with and without semi-colon, upper/lower case: + * &aa; + * &aaa; + * &aaaa; + * &aaaaa; + * &aaaaaa; + * &aaaaaaa; + * + * @param input + * A string containing a named entity like " + * @return + * Returns the decoded version of the character starting at index, or null if no decoding is possible. + */ + private Character getNamedEntity( PushbackString input ) { + StringBuilder possible = new StringBuilder(); + Map.Entry entry; + int len; + + // kludge around PushbackString.... + len = Math.min(input.remainder().length(), entityToCharacterTrie.getMaxKeyLength()); + for(int i=0;i mkCharacterToEntityMap() + { + Map map = new HashMap(252); + + map.put((char)34, "quot"); /* quotation mark */ + map.put((char)38, "amp"); /* ampersand */ + map.put((char)60, "lt"); /* less-than sign */ + map.put((char)62, "gt"); /* greater-than sign */ + map.put((char)160, "nbsp"); /* no-break space */ + map.put((char)161, "iexcl"); /* inverted exclamation mark */ + map.put((char)162, "cent"); /* cent sign */ + map.put((char)163, "pound"); /* pound sign */ + map.put((char)164, "curren"); /* currency sign */ + map.put((char)165, "yen"); /* yen sign */ + map.put((char)166, "brvbar"); /* broken bar */ + map.put((char)167, "sect"); /* section sign */ + map.put((char)168, "uml"); /* diaeresis */ + map.put((char)169, "copy"); /* copyright sign */ + map.put((char)170, "ordf"); /* feminine ordinal indicator */ + map.put((char)171, "laquo"); /* left-pointing double angle quotation mark */ + map.put((char)172, "not"); /* not sign */ + map.put((char)173, "shy"); /* soft hyphen */ + map.put((char)174, "reg"); /* registered sign */ + map.put((char)175, "macr"); /* macron */ + map.put((char)176, "deg"); /* degree sign */ + map.put((char)177, "plusmn"); /* plus-minus sign */ + map.put((char)178, "sup2"); /* superscript two */ + map.put((char)179, "sup3"); /* superscript three */ + map.put((char)180, "acute"); /* acute accent */ + map.put((char)181, "micro"); /* micro sign */ + map.put((char)182, "para"); /* pilcrow sign */ + map.put((char)183, "middot"); /* middle dot */ + map.put((char)184, "cedil"); /* cedilla */ + map.put((char)185, "sup1"); /* superscript one */ + map.put((char)186, "ordm"); /* masculine ordinal indicator */ + map.put((char)187, "raquo"); /* right-pointing double angle quotation mark */ + map.put((char)188, "frac14"); /* vulgar fraction one quarter */ + map.put((char)189, "frac12"); /* vulgar fraction one half */ + map.put((char)190, "frac34"); /* vulgar fraction three quarters */ + map.put((char)191, "iquest"); /* inverted question mark */ + map.put((char)192, "Agrave"); /* Latin capital letter a with grave */ + map.put((char)193, "Aacute"); /* Latin capital letter a with acute */ + map.put((char)194, "Acirc"); /* Latin capital letter a with circumflex */ + map.put((char)195, "Atilde"); /* Latin capital letter a with tilde */ + map.put((char)196, "Auml"); /* Latin capital letter a with diaeresis */ + map.put((char)197, "Aring"); /* Latin capital letter a with ring above */ + map.put((char)198, "AElig"); /* Latin capital letter ae */ + map.put((char)199, "Ccedil"); /* Latin capital letter c with cedilla */ + map.put((char)200, "Egrave"); /* Latin capital letter e with grave */ + map.put((char)201, "Eacute"); /* Latin capital letter e with acute */ + map.put((char)202, "Ecirc"); /* Latin capital letter e with circumflex */ + map.put((char)203, "Euml"); /* Latin capital letter e with diaeresis */ + map.put((char)204, "Igrave"); /* Latin capital letter i with grave */ + map.put((char)205, "Iacute"); /* Latin capital letter i with acute */ + map.put((char)206, "Icirc"); /* Latin capital letter i with circumflex */ + map.put((char)207, "Iuml"); /* Latin capital letter i with diaeresis */ + map.put((char)208, "ETH"); /* Latin capital letter eth */ + map.put((char)209, "Ntilde"); /* Latin capital letter n with tilde */ + map.put((char)210, "Ograve"); /* Latin capital letter o with grave */ + map.put((char)211, "Oacute"); /* Latin capital letter o with acute */ + map.put((char)212, "Ocirc"); /* Latin capital letter o with circumflex */ + map.put((char)213, "Otilde"); /* Latin capital letter o with tilde */ + map.put((char)214, "Ouml"); /* Latin capital letter o with diaeresis */ + map.put((char)215, "times"); /* multiplication sign */ + map.put((char)216, "Oslash"); /* Latin capital letter o with stroke */ + map.put((char)217, "Ugrave"); /* Latin capital letter u with grave */ + map.put((char)218, "Uacute"); /* Latin capital letter u with acute */ + map.put((char)219, "Ucirc"); /* Latin capital letter u with circumflex */ + map.put((char)220, "Uuml"); /* Latin capital letter u with diaeresis */ + map.put((char)221, "Yacute"); /* Latin capital letter y with acute */ + map.put((char)222, "THORN"); /* Latin capital letter thorn */ + map.put((char)223, "szlig"); /* Latin small letter sharp sXCOMMAX German Eszett */ + map.put((char)224, "agrave"); /* Latin small letter a with grave */ + map.put((char)225, "aacute"); /* Latin small letter a with acute */ + map.put((char)226, "acirc"); /* Latin small letter a with circumflex */ + map.put((char)227, "atilde"); /* Latin small letter a with tilde */ + map.put((char)228, "auml"); /* Latin small letter a with diaeresis */ + map.put((char)229, "aring"); /* Latin small letter a with ring above */ + map.put((char)230, "aelig"); /* Latin lowercase ligature ae */ + map.put((char)231, "ccedil"); /* Latin small letter c with cedilla */ + map.put((char)232, "egrave"); /* Latin small letter e with grave */ + map.put((char)233, "eacute"); /* Latin small letter e with acute */ + map.put((char)234, "ecirc"); /* Latin small letter e with circumflex */ + map.put((char)235, "euml"); /* Latin small letter e with diaeresis */ + map.put((char)236, "igrave"); /* Latin small letter i with grave */ + map.put((char)237, "iacute"); /* Latin small letter i with acute */ + map.put((char)238, "icirc"); /* Latin small letter i with circumflex */ + map.put((char)239, "iuml"); /* Latin small letter i with diaeresis */ + map.put((char)240, "eth"); /* Latin small letter eth */ + map.put((char)241, "ntilde"); /* Latin small letter n with tilde */ + map.put((char)242, "ograve"); /* Latin small letter o with grave */ + map.put((char)243, "oacute"); /* Latin small letter o with acute */ + map.put((char)244, "ocirc"); /* Latin small letter o with circumflex */ + map.put((char)245, "otilde"); /* Latin small letter o with tilde */ + map.put((char)246, "ouml"); /* Latin small letter o with diaeresis */ + map.put((char)247, "divide"); /* division sign */ + map.put((char)248, "oslash"); /* Latin small letter o with stroke */ + map.put((char)249, "ugrave"); /* Latin small letter u with grave */ + map.put((char)250, "uacute"); /* Latin small letter u with acute */ + map.put((char)251, "ucirc"); /* Latin small letter u with circumflex */ + map.put((char)252, "uuml"); /* Latin small letter u with diaeresis */ + map.put((char)253, "yacute"); /* Latin small letter y with acute */ + map.put((char)254, "thorn"); /* Latin small letter thorn */ + map.put((char)255, "yuml"); /* Latin small letter y with diaeresis */ + map.put((char)338, "OElig"); /* Latin capital ligature oe */ + map.put((char)339, "oelig"); /* Latin small ligature oe */ + map.put((char)352, "Scaron"); /* Latin capital letter s with caron */ + map.put((char)353, "scaron"); /* Latin small letter s with caron */ + map.put((char)376, "Yuml"); /* Latin capital letter y with diaeresis */ + map.put((char)402, "fnof"); /* Latin small letter f with hook */ + map.put((char)710, "circ"); /* modifier letter circumflex accent */ + map.put((char)732, "tilde"); /* small tilde */ + map.put((char)913, "Alpha"); /* Greek capital letter alpha */ + map.put((char)914, "Beta"); /* Greek capital letter beta */ + map.put((char)915, "Gamma"); /* Greek capital letter gamma */ + map.put((char)916, "Delta"); /* Greek capital letter delta */ + map.put((char)917, "Epsilon"); /* Greek capital letter epsilon */ + map.put((char)918, "Zeta"); /* Greek capital letter zeta */ + map.put((char)919, "Eta"); /* Greek capital letter eta */ + map.put((char)920, "Theta"); /* Greek capital letter theta */ + map.put((char)921, "Iota"); /* Greek capital letter iota */ + map.put((char)922, "Kappa"); /* Greek capital letter kappa */ + map.put((char)923, "Lambda"); /* Greek capital letter lambda */ + map.put((char)924, "Mu"); /* Greek capital letter mu */ + map.put((char)925, "Nu"); /* Greek capital letter nu */ + map.put((char)926, "Xi"); /* Greek capital letter xi */ + map.put((char)927, "Omicron"); /* Greek capital letter omicron */ + map.put((char)928, "Pi"); /* Greek capital letter pi */ + map.put((char)929, "Rho"); /* Greek capital letter rho */ + map.put((char)931, "Sigma"); /* Greek capital letter sigma */ + map.put((char)932, "Tau"); /* Greek capital letter tau */ + map.put((char)933, "Upsilon"); /* Greek capital letter upsilon */ + map.put((char)934, "Phi"); /* Greek capital letter phi */ + map.put((char)935, "Chi"); /* Greek capital letter chi */ + map.put((char)936, "Psi"); /* Greek capital letter psi */ + map.put((char)937, "Omega"); /* Greek capital letter omega */ + map.put((char)945, "alpha"); /* Greek small letter alpha */ + map.put((char)946, "beta"); /* Greek small letter beta */ + map.put((char)947, "gamma"); /* Greek small letter gamma */ + map.put((char)948, "delta"); /* Greek small letter delta */ + map.put((char)949, "epsilon"); /* Greek small letter epsilon */ + map.put((char)950, "zeta"); /* Greek small letter zeta */ + map.put((char)951, "eta"); /* Greek small letter eta */ + map.put((char)952, "theta"); /* Greek small letter theta */ + map.put((char)953, "iota"); /* Greek small letter iota */ + map.put((char)954, "kappa"); /* Greek small letter kappa */ + map.put((char)955, "lambda"); /* Greek small letter lambda */ + map.put((char)956, "mu"); /* Greek small letter mu */ + map.put((char)957, "nu"); /* Greek small letter nu */ + map.put((char)958, "xi"); /* Greek small letter xi */ + map.put((char)959, "omicron"); /* Greek small letter omicron */ + map.put((char)960, "pi"); /* Greek small letter pi */ + map.put((char)961, "rho"); /* Greek small letter rho */ + map.put((char)962, "sigmaf"); /* Greek small letter final sigma */ + map.put((char)963, "sigma"); /* Greek small letter sigma */ + map.put((char)964, "tau"); /* Greek small letter tau */ + map.put((char)965, "upsilon"); /* Greek small letter upsilon */ + map.put((char)966, "phi"); /* Greek small letter phi */ + map.put((char)967, "chi"); /* Greek small letter chi */ + map.put((char)968, "psi"); /* Greek small letter psi */ + map.put((char)969, "omega"); /* Greek small letter omega */ + map.put((char)977, "thetasym"); /* Greek theta symbol */ + map.put((char)978, "upsih"); /* Greek upsilon with hook symbol */ + map.put((char)982, "piv"); /* Greek pi symbol */ + map.put((char)8194, "ensp"); /* en space */ + map.put((char)8195, "emsp"); /* em space */ + map.put((char)8201, "thinsp"); /* thin space */ + map.put((char)8204, "zwnj"); /* zero width non-joiner */ + map.put((char)8205, "zwj"); /* zero width joiner */ + map.put((char)8206, "lrm"); /* left-to-right mark */ + map.put((char)8207, "rlm"); /* right-to-left mark */ + map.put((char)8211, "ndash"); /* en dash */ + map.put((char)8212, "mdash"); /* em dash */ + map.put((char)8216, "lsquo"); /* left single quotation mark */ + map.put((char)8217, "rsquo"); /* right single quotation mark */ + map.put((char)8218, "sbquo"); /* single low-9 quotation mark */ + map.put((char)8220, "ldquo"); /* left double quotation mark */ + map.put((char)8221, "rdquo"); /* right double quotation mark */ + map.put((char)8222, "bdquo"); /* double low-9 quotation mark */ + map.put((char)8224, "dagger"); /* dagger */ + map.put((char)8225, "Dagger"); /* double dagger */ + map.put((char)8226, "bull"); /* bullet */ + map.put((char)8230, "hellip"); /* horizontal ellipsis */ + map.put((char)8240, "permil"); /* per mille sign */ + map.put((char)8242, "prime"); /* prime */ + map.put((char)8243, "Prime"); /* double prime */ + map.put((char)8249, "lsaquo"); /* single left-pointing angle quotation mark */ + map.put((char)8250, "rsaquo"); /* single right-pointing angle quotation mark */ + map.put((char)8254, "oline"); /* overline */ + map.put((char)8260, "frasl"); /* fraction slash */ + map.put((char)8364, "euro"); /* euro sign */ + map.put((char)8465, "image"); /* black-letter capital i */ + map.put((char)8472, "weierp"); /* script capital pXCOMMAX Weierstrass p */ + map.put((char)8476, "real"); /* black-letter capital r */ + map.put((char)8482, "trade"); /* trademark sign */ + map.put((char)8501, "alefsym"); /* alef symbol */ + map.put((char)8592, "larr"); /* leftwards arrow */ + map.put((char)8593, "uarr"); /* upwards arrow */ + map.put((char)8594, "rarr"); /* rightwards arrow */ + map.put((char)8595, "darr"); /* downwards arrow */ + map.put((char)8596, "harr"); /* left right arrow */ + map.put((char)8629, "crarr"); /* downwards arrow with corner leftwards */ + map.put((char)8656, "lArr"); /* leftwards double arrow */ + map.put((char)8657, "uArr"); /* upwards double arrow */ + map.put((char)8658, "rArr"); /* rightwards double arrow */ + map.put((char)8659, "dArr"); /* downwards double arrow */ + map.put((char)8660, "hArr"); /* left right double arrow */ + map.put((char)8704, "forall"); /* for all */ + map.put((char)8706, "part"); /* partial differential */ + map.put((char)8707, "exist"); /* there exists */ + map.put((char)8709, "empty"); /* empty set */ + map.put((char)8711, "nabla"); /* nabla */ + map.put((char)8712, "isin"); /* element of */ + map.put((char)8713, "notin"); /* not an element of */ + map.put((char)8715, "ni"); /* contains as member */ + map.put((char)8719, "prod"); /* n-ary product */ + map.put((char)8721, "sum"); /* n-ary summation */ + map.put((char)8722, "minus"); /* minus sign */ + map.put((char)8727, "lowast"); /* asterisk operator */ + map.put((char)8730, "radic"); /* square root */ + map.put((char)8733, "prop"); /* proportional to */ + map.put((char)8734, "infin"); /* infinity */ + map.put((char)8736, "ang"); /* angle */ + map.put((char)8743, "and"); /* logical and */ + map.put((char)8744, "or"); /* logical or */ + map.put((char)8745, "cap"); /* intersection */ + map.put((char)8746, "cup"); /* union */ + map.put((char)8747, "int"); /* integral */ + map.put((char)8756, "there4"); /* therefore */ + map.put((char)8764, "sim"); /* tilde operator */ + map.put((char)8773, "cong"); /* congruent to */ + map.put((char)8776, "asymp"); /* almost equal to */ + map.put((char)8800, "ne"); /* not equal to */ + map.put((char)8801, "equiv"); /* identical toXCOMMAX equivalent to */ + map.put((char)8804, "le"); /* less-than or equal to */ + map.put((char)8805, "ge"); /* greater-than or equal to */ + map.put((char)8834, "sub"); /* subset of */ + map.put((char)8835, "sup"); /* superset of */ + map.put((char)8836, "nsub"); /* not a subset of */ + map.put((char)8838, "sube"); /* subset of or equal to */ + map.put((char)8839, "supe"); /* superset of or equal to */ + map.put((char)8853, "oplus"); /* circled plus */ + map.put((char)8855, "otimes"); /* circled times */ + map.put((char)8869, "perp"); /* up tack */ + map.put((char)8901, "sdot"); /* dot operator */ + map.put((char)8968, "lceil"); /* left ceiling */ + map.put((char)8969, "rceil"); /* right ceiling */ + map.put((char)8970, "lfloor"); /* left floor */ + map.put((char)8971, "rfloor"); /* right floor */ + map.put((char)9001, "lang"); /* left-pointing angle bracket */ + map.put((char)9002, "rang"); /* right-pointing angle bracket */ + map.put((char)9674, "loz"); /* lozenge */ + map.put((char)9824, "spades"); /* black spade suit */ + map.put((char)9827, "clubs"); /* black club suit */ + map.put((char)9829, "hearts"); /* black heart suit */ + map.put((char)9830, "diams"); /* black diamond suit */ + + return Collections.unmodifiableMap(map); + } + + /** + * Build a unmodifiable Trie from entitiy Name to Character + * @return Unmodifiable trie. + */ + private static synchronized Trie mkEntityToCharacterTrie() + { + Trie trie = new HashTrie(); + + for(Map.Entry entry : characterToEntityMap.entrySet()) + trie.put(entry.getValue(),entry.getKey()); + return Trie.Util.unmodifiable(trie); + } +} From d87f8dbb8f97a6cc28f488f4206264ea937735a6 Mon Sep 17 00:00:00 2001 From: kwwall Date: Mon, 18 Jan 2016 23:33:47 -0500 Subject: [PATCH 096/812] Change CRLF to LF for issue 356. --- .../owasp/esapi/codecs/JavaScriptCodec.java | 432 +++++++++--------- 1 file changed, 216 insertions(+), 216 deletions(-) diff --git a/src/main/java/org/owasp/esapi/codecs/JavaScriptCodec.java b/src/main/java/org/owasp/esapi/codecs/JavaScriptCodec.java index 6d128e462..7980155e1 100644 --- a/src/main/java/org/owasp/esapi/codecs/JavaScriptCodec.java +++ b/src/main/java/org/owasp/esapi/codecs/JavaScriptCodec.java @@ -1,217 +1,217 @@ -/** - * OWASP Enterprise Security API (ESAPI) - * - * This file is part of the Open Web Application Security Project (OWASP) - * Enterprise Security API (ESAPI) project. For details, please see - * http://www.owasp.org/index.php/ESAPI. - * - * Copyright (c) 2007 - The OWASP Foundation - * - * The ESAPI is published by OWASP under the BSD license. You should read and accept the - * LICENSE before you use, modify, and/or redistribute this software. - * - * @author Jeff Williams Aspect Security - * @created 2007 - */ -package org.owasp.esapi.codecs; - - -/** - * Implementation of the Codec interface for backslash encoding in JavaScript. - * - * @author Jeff Williams (jeff.williams .at. aspectsecurity.com) Aspect Security - * @since June 1, 2007 - * @see org.owasp.esapi.Encoder - */ -public class JavaScriptCodec extends Codec { - - - /** - * {@inheritDoc} - * - * Returns backslash encoded numeric format. Does not use backslash character escapes - * such as, \" or \' as these may cause parsing problems. For example, if a javascript - * attribute, such as onmouseover, contains a \" that will close the entire attribute and - * allow an attacker to inject another script attribute. - * - * @param immune - */ - public String encodeCharacter( char[] immune, Character c ) { - - // check for immune characters - if ( containsCharacter(c, immune ) ) { - return ""+c; - } - - // check for alphanumeric characters - String hex = Codec.getHexForNonAlphanumeric(c); - if ( hex == null ) { - return ""+c; - } - - // Do not use these shortcuts as they can be used to break out of a context - // if ( ch == 0x00 ) return "\\0"; - // if ( ch == 0x08 ) return "\\b"; - // if ( ch == 0x09 ) return "\\t"; - // if ( ch == 0x0a ) return "\\n"; - // if ( ch == 0x0b ) return "\\v"; - // if ( ch == 0x0c ) return "\\f"; - // if ( ch == 0x0d ) return "\\r"; - // if ( ch == 0x22 ) return "\\\""; - // if ( ch == 0x27 ) return "\\'"; - // if ( ch == 0x5c ) return "\\\\"; - - // encode up to 256 with \\xHH - String temp = Integer.toHexString(c); - if ( c < 256 ) { - String pad = "00".substring(temp.length() ); - return "\\x" + pad + temp.toUpperCase(); - } - - // otherwise encode with \\uHHHH - String pad = "0000".substring(temp.length() ); - return "\\u" + pad + temp.toUpperCase(); - } - - - /** - * {@inheritDoc} - * - * Returns the decoded version of the character starting at index, or - * null if no decoding is possible. - * See http://www.planetpdf.com/codecuts/pdfs/tutorial/jsspec.pdf - * Formats all are legal both upper/lower case: - * \\a - special characters - * \\xHH - * \\uHHHH - * \\OOO (1, 2, or 3 digits) - */ - public Character decodeCharacter( PushbackString input ) { - input.mark(); - Character first = input.next(); - if ( first == null ) { - input.reset(); - return null; - } - - // if this is not an encoded character, return null - if (first != '\\' ) { - input.reset(); - return null; - } - - Character second = input.next(); - if ( second == null ) { - input.reset(); - return null; - } - - // \0 collides with the octal decoder and is non-standard - // if ( second.charValue() == '0' ) { - // return Character.valueOf( (char)0x00 ); - if (second == 'b' ) { - return 0x08; - } else if (second == 't' ) { - return 0x09; - } else if (second == 'n' ) { - return 0x0a; - } else if (second == 'v' ) { - return 0x0b; - } else if (second == 'f' ) { - return 0x0c; - } else if (second == 'r' ) { - return 0x0d; - } else if (second == '\"' ) { - return 0x22; - } else if (second == '\'' ) { - return 0x27; - } else if (second == '\\' ) { - return 0x5c; - - // look for \\xXX format - } else if ( Character.toLowerCase( second.charValue() ) == 'x' ) { - // Search for exactly 2 hex digits following - StringBuilder sb = new StringBuilder(); - for ( int i=0; i<2; i++ ) { - Character c = input.nextHex(); - if ( c != null ) sb.append( c ); - else { - input.reset(); - return null; - } - } - try { - // parse the hex digit and create a character - int i = Integer.parseInt(sb.toString(), 16); - if (Character.isValidCodePoint(i)) { - return (char) i; - } - } catch( NumberFormatException e ) { - // throw an exception for malformed entity? - input.reset(); - return null; - } - - // look for \\uXXXX format - } else if ( Character.toLowerCase( second.charValue() ) == 'u') { - // Search for exactly 4 hex digits following - StringBuilder sb = new StringBuilder(); - for ( int i=0; i<4; i++ ) { - Character c = input.nextHex(); - if ( c != null ) sb.append( c ); - else { - input.reset(); - return null; - } - } - try { - // parse the hex string and create a character - int i = Integer.parseInt(sb.toString(), 16); - if (Character.isValidCodePoint(i)) { - return (char) i; - } - } catch( NumberFormatException e ) { - // throw an exception for malformed entity? - input.reset(); - return null; - } - - // look for one, two, or three octal digits - } else if ( PushbackString.isOctalDigit(second) ) { - StringBuilder sb = new StringBuilder(); - // get digit 1 - sb.append(second); - - // get digit 2 if present - Character c2 = input.next(); - if ( !PushbackString.isOctalDigit(c2) ) { - input.pushback( c2 ); - } else { - sb.append( c2 ); - // get digit 3 if present - Character c3 = input.next(); - if ( !PushbackString.isOctalDigit(c3) ) { - input.pushback( c3 ); - } else { - sb.append( c3 ); - } - } - try { - // parse the octal string and create a character - int i = Integer.parseInt(sb.toString(), 8); - if (Character.isValidCodePoint(i)) { - return (char) i; - } - } catch( NumberFormatException e ) { - // throw an exception for malformed entity? - input.reset(); - return null; - } - } - - // ignore the backslash and return the character - return second; - } - +/** + * OWASP Enterprise Security API (ESAPI) + * + * This file is part of the Open Web Application Security Project (OWASP) + * Enterprise Security API (ESAPI) project. For details, please see + * http://www.owasp.org/index.php/ESAPI. + * + * Copyright (c) 2007 - The OWASP Foundation + * + * The ESAPI is published by OWASP under the BSD license. You should read and accept the + * LICENSE before you use, modify, and/or redistribute this software. + * + * @author Jeff Williams Aspect Security + * @created 2007 + */ +package org.owasp.esapi.codecs; + + +/** + * Implementation of the Codec interface for backslash encoding in JavaScript. + * + * @author Jeff Williams (jeff.williams .at. aspectsecurity.com) Aspect Security + * @since June 1, 2007 + * @see org.owasp.esapi.Encoder + */ +public class JavaScriptCodec extends Codec { + + + /** + * {@inheritDoc} + * + * Returns backslash encoded numeric format. Does not use backslash character escapes + * such as, \" or \' as these may cause parsing problems. For example, if a javascript + * attribute, such as onmouseover, contains a \" that will close the entire attribute and + * allow an attacker to inject another script attribute. + * + * @param immune + */ + public String encodeCharacter( char[] immune, Character c ) { + + // check for immune characters + if ( containsCharacter(c, immune ) ) { + return ""+c; + } + + // check for alphanumeric characters + String hex = Codec.getHexForNonAlphanumeric(c); + if ( hex == null ) { + return ""+c; + } + + // Do not use these shortcuts as they can be used to break out of a context + // if ( ch == 0x00 ) return "\\0"; + // if ( ch == 0x08 ) return "\\b"; + // if ( ch == 0x09 ) return "\\t"; + // if ( ch == 0x0a ) return "\\n"; + // if ( ch == 0x0b ) return "\\v"; + // if ( ch == 0x0c ) return "\\f"; + // if ( ch == 0x0d ) return "\\r"; + // if ( ch == 0x22 ) return "\\\""; + // if ( ch == 0x27 ) return "\\'"; + // if ( ch == 0x5c ) return "\\\\"; + + // encode up to 256 with \\xHH + String temp = Integer.toHexString(c); + if ( c < 256 ) { + String pad = "00".substring(temp.length() ); + return "\\x" + pad + temp.toUpperCase(); + } + + // otherwise encode with \\uHHHH + String pad = "0000".substring(temp.length() ); + return "\\u" + pad + temp.toUpperCase(); + } + + + /** + * {@inheritDoc} + * + * Returns the decoded version of the character starting at index, or + * null if no decoding is possible. + * See http://www.planetpdf.com/codecuts/pdfs/tutorial/jsspec.pdf + * Formats all are legal both upper/lower case: + * \\a - special characters + * \\xHH + * \\uHHHH + * \\OOO (1, 2, or 3 digits) + */ + public Character decodeCharacter( PushbackString input ) { + input.mark(); + Character first = input.next(); + if ( first == null ) { + input.reset(); + return null; + } + + // if this is not an encoded character, return null + if (first != '\\' ) { + input.reset(); + return null; + } + + Character second = input.next(); + if ( second == null ) { + input.reset(); + return null; + } + + // \0 collides with the octal decoder and is non-standard + // if ( second.charValue() == '0' ) { + // return Character.valueOf( (char)0x00 ); + if (second == 'b' ) { + return 0x08; + } else if (second == 't' ) { + return 0x09; + } else if (second == 'n' ) { + return 0x0a; + } else if (second == 'v' ) { + return 0x0b; + } else if (second == 'f' ) { + return 0x0c; + } else if (second == 'r' ) { + return 0x0d; + } else if (second == '\"' ) { + return 0x22; + } else if (second == '\'' ) { + return 0x27; + } else if (second == '\\' ) { + return 0x5c; + + // look for \\xXX format + } else if ( Character.toLowerCase( second.charValue() ) == 'x' ) { + // Search for exactly 2 hex digits following + StringBuilder sb = new StringBuilder(); + for ( int i=0; i<2; i++ ) { + Character c = input.nextHex(); + if ( c != null ) sb.append( c ); + else { + input.reset(); + return null; + } + } + try { + // parse the hex digit and create a character + int i = Integer.parseInt(sb.toString(), 16); + if (Character.isValidCodePoint(i)) { + return (char) i; + } + } catch( NumberFormatException e ) { + // throw an exception for malformed entity? + input.reset(); + return null; + } + + // look for \\uXXXX format + } else if ( Character.toLowerCase( second.charValue() ) == 'u') { + // Search for exactly 4 hex digits following + StringBuilder sb = new StringBuilder(); + for ( int i=0; i<4; i++ ) { + Character c = input.nextHex(); + if ( c != null ) sb.append( c ); + else { + input.reset(); + return null; + } + } + try { + // parse the hex string and create a character + int i = Integer.parseInt(sb.toString(), 16); + if (Character.isValidCodePoint(i)) { + return (char) i; + } + } catch( NumberFormatException e ) { + // throw an exception for malformed entity? + input.reset(); + return null; + } + + // look for one, two, or three octal digits + } else if ( PushbackString.isOctalDigit(second) ) { + StringBuilder sb = new StringBuilder(); + // get digit 1 + sb.append(second); + + // get digit 2 if present + Character c2 = input.next(); + if ( !PushbackString.isOctalDigit(c2) ) { + input.pushback( c2 ); + } else { + sb.append( c2 ); + // get digit 3 if present + Character c3 = input.next(); + if ( !PushbackString.isOctalDigit(c3) ) { + input.pushback( c3 ); + } else { + sb.append( c3 ); + } + } + try { + // parse the octal string and create a character + int i = Integer.parseInt(sb.toString(), 8); + if (Character.isValidCodePoint(i)) { + return (char) i; + } + } catch( NumberFormatException e ) { + // throw an exception for malformed entity? + input.reset(); + return null; + } + } + + // ignore the backslash and return the character + return second; + } + } \ No newline at end of file From eae6bba8583221ea4eee72f26fdae0a0c68c2430 Mon Sep 17 00:00:00 2001 From: kwwall Date: Mon, 18 Jan 2016 23:33:48 -0500 Subject: [PATCH 097/812] Change CRLF to LF for issue 356. --- .../org/owasp/esapi/codecs/MySQLCodec.java | 526 +++++++++--------- 1 file changed, 263 insertions(+), 263 deletions(-) diff --git a/src/main/java/org/owasp/esapi/codecs/MySQLCodec.java b/src/main/java/org/owasp/esapi/codecs/MySQLCodec.java index 01db4faf5..7d2aacbaa 100644 --- a/src/main/java/org/owasp/esapi/codecs/MySQLCodec.java +++ b/src/main/java/org/owasp/esapi/codecs/MySQLCodec.java @@ -1,264 +1,264 @@ -/** - * OWASP Enterprise Security API (ESAPI) - * - * This file is part of the Open Web Application Security Project (OWASP) - * Enterprise Security API (ESAPI) project. For details, please see - * http://www.owasp.org/index.php/ESAPI. - * - * Copyright (c) 2007 - The OWASP Foundation - * - * The ESAPI is published by OWASP under the BSD license. You should read and accept the - * LICENSE before you use, modify, and/or redistribute this software. - * - * @author Jeff Williams Aspect Security - * @created 2007 - */ -package org.owasp.esapi.codecs; - - - -/** - * Implementation of the Codec interface for MySQL strings. See http://mirror.yandex.ru/mirrors/ftp.mysql.com/doc/refman/5.0/en/string-syntax.html - * for more information. - * - * @author Jeff Williams (jeff.williams .at. aspectsecurity.com) Aspect Security - * @since June 1, 2007 - * @see org.owasp.esapi.Encoder - */ -public class MySQLCodec extends Codec { - /** - * Specifies the SQL Mode the target MySQL Server is running with. For details about MySQL Server Modes - * please see the Manual at {@link http://dev.mysql.com/doc/refman/5.0/en/server-sql-mode.html#sqlmode_ansi} - * - * Currently the only supported modes are: - * ANSI - * STANDARD - */ - public static enum Mode { - ANSI(1),STANDARD(0); - - private int key; - private Mode(int key) { this.key = key; } - - static Mode findByKey(int key) { - for ( Mode m : values() ) { - if ( m.key == key ) - return m; - } - return null; - } - } - - /** Target MySQL Server is running in Standard MySQL (Default) mode. */ - public static final int MYSQL_MODE = 0; - /** Target MySQL Server is running in {@link "http://dev.mysql.com/doc/refman/5.0/en/ansi-mode.html"} ANSI Mode */ - public static final int ANSI_MODE = 1; - - //private int mode = 0; - private Mode mode; - - /** - * Instantiate the MySQL codec - * - * @param mode - * Mode has to be one of {MYSQL_MODE|ANSI_MODE} to allow correct encoding - * @deprecated - * @see #MySQLCodec(org.owasp.esapi.codecs.MySQLCodec.Mode) - */ - public MySQLCodec( int mode ) { - this.mode = Mode.findByKey(mode); - } - - /** - * Instantiate the MySQL Codec with the given SQL {@link Mode}. - * @param mode The mode the target server is running in - */ - public MySQLCodec( Mode mode ) { - this.mode = mode; - } - - - /** - * {@inheritDoc} - * - * Returns quote-encoded character - * - * @param immune - */ - public String encodeCharacter( char[] immune, Character c ) { - char ch = c.charValue(); - - // check for immune characters - if ( containsCharacter( ch, immune ) ) { - return ""+ch; - } - - // check for alphanumeric characters - String hex = Codec.getHexForNonAlphanumeric( ch ); - if ( hex == null ) { - return ""+ch; - } - - switch( mode ) { - case ANSI: return encodeCharacterANSI( c ); - case STANDARD: return encodeCharacterMySQL( c ); - } - return null; - } - - /** - * encodeCharacterANSI encodes for ANSI SQL. - * - * Apostrophe is encoded - * - * Bug ###: In ANSI Mode Strings can also be passed in using the quotation. In ANSI_QUOTES mode a quotation - * is considered to be an identifier, thus cannot be used at all in a value and will be dropped completely. - * - * @param c - * character to encode - * @return - * String encoded to standards of MySQL running in ANSI mode - */ - private String encodeCharacterANSI( Character c ) { - if ( c == '\'' ) - return "\'\'"; - if ( c == '\"' ) - return ""; - return ""+c; - } - - /** - * Encode a character suitable for MySQL - * - * @param c - * Character to encode - * @return - * Encoded Character - */ - private String encodeCharacterMySQL( Character c ) { - char ch = c.charValue(); - if ( ch == 0x00 ) return "\\0"; - if ( ch == 0x08 ) return "\\b"; - if ( ch == 0x09 ) return "\\t"; - if ( ch == 0x0a ) return "\\n"; - if ( ch == 0x0d ) return "\\r"; - if ( ch == 0x1a ) return "\\Z"; - if ( ch == 0x22 ) return "\\\""; - if ( ch == 0x25 ) return "\\%"; - if ( ch == 0x27 ) return "\\'"; - if ( ch == 0x5c ) return "\\\\"; - if ( ch == 0x5f ) return "\\_"; - return "\\" + c; - } - - /** - * {@inheritDoc} - * - * Returns the decoded version of the character starting at index, or - * null if no decoding is possible. - * - * Formats all are legal (case sensitive) - * In ANSI_MODE '' decodes to ' - * In MYSQL_MODE \x decodes to x (or a small list of specials) - */ - public Character decodeCharacter( PushbackString input ) { - switch( mode ) { - case ANSI: return decodeCharacterANSI( input ); - case STANDARD: return decodeCharacterMySQL( input ); - } - return null; - } - - /** - * decodeCharacterANSI decodes the next character from ANSI SQL escaping - * - * @param input - * A PushBackString containing characters you'd like decoded - * @return - * A single character, decoded - */ - private Character decodeCharacterANSI( PushbackString input ) { - input.mark(); - Character first = input.next(); - if ( first == null ) { - input.reset(); - return null; - } - - // if this is not an encoded character, return null - if ( first.charValue() != '\'' ) { - input.reset(); - return null; - } - - Character second = input.next(); - if ( second == null ) { - input.reset(); - return null; - } - - // if this is not an encoded character, return null - if ( second.charValue() != '\'' ) { - input.reset(); - return null; - } - return( Character.valueOf( '\'' ) ); - } - - /** - * decodeCharacterMySQL decodes all the potential escaped characters that MySQL is prepared to escape - * - * @param input - * A string you'd like to be decoded - * @return - * A single character from that string, decoded. - */ - private Character decodeCharacterMySQL( PushbackString input ) { - input.mark(); - Character first = input.next(); - if ( first == null ) { - input.reset(); - return null; - } - - // if this is not an encoded character, return null - if ( first.charValue() != '\\' ) { - input.reset(); - return null; - } - - Character second = input.next(); - if ( second == null ) { - input.reset(); - return null; - } - - if ( second.charValue() == '0' ) { - return Character.valueOf( (char)0x00 ); - } else if ( second.charValue() == 'b' ) { - return Character.valueOf( (char)0x08 ); - } else if ( second.charValue() == 't' ) { - return Character.valueOf( (char)0x09 ); - } else if ( second.charValue() == 'n' ) { - return Character.valueOf( (char)0x0a ); - } else if ( second.charValue() == 'r' ) { - return Character.valueOf( (char)0x0d ); - } else if ( second.charValue() == 'z' ) { - return Character.valueOf( (char)0x1a ); - } else if ( second.charValue() == '\"' ) { - return Character.valueOf( (char)0x22 ); - } else if ( second.charValue() == '%' ) { - return Character.valueOf( (char)0x25 ); - } else if ( second.charValue() == '\'' ) { - return Character.valueOf( (char)0x27 ); - } else if ( second.charValue() == '\\' ) { - return Character.valueOf( (char)0x5c ); - } else if ( second.charValue() == '_' ) { - return Character.valueOf( (char)0x5f ); - } else { - return second; - } - } - +/** + * OWASP Enterprise Security API (ESAPI) + * + * This file is part of the Open Web Application Security Project (OWASP) + * Enterprise Security API (ESAPI) project. For details, please see + * http://www.owasp.org/index.php/ESAPI. + * + * Copyright (c) 2007 - The OWASP Foundation + * + * The ESAPI is published by OWASP under the BSD license. You should read and accept the + * LICENSE before you use, modify, and/or redistribute this software. + * + * @author Jeff Williams Aspect Security + * @created 2007 + */ +package org.owasp.esapi.codecs; + + + +/** + * Implementation of the Codec interface for MySQL strings. See http://mirror.yandex.ru/mirrors/ftp.mysql.com/doc/refman/5.0/en/string-syntax.html + * for more information. + * + * @author Jeff Williams (jeff.williams .at. aspectsecurity.com) Aspect Security + * @since June 1, 2007 + * @see org.owasp.esapi.Encoder + */ +public class MySQLCodec extends Codec { + /** + * Specifies the SQL Mode the target MySQL Server is running with. For details about MySQL Server Modes + * please see the Manual at {@link http://dev.mysql.com/doc/refman/5.0/en/server-sql-mode.html#sqlmode_ansi} + * + * Currently the only supported modes are: + * ANSI + * STANDARD + */ + public static enum Mode { + ANSI(1),STANDARD(0); + + private int key; + private Mode(int key) { this.key = key; } + + static Mode findByKey(int key) { + for ( Mode m : values() ) { + if ( m.key == key ) + return m; + } + return null; + } + } + + /** Target MySQL Server is running in Standard MySQL (Default) mode. */ + public static final int MYSQL_MODE = 0; + /** Target MySQL Server is running in {@link "http://dev.mysql.com/doc/refman/5.0/en/ansi-mode.html"} ANSI Mode */ + public static final int ANSI_MODE = 1; + + //private int mode = 0; + private Mode mode; + + /** + * Instantiate the MySQL codec + * + * @param mode + * Mode has to be one of {MYSQL_MODE|ANSI_MODE} to allow correct encoding + * @deprecated + * @see #MySQLCodec(org.owasp.esapi.codecs.MySQLCodec.Mode) + */ + public MySQLCodec( int mode ) { + this.mode = Mode.findByKey(mode); + } + + /** + * Instantiate the MySQL Codec with the given SQL {@link Mode}. + * @param mode The mode the target server is running in + */ + public MySQLCodec( Mode mode ) { + this.mode = mode; + } + + + /** + * {@inheritDoc} + * + * Returns quote-encoded character + * + * @param immune + */ + public String encodeCharacter( char[] immune, Character c ) { + char ch = c.charValue(); + + // check for immune characters + if ( containsCharacter( ch, immune ) ) { + return ""+ch; + } + + // check for alphanumeric characters + String hex = Codec.getHexForNonAlphanumeric( ch ); + if ( hex == null ) { + return ""+ch; + } + + switch( mode ) { + case ANSI: return encodeCharacterANSI( c ); + case STANDARD: return encodeCharacterMySQL( c ); + } + return null; + } + + /** + * encodeCharacterANSI encodes for ANSI SQL. + * + * Apostrophe is encoded + * + * Bug ###: In ANSI Mode Strings can also be passed in using the quotation. In ANSI_QUOTES mode a quotation + * is considered to be an identifier, thus cannot be used at all in a value and will be dropped completely. + * + * @param c + * character to encode + * @return + * String encoded to standards of MySQL running in ANSI mode + */ + private String encodeCharacterANSI( Character c ) { + if ( c == '\'' ) + return "\'\'"; + if ( c == '\"' ) + return ""; + return ""+c; + } + + /** + * Encode a character suitable for MySQL + * + * @param c + * Character to encode + * @return + * Encoded Character + */ + private String encodeCharacterMySQL( Character c ) { + char ch = c.charValue(); + if ( ch == 0x00 ) return "\\0"; + if ( ch == 0x08 ) return "\\b"; + if ( ch == 0x09 ) return "\\t"; + if ( ch == 0x0a ) return "\\n"; + if ( ch == 0x0d ) return "\\r"; + if ( ch == 0x1a ) return "\\Z"; + if ( ch == 0x22 ) return "\\\""; + if ( ch == 0x25 ) return "\\%"; + if ( ch == 0x27 ) return "\\'"; + if ( ch == 0x5c ) return "\\\\"; + if ( ch == 0x5f ) return "\\_"; + return "\\" + c; + } + + /** + * {@inheritDoc} + * + * Returns the decoded version of the character starting at index, or + * null if no decoding is possible. + * + * Formats all are legal (case sensitive) + * In ANSI_MODE '' decodes to ' + * In MYSQL_MODE \x decodes to x (or a small list of specials) + */ + public Character decodeCharacter( PushbackString input ) { + switch( mode ) { + case ANSI: return decodeCharacterANSI( input ); + case STANDARD: return decodeCharacterMySQL( input ); + } + return null; + } + + /** + * decodeCharacterANSI decodes the next character from ANSI SQL escaping + * + * @param input + * A PushBackString containing characters you'd like decoded + * @return + * A single character, decoded + */ + private Character decodeCharacterANSI( PushbackString input ) { + input.mark(); + Character first = input.next(); + if ( first == null ) { + input.reset(); + return null; + } + + // if this is not an encoded character, return null + if ( first.charValue() != '\'' ) { + input.reset(); + return null; + } + + Character second = input.next(); + if ( second == null ) { + input.reset(); + return null; + } + + // if this is not an encoded character, return null + if ( second.charValue() != '\'' ) { + input.reset(); + return null; + } + return( Character.valueOf( '\'' ) ); + } + + /** + * decodeCharacterMySQL decodes all the potential escaped characters that MySQL is prepared to escape + * + * @param input + * A string you'd like to be decoded + * @return + * A single character from that string, decoded. + */ + private Character decodeCharacterMySQL( PushbackString input ) { + input.mark(); + Character first = input.next(); + if ( first == null ) { + input.reset(); + return null; + } + + // if this is not an encoded character, return null + if ( first.charValue() != '\\' ) { + input.reset(); + return null; + } + + Character second = input.next(); + if ( second == null ) { + input.reset(); + return null; + } + + if ( second.charValue() == '0' ) { + return Character.valueOf( (char)0x00 ); + } else if ( second.charValue() == 'b' ) { + return Character.valueOf( (char)0x08 ); + } else if ( second.charValue() == 't' ) { + return Character.valueOf( (char)0x09 ); + } else if ( second.charValue() == 'n' ) { + return Character.valueOf( (char)0x0a ); + } else if ( second.charValue() == 'r' ) { + return Character.valueOf( (char)0x0d ); + } else if ( second.charValue() == 'z' ) { + return Character.valueOf( (char)0x1a ); + } else if ( second.charValue() == '\"' ) { + return Character.valueOf( (char)0x22 ); + } else if ( second.charValue() == '%' ) { + return Character.valueOf( (char)0x25 ); + } else if ( second.charValue() == '\'' ) { + return Character.valueOf( (char)0x27 ); + } else if ( second.charValue() == '\\' ) { + return Character.valueOf( (char)0x5c ); + } else if ( second.charValue() == '_' ) { + return Character.valueOf( (char)0x5f ); + } else { + return second; + } + } + } \ No newline at end of file From 0911b97f567a804d15c3b537e6d208abc747a364 Mon Sep 17 00:00:00 2001 From: kwwall Date: Mon, 18 Jan 2016 23:33:48 -0500 Subject: [PATCH 098/812] Change CRLF to LF for issue 356. --- .../org/owasp/esapi/codecs/OracleCodec.java | 178 +++++++++--------- 1 file changed, 89 insertions(+), 89 deletions(-) diff --git a/src/main/java/org/owasp/esapi/codecs/OracleCodec.java b/src/main/java/org/owasp/esapi/codecs/OracleCodec.java index 953fece04..540920d24 100644 --- a/src/main/java/org/owasp/esapi/codecs/OracleCodec.java +++ b/src/main/java/org/owasp/esapi/codecs/OracleCodec.java @@ -1,90 +1,90 @@ -/** - * OWASP Enterprise Security API (ESAPI) - * - * This file is part of the Open Web Application Security Project (OWASP) - * Enterprise Security API (ESAPI) project. For details, please see - * http://www.owasp.org/index.php/ESAPI. - * - * Copyright (c) 2007 - The OWASP Foundation - * - * The ESAPI is published by OWASP under the BSD license. You should read and accept the - * LICENSE before you use, modify, and/or redistribute this software. - * - * @author Jeff Williams Aspect Security - * @created 2007 - */ -package org.owasp.esapi.codecs; - - - -/** - * Implementation of the Codec interface for Oracle strings. This function will only protect you from SQLi in the case of user data - * bring placed within an Oracle quoted string such as: - * - * select * from table where user_name=' USERDATA '; - * - * @see how-to-escape-single-quotes-in-strings - * - * @author Jeff Williams (jeff.williams .at. aspectsecurity.com) Aspect Security - * @author Jim Manico (jim@manico.net) Manico.net - * @since June 1, 2007 - * @see org.owasp.esapi.Encoder - */ -public class OracleCodec extends Codec { - - - /** - * {@inheritDoc} - * - * Encodes ' to '' - * - * Encodes ' to '' - * - * @param immune - */ - public String encodeCharacter( char[] immune, Character c ) { - if ( c.charValue() == '\'' ) - return "\'\'"; - return ""+c; - } - - - - /** - * {@inheritDoc} - * - * Returns the decoded version of the character starting at index, or - * null if no decoding is possible. - * - * Formats all are legal - * '' decodes to ' - */ - public Character decodeCharacter( PushbackString input ) { - input.mark(); - Character first = input.next(); - if ( first == null ) { - input.reset(); - return null; - } - - // if this is not an encoded character, return null - if ( first.charValue() != '\'' ) { - input.reset(); - return null; - } - - Character second = input.next(); - if ( second == null ) { - input.reset(); - return null; - } - - // if this is not an encoded character, return null - if ( second.charValue() != '\'' ) { - input.reset(); - return null; - } - return( Character.valueOf( '\'' ) ); - } - +/** + * OWASP Enterprise Security API (ESAPI) + * + * This file is part of the Open Web Application Security Project (OWASP) + * Enterprise Security API (ESAPI) project. For details, please see + * http://www.owasp.org/index.php/ESAPI. + * + * Copyright (c) 2007 - The OWASP Foundation + * + * The ESAPI is published by OWASP under the BSD license. You should read and accept the + * LICENSE before you use, modify, and/or redistribute this software. + * + * @author Jeff Williams Aspect Security + * @created 2007 + */ +package org.owasp.esapi.codecs; + + + +/** + * Implementation of the Codec interface for Oracle strings. This function will only protect you from SQLi in the case of user data + * bring placed within an Oracle quoted string such as: + * + * select * from table where user_name=' USERDATA '; + * + * @see how-to-escape-single-quotes-in-strings + * + * @author Jeff Williams (jeff.williams .at. aspectsecurity.com) Aspect Security + * @author Jim Manico (jim@manico.net) Manico.net + * @since June 1, 2007 + * @see org.owasp.esapi.Encoder + */ +public class OracleCodec extends Codec { + + + /** + * {@inheritDoc} + * + * Encodes ' to '' + * + * Encodes ' to '' + * + * @param immune + */ + public String encodeCharacter( char[] immune, Character c ) { + if ( c.charValue() == '\'' ) + return "\'\'"; + return ""+c; + } + + + + /** + * {@inheritDoc} + * + * Returns the decoded version of the character starting at index, or + * null if no decoding is possible. + * + * Formats all are legal + * '' decodes to ' + */ + public Character decodeCharacter( PushbackString input ) { + input.mark(); + Character first = input.next(); + if ( first == null ) { + input.reset(); + return null; + } + + // if this is not an encoded character, return null + if ( first.charValue() != '\'' ) { + input.reset(); + return null; + } + + Character second = input.next(); + if ( second == null ) { + input.reset(); + return null; + } + + // if this is not an encoded character, return null + if ( second.charValue() != '\'' ) { + input.reset(); + return null; + } + return( Character.valueOf( '\'' ) ); + } + } \ No newline at end of file From 6fa2265647a8b56f86f39c55c118234d79c24ac3 Mon Sep 17 00:00:00 2001 From: kwwall Date: Mon, 18 Jan 2016 23:33:48 -0500 Subject: [PATCH 099/812] Change CRLF to LF for issue 356. --- .../org/owasp/esapi/codecs/PercentCodec.java | 308 +++++++++--------- 1 file changed, 154 insertions(+), 154 deletions(-) diff --git a/src/main/java/org/owasp/esapi/codecs/PercentCodec.java b/src/main/java/org/owasp/esapi/codecs/PercentCodec.java index 307da471a..3d1e76a86 100644 --- a/src/main/java/org/owasp/esapi/codecs/PercentCodec.java +++ b/src/main/java/org/owasp/esapi/codecs/PercentCodec.java @@ -1,154 +1,154 @@ -/** - * OWASP Enterprise Security API (ESAPI) - * - * This file is part of the Open Web Application Security Project (OWASP) - * Enterprise Security API (ESAPI) project. For details, please see - * http://www.owasp.org/index.php/ESAPI. - * - * Copyright (c) 2007 - The OWASP Foundation - * - * The ESAPI is published by OWASP under the BSD license. You should read and accept the - * LICENSE before you use, modify, and/or redistribute this software. - * - * @author Jeff Williams Aspect Security - * @created 2007 - */ -package org.owasp.esapi.codecs; - -import java.io.UnsupportedEncodingException; -import java.util.Set; - -import org.owasp.esapi.util.CollectionsUtil; - -/** - * Implementation of the Codec interface for percent encoding (aka URL encoding). - * - * @author Jeff Williams (jeff.williams .at. aspectsecurity.com) Aspect Security - * @since June 1, 2007 - * @see org.owasp.esapi.Encoder - */ -public class PercentCodec extends Codec -{ - private static final String ALPHA_NUMERIC_STR = "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789"; - @SuppressWarnings("unused") - private static final String RFC3986_RESERVED_STR = ":/?#[]@!$&'()*+,;="; - private static final String RFC3986_NON_ALPHANUMERIC_UNRESERVED_STR = "-._~"; - // rfc3986 2.3: For consistency, percent-encoded octets - // in the ranges of ALPHA (%41-%5A and %61-%7A), DIGIT - // (%30-%39), hyphen (%2D), period (%2E), underscore - // (%5F), or tilde (%7E) should not be created by URI - // producers - private static final boolean ENCODED_NON_ALPHA_NUMERIC_UNRESERVED = true; - private static final String UNENCODED_STR = ALPHA_NUMERIC_STR + - (ENCODED_NON_ALPHA_NUMERIC_UNRESERVED ? "" : RFC3986_NON_ALPHANUMERIC_UNRESERVED_STR); - private static final Set UNENCODED_SET = CollectionsUtil.strToUnmodifiableSet(UNENCODED_STR); - - /** - * Convinence method to encode a string into UTF-8. This - * wraps the {@link UnsupportedEncodingException} that - * {@link String#getBytes(String)} throws in a - * {@link IllegalStateException} as UTF-8 support is required - * by the Java spec and should never throw this exception. - * @param str the string to encode - * @return str encoded in UTF-8 as bytes. - * @throws IllegalStateException wrapped {@link - * UnsupportedEncodingException} if - * {@link String.getBytes(String)} throws it. - */ - private static byte[] toUtf8Bytes(String str) - { - try - { - return str.getBytes("UTF-8"); - } - catch(UnsupportedEncodingException e) - { - throw new IllegalStateException("The Java spec requires UTF-8 support.", e); - } - } - - /** - * Append the two upper case hex characters for a byte. - * @param sb The string buffer to append to. - * @param b The byte to hexify - * @return sb with the hex characters appended. - */ - // rfc3986 2.1: For consistency, URI producers - // should use uppercase hexadecimal digits for all percent- - // encodings. - private static StringBuilder appendTwoUpperHex(StringBuilder sb, int b) - { - if(b < Byte.MIN_VALUE || b > Byte.MAX_VALUE) - throw new IllegalArgumentException("b is not a byte (was " + b + ')'); - b &= 0xFF; - if(b<0x10) - sb.append('0'); - return sb.append(Integer.toHexString(b).toUpperCase()); - } - - /** - * Encode a character for URLs - * @param immune characters not to encode - * @param c character to encode - * @return the encoded string representing c - */ - public String encodeCharacter( char[] immune, Character c ) - { - String cStr = String.valueOf(c.charValue()); - byte[] bytes; - StringBuilder sb; - - if(UNENCODED_SET.contains(c)) - return cStr; - - bytes = toUtf8Bytes(cStr); - sb = new StringBuilder(bytes.length * 3); - for(byte b : bytes) - appendTwoUpperHex(sb.append('%'), b); - return sb.toString(); - } - - /** - * {@inheritDoc} - * - * Formats all are legal both upper/lower case: - * %hh; - * - * @param input - * encoded character using percent characters (such as URL encoding) - */ - public Character decodeCharacter( PushbackString input ) { - input.mark(); - Character first = input.next(); - if ( first == null ) { - input.reset(); - return null; - } - - // if this is not an encoded character, return null - if (first != '%' ) { - input.reset(); - return null; - } - - // Search for exactly 2 hex digits following - StringBuilder sb = new StringBuilder(); - for ( int i=0; i<2; i++ ) { - Character c = input.nextHex(); - if ( c != null ) sb.append( c ); - } - if ( sb.length() == 2 ) { - try { - // parse the hex digit and create a character - int i = Integer.parseInt(sb.toString(), 16); - if (Character.isValidCodePoint(i)) { - return (char) i; - } - } catch( NumberFormatException ignored ) { } - } - input.reset(); - return null; - } - -} +/** + * OWASP Enterprise Security API (ESAPI) + * + * This file is part of the Open Web Application Security Project (OWASP) + * Enterprise Security API (ESAPI) project. For details, please see + * http://www.owasp.org/index.php/ESAPI. + * + * Copyright (c) 2007 - The OWASP Foundation + * + * The ESAPI is published by OWASP under the BSD license. You should read and accept the + * LICENSE before you use, modify, and/or redistribute this software. + * + * @author Jeff Williams Aspect Security + * @created 2007 + */ +package org.owasp.esapi.codecs; + +import java.io.UnsupportedEncodingException; +import java.util.Set; + +import org.owasp.esapi.util.CollectionsUtil; + +/** + * Implementation of the Codec interface for percent encoding (aka URL encoding). + * + * @author Jeff Williams (jeff.williams .at. aspectsecurity.com) Aspect Security + * @since June 1, 2007 + * @see org.owasp.esapi.Encoder + */ +public class PercentCodec extends Codec +{ + private static final String ALPHA_NUMERIC_STR = "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789"; + @SuppressWarnings("unused") + private static final String RFC3986_RESERVED_STR = ":/?#[]@!$&'()*+,;="; + private static final String RFC3986_NON_ALPHANUMERIC_UNRESERVED_STR = "-._~"; + // rfc3986 2.3: For consistency, percent-encoded octets + // in the ranges of ALPHA (%41-%5A and %61-%7A), DIGIT + // (%30-%39), hyphen (%2D), period (%2E), underscore + // (%5F), or tilde (%7E) should not be created by URI + // producers + private static final boolean ENCODED_NON_ALPHA_NUMERIC_UNRESERVED = true; + private static final String UNENCODED_STR = ALPHA_NUMERIC_STR + + (ENCODED_NON_ALPHA_NUMERIC_UNRESERVED ? "" : RFC3986_NON_ALPHANUMERIC_UNRESERVED_STR); + private static final Set UNENCODED_SET = CollectionsUtil.strToUnmodifiableSet(UNENCODED_STR); + + /** + * Convinence method to encode a string into UTF-8. This + * wraps the {@link UnsupportedEncodingException} that + * {@link String#getBytes(String)} throws in a + * {@link IllegalStateException} as UTF-8 support is required + * by the Java spec and should never throw this exception. + * @param str the string to encode + * @return str encoded in UTF-8 as bytes. + * @throws IllegalStateException wrapped {@link + * UnsupportedEncodingException} if + * {@link String.getBytes(String)} throws it. + */ + private static byte[] toUtf8Bytes(String str) + { + try + { + return str.getBytes("UTF-8"); + } + catch(UnsupportedEncodingException e) + { + throw new IllegalStateException("The Java spec requires UTF-8 support.", e); + } + } + + /** + * Append the two upper case hex characters for a byte. + * @param sb The string buffer to append to. + * @param b The byte to hexify + * @return sb with the hex characters appended. + */ + // rfc3986 2.1: For consistency, URI producers + // should use uppercase hexadecimal digits for all percent- + // encodings. + private static StringBuilder appendTwoUpperHex(StringBuilder sb, int b) + { + if(b < Byte.MIN_VALUE || b > Byte.MAX_VALUE) + throw new IllegalArgumentException("b is not a byte (was " + b + ')'); + b &= 0xFF; + if(b<0x10) + sb.append('0'); + return sb.append(Integer.toHexString(b).toUpperCase()); + } + + /** + * Encode a character for URLs + * @param immune characters not to encode + * @param c character to encode + * @return the encoded string representing c + */ + public String encodeCharacter( char[] immune, Character c ) + { + String cStr = String.valueOf(c.charValue()); + byte[] bytes; + StringBuilder sb; + + if(UNENCODED_SET.contains(c)) + return cStr; + + bytes = toUtf8Bytes(cStr); + sb = new StringBuilder(bytes.length * 3); + for(byte b : bytes) + appendTwoUpperHex(sb.append('%'), b); + return sb.toString(); + } + + /** + * {@inheritDoc} + * + * Formats all are legal both upper/lower case: + * %hh; + * + * @param input + * encoded character using percent characters (such as URL encoding) + */ + public Character decodeCharacter( PushbackString input ) { + input.mark(); + Character first = input.next(); + if ( first == null ) { + input.reset(); + return null; + } + + // if this is not an encoded character, return null + if (first != '%' ) { + input.reset(); + return null; + } + + // Search for exactly 2 hex digits following + StringBuilder sb = new StringBuilder(); + for ( int i=0; i<2; i++ ) { + Character c = input.nextHex(); + if ( c != null ) sb.append( c ); + } + if ( sb.length() == 2 ) { + try { + // parse the hex digit and create a character + int i = Integer.parseInt(sb.toString(), 16); + if (Character.isValidCodePoint(i)) { + return (char) i; + } + } catch( NumberFormatException ignored ) { } + } + input.reset(); + return null; + } + +} From 327964c8b1433a959c534b7507cefdc38973776d Mon Sep 17 00:00:00 2001 From: kwwall Date: Mon, 18 Jan 2016 23:33:48 -0500 Subject: [PATCH 100/812] Change CRLF to LF for issue 356. --- .../owasp/esapi/codecs/PushbackString.java | 368 +++++++++--------- 1 file changed, 184 insertions(+), 184 deletions(-) diff --git a/src/main/java/org/owasp/esapi/codecs/PushbackString.java b/src/main/java/org/owasp/esapi/codecs/PushbackString.java index d218eb932..1119b223c 100644 --- a/src/main/java/org/owasp/esapi/codecs/PushbackString.java +++ b/src/main/java/org/owasp/esapi/codecs/PushbackString.java @@ -1,185 +1,185 @@ -/** - * OWASP Enterprise Security API (ESAPI) - * - * This file is part of the Open Web Application Security Project (OWASP) - * Enterprise Security API (ESAPI) project. For details, please see - * http://www.owasp.org/index.php/ESAPI. - * - * Copyright (c) 2007 - The OWASP Foundation - * - * The ESAPI is published by OWASP under the BSD license. You should read and accept the - * LICENSE before you use, modify, and/or redistribute this software. - * - * @author Jeff Williams Aspect Security - * @created 2007 - */ -package org.owasp.esapi.codecs; - - -/** - * The pushback string is used by Codecs to allow them to push decoded characters back onto a string - * for further decoding. This is necessary to detect double-encoding. - * - * @author Jeff Williams (jeff.williams .at. aspectsecurity.com) Aspect Security - * @since June 1, 2007 - * @see org.owasp.esapi.Encoder - */ -public class PushbackString { - - private String input; - private Character pushback; - private Character temp; - private int index = 0; - private int mark = 0; - - /** - * - * @param input - */ - public PushbackString( String input ) { - this.input = input; - } - - /** - * - * @param c - */ - public void pushback( Character c ) { - pushback = c; - } - - - /** - * Get the current index of the PushbackString. Typically used in error messages. - * @return The current index of the PushbackString. - */ - public int index() { - return index; - } - - /** - * - * @return - */ - public boolean hasNext() { - if ( pushback != null ) return true; - if ( input == null ) return false; - if ( input.length() == 0 ) return false; - if ( index >= input.length() ) return false; - return true; - } - - /** - * - * @return - */ - public Character next() { - if ( pushback != null ) { - Character save = pushback; - pushback = null; - return save; - } - if ( input == null ) return null; - if ( input.length() == 0 ) return null; - if ( index >= input.length() ) return null; - return Character.valueOf( input.charAt(index++) ); - } - - /** - * - * @return - */ - public Character nextHex() { - Character c = next(); - if ( c == null ) return null; - if ( isHexDigit( c ) ) return c; - return null; - } - - /** - * - * @return - */ - public Character nextOctal() { - Character c = next(); - if ( c == null ) return null; - if ( isOctalDigit( c ) ) return c; - return null; - } - - /** - * Returns true if the parameter character is a hexidecimal digit 0 through 9, a through f, or A through F. - * @param c - * @return - */ - public static boolean isHexDigit( Character c ) { - if ( c == null ) return false; - char ch = c.charValue(); - return (ch >= '0' && ch <= '9' ) || (ch >= 'a' && ch <= 'f' ) || (ch >= 'A' && ch <= 'F' ); - } - - /** - * Returns true if the parameter character is an octal digit 0 through 7. - * @param c - * @return - */ -public static boolean isOctalDigit( Character c ) { - if ( c == null ) return false; - char ch = c.charValue(); - return ch >= '0' && ch <= '7'; -} - - /** - * Return the next character without affecting the current index. - * @return - */ - public Character peek() { - if ( pushback != null ) return pushback; - if ( input == null ) return null; - if ( input.length() == 0 ) return null; - if ( index >= input.length() ) return null; - return Character.valueOf( input.charAt(index) ); - } - - /** - * Test to see if the next character is a particular value without affecting the current index. - * @param c - * @return - */ - public boolean peek( char c ) { - if ( pushback != null && pushback.charValue() == c ) return true; - if ( input == null ) return false; - if ( input.length() == 0 ) return false; - if ( index >= input.length() ) return false; - return input.charAt(index) == c; - } - - /** - * - */ - public void mark() { - temp = pushback; - mark = index; - } - - /** - * - */ - public void reset() { - pushback = temp; - index = mark; - } - - /** - * - * @return - */ - protected String remainder() { - String output = input.substring( index ); - if ( pushback != null ) { - output = pushback + output; - } - return output; - } +/** + * OWASP Enterprise Security API (ESAPI) + * + * This file is part of the Open Web Application Security Project (OWASP) + * Enterprise Security API (ESAPI) project. For details, please see + * http://www.owasp.org/index.php/ESAPI. + * + * Copyright (c) 2007 - The OWASP Foundation + * + * The ESAPI is published by OWASP under the BSD license. You should read and accept the + * LICENSE before you use, modify, and/or redistribute this software. + * + * @author Jeff Williams Aspect Security + * @created 2007 + */ +package org.owasp.esapi.codecs; + + +/** + * The pushback string is used by Codecs to allow them to push decoded characters back onto a string + * for further decoding. This is necessary to detect double-encoding. + * + * @author Jeff Williams (jeff.williams .at. aspectsecurity.com) Aspect Security + * @since June 1, 2007 + * @see org.owasp.esapi.Encoder + */ +public class PushbackString { + + private String input; + private Character pushback; + private Character temp; + private int index = 0; + private int mark = 0; + + /** + * + * @param input + */ + public PushbackString( String input ) { + this.input = input; + } + + /** + * + * @param c + */ + public void pushback( Character c ) { + pushback = c; + } + + + /** + * Get the current index of the PushbackString. Typically used in error messages. + * @return The current index of the PushbackString. + */ + public int index() { + return index; + } + + /** + * + * @return + */ + public boolean hasNext() { + if ( pushback != null ) return true; + if ( input == null ) return false; + if ( input.length() == 0 ) return false; + if ( index >= input.length() ) return false; + return true; + } + + /** + * + * @return + */ + public Character next() { + if ( pushback != null ) { + Character save = pushback; + pushback = null; + return save; + } + if ( input == null ) return null; + if ( input.length() == 0 ) return null; + if ( index >= input.length() ) return null; + return Character.valueOf( input.charAt(index++) ); + } + + /** + * + * @return + */ + public Character nextHex() { + Character c = next(); + if ( c == null ) return null; + if ( isHexDigit( c ) ) return c; + return null; + } + + /** + * + * @return + */ + public Character nextOctal() { + Character c = next(); + if ( c == null ) return null; + if ( isOctalDigit( c ) ) return c; + return null; + } + + /** + * Returns true if the parameter character is a hexidecimal digit 0 through 9, a through f, or A through F. + * @param c + * @return + */ + public static boolean isHexDigit( Character c ) { + if ( c == null ) return false; + char ch = c.charValue(); + return (ch >= '0' && ch <= '9' ) || (ch >= 'a' && ch <= 'f' ) || (ch >= 'A' && ch <= 'F' ); + } + + /** + * Returns true if the parameter character is an octal digit 0 through 7. + * @param c + * @return + */ +public static boolean isOctalDigit( Character c ) { + if ( c == null ) return false; + char ch = c.charValue(); + return ch >= '0' && ch <= '7'; +} + + /** + * Return the next character without affecting the current index. + * @return + */ + public Character peek() { + if ( pushback != null ) return pushback; + if ( input == null ) return null; + if ( input.length() == 0 ) return null; + if ( index >= input.length() ) return null; + return Character.valueOf( input.charAt(index) ); + } + + /** + * Test to see if the next character is a particular value without affecting the current index. + * @param c + * @return + */ + public boolean peek( char c ) { + if ( pushback != null && pushback.charValue() == c ) return true; + if ( input == null ) return false; + if ( input.length() == 0 ) return false; + if ( index >= input.length() ) return false; + return input.charAt(index) == c; + } + + /** + * + */ + public void mark() { + temp = pushback; + mark = index; + } + + /** + * + */ + public void reset() { + pushback = temp; + index = mark; + } + + /** + * + * @return + */ + protected String remainder() { + String output = input.substring( index ); + if ( pushback != null ) { + output = pushback + output; + } + return output; + } } \ No newline at end of file From a1ebee77067751fa133ef764f4f7147749c4fb69 Mon Sep 17 00:00:00 2001 From: kwwall Date: Mon, 18 Jan 2016 23:33:48 -0500 Subject: [PATCH 101/812] Change CRLF to LF for issue 356. --- .../org/owasp/esapi/codecs/UnixCodec.java | 162 +++++++++--------- 1 file changed, 81 insertions(+), 81 deletions(-) diff --git a/src/main/java/org/owasp/esapi/codecs/UnixCodec.java b/src/main/java/org/owasp/esapi/codecs/UnixCodec.java index 19ecc80ca..489cf073b 100644 --- a/src/main/java/org/owasp/esapi/codecs/UnixCodec.java +++ b/src/main/java/org/owasp/esapi/codecs/UnixCodec.java @@ -1,82 +1,82 @@ -/** - * OWASP Enterprise Security API (ESAPI) - * - * This file is part of the Open Web Application Security Project (OWASP) - * Enterprise Security API (ESAPI) project. For details, please see - * http://www.owasp.org/index.php/ESAPI. - * - * Copyright (c) 2007 - The OWASP Foundation - * - * The ESAPI is published by OWASP under the BSD license. You should read and accept the - * LICENSE before you use, modify, and/or redistribute this software. - * - * @author Jeff Williams Aspect Security - * @created 2007 - */ -package org.owasp.esapi.codecs; - - -/** - * Implementation of the Codec interface for '\' encoding from Unix command shell. - * - * @author Jeff Williams (jeff.williams .at. aspectsecurity.com) Aspect Security - * @since June 1, 2007 - * @see org.owasp.esapi.Encoder - */ -public class UnixCodec extends Codec { - - /** - * {@inheritDoc} - * - * Returns backslash-encoded character - * - * @param immune - */ - public String encodeCharacter( char[] immune, Character c ) { - char ch = c.charValue(); - - // check for immune characters - if ( containsCharacter( ch, immune ) ) { - return ""+ch; - } - - // check for alphanumeric characters - String hex = Codec.getHexForNonAlphanumeric( ch ); - if ( hex == null ) { - return ""+ch; - } - - return "\\" + c; - } - - - /** - * {@inheritDoc} - * - * Returns the decoded version of the character starting at index, or - * null if no decoding is possible. - *

    - * Formats all are legal both upper/lower case: - * \x - all special characters - * - */ - public Character decodeCharacter( PushbackString input ) { - input.mark(); - Character first = input.next(); - if ( first == null ) { - input.reset(); - return null; - } - - // if this is not an encoded character, return null - if ( first.charValue() != '\\' ) { - input.reset(); - return null; - } - - Character second = input.next(); - return second; - } - +/** + * OWASP Enterprise Security API (ESAPI) + * + * This file is part of the Open Web Application Security Project (OWASP) + * Enterprise Security API (ESAPI) project. For details, please see + * http://www.owasp.org/index.php/ESAPI. + * + * Copyright (c) 2007 - The OWASP Foundation + * + * The ESAPI is published by OWASP under the BSD license. You should read and accept the + * LICENSE before you use, modify, and/or redistribute this software. + * + * @author Jeff Williams Aspect Security + * @created 2007 + */ +package org.owasp.esapi.codecs; + + +/** + * Implementation of the Codec interface for '\' encoding from Unix command shell. + * + * @author Jeff Williams (jeff.williams .at. aspectsecurity.com) Aspect Security + * @since June 1, 2007 + * @see org.owasp.esapi.Encoder + */ +public class UnixCodec extends Codec { + + /** + * {@inheritDoc} + * + * Returns backslash-encoded character + * + * @param immune + */ + public String encodeCharacter( char[] immune, Character c ) { + char ch = c.charValue(); + + // check for immune characters + if ( containsCharacter( ch, immune ) ) { + return ""+ch; + } + + // check for alphanumeric characters + String hex = Codec.getHexForNonAlphanumeric( ch ); + if ( hex == null ) { + return ""+ch; + } + + return "\\" + c; + } + + + /** + * {@inheritDoc} + * + * Returns the decoded version of the character starting at index, or + * null if no decoding is possible. + *

    + * Formats all are legal both upper/lower case: + * \x - all special characters + * + */ + public Character decodeCharacter( PushbackString input ) { + input.mark(); + Character first = input.next(); + if ( first == null ) { + input.reset(); + return null; + } + + // if this is not an encoded character, return null + if ( first.charValue() != '\\' ) { + input.reset(); + return null; + } + + Character second = input.next(); + return second; + } + } \ No newline at end of file From 2ee8a833875a63a7c8d4f745ab9c32e16e551bc3 Mon Sep 17 00:00:00 2001 From: kwwall Date: Mon, 18 Jan 2016 23:33:48 -0500 Subject: [PATCH 102/812] Change CRLF to LF for issue 356. --- .../org/owasp/esapi/codecs/VBScriptCodec.java | 232 +++++++++--------- 1 file changed, 116 insertions(+), 116 deletions(-) diff --git a/src/main/java/org/owasp/esapi/codecs/VBScriptCodec.java b/src/main/java/org/owasp/esapi/codecs/VBScriptCodec.java index 2dccbbd81..31442127a 100644 --- a/src/main/java/org/owasp/esapi/codecs/VBScriptCodec.java +++ b/src/main/java/org/owasp/esapi/codecs/VBScriptCodec.java @@ -1,117 +1,117 @@ -/** - * OWASP Enterprise Security API (ESAPI) - * - * This file is part of the Open Web Application Security Project (OWASP) - * Enterprise Security API (ESAPI) project. For details, please see - * http://www.owasp.org/index.php/ESAPI. - * - * Copyright (c) 2007 - The OWASP Foundation - * - * The ESAPI is published by OWASP under the BSD license. You should read and accept the - * LICENSE before you use, modify, and/or redistribute this software. - * - * @author Jeff Williams Aspect Security - * @created 2007 - */ -package org.owasp.esapi.codecs; - -import org.owasp.esapi.EncoderConstants; - - -/** - * Implementation of the Codec interface for 'quote' encoding from VBScript. - * - * @author Jeff Williams (jeff.williams .at. aspectsecurity.com) Aspect Security - * @since June 1, 2007 - * @see org.owasp.esapi.Encoder - */ -public class VBScriptCodec extends Codec { - - /** - * Encode a String so that it can be safely used in a specific context. - * - * @param immune - * @param input - * the String to encode - * @return the encoded String - */ - public String encode(char[] immune, String input) { - StringBuilder sb = new StringBuilder(); - boolean encoding = false; - boolean inquotes = false; - for ( int i=0; i 0 ) sb.append( "&" ); - if ( !inquotes && i > 0 ) sb.append( "\"" ); - sb.append( c ); - inquotes = true; - encoding = false; - - // handle characters that need encoding - } else { - if ( inquotes && i < input.length() ) sb.append( "\"" ); - if ( i > 0 ) sb.append( "&" ); - sb.append( encodeCharacter( immune, Character.valueOf( c ) ) ); - inquotes = false; - encoding = true; - } - } - return sb.toString(); - } - - - /** - * Returns quote-encoded character - * - * @param immune - */ - public String encodeCharacter( char[] immune, Character c ) { - char ch = c.charValue(); - - // check for immune characters - if ( containsCharacter( ch, immune ) ) { - return ""+ch; - } - - // check for alphanumeric characters - String hex = Codec.getHexForNonAlphanumeric( ch ); - if ( hex == null ) { - return ""+ch; - } - - return "chrw(" + (int)c.charValue() + ")"; - } - - - - /** - * Returns the decoded version of the character starting at index, or - * null if no decoding is possible. - * - * Formats all are legal both upper/lower case: - * "x - all special characters - * " + chr(x) + " - not supported yet - */ - public Character decodeCharacter( PushbackString input ) { - input.mark(); - Character first = input.next(); - if ( first == null ) { - input.reset(); - return null; - } - - // if this is not an encoded character, return null - if ( first.charValue() != '\"' ) { - input.reset(); - return null; - } - - Character second = input.next(); - return second; - } - +/** + * OWASP Enterprise Security API (ESAPI) + * + * This file is part of the Open Web Application Security Project (OWASP) + * Enterprise Security API (ESAPI) project. For details, please see + * http://www.owasp.org/index.php/ESAPI. + * + * Copyright (c) 2007 - The OWASP Foundation + * + * The ESAPI is published by OWASP under the BSD license. You should read and accept the + * LICENSE before you use, modify, and/or redistribute this software. + * + * @author Jeff Williams Aspect Security + * @created 2007 + */ +package org.owasp.esapi.codecs; + +import org.owasp.esapi.EncoderConstants; + + +/** + * Implementation of the Codec interface for 'quote' encoding from VBScript. + * + * @author Jeff Williams (jeff.williams .at. aspectsecurity.com) Aspect Security + * @since June 1, 2007 + * @see org.owasp.esapi.Encoder + */ +public class VBScriptCodec extends Codec { + + /** + * Encode a String so that it can be safely used in a specific context. + * + * @param immune + * @param input + * the String to encode + * @return the encoded String + */ + public String encode(char[] immune, String input) { + StringBuilder sb = new StringBuilder(); + boolean encoding = false; + boolean inquotes = false; + for ( int i=0; i 0 ) sb.append( "&" ); + if ( !inquotes && i > 0 ) sb.append( "\"" ); + sb.append( c ); + inquotes = true; + encoding = false; + + // handle characters that need encoding + } else { + if ( inquotes && i < input.length() ) sb.append( "\"" ); + if ( i > 0 ) sb.append( "&" ); + sb.append( encodeCharacter( immune, Character.valueOf( c ) ) ); + inquotes = false; + encoding = true; + } + } + return sb.toString(); + } + + + /** + * Returns quote-encoded character + * + * @param immune + */ + public String encodeCharacter( char[] immune, Character c ) { + char ch = c.charValue(); + + // check for immune characters + if ( containsCharacter( ch, immune ) ) { + return ""+ch; + } + + // check for alphanumeric characters + String hex = Codec.getHexForNonAlphanumeric( ch ); + if ( hex == null ) { + return ""+ch; + } + + return "chrw(" + (int)c.charValue() + ")"; + } + + + + /** + * Returns the decoded version of the character starting at index, or + * null if no decoding is possible. + * + * Formats all are legal both upper/lower case: + * "x - all special characters + * " + chr(x) + " - not supported yet + */ + public Character decodeCharacter( PushbackString input ) { + input.mark(); + Character first = input.next(); + if ( first == null ) { + input.reset(); + return null; + } + + // if this is not an encoded character, return null + if ( first.charValue() != '\"' ) { + input.reset(); + return null; + } + + Character second = input.next(); + return second; + } + } \ No newline at end of file From a2fa7eed4e429600b47444a3702cc700e8cd0233 Mon Sep 17 00:00:00 2001 From: kwwall Date: Mon, 18 Jan 2016 23:33:48 -0500 Subject: [PATCH 103/812] Change CRLF to LF for issue 356. --- .../org/owasp/esapi/codecs/WindowsCodec.java | 162 +++++++++--------- 1 file changed, 81 insertions(+), 81 deletions(-) diff --git a/src/main/java/org/owasp/esapi/codecs/WindowsCodec.java b/src/main/java/org/owasp/esapi/codecs/WindowsCodec.java index 719f00907..f7abb3a4b 100644 --- a/src/main/java/org/owasp/esapi/codecs/WindowsCodec.java +++ b/src/main/java/org/owasp/esapi/codecs/WindowsCodec.java @@ -1,82 +1,82 @@ -/** - * OWASP Enterprise Security API (ESAPI) - * - * This file is part of the Open Web Application Security Project (OWASP) - * Enterprise Security API (ESAPI) project. For details, please see - * http://www.owasp.org/index.php/ESAPI. - * - * Copyright (c) 2007 - The OWASP Foundation - * - * The ESAPI is published by OWASP under the BSD license. You should read and accept the - * LICENSE before you use, modify, and/or redistribute this software. - * - * @author Jeff Williams Aspect Security - * @created 2007 - */ -package org.owasp.esapi.codecs; - - -/** - * Implementation of the Codec interface for '^' encoding from Windows command shell. - * - * @author Jeff Williams (jeff.williams .at. aspectsecurity.com) Aspect Security - * @since June 1, 2007 - * @see org.owasp.esapi.Encoder - */ -public class WindowsCodec extends Codec { - - - /** - * {@inheritDoc} - * - * Returns Windows shell encoded character (which is ^) - * - * @param immune - */ - public String encodeCharacter( char[] immune, Character c ) { - char ch = c.charValue(); - - // check for immune characters - if ( containsCharacter( ch, immune ) ) { - return ""+ch; - } - - // check for alphanumeric characters - String hex = Codec.getHexForNonAlphanumeric( ch ); - if ( hex == null ) { - return ""+ch; - } - - return "^" + c; - } - - - /** - * {@inheritDoc} - * - * Returns the decoded version of the character starting at index, or - * null if no decoding is possible. - *

    - * Formats all are legal both upper/lower case: - * ^x - all special characters - */ - public Character decodeCharacter( PushbackString input ) { - input.mark(); - Character first = input.next(); - if ( first == null ) { - input.reset(); - return null; - } - - // if this is not an encoded character, return null - if ( first.charValue() != '^' ) { - input.reset(); - return null; - } - - Character second = input.next(); - return second; - } - +/** + * OWASP Enterprise Security API (ESAPI) + * + * This file is part of the Open Web Application Security Project (OWASP) + * Enterprise Security API (ESAPI) project. For details, please see + * http://www.owasp.org/index.php/ESAPI. + * + * Copyright (c) 2007 - The OWASP Foundation + * + * The ESAPI is published by OWASP under the BSD license. You should read and accept the + * LICENSE before you use, modify, and/or redistribute this software. + * + * @author Jeff Williams Aspect Security + * @created 2007 + */ +package org.owasp.esapi.codecs; + + +/** + * Implementation of the Codec interface for '^' encoding from Windows command shell. + * + * @author Jeff Williams (jeff.williams .at. aspectsecurity.com) Aspect Security + * @since June 1, 2007 + * @see org.owasp.esapi.Encoder + */ +public class WindowsCodec extends Codec { + + + /** + * {@inheritDoc} + * + * Returns Windows shell encoded character (which is ^) + * + * @param immune + */ + public String encodeCharacter( char[] immune, Character c ) { + char ch = c.charValue(); + + // check for immune characters + if ( containsCharacter( ch, immune ) ) { + return ""+ch; + } + + // check for alphanumeric characters + String hex = Codec.getHexForNonAlphanumeric( ch ); + if ( hex == null ) { + return ""+ch; + } + + return "^" + c; + } + + + /** + * {@inheritDoc} + * + * Returns the decoded version of the character starting at index, or + * null if no decoding is possible. + *

    + * Formats all are legal both upper/lower case: + * ^x - all special characters + */ + public Character decodeCharacter( PushbackString input ) { + input.mark(); + Character first = input.next(); + if ( first == null ) { + input.reset(); + return null; + } + + // if this is not an encoded character, return null + if ( first.charValue() != '^' ) { + input.reset(); + return null; + } + + Character second = input.next(); + return second; + } + } \ No newline at end of file From 910c6e83640b122ee7652b97f9fcd4a3ba5061e4 Mon Sep 17 00:00:00 2001 From: kwwall Date: Mon, 18 Jan 2016 23:33:48 -0500 Subject: [PATCH 104/812] Change CRLF to LF for issue 356. --- .../org/owasp/esapi/EncoderConstants.java | 234 +++++++++--------- 1 file changed, 117 insertions(+), 117 deletions(-) diff --git a/src/main/java/org/owasp/esapi/EncoderConstants.java b/src/main/java/org/owasp/esapi/EncoderConstants.java index d1480276d..1498d5ea7 100644 --- a/src/main/java/org/owasp/esapi/EncoderConstants.java +++ b/src/main/java/org/owasp/esapi/EncoderConstants.java @@ -1,117 +1,117 @@ -package org.owasp.esapi; - -import java.util.Set; - -import org.owasp.esapi.util.CollectionsUtil; - -/** - * Common character classes used for input validation, output encoding, verifying password strength - * CSRF token generation, generating salts, etc - * @author Neil Matatall (neil.matatall .at. gmail.com) - * @see User - */ -public class EncoderConstants { - /** - * !$*-.=?@_ - */ - public final static char[] CHAR_PASSWORD_SPECIALS = { '!', '$', '*', '-', '.', '=', '?', '@', '_' }; - public final static Set PASSWORD_SPECIALS; - static { - PASSWORD_SPECIALS = CollectionsUtil.arrayToSet(CHAR_PASSWORD_SPECIALS); - } - - /** - * a-b - */ - public final static char[] CHAR_LOWERS = { 'a', 'b', 'c', 'd', 'e', 'f', 'g', 'h', 'i', 'j', 'k', 'l', 'm', 'n', 'o', 'p', 'q', 'r', 's', 't', 'u', 'v', 'w', 'x', 'y', 'z' }; - public final static Set LOWERS; - static { - LOWERS = CollectionsUtil.arrayToSet(CHAR_PASSWORD_SPECIALS); - } - - /** - * A-Z - */ - public final static char[] CHAR_UPPERS = { 'A', 'B', 'C', 'D', 'E', 'F', 'G', 'H', 'I', 'J', 'K', 'L', 'M', 'N', 'O', 'P', 'Q', 'R', 'S', 'T', 'U', 'V', 'W', 'X', 'Y', 'Z' }; - public final static Set UPPERS; - static { - UPPERS = CollectionsUtil.arrayToSet(CHAR_UPPERS); - } - /** - * 0-9 - */ - public final static char[] CHAR_DIGITS = { '0', '1', '2', '3', '4', '5', '6', '7', '8', '9' }; - public final static Set DIGITS; - static { - DIGITS = CollectionsUtil.arrayToSet(CHAR_DIGITS); - } - - /** - * !$*+-.=?@^_|~ - */ - public final static char[] CHAR_SPECIALS = { '!', '$', '*', '+', '-', '.', '=', '?', '@', '^', '_', '|', '~' }; - public final static Set SPECIALS; - static { - SPECIALS = CollectionsUtil.arrayToSet(CHAR_SPECIALS); - } - - /** - * CHAR_LOWERS union CHAR_UPPERS - */ - public final static char[] CHAR_LETTERS = StringUtilities.union(CHAR_LOWERS, CHAR_UPPERS); - public final static Set LETTERS; - static { - LETTERS = CollectionsUtil.arrayToSet(CHAR_LETTERS); - } - - /** - * CHAR_LETTERS union CHAR_DIGITS - */ - public final static char[] CHAR_ALPHANUMERICS = StringUtilities.union(CHAR_LETTERS, CHAR_DIGITS); - public final static Set ALPHANUMERICS; - static { - ALPHANUMERICS = CollectionsUtil.arrayToSet(CHAR_ALPHANUMERICS); - } - - /** - * Password character set, is alphanumerics (without l, i, I, o, O, and 0) - * selected specials like + (bad for URL encoding, | is like i and 1, - * etc...) - */ - public final static char[] CHAR_PASSWORD_LOWERS = { 'a', 'b', 'c', 'd', 'e', 'f', 'g', 'h', 'j', 'k', 'm', 'n', 'p', 'q', 'r', 's', 't', 'u', 'v', 'w', 'x', 'y', 'z' }; - public final static Set PASSWORD_LOWERS; - static { - PASSWORD_LOWERS = CollectionsUtil.arrayToSet(CHAR_ALPHANUMERICS); - } - - /** - * - */ - public final static char[] CHAR_PASSWORD_UPPERS = { 'A', 'B', 'C', 'D', 'E', 'F', 'G', 'H', 'J', 'K', 'L', 'M', 'N', 'P', 'Q', 'R', 'S', 'T', 'U', 'V', 'W', 'X', 'Y', 'Z' }; - public final static Set PASSWORD_UPPERS; - static { - PASSWORD_UPPERS = CollectionsUtil.arrayToSet(CHAR_PASSWORD_UPPERS); - } - - /** - * 2-9 - */ - public final static char[] CHAR_PASSWORD_DIGITS = { '2', '3', '4', '5', '6', '7', '8', '9' }; - public final static Set PASSWORD_DIGITS; - static { - PASSWORD_DIGITS = CollectionsUtil.arrayToSet(CHAR_PASSWORD_DIGITS); - } - - /** - * CHAR_PASSWORD_LOWERS union CHAR_PASSWORD_UPPERS - */ - public final static char[] CHAR_PASSWORD_LETTERS = StringUtilities.union( CHAR_PASSWORD_LOWERS, CHAR_PASSWORD_UPPERS ); - public final static Set PASSWORD_LETTERS; - static { - PASSWORD_LETTERS = CollectionsUtil.arrayToSet(CHAR_PASSWORD_LETTERS); - } - - private EncoderConstants() { - // prevent instantiation - } -} +package org.owasp.esapi; + +import java.util.Set; + +import org.owasp.esapi.util.CollectionsUtil; + +/** + * Common character classes used for input validation, output encoding, verifying password strength + * CSRF token generation, generating salts, etc + * @author Neil Matatall (neil.matatall .at. gmail.com) + * @see User + */ +public class EncoderConstants { + /** + * !$*-.=?@_ + */ + public final static char[] CHAR_PASSWORD_SPECIALS = { '!', '$', '*', '-', '.', '=', '?', '@', '_' }; + public final static Set PASSWORD_SPECIALS; + static { + PASSWORD_SPECIALS = CollectionsUtil.arrayToSet(CHAR_PASSWORD_SPECIALS); + } + + /** + * a-b + */ + public final static char[] CHAR_LOWERS = { 'a', 'b', 'c', 'd', 'e', 'f', 'g', 'h', 'i', 'j', 'k', 'l', 'm', 'n', 'o', 'p', 'q', 'r', 's', 't', 'u', 'v', 'w', 'x', 'y', 'z' }; + public final static Set LOWERS; + static { + LOWERS = CollectionsUtil.arrayToSet(CHAR_PASSWORD_SPECIALS); + } + + /** + * A-Z + */ + public final static char[] CHAR_UPPERS = { 'A', 'B', 'C', 'D', 'E', 'F', 'G', 'H', 'I', 'J', 'K', 'L', 'M', 'N', 'O', 'P', 'Q', 'R', 'S', 'T', 'U', 'V', 'W', 'X', 'Y', 'Z' }; + public final static Set UPPERS; + static { + UPPERS = CollectionsUtil.arrayToSet(CHAR_UPPERS); + } + /** + * 0-9 + */ + public final static char[] CHAR_DIGITS = { '0', '1', '2', '3', '4', '5', '6', '7', '8', '9' }; + public final static Set DIGITS; + static { + DIGITS = CollectionsUtil.arrayToSet(CHAR_DIGITS); + } + + /** + * !$*+-.=?@^_|~ + */ + public final static char[] CHAR_SPECIALS = { '!', '$', '*', '+', '-', '.', '=', '?', '@', '^', '_', '|', '~' }; + public final static Set SPECIALS; + static { + SPECIALS = CollectionsUtil.arrayToSet(CHAR_SPECIALS); + } + + /** + * CHAR_LOWERS union CHAR_UPPERS + */ + public final static char[] CHAR_LETTERS = StringUtilities.union(CHAR_LOWERS, CHAR_UPPERS); + public final static Set LETTERS; + static { + LETTERS = CollectionsUtil.arrayToSet(CHAR_LETTERS); + } + + /** + * CHAR_LETTERS union CHAR_DIGITS + */ + public final static char[] CHAR_ALPHANUMERICS = StringUtilities.union(CHAR_LETTERS, CHAR_DIGITS); + public final static Set ALPHANUMERICS; + static { + ALPHANUMERICS = CollectionsUtil.arrayToSet(CHAR_ALPHANUMERICS); + } + + /** + * Password character set, is alphanumerics (without l, i, I, o, O, and 0) + * selected specials like + (bad for URL encoding, | is like i and 1, + * etc...) + */ + public final static char[] CHAR_PASSWORD_LOWERS = { 'a', 'b', 'c', 'd', 'e', 'f', 'g', 'h', 'j', 'k', 'm', 'n', 'p', 'q', 'r', 's', 't', 'u', 'v', 'w', 'x', 'y', 'z' }; + public final static Set PASSWORD_LOWERS; + static { + PASSWORD_LOWERS = CollectionsUtil.arrayToSet(CHAR_ALPHANUMERICS); + } + + /** + * + */ + public final static char[] CHAR_PASSWORD_UPPERS = { 'A', 'B', 'C', 'D', 'E', 'F', 'G', 'H', 'J', 'K', 'L', 'M', 'N', 'P', 'Q', 'R', 'S', 'T', 'U', 'V', 'W', 'X', 'Y', 'Z' }; + public final static Set PASSWORD_UPPERS; + static { + PASSWORD_UPPERS = CollectionsUtil.arrayToSet(CHAR_PASSWORD_UPPERS); + } + + /** + * 2-9 + */ + public final static char[] CHAR_PASSWORD_DIGITS = { '2', '3', '4', '5', '6', '7', '8', '9' }; + public final static Set PASSWORD_DIGITS; + static { + PASSWORD_DIGITS = CollectionsUtil.arrayToSet(CHAR_PASSWORD_DIGITS); + } + + /** + * CHAR_PASSWORD_LOWERS union CHAR_PASSWORD_UPPERS + */ + public final static char[] CHAR_PASSWORD_LETTERS = StringUtilities.union( CHAR_PASSWORD_LOWERS, CHAR_PASSWORD_UPPERS ); + public final static Set PASSWORD_LETTERS; + static { + PASSWORD_LETTERS = CollectionsUtil.arrayToSet(CHAR_PASSWORD_LETTERS); + } + + private EncoderConstants() { + // prevent instantiation + } +} From 464d4bad42378ea0808677ce591ccb6345f40af4 Mon Sep 17 00:00:00 2001 From: kwwall Date: Mon, 18 Jan 2016 23:33:48 -0500 Subject: [PATCH 105/812] Change CRLF to LF for issue 356. --- src/main/java/org/owasp/esapi/Encoder.java | 1032 ++++++++++---------- 1 file changed, 516 insertions(+), 516 deletions(-) diff --git a/src/main/java/org/owasp/esapi/Encoder.java b/src/main/java/org/owasp/esapi/Encoder.java index 3bce42fc4..2d2bfb7b9 100644 --- a/src/main/java/org/owasp/esapi/Encoder.java +++ b/src/main/java/org/owasp/esapi/Encoder.java @@ -1,516 +1,516 @@ -/** - * OWASP Enterprise Security API (ESAPI) - * - * This file is part of the Open Web Application Security Project (OWASP) - * Enterprise Security API (ESAPI) project. For details, please see - * http://www.owasp.org/index.php/ESAPI. - * - * Copyright (c) 2007 - The OWASP Foundation - * - * The ESAPI is published by OWASP under the BSD license. You should read and accept the - * LICENSE before you use, modify, and/or redistribute this software. - * - * @author Jeff Williams Aspect Security - * @created 2007 - */ -package org.owasp.esapi; - -import java.io.IOException; - -import org.owasp.esapi.codecs.Codec; -import org.owasp.esapi.errors.EncodingException; - - -/** - * The Encoder interface contains a number of methods for decoding input and encoding output - * so that it will be safe for a variety of interpreters. To prevent - * double-encoding, callers should make sure input does not already contain encoded characters - * by calling canonicalize. Validator implementations should call canonicalize on user input - * before validating to prevent encoded attacks. - *

    - * All of the methods must use a "whitelist" or "positive" security model. - * For the encoding methods, this means that all characters should be encoded, except for a specific list of - * "immune" characters that are known to be safe. - *

    - * The Encoder performs two key functions, encoding and decoding. These functions rely - * on a set of codecs that can be found in the org.owasp.esapi.codecs package. These include: - *

    • CSS Escaping
      • - *
    • HTMLEntity Encoding
      • - *
    • JavaScript Escaping
      • - *
    • MySQL Escaping
      • - *
    • Oracle Escaping
      • - *
    • Percent Encoding (aka URL Encoding)
      • - *
    • Unix Escaping
      • - *
    • VBScript Escaping
      • - *
    • Windows Encoding
    - *

    - * - * @author Jeff Williams (jeff.williams .at. aspectsecurity.com) Aspect Security - * @since June 1, 2007 - */ -public interface Encoder { - - /** - * Standard character sets - */ - - /** - * @deprecated Use {@link EncoderConstants#CHAR_LOWERS} instead - */ - @Deprecated - public final static char[] CHAR_LOWERS = EncoderConstants.CHAR_LOWERS; - /** - * @deprecated Use {@link EncoderConstants#CHAR_UPPERS} instead - * - */ - @Deprecated - public final static char[] CHAR_UPPERS = EncoderConstants.CHAR_UPPERS; - /** - * @deprecated Use {@link EncoderConstants#CHAR_DIGITS} instead - * - */ - @Deprecated - public final static char[] CHAR_DIGITS = EncoderConstants.CHAR_DIGITS; - /** - * @deprecated Use {@link EncoderConstants#CHAR_SPECIALS} instead - * - */ - @Deprecated - public final static char[] CHAR_SPECIALS = EncoderConstants.CHAR_SPECIALS; - /** - * @deprecated Use {@link EncoderConstants#CHAR_LETTERS} instead - * - */ - @Deprecated - public final static char[] CHAR_LETTERS = EncoderConstants.CHAR_LETTERS; - /** - * @deprecated Use {@link EncoderConstants#CHAR_ALPHANUMERICS} instead - * - */ - @Deprecated - public final static char[] CHAR_ALPHANUMERICS = EncoderConstants.CHAR_ALPHANUMERICS; - - - /** - * Password character set, is alphanumerics (without l, i, I, o, O, and 0) - * selected specials like + (bad for URL encoding, | is like i and 1, - * etc...) - * @deprecated Use {@link EncoderConstants#CHAR_PASSWORD_LOWERS} instead - */ - @Deprecated - public final static char[] CHAR_PASSWORD_LOWERS = EncoderConstants.CHAR_PASSWORD_LOWERS; - /** - * @deprecated Use {@link EncoderConstants#CHAR_PASSWORD_UPPERS} instead - * - */ - @Deprecated - public final static char[] CHAR_PASSWORD_UPPERS = EncoderConstants.CHAR_PASSWORD_UPPERS; - /** - * @deprecated Use {@link EncoderConstants#CHAR_PASSWORD_DIGITS} instead - * - */ - @Deprecated - public final static char[] CHAR_PASSWORD_DIGITS = EncoderConstants.CHAR_PASSWORD_DIGITS; - /** - * @deprecated Use {@link EncoderConstants#CHAR_PASSWORD_SPECIALS} instead - * - */ - @Deprecated - public final static char[] CHAR_PASSWORD_SPECIALS = EncoderConstants.CHAR_PASSWORD_SPECIALS; - /** - * @deprecated Use {@link EncoderConstants#CHAR_PASSWORD_LETTERS} instead - * - */ - @Deprecated - public final static char[] CHAR_PASSWORD_LETTERS = EncoderConstants.CHAR_PASSWORD_LETTERS; - - - - /** - * This method is equivalent to calling 

    Encoder.canonicalize(input, restrictMultiple, restrictMixed);
    - * - * The default values for restrictMultiple and restrictMixed come from ESAPI.properties - * 
    -	 * Encoder.AllowMultipleEncoding=false
-	 * Encoder.AllowMixedEncoding=false
-	 *
    - * - * @see Encoder#canonicalize(String, boolean, boolean) canonicalize - * @see W3C specifications - * - * @param input the text to canonicalize - * @return a String containing the canonicalized text - */ - String canonicalize(String input); - - /** - * This method is the equivalent to calling 
    Encoder.canonicalize(input, strict, strict);
    - * - * @see Encoder#canonicalize(String, boolean, boolean) canonicalize - * @see W3C specifications - * - * @param input - * the text to canonicalize - * @param strict - * true if checking for multiple and mixed encoding is desired, false otherwise - * - * @return a String containing the canonicalized text - */ - String canonicalize(String input, boolean strict); - - /** - * Canonicalization is simply the operation of reducing a possibly encoded - * string down to its simplest form. This is important, because attackers - * frequently use encoding to change their input in a way that will bypass - * validation filters, but still be interpreted properly by the target of - * the attack. Note that data encoded more than once is not something that a - * normal user would generate and should be regarded as an attack. - *

    - * Everyone says you shouldn't do validation - * without canonicalizing the data first. This is easier said than done. The canonicalize method can - * be used to simplify just about any input down to its most basic form. Note that canonicalize doesn't - * handle Unicode issues, it focuses on higher level encoding and escaping schemes. In addition to simple - * decoding, canonicalize also handles: - *

    • Perverse but legal variants of escaping schemes
      • - *
    • Multiple escaping (%2526 or &lt;)
      • - *
    • Mixed escaping (%26lt;)
      • - *
    • Nested escaping (%%316 or &%6ct;)
      • - *
    • All combinations of multiple, mixed, and nested encoding/escaping (%253c or ┦gt;)
    - *

    - * Using canonicalize is simple. The default is just... - * 

    -     *     String clean = ESAPI.encoder().canonicalize( request.getParameter("input"));
-     *
    - * You need to decode untrusted data so that it's safe for ANY downstream interpreter or decoder. For - * example, if your data goes into a Windows command shell, then into a database, and then to a browser, - * you're going to need to decode for all of those systems. You can build a custom encoder to canonicalize - * for your application like this... - * 
    -     *     ArrayList list = new ArrayList();
-     *     list.add( new WindowsCodec() );
-     *     list.add( new MySQLCodec() );
-     *     list.add( new PercentCodec() );
-     *     Encoder encoder = new DefaultEncoder( list );
-     *     String clean = encoder.canonicalize( request.getParameter( "input" ));
-     *
    - * In ESAPI, the Validator uses the canonicalize method before it does validation. So all you need to - * do is to validate as normal and you'll be protected against a host of encoded attacks. - * 
    -     *     String input = request.getParameter( "name" );
-     *     String name = ESAPI.validator().isValidInput( "test", input, "FirstName", 20, false);
-     *
    - * However, the default canonicalize() method only decodes HTMLEntity, percent (URL) encoding, and JavaScript - * encoding. If you'd like to use a custom canonicalizer with your validator, that's pretty easy too. - * 
    -     *     ... setup custom encoder as above
-     *     Validator validator = new DefaultValidator( encoder );
-     *     String input = request.getParameter( "name" );
-     *     String name = validator.isValidInput( "test", input, "name", 20, false);
-     *
    - * Although ESAPI is able to canonicalize multiple, mixed, or nested encoding, it's safer to not accept - * this stuff in the first place. In ESAPI, the default is "strict" mode that throws an IntrusionException - * if it receives anything not single-encoded with a single scheme. This is configurable - * in ESAPI.properties using the properties: - * 
    -	 * Encoder.AllowMultipleEncoding=false
-	 * Encoder.AllowMixedEncoding=false
-	 *
    - * This method allows you to override the default behavior by directly specifying whether to restrict - * multiple or mixed encoding. Even if you disable restrictions, you'll still get - * warning messages in the log about each multiple encoding and mixed encoding received. - * 
    -     *     // disabling strict mode to allow mixed encoding
-     *     String url = ESAPI.encoder().canonicalize( request.getParameter("url"), false, false);
-     *
    - * - * @see W3C specifications - * - * @param input - * the text to canonicalize - * @param restrictMultiple - * true if checking for multiple encoding is desired, false otherwise - * @param restrictMixed - * true if checking for mixed encoding is desired, false otherwise - * - * @return a String containing the canonicalized text - */ - String canonicalize(String input, boolean restrictMultiple, boolean restrictMixed); - - /** - * Encode data for use in Cascading Style Sheets (CSS) content. - * - * @see CSS Syntax [w3.org] - * - * @param input - * the text to encode for CSS - * - * @return input encoded for CSS - */ - String encodeForCSS(String input); - - /** - * Encode data for use in HTML using HTML entity encoding - *

    - * Note that the following characters: - * 00-08, 0B-0C, 0E-1F, and 7F-9F - *

    cannot be used in HTML. - * - * @see HTML Encodings [wikipedia.org] - * @see SGML Specification [w3.org] - * @see XML Specification [w3.org] - * - * @param input - * the text to encode for HTML - * - * @return input encoded for HTML - */ - String encodeForHTML(String input); - - /** - * Decodes HTML entities. - * @param input the String to decode - * @return the newly decoded String - */ - String decodeForHTML(String input); - - /** - * Encode data for use in HTML attributes. - * - * @param input - * the text to encode for an HTML attribute - * - * @return input encoded for use as an HTML attribute - */ - String encodeForHTMLAttribute(String input); - - - /** - * Encode data for insertion inside a data value or function argument in JavaScript. Including user data - * directly inside a script is quite dangerous. Great care must be taken to prevent including user data - * directly into script code itself, as no amount of encoding will prevent attacks there. - * - * Please note there are some JavaScript functions that can never safely receive untrusted data - * as input – even if the user input is encoded. - * - * For example: - * 

    -     *  <script>
-     *      window.setInterval('<%= EVEN IF YOU ENCODE UNTRUSTED DATA YOU ARE XSSED HERE %>');
-     *  </script>
-     *
    - * @param input - * the text to encode for JavaScript - * - * @return input encoded for use in JavaScript - */ - String encodeForJavaScript(String input); - - /** - * Encode data for insertion inside a data value in a Visual Basic script. Putting user data directly - * inside a script is quite dangerous. Great care must be taken to prevent putting user data - * directly into script code itself, as no amount of encoding will prevent attacks there. - * - * This method is not recommended as VBScript is only supported by Internet Explorer - * - * @param input - * the text to encode for VBScript - * - * @return input encoded for use in VBScript - */ - String encodeForVBScript(String input); - - - /** - * Encode input for use in a SQL query, according to the selected codec - * (appropriate codecs include the MySQLCodec and OracleCodec). - * - * This method is not recommended. The use of the PreparedStatement - * interface is the preferred approach. However, if for some reason - * this is impossible, then this method is provided as a weaker - * alternative. - * - * The best approach is to make sure any single-quotes are double-quoted. - * Another possible approach is to use the {escape} syntax described in the - * JDBC specification in section 1.5.6. - * - * However, this syntax does not work with all drivers, and requires - * modification of all queries. - * - * @see JDBC Specification - * - * @param codec - * a Codec that declares which database 'input' is being encoded for (ie. MySQL, Oracle, etc.) - * @param input - * the text to encode for SQL - * - * @return input encoded for use in SQL - */ - String encodeForSQL(Codec codec, String input); - - /** - * Encode for an operating system command shell according to the selected codec (appropriate codecs include the WindowsCodec and UnixCodec). - * - * Please note the following recommendations before choosing to use this method: - * - * 1) It is strongly recommended that applications avoid making direct OS system calls if possible as such calls are not portable, and they are potentially unsafe. Please use language provided features if at all possible, rather than native OS calls to implement the desired feature. - * 2) If an OS call cannot be avoided, then it is recommended that the program to be invoked be invoked directly (e.g., System.exec("nameofcommand" + "parameterstocommand");) as this avoids the use of the command shell. The "parameterstocommand" should of course be validated before passing them to the OS command. - * 3) If you must use this method, then we recommend validating all user supplied input passed to the command shell as well, in addition to using this method in order to make the command shell invocation safe. - * - * An example use of this method would be: System.exec("dir " + ESAPI.encodeForOS(WindowsCodec, "parameter(s)tocommandwithuserinput"); - * - * @param codec - * a Codec that declares which operating system 'input' is being encoded for (ie. Windows, Unix, etc.) - * @param input - * the text to encode for the command shell - * - * @return input encoded for use in command shell - */ - String encodeForOS(Codec codec, String input); - - /** - * Encode data for use in LDAP queries. - * - * @param input - * the text to encode for LDAP - * - * @return input encoded for use in LDAP - */ - String encodeForLDAP(String input); - - /** - * Encode data for use in an LDAP distinguished name. - * - * @param input - * the text to encode for an LDAP distinguished name - * - * @return input encoded for use in an LDAP distinguished name - */ - String encodeForDN(String input); - - /** - * Encode data for use in an XPath query. - * - * NB: The reference implementation encodes almost everything and may over-encode. - * - * The difficulty with XPath encoding is that XPath has no built in mechanism for escaping - * characters. It is possible to use XQuery in a parameterized way to - * prevent injection. - * - * For more information, refer to this - * article which specifies the following list of characters as the most - * dangerous: ^&"*';<>(). This - * paper suggests disallowing ' and " in queries. - * - * @see XPath Injection [ibm.com] - * @see Blind XPath Injection [packetstormsecurity.org] - * - * @param input - * the text to encode for XPath - * @return - * input encoded for use in XPath - */ - String encodeForXPath(String input); - - /** - * Encode data for use in an XML element. The implementation should follow the XML Encoding - * Standard from the W3C. - *

    - * The use of a real XML parser is strongly encouraged. However, in the - * hopefully rare case that you need to make sure that data is safe for - * inclusion in an XML document and cannot use a parse, this method provides - * a safe mechanism to do so. - * - * @see XML Encoding Standard - * - * @param input - * the text to encode for XML - * - * @return - * input encoded for use in XML - */ - String encodeForXML(String input); - - /** - * Encode data for use in an XML attribute. The implementation should follow - * the XML Encoding - * Standard from the W3C. - *

    - * The use of a real XML parser is highly encouraged. However, in the - * hopefully rare case that you need to make sure that data is safe for - * inclusion in an XML document and cannot use a parse, this method provides - * a safe mechanism to do so. - * - * @see XML Encoding Standard - * - * @param input - * the text to encode for use as an XML attribute - * - * @return - * input encoded for use in an XML attribute - */ - String encodeForXMLAttribute(String input); - - /** - * Encode for use in a URL. This method performs URL encoding - * on the entire string. - * - * @see URL encoding - * - * @param input - * the text to encode for use in a URL - * - * @return input - * encoded for use in a URL - * - * @throws EncodingException - * if encoding fails - */ - String encodeForURL(String input) throws EncodingException; - - /** - * Decode from URL. Implementations should first canonicalize and - * detect any double-encoding. If this check passes, then the data is decoded using URL - * decoding. - * - * @param input - * the text to decode from an encoded URL - * - * @return - * the decoded URL value - * - * @throws EncodingException - * if decoding fails - */ - String decodeFromURL(String input) throws EncodingException; - - /** - * Encode for Base64. - * - * @param input - * the text to encode for Base64 - * @param wrap - * the encoder will wrap lines every 64 characters of output - * - * @return input encoded for Base64 - */ - String encodeForBase64(byte[] input, boolean wrap); - - /** - * Decode data encoded with BASE-64 encoding. - * - * @param input - * the Base64 text to decode - * - * @return input - * decoded from Base64 - * - * @throws IOException - */ - byte[] decodeFromBase64(String input) throws IOException; - -} +/** + * OWASP Enterprise Security API (ESAPI) + * + * This file is part of the Open Web Application Security Project (OWASP) + * Enterprise Security API (ESAPI) project. For details, please see + * http://www.owasp.org/index.php/ESAPI. + * + * Copyright (c) 2007 - The OWASP Foundation + * + * The ESAPI is published by OWASP under the BSD license. You should read and accept the + * LICENSE before you use, modify, and/or redistribute this software. + * + * @author Jeff Williams Aspect Security + * @created 2007 + */ +package org.owasp.esapi; + +import java.io.IOException; + +import org.owasp.esapi.codecs.Codec; +import org.owasp.esapi.errors.EncodingException; + + +/** + * The Encoder interface contains a number of methods for decoding input and encoding output + * so that it will be safe for a variety of interpreters. To prevent + * double-encoding, callers should make sure input does not already contain encoded characters + * by calling canonicalize. Validator implementations should call canonicalize on user input + * before validating to prevent encoded attacks. + *

    + * All of the methods must use a "whitelist" or "positive" security model. + * For the encoding methods, this means that all characters should be encoded, except for a specific list of + * "immune" characters that are known to be safe. + *

    + * The Encoder performs two key functions, encoding and decoding. These functions rely + * on a set of codecs that can be found in the org.owasp.esapi.codecs package. These include: + *

    • CSS Escaping
      • + *
    • HTMLEntity Encoding
      • + *
    • JavaScript Escaping
      • + *
    • MySQL Escaping
      • + *
    • Oracle Escaping
      • + *
    • Percent Encoding (aka URL Encoding)
      • + *
    • Unix Escaping
      • + *
    • VBScript Escaping
      • + *
    • Windows Encoding
    + *

    + * + * @author Jeff Williams (jeff.williams .at. aspectsecurity.com) Aspect Security + * @since June 1, 2007 + */ +public interface Encoder { + + /** + * Standard character sets + */ + + /** + * @deprecated Use {@link EncoderConstants#CHAR_LOWERS} instead + */ + @Deprecated + public final static char[] CHAR_LOWERS = EncoderConstants.CHAR_LOWERS; + /** + * @deprecated Use {@link EncoderConstants#CHAR_UPPERS} instead + * + */ + @Deprecated + public final static char[] CHAR_UPPERS = EncoderConstants.CHAR_UPPERS; + /** + * @deprecated Use {@link EncoderConstants#CHAR_DIGITS} instead + * + */ + @Deprecated + public final static char[] CHAR_DIGITS = EncoderConstants.CHAR_DIGITS; + /** + * @deprecated Use {@link EncoderConstants#CHAR_SPECIALS} instead + * + */ + @Deprecated + public final static char[] CHAR_SPECIALS = EncoderConstants.CHAR_SPECIALS; + /** + * @deprecated Use {@link EncoderConstants#CHAR_LETTERS} instead + * + */ + @Deprecated + public final static char[] CHAR_LETTERS = EncoderConstants.CHAR_LETTERS; + /** + * @deprecated Use {@link EncoderConstants#CHAR_ALPHANUMERICS} instead + * + */ + @Deprecated + public final static char[] CHAR_ALPHANUMERICS = EncoderConstants.CHAR_ALPHANUMERICS; + + + /** + * Password character set, is alphanumerics (without l, i, I, o, O, and 0) + * selected specials like + (bad for URL encoding, | is like i and 1, + * etc...) + * @deprecated Use {@link EncoderConstants#CHAR_PASSWORD_LOWERS} instead + */ + @Deprecated + public final static char[] CHAR_PASSWORD_LOWERS = EncoderConstants.CHAR_PASSWORD_LOWERS; + /** + * @deprecated Use {@link EncoderConstants#CHAR_PASSWORD_UPPERS} instead + * + */ + @Deprecated + public final static char[] CHAR_PASSWORD_UPPERS = EncoderConstants.CHAR_PASSWORD_UPPERS; + /** + * @deprecated Use {@link EncoderConstants#CHAR_PASSWORD_DIGITS} instead + * + */ + @Deprecated + public final static char[] CHAR_PASSWORD_DIGITS = EncoderConstants.CHAR_PASSWORD_DIGITS; + /** + * @deprecated Use {@link EncoderConstants#CHAR_PASSWORD_SPECIALS} instead + * + */ + @Deprecated + public final static char[] CHAR_PASSWORD_SPECIALS = EncoderConstants.CHAR_PASSWORD_SPECIALS; + /** + * @deprecated Use {@link EncoderConstants#CHAR_PASSWORD_LETTERS} instead + * + */ + @Deprecated + public final static char[] CHAR_PASSWORD_LETTERS = EncoderConstants.CHAR_PASSWORD_LETTERS; + + + + /** + * This method is equivalent to calling 

    Encoder.canonicalize(input, restrictMultiple, restrictMixed);
    + * + * The default values for restrictMultiple and restrictMixed come from ESAPI.properties + * 
    +	 * Encoder.AllowMultipleEncoding=false
+	 * Encoder.AllowMixedEncoding=false
+	 *
    + * + * @see Encoder#canonicalize(String, boolean, boolean) canonicalize + * @see W3C specifications + * + * @param input the text to canonicalize + * @return a String containing the canonicalized text + */ + String canonicalize(String input); + + /** + * This method is the equivalent to calling 
    Encoder.canonicalize(input, strict, strict);
    + * + * @see Encoder#canonicalize(String, boolean, boolean) canonicalize + * @see W3C specifications + * + * @param input + * the text to canonicalize + * @param strict + * true if checking for multiple and mixed encoding is desired, false otherwise + * + * @return a String containing the canonicalized text + */ + String canonicalize(String input, boolean strict); + + /** + * Canonicalization is simply the operation of reducing a possibly encoded + * string down to its simplest form. This is important, because attackers + * frequently use encoding to change their input in a way that will bypass + * validation filters, but still be interpreted properly by the target of + * the attack. Note that data encoded more than once is not something that a + * normal user would generate and should be regarded as an attack. + *

    + * Everyone says you shouldn't do validation + * without canonicalizing the data first. This is easier said than done. The canonicalize method can + * be used to simplify just about any input down to its most basic form. Note that canonicalize doesn't + * handle Unicode issues, it focuses on higher level encoding and escaping schemes. In addition to simple + * decoding, canonicalize also handles: + *

    • Perverse but legal variants of escaping schemes
      • + *
    • Multiple escaping (%2526 or &lt;)
      • + *
    • Mixed escaping (%26lt;)
      • + *
    • Nested escaping (%%316 or &%6ct;)
      • + *
    • All combinations of multiple, mixed, and nested encoding/escaping (%253c or ┦gt;)
    + *

    + * Using canonicalize is simple. The default is just... + * 

    +     *     String clean = ESAPI.encoder().canonicalize( request.getParameter("input"));
+     *
    + * You need to decode untrusted data so that it's safe for ANY downstream interpreter or decoder. For + * example, if your data goes into a Windows command shell, then into a database, and then to a browser, + * you're going to need to decode for all of those systems. You can build a custom encoder to canonicalize + * for your application like this... + * 
    +     *     ArrayList list = new ArrayList();
+     *     list.add( new WindowsCodec() );
+     *     list.add( new MySQLCodec() );
+     *     list.add( new PercentCodec() );
+     *     Encoder encoder = new DefaultEncoder( list );
+     *     String clean = encoder.canonicalize( request.getParameter( "input" ));
+     *
    + * In ESAPI, the Validator uses the canonicalize method before it does validation. So all you need to + * do is to validate as normal and you'll be protected against a host of encoded attacks. + * 
    +     *     String input = request.getParameter( "name" );
+     *     String name = ESAPI.validator().isValidInput( "test", input, "FirstName", 20, false);
+     *
    + * However, the default canonicalize() method only decodes HTMLEntity, percent (URL) encoding, and JavaScript + * encoding. If you'd like to use a custom canonicalizer with your validator, that's pretty easy too. + * 
    +     *     ... setup custom encoder as above
+     *     Validator validator = new DefaultValidator( encoder );
+     *     String input = request.getParameter( "name" );
+     *     String name = validator.isValidInput( "test", input, "name", 20, false);
+     *
    + * Although ESAPI is able to canonicalize multiple, mixed, or nested encoding, it's safer to not accept + * this stuff in the first place. In ESAPI, the default is "strict" mode that throws an IntrusionException + * if it receives anything not single-encoded with a single scheme. This is configurable + * in ESAPI.properties using the properties: + * 
    +	 * Encoder.AllowMultipleEncoding=false
+	 * Encoder.AllowMixedEncoding=false
+	 *
    + * This method allows you to override the default behavior by directly specifying whether to restrict + * multiple or mixed encoding. Even if you disable restrictions, you'll still get + * warning messages in the log about each multiple encoding and mixed encoding received. + * 
    +     *     // disabling strict mode to allow mixed encoding
+     *     String url = ESAPI.encoder().canonicalize( request.getParameter("url"), false, false);
+     *
    + * + * @see W3C specifications + * + * @param input + * the text to canonicalize + * @param restrictMultiple + * true if checking for multiple encoding is desired, false otherwise + * @param restrictMixed + * true if checking for mixed encoding is desired, false otherwise + * + * @return a String containing the canonicalized text + */ + String canonicalize(String input, boolean restrictMultiple, boolean restrictMixed); + + /** + * Encode data for use in Cascading Style Sheets (CSS) content. + * + * @see CSS Syntax [w3.org] + * + * @param input + * the text to encode for CSS + * + * @return input encoded for CSS + */ + String encodeForCSS(String input); + + /** + * Encode data for use in HTML using HTML entity encoding + *

    + * Note that the following characters: + * 00-08, 0B-0C, 0E-1F, and 7F-9F + *

    cannot be used in HTML. + * + * @see HTML Encodings [wikipedia.org] + * @see SGML Specification [w3.org] + * @see XML Specification [w3.org] + * + * @param input + * the text to encode for HTML + * + * @return input encoded for HTML + */ + String encodeForHTML(String input); + + /** + * Decodes HTML entities. + * @param input the String to decode + * @return the newly decoded String + */ + String decodeForHTML(String input); + + /** + * Encode data for use in HTML attributes. + * + * @param input + * the text to encode for an HTML attribute + * + * @return input encoded for use as an HTML attribute + */ + String encodeForHTMLAttribute(String input); + + + /** + * Encode data for insertion inside a data value or function argument in JavaScript. Including user data + * directly inside a script is quite dangerous. Great care must be taken to prevent including user data + * directly into script code itself, as no amount of encoding will prevent attacks there. + * + * Please note there are some JavaScript functions that can never safely receive untrusted data + * as input – even if the user input is encoded. + * + * For example: + * 

    +     *  <script>
+     *      window.setInterval('<%= EVEN IF YOU ENCODE UNTRUSTED DATA YOU ARE XSSED HERE %>');
+     *  </script>
+     *
    + * @param input + * the text to encode for JavaScript + * + * @return input encoded for use in JavaScript + */ + String encodeForJavaScript(String input); + + /** + * Encode data for insertion inside a data value in a Visual Basic script. Putting user data directly + * inside a script is quite dangerous. Great care must be taken to prevent putting user data + * directly into script code itself, as no amount of encoding will prevent attacks there. + * + * This method is not recommended as VBScript is only supported by Internet Explorer + * + * @param input + * the text to encode for VBScript + * + * @return input encoded for use in VBScript + */ + String encodeForVBScript(String input); + + + /** + * Encode input for use in a SQL query, according to the selected codec + * (appropriate codecs include the MySQLCodec and OracleCodec). + * + * This method is not recommended. The use of the PreparedStatement + * interface is the preferred approach. However, if for some reason + * this is impossible, then this method is provided as a weaker + * alternative. + * + * The best approach is to make sure any single-quotes are double-quoted. + * Another possible approach is to use the {escape} syntax described in the + * JDBC specification in section 1.5.6. + * + * However, this syntax does not work with all drivers, and requires + * modification of all queries. + * + * @see JDBC Specification + * + * @param codec + * a Codec that declares which database 'input' is being encoded for (ie. MySQL, Oracle, etc.) + * @param input + * the text to encode for SQL + * + * @return input encoded for use in SQL + */ + String encodeForSQL(Codec codec, String input); + + /** + * Encode for an operating system command shell according to the selected codec (appropriate codecs include the WindowsCodec and UnixCodec). + * + * Please note the following recommendations before choosing to use this method: + * + * 1) It is strongly recommended that applications avoid making direct OS system calls if possible as such calls are not portable, and they are potentially unsafe. Please use language provided features if at all possible, rather than native OS calls to implement the desired feature. + * 2) If an OS call cannot be avoided, then it is recommended that the program to be invoked be invoked directly (e.g., System.exec("nameofcommand" + "parameterstocommand");) as this avoids the use of the command shell. The "parameterstocommand" should of course be validated before passing them to the OS command. + * 3) If you must use this method, then we recommend validating all user supplied input passed to the command shell as well, in addition to using this method in order to make the command shell invocation safe. + * + * An example use of this method would be: System.exec("dir " + ESAPI.encodeForOS(WindowsCodec, "parameter(s)tocommandwithuserinput"); + * + * @param codec + * a Codec that declares which operating system 'input' is being encoded for (ie. Windows, Unix, etc.) + * @param input + * the text to encode for the command shell + * + * @return input encoded for use in command shell + */ + String encodeForOS(Codec codec, String input); + + /** + * Encode data for use in LDAP queries. + * + * @param input + * the text to encode for LDAP + * + * @return input encoded for use in LDAP + */ + String encodeForLDAP(String input); + + /** + * Encode data for use in an LDAP distinguished name. + * + * @param input + * the text to encode for an LDAP distinguished name + * + * @return input encoded for use in an LDAP distinguished name + */ + String encodeForDN(String input); + + /** + * Encode data for use in an XPath query. + * + * NB: The reference implementation encodes almost everything and may over-encode. + * + * The difficulty with XPath encoding is that XPath has no built in mechanism for escaping + * characters. It is possible to use XQuery in a parameterized way to + * prevent injection. + * + * For more information, refer to this + * article which specifies the following list of characters as the most + * dangerous: ^&"*';<>(). This + * paper suggests disallowing ' and " in queries. + * + * @see XPath Injection [ibm.com] + * @see Blind XPath Injection [packetstormsecurity.org] + * + * @param input + * the text to encode for XPath + * @return + * input encoded for use in XPath + */ + String encodeForXPath(String input); + + /** + * Encode data for use in an XML element. The implementation should follow the XML Encoding + * Standard from the W3C. + *

    + * The use of a real XML parser is strongly encouraged. However, in the + * hopefully rare case that you need to make sure that data is safe for + * inclusion in an XML document and cannot use a parse, this method provides + * a safe mechanism to do so. + * + * @see XML Encoding Standard + * + * @param input + * the text to encode for XML + * + * @return + * input encoded for use in XML + */ + String encodeForXML(String input); + + /** + * Encode data for use in an XML attribute. The implementation should follow + * the XML Encoding + * Standard from the W3C. + *

    + * The use of a real XML parser is highly encouraged. However, in the + * hopefully rare case that you need to make sure that data is safe for + * inclusion in an XML document and cannot use a parse, this method provides + * a safe mechanism to do so. + * + * @see XML Encoding Standard + * + * @param input + * the text to encode for use as an XML attribute + * + * @return + * input encoded for use in an XML attribute + */ + String encodeForXMLAttribute(String input); + + /** + * Encode for use in a URL. This method performs URL encoding + * on the entire string. + * + * @see URL encoding + * + * @param input + * the text to encode for use in a URL + * + * @return input + * encoded for use in a URL + * + * @throws EncodingException + * if encoding fails + */ + String encodeForURL(String input) throws EncodingException; + + /** + * Decode from URL. Implementations should first canonicalize and + * detect any double-encoding. If this check passes, then the data is decoded using URL + * decoding. + * + * @param input + * the text to decode from an encoded URL + * + * @return + * the decoded URL value + * + * @throws EncodingException + * if decoding fails + */ + String decodeFromURL(String input) throws EncodingException; + + /** + * Encode for Base64. + * + * @param input + * the text to encode for Base64 + * @param wrap + * the encoder will wrap lines every 64 characters of output + * + * @return input encoded for Base64 + */ + String encodeForBase64(byte[] input, boolean wrap); + + /** + * Decode data encoded with BASE-64 encoding. + * + * @param input + * the Base64 text to decode + * + * @return input + * decoded from Base64 + * + * @throws IOException + */ + byte[] decodeFromBase64(String input) throws IOException; + +} From 9b8c23eedc363039e10df109697fc2dbf44b10b8 Mon Sep 17 00:00:00 2001 From: kwwall Date: Mon, 18 Jan 2016 23:33:48 -0500 Subject: [PATCH 106/812] Change CRLF to LF for issue 356. --- .../org/owasp/esapi/EncryptedProperties.java | 224 +++++++++--------- 1 file changed, 112 insertions(+), 112 deletions(-) diff --git a/src/main/java/org/owasp/esapi/EncryptedProperties.java b/src/main/java/org/owasp/esapi/EncryptedProperties.java index e95b1b858..b3a7cd006 100644 --- a/src/main/java/org/owasp/esapi/EncryptedProperties.java +++ b/src/main/java/org/owasp/esapi/EncryptedProperties.java @@ -1,112 +1,112 @@ -/** - * OWASP Enterprise Security API (ESAPI) - * - * This file is part of the Open Web Application Security Project (OWASP) - * Enterprise Security API (ESAPI) project. For details, please see - * http://www.owasp.org/index.php/ESAPI. - * - * Copyright (c) 2007 - The OWASP Foundation - * - * The ESAPI is published by OWASP under the BSD license. You should read and accept the - * LICENSE before you use, modify, and/or redistribute this software. - * - * @author Jeff Williams Aspect Security - * @created 2007 - */ -package org.owasp.esapi; - -import java.io.IOException; -import java.io.InputStream; -import java.io.OutputStream; -import java.util.Set; - -import org.owasp.esapi.errors.EncryptionException; - - -/** - * The {@code EncryptedProperties} interface represents a properties file - * where all the data is encrypted before it is added, and decrypted when it - * retrieved. This interface can be implemented in a number of ways, the - * simplest being extending {@link java.util.Properties} and overloading - * the {@code getProperty} and {@code setProperty} methods. In all cases, - * the master encryption key, as given by the {@code Encryptor.MasterKey} - * property in ESAPI.properties file. - * - * @author Jeff Williams (jeff.williams .at. aspectsecurity.com) Aspect Security - * @since June 1, 2007 - */ -public interface EncryptedProperties { - - /** - * Gets the property value from the encrypted store, decrypts it, and - * returns the plaintext value to the caller. - * - * @param key - * the name of the property to get - * - * @return - * The decrypted property value. null if the key is not set. - * - * @throws EncryptionException - * if the property could not be decrypted - */ - String getProperty(String key) throws EncryptionException; - - /** - * Encrypts the plaintext property value and stores the ciphertext value - * in the encrypted store. - * - * @param key - * the name of the property to set - * @param value - * the value of the property to set - * - * @return - * the previously encrypted property value for the specified key, or - * {@code null} if it did not have one. - * - * @throws EncryptionException - * if the property could not be encrypted - */ - String setProperty(String key, String value) throws EncryptionException; - - /** - * Returns a {@code Set} view of properties. The {@code Set} is backed by a - * {@code java.util.Hashtable}, so changes to the {@code Hashtable} are - * reflected in the {@code Set}, and vice-versa. The {@code Set} supports element - * removal (which removes the corresponding entry from the {@code Hashtable), - * but not element addition. - * - * @return - * a set view of the properties contained in this map. - */ - public Set keySet(); - - /** - * Reads a property list (key and element pairs) from the input stream. - * - * @param in - * the input stream that contains the properties file - * - * @throws IOException - * Signals that an I/O exception has occurred. - */ - public void load(InputStream in) throws IOException; - - /** - * Writes this property list (key and element pairs) in this Properties table to - * the output stream in a format suitable for loading into a Properties table using the load method. - * - * @param out - * the output stream that contains the properties file - * @param comments - * a description of the property list (ex. "Encrypted Properties File"). - * - * @throws IOException - * Signals that an I/O exception has occurred. - */ - public void store(OutputStream out, String comments) throws IOException; - - -} +/** + * OWASP Enterprise Security API (ESAPI) + * + * This file is part of the Open Web Application Security Project (OWASP) + * Enterprise Security API (ESAPI) project. For details, please see + * http://www.owasp.org/index.php/ESAPI. + * + * Copyright (c) 2007 - The OWASP Foundation + * + * The ESAPI is published by OWASP under the BSD license. You should read and accept the + * LICENSE before you use, modify, and/or redistribute this software. + * + * @author Jeff Williams Aspect Security + * @created 2007 + */ +package org.owasp.esapi; + +import java.io.IOException; +import java.io.InputStream; +import java.io.OutputStream; +import java.util.Set; + +import org.owasp.esapi.errors.EncryptionException; + + +/** + * The {@code EncryptedProperties} interface represents a properties file + * where all the data is encrypted before it is added, and decrypted when it + * retrieved. This interface can be implemented in a number of ways, the + * simplest being extending {@link java.util.Properties} and overloading + * the {@code getProperty} and {@code setProperty} methods. In all cases, + * the master encryption key, as given by the {@code Encryptor.MasterKey} + * property in ESAPI.properties file. + * + * @author Jeff Williams (jeff.williams .at. aspectsecurity.com) Aspect Security + * @since June 1, 2007 + */ +public interface EncryptedProperties { + + /** + * Gets the property value from the encrypted store, decrypts it, and + * returns the plaintext value to the caller. + * + * @param key + * the name of the property to get + * + * @return + * The decrypted property value. null if the key is not set. + * + * @throws EncryptionException + * if the property could not be decrypted + */ + String getProperty(String key) throws EncryptionException; + + /** + * Encrypts the plaintext property value and stores the ciphertext value + * in the encrypted store. + * + * @param key + * the name of the property to set + * @param value + * the value of the property to set + * + * @return + * the previously encrypted property value for the specified key, or + * {@code null} if it did not have one. + * + * @throws EncryptionException + * if the property could not be encrypted + */ + String setProperty(String key, String value) throws EncryptionException; + + /** + * Returns a {@code Set} view of properties. The {@code Set} is backed by a + * {@code java.util.Hashtable}, so changes to the {@code Hashtable} are + * reflected in the {@code Set}, and vice-versa. The {@code Set} supports element + * removal (which removes the corresponding entry from the {@code Hashtable), + * but not element addition. + * + * @return + * a set view of the properties contained in this map. + */ + public Set keySet(); + + /** + * Reads a property list (key and element pairs) from the input stream. + * + * @param in + * the input stream that contains the properties file + * + * @throws IOException + * Signals that an I/O exception has occurred. + */ + public void load(InputStream in) throws IOException; + + /** + * Writes this property list (key and element pairs) in this Properties table to + * the output stream in a format suitable for loading into a Properties table using the load method. + * + * @param out + * the output stream that contains the properties file + * @param comments + * a description of the property list (ex. "Encrypted Properties File"). + * + * @throws IOException + * Signals that an I/O exception has occurred. + */ + public void store(OutputStream out, String comments) throws IOException; + + +} From cf3039aef11fac00c3aeabb776337db915e96c88 Mon Sep 17 00:00:00 2001 From: kwwall Date: Mon, 18 Jan 2016 23:33:48 -0500 Subject: [PATCH 107/812] Change CRLF to LF for issue 356. --- src/main/java/org/owasp/esapi/Encryptor.java | 634 +++++++++---------- 1 file changed, 317 insertions(+), 317 deletions(-) diff --git a/src/main/java/org/owasp/esapi/Encryptor.java b/src/main/java/org/owasp/esapi/Encryptor.java index 35bf094dd..979140c86 100644 --- a/src/main/java/org/owasp/esapi/Encryptor.java +++ b/src/main/java/org/owasp/esapi/Encryptor.java @@ -1,318 +1,318 @@ -/** - * OWASP Enterprise Security API (ESAPI) - * - * This file is part of the Open Web Application Security Project (OWASP) - * Enterprise Security API (ESAPI) project. For details, please see - * http://www.owasp.org/index.php/ESAPI. - * - * Copyright © 2007,2009 - The OWASP Foundation - * - * The ESAPI is published by OWASP under the BSD license. You should read and accept the - * LICENSE before you use, modify, and/or redistribute this software. - * - * @author Jeff Williams Aspect Security - * @author kevin.w.wall@gmail.com - * @created 2007 - */ -package org.owasp.esapi; - -import javax.crypto.SecretKey; - -import org.owasp.esapi.crypto.CipherText; -import org.owasp.esapi.crypto.PlainText; -import org.owasp.esapi.errors.EncryptionException; -import org.owasp.esapi.errors.IntegrityException; - - -/** - * The Encryptor interface provides a set of methods for performing common - * encryption, random number, and hashing operations. Implementations should - * rely on a strong cryptographic implementation, such as JCE or BouncyCastle. - * Implementors should take care to ensure that they initialize their - * implementation with a strong "master key", and that they protect this secret - * as much as possible. - *

    - * The main property controlling the selection of the implementation class is the - * property {@code ESAPI.Encryptor} in {@code ESAPI.properties}. Most of the - * the other encryption related properties have property names that start with - * the string "Encryptor.". These properties all you to do things such as - * select the encryption algorithms, the preferred JCE provider, etc. - *

    - * In addition, there are two important properties (initially delivered as unset - * from the ESAPI download) named {@code Encryptor.MasterKey} and - * {@code Encryptor.MasterSalt} that must be set before using ESAPI encryption. - * There is a bash(1) shell script provided with the standard ESAPI distribution - * called 'setMasterKey.sh' that will assist you in setting these two properties. The - * script is in 'src/examples/scripts/setMasterKey.sh'. - *

    - * Possible future enhancements (depending on feedback) are discussed in - * section 4 of - * - * Design Goals in OWASP ESAPI Cryptography. - * - * @author Jeff Williams (jeff.williams .at. aspectsecurity.com) Aspect Security - * @since June 1, 2007 - * @see User Guide for Symmetric Encryption in ESAPI 2.0 - */ -public interface Encryptor { - - /** - * Returns a string representation of the hash of the provided plaintext and - * salt. The salt helps to protect against a rainbow table attack by mixing - * in some extra data with the plaintext. Some good choices for a salt might - * be an account name or some other string that is known to the application - * but not to an attacker. - * See - * this article for more information about hashing as it pertains to password schemes. - * - * @param plaintext - * the plaintext String to encrypt - * @param salt - * the salt to add to the plaintext String before hashing - * - * @return - * the encrypted hash of 'plaintext' stored as a String - * - * @throws EncryptionException - * if the specified hash algorithm could not be found or another problem exists with - * the hashing of 'plaintext' - */ - String hash(String plaintext, String salt) throws EncryptionException; - - /** - * Returns a string representation of the hash of the provided plaintext and - * salt. The salt helps to protect against a rainbow table attack by mixing - * in some extra data with the plaintext. Some good choices for a salt might - * be an account name or some other string that is known to the application - * but not to an attacker. - * See - * this article for more information about hashing as it pertains to password schemes. - * - * @param plaintext - * the plaintext String to encrypt - * @param salt - * the salt to add to the plaintext String before hashing - * @param iterations - * the number of times to iterate the hash - * - * @return - * the encrypted hash of 'plaintext' stored as a String - * - * @throws EncryptionException - * if the specified hash algorithm could not be found or another problem exists with - * the hashing of 'plaintext' - */ - String hash(String plaintext, String salt, int iterations) throws EncryptionException; - - /** - * Encrypts the provided plaintext bytes using the cipher transformation - * specified by the property Encryptor.CipherTransformation - * and the master encryption key as specified by the property - * {@code Encryptor.MasterKey} as defined in the ESAPI.properties file. - *

    - * - * @param plaintext The {@code PlainText} to be encrypted. - * @return the {@code CipherText} object from which the raw ciphertext, the - * IV, the cipher transformation, and many other aspects about - * the encryption detail may be extracted. - * @throws EncryptionException Thrown if something should go wrong such as - * the JCE provider cannot be found, the cipher algorithm, - * cipher mode, or padding scheme not being supported, specifying - * an unsupported key size, specifying an IV of incorrect length, - * etc. - * @see #encrypt(SecretKey, PlainText) - * @since 2.0 - */ - CipherText encrypt(PlainText plaintext) throws EncryptionException; - - - /** - * Encrypts the provided plaintext bytes using the cipher transformation - * specified by the property Encryptor.CipherTransformation - * as defined in the ESAPI.properties file and the - * specified secret key. - *

    - * This method is similar to {@link #encrypt(PlainText)} except that it - * permits a specific {@code SecretKey} to be used for encryption. - * - * @param key The {@code SecretKey} to use for encrypting the plaintext. - * @param plaintext The byte stream to be encrypted. Note if a Java - * {@code String} is to be encrypted, it should be converted - * using {@code "some string".getBytes("UTF-8")}. - * @return the {@code CipherText} object from which the raw ciphertext, the - * IV, the cipher transformation, and many other aspects about - * the encryption detail may be extracted. - * @throws EncryptionException Thrown if something should go wrong such as - * the JCE provider cannot be found, the cipher algorithm, - * cipher mode, or padding scheme not being supported, specifying - * an unsupported key size, specifying an IV of incorrect length, - * etc. - * @see #encrypt(PlainText) - * @since 2.0 - */ - CipherText encrypt(SecretKey key, PlainText plaintext) - throws EncryptionException; - - /** - * Decrypts the provided {@link CipherText} using the information from it - * and the master encryption key as specified by the property - * {@code Encryptor.MasterKey} as defined in the {@code ESAPI.properties} - * file. - *

    - * @param ciphertext The {@code CipherText} object to be decrypted. - * @return The {@code PlainText} object resulting from decrypting the specified - * ciphertext. Note that it it is desired to convert the returned - * plaintext byte array to a Java String is should be done using - * {@code new String(byte[], "UTF-8");} rather than simply using - * {@code new String(byte[]);} which uses native encoding and may - * not be portable across hardware and/or OS platforms. - * @throws EncryptionException Thrown if something should go wrong such as - * the JCE provider cannot be found, the cipher algorithm, - * cipher mode, or padding scheme not being supported, specifying - * an unsupported key size, or incorrect encryption key was - * specified or a {@code PaddingException} occurs. - * @see #decrypt(SecretKey, CipherText) - */ - PlainText decrypt(CipherText ciphertext) throws EncryptionException; - - /** - * Decrypts the provided {@link CipherText} using the information from it - * and the specified secret key. - *

    - * This decrypt method is similar to {@link #decrypt(CipherText)} except that - * it allows decrypting with a secret key other than the master secret key. - *

    - * @param key The {@code SecretKey} to use for encrypting the plaintext. - * @param ciphertext The {@code CipherText} object to be decrypted. - * @return The {@code PlainText} object resulting from decrypting the specified - * ciphertext. Note that it it is desired to convert the returned - * plaintext byte array to a Java String is should be done using - * {@code new String(byte[], "UTF-8");} rather than simply using - * {@code new String(byte[]);} which uses native encoding and may - * not be portable across hardware and/or OS platforms. - * @throws EncryptionException Thrown if something should go wrong such as - * the JCE provider cannot be found, the cipher algorithm, - * cipher mode, or padding scheme not being supported, specifying - * an unsupported key size, or incorrect encryption key was - * specified or a {@code PaddingException} occurs. - * @see #decrypt(CipherText) - */ - PlainText decrypt(SecretKey key, CipherText ciphertext) throws EncryptionException; - - /** - * Create a digital signature for the provided data and return it in a - * string. - *

    - * Limitations: A new public/private key pair used for ESAPI 2.0 digital - * signatures with this method and {@link #verifySignature(String, String)} - * are dynamically created when the default reference implementation class, - * {@link org.owasp.esapi.reference.crypto.JavaEncryptor} is first created. - * Because this key pair is not persisted nor is the public key shared, - * this method and the corresponding {@link #verifySignature(String, String)} - * can not be used with expected results across JVM instances. This limitation - * will be addressed in ESAPI 2.1. - *

    - * - * @param data - * the data to sign - * - * @return - * the digital signature stored as a String - * - * @throws EncryptionException - * if the specified signature algorithm cannot be found - */ - String sign(String data) throws EncryptionException; - - /** - * Verifies a digital signature (created with the sign method) and returns - * the boolean result. - *

    - * Limitations: A new public/private key pair used for ESAPI 2.0 digital - * signatures with this method and {@link #sign(String)} - * are dynamically created when the default reference implementation class, - * {@link org.owasp.esapi.reference.crypto.JavaEncryptor} is first created. - * Because this key pair is not persisted nor is the public key shared, - * this method and the corresponding {@link #sign(String)} - * can not be used with expected results across JVM instances. This limitation - * will be addressed in ESAPI 2.1. - *

    - * @param signature - * the signature to verify against 'data' - * @param data - * the data to verify against 'signature' - * - * @return - * true, if the signature is verified, false otherwise - * - */ - boolean verifySignature(String signature, String data); - - /** - * Creates a seal that binds a set of data and includes an expiration timestamp. - * - * @param data - * the data to seal - * @param timestamp - * the absolute expiration date of the data, expressed as seconds since the epoch - * - * @return - * the seal - * @throws IntegrityException - * - */ - String seal(String data, long timestamp) throws IntegrityException; - - /** - * Unseals data (created with the seal method) and throws an exception - * describing any of the various problems that could exist with a seal, such - * as an invalid seal format, expired timestamp, or decryption error. - * - * @param seal - * the sealed data - * - * @return - * the original (unsealed) data - * - * @throws EncryptionException - * if the unsealed data cannot be retrieved for any reason - */ - String unseal( String seal ) throws EncryptionException; - - /** - * Verifies a seal (created with the seal method) and throws an exception - * describing any of the various problems that could exist with a seal, such - * as an invalid seal format, expired timestamp, or data mismatch. - * - * @param seal - * the seal to verify - * - * @return - * true, if the seal is valid. False otherwise - */ - boolean verifySeal(String seal); - - /** - * Gets an absolute timestamp representing an offset from the current time to be used by - * other functions in the library. - * - * @param offset - * the offset to add to the current time - * - * @return - * the absolute timestamp - */ - public long getRelativeTimeStamp( long offset ); - - - /** - * Gets a timestamp representing the current date and time to be used by - * other functions in the library. - * - * @return - * a timestamp representing the current time - */ - long getTimeStamp(); - +/** + * OWASP Enterprise Security API (ESAPI) + * + * This file is part of the Open Web Application Security Project (OWASP) + * Enterprise Security API (ESAPI) project. For details, please see + * http://www.owasp.org/index.php/ESAPI. + * + * Copyright © 2007,2009 - The OWASP Foundation + * + * The ESAPI is published by OWASP under the BSD license. You should read and accept the + * LICENSE before you use, modify, and/or redistribute this software. + * + * @author Jeff Williams Aspect Security + * @author kevin.w.wall@gmail.com + * @created 2007 + */ +package org.owasp.esapi; + +import javax.crypto.SecretKey; + +import org.owasp.esapi.crypto.CipherText; +import org.owasp.esapi.crypto.PlainText; +import org.owasp.esapi.errors.EncryptionException; +import org.owasp.esapi.errors.IntegrityException; + + +/** + * The Encryptor interface provides a set of methods for performing common + * encryption, random number, and hashing operations. Implementations should + * rely on a strong cryptographic implementation, such as JCE or BouncyCastle. + * Implementors should take care to ensure that they initialize their + * implementation with a strong "master key", and that they protect this secret + * as much as possible. + *

    + * The main property controlling the selection of the implementation class is the + * property {@code ESAPI.Encryptor} in {@code ESAPI.properties}. Most of the + * the other encryption related properties have property names that start with + * the string "Encryptor.". These properties all you to do things such as + * select the encryption algorithms, the preferred JCE provider, etc. + *

    + * In addition, there are two important properties (initially delivered as unset + * from the ESAPI download) named {@code Encryptor.MasterKey} and + * {@code Encryptor.MasterSalt} that must be set before using ESAPI encryption. + * There is a bash(1) shell script provided with the standard ESAPI distribution + * called 'setMasterKey.sh' that will assist you in setting these two properties. The + * script is in 'src/examples/scripts/setMasterKey.sh'. + *

    + * Possible future enhancements (depending on feedback) are discussed in + * section 4 of + * + * Design Goals in OWASP ESAPI Cryptography. + * + * @author Jeff Williams (jeff.williams .at. aspectsecurity.com) Aspect Security + * @since June 1, 2007 + * @see User Guide for Symmetric Encryption in ESAPI 2.0 + */ +public interface Encryptor { + + /** + * Returns a string representation of the hash of the provided plaintext and + * salt. The salt helps to protect against a rainbow table attack by mixing + * in some extra data with the plaintext. Some good choices for a salt might + * be an account name or some other string that is known to the application + * but not to an attacker. + * See + * this article for more information about hashing as it pertains to password schemes. + * + * @param plaintext + * the plaintext String to encrypt + * @param salt + * the salt to add to the plaintext String before hashing + * + * @return + * the encrypted hash of 'plaintext' stored as a String + * + * @throws EncryptionException + * if the specified hash algorithm could not be found or another problem exists with + * the hashing of 'plaintext' + */ + String hash(String plaintext, String salt) throws EncryptionException; + + /** + * Returns a string representation of the hash of the provided plaintext and + * salt. The salt helps to protect against a rainbow table attack by mixing + * in some extra data with the plaintext. Some good choices for a salt might + * be an account name or some other string that is known to the application + * but not to an attacker. + * See + * this article for more information about hashing as it pertains to password schemes. + * + * @param plaintext + * the plaintext String to encrypt + * @param salt + * the salt to add to the plaintext String before hashing + * @param iterations + * the number of times to iterate the hash + * + * @return + * the encrypted hash of 'plaintext' stored as a String + * + * @throws EncryptionException + * if the specified hash algorithm could not be found or another problem exists with + * the hashing of 'plaintext' + */ + String hash(String plaintext, String salt, int iterations) throws EncryptionException; + + /** + * Encrypts the provided plaintext bytes using the cipher transformation + * specified by the property Encryptor.CipherTransformation + * and the master encryption key as specified by the property + * {@code Encryptor.MasterKey} as defined in the ESAPI.properties file. + *

    + * + * @param plaintext The {@code PlainText} to be encrypted. + * @return the {@code CipherText} object from which the raw ciphertext, the + * IV, the cipher transformation, and many other aspects about + * the encryption detail may be extracted. + * @throws EncryptionException Thrown if something should go wrong such as + * the JCE provider cannot be found, the cipher algorithm, + * cipher mode, or padding scheme not being supported, specifying + * an unsupported key size, specifying an IV of incorrect length, + * etc. + * @see #encrypt(SecretKey, PlainText) + * @since 2.0 + */ + CipherText encrypt(PlainText plaintext) throws EncryptionException; + + + /** + * Encrypts the provided plaintext bytes using the cipher transformation + * specified by the property Encryptor.CipherTransformation + * as defined in the ESAPI.properties file and the + * specified secret key. + *

    + * This method is similar to {@link #encrypt(PlainText)} except that it + * permits a specific {@code SecretKey} to be used for encryption. + * + * @param key The {@code SecretKey} to use for encrypting the plaintext. + * @param plaintext The byte stream to be encrypted. Note if a Java + * {@code String} is to be encrypted, it should be converted + * using {@code "some string".getBytes("UTF-8")}. + * @return the {@code CipherText} object from which the raw ciphertext, the + * IV, the cipher transformation, and many other aspects about + * the encryption detail may be extracted. + * @throws EncryptionException Thrown if something should go wrong such as + * the JCE provider cannot be found, the cipher algorithm, + * cipher mode, or padding scheme not being supported, specifying + * an unsupported key size, specifying an IV of incorrect length, + * etc. + * @see #encrypt(PlainText) + * @since 2.0 + */ + CipherText encrypt(SecretKey key, PlainText plaintext) + throws EncryptionException; + + /** + * Decrypts the provided {@link CipherText} using the information from it + * and the master encryption key as specified by the property + * {@code Encryptor.MasterKey} as defined in the {@code ESAPI.properties} + * file. + *

    + * @param ciphertext The {@code CipherText} object to be decrypted. + * @return The {@code PlainText} object resulting from decrypting the specified + * ciphertext. Note that it it is desired to convert the returned + * plaintext byte array to a Java String is should be done using + * {@code new String(byte[], "UTF-8");} rather than simply using + * {@code new String(byte[]);} which uses native encoding and may + * not be portable across hardware and/or OS platforms. + * @throws EncryptionException Thrown if something should go wrong such as + * the JCE provider cannot be found, the cipher algorithm, + * cipher mode, or padding scheme not being supported, specifying + * an unsupported key size, or incorrect encryption key was + * specified or a {@code PaddingException} occurs. + * @see #decrypt(SecretKey, CipherText) + */ + PlainText decrypt(CipherText ciphertext) throws EncryptionException; + + /** + * Decrypts the provided {@link CipherText} using the information from it + * and the specified secret key. + *

    + * This decrypt method is similar to {@link #decrypt(CipherText)} except that + * it allows decrypting with a secret key other than the master secret key. + *

    + * @param key The {@code SecretKey} to use for encrypting the plaintext. + * @param ciphertext The {@code CipherText} object to be decrypted. + * @return The {@code PlainText} object resulting from decrypting the specified + * ciphertext. Note that it it is desired to convert the returned + * plaintext byte array to a Java String is should be done using + * {@code new String(byte[], "UTF-8");} rather than simply using + * {@code new String(byte[]);} which uses native encoding and may + * not be portable across hardware and/or OS platforms. + * @throws EncryptionException Thrown if something should go wrong such as + * the JCE provider cannot be found, the cipher algorithm, + * cipher mode, or padding scheme not being supported, specifying + * an unsupported key size, or incorrect encryption key was + * specified or a {@code PaddingException} occurs. + * @see #decrypt(CipherText) + */ + PlainText decrypt(SecretKey key, CipherText ciphertext) throws EncryptionException; + + /** + * Create a digital signature for the provided data and return it in a + * string. + *

    + * Limitations: A new public/private key pair used for ESAPI 2.0 digital + * signatures with this method and {@link #verifySignature(String, String)} + * are dynamically created when the default reference implementation class, + * {@link org.owasp.esapi.reference.crypto.JavaEncryptor} is first created. + * Because this key pair is not persisted nor is the public key shared, + * this method and the corresponding {@link #verifySignature(String, String)} + * can not be used with expected results across JVM instances. This limitation + * will be addressed in ESAPI 2.1. + *

    + * + * @param data + * the data to sign + * + * @return + * the digital signature stored as a String + * + * @throws EncryptionException + * if the specified signature algorithm cannot be found + */ + String sign(String data) throws EncryptionException; + + /** + * Verifies a digital signature (created with the sign method) and returns + * the boolean result. + *

    + * Limitations: A new public/private key pair used for ESAPI 2.0 digital + * signatures with this method and {@link #sign(String)} + * are dynamically created when the default reference implementation class, + * {@link org.owasp.esapi.reference.crypto.JavaEncryptor} is first created. + * Because this key pair is not persisted nor is the public key shared, + * this method and the corresponding {@link #sign(String)} + * can not be used with expected results across JVM instances. This limitation + * will be addressed in ESAPI 2.1. + *

    + * @param signature + * the signature to verify against 'data' + * @param data + * the data to verify against 'signature' + * + * @return + * true, if the signature is verified, false otherwise + * + */ + boolean verifySignature(String signature, String data); + + /** + * Creates a seal that binds a set of data and includes an expiration timestamp. + * + * @param data + * the data to seal + * @param timestamp + * the absolute expiration date of the data, expressed as seconds since the epoch + * + * @return + * the seal + * @throws IntegrityException + * + */ + String seal(String data, long timestamp) throws IntegrityException; + + /** + * Unseals data (created with the seal method) and throws an exception + * describing any of the various problems that could exist with a seal, such + * as an invalid seal format, expired timestamp, or decryption error. + * + * @param seal + * the sealed data + * + * @return + * the original (unsealed) data + * + * @throws EncryptionException + * if the unsealed data cannot be retrieved for any reason + */ + String unseal( String seal ) throws EncryptionException; + + /** + * Verifies a seal (created with the seal method) and throws an exception + * describing any of the various problems that could exist with a seal, such + * as an invalid seal format, expired timestamp, or data mismatch. + * + * @param seal + * the seal to verify + * + * @return + * true, if the seal is valid. False otherwise + */ + boolean verifySeal(String seal); + + /** + * Gets an absolute timestamp representing an offset from the current time to be used by + * other functions in the library. + * + * @param offset + * the offset to add to the current time + * + * @return + * the absolute timestamp + */ + public long getRelativeTimeStamp( long offset ); + + + /** + * Gets a timestamp representing the current date and time to be used by + * other functions in the library. + * + * @return + * a timestamp representing the current time + */ + long getTimeStamp(); + } \ No newline at end of file From 2fea8174b8820d62decbfefc5dc51ecbb5ddcd96 Mon Sep 17 00:00:00 2001 From: kwwall Date: Mon, 18 Jan 2016 23:33:48 -0500 Subject: [PATCH 108/812] Change CRLF to LF for issue 356. --- .../AuthenticationAccountsException.java | 118 +++++++++--------- 1 file changed, 59 insertions(+), 59 deletions(-) diff --git a/src/main/java/org/owasp/esapi/errors/AuthenticationAccountsException.java b/src/main/java/org/owasp/esapi/errors/AuthenticationAccountsException.java index 98954db6f..c81ff844b 100644 --- a/src/main/java/org/owasp/esapi/errors/AuthenticationAccountsException.java +++ b/src/main/java/org/owasp/esapi/errors/AuthenticationAccountsException.java @@ -1,59 +1,59 @@ -/** - * OWASP Enterprise Security API (ESAPI) - * - * This file is part of the Open Web Application Security Project (OWASP) - * Enterprise Security API (ESAPI) project. For details, please see - * http://www.owasp.org/index.php/ESAPI. - * - * Copyright (c) 2007 - The OWASP Foundation - * - * The ESAPI is published by OWASP under the BSD license. You should read and accept the - * LICENSE before you use, modify, and/or redistribute this software. - * - * @author Jeff Williams Aspect Security - * @created 2007 - */ -package org.owasp.esapi.errors; - -/** - * An AuthenticationException should be thrown when anything goes wrong during - * login or logout. They are also appropriate for any problems related to - * identity management. - * - * @author Jeff Williams (jeff.williams@aspectsecurity.com) - */ -public class AuthenticationAccountsException extends AuthenticationException { - - /** The Constant serialVersionUID. */ - private static final long serialVersionUID = 1L; - - /** - * Instantiates a new authentication exception. - */ - protected AuthenticationAccountsException() { - // hidden - } - - /** - * Creates a new instance of {@code AuthenticationAccountsException}. - * - * @param userMessage the message displayed to the user - * @param logMessage the message logged - * - */ - public AuthenticationAccountsException(String userMessage, String logMessage) { - super(userMessage, logMessage); - } - - /** - * Instantiates a new authentication exception. - * - * @param userMessage the message displayed to the user - * @param logMessage the message logged - * @param cause the root cause - */ - public AuthenticationAccountsException(String userMessage, String logMessage, Throwable cause) { - super(userMessage, logMessage, cause); - } - -} +/** + * OWASP Enterprise Security API (ESAPI) + * + * This file is part of the Open Web Application Security Project (OWASP) + * Enterprise Security API (ESAPI) project. For details, please see + * http://www.owasp.org/index.php/ESAPI. + * + * Copyright (c) 2007 - The OWASP Foundation + * + * The ESAPI is published by OWASP under the BSD license. You should read and accept the + * LICENSE before you use, modify, and/or redistribute this software. + * + * @author Jeff Williams Aspect Security + * @created 2007 + */ +package org.owasp.esapi.errors; + +/** + * An AuthenticationException should be thrown when anything goes wrong during + * login or logout. They are also appropriate for any problems related to + * identity management. + * + * @author Jeff Williams (jeff.williams@aspectsecurity.com) + */ +public class AuthenticationAccountsException extends AuthenticationException { + + /** The Constant serialVersionUID. */ + private static final long serialVersionUID = 1L; + + /** + * Instantiates a new authentication exception. + */ + protected AuthenticationAccountsException() { + // hidden + } + + /** + * Creates a new instance of {@code AuthenticationAccountsException}. + * + * @param userMessage the message displayed to the user + * @param logMessage the message logged + * + */ + public AuthenticationAccountsException(String userMessage, String logMessage) { + super(userMessage, logMessage); + } + + /** + * Instantiates a new authentication exception. + * + * @param userMessage the message displayed to the user + * @param logMessage the message logged + * @param cause the root cause + */ + public AuthenticationAccountsException(String userMessage, String logMessage, Throwable cause) { + super(userMessage, logMessage, cause); + } + +} From 4cd63092d4f8f98f9bbc3e5a139a735d81d8a3a6 Mon Sep 17 00:00:00 2001 From: kwwall Date: Mon, 18 Jan 2016 23:33:48 -0500 Subject: [PATCH 109/812] Change CRLF to LF for issue 356. --- .../AuthenticationCredentialsException.java | 116 +++++++++--------- 1 file changed, 58 insertions(+), 58 deletions(-) diff --git a/src/main/java/org/owasp/esapi/errors/AuthenticationCredentialsException.java b/src/main/java/org/owasp/esapi/errors/AuthenticationCredentialsException.java index 0bcd0a70f..e48187739 100644 --- a/src/main/java/org/owasp/esapi/errors/AuthenticationCredentialsException.java +++ b/src/main/java/org/owasp/esapi/errors/AuthenticationCredentialsException.java @@ -1,58 +1,58 @@ -/** - * OWASP Enterprise Security API (ESAPI) - * - * This file is part of the Open Web Application Security Project (OWASP) - * Enterprise Security API (ESAPI) project. For details, please see - * http://www.owasp.org/index.php/ESAPI. - * - * Copyright (c) 2007 - The OWASP Foundation - * - * The ESAPI is published by OWASP under the BSD license. You should read and accept the - * LICENSE before you use, modify, and/or redistribute this software. - * - * @author Jeff Williams Aspect Security - * @created 2007 - */ -package org.owasp.esapi.errors; - -/** - * An AuthenticationException should be thrown when anything goes wrong during - * login or logout. They are also appropriate for any problems related to - * identity management. - * - * @author Jeff Williams (jeff.williams@aspectsecurity.com) - */ -public class AuthenticationCredentialsException extends AuthenticationException { - - /** The Constant serialVersionUID. */ - private static final long serialVersionUID = 1L; - - /** - * Instantiates a new authentication exception. - */ - protected AuthenticationCredentialsException() { - // hidden - } - - /** - * Creates a new instance of {@code AuthenticationCredentialsException}. - * - * @param userMessage the message displayed to the user - * @param logMessage the message logged - */ - public AuthenticationCredentialsException(String userMessage, String logMessage) { - super(userMessage, logMessage); - } - - /** - * Instantiates a new authentication exception. - * - * @param userMessage the message displayed to the user - * @param logMessage the message logged - * @param cause the root cause - */ - public AuthenticationCredentialsException(String userMessage, String logMessage, Throwable cause) { - super(userMessage, logMessage, cause); - } - -} +/** + * OWASP Enterprise Security API (ESAPI) + * + * This file is part of the Open Web Application Security Project (OWASP) + * Enterprise Security API (ESAPI) project. For details, please see + * http://www.owasp.org/index.php/ESAPI. + * + * Copyright (c) 2007 - The OWASP Foundation + * + * The ESAPI is published by OWASP under the BSD license. You should read and accept the + * LICENSE before you use, modify, and/or redistribute this software. + * + * @author Jeff Williams Aspect Security + * @created 2007 + */ +package org.owasp.esapi.errors; + +/** + * An AuthenticationException should be thrown when anything goes wrong during + * login or logout. They are also appropriate for any problems related to + * identity management. + * + * @author Jeff Williams (jeff.williams@aspectsecurity.com) + */ +public class AuthenticationCredentialsException extends AuthenticationException { + + /** The Constant serialVersionUID. */ + private static final long serialVersionUID = 1L; + + /** + * Instantiates a new authentication exception. + */ + protected AuthenticationCredentialsException() { + // hidden + } + + /** + * Creates a new instance of {@code AuthenticationCredentialsException}. + * + * @param userMessage the message displayed to the user + * @param logMessage the message logged + */ + public AuthenticationCredentialsException(String userMessage, String logMessage) { + super(userMessage, logMessage); + } + + /** + * Instantiates a new authentication exception. + * + * @param userMessage the message displayed to the user + * @param logMessage the message logged + * @param cause the root cause + */ + public AuthenticationCredentialsException(String userMessage, String logMessage, Throwable cause) { + super(userMessage, logMessage, cause); + } + +} From 085618183e6e37ffeee359f974c2e61721bce7e7 Mon Sep 17 00:00:00 2001 From: kwwall Date: Mon, 18 Jan 2016 23:33:48 -0500 Subject: [PATCH 110/812] Change CRLF to LF for issue 356. --- .../esapi/errors/AuthenticationException.java | 116 +++++++++--------- 1 file changed, 58 insertions(+), 58 deletions(-) diff --git a/src/main/java/org/owasp/esapi/errors/AuthenticationException.java b/src/main/java/org/owasp/esapi/errors/AuthenticationException.java index 12ef63e9e..c8198f57f 100644 --- a/src/main/java/org/owasp/esapi/errors/AuthenticationException.java +++ b/src/main/java/org/owasp/esapi/errors/AuthenticationException.java @@ -1,58 +1,58 @@ -/** - * OWASP Enterprise Security API (ESAPI) - * - * This file is part of the Open Web Application Security Project (OWASP) - * Enterprise Security API (ESAPI) project. For details, please see - * http://www.owasp.org/index.php/ESAPI. - * - * Copyright (c) 2007 - The OWASP Foundation - * - * The ESAPI is published by OWASP under the BSD license. You should read and accept the - * LICENSE before you use, modify, and/or redistribute this software. - * - * @author Jeff Williams Aspect Security - * @created 2007 - */ -package org.owasp.esapi.errors; - -/** - * An AuthenticationException should be thrown when anything goes wrong during - * login or logout. They are also appropriate for any problems related to - * identity management. - * - * @author Jeff Williams (jeff.williams@aspectsecurity.com) - */ -public class AuthenticationException extends EnterpriseSecurityException { - - /** The Constant serialVersionUID. */ - private static final long serialVersionUID = 1L; - - /** - * Instantiates a new authentication exception. - */ - protected AuthenticationException() { - // hidden - } - - /** - * Creates a new instance of {@code AuthenticationException}. - * - * @param userMessage the message displayed to the user - * @param logMessage the message logged - */ - public AuthenticationException(String userMessage, String logMessage) { - super(userMessage, logMessage); - } - - /** - * Instantiates a new authentication exception. - * - * @param userMessage the message displayed to the user - * @param logMessage the message logged - * @param cause the root cause - */ - public AuthenticationException(String userMessage, String logMessage, Throwable cause) { - super(userMessage, logMessage, cause); - } - -} +/** + * OWASP Enterprise Security API (ESAPI) + * + * This file is part of the Open Web Application Security Project (OWASP) + * Enterprise Security API (ESAPI) project. For details, please see + * http://www.owasp.org/index.php/ESAPI. + * + * Copyright (c) 2007 - The OWASP Foundation + * + * The ESAPI is published by OWASP under the BSD license. You should read and accept the + * LICENSE before you use, modify, and/or redistribute this software. + * + * @author Jeff Williams Aspect Security + * @created 2007 + */ +package org.owasp.esapi.errors; + +/** + * An AuthenticationException should be thrown when anything goes wrong during + * login or logout. They are also appropriate for any problems related to + * identity management. + * + * @author Jeff Williams (jeff.williams@aspectsecurity.com) + */ +public class AuthenticationException extends EnterpriseSecurityException { + + /** The Constant serialVersionUID. */ + private static final long serialVersionUID = 1L; + + /** + * Instantiates a new authentication exception. + */ + protected AuthenticationException() { + // hidden + } + + /** + * Creates a new instance of {@code AuthenticationException}. + * + * @param userMessage the message displayed to the user + * @param logMessage the message logged + */ + public AuthenticationException(String userMessage, String logMessage) { + super(userMessage, logMessage); + } + + /** + * Instantiates a new authentication exception. + * + * @param userMessage the message displayed to the user + * @param logMessage the message logged + * @param cause the root cause + */ + public AuthenticationException(String userMessage, String logMessage, Throwable cause) { + super(userMessage, logMessage, cause); + } + +} From ae57d5a3a2a81eb05b5617bfc3503e9041088144 Mon Sep 17 00:00:00 2001 From: kwwall Date: Mon, 18 Jan 2016 23:33:48 -0500 Subject: [PATCH 111/812] Change CRLF to LF for issue 356. --- .../errors/AuthenticationHostException.java | 114 +++++++++--------- 1 file changed, 57 insertions(+), 57 deletions(-) diff --git a/src/main/java/org/owasp/esapi/errors/AuthenticationHostException.java b/src/main/java/org/owasp/esapi/errors/AuthenticationHostException.java index 159a60b67..1deac4b72 100644 --- a/src/main/java/org/owasp/esapi/errors/AuthenticationHostException.java +++ b/src/main/java/org/owasp/esapi/errors/AuthenticationHostException.java @@ -1,57 +1,57 @@ -/** - * OWASP Enterprise Security API (ESAPI) - * - * This file is part of the Open Web Application Security Project (OWASP) - * Enterprise Security API (ESAPI) project. For details, please see - * http://www.owasp.org/index.php/ESAPI. - * - * Copyright (c) 2007 - The OWASP Foundation - * - * The ESAPI is published by OWASP under the BSD license. You should read and accept the - * LICENSE before you use, modify, and/or redistribute this software. - * - * @author Jeff Williams Aspect Security - * @created 2007 - */ -package org.owasp.esapi.errors; - -/** - * An AuthenticationHostException should be thrown when there is a problem with - * the host involved with authentication, particularly if the host changes unexpectedly. - * - * @author Jeff Williams (jeff.williams@aspectsecurity.com) - */ -public class AuthenticationHostException extends AuthenticationException { - - /** The Constant serialVersionUID. */ - private static final long serialVersionUID = 1L; - - /** - * Instantiates a new authentication exception. - */ - protected AuthenticationHostException() { - // hidden - } - - /** - * Creates a new instance of AuthenticationHostException. - * - * @param userMessage the message displayed to the user - * @param logMessage the message logged - */ - public AuthenticationHostException(String userMessage, String logMessage) { - super(userMessage, logMessage); - } - - /** - * Instantiates a new authentication exception. - * - * @param userMessage the message displayed to the user - * @param logMessage the message logged - * @param cause the cause - */ - public AuthenticationHostException(String userMessage, String logMessage, Throwable cause) { - super(userMessage, logMessage, cause); - } - -} +/** + * OWASP Enterprise Security API (ESAPI) + * + * This file is part of the Open Web Application Security Project (OWASP) + * Enterprise Security API (ESAPI) project. For details, please see + * http://www.owasp.org/index.php/ESAPI. + * + * Copyright (c) 2007 - The OWASP Foundation + * + * The ESAPI is published by OWASP under the BSD license. You should read and accept the + * LICENSE before you use, modify, and/or redistribute this software. + * + * @author Jeff Williams Aspect Security + * @created 2007 + */ +package org.owasp.esapi.errors; + +/** + * An AuthenticationHostException should be thrown when there is a problem with + * the host involved with authentication, particularly if the host changes unexpectedly. + * + * @author Jeff Williams (jeff.williams@aspectsecurity.com) + */ +public class AuthenticationHostException extends AuthenticationException { + + /** The Constant serialVersionUID. */ + private static final long serialVersionUID = 1L; + + /** + * Instantiates a new authentication exception. + */ + protected AuthenticationHostException() { + // hidden + } + + /** + * Creates a new instance of AuthenticationHostException. + * + * @param userMessage the message displayed to the user + * @param logMessage the message logged + */ + public AuthenticationHostException(String userMessage, String logMessage) { + super(userMessage, logMessage); + } + + /** + * Instantiates a new authentication exception. + * + * @param userMessage the message displayed to the user + * @param logMessage the message logged + * @param cause the cause + */ + public AuthenticationHostException(String userMessage, String logMessage, Throwable cause) { + super(userMessage, logMessage, cause); + } + +} From 8fa2fec8cc2a392da648388cdca3a42b13a7213d Mon Sep 17 00:00:00 2001 From: kwwall Date: Mon, 18 Jan 2016 23:33:48 -0500 Subject: [PATCH 112/812] Change CRLF to LF for issue 356. --- .../errors/AuthenticationLoginException.java | 116 +++++++++--------- 1 file changed, 58 insertions(+), 58 deletions(-) diff --git a/src/main/java/org/owasp/esapi/errors/AuthenticationLoginException.java b/src/main/java/org/owasp/esapi/errors/AuthenticationLoginException.java index 6effd2af9..d389591bc 100644 --- a/src/main/java/org/owasp/esapi/errors/AuthenticationLoginException.java +++ b/src/main/java/org/owasp/esapi/errors/AuthenticationLoginException.java @@ -1,58 +1,58 @@ -/** - * OWASP Enterprise Security API (ESAPI) - * - * This file is part of the Open Web Application Security Project (OWASP) - * Enterprise Security API (ESAPI) project. For details, please see - * http://www.owasp.org/index.php/ESAPI. - * - * Copyright (c) 2007 - The OWASP Foundation - * - * The ESAPI is published by OWASP under the BSD license. You should read and accept the - * LICENSE before you use, modify, and/or redistribute this software. - * - * @author Jeff Williams Aspect Security - * @created 2007 - */ -package org.owasp.esapi.errors; - -/** - * An AuthenticationException should be thrown when anything goes wrong during - * login or logout. They are also appropriate for any problems related to - * identity management. - * - * @author Jeff Williams (jeff.williams@aspectsecurity.com) - */ -public class AuthenticationLoginException extends AuthenticationException { - - /** The Constant serialVersionUID. */ - private static final long serialVersionUID = 1L; - - /** - * Instantiates a new authentication exception. - */ - protected AuthenticationLoginException() { - // hidden - } - - /** - * Creates a new instance of EnterpriseSecurityException. - * - * @param userMessage the message displayed to the user - * @param logMessage the message logged - */ - public AuthenticationLoginException(String userMessage, String logMessage) { - super(userMessage, logMessage); - } - - /** - * Instantiates a new authentication exception. - * - * @param userMessage the message displayed to the user - * @param logMessage the message logged - * @param cause the cause - */ - public AuthenticationLoginException(String userMessage, String logMessage, Throwable cause) { - super(userMessage, logMessage, cause); - } - -} +/** + * OWASP Enterprise Security API (ESAPI) + * + * This file is part of the Open Web Application Security Project (OWASP) + * Enterprise Security API (ESAPI) project. For details, please see + * http://www.owasp.org/index.php/ESAPI. + * + * Copyright (c) 2007 - The OWASP Foundation + * + * The ESAPI is published by OWASP under the BSD license. You should read and accept the + * LICENSE before you use, modify, and/or redistribute this software. + * + * @author Jeff Williams Aspect Security + * @created 2007 + */ +package org.owasp.esapi.errors; + +/** + * An AuthenticationException should be thrown when anything goes wrong during + * login or logout. They are also appropriate for any problems related to + * identity management. + * + * @author Jeff Williams (jeff.williams@aspectsecurity.com) + */ +public class AuthenticationLoginException extends AuthenticationException { + + /** The Constant serialVersionUID. */ + private static final long serialVersionUID = 1L; + + /** + * Instantiates a new authentication exception. + */ + protected AuthenticationLoginException() { + // hidden + } + + /** + * Creates a new instance of EnterpriseSecurityException. + * + * @param userMessage the message displayed to the user + * @param logMessage the message logged + */ + public AuthenticationLoginException(String userMessage, String logMessage) { + super(userMessage, logMessage); + } + + /** + * Instantiates a new authentication exception. + * + * @param userMessage the message displayed to the user + * @param logMessage the message logged + * @param cause the cause + */ + public AuthenticationLoginException(String userMessage, String logMessage, Throwable cause) { + super(userMessage, logMessage, cause); + } + +} From eaa5d7493f6eb0ffd936730e6f5314de53d09fa0 Mon Sep 17 00:00:00 2001 From: kwwall Date: Mon, 18 Jan 2016 23:33:48 -0500 Subject: [PATCH 113/812] Change CRLF to LF for issue 356. --- .../esapi/errors/AvailabilityException.java | 114 +++++++++--------- 1 file changed, 57 insertions(+), 57 deletions(-) diff --git a/src/main/java/org/owasp/esapi/errors/AvailabilityException.java b/src/main/java/org/owasp/esapi/errors/AvailabilityException.java index 3530cc3a2..3ec04b677 100644 --- a/src/main/java/org/owasp/esapi/errors/AvailabilityException.java +++ b/src/main/java/org/owasp/esapi/errors/AvailabilityException.java @@ -1,57 +1,57 @@ -/** - * OWASP Enterprise Security API (ESAPI) - * - * This file is part of the Open Web Application Security Project (OWASP) - * Enterprise Security API (ESAPI) project. For details, please see - * http://www.owasp.org/index.php/ESAPI. - * - * Copyright (c) 2007 - The OWASP Foundation - * - * The ESAPI is published by OWASP under the BSD license. You should read and accept the - * LICENSE before you use, modify, and/or redistribute this software. - * - * @author Jeff Williams Aspect Security - * @created 2007 - */ -package org.owasp.esapi.errors; - -/** - * An AvailabilityException should be thrown when the availability of a limited - * resource is in jeopardy. For example, if a database connection pool runs out - * of connections, an availability exception should be thrown. - * - * @author Jeff Williams (jeff.williams@aspectsecurity.com) - */ -public class AvailabilityException extends EnterpriseSecurityException { - - /** The Constant serialVersionUID. */ - private static final long serialVersionUID = 1L; - - /** - * Instantiates a new availability exception. - */ - protected AvailabilityException() { - // hidden - } - - /** - * Creates a new instance of AvailabilityException. - * - * @param userMessage the message displayed to the user - * @param logMessage the message logged - */ - public AvailabilityException(String userMessage, String logMessage) { - super(userMessage, logMessage); - } - - /** - * Instantiates a new AvailabilityException. - * - * @param userMessage the message displayed to the user - * @param logMessage the message logged - * @param cause the cause - */ - public AvailabilityException(String userMessage, String logMessage, Throwable cause) { - super(userMessage, logMessage, cause); - } -} +/** + * OWASP Enterprise Security API (ESAPI) + * + * This file is part of the Open Web Application Security Project (OWASP) + * Enterprise Security API (ESAPI) project. For details, please see + * http://www.owasp.org/index.php/ESAPI. + * + * Copyright (c) 2007 - The OWASP Foundation + * + * The ESAPI is published by OWASP under the BSD license. You should read and accept the + * LICENSE before you use, modify, and/or redistribute this software. + * + * @author Jeff Williams Aspect Security + * @created 2007 + */ +package org.owasp.esapi.errors; + +/** + * An AvailabilityException should be thrown when the availability of a limited + * resource is in jeopardy. For example, if a database connection pool runs out + * of connections, an availability exception should be thrown. + * + * @author Jeff Williams (jeff.williams@aspectsecurity.com) + */ +public class AvailabilityException extends EnterpriseSecurityException { + + /** The Constant serialVersionUID. */ + private static final long serialVersionUID = 1L; + + /** + * Instantiates a new availability exception. + */ + protected AvailabilityException() { + // hidden + } + + /** + * Creates a new instance of AvailabilityException. + * + * @param userMessage the message displayed to the user + * @param logMessage the message logged + */ + public AvailabilityException(String userMessage, String logMessage) { + super(userMessage, logMessage); + } + + /** + * Instantiates a new AvailabilityException. + * + * @param userMessage the message displayed to the user + * @param logMessage the message logged + * @param cause the cause + */ + public AvailabilityException(String userMessage, String logMessage, Throwable cause) { + super(userMessage, logMessage, cause); + } +} From 4eccc3c2c999ee98165a89f4672537579a25835a Mon Sep 17 00:00:00 2001 From: kwwall Date: Mon, 18 Jan 2016 23:33:48 -0500 Subject: [PATCH 114/812] Change CRLF to LF for issue 356. --- .../esapi/errors/CertificateException.java | 112 +++++++++--------- 1 file changed, 56 insertions(+), 56 deletions(-) diff --git a/src/main/java/org/owasp/esapi/errors/CertificateException.java b/src/main/java/org/owasp/esapi/errors/CertificateException.java index 957d32aac..2f84b2c01 100644 --- a/src/main/java/org/owasp/esapi/errors/CertificateException.java +++ b/src/main/java/org/owasp/esapi/errors/CertificateException.java @@ -1,56 +1,56 @@ -/** - * OWASP Enterprise Security API (ESAPI) - * - * This file is part of the Open Web Application Security Project (OWASP) - * Enterprise Security API (ESAPI) project. For details, please see - * http://www.owasp.org/index.php/ESAPI. - * - * Copyright (c) 2007 - The OWASP Foundation - * - * The ESAPI is published by OWASP under the BSD license. You should read and accept the - * LICENSE before you use, modify, and/or redistribute this software. - * - * @author Jeff Williams Aspect Security - * @created 2007 - */ -package org.owasp.esapi.errors; - -/** - * A CertificateException should be thrown for any problems that arise during - * processing of digital certificates. - * - * @author Jeff Williams (jeff.williams@aspectsecurity.com) - */ -public class CertificateException extends EnterpriseSecurityException { - - /** The Constant serialVersionUID. */ - private static final long serialVersionUID = 1L; - - /** - * Instantiates a new certificate exception. - */ - protected CertificateException() { - // hidden - } - - /** - * Creates a new instance of CertificateException. - * - * @param userMessage the message displayed to the user - * @param logMessage the message logged - */ - public CertificateException(String userMessage, String logMessage) { - super(userMessage, logMessage); - } - - /** - * Instantiates a new CertificateException. - * - * @param userMessage the message displayed to the user - * @param logMessage the message logged - * @param cause the cause - */ - public CertificateException(String userMessage, String logMessage, Throwable cause) { - super(userMessage, logMessage, cause); - } -} +/** + * OWASP Enterprise Security API (ESAPI) + * + * This file is part of the Open Web Application Security Project (OWASP) + * Enterprise Security API (ESAPI) project. For details, please see + * http://www.owasp.org/index.php/ESAPI. + * + * Copyright (c) 2007 - The OWASP Foundation + * + * The ESAPI is published by OWASP under the BSD license. You should read and accept the + * LICENSE before you use, modify, and/or redistribute this software. + * + * @author Jeff Williams Aspect Security + * @created 2007 + */ +package org.owasp.esapi.errors; + +/** + * A CertificateException should be thrown for any problems that arise during + * processing of digital certificates. + * + * @author Jeff Williams (jeff.williams@aspectsecurity.com) + */ +public class CertificateException extends EnterpriseSecurityException { + + /** The Constant serialVersionUID. */ + private static final long serialVersionUID = 1L; + + /** + * Instantiates a new certificate exception. + */ + protected CertificateException() { + // hidden + } + + /** + * Creates a new instance of CertificateException. + * + * @param userMessage the message displayed to the user + * @param logMessage the message logged + */ + public CertificateException(String userMessage, String logMessage) { + super(userMessage, logMessage); + } + + /** + * Instantiates a new CertificateException. + * + * @param userMessage the message displayed to the user + * @param logMessage the message logged + * @param cause the cause + */ + public CertificateException(String userMessage, String logMessage, Throwable cause) { + super(userMessage, logMessage, cause); + } +} From 3e0fccfb1040715dbcb7d61314b86906892eff04 Mon Sep 17 00:00:00 2001 From: kwwall Date: Mon, 18 Jan 2016 23:33:48 -0500 Subject: [PATCH 115/812] Change CRLF to LF for issue 356. --- .../esapi/errors/ConfigurationException.java | 68 +++++++++---------- 1 file changed, 34 insertions(+), 34 deletions(-) diff --git a/src/main/java/org/owasp/esapi/errors/ConfigurationException.java b/src/main/java/org/owasp/esapi/errors/ConfigurationException.java index f34c25a36..4e6a38130 100644 --- a/src/main/java/org/owasp/esapi/errors/ConfigurationException.java +++ b/src/main/java/org/owasp/esapi/errors/ConfigurationException.java @@ -1,34 +1,34 @@ -package org.owasp.esapi.errors; - -/** - * A {@code ConfigurationException} should be thrown when a problem arises because of - * a problem in one of ESAPI's configuration files, such as a missing required - * property or invalid setting of a property, or missing or unreadable - * configuration file, etc. - *

    - * A {@code ConfigurationException} is a {@code RuntimeException} - * because 1) configuration properties can, for the most part, only be checked - * at run-time, and 2) we want this to be an unchecked exception to make ESAPI - * easy to use and not cluttered with catching a bunch of try/catch blocks. - *

    - */ -public class ConfigurationException extends RuntimeException { - - protected static final long serialVersionUID = 1L; - - public ConfigurationException(Exception e) { - super(e); - } - - public ConfigurationException(String s) { - super(s); - } - - public ConfigurationException(String s, Throwable cause) { - super(s, cause); - } - - public ConfigurationException(Throwable cause) { - super(cause); - } -} +package org.owasp.esapi.errors; + +/** + * A {@code ConfigurationException} should be thrown when a problem arises because of + * a problem in one of ESAPI's configuration files, such as a missing required + * property or invalid setting of a property, or missing or unreadable + * configuration file, etc. + *

    + * A {@code ConfigurationException} is a {@code RuntimeException} + * because 1) configuration properties can, for the most part, only be checked + * at run-time, and 2) we want this to be an unchecked exception to make ESAPI + * easy to use and not cluttered with catching a bunch of try/catch blocks. + *

    + */ +public class ConfigurationException extends RuntimeException { + + protected static final long serialVersionUID = 1L; + + public ConfigurationException(Exception e) { + super(e); + } + + public ConfigurationException(String s) { + super(s); + } + + public ConfigurationException(String s, Throwable cause) { + super(s, cause); + } + + public ConfigurationException(Throwable cause) { + super(cause); + } +} From 43643d7e1255baa403e81ede0c0d2aeadcd00a61 Mon Sep 17 00:00:00 2001 From: kwwall Date: Mon, 18 Jan 2016 23:33:48 -0500 Subject: [PATCH 116/812] Change CRLF to LF for issue 356. --- .../owasp/esapi/errors/EncodingException.java | 124 +++++++++--------- 1 file changed, 62 insertions(+), 62 deletions(-) diff --git a/src/main/java/org/owasp/esapi/errors/EncodingException.java b/src/main/java/org/owasp/esapi/errors/EncodingException.java index 9335004a1..f2b269445 100644 --- a/src/main/java/org/owasp/esapi/errors/EncodingException.java +++ b/src/main/java/org/owasp/esapi/errors/EncodingException.java @@ -1,62 +1,62 @@ -/** - * OWASP Enterprise Security API (ESAPI) - * - * This file is part of the Open Web Application Security Project (OWASP) - * Enterprise Security API (ESAPI) project. For details, please see - * http://www.owasp.org/index.php/ESAPI. - * - * Copyright (c) 2007 - The OWASP Foundation - * - * The ESAPI is published by OWASP under the BSD license. You should read and accept the - * LICENSE before you use, modify, and/or redistribute this software. - * - * @author Jeff Williams Aspect Security - * @created 2007 - */ -package org.owasp.esapi.errors; - -/** - * An EncodingException should be thrown for any problems that occur when - * encoding or decoding data. - * - * @author Jeff Williams (jeff.williams@aspectsecurity.com) - */ -public class EncodingException extends EnterpriseSecurityException { - - /** The Constant serialVersionUID. */ - private static final long serialVersionUID = 1L; - - /** - * Instantiates a new service exception. - */ - protected EncodingException() { - // hidden - } - - /** - * Creates a new instance of EncodingException. - * - * @param userMessage - * the message displayed to the user - * @param logMessage - * the message logged - */ - public EncodingException(String userMessage, String logMessage) { - super(userMessage, logMessage); - } - - /** - * Instantiates a new EncodingException. - * - * @param userMessage - * the message displayed to the user - * @param logMessage - * the message logged - * @param cause - * the cause - */ - public EncodingException(String userMessage, String logMessage, Throwable cause) { - super(userMessage, logMessage, cause); - } - -} +/** + * OWASP Enterprise Security API (ESAPI) + * + * This file is part of the Open Web Application Security Project (OWASP) + * Enterprise Security API (ESAPI) project. For details, please see + * http://www.owasp.org/index.php/ESAPI. + * + * Copyright (c) 2007 - The OWASP Foundation + * + * The ESAPI is published by OWASP under the BSD license. You should read and accept the + * LICENSE before you use, modify, and/or redistribute this software. + * + * @author Jeff Williams Aspect Security + * @created 2007 + */ +package org.owasp.esapi.errors; + +/** + * An EncodingException should be thrown for any problems that occur when + * encoding or decoding data. + * + * @author Jeff Williams (jeff.williams@aspectsecurity.com) + */ +public class EncodingException extends EnterpriseSecurityException { + + /** The Constant serialVersionUID. */ + private static final long serialVersionUID = 1L; + + /** + * Instantiates a new service exception. + */ + protected EncodingException() { + // hidden + } + + /** + * Creates a new instance of EncodingException. + * + * @param userMessage + * the message displayed to the user + * @param logMessage + * the message logged + */ + public EncodingException(String userMessage, String logMessage) { + super(userMessage, logMessage); + } + + /** + * Instantiates a new EncodingException. + * + * @param userMessage + * the message displayed to the user + * @param logMessage + * the message logged + * @param cause + * the cause + */ + public EncodingException(String userMessage, String logMessage, Throwable cause) { + super(userMessage, logMessage, cause); + } + +} From 0b856339cfcf20a3c0b72f99ebfa349ed6b945b1 Mon Sep 17 00:00:00 2001 From: kwwall Date: Mon, 18 Jan 2016 23:33:48 -0500 Subject: [PATCH 117/812] Change CRLF to LF for issue 356. --- .../esapi/errors/EncryptionException.java | 122 +++++++++--------- 1 file changed, 61 insertions(+), 61 deletions(-) diff --git a/src/main/java/org/owasp/esapi/errors/EncryptionException.java b/src/main/java/org/owasp/esapi/errors/EncryptionException.java index 965a52e24..163a1d228 100644 --- a/src/main/java/org/owasp/esapi/errors/EncryptionException.java +++ b/src/main/java/org/owasp/esapi/errors/EncryptionException.java @@ -1,61 +1,61 @@ -/** - * OWASP Enterprise Security API (ESAPI) - * - * This file is part of the Open Web Application Security Project (OWASP) - * Enterprise Security API (ESAPI) project. For details, please see - * http://www.owasp.org/index.php/ESAPI. - * - * Copyright (c) 2007 - The OWASP Foundation - * - * The ESAPI is published by OWASP under the BSD license. You should read and accept the - * LICENSE before you use, modify, and/or redistribute this software. - * - * @author Jeff Williams Aspect Security - * @created 2007 - */ -package org.owasp.esapi.errors; - -/** - * An EncryptionException should be thrown for any problems related to - * encryption, hashing, or digital signatures. - * - * @author Jeff Williams (jeff.williams@aspectsecurity.com) - */ -public class EncryptionException extends EnterpriseSecurityException { - - /** The Constant serialVersionUID. */ - private static final long serialVersionUID = 1L; - - /** - * Instantiates a new EncryptionException. - */ - protected EncryptionException() { - // hidden - } - - /** - * Creates a new instance of EncryptionException. - * - * @param userMessage - * the message displayed to the user - * @param logMessage - * the message logged - */ - public EncryptionException(String userMessage, String logMessage) { - super(userMessage, logMessage); - } - - /** - * Instantiates a new EncryptionException. - * - * @param userMessage - * the message displayed to the user - * @param logMessage - * the message logged - * @param cause - * the cause - */ - public EncryptionException(String userMessage, String logMessage, Throwable cause) { - super(userMessage, logMessage, cause); - } -} +/** + * OWASP Enterprise Security API (ESAPI) + * + * This file is part of the Open Web Application Security Project (OWASP) + * Enterprise Security API (ESAPI) project. For details, please see + * http://www.owasp.org/index.php/ESAPI. + * + * Copyright (c) 2007 - The OWASP Foundation + * + * The ESAPI is published by OWASP under the BSD license. You should read and accept the + * LICENSE before you use, modify, and/or redistribute this software. + * + * @author Jeff Williams Aspect Security + * @created 2007 + */ +package org.owasp.esapi.errors; + +/** + * An EncryptionException should be thrown for any problems related to + * encryption, hashing, or digital signatures. + * + * @author Jeff Williams (jeff.williams@aspectsecurity.com) + */ +public class EncryptionException extends EnterpriseSecurityException { + + /** The Constant serialVersionUID. */ + private static final long serialVersionUID = 1L; + + /** + * Instantiates a new EncryptionException. + */ + protected EncryptionException() { + // hidden + } + + /** + * Creates a new instance of EncryptionException. + * + * @param userMessage + * the message displayed to the user + * @param logMessage + * the message logged + */ + public EncryptionException(String userMessage, String logMessage) { + super(userMessage, logMessage); + } + + /** + * Instantiates a new EncryptionException. + * + * @param userMessage + * the message displayed to the user + * @param logMessage + * the message logged + * @param cause + * the cause + */ + public EncryptionException(String userMessage, String logMessage, Throwable cause) { + super(userMessage, logMessage, cause); + } +} From 778d48f75f5130e03173ad613c47ab673da0c01a Mon Sep 17 00:00:00 2001 From: kwwall Date: Mon, 18 Jan 2016 23:33:48 -0500 Subject: [PATCH 118/812] Change CRLF to LF for issue 356. --- .../errors/EnterpriseSecurityException.java | 300 +++++++++--------- 1 file changed, 150 insertions(+), 150 deletions(-) diff --git a/src/main/java/org/owasp/esapi/errors/EnterpriseSecurityException.java b/src/main/java/org/owasp/esapi/errors/EnterpriseSecurityException.java index 8c6d46114..93ee30191 100644 --- a/src/main/java/org/owasp/esapi/errors/EnterpriseSecurityException.java +++ b/src/main/java/org/owasp/esapi/errors/EnterpriseSecurityException.java @@ -1,150 +1,150 @@ -/** - * OWASP Enterprise Security API (ESAPI) - * - * This file is part of the Open Web Application Security Project (OWASP) - * Enterprise Security API (ESAPI) project. For details, please see - * http://www.owasp.org/index.php/ESAPI. - * - * Copyright (c) 2007 - The OWASP Foundation - * - * The ESAPI is published by OWASP under the BSD license. You should read and accept the - * LICENSE before you use, modify, and/or redistribute this software. - * - * @author Jeff Williams Aspect Security - * @created 2007 - */ -package org.owasp.esapi.errors; - -import org.owasp.esapi.ESAPI; -import org.owasp.esapi.Logger; - - -/** - * EnterpriseSecurityException is the base class for all security related exceptions. You should pass in the root cause - * exception where possible. Constructors for classes extending EnterpriseSecurityException should be sure to call the - * appropriate super() method in order to ensure that logging and intrusion detection occur properly. - *

    - * All EnterpriseSecurityExceptions have two messages, one for the user and one for the log file. This way, a message - * can be shown to the user that doesn't contain sensitive information or unnecessary implementation details. Meanwhile, - * all the critical information can be included in the exception so that it gets logged. - *

    - * Note that the "logMessage" for ALL EnterpriseSecurityExceptions is logged in the log file. This feature should be - * used extensively throughout ESAPI implementations and the result is a fairly complete set of security log records. - * ALL EnterpriseSecurityExceptions are also sent to the IntrusionDetector for use in detecting anomalous patterns of - * application usage. - *

    - * @author Jeff Williams (jeff.williams@aspectsecurity.com) - */ -public class EnterpriseSecurityException extends Exception { - - protected static final long serialVersionUID = 1L; - - /** The logger. */ - protected final transient Logger logger = ESAPI.getLogger("EnterpriseSecurityException"); - - /** - * - */ - protected String logMessage = null; - - /** - * Instantiates a new enterprise security exception. - */ - protected EnterpriseSecurityException() { - // hidden - } - - /** - * Instantiates a new enterprise security exception with a user message. - * (Needed by anything which subclasses this.) - * - * @param userMessage Message displayed to user. - */ - protected EnterpriseSecurityException(String userMessage) { - // hidden - super(userMessage); - } - - /** - * Instantiates a new enterprise security exception with a user message - * and cause. (Needed by anything which subclasses this.) - * - * @param userMessage Message displayed to user. - * @param cause The cause (which is saved for later retrieval by the - * getCause() method). (A null value is permitted, and indicates that the - * cause is nonexistent or unknown.) - */ - protected EnterpriseSecurityException(String userMessage, Throwable cause) - { - // hidden - super(userMessage, cause); - } - - /** - * Creates a new instance of EnterpriseSecurityException. This exception is automatically logged, so that simply by - * using this API, applications will generate an extensive security log. In addition, this exception is - * automatically registered with the IntrusionDetector, so that quotas can be checked. - * - * It should be noted that messages that are intended to be displayed to the user should be safe for display. In - * other words, don't pass in unsanitized data here. Also could hold true for the logging message depending on the - * context of the exception. - * - * @param userMessage - * the message displayed to the user - * @param logMessage - * the message logged - */ - public EnterpriseSecurityException(String userMessage, String logMessage) { - super(userMessage); - this.logMessage = logMessage; - if (!ESAPI.securityConfiguration().getDisableIntrusionDetection()) { - ESAPI.intrusionDetector().addException(this); - } - } - - /** - * Creates a new instance of EnterpriseSecurityException that includes a root cause Throwable. - * - * It should be noted that messages that are intended to be displayed to the user should be safe for display. In - * other words, don't pass in unsanitized data here. Also could hold true for the logging message depending on the - * context of the exception. - * - * @param userMessage - * the message displayed to the user - * @param logMessage - * the message logged - * @param cause the cause - */ - public EnterpriseSecurityException(String userMessage, String logMessage, Throwable cause) { - super(userMessage, cause); - this.logMessage = logMessage; - if (!ESAPI.securityConfiguration().getDisableIntrusionDetection()) { - ESAPI.intrusionDetector().addException(this); - } - } - - /** - * Returns message meant for display to users - * - * Note that if you are unsure of what set this message, it would probably - * be a good idea to encode this message before displaying it to the end user. - * - * @return a String containing a message that is safe to display to users - */ - public String getUserMessage() { - return getMessage(); - } - - /** - * Returns a message that is safe to display in logs, but may contain - * sensitive information and therefore probably should not be displayed to - * users. - * - * @return a String containing a message that is safe to display in logs, - * but probably not to users as it may contain sensitive information. - */ - public String getLogMessage() { - return logMessage; - } - -} +/** + * OWASP Enterprise Security API (ESAPI) + * + * This file is part of the Open Web Application Security Project (OWASP) + * Enterprise Security API (ESAPI) project. For details, please see + * http://www.owasp.org/index.php/ESAPI. + * + * Copyright (c) 2007 - The OWASP Foundation + * + * The ESAPI is published by OWASP under the BSD license. You should read and accept the + * LICENSE before you use, modify, and/or redistribute this software. + * + * @author Jeff Williams Aspect Security + * @created 2007 + */ +package org.owasp.esapi.errors; + +import org.owasp.esapi.ESAPI; +import org.owasp.esapi.Logger; + + +/** + * EnterpriseSecurityException is the base class for all security related exceptions. You should pass in the root cause + * exception where possible. Constructors for classes extending EnterpriseSecurityException should be sure to call the + * appropriate super() method in order to ensure that logging and intrusion detection occur properly. + *

    + * All EnterpriseSecurityExceptions have two messages, one for the user and one for the log file. This way, a message + * can be shown to the user that doesn't contain sensitive information or unnecessary implementation details. Meanwhile, + * all the critical information can be included in the exception so that it gets logged. + *

    + * Note that the "logMessage" for ALL EnterpriseSecurityExceptions is logged in the log file. This feature should be + * used extensively throughout ESAPI implementations and the result is a fairly complete set of security log records. + * ALL EnterpriseSecurityExceptions are also sent to the IntrusionDetector for use in detecting anomalous patterns of + * application usage. + *

    + * @author Jeff Williams (jeff.williams@aspectsecurity.com) + */ +public class EnterpriseSecurityException extends Exception { + + protected static final long serialVersionUID = 1L; + + /** The logger. */ + protected final transient Logger logger = ESAPI.getLogger("EnterpriseSecurityException"); + + /** + * + */ + protected String logMessage = null; + + /** + * Instantiates a new enterprise security exception. + */ + protected EnterpriseSecurityException() { + // hidden + } + + /** + * Instantiates a new enterprise security exception with a user message. + * (Needed by anything which subclasses this.) + * + * @param userMessage Message displayed to user. + */ + protected EnterpriseSecurityException(String userMessage) { + // hidden + super(userMessage); + } + + /** + * Instantiates a new enterprise security exception with a user message + * and cause. (Needed by anything which subclasses this.) + * + * @param userMessage Message displayed to user. + * @param cause The cause (which is saved for later retrieval by the + * getCause() method). (A null value is permitted, and indicates that the + * cause is nonexistent or unknown.) + */ + protected EnterpriseSecurityException(String userMessage, Throwable cause) + { + // hidden + super(userMessage, cause); + } + + /** + * Creates a new instance of EnterpriseSecurityException. This exception is automatically logged, so that simply by + * using this API, applications will generate an extensive security log. In addition, this exception is + * automatically registered with the IntrusionDetector, so that quotas can be checked. + * + * It should be noted that messages that are intended to be displayed to the user should be safe for display. In + * other words, don't pass in unsanitized data here. Also could hold true for the logging message depending on the + * context of the exception. + * + * @param userMessage + * the message displayed to the user + * @param logMessage + * the message logged + */ + public EnterpriseSecurityException(String userMessage, String logMessage) { + super(userMessage); + this.logMessage = logMessage; + if (!ESAPI.securityConfiguration().getDisableIntrusionDetection()) { + ESAPI.intrusionDetector().addException(this); + } + } + + /** + * Creates a new instance of EnterpriseSecurityException that includes a root cause Throwable. + * + * It should be noted that messages that are intended to be displayed to the user should be safe for display. In + * other words, don't pass in unsanitized data here. Also could hold true for the logging message depending on the + * context of the exception. + * + * @param userMessage + * the message displayed to the user + * @param logMessage + * the message logged + * @param cause the cause + */ + public EnterpriseSecurityException(String userMessage, String logMessage, Throwable cause) { + super(userMessage, cause); + this.logMessage = logMessage; + if (!ESAPI.securityConfiguration().getDisableIntrusionDetection()) { + ESAPI.intrusionDetector().addException(this); + } + } + + /** + * Returns message meant for display to users + * + * Note that if you are unsure of what set this message, it would probably + * be a good idea to encode this message before displaying it to the end user. + * + * @return a String containing a message that is safe to display to users + */ + public String getUserMessage() { + return getMessage(); + } + + /** + * Returns a message that is safe to display in logs, but may contain + * sensitive information and therefore probably should not be displayed to + * users. + * + * @return a String containing a message that is safe to display in logs, + * but probably not to users as it may contain sensitive information. + */ + public String getLogMessage() { + return logMessage; + } + +} From 9d864eaf3240701272d166888a889962bdb8620c Mon Sep 17 00:00:00 2001 From: kwwall Date: Mon, 18 Jan 2016 23:33:48 -0500 Subject: [PATCH 119/812] Change CRLF to LF for issue 356. --- .../owasp/esapi/errors/ExecutorException.java | 124 +++++++++--------- 1 file changed, 62 insertions(+), 62 deletions(-) diff --git a/src/main/java/org/owasp/esapi/errors/ExecutorException.java b/src/main/java/org/owasp/esapi/errors/ExecutorException.java index d453129cd..a27c74fa3 100644 --- a/src/main/java/org/owasp/esapi/errors/ExecutorException.java +++ b/src/main/java/org/owasp/esapi/errors/ExecutorException.java @@ -1,62 +1,62 @@ -/** - * OWASP Enterprise Security API (ESAPI) - * - * This file is part of the Open Web Application Security Project (OWASP) - * Enterprise Security API (ESAPI) project. For details, please see - * http://www.owasp.org/index.php/ESAPI. - * - * Copyright (c) 2007 - The OWASP Foundation - * - * The ESAPI is published by OWASP under the BSD license. You should read and accept the - * LICENSE before you use, modify, and/or redistribute this software. - * - * @author Jeff Williams Aspect Security - * @created 2007 - */ -package org.owasp.esapi.errors; - -/** - * An ExecutorException should be thrown for any problems that arise during the - * execution of a system executable. - * - * @author Jeff Williams (jeff.williams@aspectsecurity.com) - */ -public class ExecutorException extends EnterpriseSecurityException { - - /** The Constant serialVersionUID. */ - private static final long serialVersionUID = 1L; - - /** - * Instantiates a new ExecutorException. - */ - protected ExecutorException() { - // hidden - } - - /** - * Creates a new instance of ExecutorException. - * - * @param userMessage - * the message to display to users - * @param logMessage - * the message logged - */ - public ExecutorException(String userMessage, String logMessage) { - super(userMessage, logMessage); - } - - /** - * Instantiates a new ExecutorException. - * - * @param userMessage - * the message to display to users - * @param logMessage - * the message logged - * @param cause - * the cause - */ - public ExecutorException(String userMessage, String logMessage, Throwable cause) { - super(userMessage, logMessage, cause); - } - -} +/** + * OWASP Enterprise Security API (ESAPI) + * + * This file is part of the Open Web Application Security Project (OWASP) + * Enterprise Security API (ESAPI) project. For details, please see + * http://www.owasp.org/index.php/ESAPI. + * + * Copyright (c) 2007 - The OWASP Foundation + * + * The ESAPI is published by OWASP under the BSD license. You should read and accept the + * LICENSE before you use, modify, and/or redistribute this software. + * + * @author Jeff Williams Aspect Security + * @created 2007 + */ +package org.owasp.esapi.errors; + +/** + * An ExecutorException should be thrown for any problems that arise during the + * execution of a system executable. + * + * @author Jeff Williams (jeff.williams@aspectsecurity.com) + */ +public class ExecutorException extends EnterpriseSecurityException { + + /** The Constant serialVersionUID. */ + private static final long serialVersionUID = 1L; + + /** + * Instantiates a new ExecutorException. + */ + protected ExecutorException() { + // hidden + } + + /** + * Creates a new instance of ExecutorException. + * + * @param userMessage + * the message to display to users + * @param logMessage + * the message logged + */ + public ExecutorException(String userMessage, String logMessage) { + super(userMessage, logMessage); + } + + /** + * Instantiates a new ExecutorException. + * + * @param userMessage + * the message to display to users + * @param logMessage + * the message logged + * @param cause + * the cause + */ + public ExecutorException(String userMessage, String logMessage, Throwable cause) { + super(userMessage, logMessage, cause); + } + +} From e3066d0fb2fa08b5abbe6e37023837b59f866324 Mon Sep 17 00:00:00 2001 From: kwwall Date: Mon, 18 Jan 2016 23:33:48 -0500 Subject: [PATCH 120/812] Change CRLF to LF for issue 356. --- .../esapi/errors/IntegrityException.java | 124 +++++++++--------- 1 file changed, 62 insertions(+), 62 deletions(-) diff --git a/src/main/java/org/owasp/esapi/errors/IntegrityException.java b/src/main/java/org/owasp/esapi/errors/IntegrityException.java index 02e37979a..59d97a189 100644 --- a/src/main/java/org/owasp/esapi/errors/IntegrityException.java +++ b/src/main/java/org/owasp/esapi/errors/IntegrityException.java @@ -1,62 +1,62 @@ -/** - * OWASP Enterprise Security API (ESAPI) - * - * This file is part of the Open Web Application Security Project (OWASP) - * Enterprise Security API (ESAPI) project. For details, please see - * http://www.owasp.org/index.php/ESAPI. - * - * Copyright (c) 2007 - The OWASP Foundation - * - * The ESAPI is published by OWASP under the BSD license. You should read and accept the - * LICENSE before you use, modify, and/or redistribute this software. - * - * @author Jeff Williams Aspect Security - * @created 2007 - */ -package org.owasp.esapi.errors; - -/** - * An IntegrityException should be thrown when a problem with the integrity of data - * has been detected. For example, if a financial account cannot be reconciled after - * a transaction has been performed, an integrity exception should be thrown. - * - * @author Jeff Williams (jeff.williams@aspectsecurity.com) - */ -public class IntegrityException extends EnterpriseSecurityException { - - /** The Constant serialVersionUID. */ - private static final long serialVersionUID = 1L; - - /** - * Instantiates a new availability exception. - */ - protected IntegrityException() { - // hidden - } - - /** - * Creates a new instance of IntegrityException. - * - * @param userMessage - * the message to display to users - * @param logMessage - * the message logged - */ - public IntegrityException(String userMessage, String logMessage) { - super(userMessage, logMessage); - } - - /** - * Instantiates a new IntegrityException. - * - * @param userMessage - * the message to display to users - * @param logMessage - * the message logged - * @param cause - * the cause - */ - public IntegrityException(String userMessage, String logMessage, Throwable cause) { - super(userMessage, logMessage, cause); - } -} +/** + * OWASP Enterprise Security API (ESAPI) + * + * This file is part of the Open Web Application Security Project (OWASP) + * Enterprise Security API (ESAPI) project. For details, please see + * http://www.owasp.org/index.php/ESAPI. + * + * Copyright (c) 2007 - The OWASP Foundation + * + * The ESAPI is published by OWASP under the BSD license. You should read and accept the + * LICENSE before you use, modify, and/or redistribute this software. + * + * @author Jeff Williams Aspect Security + * @created 2007 + */ +package org.owasp.esapi.errors; + +/** + * An IntegrityException should be thrown when a problem with the integrity of data + * has been detected. For example, if a financial account cannot be reconciled after + * a transaction has been performed, an integrity exception should be thrown. + * + * @author Jeff Williams (jeff.williams@aspectsecurity.com) + */ +public class IntegrityException extends EnterpriseSecurityException { + + /** The Constant serialVersionUID. */ + private static final long serialVersionUID = 1L; + + /** + * Instantiates a new availability exception. + */ + protected IntegrityException() { + // hidden + } + + /** + * Creates a new instance of IntegrityException. + * + * @param userMessage + * the message to display to users + * @param logMessage + * the message logged + */ + public IntegrityException(String userMessage, String logMessage) { + super(userMessage, logMessage); + } + + /** + * Instantiates a new IntegrityException. + * + * @param userMessage + * the message to display to users + * @param logMessage + * the message logged + * @param cause + * the cause + */ + public IntegrityException(String userMessage, String logMessage, Throwable cause) { + super(userMessage, logMessage, cause); + } +} From a687babed82b92ce30eefe33314d7907d3a0c549 Mon Sep 17 00:00:00 2001 From: kwwall Date: Mon, 18 Jan 2016 23:33:48 -0500 Subject: [PATCH 121/812] Change CRLF to LF for issue 356. --- .../esapi/errors/IntrusionException.java | 184 +++++++++--------- 1 file changed, 92 insertions(+), 92 deletions(-) diff --git a/src/main/java/org/owasp/esapi/errors/IntrusionException.java b/src/main/java/org/owasp/esapi/errors/IntrusionException.java index 718f8a7c3..b5253ea28 100644 --- a/src/main/java/org/owasp/esapi/errors/IntrusionException.java +++ b/src/main/java/org/owasp/esapi/errors/IntrusionException.java @@ -1,92 +1,92 @@ -/** - * OWASP Enterprise Security API (ESAPI) - * - * This file is part of the Open Web Application Security Project (OWASP) - * Enterprise Security API (ESAPI) project. For details, please see - * http://www.owasp.org/index.php/ESAPI. - * - * Copyright (c) 2007 - The OWASP Foundation - * - * The ESAPI is published by OWASP under the BSD license. You should read and accept the - * LICENSE before you use, modify, and/or redistribute this software. - * - * @author Jeff Williams Aspect Security - * @created 2007 - */ -package org.owasp.esapi.errors; - -import org.owasp.esapi.ESAPI; -import org.owasp.esapi.Logger; - -/** - * An IntrusionException should be thrown anytime an error condition arises that is likely to be the result of an attack - * in progress. IntrusionExceptions are handled specially by the IntrusionDetector, which is equipped to respond by - * either specially logging the event, logging out the current user, or invalidating the current user's account. - *

    - * Unlike other exceptions in the ESAPI, the IntrusionException is a RuntimeException so that it can be thrown from - * anywhere and will not require a lot of special exception handling. - * - * @author Jeff Williams (jeff.williams@aspectsecurity.com) - */ -public class IntrusionException extends EnterpriseSecurityRuntimeException { - - /** The Constant serialVersionUID. */ - private static final long serialVersionUID = 1L; - - /** The logger. */ - protected final transient Logger logger = ESAPI.getLogger("IntrusionException"); - - /** - * - */ - protected String logMessage = null; - - /** - * Creates a new instance of IntrusionException. - * - * @param userMessage - * the message to display to users - * @param logMessage - * the message logged - */ - public IntrusionException(String userMessage, String logMessage) { - super(userMessage); - this.logMessage = logMessage; - logger.error(Logger.SECURITY_FAILURE, "INTRUSION - " + logMessage); - } - - /** - * Instantiates a new intrusion exception. - * - * @param userMessage - * the message to display to users - * @param logMessage - * the message logged - * @param cause - * the cause - */ - public IntrusionException(String userMessage, String logMessage, Throwable cause) { - super(userMessage, cause); - this.logMessage = logMessage; - logger.error(Logger.SECURITY_FAILURE, "INTRUSION - " + logMessage, cause); - } - - /** - * Returns a String containing a message that is safe to display to users - * - * @return a String containing a message that is safe to display to users - */ - public String getUserMessage() { - return getMessage(); - } - - /** - * Returns a String that is safe to display in logs, but probably not to users - * - * @return a String containing a message that is safe to display in logs, but probably not to users - */ - public String getLogMessage() { - return logMessage; - } - -} +/** + * OWASP Enterprise Security API (ESAPI) + * + * This file is part of the Open Web Application Security Project (OWASP) + * Enterprise Security API (ESAPI) project. For details, please see + * http://www.owasp.org/index.php/ESAPI. + * + * Copyright (c) 2007 - The OWASP Foundation + * + * The ESAPI is published by OWASP under the BSD license. You should read and accept the + * LICENSE before you use, modify, and/or redistribute this software. + * + * @author Jeff Williams Aspect Security + * @created 2007 + */ +package org.owasp.esapi.errors; + +import org.owasp.esapi.ESAPI; +import org.owasp.esapi.Logger; + +/** + * An IntrusionException should be thrown anytime an error condition arises that is likely to be the result of an attack + * in progress. IntrusionExceptions are handled specially by the IntrusionDetector, which is equipped to respond by + * either specially logging the event, logging out the current user, or invalidating the current user's account. + *

    + * Unlike other exceptions in the ESAPI, the IntrusionException is a RuntimeException so that it can be thrown from + * anywhere and will not require a lot of special exception handling. + * + * @author Jeff Williams (jeff.williams@aspectsecurity.com) + */ +public class IntrusionException extends EnterpriseSecurityRuntimeException { + + /** The Constant serialVersionUID. */ + private static final long serialVersionUID = 1L; + + /** The logger. */ + protected final transient Logger logger = ESAPI.getLogger("IntrusionException"); + + /** + * + */ + protected String logMessage = null; + + /** + * Creates a new instance of IntrusionException. + * + * @param userMessage + * the message to display to users + * @param logMessage + * the message logged + */ + public IntrusionException(String userMessage, String logMessage) { + super(userMessage); + this.logMessage = logMessage; + logger.error(Logger.SECURITY_FAILURE, "INTRUSION - " + logMessage); + } + + /** + * Instantiates a new intrusion exception. + * + * @param userMessage + * the message to display to users + * @param logMessage + * the message logged + * @param cause + * the cause + */ + public IntrusionException(String userMessage, String logMessage, Throwable cause) { + super(userMessage, cause); + this.logMessage = logMessage; + logger.error(Logger.SECURITY_FAILURE, "INTRUSION - " + logMessage, cause); + } + + /** + * Returns a String containing a message that is safe to display to users + * + * @return a String containing a message that is safe to display to users + */ + public String getUserMessage() { + return getMessage(); + } + + /** + * Returns a String that is safe to display in logs, but probably not to users + * + * @return a String containing a message that is safe to display in logs, but probably not to users + */ + public String getLogMessage() { + return logMessage; + } + +} From dd7e5732ee6ba7fafe349284509f5f2c8612e829 Mon Sep 17 00:00:00 2001 From: kwwall Date: Mon, 18 Jan 2016 23:33:48 -0500 Subject: [PATCH 122/812] Change CRLF to LF for issue 356. --- .../ValidationAvailabilityException.java | 114 +++++++++--------- 1 file changed, 57 insertions(+), 57 deletions(-) diff --git a/src/main/java/org/owasp/esapi/errors/ValidationAvailabilityException.java b/src/main/java/org/owasp/esapi/errors/ValidationAvailabilityException.java index d749e4f04..4e4a1d48b 100644 --- a/src/main/java/org/owasp/esapi/errors/ValidationAvailabilityException.java +++ b/src/main/java/org/owasp/esapi/errors/ValidationAvailabilityException.java @@ -1,57 +1,57 @@ -/** - * OWASP Enterprise Security API (ESAPI) - * - * This file is part of the Open Web Application Security Project (OWASP) - * Enterprise Security API (ESAPI) project. For details, please see - * http://www.owasp.org/index.php/ESAPI. - * - * Copyright (c) 2007 - The OWASP Foundation - * - * The ESAPI is published by OWASP under the BSD license. You should read and accept the - * LICENSE before you use, modify, and/or redistribute this software. - * - * @author Jeff Williams Aspect Security - * @created 2007 - */ -package org.owasp.esapi.errors; - -/** - * @author Jeff Williams (jeff.williams@aspectsecurity.com) - */ -public class ValidationAvailabilityException extends ValidationException { - - /** The Constant serialVersionUID. */ - private static final long serialVersionUID = 1L; - - /** - * Instantiates a new validation exception. - */ - protected ValidationAvailabilityException() { - // hidden - } - - /** - * Create a new ValidationException - * @param userMessage - * the message to display to users - * @param logMessage - * the message logged - */ - public ValidationAvailabilityException(String userMessage, String logMessage) { - super(userMessage, logMessage); - } - - /** - * Create a new ValidationException - * @param userMessage - * the message to display to users - * @param logMessage - * the message logged - * @param cause - * the cause - */ - public ValidationAvailabilityException(String userMessage, String logMessage, Throwable cause) { - super(userMessage, logMessage, cause); - } - -} +/** + * OWASP Enterprise Security API (ESAPI) + * + * This file is part of the Open Web Application Security Project (OWASP) + * Enterprise Security API (ESAPI) project. For details, please see + * http://www.owasp.org/index.php/ESAPI. + * + * Copyright (c) 2007 - The OWASP Foundation + * + * The ESAPI is published by OWASP under the BSD license. You should read and accept the + * LICENSE before you use, modify, and/or redistribute this software. + * + * @author Jeff Williams Aspect Security + * @created 2007 + */ +package org.owasp.esapi.errors; + +/** + * @author Jeff Williams (jeff.williams@aspectsecurity.com) + */ +public class ValidationAvailabilityException extends ValidationException { + + /** The Constant serialVersionUID. */ + private static final long serialVersionUID = 1L; + + /** + * Instantiates a new validation exception. + */ + protected ValidationAvailabilityException() { + // hidden + } + + /** + * Create a new ValidationException + * @param userMessage + * the message to display to users + * @param logMessage + * the message logged + */ + public ValidationAvailabilityException(String userMessage, String logMessage) { + super(userMessage, logMessage); + } + + /** + * Create a new ValidationException + * @param userMessage + * the message to display to users + * @param logMessage + * the message logged + * @param cause + * the cause + */ + public ValidationAvailabilityException(String userMessage, String logMessage, Throwable cause) { + super(userMessage, logMessage, cause); + } + +} From 0041a07432ec4d1133be6e6bdf2671944d50f19a Mon Sep 17 00:00:00 2001 From: kwwall Date: Mon, 18 Jan 2016 23:33:48 -0500 Subject: [PATCH 123/812] Change CRLF to LF for issue 356. --- .../esapi/errors/ValidationException.java | 230 +++++++++--------- 1 file changed, 115 insertions(+), 115 deletions(-) diff --git a/src/main/java/org/owasp/esapi/errors/ValidationException.java b/src/main/java/org/owasp/esapi/errors/ValidationException.java index b6ebcb9c3..a33562f96 100644 --- a/src/main/java/org/owasp/esapi/errors/ValidationException.java +++ b/src/main/java/org/owasp/esapi/errors/ValidationException.java @@ -1,115 +1,115 @@ -/** - * OWASP Enterprise Security API (ESAPI) - * - * This file is part of the Open Web Application Security Project (OWASP) - * Enterprise Security API (ESAPI) project. For details, please see - * http://www.owasp.org/index.php/ESAPI. - * - * Copyright (c) 2007 - The OWASP Foundation - * - * The ESAPI is published by OWASP under the BSD license. You should read and accept the - * LICENSE before you use, modify, and/or redistribute this software. - * - * @author Jeff Williams Aspect Security - * @created 2007 - */ -package org.owasp.esapi.errors; - -/** - * A ValidationException should be thrown to indicate that the data provided by - * the user or from some other external source does not match the validation - * rules that have been specified for that data. - * - * @author Jeff Williams (jeff.williams@aspectsecurity.com) - */ -public class ValidationException extends EnterpriseSecurityException { - - protected static final long serialVersionUID = 1L; - - /** The UI reference that caused this ValidationException */ - private String context; - - /** - * Instantiates a new validation exception. - */ - protected ValidationException() { - // hidden - } - - /** - * Creates a new instance of ValidationException. - * - * @param userMessage - * the message to display to users - * @param logMessage - * the message logged - */ - public ValidationException(String userMessage, String logMessage) { - super(userMessage, logMessage); - } - - /** - * Instantiates a new ValidationException. - * - * @param userMessage - * the message to display to users - * @param logMessage - * the message logged - * @param cause - * the cause - */ - public ValidationException(String userMessage, String logMessage, Throwable cause) { - super(userMessage, logMessage, cause); - } - - /** - * Creates a new instance of ValidationException. - * - * @param userMessage - * the message to display to users - * @param logMessage - * the message logged - * @param context - * the source that caused this exception - */ - public ValidationException(String userMessage, String logMessage, String context) { - super(userMessage, logMessage); - setContext(context); - } - - /** - * Instantiates a new ValidationException. - * - * @param userMessage - * the message to display to users - * @param logMessage - * the message logged - * @param cause - * the cause - * @param context - * the source that caused this exception - */ - public ValidationException(String userMessage, String logMessage, Throwable cause, String context) { - super(userMessage, logMessage, cause); - setContext(context); - } - - /** - * Returns the UI reference that caused this ValidationException - * - * @return context, the source that caused the exception, stored as a string - */ - public String getContext() { - return context; - } - - /** - * Set's the UI reference that caused this ValidationException - * - * @param context - * the context to set, passed as a String - */ - public void setContext(String context) { - this.context = context; - } -} +/** + * OWASP Enterprise Security API (ESAPI) + * + * This file is part of the Open Web Application Security Project (OWASP) + * Enterprise Security API (ESAPI) project. For details, please see + * http://www.owasp.org/index.php/ESAPI. + * + * Copyright (c) 2007 - The OWASP Foundation + * + * The ESAPI is published by OWASP under the BSD license. You should read and accept the + * LICENSE before you use, modify, and/or redistribute this software. + * + * @author Jeff Williams Aspect Security + * @created 2007 + */ +package org.owasp.esapi.errors; + +/** + * A ValidationException should be thrown to indicate that the data provided by + * the user or from some other external source does not match the validation + * rules that have been specified for that data. + * + * @author Jeff Williams (jeff.williams@aspectsecurity.com) + */ +public class ValidationException extends EnterpriseSecurityException { + + protected static final long serialVersionUID = 1L; + + /** The UI reference that caused this ValidationException */ + private String context; + + /** + * Instantiates a new validation exception. + */ + protected ValidationException() { + // hidden + } + + /** + * Creates a new instance of ValidationException. + * + * @param userMessage + * the message to display to users + * @param logMessage + * the message logged + */ + public ValidationException(String userMessage, String logMessage) { + super(userMessage, logMessage); + } + + /** + * Instantiates a new ValidationException. + * + * @param userMessage + * the message to display to users + * @param logMessage + * the message logged + * @param cause + * the cause + */ + public ValidationException(String userMessage, String logMessage, Throwable cause) { + super(userMessage, logMessage, cause); + } + + /** + * Creates a new instance of ValidationException. + * + * @param userMessage + * the message to display to users + * @param logMessage + * the message logged + * @param context + * the source that caused this exception + */ + public ValidationException(String userMessage, String logMessage, String context) { + super(userMessage, logMessage); + setContext(context); + } + + /** + * Instantiates a new ValidationException. + * + * @param userMessage + * the message to display to users + * @param logMessage + * the message logged + * @param cause + * the cause + * @param context + * the source that caused this exception + */ + public ValidationException(String userMessage, String logMessage, Throwable cause, String context) { + super(userMessage, logMessage, cause); + setContext(context); + } + + /** + * Returns the UI reference that caused this ValidationException + * + * @return context, the source that caused the exception, stored as a string + */ + public String getContext() { + return context; + } + + /** + * Set's the UI reference that caused this ValidationException + * + * @param context + * the context to set, passed as a String + */ + public void setContext(String context) { + this.context = context; + } +} From 855eefcf40ec294bfb0b086449ce8c6a34365faf Mon Sep 17 00:00:00 2001 From: kwwall Date: Mon, 18 Jan 2016 23:33:48 -0500 Subject: [PATCH 124/812] Change CRLF to LF for issue 356. --- .../errors/ValidationUploadException.java | 118 +++++++++--------- 1 file changed, 59 insertions(+), 59 deletions(-) diff --git a/src/main/java/org/owasp/esapi/errors/ValidationUploadException.java b/src/main/java/org/owasp/esapi/errors/ValidationUploadException.java index 0541e42cf..4a04de2eb 100644 --- a/src/main/java/org/owasp/esapi/errors/ValidationUploadException.java +++ b/src/main/java/org/owasp/esapi/errors/ValidationUploadException.java @@ -1,59 +1,59 @@ -/** - * OWASP Enterprise Security API (ESAPI) - * - * This file is part of the Open Web Application Security Project (OWASP) - * Enterprise Security API (ESAPI) project. For details, please see - * http://www.owasp.org/index.php/ESAPI. - * - * Copyright (c) 2007 - The OWASP Foundation - * - * The ESAPI is published by OWASP under the BSD license. You should read and accept the - * LICENSE before you use, modify, and/or redistribute this software. - * - * @author Jeff Williams Aspect Security - * @created 2007 - */ -package org.owasp.esapi.errors; - -/** - * @author Jeff Williams (jeff.williams@aspectsecurity.com) - */ -public class ValidationUploadException extends ValidationException { - - /** The Constant serialVersionUID. */ - private static final long serialVersionUID = 1L; - - /** - * Instantiates a new validation exception. - */ - protected ValidationUploadException() { - // hidden - } - - /** - * Create a new ValidationException - * - * @param userMessage - * the message to display to users - * @param logMessage - * the message logged - */ - public ValidationUploadException(String userMessage, String logMessage) { - super(userMessage, logMessage); - } - - /** - * Create a new ValidationException - * - * @param userMessage - * the message to display to users - * @param logMessage - * the message logged - * @param cause - * the cause - */ - public ValidationUploadException(String userMessage, String logMessage, Throwable cause) { - super(userMessage, logMessage, cause); - } - -} +/** + * OWASP Enterprise Security API (ESAPI) + * + * This file is part of the Open Web Application Security Project (OWASP) + * Enterprise Security API (ESAPI) project. For details, please see + * http://www.owasp.org/index.php/ESAPI. + * + * Copyright (c) 2007 - The OWASP Foundation + * + * The ESAPI is published by OWASP under the BSD license. You should read and accept the + * LICENSE before you use, modify, and/or redistribute this software. + * + * @author Jeff Williams Aspect Security + * @created 2007 + */ +package org.owasp.esapi.errors; + +/** + * @author Jeff Williams (jeff.williams@aspectsecurity.com) + */ +public class ValidationUploadException extends ValidationException { + + /** The Constant serialVersionUID. */ + private static final long serialVersionUID = 1L; + + /** + * Instantiates a new validation exception. + */ + protected ValidationUploadException() { + // hidden + } + + /** + * Create a new ValidationException + * + * @param userMessage + * the message to display to users + * @param logMessage + * the message logged + */ + public ValidationUploadException(String userMessage, String logMessage) { + super(userMessage, logMessage); + } + + /** + * Create a new ValidationException + * + * @param userMessage + * the message to display to users + * @param logMessage + * the message logged + * @param cause + * the cause + */ + public ValidationUploadException(String userMessage, String logMessage, Throwable cause) { + super(userMessage, logMessage, cause); + } + +} From fc745071b3c034e9993e49a75147b5d344677d8d Mon Sep 17 00:00:00 2001 From: kwwall Date: Mon, 18 Jan 2016 23:33:48 -0500 Subject: [PATCH 125/812] Change CRLF to LF for issue 356. --- src/main/java/org/owasp/esapi/Executor.java | 156 ++++++++++---------- 1 file changed, 78 insertions(+), 78 deletions(-) diff --git a/src/main/java/org/owasp/esapi/Executor.java b/src/main/java/org/owasp/esapi/Executor.java index 6286741ed..b475da90d 100644 --- a/src/main/java/org/owasp/esapi/Executor.java +++ b/src/main/java/org/owasp/esapi/Executor.java @@ -1,78 +1,78 @@ -/** - * OWASP Enterprise Security API (ESAPI) - * - * This file is part of the Open Web Application Security Project (OWASP) - * Enterprise Security API (ESAPI) project. For details, please see - * http://www.owasp.org/index.php/ESAPI. - * - * Copyright (c) 2007 - The OWASP Foundation - * - * The ESAPI is published by OWASP under the BSD license. You should read and accept the - * LICENSE before you use, modify, and/or redistribute this software. - * - * @author Jeff Williams Aspect Security - * @created 2007 - */ -package org.owasp.esapi; - -import java.io.File; -import java.util.List; - -import org.owasp.esapi.codecs.Codec; -import org.owasp.esapi.errors.ExecutorException; - -/** - * The Executor interface is used to run an OS command with reduced security risk. - * - *

    Implementations should do as much as possible to minimize the risk of - * injection into either the command or parameters. In addition, implementations - * should timeout after a specified time period in order to help prevent denial - * of service attacks.

    - * - *

    The class should perform logging and error handling as - * well. Finally, implementation should handle errors and generate an - * ExecutorException with all the necessary information.

    - * - *

    The reference implementation does all of the above.

    - * - * @author Jeff Williams (jeff.williams .at. aspectsecurity.com) Aspect Security - * @since June 1, 2007 - */ -public interface Executor { - - /** - * Invokes the specified executable with default workdir and codec and not logging parameters. - * - * @param executable - * the command to execute - * @param params - * the parameters of the command being executed - */ - ExecuteResult executeSystemCommand(File executable, List params) throws ExecutorException; - - /** - * Executes a system command after checking that the executable exists and - * escaping all the parameters to ensure that injection is impossible. - * Implementations must change to the specified working - * directory before invoking the command. - * - * @param executable - * the command to execute - * @param params - * the parameters of the command being executed - * @param workdir - * the working directory - * @param codec - * the codec to use to encode for the particular OS in use - * @param logParams - * use false if any parameters contains sensitive or confidential information - * - * @return the output of the command being run - * - * @throws ExecutorException - * the service exception - */ - ExecuteResult executeSystemCommand(File executable, List params, File workdir, Codec codec, boolean logParams, boolean redirectErrorStream) throws ExecutorException; - -} +/** + * OWASP Enterprise Security API (ESAPI) + * + * This file is part of the Open Web Application Security Project (OWASP) + * Enterprise Security API (ESAPI) project. For details, please see + * http://www.owasp.org/index.php/ESAPI. + * + * Copyright (c) 2007 - The OWASP Foundation + * + * The ESAPI is published by OWASP under the BSD license. You should read and accept the + * LICENSE before you use, modify, and/or redistribute this software. + * + * @author Jeff Williams Aspect Security + * @created 2007 + */ +package org.owasp.esapi; + +import java.io.File; +import java.util.List; + +import org.owasp.esapi.codecs.Codec; +import org.owasp.esapi.errors.ExecutorException; + +/** + * The Executor interface is used to run an OS command with reduced security risk. + * + *

    Implementations should do as much as possible to minimize the risk of + * injection into either the command or parameters. In addition, implementations + * should timeout after a specified time period in order to help prevent denial + * of service attacks.

    + * + *

    The class should perform logging and error handling as + * well. Finally, implementation should handle errors and generate an + * ExecutorException with all the necessary information.

    + * + *

    The reference implementation does all of the above.

    + * + * @author Jeff Williams (jeff.williams .at. aspectsecurity.com) Aspect Security + * @since June 1, 2007 + */ +public interface Executor { + + /** + * Invokes the specified executable with default workdir and codec and not logging parameters. + * + * @param executable + * the command to execute + * @param params + * the parameters of the command being executed + */ + ExecuteResult executeSystemCommand(File executable, List params) throws ExecutorException; + + /** + * Executes a system command after checking that the executable exists and + * escaping all the parameters to ensure that injection is impossible. + * Implementations must change to the specified working + * directory before invoking the command. + * + * @param executable + * the command to execute + * @param params + * the parameters of the command being executed + * @param workdir + * the working directory + * @param codec + * the codec to use to encode for the particular OS in use + * @param logParams + * use false if any parameters contains sensitive or confidential information + * + * @return the output of the command being run + * + * @throws ExecutorException + * the service exception + */ + ExecuteResult executeSystemCommand(File executable, List params, File workdir, Codec codec, boolean logParams, boolean redirectErrorStream) throws ExecutorException; + +} From a5c5d3c56373254da11b9e64cca60f0aaf268129 Mon Sep 17 00:00:00 2001 From: kwwall Date: Mon, 18 Jan 2016 23:33:48 -0500 Subject: [PATCH 126/812] Change CRLF to LF for issue 356. --- .../owasp/esapi/filters/ClickjackFilter.java | 216 +++++++++--------- 1 file changed, 108 insertions(+), 108 deletions(-) diff --git a/src/main/java/org/owasp/esapi/filters/ClickjackFilter.java b/src/main/java/org/owasp/esapi/filters/ClickjackFilter.java index 86025b1dd..8f1038691 100644 --- a/src/main/java/org/owasp/esapi/filters/ClickjackFilter.java +++ b/src/main/java/org/owasp/esapi/filters/ClickjackFilter.java @@ -1,108 +1,108 @@ -/** - * OWASP Enterprise Security API (ESAPI) - * - * This file is part of the Open Web Application Security Project (OWASP) - * Enterprise Security API (ESAPI) project. For details, please see - * http://www.owasp.org/index.php/ESAPI. - * - * Copyright (c) 2007 - The OWASP Foundation - * - * The ESAPI is published by OWASP under the BSD license. You should read and accept the - * LICENSE before you use, modify, and/or redistribute this software. - * - * @author Jeff Williams Aspect Security - * @created February 6, 2009 - */ - -package org.owasp.esapi.filters; -import java.io.IOException; - -import javax.servlet.Filter; -import javax.servlet.FilterChain; -import javax.servlet.FilterConfig; -import javax.servlet.ServletException; -import javax.servlet.ServletRequest; -import javax.servlet.ServletResponse; -import javax.servlet.http.HttpServletResponse; - -/** - * The {@code ClickjackFilter} is discussed at - * {@link http://www.owasp.org/index.php/ClickjackFilter_for_Java_EE}. - * 
    - *     
- *            ClickjackFilterDeny
- *            org.owasp.filters.ClickjackFilter
- *            
- *                mode
- *                 DENY
- *             
- *         
- *         
- *         
- *             ClickjackFilterSameOrigin
- *             org.owasp.filters.ClickjackFilter
- *             
- *                 mode
- *                 SAMEORIGIN
- *             
- *         
- *        
- *        
- *         
- *            ClickjackFilterDeny
- *            /*
- *        
- *         
- *         
+ *         
+ *            ClickjackFilterDeny
+ *            /*
+ *        
+ *         
+ *         
-	
-
-
-
-	
-	
-		
-		
-		
-		
-	
-	
-	
-	
-		
-		
-		
-		 
-		
-		
-	
-	
-	
-	
-
-	
-
-	
-		
-
-		
-		 	
-		 		
-		 	
-		 
-		 
-		 
-		 	
-		 		
-		 	
-		 
-
-		
-			
-				
-				
-			
-		
-	
-		
-			
-				
-				
-				
-				
-				
-			
-		
-
-	
-
-
-	
-	
-	
-		
-		
-	
-
-
-	
-
-		
-
-		
-		
-		
-		
-		
-		
-		
-		
-		
-		
-
-		
-		
-		
-			
-		
-
-				
-		
-		
-		
-		
-		
-		
-		
-
-		
-		
-		
-		 
-		
-						
-		
-		
-		
-
-			
-			
-				
-					
-					
-				
-			
-			
-				
-					
-				
-			
-		
-
-		
-
-		
-		
-		
-		
-	
-
-
-
-	
-
-	
-	
-
-
-	
-		
-		
-		
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		                                  
-		 
-		
-		
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		
-		
-		 
-		
-		 
-		 
-		 
-		 
-		 
-		
-		
-		 
-		 
-		 
-		 
-		 
-		
-		
-		
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		
-		
-		    
-		 
-		 
-		
-		
-		     
-		 
-		 
-		
-		
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-	
-		
-		 
-		
-		
-		     
-		 
-		
-		
-		
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		
-		
-		     
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		
-		 
-		
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		
-		
-		
-		 
-		 
-		 
-		 
-		 
-		
-		 
-		
-		
-		
-		 
-		
-		
-		 
-		
-		 
-		 
-		 
-		
-		 
-		
-		 
-		 
-		
-		 
-		 
-		 
-		
-		
-		 
-		 
-		
-		
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		
-		 
-		
-		 
-	
-
-
+
+	
+
+	
+
+
+
+	
+	
+		
+		
+		
+		
+	
+	
+	
+	
+		
+		
+		
+		 
+		
+		
+	
+	
+	
+	
+
+	
+
+	
+		
+
+		
+		 	
+		 		
+		 	
+		 
+		 
+		 
+		 	
+		 		
+		 	
+		 
+
+		
+			
+				
+				
+			
+		
+	
+		
+			
+				
+				
+				
+				
+				
+			
+		
+
+	
+
+
+	
+	
+	
+		
+		
+	
+
+
+	
+
+		
+
+		
+		
+		
+		
+		
+		
+		
+		
+		
+		
+
+		
+		
+		
+			
+		
+
+				
+		
+		
+		
+		
+		
+		
+		
+
+		
+		
+		
+		 
+		
+						
+		
+		
+		
+
+			
+			
+				
+					
+					
+				
+			
+			
+				
+					
+				
+			
+		
+
+		
+
+		
+		
+		
+		
+	
+
+
+
+	
+
+	
+	
+
+
+	
+		
+		
+		
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		                                  
+		 
+		
+		
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		
+		
+		 
+		
+		 
+		 
+		 
+		 
+		 
+		
+		
+		 
+		 
+		 
+		 
+		 
+		
+		
+		
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		
+		
+		    
+		 
+		 
+		
+		
+		     
+		 
+		 
+		
+		
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+	
+		
+		 
+		
+		
+		     
+		 
+		
+		
+		
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		
+		
+		     
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		
+		 
+		
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		
+		
+		
+		 
+		 
+		 
+		 
+		 
+		
+		 
+		
+		
+		
+		 
+		
+		
+		 
+		
+		 
+		 
+		 
+		
+		 
+		
+		 
+		 
+		
+		 
+		 
+		 
+		
+		
+		 
+		 
+		
+		
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		
+		 
+		
+		 
+	
+
+

From 4db1a33cff1c017a1627b710977a7bf2d6089140 Mon Sep 17 00:00:00 2001
From: kwwall 
Date: Mon, 18 Jan 2016 23:34:45 -0500
Subject: [PATCH 273/812] Change CRLF to LF for issue 356.

---
 .../esapi/ESAPI-AccessControlPolicy.xml       | 254 +++++++++---------
 1 file changed, 127 insertions(+), 127 deletions(-)

diff --git a/configuration/esapi/ESAPI-AccessControlPolicy.xml b/configuration/esapi/ESAPI-AccessControlPolicy.xml
index 2ed0732bc..4d2ca74b5 100644
--- a/configuration/esapi/ESAPI-AccessControlPolicy.xml
+++ b/configuration/esapi/ESAPI-AccessControlPolicy.xml
@@ -1,127 +1,127 @@
-
-
-
-	
-		
-		
-		
-		
-		
-		
-		
-			
-				
-			
-		
-		
-		
-		
-			
-				 
-				
-				
-			
-		
-		
-			
-				
-				
-				
-			
-		
-		
-			
-				
-				
-				
-			
-		
-		
-			
-				
-				
-				
-			
-		
-		
-			
-				
-				
-				
-			
-		
-		
-		
-	
-
-
-
-
-
-
-
+
+
+
+	
+		
+		
+		
+		
+		
+		
+		
+			
+				
+			
+		
+		
+		
+		
+			
+				 
+				
+				
+			
+		
+		
+			
+				
+				
+				
+			
+		
+		
+			
+				
+				
+				
+			
+		
+		
+			
+				
+				
+				
+			
+		
+		
+			
+				
+				
+				
+			
+		
+		
+		
+	
+
+
+
+
+
+
+

From 19ce3948cf19020046a4186353a5b32a37fbf66d Mon Sep 17 00:00:00 2001
From: kwwall 
Date: Mon, 18 Jan 2016 23:34:45 -0500
Subject: [PATCH 274/812] Change CRLF to LF for issue 356.

---
 .../esapi/waf-policies/add-header-policy.xml  | 56 +++++++++----------
 1 file changed, 28 insertions(+), 28 deletions(-)

diff --git a/configuration/esapi/waf-policies/add-header-policy.xml b/configuration/esapi/waf-policies/add-header-policy.xml
index b2d8efc49..0a48ed2d0 100644
--- a/configuration/esapi/waf-policies/add-header-policy.xml
+++ b/configuration/esapi/waf-policies/add-header-policy.xml
@@ -1,29 +1,29 @@
-
-
-	
-
-
-
-	
-		redirect
-		
-			/security/error.jsp
-			403
-		
-	
-	
-	
-		
-			/marketing/.*
-		
-	
-	
+
+
+	
+
+
+
+	
+		redirect
+		
+			/security/error.jsp
+			403
+		
+	
+	
+	
+		
+			/marketing/.*
+		
+	
+	
 
\ No newline at end of file

From 43540728991f54e01843af3668e6c524b81e95d5 Mon Sep 17 00:00:00 2001
From: kwwall 
Date: Mon, 18 Jan 2016 23:34:45 -0500
Subject: [PATCH 275/812] Change CRLF to LF for issue 356.

---
 .../waf-policies/add-httponly-policy.xml      | 52 +++++++++----------
 1 file changed, 26 insertions(+), 26 deletions(-)

diff --git a/configuration/esapi/waf-policies/add-httponly-policy.xml b/configuration/esapi/waf-policies/add-httponly-policy.xml
index 1232f5997..4420e6ce0 100644
--- a/configuration/esapi/waf-policies/add-httponly-policy.xml
+++ b/configuration/esapi/waf-policies/add-httponly-policy.xml
@@ -1,27 +1,27 @@
-
-
-	
-
-
-
-	
-		redirect
-		
-			/security/error.jsp
-			403
-		
-	
-
-	
-		
-			
-		
-	
-	
+
+
+	
+
+
+
+	
+		redirect
+		
+			/security/error.jsp
+			403
+		
+	
+
+	
+		
+			
+		
+	
+	
 
\ No newline at end of file

From bff90d3ce384e826e69eea661a98a82caad7172d Mon Sep 17 00:00:00 2001
From: kwwall 
Date: Mon, 18 Jan 2016 23:34:45 -0500
Subject: [PATCH 276/812] Change CRLF to LF for issue 356.

---
 .../esapi/waf-policies/add-secure-policy.xml  | 52 +++++++++----------
 1 file changed, 26 insertions(+), 26 deletions(-)

diff --git a/configuration/esapi/waf-policies/add-secure-policy.xml b/configuration/esapi/waf-policies/add-secure-policy.xml
index 12298a45a..80067da42 100644
--- a/configuration/esapi/waf-policies/add-secure-policy.xml
+++ b/configuration/esapi/waf-policies/add-secure-policy.xml
@@ -1,27 +1,27 @@
-
-
-	
-
-
-
-	
-		redirect
-		
-			/security/error.jsp
-			403
-		
-	
-	
-	
-		
-			
-		
-	
-	
+
+
+	
+
+
+
+	
+		redirect
+		
+			/security/error.jsp
+			403
+		
+	
+	
+	
+		
+			
+		
+	
+	
 
\ No newline at end of file

From cf2e253532b2dad8f084d3620e01aaf3bd4914c9 Mon Sep 17 00:00:00 2001
From: kwwall 
Date: Mon, 18 Jan 2016 23:34:45 -0500
Subject: [PATCH 277/812] Change CRLF to LF for issue 356.

---
 .../waf-policies/authentication-policy.xml    | 58 +++++++++----------
 1 file changed, 29 insertions(+), 29 deletions(-)

diff --git a/configuration/esapi/waf-policies/authentication-policy.xml b/configuration/esapi/waf-policies/authentication-policy.xml
index 1c1a485be..5a77e6c0b 100644
--- a/configuration/esapi/waf-policies/authentication-policy.xml
+++ b/configuration/esapi/waf-policies/authentication-policy.xml
@@ -1,30 +1,30 @@
-
-
-	
-
-
-
-	
-		redirect
-		
-			/security/error.jsp
-			403
-		
-	>
-
-	
-	
-		/index.html
-		/images/.*
-	
-
+
+
+	
+
+
+
+	
+		redirect
+		
+			/security/error.jsp
+			403
+		
+	>
+
+	
+	
+		/index.html
+		/images/.*
+	
+
 
\ No newline at end of file

From ec6c70e6e3a6dc16dc326584a29ee751e834a499 Mon Sep 17 00:00:00 2001
From: kwwall 
Date: Mon, 18 Jan 2016 23:34:45 -0500
Subject: [PATCH 278/812] Change CRLF to LF for issue 356.

---
 .../esapi/waf-policies/bean-shell-policy.xml  | 58 +++++++++----------
 1 file changed, 29 insertions(+), 29 deletions(-)

diff --git a/configuration/esapi/waf-policies/bean-shell-policy.xml b/configuration/esapi/waf-policies/bean-shell-policy.xml
index 2e3f7bb93..76711c82d 100644
--- a/configuration/esapi/waf-policies/bean-shell-policy.xml
+++ b/configuration/esapi/waf-policies/bean-shell-policy.xml
@@ -1,30 +1,30 @@
-
-
-	
-
-
-
-	
-		redirect
-		
-			/security/error.jsp
-			403
-		
-	
-
-	
-		
-		
-	
-
+
+
+	
+
+
+
+	
+		redirect
+		
+			/security/error.jsp
+			403
+		
+	
+
+	
+		
+		
+	
+
 
\ No newline at end of file

From a849b75e7717eaeca252db52da4247e84125e308 Mon Sep 17 00:00:00 2001
From: kwwall 
Date: Mon, 18 Jan 2016 23:34:45 -0500
Subject: [PATCH 279/812] Change CRLF to LF for issue 356.

---
 .../waf-policies/detect-outbound-policy.xml   | 52 +++++++++----------
 1 file changed, 26 insertions(+), 26 deletions(-)

diff --git a/configuration/esapi/waf-policies/detect-outbound-policy.xml b/configuration/esapi/waf-policies/detect-outbound-policy.xml
index 8312be95d..ac756aefa 100644
--- a/configuration/esapi/waf-policies/detect-outbound-policy.xml
+++ b/configuration/esapi/waf-policies/detect-outbound-policy.xml
@@ -1,27 +1,27 @@
-
-
-	
-
-
-
-	
-		redirect
-		
-			/security/error.jsp
-			403
-		
-	
-
-	
-		
-	
-	
+
+
+	
+
+
+
+	
+		redirect
+		
+			/security/error.jsp
+			403
+		
+	
+
+	
+		
+	
+	
 
\ No newline at end of file

From 7994d0e654ebe80915b5395475fd5ab1ecb2f199 Mon Sep 17 00:00:00 2001
From: kwwall 
Date: Mon, 18 Jan 2016 23:34:46 -0500
Subject: [PATCH 280/812] Change CRLF to LF for issue 356.

---
 .../waf-policies/dynamic-insertion-policy.xml | 52 +++++++++----------
 1 file changed, 26 insertions(+), 26 deletions(-)

diff --git a/configuration/esapi/waf-policies/dynamic-insertion-policy.xml b/configuration/esapi/waf-policies/dynamic-insertion-policy.xml
index 9c1aa4097..5b0926c2b 100644
--- a/configuration/esapi/waf-policies/dynamic-insertion-policy.xml
+++ b/configuration/esapi/waf-policies/dynamic-insertion-policy.xml
@@ -1,27 +1,27 @@
-
-
-	
-
-
-
-	
-		redirect
-		
-			/security/error.jsp
-			403
-		
-	
-
-	
-		
-			
-		
-	
-	
+
+
+	
+
+
+
+	
+		redirect
+		
+			/security/error.jsp
+			403
+		
+	
+
+	
+		
+			
+		
+	
+	
 
\ No newline at end of file

From 1fcdc4894aa22ef175928fa3fb80548d1242a380 Mon Sep 17 00:00:00 2001
From: kwwall 
Date: Mon, 18 Jan 2016 23:34:46 -0500
Subject: [PATCH 281/812] Change CRLF to LF for issue 356.

---
 .../waf-policies/enforce-https-policy.xml     | 54 +++++++++----------
 1 file changed, 27 insertions(+), 27 deletions(-)

diff --git a/configuration/esapi/waf-policies/enforce-https-policy.xml b/configuration/esapi/waf-policies/enforce-https-policy.xml
index ab123b7e6..beb88513a 100644
--- a/configuration/esapi/waf-policies/enforce-https-policy.xml
+++ b/configuration/esapi/waf-policies/enforce-https-policy.xml
@@ -1,28 +1,28 @@
-
-
-	
-
-
-
-	
-		redirect
-		
-			/security/error.jsp
-			403
-		
-	
-
-	
-		
-			/index.html
-			/images/.*
-		
-	
-
+
+
+	
+
+
+
+	
+		redirect
+		
+			/security/error.jsp
+			403
+		
+	
+
+	
+		
+			/index.html
+			/images/.*
+		
+	
+
 
\ No newline at end of file

From f46fde8aa7ff9921897f365e373126170b1446de Mon Sep 17 00:00:00 2001
From: kwwall 
Date: Mon, 18 Jan 2016 23:34:46 -0500
Subject: [PATCH 282/812] Change CRLF to LF for issue 356.

---
 .../esapi/waf-policies/must-match-policy.xml  | 68 +++++++++----------
 1 file changed, 34 insertions(+), 34 deletions(-)

diff --git a/configuration/esapi/waf-policies/must-match-policy.xml b/configuration/esapi/waf-policies/must-match-policy.xml
index 721fa4cfa..af26fc4cd 100644
--- a/configuration/esapi/waf-policies/must-match-policy.xml
+++ b/configuration/esapi/waf-policies/must-match-policy.xml
@@ -1,35 +1,35 @@
-
-
-	
-
-
-
-	
-		redirect
-		
-			/security/error.jsp
-			403
-		
-	
-
-	
-		
-		
-	
-
+
+
+	
+
+
+
+	
+		redirect
+		
+			/security/error.jsp
+			403
+		
+	
+
+	
+		
+		
+	
+
 
\ No newline at end of file

From 7a177267b4d67522df100e615009528f3c2f9a63 Mon Sep 17 00:00:00 2001
From: kwwall 
Date: Mon, 18 Jan 2016 23:34:46 -0500
Subject: [PATCH 283/812] Change CRLF to LF for issue 356.

---
 .../waf-policies/replace-outbound-policy.xml  | 52 +++++++++----------
 1 file changed, 26 insertions(+), 26 deletions(-)

diff --git a/configuration/esapi/waf-policies/replace-outbound-policy.xml b/configuration/esapi/waf-policies/replace-outbound-policy.xml
index 9c1aa4097..5b0926c2b 100644
--- a/configuration/esapi/waf-policies/replace-outbound-policy.xml
+++ b/configuration/esapi/waf-policies/replace-outbound-policy.xml
@@ -1,27 +1,27 @@
-
-
-	
-
-
-
-	
-		redirect
-		
-			/security/error.jsp
-			403
-		
-	
-
-	
-		
-			
-		
-	
-	
+
+
+	
+
+
+
+	
+		redirect
+		
+			/security/error.jsp
+			403
+		
+	
+
+	
+		
+			
+		
+	
+	
 
\ No newline at end of file

From e20146fc9bb685ec06e2a655b4c378a00af9c53e Mon Sep 17 00:00:00 2001
From: kwwall 
Date: Mon, 18 Jan 2016 23:34:46 -0500
Subject: [PATCH 284/812] Change CRLF to LF for issue 356.

---
 .../restrict-content-type-policy.xml          | 52 +++++++++----------
 1 file changed, 26 insertions(+), 26 deletions(-)

diff --git a/configuration/esapi/waf-policies/restrict-content-type-policy.xml b/configuration/esapi/waf-policies/restrict-content-type-policy.xml
index a9b8a4a38..b766f19d3 100644
--- a/configuration/esapi/waf-policies/restrict-content-type-policy.xml
+++ b/configuration/esapi/waf-policies/restrict-content-type-policy.xml
@@ -1,27 +1,27 @@
-
-
-	
-
-
-
-	
-		redirect
-		
-			/security/error.jsp
-			403
-		
-	
-
-	
-		
-			/fileupload.jsp
-		
-
-	
-
+
+
+	
+
+
+
+	
+		redirect
+		
+			/security/error.jsp
+			403
+		
+	
+
+	
+		
+			/fileupload.jsp
+		
+
+	
+
 
\ No newline at end of file

From bd94f010f471095e4357e6e020d5844c88d93126 Mon Sep 17 00:00:00 2001
From: kwwall 
Date: Mon, 18 Jan 2016 23:34:46 -0500
Subject: [PATCH 285/812] Change CRLF to LF for issue 356.

---
 .../restrict-extension-policy.xml             | 48 +++++++++----------
 1 file changed, 24 insertions(+), 24 deletions(-)

diff --git a/configuration/esapi/waf-policies/restrict-extension-policy.xml b/configuration/esapi/waf-policies/restrict-extension-policy.xml
index fe1dbe193..a572bd4ea 100644
--- a/configuration/esapi/waf-policies/restrict-extension-policy.xml
+++ b/configuration/esapi/waf-policies/restrict-extension-policy.xml
@@ -1,25 +1,25 @@
-
-
-	
-
-
-
-	
-		redirect
-		
-			/security/error.jsp
-			403
-		
-	
-
-	
-		
-		
-	
-
+
+
+	
+
+
+
+	
+		redirect
+		
+			/security/error.jsp
+			403
+		
+	
+
+	
+		
+		
+	
+
 
\ No newline at end of file

From 30703f6d73e1a488a43d34b197e1b4b02995d2d8 Mon Sep 17 00:00:00 2001
From: kwwall 
Date: Mon, 18 Jan 2016 23:34:46 -0500
Subject: [PATCH 286/812] Change CRLF to LF for issue 356.

---
 .../waf-policies/restrict-method-policy.xml   | 48 +++++++++----------
 1 file changed, 24 insertions(+), 24 deletions(-)

diff --git a/configuration/esapi/waf-policies/restrict-method-policy.xml b/configuration/esapi/waf-policies/restrict-method-policy.xml
index 5a2337cf7..c1eb5a36e 100644
--- a/configuration/esapi/waf-policies/restrict-method-policy.xml
+++ b/configuration/esapi/waf-policies/restrict-method-policy.xml
@@ -1,25 +1,25 @@
-
-
-	
-
-
-
-	
-		redirect
-		
-			/security/error.jsp
-			403
-		
-	
-
-	
-		
-		
-	
-
+
+
+	
+
+
+
+	
+		redirect
+		
+			/security/error.jsp
+			403
+		
+	
+
+	
+		
+		
+	
+
 
\ No newline at end of file

From b80eee75e4ec46a0794dfdc5c6dc9fc71b4305d0 Mon Sep 17 00:00:00 2001
From: kwwall 
Date: Mon, 18 Jan 2016 23:34:46 -0500
Subject: [PATCH 287/812] Change CRLF to LF for issue 356.

---
 .../restrict-source-ip-policy.xml             | 52 +++++++++----------
 1 file changed, 26 insertions(+), 26 deletions(-)

diff --git a/configuration/esapi/waf-policies/restrict-source-ip-policy.xml b/configuration/esapi/waf-policies/restrict-source-ip-policy.xml
index d23d87a02..72860a7d3 100644
--- a/configuration/esapi/waf-policies/restrict-source-ip-policy.xml
+++ b/configuration/esapi/waf-policies/restrict-source-ip-policy.xml
@@ -1,27 +1,27 @@
-
-
-	
-
-
-
-	
-		redirect
-		
-			/security/error.jsp
-			403
-		
-	
-
-	
-		/admin/.*
-
-	
-
+
+
+	
+
+
+
+	
+		redirect
+		
+			/security/error.jsp
+			403
+		
+	
+
+	
+		/admin/.*
+
+	
+
 
\ No newline at end of file

From e6704dc1e8d247b97e00fb4272f3f998c72b72e2 Mon Sep 17 00:00:00 2001
From: kwwall 
Date: Mon, 18 Jan 2016 23:34:46 -0500
Subject: [PATCH 288/812] Change CRLF to LF for issue 356.

---
 .../restrict-user-agent-policy.xml            | 50 +++++++++----------
 1 file changed, 25 insertions(+), 25 deletions(-)

diff --git a/configuration/esapi/waf-policies/restrict-user-agent-policy.xml b/configuration/esapi/waf-policies/restrict-user-agent-policy.xml
index 7cdebd595..c550a2c61 100644
--- a/configuration/esapi/waf-policies/restrict-user-agent-policy.xml
+++ b/configuration/esapi/waf-policies/restrict-user-agent-policy.xml
@@ -1,26 +1,26 @@
-
-
-	
-
-
-
-	
-		redirect
-		
-			/security/error.jsp
-			403
-		
-	
-
-	
-		
-			/index.html
-		
-	
-
+
+
+	
+
+
+
+	
+		redirect
+		
+			/security/error.jsp
+			403
+		
+	
+
+	
+		
+			/index.html
+		
+	
+
 
\ No newline at end of file

From 158a6bbcfa98bac6a1d08fc76c2c2e6ec26dc193 Mon Sep 17 00:00:00 2001
From: kwwall 
Date: Mon, 18 Jan 2016 23:34:46 -0500
Subject: [PATCH 289/812] Change CRLF to LF for issue 356.

---
 .../waf-policies/virtual-patch-policy.xml     | 52 +++++++++----------
 1 file changed, 26 insertions(+), 26 deletions(-)

diff --git a/configuration/esapi/waf-policies/virtual-patch-policy.xml b/configuration/esapi/waf-policies/virtual-patch-policy.xml
index 61c93fa88..8b989dd6e 100644
--- a/configuration/esapi/waf-policies/virtual-patch-policy.xml
+++ b/configuration/esapi/waf-policies/virtual-patch-policy.xml
@@ -1,27 +1,27 @@
-
-
-	
-
-
-
-	
-		redirect
-		
-			/security/error.jsp
-			403
-		
-	
-
-	
-		
-	
-
+
+
+	
+
+
+
+	
+		redirect
+		
+			/security/error.jsp
+			403
+		
+	
+
+	
+		
+	
+
 
\ No newline at end of file

From c9d3cdb68b4b34bb02b53291b04aa42f23122c30 Mon Sep 17 00:00:00 2001
From: kwwall 
Date: Mon, 18 Jan 2016 23:34:46 -0500
Subject: [PATCH 290/812] Change CRLF to LF for issue 356.

---
 configuration/log4j.xml | 94 ++++++++++++++++++++---------------------
 1 file changed, 47 insertions(+), 47 deletions(-)

diff --git a/configuration/log4j.xml b/configuration/log4j.xml
index 6f895d580..758514e80 100644
--- a/configuration/log4j.xml
+++ b/configuration/log4j.xml
@@ -1,47 +1,47 @@
-
-
-
-
-   
-     
-     
-       
-     
-   
-
-  
-    
-  
-
-  
-    
-  
-
-  
-    
- 
-
-  
-    
-  
-
-  
-    
-  
-
-  
-    
-  
-
-  
-    
-  
-
-   
-     
-     
-  
-
-  
-  
-
+
+
+
+
+   
+     
+     
+       
+     
+   
+
+  
+    
+  
+
+  
+    
+  
+
+  
+    
+ 
+
+  
+    
+  
+
+  
+    
+  
+
+  
+    
+  
+
+  
+    
+  
+
+   
+     
+     
+  
+
+  
+  
+

From b7334c4327223c77746a7fbbcac2429df78315d3 Mon Sep 17 00:00:00 2001
From: kwwall 
Date: Mon, 18 Jan 2016 23:34:46 -0500
Subject: [PATCH 291/812] Change CRLF to LF for issue 356.

---
 javadoc.xml | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/javadoc.xml b/javadoc.xml
index daa7ba95f..791f62ae7 100644
--- a/javadoc.xml
+++ b/javadoc.xml
@@ -1,6 +1,6 @@
-
-
-    
-        
-    
-
+
+
+    
+        
+    
+

From ead51f90e60e4612a2e35d380fe9f55359b9a5b9 Mon Sep 17 00:00:00 2001
From: kwwall 
Date: Mon, 18 Jan 2016 23:34:46 -0500
Subject: [PATCH 292/812] Change CRLF to LF for issue 356.

---
 .../org.eclipse.wst.common.project.facet.core.xml      | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/.settings/org.eclipse.wst.common.project.facet.core.xml b/.settings/org.eclipse.wst.common.project.facet.core.xml
index 613f29cbf..9bbcbd78e 100644
--- a/.settings/org.eclipse.wst.common.project.facet.core.xml
+++ b/.settings/org.eclipse.wst.common.project.facet.core.xml
@@ -1,6 +1,6 @@
-
-  
-  
-  
-  
+
+  
+  
+  
+  
 
\ No newline at end of file

From af87670af171d0352350065aa621fbc0a7f906fd Mon Sep 17 00:00:00 2001
From: kwwall 
Date: Mon, 18 Jan 2016 23:34:46 -0500
Subject: [PATCH 293/812] Change CRLF to LF for issue 356.

---
 src/test/resources/esapi/antisamy-esapi.xml | 984 ++++++++++----------
 1 file changed, 492 insertions(+), 492 deletions(-)

diff --git a/src/test/resources/esapi/antisamy-esapi.xml b/src/test/resources/esapi/antisamy-esapi.xml
index 500ab5943..14880d0b5 100644
--- a/src/test/resources/esapi/antisamy-esapi.xml
+++ b/src/test/resources/esapi/antisamy-esapi.xml
@@ -1,492 +1,492 @@
-
-	
-
-	
-
-
-
-	
-	
-		
-		
-		
-		
-	
-	
-	
-	
-		
-		
-		
-		 
-		
-		
-	
-	
-	
-	
-
-	
-
-	
-		
-
-		
-		 	
-		 		
-		 	
-		 
-		 
-		 
-		 	
-		 		
-		 	
-		 
-
-		
-			
-				
-				
-			
-		
-	
-		
-			
-				
-				
-				
-				
-				
-			
-		
-
-	
-
-
-	
-	
-	
-		
-		
-	
-
-
-	
-
-		
-
-		
-		
-		
-		
-		
-		
-		
-		
-		
-		
-
-		
-		
-		
-			
-		
-
-				
-		
-		
-		
-		
-		
-		
-		
-
-		
-		
-		
-		 
-		
-						
-		
-		
-		
-
-			
-			
-				
-					
-					
-				
-			
-			
-				
-					
-				
-			
-		
-
-		
-
-		
-		
-		
-		
-	
-
-
-
-	
-
-	
-	
-
-
-	
-		
-		
-		
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		                                  
-		 
-		
-		
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		
-		
-		 
-		
-		 
-		 
-		 
-		 
-		 
-		
-		
-		 
-		 
-		 
-		 
-		 
-		
-		
-		
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		
-		
-		    
-		 
-		 
-		
-		
-		     
-		 
-		 
-		
-		
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-	
-		
-		 
-		
-		
-		     
-		 
-		
-		
-		
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		
-		
-		     
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		
-		 
-		
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		
-		
-		
-		 
-		 
-		 
-		 
-		 
-		
-		 
-		
-		
-		
-		 
-		
-		
-		 
-		
-		 
-		 
-		 
-		
-		 
-		
-		 
-		 
-		
-		 
-		 
-		 
-		
-		
-		 
-		 
-		
-		
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		 
-		
-		 
-		
-		 
-	
-
-
+
+	
+
+	
+
+
+
+	
+	
+		
+		
+		
+		
+	
+	
+	
+	
+		
+		
+		
+		 
+		
+		
+	
+	
+	
+	
+
+	
+
+	
+		
+
+		
+		 	
+		 		
+		 	
+		 
+		 
+		 
+		 	
+		 		
+		 	
+		 
+
+		
+			
+				
+				
+			
+		
+	
+		
+			
+				
+				
+				
+				
+				
+			
+		
+
+	
+
+
+	
+	
+	
+		
+		
+	
+
+
+	
+
+		
+
+		
+		
+		
+		
+		
+		
+		
+		
+		
+		
+
+		
+		
+		
+			
+		
+
+				
+		
+		
+		
+		
+		
+		
+		
+
+		
+		
+		
+		 
+		
+						
+		
+		
+		
+
+			
+			
+				
+					
+					
+				
+			
+			
+				
+					
+				
+			
+		
+
+		
+
+		
+		
+		
+		
+	
+
+
+
+	
+
+	
+	
+
+
+	
+		
+		
+		
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		                                  
+		 
+		
+		
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		
+		
+		 
+		
+		 
+		 
+		 
+		 
+		 
+		
+		
+		 
+		 
+		 
+		 
+		 
+		
+		
+		
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		
+		
+		    
+		 
+		 
+		
+		
+		     
+		 
+		 
+		
+		
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+	
+		
+		 
+		
+		
+		     
+		 
+		
+		
+		
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		
+		
+		     
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		
+		 
+		
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		
+		
+		
+		 
+		 
+		 
+		 
+		 
+		
+		 
+		
+		
+		
+		 
+		
+		
+		 
+		
+		 
+		 
+		 
+		
+		 
+		
+		 
+		 
+		
+		 
+		 
+		 
+		
+		
+		 
+		 
+		
+		
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		 
+		
+		 
+		
+		 
+	
+
+

From 41f2c2a18229e6a146e705fdb322aed47b4c9933 Mon Sep 17 00:00:00 2001
From: kwwall 
Date: Mon, 18 Jan 2016 23:34:46 -0500
Subject: [PATCH 294/812] Change CRLF to LF for issue 356.

---
 .../esapi/ESAPI-AccessControlPolicy.xml       | 254 +++++++++---------
 1 file changed, 127 insertions(+), 127 deletions(-)

diff --git a/src/test/resources/esapi/ESAPI-AccessControlPolicy.xml b/src/test/resources/esapi/ESAPI-AccessControlPolicy.xml
index 2ed0732bc..4d2ca74b5 100644
--- a/src/test/resources/esapi/ESAPI-AccessControlPolicy.xml
+++ b/src/test/resources/esapi/ESAPI-AccessControlPolicy.xml
@@ -1,127 +1,127 @@
-
-
-
-	
-		
-		
-		
-		
-		
-		
-		
-			
-				
-			
-		
-		
-		
-		
-			
-				 
-				
-				
-			
-		
-		
-			
-				
-				
-				
-			
-		
-		
-			
-				
-				
-				
-			
-		
-		
-			
-				
-				
-				
-			
-		
-		
-			
-				
-				
-				
-			
-		
-		
-		
-	
-
-
-
-
-
-
-
+
+
+
+	
+		
+		
+		
+		
+		
+		
+		
+			
+				
+			
+		
+		
+		
+		
+			
+				 
+				
+				
+			
+		
+		
+			
+				
+				
+				
+			
+		
+		
+			
+				
+				
+				
+			
+		
+		
+			
+				
+				
+				
+			
+		
+		
+			
+				
+				
+				
+			
+		
+		
+		
+	
+
+
+
+
+
+
+

From 41e96c6189d60f565fec213d4700a577ac65de00 Mon Sep 17 00:00:00 2001
From: kwwall 
Date: Mon, 18 Jan 2016 23:34:46 -0500
Subject: [PATCH 295/812] Change CRLF to LF for issue 356.

---
 .../esapi/waf-policies/add-header-policy.xml  | 56 +++++++++----------
 1 file changed, 28 insertions(+), 28 deletions(-)

diff --git a/src/test/resources/esapi/waf-policies/add-header-policy.xml b/src/test/resources/esapi/waf-policies/add-header-policy.xml
index b2d8efc49..0a48ed2d0 100644
--- a/src/test/resources/esapi/waf-policies/add-header-policy.xml
+++ b/src/test/resources/esapi/waf-policies/add-header-policy.xml
@@ -1,29 +1,29 @@
-
-
-	
-
-
-
-	
-		redirect
-		
-			/security/error.jsp
-			403
-		
-	
-	
-	
-		
-			/marketing/.*
-		
-	
-	
+
+
+	
+
+
+
+	
+		redirect
+		
+			/security/error.jsp
+			403
+		
+	
+	
+	
+		
+			/marketing/.*
+		
+	
+	
 
\ No newline at end of file

From 96d91bbe98af8611c695cc9615dd4a19587ea169 Mon Sep 17 00:00:00 2001
From: kwwall 
Date: Mon, 18 Jan 2016 23:34:46 -0500
Subject: [PATCH 296/812] Change CRLF to LF for issue 356.

---
 .../waf-policies/add-httponly-policy.xml      | 52 +++++++++----------
 1 file changed, 26 insertions(+), 26 deletions(-)

diff --git a/src/test/resources/esapi/waf-policies/add-httponly-policy.xml b/src/test/resources/esapi/waf-policies/add-httponly-policy.xml
index 1232f5997..4420e6ce0 100644
--- a/src/test/resources/esapi/waf-policies/add-httponly-policy.xml
+++ b/src/test/resources/esapi/waf-policies/add-httponly-policy.xml
@@ -1,27 +1,27 @@
-
-
-	
-
-
-
-	
-		redirect
-		
-			/security/error.jsp
-			403
-		
-	
-
-	
-		
-			
-		
-	
-	
+
+
+	
+
+
+
+	
+		redirect
+		
+			/security/error.jsp
+			403
+		
+	
+
+	
+		
+			
+		
+	
+	
 
\ No newline at end of file

From 6979a3c7b8ff112dbef1f5559197361e251a79d5 Mon Sep 17 00:00:00 2001
From: kwwall 
Date: Mon, 18 Jan 2016 23:34:46 -0500
Subject: [PATCH 297/812] Change CRLF to LF for issue 356.

---
 .../esapi/waf-policies/add-secure-policy.xml  | 52 +++++++++----------
 1 file changed, 26 insertions(+), 26 deletions(-)

diff --git a/src/test/resources/esapi/waf-policies/add-secure-policy.xml b/src/test/resources/esapi/waf-policies/add-secure-policy.xml
index 12298a45a..80067da42 100644
--- a/src/test/resources/esapi/waf-policies/add-secure-policy.xml
+++ b/src/test/resources/esapi/waf-policies/add-secure-policy.xml
@@ -1,27 +1,27 @@
-
-
-	
-
-
-
-	
-		redirect
-		
-			/security/error.jsp
-			403
-		
-	
-	
-	
-		
-			
-		
-	
-	
+
+
+	
+
+
+
+	
+		redirect
+		
+			/security/error.jsp
+			403
+		
+	
+	
+	
+		
+			
+		
+	
+	
 
\ No newline at end of file

From 73d5af5d969c471a369e91d7ff0916ddbdcf4d2f Mon Sep 17 00:00:00 2001
From: kwwall 
Date: Mon, 18 Jan 2016 23:34:46 -0500
Subject: [PATCH 298/812] Change CRLF to LF for issue 356.

---
 .../waf-policies/authentication-policy.xml    | 58 +++++++++----------
 1 file changed, 29 insertions(+), 29 deletions(-)

diff --git a/src/test/resources/esapi/waf-policies/authentication-policy.xml b/src/test/resources/esapi/waf-policies/authentication-policy.xml
index 1c1a485be..5a77e6c0b 100644
--- a/src/test/resources/esapi/waf-policies/authentication-policy.xml
+++ b/src/test/resources/esapi/waf-policies/authentication-policy.xml
@@ -1,30 +1,30 @@
-
-
-	
-
-
-
-	
-		redirect
-		
-			/security/error.jsp
-			403
-		
-	>
-
-	
-	
-		/index.html
-		/images/.*
-	
-
+
+
+	
+
+
+
+	
+		redirect
+		
+			/security/error.jsp
+			403
+		
+	>
+
+	
+	
+		/index.html
+		/images/.*
+	
+
 
\ No newline at end of file

From 53ee54a5cd23846007580bfe2972e5cd99af7351 Mon Sep 17 00:00:00 2001
From: kwwall 
Date: Mon, 18 Jan 2016 23:34:46 -0500
Subject: [PATCH 299/812] Change CRLF to LF for issue 356.

---
 .../esapi/waf-policies/bean-shell-policy.xml  | 58 +++++++++----------
 1 file changed, 29 insertions(+), 29 deletions(-)

diff --git a/src/test/resources/esapi/waf-policies/bean-shell-policy.xml b/src/test/resources/esapi/waf-policies/bean-shell-policy.xml
index 5d2f9275f..948d151c0 100644
--- a/src/test/resources/esapi/waf-policies/bean-shell-policy.xml
+++ b/src/test/resources/esapi/waf-policies/bean-shell-policy.xml
@@ -1,30 +1,30 @@
-
-
-	
-
-
-
-	
-		redirect
-		
-			/security/error.jsp
-			403
-		
-	
-
-	
-		
-		
-	
-
+
+
+	
+
+
+
+	
+		redirect
+		
+			/security/error.jsp
+			403
+		
+	
+
+	
+		
+		
+	
+
 
\ No newline at end of file

From 3ac816c7b36cb5b5f789ab48f16ebb65254c93fd Mon Sep 17 00:00:00 2001
From: kwwall 
Date: Mon, 18 Jan 2016 23:34:46 -0500
Subject: [PATCH 300/812] Change CRLF to LF for issue 356.

---
 .../waf-policies/detect-outbound-policy.xml   | 52 +++++++++----------
 1 file changed, 26 insertions(+), 26 deletions(-)

diff --git a/src/test/resources/esapi/waf-policies/detect-outbound-policy.xml b/src/test/resources/esapi/waf-policies/detect-outbound-policy.xml
index 8312be95d..ac756aefa 100644
--- a/src/test/resources/esapi/waf-policies/detect-outbound-policy.xml
+++ b/src/test/resources/esapi/waf-policies/detect-outbound-policy.xml
@@ -1,27 +1,27 @@
-
-
-	
-
-
-
-	
-		redirect
-		
-			/security/error.jsp
-			403
-		
-	
-
-	
-		
-	
-	
+
+
+	
+
+
+
+	
+		redirect
+		
+			/security/error.jsp
+			403
+		
+	
+
+	
+		
+	
+	
 
\ No newline at end of file

From 7eb39e3846c2c547dc58008c7adaf719eb622309 Mon Sep 17 00:00:00 2001
From: kwwall 
Date: Mon, 18 Jan 2016 23:34:46 -0500
Subject: [PATCH 301/812] Change CRLF to LF for issue 356.

---
 .../waf-policies/dynamic-insertion-policy.xml | 52 +++++++++----------
 1 file changed, 26 insertions(+), 26 deletions(-)

diff --git a/src/test/resources/esapi/waf-policies/dynamic-insertion-policy.xml b/src/test/resources/esapi/waf-policies/dynamic-insertion-policy.xml
index 9c1aa4097..5b0926c2b 100644
--- a/src/test/resources/esapi/waf-policies/dynamic-insertion-policy.xml
+++ b/src/test/resources/esapi/waf-policies/dynamic-insertion-policy.xml
@@ -1,27 +1,27 @@
-
-
-	
-
-
-
-	
-		redirect
-		
-			/security/error.jsp
-			403
-		
-	
-
-	
-		
-			
-		
-	
-	
+
+
+	
+
+
+
+	
+		redirect
+		
+			/security/error.jsp
+			403
+		
+	
+
+	
+		
+			
+		
+	
+	
 
\ No newline at end of file

From b265e8e449a7da2edc9218b9b54ecd9240a67ebe Mon Sep 17 00:00:00 2001
From: kwwall 
Date: Mon, 18 Jan 2016 23:34:46 -0500
Subject: [PATCH 302/812] Change CRLF to LF for issue 356.

---
 .../waf-policies/enforce-https-policy.xml     | 54 +++++++++----------
 1 file changed, 27 insertions(+), 27 deletions(-)

diff --git a/src/test/resources/esapi/waf-policies/enforce-https-policy.xml b/src/test/resources/esapi/waf-policies/enforce-https-policy.xml
index ab123b7e6..beb88513a 100644
--- a/src/test/resources/esapi/waf-policies/enforce-https-policy.xml
+++ b/src/test/resources/esapi/waf-policies/enforce-https-policy.xml
@@ -1,28 +1,28 @@
-
-
-	
-
-
-
-	
-		redirect
-		
-			/security/error.jsp
-			403
-		
-	
-
-	
-		
-			/index.html
-			/images/.*
-		
-	
-
+
+
+	
+
+
+
+	
+		redirect
+		
+			/security/error.jsp
+			403
+		
+	
+
+	
+		
+			/index.html
+			/images/.*
+		
+	
+
 
\ No newline at end of file

From cae9ce34e32df0115e23c6b57ac6f8cb644a977c Mon Sep 17 00:00:00 2001
From: kwwall 
Date: Mon, 18 Jan 2016 23:34:46 -0500
Subject: [PATCH 303/812] Change CRLF to LF for issue 356.

---
 .../esapi/waf-policies/must-match-policy.xml  | 68 +++++++++----------
 1 file changed, 34 insertions(+), 34 deletions(-)

diff --git a/src/test/resources/esapi/waf-policies/must-match-policy.xml b/src/test/resources/esapi/waf-policies/must-match-policy.xml
index 721fa4cfa..af26fc4cd 100644
--- a/src/test/resources/esapi/waf-policies/must-match-policy.xml
+++ b/src/test/resources/esapi/waf-policies/must-match-policy.xml
@@ -1,35 +1,35 @@
-
-
-	
-
-
-
-	
-		redirect
-		
-			/security/error.jsp
-			403
-		
-	
-
-	
-		
-		
-	
-
+
+
+	
+
+
+
+	
+		redirect
+		
+			/security/error.jsp
+			403
+		
+	
+
+	
+		
+		
+	
+
 
\ No newline at end of file

From 7f4022d27f07645eaecc7f495163b525d3f45665 Mon Sep 17 00:00:00 2001
From: kwwall 
Date: Mon, 18 Jan 2016 23:34:46 -0500
Subject: [PATCH 304/812] Change CRLF to LF for issue 356.

---
 .../waf-policies/replace-outbound-policy.xml  | 52 +++++++++----------
 1 file changed, 26 insertions(+), 26 deletions(-)

diff --git a/src/test/resources/esapi/waf-policies/replace-outbound-policy.xml b/src/test/resources/esapi/waf-policies/replace-outbound-policy.xml
index 9c1aa4097..5b0926c2b 100644
--- a/src/test/resources/esapi/waf-policies/replace-outbound-policy.xml
+++ b/src/test/resources/esapi/waf-policies/replace-outbound-policy.xml
@@ -1,27 +1,27 @@
-
-
-	
-
-
-
-	
-		redirect
-		
-			/security/error.jsp
-			403
-		
-	
-
-	
-		
-			
-		
-	
-	
+
+
+	
+
+
+
+	
+		redirect
+		
+			/security/error.jsp
+			403
+		
+	
+
+	
+		
+			
+		
+	
+	
 
\ No newline at end of file

From 7e519cd4bb7fed416672e4f4304e99aa21f0e0e8 Mon Sep 17 00:00:00 2001
From: kwwall 
Date: Mon, 18 Jan 2016 23:34:46 -0500
Subject: [PATCH 305/812] Change CRLF to LF for issue 356.

---
 .../restrict-content-type-policy.xml          | 52 +++++++++----------
 1 file changed, 26 insertions(+), 26 deletions(-)

diff --git a/src/test/resources/esapi/waf-policies/restrict-content-type-policy.xml b/src/test/resources/esapi/waf-policies/restrict-content-type-policy.xml
index a9b8a4a38..b766f19d3 100644
--- a/src/test/resources/esapi/waf-policies/restrict-content-type-policy.xml
+++ b/src/test/resources/esapi/waf-policies/restrict-content-type-policy.xml
@@ -1,27 +1,27 @@
-
-
-	
-
-
-
-	
-		redirect
-		
-			/security/error.jsp
-			403
-		
-	
-
-	
-		
-			/fileupload.jsp
-		
-
-	
-
+
+
+	
+
+
+
+	
+		redirect
+		
+			/security/error.jsp
+			403
+		
+	
+
+	
+		
+			/fileupload.jsp
+		
+
+	
+
 
\ No newline at end of file

From 21d2171cc925201b11da8c88ceba8d3d27d9d17b Mon Sep 17 00:00:00 2001
From: kwwall 
Date: Mon, 18 Jan 2016 23:34:46 -0500
Subject: [PATCH 306/812] Change CRLF to LF for issue 356.

---
 .../restrict-extension-policy.xml             | 48 +++++++++----------
 1 file changed, 24 insertions(+), 24 deletions(-)

diff --git a/src/test/resources/esapi/waf-policies/restrict-extension-policy.xml b/src/test/resources/esapi/waf-policies/restrict-extension-policy.xml
index fe1dbe193..a572bd4ea 100644
--- a/src/test/resources/esapi/waf-policies/restrict-extension-policy.xml
+++ b/src/test/resources/esapi/waf-policies/restrict-extension-policy.xml
@@ -1,25 +1,25 @@
-
-
-	
-
-
-
-	
-		redirect
-		
-			/security/error.jsp
-			403
-		
-	
-
-	
-		
-		
-	
-
+
+
+	
+
+
+
+	
+		redirect
+		
+			/security/error.jsp
+			403
+		
+	
+
+	
+		
+		
+	
+
 
\ No newline at end of file

From 5aca43aa27eb9670ea808ef4f88e2e68697f7242 Mon Sep 17 00:00:00 2001
From: kwwall 
Date: Mon, 18 Jan 2016 23:34:46 -0500
Subject: [PATCH 307/812] Change CRLF to LF for issue 356.

---
 .../waf-policies/restrict-method-policy.xml   | 48 +++++++++----------
 1 file changed, 24 insertions(+), 24 deletions(-)

diff --git a/src/test/resources/esapi/waf-policies/restrict-method-policy.xml b/src/test/resources/esapi/waf-policies/restrict-method-policy.xml
index 5a2337cf7..c1eb5a36e 100644
--- a/src/test/resources/esapi/waf-policies/restrict-method-policy.xml
+++ b/src/test/resources/esapi/waf-policies/restrict-method-policy.xml
@@ -1,25 +1,25 @@
-
-
-	
-
-
-
-	
-		redirect
-		
-			/security/error.jsp
-			403
-		
-	
-
-	
-		
-		
-	
-
+
+
+	
+
+
+
+	
+		redirect
+		
+			/security/error.jsp
+			403
+		
+	
+
+	
+		
+		
+	
+
 
\ No newline at end of file

From 4c9dcef430b2e08ef45280ddd1b6f6f98904b706 Mon Sep 17 00:00:00 2001
From: kwwall 
Date: Mon, 18 Jan 2016 23:34:46 -0500
Subject: [PATCH 308/812] Change CRLF to LF for issue 356.

---
 .../restrict-source-ip-policy.xml             | 52 +++++++++----------
 1 file changed, 26 insertions(+), 26 deletions(-)

diff --git a/src/test/resources/esapi/waf-policies/restrict-source-ip-policy.xml b/src/test/resources/esapi/waf-policies/restrict-source-ip-policy.xml
index d23d87a02..72860a7d3 100644
--- a/src/test/resources/esapi/waf-policies/restrict-source-ip-policy.xml
+++ b/src/test/resources/esapi/waf-policies/restrict-source-ip-policy.xml
@@ -1,27 +1,27 @@
-
-
-	
-
-
-
-	
-		redirect
-		
-			/security/error.jsp
-			403
-		
-	
-
-	
-		/admin/.*
-
-	
-
+
+
+	
+
+
+
+	
+		redirect
+		
+			/security/error.jsp
+			403
+		
+	
+
+	
+		/admin/.*
+
+	
+
 
\ No newline at end of file

From 0038ea8eade5399c5711bbc0123e3f4e6258e368 Mon Sep 17 00:00:00 2001
From: kwwall 
Date: Mon, 18 Jan 2016 23:34:46 -0500
Subject: [PATCH 309/812] Change CRLF to LF for issue 356.

---
 .../restrict-user-agent-policy.xml            | 50 +++++++++----------
 1 file changed, 25 insertions(+), 25 deletions(-)

diff --git a/src/test/resources/esapi/waf-policies/restrict-user-agent-policy.xml b/src/test/resources/esapi/waf-policies/restrict-user-agent-policy.xml
index 7cdebd595..c550a2c61 100644
--- a/src/test/resources/esapi/waf-policies/restrict-user-agent-policy.xml
+++ b/src/test/resources/esapi/waf-policies/restrict-user-agent-policy.xml
@@ -1,26 +1,26 @@
-
-
-	
-
-
-
-	
-		redirect
-		
-			/security/error.jsp
-			403
-		
-	
-
-	
-		
-			/index.html
-		
-	
-
+
+
+	
+
+
+
+	
+		redirect
+		
+			/security/error.jsp
+			403
+		
+	
+
+	
+		
+			/index.html
+		
+	
+
 
\ No newline at end of file

From 284c604f99c070f3966e977113a9794151ded02e Mon Sep 17 00:00:00 2001
From: kwwall 
Date: Mon, 18 Jan 2016 23:34:46 -0500
Subject: [PATCH 310/812] Change CRLF to LF for issue 356.

---
 .../waf-policies/virtual-patch-policy.xml     | 52 +++++++++----------
 1 file changed, 26 insertions(+), 26 deletions(-)

diff --git a/src/test/resources/esapi/waf-policies/virtual-patch-policy.xml b/src/test/resources/esapi/waf-policies/virtual-patch-policy.xml
index 61c93fa88..8b989dd6e 100644
--- a/src/test/resources/esapi/waf-policies/virtual-patch-policy.xml
+++ b/src/test/resources/esapi/waf-policies/virtual-patch-policy.xml
@@ -1,27 +1,27 @@
-
-
-	
-
-
-
-	
-		redirect
-		
-			/security/error.jsp
-			403
-		
-	
-
-	
-		
-	
-
+
+
+	
+
+
+
+	
+		redirect
+		
+			/security/error.jsp
+			403
+		
+	
+
+	
+		
+	
+
 
\ No newline at end of file

From 9aaaf809a1b77c9fd8bfdeaee2b85079d1fe7db4 Mon Sep 17 00:00:00 2001
From: kwwall 
Date: Mon, 18 Jan 2016 23:34:46 -0500
Subject: [PATCH 311/812] Change CRLF to LF for issue 356.

---
 src/test/resources/esapi/waf-policy.xml | 296 ++++++++++++------------
 1 file changed, 148 insertions(+), 148 deletions(-)

diff --git a/src/test/resources/esapi/waf-policy.xml b/src/test/resources/esapi/waf-policy.xml
index 05d75b23d..7a1df159f 100644
--- a/src/test/resources/esapi/waf-policy.xml
+++ b/src/test/resources/esapi/waf-policy.xml
@@ -1,149 +1,149 @@
-
-
-	
-
-
-
-
-	
-	
-		/security/input.jsp
-		^/admin/.*
-	
-
-
-
-	
-	
-		redirect
-		JSESSIONID
-		
-			/security/error.jsp
-			403
-		
-	
-
-
-
-	
-	
-		/
-		/index.html
-		/login.jsp
-		/index.jsp
-		/images/.*
-		/css/.*
-		/help/.*
-	
-
-
-		
-		
-	
-	
-	
-	
-		/admin/.*
-		
-	
-
-
-
-	
-	
-		
-
-		
-		
-
-		
-			/index.html
-			/index.jsp
-			/images/.*
-			/css/.*
-			/help/.*
-		
-	
-
-
-
-	
-	
-		
-		
-		
-		
-		
-	
-
-
-	
-	
-		
-	
-
-
-
-	
-
-	
-
-		
-			/foobar/.*
-		
-
-		
-			
-		
-
-		
-			
-		
-
- 		
-			
-		
-
-		
-			\1\2
-		
-
-		
-
-	
-
+
+
+	
+
+
+
+
+	
+	
+		/security/input.jsp
+		^/admin/.*
+	
+
+
+
+	
+	
+		redirect
+		JSESSIONID
+		
+			/security/error.jsp
+			403
+		
+	
+
+
+
+	
+	
+		/
+		/index.html
+		/login.jsp
+		/index.jsp
+		/images/.*
+		/css/.*
+		/help/.*
+	
+
+
+		
+		
+	
+	
+	
+	
+		/admin/.*
+		
+	
+
+
+
+	
+	
+		
+
+		
+		
+
+		
+			/index.html
+			/index.jsp
+			/images/.*
+			/css/.*
+			/help/.*
+		
+	
+
+
+
+	
+	
+		
+		
+		
+		
+		
+	
+
+
+	
+	
+		
+	
+
+
+
+	
+
+	
+
+		
+			/foobar/.*
+		
+
+		
+			
+		
+
+		
+			
+		
+
+ 		
+			
+		
+
+		
+			\1\2
+		
+
+		
+
+	
+
 
\ No newline at end of file

From d571e4e6ce7e3639441569d6e359dfbb0860e778 Mon Sep 17 00:00:00 2001
From: kwwall 
Date: Mon, 18 Jan 2016 23:34:46 -0500
Subject: [PATCH 312/812] Change CRLF to LF for issue 356.

---
 src/test/resources/log4j.xml | 110 +++++++++++++++++------------------
 1 file changed, 55 insertions(+), 55 deletions(-)

diff --git a/src/test/resources/log4j.xml b/src/test/resources/log4j.xml
index 04c2b4364..9cb7354fe 100644
--- a/src/test/resources/log4j.xml
+++ b/src/test/resources/log4j.xml
@@ -1,55 +1,55 @@
-
-
-
-
-
-   
-     
-     
-       
-     
-  
-
-    
-        
-        
-          
-        
-    
-
-  
-    
-  
-
-  
-    
-  
-
-  
-    
- 
-
-  
-    
-  
-
-  
-    
-  
-
-  
-    
-  
-
-  
-    
-  
-
-  
-    
-    
-  
-
-  
-
-
+
+
+
+
+
+   
+     
+     
+       
+     
+  
+
+    
+        
+        
+          
+        
+    
+
+  
+    
+  
+
+  
+    
+  
+
+  
+    
+ 
+
+  
+    
+  
+
+  
+    
+  
+
+  
+    
+  
+
+  
+    
+  
+
+  
+    
+    
+  
+
+  
+
+

From 4a229d9fe665e60b5d7d51408caa59d8d2baf85d Mon Sep 17 00:00:00 2001
From: kwwall 
Date: Tue, 19 Jan 2016 01:10:08 -0500
Subject: [PATCH 313/812] Continue to try to address issue 356.

---
 .gitattributes | 25 ++++++++++++++++++++-----
 1 file changed, 20 insertions(+), 5 deletions(-)

diff --git a/.gitattributes b/.gitattributes
index a90ca1d70..3645b7bba 100644
--- a/.gitattributes
+++ b/.gitattributes
@@ -7,12 +7,9 @@
 #       git config --global core.autocrlf input
 * text=auto
 
-# And configure default EOL terminators.
 #
-# Force the following filetypes to have Unix eols, so Windows does not break them
-# Those that are not explicitly set to use Windows EOL will use LF as EOL terminator.
-# (e.g., see *.bat, below).
-*.* text eol=lf
+# And configure default EOL terminators for various text types
+#
 
 # Explicitly declare text files you want to always be normalized and converted
 # to native line endings on checkout.
@@ -42,6 +39,16 @@
 *.bsh text eol=lf
 *.ksh text eol=lf
 
+# More
+.gitattributes text
+.settings/* text eol=crlf
+.classpath text eol=crlf
+*.MF text eol=crlf
+LICENSE text eol=crlf
+LICENSE-CONTENT text eol=crlf
+LICENSE-README text eol=crlf
+
+
 # Denote all files that are truly binary and should not be modified,
 # or simply replaced in whole if committed.
 *.jpg binary
@@ -56,3 +63,11 @@
 *.pptx binary
 *.odt binary
 *.pdf binary
+*.zip binary
+*.jar binary
+*.war binary
+*.ear binary
+*.7z binary
+*.rar binary
+*.tgz binary
+*.tar binary

From f348b558d5cb059b806f4240f4c553e36ada06ad Mon Sep 17 00:00:00 2001
From: kwwall 
Date: Tue, 19 Jan 2016 01:12:42 -0500
Subject: [PATCH 314/812] Address issue 356.

---
 configuration/esapi/ESAPI.properties | 930 +++++++++++++--------------
 1 file changed, 465 insertions(+), 465 deletions(-)

diff --git a/configuration/esapi/ESAPI.properties b/configuration/esapi/ESAPI.properties
index baa8e6933..f98cc5a49 100644
--- a/configuration/esapi/ESAPI.properties
+++ b/configuration/esapi/ESAPI.properties
@@ -1,465 +1,465 @@
-#
-# OWASP Enterprise Security API (ESAPI) Properties file -- PRODUCTION Version
-# 
-# This file is part of the Open Web Application Security Project (OWASP)
-# Enterprise Security API (ESAPI) project. For details, please see
-# http://www.owasp.org/index.php/ESAPI.
-#
-# Copyright (c) 2008,2009 - The OWASP Foundation
-#
-# DISCUSS: This may cause a major backwards compatibility issue, etc. but
-#		   from a name space perspective, we probably should have prefaced
-#		   all the property names with ESAPI or at least OWASP. Otherwise
-#		   there could be problems is someone loads this properties file into
-#		   the System properties.  We could also put this file into the
-#		   esapi.jar file (perhaps as a ResourceBundle) and then allow an external
-#		   ESAPI properties be defined that would overwrite these defaults.
-#		   That keeps the application's properties relatively simple as usually
-#		   they will only want to override a few properties. If looks like we
-#		   already support multiple override levels of this in the
-#		   DefaultSecurityConfiguration class, but I'm suggesting placing the
-#		   defaults in the esapi.jar itself. That way, if the jar is signed,
-#		   we could detect if those properties had been tampered with. (The
-#		   code to check the jar signatures is pretty simple... maybe 70-90 LOC,
-#		   but off course there is an execution penalty (similar to the way
-#		   that the separate sunjce.jar used to be when a class from it was
-#		   first loaded). Thoughts?
-###############################################################################
-#
-# WARNING: Operating system protection should be used to lock down the .esapi
-# resources directory and all the files inside and all the directories all the
-# way up to the root directory of the file system.  Note that if you are using
-# file-based implementations, that some files may need to be read-write as they
-# get updated dynamically.
-#
-# Before using, be sure to update the MasterKey and MasterSalt as described below.
-# N.B.: If you had stored data that you have previously encrypted with ESAPI 1.4,
-#		you *must* FIRST decrypt it using ESAPI 1.4 and then (if so desired)
-#		re-encrypt it with ESAPI 2.0. If you fail to do this, you will NOT be
-#		able to decrypt your data with ESAPI 2.0.
-#
-#		YOU HAVE BEEN WARNED!!! More details are in the ESAPI 2.0 Release Notes.
-#
-#===========================================================================
-# ESAPI Configuration
-#
-# If true, then print all the ESAPI properties set here when they are loaded.
-# If false, they are not printed. Useful to reduce output when running JUnit tests.
-# If you need to troubleshoot a properties related problem, turning this on may help.
-# This is 'false' in the src/test/resources/.esapi version. It is 'true' by
-# default for reasons of backward compatibility with earlier ESAPI versions.
-ESAPI.printProperties=true
-
-# ESAPI is designed to be easily extensible. You can use the reference implementation
-# or implement your own providers to take advantage of your enterprise's security
-# infrastructure. The functions in ESAPI are referenced using the ESAPI locator, like:
-#
-#    String ciphertext =
-#		ESAPI.encryptor().encrypt("Secret message");   // Deprecated in 2.0
-#    CipherText cipherText =
-#		ESAPI.encryptor().encrypt(new PlainText("Secret message")); // Preferred
-#
-# Below you can specify the classname for the provider that you wish to use in your
-# application. The only requirement is that it implement the appropriate ESAPI interface.
-# This allows you to switch security implementations in the future without rewriting the
-# entire application.
-#
-# ExperimentalAccessController requires ESAPI-AccessControlPolicy.xml in .esapi directory
-ESAPI.AccessControl=org.owasp.esapi.reference.DefaultAccessController
-# FileBasedAuthenticator requires users.txt file in .esapi directory
-ESAPI.Authenticator=org.owasp.esapi.reference.FileBasedAuthenticator
-ESAPI.Encoder=org.owasp.esapi.reference.DefaultEncoder
-ESAPI.Encryptor=org.owasp.esapi.reference.crypto.JavaEncryptor
-
-ESAPI.Executor=org.owasp.esapi.reference.DefaultExecutor
-ESAPI.HTTPUtilities=org.owasp.esapi.reference.DefaultHTTPUtilities
-ESAPI.IntrusionDetector=org.owasp.esapi.reference.DefaultIntrusionDetector
-# Log4JFactory Requires log4j.xml or log4j.properties in classpath - http://www.laliluna.de/log4j-tutorial.html
-ESAPI.Logger=org.owasp.esapi.reference.Log4JLogFactory
-#ESAPI.Logger=org.owasp.esapi.reference.JavaLogFactory
-ESAPI.Randomizer=org.owasp.esapi.reference.DefaultRandomizer
-ESAPI.Validator=org.owasp.esapi.reference.DefaultValidator
-
-#===========================================================================
-# ESAPI Authenticator
-#
-Authenticator.AllowedLoginAttempts=3
-Authenticator.MaxOldPasswordHashes=13
-Authenticator.UsernameParameterName=username
-Authenticator.PasswordParameterName=password
-# RememberTokenDuration (in days)
-Authenticator.RememberTokenDuration=14
-# Session Timeouts (in minutes)
-Authenticator.IdleTimeoutDuration=20
-Authenticator.AbsoluteTimeoutDuration=120
-
-#===========================================================================
-# ESAPI Encoder
-#
-# ESAPI canonicalizes input before validation to prevent bypassing filters with encoded attacks.
-# Failure to canonicalize input is a very common mistake when implementing validation schemes.
-# Canonicalization is automatic when using the ESAPI Validator, but you can also use the
-# following code to canonicalize data.
-#
-#      ESAPI.Encoder().canonicalize( "%22hello world"" );
-#  
-# Multiple encoding is when a single encoding format is applied multiple times. Allowing
-# multiple encoding is strongly discouraged.
-Encoder.AllowMultipleEncoding=false
-
-# Mixed encoding is when multiple different encoding formats are applied, or when 
-# multiple formats are nested. Allowing multiple encoding is strongly discouraged.
-Encoder.AllowMixedEncoding=false
-
-# The default list of codecs to apply when canonicalizing untrusted data. The list should include the codecs
-# for all downstream interpreters or decoders. For example, if the data is likely to end up in a URL, HTML, or
-# inside JavaScript, then the list of codecs below is appropriate. The order of the list is not terribly important.
-Encoder.DefaultCodecList=HTMLEntityCodec,PercentCodec,JavaScriptCodec
-
-
-#===========================================================================
-# ESAPI Encryption
-#
-# The ESAPI Encryptor provides basic cryptographic functions with a simplified API.
-# To get started, generate a new key using java -classpath esapi.jar org.owasp.esapi.reference.crypto.JavaEncryptor
-# There is not currently any support for key rotation, so be careful when changing your key and salt as it
-# will invalidate all signed, encrypted, and hashed data.
-#
-# WARNING: Not all combinations of algorithms and key lengths are supported.
-# If you choose to use a key length greater than 128, you MUST download the
-# unlimited strength policy files and install in the lib directory of your JRE/JDK.
-# See http://java.sun.com/javase/downloads/index.jsp for more information.
-#
-# Backward compatibility with ESAPI Java 1.4 is supported by the two deprecated API
-# methods, Encryptor.encrypt(String) and Encryptor.decrypt(String). However, whenever
-# possible, these methods should be avoided as they use ECB cipher mode, which in almost
-# all circumstances a poor choice because of it's weakness. CBC cipher mode is the default
-# for the new Encryptor encrypt / decrypt methods for ESAPI Java 2.0.  In general, you
-# should only use this compatibility setting if you have persistent data encrypted with
-# version 1.4 and even then, you should ONLY set this compatibility mode UNTIL
-# you have decrypted all of your old encrypted data and then re-encrypted it with
-# ESAPI 2.0 using CBC mode. If you have some reason to mix the deprecated 1.4 mode
-# with the new 2.0 methods, make sure that you use the same cipher algorithm for both
-# (256-bit AES was the default for 1.4; 128-bit is the default for 2.0; see below for
-# more details.) Otherwise, you will have to use the new 2.0 encrypt / decrypt methods
-# where you can specify a SecretKey. (Note that if you are using the 256-bit AES,
-# that requires downloading the special jurisdiction policy files mentioned above.)
-#
-#		***** IMPORTANT: Do NOT forget to replace these with your own values! *****
-# To calculate these values, you can run:
-#		java -classpath esapi.jar org.owasp.esapi.reference.crypto.JavaEncryptor
-#
-#Encryptor.MasterKey=
-#Encryptor.MasterSalt=
-
-# Provides the default JCE provider that ESAPI will "prefer" for its symmetric
-# encryption and hashing. (That is it will look to this provider first, but it
-# will defer to other providers if the requested algorithm is not implemented
-# by this provider.) If left unset, ESAPI will just use your Java VM's current
-# preferred JCE provider, which is generally set in the file
-# "$JAVA_HOME/jre/lib/security/java.security".
-#
-# The main intent of this is to allow ESAPI symmetric encryption to be
-# used with a FIPS 140-2 compliant crypto-module. For details, see the section
-# "Using ESAPI Symmetric Encryption with FIPS 140-2 Cryptographic Modules" in
-# the ESAPI 2.0 Symmetric Encryption User Guide, at:
-# http://owasp-esapi-java.googlecode.com/svn/trunk/documentation/esapi4java-core-2.0-symmetric-crypto-user-guide.html
-# However, this property also allows you to easily use an alternate JCE provider
-# such as "Bouncy Castle" without having to make changes to "java.security".
-# See Javadoc for SecurityProviderLoader for further details. If you wish to use
-# a provider that is not known to SecurityProviderLoader, you may specify the
-# fully-qualified class name of the JCE provider class that implements
-# java.security.Provider. If the name contains a '.', this is interpreted as
-# a fully-qualified class name that implements java.security.Provider.
-#
-# NOTE: Setting this property has the side-effect of changing it in your application
-#       as well, so if you are using JCE in your application directly rather than
-#       through ESAPI (you wouldn't do that, would you? ;-), it will change the
-#       preferred JCE provider there as well.
-#
-# Default: Keeps the JCE provider set to whatever JVM sets it to.
-Encryptor.PreferredJCEProvider=
-
-# AES is the most widely used and strongest encryption algorithm. This
-# should agree with your Encryptor.CipherTransformation property.
-# By default, ESAPI Java 1.4 uses "PBEWithMD5AndDES" and which is
-# very weak. It is essentially a password-based encryption key, hashed
-# with MD5 around 1K times and then encrypted with the weak DES algorithm
-# (56-bits) using ECB mode and an unspecified padding (it is
-# JCE provider specific, but most likely "NoPadding"). However, 2.0 uses
-# "AES/CBC/PKCSPadding". If you want to change these, change them here.
-# Warning: This property does not control the default reference implementation for
-#		   ESAPI 2.0 using JavaEncryptor. Also, this property will be dropped
-#		   in the future.
-# @deprecated
-Encryptor.EncryptionAlgorithm=AES
-#		For ESAPI Java 2.0 - New encrypt / decrypt methods use this.
-Encryptor.CipherTransformation=AES/CBC/PKCS5Padding
-
-# Applies to ESAPI 2.0 and later only!
-# Comma-separated list of cipher modes that provide *BOTH*
-# confidentiality *AND* message authenticity. (NIST refers to such cipher
-# modes as "combined modes" so that's what we shall call them.) If any of these
-# cipher modes are used then no MAC is calculated and stored
-# in the CipherText upon encryption. Likewise, if one of these
-# cipher modes is used with decryption, no attempt will be made
-# to validate the MAC contained in the CipherText object regardless
-# of whether it contains one or not. Since the expectation is that
-# these cipher modes support support message authenticity already,
-# injecting a MAC in the CipherText object would be at best redundant.
-#
-# Note that as of JDK 1.5, the SunJCE provider does not support *any*
-# of these cipher modes. Of these listed, only GCM and CCM are currently
-# NIST approved. YMMV for other JCE providers. E.g., Bouncy Castle supports
-# GCM and CCM with "NoPadding" mode, but not with "PKCS5Padding" or other
-# padding modes.
-Encryptor.cipher_modes.combined_modes=GCM,CCM,IAPM,EAX,OCB,CWC
-
-# Applies to ESAPI 2.0 and later only!
-# Additional cipher modes allowed for ESAPI 2.0 encryption. These
-# cipher modes are in _addition_ to those specified by the property
-# 'Encryptor.cipher_modes.combined_modes'.
-# Note: We will add support for streaming modes like CFB & OFB once
-# we add support for 'specified' to the property 'Encryptor.ChooseIVMethod'
-# (probably in ESAPI 2.1).
-# DISCUSS: Better name?
-Encryptor.cipher_modes.additional_allowed=CBC
-
-# 128-bit is almost always sufficient and appears to be more resistant to
-# related key attacks than is 256-bit AES. Use '_' to use default key size
-# for cipher algorithms (where it makes sense because the algorithm supports
-# a variable key size). Key length must agree to what's provided as the
-# cipher transformation, otherwise this will be ignored after logging a
-# warning.
-#
-# NOTE: This is what applies BOTH ESAPI 1.4 and 2.0. See warning above about mixing!
-Encryptor.EncryptionKeyLength=128
-
-# Because 2.0 uses CBC mode by default, it requires an initialization vector (IV).
-# (All cipher modes except ECB require an IV.) There are two choices: we can either
-# use a fixed IV known to both parties or allow ESAPI to choose a random IV. While
-# the IV does not need to be hidden from adversaries, it is important that the
-# adversary not be allowed to choose it. Also, random IVs are generally much more
-# secure than fixed IVs. (In fact, it is essential that feed-back cipher modes
-# such as CFB and OFB use a different IV for each encryption with a given key so
-# in such cases, random IVs are much preferred. By default, ESAPI 2.0 uses random
-# IVs. If you wish to use 'fixed' IVs, set 'Encryptor.ChooseIVMethod=fixed' and
-# uncomment the Encryptor.fixedIV.
-#
-# Valid values:		random|fixed|specified		'specified' not yet implemented; planned for 2.1
-Encryptor.ChooseIVMethod=random
-# If you choose to use a fixed IV, then you must place a fixed IV here that
-# is known to all others who are sharing your secret key. The format should
-# be a hex string that is the same length as the cipher block size for the
-# cipher algorithm that you are using. The following is an *example* for AES
-# from an AES test vector for AES-128/CBC as described in:
-# NIST Special Publication 800-38A (2001 Edition)
-# "Recommendation for Block Cipher Modes of Operation".
-# (Note that the block size for AES is 16 bytes == 128 bits.)
-#
-Encryptor.fixedIV=0x000102030405060708090a0b0c0d0e0f
-
-# Whether or not CipherText should use a message authentication code (MAC) with it.
-# This prevents an adversary from altering the IV as well as allowing a more
-# fool-proof way of determining the decryption failed because of an incorrect
-# key being supplied. This refers to the "separate" MAC calculated and stored
-# in CipherText, not part of any MAC that is calculated as a result of a
-# "combined mode" cipher mode.
-#
-# If you are using ESAPI with a FIPS 140-2 cryptographic module, you *must* also
-# set this property to false.
-Encryptor.CipherText.useMAC=true
-
-# Whether or not the PlainText object may be overwritten and then marked
-# eligible for garbage collection. If not set, this is still treated as 'true'.
-Encryptor.PlainText.overwrite=true
-
-# Do not use DES except in a legacy situations. 56-bit is way too small key size.
-#Encryptor.EncryptionKeyLength=56
-#Encryptor.EncryptionAlgorithm=DES
-
-# TripleDES is considered strong enough for most purposes.
-#	Note:	There is also a 112-bit version of DESede. Using the 168-bit version
-#			requires downloading the special jurisdiction policy from Sun.
-#Encryptor.EncryptionKeyLength=168
-#Encryptor.EncryptionAlgorithm=DESede
-
-Encryptor.HashAlgorithm=SHA-512
-Encryptor.HashIterations=1024
-Encryptor.DigitalSignatureAlgorithm=SHA1withDSA
-Encryptor.DigitalSignatureKeyLength=1024
-Encryptor.RandomAlgorithm=SHA1PRNG
-Encryptor.CharacterEncoding=UTF-8
-
-# This is the Pseudo Random Function (PRF) that ESAPI's Key Derivation Function
-# (KDF) normally uses. Note this is *only* the PRF used for ESAPI's KDF and
-# *not* what is used for ESAPI's MAC. (Currently, HmacSHA1 is always used for
-# the MAC, mostly to keep the overall size at a minimum.)
-#
-# Currently supported choices for JDK 1.5 and 1.6 are:
-#	HmacSHA1 (160 bits), HmacSHA256 (256 bits), HmacSHA384 (384 bits), and
-#	HmacSHA512 (512 bits).
-# Note that HmacMD5 is *not* supported for the PRF used by the KDF even though
-# the JDKs support it.  See the ESAPI 2.0 Symmetric Encryption User Guide
-# further details.
-Encryptor.KDF.PRF=HmacSHA256
-#===========================================================================
-# ESAPI HttpUtilties
-#
-# The HttpUtilities provide basic protections to HTTP requests and responses. Primarily these methods 
-# protect against malicious data from attackers, such as unprintable characters, escaped characters,
-# and other simple attacks. The HttpUtilities also provides utility methods for dealing with cookies,
-# headers, and CSRF tokens.
-#
-# Default file upload location (remember to escape backslashes with \\)
-HttpUtilities.UploadDir=C:\\ESAPI\\testUpload
-HttpUtilities.UploadTempDir=C:\\temp
-# Force flags on cookies, if you use HttpUtilities to set cookies
-HttpUtilities.ForceHttpOnlySession=false
-HttpUtilities.ForceSecureSession=false
-HttpUtilities.ForceHttpOnlyCookies=true
-HttpUtilities.ForceSecureCookies=true
-# Maximum size of HTTP headers
-HttpUtilities.MaxHeaderSize=4096
-# File upload configuration
-HttpUtilities.ApprovedUploadExtensions=.zip,.pdf,.doc,.docx,.ppt,.pptx,.tar,.gz,.tgz,.rar,.war,.jar,.ear,.xls,.rtf,.properties,.java,.class,.txt,.xml,.jsp,.jsf,.exe,.dll
-HttpUtilities.MaxUploadFileBytes=500000000
-# Using UTF-8 throughout your stack is highly recommended. That includes your database driver,
-# container, and any other technologies you may be using. Failure to do this may expose you
-# to Unicode transcoding injection attacks. Use of UTF-8 does not hinder internationalization.
-HttpUtilities.ResponseContentType=text/html; charset=UTF-8
-# This is the name of the cookie used to represent the HTTP session
-# Typically this will be the default "JSESSIONID" 
-HttpUtilities.HttpSessionIdName=JSESSIONID
-
-
-
-#===========================================================================
-# ESAPI Executor
-# CHECKME - This should be made OS independent. Don't use unsafe defaults.
-# # Examples only -- do NOT blindly copy!
-#   For Windows:
-#     Executor.WorkingDirectory=C:\\Windows\\Temp
-#     Executor.ApprovedExecutables=C:\\Windows\\System32\\cmd.exe,C:\\Windows\\System32\\runas.exe
-#   For *nux, MacOS:
-#     Executor.WorkingDirectory=/tmp
-#     Executor.ApprovedExecutables=/bin/bash
-Executor.WorkingDirectory=
-Executor.ApprovedExecutables=
-
-
-#===========================================================================
-# ESAPI Logging
-# Set the application name if these logs are combined with other applications
-Logger.ApplicationName=ExampleApplication
-# If you use an HTML log viewer that does not properly HTML escape log data, you can set LogEncodingRequired to true
-Logger.LogEncodingRequired=false
-# Determines whether ESAPI should log the application name. This might be clutter in some single-server/single-app environments.
-Logger.LogApplicationName=true
-# Determines whether ESAPI should log the server IP and port. This might be clutter in some single-server environments.
-Logger.LogServerIP=true
-# LogFileName, the name of the logging file. Provide a full directory path (e.g., C:\\ESAPI\\ESAPI_logging_file) if you
-# want to place it in a specific directory.
-Logger.LogFileName=ESAPI_logging_file
-# MaxLogFileSize, the max size (in bytes) of a single log file before it cuts over to a new one (default is 10,000,000)
-Logger.MaxLogFileSize=10000000
-
-
-#===========================================================================
-# ESAPI Intrusion Detection
-#
-# Each event has a base to which .count, .interval, and .action are added
-# The IntrusionException will fire if we receive "count" events within "interval" seconds
-# The IntrusionDetector is configurable to take the following actions: log, logout, and disable
-#  (multiple actions separated by commas are allowed e.g. event.test.actions=log,disable
-#
-# Custom Events
-# Names must start with "event." as the base
-# Use IntrusionDetector.addEvent( "test" ) in your code to trigger "event.test" here
-# You can also disable intrusion detection completely by changing
-# the following parameter to true
-#
-IntrusionDetector.Disable=false
-#
-IntrusionDetector.event.test.count=2
-IntrusionDetector.event.test.interval=10
-IntrusionDetector.event.test.actions=disable,log
-
-# Exception Events
-# All EnterpriseSecurityExceptions are registered automatically
-# Call IntrusionDetector.getInstance().addException(e) for Exceptions that do not extend EnterpriseSecurityException
-# Use the fully qualified classname of the exception as the base
-
-# any intrusion is an attack
-IntrusionDetector.org.owasp.esapi.errors.IntrusionException.count=1
-IntrusionDetector.org.owasp.esapi.errors.IntrusionException.interval=1
-IntrusionDetector.org.owasp.esapi.errors.IntrusionException.actions=log,disable,logout
-
-# for test purposes
-# CHECKME: Shouldn't there be something in the property name itself that designates
-#		   that these are for testing???
-IntrusionDetector.org.owasp.esapi.errors.IntegrityException.count=10
-IntrusionDetector.org.owasp.esapi.errors.IntegrityException.interval=5
-IntrusionDetector.org.owasp.esapi.errors.IntegrityException.actions=log,disable,logout
-
-# rapid validation errors indicate scans or attacks in progress
-# org.owasp.esapi.errors.ValidationException.count=10
-# org.owasp.esapi.errors.ValidationException.interval=10
-# org.owasp.esapi.errors.ValidationException.actions=log,logout
-
-# sessions jumping between hosts indicates session hijacking
-IntrusionDetector.org.owasp.esapi.errors.AuthenticationHostException.count=2
-IntrusionDetector.org.owasp.esapi.errors.AuthenticationHostException.interval=10
-IntrusionDetector.org.owasp.esapi.errors.AuthenticationHostException.actions=log,logout
-
-
-#===========================================================================
-# ESAPI Validation
-#
-# The ESAPI Validator works on regular expressions with defined names. You can define names
-# either here, or you may define application specific patterns in a separate file defined below.
-# This allows enterprises to specify both organizational standards as well as application specific
-# validation rules.
-#
-# Use '\p{L}' (without the quotes) within the character class to match
-# any Unicode LETTER. You can also use a range, like:  \u00C0-\u017F
-# You can also use any of the regex flags as documented at
-# https://docs.oracle.com/javase/tutorial/essential/regex/pattern.html, e.g. (?u)
-#
-Validator.ConfigurationFile=validation.properties
-
-# Validators used by ESAPI
-Validator.AccountName=^[a-zA-Z0-9]{3,20}$
-Validator.SystemCommand=^[a-zA-Z\\-\\/]{1,64}$
-Validator.RoleName=^[a-z]{1,20}$
-
-#the word TEST below should be changed to your application 
-#name - only relative URL's are supported
-Validator.Redirect=^\\/test.*$
-
-# Global HTTP Validation Rules
-# Values with Base64 encoded data (e.g. encrypted state) will need at least [a-zA-Z0-9\/+=]
-Validator.HTTPScheme=^(http|https)$
-Validator.HTTPServerName=^[a-zA-Z0-9_.\\-]*$
-Validator.HTTPParameterName=^[a-zA-Z0-9_]{1,32}$
-Validator.HTTPParameterValue=^[a-zA-Z0-9.\\-\\/+=@_ ]*$
-Validator.HTTPCookieName=^[a-zA-Z0-9\\-_]{1,32}$
-Validator.HTTPCookieValue=^[a-zA-Z0-9\\-\\/+=_ ]*$
-# Note that max header name capped at 150 in SecurityRequestWrapper!
-Validator.HTTPHeaderName=^[a-zA-Z0-9\\-_]{1,50}$
-Validator.HTTPHeaderValue=^[a-zA-Z0-9()\\-=\\*\\.\\?;,+\\/:&_ ]*$
-Validator.HTTPContextPath=^\\/?[a-zA-Z0-9.\\-\\/_]*$
-Validator.HTTPServletPath=^[a-zA-Z0-9.\\-\\/_]*$
-Validator.HTTPPath=^[a-zA-Z0-9.\\-_]*$
-Validator.HTTPQueryString=^[a-zA-Z0-9()\\-=\\*\\.\\?;,+\\/:&_ %]*$
-Validator.HTTPURI=^[a-zA-Z0-9()\\-=\\*\\.\\?;,+\\/:&_ ]*$
-Validator.HTTPURL=^.*$
-Validator.HTTPJSESSIONID=^[A-Z0-9]{10,30}$
-
-# Validation of file related input
-Validator.FileName=^[a-zA-Z0-9!@#$%^&{}\\[\\]()_+\\-=,.~'` ]{1,255}$
-Validator.DirectoryName=^[a-zA-Z0-9:/\\\\!@#$%^&{}\\[\\]()_+\\-=,.~'` ]{1,255}$
-
-# Validation of dates. Controls whether or not 'lenient' dates are accepted.
-# See DataFormat.setLenient(boolean flag) for further details.
-Validator.AcceptLenientDates=false
+#
+# OWASP Enterprise Security API (ESAPI) Properties file -- PRODUCTION Version
+# 
+# This file is part of the Open Web Application Security Project (OWASP)
+# Enterprise Security API (ESAPI) project. For details, please see
+# http://www.owasp.org/index.php/ESAPI.
+#
+# Copyright (c) 2008,2009 - The OWASP Foundation
+#
+# DISCUSS: This may cause a major backwards compatibility issue, etc. but
+#		   from a name space perspective, we probably should have prefaced
+#		   all the property names with ESAPI or at least OWASP. Otherwise
+#		   there could be problems is someone loads this properties file into
+#		   the System properties.  We could also put this file into the
+#		   esapi.jar file (perhaps as a ResourceBundle) and then allow an external
+#		   ESAPI properties be defined that would overwrite these defaults.
+#		   That keeps the application's properties relatively simple as usually
+#		   they will only want to override a few properties. If looks like we
+#		   already support multiple override levels of this in the
+#		   DefaultSecurityConfiguration class, but I'm suggesting placing the
+#		   defaults in the esapi.jar itself. That way, if the jar is signed,
+#		   we could detect if those properties had been tampered with. (The
+#		   code to check the jar signatures is pretty simple... maybe 70-90 LOC,
+#		   but off course there is an execution penalty (similar to the way
+#		   that the separate sunjce.jar used to be when a class from it was
+#		   first loaded). Thoughts?
+###############################################################################
+#
+# WARNING: Operating system protection should be used to lock down the .esapi
+# resources directory and all the files inside and all the directories all the
+# way up to the root directory of the file system.  Note that if you are using
+# file-based implementations, that some files may need to be read-write as they
+# get updated dynamically.
+#
+# Before using, be sure to update the MasterKey and MasterSalt as described below.
+# N.B.: If you had stored data that you have previously encrypted with ESAPI 1.4,
+#		you *must* FIRST decrypt it using ESAPI 1.4 and then (if so desired)
+#		re-encrypt it with ESAPI 2.0. If you fail to do this, you will NOT be
+#		able to decrypt your data with ESAPI 2.0.
+#
+#		YOU HAVE BEEN WARNED!!! More details are in the ESAPI 2.0 Release Notes.
+#
+#===========================================================================
+# ESAPI Configuration
+#
+# If true, then print all the ESAPI properties set here when they are loaded.
+# If false, they are not printed. Useful to reduce output when running JUnit tests.
+# If you need to troubleshoot a properties related problem, turning this on may help.
+# This is 'false' in the src/test/resources/.esapi version. It is 'true' by
+# default for reasons of backward compatibility with earlier ESAPI versions.
+ESAPI.printProperties=true
+
+# ESAPI is designed to be easily extensible. You can use the reference implementation
+# or implement your own providers to take advantage of your enterprise's security
+# infrastructure. The functions in ESAPI are referenced using the ESAPI locator, like:
+#
+#    String ciphertext =
+#		ESAPI.encryptor().encrypt("Secret message");   // Deprecated in 2.0
+#    CipherText cipherText =
+#		ESAPI.encryptor().encrypt(new PlainText("Secret message")); // Preferred
+#
+# Below you can specify the classname for the provider that you wish to use in your
+# application. The only requirement is that it implement the appropriate ESAPI interface.
+# This allows you to switch security implementations in the future without rewriting the
+# entire application.
+#
+# ExperimentalAccessController requires ESAPI-AccessControlPolicy.xml in .esapi directory
+ESAPI.AccessControl=org.owasp.esapi.reference.DefaultAccessController
+# FileBasedAuthenticator requires users.txt file in .esapi directory
+ESAPI.Authenticator=org.owasp.esapi.reference.FileBasedAuthenticator
+ESAPI.Encoder=org.owasp.esapi.reference.DefaultEncoder
+ESAPI.Encryptor=org.owasp.esapi.reference.crypto.JavaEncryptor
+
+ESAPI.Executor=org.owasp.esapi.reference.DefaultExecutor
+ESAPI.HTTPUtilities=org.owasp.esapi.reference.DefaultHTTPUtilities
+ESAPI.IntrusionDetector=org.owasp.esapi.reference.DefaultIntrusionDetector
+# Log4JFactory Requires log4j.xml or log4j.properties in classpath - http://www.laliluna.de/log4j-tutorial.html
+ESAPI.Logger=org.owasp.esapi.reference.Log4JLogFactory
+#ESAPI.Logger=org.owasp.esapi.reference.JavaLogFactory
+ESAPI.Randomizer=org.owasp.esapi.reference.DefaultRandomizer
+ESAPI.Validator=org.owasp.esapi.reference.DefaultValidator
+
+#===========================================================================
+# ESAPI Authenticator
+#
+Authenticator.AllowedLoginAttempts=3
+Authenticator.MaxOldPasswordHashes=13
+Authenticator.UsernameParameterName=username
+Authenticator.PasswordParameterName=password
+# RememberTokenDuration (in days)
+Authenticator.RememberTokenDuration=14
+# Session Timeouts (in minutes)
+Authenticator.IdleTimeoutDuration=20
+Authenticator.AbsoluteTimeoutDuration=120
+
+#===========================================================================
+# ESAPI Encoder
+#
+# ESAPI canonicalizes input before validation to prevent bypassing filters with encoded attacks.
+# Failure to canonicalize input is a very common mistake when implementing validation schemes.
+# Canonicalization is automatic when using the ESAPI Validator, but you can also use the
+# following code to canonicalize data.
+#
+#      ESAPI.Encoder().canonicalize( "%22hello world"" );
+#  
+# Multiple encoding is when a single encoding format is applied multiple times. Allowing
+# multiple encoding is strongly discouraged.
+Encoder.AllowMultipleEncoding=false
+
+# Mixed encoding is when multiple different encoding formats are applied, or when 
+# multiple formats are nested. Allowing multiple encoding is strongly discouraged.
+Encoder.AllowMixedEncoding=false
+
+# The default list of codecs to apply when canonicalizing untrusted data. The list should include the codecs
+# for all downstream interpreters or decoders. For example, if the data is likely to end up in a URL, HTML, or
+# inside JavaScript, then the list of codecs below is appropriate. The order of the list is not terribly important.
+Encoder.DefaultCodecList=HTMLEntityCodec,PercentCodec,JavaScriptCodec
+
+
+#===========================================================================
+# ESAPI Encryption
+#
+# The ESAPI Encryptor provides basic cryptographic functions with a simplified API.
+# To get started, generate a new key using java -classpath esapi.jar org.owasp.esapi.reference.crypto.JavaEncryptor
+# There is not currently any support for key rotation, so be careful when changing your key and salt as it
+# will invalidate all signed, encrypted, and hashed data.
+#
+# WARNING: Not all combinations of algorithms and key lengths are supported.
+# If you choose to use a key length greater than 128, you MUST download the
+# unlimited strength policy files and install in the lib directory of your JRE/JDK.
+# See http://java.sun.com/javase/downloads/index.jsp for more information.
+#
+# Backward compatibility with ESAPI Java 1.4 is supported by the two deprecated API
+# methods, Encryptor.encrypt(String) and Encryptor.decrypt(String). However, whenever
+# possible, these methods should be avoided as they use ECB cipher mode, which in almost
+# all circumstances a poor choice because of it's weakness. CBC cipher mode is the default
+# for the new Encryptor encrypt / decrypt methods for ESAPI Java 2.0.  In general, you
+# should only use this compatibility setting if you have persistent data encrypted with
+# version 1.4 and even then, you should ONLY set this compatibility mode UNTIL
+# you have decrypted all of your old encrypted data and then re-encrypted it with
+# ESAPI 2.0 using CBC mode. If you have some reason to mix the deprecated 1.4 mode
+# with the new 2.0 methods, make sure that you use the same cipher algorithm for both
+# (256-bit AES was the default for 1.4; 128-bit is the default for 2.0; see below for
+# more details.) Otherwise, you will have to use the new 2.0 encrypt / decrypt methods
+# where you can specify a SecretKey. (Note that if you are using the 256-bit AES,
+# that requires downloading the special jurisdiction policy files mentioned above.)
+#
+#		***** IMPORTANT: Do NOT forget to replace these with your own values! *****
+# To calculate these values, you can run:
+#		java -classpath esapi.jar org.owasp.esapi.reference.crypto.JavaEncryptor
+#
+#Encryptor.MasterKey=
+#Encryptor.MasterSalt=
+
+# Provides the default JCE provider that ESAPI will "prefer" for its symmetric
+# encryption and hashing. (That is it will look to this provider first, but it
+# will defer to other providers if the requested algorithm is not implemented
+# by this provider.) If left unset, ESAPI will just use your Java VM's current
+# preferred JCE provider, which is generally set in the file
+# "$JAVA_HOME/jre/lib/security/java.security".
+#
+# The main intent of this is to allow ESAPI symmetric encryption to be
+# used with a FIPS 140-2 compliant crypto-module. For details, see the section
+# "Using ESAPI Symmetric Encryption with FIPS 140-2 Cryptographic Modules" in
+# the ESAPI 2.0 Symmetric Encryption User Guide, at:
+# http://owasp-esapi-java.googlecode.com/svn/trunk/documentation/esapi4java-core-2.0-symmetric-crypto-user-guide.html
+# However, this property also allows you to easily use an alternate JCE provider
+# such as "Bouncy Castle" without having to make changes to "java.security".
+# See Javadoc for SecurityProviderLoader for further details. If you wish to use
+# a provider that is not known to SecurityProviderLoader, you may specify the
+# fully-qualified class name of the JCE provider class that implements
+# java.security.Provider. If the name contains a '.', this is interpreted as
+# a fully-qualified class name that implements java.security.Provider.
+#
+# NOTE: Setting this property has the side-effect of changing it in your application
+#       as well, so if you are using JCE in your application directly rather than
+#       through ESAPI (you wouldn't do that, would you? ;-), it will change the
+#       preferred JCE provider there as well.
+#
+# Default: Keeps the JCE provider set to whatever JVM sets it to.
+Encryptor.PreferredJCEProvider=
+
+# AES is the most widely used and strongest encryption algorithm. This
+# should agree with your Encryptor.CipherTransformation property.
+# By default, ESAPI Java 1.4 uses "PBEWithMD5AndDES" and which is
+# very weak. It is essentially a password-based encryption key, hashed
+# with MD5 around 1K times and then encrypted with the weak DES algorithm
+# (56-bits) using ECB mode and an unspecified padding (it is
+# JCE provider specific, but most likely "NoPadding"). However, 2.0 uses
+# "AES/CBC/PKCSPadding". If you want to change these, change them here.
+# Warning: This property does not control the default reference implementation for
+#		   ESAPI 2.0 using JavaEncryptor. Also, this property will be dropped
+#		   in the future.
+# @deprecated
+Encryptor.EncryptionAlgorithm=AES
+#		For ESAPI Java 2.0 - New encrypt / decrypt methods use this.
+Encryptor.CipherTransformation=AES/CBC/PKCS5Padding
+
+# Applies to ESAPI 2.0 and later only!
+# Comma-separated list of cipher modes that provide *BOTH*
+# confidentiality *AND* message authenticity. (NIST refers to such cipher
+# modes as "combined modes" so that's what we shall call them.) If any of these
+# cipher modes are used then no MAC is calculated and stored
+# in the CipherText upon encryption. Likewise, if one of these
+# cipher modes is used with decryption, no attempt will be made
+# to validate the MAC contained in the CipherText object regardless
+# of whether it contains one or not. Since the expectation is that
+# these cipher modes support support message authenticity already,
+# injecting a MAC in the CipherText object would be at best redundant.
+#
+# Note that as of JDK 1.5, the SunJCE provider does not support *any*
+# of these cipher modes. Of these listed, only GCM and CCM are currently
+# NIST approved. YMMV for other JCE providers. E.g., Bouncy Castle supports
+# GCM and CCM with "NoPadding" mode, but not with "PKCS5Padding" or other
+# padding modes.
+Encryptor.cipher_modes.combined_modes=GCM,CCM,IAPM,EAX,OCB,CWC
+
+# Applies to ESAPI 2.0 and later only!
+# Additional cipher modes allowed for ESAPI 2.0 encryption. These
+# cipher modes are in _addition_ to those specified by the property
+# 'Encryptor.cipher_modes.combined_modes'.
+# Note: We will add support for streaming modes like CFB & OFB once
+# we add support for 'specified' to the property 'Encryptor.ChooseIVMethod'
+# (probably in ESAPI 2.1).
+# DISCUSS: Better name?
+Encryptor.cipher_modes.additional_allowed=CBC
+
+# 128-bit is almost always sufficient and appears to be more resistant to
+# related key attacks than is 256-bit AES. Use '_' to use default key size
+# for cipher algorithms (where it makes sense because the algorithm supports
+# a variable key size). Key length must agree to what's provided as the
+# cipher transformation, otherwise this will be ignored after logging a
+# warning.
+#
+# NOTE: This is what applies BOTH ESAPI 1.4 and 2.0. See warning above about mixing!
+Encryptor.EncryptionKeyLength=128
+
+# Because 2.0 uses CBC mode by default, it requires an initialization vector (IV).
+# (All cipher modes except ECB require an IV.) There are two choices: we can either
+# use a fixed IV known to both parties or allow ESAPI to choose a random IV. While
+# the IV does not need to be hidden from adversaries, it is important that the
+# adversary not be allowed to choose it. Also, random IVs are generally much more
+# secure than fixed IVs. (In fact, it is essential that feed-back cipher modes
+# such as CFB and OFB use a different IV for each encryption with a given key so
+# in such cases, random IVs are much preferred. By default, ESAPI 2.0 uses random
+# IVs. If you wish to use 'fixed' IVs, set 'Encryptor.ChooseIVMethod=fixed' and
+# uncomment the Encryptor.fixedIV.
+#
+# Valid values:		random|fixed|specified		'specified' not yet implemented; planned for 2.1
+Encryptor.ChooseIVMethod=random
+# If you choose to use a fixed IV, then you must place a fixed IV here that
+# is known to all others who are sharing your secret key. The format should
+# be a hex string that is the same length as the cipher block size for the
+# cipher algorithm that you are using. The following is an *example* for AES
+# from an AES test vector for AES-128/CBC as described in:
+# NIST Special Publication 800-38A (2001 Edition)
+# "Recommendation for Block Cipher Modes of Operation".
+# (Note that the block size for AES is 16 bytes == 128 bits.)
+#
+Encryptor.fixedIV=0x000102030405060708090a0b0c0d0e0f
+
+# Whether or not CipherText should use a message authentication code (MAC) with it.
+# This prevents an adversary from altering the IV as well as allowing a more
+# fool-proof way of determining the decryption failed because of an incorrect
+# key being supplied. This refers to the "separate" MAC calculated and stored
+# in CipherText, not part of any MAC that is calculated as a result of a
+# "combined mode" cipher mode.
+#
+# If you are using ESAPI with a FIPS 140-2 cryptographic module, you *must* also
+# set this property to false.
+Encryptor.CipherText.useMAC=true
+
+# Whether or not the PlainText object may be overwritten and then marked
+# eligible for garbage collection. If not set, this is still treated as 'true'.
+Encryptor.PlainText.overwrite=true
+
+# Do not use DES except in a legacy situations. 56-bit is way too small key size.
+#Encryptor.EncryptionKeyLength=56
+#Encryptor.EncryptionAlgorithm=DES
+
+# TripleDES is considered strong enough for most purposes.
+#	Note:	There is also a 112-bit version of DESede. Using the 168-bit version
+#			requires downloading the special jurisdiction policy from Sun.
+#Encryptor.EncryptionKeyLength=168
+#Encryptor.EncryptionAlgorithm=DESede
+
+Encryptor.HashAlgorithm=SHA-512
+Encryptor.HashIterations=1024
+Encryptor.DigitalSignatureAlgorithm=SHA1withDSA
+Encryptor.DigitalSignatureKeyLength=1024
+Encryptor.RandomAlgorithm=SHA1PRNG
+Encryptor.CharacterEncoding=UTF-8
+
+# This is the Pseudo Random Function (PRF) that ESAPI's Key Derivation Function
+# (KDF) normally uses. Note this is *only* the PRF used for ESAPI's KDF and
+# *not* what is used for ESAPI's MAC. (Currently, HmacSHA1 is always used for
+# the MAC, mostly to keep the overall size at a minimum.)
+#
+# Currently supported choices for JDK 1.5 and 1.6 are:
+#	HmacSHA1 (160 bits), HmacSHA256 (256 bits), HmacSHA384 (384 bits), and
+#	HmacSHA512 (512 bits).
+# Note that HmacMD5 is *not* supported for the PRF used by the KDF even though
+# the JDKs support it.  See the ESAPI 2.0 Symmetric Encryption User Guide
+# further details.
+Encryptor.KDF.PRF=HmacSHA256
+#===========================================================================
+# ESAPI HttpUtilties
+#
+# The HttpUtilities provide basic protections to HTTP requests and responses. Primarily these methods 
+# protect against malicious data from attackers, such as unprintable characters, escaped characters,
+# and other simple attacks. The HttpUtilities also provides utility methods for dealing with cookies,
+# headers, and CSRF tokens.
+#
+# Default file upload location (remember to escape backslashes with \\)
+HttpUtilities.UploadDir=C:\\ESAPI\\testUpload
+HttpUtilities.UploadTempDir=C:\\temp
+# Force flags on cookies, if you use HttpUtilities to set cookies
+HttpUtilities.ForceHttpOnlySession=false
+HttpUtilities.ForceSecureSession=false
+HttpUtilities.ForceHttpOnlyCookies=true
+HttpUtilities.ForceSecureCookies=true
+# Maximum size of HTTP headers
+HttpUtilities.MaxHeaderSize=4096
+# File upload configuration
+HttpUtilities.ApprovedUploadExtensions=.zip,.pdf,.doc,.docx,.ppt,.pptx,.tar,.gz,.tgz,.rar,.war,.jar,.ear,.xls,.rtf,.properties,.java,.class,.txt,.xml,.jsp,.jsf,.exe,.dll
+HttpUtilities.MaxUploadFileBytes=500000000
+# Using UTF-8 throughout your stack is highly recommended. That includes your database driver,
+# container, and any other technologies you may be using. Failure to do this may expose you
+# to Unicode transcoding injection attacks. Use of UTF-8 does not hinder internationalization.
+HttpUtilities.ResponseContentType=text/html; charset=UTF-8
+# This is the name of the cookie used to represent the HTTP session
+# Typically this will be the default "JSESSIONID" 
+HttpUtilities.HttpSessionIdName=JSESSIONID
+
+
+
+#===========================================================================
+# ESAPI Executor
+# CHECKME - This should be made OS independent. Don't use unsafe defaults.
+# # Examples only -- do NOT blindly copy!
+#   For Windows:
+#     Executor.WorkingDirectory=C:\\Windows\\Temp
+#     Executor.ApprovedExecutables=C:\\Windows\\System32\\cmd.exe,C:\\Windows\\System32\\runas.exe
+#   For *nux, MacOS:
+#     Executor.WorkingDirectory=/tmp
+#     Executor.ApprovedExecutables=/bin/bash
+Executor.WorkingDirectory=
+Executor.ApprovedExecutables=
+
+
+#===========================================================================
+# ESAPI Logging
+# Set the application name if these logs are combined with other applications
+Logger.ApplicationName=ExampleApplication
+# If you use an HTML log viewer that does not properly HTML escape log data, you can set LogEncodingRequired to true
+Logger.LogEncodingRequired=false
+# Determines whether ESAPI should log the application name. This might be clutter in some single-server/single-app environments.
+Logger.LogApplicationName=true
+# Determines whether ESAPI should log the server IP and port. This might be clutter in some single-server environments.
+Logger.LogServerIP=true
+# LogFileName, the name of the logging file. Provide a full directory path (e.g., C:\\ESAPI\\ESAPI_logging_file) if you
+# want to place it in a specific directory.
+Logger.LogFileName=ESAPI_logging_file
+# MaxLogFileSize, the max size (in bytes) of a single log file before it cuts over to a new one (default is 10,000,000)
+Logger.MaxLogFileSize=10000000
+
+
+#===========================================================================
+# ESAPI Intrusion Detection
+#
+# Each event has a base to which .count, .interval, and .action are added
+# The IntrusionException will fire if we receive "count" events within "interval" seconds
+# The IntrusionDetector is configurable to take the following actions: log, logout, and disable
+#  (multiple actions separated by commas are allowed e.g. event.test.actions=log,disable
+#
+# Custom Events
+# Names must start with "event." as the base
+# Use IntrusionDetector.addEvent( "test" ) in your code to trigger "event.test" here
+# You can also disable intrusion detection completely by changing
+# the following parameter to true
+#
+IntrusionDetector.Disable=false
+#
+IntrusionDetector.event.test.count=2
+IntrusionDetector.event.test.interval=10
+IntrusionDetector.event.test.actions=disable,log
+
+# Exception Events
+# All EnterpriseSecurityExceptions are registered automatically
+# Call IntrusionDetector.getInstance().addException(e) for Exceptions that do not extend EnterpriseSecurityException
+# Use the fully qualified classname of the exception as the base
+
+# any intrusion is an attack
+IntrusionDetector.org.owasp.esapi.errors.IntrusionException.count=1
+IntrusionDetector.org.owasp.esapi.errors.IntrusionException.interval=1
+IntrusionDetector.org.owasp.esapi.errors.IntrusionException.actions=log,disable,logout
+
+# for test purposes
+# CHECKME: Shouldn't there be something in the property name itself that designates
+#		   that these are for testing???
+IntrusionDetector.org.owasp.esapi.errors.IntegrityException.count=10
+IntrusionDetector.org.owasp.esapi.errors.IntegrityException.interval=5
+IntrusionDetector.org.owasp.esapi.errors.IntegrityException.actions=log,disable,logout
+
+# rapid validation errors indicate scans or attacks in progress
+# org.owasp.esapi.errors.ValidationException.count=10
+# org.owasp.esapi.errors.ValidationException.interval=10
+# org.owasp.esapi.errors.ValidationException.actions=log,logout
+
+# sessions jumping between hosts indicates session hijacking
+IntrusionDetector.org.owasp.esapi.errors.AuthenticationHostException.count=2
+IntrusionDetector.org.owasp.esapi.errors.AuthenticationHostException.interval=10
+IntrusionDetector.org.owasp.esapi.errors.AuthenticationHostException.actions=log,logout
+
+
+#===========================================================================
+# ESAPI Validation
+#
+# The ESAPI Validator works on regular expressions with defined names. You can define names
+# either here, or you may define application specific patterns in a separate file defined below.
+# This allows enterprises to specify both organizational standards as well as application specific
+# validation rules.
+#
+# Use '\p{L}' (without the quotes) within the character class to match
+# any Unicode LETTER. You can also use a range, like:  \u00C0-\u017F
+# You can also use any of the regex flags as documented at
+# https://docs.oracle.com/javase/tutorial/essential/regex/pattern.html, e.g. (?u)
+#
+Validator.ConfigurationFile=validation.properties
+
+# Validators used by ESAPI
+Validator.AccountName=^[a-zA-Z0-9]{3,20}$
+Validator.SystemCommand=^[a-zA-Z\\-\\/]{1,64}$
+Validator.RoleName=^[a-z]{1,20}$
+
+#the word TEST below should be changed to your application 
+#name - only relative URL's are supported
+Validator.Redirect=^\\/test.*$
+
+# Global HTTP Validation Rules
+# Values with Base64 encoded data (e.g. encrypted state) will need at least [a-zA-Z0-9\/+=]
+Validator.HTTPScheme=^(http|https)$
+Validator.HTTPServerName=^[a-zA-Z0-9_.\\-]*$
+Validator.HTTPParameterName=^[a-zA-Z0-9_]{1,32}$
+Validator.HTTPParameterValue=^[a-zA-Z0-9.\\-\\/+=@_ ]*$
+Validator.HTTPCookieName=^[a-zA-Z0-9\\-_]{1,32}$
+Validator.HTTPCookieValue=^[a-zA-Z0-9\\-\\/+=_ ]*$
+# Note that max header name capped at 150 in SecurityRequestWrapper!
+Validator.HTTPHeaderName=^[a-zA-Z0-9\\-_]{1,50}$
+Validator.HTTPHeaderValue=^[a-zA-Z0-9()\\-=\\*\\.\\?;,+\\/:&_ ]*$
+Validator.HTTPContextPath=^\\/?[a-zA-Z0-9.\\-\\/_]*$
+Validator.HTTPServletPath=^[a-zA-Z0-9.\\-\\/_]*$
+Validator.HTTPPath=^[a-zA-Z0-9.\\-_]*$
+Validator.HTTPQueryString=^[a-zA-Z0-9()\\-=\\*\\.\\?;,+\\/:&_ %]*$
+Validator.HTTPURI=^[a-zA-Z0-9()\\-=\\*\\.\\?;,+\\/:&_ ]*$
+Validator.HTTPURL=^.*$
+Validator.HTTPJSESSIONID=^[A-Z0-9]{10,30}$
+
+# Validation of file related input
+Validator.FileName=^[a-zA-Z0-9!@#$%^&{}\\[\\]()_+\\-=,.~'` ]{1,255}$
+Validator.DirectoryName=^[a-zA-Z0-9:/\\\\!@#$%^&{}\\[\\]()_+\\-=,.~'` ]{1,255}$
+
+# Validation of dates. Controls whether or not 'lenient' dates are accepted.
+# See DataFormat.setLenient(boolean flag) for further details.
+Validator.AcceptLenientDates=false

From 2812549f07865efcce7ab741742291d8190d8e33 Mon Sep 17 00:00:00 2001
From: kwwall 
Date: Tue, 19 Jan 2016 01:12:42 -0500
Subject: [PATCH 315/812] Address issue 356.

---
 configuration/esapi/validation.properties | 58 +++++++++++------------
 1 file changed, 29 insertions(+), 29 deletions(-)

diff --git a/configuration/esapi/validation.properties b/configuration/esapi/validation.properties
index 18e037f3b..433fa0b6b 100644
--- a/configuration/esapi/validation.properties
+++ b/configuration/esapi/validation.properties
@@ -1,29 +1,29 @@
-# The ESAPI validator does many security checks on input, such as canonicalization
-# and whitelist validation. Note that all of these validation rules are applied *after*
-# canonicalization. Double-encoded characters (even with different encodings involved,
-# are never allowed.
-#
-# To use:
-#
-# First set up a pattern below. You can choose any name you want, prefixed by the word
-# "Validation." For example:
-#   Validation.Email=^[A-Za-z0-9._%-]+@[A-Za-z0-9.-]+\\.[a-zA-Z]{2,4}$
-# 
-# Then you can validate in your code against the pattern like this:
-#     ESAPI.validator().isValidInput("User Email", input, "Email", maxLength, allowNull);
-# Where maxLength and allowNull are set for you needs, respectively.
-#
-# But note, when you use boolean variants of validation functions, you lose critical 
-# canonicalization. It is preferable to use the "get" methods (which throw exceptions) and 
-# and use the returned user input which is in canonical form. Consider the following:
-#  
-# try {
-#    someObject.setEmail(ESAPI.validator().getValidInput("User Email", input, "Email", maxLength, allowNull));
-#
-Validator.SafeString=^[.\\p{Alnum}\\p{Space}]{0,1024}$
-Validator.Email=^[A-Za-z0-9._%'-]+@[A-Za-z0-9.-]+\\.[a-zA-Z]{2,4}$
-Validator.IPAddress=^(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$
-Validator.URL=^(ht|f)tp(s?)\\:\\/\\/[0-9a-zA-Z]([-.\\w]*[0-9a-zA-Z])*(:(0-9)*)*(\\/?)([a-zA-Z0-9\\-\\.\\?\\,\\:\\'\\/\\\\\\+=&%\\$#_]*)?$
-Validator.CreditCard=^(\\d{4}[- ]?){3}\\d{4}$
-Validator.SSN=^(?!000)([0-6]\\d{2}|7([0-6]\\d|7[012]))([ -]?)(?!00)\\d\\d\\3(?!0000)\\d{4}$
-
+# The ESAPI validator does many security checks on input, such as canonicalization
+# and whitelist validation. Note that all of these validation rules are applied *after*
+# canonicalization. Double-encoded characters (even with different encodings involved,
+# are never allowed.
+#
+# To use:
+#
+# First set up a pattern below. You can choose any name you want, prefixed by the word
+# "Validation." For example:
+#   Validation.Email=^[A-Za-z0-9._%-]+@[A-Za-z0-9.-]+\\.[a-zA-Z]{2,4}$
+# 
+# Then you can validate in your code against the pattern like this:
+#     ESAPI.validator().isValidInput("User Email", input, "Email", maxLength, allowNull);
+# Where maxLength and allowNull are set for you needs, respectively.
+#
+# But note, when you use boolean variants of validation functions, you lose critical 
+# canonicalization. It is preferable to use the "get" methods (which throw exceptions) and 
+# and use the returned user input which is in canonical form. Consider the following:
+#  
+# try {
+#    someObject.setEmail(ESAPI.validator().getValidInput("User Email", input, "Email", maxLength, allowNull));
+#
+Validator.SafeString=^[.\\p{Alnum}\\p{Space}]{0,1024}$
+Validator.Email=^[A-Za-z0-9._%'-]+@[A-Za-z0-9.-]+\\.[a-zA-Z]{2,4}$
+Validator.IPAddress=^(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$
+Validator.URL=^(ht|f)tp(s?)\\:\\/\\/[0-9a-zA-Z]([-.\\w]*[0-9a-zA-Z])*(:(0-9)*)*(\\/?)([a-zA-Z0-9\\-\\.\\?\\,\\:\\'\\/\\\\\\+=&%\\$#_]*)?$
+Validator.CreditCard=^(\\d{4}[- ]?){3}\\d{4}$
+Validator.SSN=^(?!000)([0-6]\\d{2}|7([0-6]\\d|7[012]))([ -]?)(?!00)\\d\\d\\3(?!0000)\\d{4}$
+

From 53505707a49fad41ec3ff5b74fbf390741bed248 Mon Sep 17 00:00:00 2001
From: kwwall 
Date: Tue, 19 Jan 2016 01:12:42 -0500
Subject: [PATCH 316/812] Address issue 356.

---
 .../properties/ESAPI_en_US.properties          | 18 +++++++++---------
 1 file changed, 9 insertions(+), 9 deletions(-)

diff --git a/configuration/properties/ESAPI_en_US.properties b/configuration/properties/ESAPI_en_US.properties
index 9b43d1a23..04f043b21 100644
--- a/configuration/properties/ESAPI_en_US.properties
+++ b/configuration/properties/ESAPI_en_US.properties
@@ -1,9 +1,9 @@
-# User Messages
-Error.creating.randomizer=Error creating randomizer
-
-This.is.test.message=This {0} is {1} a test {2} message
-
-# Validation Messages
-
-# Log Messages
-
+# User Messages
+Error.creating.randomizer=Error creating randomizer
+
+This.is.test.message=This {0} is {1} a test {2} message
+
+# Validation Messages
+
+# Log Messages
+

From 71ba3946427c154fa66d92e20ccaed042615cfea Mon Sep 17 00:00:00 2001
From: kwwall 
Date: Tue, 19 Jan 2016 01:12:42 -0500
Subject: [PATCH 317/812] Address issue 356.

---
 .../properties/ESAPI_fr_FR.properties          | 18 +++++++++---------
 1 file changed, 9 insertions(+), 9 deletions(-)

diff --git a/configuration/properties/ESAPI_fr_FR.properties b/configuration/properties/ESAPI_fr_FR.properties
index 89ebcba7d..3e5a7a8f5 100644
--- a/configuration/properties/ESAPI_fr_FR.properties
+++ b/configuration/properties/ESAPI_fr_FR.properties
@@ -1,9 +1,9 @@
-# User Messages
-Error.creating.randomizer=Erreur lors de la cration alatoire
-
-This.is.test.message=Ceci est un message de test message singh
-
-# Validation Messages
-
-# Log Messages
-
+# User Messages
+Error.creating.randomizer=Erreur lors de la cration alatoire
+
+This.is.test.message=Ceci est un message de test message singh
+
+# Validation Messages
+
+# Log Messages
+

From b6a746b8589326aed5ef7208322f27a352c97869 Mon Sep 17 00:00:00 2001
From: kwwall 
Date: Tue, 19 Jan 2016 01:12:42 -0500
Subject: [PATCH 318/812] Address issue 356.

---
 ...ESAPI-CommaValidatorFileChecker.properties | 930 +++++++++---------
 1 file changed, 465 insertions(+), 465 deletions(-)

diff --git a/src/test/resources/esapi/ESAPI-CommaValidatorFileChecker.properties b/src/test/resources/esapi/ESAPI-CommaValidatorFileChecker.properties
index 837d5a9d3..f120f748d 100644
--- a/src/test/resources/esapi/ESAPI-CommaValidatorFileChecker.properties
+++ b/src/test/resources/esapi/ESAPI-CommaValidatorFileChecker.properties
@@ -1,466 +1,466 @@
-#
-# OWASP Enterprise Security API (ESAPI) Properties file -- TEST Version
-# 
-# This file is part of the Open Web Application Security Project (OWASP)
-# Enterprise Security API (ESAPI) project. For details, please see
-# http://www.owasp.org/index.php/ESAPI.
-#
-# Copyright (c) 2008,2009 - The OWASP Foundation
-#
-# DISCUSS: This may cause a major backwards compatibility issue, etc. but
-#		   from a name space perspective, we probably should have prefaced
-#		   all the property names with ESAPI or at least OWASP. Otherwise
-#		   there could be problems is someone loads this properties file into
-#		   the System properties.  We could also put this file into the
-#		   esapi.jar file (perhaps as a ResourceBundle) and then allow an external
-#		   ESAPI properties be defined that would overwrite these defaults.
-#		   That keeps the application's properties relatively simple as usually
-#		   they will only want to override a few properties. If looks like we
-#		   already support multiple override levels of this in the
-#		   DefaultSecurityConfiguration class, but I'm suggesting placing the
-#		   defaults in the esapi.jar itself. That way, if the jar is signed,
-#		   we could detect if those properties had been tampered with. (The
-#		   code to check the jar signatures is pretty simple... maybe 70-90 LOC,
-#		   but off course there is an execution penalty (similar to the way
-#		   that the separate sunjce.jar used to be when a class from it was
-#		   first loaded). Thoughts?
-###############################################################################
-#
-# WARNING: Operating system protection should be used to lock down the .esapi
-# resources directory and all the files inside and all the directories all the
-# way up to the root directory of the file system.  Note that if you are using
-# file-based implementations, that some files may need to be read-write as they
-# get updated dynamically.
-#
-# Before using, be sure to update the MasterKey and MasterSalt as described below.
-# N.B.: If you had stored data that you have previously encrypted with ESAPI 1.4,
-#		you *must* FIRST decrypt it using ESAPI 1.4 and then (if so desired)
-#		re-encrypt it with ESAPI 2.0. If you fail to do this, you will NOT be
-#		able to decrypt your data with ESAPI 2.0.
-#
-#		YOU HAVE BEEN WARNED!!! More details are in the ESAPI 2.0 Release Notes.
-#
-#===========================================================================
-# ESAPI Configuration
-#
-# If true, then print all the ESAPI properties set here when they are loaded.
-# If false, they are not printed. Useful to reduce output when running JUnit tests.
-# If you need to troubleshoot a properties related problem, turning this on may help,
-# but we leave it off for running JUnit tests. (It will be 'true' in the one delivered
-# as part of production ESAPI, mostly for backward compatibility.)
-ESAPI.printProperties=false
-
-# ESAPI is designed to be easily extensible. You can use the reference implementation
-# or implement your own providers to take advantage of your enterprise's security
-# infrastructure. The functions in ESAPI are referenced using the ESAPI locator, like:
-#
-#    String ciphertext =
-#		ESAPI.encryptor().encrypt("Secret message");   // Deprecated in 2.0
-#    CipherText cipherText =
-#		ESAPI.encryptor().encrypt(new PlainText("Secret message")); // Preferred
-#
-# Below you can specify the classname for the provider that you wish to use in your
-# application. The only requirement is that it implement the appropriate ESAPI interface.
-# This allows you to switch security implementations in the future without rewriting the
-# entire application.
-#
-# ExperimentalAccessController requires ESAPI-AccessControlPolicy.xml in .esapi directory
-ESAPI.AccessControl=org.owasp.esapi.reference.DefaultAccessController
-# FileBasedAuthenticator requires users.txt file in .esapi directory
-ESAPI.Authenticator=org.owasp.esapi.reference.FileBasedAuthenticator
-ESAPI.Encoder=org.owasp.esapi.reference.DefaultEncoder
-ESAPI.Encryptor=org.owasp.esapi.reference.crypto.JavaEncryptor
-
-ESAPI.Executor=org.owasp.esapi.reference.DefaultExecutor
-ESAPI.HTTPUtilities=org.owasp.esapi.reference.DefaultHTTPUtilities
-ESAPI.IntrusionDetector=org.owasp.esapi.reference.DefaultIntrusionDetector
-# Log4JFactory Requires log4j.xml or log4j.properties in classpath - http://www.laliluna.de/log4j-tutorial.html
-ESAPI.Logger=org.owasp.esapi.reference.Log4JLogFactory
-#ESAPI.Logger=org.owasp.esapi.reference.JavaLogFactory
-#ESAPI.Logger=org.owasp.esapi.reference.ExampleExtendedLog4JLogFactory
-ESAPI.Randomizer=org.owasp.esapi.reference.DefaultRandomizer
-ESAPI.Validator=org.owasp.esapi.reference.DefaultValidator
-
-#===========================================================================
-# ESAPI Authenticator
-#
-Authenticator.AllowedLoginAttempts=3
-Authenticator.MaxOldPasswordHashes=13
-Authenticator.UsernameParameterName=username
-Authenticator.PasswordParameterName=password
-# RememberTokenDuration (in days)
-Authenticator.RememberTokenDuration=14
-# Session Timeouts (in minutes)
-Authenticator.IdleTimeoutDuration=20
-Authenticator.AbsoluteTimeoutDuration=120
-
-#===========================================================================
-# ESAPI Encoder
-#
-# ESAPI canonicalizes input before validation to prevent bypassing filters with encoded attacks.
-# Failure to canonicalize input is a very common mistake when implementing validation schemes.
-# Canonicalization is automatic when using the ESAPI Validator, but you can also use the
-# following code to canonicalize data.
-#
-#      ESAPI.Encoder().canonicalize( "%22hello world"" );
-#  
-# Multiple encoding is when a single encoding format is applied multiple times. Allowing
-# multiple encoding is strongly discouraged.
-Encoder.AllowMultipleEncoding=false
-
-# Mixed encoding is when multiple different encoding formats are applied, or when
-# multiple formats are nested. Allowing multiple encoding is strongly discouraged.
-Encoder.AllowMixedEncoding=false
-
-# The default list of codecs to apply when canonicalizing untrusted data. The list should include the codecs
-# for all downstream interpreters or decoders. For example, if the data is likely to end up in a URL, HTML, or
-# inside JavaScript, then the list of codecs below is appropriate. The order of the list is not terribly important.
-Encoder.DefaultCodecList=HTMLEntityCodec,PercentCodec,JavaScriptCodec
-
-
-#===========================================================================
-# ESAPI Encryption
-#
-# The ESAPI Encryptor provides basic cryptographic functions with a simplified API.
-# To get started, generate a new key using java -classpath esapi.jar org.owasp.esapi.reference.crypto.JavaEncryptor
-# There is not currently any support for key rotation, so be careful when changing your key and salt as it
-# will invalidate all signed, encrypted, and hashed data.
-#
-# WARNING: Not all combinations of algorithms and key lengths are supported.
-# If you choose to use a key length greater than 128, you MUST download the
-# unlimited strength policy files and install in the lib directory of your JRE/JDK.
-# See http://java.sun.com/javase/downloads/index.jsp for more information.
-#
-# Backward compatibility with ESAPI Java 1.4 is supported by the two deprecated API
-# methods, Encryptor.encrypt(String) and Encryptor.decrypt(String). However, whenever
-# possible, these methods should be avoided as they use ECB cipher mode, which in almost
-# all circumstances a poor choice because of it's weakness. CBC cipher mode is the default
-# for the new Encryptor encrypt / decrypt methods for ESAPI Java 2.0.  In general, you
-# should only use this compatibility setting if you have persistent data encrypted with
-# version 1.4 and even then, you should ONLY set this compatibility mode UNTIL
-# you have decrypted all of your old encrypted data and then re-encrypted it with
-# ESAPI 2.0 using CBC mode. If you have some reason to mix the deprecated 1.4 mode
-# with the new 2.0 methods, make sure that you use the same cipher algorithm for both
-# (256-bit AES was the default for 1.4; 128-bit is the default for 2.0; see below for
-# more details.) Otherwise, you will have to use the new 2.0 encrypt / decrypt methods
-# where you can specify a SecretKey. (Note that if you are using the 256-bit AES,
-# that requires downloading the special jurisdiction policy files mentioned above.)
-#
-#		***** IMPORTANT: These are for JUnit testing. Test files may have been
-#						 encrypted using these values so do not change these or
-#						 those tests will fail. The version under
-#							src/main/resources/.esapi/ESAPI.properties
-#						 will be delivered with Encryptor.MasterKey and
-#						 Encryptor.MasterSalt set to the empty string.
-#
-#						 FINAL NOTE:
-#                           If Maven changes these when run, that needs to be fixed.
-#       256-bit key... requires unlimited strength jurisdiction policy files
-### Encryptor.MasterKey=pJhlri8JbuFYDgkqtHmm9s0Ziug2PE7ovZDyEPm4j14=
-#       128-bit key
-Encryptor.MasterKey=a6H9is3hEVGKB4Jut+lOVA==
-Encryptor.MasterSalt=SbftnvmEWD5ZHHP+pX3fqugNysc=
-# Encryptor.MasterSalt=
-
-# Provides the default JCE provider that ESAPI will "prefer" for its symmetric
-# encryption and hashing. (That is it will look to this provider first, but it
-# will defer to other providers if the requested algorithm is not implemented
-# by this provider.) If left unset, ESAPI will just use your Java VM's current
-# preferred JCE provider, which is generally set in the file
-# "$JAVA_HOME/jre/lib/security/java.security".
-#
-# The main intent of this is to allow ESAPI symmetric encryption to be
-# used with a FIPS 140-2 compliant crypto-module. For details, see the section
-# "Using ESAPI Symmetric Encryption with FIPS 140-2 Cryptographic Modules" in
-# the ESAPI 2.0 Symmetric Encryption User Guide, at:
-# http://owasp-esapi-java.googlecode.com/svn/trunk/documentation/esapi4java-core-2.0-symmetric-crypto-user-guide.html
-# However, this property also allows you to easily use an alternate JCE provider
-# such as "Bouncy Castle" without having to make changes to "java.security".
-# See Javadoc for SecurityProviderLoader for further details. If you wish to use
-# a provider that is not known to SecurityProviderLoader, you may specify the
-# fully-qualified class name of the JCE provider class that implements
-# java.security.Provider. If the name contains a '.', this is interpreted as
-# a fully-qualified class name that implements java.security.Provider.
-#
-# NOTE: Setting this property has the side-effect of changing it in your application
-#       as well, so if you are using JCE in your application directly rather than
-#       through ESAPI (you wouldn't do that, would you? ;-), it will change the
-#       preferred JCE provider there as well.
-#
-# Default: Keeps the JCE provider set to whatever JVM sets it to.
-Encryptor.PreferredJCEProvider=
-
-# AES is the most widely used and strongest encryption algorithm. This
-# should agree with your Encryptor.CipherTransformation property.
-# By default, ESAPI Java 1.4 uses "PBEWithMD5AndDES" and which is
-# very weak. It is essentially a password-based encryption key, hashed
-# with MD5 around 1K times and then encrypted with the weak DES algorithm
-# (56-bits) using ECB mode and an unspecified padding (it is
-# JCE provider specific, but most likely "NoPadding"). However, 2.0 uses
-# "AES/CBC/PKCSPadding". If you want to change these, change them here.
-# Warning: This property does not control the default reference implementation for
-#		   ESAPI 2.0 using JavaEncryptor. Also, this property will be dropped
-#		   in the future.
-# @deprecated
-Encryptor.EncryptionAlgorithm=AES
-#		For ESAPI Java 2.0 - New encrypt / decrypt methods use this.
-Encryptor.CipherTransformation=AES/CBC/PKCS5Padding
-
-# Applies to ESAPI 2.0 and later only!
-# Comma-separated list of cipher modes that provide *BOTH*
-# confidentiality *AND* message authenticity. (NIST refers to such cipher
-# modes as "combined modes" so that's what we shall call them.) If any of these
-# cipher modes are used then no MAC is calculated and stored
-# in the CipherText upon encryption. Likewise, if one of these
-# cipher modes is used with decryption, no attempt will be made
-# to validate the MAC contained in the CipherText object regardless
-# of whether it contains one or not. Since the expectation is that
-# these cipher modes support support message authenticity already,
-# injecting a MAC in the CipherText object would be at best redundant.
-#
-# Note that as of JDK 1.5, the SunJCE provider does not support *any*
-# of these cipher modes. Of these listed, only GCM and CCM are currently
-# NIST approved. YMMV for other JCE providers. E.g., Bouncy Castle supports
-# GCM and CCM with "NoPadding" mode, but not with "PKCS5Padding" or other
-# padding modes.
-Encryptor.cipher_modes.combined_modes=GCM,CCM,IAPM,EAX,OCB,CWC
-
-# Applies to ESAPI 2.0 and later only!
-# Additional cipher modes allowed for ESAPI 2.0 encryption. These
-# cipher modes are in _addition_ to those specified by the property
-# 'Encryptor.cipher_modes.combined_modes'.
-# Note: We will add support for streaming modes like CFB & OFB once
-# we add support for 'specified' to the property 'Encryptor.ChooseIVMethod'
-# (probably in ESAPI 2.1).
-#
-#	IMPORTANT NOTE:	In the official ESAPI.properties we do *NOT* include ECB
-#					here as this is an extremely weak mode. However, we *must*
-#					allow it here so we can test ECB mode. That is important
-#					since the logic is somewhat different (i.e., ECB mode does
-#					not use an IV).
-# DISCUSS: Better name?
-#	NOTE: ECB added only for testing purposes. Don't try this at home!
-Encryptor.cipher_modes.additional_allowed=CBC,ECB
-
-# 128-bit is almost always sufficient and appears to be more resistant to
-# related key attacks than is 256-bit AES. Use '_' to use default key size
-# for cipher algorithms (where it makes sense because the algorithm supports
-# a variable key size). Key length must agree to what's provided as the
-# cipher transformation, otherwise this will be ignored after logging a
-# warning.
-#
-# NOTE: This is what applies BOTH ESAPI 1.4 and 2.0. See warning above about mixing!
-Encryptor.EncryptionKeyLength=128
-
-# Because 2.0 uses CBC mode by default, it requires an initialization vector (IV).
-# (All cipher modes except ECB require an IV.) There are two choices: we can either
-# use a fixed IV known to both parties or allow ESAPI to choose a random IV. While
-# the IV does not need to be hidden from adversaries, it is important that the
-# adversary not be allowed to choose it. Also, random IVs are generally much more
-# secure than fixed IVs. (In fact, it is essential that feed-back cipher modes
-# such as CFB and OFB use a different IV for each encryption with a given key so
-# in such cases, random IVs are much preferred. By default, ESAPI 2.0 uses random
-# IVs. If you wish to use 'fixed' IVs, set 'Encryptor.ChooseIVMethod=fixed' and
-# uncomment the Encryptor.fixedIV.
-#
-# Valid values:		random|fixed|specified		'specified' not yet implemented; planned for 2.1
-Encryptor.ChooseIVMethod=random
-# If you choose to use a fixed IV, then you must place a fixed IV here that
-# is known to all others who are sharing your secret key. The format should
-# be a hex string that is the same length as the cipher block size for the
-# cipher algorithm that you are using. The following is an example for AES
-# from an AES test vector for AES-128/CBC as described in:
-# NIST Special Publication 800-38A (2001 Edition)
-# "Recommendation for Block Cipher Modes of Operation".
-# (Note that the block size for AES is 16 bytes == 128 bits.)
-#
-Encryptor.fixedIV=0x000102030405060708090a0b0c0d0e0f
-
-# Whether or not CipherText should use a message authentication code (MAC) with it.
-# This prevents an adversary from altering the IV as well as allowing a more
-# fool-proof way of determining the decryption failed because of an incorrect
-# key being supplied. This refers to the "separate" MAC calculated and stored
-# in CipherText, not part of any MAC that is calculated as a result of a
-# "combined mode" cipher mode.
-#
-# If you are using ESAPI with a FIPS 140-2 cryptographic module, you *must* also
-# set this property to false.
-Encryptor.CipherText.useMAC=true
-
-# Whether or not the PlainText object may be overwritten and then marked
-# eligible for garbage collection. If not set, this is still treated as 'true'.
-Encryptor.PlainText.overwrite=true
-
-# Do not use DES except in a legacy situations. 56-bit is way too small key size.
-#Encryptor.EncryptionKeyLength=56
-#Encryptor.EncryptionAlgorithm=DES
-
-# TripleDES is considered strong enough for most purposes.
-#	Note:	There is also a 112-bit version of DESede. Using the 168-bit version
-#			requires downloading the special jurisdiction policy from Sun.
-#Encryptor.EncryptionKeyLength=168
-#Encryptor.EncryptionAlgorithm=DESede
-
-Encryptor.HashAlgorithm=SHA-512
-Encryptor.HashIterations=1024
-Encryptor.DigitalSignatureAlgorithm=SHA1withDSA
-Encryptor.DigitalSignatureKeyLength=1024
-Encryptor.RandomAlgorithm=SHA1PRNG
-Encryptor.CharacterEncoding=UTF-8
-# Currently supported choices for JDK 1.5 and 1.6 are:
-#	HmacSHA1 (160 bits), HmacSHA256 (256 bits), HmacSHA384 (384 bits), and
-#	HmacSHA512 (512 bits).
-# Note that HmacMD5 is *not* supported for the PRF used by the KDF even though
-# these JDKs support it.
-Encryptor.KDF.PRF=HmacSHA256
-
-#===========================================================================
-# ESAPI HttpUtilties
-#
-# The HttpUtilities provide basic protections to HTTP requests and responses. Primarily these methods 
-# protect against malicious data from attackers, such as unprintable characters, escaped characters,
-# and other simple attacks. The HttpUtilities also provides utility methods for dealing with cookies,
-# headers, and CSRF tokens.
-#
-# Default file upload location (remember to escape backslashes with \\)
-HttpUtilities.UploadDir=C:\\ESAPI\\testUpload
-# let this default to java.io.tmpdir for testing
-#HttpUtilities.UploadTempDir=C:\\temp
-# Force flags on cookies, if you use HttpUtilities to set cookies
-HttpUtilities.ForceHttpOnlySession=false
-HttpUtilities.ForceSecureSession=false
-HttpUtilities.ForceHttpOnlyCookies=true
-HttpUtilities.ForceSecureCookies=true
-# Maximum size of HTTP headers
-HttpUtilities.MaxHeaderSize=4096
-# File upload configuration
-HttpUtilities.ApprovedUploadExtensions=.zip,.pdf,.doc,.docx,.ppt,.pptx,.tar,.gz,.tgz,.rar,.war,.jar,.ear,.xls,.rtf,.properties,.java,.class,.txt,.xml,.jsp,.jsf,.exe,.dll
-HttpUtilities.MaxUploadFileBytes=500000000
-# Using UTF-8 throughout your stack is highly recommended. That includes your database driver,
-# container, and any other technologies you may be using. Failure to do this may expose you
-# to Unicode transcoding injection attacks. Use of UTF-8 does not hinder internationalization.
-HttpUtilities.ResponseContentType=text/html; charset=UTF-8
-# This is the name of the cookie used to represent the HTTP session
-# Typically this will be the default "JSESSIONID" 
-HttpUtilities.HttpSessionIdName=JSESSIONID
-
-
-
-#===========================================================================
-# ESAPI Executor
-# CHECKME - Not sure what this is used for, but surely it should be made OS independent.
-Executor.WorkingDirectory=C:\\Windows\\Temp
-Executor.ApprovedExecutables=C:\\Windows\\System32\\cmd.exe,C:\\Windows\\System32\\runas.exe
-
-
-#===========================================================================
-# ESAPI Logging
-# Set the application name if these logs are combined with other applications
-Logger.ApplicationName=ExampleApplication
-# If you use an HTML log viewer that does not properly HTML escape log data, you can set LogEncodingRequired to true
-Logger.LogEncodingRequired=false
-# Determines whether ESAPI should log the application name. This might be clutter in some single-server/single-app environments.
-Logger.LogApplicationName=true
-# Determines whether ESAPI should log the server IP and port. This might be clutter in some single-server environments.
-Logger.LogServerIP=true
-# LogFileName, the name of the logging file. Provide a full directory path (e.g., C:\\ESAPI\\ESAPI_logging_file) if you
-# want to place it in a specific directory.
-Logger.LogFileName=ESAPI_logging_file
-# MaxLogFileSize, the max size (in bytes) of a single log file before it cuts over to a new one (default is 10,000,000)
-Logger.MaxLogFileSize=10000000
-
-
-#===========================================================================
-# ESAPI Intrusion Detection
-#
-# Each event has a base to which .count, .interval, and .action are added
-# The IntrusionException will fire if we receive "count" events within "interval" seconds
-# The IntrusionDetector is configurable to take the following actions: log, logout, and disable
-#  (multiple actions separated by commas are allowed e.g. event.test.actions=log,disable
-#
-# Custom Events
-# Names must start with "event." as the base
-# Use IntrusionDetector.addEvent( "test" ) in your code to trigger "event.test" here
-# You can also disable intrusion detection completely by changing
-# the following parameter to true
-#
-IntrusionDetector.Disable=false
-#
-IntrusionDetector.event.test.count=2
-IntrusionDetector.event.test.interval=10
-IntrusionDetector.event.test.actions=disable,log
-
-# Exception Events
-# All EnterpriseSecurityExceptions are registered automatically
-# Call IntrusionDetector.getInstance().addException(e) for Exceptions that do not extend EnterpriseSecurityException
-# Use the fully qualified classname of the exception as the base
-
-# any intrusion is an attack
-IntrusionDetector.org.owasp.esapi.errors.IntrusionException.count=1
-IntrusionDetector.org.owasp.esapi.errors.IntrusionException.interval=1
-IntrusionDetector.org.owasp.esapi.errors.IntrusionException.actions=log,disable,logout
-
-# for test purposes
-# CHECKME: Shouldn't there be something in the property name itself that designates
-#		   that these are for testing???
-IntrusionDetector.org.owasp.esapi.errors.IntegrityException.count=10
-IntrusionDetector.org.owasp.esapi.errors.IntegrityException.interval=5
-IntrusionDetector.org.owasp.esapi.errors.IntegrityException.actions=log,disable,logout
-
-# rapid validation errors indicate scans or attacks in progress
-# org.owasp.esapi.errors.ValidationException.count=10
-# org.owasp.esapi.errors.ValidationException.interval=10
-# org.owasp.esapi.errors.ValidationException.actions=log,logout
-
-# sessions jumping between hosts indicates session hijacking
-IntrusionDetector.org.owasp.esapi.errors.AuthenticationHostException.count=2
-IntrusionDetector.org.owasp.esapi.errors.AuthenticationHostException.interval=10
-IntrusionDetector.org.owasp.esapi.errors.AuthenticationHostException.actions=log,logout
-
-
-#===========================================================================
-# ESAPI Validation
-#
-# The ESAPI Validator works on regular expressions with defined names. You can define names
-# either here, or you may define application specific patterns in a separate file defined below.
-# This allows enterprises to specify both organizational standards as well as application specific
-# validation rules.
-#
-#Validator.ConfigurationFile.MultiValued=false
-Validator.ConfigurationFile=validation-test,comma.properties
-
-# Validators used by ESAPI
-Validator.AccountName=^[a-zA-Z0-9]{3,20}$
-Validator.SystemCommand=^[a-zA-Z\\-\\/]{1,64}$
-Validator.RoleName=^[a-z]{1,20}$
-Validator.Redirect=^\\/test.*$
-
-# Global HTTP Validation Rules
-# Values with Base64 encoded data (e.g. encrypted state) will need at least [a-zA-Z0-9\/+=]
-Validator.HTTPScheme=^(http|https)$
-Validator.HTTPServerName=^[a-zA-Z0-9_.\\-]*$
-Validator.HTTPCookieName=^[a-zA-Z0-9\\-_]{1,32}$
-Validator.HTTPCookieValue=^[a-zA-Z0-9\\-\\/+=_ ]*$
-Validator.HTTPHeaderName=^[a-zA-Z0-9\\-_]{1,32}$
-Validator.HTTPHeaderValue=^[a-zA-Z0-9()\\-=\\*\\.\\?;,+\\/:&_ ]*$
-Validator.HTTPServletPath=^[a-zA-Z0-9.\\-\\/_]*$
-Validator.HTTPPath=^[a-zA-Z0-9.\\-_]*$
-Validator.HTTPURL=^.*$
-Validator.HTTPJSESSIONID=^[A-Z0-9]{10,30}$
-
-# Contributed by Fraenku@gmx.ch
-# Googlecode Issue 116 (http://code.google.com/p/owasp-esapi-java/issues/detail?id=116)
-Validator.HTTPParameterName=^[a-zA-Z0-9_\\-]{1,32}$
-Validator.HTTPParameterValue=^[\\p{L}\\p{N}.\\-/+=_ !$*?@]{0,1000}$
-Validator.HTTPContextPath=^/[a-zA-Z0-9.\\-_]*$
-Validator.HTTPQueryString=^([a-zA-Z0-9_\\-]{1,32}=[\\p{L}\\p{N}.\\-/+=_ !$*?@%]*&?)*$
-Validator.HTTPURI=^/([a-zA-Z0-9.\\-_]*/?)*$
-
-
-# Validation of file related input
-Validator.FileName=^[a-zA-Z0-9!@#$%^&{}\\[\\]()_+\\-=,.~'` ]{1,255}$
-Validator.DirectoryName=^[a-zA-Z0-9:/\\\\!@#$%^&{}\\[\\]()_+\\-=,.~'` ]{1,255}$
-
-# Validation of dates. Controls whether or not 'lenient' dates are accepted.
-# See DataFormat.setLenient(boolean flag) for further details.
+#
+# OWASP Enterprise Security API (ESAPI) Properties file -- TEST Version
+# 
+# This file is part of the Open Web Application Security Project (OWASP)
+# Enterprise Security API (ESAPI) project. For details, please see
+# http://www.owasp.org/index.php/ESAPI.
+#
+# Copyright (c) 2008,2009 - The OWASP Foundation
+#
+# DISCUSS: This may cause a major backwards compatibility issue, etc. but
+#		   from a name space perspective, we probably should have prefaced
+#		   all the property names with ESAPI or at least OWASP. Otherwise
+#		   there could be problems is someone loads this properties file into
+#		   the System properties.  We could also put this file into the
+#		   esapi.jar file (perhaps as a ResourceBundle) and then allow an external
+#		   ESAPI properties be defined that would overwrite these defaults.
+#		   That keeps the application's properties relatively simple as usually
+#		   they will only want to override a few properties. If looks like we
+#		   already support multiple override levels of this in the
+#		   DefaultSecurityConfiguration class, but I'm suggesting placing the
+#		   defaults in the esapi.jar itself. That way, if the jar is signed,
+#		   we could detect if those properties had been tampered with. (The
+#		   code to check the jar signatures is pretty simple... maybe 70-90 LOC,
+#		   but off course there is an execution penalty (similar to the way
+#		   that the separate sunjce.jar used to be when a class from it was
+#		   first loaded). Thoughts?
+###############################################################################
+#
+# WARNING: Operating system protection should be used to lock down the .esapi
+# resources directory and all the files inside and all the directories all the
+# way up to the root directory of the file system.  Note that if you are using
+# file-based implementations, that some files may need to be read-write as they
+# get updated dynamically.
+#
+# Before using, be sure to update the MasterKey and MasterSalt as described below.
+# N.B.: If you had stored data that you have previously encrypted with ESAPI 1.4,
+#		you *must* FIRST decrypt it using ESAPI 1.4 and then (if so desired)
+#		re-encrypt it with ESAPI 2.0. If you fail to do this, you will NOT be
+#		able to decrypt your data with ESAPI 2.0.
+#
+#		YOU HAVE BEEN WARNED!!! More details are in the ESAPI 2.0 Release Notes.
+#
+#===========================================================================
+# ESAPI Configuration
+#
+# If true, then print all the ESAPI properties set here when they are loaded.
+# If false, they are not printed. Useful to reduce output when running JUnit tests.
+# If you need to troubleshoot a properties related problem, turning this on may help,
+# but we leave it off for running JUnit tests. (It will be 'true' in the one delivered
+# as part of production ESAPI, mostly for backward compatibility.)
+ESAPI.printProperties=false
+
+# ESAPI is designed to be easily extensible. You can use the reference implementation
+# or implement your own providers to take advantage of your enterprise's security
+# infrastructure. The functions in ESAPI are referenced using the ESAPI locator, like:
+#
+#    String ciphertext =
+#		ESAPI.encryptor().encrypt("Secret message");   // Deprecated in 2.0
+#    CipherText cipherText =
+#		ESAPI.encryptor().encrypt(new PlainText("Secret message")); // Preferred
+#
+# Below you can specify the classname for the provider that you wish to use in your
+# application. The only requirement is that it implement the appropriate ESAPI interface.
+# This allows you to switch security implementations in the future without rewriting the
+# entire application.
+#
+# ExperimentalAccessController requires ESAPI-AccessControlPolicy.xml in .esapi directory
+ESAPI.AccessControl=org.owasp.esapi.reference.DefaultAccessController
+# FileBasedAuthenticator requires users.txt file in .esapi directory
+ESAPI.Authenticator=org.owasp.esapi.reference.FileBasedAuthenticator
+ESAPI.Encoder=org.owasp.esapi.reference.DefaultEncoder
+ESAPI.Encryptor=org.owasp.esapi.reference.crypto.JavaEncryptor
+
+ESAPI.Executor=org.owasp.esapi.reference.DefaultExecutor
+ESAPI.HTTPUtilities=org.owasp.esapi.reference.DefaultHTTPUtilities
+ESAPI.IntrusionDetector=org.owasp.esapi.reference.DefaultIntrusionDetector
+# Log4JFactory Requires log4j.xml or log4j.properties in classpath - http://www.laliluna.de/log4j-tutorial.html
+ESAPI.Logger=org.owasp.esapi.reference.Log4JLogFactory
+#ESAPI.Logger=org.owasp.esapi.reference.JavaLogFactory
+#ESAPI.Logger=org.owasp.esapi.reference.ExampleExtendedLog4JLogFactory
+ESAPI.Randomizer=org.owasp.esapi.reference.DefaultRandomizer
+ESAPI.Validator=org.owasp.esapi.reference.DefaultValidator
+
+#===========================================================================
+# ESAPI Authenticator
+#
+Authenticator.AllowedLoginAttempts=3
+Authenticator.MaxOldPasswordHashes=13
+Authenticator.UsernameParameterName=username
+Authenticator.PasswordParameterName=password
+# RememberTokenDuration (in days)
+Authenticator.RememberTokenDuration=14
+# Session Timeouts (in minutes)
+Authenticator.IdleTimeoutDuration=20
+Authenticator.AbsoluteTimeoutDuration=120
+
+#===========================================================================
+# ESAPI Encoder
+#
+# ESAPI canonicalizes input before validation to prevent bypassing filters with encoded attacks.
+# Failure to canonicalize input is a very common mistake when implementing validation schemes.
+# Canonicalization is automatic when using the ESAPI Validator, but you can also use the
+# following code to canonicalize data.
+#
+#      ESAPI.Encoder().canonicalize( "%22hello world"" );
+#  
+# Multiple encoding is when a single encoding format is applied multiple times. Allowing
+# multiple encoding is strongly discouraged.
+Encoder.AllowMultipleEncoding=false
+
+# Mixed encoding is when multiple different encoding formats are applied, or when
+# multiple formats are nested. Allowing multiple encoding is strongly discouraged.
+Encoder.AllowMixedEncoding=false
+
+# The default list of codecs to apply when canonicalizing untrusted data. The list should include the codecs
+# for all downstream interpreters or decoders. For example, if the data is likely to end up in a URL, HTML, or
+# inside JavaScript, then the list of codecs below is appropriate. The order of the list is not terribly important.
+Encoder.DefaultCodecList=HTMLEntityCodec,PercentCodec,JavaScriptCodec
+
+
+#===========================================================================
+# ESAPI Encryption
+#
+# The ESAPI Encryptor provides basic cryptographic functions with a simplified API.
+# To get started, generate a new key using java -classpath esapi.jar org.owasp.esapi.reference.crypto.JavaEncryptor
+# There is not currently any support for key rotation, so be careful when changing your key and salt as it
+# will invalidate all signed, encrypted, and hashed data.
+#
+# WARNING: Not all combinations of algorithms and key lengths are supported.
+# If you choose to use a key length greater than 128, you MUST download the
+# unlimited strength policy files and install in the lib directory of your JRE/JDK.
+# See http://java.sun.com/javase/downloads/index.jsp for more information.
+#
+# Backward compatibility with ESAPI Java 1.4 is supported by the two deprecated API
+# methods, Encryptor.encrypt(String) and Encryptor.decrypt(String). However, whenever
+# possible, these methods should be avoided as they use ECB cipher mode, which in almost
+# all circumstances a poor choice because of it's weakness. CBC cipher mode is the default
+# for the new Encryptor encrypt / decrypt methods for ESAPI Java 2.0.  In general, you
+# should only use this compatibility setting if you have persistent data encrypted with
+# version 1.4 and even then, you should ONLY set this compatibility mode UNTIL
+# you have decrypted all of your old encrypted data and then re-encrypted it with
+# ESAPI 2.0 using CBC mode. If you have some reason to mix the deprecated 1.4 mode
+# with the new 2.0 methods, make sure that you use the same cipher algorithm for both
+# (256-bit AES was the default for 1.4; 128-bit is the default for 2.0; see below for
+# more details.) Otherwise, you will have to use the new 2.0 encrypt / decrypt methods
+# where you can specify a SecretKey. (Note that if you are using the 256-bit AES,
+# that requires downloading the special jurisdiction policy files mentioned above.)
+#
+#		***** IMPORTANT: These are for JUnit testing. Test files may have been
+#						 encrypted using these values so do not change these or
+#						 those tests will fail. The version under
+#							src/main/resources/.esapi/ESAPI.properties
+#						 will be delivered with Encryptor.MasterKey and
+#						 Encryptor.MasterSalt set to the empty string.
+#
+#						 FINAL NOTE:
+#                           If Maven changes these when run, that needs to be fixed.
+#       256-bit key... requires unlimited strength jurisdiction policy files
+### Encryptor.MasterKey=pJhlri8JbuFYDgkqtHmm9s0Ziug2PE7ovZDyEPm4j14=
+#       128-bit key
+Encryptor.MasterKey=a6H9is3hEVGKB4Jut+lOVA==
+Encryptor.MasterSalt=SbftnvmEWD5ZHHP+pX3fqugNysc=
+# Encryptor.MasterSalt=
+
+# Provides the default JCE provider that ESAPI will "prefer" for its symmetric
+# encryption and hashing. (That is it will look to this provider first, but it
+# will defer to other providers if the requested algorithm is not implemented
+# by this provider.) If left unset, ESAPI will just use your Java VM's current
+# preferred JCE provider, which is generally set in the file
+# "$JAVA_HOME/jre/lib/security/java.security".
+#
+# The main intent of this is to allow ESAPI symmetric encryption to be
+# used with a FIPS 140-2 compliant crypto-module. For details, see the section
+# "Using ESAPI Symmetric Encryption with FIPS 140-2 Cryptographic Modules" in
+# the ESAPI 2.0 Symmetric Encryption User Guide, at:
+# http://owasp-esapi-java.googlecode.com/svn/trunk/documentation/esapi4java-core-2.0-symmetric-crypto-user-guide.html
+# However, this property also allows you to easily use an alternate JCE provider
+# such as "Bouncy Castle" without having to make changes to "java.security".
+# See Javadoc for SecurityProviderLoader for further details. If you wish to use
+# a provider that is not known to SecurityProviderLoader, you may specify the
+# fully-qualified class name of the JCE provider class that implements
+# java.security.Provider. If the name contains a '.', this is interpreted as
+# a fully-qualified class name that implements java.security.Provider.
+#
+# NOTE: Setting this property has the side-effect of changing it in your application
+#       as well, so if you are using JCE in your application directly rather than
+#       through ESAPI (you wouldn't do that, would you? ;-), it will change the
+#       preferred JCE provider there as well.
+#
+# Default: Keeps the JCE provider set to whatever JVM sets it to.
+Encryptor.PreferredJCEProvider=
+
+# AES is the most widely used and strongest encryption algorithm. This
+# should agree with your Encryptor.CipherTransformation property.
+# By default, ESAPI Java 1.4 uses "PBEWithMD5AndDES" and which is
+# very weak. It is essentially a password-based encryption key, hashed
+# with MD5 around 1K times and then encrypted with the weak DES algorithm
+# (56-bits) using ECB mode and an unspecified padding (it is
+# JCE provider specific, but most likely "NoPadding"). However, 2.0 uses
+# "AES/CBC/PKCSPadding". If you want to change these, change them here.
+# Warning: This property does not control the default reference implementation for
+#		   ESAPI 2.0 using JavaEncryptor. Also, this property will be dropped
+#		   in the future.
+# @deprecated
+Encryptor.EncryptionAlgorithm=AES
+#		For ESAPI Java 2.0 - New encrypt / decrypt methods use this.
+Encryptor.CipherTransformation=AES/CBC/PKCS5Padding
+
+# Applies to ESAPI 2.0 and later only!
+# Comma-separated list of cipher modes that provide *BOTH*
+# confidentiality *AND* message authenticity. (NIST refers to such cipher
+# modes as "combined modes" so that's what we shall call them.) If any of these
+# cipher modes are used then no MAC is calculated and stored
+# in the CipherText upon encryption. Likewise, if one of these
+# cipher modes is used with decryption, no attempt will be made
+# to validate the MAC contained in the CipherText object regardless
+# of whether it contains one or not. Since the expectation is that
+# these cipher modes support support message authenticity already,
+# injecting a MAC in the CipherText object would be at best redundant.
+#
+# Note that as of JDK 1.5, the SunJCE provider does not support *any*
+# of these cipher modes. Of these listed, only GCM and CCM are currently
+# NIST approved. YMMV for other JCE providers. E.g., Bouncy Castle supports
+# GCM and CCM with "NoPadding" mode, but not with "PKCS5Padding" or other
+# padding modes.
+Encryptor.cipher_modes.combined_modes=GCM,CCM,IAPM,EAX,OCB,CWC
+
+# Applies to ESAPI 2.0 and later only!
+# Additional cipher modes allowed for ESAPI 2.0 encryption. These
+# cipher modes are in _addition_ to those specified by the property
+# 'Encryptor.cipher_modes.combined_modes'.
+# Note: We will add support for streaming modes like CFB & OFB once
+# we add support for 'specified' to the property 'Encryptor.ChooseIVMethod'
+# (probably in ESAPI 2.1).
+#
+#	IMPORTANT NOTE:	In the official ESAPI.properties we do *NOT* include ECB
+#					here as this is an extremely weak mode. However, we *must*
+#					allow it here so we can test ECB mode. That is important
+#					since the logic is somewhat different (i.e., ECB mode does
+#					not use an IV).
+# DISCUSS: Better name?
+#	NOTE: ECB added only for testing purposes. Don't try this at home!
+Encryptor.cipher_modes.additional_allowed=CBC,ECB
+
+# 128-bit is almost always sufficient and appears to be more resistant to
+# related key attacks than is 256-bit AES. Use '_' to use default key size
+# for cipher algorithms (where it makes sense because the algorithm supports
+# a variable key size). Key length must agree to what's provided as the
+# cipher transformation, otherwise this will be ignored after logging a
+# warning.
+#
+# NOTE: This is what applies BOTH ESAPI 1.4 and 2.0. See warning above about mixing!
+Encryptor.EncryptionKeyLength=128
+
+# Because 2.0 uses CBC mode by default, it requires an initialization vector (IV).
+# (All cipher modes except ECB require an IV.) There are two choices: we can either
+# use a fixed IV known to both parties or allow ESAPI to choose a random IV. While
+# the IV does not need to be hidden from adversaries, it is important that the
+# adversary not be allowed to choose it. Also, random IVs are generally much more
+# secure than fixed IVs. (In fact, it is essential that feed-back cipher modes
+# such as CFB and OFB use a different IV for each encryption with a given key so
+# in such cases, random IVs are much preferred. By default, ESAPI 2.0 uses random
+# IVs. If you wish to use 'fixed' IVs, set 'Encryptor.ChooseIVMethod=fixed' and
+# uncomment the Encryptor.fixedIV.
+#
+# Valid values:		random|fixed|specified		'specified' not yet implemented; planned for 2.1
+Encryptor.ChooseIVMethod=random
+# If you choose to use a fixed IV, then you must place a fixed IV here that
+# is known to all others who are sharing your secret key. The format should
+# be a hex string that is the same length as the cipher block size for the
+# cipher algorithm that you are using. The following is an example for AES
+# from an AES test vector for AES-128/CBC as described in:
+# NIST Special Publication 800-38A (2001 Edition)
+# "Recommendation for Block Cipher Modes of Operation".
+# (Note that the block size for AES is 16 bytes == 128 bits.)
+#
+Encryptor.fixedIV=0x000102030405060708090a0b0c0d0e0f
+
+# Whether or not CipherText should use a message authentication code (MAC) with it.
+# This prevents an adversary from altering the IV as well as allowing a more
+# fool-proof way of determining the decryption failed because of an incorrect
+# key being supplied. This refers to the "separate" MAC calculated and stored
+# in CipherText, not part of any MAC that is calculated as a result of a
+# "combined mode" cipher mode.
+#
+# If you are using ESAPI with a FIPS 140-2 cryptographic module, you *must* also
+# set this property to false.
+Encryptor.CipherText.useMAC=true
+
+# Whether or not the PlainText object may be overwritten and then marked
+# eligible for garbage collection. If not set, this is still treated as 'true'.
+Encryptor.PlainText.overwrite=true
+
+# Do not use DES except in a legacy situations. 56-bit is way too small key size.
+#Encryptor.EncryptionKeyLength=56
+#Encryptor.EncryptionAlgorithm=DES
+
+# TripleDES is considered strong enough for most purposes.
+#	Note:	There is also a 112-bit version of DESede. Using the 168-bit version
+#			requires downloading the special jurisdiction policy from Sun.
+#Encryptor.EncryptionKeyLength=168
+#Encryptor.EncryptionAlgorithm=DESede
+
+Encryptor.HashAlgorithm=SHA-512
+Encryptor.HashIterations=1024
+Encryptor.DigitalSignatureAlgorithm=SHA1withDSA
+Encryptor.DigitalSignatureKeyLength=1024
+Encryptor.RandomAlgorithm=SHA1PRNG
+Encryptor.CharacterEncoding=UTF-8
+# Currently supported choices for JDK 1.5 and 1.6 are:
+#	HmacSHA1 (160 bits), HmacSHA256 (256 bits), HmacSHA384 (384 bits), and
+#	HmacSHA512 (512 bits).
+# Note that HmacMD5 is *not* supported for the PRF used by the KDF even though
+# these JDKs support it.
+Encryptor.KDF.PRF=HmacSHA256
+
+#===========================================================================
+# ESAPI HttpUtilties
+#
+# The HttpUtilities provide basic protections to HTTP requests and responses. Primarily these methods 
+# protect against malicious data from attackers, such as unprintable characters, escaped characters,
+# and other simple attacks. The HttpUtilities also provides utility methods for dealing with cookies,
+# headers, and CSRF tokens.
+#
+# Default file upload location (remember to escape backslashes with \\)
+HttpUtilities.UploadDir=C:\\ESAPI\\testUpload
+# let this default to java.io.tmpdir for testing
+#HttpUtilities.UploadTempDir=C:\\temp
+# Force flags on cookies, if you use HttpUtilities to set cookies
+HttpUtilities.ForceHttpOnlySession=false
+HttpUtilities.ForceSecureSession=false
+HttpUtilities.ForceHttpOnlyCookies=true
+HttpUtilities.ForceSecureCookies=true
+# Maximum size of HTTP headers
+HttpUtilities.MaxHeaderSize=4096
+# File upload configuration
+HttpUtilities.ApprovedUploadExtensions=.zip,.pdf,.doc,.docx,.ppt,.pptx,.tar,.gz,.tgz,.rar,.war,.jar,.ear,.xls,.rtf,.properties,.java,.class,.txt,.xml,.jsp,.jsf,.exe,.dll
+HttpUtilities.MaxUploadFileBytes=500000000
+# Using UTF-8 throughout your stack is highly recommended. That includes your database driver,
+# container, and any other technologies you may be using. Failure to do this may expose you
+# to Unicode transcoding injection attacks. Use of UTF-8 does not hinder internationalization.
+HttpUtilities.ResponseContentType=text/html; charset=UTF-8
+# This is the name of the cookie used to represent the HTTP session
+# Typically this will be the default "JSESSIONID" 
+HttpUtilities.HttpSessionIdName=JSESSIONID
+
+
+
+#===========================================================================
+# ESAPI Executor
+# CHECKME - Not sure what this is used for, but surely it should be made OS independent.
+Executor.WorkingDirectory=C:\\Windows\\Temp
+Executor.ApprovedExecutables=C:\\Windows\\System32\\cmd.exe,C:\\Windows\\System32\\runas.exe
+
+
+#===========================================================================
+# ESAPI Logging
+# Set the application name if these logs are combined with other applications
+Logger.ApplicationName=ExampleApplication
+# If you use an HTML log viewer that does not properly HTML escape log data, you can set LogEncodingRequired to true
+Logger.LogEncodingRequired=false
+# Determines whether ESAPI should log the application name. This might be clutter in some single-server/single-app environments.
+Logger.LogApplicationName=true
+# Determines whether ESAPI should log the server IP and port. This might be clutter in some single-server environments.
+Logger.LogServerIP=true
+# LogFileName, the name of the logging file. Provide a full directory path (e.g., C:\\ESAPI\\ESAPI_logging_file) if you
+# want to place it in a specific directory.
+Logger.LogFileName=ESAPI_logging_file
+# MaxLogFileSize, the max size (in bytes) of a single log file before it cuts over to a new one (default is 10,000,000)
+Logger.MaxLogFileSize=10000000
+
+
+#===========================================================================
+# ESAPI Intrusion Detection
+#
+# Each event has a base to which .count, .interval, and .action are added
+# The IntrusionException will fire if we receive "count" events within "interval" seconds
+# The IntrusionDetector is configurable to take the following actions: log, logout, and disable
+#  (multiple actions separated by commas are allowed e.g. event.test.actions=log,disable
+#
+# Custom Events
+# Names must start with "event." as the base
+# Use IntrusionDetector.addEvent( "test" ) in your code to trigger "event.test" here
+# You can also disable intrusion detection completely by changing
+# the following parameter to true
+#
+IntrusionDetector.Disable=false
+#
+IntrusionDetector.event.test.count=2
+IntrusionDetector.event.test.interval=10
+IntrusionDetector.event.test.actions=disable,log
+
+# Exception Events
+# All EnterpriseSecurityExceptions are registered automatically
+# Call IntrusionDetector.getInstance().addException(e) for Exceptions that do not extend EnterpriseSecurityException
+# Use the fully qualified classname of the exception as the base
+
+# any intrusion is an attack
+IntrusionDetector.org.owasp.esapi.errors.IntrusionException.count=1
+IntrusionDetector.org.owasp.esapi.errors.IntrusionException.interval=1
+IntrusionDetector.org.owasp.esapi.errors.IntrusionException.actions=log,disable,logout
+
+# for test purposes
+# CHECKME: Shouldn't there be something in the property name itself that designates
+#		   that these are for testing???
+IntrusionDetector.org.owasp.esapi.errors.IntegrityException.count=10
+IntrusionDetector.org.owasp.esapi.errors.IntegrityException.interval=5
+IntrusionDetector.org.owasp.esapi.errors.IntegrityException.actions=log,disable,logout
+
+# rapid validation errors indicate scans or attacks in progress
+# org.owasp.esapi.errors.ValidationException.count=10
+# org.owasp.esapi.errors.ValidationException.interval=10
+# org.owasp.esapi.errors.ValidationException.actions=log,logout
+
+# sessions jumping between hosts indicates session hijacking
+IntrusionDetector.org.owasp.esapi.errors.AuthenticationHostException.count=2
+IntrusionDetector.org.owasp.esapi.errors.AuthenticationHostException.interval=10
+IntrusionDetector.org.owasp.esapi.errors.AuthenticationHostException.actions=log,logout
+
+
+#===========================================================================
+# ESAPI Validation
+#
+# The ESAPI Validator works on regular expressions with defined names. You can define names
+# either here, or you may define application specific patterns in a separate file defined below.
+# This allows enterprises to specify both organizational standards as well as application specific
+# validation rules.
+#
+#Validator.ConfigurationFile.MultiValued=false
+Validator.ConfigurationFile=validation-test,comma.properties
+
+# Validators used by ESAPI
+Validator.AccountName=^[a-zA-Z0-9]{3,20}$
+Validator.SystemCommand=^[a-zA-Z\\-\\/]{1,64}$
+Validator.RoleName=^[a-z]{1,20}$
+Validator.Redirect=^\\/test.*$
+
+# Global HTTP Validation Rules
+# Values with Base64 encoded data (e.g. encrypted state) will need at least [a-zA-Z0-9\/+=]
+Validator.HTTPScheme=^(http|https)$
+Validator.HTTPServerName=^[a-zA-Z0-9_.\\-]*$
+Validator.HTTPCookieName=^[a-zA-Z0-9\\-_]{1,32}$
+Validator.HTTPCookieValue=^[a-zA-Z0-9\\-\\/+=_ ]*$
+Validator.HTTPHeaderName=^[a-zA-Z0-9\\-_]{1,32}$
+Validator.HTTPHeaderValue=^[a-zA-Z0-9()\\-=\\*\\.\\?;,+\\/:&_ ]*$
+Validator.HTTPServletPath=^[a-zA-Z0-9.\\-\\/_]*$
+Validator.HTTPPath=^[a-zA-Z0-9.\\-_]*$
+Validator.HTTPURL=^.*$
+Validator.HTTPJSESSIONID=^[A-Z0-9]{10,30}$
+
+# Contributed by Fraenku@gmx.ch
+# Googlecode Issue 116 (http://code.google.com/p/owasp-esapi-java/issues/detail?id=116)
+Validator.HTTPParameterName=^[a-zA-Z0-9_\\-]{1,32}$
+Validator.HTTPParameterValue=^[\\p{L}\\p{N}.\\-/+=_ !$*?@]{0,1000}$
+Validator.HTTPContextPath=^/[a-zA-Z0-9.\\-_]*$
+Validator.HTTPQueryString=^([a-zA-Z0-9_\\-]{1,32}=[\\p{L}\\p{N}.\\-/+=_ !$*?@%]*&?)*$
+Validator.HTTPURI=^/([a-zA-Z0-9.\\-_]*/?)*$
+
+
+# Validation of file related input
+Validator.FileName=^[a-zA-Z0-9!@#$%^&{}\\[\\]()_+\\-=,.~'` ]{1,255}$
+Validator.DirectoryName=^[a-zA-Z0-9:/\\\\!@#$%^&{}\\[\\]()_+\\-=,.~'` ]{1,255}$
+
+# Validation of dates. Controls whether or not 'lenient' dates are accepted.
+# See DataFormat.setLenient(boolean flag) for further details.
 Validator.AcceptLenientDates=false
\ No newline at end of file

From 23e6d43a552369983297c38bfc2e181320495fd8 Mon Sep 17 00:00:00 2001
From: kwwall 
Date: Tue, 19 Jan 2016 01:12:42 -0500
Subject: [PATCH 319/812] Address issue 356.

---
 .../ESAPI-DualValidatorFileChecker.properties | 930 +++++++++---------
 1 file changed, 465 insertions(+), 465 deletions(-)

diff --git a/src/test/resources/esapi/ESAPI-DualValidatorFileChecker.properties b/src/test/resources/esapi/ESAPI-DualValidatorFileChecker.properties
index afa1d75f0..040de2038 100644
--- a/src/test/resources/esapi/ESAPI-DualValidatorFileChecker.properties
+++ b/src/test/resources/esapi/ESAPI-DualValidatorFileChecker.properties
@@ -1,466 +1,466 @@
-#
-# OWASP Enterprise Security API (ESAPI) Properties file -- TEST Version
-# 
-# This file is part of the Open Web Application Security Project (OWASP)
-# Enterprise Security API (ESAPI) project. For details, please see
-# http://www.owasp.org/index.php/ESAPI.
-#
-# Copyright (c) 2008,2009 - The OWASP Foundation
-#
-# DISCUSS: This may cause a major backwards compatibility issue, etc. but
-#		   from a name space perspective, we probably should have prefaced
-#		   all the property names with ESAPI or at least OWASP. Otherwise
-#		   there could be problems is someone loads this properties file into
-#		   the System properties.  We could also put this file into the
-#		   esapi.jar file (perhaps as a ResourceBundle) and then allow an external
-#		   ESAPI properties be defined that would overwrite these defaults.
-#		   That keeps the application's properties relatively simple as usually
-#		   they will only want to override a few properties. If looks like we
-#		   already support multiple override levels of this in the
-#		   DefaultSecurityConfiguration class, but I'm suggesting placing the
-#		   defaults in the esapi.jar itself. That way, if the jar is signed,
-#		   we could detect if those properties had been tampered with. (The
-#		   code to check the jar signatures is pretty simple... maybe 70-90 LOC,
-#		   but off course there is an execution penalty (similar to the way
-#		   that the separate sunjce.jar used to be when a class from it was
-#		   first loaded). Thoughts?
-###############################################################################
-#
-# WARNING: Operating system protection should be used to lock down the .esapi
-# resources directory and all the files inside and all the directories all the
-# way up to the root directory of the file system.  Note that if you are using
-# file-based implementations, that some files may need to be read-write as they
-# get updated dynamically.
-#
-# Before using, be sure to update the MasterKey and MasterSalt as described below.
-# N.B.: If you had stored data that you have previously encrypted with ESAPI 1.4,
-#		you *must* FIRST decrypt it using ESAPI 1.4 and then (if so desired)
-#		re-encrypt it with ESAPI 2.0. If you fail to do this, you will NOT be
-#		able to decrypt your data with ESAPI 2.0.
-#
-#		YOU HAVE BEEN WARNED!!! More details are in the ESAPI 2.0 Release Notes.
-#
-#===========================================================================
-# ESAPI Configuration
-#
-# If true, then print all the ESAPI properties set here when they are loaded.
-# If false, they are not printed. Useful to reduce output when running JUnit tests.
-# If you need to troubleshoot a properties related problem, turning this on may help,
-# but we leave it off for running JUnit tests. (It will be 'true' in the one delivered
-# as part of production ESAPI, mostly for backward compatibility.)
-ESAPI.printProperties=false
-
-# ESAPI is designed to be easily extensible. You can use the reference implementation
-# or implement your own providers to take advantage of your enterprise's security
-# infrastructure. The functions in ESAPI are referenced using the ESAPI locator, like:
-#
-#    String ciphertext =
-#		ESAPI.encryptor().encrypt("Secret message");   // Deprecated in 2.0
-#    CipherText cipherText =
-#		ESAPI.encryptor().encrypt(new PlainText("Secret message")); // Preferred
-#
-# Below you can specify the classname for the provider that you wish to use in your
-# application. The only requirement is that it implement the appropriate ESAPI interface.
-# This allows you to switch security implementations in the future without rewriting the
-# entire application.
-#
-# ExperimentalAccessController requires ESAPI-AccessControlPolicy.xml in .esapi directory
-ESAPI.AccessControl=org.owasp.esapi.reference.DefaultAccessController
-# FileBasedAuthenticator requires users.txt file in .esapi directory
-ESAPI.Authenticator=org.owasp.esapi.reference.FileBasedAuthenticator
-ESAPI.Encoder=org.owasp.esapi.reference.DefaultEncoder
-ESAPI.Encryptor=org.owasp.esapi.reference.crypto.JavaEncryptor
-
-ESAPI.Executor=org.owasp.esapi.reference.DefaultExecutor
-ESAPI.HTTPUtilities=org.owasp.esapi.reference.DefaultHTTPUtilities
-ESAPI.IntrusionDetector=org.owasp.esapi.reference.DefaultIntrusionDetector
-# Log4JFactory Requires log4j.xml or log4j.properties in classpath - http://www.laliluna.de/log4j-tutorial.html
-ESAPI.Logger=org.owasp.esapi.reference.Log4JLogFactory
-#ESAPI.Logger=org.owasp.esapi.reference.JavaLogFactory
-#ESAPI.Logger=org.owasp.esapi.reference.ExampleExtendedLog4JLogFactory
-ESAPI.Randomizer=org.owasp.esapi.reference.DefaultRandomizer
-ESAPI.Validator=org.owasp.esapi.reference.DefaultValidator
-
-#===========================================================================
-# ESAPI Authenticator
-#
-Authenticator.AllowedLoginAttempts=3
-Authenticator.MaxOldPasswordHashes=13
-Authenticator.UsernameParameterName=username
-Authenticator.PasswordParameterName=password
-# RememberTokenDuration (in days)
-Authenticator.RememberTokenDuration=14
-# Session Timeouts (in minutes)
-Authenticator.IdleTimeoutDuration=20
-Authenticator.AbsoluteTimeoutDuration=120
-
-#===========================================================================
-# ESAPI Encoder
-#
-# ESAPI canonicalizes input before validation to prevent bypassing filters with encoded attacks.
-# Failure to canonicalize input is a very common mistake when implementing validation schemes.
-# Canonicalization is automatic when using the ESAPI Validator, but you can also use the
-# following code to canonicalize data.
-#
-#      ESAPI.Encoder().canonicalize( "%22hello world"" );
-#  
-# Multiple encoding is when a single encoding format is applied multiple times. Allowing
-# multiple encoding is strongly discouraged.
-Encoder.AllowMultipleEncoding=false
-
-# Mixed encoding is when multiple different encoding formats are applied, or when
-# multiple formats are nested. Allowing multiple encoding is strongly discouraged.
-Encoder.AllowMixedEncoding=false
-
-# The default list of codecs to apply when canonicalizing untrusted data. The list should include the codecs
-# for all downstream interpreters or decoders. For example, if the data is likely to end up in a URL, HTML, or
-# inside JavaScript, then the list of codecs below is appropriate. The order of the list is not terribly important.
-Encoder.DefaultCodecList=HTMLEntityCodec,PercentCodec,JavaScriptCodec
-
-
-#===========================================================================
-# ESAPI Encryption
-#
-# The ESAPI Encryptor provides basic cryptographic functions with a simplified API.
-# To get started, generate a new key using java -classpath esapi.jar org.owasp.esapi.reference.crypto.JavaEncryptor
-# There is not currently any support for key rotation, so be careful when changing your key and salt as it
-# will invalidate all signed, encrypted, and hashed data.
-#
-# WARNING: Not all combinations of algorithms and key lengths are supported.
-# If you choose to use a key length greater than 128, you MUST download the
-# unlimited strength policy files and install in the lib directory of your JRE/JDK.
-# See http://java.sun.com/javase/downloads/index.jsp for more information.
-#
-# Backward compatibility with ESAPI Java 1.4 is supported by the two deprecated API
-# methods, Encryptor.encrypt(String) and Encryptor.decrypt(String). However, whenever
-# possible, these methods should be avoided as they use ECB cipher mode, which in almost
-# all circumstances a poor choice because of it's weakness. CBC cipher mode is the default
-# for the new Encryptor encrypt / decrypt methods for ESAPI Java 2.0.  In general, you
-# should only use this compatibility setting if you have persistent data encrypted with
-# version 1.4 and even then, you should ONLY set this compatibility mode UNTIL
-# you have decrypted all of your old encrypted data and then re-encrypted it with
-# ESAPI 2.0 using CBC mode. If you have some reason to mix the deprecated 1.4 mode
-# with the new 2.0 methods, make sure that you use the same cipher algorithm for both
-# (256-bit AES was the default for 1.4; 128-bit is the default for 2.0; see below for
-# more details.) Otherwise, you will have to use the new 2.0 encrypt / decrypt methods
-# where you can specify a SecretKey. (Note that if you are using the 256-bit AES,
-# that requires downloading the special jurisdiction policy files mentioned above.)
-#
-#		***** IMPORTANT: These are for JUnit testing. Test files may have been
-#						 encrypted using these values so do not change these or
-#						 those tests will fail. The version under
-#							src/main/resources/.esapi/ESAPI.properties
-#						 will be delivered with Encryptor.MasterKey and
-#						 Encryptor.MasterSalt set to the empty string.
-#
-#						 FINAL NOTE:
-#                           If Maven changes these when run, that needs to be fixed.
-#       256-bit key... requires unlimited strength jurisdiction policy files
-### Encryptor.MasterKey=pJhlri8JbuFYDgkqtHmm9s0Ziug2PE7ovZDyEPm4j14=
-#       128-bit key
-Encryptor.MasterKey=a6H9is3hEVGKB4Jut+lOVA==
-Encryptor.MasterSalt=SbftnvmEWD5ZHHP+pX3fqugNysc=
-# Encryptor.MasterSalt=
-
-# Provides the default JCE provider that ESAPI will "prefer" for its symmetric
-# encryption and hashing. (That is it will look to this provider first, but it
-# will defer to other providers if the requested algorithm is not implemented
-# by this provider.) If left unset, ESAPI will just use your Java VM's current
-# preferred JCE provider, which is generally set in the file
-# "$JAVA_HOME/jre/lib/security/java.security".
-#
-# The main intent of this is to allow ESAPI symmetric encryption to be
-# used with a FIPS 140-2 compliant crypto-module. For details, see the section
-# "Using ESAPI Symmetric Encryption with FIPS 140-2 Cryptographic Modules" in
-# the ESAPI 2.0 Symmetric Encryption User Guide, at:
-# http://owasp-esapi-java.googlecode.com/svn/trunk/documentation/esapi4java-core-2.0-symmetric-crypto-user-guide.html
-# However, this property also allows you to easily use an alternate JCE provider
-# such as "Bouncy Castle" without having to make changes to "java.security".
-# See Javadoc for SecurityProviderLoader for further details. If you wish to use
-# a provider that is not known to SecurityProviderLoader, you may specify the
-# fully-qualified class name of the JCE provider class that implements
-# java.security.Provider. If the name contains a '.', this is interpreted as
-# a fully-qualified class name that implements java.security.Provider.
-#
-# NOTE: Setting this property has the side-effect of changing it in your application
-#       as well, so if you are using JCE in your application directly rather than
-#       through ESAPI (you wouldn't do that, would you? ;-), it will change the
-#       preferred JCE provider there as well.
-#
-# Default: Keeps the JCE provider set to whatever JVM sets it to.
-Encryptor.PreferredJCEProvider=
-
-# AES is the most widely used and strongest encryption algorithm. This
-# should agree with your Encryptor.CipherTransformation property.
-# By default, ESAPI Java 1.4 uses "PBEWithMD5AndDES" and which is
-# very weak. It is essentially a password-based encryption key, hashed
-# with MD5 around 1K times and then encrypted with the weak DES algorithm
-# (56-bits) using ECB mode and an unspecified padding (it is
-# JCE provider specific, but most likely "NoPadding"). However, 2.0 uses
-# "AES/CBC/PKCSPadding". If you want to change these, change them here.
-# Warning: This property does not control the default reference implementation for
-#		   ESAPI 2.0 using JavaEncryptor. Also, this property will be dropped
-#		   in the future.
-# @deprecated
-Encryptor.EncryptionAlgorithm=AES
-#		For ESAPI Java 2.0 - New encrypt / decrypt methods use this.
-Encryptor.CipherTransformation=AES/CBC/PKCS5Padding
-
-# Applies to ESAPI 2.0 and later only!
-# Comma-separated list of cipher modes that provide *BOTH*
-# confidentiality *AND* message authenticity. (NIST refers to such cipher
-# modes as "combined modes" so that's what we shall call them.) If any of these
-# cipher modes are used then no MAC is calculated and stored
-# in the CipherText upon encryption. Likewise, if one of these
-# cipher modes is used with decryption, no attempt will be made
-# to validate the MAC contained in the CipherText object regardless
-# of whether it contains one or not. Since the expectation is that
-# these cipher modes support support message authenticity already,
-# injecting a MAC in the CipherText object would be at best redundant.
-#
-# Note that as of JDK 1.5, the SunJCE provider does not support *any*
-# of these cipher modes. Of these listed, only GCM and CCM are currently
-# NIST approved. YMMV for other JCE providers. E.g., Bouncy Castle supports
-# GCM and CCM with "NoPadding" mode, but not with "PKCS5Padding" or other
-# padding modes.
-Encryptor.cipher_modes.combined_modes=GCM,CCM,IAPM,EAX,OCB,CWC
-
-# Applies to ESAPI 2.0 and later only!
-# Additional cipher modes allowed for ESAPI 2.0 encryption. These
-# cipher modes are in _addition_ to those specified by the property
-# 'Encryptor.cipher_modes.combined_modes'.
-# Note: We will add support for streaming modes like CFB & OFB once
-# we add support for 'specified' to the property 'Encryptor.ChooseIVMethod'
-# (probably in ESAPI 2.1).
-#
-#	IMPORTANT NOTE:	In the official ESAPI.properties we do *NOT* include ECB
-#					here as this is an extremely weak mode. However, we *must*
-#					allow it here so we can test ECB mode. That is important
-#					since the logic is somewhat different (i.e., ECB mode does
-#					not use an IV).
-# DISCUSS: Better name?
-#	NOTE: ECB added only for testing purposes. Don't try this at home!
-Encryptor.cipher_modes.additional_allowed=CBC,ECB
-
-# 128-bit is almost always sufficient and appears to be more resistant to
-# related key attacks than is 256-bit AES. Use '_' to use default key size
-# for cipher algorithms (where it makes sense because the algorithm supports
-# a variable key size). Key length must agree to what's provided as the
-# cipher transformation, otherwise this will be ignored after logging a
-# warning.
-#
-# NOTE: This is what applies BOTH ESAPI 1.4 and 2.0. See warning above about mixing!
-Encryptor.EncryptionKeyLength=128
-
-# Because 2.0 uses CBC mode by default, it requires an initialization vector (IV).
-# (All cipher modes except ECB require an IV.) There are two choices: we can either
-# use a fixed IV known to both parties or allow ESAPI to choose a random IV. While
-# the IV does not need to be hidden from adversaries, it is important that the
-# adversary not be allowed to choose it. Also, random IVs are generally much more
-# secure than fixed IVs. (In fact, it is essential that feed-back cipher modes
-# such as CFB and OFB use a different IV for each encryption with a given key so
-# in such cases, random IVs are much preferred. By default, ESAPI 2.0 uses random
-# IVs. If you wish to use 'fixed' IVs, set 'Encryptor.ChooseIVMethod=fixed' and
-# uncomment the Encryptor.fixedIV.
-#
-# Valid values:		random|fixed|specified		'specified' not yet implemented; planned for 2.1
-Encryptor.ChooseIVMethod=random
-# If you choose to use a fixed IV, then you must place a fixed IV here that
-# is known to all others who are sharing your secret key. The format should
-# be a hex string that is the same length as the cipher block size for the
-# cipher algorithm that you are using. The following is an example for AES
-# from an AES test vector for AES-128/CBC as described in:
-# NIST Special Publication 800-38A (2001 Edition)
-# "Recommendation for Block Cipher Modes of Operation".
-# (Note that the block size for AES is 16 bytes == 128 bits.)
-#
-Encryptor.fixedIV=0x000102030405060708090a0b0c0d0e0f
-
-# Whether or not CipherText should use a message authentication code (MAC) with it.
-# This prevents an adversary from altering the IV as well as allowing a more
-# fool-proof way of determining the decryption failed because of an incorrect
-# key being supplied. This refers to the "separate" MAC calculated and stored
-# in CipherText, not part of any MAC that is calculated as a result of a
-# "combined mode" cipher mode.
-#
-# If you are using ESAPI with a FIPS 140-2 cryptographic module, you *must* also
-# set this property to false.
-Encryptor.CipherText.useMAC=true
-
-# Whether or not the PlainText object may be overwritten and then marked
-# eligible for garbage collection. If not set, this is still treated as 'true'.
-Encryptor.PlainText.overwrite=true
-
-# Do not use DES except in a legacy situations. 56-bit is way too small key size.
-#Encryptor.EncryptionKeyLength=56
-#Encryptor.EncryptionAlgorithm=DES
-
-# TripleDES is considered strong enough for most purposes.
-#	Note:	There is also a 112-bit version of DESede. Using the 168-bit version
-#			requires downloading the special jurisdiction policy from Sun.
-#Encryptor.EncryptionKeyLength=168
-#Encryptor.EncryptionAlgorithm=DESede
-
-Encryptor.HashAlgorithm=SHA-512
-Encryptor.HashIterations=1024
-Encryptor.DigitalSignatureAlgorithm=SHA1withDSA
-Encryptor.DigitalSignatureKeyLength=1024
-Encryptor.RandomAlgorithm=SHA1PRNG
-Encryptor.CharacterEncoding=UTF-8
-# Currently supported choices for JDK 1.5 and 1.6 are:
-#	HmacSHA1 (160 bits), HmacSHA256 (256 bits), HmacSHA384 (384 bits), and
-#	HmacSHA512 (512 bits).
-# Note that HmacMD5 is *not* supported for the PRF used by the KDF even though
-# these JDKs support it.
-Encryptor.KDF.PRF=HmacSHA256
-
-#===========================================================================
-# ESAPI HttpUtilties
-#
-# The HttpUtilities provide basic protections to HTTP requests and responses. Primarily these methods 
-# protect against malicious data from attackers, such as unprintable characters, escaped characters,
-# and other simple attacks. The HttpUtilities also provides utility methods for dealing with cookies,
-# headers, and CSRF tokens.
-#
-# Default file upload location (remember to escape backslashes with \\)
-HttpUtilities.UploadDir=C:\\ESAPI\\testUpload
-# let this default to java.io.tmpdir for testing
-#HttpUtilities.UploadTempDir=C:\\temp
-# Force flags on cookies, if you use HttpUtilities to set cookies
-HttpUtilities.ForceHttpOnlySession=false
-HttpUtilities.ForceSecureSession=false
-HttpUtilities.ForceHttpOnlyCookies=true
-HttpUtilities.ForceSecureCookies=true
-# Maximum size of HTTP headers
-HttpUtilities.MaxHeaderSize=4096
-# File upload configuration
-HttpUtilities.ApprovedUploadExtensions=.zip,.pdf,.doc,.docx,.ppt,.pptx,.tar,.gz,.tgz,.rar,.war,.jar,.ear,.xls,.rtf,.properties,.java,.class,.txt,.xml,.jsp,.jsf,.exe,.dll
-HttpUtilities.MaxUploadFileBytes=500000000
-# Using UTF-8 throughout your stack is highly recommended. That includes your database driver,
-# container, and any other technologies you may be using. Failure to do this may expose you
-# to Unicode transcoding injection attacks. Use of UTF-8 does not hinder internationalization.
-HttpUtilities.ResponseContentType=text/html; charset=UTF-8
-# This is the name of the cookie used to represent the HTTP session
-# Typically this will be the default "JSESSIONID" 
-HttpUtilities.HttpSessionIdName=JSESSIONID
-
-
-
-#===========================================================================
-# ESAPI Executor
-# CHECKME - Not sure what this is used for, but surely it should be made OS independent.
-Executor.WorkingDirectory=C:\\Windows\\Temp
-Executor.ApprovedExecutables=C:\\Windows\\System32\\cmd.exe,C:\\Windows\\System32\\runas.exe
-
-
-#===========================================================================
-# ESAPI Logging
-# Set the application name if these logs are combined with other applications
-Logger.ApplicationName=ExampleApplication
-# If you use an HTML log viewer that does not properly HTML escape log data, you can set LogEncodingRequired to true
-Logger.LogEncodingRequired=false
-# Determines whether ESAPI should log the application name. This might be clutter in some single-server/single-app environments.
-Logger.LogApplicationName=true
-# Determines whether ESAPI should log the server IP and port. This might be clutter in some single-server environments.
-Logger.LogServerIP=true
-# LogFileName, the name of the logging file. Provide a full directory path (e.g., C:\\ESAPI\\ESAPI_logging_file) if you
-# want to place it in a specific directory.
-Logger.LogFileName=ESAPI_logging_file
-# MaxLogFileSize, the max size (in bytes) of a single log file before it cuts over to a new one (default is 10,000,000)
-Logger.MaxLogFileSize=10000000
-
-
-#===========================================================================
-# ESAPI Intrusion Detection
-#
-# Each event has a base to which .count, .interval, and .action are added
-# The IntrusionException will fire if we receive "count" events within "interval" seconds
-# The IntrusionDetector is configurable to take the following actions: log, logout, and disable
-#  (multiple actions separated by commas are allowed e.g. event.test.actions=log,disable
-#
-# Custom Events
-# Names must start with "event." as the base
-# Use IntrusionDetector.addEvent( "test" ) in your code to trigger "event.test" here
-# You can also disable intrusion detection completely by changing
-# the following parameter to true
-#
-IntrusionDetector.Disable=false
-#
-IntrusionDetector.event.test.count=2
-IntrusionDetector.event.test.interval=10
-IntrusionDetector.event.test.actions=disable,log
-
-# Exception Events
-# All EnterpriseSecurityExceptions are registered automatically
-# Call IntrusionDetector.getInstance().addException(e) for Exceptions that do not extend EnterpriseSecurityException
-# Use the fully qualified classname of the exception as the base
-
-# any intrusion is an attack
-IntrusionDetector.org.owasp.esapi.errors.IntrusionException.count=1
-IntrusionDetector.org.owasp.esapi.errors.IntrusionException.interval=1
-IntrusionDetector.org.owasp.esapi.errors.IntrusionException.actions=log,disable,logout
-
-# for test purposes
-# CHECKME: Shouldn't there be something in the property name itself that designates
-#		   that these are for testing???
-IntrusionDetector.org.owasp.esapi.errors.IntegrityException.count=10
-IntrusionDetector.org.owasp.esapi.errors.IntegrityException.interval=5
-IntrusionDetector.org.owasp.esapi.errors.IntegrityException.actions=log,disable,logout
-
-# rapid validation errors indicate scans or attacks in progress
-# org.owasp.esapi.errors.ValidationException.count=10
-# org.owasp.esapi.errors.ValidationException.interval=10
-# org.owasp.esapi.errors.ValidationException.actions=log,logout
-
-# sessions jumping between hosts indicates session hijacking
-IntrusionDetector.org.owasp.esapi.errors.AuthenticationHostException.count=2
-IntrusionDetector.org.owasp.esapi.errors.AuthenticationHostException.interval=10
-IntrusionDetector.org.owasp.esapi.errors.AuthenticationHostException.actions=log,logout
-
-
-#===========================================================================
-# ESAPI Validation
-#
-# The ESAPI Validator works on regular expressions with defined names. You can define names
-# either here, or you may define application specific patterns in a separate file defined below.
-# This allows enterprises to specify both organizational standards as well as application specific
-# validation rules.
-#
-Validator.ConfigurationFile.MultiValued=true
-Validator.ConfigurationFile=validation-test1.properties,validation-test2.properties
-
-# Validators used by ESAPI
-Validator.AccountName=^[a-zA-Z0-9]{3,20}$
-Validator.SystemCommand=^[a-zA-Z\\-\\/]{1,64}$
-Validator.RoleName=^[a-z]{1,20}$
-Validator.Redirect=^\\/test.*$
-
-# Global HTTP Validation Rules
-# Values with Base64 encoded data (e.g. encrypted state) will need at least [a-zA-Z0-9\/+=]
-Validator.HTTPScheme=^(http|https)$
-Validator.HTTPServerName=^[a-zA-Z0-9_.\\-]*$
-Validator.HTTPCookieName=^[a-zA-Z0-9\\-_]{1,32}$
-Validator.HTTPCookieValue=^[a-zA-Z0-9\\-\\/+=_ ]*$
-Validator.HTTPHeaderName=^[a-zA-Z0-9\\-_]{1,32}$
-Validator.HTTPHeaderValue=^[a-zA-Z0-9()\\-=\\*\\.\\?;,+\\/:&_ ]*$
-Validator.HTTPServletPath=^[a-zA-Z0-9.\\-\\/_]*$
-Validator.HTTPPath=^[a-zA-Z0-9.\\-_]*$
-Validator.HTTPURL=^.*$
-Validator.HTTPJSESSIONID=^[A-Z0-9]{10,30}$
-
-# Contributed by Fraenku@gmx.ch
-# Googlecode Issue 116 (http://code.google.com/p/owasp-esapi-java/issues/detail?id=116)
-Validator.HTTPParameterName=^[a-zA-Z0-9_\\-]{1,32}$
-Validator.HTTPParameterValue=^[\\p{L}\\p{N}.\\-/+=_ !$*?@]{0,1000}$
-Validator.HTTPContextPath=^/[a-zA-Z0-9.\\-_]*$
-Validator.HTTPQueryString=^([a-zA-Z0-9_\\-]{1,32}=[\\p{L}\\p{N}.\\-/+=_ !$*?@%]*&?)*$
-Validator.HTTPURI=^/([a-zA-Z0-9.\\-_]*/?)*$
-
-
-# Validation of file related input
-Validator.FileName=^[a-zA-Z0-9!@#$%^&{}\\[\\]()_+\\-=,.~'` ]{1,255}$
-Validator.DirectoryName=^[a-zA-Z0-9:/\\\\!@#$%^&{}\\[\\]()_+\\-=,.~'` ]{1,255}$
-
-# Validation of dates. Controls whether or not 'lenient' dates are accepted.
-# See DataFormat.setLenient(boolean flag) for further details.
+#
+# OWASP Enterprise Security API (ESAPI) Properties file -- TEST Version
+# 
+# This file is part of the Open Web Application Security Project (OWASP)
+# Enterprise Security API (ESAPI) project. For details, please see
+# http://www.owasp.org/index.php/ESAPI.
+#
+# Copyright (c) 2008,2009 - The OWASP Foundation
+#
+# DISCUSS: This may cause a major backwards compatibility issue, etc. but
+#		   from a name space perspective, we probably should have prefaced
+#		   all the property names with ESAPI or at least OWASP. Otherwise
+#		   there could be problems is someone loads this properties file into
+#		   the System properties.  We could also put this file into the
+#		   esapi.jar file (perhaps as a ResourceBundle) and then allow an external
+#		   ESAPI properties be defined that would overwrite these defaults.
+#		   That keeps the application's properties relatively simple as usually
+#		   they will only want to override a few properties. If looks like we
+#		   already support multiple override levels of this in the
+#		   DefaultSecurityConfiguration class, but I'm suggesting placing the
+#		   defaults in the esapi.jar itself. That way, if the jar is signed,
+#		   we could detect if those properties had been tampered with. (The
+#		   code to check the jar signatures is pretty simple... maybe 70-90 LOC,
+#		   but off course there is an execution penalty (similar to the way
+#		   that the separate sunjce.jar used to be when a class from it was
+#		   first loaded). Thoughts?
+###############################################################################
+#
+# WARNING: Operating system protection should be used to lock down the .esapi
+# resources directory and all the files inside and all the directories all the
+# way up to the root directory of the file system.  Note that if you are using
+# file-based implementations, that some files may need to be read-write as they
+# get updated dynamically.
+#
+# Before using, be sure to update the MasterKey and MasterSalt as described below.
+# N.B.: If you had stored data that you have previously encrypted with ESAPI 1.4,
+#		you *must* FIRST decrypt it using ESAPI 1.4 and then (if so desired)
+#		re-encrypt it with ESAPI 2.0. If you fail to do this, you will NOT be
+#		able to decrypt your data with ESAPI 2.0.
+#
+#		YOU HAVE BEEN WARNED!!! More details are in the ESAPI 2.0 Release Notes.
+#
+#===========================================================================
+# ESAPI Configuration
+#
+# If true, then print all the ESAPI properties set here when they are loaded.
+# If false, they are not printed. Useful to reduce output when running JUnit tests.
+# If you need to troubleshoot a properties related problem, turning this on may help,
+# but we leave it off for running JUnit tests. (It will be 'true' in the one delivered
+# as part of production ESAPI, mostly for backward compatibility.)
+ESAPI.printProperties=false
+
+# ESAPI is designed to be easily extensible. You can use the reference implementation
+# or implement your own providers to take advantage of your enterprise's security
+# infrastructure. The functions in ESAPI are referenced using the ESAPI locator, like:
+#
+#    String ciphertext =
+#		ESAPI.encryptor().encrypt("Secret message");   // Deprecated in 2.0
+#    CipherText cipherText =
+#		ESAPI.encryptor().encrypt(new PlainText("Secret message")); // Preferred
+#
+# Below you can specify the classname for the provider that you wish to use in your
+# application. The only requirement is that it implement the appropriate ESAPI interface.
+# This allows you to switch security implementations in the future without rewriting the
+# entire application.
+#
+# ExperimentalAccessController requires ESAPI-AccessControlPolicy.xml in .esapi directory
+ESAPI.AccessControl=org.owasp.esapi.reference.DefaultAccessController
+# FileBasedAuthenticator requires users.txt file in .esapi directory
+ESAPI.Authenticator=org.owasp.esapi.reference.FileBasedAuthenticator
+ESAPI.Encoder=org.owasp.esapi.reference.DefaultEncoder
+ESAPI.Encryptor=org.owasp.esapi.reference.crypto.JavaEncryptor
+
+ESAPI.Executor=org.owasp.esapi.reference.DefaultExecutor
+ESAPI.HTTPUtilities=org.owasp.esapi.reference.DefaultHTTPUtilities
+ESAPI.IntrusionDetector=org.owasp.esapi.reference.DefaultIntrusionDetector
+# Log4JFactory Requires log4j.xml or log4j.properties in classpath - http://www.laliluna.de/log4j-tutorial.html
+ESAPI.Logger=org.owasp.esapi.reference.Log4JLogFactory
+#ESAPI.Logger=org.owasp.esapi.reference.JavaLogFactory
+#ESAPI.Logger=org.owasp.esapi.reference.ExampleExtendedLog4JLogFactory
+ESAPI.Randomizer=org.owasp.esapi.reference.DefaultRandomizer
+ESAPI.Validator=org.owasp.esapi.reference.DefaultValidator
+
+#===========================================================================
+# ESAPI Authenticator
+#
+Authenticator.AllowedLoginAttempts=3
+Authenticator.MaxOldPasswordHashes=13
+Authenticator.UsernameParameterName=username
+Authenticator.PasswordParameterName=password
+# RememberTokenDuration (in days)
+Authenticator.RememberTokenDuration=14
+# Session Timeouts (in minutes)
+Authenticator.IdleTimeoutDuration=20
+Authenticator.AbsoluteTimeoutDuration=120
+
+#===========================================================================
+# ESAPI Encoder
+#
+# ESAPI canonicalizes input before validation to prevent bypassing filters with encoded attacks.
+# Failure to canonicalize input is a very common mistake when implementing validation schemes.
+# Canonicalization is automatic when using the ESAPI Validator, but you can also use the
+# following code to canonicalize data.
+#
+#      ESAPI.Encoder().canonicalize( "%22hello world"" );
+#  
+# Multiple encoding is when a single encoding format is applied multiple times. Allowing
+# multiple encoding is strongly discouraged.
+Encoder.AllowMultipleEncoding=false
+
+# Mixed encoding is when multiple different encoding formats are applied, or when
+# multiple formats are nested. Allowing multiple encoding is strongly discouraged.
+Encoder.AllowMixedEncoding=false
+
+# The default list of codecs to apply when canonicalizing untrusted data. The list should include the codecs
+# for all downstream interpreters or decoders. For example, if the data is likely to end up in a URL, HTML, or
+# inside JavaScript, then the list of codecs below is appropriate. The order of the list is not terribly important.
+Encoder.DefaultCodecList=HTMLEntityCodec,PercentCodec,JavaScriptCodec
+
+
+#===========================================================================
+# ESAPI Encryption
+#
+# The ESAPI Encryptor provides basic cryptographic functions with a simplified API.
+# To get started, generate a new key using java -classpath esapi.jar org.owasp.esapi.reference.crypto.JavaEncryptor
+# There is not currently any support for key rotation, so be careful when changing your key and salt as it
+# will invalidate all signed, encrypted, and hashed data.
+#
+# WARNING: Not all combinations of algorithms and key lengths are supported.
+# If you choose to use a key length greater than 128, you MUST download the
+# unlimited strength policy files and install in the lib directory of your JRE/JDK.
+# See http://java.sun.com/javase/downloads/index.jsp for more information.
+#
+# Backward compatibility with ESAPI Java 1.4 is supported by the two deprecated API
+# methods, Encryptor.encrypt(String) and Encryptor.decrypt(String). However, whenever
+# possible, these methods should be avoided as they use ECB cipher mode, which in almost
+# all circumstances a poor choice because of it's weakness. CBC cipher mode is the default
+# for the new Encryptor encrypt / decrypt methods for ESAPI Java 2.0.  In general, you
+# should only use this compatibility setting if you have persistent data encrypted with
+# version 1.4 and even then, you should ONLY set this compatibility mode UNTIL
+# you have decrypted all of your old encrypted data and then re-encrypted it with
+# ESAPI 2.0 using CBC mode. If you have some reason to mix the deprecated 1.4 mode
+# with the new 2.0 methods, make sure that you use the same cipher algorithm for both
+# (256-bit AES was the default for 1.4; 128-bit is the default for 2.0; see below for
+# more details.) Otherwise, you will have to use the new 2.0 encrypt / decrypt methods
+# where you can specify a SecretKey. (Note that if you are using the 256-bit AES,
+# that requires downloading the special jurisdiction policy files mentioned above.)
+#
+#		***** IMPORTANT: These are for JUnit testing. Test files may have been
+#						 encrypted using these values so do not change these or
+#						 those tests will fail. The version under
+#							src/main/resources/.esapi/ESAPI.properties
+#						 will be delivered with Encryptor.MasterKey and
+#						 Encryptor.MasterSalt set to the empty string.
+#
+#						 FINAL NOTE:
+#                           If Maven changes these when run, that needs to be fixed.
+#       256-bit key... requires unlimited strength jurisdiction policy files
+### Encryptor.MasterKey=pJhlri8JbuFYDgkqtHmm9s0Ziug2PE7ovZDyEPm4j14=
+#       128-bit key
+Encryptor.MasterKey=a6H9is3hEVGKB4Jut+lOVA==
+Encryptor.MasterSalt=SbftnvmEWD5ZHHP+pX3fqugNysc=
+# Encryptor.MasterSalt=
+
+# Provides the default JCE provider that ESAPI will "prefer" for its symmetric
+# encryption and hashing. (That is it will look to this provider first, but it
+# will defer to other providers if the requested algorithm is not implemented
+# by this provider.) If left unset, ESAPI will just use your Java VM's current
+# preferred JCE provider, which is generally set in the file
+# "$JAVA_HOME/jre/lib/security/java.security".
+#
+# The main intent of this is to allow ESAPI symmetric encryption to be
+# used with a FIPS 140-2 compliant crypto-module. For details, see the section
+# "Using ESAPI Symmetric Encryption with FIPS 140-2 Cryptographic Modules" in
+# the ESAPI 2.0 Symmetric Encryption User Guide, at:
+# http://owasp-esapi-java.googlecode.com/svn/trunk/documentation/esapi4java-core-2.0-symmetric-crypto-user-guide.html
+# However, this property also allows you to easily use an alternate JCE provider
+# such as "Bouncy Castle" without having to make changes to "java.security".
+# See Javadoc for SecurityProviderLoader for further details. If you wish to use
+# a provider that is not known to SecurityProviderLoader, you may specify the
+# fully-qualified class name of the JCE provider class that implements
+# java.security.Provider. If the name contains a '.', this is interpreted as
+# a fully-qualified class name that implements java.security.Provider.
+#
+# NOTE: Setting this property has the side-effect of changing it in your application
+#       as well, so if you are using JCE in your application directly rather than
+#       through ESAPI (you wouldn't do that, would you? ;-), it will change the
+#       preferred JCE provider there as well.
+#
+# Default: Keeps the JCE provider set to whatever JVM sets it to.
+Encryptor.PreferredJCEProvider=
+
+# AES is the most widely used and strongest encryption algorithm. This
+# should agree with your Encryptor.CipherTransformation property.
+# By default, ESAPI Java 1.4 uses "PBEWithMD5AndDES" and which is
+# very weak. It is essentially a password-based encryption key, hashed
+# with MD5 around 1K times and then encrypted with the weak DES algorithm
+# (56-bits) using ECB mode and an unspecified padding (it is
+# JCE provider specific, but most likely "NoPadding"). However, 2.0 uses
+# "AES/CBC/PKCSPadding". If you want to change these, change them here.
+# Warning: This property does not control the default reference implementation for
+#		   ESAPI 2.0 using JavaEncryptor. Also, this property will be dropped
+#		   in the future.
+# @deprecated
+Encryptor.EncryptionAlgorithm=AES
+#		For ESAPI Java 2.0 - New encrypt / decrypt methods use this.
+Encryptor.CipherTransformation=AES/CBC/PKCS5Padding
+
+# Applies to ESAPI 2.0 and later only!
+# Comma-separated list of cipher modes that provide *BOTH*
+# confidentiality *AND* message authenticity. (NIST refers to such cipher
+# modes as "combined modes" so that's what we shall call them.) If any of these
+# cipher modes are used then no MAC is calculated and stored
+# in the CipherText upon encryption. Likewise, if one of these
+# cipher modes is used with decryption, no attempt will be made
+# to validate the MAC contained in the CipherText object regardless
+# of whether it contains one or not. Since the expectation is that
+# these cipher modes support support message authenticity already,
+# injecting a MAC in the CipherText object would be at best redundant.
+#
+# Note that as of JDK 1.5, the SunJCE provider does not support *any*
+# of these cipher modes. Of these listed, only GCM and CCM are currently
+# NIST approved. YMMV for other JCE providers. E.g., Bouncy Castle supports
+# GCM and CCM with "NoPadding" mode, but not with "PKCS5Padding" or other
+# padding modes.
+Encryptor.cipher_modes.combined_modes=GCM,CCM,IAPM,EAX,OCB,CWC
+
+# Applies to ESAPI 2.0 and later only!
+# Additional cipher modes allowed for ESAPI 2.0 encryption. These
+# cipher modes are in _addition_ to those specified by the property
+# 'Encryptor.cipher_modes.combined_modes'.
+# Note: We will add support for streaming modes like CFB & OFB once
+# we add support for 'specified' to the property 'Encryptor.ChooseIVMethod'
+# (probably in ESAPI 2.1).
+#
+#	IMPORTANT NOTE:	In the official ESAPI.properties we do *NOT* include ECB
+#					here as this is an extremely weak mode. However, we *must*
+#					allow it here so we can test ECB mode. That is important
+#					since the logic is somewhat different (i.e., ECB mode does
+#					not use an IV).
+# DISCUSS: Better name?
+#	NOTE: ECB added only for testing purposes. Don't try this at home!
+Encryptor.cipher_modes.additional_allowed=CBC,ECB
+
+# 128-bit is almost always sufficient and appears to be more resistant to
+# related key attacks than is 256-bit AES. Use '_' to use default key size
+# for cipher algorithms (where it makes sense because the algorithm supports
+# a variable key size). Key length must agree to what's provided as the
+# cipher transformation, otherwise this will be ignored after logging a
+# warning.
+#
+# NOTE: This is what applies BOTH ESAPI 1.4 and 2.0. See warning above about mixing!
+Encryptor.EncryptionKeyLength=128
+
+# Because 2.0 uses CBC mode by default, it requires an initialization vector (IV).
+# (All cipher modes except ECB require an IV.) There are two choices: we can either
+# use a fixed IV known to both parties or allow ESAPI to choose a random IV. While
+# the IV does not need to be hidden from adversaries, it is important that the
+# adversary not be allowed to choose it. Also, random IVs are generally much more
+# secure than fixed IVs. (In fact, it is essential that feed-back cipher modes
+# such as CFB and OFB use a different IV for each encryption with a given key so
+# in such cases, random IVs are much preferred. By default, ESAPI 2.0 uses random
+# IVs. If you wish to use 'fixed' IVs, set 'Encryptor.ChooseIVMethod=fixed' and
+# uncomment the Encryptor.fixedIV.
+#
+# Valid values:		random|fixed|specified		'specified' not yet implemented; planned for 2.1
+Encryptor.ChooseIVMethod=random
+# If you choose to use a fixed IV, then you must place a fixed IV here that
+# is known to all others who are sharing your secret key. The format should
+# be a hex string that is the same length as the cipher block size for the
+# cipher algorithm that you are using. The following is an example for AES
+# from an AES test vector for AES-128/CBC as described in:
+# NIST Special Publication 800-38A (2001 Edition)
+# "Recommendation for Block Cipher Modes of Operation".
+# (Note that the block size for AES is 16 bytes == 128 bits.)
+#
+Encryptor.fixedIV=0x000102030405060708090a0b0c0d0e0f
+
+# Whether or not CipherText should use a message authentication code (MAC) with it.
+# This prevents an adversary from altering the IV as well as allowing a more
+# fool-proof way of determining the decryption failed because of an incorrect
+# key being supplied. This refers to the "separate" MAC calculated and stored
+# in CipherText, not part of any MAC that is calculated as a result of a
+# "combined mode" cipher mode.
+#
+# If you are using ESAPI with a FIPS 140-2 cryptographic module, you *must* also
+# set this property to false.
+Encryptor.CipherText.useMAC=true
+
+# Whether or not the PlainText object may be overwritten and then marked
+# eligible for garbage collection. If not set, this is still treated as 'true'.
+Encryptor.PlainText.overwrite=true
+
+# Do not use DES except in a legacy situations. 56-bit is way too small key size.
+#Encryptor.EncryptionKeyLength=56
+#Encryptor.EncryptionAlgorithm=DES
+
+# TripleDES is considered strong enough for most purposes.
+#	Note:	There is also a 112-bit version of DESede. Using the 168-bit version
+#			requires downloading the special jurisdiction policy from Sun.
+#Encryptor.EncryptionKeyLength=168
+#Encryptor.EncryptionAlgorithm=DESede
+
+Encryptor.HashAlgorithm=SHA-512
+Encryptor.HashIterations=1024
+Encryptor.DigitalSignatureAlgorithm=SHA1withDSA
+Encryptor.DigitalSignatureKeyLength=1024
+Encryptor.RandomAlgorithm=SHA1PRNG
+Encryptor.CharacterEncoding=UTF-8
+# Currently supported choices for JDK 1.5 and 1.6 are:
+#	HmacSHA1 (160 bits), HmacSHA256 (256 bits), HmacSHA384 (384 bits), and
+#	HmacSHA512 (512 bits).
+# Note that HmacMD5 is *not* supported for the PRF used by the KDF even though
+# these JDKs support it.
+Encryptor.KDF.PRF=HmacSHA256
+
+#===========================================================================
+# ESAPI HttpUtilties
+#
+# The HttpUtilities provide basic protections to HTTP requests and responses. Primarily these methods 
+# protect against malicious data from attackers, such as unprintable characters, escaped characters,
+# and other simple attacks. The HttpUtilities also provides utility methods for dealing with cookies,
+# headers, and CSRF tokens.
+#
+# Default file upload location (remember to escape backslashes with \\)
+HttpUtilities.UploadDir=C:\\ESAPI\\testUpload
+# let this default to java.io.tmpdir for testing
+#HttpUtilities.UploadTempDir=C:\\temp
+# Force flags on cookies, if you use HttpUtilities to set cookies
+HttpUtilities.ForceHttpOnlySession=false
+HttpUtilities.ForceSecureSession=false
+HttpUtilities.ForceHttpOnlyCookies=true
+HttpUtilities.ForceSecureCookies=true
+# Maximum size of HTTP headers
+HttpUtilities.MaxHeaderSize=4096
+# File upload configuration
+HttpUtilities.ApprovedUploadExtensions=.zip,.pdf,.doc,.docx,.ppt,.pptx,.tar,.gz,.tgz,.rar,.war,.jar,.ear,.xls,.rtf,.properties,.java,.class,.txt,.xml,.jsp,.jsf,.exe,.dll
+HttpUtilities.MaxUploadFileBytes=500000000
+# Using UTF-8 throughout your stack is highly recommended. That includes your database driver,
+# container, and any other technologies you may be using. Failure to do this may expose you
+# to Unicode transcoding injection attacks. Use of UTF-8 does not hinder internationalization.
+HttpUtilities.ResponseContentType=text/html; charset=UTF-8
+# This is the name of the cookie used to represent the HTTP session
+# Typically this will be the default "JSESSIONID" 
+HttpUtilities.HttpSessionIdName=JSESSIONID
+
+
+
+#===========================================================================
+# ESAPI Executor
+# CHECKME - Not sure what this is used for, but surely it should be made OS independent.
+Executor.WorkingDirectory=C:\\Windows\\Temp
+Executor.ApprovedExecutables=C:\\Windows\\System32\\cmd.exe,C:\\Windows\\System32\\runas.exe
+
+
+#===========================================================================
+# ESAPI Logging
+# Set the application name if these logs are combined with other applications
+Logger.ApplicationName=ExampleApplication
+# If you use an HTML log viewer that does not properly HTML escape log data, you can set LogEncodingRequired to true
+Logger.LogEncodingRequired=false
+# Determines whether ESAPI should log the application name. This might be clutter in some single-server/single-app environments.
+Logger.LogApplicationName=true
+# Determines whether ESAPI should log the server IP and port. This might be clutter in some single-server environments.
+Logger.LogServerIP=true
+# LogFileName, the name of the logging file. Provide a full directory path (e.g., C:\\ESAPI\\ESAPI_logging_file) if you
+# want to place it in a specific directory.
+Logger.LogFileName=ESAPI_logging_file
+# MaxLogFileSize, the max size (in bytes) of a single log file before it cuts over to a new one (default is 10,000,000)
+Logger.MaxLogFileSize=10000000
+
+
+#===========================================================================
+# ESAPI Intrusion Detection
+#
+# Each event has a base to which .count, .interval, and .action are added
+# The IntrusionException will fire if we receive "count" events within "interval" seconds
+# The IntrusionDetector is configurable to take the following actions: log, logout, and disable
+#  (multiple actions separated by commas are allowed e.g. event.test.actions=log,disable
+#
+# Custom Events
+# Names must start with "event." as the base
+# Use IntrusionDetector.addEvent( "test" ) in your code to trigger "event.test" here
+# You can also disable intrusion detection completely by changing
+# the following parameter to true
+#
+IntrusionDetector.Disable=false
+#
+IntrusionDetector.event.test.count=2
+IntrusionDetector.event.test.interval=10
+IntrusionDetector.event.test.actions=disable,log
+
+# Exception Events
+# All EnterpriseSecurityExceptions are registered automatically
+# Call IntrusionDetector.getInstance().addException(e) for Exceptions that do not extend EnterpriseSecurityException
+# Use the fully qualified classname of the exception as the base
+
+# any intrusion is an attack
+IntrusionDetector.org.owasp.esapi.errors.IntrusionException.count=1
+IntrusionDetector.org.owasp.esapi.errors.IntrusionException.interval=1
+IntrusionDetector.org.owasp.esapi.errors.IntrusionException.actions=log,disable,logout
+
+# for test purposes
+# CHECKME: Shouldn't there be something in the property name itself that designates
+#		   that these are for testing???
+IntrusionDetector.org.owasp.esapi.errors.IntegrityException.count=10
+IntrusionDetector.org.owasp.esapi.errors.IntegrityException.interval=5
+IntrusionDetector.org.owasp.esapi.errors.IntegrityException.actions=log,disable,logout
+
+# rapid validation errors indicate scans or attacks in progress
+# org.owasp.esapi.errors.ValidationException.count=10
+# org.owasp.esapi.errors.ValidationException.interval=10
+# org.owasp.esapi.errors.ValidationException.actions=log,logout
+
+# sessions jumping between hosts indicates session hijacking
+IntrusionDetector.org.owasp.esapi.errors.AuthenticationHostException.count=2
+IntrusionDetector.org.owasp.esapi.errors.AuthenticationHostException.interval=10
+IntrusionDetector.org.owasp.esapi.errors.AuthenticationHostException.actions=log,logout
+
+
+#===========================================================================
+# ESAPI Validation
+#
+# The ESAPI Validator works on regular expressions with defined names. You can define names
+# either here, or you may define application specific patterns in a separate file defined below.
+# This allows enterprises to specify both organizational standards as well as application specific
+# validation rules.
+#
+Validator.ConfigurationFile.MultiValued=true
+Validator.ConfigurationFile=validation-test1.properties,validation-test2.properties
+
+# Validators used by ESAPI
+Validator.AccountName=^[a-zA-Z0-9]{3,20}$
+Validator.SystemCommand=^[a-zA-Z\\-\\/]{1,64}$
+Validator.RoleName=^[a-z]{1,20}$
+Validator.Redirect=^\\/test.*$
+
+# Global HTTP Validation Rules
+# Values with Base64 encoded data (e.g. encrypted state) will need at least [a-zA-Z0-9\/+=]
+Validator.HTTPScheme=^(http|https)$
+Validator.HTTPServerName=^[a-zA-Z0-9_.\\-]*$
+Validator.HTTPCookieName=^[a-zA-Z0-9\\-_]{1,32}$
+Validator.HTTPCookieValue=^[a-zA-Z0-9\\-\\/+=_ ]*$
+Validator.HTTPHeaderName=^[a-zA-Z0-9\\-_]{1,32}$
+Validator.HTTPHeaderValue=^[a-zA-Z0-9()\\-=\\*\\.\\?;,+\\/:&_ ]*$
+Validator.HTTPServletPath=^[a-zA-Z0-9.\\-\\/_]*$
+Validator.HTTPPath=^[a-zA-Z0-9.\\-_]*$
+Validator.HTTPURL=^.*$
+Validator.HTTPJSESSIONID=^[A-Z0-9]{10,30}$
+
+# Contributed by Fraenku@gmx.ch
+# Googlecode Issue 116 (http://code.google.com/p/owasp-esapi-java/issues/detail?id=116)
+Validator.HTTPParameterName=^[a-zA-Z0-9_\\-]{1,32}$
+Validator.HTTPParameterValue=^[\\p{L}\\p{N}.\\-/+=_ !$*?@]{0,1000}$
+Validator.HTTPContextPath=^/[a-zA-Z0-9.\\-_]*$
+Validator.HTTPQueryString=^([a-zA-Z0-9_\\-]{1,32}=[\\p{L}\\p{N}.\\-/+=_ !$*?@%]*&?)*$
+Validator.HTTPURI=^/([a-zA-Z0-9.\\-_]*/?)*$
+
+
+# Validation of file related input
+Validator.FileName=^[a-zA-Z0-9!@#$%^&{}\\[\\]()_+\\-=,.~'` ]{1,255}$
+Validator.DirectoryName=^[a-zA-Z0-9:/\\\\!@#$%^&{}\\[\\]()_+\\-=,.~'` ]{1,255}$
+
+# Validation of dates. Controls whether or not 'lenient' dates are accepted.
+# See DataFormat.setLenient(boolean flag) for further details.
 Validator.AcceptLenientDates=false
\ No newline at end of file

From 1678c989de38e716b376790186cad5dce2ef05f9 Mon Sep 17 00:00:00 2001
From: kwwall 
Date: Tue, 19 Jan 2016 01:12:42 -0500
Subject: [PATCH 320/812] Address issue 356.

---
 ...SAPI-QuotedValidatorFileChecker.properties | 930 +++++++++---------
 1 file changed, 465 insertions(+), 465 deletions(-)

diff --git a/src/test/resources/esapi/ESAPI-QuotedValidatorFileChecker.properties b/src/test/resources/esapi/ESAPI-QuotedValidatorFileChecker.properties
index 2dc8c5d15..a3a66ba60 100644
--- a/src/test/resources/esapi/ESAPI-QuotedValidatorFileChecker.properties
+++ b/src/test/resources/esapi/ESAPI-QuotedValidatorFileChecker.properties
@@ -1,466 +1,466 @@
-#
-# OWASP Enterprise Security API (ESAPI) Properties file -- TEST Version
-# 
-# This file is part of the Open Web Application Security Project (OWASP)
-# Enterprise Security API (ESAPI) project. For details, please see
-# http://www.owasp.org/index.php/ESAPI.
-#
-# Copyright (c) 2008,2009 - The OWASP Foundation
-#
-# DISCUSS: This may cause a major backwards compatibility issue, etc. but
-#		   from a name space perspective, we probably should have prefaced
-#		   all the property names with ESAPI or at least OWASP. Otherwise
-#		   there could be problems is someone loads this properties file into
-#		   the System properties.  We could also put this file into the
-#		   esapi.jar file (perhaps as a ResourceBundle) and then allow an external
-#		   ESAPI properties be defined that would overwrite these defaults.
-#		   That keeps the application's properties relatively simple as usually
-#		   they will only want to override a few properties. If looks like we
-#		   already support multiple override levels of this in the
-#		   DefaultSecurityConfiguration class, but I'm suggesting placing the
-#		   defaults in the esapi.jar itself. That way, if the jar is signed,
-#		   we could detect if those properties had been tampered with. (The
-#		   code to check the jar signatures is pretty simple... maybe 70-90 LOC,
-#		   but off course there is an execution penalty (similar to the way
-#		   that the separate sunjce.jar used to be when a class from it was
-#		   first loaded). Thoughts?
-###############################################################################
-#
-# WARNING: Operating system protection should be used to lock down the .esapi
-# resources directory and all the files inside and all the directories all the
-# way up to the root directory of the file system.  Note that if you are using
-# file-based implementations, that some files may need to be read-write as they
-# get updated dynamically.
-#
-# Before using, be sure to update the MasterKey and MasterSalt as described below.
-# N.B.: If you had stored data that you have previously encrypted with ESAPI 1.4,
-#		you *must* FIRST decrypt it using ESAPI 1.4 and then (if so desired)
-#		re-encrypt it with ESAPI 2.0. If you fail to do this, you will NOT be
-#		able to decrypt your data with ESAPI 2.0.
-#
-#		YOU HAVE BEEN WARNED!!! More details are in the ESAPI 2.0 Release Notes.
-#
-#===========================================================================
-# ESAPI Configuration
-#
-# If true, then print all the ESAPI properties set here when they are loaded.
-# If false, they are not printed. Useful to reduce output when running JUnit tests.
-# If you need to troubleshoot a properties related problem, turning this on may help,
-# but we leave it off for running JUnit tests. (It will be 'true' in the one delivered
-# as part of production ESAPI, mostly for backward compatibility.)
-ESAPI.printProperties=false
-
-# ESAPI is designed to be easily extensible. You can use the reference implementation
-# or implement your own providers to take advantage of your enterprise's security
-# infrastructure. The functions in ESAPI are referenced using the ESAPI locator, like:
-#
-#    String ciphertext =
-#		ESAPI.encryptor().encrypt("Secret message");   // Deprecated in 2.0
-#    CipherText cipherText =
-#		ESAPI.encryptor().encrypt(new PlainText("Secret message")); // Preferred
-#
-# Below you can specify the classname for the provider that you wish to use in your
-# application. The only requirement is that it implement the appropriate ESAPI interface.
-# This allows you to switch security implementations in the future without rewriting the
-# entire application.
-#
-# ExperimentalAccessController requires ESAPI-AccessControlPolicy.xml in .esapi directory
-ESAPI.AccessControl=org.owasp.esapi.reference.DefaultAccessController
-# FileBasedAuthenticator requires users.txt file in .esapi directory
-ESAPI.Authenticator=org.owasp.esapi.reference.FileBasedAuthenticator
-ESAPI.Encoder=org.owasp.esapi.reference.DefaultEncoder
-ESAPI.Encryptor=org.owasp.esapi.reference.crypto.JavaEncryptor
-
-ESAPI.Executor=org.owasp.esapi.reference.DefaultExecutor
-ESAPI.HTTPUtilities=org.owasp.esapi.reference.DefaultHTTPUtilities
-ESAPI.IntrusionDetector=org.owasp.esapi.reference.DefaultIntrusionDetector
-# Log4JFactory Requires log4j.xml or log4j.properties in classpath - http://www.laliluna.de/log4j-tutorial.html
-ESAPI.Logger=org.owasp.esapi.reference.Log4JLogFactory
-#ESAPI.Logger=org.owasp.esapi.reference.JavaLogFactory
-#ESAPI.Logger=org.owasp.esapi.reference.ExampleExtendedLog4JLogFactory
-ESAPI.Randomizer=org.owasp.esapi.reference.DefaultRandomizer
-ESAPI.Validator=org.owasp.esapi.reference.DefaultValidator
-
-#===========================================================================
-# ESAPI Authenticator
-#
-Authenticator.AllowedLoginAttempts=3
-Authenticator.MaxOldPasswordHashes=13
-Authenticator.UsernameParameterName=username
-Authenticator.PasswordParameterName=password
-# RememberTokenDuration (in days)
-Authenticator.RememberTokenDuration=14
-# Session Timeouts (in minutes)
-Authenticator.IdleTimeoutDuration=20
-Authenticator.AbsoluteTimeoutDuration=120
-
-#===========================================================================
-# ESAPI Encoder
-#
-# ESAPI canonicalizes input before validation to prevent bypassing filters with encoded attacks.
-# Failure to canonicalize input is a very common mistake when implementing validation schemes.
-# Canonicalization is automatic when using the ESAPI Validator, but you can also use the
-# following code to canonicalize data.
-#
-#      ESAPI.Encoder().canonicalize( "%22hello world"" );
-#  
-# Multiple encoding is when a single encoding format is applied multiple times. Allowing
-# multiple encoding is strongly discouraged.
-Encoder.AllowMultipleEncoding=false
-
-# Mixed encoding is when multiple different encoding formats are applied, or when
-# multiple formats are nested. Allowing multiple encoding is strongly discouraged.
-Encoder.AllowMixedEncoding=false
-
-# The default list of codecs to apply when canonicalizing untrusted data. The list should include the codecs
-# for all downstream interpreters or decoders. For example, if the data is likely to end up in a URL, HTML, or
-# inside JavaScript, then the list of codecs below is appropriate. The order of the list is not terribly important.
-Encoder.DefaultCodecList=HTMLEntityCodec,PercentCodec,JavaScriptCodec
-
-
-#===========================================================================
-# ESAPI Encryption
-#
-# The ESAPI Encryptor provides basic cryptographic functions with a simplified API.
-# To get started, generate a new key using java -classpath esapi.jar org.owasp.esapi.reference.crypto.JavaEncryptor
-# There is not currently any support for key rotation, so be careful when changing your key and salt as it
-# will invalidate all signed, encrypted, and hashed data.
-#
-# WARNING: Not all combinations of algorithms and key lengths are supported.
-# If you choose to use a key length greater than 128, you MUST download the
-# unlimited strength policy files and install in the lib directory of your JRE/JDK.
-# See http://java.sun.com/javase/downloads/index.jsp for more information.
-#
-# Backward compatibility with ESAPI Java 1.4 is supported by the two deprecated API
-# methods, Encryptor.encrypt(String) and Encryptor.decrypt(String). However, whenever
-# possible, these methods should be avoided as they use ECB cipher mode, which in almost
-# all circumstances a poor choice because of it's weakness. CBC cipher mode is the default
-# for the new Encryptor encrypt / decrypt methods for ESAPI Java 2.0.  In general, you
-# should only use this compatibility setting if you have persistent data encrypted with
-# version 1.4 and even then, you should ONLY set this compatibility mode UNTIL
-# you have decrypted all of your old encrypted data and then re-encrypted it with
-# ESAPI 2.0 using CBC mode. If you have some reason to mix the deprecated 1.4 mode
-# with the new 2.0 methods, make sure that you use the same cipher algorithm for both
-# (256-bit AES was the default for 1.4; 128-bit is the default for 2.0; see below for
-# more details.) Otherwise, you will have to use the new 2.0 encrypt / decrypt methods
-# where you can specify a SecretKey. (Note that if you are using the 256-bit AES,
-# that requires downloading the special jurisdiction policy files mentioned above.)
-#
-#		***** IMPORTANT: These are for JUnit testing. Test files may have been
-#						 encrypted using these values so do not change these or
-#						 those tests will fail. The version under
-#							src/main/resources/.esapi/ESAPI.properties
-#						 will be delivered with Encryptor.MasterKey and
-#						 Encryptor.MasterSalt set to the empty string.
-#
-#						 FINAL NOTE:
-#                           If Maven changes these when run, that needs to be fixed.
-#       256-bit key... requires unlimited strength jurisdiction policy files
-### Encryptor.MasterKey=pJhlri8JbuFYDgkqtHmm9s0Ziug2PE7ovZDyEPm4j14=
-#       128-bit key
-Encryptor.MasterKey=a6H9is3hEVGKB4Jut+lOVA==
-Encryptor.MasterSalt=SbftnvmEWD5ZHHP+pX3fqugNysc=
-# Encryptor.MasterSalt=
-
-# Provides the default JCE provider that ESAPI will "prefer" for its symmetric
-# encryption and hashing. (That is it will look to this provider first, but it
-# will defer to other providers if the requested algorithm is not implemented
-# by this provider.) If left unset, ESAPI will just use your Java VM's current
-# preferred JCE provider, which is generally set in the file
-# "$JAVA_HOME/jre/lib/security/java.security".
-#
-# The main intent of this is to allow ESAPI symmetric encryption to be
-# used with a FIPS 140-2 compliant crypto-module. For details, see the section
-# "Using ESAPI Symmetric Encryption with FIPS 140-2 Cryptographic Modules" in
-# the ESAPI 2.0 Symmetric Encryption User Guide, at:
-# http://owasp-esapi-java.googlecode.com/svn/trunk/documentation/esapi4java-core-2.0-symmetric-crypto-user-guide.html
-# However, this property also allows you to easily use an alternate JCE provider
-# such as "Bouncy Castle" without having to make changes to "java.security".
-# See Javadoc for SecurityProviderLoader for further details. If you wish to use
-# a provider that is not known to SecurityProviderLoader, you may specify the
-# fully-qualified class name of the JCE provider class that implements
-# java.security.Provider. If the name contains a '.', this is interpreted as
-# a fully-qualified class name that implements java.security.Provider.
-#
-# NOTE: Setting this property has the side-effect of changing it in your application
-#       as well, so if you are using JCE in your application directly rather than
-#       through ESAPI (you wouldn't do that, would you? ;-), it will change the
-#       preferred JCE provider there as well.
-#
-# Default: Keeps the JCE provider set to whatever JVM sets it to.
-Encryptor.PreferredJCEProvider=
-
-# AES is the most widely used and strongest encryption algorithm. This
-# should agree with your Encryptor.CipherTransformation property.
-# By default, ESAPI Java 1.4 uses "PBEWithMD5AndDES" and which is
-# very weak. It is essentially a password-based encryption key, hashed
-# with MD5 around 1K times and then encrypted with the weak DES algorithm
-# (56-bits) using ECB mode and an unspecified padding (it is
-# JCE provider specific, but most likely "NoPadding"). However, 2.0 uses
-# "AES/CBC/PKCSPadding". If you want to change these, change them here.
-# Warning: This property does not control the default reference implementation for
-#		   ESAPI 2.0 using JavaEncryptor. Also, this property will be dropped
-#		   in the future.
-# @deprecated
-Encryptor.EncryptionAlgorithm=AES
-#		For ESAPI Java 2.0 - New encrypt / decrypt methods use this.
-Encryptor.CipherTransformation=AES/CBC/PKCS5Padding
-
-# Applies to ESAPI 2.0 and later only!
-# Comma-separated list of cipher modes that provide *BOTH*
-# confidentiality *AND* message authenticity. (NIST refers to such cipher
-# modes as "combined modes" so that's what we shall call them.) If any of these
-# cipher modes are used then no MAC is calculated and stored
-# in the CipherText upon encryption. Likewise, if one of these
-# cipher modes is used with decryption, no attempt will be made
-# to validate the MAC contained in the CipherText object regardless
-# of whether it contains one or not. Since the expectation is that
-# these cipher modes support support message authenticity already,
-# injecting a MAC in the CipherText object would be at best redundant.
-#
-# Note that as of JDK 1.5, the SunJCE provider does not support *any*
-# of these cipher modes. Of these listed, only GCM and CCM are currently
-# NIST approved. YMMV for other JCE providers. E.g., Bouncy Castle supports
-# GCM and CCM with "NoPadding" mode, but not with "PKCS5Padding" or other
-# padding modes.
-Encryptor.cipher_modes.combined_modes=GCM,CCM,IAPM,EAX,OCB,CWC
-
-# Applies to ESAPI 2.0 and later only!
-# Additional cipher modes allowed for ESAPI 2.0 encryption. These
-# cipher modes are in _addition_ to those specified by the property
-# 'Encryptor.cipher_modes.combined_modes'.
-# Note: We will add support for streaming modes like CFB & OFB once
-# we add support for 'specified' to the property 'Encryptor.ChooseIVMethod'
-# (probably in ESAPI 2.1).
-#
-#	IMPORTANT NOTE:	In the official ESAPI.properties we do *NOT* include ECB
-#					here as this is an extremely weak mode. However, we *must*
-#					allow it here so we can test ECB mode. That is important
-#					since the logic is somewhat different (i.e., ECB mode does
-#					not use an IV).
-# DISCUSS: Better name?
-#	NOTE: ECB added only for testing purposes. Don't try this at home!
-Encryptor.cipher_modes.additional_allowed=CBC,ECB
-
-# 128-bit is almost always sufficient and appears to be more resistant to
-# related key attacks than is 256-bit AES. Use '_' to use default key size
-# for cipher algorithms (where it makes sense because the algorithm supports
-# a variable key size). Key length must agree to what's provided as the
-# cipher transformation, otherwise this will be ignored after logging a
-# warning.
-#
-# NOTE: This is what applies BOTH ESAPI 1.4 and 2.0. See warning above about mixing!
-Encryptor.EncryptionKeyLength=128
-
-# Because 2.0 uses CBC mode by default, it requires an initialization vector (IV).
-# (All cipher modes except ECB require an IV.) There are two choices: we can either
-# use a fixed IV known to both parties or allow ESAPI to choose a random IV. While
-# the IV does not need to be hidden from adversaries, it is important that the
-# adversary not be allowed to choose it. Also, random IVs are generally much more
-# secure than fixed IVs. (In fact, it is essential that feed-back cipher modes
-# such as CFB and OFB use a different IV for each encryption with a given key so
-# in such cases, random IVs are much preferred. By default, ESAPI 2.0 uses random
-# IVs. If you wish to use 'fixed' IVs, set 'Encryptor.ChooseIVMethod=fixed' and
-# uncomment the Encryptor.fixedIV.
-#
-# Valid values:		random|fixed|specified		'specified' not yet implemented; planned for 2.1
-Encryptor.ChooseIVMethod=random
-# If you choose to use a fixed IV, then you must place a fixed IV here that
-# is known to all others who are sharing your secret key. The format should
-# be a hex string that is the same length as the cipher block size for the
-# cipher algorithm that you are using. The following is an example for AES
-# from an AES test vector for AES-128/CBC as described in:
-# NIST Special Publication 800-38A (2001 Edition)
-# "Recommendation for Block Cipher Modes of Operation".
-# (Note that the block size for AES is 16 bytes == 128 bits.)
-#
-Encryptor.fixedIV=0x000102030405060708090a0b0c0d0e0f
-
-# Whether or not CipherText should use a message authentication code (MAC) with it.
-# This prevents an adversary from altering the IV as well as allowing a more
-# fool-proof way of determining the decryption failed because of an incorrect
-# key being supplied. This refers to the "separate" MAC calculated and stored
-# in CipherText, not part of any MAC that is calculated as a result of a
-# "combined mode" cipher mode.
-#
-# If you are using ESAPI with a FIPS 140-2 cryptographic module, you *must* also
-# set this property to false.
-Encryptor.CipherText.useMAC=true
-
-# Whether or not the PlainText object may be overwritten and then marked
-# eligible for garbage collection. If not set, this is still treated as 'true'.
-Encryptor.PlainText.overwrite=true
-
-# Do not use DES except in a legacy situations. 56-bit is way too small key size.
-#Encryptor.EncryptionKeyLength=56
-#Encryptor.EncryptionAlgorithm=DES
-
-# TripleDES is considered strong enough for most purposes.
-#	Note:	There is also a 112-bit version of DESede. Using the 168-bit version
-#			requires downloading the special jurisdiction policy from Sun.
-#Encryptor.EncryptionKeyLength=168
-#Encryptor.EncryptionAlgorithm=DESede
-
-Encryptor.HashAlgorithm=SHA-512
-Encryptor.HashIterations=1024
-Encryptor.DigitalSignatureAlgorithm=SHA1withDSA
-Encryptor.DigitalSignatureKeyLength=1024
-Encryptor.RandomAlgorithm=SHA1PRNG
-Encryptor.CharacterEncoding=UTF-8
-# Currently supported choices for JDK 1.5 and 1.6 are:
-#	HmacSHA1 (160 bits), HmacSHA256 (256 bits), HmacSHA384 (384 bits), and
-#	HmacSHA512 (512 bits).
-# Note that HmacMD5 is *not* supported for the PRF used by the KDF even though
-# these JDKs support it.
-Encryptor.KDF.PRF=HmacSHA256
-
-#===========================================================================
-# ESAPI HttpUtilties
-#
-# The HttpUtilities provide basic protections to HTTP requests and responses. Primarily these methods 
-# protect against malicious data from attackers, such as unprintable characters, escaped characters,
-# and other simple attacks. The HttpUtilities also provides utility methods for dealing with cookies,
-# headers, and CSRF tokens.
-#
-# Default file upload location (remember to escape backslashes with \\)
-HttpUtilities.UploadDir=C:\\ESAPI\\testUpload
-# let this default to java.io.tmpdir for testing
-#HttpUtilities.UploadTempDir=C:\\temp
-# Force flags on cookies, if you use HttpUtilities to set cookies
-HttpUtilities.ForceHttpOnlySession=false
-HttpUtilities.ForceSecureSession=false
-HttpUtilities.ForceHttpOnlyCookies=true
-HttpUtilities.ForceSecureCookies=true
-# Maximum size of HTTP headers
-HttpUtilities.MaxHeaderSize=4096
-# File upload configuration
-HttpUtilities.ApprovedUploadExtensions=.zip,.pdf,.doc,.docx,.ppt,.pptx,.tar,.gz,.tgz,.rar,.war,.jar,.ear,.xls,.rtf,.properties,.java,.class,.txt,.xml,.jsp,.jsf,.exe,.dll
-HttpUtilities.MaxUploadFileBytes=500000000
-# Using UTF-8 throughout your stack is highly recommended. That includes your database driver,
-# container, and any other technologies you may be using. Failure to do this may expose you
-# to Unicode transcoding injection attacks. Use of UTF-8 does not hinder internationalization.
-HttpUtilities.ResponseContentType=text/html; charset=UTF-8
-# This is the name of the cookie used to represent the HTTP session
-# Typically this will be the default "JSESSIONID" 
-HttpUtilities.HttpSessionIdName=JSESSIONID
-
-
-
-#===========================================================================
-# ESAPI Executor
-# CHECKME - Not sure what this is used for, but surely it should be made OS independent.
-Executor.WorkingDirectory=C:\\Windows\\Temp
-Executor.ApprovedExecutables=C:\\Windows\\System32\\cmd.exe,C:\\Windows\\System32\\runas.exe
-
-
-#===========================================================================
-# ESAPI Logging
-# Set the application name if these logs are combined with other applications
-Logger.ApplicationName=ExampleApplication
-# If you use an HTML log viewer that does not properly HTML escape log data, you can set LogEncodingRequired to true
-Logger.LogEncodingRequired=false
-# Determines whether ESAPI should log the application name. This might be clutter in some single-server/single-app environments.
-Logger.LogApplicationName=true
-# Determines whether ESAPI should log the server IP and port. This might be clutter in some single-server environments.
-Logger.LogServerIP=true
-# LogFileName, the name of the logging file. Provide a full directory path (e.g., C:\\ESAPI\\ESAPI_logging_file) if you
-# want to place it in a specific directory.
-Logger.LogFileName=ESAPI_logging_file
-# MaxLogFileSize, the max size (in bytes) of a single log file before it cuts over to a new one (default is 10,000,000)
-Logger.MaxLogFileSize=10000000
-
-
-#===========================================================================
-# ESAPI Intrusion Detection
-#
-# Each event has a base to which .count, .interval, and .action are added
-# The IntrusionException will fire if we receive "count" events within "interval" seconds
-# The IntrusionDetector is configurable to take the following actions: log, logout, and disable
-#  (multiple actions separated by commas are allowed e.g. event.test.actions=log,disable
-#
-# Custom Events
-# Names must start with "event." as the base
-# Use IntrusionDetector.addEvent( "test" ) in your code to trigger "event.test" here
-# You can also disable intrusion detection completely by changing
-# the following parameter to true
-#
-IntrusionDetector.Disable=false
-#
-IntrusionDetector.event.test.count=2
-IntrusionDetector.event.test.interval=10
-IntrusionDetector.event.test.actions=disable,log
-
-# Exception Events
-# All EnterpriseSecurityExceptions are registered automatically
-# Call IntrusionDetector.getInstance().addException(e) for Exceptions that do not extend EnterpriseSecurityException
-# Use the fully qualified classname of the exception as the base
-
-# any intrusion is an attack
-IntrusionDetector.org.owasp.esapi.errors.IntrusionException.count=1
-IntrusionDetector.org.owasp.esapi.errors.IntrusionException.interval=1
-IntrusionDetector.org.owasp.esapi.errors.IntrusionException.actions=log,disable,logout
-
-# for test purposes
-# CHECKME: Shouldn't there be something in the property name itself that designates
-#		   that these are for testing???
-IntrusionDetector.org.owasp.esapi.errors.IntegrityException.count=10
-IntrusionDetector.org.owasp.esapi.errors.IntegrityException.interval=5
-IntrusionDetector.org.owasp.esapi.errors.IntegrityException.actions=log,disable,logout
-
-# rapid validation errors indicate scans or attacks in progress
-# org.owasp.esapi.errors.ValidationException.count=10
-# org.owasp.esapi.errors.ValidationException.interval=10
-# org.owasp.esapi.errors.ValidationException.actions=log,logout
-
-# sessions jumping between hosts indicates session hijacking
-IntrusionDetector.org.owasp.esapi.errors.AuthenticationHostException.count=2
-IntrusionDetector.org.owasp.esapi.errors.AuthenticationHostException.interval=10
-IntrusionDetector.org.owasp.esapi.errors.AuthenticationHostException.actions=log,logout
-
-
-#===========================================================================
-# ESAPI Validation
-#
-# The ESAPI Validator works on regular expressions with defined names. You can define names
-# either here, or you may define application specific patterns in a separate file defined below.
-# This allows enterprises to specify both organizational standards as well as application specific
-# validation rules.
-#
-Validator.ConfigurationFile.MultiValued=true
-Validator.ConfigurationFile="validation-test,comma.properties",validation-test1.properties,validation-test2.properties
-
-# Validators used by ESAPI
-Validator.AccountName=^[a-zA-Z0-9]{3,20}$
-Validator.SystemCommand=^[a-zA-Z\\-\\/]{1,64}$
-Validator.RoleName=^[a-z]{1,20}$
-Validator.Redirect=^\\/test.*$
-
-# Global HTTP Validation Rules
-# Values with Base64 encoded data (e.g. encrypted state) will need at least [a-zA-Z0-9\/+=]
-Validator.HTTPScheme=^(http|https)$
-Validator.HTTPServerName=^[a-zA-Z0-9_.\\-]*$
-Validator.HTTPCookieName=^[a-zA-Z0-9\\-_]{1,32}$
-Validator.HTTPCookieValue=^[a-zA-Z0-9\\-\\/+=_ ]*$
-Validator.HTTPHeaderName=^[a-zA-Z0-9\\-_]{1,32}$
-Validator.HTTPHeaderValue=^[a-zA-Z0-9()\\-=\\*\\.\\?;,+\\/:&_ ]*$
-Validator.HTTPServletPath=^[a-zA-Z0-9.\\-\\/_]*$
-Validator.HTTPPath=^[a-zA-Z0-9.\\-_]*$
-Validator.HTTPURL=^.*$
-Validator.HTTPJSESSIONID=^[A-Z0-9]{10,30}$
-
-# Contributed by Fraenku@gmx.ch
-# Googlecode Issue 116 (http://code.google.com/p/owasp-esapi-java/issues/detail?id=116)
-Validator.HTTPParameterName=^[a-zA-Z0-9_\\-]{1,32}$
-Validator.HTTPParameterValue=^[\\p{L}\\p{N}.\\-/+=_ !$*?@]{0,1000}$
-Validator.HTTPContextPath=^/[a-zA-Z0-9.\\-_]*$
-Validator.HTTPQueryString=^([a-zA-Z0-9_\\-]{1,32}=[\\p{L}\\p{N}.\\-/+=_ !$*?@%]*&?)*$
-Validator.HTTPURI=^/([a-zA-Z0-9.\\-_]*/?)*$
-
-
-# Validation of file related input
-Validator.FileName=^[a-zA-Z0-9!@#$%^&{}\\[\\]()_+\\-=,.~'` ]{1,255}$
-Validator.DirectoryName=^[a-zA-Z0-9:/\\\\!@#$%^&{}\\[\\]()_+\\-=,.~'` ]{1,255}$
-
-# Validation of dates. Controls whether or not 'lenient' dates are accepted.
-# See DataFormat.setLenient(boolean flag) for further details.
+#
+# OWASP Enterprise Security API (ESAPI) Properties file -- TEST Version
+# 
+# This file is part of the Open Web Application Security Project (OWASP)
+# Enterprise Security API (ESAPI) project. For details, please see
+# http://www.owasp.org/index.php/ESAPI.
+#
+# Copyright (c) 2008,2009 - The OWASP Foundation
+#
+# DISCUSS: This may cause a major backwards compatibility issue, etc. but
+#		   from a name space perspective, we probably should have prefaced
+#		   all the property names with ESAPI or at least OWASP. Otherwise
+#		   there could be problems is someone loads this properties file into
+#		   the System properties.  We could also put this file into the
+#		   esapi.jar file (perhaps as a ResourceBundle) and then allow an external
+#		   ESAPI properties be defined that would overwrite these defaults.
+#		   That keeps the application's properties relatively simple as usually
+#		   they will only want to override a few properties. If looks like we
+#		   already support multiple override levels of this in the
+#		   DefaultSecurityConfiguration class, but I'm suggesting placing the
+#		   defaults in the esapi.jar itself. That way, if the jar is signed,
+#		   we could detect if those properties had been tampered with. (The
+#		   code to check the jar signatures is pretty simple... maybe 70-90 LOC,
+#		   but off course there is an execution penalty (similar to the way
+#		   that the separate sunjce.jar used to be when a class from it was
+#		   first loaded). Thoughts?
+###############################################################################
+#
+# WARNING: Operating system protection should be used to lock down the .esapi
+# resources directory and all the files inside and all the directories all the
+# way up to the root directory of the file system.  Note that if you are using
+# file-based implementations, that some files may need to be read-write as they
+# get updated dynamically.
+#
+# Before using, be sure to update the MasterKey and MasterSalt as described below.
+# N.B.: If you had stored data that you have previously encrypted with ESAPI 1.4,
+#		you *must* FIRST decrypt it using ESAPI 1.4 and then (if so desired)
+#		re-encrypt it with ESAPI 2.0. If you fail to do this, you will NOT be
+#		able to decrypt your data with ESAPI 2.0.
+#
+#		YOU HAVE BEEN WARNED!!! More details are in the ESAPI 2.0 Release Notes.
+#
+#===========================================================================
+# ESAPI Configuration
+#
+# If true, then print all the ESAPI properties set here when they are loaded.
+# If false, they are not printed. Useful to reduce output when running JUnit tests.
+# If you need to troubleshoot a properties related problem, turning this on may help,
+# but we leave it off for running JUnit tests. (It will be 'true' in the one delivered
+# as part of production ESAPI, mostly for backward compatibility.)
+ESAPI.printProperties=false
+
+# ESAPI is designed to be easily extensible. You can use the reference implementation
+# or implement your own providers to take advantage of your enterprise's security
+# infrastructure. The functions in ESAPI are referenced using the ESAPI locator, like:
+#
+#    String ciphertext =
+#		ESAPI.encryptor().encrypt("Secret message");   // Deprecated in 2.0
+#    CipherText cipherText =
+#		ESAPI.encryptor().encrypt(new PlainText("Secret message")); // Preferred
+#
+# Below you can specify the classname for the provider that you wish to use in your
+# application. The only requirement is that it implement the appropriate ESAPI interface.
+# This allows you to switch security implementations in the future without rewriting the
+# entire application.
+#
+# ExperimentalAccessController requires ESAPI-AccessControlPolicy.xml in .esapi directory
+ESAPI.AccessControl=org.owasp.esapi.reference.DefaultAccessController
+# FileBasedAuthenticator requires users.txt file in .esapi directory
+ESAPI.Authenticator=org.owasp.esapi.reference.FileBasedAuthenticator
+ESAPI.Encoder=org.owasp.esapi.reference.DefaultEncoder
+ESAPI.Encryptor=org.owasp.esapi.reference.crypto.JavaEncryptor
+
+ESAPI.Executor=org.owasp.esapi.reference.DefaultExecutor
+ESAPI.HTTPUtilities=org.owasp.esapi.reference.DefaultHTTPUtilities
+ESAPI.IntrusionDetector=org.owasp.esapi.reference.DefaultIntrusionDetector
+# Log4JFactory Requires log4j.xml or log4j.properties in classpath - http://www.laliluna.de/log4j-tutorial.html
+ESAPI.Logger=org.owasp.esapi.reference.Log4JLogFactory
+#ESAPI.Logger=org.owasp.esapi.reference.JavaLogFactory
+#ESAPI.Logger=org.owasp.esapi.reference.ExampleExtendedLog4JLogFactory
+ESAPI.Randomizer=org.owasp.esapi.reference.DefaultRandomizer
+ESAPI.Validator=org.owasp.esapi.reference.DefaultValidator
+
+#===========================================================================
+# ESAPI Authenticator
+#
+Authenticator.AllowedLoginAttempts=3
+Authenticator.MaxOldPasswordHashes=13
+Authenticator.UsernameParameterName=username
+Authenticator.PasswordParameterName=password
+# RememberTokenDuration (in days)
+Authenticator.RememberTokenDuration=14
+# Session Timeouts (in minutes)
+Authenticator.IdleTimeoutDuration=20
+Authenticator.AbsoluteTimeoutDuration=120
+
+#===========================================================================
+# ESAPI Encoder
+#
+# ESAPI canonicalizes input before validation to prevent bypassing filters with encoded attacks.
+# Failure to canonicalize input is a very common mistake when implementing validation schemes.
+# Canonicalization is automatic when using the ESAPI Validator, but you can also use the
+# following code to canonicalize data.
+#
+#      ESAPI.Encoder().canonicalize( "%22hello world"" );
+#  
+# Multiple encoding is when a single encoding format is applied multiple times. Allowing
+# multiple encoding is strongly discouraged.
+Encoder.AllowMultipleEncoding=false
+
+# Mixed encoding is when multiple different encoding formats are applied, or when
+# multiple formats are nested. Allowing multiple encoding is strongly discouraged.
+Encoder.AllowMixedEncoding=false
+
+# The default list of codecs to apply when canonicalizing untrusted data. The list should include the codecs
+# for all downstream interpreters or decoders. For example, if the data is likely to end up in a URL, HTML, or
+# inside JavaScript, then the list of codecs below is appropriate. The order of the list is not terribly important.
+Encoder.DefaultCodecList=HTMLEntityCodec,PercentCodec,JavaScriptCodec
+
+
+#===========================================================================
+# ESAPI Encryption
+#
+# The ESAPI Encryptor provides basic cryptographic functions with a simplified API.
+# To get started, generate a new key using java -classpath esapi.jar org.owasp.esapi.reference.crypto.JavaEncryptor
+# There is not currently any support for key rotation, so be careful when changing your key and salt as it
+# will invalidate all signed, encrypted, and hashed data.
+#
+# WARNING: Not all combinations of algorithms and key lengths are supported.
+# If you choose to use a key length greater than 128, you MUST download the
+# unlimited strength policy files and install in the lib directory of your JRE/JDK.
+# See http://java.sun.com/javase/downloads/index.jsp for more information.
+#
+# Backward compatibility with ESAPI Java 1.4 is supported by the two deprecated API
+# methods, Encryptor.encrypt(String) and Encryptor.decrypt(String). However, whenever
+# possible, these methods should be avoided as they use ECB cipher mode, which in almost
+# all circumstances a poor choice because of it's weakness. CBC cipher mode is the default
+# for the new Encryptor encrypt / decrypt methods for ESAPI Java 2.0.  In general, you
+# should only use this compatibility setting if you have persistent data encrypted with
+# version 1.4 and even then, you should ONLY set this compatibility mode UNTIL
+# you have decrypted all of your old encrypted data and then re-encrypted it with
+# ESAPI 2.0 using CBC mode. If you have some reason to mix the deprecated 1.4 mode
+# with the new 2.0 methods, make sure that you use the same cipher algorithm for both
+# (256-bit AES was the default for 1.4; 128-bit is the default for 2.0; see below for
+# more details.) Otherwise, you will have to use the new 2.0 encrypt / decrypt methods
+# where you can specify a SecretKey. (Note that if you are using the 256-bit AES,
+# that requires downloading the special jurisdiction policy files mentioned above.)
+#
+#		***** IMPORTANT: These are for JUnit testing. Test files may have been
+#						 encrypted using these values so do not change these or
+#						 those tests will fail. The version under
+#							src/main/resources/.esapi/ESAPI.properties
+#						 will be delivered with Encryptor.MasterKey and
+#						 Encryptor.MasterSalt set to the empty string.
+#
+#						 FINAL NOTE:
+#                           If Maven changes these when run, that needs to be fixed.
+#       256-bit key... requires unlimited strength jurisdiction policy files
+### Encryptor.MasterKey=pJhlri8JbuFYDgkqtHmm9s0Ziug2PE7ovZDyEPm4j14=
+#       128-bit key
+Encryptor.MasterKey=a6H9is3hEVGKB4Jut+lOVA==
+Encryptor.MasterSalt=SbftnvmEWD5ZHHP+pX3fqugNysc=
+# Encryptor.MasterSalt=
+
+# Provides the default JCE provider that ESAPI will "prefer" for its symmetric
+# encryption and hashing. (That is it will look to this provider first, but it
+# will defer to other providers if the requested algorithm is not implemented
+# by this provider.) If left unset, ESAPI will just use your Java VM's current
+# preferred JCE provider, which is generally set in the file
+# "$JAVA_HOME/jre/lib/security/java.security".
+#
+# The main intent of this is to allow ESAPI symmetric encryption to be
+# used with a FIPS 140-2 compliant crypto-module. For details, see the section
+# "Using ESAPI Symmetric Encryption with FIPS 140-2 Cryptographic Modules" in
+# the ESAPI 2.0 Symmetric Encryption User Guide, at:
+# http://owasp-esapi-java.googlecode.com/svn/trunk/documentation/esapi4java-core-2.0-symmetric-crypto-user-guide.html
+# However, this property also allows you to easily use an alternate JCE provider
+# such as "Bouncy Castle" without having to make changes to "java.security".
+# See Javadoc for SecurityProviderLoader for further details. If you wish to use
+# a provider that is not known to SecurityProviderLoader, you may specify the
+# fully-qualified class name of the JCE provider class that implements
+# java.security.Provider. If the name contains a '.', this is interpreted as
+# a fully-qualified class name that implements java.security.Provider.
+#
+# NOTE: Setting this property has the side-effect of changing it in your application
+#       as well, so if you are using JCE in your application directly rather than
+#       through ESAPI (you wouldn't do that, would you? ;-), it will change the
+#       preferred JCE provider there as well.
+#
+# Default: Keeps the JCE provider set to whatever JVM sets it to.
+Encryptor.PreferredJCEProvider=
+
+# AES is the most widely used and strongest encryption algorithm. This
+# should agree with your Encryptor.CipherTransformation property.
+# By default, ESAPI Java 1.4 uses "PBEWithMD5AndDES" and which is
+# very weak. It is essentially a password-based encryption key, hashed
+# with MD5 around 1K times and then encrypted with the weak DES algorithm
+# (56-bits) using ECB mode and an unspecified padding (it is
+# JCE provider specific, but most likely "NoPadding"). However, 2.0 uses
+# "AES/CBC/PKCSPadding". If you want to change these, change them here.
+# Warning: This property does not control the default reference implementation for
+#		   ESAPI 2.0 using JavaEncryptor. Also, this property will be dropped
+#		   in the future.
+# @deprecated
+Encryptor.EncryptionAlgorithm=AES
+#		For ESAPI Java 2.0 - New encrypt / decrypt methods use this.
+Encryptor.CipherTransformation=AES/CBC/PKCS5Padding
+
+# Applies to ESAPI 2.0 and later only!
+# Comma-separated list of cipher modes that provide *BOTH*
+# confidentiality *AND* message authenticity. (NIST refers to such cipher
+# modes as "combined modes" so that's what we shall call them.) If any of these
+# cipher modes are used then no MAC is calculated and stored
+# in the CipherText upon encryption. Likewise, if one of these
+# cipher modes is used with decryption, no attempt will be made
+# to validate the MAC contained in the CipherText object regardless
+# of whether it contains one or not. Since the expectation is that
+# these cipher modes support support message authenticity already,
+# injecting a MAC in the CipherText object would be at best redundant.
+#
+# Note that as of JDK 1.5, the SunJCE provider does not support *any*
+# of these cipher modes. Of these listed, only GCM and CCM are currently
+# NIST approved. YMMV for other JCE providers. E.g., Bouncy Castle supports
+# GCM and CCM with "NoPadding" mode, but not with "PKCS5Padding" or other
+# padding modes.
+Encryptor.cipher_modes.combined_modes=GCM,CCM,IAPM,EAX,OCB,CWC
+
+# Applies to ESAPI 2.0 and later only!
+# Additional cipher modes allowed for ESAPI 2.0 encryption. These
+# cipher modes are in _addition_ to those specified by the property
+# 'Encryptor.cipher_modes.combined_modes'.
+# Note: We will add support for streaming modes like CFB & OFB once
+# we add support for 'specified' to the property 'Encryptor.ChooseIVMethod'
+# (probably in ESAPI 2.1).
+#
+#	IMPORTANT NOTE:	In the official ESAPI.properties we do *NOT* include ECB
+#					here as this is an extremely weak mode. However, we *must*
+#					allow it here so we can test ECB mode. That is important
+#					since the logic is somewhat different (i.e., ECB mode does
+#					not use an IV).
+# DISCUSS: Better name?
+#	NOTE: ECB added only for testing purposes. Don't try this at home!
+Encryptor.cipher_modes.additional_allowed=CBC,ECB
+
+# 128-bit is almost always sufficient and appears to be more resistant to
+# related key attacks than is 256-bit AES. Use '_' to use default key size
+# for cipher algorithms (where it makes sense because the algorithm supports
+# a variable key size). Key length must agree to what's provided as the
+# cipher transformation, otherwise this will be ignored after logging a
+# warning.
+#
+# NOTE: This is what applies BOTH ESAPI 1.4 and 2.0. See warning above about mixing!
+Encryptor.EncryptionKeyLength=128
+
+# Because 2.0 uses CBC mode by default, it requires an initialization vector (IV).
+# (All cipher modes except ECB require an IV.) There are two choices: we can either
+# use a fixed IV known to both parties or allow ESAPI to choose a random IV. While
+# the IV does not need to be hidden from adversaries, it is important that the
+# adversary not be allowed to choose it. Also, random IVs are generally much more
+# secure than fixed IVs. (In fact, it is essential that feed-back cipher modes
+# such as CFB and OFB use a different IV for each encryption with a given key so
+# in such cases, random IVs are much preferred. By default, ESAPI 2.0 uses random
+# IVs. If you wish to use 'fixed' IVs, set 'Encryptor.ChooseIVMethod=fixed' and
+# uncomment the Encryptor.fixedIV.
+#
+# Valid values:		random|fixed|specified		'specified' not yet implemented; planned for 2.1
+Encryptor.ChooseIVMethod=random
+# If you choose to use a fixed IV, then you must place a fixed IV here that
+# is known to all others who are sharing your secret key. The format should
+# be a hex string that is the same length as the cipher block size for the
+# cipher algorithm that you are using. The following is an example for AES
+# from an AES test vector for AES-128/CBC as described in:
+# NIST Special Publication 800-38A (2001 Edition)
+# "Recommendation for Block Cipher Modes of Operation".
+# (Note that the block size for AES is 16 bytes == 128 bits.)
+#
+Encryptor.fixedIV=0x000102030405060708090a0b0c0d0e0f
+
+# Whether or not CipherText should use a message authentication code (MAC) with it.
+# This prevents an adversary from altering the IV as well as allowing a more
+# fool-proof way of determining the decryption failed because of an incorrect
+# key being supplied. This refers to the "separate" MAC calculated and stored
+# in CipherText, not part of any MAC that is calculated as a result of a
+# "combined mode" cipher mode.
+#
+# If you are using ESAPI with a FIPS 140-2 cryptographic module, you *must* also
+# set this property to false.
+Encryptor.CipherText.useMAC=true
+
+# Whether or not the PlainText object may be overwritten and then marked
+# eligible for garbage collection. If not set, this is still treated as 'true'.
+Encryptor.PlainText.overwrite=true
+
+# Do not use DES except in a legacy situations. 56-bit is way too small key size.
+#Encryptor.EncryptionKeyLength=56
+#Encryptor.EncryptionAlgorithm=DES
+
+# TripleDES is considered strong enough for most purposes.
+#	Note:	There is also a 112-bit version of DESede. Using the 168-bit version
+#			requires downloading the special jurisdiction policy from Sun.
+#Encryptor.EncryptionKeyLength=168
+#Encryptor.EncryptionAlgorithm=DESede
+
+Encryptor.HashAlgorithm=SHA-512
+Encryptor.HashIterations=1024
+Encryptor.DigitalSignatureAlgorithm=SHA1withDSA
+Encryptor.DigitalSignatureKeyLength=1024
+Encryptor.RandomAlgorithm=SHA1PRNG
+Encryptor.CharacterEncoding=UTF-8
+# Currently supported choices for JDK 1.5 and 1.6 are:
+#	HmacSHA1 (160 bits), HmacSHA256 (256 bits), HmacSHA384 (384 bits), and
+#	HmacSHA512 (512 bits).
+# Note that HmacMD5 is *not* supported for the PRF used by the KDF even though
+# these JDKs support it.
+Encryptor.KDF.PRF=HmacSHA256
+
+#===========================================================================
+# ESAPI HttpUtilties
+#
+# The HttpUtilities provide basic protections to HTTP requests and responses. Primarily these methods 
+# protect against malicious data from attackers, such as unprintable characters, escaped characters,
+# and other simple attacks. The HttpUtilities also provides utility methods for dealing with cookies,
+# headers, and CSRF tokens.
+#
+# Default file upload location (remember to escape backslashes with \\)
+HttpUtilities.UploadDir=C:\\ESAPI\\testUpload
+# let this default to java.io.tmpdir for testing
+#HttpUtilities.UploadTempDir=C:\\temp
+# Force flags on cookies, if you use HttpUtilities to set cookies
+HttpUtilities.ForceHttpOnlySession=false
+HttpUtilities.ForceSecureSession=false
+HttpUtilities.ForceHttpOnlyCookies=true
+HttpUtilities.ForceSecureCookies=true
+# Maximum size of HTTP headers
+HttpUtilities.MaxHeaderSize=4096
+# File upload configuration
+HttpUtilities.ApprovedUploadExtensions=.zip,.pdf,.doc,.docx,.ppt,.pptx,.tar,.gz,.tgz,.rar,.war,.jar,.ear,.xls,.rtf,.properties,.java,.class,.txt,.xml,.jsp,.jsf,.exe,.dll
+HttpUtilities.MaxUploadFileBytes=500000000
+# Using UTF-8 throughout your stack is highly recommended. That includes your database driver,
+# container, and any other technologies you may be using. Failure to do this may expose you
+# to Unicode transcoding injection attacks. Use of UTF-8 does not hinder internationalization.
+HttpUtilities.ResponseContentType=text/html; charset=UTF-8
+# This is the name of the cookie used to represent the HTTP session
+# Typically this will be the default "JSESSIONID" 
+HttpUtilities.HttpSessionIdName=JSESSIONID
+
+
+
+#===========================================================================
+# ESAPI Executor
+# CHECKME - Not sure what this is used for, but surely it should be made OS independent.
+Executor.WorkingDirectory=C:\\Windows\\Temp
+Executor.ApprovedExecutables=C:\\Windows\\System32\\cmd.exe,C:\\Windows\\System32\\runas.exe
+
+
+#===========================================================================
+# ESAPI Logging
+# Set the application name if these logs are combined with other applications
+Logger.ApplicationName=ExampleApplication
+# If you use an HTML log viewer that does not properly HTML escape log data, you can set LogEncodingRequired to true
+Logger.LogEncodingRequired=false
+# Determines whether ESAPI should log the application name. This might be clutter in some single-server/single-app environments.
+Logger.LogApplicationName=true
+# Determines whether ESAPI should log the server IP and port. This might be clutter in some single-server environments.
+Logger.LogServerIP=true
+# LogFileName, the name of the logging file. Provide a full directory path (e.g., C:\\ESAPI\\ESAPI_logging_file) if you
+# want to place it in a specific directory.
+Logger.LogFileName=ESAPI_logging_file
+# MaxLogFileSize, the max size (in bytes) of a single log file before it cuts over to a new one (default is 10,000,000)
+Logger.MaxLogFileSize=10000000
+
+
+#===========================================================================
+# ESAPI Intrusion Detection
+#
+# Each event has a base to which .count, .interval, and .action are added
+# The IntrusionException will fire if we receive "count" events within "interval" seconds
+# The IntrusionDetector is configurable to take the following actions: log, logout, and disable
+#  (multiple actions separated by commas are allowed e.g. event.test.actions=log,disable
+#
+# Custom Events
+# Names must start with "event." as the base
+# Use IntrusionDetector.addEvent( "test" ) in your code to trigger "event.test" here
+# You can also disable intrusion detection completely by changing
+# the following parameter to true
+#
+IntrusionDetector.Disable=false
+#
+IntrusionDetector.event.test.count=2
+IntrusionDetector.event.test.interval=10
+IntrusionDetector.event.test.actions=disable,log
+
+# Exception Events
+# All EnterpriseSecurityExceptions are registered automatically
+# Call IntrusionDetector.getInstance().addException(e) for Exceptions that do not extend EnterpriseSecurityException
+# Use the fully qualified classname of the exception as the base
+
+# any intrusion is an attack
+IntrusionDetector.org.owasp.esapi.errors.IntrusionException.count=1
+IntrusionDetector.org.owasp.esapi.errors.IntrusionException.interval=1
+IntrusionDetector.org.owasp.esapi.errors.IntrusionException.actions=log,disable,logout
+
+# for test purposes
+# CHECKME: Shouldn't there be something in the property name itself that designates
+#		   that these are for testing???
+IntrusionDetector.org.owasp.esapi.errors.IntegrityException.count=10
+IntrusionDetector.org.owasp.esapi.errors.IntegrityException.interval=5
+IntrusionDetector.org.owasp.esapi.errors.IntegrityException.actions=log,disable,logout
+
+# rapid validation errors indicate scans or attacks in progress
+# org.owasp.esapi.errors.ValidationException.count=10
+# org.owasp.esapi.errors.ValidationException.interval=10
+# org.owasp.esapi.errors.ValidationException.actions=log,logout
+
+# sessions jumping between hosts indicates session hijacking
+IntrusionDetector.org.owasp.esapi.errors.AuthenticationHostException.count=2
+IntrusionDetector.org.owasp.esapi.errors.AuthenticationHostException.interval=10
+IntrusionDetector.org.owasp.esapi.errors.AuthenticationHostException.actions=log,logout
+
+
+#===========================================================================
+# ESAPI Validation
+#
+# The ESAPI Validator works on regular expressions with defined names. You can define names
+# either here, or you may define application specific patterns in a separate file defined below.
+# This allows enterprises to specify both organizational standards as well as application specific
+# validation rules.
+#
+Validator.ConfigurationFile.MultiValued=true
+Validator.ConfigurationFile="validation-test,comma.properties",validation-test1.properties,validation-test2.properties
+
+# Validators used by ESAPI
+Validator.AccountName=^[a-zA-Z0-9]{3,20}$
+Validator.SystemCommand=^[a-zA-Z\\-\\/]{1,64}$
+Validator.RoleName=^[a-z]{1,20}$
+Validator.Redirect=^\\/test.*$
+
+# Global HTTP Validation Rules
+# Values with Base64 encoded data (e.g. encrypted state) will need at least [a-zA-Z0-9\/+=]
+Validator.HTTPScheme=^(http|https)$
+Validator.HTTPServerName=^[a-zA-Z0-9_.\\-]*$
+Validator.HTTPCookieName=^[a-zA-Z0-9\\-_]{1,32}$
+Validator.HTTPCookieValue=^[a-zA-Z0-9\\-\\/+=_ ]*$
+Validator.HTTPHeaderName=^[a-zA-Z0-9\\-_]{1,32}$
+Validator.HTTPHeaderValue=^[a-zA-Z0-9()\\-=\\*\\.\\?;,+\\/:&_ ]*$
+Validator.HTTPServletPath=^[a-zA-Z0-9.\\-\\/_]*$
+Validator.HTTPPath=^[a-zA-Z0-9.\\-_]*$
+Validator.HTTPURL=^.*$
+Validator.HTTPJSESSIONID=^[A-Z0-9]{10,30}$
+
+# Contributed by Fraenku@gmx.ch
+# Googlecode Issue 116 (http://code.google.com/p/owasp-esapi-java/issues/detail?id=116)
+Validator.HTTPParameterName=^[a-zA-Z0-9_\\-]{1,32}$
+Validator.HTTPParameterValue=^[\\p{L}\\p{N}.\\-/+=_ !$*?@]{0,1000}$
+Validator.HTTPContextPath=^/[a-zA-Z0-9.\\-_]*$
+Validator.HTTPQueryString=^([a-zA-Z0-9_\\-]{1,32}=[\\p{L}\\p{N}.\\-/+=_ !$*?@%]*&?)*$
+Validator.HTTPURI=^/([a-zA-Z0-9.\\-_]*/?)*$
+
+
+# Validation of file related input
+Validator.FileName=^[a-zA-Z0-9!@#$%^&{}\\[\\]()_+\\-=,.~'` ]{1,255}$
+Validator.DirectoryName=^[a-zA-Z0-9:/\\\\!@#$%^&{}\\[\\]()_+\\-=,.~'` ]{1,255}$
+
+# Validation of dates. Controls whether or not 'lenient' dates are accepted.
+# See DataFormat.setLenient(boolean flag) for further details.
 Validator.AcceptLenientDates=false
\ No newline at end of file

From c52a1f7981194a828bdc064268c349a950dd720f Mon Sep 17 00:00:00 2001
From: kwwall 
Date: Tue, 19 Jan 2016 01:12:42 -0500
Subject: [PATCH 321/812] Address issue 356.

---
 ...SAPI-SingleValidatorFileChecker.properties | 930 +++++++++---------
 1 file changed, 465 insertions(+), 465 deletions(-)

diff --git a/src/test/resources/esapi/ESAPI-SingleValidatorFileChecker.properties b/src/test/resources/esapi/ESAPI-SingleValidatorFileChecker.properties
index 95cdb0056..d741f3608 100644
--- a/src/test/resources/esapi/ESAPI-SingleValidatorFileChecker.properties
+++ b/src/test/resources/esapi/ESAPI-SingleValidatorFileChecker.properties
@@ -1,466 +1,466 @@
-#
-# OWASP Enterprise Security API (ESAPI) Properties file -- TEST Version
-# 
-# This file is part of the Open Web Application Security Project (OWASP)
-# Enterprise Security API (ESAPI) project. For details, please see
-# http://www.owasp.org/index.php/ESAPI.
-#
-# Copyright (c) 2008,2009 - The OWASP Foundation
-#
-# DISCUSS: This may cause a major backwards compatibility issue, etc. but
-#		   from a name space perspective, we probably should have prefaced
-#		   all the property names with ESAPI or at least OWASP. Otherwise
-#		   there could be problems is someone loads this properties file into
-#		   the System properties.  We could also put this file into the
-#		   esapi.jar file (perhaps as a ResourceBundle) and then allow an external
-#		   ESAPI properties be defined that would overwrite these defaults.
-#		   That keeps the application's properties relatively simple as usually
-#		   they will only want to override a few properties. If looks like we
-#		   already support multiple override levels of this in the
-#		   DefaultSecurityConfiguration class, but I'm suggesting placing the
-#		   defaults in the esapi.jar itself. That way, if the jar is signed,
-#		   we could detect if those properties had been tampered with. (The
-#		   code to check the jar signatures is pretty simple... maybe 70-90 LOC,
-#		   but off course there is an execution penalty (similar to the way
-#		   that the separate sunjce.jar used to be when a class from it was
-#		   first loaded). Thoughts?
-###############################################################################
-#
-# WARNING: Operating system protection should be used to lock down the .esapi
-# resources directory and all the files inside and all the directories all the
-# way up to the root directory of the file system.  Note that if you are using
-# file-based implementations, that some files may need to be read-write as they
-# get updated dynamically.
-#
-# Before using, be sure to update the MasterKey and MasterSalt as described below.
-# N.B.: If you had stored data that you have previously encrypted with ESAPI 1.4,
-#		you *must* FIRST decrypt it using ESAPI 1.4 and then (if so desired)
-#		re-encrypt it with ESAPI 2.0. If you fail to do this, you will NOT be
-#		able to decrypt your data with ESAPI 2.0.
-#
-#		YOU HAVE BEEN WARNED!!! More details are in the ESAPI 2.0 Release Notes.
-#
-#===========================================================================
-# ESAPI Configuration
-#
-# If true, then print all the ESAPI properties set here when they are loaded.
-# If false, they are not printed. Useful to reduce output when running JUnit tests.
-# If you need to troubleshoot a properties related problem, turning this on may help,
-# but we leave it off for running JUnit tests. (It will be 'true' in the one delivered
-# as part of production ESAPI, mostly for backward compatibility.)
-ESAPI.printProperties=false
-
-# ESAPI is designed to be easily extensible. You can use the reference implementation
-# or implement your own providers to take advantage of your enterprise's security
-# infrastructure. The functions in ESAPI are referenced using the ESAPI locator, like:
-#
-#    String ciphertext =
-#		ESAPI.encryptor().encrypt("Secret message");   // Deprecated in 2.0
-#    CipherText cipherText =
-#		ESAPI.encryptor().encrypt(new PlainText("Secret message")); // Preferred
-#
-# Below you can specify the classname for the provider that you wish to use in your
-# application. The only requirement is that it implement the appropriate ESAPI interface.
-# This allows you to switch security implementations in the future without rewriting the
-# entire application.
-#
-# ExperimentalAccessController requires ESAPI-AccessControlPolicy.xml in .esapi directory
-ESAPI.AccessControl=org.owasp.esapi.reference.DefaultAccessController
-# FileBasedAuthenticator requires users.txt file in .esapi directory
-ESAPI.Authenticator=org.owasp.esapi.reference.FileBasedAuthenticator
-ESAPI.Encoder=org.owasp.esapi.reference.DefaultEncoder
-ESAPI.Encryptor=org.owasp.esapi.reference.crypto.JavaEncryptor
-
-ESAPI.Executor=org.owasp.esapi.reference.DefaultExecutor
-ESAPI.HTTPUtilities=org.owasp.esapi.reference.DefaultHTTPUtilities
-ESAPI.IntrusionDetector=org.owasp.esapi.reference.DefaultIntrusionDetector
-# Log4JFactory Requires log4j.xml or log4j.properties in classpath - http://www.laliluna.de/log4j-tutorial.html
-ESAPI.Logger=org.owasp.esapi.reference.Log4JLogFactory
-#ESAPI.Logger=org.owasp.esapi.reference.JavaLogFactory
-#ESAPI.Logger=org.owasp.esapi.reference.ExampleExtendedLog4JLogFactory
-ESAPI.Randomizer=org.owasp.esapi.reference.DefaultRandomizer
-ESAPI.Validator=org.owasp.esapi.reference.DefaultValidator
-
-#===========================================================================
-# ESAPI Authenticator
-#
-Authenticator.AllowedLoginAttempts=3
-Authenticator.MaxOldPasswordHashes=13
-Authenticator.UsernameParameterName=username
-Authenticator.PasswordParameterName=password
-# RememberTokenDuration (in days)
-Authenticator.RememberTokenDuration=14
-# Session Timeouts (in minutes)
-Authenticator.IdleTimeoutDuration=20
-Authenticator.AbsoluteTimeoutDuration=120
-
-#===========================================================================
-# ESAPI Encoder
-#
-# ESAPI canonicalizes input before validation to prevent bypassing filters with encoded attacks.
-# Failure to canonicalize input is a very common mistake when implementing validation schemes.
-# Canonicalization is automatic when using the ESAPI Validator, but you can also use the
-# following code to canonicalize data.
-#
-#      ESAPI.Encoder().canonicalize( "%22hello world"" );
-#  
-# Multiple encoding is when a single encoding format is applied multiple times. Allowing
-# multiple encoding is strongly discouraged.
-Encoder.AllowMultipleEncoding=false
-
-# Mixed encoding is when multiple different encoding formats are applied, or when
-# multiple formats are nested. Allowing multiple encoding is strongly discouraged.
-Encoder.AllowMixedEncoding=false
-
-# The default list of codecs to apply when canonicalizing untrusted data. The list should include the codecs
-# for all downstream interpreters or decoders. For example, if the data is likely to end up in a URL, HTML, or
-# inside JavaScript, then the list of codecs below is appropriate. The order of the list is not terribly important.
-Encoder.DefaultCodecList=HTMLEntityCodec,PercentCodec,JavaScriptCodec
-
-
-#===========================================================================
-# ESAPI Encryption
-#
-# The ESAPI Encryptor provides basic cryptographic functions with a simplified API.
-# To get started, generate a new key using java -classpath esapi.jar org.owasp.esapi.reference.crypto.JavaEncryptor
-# There is not currently any support for key rotation, so be careful when changing your key and salt as it
-# will invalidate all signed, encrypted, and hashed data.
-#
-# WARNING: Not all combinations of algorithms and key lengths are supported.
-# If you choose to use a key length greater than 128, you MUST download the
-# unlimited strength policy files and install in the lib directory of your JRE/JDK.
-# See http://java.sun.com/javase/downloads/index.jsp for more information.
-#
-# Backward compatibility with ESAPI Java 1.4 is supported by the two deprecated API
-# methods, Encryptor.encrypt(String) and Encryptor.decrypt(String). However, whenever
-# possible, these methods should be avoided as they use ECB cipher mode, which in almost
-# all circumstances a poor choice because of it's weakness. CBC cipher mode is the default
-# for the new Encryptor encrypt / decrypt methods for ESAPI Java 2.0.  In general, you
-# should only use this compatibility setting if you have persistent data encrypted with
-# version 1.4 and even then, you should ONLY set this compatibility mode UNTIL
-# you have decrypted all of your old encrypted data and then re-encrypted it with
-# ESAPI 2.0 using CBC mode. If you have some reason to mix the deprecated 1.4 mode
-# with the new 2.0 methods, make sure that you use the same cipher algorithm for both
-# (256-bit AES was the default for 1.4; 128-bit is the default for 2.0; see below for
-# more details.) Otherwise, you will have to use the new 2.0 encrypt / decrypt methods
-# where you can specify a SecretKey. (Note that if you are using the 256-bit AES,
-# that requires downloading the special jurisdiction policy files mentioned above.)
-#
-#		***** IMPORTANT: These are for JUnit testing. Test files may have been
-#						 encrypted using these values so do not change these or
-#						 those tests will fail. The version under
-#							src/main/resources/.esapi/ESAPI.properties
-#						 will be delivered with Encryptor.MasterKey and
-#						 Encryptor.MasterSalt set to the empty string.
-#
-#						 FINAL NOTE:
-#                           If Maven changes these when run, that needs to be fixed.
-#       256-bit key... requires unlimited strength jurisdiction policy files
-### Encryptor.MasterKey=pJhlri8JbuFYDgkqtHmm9s0Ziug2PE7ovZDyEPm4j14=
-#       128-bit key
-Encryptor.MasterKey=a6H9is3hEVGKB4Jut+lOVA==
-Encryptor.MasterSalt=SbftnvmEWD5ZHHP+pX3fqugNysc=
-# Encryptor.MasterSalt=
-
-# Provides the default JCE provider that ESAPI will "prefer" for its symmetric
-# encryption and hashing. (That is it will look to this provider first, but it
-# will defer to other providers if the requested algorithm is not implemented
-# by this provider.) If left unset, ESAPI will just use your Java VM's current
-# preferred JCE provider, which is generally set in the file
-# "$JAVA_HOME/jre/lib/security/java.security".
-#
-# The main intent of this is to allow ESAPI symmetric encryption to be
-# used with a FIPS 140-2 compliant crypto-module. For details, see the section
-# "Using ESAPI Symmetric Encryption with FIPS 140-2 Cryptographic Modules" in
-# the ESAPI 2.0 Symmetric Encryption User Guide, at:
-# http://owasp-esapi-java.googlecode.com/svn/trunk/documentation/esapi4java-core-2.0-symmetric-crypto-user-guide.html
-# However, this property also allows you to easily use an alternate JCE provider
-# such as "Bouncy Castle" without having to make changes to "java.security".
-# See Javadoc for SecurityProviderLoader for further details. If you wish to use
-# a provider that is not known to SecurityProviderLoader, you may specify the
-# fully-qualified class name of the JCE provider class that implements
-# java.security.Provider. If the name contains a '.', this is interpreted as
-# a fully-qualified class name that implements java.security.Provider.
-#
-# NOTE: Setting this property has the side-effect of changing it in your application
-#       as well, so if you are using JCE in your application directly rather than
-#       through ESAPI (you wouldn't do that, would you? ;-), it will change the
-#       preferred JCE provider there as well.
-#
-# Default: Keeps the JCE provider set to whatever JVM sets it to.
-Encryptor.PreferredJCEProvider=
-
-# AES is the most widely used and strongest encryption algorithm. This
-# should agree with your Encryptor.CipherTransformation property.
-# By default, ESAPI Java 1.4 uses "PBEWithMD5AndDES" and which is
-# very weak. It is essentially a password-based encryption key, hashed
-# with MD5 around 1K times and then encrypted with the weak DES algorithm
-# (56-bits) using ECB mode and an unspecified padding (it is
-# JCE provider specific, but most likely "NoPadding"). However, 2.0 uses
-# "AES/CBC/PKCSPadding". If you want to change these, change them here.
-# Warning: This property does not control the default reference implementation for
-#		   ESAPI 2.0 using JavaEncryptor. Also, this property will be dropped
-#		   in the future.
-# @deprecated
-Encryptor.EncryptionAlgorithm=AES
-#		For ESAPI Java 2.0 - New encrypt / decrypt methods use this.
-Encryptor.CipherTransformation=AES/CBC/PKCS5Padding
-
-# Applies to ESAPI 2.0 and later only!
-# Comma-separated list of cipher modes that provide *BOTH*
-# confidentiality *AND* message authenticity. (NIST refers to such cipher
-# modes as "combined modes" so that's what we shall call them.) If any of these
-# cipher modes are used then no MAC is calculated and stored
-# in the CipherText upon encryption. Likewise, if one of these
-# cipher modes is used with decryption, no attempt will be made
-# to validate the MAC contained in the CipherText object regardless
-# of whether it contains one or not. Since the expectation is that
-# these cipher modes support support message authenticity already,
-# injecting a MAC in the CipherText object would be at best redundant.
-#
-# Note that as of JDK 1.5, the SunJCE provider does not support *any*
-# of these cipher modes. Of these listed, only GCM and CCM are currently
-# NIST approved. YMMV for other JCE providers. E.g., Bouncy Castle supports
-# GCM and CCM with "NoPadding" mode, but not with "PKCS5Padding" or other
-# padding modes.
-Encryptor.cipher_modes.combined_modes=GCM,CCM,IAPM,EAX,OCB,CWC
-
-# Applies to ESAPI 2.0 and later only!
-# Additional cipher modes allowed for ESAPI 2.0 encryption. These
-# cipher modes are in _addition_ to those specified by the property
-# 'Encryptor.cipher_modes.combined_modes'.
-# Note: We will add support for streaming modes like CFB & OFB once
-# we add support for 'specified' to the property 'Encryptor.ChooseIVMethod'
-# (probably in ESAPI 2.1).
-#
-#	IMPORTANT NOTE:	In the official ESAPI.properties we do *NOT* include ECB
-#					here as this is an extremely weak mode. However, we *must*
-#					allow it here so we can test ECB mode. That is important
-#					since the logic is somewhat different (i.e., ECB mode does
-#					not use an IV).
-# DISCUSS: Better name?
-#	NOTE: ECB added only for testing purposes. Don't try this at home!
-Encryptor.cipher_modes.additional_allowed=CBC,ECB
-
-# 128-bit is almost always sufficient and appears to be more resistant to
-# related key attacks than is 256-bit AES. Use '_' to use default key size
-# for cipher algorithms (where it makes sense because the algorithm supports
-# a variable key size). Key length must agree to what's provided as the
-# cipher transformation, otherwise this will be ignored after logging a
-# warning.
-#
-# NOTE: This is what applies BOTH ESAPI 1.4 and 2.0. See warning above about mixing!
-Encryptor.EncryptionKeyLength=128
-
-# Because 2.0 uses CBC mode by default, it requires an initialization vector (IV).
-# (All cipher modes except ECB require an IV.) There are two choices: we can either
-# use a fixed IV known to both parties or allow ESAPI to choose a random IV. While
-# the IV does not need to be hidden from adversaries, it is important that the
-# adversary not be allowed to choose it. Also, random IVs are generally much more
-# secure than fixed IVs. (In fact, it is essential that feed-back cipher modes
-# such as CFB and OFB use a different IV for each encryption with a given key so
-# in such cases, random IVs are much preferred. By default, ESAPI 2.0 uses random
-# IVs. If you wish to use 'fixed' IVs, set 'Encryptor.ChooseIVMethod=fixed' and
-# uncomment the Encryptor.fixedIV.
-#
-# Valid values:		random|fixed|specified		'specified' not yet implemented; planned for 2.1
-Encryptor.ChooseIVMethod=random
-# If you choose to use a fixed IV, then you must place a fixed IV here that
-# is known to all others who are sharing your secret key. The format should
-# be a hex string that is the same length as the cipher block size for the
-# cipher algorithm that you are using. The following is an example for AES
-# from an AES test vector for AES-128/CBC as described in:
-# NIST Special Publication 800-38A (2001 Edition)
-# "Recommendation for Block Cipher Modes of Operation".
-# (Note that the block size for AES is 16 bytes == 128 bits.)
-#
-Encryptor.fixedIV=0x000102030405060708090a0b0c0d0e0f
-
-# Whether or not CipherText should use a message authentication code (MAC) with it.
-# This prevents an adversary from altering the IV as well as allowing a more
-# fool-proof way of determining the decryption failed because of an incorrect
-# key being supplied. This refers to the "separate" MAC calculated and stored
-# in CipherText, not part of any MAC that is calculated as a result of a
-# "combined mode" cipher mode.
-#
-# If you are using ESAPI with a FIPS 140-2 cryptographic module, you *must* also
-# set this property to false.
-Encryptor.CipherText.useMAC=true
-
-# Whether or not the PlainText object may be overwritten and then marked
-# eligible for garbage collection. If not set, this is still treated as 'true'.
-Encryptor.PlainText.overwrite=true
-
-# Do not use DES except in a legacy situations. 56-bit is way too small key size.
-#Encryptor.EncryptionKeyLength=56
-#Encryptor.EncryptionAlgorithm=DES
-
-# TripleDES is considered strong enough for most purposes.
-#	Note:	There is also a 112-bit version of DESede. Using the 168-bit version
-#			requires downloading the special jurisdiction policy from Sun.
-#Encryptor.EncryptionKeyLength=168
-#Encryptor.EncryptionAlgorithm=DESede
-
-Encryptor.HashAlgorithm=SHA-512
-Encryptor.HashIterations=1024
-Encryptor.DigitalSignatureAlgorithm=SHA1withDSA
-Encryptor.DigitalSignatureKeyLength=1024
-Encryptor.RandomAlgorithm=SHA1PRNG
-Encryptor.CharacterEncoding=UTF-8
-# Currently supported choices for JDK 1.5 and 1.6 are:
-#	HmacSHA1 (160 bits), HmacSHA256 (256 bits), HmacSHA384 (384 bits), and
-#	HmacSHA512 (512 bits).
-# Note that HmacMD5 is *not* supported for the PRF used by the KDF even though
-# these JDKs support it.
-Encryptor.KDF.PRF=HmacSHA256
-
-#===========================================================================
-# ESAPI HttpUtilties
-#
-# The HttpUtilities provide basic protections to HTTP requests and responses. Primarily these methods 
-# protect against malicious data from attackers, such as unprintable characters, escaped characters,
-# and other simple attacks. The HttpUtilities also provides utility methods for dealing with cookies,
-# headers, and CSRF tokens.
-#
-# Default file upload location (remember to escape backslashes with \\)
-HttpUtilities.UploadDir=C:\\ESAPI\\testUpload
-# let this default to java.io.tmpdir for testing
-#HttpUtilities.UploadTempDir=C:\\temp
-# Force flags on cookies, if you use HttpUtilities to set cookies
-HttpUtilities.ForceHttpOnlySession=false
-HttpUtilities.ForceSecureSession=false
-HttpUtilities.ForceHttpOnlyCookies=true
-HttpUtilities.ForceSecureCookies=true
-# Maximum size of HTTP headers
-HttpUtilities.MaxHeaderSize=4096
-# File upload configuration
-HttpUtilities.ApprovedUploadExtensions=.zip,.pdf,.doc,.docx,.ppt,.pptx,.tar,.gz,.tgz,.rar,.war,.jar,.ear,.xls,.rtf,.properties,.java,.class,.txt,.xml,.jsp,.jsf,.exe,.dll
-HttpUtilities.MaxUploadFileBytes=500000000
-# Using UTF-8 throughout your stack is highly recommended. That includes your database driver,
-# container, and any other technologies you may be using. Failure to do this may expose you
-# to Unicode transcoding injection attacks. Use of UTF-8 does not hinder internationalization.
-HttpUtilities.ResponseContentType=text/html; charset=UTF-8
-# This is the name of the cookie used to represent the HTTP session
-# Typically this will be the default "JSESSIONID" 
-HttpUtilities.HttpSessionIdName=JSESSIONID
-
-
-
-#===========================================================================
-# ESAPI Executor
-# CHECKME - Not sure what this is used for, but surely it should be made OS independent.
-Executor.WorkingDirectory=C:\\Windows\\Temp
-Executor.ApprovedExecutables=C:\\Windows\\System32\\cmd.exe,C:\\Windows\\System32\\runas.exe
-
-
-#===========================================================================
-# ESAPI Logging
-# Set the application name if these logs are combined with other applications
-Logger.ApplicationName=ExampleApplication
-# If you use an HTML log viewer that does not properly HTML escape log data, you can set LogEncodingRequired to true
-Logger.LogEncodingRequired=false
-# Determines whether ESAPI should log the application name. This might be clutter in some single-server/single-app environments.
-Logger.LogApplicationName=true
-# Determines whether ESAPI should log the server IP and port. This might be clutter in some single-server environments.
-Logger.LogServerIP=true
-# LogFileName, the name of the logging file. Provide a full directory path (e.g., C:\\ESAPI\\ESAPI_logging_file) if you
-# want to place it in a specific directory.
-Logger.LogFileName=ESAPI_logging_file
-# MaxLogFileSize, the max size (in bytes) of a single log file before it cuts over to a new one (default is 10,000,000)
-Logger.MaxLogFileSize=10000000
-
-
-#===========================================================================
-# ESAPI Intrusion Detection
-#
-# Each event has a base to which .count, .interval, and .action are added
-# The IntrusionException will fire if we receive "count" events within "interval" seconds
-# The IntrusionDetector is configurable to take the following actions: log, logout, and disable
-#  (multiple actions separated by commas are allowed e.g. event.test.actions=log,disable
-#
-# Custom Events
-# Names must start with "event." as the base
-# Use IntrusionDetector.addEvent( "test" ) in your code to trigger "event.test" here
-# You can also disable intrusion detection completely by changing
-# the following parameter to true
-#
-IntrusionDetector.Disable=false
-#
-IntrusionDetector.event.test.count=2
-IntrusionDetector.event.test.interval=10
-IntrusionDetector.event.test.actions=disable,log
-
-# Exception Events
-# All EnterpriseSecurityExceptions are registered automatically
-# Call IntrusionDetector.getInstance().addException(e) for Exceptions that do not extend EnterpriseSecurityException
-# Use the fully qualified classname of the exception as the base
-
-# any intrusion is an attack
-IntrusionDetector.org.owasp.esapi.errors.IntrusionException.count=1
-IntrusionDetector.org.owasp.esapi.errors.IntrusionException.interval=1
-IntrusionDetector.org.owasp.esapi.errors.IntrusionException.actions=log,disable,logout
-
-# for test purposes
-# CHECKME: Shouldn't there be something in the property name itself that designates
-#		   that these are for testing???
-IntrusionDetector.org.owasp.esapi.errors.IntegrityException.count=10
-IntrusionDetector.org.owasp.esapi.errors.IntegrityException.interval=5
-IntrusionDetector.org.owasp.esapi.errors.IntegrityException.actions=log,disable,logout
-
-# rapid validation errors indicate scans or attacks in progress
-# org.owasp.esapi.errors.ValidationException.count=10
-# org.owasp.esapi.errors.ValidationException.interval=10
-# org.owasp.esapi.errors.ValidationException.actions=log,logout
-
-# sessions jumping between hosts indicates session hijacking
-IntrusionDetector.org.owasp.esapi.errors.AuthenticationHostException.count=2
-IntrusionDetector.org.owasp.esapi.errors.AuthenticationHostException.interval=10
-IntrusionDetector.org.owasp.esapi.errors.AuthenticationHostException.actions=log,logout
-
-
-#===========================================================================
-# ESAPI Validation
-#
-# The ESAPI Validator works on regular expressions with defined names. You can define names
-# either here, or you may define application specific patterns in a separate file defined below.
-# This allows enterprises to specify both organizational standards as well as application specific
-# validation rules.
-#
-#Validator.ConfigurationFile.MultiValued=false
-Validator.ConfigurationFile=validation-test1.properties
-
-# Validators used by ESAPI
-Validator.AccountName=^[a-zA-Z0-9]{3,20}$
-Validator.SystemCommand=^[a-zA-Z\\-\\/]{1,64}$
-Validator.RoleName=^[a-z]{1,20}$
-Validator.Redirect=^\\/test.*$
-
-# Global HTTP Validation Rules
-# Values with Base64 encoded data (e.g. encrypted state) will need at least [a-zA-Z0-9\/+=]
-Validator.HTTPScheme=^(http|https)$
-Validator.HTTPServerName=^[a-zA-Z0-9_.\\-]*$
-Validator.HTTPCookieName=^[a-zA-Z0-9\\-_]{1,32}$
-Validator.HTTPCookieValue=^[a-zA-Z0-9\\-\\/+=_ ]*$
-Validator.HTTPHeaderName=^[a-zA-Z0-9\\-_]{1,32}$
-Validator.HTTPHeaderValue=^[a-zA-Z0-9()\\-=\\*\\.\\?;,+\\/:&_ ]*$
-Validator.HTTPServletPath=^[a-zA-Z0-9.\\-\\/_]*$
-Validator.HTTPPath=^[a-zA-Z0-9.\\-_]*$
-Validator.HTTPURL=^.*$
-Validator.HTTPJSESSIONID=^[A-Z0-9]{10,30}$
-
-# Contributed by Fraenku@gmx.ch
-# Googlecode Issue 116 (http://code.google.com/p/owasp-esapi-java/issues/detail?id=116)
-Validator.HTTPParameterName=^[a-zA-Z0-9_\\-]{1,32}$
-Validator.HTTPParameterValue=^[\\p{L}\\p{N}.\\-/+=_ !$*?@]{0,1000}$
-Validator.HTTPContextPath=^/[a-zA-Z0-9.\\-_]*$
-Validator.HTTPQueryString=^([a-zA-Z0-9_\\-]{1,32}=[\\p{L}\\p{N}.\\-/+=_ !$*?@%]*&?)*$
-Validator.HTTPURI=^/([a-zA-Z0-9.\\-_]*/?)*$
-
-
-# Validation of file related input
-Validator.FileName=^[a-zA-Z0-9!@#$%^&{}\\[\\]()_+\\-=,.~'` ]{1,255}$
-Validator.DirectoryName=^[a-zA-Z0-9:/\\\\!@#$%^&{}\\[\\]()_+\\-=,.~'` ]{1,255}$
-
-# Validation of dates. Controls whether or not 'lenient' dates are accepted.
-# See DataFormat.setLenient(boolean flag) for further details.
+#
+# OWASP Enterprise Security API (ESAPI) Properties file -- TEST Version
+# 
+# This file is part of the Open Web Application Security Project (OWASP)
+# Enterprise Security API (ESAPI) project. For details, please see
+# http://www.owasp.org/index.php/ESAPI.
+#
+# Copyright (c) 2008,2009 - The OWASP Foundation
+#
+# DISCUSS: This may cause a major backwards compatibility issue, etc. but
+#		   from a name space perspective, we probably should have prefaced
+#		   all the property names with ESAPI or at least OWASP. Otherwise
+#		   there could be problems is someone loads this properties file into
+#		   the System properties.  We could also put this file into the
+#		   esapi.jar file (perhaps as a ResourceBundle) and then allow an external
+#		   ESAPI properties be defined that would overwrite these defaults.
+#		   That keeps the application's properties relatively simple as usually
+#		   they will only want to override a few properties. If looks like we
+#		   already support multiple override levels of this in the
+#		   DefaultSecurityConfiguration class, but I'm suggesting placing the
+#		   defaults in the esapi.jar itself. That way, if the jar is signed,
+#		   we could detect if those properties had been tampered with. (The
+#		   code to check the jar signatures is pretty simple... maybe 70-90 LOC,
+#		   but off course there is an execution penalty (similar to the way
+#		   that the separate sunjce.jar used to be when a class from it was
+#		   first loaded). Thoughts?
+###############################################################################
+#
+# WARNING: Operating system protection should be used to lock down the .esapi
+# resources directory and all the files inside and all the directories all the
+# way up to the root directory of the file system.  Note that if you are using
+# file-based implementations, that some files may need to be read-write as they
+# get updated dynamically.
+#
+# Before using, be sure to update the MasterKey and MasterSalt as described below.
+# N.B.: If you had stored data that you have previously encrypted with ESAPI 1.4,
+#		you *must* FIRST decrypt it using ESAPI 1.4 and then (if so desired)
+#		re-encrypt it with ESAPI 2.0. If you fail to do this, you will NOT be
+#		able to decrypt your data with ESAPI 2.0.
+#
+#		YOU HAVE BEEN WARNED!!! More details are in the ESAPI 2.0 Release Notes.
+#
+#===========================================================================
+# ESAPI Configuration
+#
+# If true, then print all the ESAPI properties set here when they are loaded.
+# If false, they are not printed. Useful to reduce output when running JUnit tests.
+# If you need to troubleshoot a properties related problem, turning this on may help,
+# but we leave it off for running JUnit tests. (It will be 'true' in the one delivered
+# as part of production ESAPI, mostly for backward compatibility.)
+ESAPI.printProperties=false
+
+# ESAPI is designed to be easily extensible. You can use the reference implementation
+# or implement your own providers to take advantage of your enterprise's security
+# infrastructure. The functions in ESAPI are referenced using the ESAPI locator, like:
+#
+#    String ciphertext =
+#		ESAPI.encryptor().encrypt("Secret message");   // Deprecated in 2.0
+#    CipherText cipherText =
+#		ESAPI.encryptor().encrypt(new PlainText("Secret message")); // Preferred
+#
+# Below you can specify the classname for the provider that you wish to use in your
+# application. The only requirement is that it implement the appropriate ESAPI interface.
+# This allows you to switch security implementations in the future without rewriting the
+# entire application.
+#
+# ExperimentalAccessController requires ESAPI-AccessControlPolicy.xml in .esapi directory
+ESAPI.AccessControl=org.owasp.esapi.reference.DefaultAccessController
+# FileBasedAuthenticator requires users.txt file in .esapi directory
+ESAPI.Authenticator=org.owasp.esapi.reference.FileBasedAuthenticator
+ESAPI.Encoder=org.owasp.esapi.reference.DefaultEncoder
+ESAPI.Encryptor=org.owasp.esapi.reference.crypto.JavaEncryptor
+
+ESAPI.Executor=org.owasp.esapi.reference.DefaultExecutor
+ESAPI.HTTPUtilities=org.owasp.esapi.reference.DefaultHTTPUtilities
+ESAPI.IntrusionDetector=org.owasp.esapi.reference.DefaultIntrusionDetector
+# Log4JFactory Requires log4j.xml or log4j.properties in classpath - http://www.laliluna.de/log4j-tutorial.html
+ESAPI.Logger=org.owasp.esapi.reference.Log4JLogFactory
+#ESAPI.Logger=org.owasp.esapi.reference.JavaLogFactory
+#ESAPI.Logger=org.owasp.esapi.reference.ExampleExtendedLog4JLogFactory
+ESAPI.Randomizer=org.owasp.esapi.reference.DefaultRandomizer
+ESAPI.Validator=org.owasp.esapi.reference.DefaultValidator
+
+#===========================================================================
+# ESAPI Authenticator
+#
+Authenticator.AllowedLoginAttempts=3
+Authenticator.MaxOldPasswordHashes=13
+Authenticator.UsernameParameterName=username
+Authenticator.PasswordParameterName=password
+# RememberTokenDuration (in days)
+Authenticator.RememberTokenDuration=14
+# Session Timeouts (in minutes)
+Authenticator.IdleTimeoutDuration=20
+Authenticator.AbsoluteTimeoutDuration=120
+
+#===========================================================================
+# ESAPI Encoder
+#
+# ESAPI canonicalizes input before validation to prevent bypassing filters with encoded attacks.
+# Failure to canonicalize input is a very common mistake when implementing validation schemes.
+# Canonicalization is automatic when using the ESAPI Validator, but you can also use the
+# following code to canonicalize data.
+#
+#      ESAPI.Encoder().canonicalize( "%22hello world"" );
+#  
+# Multiple encoding is when a single encoding format is applied multiple times. Allowing
+# multiple encoding is strongly discouraged.
+Encoder.AllowMultipleEncoding=false
+
+# Mixed encoding is when multiple different encoding formats are applied, or when
+# multiple formats are nested. Allowing multiple encoding is strongly discouraged.
+Encoder.AllowMixedEncoding=false
+
+# The default list of codecs to apply when canonicalizing untrusted data. The list should include the codecs
+# for all downstream interpreters or decoders. For example, if the data is likely to end up in a URL, HTML, or
+# inside JavaScript, then the list of codecs below is appropriate. The order of the list is not terribly important.
+Encoder.DefaultCodecList=HTMLEntityCodec,PercentCodec,JavaScriptCodec
+
+
+#===========================================================================
+# ESAPI Encryption
+#
+# The ESAPI Encryptor provides basic cryptographic functions with a simplified API.
+# To get started, generate a new key using java -classpath esapi.jar org.owasp.esapi.reference.crypto.JavaEncryptor
+# There is not currently any support for key rotation, so be careful when changing your key and salt as it
+# will invalidate all signed, encrypted, and hashed data.
+#
+# WARNING: Not all combinations of algorithms and key lengths are supported.
+# If you choose to use a key length greater than 128, you MUST download the
+# unlimited strength policy files and install in the lib directory of your JRE/JDK.
+# See http://java.sun.com/javase/downloads/index.jsp for more information.
+#
+# Backward compatibility with ESAPI Java 1.4 is supported by the two deprecated API
+# methods, Encryptor.encrypt(String) and Encryptor.decrypt(String). However, whenever
+# possible, these methods should be avoided as they use ECB cipher mode, which in almost
+# all circumstances a poor choice because of it's weakness. CBC cipher mode is the default
+# for the new Encryptor encrypt / decrypt methods for ESAPI Java 2.0.  In general, you
+# should only use this compatibility setting if you have persistent data encrypted with
+# version 1.4 and even then, you should ONLY set this compatibility mode UNTIL
+# you have decrypted all of your old encrypted data and then re-encrypted it with
+# ESAPI 2.0 using CBC mode. If you have some reason to mix the deprecated 1.4 mode
+# with the new 2.0 methods, make sure that you use the same cipher algorithm for both
+# (256-bit AES was the default for 1.4; 128-bit is the default for 2.0; see below for
+# more details.) Otherwise, you will have to use the new 2.0 encrypt / decrypt methods
+# where you can specify a SecretKey. (Note that if you are using the 256-bit AES,
+# that requires downloading the special jurisdiction policy files mentioned above.)
+#
+#		***** IMPORTANT: These are for JUnit testing. Test files may have been
+#						 encrypted using these values so do not change these or
+#						 those tests will fail. The version under
+#							src/main/resources/.esapi/ESAPI.properties
+#						 will be delivered with Encryptor.MasterKey and
+#						 Encryptor.MasterSalt set to the empty string.
+#
+#						 FINAL NOTE:
+#                           If Maven changes these when run, that needs to be fixed.
+#       256-bit key... requires unlimited strength jurisdiction policy files
+### Encryptor.MasterKey=pJhlri8JbuFYDgkqtHmm9s0Ziug2PE7ovZDyEPm4j14=
+#       128-bit key
+Encryptor.MasterKey=a6H9is3hEVGKB4Jut+lOVA==
+Encryptor.MasterSalt=SbftnvmEWD5ZHHP+pX3fqugNysc=
+# Encryptor.MasterSalt=
+
+# Provides the default JCE provider that ESAPI will "prefer" for its symmetric
+# encryption and hashing. (That is it will look to this provider first, but it
+# will defer to other providers if the requested algorithm is not implemented
+# by this provider.) If left unset, ESAPI will just use your Java VM's current
+# preferred JCE provider, which is generally set in the file
+# "$JAVA_HOME/jre/lib/security/java.security".
+#
+# The main intent of this is to allow ESAPI symmetric encryption to be
+# used with a FIPS 140-2 compliant crypto-module. For details, see the section
+# "Using ESAPI Symmetric Encryption with FIPS 140-2 Cryptographic Modules" in
+# the ESAPI 2.0 Symmetric Encryption User Guide, at:
+# http://owasp-esapi-java.googlecode.com/svn/trunk/documentation/esapi4java-core-2.0-symmetric-crypto-user-guide.html
+# However, this property also allows you to easily use an alternate JCE provider
+# such as "Bouncy Castle" without having to make changes to "java.security".
+# See Javadoc for SecurityProviderLoader for further details. If you wish to use
+# a provider that is not known to SecurityProviderLoader, you may specify the
+# fully-qualified class name of the JCE provider class that implements
+# java.security.Provider. If the name contains a '.', this is interpreted as
+# a fully-qualified class name that implements java.security.Provider.
+#
+# NOTE: Setting this property has the side-effect of changing it in your application
+#       as well, so if you are using JCE in your application directly rather than
+#       through ESAPI (you wouldn't do that, would you? ;-), it will change the
+#       preferred JCE provider there as well.
+#
+# Default: Keeps the JCE provider set to whatever JVM sets it to.
+Encryptor.PreferredJCEProvider=
+
+# AES is the most widely used and strongest encryption algorithm. This
+# should agree with your Encryptor.CipherTransformation property.
+# By default, ESAPI Java 1.4 uses "PBEWithMD5AndDES" and which is
+# very weak. It is essentially a password-based encryption key, hashed
+# with MD5 around 1K times and then encrypted with the weak DES algorithm
+# (56-bits) using ECB mode and an unspecified padding (it is
+# JCE provider specific, but most likely "NoPadding"). However, 2.0 uses
+# "AES/CBC/PKCSPadding". If you want to change these, change them here.
+# Warning: This property does not control the default reference implementation for
+#		   ESAPI 2.0 using JavaEncryptor. Also, this property will be dropped
+#		   in the future.
+# @deprecated
+Encryptor.EncryptionAlgorithm=AES
+#		For ESAPI Java 2.0 - New encrypt / decrypt methods use this.
+Encryptor.CipherTransformation=AES/CBC/PKCS5Padding
+
+# Applies to ESAPI 2.0 and later only!
+# Comma-separated list of cipher modes that provide *BOTH*
+# confidentiality *AND* message authenticity. (NIST refers to such cipher
+# modes as "combined modes" so that's what we shall call them.) If any of these
+# cipher modes are used then no MAC is calculated and stored
+# in the CipherText upon encryption. Likewise, if one of these
+# cipher modes is used with decryption, no attempt will be made
+# to validate the MAC contained in the CipherText object regardless
+# of whether it contains one or not. Since the expectation is that
+# these cipher modes support support message authenticity already,
+# injecting a MAC in the CipherText object would be at best redundant.
+#
+# Note that as of JDK 1.5, the SunJCE provider does not support *any*
+# of these cipher modes. Of these listed, only GCM and CCM are currently
+# NIST approved. YMMV for other JCE providers. E.g., Bouncy Castle supports
+# GCM and CCM with "NoPadding" mode, but not with "PKCS5Padding" or other
+# padding modes.
+Encryptor.cipher_modes.combined_modes=GCM,CCM,IAPM,EAX,OCB,CWC
+
+# Applies to ESAPI 2.0 and later only!
+# Additional cipher modes allowed for ESAPI 2.0 encryption. These
+# cipher modes are in _addition_ to those specified by the property
+# 'Encryptor.cipher_modes.combined_modes'.
+# Note: We will add support for streaming modes like CFB & OFB once
+# we add support for 'specified' to the property 'Encryptor.ChooseIVMethod'
+# (probably in ESAPI 2.1).
+#
+#	IMPORTANT NOTE:	In the official ESAPI.properties we do *NOT* include ECB
+#					here as this is an extremely weak mode. However, we *must*
+#					allow it here so we can test ECB mode. That is important
+#					since the logic is somewhat different (i.e., ECB mode does
+#					not use an IV).
+# DISCUSS: Better name?
+#	NOTE: ECB added only for testing purposes. Don't try this at home!
+Encryptor.cipher_modes.additional_allowed=CBC,ECB
+
+# 128-bit is almost always sufficient and appears to be more resistant to
+# related key attacks than is 256-bit AES. Use '_' to use default key size
+# for cipher algorithms (where it makes sense because the algorithm supports
+# a variable key size). Key length must agree to what's provided as the
+# cipher transformation, otherwise this will be ignored after logging a
+# warning.
+#
+# NOTE: This is what applies BOTH ESAPI 1.4 and 2.0. See warning above about mixing!
+Encryptor.EncryptionKeyLength=128
+
+# Because 2.0 uses CBC mode by default, it requires an initialization vector (IV).
+# (All cipher modes except ECB require an IV.) There are two choices: we can either
+# use a fixed IV known to both parties or allow ESAPI to choose a random IV. While
+# the IV does not need to be hidden from adversaries, it is important that the
+# adversary not be allowed to choose it. Also, random IVs are generally much more
+# secure than fixed IVs. (In fact, it is essential that feed-back cipher modes
+# such as CFB and OFB use a different IV for each encryption with a given key so
+# in such cases, random IVs are much preferred. By default, ESAPI 2.0 uses random
+# IVs. If you wish to use 'fixed' IVs, set 'Encryptor.ChooseIVMethod=fixed' and
+# uncomment the Encryptor.fixedIV.
+#
+# Valid values:		random|fixed|specified		'specified' not yet implemented; planned for 2.1
+Encryptor.ChooseIVMethod=random
+# If you choose to use a fixed IV, then you must place a fixed IV here that
+# is known to all others who are sharing your secret key. The format should
+# be a hex string that is the same length as the cipher block size for the
+# cipher algorithm that you are using. The following is an example for AES
+# from an AES test vector for AES-128/CBC as described in:
+# NIST Special Publication 800-38A (2001 Edition)
+# "Recommendation for Block Cipher Modes of Operation".
+# (Note that the block size for AES is 16 bytes == 128 bits.)
+#
+Encryptor.fixedIV=0x000102030405060708090a0b0c0d0e0f
+
+# Whether or not CipherText should use a message authentication code (MAC) with it.
+# This prevents an adversary from altering the IV as well as allowing a more
+# fool-proof way of determining the decryption failed because of an incorrect
+# key being supplied. This refers to the "separate" MAC calculated and stored
+# in CipherText, not part of any MAC that is calculated as a result of a
+# "combined mode" cipher mode.
+#
+# If you are using ESAPI with a FIPS 140-2 cryptographic module, you *must* also
+# set this property to false.
+Encryptor.CipherText.useMAC=true
+
+# Whether or not the PlainText object may be overwritten and then marked
+# eligible for garbage collection. If not set, this is still treated as 'true'.
+Encryptor.PlainText.overwrite=true
+
+# Do not use DES except in a legacy situations. 56-bit is way too small key size.
+#Encryptor.EncryptionKeyLength=56
+#Encryptor.EncryptionAlgorithm=DES
+
+# TripleDES is considered strong enough for most purposes.
+#	Note:	There is also a 112-bit version of DESede. Using the 168-bit version
+#			requires downloading the special jurisdiction policy from Sun.
+#Encryptor.EncryptionKeyLength=168
+#Encryptor.EncryptionAlgorithm=DESede
+
+Encryptor.HashAlgorithm=SHA-512
+Encryptor.HashIterations=1024
+Encryptor.DigitalSignatureAlgorithm=SHA1withDSA
+Encryptor.DigitalSignatureKeyLength=1024
+Encryptor.RandomAlgorithm=SHA1PRNG
+Encryptor.CharacterEncoding=UTF-8
+# Currently supported choices for JDK 1.5 and 1.6 are:
+#	HmacSHA1 (160 bits), HmacSHA256 (256 bits), HmacSHA384 (384 bits), and
+#	HmacSHA512 (512 bits).
+# Note that HmacMD5 is *not* supported for the PRF used by the KDF even though
+# these JDKs support it.
+Encryptor.KDF.PRF=HmacSHA256
+
+#===========================================================================
+# ESAPI HttpUtilties
+#
+# The HttpUtilities provide basic protections to HTTP requests and responses. Primarily these methods 
+# protect against malicious data from attackers, such as unprintable characters, escaped characters,
+# and other simple attacks. The HttpUtilities also provides utility methods for dealing with cookies,
+# headers, and CSRF tokens.
+#
+# Default file upload location (remember to escape backslashes with \\)
+HttpUtilities.UploadDir=C:\\ESAPI\\testUpload
+# let this default to java.io.tmpdir for testing
+#HttpUtilities.UploadTempDir=C:\\temp
+# Force flags on cookies, if you use HttpUtilities to set cookies
+HttpUtilities.ForceHttpOnlySession=false
+HttpUtilities.ForceSecureSession=false
+HttpUtilities.ForceHttpOnlyCookies=true
+HttpUtilities.ForceSecureCookies=true
+# Maximum size of HTTP headers
+HttpUtilities.MaxHeaderSize=4096
+# File upload configuration
+HttpUtilities.ApprovedUploadExtensions=.zip,.pdf,.doc,.docx,.ppt,.pptx,.tar,.gz,.tgz,.rar,.war,.jar,.ear,.xls,.rtf,.properties,.java,.class,.txt,.xml,.jsp,.jsf,.exe,.dll
+HttpUtilities.MaxUploadFileBytes=500000000
+# Using UTF-8 throughout your stack is highly recommended. That includes your database driver,
+# container, and any other technologies you may be using. Failure to do this may expose you
+# to Unicode transcoding injection attacks. Use of UTF-8 does not hinder internationalization.
+HttpUtilities.ResponseContentType=text/html; charset=UTF-8
+# This is the name of the cookie used to represent the HTTP session
+# Typically this will be the default "JSESSIONID" 
+HttpUtilities.HttpSessionIdName=JSESSIONID
+
+
+
+#===========================================================================
+# ESAPI Executor
+# CHECKME - Not sure what this is used for, but surely it should be made OS independent.
+Executor.WorkingDirectory=C:\\Windows\\Temp
+Executor.ApprovedExecutables=C:\\Windows\\System32\\cmd.exe,C:\\Windows\\System32\\runas.exe
+
+
+#===========================================================================
+# ESAPI Logging
+# Set the application name if these logs are combined with other applications
+Logger.ApplicationName=ExampleApplication
+# If you use an HTML log viewer that does not properly HTML escape log data, you can set LogEncodingRequired to true
+Logger.LogEncodingRequired=false
+# Determines whether ESAPI should log the application name. This might be clutter in some single-server/single-app environments.
+Logger.LogApplicationName=true
+# Determines whether ESAPI should log the server IP and port. This might be clutter in some single-server environments.
+Logger.LogServerIP=true
+# LogFileName, the name of the logging file. Provide a full directory path (e.g., C:\\ESAPI\\ESAPI_logging_file) if you
+# want to place it in a specific directory.
+Logger.LogFileName=ESAPI_logging_file
+# MaxLogFileSize, the max size (in bytes) of a single log file before it cuts over to a new one (default is 10,000,000)
+Logger.MaxLogFileSize=10000000
+
+
+#===========================================================================
+# ESAPI Intrusion Detection
+#
+# Each event has a base to which .count, .interval, and .action are added
+# The IntrusionException will fire if we receive "count" events within "interval" seconds
+# The IntrusionDetector is configurable to take the following actions: log, logout, and disable
+#  (multiple actions separated by commas are allowed e.g. event.test.actions=log,disable
+#
+# Custom Events
+# Names must start with "event." as the base
+# Use IntrusionDetector.addEvent( "test" ) in your code to trigger "event.test" here
+# You can also disable intrusion detection completely by changing
+# the following parameter to true
+#
+IntrusionDetector.Disable=false
+#
+IntrusionDetector.event.test.count=2
+IntrusionDetector.event.test.interval=10
+IntrusionDetector.event.test.actions=disable,log
+
+# Exception Events
+# All EnterpriseSecurityExceptions are registered automatically
+# Call IntrusionDetector.getInstance().addException(e) for Exceptions that do not extend EnterpriseSecurityException
+# Use the fully qualified classname of the exception as the base
+
+# any intrusion is an attack
+IntrusionDetector.org.owasp.esapi.errors.IntrusionException.count=1
+IntrusionDetector.org.owasp.esapi.errors.IntrusionException.interval=1
+IntrusionDetector.org.owasp.esapi.errors.IntrusionException.actions=log,disable,logout
+
+# for test purposes
+# CHECKME: Shouldn't there be something in the property name itself that designates
+#		   that these are for testing???
+IntrusionDetector.org.owasp.esapi.errors.IntegrityException.count=10
+IntrusionDetector.org.owasp.esapi.errors.IntegrityException.interval=5
+IntrusionDetector.org.owasp.esapi.errors.IntegrityException.actions=log,disable,logout
+
+# rapid validation errors indicate scans or attacks in progress
+# org.owasp.esapi.errors.ValidationException.count=10
+# org.owasp.esapi.errors.ValidationException.interval=10
+# org.owasp.esapi.errors.ValidationException.actions=log,logout
+
+# sessions jumping between hosts indicates session hijacking
+IntrusionDetector.org.owasp.esapi.errors.AuthenticationHostException.count=2
+IntrusionDetector.org.owasp.esapi.errors.AuthenticationHostException.interval=10
+IntrusionDetector.org.owasp.esapi.errors.AuthenticationHostException.actions=log,logout
+
+
+#===========================================================================
+# ESAPI Validation
+#
+# The ESAPI Validator works on regular expressions with defined names. You can define names
+# either here, or you may define application specific patterns in a separate file defined below.
+# This allows enterprises to specify both organizational standards as well as application specific
+# validation rules.
+#
+#Validator.ConfigurationFile.MultiValued=false
+Validator.ConfigurationFile=validation-test1.properties
+
+# Validators used by ESAPI
+Validator.AccountName=^[a-zA-Z0-9]{3,20}$
+Validator.SystemCommand=^[a-zA-Z\\-\\/]{1,64}$
+Validator.RoleName=^[a-z]{1,20}$
+Validator.Redirect=^\\/test.*$
+
+# Global HTTP Validation Rules
+# Values with Base64 encoded data (e.g. encrypted state) will need at least [a-zA-Z0-9\/+=]
+Validator.HTTPScheme=^(http|https)$
+Validator.HTTPServerName=^[a-zA-Z0-9_.\\-]*$
+Validator.HTTPCookieName=^[a-zA-Z0-9\\-_]{1,32}$
+Validator.HTTPCookieValue=^[a-zA-Z0-9\\-\\/+=_ ]*$
+Validator.HTTPHeaderName=^[a-zA-Z0-9\\-_]{1,32}$
+Validator.HTTPHeaderValue=^[a-zA-Z0-9()\\-=\\*\\.\\?;,+\\/:&_ ]*$
+Validator.HTTPServletPath=^[a-zA-Z0-9.\\-\\/_]*$
+Validator.HTTPPath=^[a-zA-Z0-9.\\-_]*$
+Validator.HTTPURL=^.*$
+Validator.HTTPJSESSIONID=^[A-Z0-9]{10,30}$
+
+# Contributed by Fraenku@gmx.ch
+# Googlecode Issue 116 (http://code.google.com/p/owasp-esapi-java/issues/detail?id=116)
+Validator.HTTPParameterName=^[a-zA-Z0-9_\\-]{1,32}$
+Validator.HTTPParameterValue=^[\\p{L}\\p{N}.\\-/+=_ !$*?@]{0,1000}$
+Validator.HTTPContextPath=^/[a-zA-Z0-9.\\-_]*$
+Validator.HTTPQueryString=^([a-zA-Z0-9_\\-]{1,32}=[\\p{L}\\p{N}.\\-/+=_ !$*?@%]*&?)*$
+Validator.HTTPURI=^/([a-zA-Z0-9.\\-_]*/?)*$
+
+
+# Validation of file related input
+Validator.FileName=^[a-zA-Z0-9!@#$%^&{}\\[\\]()_+\\-=,.~'` ]{1,255}$
+Validator.DirectoryName=^[a-zA-Z0-9:/\\\\!@#$%^&{}\\[\\]()_+\\-=,.~'` ]{1,255}$
+
+# Validation of dates. Controls whether or not 'lenient' dates are accepted.
+# See DataFormat.setLenient(boolean flag) for further details.
 Validator.AcceptLenientDates=false
\ No newline at end of file

From 770fb79545bc6ea869809121ab4b86f32212ec2a Mon Sep 17 00:00:00 2001
From: kwwall 
Date: Tue, 19 Jan 2016 01:12:42 -0500
Subject: [PATCH 322/812] Address issue 356.

---
 src/test/resources/esapi/ESAPI.properties | 942 +++++++++++-----------
 1 file changed, 471 insertions(+), 471 deletions(-)

diff --git a/src/test/resources/esapi/ESAPI.properties b/src/test/resources/esapi/ESAPI.properties
index 1a0506ebf..2727d4ada 100644
--- a/src/test/resources/esapi/ESAPI.properties
+++ b/src/test/resources/esapi/ESAPI.properties
@@ -1,471 +1,471 @@
-#
-# OWASP Enterprise Security API (ESAPI) Properties file -- TEST Version
-# 
-# This file is part of the Open Web Application Security Project (OWASP)
-# Enterprise Security API (ESAPI) project. For details, please see
-# http://www.owasp.org/index.php/ESAPI.
-#
-# Copyright (c) 2008,2009 - The OWASP Foundation
-#
-# DISCUSS: This may cause a major backwards compatibility issue, etc. but
-#		   from a name space perspective, we probably should have prefaced
-#		   all the property names with ESAPI or at least OWASP. Otherwise
-#		   there could be problems is someone loads this properties file into
-#		   the System properties.  We could also put this file into the
-#		   esapi.jar file (perhaps as a ResourceBundle) and then allow an external
-#		   ESAPI properties be defined that would overwrite these defaults.
-#		   That keeps the application's properties relatively simple as usually
-#		   they will only want to override a few properties. If looks like we
-#		   already support multiple override levels of this in the
-#		   DefaultSecurityConfiguration class, but I'm suggesting placing the
-#		   defaults in the esapi.jar itself. That way, if the jar is signed,
-#		   we could detect if those properties had been tampered with. (The
-#		   code to check the jar signatures is pretty simple... maybe 70-90 LOC,
-#		   but off course there is an execution penalty (similar to the way
-#		   that the separate sunjce.jar used to be when a class from it was
-#		   first loaded). Thoughts?
-###############################################################################
-#
-# WARNING: Operating system protection should be used to lock down the .esapi
-# resources directory and all the files inside and all the directories all the
-# way up to the root directory of the file system.  Note that if you are using
-# file-based implementations, that some files may need to be read-write as they
-# get updated dynamically.
-#
-# Before using, be sure to update the MasterKey and MasterSalt as described below.
-# N.B.: If you had stored data that you have previously encrypted with ESAPI 1.4,
-#		you *must* FIRST decrypt it using ESAPI 1.4 and then (if so desired)
-#		re-encrypt it with ESAPI 2.0. If you fail to do this, you will NOT be
-#		able to decrypt your data with ESAPI 2.0.
-#
-#		YOU HAVE BEEN WARNED!!! More details are in the ESAPI 2.0 Release Notes.
-#
-#===========================================================================
-# ESAPI Configuration
-#
-# If true, then print all the ESAPI properties set here when they are loaded.
-# If false, they are not printed. Useful to reduce output when running JUnit tests.
-# If you need to troubleshoot a properties related problem, turning this on may help,
-# but we leave it off for running JUnit tests. (It will be 'true' in the one delivered
-# as part of production ESAPI, mostly for backward compatibility.)
-ESAPI.printProperties=false
-
-# ESAPI is designed to be easily extensible. You can use the reference implementation
-# or implement your own providers to take advantage of your enterprise's security
-# infrastructure. The functions in ESAPI are referenced using the ESAPI locator, like:
-#
-#    String ciphertext =
-#		ESAPI.encryptor().encrypt("Secret message");   // Deprecated in 2.0
-#    CipherText cipherText =
-#		ESAPI.encryptor().encrypt(new PlainText("Secret message")); // Preferred
-#
-# Below you can specify the classname for the provider that you wish to use in your
-# application. The only requirement is that it implement the appropriate ESAPI interface.
-# This allows you to switch security implementations in the future without rewriting the
-# entire application.
-#
-# ExperimentalAccessController requires ESAPI-AccessControlPolicy.xml in .esapi directory
-ESAPI.AccessControl=org.owasp.esapi.reference.DefaultAccessController
-# FileBasedAuthenticator requires users.txt file in .esapi directory
-ESAPI.Authenticator=org.owasp.esapi.reference.FileBasedAuthenticator
-ESAPI.Encoder=org.owasp.esapi.reference.DefaultEncoder
-ESAPI.Encryptor=org.owasp.esapi.reference.crypto.JavaEncryptor
-
-ESAPI.Executor=org.owasp.esapi.reference.DefaultExecutor
-ESAPI.HTTPUtilities=org.owasp.esapi.reference.DefaultHTTPUtilities
-ESAPI.IntrusionDetector=org.owasp.esapi.reference.DefaultIntrusionDetector
-# Log4JFactory Requires log4j.xml or log4j.properties in classpath - http://www.laliluna.de/log4j-tutorial.html
-ESAPI.Logger=org.owasp.esapi.reference.Log4JLogFactory
-#ESAPI.Logger=org.owasp.esapi.reference.JavaLogFactory
-#ESAPI.Logger=org.owasp.esapi.reference.ExampleExtendedLog4JLogFactory
-ESAPI.Randomizer=org.owasp.esapi.reference.DefaultRandomizer
-ESAPI.Validator=org.owasp.esapi.reference.DefaultValidator
-
-#===========================================================================
-# ESAPI Authenticator
-#
-Authenticator.AllowedLoginAttempts=3
-Authenticator.MaxOldPasswordHashes=13
-Authenticator.UsernameParameterName=username
-Authenticator.PasswordParameterName=password
-# RememberTokenDuration (in days)
-Authenticator.RememberTokenDuration=14
-# Session Timeouts (in minutes)
-Authenticator.IdleTimeoutDuration=20
-Authenticator.AbsoluteTimeoutDuration=120
-
-#===========================================================================
-# ESAPI Encoder
-#
-# ESAPI canonicalizes input before validation to prevent bypassing filters with encoded attacks.
-# Failure to canonicalize input is a very common mistake when implementing validation schemes.
-# Canonicalization is automatic when using the ESAPI Validator, but you can also use the
-# following code to canonicalize data.
-#
-#      ESAPI.Encoder().canonicalize( "%22hello world"" );
-#  
-# Multiple encoding is when a single encoding format is applied multiple times. Allowing
-# multiple encoding is strongly discouraged.
-Encoder.AllowMultipleEncoding=false
-
-# Mixed encoding is when multiple different encoding formats are applied, or when
-# multiple formats are nested. Allowing multiple encoding is strongly discouraged.
-Encoder.AllowMixedEncoding=false
-
-# The default list of codecs to apply when canonicalizing untrusted data. The list should include the codecs
-# for all downstream interpreters or decoders. For example, if the data is likely to end up in a URL, HTML, or
-# inside JavaScript, then the list of codecs below is appropriate. The order of the list is not terribly important.
-Encoder.DefaultCodecList=HTMLEntityCodec,PercentCodec,JavaScriptCodec
-
-
-#===========================================================================
-# ESAPI Encryption
-#
-# The ESAPI Encryptor provides basic cryptographic functions with a simplified API.
-# To get started, generate a new key using java -classpath esapi.jar org.owasp.esapi.reference.crypto.JavaEncryptor
-# There is not currently any support for key rotation, so be careful when changing your key and salt as it
-# will invalidate all signed, encrypted, and hashed data.
-#
-# WARNING: Not all combinations of algorithms and key lengths are supported.
-# If you choose to use a key length greater than 128, you MUST download the
-# unlimited strength policy files and install in the lib directory of your JRE/JDK.
-# See http://java.sun.com/javase/downloads/index.jsp for more information.
-#
-# Backward compatibility with ESAPI Java 1.4 is supported by the two deprecated API
-# methods, Encryptor.encrypt(String) and Encryptor.decrypt(String). However, whenever
-# possible, these methods should be avoided as they use ECB cipher mode, which in almost
-# all circumstances a poor choice because of it's weakness. CBC cipher mode is the default
-# for the new Encryptor encrypt / decrypt methods for ESAPI Java 2.0.  In general, you
-# should only use this compatibility setting if you have persistent data encrypted with
-# version 1.4 and even then, you should ONLY set this compatibility mode UNTIL
-# you have decrypted all of your old encrypted data and then re-encrypted it with
-# ESAPI 2.0 using CBC mode. If you have some reason to mix the deprecated 1.4 mode
-# with the new 2.0 methods, make sure that you use the same cipher algorithm for both
-# (256-bit AES was the default for 1.4; 128-bit is the default for 2.0; see below for
-# more details.) Otherwise, you will have to use the new 2.0 encrypt / decrypt methods
-# where you can specify a SecretKey. (Note that if you are using the 256-bit AES,
-# that requires downloading the special jurisdiction policy files mentioned above.)
-#
-#		***** IMPORTANT: These are for JUnit testing. Test files may have been
-#						 encrypted using these values so do not change these or
-#						 those tests will fail. The version under
-#							src/main/resources/.esapi/ESAPI.properties
-#						 will be delivered with Encryptor.MasterKey and
-#						 Encryptor.MasterSalt set to the empty string.
-#
-#						 FINAL NOTE:
-#                           If Maven changes these when run, that needs to be fixed.
-#       256-bit key... requires unlimited strength jurisdiction policy files
-### Encryptor.MasterKey=pJhlri8JbuFYDgkqtHmm9s0Ziug2PE7ovZDyEPm4j14=
-#       128-bit key
-Encryptor.MasterKey=a6H9is3hEVGKB4Jut+lOVA==
-Encryptor.MasterSalt=SbftnvmEWD5ZHHP+pX3fqugNysc=
-# Encryptor.MasterSalt=
-
-# Provides the default JCE provider that ESAPI will "prefer" for its symmetric
-# encryption and hashing. (That is it will look to this provider first, but it
-# will defer to other providers if the requested algorithm is not implemented
-# by this provider.) If left unset, ESAPI will just use your Java VM's current
-# preferred JCE provider, which is generally set in the file
-# "$JAVA_HOME/jre/lib/security/java.security".
-#
-# The main intent of this is to allow ESAPI symmetric encryption to be
-# used with a FIPS 140-2 compliant crypto-module. For details, see the section
-# "Using ESAPI Symmetric Encryption with FIPS 140-2 Cryptographic Modules" in
-# the ESAPI 2.0 Symmetric Encryption User Guide, at:
-# http://owasp-esapi-java.googlecode.com/svn/trunk/documentation/esapi4java-core-2.0-symmetric-crypto-user-guide.html
-# However, this property also allows you to easily use an alternate JCE provider
-# such as "Bouncy Castle" without having to make changes to "java.security".
-# See Javadoc for SecurityProviderLoader for further details. If you wish to use
-# a provider that is not known to SecurityProviderLoader, you may specify the
-# fully-qualified class name of the JCE provider class that implements
-# java.security.Provider. If the name contains a '.', this is interpreted as
-# a fully-qualified class name that implements java.security.Provider.
-#
-# NOTE: Setting this property has the side-effect of changing it in your application
-#       as well, so if you are using JCE in your application directly rather than
-#       through ESAPI (you wouldn't do that, would you? ;-), it will change the
-#       preferred JCE provider there as well.
-#
-# Default: Keeps the JCE provider set to whatever JVM sets it to.
-Encryptor.PreferredJCEProvider=
-
-# AES is the most widely used and strongest encryption algorithm. This
-# should agree with your Encryptor.CipherTransformation property.
-# By default, ESAPI Java 1.4 uses "PBEWithMD5AndDES" and which is
-# very weak. It is essentially a password-based encryption key, hashed
-# with MD5 around 1K times and then encrypted with the weak DES algorithm
-# (56-bits) using ECB mode and an unspecified padding (it is
-# JCE provider specific, but most likely "NoPadding"). However, 2.0 uses
-# "AES/CBC/PKCSPadding". If you want to change these, change them here.
-# Warning: This property does not control the default reference implementation for
-#		   ESAPI 2.0 using JavaEncryptor. Also, this property will be dropped
-#		   in the future.
-# @deprecated
-Encryptor.EncryptionAlgorithm=AES
-#		For ESAPI Java 2.0 - New encrypt / decrypt methods use this.
-Encryptor.CipherTransformation=AES/CBC/PKCS5Padding
-
-# Applies to ESAPI 2.0 and later only!
-# Comma-separated list of cipher modes that provide *BOTH*
-# confidentiality *AND* message authenticity. (NIST refers to such cipher
-# modes as "combined modes" so that's what we shall call them.) If any of these
-# cipher modes are used then no MAC is calculated and stored
-# in the CipherText upon encryption. Likewise, if one of these
-# cipher modes is used with decryption, no attempt will be made
-# to validate the MAC contained in the CipherText object regardless
-# of whether it contains one or not. Since the expectation is that
-# these cipher modes support support message authenticity already,
-# injecting a MAC in the CipherText object would be at best redundant.
-#
-# Note that as of JDK 1.5, the SunJCE provider does not support *any*
-# of these cipher modes. Of these listed, only GCM and CCM are currently
-# NIST approved. YMMV for other JCE providers. E.g., Bouncy Castle supports
-# GCM and CCM with "NoPadding" mode, but not with "PKCS5Padding" or other
-# padding modes.
-Encryptor.cipher_modes.combined_modes=GCM,CCM,IAPM,EAX,OCB,CWC
-
-# Applies to ESAPI 2.0 and later only!
-# Additional cipher modes allowed for ESAPI 2.0 encryption. These
-# cipher modes are in _addition_ to those specified by the property
-# 'Encryptor.cipher_modes.combined_modes'.
-# Note: We will add support for streaming modes like CFB & OFB once
-# we add support for 'specified' to the property 'Encryptor.ChooseIVMethod'
-# (probably in ESAPI 2.1).
-#
-#	IMPORTANT NOTE:	In the official ESAPI.properties we do *NOT* include ECB
-#					here as this is an extremely weak mode. However, we *must*
-#					allow it here so we can test ECB mode. That is important
-#					since the logic is somewhat different (i.e., ECB mode does
-#					not use an IV).
-# DISCUSS: Better name?
-#	NOTE: ECB added only for testing purposes. Don't try this at home!
-Encryptor.cipher_modes.additional_allowed=CBC,ECB
-
-# 128-bit is almost always sufficient and appears to be more resistant to
-# related key attacks than is 256-bit AES. Use '_' to use default key size
-# for cipher algorithms (where it makes sense because the algorithm supports
-# a variable key size). Key length must agree to what's provided as the
-# cipher transformation, otherwise this will be ignored after logging a
-# warning.
-#
-# NOTE: This is what applies BOTH ESAPI 1.4 and 2.0. See warning above about mixing!
-Encryptor.EncryptionKeyLength=128
-
-# Because 2.0 uses CBC mode by default, it requires an initialization vector (IV).
-# (All cipher modes except ECB require an IV.) There are two choices: we can either
-# use a fixed IV known to both parties or allow ESAPI to choose a random IV. While
-# the IV does not need to be hidden from adversaries, it is important that the
-# adversary not be allowed to choose it. Also, random IVs are generally much more
-# secure than fixed IVs. (In fact, it is essential that feed-back cipher modes
-# such as CFB and OFB use a different IV for each encryption with a given key so
-# in such cases, random IVs are much preferred. By default, ESAPI 2.0 uses random
-# IVs. If you wish to use 'fixed' IVs, set 'Encryptor.ChooseIVMethod=fixed' and
-# uncomment the Encryptor.fixedIV.
-#
-# Valid values:		random|fixed|specified		'specified' not yet implemented; planned for 2.1
-Encryptor.ChooseIVMethod=random
-# If you choose to use a fixed IV, then you must place a fixed IV here that
-# is known to all others who are sharing your secret key. The format should
-# be a hex string that is the same length as the cipher block size for the
-# cipher algorithm that you are using. The following is an example for AES
-# from an AES test vector for AES-128/CBC as described in:
-# NIST Special Publication 800-38A (2001 Edition)
-# "Recommendation for Block Cipher Modes of Operation".
-# (Note that the block size for AES is 16 bytes == 128 bits.)
-#
-Encryptor.fixedIV=0x000102030405060708090a0b0c0d0e0f
-
-# Whether or not CipherText should use a message authentication code (MAC) with it.
-# This prevents an adversary from altering the IV as well as allowing a more
-# fool-proof way of determining the decryption failed because of an incorrect
-# key being supplied. This refers to the "separate" MAC calculated and stored
-# in CipherText, not part of any MAC that is calculated as a result of a
-# "combined mode" cipher mode.
-#
-# If you are using ESAPI with a FIPS 140-2 cryptographic module, you *must* also
-# set this property to false.
-Encryptor.CipherText.useMAC=true
-
-# Whether or not the PlainText object may be overwritten and then marked
-# eligible for garbage collection. If not set, this is still treated as 'true'.
-Encryptor.PlainText.overwrite=true
-
-# Do not use DES except in a legacy situations. 56-bit is way too small key size.
-#Encryptor.EncryptionKeyLength=56
-#Encryptor.EncryptionAlgorithm=DES
-
-# TripleDES is considered strong enough for most purposes.
-#	Note:	There is also a 112-bit version of DESede. Using the 168-bit version
-#			requires downloading the special jurisdiction policy from Sun.
-#Encryptor.EncryptionKeyLength=168
-#Encryptor.EncryptionAlgorithm=DESede
-
-Encryptor.HashAlgorithm=SHA-512
-Encryptor.HashIterations=1024
-Encryptor.DigitalSignatureAlgorithm=SHA1withDSA
-Encryptor.DigitalSignatureKeyLength=1024
-Encryptor.RandomAlgorithm=SHA1PRNG
-Encryptor.CharacterEncoding=UTF-8
-# Currently supported choices for JDK 1.5 and 1.6 are:
-#	HmacSHA1 (160 bits), HmacSHA256 (256 bits), HmacSHA384 (384 bits), and
-#	HmacSHA512 (512 bits).
-# Note that HmacMD5 is *not* supported for the PRF used by the KDF even though
-# these JDKs support it.
-Encryptor.KDF.PRF=HmacSHA256
-
-#===========================================================================
-# ESAPI HttpUtilties
-#
-# The HttpUtilities provide basic protections to HTTP requests and responses. Primarily these methods 
-# protect against malicious data from attackers, such as unprintable characters, escaped characters,
-# and other simple attacks. The HttpUtilities also provides utility methods for dealing with cookies,
-# headers, and CSRF tokens.
-#
-# Default file upload location (remember to escape backslashes with \\)
-HttpUtilities.UploadDir=C:\\ESAPI\\testUpload
-# let this default to java.io.tmpdir for testing
-#HttpUtilities.UploadTempDir=C:\\temp
-# Force flags on cookies, if you use HttpUtilities to set cookies
-HttpUtilities.ForceHttpOnlySession=false
-HttpUtilities.ForceSecureSession=false
-HttpUtilities.ForceHttpOnlyCookies=true
-HttpUtilities.ForceSecureCookies=true
-# Maximum size of HTTP headers
-HttpUtilities.MaxHeaderSize=4096
-# File upload configuration
-HttpUtilities.ApprovedUploadExtensions=.zip,.pdf,.doc,.docx,.ppt,.pptx,.tar,.gz,.tgz,.rar,.war,.jar,.ear,.xls,.rtf,.properties,.java,.class,.txt,.xml,.jsp,.jsf,.exe,.dll
-HttpUtilities.MaxUploadFileBytes=500000000
-# Using UTF-8 throughout your stack is highly recommended. That includes your database driver,
-# container, and any other technologies you may be using. Failure to do this may expose you
-# to Unicode transcoding injection attacks. Use of UTF-8 does not hinder internationalization.
-HttpUtilities.ResponseContentType=text/html; charset=UTF-8
-# This is the name of the cookie used to represent the HTTP session
-# Typically this will be the default "JSESSIONID" 
-HttpUtilities.HttpSessionIdName=JSESSIONID
-
-
-
-#===========================================================================
-# ESAPI Executor
-# CHECKME - Not sure what this is used for, but surely it should be made OS independent.
-Executor.WorkingDirectory=C:\\Windows\\Temp
-Executor.ApprovedExecutables=C:\\Windows\\System32\\cmd.exe,C:\\Windows\\System32\\runas.exe
-
-
-#===========================================================================
-# ESAPI Logging
-# Set the application name if these logs are combined with other applications
-Logger.ApplicationName=ExampleApplication
-# If you use an HTML log viewer that does not properly HTML escape log data, you can set LogEncodingRequired to true
-Logger.LogEncodingRequired=false
-# Determines whether ESAPI should log the application name. This might be clutter in some single-server/single-app environments.
-Logger.LogApplicationName=true
-# Determines whether ESAPI should log the server IP and port. This might be clutter in some single-server environments.
-Logger.LogServerIP=true
-# LogFileName, the name of the logging file. Provide a full directory path (e.g., C:\\ESAPI\\ESAPI_logging_file) if you
-# want to place it in a specific directory.
-Logger.LogFileName=ESAPI_logging_file
-# MaxLogFileSize, the max size (in bytes) of a single log file before it cuts over to a new one (default is 10,000,000)
-Logger.MaxLogFileSize=10000000
-
-
-#===========================================================================
-# ESAPI Intrusion Detection
-#
-# Each event has a base to which .count, .interval, and .action are added
-# The IntrusionException will fire if we receive "count" events within "interval" seconds
-# The IntrusionDetector is configurable to take the following actions: log, logout, and disable
-#  (multiple actions separated by commas are allowed e.g. event.test.actions=log,disable
-#
-# Custom Events
-# Names must start with "event." as the base
-# Use IntrusionDetector.addEvent( "test" ) in your code to trigger "event.test" here
-# You can also disable intrusion detection completely by changing
-# the following parameter to true
-#
-IntrusionDetector.Disable=false
-#
-IntrusionDetector.event.test.count=2
-IntrusionDetector.event.test.interval=10
-IntrusionDetector.event.test.actions=disable,log
-
-# Exception Events
-# All EnterpriseSecurityExceptions are registered automatically
-# Call IntrusionDetector.getInstance().addException(e) for Exceptions that do not extend EnterpriseSecurityException
-# Use the fully qualified classname of the exception as the base
-
-# any intrusion is an attack
-IntrusionDetector.org.owasp.esapi.errors.IntrusionException.count=1
-IntrusionDetector.org.owasp.esapi.errors.IntrusionException.interval=1
-IntrusionDetector.org.owasp.esapi.errors.IntrusionException.actions=log,disable,logout
-
-# for test purposes
-# CHECKME: Shouldn't there be something in the property name itself that designates
-#		   that these are for testing???
-IntrusionDetector.org.owasp.esapi.errors.IntegrityException.count=10
-IntrusionDetector.org.owasp.esapi.errors.IntegrityException.interval=5
-IntrusionDetector.org.owasp.esapi.errors.IntegrityException.actions=log,disable,logout
-
-# rapid validation errors indicate scans or attacks in progress
-# org.owasp.esapi.errors.ValidationException.count=10
-# org.owasp.esapi.errors.ValidationException.interval=10
-# org.owasp.esapi.errors.ValidationException.actions=log,logout
-
-# sessions jumping between hosts indicates session hijacking
-IntrusionDetector.org.owasp.esapi.errors.AuthenticationHostException.count=2
-IntrusionDetector.org.owasp.esapi.errors.AuthenticationHostException.interval=10
-IntrusionDetector.org.owasp.esapi.errors.AuthenticationHostException.actions=log,logout
-
-
-#===========================================================================
-# ESAPI Validation
-#
-# The ESAPI Validator works on regular expressions with defined names. You can define names
-# either here, or you may define application specific patterns in a separate file defined below.
-# This allows enterprises to specify both organizational standards as well as application specific
-# validation rules.
-#
-# Use '\p{L}' (without the quotes) within the character class to match
-# any Unicode LETTER. You can also use a range, like:  \u00C0-\u017F
-# You can also use any of the regex flags as documented at
-# https://docs.oracle.com/javase/tutorial/essential/regex/pattern.html, e.g. (?u)
-#
-Validator.ConfigurationFile=validation.properties
-
-# Validators used by ESAPI
-Validator.AccountName=^[a-zA-Z0-9]{3,20}$
-Validator.SystemCommand=^[a-zA-Z\\-\\/]{1,64}$
-Validator.RoleName=^[a-z]{1,20}$
-Validator.Redirect=^\\/test.*$
-
-# Global HTTP Validation Rules
-# Values with Base64 encoded data (e.g. encrypted state) will need at least [a-zA-Z0-9\/+=]
-Validator.HTTPScheme=^(http|https)$
-Validator.HTTPServerName=^[a-zA-Z0-9_.\\-]*$
-Validator.HTTPCookieName=^[a-zA-Z0-9\\-_]{1,32}$
-Validator.HTTPCookieValue=^[a-zA-Z0-9\\-\\/+=_ ]*$
-# Note that max header name capped at 150 in SecurityRequestWrapper!
-Validator.HTTPHeaderName=^[a-zA-Z0-9\\-_]{1,50}$
-Validator.HTTPHeaderValue=^[a-zA-Z0-9()\\-=\\*\\.\\?;,+\\/:&_ ]*$
-Validator.HTTPServletPath=^[a-zA-Z0-9.\\-\\/_]*$
-Validator.HTTPPath=^[a-zA-Z0-9.\\-_]*$
-Validator.HTTPURL=^.*$
-Validator.HTTPJSESSIONID=^[A-Z0-9]{10,30}$
-
-# Contributed by Fraenku@gmx.ch
-# Googlecode Issue 116 (http://code.google.com/p/owasp-esapi-java/issues/detail?id=116)
-Validator.HTTPParameterName=^[a-zA-Z0-9_\\-]{1,32}$
-Validator.HTTPParameterValue=^[\\p{L}\\p{N}.\\-/+=_ !$*?@]{0,1000}$
-Validator.HTTPContextPath=^/[a-zA-Z0-9.\\-_]*$
-Validator.HTTPQueryString=^([a-zA-Z0-9_\\-]{1,32}=[\\p{L}\\p{N}.\\-/+=_ !$*?@%]*&?)*$
-Validator.HTTPURI=^/([a-zA-Z0-9.\\-_]*/?)*$
-
-
-# Validation of file related input
-Validator.FileName=^[a-zA-Z0-9!@#$%^&{}\\[\\]()_+\\-=,.~'` ]{1,255}$
-Validator.DirectoryName=^[a-zA-Z0-9:/\\\\!@#$%^&{}\\[\\]()_+\\-=,.~'` ]{1,255}$
-
-# Validation of dates. Controls whether or not 'lenient' dates are accepted.
-# See DataFormat.setLenient(boolean flag) for further details.
-Validator.AcceptLenientDates=false
+#
+# OWASP Enterprise Security API (ESAPI) Properties file -- TEST Version
+# 
+# This file is part of the Open Web Application Security Project (OWASP)
+# Enterprise Security API (ESAPI) project. For details, please see
+# http://www.owasp.org/index.php/ESAPI.
+#
+# Copyright (c) 2008,2009 - The OWASP Foundation
+#
+# DISCUSS: This may cause a major backwards compatibility issue, etc. but
+#		   from a name space perspective, we probably should have prefaced
+#		   all the property names with ESAPI or at least OWASP. Otherwise
+#		   there could be problems is someone loads this properties file into
+#		   the System properties.  We could also put this file into the
+#		   esapi.jar file (perhaps as a ResourceBundle) and then allow an external
+#		   ESAPI properties be defined that would overwrite these defaults.
+#		   That keeps the application's properties relatively simple as usually
+#		   they will only want to override a few properties. If looks like we
+#		   already support multiple override levels of this in the
+#		   DefaultSecurityConfiguration class, but I'm suggesting placing the
+#		   defaults in the esapi.jar itself. That way, if the jar is signed,
+#		   we could detect if those properties had been tampered with. (The
+#		   code to check the jar signatures is pretty simple... maybe 70-90 LOC,
+#		   but off course there is an execution penalty (similar to the way
+#		   that the separate sunjce.jar used to be when a class from it was
+#		   first loaded). Thoughts?
+###############################################################################
+#
+# WARNING: Operating system protection should be used to lock down the .esapi
+# resources directory and all the files inside and all the directories all the
+# way up to the root directory of the file system.  Note that if you are using
+# file-based implementations, that some files may need to be read-write as they
+# get updated dynamically.
+#
+# Before using, be sure to update the MasterKey and MasterSalt as described below.
+# N.B.: If you had stored data that you have previously encrypted with ESAPI 1.4,
+#		you *must* FIRST decrypt it using ESAPI 1.4 and then (if so desired)
+#		re-encrypt it with ESAPI 2.0. If you fail to do this, you will NOT be
+#		able to decrypt your data with ESAPI 2.0.
+#
+#		YOU HAVE BEEN WARNED!!! More details are in the ESAPI 2.0 Release Notes.
+#
+#===========================================================================
+# ESAPI Configuration
+#
+# If true, then print all the ESAPI properties set here when they are loaded.
+# If false, they are not printed. Useful to reduce output when running JUnit tests.
+# If you need to troubleshoot a properties related problem, turning this on may help,
+# but we leave it off for running JUnit tests. (It will be 'true' in the one delivered
+# as part of production ESAPI, mostly for backward compatibility.)
+ESAPI.printProperties=false
+
+# ESAPI is designed to be easily extensible. You can use the reference implementation
+# or implement your own providers to take advantage of your enterprise's security
+# infrastructure. The functions in ESAPI are referenced using the ESAPI locator, like:
+#
+#    String ciphertext =
+#		ESAPI.encryptor().encrypt("Secret message");   // Deprecated in 2.0
+#    CipherText cipherText =
+#		ESAPI.encryptor().encrypt(new PlainText("Secret message")); // Preferred
+#
+# Below you can specify the classname for the provider that you wish to use in your
+# application. The only requirement is that it implement the appropriate ESAPI interface.
+# This allows you to switch security implementations in the future without rewriting the
+# entire application.
+#
+# ExperimentalAccessController requires ESAPI-AccessControlPolicy.xml in .esapi directory
+ESAPI.AccessControl=org.owasp.esapi.reference.DefaultAccessController
+# FileBasedAuthenticator requires users.txt file in .esapi directory
+ESAPI.Authenticator=org.owasp.esapi.reference.FileBasedAuthenticator
+ESAPI.Encoder=org.owasp.esapi.reference.DefaultEncoder
+ESAPI.Encryptor=org.owasp.esapi.reference.crypto.JavaEncryptor
+
+ESAPI.Executor=org.owasp.esapi.reference.DefaultExecutor
+ESAPI.HTTPUtilities=org.owasp.esapi.reference.DefaultHTTPUtilities
+ESAPI.IntrusionDetector=org.owasp.esapi.reference.DefaultIntrusionDetector
+# Log4JFactory Requires log4j.xml or log4j.properties in classpath - http://www.laliluna.de/log4j-tutorial.html
+ESAPI.Logger=org.owasp.esapi.reference.Log4JLogFactory
+#ESAPI.Logger=org.owasp.esapi.reference.JavaLogFactory
+#ESAPI.Logger=org.owasp.esapi.reference.ExampleExtendedLog4JLogFactory
+ESAPI.Randomizer=org.owasp.esapi.reference.DefaultRandomizer
+ESAPI.Validator=org.owasp.esapi.reference.DefaultValidator
+
+#===========================================================================
+# ESAPI Authenticator
+#
+Authenticator.AllowedLoginAttempts=3
+Authenticator.MaxOldPasswordHashes=13
+Authenticator.UsernameParameterName=username
+Authenticator.PasswordParameterName=password
+# RememberTokenDuration (in days)
+Authenticator.RememberTokenDuration=14
+# Session Timeouts (in minutes)
+Authenticator.IdleTimeoutDuration=20
+Authenticator.AbsoluteTimeoutDuration=120
+
+#===========================================================================
+# ESAPI Encoder
+#
+# ESAPI canonicalizes input before validation to prevent bypassing filters with encoded attacks.
+# Failure to canonicalize input is a very common mistake when implementing validation schemes.
+# Canonicalization is automatic when using the ESAPI Validator, but you can also use the
+# following code to canonicalize data.
+#
+#      ESAPI.Encoder().canonicalize( "%22hello world"" );
+#  
+# Multiple encoding is when a single encoding format is applied multiple times. Allowing
+# multiple encoding is strongly discouraged.
+Encoder.AllowMultipleEncoding=false
+
+# Mixed encoding is when multiple different encoding formats are applied, or when
+# multiple formats are nested. Allowing multiple encoding is strongly discouraged.
+Encoder.AllowMixedEncoding=false
+
+# The default list of codecs to apply when canonicalizing untrusted data. The list should include the codecs
+# for all downstream interpreters or decoders. For example, if the data is likely to end up in a URL, HTML, or
+# inside JavaScript, then the list of codecs below is appropriate. The order of the list is not terribly important.
+Encoder.DefaultCodecList=HTMLEntityCodec,PercentCodec,JavaScriptCodec
+
+
+#===========================================================================
+# ESAPI Encryption
+#
+# The ESAPI Encryptor provides basic cryptographic functions with a simplified API.
+# To get started, generate a new key using java -classpath esapi.jar org.owasp.esapi.reference.crypto.JavaEncryptor
+# There is not currently any support for key rotation, so be careful when changing your key and salt as it
+# will invalidate all signed, encrypted, and hashed data.
+#
+# WARNING: Not all combinations of algorithms and key lengths are supported.
+# If you choose to use a key length greater than 128, you MUST download the
+# unlimited strength policy files and install in the lib directory of your JRE/JDK.
+# See http://java.sun.com/javase/downloads/index.jsp for more information.
+#
+# Backward compatibility with ESAPI Java 1.4 is supported by the two deprecated API
+# methods, Encryptor.encrypt(String) and Encryptor.decrypt(String). However, whenever
+# possible, these methods should be avoided as they use ECB cipher mode, which in almost
+# all circumstances a poor choice because of it's weakness. CBC cipher mode is the default
+# for the new Encryptor encrypt / decrypt methods for ESAPI Java 2.0.  In general, you
+# should only use this compatibility setting if you have persistent data encrypted with
+# version 1.4 and even then, you should ONLY set this compatibility mode UNTIL
+# you have decrypted all of your old encrypted data and then re-encrypted it with
+# ESAPI 2.0 using CBC mode. If you have some reason to mix the deprecated 1.4 mode
+# with the new 2.0 methods, make sure that you use the same cipher algorithm for both
+# (256-bit AES was the default for 1.4; 128-bit is the default for 2.0; see below for
+# more details.) Otherwise, you will have to use the new 2.0 encrypt / decrypt methods
+# where you can specify a SecretKey. (Note that if you are using the 256-bit AES,
+# that requires downloading the special jurisdiction policy files mentioned above.)
+#
+#		***** IMPORTANT: These are for JUnit testing. Test files may have been
+#						 encrypted using these values so do not change these or
+#						 those tests will fail. The version under
+#							src/main/resources/.esapi/ESAPI.properties
+#						 will be delivered with Encryptor.MasterKey and
+#						 Encryptor.MasterSalt set to the empty string.
+#
+#						 FINAL NOTE:
+#                           If Maven changes these when run, that needs to be fixed.
+#       256-bit key... requires unlimited strength jurisdiction policy files
+### Encryptor.MasterKey=pJhlri8JbuFYDgkqtHmm9s0Ziug2PE7ovZDyEPm4j14=
+#       128-bit key
+Encryptor.MasterKey=a6H9is3hEVGKB4Jut+lOVA==
+Encryptor.MasterSalt=SbftnvmEWD5ZHHP+pX3fqugNysc=
+# Encryptor.MasterSalt=
+
+# Provides the default JCE provider that ESAPI will "prefer" for its symmetric
+# encryption and hashing. (That is it will look to this provider first, but it
+# will defer to other providers if the requested algorithm is not implemented
+# by this provider.) If left unset, ESAPI will just use your Java VM's current
+# preferred JCE provider, which is generally set in the file
+# "$JAVA_HOME/jre/lib/security/java.security".
+#
+# The main intent of this is to allow ESAPI symmetric encryption to be
+# used with a FIPS 140-2 compliant crypto-module. For details, see the section
+# "Using ESAPI Symmetric Encryption with FIPS 140-2 Cryptographic Modules" in
+# the ESAPI 2.0 Symmetric Encryption User Guide, at:
+# http://owasp-esapi-java.googlecode.com/svn/trunk/documentation/esapi4java-core-2.0-symmetric-crypto-user-guide.html
+# However, this property also allows you to easily use an alternate JCE provider
+# such as "Bouncy Castle" without having to make changes to "java.security".
+# See Javadoc for SecurityProviderLoader for further details. If you wish to use
+# a provider that is not known to SecurityProviderLoader, you may specify the
+# fully-qualified class name of the JCE provider class that implements
+# java.security.Provider. If the name contains a '.', this is interpreted as
+# a fully-qualified class name that implements java.security.Provider.
+#
+# NOTE: Setting this property has the side-effect of changing it in your application
+#       as well, so if you are using JCE in your application directly rather than
+#       through ESAPI (you wouldn't do that, would you? ;-), it will change the
+#       preferred JCE provider there as well.
+#
+# Default: Keeps the JCE provider set to whatever JVM sets it to.
+Encryptor.PreferredJCEProvider=
+
+# AES is the most widely used and strongest encryption algorithm. This
+# should agree with your Encryptor.CipherTransformation property.
+# By default, ESAPI Java 1.4 uses "PBEWithMD5AndDES" and which is
+# very weak. It is essentially a password-based encryption key, hashed
+# with MD5 around 1K times and then encrypted with the weak DES algorithm
+# (56-bits) using ECB mode and an unspecified padding (it is
+# JCE provider specific, but most likely "NoPadding"). However, 2.0 uses
+# "AES/CBC/PKCSPadding". If you want to change these, change them here.
+# Warning: This property does not control the default reference implementation for
+#		   ESAPI 2.0 using JavaEncryptor. Also, this property will be dropped
+#		   in the future.
+# @deprecated
+Encryptor.EncryptionAlgorithm=AES
+#		For ESAPI Java 2.0 - New encrypt / decrypt methods use this.
+Encryptor.CipherTransformation=AES/CBC/PKCS5Padding
+
+# Applies to ESAPI 2.0 and later only!
+# Comma-separated list of cipher modes that provide *BOTH*
+# confidentiality *AND* message authenticity. (NIST refers to such cipher
+# modes as "combined modes" so that's what we shall call them.) If any of these
+# cipher modes are used then no MAC is calculated and stored
+# in the CipherText upon encryption. Likewise, if one of these
+# cipher modes is used with decryption, no attempt will be made
+# to validate the MAC contained in the CipherText object regardless
+# of whether it contains one or not. Since the expectation is that
+# these cipher modes support support message authenticity already,
+# injecting a MAC in the CipherText object would be at best redundant.
+#
+# Note that as of JDK 1.5, the SunJCE provider does not support *any*
+# of these cipher modes. Of these listed, only GCM and CCM are currently
+# NIST approved. YMMV for other JCE providers. E.g., Bouncy Castle supports
+# GCM and CCM with "NoPadding" mode, but not with "PKCS5Padding" or other
+# padding modes.
+Encryptor.cipher_modes.combined_modes=GCM,CCM,IAPM,EAX,OCB,CWC
+
+# Applies to ESAPI 2.0 and later only!
+# Additional cipher modes allowed for ESAPI 2.0 encryption. These
+# cipher modes are in _addition_ to those specified by the property
+# 'Encryptor.cipher_modes.combined_modes'.
+# Note: We will add support for streaming modes like CFB & OFB once
+# we add support for 'specified' to the property 'Encryptor.ChooseIVMethod'
+# (probably in ESAPI 2.1).
+#
+#	IMPORTANT NOTE:	In the official ESAPI.properties we do *NOT* include ECB
+#					here as this is an extremely weak mode. However, we *must*
+#					allow it here so we can test ECB mode. That is important
+#					since the logic is somewhat different (i.e., ECB mode does
+#					not use an IV).
+# DISCUSS: Better name?
+#	NOTE: ECB added only for testing purposes. Don't try this at home!
+Encryptor.cipher_modes.additional_allowed=CBC,ECB
+
+# 128-bit is almost always sufficient and appears to be more resistant to
+# related key attacks than is 256-bit AES. Use '_' to use default key size
+# for cipher algorithms (where it makes sense because the algorithm supports
+# a variable key size). Key length must agree to what's provided as the
+# cipher transformation, otherwise this will be ignored after logging a
+# warning.
+#
+# NOTE: This is what applies BOTH ESAPI 1.4 and 2.0. See warning above about mixing!
+Encryptor.EncryptionKeyLength=128
+
+# Because 2.0 uses CBC mode by default, it requires an initialization vector (IV).
+# (All cipher modes except ECB require an IV.) There are two choices: we can either
+# use a fixed IV known to both parties or allow ESAPI to choose a random IV. While
+# the IV does not need to be hidden from adversaries, it is important that the
+# adversary not be allowed to choose it. Also, random IVs are generally much more
+# secure than fixed IVs. (In fact, it is essential that feed-back cipher modes
+# such as CFB and OFB use a different IV for each encryption with a given key so
+# in such cases, random IVs are much preferred. By default, ESAPI 2.0 uses random
+# IVs. If you wish to use 'fixed' IVs, set 'Encryptor.ChooseIVMethod=fixed' and
+# uncomment the Encryptor.fixedIV.
+#
+# Valid values:		random|fixed|specified		'specified' not yet implemented; planned for 2.1
+Encryptor.ChooseIVMethod=random
+# If you choose to use a fixed IV, then you must place a fixed IV here that
+# is known to all others who are sharing your secret key. The format should
+# be a hex string that is the same length as the cipher block size for the
+# cipher algorithm that you are using. The following is an example for AES
+# from an AES test vector for AES-128/CBC as described in:
+# NIST Special Publication 800-38A (2001 Edition)
+# "Recommendation for Block Cipher Modes of Operation".
+# (Note that the block size for AES is 16 bytes == 128 bits.)
+#
+Encryptor.fixedIV=0x000102030405060708090a0b0c0d0e0f
+
+# Whether or not CipherText should use a message authentication code (MAC) with it.
+# This prevents an adversary from altering the IV as well as allowing a more
+# fool-proof way of determining the decryption failed because of an incorrect
+# key being supplied. This refers to the "separate" MAC calculated and stored
+# in CipherText, not part of any MAC that is calculated as a result of a
+# "combined mode" cipher mode.
+#
+# If you are using ESAPI with a FIPS 140-2 cryptographic module, you *must* also
+# set this property to false.
+Encryptor.CipherText.useMAC=true
+
+# Whether or not the PlainText object may be overwritten and then marked
+# eligible for garbage collection. If not set, this is still treated as 'true'.
+Encryptor.PlainText.overwrite=true
+
+# Do not use DES except in a legacy situations. 56-bit is way too small key size.
+#Encryptor.EncryptionKeyLength=56
+#Encryptor.EncryptionAlgorithm=DES
+
+# TripleDES is considered strong enough for most purposes.
+#	Note:	There is also a 112-bit version of DESede. Using the 168-bit version
+#			requires downloading the special jurisdiction policy from Sun.
+#Encryptor.EncryptionKeyLength=168
+#Encryptor.EncryptionAlgorithm=DESede
+
+Encryptor.HashAlgorithm=SHA-512
+Encryptor.HashIterations=1024
+Encryptor.DigitalSignatureAlgorithm=SHA1withDSA
+Encryptor.DigitalSignatureKeyLength=1024
+Encryptor.RandomAlgorithm=SHA1PRNG
+Encryptor.CharacterEncoding=UTF-8
+# Currently supported choices for JDK 1.5 and 1.6 are:
+#	HmacSHA1 (160 bits), HmacSHA256 (256 bits), HmacSHA384 (384 bits), and
+#	HmacSHA512 (512 bits).
+# Note that HmacMD5 is *not* supported for the PRF used by the KDF even though
+# these JDKs support it.
+Encryptor.KDF.PRF=HmacSHA256
+
+#===========================================================================
+# ESAPI HttpUtilties
+#
+# The HttpUtilities provide basic protections to HTTP requests and responses. Primarily these methods 
+# protect against malicious data from attackers, such as unprintable characters, escaped characters,
+# and other simple attacks. The HttpUtilities also provides utility methods for dealing with cookies,
+# headers, and CSRF tokens.
+#
+# Default file upload location (remember to escape backslashes with \\)
+HttpUtilities.UploadDir=C:\\ESAPI\\testUpload
+# let this default to java.io.tmpdir for testing
+#HttpUtilities.UploadTempDir=C:\\temp
+# Force flags on cookies, if you use HttpUtilities to set cookies
+HttpUtilities.ForceHttpOnlySession=false
+HttpUtilities.ForceSecureSession=false
+HttpUtilities.ForceHttpOnlyCookies=true
+HttpUtilities.ForceSecureCookies=true
+# Maximum size of HTTP headers
+HttpUtilities.MaxHeaderSize=4096
+# File upload configuration
+HttpUtilities.ApprovedUploadExtensions=.zip,.pdf,.doc,.docx,.ppt,.pptx,.tar,.gz,.tgz,.rar,.war,.jar,.ear,.xls,.rtf,.properties,.java,.class,.txt,.xml,.jsp,.jsf,.exe,.dll
+HttpUtilities.MaxUploadFileBytes=500000000
+# Using UTF-8 throughout your stack is highly recommended. That includes your database driver,
+# container, and any other technologies you may be using. Failure to do this may expose you
+# to Unicode transcoding injection attacks. Use of UTF-8 does not hinder internationalization.
+HttpUtilities.ResponseContentType=text/html; charset=UTF-8
+# This is the name of the cookie used to represent the HTTP session
+# Typically this will be the default "JSESSIONID" 
+HttpUtilities.HttpSessionIdName=JSESSIONID
+
+
+
+#===========================================================================
+# ESAPI Executor
+# CHECKME - Not sure what this is used for, but surely it should be made OS independent.
+Executor.WorkingDirectory=C:\\Windows\\Temp
+Executor.ApprovedExecutables=C:\\Windows\\System32\\cmd.exe,C:\\Windows\\System32\\runas.exe
+
+
+#===========================================================================
+# ESAPI Logging
+# Set the application name if these logs are combined with other applications
+Logger.ApplicationName=ExampleApplication
+# If you use an HTML log viewer that does not properly HTML escape log data, you can set LogEncodingRequired to true
+Logger.LogEncodingRequired=false
+# Determines whether ESAPI should log the application name. This might be clutter in some single-server/single-app environments.
+Logger.LogApplicationName=true
+# Determines whether ESAPI should log the server IP and port. This might be clutter in some single-server environments.
+Logger.LogServerIP=true
+# LogFileName, the name of the logging file. Provide a full directory path (e.g., C:\\ESAPI\\ESAPI_logging_file) if you
+# want to place it in a specific directory.
+Logger.LogFileName=ESAPI_logging_file
+# MaxLogFileSize, the max size (in bytes) of a single log file before it cuts over to a new one (default is 10,000,000)
+Logger.MaxLogFileSize=10000000
+
+
+#===========================================================================
+# ESAPI Intrusion Detection
+#
+# Each event has a base to which .count, .interval, and .action are added
+# The IntrusionException will fire if we receive "count" events within "interval" seconds
+# The IntrusionDetector is configurable to take the following actions: log, logout, and disable
+#  (multiple actions separated by commas are allowed e.g. event.test.actions=log,disable
+#
+# Custom Events
+# Names must start with "event." as the base
+# Use IntrusionDetector.addEvent( "test" ) in your code to trigger "event.test" here
+# You can also disable intrusion detection completely by changing
+# the following parameter to true
+#
+IntrusionDetector.Disable=false
+#
+IntrusionDetector.event.test.count=2
+IntrusionDetector.event.test.interval=10
+IntrusionDetector.event.test.actions=disable,log
+
+# Exception Events
+# All EnterpriseSecurityExceptions are registered automatically
+# Call IntrusionDetector.getInstance().addException(e) for Exceptions that do not extend EnterpriseSecurityException
+# Use the fully qualified classname of the exception as the base
+
+# any intrusion is an attack
+IntrusionDetector.org.owasp.esapi.errors.IntrusionException.count=1
+IntrusionDetector.org.owasp.esapi.errors.IntrusionException.interval=1
+IntrusionDetector.org.owasp.esapi.errors.IntrusionException.actions=log,disable,logout
+
+# for test purposes
+# CHECKME: Shouldn't there be something in the property name itself that designates
+#		   that these are for testing???
+IntrusionDetector.org.owasp.esapi.errors.IntegrityException.count=10
+IntrusionDetector.org.owasp.esapi.errors.IntegrityException.interval=5
+IntrusionDetector.org.owasp.esapi.errors.IntegrityException.actions=log,disable,logout
+
+# rapid validation errors indicate scans or attacks in progress
+# org.owasp.esapi.errors.ValidationException.count=10
+# org.owasp.esapi.errors.ValidationException.interval=10
+# org.owasp.esapi.errors.ValidationException.actions=log,logout
+
+# sessions jumping between hosts indicates session hijacking
+IntrusionDetector.org.owasp.esapi.errors.AuthenticationHostException.count=2
+IntrusionDetector.org.owasp.esapi.errors.AuthenticationHostException.interval=10
+IntrusionDetector.org.owasp.esapi.errors.AuthenticationHostException.actions=log,logout
+
+
+#===========================================================================
+# ESAPI Validation
+#
+# The ESAPI Validator works on regular expressions with defined names. You can define names
+# either here, or you may define application specific patterns in a separate file defined below.
+# This allows enterprises to specify both organizational standards as well as application specific
+# validation rules.
+#
+# Use '\p{L}' (without the quotes) within the character class to match
+# any Unicode LETTER. You can also use a range, like:  \u00C0-\u017F
+# You can also use any of the regex flags as documented at
+# https://docs.oracle.com/javase/tutorial/essential/regex/pattern.html, e.g. (?u)
+#
+Validator.ConfigurationFile=validation.properties
+
+# Validators used by ESAPI
+Validator.AccountName=^[a-zA-Z0-9]{3,20}$
+Validator.SystemCommand=^[a-zA-Z\\-\\/]{1,64}$
+Validator.RoleName=^[a-z]{1,20}$
+Validator.Redirect=^\\/test.*$
+
+# Global HTTP Validation Rules
+# Values with Base64 encoded data (e.g. encrypted state) will need at least [a-zA-Z0-9\/+=]
+Validator.HTTPScheme=^(http|https)$
+Validator.HTTPServerName=^[a-zA-Z0-9_.\\-]*$
+Validator.HTTPCookieName=^[a-zA-Z0-9\\-_]{1,32}$
+Validator.HTTPCookieValue=^[a-zA-Z0-9\\-\\/+=_ ]*$
+# Note that max header name capped at 150 in SecurityRequestWrapper!
+Validator.HTTPHeaderName=^[a-zA-Z0-9\\-_]{1,50}$
+Validator.HTTPHeaderValue=^[a-zA-Z0-9()\\-=\\*\\.\\?;,+\\/:&_ ]*$
+Validator.HTTPServletPath=^[a-zA-Z0-9.\\-\\/_]*$
+Validator.HTTPPath=^[a-zA-Z0-9.\\-_]*$
+Validator.HTTPURL=^.*$
+Validator.HTTPJSESSIONID=^[A-Z0-9]{10,30}$
+
+# Contributed by Fraenku@gmx.ch
+# Googlecode Issue 116 (http://code.google.com/p/owasp-esapi-java/issues/detail?id=116)
+Validator.HTTPParameterName=^[a-zA-Z0-9_\\-]{1,32}$
+Validator.HTTPParameterValue=^[\\p{L}\\p{N}.\\-/+=_ !$*?@]{0,1000}$
+Validator.HTTPContextPath=^/[a-zA-Z0-9.\\-_]*$
+Validator.HTTPQueryString=^([a-zA-Z0-9_\\-]{1,32}=[\\p{L}\\p{N}.\\-/+=_ !$*?@%]*&?)*$
+Validator.HTTPURI=^/([a-zA-Z0-9.\\-_]*/?)*$
+
+
+# Validation of file related input
+Validator.FileName=^[a-zA-Z0-9!@#$%^&{}\\[\\]()_+\\-=,.~'` ]{1,255}$
+Validator.DirectoryName=^[a-zA-Z0-9:/\\\\!@#$%^&{}\\[\\]()_+\\-=,.~'` ]{1,255}$
+
+# Validation of dates. Controls whether or not 'lenient' dates are accepted.
+# See DataFormat.setLenient(boolean flag) for further details.
+Validator.AcceptLenientDates=false

From ab4d74b374242a350a7716c51385d850e00b9215 Mon Sep 17 00:00:00 2001
From: kwwall 
Date: Tue, 19 Jan 2016 01:12:42 -0500
Subject: [PATCH 323/812] Address issue 356.

---
 .../resources/esapi/validation.properties     | 58 +++++++++----------
 1 file changed, 29 insertions(+), 29 deletions(-)

diff --git a/src/test/resources/esapi/validation.properties b/src/test/resources/esapi/validation.properties
index 18e037f3b..433fa0b6b 100644
--- a/src/test/resources/esapi/validation.properties
+++ b/src/test/resources/esapi/validation.properties
@@ -1,29 +1,29 @@
-# The ESAPI validator does many security checks on input, such as canonicalization
-# and whitelist validation. Note that all of these validation rules are applied *after*
-# canonicalization. Double-encoded characters (even with different encodings involved,
-# are never allowed.
-#
-# To use:
-#
-# First set up a pattern below. You can choose any name you want, prefixed by the word
-# "Validation." For example:
-#   Validation.Email=^[A-Za-z0-9._%-]+@[A-Za-z0-9.-]+\\.[a-zA-Z]{2,4}$
-# 
-# Then you can validate in your code against the pattern like this:
-#     ESAPI.validator().isValidInput("User Email", input, "Email", maxLength, allowNull);
-# Where maxLength and allowNull are set for you needs, respectively.
-#
-# But note, when you use boolean variants of validation functions, you lose critical 
-# canonicalization. It is preferable to use the "get" methods (which throw exceptions) and 
-# and use the returned user input which is in canonical form. Consider the following:
-#  
-# try {
-#    someObject.setEmail(ESAPI.validator().getValidInput("User Email", input, "Email", maxLength, allowNull));
-#
-Validator.SafeString=^[.\\p{Alnum}\\p{Space}]{0,1024}$
-Validator.Email=^[A-Za-z0-9._%'-]+@[A-Za-z0-9.-]+\\.[a-zA-Z]{2,4}$
-Validator.IPAddress=^(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$
-Validator.URL=^(ht|f)tp(s?)\\:\\/\\/[0-9a-zA-Z]([-.\\w]*[0-9a-zA-Z])*(:(0-9)*)*(\\/?)([a-zA-Z0-9\\-\\.\\?\\,\\:\\'\\/\\\\\\+=&%\\$#_]*)?$
-Validator.CreditCard=^(\\d{4}[- ]?){3}\\d{4}$
-Validator.SSN=^(?!000)([0-6]\\d{2}|7([0-6]\\d|7[012]))([ -]?)(?!00)\\d\\d\\3(?!0000)\\d{4}$
-
+# The ESAPI validator does many security checks on input, such as canonicalization
+# and whitelist validation. Note that all of these validation rules are applied *after*
+# canonicalization. Double-encoded characters (even with different encodings involved,
+# are never allowed.
+#
+# To use:
+#
+# First set up a pattern below. You can choose any name you want, prefixed by the word
+# "Validation." For example:
+#   Validation.Email=^[A-Za-z0-9._%-]+@[A-Za-z0-9.-]+\\.[a-zA-Z]{2,4}$
+# 
+# Then you can validate in your code against the pattern like this:
+#     ESAPI.validator().isValidInput("User Email", input, "Email", maxLength, allowNull);
+# Where maxLength and allowNull are set for you needs, respectively.
+#
+# But note, when you use boolean variants of validation functions, you lose critical 
+# canonicalization. It is preferable to use the "get" methods (which throw exceptions) and 
+# and use the returned user input which is in canonical form. Consider the following:
+#  
+# try {
+#    someObject.setEmail(ESAPI.validator().getValidInput("User Email", input, "Email", maxLength, allowNull));
+#
+Validator.SafeString=^[.\\p{Alnum}\\p{Space}]{0,1024}$
+Validator.Email=^[A-Za-z0-9._%'-]+@[A-Za-z0-9.-]+\\.[a-zA-Z]{2,4}$
+Validator.IPAddress=^(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$
+Validator.URL=^(ht|f)tp(s?)\\:\\/\\/[0-9a-zA-Z]([-.\\w]*[0-9a-zA-Z])*(:(0-9)*)*(\\/?)([a-zA-Z0-9\\-\\.\\?\\,\\:\\'\\/\\\\\\+=&%\\$#_]*)?$
+Validator.CreditCard=^(\\d{4}[- ]?){3}\\d{4}$
+Validator.SSN=^(?!000)([0-6]\\d{2}|7([0-6]\\d|7[012]))([ -]?)(?!00)\\d\\d\\3(?!0000)\\d{4}$
+

From 392eae1efc6d078bebd4d3a8e287ec6f0055a225 Mon Sep 17 00:00:00 2001
From: kwwall 
Date: Tue, 19 Jan 2016 01:12:42 -0500
Subject: [PATCH 324/812] Address issue 356.

---
 .../properties/ESAPI_en_US.properties          | 18 +++++++++---------
 1 file changed, 9 insertions(+), 9 deletions(-)

diff --git a/src/test/resources/properties/ESAPI_en_US.properties b/src/test/resources/properties/ESAPI_en_US.properties
index 9b43d1a23..04f043b21 100644
--- a/src/test/resources/properties/ESAPI_en_US.properties
+++ b/src/test/resources/properties/ESAPI_en_US.properties
@@ -1,9 +1,9 @@
-# User Messages
-Error.creating.randomizer=Error creating randomizer
-
-This.is.test.message=This {0} is {1} a test {2} message
-
-# Validation Messages
-
-# Log Messages
-
+# User Messages
+Error.creating.randomizer=Error creating randomizer
+
+This.is.test.message=This {0} is {1} a test {2} message
+
+# Validation Messages
+
+# Log Messages
+

From c4c9281679689b396f5d3fbff743193fd3879b31 Mon Sep 17 00:00:00 2001
From: kwwall 
Date: Tue, 19 Jan 2016 01:12:43 -0500
Subject: [PATCH 325/812] Address issue 356.

---
 .../properties/ESAPI_fr_FR.properties          | 18 +++++++++---------
 1 file changed, 9 insertions(+), 9 deletions(-)

diff --git a/src/test/resources/properties/ESAPI_fr_FR.properties b/src/test/resources/properties/ESAPI_fr_FR.properties
index 89ebcba7d..3e5a7a8f5 100644
--- a/src/test/resources/properties/ESAPI_fr_FR.properties
+++ b/src/test/resources/properties/ESAPI_fr_FR.properties
@@ -1,9 +1,9 @@
-# User Messages
-Error.creating.randomizer=Erreur lors de la cration alatoire
-
-This.is.test.message=Ceci est un message de test message singh
-
-# Validation Messages
-
-# Log Messages
-
+# User Messages
+Error.creating.randomizer=Erreur lors de la cration alatoire
+
+This.is.test.message=Ceci est un message de test message singh
+
+# Validation Messages
+
+# Log Messages
+

From 3dd0aecb6fed7c2c32f66083d0728d612e785d8a Mon Sep 17 00:00:00 2001
From: kwwall 
Date: Tue, 19 Jan 2016 01:15:37 -0500
Subject: [PATCH 326/812] Continue to try to address issue 356.

---
 .gitattributes | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/.gitattributes b/.gitattributes
index 3645b7bba..74f99db34 100644
--- a/.gitattributes
+++ b/.gitattributes
@@ -39,10 +39,14 @@
 *.bsh text eol=lf
 *.ksh text eol=lf
 
-# More
-.gitattributes text
+# Eclipse stuff
 .settings/* text eol=crlf
 .classpath text eol=crlf
+.project text eol=crlf
+
+# Miscellaneous text
+.gitattributes text eol=lf
+.gitignore text eol=lf
 *.MF text eol=crlf
 LICENSE text eol=crlf
 LICENSE-CONTENT text eol=crlf

From 2f3650d87ec45bd56ee8999e850c0beb1a9950cc Mon Sep 17 00:00:00 2001
From: kwwall 
Date: Tue, 19 Jan 2016 01:17:57 -0500
Subject: [PATCH 327/812] Issue 356 EOL matters

---
 configuration/esapi/waf-policies/bean-shell-rule.bsh | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/configuration/esapi/waf-policies/bean-shell-rule.bsh b/configuration/esapi/waf-policies/bean-shell-rule.bsh
index 2a1f423e7..08c8424c4 100644
--- a/configuration/esapi/waf-policies/bean-shell-rule.bsh
+++ b/configuration/esapi/waf-policies/bean-shell-rule.bsh
@@ -1,5 +1,5 @@
-import org.owasp.esapi.waf.actions.*;
-
-session.setAttribute("simple_waf_test", "true");
-
+import org.owasp.esapi.waf.actions.*;
+
+session.setAttribute("simple_waf_test", "true");
+
 action = new RedirectAction();
\ No newline at end of file

From ce5cbf3058c9c283afbb11dde8661edc77a87ca3 Mon Sep 17 00:00:00 2001
From: kwwall 
Date: Tue, 19 Jan 2016 01:17:57 -0500
Subject: [PATCH 328/812] Issue 356 EOL matters

---
 .../java/org/owasp/esapi/errors/package.html  | 34 +++++++++----------
 1 file changed, 17 insertions(+), 17 deletions(-)

diff --git a/src/main/java/org/owasp/esapi/errors/package.html b/src/main/java/org/owasp/esapi/errors/package.html
index cb35f9c0b..4e061dd18 100644
--- a/src/main/java/org/owasp/esapi/errors/package.html
+++ b/src/main/java/org/owasp/esapi/errors/package.html
@@ -1,17 +1,17 @@
-
-
-
-
-
-
-
-A set of exception classes designed to model the error conditions that
-frequently arise in enterprise web applications and web services. The
-root class is the EnterpriseSecurityException and all the other
-exception classes extend this basic class. The
-EnterpriseSecurityException automatically logs a message in the
-constructor so that a full set of security events are captured in the
-logs.
-
-
-
+
+
+
+
+
+
+
+A set of exception classes designed to model the error conditions that
+frequently arise in enterprise web applications and web services. The
+root class is the EnterpriseSecurityException and all the other
+exception classes extend this basic class. The
+EnterpriseSecurityException automatically logs a message in the
+constructor so that a full set of security events are captured in the
+logs.
+
+
+

From f0fbbb1f9c86f5006e79d07fca92afc5a8becb2e Mon Sep 17 00:00:00 2001
From: kwwall 
Date: Tue, 19 Jan 2016 01:17:57 -0500
Subject: [PATCH 329/812] Issue 356 EOL matters

---
 src/main/java/org/owasp/esapi/reference/package.html | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/src/main/java/org/owasp/esapi/reference/package.html b/src/main/java/org/owasp/esapi/reference/package.html
index 0e110cb91..e1fe0b048 100644
--- a/src/main/java/org/owasp/esapi/reference/package.html
+++ b/src/main/java/org/owasp/esapi/reference/package.html
@@ -5,11 +5,11 @@
 
 
 
-This package contains reference implementations of the ESAPI interfaces. These are intended to
-serve as examples of how your enterprise might implement these functions. The reference implementations
-are high quality and pass all of the ESAPI test cases. Many of the reference implementations are
-likely to be useful in your enterprise without change (Validator, Encoder, Encryptor, etc...).
-Implementing other classes (Authenticator, User, AccessController, Logger, etc...) will likely need to
+This package contains reference implementations of the ESAPI interfaces. These are intended to
+serve as examples of how your enterprise might implement these functions. The reference implementations
+are high quality and pass all of the ESAPI test cases. Many of the reference implementations are
+likely to be useful in your enterprise without change (Validator, Encoder, Encryptor, etc...).
+Implementing other classes (Authenticator, User, AccessController, Logger, etc...) will likely need to
 be customized for your enterprise, to integrate with your backend systems and policies.
 
 

From 3c4385286f866fe92ecdcdf00408a52a25874fc2 Mon Sep 17 00:00:00 2001
From: kwwall 
Date: Tue, 19 Jan 2016 01:17:57 -0500
Subject: [PATCH 330/812] Issue 356 EOL matters

---
 .../esapi/reference/validation/package.html   | 22 +++++++++----------
 1 file changed, 11 insertions(+), 11 deletions(-)

diff --git a/src/main/java/org/owasp/esapi/reference/validation/package.html b/src/main/java/org/owasp/esapi/reference/validation/package.html
index 050397abf..b950c12a7 100644
--- a/src/main/java/org/owasp/esapi/reference/validation/package.html
+++ b/src/main/java/org/owasp/esapi/reference/validation/package.html
@@ -1,11 +1,11 @@
-
-
-
-
-
-
-
-This package contains data format-specific validation rule functions.
- 
-
-
+
+
+
+
+
+
+
+This package contains data format-specific validation rule functions.
+ 
+
+

From d0d363ebd2b78b40f131823d3666a4275fe5745b Mon Sep 17 00:00:00 2001
From: kwwall 
Date: Tue, 19 Jan 2016 01:17:58 -0500
Subject: [PATCH 331/812] Issue 356 EOL matters

---
 .../org/owasp/esapi/waf/actions/package.html  | 22 +++++++++----------
 1 file changed, 11 insertions(+), 11 deletions(-)

diff --git a/src/main/java/org/owasp/esapi/waf/actions/package.html b/src/main/java/org/owasp/esapi/waf/actions/package.html
index 94adcc808..89657d08c 100644
--- a/src/main/java/org/owasp/esapi/waf/actions/package.html
+++ b/src/main/java/org/owasp/esapi/waf/actions/package.html
@@ -1,11 +1,11 @@
-
-
-
-
-
-
-
-This package contains the Action objects that are executed after a Rule subclass executes. 
- 
-
-
+
+
+
+
+
+
+
+This package contains the Action objects that are executed after a Rule subclass executes. 
+ 
+
+

From 04902a8957c24c1c863a00926b8ca724dccea009 Mon Sep 17 00:00:00 2001
From: kwwall 
Date: Tue, 19 Jan 2016 01:17:58 -0500
Subject: [PATCH 332/812] Issue 356 EOL matters

---
 .../esapi/waf/configuration/package.html      | 24 +++++++++----------
 1 file changed, 12 insertions(+), 12 deletions(-)

diff --git a/src/main/java/org/owasp/esapi/waf/configuration/package.html b/src/main/java/org/owasp/esapi/waf/configuration/package.html
index ea68242bf..8c41b3a27 100644
--- a/src/main/java/org/owasp/esapi/waf/configuration/package.html
+++ b/src/main/java/org/owasp/esapi/waf/configuration/package.html
@@ -1,12 +1,12 @@
-
-
-
-
-
-
-
-This package contains the both the configuration object model and the 
-utility class to create that object model from an existing policy file. 
- 
-
-
+
+
+
+
+
+
+
+This package contains the both the configuration object model and the 
+utility class to create that object model from an existing policy file. 
+ 
+
+

From dc7d5406c7d1f2b6a8710d14309f353f167f8e39 Mon Sep 17 00:00:00 2001
From: kwwall 
Date: Tue, 19 Jan 2016 01:17:58 -0500
Subject: [PATCH 333/812] Issue 356 EOL matters

---
 .../org/owasp/esapi/waf/internal/package.html | 24 +++++++++----------
 1 file changed, 12 insertions(+), 12 deletions(-)

diff --git a/src/main/java/org/owasp/esapi/waf/internal/package.html b/src/main/java/org/owasp/esapi/waf/internal/package.html
index 3b535518f..a94870056 100644
--- a/src/main/java/org/owasp/esapi/waf/internal/package.html
+++ b/src/main/java/org/owasp/esapi/waf/internal/package.html
@@ -1,12 +1,12 @@
-
-
-
-
-
-
-
-This package contains all HTTP-related classes used internally by the WAF for the implementation
-of its rules. 
- 
-
-
+
+
+
+
+
+
+
+This package contains all HTTP-related classes used internally by the WAF for the implementation
+of its rules. 
+ 
+
+

From 0c21fbaa9763fbe555e799413628caff20cc8399 Mon Sep 17 00:00:00 2001
From: kwwall 
Date: Tue, 19 Jan 2016 01:17:58 -0500
Subject: [PATCH 334/812] Issue 356 EOL matters

---
 .../java/org/owasp/esapi/waf/package.html     | 28 +++++++++----------
 1 file changed, 14 insertions(+), 14 deletions(-)

diff --git a/src/main/java/org/owasp/esapi/waf/package.html b/src/main/java/org/owasp/esapi/waf/package.html
index bf23005ed..8f025e3ed 100644
--- a/src/main/java/org/owasp/esapi/waf/package.html
+++ b/src/main/java/org/owasp/esapi/waf/package.html
@@ -1,14 +1,14 @@
-
-
-
-
-
-
-
-This package contains the ESAPI Web Application Firewall (WAF). It is an optional feature of ESAPI
-that can be used with or without ESAPI's other security controls in place. It's purpose is to provide
-fast virtual patching capabilities against known vulnerabilities or the enforcement of existing
-security policies where possible.
- 
-
-
+
+
+
+
+
+
+
+This package contains the ESAPI Web Application Firewall (WAF). It is an optional feature of ESAPI
+that can be used with or without ESAPI's other security controls in place. It's purpose is to provide
+fast virtual patching capabilities against known vulnerabilities or the enforcement of existing
+security policies where possible.
+ 
+
+

From ca61c6decc5c7e60d1847b32682e0f9d10d70bae Mon Sep 17 00:00:00 2001
From: kwwall 
Date: Tue, 19 Jan 2016 01:17:58 -0500
Subject: [PATCH 335/812] Issue 356 EOL matters

---
 .../org/owasp/esapi/waf/rules/package.html    | 24 +++++++++----------
 1 file changed, 12 insertions(+), 12 deletions(-)

diff --git a/src/main/java/org/owasp/esapi/waf/rules/package.html b/src/main/java/org/owasp/esapi/waf/rules/package.html
index 133148e47..0f29d7ea3 100644
--- a/src/main/java/org/owasp/esapi/waf/rules/package.html
+++ b/src/main/java/org/owasp/esapi/waf/rules/package.html
@@ -1,12 +1,12 @@
-
-
-
-
-
-
-
-This package contains all of the Rule subclasses that correspond to policy file entries. Each 
-class contains the logic for enforcing its rule. 
- 
-
-
+
+
+
+
+
+
+
+This package contains all of the Rule subclasses that correspond to policy file entries. Each 
+class contains the logic for enforcing its rule. 
+ 
+
+

From 99917ec05d892f6e53a8e025872c2434430ad755 Mon Sep 17 00:00:00 2001
From: kwwall 
Date: Tue, 19 Jan 2016 01:17:58 -0500
Subject: [PATCH 336/812] Issue 356 EOL matters

---
 .../java/org/owasp/esapi/http/package.html    | 30 +++++++++----------
 1 file changed, 15 insertions(+), 15 deletions(-)

diff --git a/src/test/java/org/owasp/esapi/http/package.html b/src/test/java/org/owasp/esapi/http/package.html
index 76f720fb6..c61efd69f 100644
--- a/src/test/java/org/owasp/esapi/http/package.html
+++ b/src/test/java/org/owasp/esapi/http/package.html
@@ -1,15 +1,15 @@
-
-
-
-
-
-
-
-A few simple mock classes to help test the ESAPI reference
-implementation. These classes are not fully functional and only
-implement the functions required to test the library. These
-implementations are not fully accurate and may not behave like the real
-Java EE classes.
-
-
-
+
+
+
+
+
+
+
+A few simple mock classes to help test the ESAPI reference
+implementation. These classes are not fully functional and only
+implement the functions required to test the library. These
+implementations are not fully accurate and may not behave like the real
+Java EE classes.
+
+
+

From c2585acb10d7bb075b17f6878d84f88b87de74b5 Mon Sep 17 00:00:00 2001
From: kwwall 
Date: Tue, 19 Jan 2016 01:17:58 -0500
Subject: [PATCH 337/812] Issue 356 EOL matters

---
 src/test/resources/esapi/waf-policies/bean-shell-rule.bsh | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/src/test/resources/esapi/waf-policies/bean-shell-rule.bsh b/src/test/resources/esapi/waf-policies/bean-shell-rule.bsh
index 2a1f423e7..08c8424c4 100644
--- a/src/test/resources/esapi/waf-policies/bean-shell-rule.bsh
+++ b/src/test/resources/esapi/waf-policies/bean-shell-rule.bsh
@@ -1,5 +1,5 @@
-import org.owasp.esapi.waf.actions.*;
-
-session.setAttribute("simple_waf_test", "true");
-
+import org.owasp.esapi.waf.actions.*;
+
+session.setAttribute("simple_waf_test", "true");
+
 action = new RedirectAction();
\ No newline at end of file

From 86c89a20e49209f853cbd04f9361e30ca03e2e2d Mon Sep 17 00:00:00 2001
From: kwwall 
Date: Tue, 19 Jan 2016 21:46:51 -0500
Subject: [PATCH 338/812] Close issue #354.

---
 .../java/org/owasp/esapi/codecs/Base64.java   | 27 ++++++++-
 .../owasp/esapi/reference/EncoderTest.java    | 56 +++++++++++++++++++
 2 files changed, 82 insertions(+), 1 deletion(-)

diff --git a/src/main/java/org/owasp/esapi/codecs/Base64.java b/src/main/java/org/owasp/esapi/codecs/Base64.java
index 624d23c3d..b92f35590 100644
--- a/src/main/java/org/owasp/esapi/codecs/Base64.java
+++ b/src/main/java/org/owasp/esapi/codecs/Base64.java
@@ -8,7 +8,7 @@
 // I think that really depends on how much OWASP ESAPI plans on tracking changes to this
 // version vs. if the plan was just to fork from it and maintain OWASP's own version.
 // At this point, I think I prefer split from tracking Harder's original, but I'm easily
-// persuaded otherwise. - Kevin Wall
+// persuaded otherwise. (In fact, we have already done so w/ decodeToObject().) - Kevin Wall
 
 /**
  * 
    Encodes and decodes to and from Base64 notation.
    
@@ -136,6 +136,12 @@ public class Base64
 	  */
 	 public final static int ORDERED = 32;
     
+     /**
+      * System property name that must be set to true in order to invoke {@code Base64.decodeToObject()}.
+      * @see https://github.com/ESAPI/esapi-java-legacy/issues/354
+      * @see http://foxglovesecurity.com/2015/11/06/what-do-weblogic-websphere-jboss-jenkins-opennms-and-your-application-have-in-common-this-vulnerability/
+      */
+     public final static String ENABLE_UNSAFE_SERIALIZATION = "org.owasp.esapi.enableUnsafeSerialization"; // Do NOT change!
     
 /* ********  P R I V A T E   F I E L D S  ******** */  
     
@@ -1091,6 +1097,15 @@ public static byte[] decode( String s, int options )
      *      untrusted data from a string and deserialize it into
      *      an object can potentially result in remote command
      *      injection vulnerabilities. Use at your own risk!
+     * 
    IMPORTANT BACKWARD COMPATIBILITY NOTICE
    
+     * Because this static method can easily be used as an attack vector
+     * for those passing in deserialized objects, in a manner similar to the
+     * Apache Commons Collections InvokerTransformer
+     * issue, we are requiring that the system property
+     * {@code org.owasp.esapi.enableUnsafeSerialization}
+     * be set to "true" in order for this method to be successfully invoked.
+     * We apologize for the inconvenience this may cause in breaking anyone's
+     * application, but we feel that it is for the greater good.
      * 
    
      *
      * @param encodedObject The Base64 data to decode
@@ -1110,6 +1125,16 @@ public static byte[] decode( String s, int options )
     @Deprecated
     public static Object decodeToObject( String encodedObject )
     {
+        // We will do better when we attempt this again, allowing for a second argument
+        // to specify some sort of a collection of white-listed classes. Until then...
+        // See: http://www.ibm.com/developerworks/library/se-lookahead/ for how-to.
+        if ( ! "true".equalsIgnoreCase( System.getProperty( ENABLE_UNSAFE_SERIALIZATION ) ) ) {
+            throw new UnsupportedOperationException(
+                "Deserialization by Base64.decodeToObject(String) is disabled for security reasons. " +
+                "To re-enable it, set the system property '" + ENABLE_UNSAFE_SERIALIZATION + "' to 'true'." +
+                "For details, see: https://github.com/ESAPI/esapi-java-legacy/issues/354");
+        }
+
         // Decode and gunzip if necessary
         byte[] objBytes = decode( encodedObject );
         
diff --git a/src/test/java/org/owasp/esapi/reference/EncoderTest.java b/src/test/java/org/owasp/esapi/reference/EncoderTest.java
index 3e8f17a6a..bc2e1afde 100644
--- a/src/test/java/org/owasp/esapi/reference/EncoderTest.java
+++ b/src/test/java/org/owasp/esapi/reference/EncoderTest.java
@@ -19,6 +19,8 @@
 import java.io.UnsupportedEncodingException;
 import java.util.ArrayList;
 import java.util.Arrays;
+import java.io.ByteArrayOutputStream;
+import java.io.ObjectOutputStream;
 
 import junit.framework.Test;
 import junit.framework.TestCase;
@@ -27,6 +29,7 @@
 import org.owasp.esapi.ESAPI;
 import org.owasp.esapi.Encoder;
 import org.owasp.esapi.EncoderConstants;
+import org.owasp.esapi.codecs.Base64;
 import org.owasp.esapi.codecs.Codec;
 import org.owasp.esapi.codecs.MySQLCodec;
 import org.owasp.esapi.codecs.OracleCodec;
@@ -632,6 +635,59 @@ public void testDecodeFromBase64() {
         }
     }
     
+    /**
+	 * Test of Base64.decodeToObject() method. Should really be put into a
+     * separate Base64Test.java class, but this method has been deprecated
+     * so hopefully, we can kill it off soon.
+	 */
+    public void testBase64decodToObject() {
+        try {
+            System.out.println("testBase64decodeToObject");
+
+            ByteArrayOutputStream baos = new ByteArrayOutputStream();
+            ObjectOutputStream dout = new ObjectOutputStream(baos);
+
+            // If you don't get the joke, google John Draper. (And, BTW, you should
+            // be ashamed of yourself if you call yourself a hacker!)
+            String cerealizeThis = new String("Cap'n Crunch - every hacker's favorite cereal");
+            dout.writeObject( cerealizeThis );
+            byte[] serializedData = baos.toByteArray();
+            dout.close();
+
+            String b64serialized = Base64.encodeBytes( serializedData );
+            final String propName = Base64.ENABLE_UNSAFE_SERIALIZATION;
+
+            // Make sure the property is not set.
+            try { System.clearProperty( propName ); } catch(Throwable t) { ; }
+            String capnCrunch = null;
+
+            try {
+                capnCrunch = (String)Base64.decodeToObject( b64serialized );
+                fail("Case 1: Did not throw UnsupportedOperationException");
+            } catch(UnsupportedOperationException uoex) {
+                ; // Expected case
+            }
+
+            try {
+                System.setProperty( propName, "false" );
+                capnCrunch = (String)Base64.decodeToObject( b64serialized );
+                fail("Case 2: Did not throw UnsupportedOperationException");
+            } catch(UnsupportedOperationException uoex) {
+                ; // Expected case
+            }
+
+            try {
+                // This case should work.
+                System.setProperty( propName, "true" );
+                capnCrunch = (String)Base64.decodeToObject( b64serialized );
+                assertTrue( capnCrunch.equals( cerealizeThis ) );
+            } catch(Throwable t) {
+                fail("Case 3: Caught unexpected exception: " + t);
+            }
+        } catch(Throwable t) {
+            fail("Caught unexpected exception: " + t);
+        }
+    }
 
     /**
 	 * Test of WindowsCodec

From 21f3992440b1894b654d93c031c705bc9e4cd52c Mon Sep 17 00:00:00 2001
From: kwwall 
Date: Tue, 19 Jan 2016 21:58:13 -0500
Subject: [PATCH 339/812] Git is complaining it's modified, but I'm committing
 w/out any actual change. Let's see what happens.

---
 LICENSE | 24 ++++++++++++------------
 1 file changed, 12 insertions(+), 12 deletions(-)

diff --git a/LICENSE b/LICENSE
index 5d0f11c51..20c1657fa 100644
--- a/LICENSE
+++ b/LICENSE
@@ -1,12 +1,12 @@
-The BSD License
-
-Copyright (c) 2007, The OWASP Foundation
-All rights reserved.
-
-Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
-
-Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. 
-Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. 
-Neither the name of the OWASP Foundation nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. 
-THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
-
+The BSD License
+
+Copyright (c) 2007, The OWASP Foundation
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
+
+Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. 
+Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. 
+Neither the name of the OWASP Foundation nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. 
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+

From 73995a44c0351041f6f6400a36c2c0571822602f Mon Sep 17 00:00:00 2001
From: kwwall 
Date: Tue, 19 Jan 2016 22:06:16 -0500
Subject: [PATCH 340/812] No explicit changes; just did a add, followed by
 commit, but that seemed to fix the others.

---
 LICENSE-CONTENT                               | 156 +++++++++---------
 LICENSE-README                                |  12 +-
 documentation/esapi4java-2.0-readme.txt       | 120 +++++++-------
 ...va-2.0rc6-override-log4jloggingfactory.txt | 142 ++++++++--------
 .../esapi4java-core-2.1-release-notes.txt     | 136 +++++++--------
 src/main/java/META-INF/MANIFEST.MF            |   6 +-
 6 files changed, 286 insertions(+), 286 deletions(-)

diff --git a/LICENSE-CONTENT b/LICENSE-CONTENT
index 9d154ce74..b5b0f5e05 100644
--- a/LICENSE-CONTENT
+++ b/LICENSE-CONTENT
@@ -1,78 +1,78 @@
-Creative Commons
-Creative Commons Legal Code
-Attribution-ShareAlike 3.0 Unported
-
-    CREATIVE COMMONS CORPORATION IS NOT A LAW FIRM AND DOES NOT PROVIDE LEGAL SERVICES. DISTRIBUTION OF THIS LICENSE DOES NOT CREATE AN ATTORNEY-CLIENT RELATIONSHIP. CREATIVE COMMONS PROVIDES THIS INFORMATION ON AN "AS-IS" BASIS. CREATIVE COMMONS MAKES NO WARRANTIES REGARDING THE INFORMATION PROVIDED, AND DISCLAIMS LIABILITY FOR DAMAGES RESULTING FROM ITS USE. 
-
-License
-
-THE WORK (AS DEFINED BELOW) IS PROVIDED UNDER THE TERMS OF THIS CREATIVE COMMONS PUBLIC LICENSE ("CCPL" OR "LICENSE"). THE WORK IS PROTECTED BY COPYRIGHT AND/OR OTHER APPLICABLE LAW. ANY USE OF THE WORK OTHER THAN AS AUTHORIZED UNDER THIS LICENSE OR COPYRIGHT LAW IS PROHIBITED.
-
-BY EXERCISING ANY RIGHTS TO THE WORK PROVIDED HERE, YOU ACCEPT AND AGREE TO BE BOUND BY THE TERMS OF THIS LICENSE. TO THE EXTENT THIS LICENSE MAY BE CONSIDERED TO BE A CONTRACT, THE LICENSOR GRANTS YOU THE RIGHTS CONTAINED HERE IN CONSIDERATION OF YOUR ACCEPTANCE OF SUCH TERMS AND CONDITIONS.
-
-1. Definitions
-
-   1. "Adaptation" means a work based upon the Work, or upon the Work and other pre-existing works, such as a translation, adaptation, derivative work, arrangement of music or other alterations of a literary or artistic work, or phonogram or performance and includes cinematographic adaptations or any other form in which the Work may be recast, transformed, or adapted including in any form recognizably derived from the original, except that a work that constitutes a Collection will not be considered an Adaptation for the purpose of this License. For the avoidance of doubt, where the Work is a musical work, performance or phonogram, the synchronization of the Work in timed-relation with a moving image ("synching") will be considered an Adaptation for the purpose of this License.
-   2. "Collection" means a collection of literary or artistic works, such as encyclopedias and anthologies, or performances, phonograms or broadcasts, or other works or subject matter other than works listed in Section 1(f) below, which, by reason of the selection and arrangement of their contents, constitute intellectual creations, in which the Work is included in its entirety in unmodified form along with one or more other contributions, each constituting separate and independent works in themselves, which together are assembled into a collective whole. A work that constitutes a Collection will not be considered an Adaptation (as defined below) for the purposes of this License.
-   3. "Creative Commons Compatible License" means a license that is listed at http://creativecommons.org/compatiblelicenses that has been approved by Creative Commons as being essentially equivalent to this License, including, at a minimum, because that license: (i) contains terms that have the same purpose, meaning and effect as the License Elements of this License; and, (ii) explicitly permits the relicensing of adaptations of works made available under that license under this License or a Creative Commons jurisdiction license with the same License Elements as this License.
-   4. "Distribute" means to make available to the public the original and copies of the Work or Adaptation, as appropriate, through sale or other transfer of ownership.
-   5. "License Elements" means the following high-level license attributes as selected by Licensor and indicated in the title of this License: Attribution, ShareAlike.
-   6. "Licensor" means the individual, individuals, entity or entities that offer(s) the Work under the terms of this License.
-   7. "Original Author" means, in the case of a literary or artistic work, the individual, individuals, entity or entities who created the Work or if no individual or entity can be identified, the publisher; and in addition (i) in the case of a performance the actors, singers, musicians, dancers, and other persons who act, sing, deliver, declaim, play in, interpret or otherwise perform literary or artistic works or expressions of folklore; (ii) in the case of a phonogram the producer being the person or legal entity who first fixes the sounds of a performance or other sounds; and, (iii) in the case of broadcasts, the organization that transmits the broadcast.
-   8. "Work" means the literary and/or artistic work offered under the terms of this License including without limitation any production in the literary, scientific and artistic domain, whatever may be the mode or form of its expression including digital form, such as a book, pamphlet and other writing; a lecture, address, sermon or other work of the same nature; a dramatic or dramatico-musical work; a choreographic work or entertainment in dumb show; a musical composition with or without words; a cinematographic work to which are assimilated works expressed by a process analogous to cinematography; a work of drawing, painting, architecture, sculpture, engraving or lithography; a photographic work to which are assimilated works expressed by a process analogous to photography; a work of applied art; an illustration, map, plan, sketch or three-dimensional work relative to geography, topography, architecture or science; a performance; a broadcast; a phonogram; a compilation of data to the extent it is protected as a copyrightable work; or a work performed by a variety or circus performer to the extent it is not otherwise considered a literary or artistic work.
-   9. "You" means an individual or entity exercising rights under this License who has not previously violated the terms of this License with respect to the Work, or who has received express permission from the Licensor to exercise rights under this License despite a previous violation.
-  10. "Publicly Perform" means to perform public recitations of the Work and to communicate to the public those public recitations, by any means or process, including by wire or wireless means or public digital performances; to make available to the public Works in such a way that members of the public may access these Works from a place and at a place individually chosen by them; to perform the Work to the public by any means or process and the communication to the public of the performances of the Work, including by public digital performance; to broadcast and rebroadcast the Work by any means including signs, sounds or images.
-  11. "Reproduce" means to make copies of the Work by any means including without limitation by sound or visual recordings and the right of fixation and reproducing fixations of the Work, including storage of a protected performance or phonogram in digital form or other electronic medium.
-
-2. Fair Dealing Rights. Nothing in this License is intended to reduce, limit, or restrict any uses free from copyright or rights arising from limitations or exceptions that are provided for in connection with the copyright protection under copyright law or other applicable laws.
-
-3. License Grant. Subject to the terms and conditions of this License, Licensor hereby grants You a worldwide, royalty-free, non-exclusive, perpetual (for the duration of the applicable copyright) license to exercise the rights in the Work as stated below:
-
-   1. to Reproduce the Work, to incorporate the Work into one or more Collections, and to Reproduce the Work as incorporated in the Collections;
-   2. to create and Reproduce Adaptations provided that any such Adaptation, including any translation in any medium, takes reasonable steps to clearly label, demarcate or otherwise identify that changes were made to the original Work. For example, a translation could be marked "The original work was translated from English to Spanish," or a modification could indicate "The original work has been modified.";
-   3. to Distribute and Publicly Perform the Work including as incorporated in Collections; and,
-   4. to Distribute and Publicly Perform Adaptations.
-   5.
-
-      For the avoidance of doubt:
-         1. Non-waivable Compulsory License Schemes. In those jurisdictions in which the right to collect royalties through any statutory or compulsory licensing scheme cannot be waived, the Licensor reserves the exclusive right to collect such royalties for any exercise by You of the rights granted under this License;
-         2. Waivable Compulsory License Schemes. In those jurisdictions in which the right to collect royalties through any statutory or compulsory licensing scheme can be waived, the Licensor waives the exclusive right to collect such royalties for any exercise by You of the rights granted under this License; and,
-         3. Voluntary License Schemes. The Licensor waives the right to collect royalties, whether individually or, in the event that the Licensor is a member of a collecting society that administers voluntary licensing schemes, via that society, from any exercise by You of the rights granted under this License.
-
-The above rights may be exercised in all media and formats whether now known or hereafter devised. The above rights include the right to make such modifications as are technically necessary to exercise the rights in other media and formats. Subject to Section 8(f), all rights not expressly granted by Licensor are hereby reserved.
-
-4. Restrictions. The license granted in Section 3 above is expressly made subject to and limited by the following restrictions:
-
-   1. You may Distribute or Publicly Perform the Work only under the terms of this License. You must include a copy of, or the Uniform Resource Identifier (URI) for, this License with every copy of the Work You Distribute or Publicly Perform. You may not offer or impose any terms on the Work that restrict the terms of this License or the ability of the recipient of the Work to exercise the rights granted to that recipient under the terms of the License. You may not sublicense the Work. You must keep intact all notices that refer to this License and to the disclaimer of warranties with every copy of the Work You Distribute or Publicly Perform. When You Distribute or Publicly Perform the Work, You may not impose any effective technological measures on the Work that restrict the ability of a recipient of the Work from You to exercise the rights granted to that recipient under the terms of the License. This Section 4(a) applies to the Work as incorporated in a Collection, but this does not require the Collection apart from the Work itself to be made subject to the terms of this License. If You create a Collection, upon notice from any Licensor You must, to the extent practicable, remove from the Collection any credit as required by Section 4(c), as requested. If You create an Adaptation, upon notice from any Licensor You must, to the extent practicable, remove from the Adaptation any credit as required by Section 4(c), as requested.
-   2. You may Distribute or Publicly Perform an Adaptation only under the terms of: (i) this License; (ii) a later version of this License with the same License Elements as this License; (iii) a Creative Commons jurisdiction license (either this or a later license version) that contains the same License Elements as this License (e.g., Attribution-ShareAlike 3.0 US)); (iv) a Creative Commons Compatible License. If you license the Adaptation under one of the licenses mentioned in (iv), you must comply with the terms of that license. If you license the Adaptation under the terms of any of the licenses mentioned in (i), (ii) or (iii) (the "Applicable License"), you must comply with the terms of the Applicable License generally and the following provisions: (I) You must include a copy of, or the URI for, the Applicable License with every copy of each Adaptation You Distribute or Publicly Perform; (II) You may not offer or impose any terms on the Adaptation that restrict the terms of the Applicable License or the ability of the recipient of the Adaptation to exercise the rights granted to that recipient under the terms of the Applicable License; (III) You must keep intact all notices that refer to the Applicable License and to the disclaimer of warranties with every copy of the Work as included in the Adaptation You Distribute or Publicly Perform; (IV) when You Distribute or Publicly Perform the Adaptation, You may not impose any effective technological measures on the Adaptation that restrict the ability of a recipient of the Adaptation from You to exercise the rights granted to that recipient under the terms of the Applicable License. This Section 4(b) applies to the Adaptation as incorporated in a Collection, but this does not require the Collection apart from the Adaptation itself to be made subject to the terms of the Applicable License.
-   3. If You Distribute, or Publicly Perform the Work or any Adaptations or Collections, You must, unless a request has been made pursuant to Section 4(a), keep intact all copyright notices for the Work and provide, reasonable to the medium or means You are utilizing: (i) the name of the Original Author (or pseudonym, if applicable) if supplied, and/or if the Original Author and/or Licensor designate another party or parties (e.g., a sponsor institute, publishing entity, journal) for attribution ("Attribution Parties") in Licensor's copyright notice, terms of service or by other reasonable means, the name of such party or parties; (ii) the title of the Work if supplied; (iii) to the extent reasonably practicable, the URI, if any, that Licensor specifies to be associated with the Work, unless such URI does not refer to the copyright notice or licensing information for the Work; and (iv) , consistent with Ssection 3(b), in the case of an Adaptation, a credit identifying the use of the Work in the Adaptation (e.g., "French translation of the Work by Original Author," or "Screenplay based on original Work by Original Author"). The credit required by this Section 4(c) may be implemented in any reasonable manner; provided, however, that in the case of a Adaptation or Collection, at a minimum such credit will appear, if a credit for all contributing authors of the Adaptation or Collection appears, then as part of these credits and in a manner at least as prominent as the credits for the other contributing authors. For the avoidance of doubt, You may only use the credit required by this Section for the purpose of attribution in the manner set out above and, by exercising Your rights under this License, You may not implicitly or explicitly assert or imply any connection with, sponsorship or endorsement by the Original Author, Licensor and/or Attribution Parties, as appropriate, of You or Your use of the Work, without the separate, express prior written permission of the Original Author, Licensor and/or Attribution Parties.
-   4. Except as otherwise agreed in writing by the Licensor or as may be otherwise permitted by applicable law, if You Reproduce, Distribute or Publicly Perform the Work either by itself or as part of any Adaptations or Collections, You must not distort, mutilate, modify or take other derogatory action in relation to the Work which would be prejudicial to the Original Author's honor or reputation. Licensor agrees that in those jurisdictions (e.g. Japan), in which any exercise of the right granted in Section 3(b) of this License (the right to make Adaptations) would be deemed to be a distortion, mutilation, modification or other derogatory action prejudicial to the Original Author's honor and reputation, the Licensor will waive or not assert, as appropriate, this Section, to the fullest extent permitted by the applicable national law, to enable You to reasonably exercise Your right under Section 3(b) of this License (right to make Adaptations) but not otherwise.
-
-5. Representations, Warranties and Disclaimer
-
-UNLESS OTHERWISE MUTUALLY AGREED TO BY THE PARTIES IN WRITING, LICENSOR OFFERS THE WORK AS-IS AND MAKES NO REPRESENTATIONS OR WARRANTIES OF ANY KIND CONCERNING THE WORK, EXPRESS, IMPLIED, STATUTORY OR OTHERWISE, INCLUDING, WITHOUT LIMITATION, WARRANTIES OF TITLE, MERCHANTIBILITY, FITNESS FOR A PARTICULAR PURPOSE, NONINFRINGEMENT, OR THE ABSENCE OF LATENT OR OTHER DEFECTS, ACCURACY, OR THE PRESENCE OF ABSENCE OF ERRORS, WHETHER OR NOT DISCOVERABLE. SOME JURISDICTIONS DO NOT ALLOW THE EXCLUSION OF IMPLIED WARRANTIES, SO SUCH EXCLUSION MAY NOT APPLY TO YOU.
-
-6. Limitation on Liability. EXCEPT TO THE EXTENT REQUIRED BY APPLICABLE LAW, IN NO EVENT WILL LICENSOR BE LIABLE TO YOU ON ANY LEGAL THEORY FOR ANY SPECIAL, INCIDENTAL, CONSEQUENTIAL, PUNITIVE OR EXEMPLARY DAMAGES ARISING OUT OF THIS LICENSE OR THE USE OF THE WORK, EVEN IF LICENSOR HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
-
-7. Termination
-
-   1. This License and the rights granted hereunder will terminate automatically upon any breach by You of the terms of this License. Individuals or entities who have received Adaptations or Collections from You under this License, however, will not have their licenses terminated provided such individuals or entities remain in full compliance with those licenses. Sections 1, 2, 5, 6, 7, and 8 will survive any termination of this License.
-   2. Subject to the above terms and conditions, the license granted here is perpetual (for the duration of the applicable copyright in the Work). Notwithstanding the above, Licensor reserves the right to release the Work under different license terms or to stop distributing the Work at any time; provided, however that any such election will not serve to withdraw this License (or any other license that has been, or is required to be, granted under the terms of this License), and this License will continue in full force and effect unless terminated as stated above.
-
-8. Miscellaneous
-
-   1. Each time You Distribute or Publicly Perform the Work or a Collection, the Licensor offers to the recipient a license to the Work on the same terms and conditions as the license granted to You under this License.
-   2. Each time You Distribute or Publicly Perform an Adaptation, Licensor offers to the recipient a license to the original Work on the same terms and conditions as the license granted to You under this License.
-   3. If any provision of this License is invalid or unenforceable under applicable law, it shall not affect the validity or enforceability of the remainder of the terms of this License, and without further action by the parties to this agreement, such provision shall be reformed to the minimum extent necessary to make such provision valid and enforceable.
-   4. No term or provision of this License shall be deemed waived and no breach consented to unless such waiver or consent shall be in writing and signed by the party to be charged with such waiver or consent.
-   5. This License constitutes the entire agreement between the parties with respect to the Work licensed here. There are no understandings, agreements or representations with respect to the Work not specified here. Licensor shall not be bound by any additional provisions that may appear in any communication from You. This License may not be modified without the mutual written agreement of the Licensor and You.
-   6. The rights granted under, and the subject matter referenced, in this License were drafted utilizing the terminology of the Berne Convention for the Protection of Literary and Artistic Works (as amended on September 28, 1979), the Rome Convention of 1961, the WIPO Copyright Treaty of 1996, the WIPO Performances and Phonograms Treaty of 1996 and the Universal Copyright Convention (as revised on July 24, 1971). These rights and subject matter take effect in the relevant jurisdiction in which the License terms are sought to be enforced according to the corresponding provisions of the implementation of those treaty provisions in the applicable national law. If the standard suite of rights granted under applicable copyright law includes additional rights not granted under this License, such additional rights are deemed to be included in the License; this License is not intended to restrict the license of any rights under applicable law.
-
-    Creative Commons Notice
-
-    Creative Commons is not a party to this License, and makes no warranty whatsoever in connection with the Work. Creative Commons will not be liable to You or any party on any legal theory for any damages whatsoever, including without limitation any general, special, incidental or consequential damages arising in connection to this license. Notwithstanding the foregoing two (2) sentences, if Creative Commons has expressly identified itself as the Licensor hereunder, it shall have all rights and obligations of Licensor.
-
-    Except for the limited purpose of indicating to the public that the Work is licensed under the CCPL, Creative Commons does not authorize the use by either party of the trademark "Creative Commons" or any related trademark or logo of Creative Commons without the prior written consent of Creative Commons. Any permitted use will be in compliance with Creative Commons' then-current trademark usage guidelines, as may be published on its website or otherwise made available upon request from time to time. For the avoidance of doubt, this trademark restriction does not form part of the License.
-
-    Creative Commons may be contacted at http://creativecommons.org/.
-
+Creative Commons
+Creative Commons Legal Code
+Attribution-ShareAlike 3.0 Unported
+
+    CREATIVE COMMONS CORPORATION IS NOT A LAW FIRM AND DOES NOT PROVIDE LEGAL SERVICES. DISTRIBUTION OF THIS LICENSE DOES NOT CREATE AN ATTORNEY-CLIENT RELATIONSHIP. CREATIVE COMMONS PROVIDES THIS INFORMATION ON AN "AS-IS" BASIS. CREATIVE COMMONS MAKES NO WARRANTIES REGARDING THE INFORMATION PROVIDED, AND DISCLAIMS LIABILITY FOR DAMAGES RESULTING FROM ITS USE. 
+
+License
+
+THE WORK (AS DEFINED BELOW) IS PROVIDED UNDER THE TERMS OF THIS CREATIVE COMMONS PUBLIC LICENSE ("CCPL" OR "LICENSE"). THE WORK IS PROTECTED BY COPYRIGHT AND/OR OTHER APPLICABLE LAW. ANY USE OF THE WORK OTHER THAN AS AUTHORIZED UNDER THIS LICENSE OR COPYRIGHT LAW IS PROHIBITED.
+
+BY EXERCISING ANY RIGHTS TO THE WORK PROVIDED HERE, YOU ACCEPT AND AGREE TO BE BOUND BY THE TERMS OF THIS LICENSE. TO THE EXTENT THIS LICENSE MAY BE CONSIDERED TO BE A CONTRACT, THE LICENSOR GRANTS YOU THE RIGHTS CONTAINED HERE IN CONSIDERATION OF YOUR ACCEPTANCE OF SUCH TERMS AND CONDITIONS.
+
+1. Definitions
+
+   1. "Adaptation" means a work based upon the Work, or upon the Work and other pre-existing works, such as a translation, adaptation, derivative work, arrangement of music or other alterations of a literary or artistic work, or phonogram or performance and includes cinematographic adaptations or any other form in which the Work may be recast, transformed, or adapted including in any form recognizably derived from the original, except that a work that constitutes a Collection will not be considered an Adaptation for the purpose of this License. For the avoidance of doubt, where the Work is a musical work, performance or phonogram, the synchronization of the Work in timed-relation with a moving image ("synching") will be considered an Adaptation for the purpose of this License.
+   2. "Collection" means a collection of literary or artistic works, such as encyclopedias and anthologies, or performances, phonograms or broadcasts, or other works or subject matter other than works listed in Section 1(f) below, which, by reason of the selection and arrangement of their contents, constitute intellectual creations, in which the Work is included in its entirety in unmodified form along with one or more other contributions, each constituting separate and independent works in themselves, which together are assembled into a collective whole. A work that constitutes a Collection will not be considered an Adaptation (as defined below) for the purposes of this License.
+   3. "Creative Commons Compatible License" means a license that is listed at http://creativecommons.org/compatiblelicenses that has been approved by Creative Commons as being essentially equivalent to this License, including, at a minimum, because that license: (i) contains terms that have the same purpose, meaning and effect as the License Elements of this License; and, (ii) explicitly permits the relicensing of adaptations of works made available under that license under this License or a Creative Commons jurisdiction license with the same License Elements as this License.
+   4. "Distribute" means to make available to the public the original and copies of the Work or Adaptation, as appropriate, through sale or other transfer of ownership.
+   5. "License Elements" means the following high-level license attributes as selected by Licensor and indicated in the title of this License: Attribution, ShareAlike.
+   6. "Licensor" means the individual, individuals, entity or entities that offer(s) the Work under the terms of this License.
+   7. "Original Author" means, in the case of a literary or artistic work, the individual, individuals, entity or entities who created the Work or if no individual or entity can be identified, the publisher; and in addition (i) in the case of a performance the actors, singers, musicians, dancers, and other persons who act, sing, deliver, declaim, play in, interpret or otherwise perform literary or artistic works or expressions of folklore; (ii) in the case of a phonogram the producer being the person or legal entity who first fixes the sounds of a performance or other sounds; and, (iii) in the case of broadcasts, the organization that transmits the broadcast.
+   8. "Work" means the literary and/or artistic work offered under the terms of this License including without limitation any production in the literary, scientific and artistic domain, whatever may be the mode or form of its expression including digital form, such as a book, pamphlet and other writing; a lecture, address, sermon or other work of the same nature; a dramatic or dramatico-musical work; a choreographic work or entertainment in dumb show; a musical composition with or without words; a cinematographic work to which are assimilated works expressed by a process analogous to cinematography; a work of drawing, painting, architecture, sculpture, engraving or lithography; a photographic work to which are assimilated works expressed by a process analogous to photography; a work of applied art; an illustration, map, plan, sketch or three-dimensional work relative to geography, topography, architecture or science; a performance; a broadcast; a phonogram; a compilation of data to the extent it is protected as a copyrightable work; or a work performed by a variety or circus performer to the extent it is not otherwise considered a literary or artistic work.
+   9. "You" means an individual or entity exercising rights under this License who has not previously violated the terms of this License with respect to the Work, or who has received express permission from the Licensor to exercise rights under this License despite a previous violation.
+  10. "Publicly Perform" means to perform public recitations of the Work and to communicate to the public those public recitations, by any means or process, including by wire or wireless means or public digital performances; to make available to the public Works in such a way that members of the public may access these Works from a place and at a place individually chosen by them; to perform the Work to the public by any means or process and the communication to the public of the performances of the Work, including by public digital performance; to broadcast and rebroadcast the Work by any means including signs, sounds or images.
+  11. "Reproduce" means to make copies of the Work by any means including without limitation by sound or visual recordings and the right of fixation and reproducing fixations of the Work, including storage of a protected performance or phonogram in digital form or other electronic medium.
+
+2. Fair Dealing Rights. Nothing in this License is intended to reduce, limit, or restrict any uses free from copyright or rights arising from limitations or exceptions that are provided for in connection with the copyright protection under copyright law or other applicable laws.
+
+3. License Grant. Subject to the terms and conditions of this License, Licensor hereby grants You a worldwide, royalty-free, non-exclusive, perpetual (for the duration of the applicable copyright) license to exercise the rights in the Work as stated below:
+
+   1. to Reproduce the Work, to incorporate the Work into one or more Collections, and to Reproduce the Work as incorporated in the Collections;
+   2. to create and Reproduce Adaptations provided that any such Adaptation, including any translation in any medium, takes reasonable steps to clearly label, demarcate or otherwise identify that changes were made to the original Work. For example, a translation could be marked "The original work was translated from English to Spanish," or a modification could indicate "The original work has been modified.";
+   3. to Distribute and Publicly Perform the Work including as incorporated in Collections; and,
+   4. to Distribute and Publicly Perform Adaptations.
+   5.
+
+      For the avoidance of doubt:
+         1. Non-waivable Compulsory License Schemes. In those jurisdictions in which the right to collect royalties through any statutory or compulsory licensing scheme cannot be waived, the Licensor reserves the exclusive right to collect such royalties for any exercise by You of the rights granted under this License;
+         2. Waivable Compulsory License Schemes. In those jurisdictions in which the right to collect royalties through any statutory or compulsory licensing scheme can be waived, the Licensor waives the exclusive right to collect such royalties for any exercise by You of the rights granted under this License; and,
+         3. Voluntary License Schemes. The Licensor waives the right to collect royalties, whether individually or, in the event that the Licensor is a member of a collecting society that administers voluntary licensing schemes, via that society, from any exercise by You of the rights granted under this License.
+
+The above rights may be exercised in all media and formats whether now known or hereafter devised. The above rights include the right to make such modifications as are technically necessary to exercise the rights in other media and formats. Subject to Section 8(f), all rights not expressly granted by Licensor are hereby reserved.
+
+4. Restrictions. The license granted in Section 3 above is expressly made subject to and limited by the following restrictions:
+
+   1. You may Distribute or Publicly Perform the Work only under the terms of this License. You must include a copy of, or the Uniform Resource Identifier (URI) for, this License with every copy of the Work You Distribute or Publicly Perform. You may not offer or impose any terms on the Work that restrict the terms of this License or the ability of the recipient of the Work to exercise the rights granted to that recipient under the terms of the License. You may not sublicense the Work. You must keep intact all notices that refer to this License and to the disclaimer of warranties with every copy of the Work You Distribute or Publicly Perform. When You Distribute or Publicly Perform the Work, You may not impose any effective technological measures on the Work that restrict the ability of a recipient of the Work from You to exercise the rights granted to that recipient under the terms of the License. This Section 4(a) applies to the Work as incorporated in a Collection, but this does not require the Collection apart from the Work itself to be made subject to the terms of this License. If You create a Collection, upon notice from any Licensor You must, to the extent practicable, remove from the Collection any credit as required by Section 4(c), as requested. If You create an Adaptation, upon notice from any Licensor You must, to the extent practicable, remove from the Adaptation any credit as required by Section 4(c), as requested.
+   2. You may Distribute or Publicly Perform an Adaptation only under the terms of: (i) this License; (ii) a later version of this License with the same License Elements as this License; (iii) a Creative Commons jurisdiction license (either this or a later license version) that contains the same License Elements as this License (e.g., Attribution-ShareAlike 3.0 US)); (iv) a Creative Commons Compatible License. If you license the Adaptation under one of the licenses mentioned in (iv), you must comply with the terms of that license. If you license the Adaptation under the terms of any of the licenses mentioned in (i), (ii) or (iii) (the "Applicable License"), you must comply with the terms of the Applicable License generally and the following provisions: (I) You must include a copy of, or the URI for, the Applicable License with every copy of each Adaptation You Distribute or Publicly Perform; (II) You may not offer or impose any terms on the Adaptation that restrict the terms of the Applicable License or the ability of the recipient of the Adaptation to exercise the rights granted to that recipient under the terms of the Applicable License; (III) You must keep intact all notices that refer to the Applicable License and to the disclaimer of warranties with every copy of the Work as included in the Adaptation You Distribute or Publicly Perform; (IV) when You Distribute or Publicly Perform the Adaptation, You may not impose any effective technological measures on the Adaptation that restrict the ability of a recipient of the Adaptation from You to exercise the rights granted to that recipient under the terms of the Applicable License. This Section 4(b) applies to the Adaptation as incorporated in a Collection, but this does not require the Collection apart from the Adaptation itself to be made subject to the terms of the Applicable License.
+   3. If You Distribute, or Publicly Perform the Work or any Adaptations or Collections, You must, unless a request has been made pursuant to Section 4(a), keep intact all copyright notices for the Work and provide, reasonable to the medium or means You are utilizing: (i) the name of the Original Author (or pseudonym, if applicable) if supplied, and/or if the Original Author and/or Licensor designate another party or parties (e.g., a sponsor institute, publishing entity, journal) for attribution ("Attribution Parties") in Licensor's copyright notice, terms of service or by other reasonable means, the name of such party or parties; (ii) the title of the Work if supplied; (iii) to the extent reasonably practicable, the URI, if any, that Licensor specifies to be associated with the Work, unless such URI does not refer to the copyright notice or licensing information for the Work; and (iv) , consistent with Ssection 3(b), in the case of an Adaptation, a credit identifying the use of the Work in the Adaptation (e.g., "French translation of the Work by Original Author," or "Screenplay based on original Work by Original Author"). The credit required by this Section 4(c) may be implemented in any reasonable manner; provided, however, that in the case of a Adaptation or Collection, at a minimum such credit will appear, if a credit for all contributing authors of the Adaptation or Collection appears, then as part of these credits and in a manner at least as prominent as the credits for the other contributing authors. For the avoidance of doubt, You may only use the credit required by this Section for the purpose of attribution in the manner set out above and, by exercising Your rights under this License, You may not implicitly or explicitly assert or imply any connection with, sponsorship or endorsement by the Original Author, Licensor and/or Attribution Parties, as appropriate, of You or Your use of the Work, without the separate, express prior written permission of the Original Author, Licensor and/or Attribution Parties.
+   4. Except as otherwise agreed in writing by the Licensor or as may be otherwise permitted by applicable law, if You Reproduce, Distribute or Publicly Perform the Work either by itself or as part of any Adaptations or Collections, You must not distort, mutilate, modify or take other derogatory action in relation to the Work which would be prejudicial to the Original Author's honor or reputation. Licensor agrees that in those jurisdictions (e.g. Japan), in which any exercise of the right granted in Section 3(b) of this License (the right to make Adaptations) would be deemed to be a distortion, mutilation, modification or other derogatory action prejudicial to the Original Author's honor and reputation, the Licensor will waive or not assert, as appropriate, this Section, to the fullest extent permitted by the applicable national law, to enable You to reasonably exercise Your right under Section 3(b) of this License (right to make Adaptations) but not otherwise.
+
+5. Representations, Warranties and Disclaimer
+
+UNLESS OTHERWISE MUTUALLY AGREED TO BY THE PARTIES IN WRITING, LICENSOR OFFERS THE WORK AS-IS AND MAKES NO REPRESENTATIONS OR WARRANTIES OF ANY KIND CONCERNING THE WORK, EXPRESS, IMPLIED, STATUTORY OR OTHERWISE, INCLUDING, WITHOUT LIMITATION, WARRANTIES OF TITLE, MERCHANTIBILITY, FITNESS FOR A PARTICULAR PURPOSE, NONINFRINGEMENT, OR THE ABSENCE OF LATENT OR OTHER DEFECTS, ACCURACY, OR THE PRESENCE OF ABSENCE OF ERRORS, WHETHER OR NOT DISCOVERABLE. SOME JURISDICTIONS DO NOT ALLOW THE EXCLUSION OF IMPLIED WARRANTIES, SO SUCH EXCLUSION MAY NOT APPLY TO YOU.
+
+6. Limitation on Liability. EXCEPT TO THE EXTENT REQUIRED BY APPLICABLE LAW, IN NO EVENT WILL LICENSOR BE LIABLE TO YOU ON ANY LEGAL THEORY FOR ANY SPECIAL, INCIDENTAL, CONSEQUENTIAL, PUNITIVE OR EXEMPLARY DAMAGES ARISING OUT OF THIS LICENSE OR THE USE OF THE WORK, EVEN IF LICENSOR HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
+
+7. Termination
+
+   1. This License and the rights granted hereunder will terminate automatically upon any breach by You of the terms of this License. Individuals or entities who have received Adaptations or Collections from You under this License, however, will not have their licenses terminated provided such individuals or entities remain in full compliance with those licenses. Sections 1, 2, 5, 6, 7, and 8 will survive any termination of this License.
+   2. Subject to the above terms and conditions, the license granted here is perpetual (for the duration of the applicable copyright in the Work). Notwithstanding the above, Licensor reserves the right to release the Work under different license terms or to stop distributing the Work at any time; provided, however that any such election will not serve to withdraw this License (or any other license that has been, or is required to be, granted under the terms of this License), and this License will continue in full force and effect unless terminated as stated above.
+
+8. Miscellaneous
+
+   1. Each time You Distribute or Publicly Perform the Work or a Collection, the Licensor offers to the recipient a license to the Work on the same terms and conditions as the license granted to You under this License.
+   2. Each time You Distribute or Publicly Perform an Adaptation, Licensor offers to the recipient a license to the original Work on the same terms and conditions as the license granted to You under this License.
+   3. If any provision of this License is invalid or unenforceable under applicable law, it shall not affect the validity or enforceability of the remainder of the terms of this License, and without further action by the parties to this agreement, such provision shall be reformed to the minimum extent necessary to make such provision valid and enforceable.
+   4. No term or provision of this License shall be deemed waived and no breach consented to unless such waiver or consent shall be in writing and signed by the party to be charged with such waiver or consent.
+   5. This License constitutes the entire agreement between the parties with respect to the Work licensed here. There are no understandings, agreements or representations with respect to the Work not specified here. Licensor shall not be bound by any additional provisions that may appear in any communication from You. This License may not be modified without the mutual written agreement of the Licensor and You.
+   6. The rights granted under, and the subject matter referenced, in this License were drafted utilizing the terminology of the Berne Convention for the Protection of Literary and Artistic Works (as amended on September 28, 1979), the Rome Convention of 1961, the WIPO Copyright Treaty of 1996, the WIPO Performances and Phonograms Treaty of 1996 and the Universal Copyright Convention (as revised on July 24, 1971). These rights and subject matter take effect in the relevant jurisdiction in which the License terms are sought to be enforced according to the corresponding provisions of the implementation of those treaty provisions in the applicable national law. If the standard suite of rights granted under applicable copyright law includes additional rights not granted under this License, such additional rights are deemed to be included in the License; this License is not intended to restrict the license of any rights under applicable law.
+
+    Creative Commons Notice
+
+    Creative Commons is not a party to this License, and makes no warranty whatsoever in connection with the Work. Creative Commons will not be liable to You or any party on any legal theory for any damages whatsoever, including without limitation any general, special, incidental or consequential damages arising in connection to this license. Notwithstanding the foregoing two (2) sentences, if Creative Commons has expressly identified itself as the Licensor hereunder, it shall have all rights and obligations of Licensor.
+
+    Except for the limited purpose of indicating to the public that the Work is licensed under the CCPL, Creative Commons does not authorize the use by either party of the trademark "Creative Commons" or any related trademark or logo of Creative Commons without the prior written consent of Creative Commons. Any permitted use will be in compliance with Creative Commons' then-current trademark usage guidelines, as may be published on its website or otherwise made available upon request from time to time. For the avoidance of doubt, this trademark restriction does not form part of the License.
+
+    Creative Commons may be contacted at http://creativecommons.org/.
+
diff --git a/LICENSE-README b/LICENSE-README
index e7295e13e..6968b1478 100644
--- a/LICENSE-README
+++ b/LICENSE-README
@@ -1,7 +1,7 @@
-Please note that:
-
-1) The LICENSE file only refers to the licensing of the source and binary code of ESAPI. 
-   For example, the actual ESAPI JAR file is only licensed under "The BSD License".
-   
-2) The LICENSE-CONTENT file only refers to the licensing of the content and documentation of ESAPI. 
+Please note that:
+
+1) The LICENSE file only refers to the licensing of the source and binary code of ESAPI. 
+   For example, the actual ESAPI JAR file is only licensed under "The BSD License".
+   
+2) The LICENSE-CONTENT file only refers to the licensing of the content and documentation of ESAPI. 
    For example, the documentation directory is only licensed under the Creative Commons/ShareAlike 3.0 Unported license.
\ No newline at end of file
diff --git a/documentation/esapi4java-2.0-readme.txt b/documentation/esapi4java-2.0-readme.txt
index de7c40dda..f2b3e61b6 100644
--- a/documentation/esapi4java-2.0-readme.txt
+++ b/documentation/esapi4java-2.0-readme.txt
@@ -1,60 +1,60 @@
-
-                            Welcome to ESAPI for Java!
-
-(This file best viewed full screen.)
-
-Here are the most significant directories and files included the zip file for this release:
-
-File / Directory                                                        Description
-=========================================================================================
-/	
-|
-+---configuration/                                                      Directory of ESAPI configuration files
-|     |
-|     |---.esapi/
-|     |     |---waf-policies/                                           Directory containing Web Application Firewall policies
-|     |     |---ESAPI.properties                                        The main ESAPI configuration file
-|     |     `---validation.properties                                   Regular expressions used by the ESAPI validator
-|     |
-|     `---properties/                                                   Examples of how to internationalize error messages???
-|           |---ESAPI_en_US.properties                                      in US/English
-|           |---ESAPI_fr_FR.properties                                      in French
-|           `---ESAPI_zhs_CN.properties                                     in Chinese
-|
-|---documentation/                                                      ESAPI documentation
-|     |
-|     |---esapi4java-2.0-readme.txt                                     The file you are now reading
-|     |---esapi4java-core-2.0-release-notes.pdf                         ESAPI 2.0 release notes (draft)
-|     |---esapi4java-core-2.0-install-guide.doc                         ESAPI 2.0 installation guide (draft)
-|     |---esapi4java-2.0rc6-override-log4jloggingfactory.txt            How to use log4j to override User logging
-|     |---esapi4java-core-2.0-ciphertext-serialization.pdf              Describes serialization layout of ESAPI 2.0 ciphertext representation
-|     |---esapi4java-core-2.0-crypto-design-goals.doc (draft)           Describes ESAPI 2.0 crypto design goals & design decisions
-|     |---esapi4java-core-2.0-readme-crypto-changes.html                Describes why crypto was changed from what was in ESAPI 1.4
-|     |---esapi4java-core-2.0-symmetric-crypto-user-guide.html          User guide for using symmetric encryption in ESAPI 2.0
-|     |---esapi4java-core-2.1-release-notes.txt                         ESAPI 2.1 release notes
-|     `---esapi4java-waf-2.0-policy-file-spec.pdf                       Describes how to configure ESAPI 2.0's Web Application Firewall
-|
-|---libs/                                                               ESAPI dependencies
-|
-|---site/
-|     |---apidocs                                                       ESAPI Javadoc
-|     |---cobertura
-|     `---testapidocs                                                   ESAPI Javadoc for its JUnit test cases
-|
-|---src/                                                                ESAPI source code
-|
-|---esapi-.jar                                                    The ESAPI jar for version  (e.g.,  == 2.0_rc10)
-|
-|---LICENSE.txt                                                         ESAPI license for source code and documentation
-|
-`---pom.xml                                                             Maven's pom.xml for building ESAPI from source via mvn.
-
-===========================================================
-
-Where to go from here -- please see the installation guide and the release
-notes.
-
-Please address comments and questions concerning the API and this document to
-the ESAPI Users mailing list, .
-
-Copyright (C) 2009-2010 The OWASP Foundation.
+
+                            Welcome to ESAPI for Java!
+
+(This file best viewed full screen.)
+
+Here are the most significant directories and files included the zip file for this release:
+
+File / Directory                                                        Description
+=========================================================================================
+/	
+|
++---configuration/                                                      Directory of ESAPI configuration files
+|     |
+|     |---.esapi/
+|     |     |---waf-policies/                                           Directory containing Web Application Firewall policies
+|     |     |---ESAPI.properties                                        The main ESAPI configuration file
+|     |     `---validation.properties                                   Regular expressions used by the ESAPI validator
+|     |
+|     `---properties/                                                   Examples of how to internationalize error messages???
+|           |---ESAPI_en_US.properties                                      in US/English
+|           |---ESAPI_fr_FR.properties                                      in French
+|           `---ESAPI_zhs_CN.properties                                     in Chinese
+|
+|---documentation/                                                      ESAPI documentation
+|     |
+|     |---esapi4java-2.0-readme.txt                                     The file you are now reading
+|     |---esapi4java-core-2.0-release-notes.pdf                         ESAPI 2.0 release notes (draft)
+|     |---esapi4java-core-2.0-install-guide.doc                         ESAPI 2.0 installation guide (draft)
+|     |---esapi4java-2.0rc6-override-log4jloggingfactory.txt            How to use log4j to override User logging
+|     |---esapi4java-core-2.0-ciphertext-serialization.pdf              Describes serialization layout of ESAPI 2.0 ciphertext representation
+|     |---esapi4java-core-2.0-crypto-design-goals.doc (draft)           Describes ESAPI 2.0 crypto design goals & design decisions
+|     |---esapi4java-core-2.0-readme-crypto-changes.html                Describes why crypto was changed from what was in ESAPI 1.4
+|     |---esapi4java-core-2.0-symmetric-crypto-user-guide.html          User guide for using symmetric encryption in ESAPI 2.0
+|     |---esapi4java-core-2.1-release-notes.txt                         ESAPI 2.1 release notes
+|     `---esapi4java-waf-2.0-policy-file-spec.pdf                       Describes how to configure ESAPI 2.0's Web Application Firewall
+|
+|---libs/                                                               ESAPI dependencies
+|
+|---site/
+|     |---apidocs                                                       ESAPI Javadoc
+|     |---cobertura
+|     `---testapidocs                                                   ESAPI Javadoc for its JUnit test cases
+|
+|---src/                                                                ESAPI source code
+|
+|---esapi-.jar                                                    The ESAPI jar for version  (e.g.,  == 2.0_rc10)
+|
+|---LICENSE.txt                                                         ESAPI license for source code and documentation
+|
+`---pom.xml                                                             Maven's pom.xml for building ESAPI from source via mvn.
+
+===========================================================
+
+Where to go from here -- please see the installation guide and the release
+notes.
+
+Please address comments and questions concerning the API and this document to
+the ESAPI Users mailing list, .
+
+Copyright (C) 2009-2010 The OWASP Foundation.
diff --git a/documentation/esapi4java-2.0rc6-override-log4jloggingfactory.txt b/documentation/esapi4java-2.0rc6-override-log4jloggingfactory.txt
index 891f76935..49accdbfc 100644
--- a/documentation/esapi4java-2.0rc6-override-log4jloggingfactory.txt
+++ b/documentation/esapi4java-2.0rc6-override-log4jloggingfactory.txt
@@ -1,71 +1,71 @@
-This release includes critical changes to the ESAPI Log4JLogger that will now allow you to over-ride the user specific 
-message using your own User or java.security.Principal implementation.
-
-There are a three critical steps that need to be taken to over-ride the ESAPI Log4JLogger:
-
-1)  Please make a copy of http://owasp-esapi-java.googlecode.com/svn/trunk/src/main/java/org/owasp/esapi/reference/ExampleExtendedLog4JLogFactory.java and change the package and the class name (something like com.yourcompany.logging.ExtendedLog4JFactory). This class (not very big at all) gives you the exact “shell” that you will need to over-ride the user message of the ESAPI Log4JLogger.
-
-2)  In your new class, please change the following function to use your user object:
-
-        public String getUserInfo() {
-            return "-EXTENDEDUSERINFO-";
-    }
-
-3)  Change your copy of ESAPI.properties to use your new logging class
-
-The ESAPI.properties entry looks like this now:
-
-ESAPI.Logger=org.owasp.esapi.reference.Log4JLogFactory
-
-Please change it to the following, based on how you renamed your new logging class
-
-ESAPI.Logger=com.yourcompany.logging.ExtendedLog4JFactory
-
-And you should be all set!
-
-PS: The original ESAPI Log4JLogging class used a secure random number as a replacement to logging the session ID. This allowed 
-us to tie log messages from the same session together, without exposing the actual session id in the log file. The code looks 
-like this, and you may wish to use it in your over-ridden version of getUserInfo.
-
-HttpServletRequest request = ESAPI.httpUtilities().getCurrentRequest();
-if ( request != null ) {
-    HttpSession session = request.getSession( false );
-    if ( session != null ) {
-        sid = (String)session.getAttribute("ESAPI_SESSION");
-        // if there is no session ID for the user yet, we create one and store it in the user's session
-        if ( sid == null ) {
-            sid = ""+ ESAPI.randomizer().getRandomInteger(0, 1000000);
-            session.setAttribute("ESAPI_SESSION", sid);
-        }
-    }
-}
-
-In fact, here is the entire original getUserInfo() implementation (that was tied to the ESAPI request and user object) – 
-you may wish to emulate some of this.
-
-public String getUserInfo() {
-    // create a random session number for the user to represent the user's 'session', if it doesn't exist already
-    String sid = null;
-    HttpServletRequest request = ESAPI.httpUtilities().getCurrentRequest();
-    if ( request != null ) {
-        HttpSession session = request.getSession( false );
-        if ( session != null ) {
-            sid = (String)session.getAttribute("ESAPI_SESSION");
-            // if there is no session ID for the user yet, we create one and store it in the user's session
-            if ( sid == null ) {
-                sid = ""+ ESAPI.randomizer().getRandomInteger(0, 1000000);
-                session.setAttribute("ESAPI_SESSION", sid);
-            }
-        }
-    }
-    
-    // log user information - username:session@ipaddr
-    User user = ESAPI.authenticator().getCurrentUser();            
-    String userInfo = "";
-    //TODO - make type logging configurable
-    if ( user != null) {
-        userInfo += user.getAccountName()+ ":" + sid + "@"+ user.getLastHostAddress();
-    }
-    
-    return userInfo;
-}
+This release includes critical changes to the ESAPI Log4JLogger that will now allow you to over-ride the user specific 
+message using your own User or java.security.Principal implementation.
+
+There are a three critical steps that need to be taken to over-ride the ESAPI Log4JLogger:
+
+1)  Please make a copy of http://owasp-esapi-java.googlecode.com/svn/trunk/src/main/java/org/owasp/esapi/reference/ExampleExtendedLog4JLogFactory.java and change the package and the class name (something like com.yourcompany.logging.ExtendedLog4JFactory). This class (not very big at all) gives you the exact “shell” that you will need to over-ride the user message of the ESAPI Log4JLogger.
+
+2)  In your new class, please change the following function to use your user object:
+
+        public String getUserInfo() {
+            return "-EXTENDEDUSERINFO-";
+    }
+
+3)  Change your copy of ESAPI.properties to use your new logging class
+
+The ESAPI.properties entry looks like this now:
+
+ESAPI.Logger=org.owasp.esapi.reference.Log4JLogFactory
+
+Please change it to the following, based on how you renamed your new logging class
+
+ESAPI.Logger=com.yourcompany.logging.ExtendedLog4JFactory
+
+And you should be all set!
+
+PS: The original ESAPI Log4JLogging class used a secure random number as a replacement to logging the session ID. This allowed 
+us to tie log messages from the same session together, without exposing the actual session id in the log file. The code looks 
+like this, and you may wish to use it in your over-ridden version of getUserInfo.
+
+HttpServletRequest request = ESAPI.httpUtilities().getCurrentRequest();
+if ( request != null ) {
+    HttpSession session = request.getSession( false );
+    if ( session != null ) {
+        sid = (String)session.getAttribute("ESAPI_SESSION");
+        // if there is no session ID for the user yet, we create one and store it in the user's session
+        if ( sid == null ) {
+            sid = ""+ ESAPI.randomizer().getRandomInteger(0, 1000000);
+            session.setAttribute("ESAPI_SESSION", sid);
+        }
+    }
+}
+
+In fact, here is the entire original getUserInfo() implementation (that was tied to the ESAPI request and user object) – 
+you may wish to emulate some of this.
+
+public String getUserInfo() {
+    // create a random session number for the user to represent the user's 'session', if it doesn't exist already
+    String sid = null;
+    HttpServletRequest request = ESAPI.httpUtilities().getCurrentRequest();
+    if ( request != null ) {
+        HttpSession session = request.getSession( false );
+        if ( session != null ) {
+            sid = (String)session.getAttribute("ESAPI_SESSION");
+            // if there is no session ID for the user yet, we create one and store it in the user's session
+            if ( sid == null ) {
+                sid = ""+ ESAPI.randomizer().getRandomInteger(0, 1000000);
+                session.setAttribute("ESAPI_SESSION", sid);
+            }
+        }
+    }
+    
+    // log user information - username:session@ipaddr
+    User user = ESAPI.authenticator().getCurrentUser();            
+    String userInfo = "";
+    //TODO - make type logging configurable
+    if ( user != null) {
+        userInfo += user.getAccountName()+ ":" + sid + "@"+ user.getLastHostAddress();
+    }
+    
+    return userInfo;
+}
diff --git a/documentation/esapi4java-core-2.1-release-notes.txt b/documentation/esapi4java-core-2.1-release-notes.txt
index 3570d0f88..d84097d80 100644
--- a/documentation/esapi4java-core-2.1-release-notes.txt
+++ b/documentation/esapi4java-core-2.1-release-notes.txt
@@ -1,68 +1,68 @@
-ESAPI for Java - 2.1.0 Release Notes
-
-1) Fixed security issue #306, a vulnerability discovered by Phillipe Arteau.
-   This fix necessitated removing the deprecated encrypt() and decrupt() methods
-   that were intended to provide backward compatibility with ESAPI 1.4.
-   As it turns out, there was no way to fix this bug without a major rewrite
-   unless these methods were removed. However, as these two methods have been
-   deprecated more than 2 years ago and they are known to be insecure
-   (they are vulnerable to padding oracle attacks), the ESAPI team has
-   decided to remove them in accordance to their support policy.
-   
-   See comments for issue #306 for further details, as well as additional
-   safety precautions that you may wish to take in the unlikely, but possible
-   event that this vulnerability resulted in an actual security breach.
-
-   Finally, since the removal of these methods constitute an interface change
-   (to the Encryptor interface), this is considered a minor release (2.1)
-   rather than simply a patch release (2.0.2).
-
-   Please note that there are further updates planned to further strengthen
-   the MAC that ESAPI crypt uses. However, because they will require some
-   design changes, they may not be out for another month. Note that these
-   fixes do not correct any *known* vulnerabilities, but will address
-   some potential weaknesses in what is not included in the MAC (such as
-   the crypto version).
-
-2) Other Google Issues fixed: 257, 271, and 292 are all fixed in this release.
-
-3) Fixed Javadoc for Encoder.encryptForJavaScript(). [Revision r1879]
-
-4) DefaultEncryptedProperties - made minor Javadoc changes.
-
-5) The ESAPI 2.0 Encryptor.encrypt() methods now all throw an appropriate
-   IllegalArgumentException if any of the arguments are null. Previously,
-   if any of the arguments were null you would either get an AssertionError
-   (if you had assertions enabled) or a default NullPointerException when
-   assertions were disabled.  While IllegalArgumentException is still an
-   unchecked RuntimeException, note that if you were previously catching
-   NullPointerExceptions for these cases, you may need to change your code.
-
-6) The public constructor, CiphertextSerializer(CipherText ct), was changed
-   to explicitly check that the parameter is not null. Previously it had
-   checked with assertions which might later result in a NullPointerException
-   being thrown if assertions were disabled. Now if the parameter is null,
-   an appropriate IllegalArgumentException is thrown. This should not really
-   affect existing code (unless you are experimenting implementing your own
-   crypto) since user code should not really be using CiperTextSerializer
-   directly.
-
-7) Some of the setter methods in KeyDerivationFunction were changed to explicitly
-   check for invalid arguments and throw an IllegalArgumentException rather than
-   checking these parameters via assertions. This should not affect general
-   user code as most would not be calling the KeyDerivationFunction class
-   directly.
-
-8) Other miscellaneous minor code clean-up, mostly to remove compiler warnings.
-
-NOTE: A follow-up patch release is scheduled within the next few months to
-      address some questionable design decisions regarding what data in
-      the serialized ciphertext should be authenticated via the MAC. For
-      instance, presently only the IV+ciphertext is MAC'd (as would be the
-      equivalent case of when you would use an authenticated combined cipher
-      mode such as GCM or CCM). A deeper analysis of the design is required
-      based on findings in Google Issue # 306. I will periodically try
-      to keep the ESAPI mailing lists updated with the progress so watch
-      there for emerging details and anticipated schedule.
-      
--Kevin W. Wall , 2013-08-30
+ESAPI for Java - 2.1.0 Release Notes
+
+1) Fixed security issue #306, a vulnerability discovered by Phillipe Arteau.
+   This fix necessitated removing the deprecated encrypt() and decrupt() methods
+   that were intended to provide backward compatibility with ESAPI 1.4.
+   As it turns out, there was no way to fix this bug without a major rewrite
+   unless these methods were removed. However, as these two methods have been
+   deprecated more than 2 years ago and they are known to be insecure
+   (they are vulnerable to padding oracle attacks), the ESAPI team has
+   decided to remove them in accordance to their support policy.
+   
+   See comments for issue #306 for further details, as well as additional
+   safety precautions that you may wish to take in the unlikely, but possible
+   event that this vulnerability resulted in an actual security breach.
+
+   Finally, since the removal of these methods constitute an interface change
+   (to the Encryptor interface), this is considered a minor release (2.1)
+   rather than simply a patch release (2.0.2).
+
+   Please note that there are further updates planned to further strengthen
+   the MAC that ESAPI crypt uses. However, because they will require some
+   design changes, they may not be out for another month. Note that these
+   fixes do not correct any *known* vulnerabilities, but will address
+   some potential weaknesses in what is not included in the MAC (such as
+   the crypto version).
+
+2) Other Google Issues fixed: 257, 271, and 292 are all fixed in this release.
+
+3) Fixed Javadoc for Encoder.encryptForJavaScript(). [Revision r1879]
+
+4) DefaultEncryptedProperties - made minor Javadoc changes.
+
+5) The ESAPI 2.0 Encryptor.encrypt() methods now all throw an appropriate
+   IllegalArgumentException if any of the arguments are null. Previously,
+   if any of the arguments were null you would either get an AssertionError
+   (if you had assertions enabled) or a default NullPointerException when
+   assertions were disabled.  While IllegalArgumentException is still an
+   unchecked RuntimeException, note that if you were previously catching
+   NullPointerExceptions for these cases, you may need to change your code.
+
+6) The public constructor, CiphertextSerializer(CipherText ct), was changed
+   to explicitly check that the parameter is not null. Previously it had
+   checked with assertions which might later result in a NullPointerException
+   being thrown if assertions were disabled. Now if the parameter is null,
+   an appropriate IllegalArgumentException is thrown. This should not really
+   affect existing code (unless you are experimenting implementing your own
+   crypto) since user code should not really be using CiperTextSerializer
+   directly.
+
+7) Some of the setter methods in KeyDerivationFunction were changed to explicitly
+   check for invalid arguments and throw an IllegalArgumentException rather than
+   checking these parameters via assertions. This should not affect general
+   user code as most would not be calling the KeyDerivationFunction class
+   directly.
+
+8) Other miscellaneous minor code clean-up, mostly to remove compiler warnings.
+
+NOTE: A follow-up patch release is scheduled within the next few months to
+      address some questionable design decisions regarding what data in
+      the serialized ciphertext should be authenticated via the MAC. For
+      instance, presently only the IV+ciphertext is MAC'd (as would be the
+      equivalent case of when you would use an authenticated combined cipher
+      mode such as GCM or CCM). A deeper analysis of the design is required
+      based on findings in Google Issue # 306. I will periodically try
+      to keep the ESAPI mailing lists updated with the progress so watch
+      there for emerging details and anticipated schedule.
+      
+-Kevin W. Wall , 2013-08-30
diff --git a/src/main/java/META-INF/MANIFEST.MF b/src/main/java/META-INF/MANIFEST.MF
index 5e9495128..254272e1c 100644
--- a/src/main/java/META-INF/MANIFEST.MF
+++ b/src/main/java/META-INF/MANIFEST.MF
@@ -1,3 +1,3 @@
-Manifest-Version: 1.0
-Class-Path: 
-
+Manifest-Version: 1.0
+Class-Path: 
+

From 142307d2811d139221c27e8da98aa01324d5514c Mon Sep 17 00:00:00 2001
From: kwwall 
Date: Tue, 19 Jan 2016 22:11:46 -0500
Subject: [PATCH 341/812] Try to get git to ignore Eclipse generated files.

---
 .gitignore | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/.gitignore b/.gitignore
index ea8c4bf7f..0f6484a23 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1 +1,4 @@
 /target
+/.settings/**
+.classpath
+.project

From 65adf0518925b91d965d6d3e70e031faa9ca122b Mon Sep 17 00:00:00 2001
From: "Kevin W. Wall" 
Date: Tue, 19 Jan 2016 22:19:27 -0500
Subject: [PATCH 342/812] Delete org.eclipse.core.resources.prefs

This is a file generated by Eclipse and not really part of ESAPI per se. It may be version specific to a particular release of Eclipse, thus we are deleting it and adding it to be ignored in the .gitignore file.
---
 .settings/org.eclipse.core.resources.prefs | 3 ---
 1 file changed, 3 deletions(-)
 delete mode 100644 .settings/org.eclipse.core.resources.prefs

diff --git a/.settings/org.eclipse.core.resources.prefs b/.settings/org.eclipse.core.resources.prefs
deleted file mode 100644
index 2655b6477..000000000
--- a/.settings/org.eclipse.core.resources.prefs
+++ /dev/null
@@ -1,3 +0,0 @@
-#Thu Nov 26 01:50:11 HST 2009
-eclipse.preferences.version=1
-encoding/=UTF-8

From a88295a60d39d8f696461cdb9bfa9f52352c23da Mon Sep 17 00:00:00 2001
From: "Kevin W. Wall" 
Date: Tue, 19 Jan 2016 22:20:48 -0500
Subject: [PATCH 343/812] Delete org.eclipse.jdt.core.prefs

This is a file generated by Eclipse and not really part of ESAPI per se. It may be version specific to a particular release of Eclipse, thus we are deleting it and adding it to be ignored in the .gitignore file. (In fact, this one is telling Eclipse to use '-target 1.5' when actually '-target 1.6' is what the pom.xml specifies.)
---
 .settings/org.eclipse.jdt.core.prefs | 6 ------
 1 file changed, 6 deletions(-)
 delete mode 100644 .settings/org.eclipse.jdt.core.prefs

diff --git a/.settings/org.eclipse.jdt.core.prefs b/.settings/org.eclipse.jdt.core.prefs
deleted file mode 100644
index 9e33fcc4b..000000000
--- a/.settings/org.eclipse.jdt.core.prefs
+++ /dev/null
@@ -1,6 +0,0 @@
-#Tue May 10 22:28:38 MDT 2011
-eclipse.preferences.version=1
-org.eclipse.jdt.core.compiler.codegen.targetPlatform=1.5
-org.eclipse.jdt.core.compiler.compliance=1.5
-org.eclipse.jdt.core.compiler.problem.forbiddenReference=warning
-org.eclipse.jdt.core.compiler.source=1.5

From d863f355fe6e05d81b0b209077e4d4b851d6f62d Mon Sep 17 00:00:00 2001
From: "Kevin W. Wall" 
Date: Tue, 19 Jan 2016 22:21:30 -0500
Subject: [PATCH 344/812] Delete org.eclipse.wst.common.component

This is a file generated by Eclipse and not really part of ESAPI per se. It may be version specific to a particular release of Eclipse, thus we are deleting it and adding it to be ignored in the .gitignore file.
---
 .settings/org.eclipse.wst.common.component | 10 ----------
 1 file changed, 10 deletions(-)
 delete mode 100644 .settings/org.eclipse.wst.common.component

diff --git a/.settings/org.eclipse.wst.common.component b/.settings/org.eclipse.wst.common.component
deleted file mode 100644
index b814064d1..000000000
--- a/.settings/org.eclipse.wst.common.component
+++ /dev/null
@@ -1,10 +0,0 @@
-
-
-  
-    
-    
-        
-        
-        
-  
-

From ce7641299919f60f8dab994fc28afdb29884e496 Mon Sep 17 00:00:00 2001
From: "Kevin W. Wall" 
Date: Tue, 19 Jan 2016 22:21:45 -0500
Subject: [PATCH 345/812] Delete org.eclipse.wst.common.project.facet.core.xml

This is a file generated by Eclipse and not really part of ESAPI per se. It may be version specific to a particular release of Eclipse, thus we are deleting it and adding it to be ignored in the .gitignore file.
---
 .settings/org.eclipse.wst.common.project.facet.core.xml | 6 ------
 1 file changed, 6 deletions(-)
 delete mode 100644 .settings/org.eclipse.wst.common.project.facet.core.xml

diff --git a/.settings/org.eclipse.wst.common.project.facet.core.xml b/.settings/org.eclipse.wst.common.project.facet.core.xml
deleted file mode 100644
index 9bbcbd78e..000000000
--- a/.settings/org.eclipse.wst.common.project.facet.core.xml
+++ /dev/null
@@ -1,6 +0,0 @@
-
-  
-  
-  
-  
-
\ No newline at end of file

From 7fd79e7e68b8561e50a15cfc3dfd8efc351e94d8 Mon Sep 17 00:00:00 2001
From: "Kevin W. Wall" 
Date: Tue, 19 Jan 2016 22:22:04 -0500
Subject: [PATCH 346/812] Delete org.maven.ide.eclipse.prefs

This is a file generated by Eclipse and not really part of ESAPI per se. It may be version specific to a particular release of Eclipse, thus we are deleting it and adding it to be ignored in the .gitignore file.
---
 .settings/org.maven.ide.eclipse.prefs | 9 ---------
 1 file changed, 9 deletions(-)
 delete mode 100644 .settings/org.maven.ide.eclipse.prefs

diff --git a/.settings/org.maven.ide.eclipse.prefs b/.settings/org.maven.ide.eclipse.prefs
deleted file mode 100644
index 310a30006..000000000
--- a/.settings/org.maven.ide.eclipse.prefs
+++ /dev/null
@@ -1,9 +0,0 @@
-#Fri Jul 10 01:10:33 EDT 2009
-activeProfiles=
-eclipse.preferences.version=1
-fullBuildGoals=process-test-resources
-includeModules=false
-resolveWorkspaceProjects=true
-resourceFilterGoals=process-resources resources\:testResources
-skipCompilerPlugin=true
-version=1

From 467f179292243c369c1fee09427481c3f7e6a39b Mon Sep 17 00:00:00 2001
From: "Kevin W. Wall" 
Date: Tue, 19 Jan 2016 22:25:02 -0500
Subject: [PATCH 347/812] Delete .classpath

This is a file generated by Eclipse and not really part of ESAPI per se. It may be version specific to a particular release of Eclipse, thus we are deleting it and adding it to be ignored in the .gitignore file.
---
 .classpath | 10 ----------
 1 file changed, 10 deletions(-)
 delete mode 100644 .classpath

diff --git a/.classpath b/.classpath
deleted file mode 100644
index 3c57589c2..000000000
--- a/.classpath
+++ /dev/null
@@ -1,10 +0,0 @@
-
-
-	
-	
-	
-	
-	
-	
-	
-

From 65d6673e58995ca08b26e97edd090acbd2a5a68c Mon Sep 17 00:00:00 2001
From: "Kevin W. Wall" 
Date: Tue, 19 Jan 2016 22:25:52 -0500
Subject: [PATCH 348/812] Delete .project

This is a file generated by Eclipse and not really part of ESAPI per se. It may be version specific to a particular release of Eclipse, thus we are deleting it and adding it to be ignored in the .gitignore file.
---
 .project | 42 ------------------------------------------
 1 file changed, 42 deletions(-)
 delete mode 100644 .project

diff --git a/.project b/.project
deleted file mode 100644
index b20935afd..000000000
--- a/.project
+++ /dev/null
@@ -1,42 +0,0 @@
-
-
-	ESAPI_2.0
-	The Enterprise Security API project is an OWASP project
-		to create simple strong security controls for every web platform.
-		Security controls are not simple to build. You can read about the
-		hundreds of pitfalls for unwary developers on the OWASP website. By
-		providing developers with a set of strong controls, we aim to
-		eliminate some of the complexity of creating secure web applications.
-		This can result in significant cost savings across the SDLC.
-	
-	
-	
-		
-			org.eclipse.wst.common.project.facet.core.builder
-			
-			
-		
-		
-			org.eclipse.jdt.core.javabuilder
-			
-			
-		
-		
-			org.eclipse.wst.validation.validationbuilder
-			
-			
-		
-		
-			org.maven.ide.eclipse.maven2Builder
-			
-			
-		
-	
-	
-		org.maven.ide.eclipse.maven2Nature
-		org.eclipse.jem.workbench.JavaEMFNature
-		org.eclipse.wst.common.modulecore.ModuleCoreNature
-		org.eclipse.jdt.core.javanature
-		org.eclipse.wst.common.project.facet.core.nature
-	
-

From 520e167a1d0cffbbdd923026e456b60ad54cd2d0 Mon Sep 17 00:00:00 2001
From: kwwall 
Date: Tue, 19 Jan 2016 22:38:23 -0500
Subject: [PATCH 349/812] Add *.swp and *~ to the ignore list. The former are
 vim temp files, and the latter are its backups (if so-enabled).

---
 .gitignore | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/.gitignore b/.gitignore
index 0f6484a23..cc8990967 100644
--- a/.gitignore
+++ b/.gitignore
@@ -2,3 +2,5 @@
 /.settings/**
 .classpath
 .project
+*.swp
+*~

From 4d2b101637a137285bcd39f99335ab184926e5ed Mon Sep 17 00:00:00 2001
From: Anthony Musyoki 
Date: Wed, 20 Jan 2016 11:47:07 +0300
Subject: [PATCH 350/812] Fix issue 355 by adding a call to
 file.deleteOnExit().

---
 .../esapi/waf/internal/InterceptingServletOutputStream.java  | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/src/main/java/org/owasp/esapi/waf/internal/InterceptingServletOutputStream.java b/src/main/java/org/owasp/esapi/waf/internal/InterceptingServletOutputStream.java
index 693c11112..cad2efe92 100644
--- a/src/main/java/org/owasp/esapi/waf/internal/InterceptingServletOutputStream.java
+++ b/src/main/java/org/owasp/esapi/waf/internal/InterceptingServletOutputStream.java
@@ -56,7 +56,10 @@ public InterceptingServletOutputStream(ServletOutputStream os, boolean buffered)
 		 * the prefix and suffix small for less processing. The "oew" is intended
 		 * to stand for "OWASP ESAPI WAF" and the "hop" for HTTP output.
 		 */
-		this.out = new RandomAccessFile ( File.createTempFile("oew", ".hop"), "rw" ); 
+		File tempFile= File.createTempFile("oew", ".hop");
+		this.out = new RandomAccessFile (tempFile, "rw" ); 
+		tempFile.deleteOnExit();
+		
 	}
 
 	public void reset() throws IOException {

From 56dae769091157755d0a8c0992e2c5d17bb8e6f8 Mon Sep 17 00:00:00 2001
From: Matt Seil 
Date: Wed, 20 Jan 2016 17:59:15 -0600
Subject: [PATCH 351/812] Applied fixes to unit test and upgraded junit to
 4.12.

---
 pom.xml                                       |   2 +-
 .../esapi/reference/AuthenticatorTest.java    | 208 ++++++++++--------
 2 files changed, 116 insertions(+), 94 deletions(-)

diff --git a/pom.xml b/pom.xml
index dea265185..4459f4b90 100644
--- a/pom.xml
+++ b/pom.xml
@@ -132,7 +132,7 @@
         
             junit
             junit
-            4.5
+            4.12
             test
         
         
diff --git a/src/test/java/org/owasp/esapi/reference/AuthenticatorTest.java b/src/test/java/org/owasp/esapi/reference/AuthenticatorTest.java
index e6a660f4b..1603689c7 100644
--- a/src/test/java/org/owasp/esapi/reference/AuthenticatorTest.java
+++ b/src/test/java/org/owasp/esapi/reference/AuthenticatorTest.java
@@ -15,13 +15,32 @@
  */
 package org.owasp.esapi.reference;
 
+import static org.junit.Assert.assertEquals;
+import static org.junit.Assert.assertFalse;
+import static org.junit.Assert.assertNotNull;
+import static org.junit.Assert.assertNull;
+import static org.junit.Assert.assertSame;
+import static org.junit.Assert.assertTrue;
+import static org.junit.Assert.fail;
+import static org.junit.Assume.assumeTrue;
+
 import java.util.Date;
 import java.util.Set;
+import java.util.concurrent.CountDownLatch;
+import java.util.concurrent.Semaphore;
+import java.util.concurrent.TimeUnit;
 
-import junit.framework.Test;
-import junit.framework.TestCase;
-import junit.framework.TestSuite;
+import javax.servlet.http.HttpServletRequest;
+import javax.servlet.http.HttpServletResponse;
 
+import org.junit.After;
+import org.junit.Before;
+import org.junit.BeforeClass;
+import org.junit.Rule;
+import org.junit.Test;
+import org.junit.rules.ErrorCollector;
+import org.junit.rules.TestName;
+import org.junit.rules.Timeout;
 import org.owasp.esapi.Authenticator;
 import org.owasp.esapi.ESAPI;
 import org.owasp.esapi.EncoderConstants;
@@ -38,47 +57,49 @@
  * 
  * @author Jeff Williams (jeff.williams@aspectsecurity.com)
  */
-public class AuthenticatorTest extends TestCase {
-
-
-	/**
-	 * Suite.
-	 * 
-	 * @return the test
-	 */
-	public static Test suite() {
-		TestSuite suite = new TestSuite(AuthenticatorTest.class);
+public class AuthenticatorTest {
+    private static Authenticator instance;
+    /** 
+     * User session information is stored on a per-thread basis.  So long as this has potential to run single threaded then we'll maintain a synchronous nature execution.
+     * This is done to prevent tests corrupting each others states since all will be executed on a limited set of Threads within the JVM.
+     */
+    private static Semaphore threadIsolation = new Semaphore(1, true);
 
-		return suite;
-	}
+    @Rule
+    public ErrorCollector collector = new ErrorCollector();
+    @Rule
+    public Timeout testTimout = new Timeout(10, TimeUnit.SECONDS);
+    @Rule
+    public TestName name = new TestName();
 
-	/**
-	 * Instantiates a new authenticator test.
-	 * 
-	 * @param testName
-	 *            the test name
-	 */
-	public AuthenticatorTest(String testName) {
-		super(testName);
-	}
+    @BeforeClass
+    public static void setUpStatic() {
+        instance = ESAPI.authenticator();
+    }
 
-    /**
-     * {@inheritDoc}
-     *
-     * @throws Exception
-     */
-	protected void setUp() throws Exception {
-		// none
-	}
+    @Before
+    public void setup() throws InterruptedException {
+        while (!threadIsolation.tryAcquire(500, TimeUnit.MILLISECONDS)) {
+            //Spurious Interrupt Guard
+        }       
+    }
 
-    /**
-     * {@inheritDoc}
-     *
-     * @throws Exception
-     */
-	protected void tearDown() throws Exception {
-		// none
-	}
+    @After
+    public void cleanup() {
+        try {
+            instance.logout();
+            instance.clearCurrent();
+            HttpServletRequest request = ESAPI.httpUtilities().getCurrentRequest();
+            HttpServletResponse response = ESAPI.httpUtilities().getCurrentResponse();
+            if (request != null  && response != null) {
+                //I don't know why killAllCookies doesn't nullcheck state.  I'm assuming this is unique to the test environment.
+                ESAPI.httpUtilities().killAllCookies();
+            }
+            ESAPI.httpUtilities().clearCurrent();
+        } finally {
+            threadIsolation.release();
+        }
+    }
 
 	
 	/**
@@ -88,10 +109,9 @@ protected void tearDown() throws Exception {
      *             the authentication exception
      * @throws EncryptionException
 	 */
-	public void testCreateUser() throws AuthenticationException, EncryptionException {
+	@Test public void testCreateUser() throws AuthenticationException, EncryptionException {
 		System.out.println("createUser");
 		String accountName = ESAPI.randomizer().getRandomString(8, EncoderConstants.CHAR_ALPHANUMERICS);
-		Authenticator instance = ESAPI.authenticator();
 		String password = instance.generateStrongPassword();
 		User user = instance.createUser(accountName, password, password);
 		assertTrue(user.verifyPassword(password));
@@ -141,9 +161,8 @@ public void testCreateUser() throws AuthenticationException, EncryptionException
 	 * @throws AuthenticationException
 	 *             the authentication exception
 	 */
-	public void testGenerateStrongPassword() throws AuthenticationException {
+	@Test public void testGenerateStrongPassword() throws AuthenticationException {
 		System.out.println("generateStrongPassword");		
-		Authenticator instance = ESAPI.authenticator();
 		String oldPassword = "iiiiiiiiii";  // i is not allowed in passwords - this prevents failures from containing pieces of old password
 		String newPassword = null;
 		String username = "FictionalEsapiUser";
@@ -171,9 +190,8 @@ public void testGenerateStrongPassword() throws AuthenticationException {
      *
      * @throws Exception
      */
-	public void testGetCurrentUser() throws Exception {
+	@Test public void testGetCurrentUser() throws Exception {
 		System.out.println("getCurrentUser");
-        Authenticator instance = ESAPI.authenticator();
 		String username1 = ESAPI.randomizer().getRandomString(8, EncoderConstants.CHAR_ALPHANUMERICS);
 		String username2 = ESAPI.randomizer().getRandomString(8, EncoderConstants.CHAR_ALPHANUMERICS);
 		User user1 = instance.createUser(username1, "getCurrentUser", "getCurrentUser");
@@ -192,21 +210,21 @@ public void testGetCurrentUser() throws Exception {
 			private int count = 1;
             private boolean result = false;
 			public void run() {
-		        Authenticator auth = ESAPI.authenticator();
 				User a = null;
 				try {
-					String password = auth.generateStrongPassword();
+					String password = instance.generateStrongPassword();
 					String accountName = "TestAccount" + count++;
-					a = auth.getUser(accountName);
+					a = instance.getUser(accountName);
 					if ( a != null ) {
-						auth.removeUser(accountName);
+					    instance.removeUser(accountName);
 					}
-					a = auth.createUser(accountName, password, password);
-					auth.setCurrentUser(a);
+					a = instance.createUser(accountName, password, password);
+					instance.setCurrentUser(a);
 				} catch (AuthenticationException e) {
-					e.printStackTrace();
+				    //Use ErrorCollector to fail test.
+                    collector.addError(e);
 				}
-				User b = auth.getCurrentUser();
+				User b = instance.getCurrentUser();
 				result &= a.equals(b);
 			}
 		};
@@ -225,9 +243,8 @@ public void run() {
 	 * @throws AuthenticationException
 	 *             the authentication exception
 	 */
-	public void testGetUser() throws AuthenticationException {
+	@Test public void testGetUser() throws AuthenticationException {
 		System.out.println("getUser");
-        Authenticator instance = ESAPI.authenticator();
 		String password = instance.generateStrongPassword();
 		String accountName=ESAPI.randomizer().getRandomString(8, EncoderConstants.CHAR_ALPHANUMERICS);
 		instance.createUser(accountName, password, password);
@@ -239,10 +256,8 @@ public void testGetUser() throws AuthenticationException {
      *
      * @throws org.owasp.esapi.errors.AuthenticationException
      */
-    public void testGetUserFromRememberToken() throws AuthenticationException {
+    @Test public void testGetUserFromRememberToken() throws AuthenticationException {
 		System.out.println("getUserFromRememberToken");
-        Authenticator instance = ESAPI.authenticator();
-        instance.logout();  // in case anyone is logged in
 		String password = instance.generateStrongPassword();
 		String accountName=ESAPI.randomizer().getRandomString(8, EncoderConstants.CHAR_ALPHANUMERICS);
 		User user = instance.createUser(accountName, password, password);
@@ -255,6 +270,7 @@ public void testGetUserFromRememberToken() throws AuthenticationException {
 		request.setCookie( HTTPUtilities.REMEMBER_TOKEN_COOKIE_NAME, "ridiculous" );
 		try {
 			instance.login( request, response );  // wrong cookie will fail
+			fail();
 		} catch( AuthenticationException e ) {
 			// expected
 		}
@@ -278,10 +294,9 @@ public void testGetUserFromRememberToken() throws AuthenticationException {
 	 * @throws AuthenticationException
 	 *             the authentication exception
 	 */
-	public void testGetUserFromSession() throws AuthenticationException {
+	@Test public void testGetUserFromSession() throws AuthenticationException {
 		System.out.println("getUserFromSession");
-        FileBasedAuthenticator instance = (FileBasedAuthenticator)ESAPI.authenticator();
-        instance.logout();  // in case anyone is logged in
+		assumeTrue(instance instanceof FileBasedAuthenticator);
 		String accountName=ESAPI.randomizer().getRandomString(8, EncoderConstants.CHAR_ALPHANUMERICS);
 		String password = instance.generateStrongPassword();
 		User user = instance.createUser(accountName, password, password);
@@ -292,7 +307,7 @@ public void testGetUserFromSession() throws AuthenticationException {
 		MockHttpServletResponse response = new MockHttpServletResponse();
 		ESAPI.httpUtilities().setCurrentHTTP( request, response );
 		instance.login( request, response);
-		User test = instance.getUserFromSession();
+		User test = ((FileBasedAuthenticator)instance).getUserFromSession();
 		assertEquals( user, test );
 	}
 
@@ -302,9 +317,8 @@ public void testGetUserFromSession() throws AuthenticationException {
 	 * @throws AuthenticationException
 	 *             the authentication exception
 	 */
-	public void testGetUserNames() throws AuthenticationException {
+	@Test public void testGetUserNames() throws AuthenticationException {
 		System.out.println("getUserNames");
-        Authenticator instance = ESAPI.authenticator();
 		String password = instance.generateStrongPassword();
 		String[] testnames = new String[10];
 		for(int i=0;i
Date: Thu, 21 Jan 2016 16:03:34 -0600
Subject: [PATCH 352/812] Added missing call (?) to HttpUtilitiesTest to set
 the current request.  Refactored AbstractAuthenticator to make the method
 call transactional.

---
 .../reference/AbstractAuthenticator.java      |  4 +-
 .../esapi/reference/HTTPUtilitiesTest.java    | 37 +++++++++++++------
 2 files changed, 29 insertions(+), 12 deletions(-)

diff --git a/src/main/java/org/owasp/esapi/reference/AbstractAuthenticator.java b/src/main/java/org/owasp/esapi/reference/AbstractAuthenticator.java
index 780181971..d7de99f04 100644
--- a/src/main/java/org/owasp/esapi/reference/AbstractAuthenticator.java
+++ b/src/main/java/org/owasp/esapi/reference/AbstractAuthenticator.java
@@ -96,7 +96,9 @@ public User getCurrentUser() {
      * @return the user from session or null if no user is found in the session
      */
     protected User getUserFromSession() {
-        HttpSession session = ESAPI.httpUtilities().getCurrentRequest().getSession(false);
+    	HTTPUtilities httpUtils = ESAPI.httpUtilities();
+    	HttpServletRequest req = httpUtils.getCurrentRequest();
+        HttpSession session = req.getSession(false);
         if (session == null) return null;
         return ESAPI.httpUtilities().getSessionAttribute(USER);
     }
diff --git a/src/test/java/org/owasp/esapi/reference/HTTPUtilitiesTest.java b/src/test/java/org/owasp/esapi/reference/HTTPUtilitiesTest.java
index d86f98ba4..5dadd5ce3 100644
--- a/src/test/java/org/owasp/esapi/reference/HTTPUtilitiesTest.java
+++ b/src/test/java/org/owasp/esapi/reference/HTTPUtilitiesTest.java
@@ -15,24 +15,38 @@
  */
 package org.owasp.esapi.reference;
 
-import junit.framework.Test;
-import junit.framework.TestCase;
-import junit.framework.TestSuite;
-import org.owasp.esapi.*;
+import java.io.File;
+import java.io.IOException;
+import java.util.ArrayList;
+import java.util.HashMap;
+import java.util.Iterator;
+import java.util.List;
+import java.util.Map;
+
+import javax.servlet.http.Cookie;
+import javax.servlet.http.HttpServletRequest;
+import javax.servlet.http.HttpSession;
+
+import org.owasp.esapi.Authenticator;
+import org.owasp.esapi.ESAPI;
+import org.owasp.esapi.EncoderConstants;
+import org.owasp.esapi.HTTPUtilities;
+import org.owasp.esapi.User;
 import org.owasp.esapi.codecs.Hex;
 import org.owasp.esapi.crypto.CipherText;
-import org.owasp.esapi.errors.*;
+import org.owasp.esapi.errors.AccessControlException;
+import org.owasp.esapi.errors.AuthenticationException;
+import org.owasp.esapi.errors.EncryptionException;
+import org.owasp.esapi.errors.EnterpriseSecurityException;
+import org.owasp.esapi.errors.ValidationException;
 import org.owasp.esapi.http.MockHttpServletRequest;
 import org.owasp.esapi.http.MockHttpServletResponse;
 import org.owasp.esapi.http.MockHttpSession;
 import org.owasp.esapi.util.FileTestUtils;
 
-import javax.servlet.http.Cookie;
-import javax.servlet.http.HttpServletRequest;
-import javax.servlet.http.HttpSession;
-import java.io.File;
-import java.io.IOException;
-import java.util.*;
+import junit.framework.Test;
+import junit.framework.TestCase;
+import junit.framework.TestSuite;
 
 /**
  * The Class HTTPUtilitiesTest.
@@ -462,6 +476,7 @@ public void testSetRememberToken() throws AuthenticationException {
 		request.addParameter("username", accountName);
 		request.addParameter("password", password);
 		MockHttpServletResponse response = new MockHttpServletResponse();
+		ESAPI.httpUtilities().setCurrentHTTP(request, response);
 		instance.login( request, response);
 
 		int maxAge = ( 60 * 60 * 24 * 14 );

From 2dfd89195cb7f4c3a81ec939db93dda6a5a4086d Mon Sep 17 00:00:00 2001
From: kwwall 
Date: Thu, 21 Jan 2016 22:55:35 -0500
Subject: [PATCH 353/812] Ignore *.iml files which are config files from
 InteliJ IDE.

---
 .gitignore | 1 +
 1 file changed, 1 insertion(+)

diff --git a/.gitignore b/.gitignore
index cc8990967..65ac7f40a 100644
--- a/.gitignore
+++ b/.gitignore
@@ -4,3 +4,4 @@
 .project
 *.swp
 *~
+*.iml

From 7d3b4f3e83185254142068faff5bcdb7396bde74 Mon Sep 17 00:00:00 2001
From: "Kevin W. Wall" 
Date: Thu, 21 Jan 2016 22:58:18 -0500
Subject: [PATCH 354/812] Delete esapi.iml

This is a config file from InteliJ IDE and does not belong with the ESAPI repo. We did the same for the Eclipse config files.
---
 esapi.iml | 48 ------------------------------------------------
 1 file changed, 48 deletions(-)
 delete mode 100644 esapi.iml

diff --git a/esapi.iml b/esapi.iml
deleted file mode 100644
index 5729ef276..000000000
--- a/esapi.iml
+++ /dev/null
@@ -1,48 +0,0 @@
-
-
-  
-    
-    
-    
-      
-      
-      
-      
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-    
-  
-
-

From 49dfc9c9816d468a7b7a94c0d43e1bb2e6d4227a Mon Sep 17 00:00:00 2001
From: kwwall 
Date: Thu, 21 Jan 2016 23:43:18 -0500
Subject: [PATCH 355/812] Change version from 2.1.1-SNAPSHOT to
 2.1.0.1-SNAPSHOT

---
 pom.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pom.xml b/pom.xml
index 4459f4b90..2f41f7705 100644
--- a/pom.xml
+++ b/pom.xml
@@ -3,7 +3,7 @@
     4.0.0
     org.owasp.esapi
     esapi
-    2.1.1-SNAPSHOT
+    2.1.0.1-SNAPSHOT
     jar
 
     

From d5306d69bf881f44e45490285812500dd99159ca Mon Sep 17 00:00:00 2001
From: Matt Seil 
Date: Sun, 24 Jan 2016 11:37:31 -0600
Subject: [PATCH 356/812] Changed the RandomizerTest failure into a System.err
 report for randomness counts.  JUnit has no equivalent for "WARN".

---
 .../java/org/owasp/esapi/reference/RandomizerTest.java     | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/src/test/java/org/owasp/esapi/reference/RandomizerTest.java b/src/test/java/org/owasp/esapi/reference/RandomizerTest.java
index 32ce1cb0e..b73a0241d 100644
--- a/src/test/java/org/owasp/esapi/reference/RandomizerTest.java
+++ b/src/test/java/org/owasp/esapi/reference/RandomizerTest.java
@@ -97,7 +97,12 @@ public void testGetRandomString() {
         	if ( counts[i] > max ) { max = counts[i]; } 
         	if ( counts[i] > 0 && counts[i] < min ) { min = counts[i]; }
         	if ( max - min > trials/10 ) {
-        		fail( "getRandomString randomness counts are off" );
+        		System.err.println("*** WARNING: RandomizerTest.testGetRandomString(): " +
+                        "Randomness counts are off. This may be simply from " +
+                        "statistical variance or it could signify a flaw in " +
+                        "Randomizer.getRandomString(). Repeat this test " +
+                        "multiple times and if you get repeated warnings " +
+                        "you should assume the latter and investigate further.");
         	}
         }
     }

From 6438ad007b202c563ceda080429ea77a66d5d6ed Mon Sep 17 00:00:00 2001
From: kwwall 
Date: Sat, 30 Jan 2016 23:38:45 -0500
Subject: [PATCH 357/812] Change Google Code references to GitHub.

---
 pom.xml | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/pom.xml b/pom.xml
index 2f41f7705..f867c9b1a 100644
--- a/pom.xml
+++ b/pom.xml
@@ -30,7 +30,7 @@
     
 
     ESAPI
-    http://www.esapi.org/
+    https://www.owasp.org/index.php/Category:OWASP_Enterprise_Security_API
     The Enterprise Security API (ESAPI) project is an OWASP project
         to create simple strong security controls for every web platform.
         Security controls are not simple to build. You can read about the
@@ -70,14 +70,14 @@
     
 
     
-        scm:svn:http://owasp-esapi-java.googlecode.com/svn/trunk
-        scm:svn:https://owasp-esapi-java.googlecode.com/svn/trunk
-        http://code.google.com/p/owasp-esapi-java/source/checkout
+        scm:git:git://github.com/ESAPI/esapi-java-legacy.git
+        scm:git:git@github.com:ESAPI/esapi-java-legacy.git
+        https://github.com/ESAPI/esapi-java-legacy
     
 
     
-        Google Code Issue Tracking
-        http://code.google.com/p/owasp-esapi-java/issues/list
+        GitHub Issue Tracking
+        https://github.com/ESAPI/esapi-java-legacy/issues
     
 
     
@@ -92,14 +92,14 @@
             Chris Schmidt
             Aspect Security
             
-                Project Owner
+                Project Co-owner
             
         
         
             Kevin W. Wall
             Wells Fargo
             
-                Project Manager
+                Project Co-owner
             
         
     

From b7cbc53f9cc967cf1a5a9463d8c6fef9ed6ef4f7 Mon Sep 17 00:00:00 2001
From: kwwall 
Date: Sun, 31 Jan 2016 01:56:59 -0500
Subject: [PATCH 358/812] Close #306. Close #359

---
 .../org/owasp/esapi/codecs/PercentCodec.java  |  12 +-
 .../owasp/esapi/codecs/CodecImmunityTest.java | 138 ++++++++++++++++++
 2 files changed, 149 insertions(+), 1 deletion(-)
 create mode 100644 src/test/java/org/owasp/esapi/codecs/CodecImmunityTest.java

diff --git a/src/main/java/org/owasp/esapi/codecs/PercentCodec.java b/src/main/java/org/owasp/esapi/codecs/PercentCodec.java
index 3d1e76a86..42e1d040e 100644
--- a/src/main/java/org/owasp/esapi/codecs/PercentCodec.java
+++ b/src/main/java/org/owasp/esapi/codecs/PercentCodec.java
@@ -89,7 +89,12 @@ private static StringBuilder appendTwoUpperHex(StringBuilder sb, int b)
 
 	/**
 	 * Encode a character for URLs
-	 * @param immune characters not to encode
+	 * @param immune Additional characters not to encode. Note this could
+     *               break URL encoding as referenced in RFC 3986. You should
+     *               especially be wary of including '%' in this list of immune
+     *               characters since it is used as the "escape" character for
+     *               the hex encoding and including it may result in subsequent
+     *               and/or dangerous results when decoding.
 	 * @param c character to encode
 	 * @return the encoded string representing c
 	 */
@@ -99,6 +104,11 @@ public String encodeCharacter( char[] immune, Character c )
 		byte[] bytes;
 		StringBuilder sb;
 
+        // check for user specified immune characters
+        if ( immune != null && containsCharacter( c.charValue(), immune ) )
+            return cStr;
+
+        // check for standard characters (e.g., alphanumeric, etc.)
 		if(UNENCODED_SET.contains(c))
 			return cStr;
 
diff --git a/src/test/java/org/owasp/esapi/codecs/CodecImmunityTest.java b/src/test/java/org/owasp/esapi/codecs/CodecImmunityTest.java
new file mode 100644
index 000000000..7d35dc168
--- /dev/null
+++ b/src/test/java/org/owasp/esapi/codecs/CodecImmunityTest.java
@@ -0,0 +1,138 @@
+package org.owasp.esapi.codecs;
+
+import java.util.ArrayList;
+import java.util.Arrays;
+import java.util.Collection;
+import java.util.List;
+
+import org.junit.Assert;
+import org.junit.Test;
+import org.junit.runner.RunWith;
+import org.junit.runners.Parameterized;
+import org.junit.runners.Parameterized.Parameters;
+import org.owasp.esapi.EncoderConstants;
+import org.owasp.esapi.StringUtilities;
+import org.owasp.esapi.codecs.*;
+
+/**
+ * Parameterized test to verify that the Immunity parameter for a codec
+ * encode/decode event works as expected on a series of special characters.
+ *  
+ * @author jeremiah.j.stacey@gmail.com
+ * @since 2.1.0.1
+ *
+ */
+@RunWith(Parameterized.class)
+public class CodecImmunityTest {
+    /** character arrays used as immunity lists from Default Encoder.*/
+    private final static char[] IMMUNE_HTML = { ',', '.', '-', '_', ' ' };
+    private final static char[] IMMUNE_HTMLATTR = { ',', '.', '-', '_' };
+    private final static char[] IMMUNE_CSS = {};
+    private final static char[] IMMUNE_JAVASCRIPT = { ',', '.', '_' };
+    private final static char[] IMMUNE_VBSCRIPT = { ',', '.', '_' };
+    private final static char[] IMMUNE_XML = { ',', '.', '-', '_', ' ' };
+    private final static char[] IMMUNE_SQL = { ' ' };
+    private final static char[] IMMUNE_OS = { '-' };
+    private final static char[] IMMUNE_XMLATTR = { ',', '.', '-', '_' };
+    private final static char[] IMMUNE_XPATH = { ',', '.', '-', '_', ' ' };
+    private final static char[] IMMUNE_PERCENT = { '%' };
+    // These are inline in the encode methods, but same principle.
+    // private final static char[] IMMUNE_LDAP = { '\\', '*', '(', ')', '\0' };
+    // private final static char[] IMMUNE_DN = { '\\', ',', '+', '"', '<', '>', ';' };
+
+
+    @Parameters(name = "{0}")
+    public static Collection getParams() {
+        Collection knownCodecs = new ArrayList();
+        knownCodecs.add(new CSSCodec());
+        knownCodecs.add(new DB2Codec());
+        knownCodecs.add(new HTMLEntityCodec());
+        knownCodecs.add(new JavaScriptCodec());
+        knownCodecs.add(new MySQLCodec(0)); //Standard
+        knownCodecs.add(new MySQLCodec(1)); //ANSI
+        knownCodecs.add(new OracleCodec());
+        knownCodecs.add(new PercentCodec());
+        knownCodecs.add(new UnixCodec());
+        knownCodecs.add(new VBScriptCodec());
+        knownCodecs.add(new WindowsCodec());
+        knownCodecs.add(new XMLEntityCodec());
+
+        // TODO:  Add more strings here!!
+        List sampleStrings = Arrays.asList("%De");
+
+        Collection params = new ArrayList();
+        for (Codec codec : knownCodecs) {
+            for (String sample : sampleStrings) {
+                params.add(new Object[]{codec.getClass().getSimpleName() + " " + sample, codec, sample});
+            }
+        }
+
+        // Add Tests for codecs against the configured ImmunityLists within the Default Encoder.
+        params.addAll(buildImmunitiyValidation(new HTMLEntityCodec(), IMMUNE_HTML, "IMMUNE_HTML"));
+        params.addAll(buildImmunitiyValidation(new HTMLEntityCodec(), IMMUNE_XPATH, "IMMUNE_XPATH"));
+        params.addAll(buildImmunitiyValidation(new HTMLEntityCodec(), IMMUNE_HTMLATTR, "IMMUNE_HTMLATTR"));
+        params.addAll(buildImmunitiyValidation(new CSSCodec(), IMMUNE_CSS, "IMMUNE_CSS"));
+        //params.addAll(buildImmunitiyValidation(new DB2Codec(), IMMUNE_HTML, ""));
+        params.addAll(buildImmunitiyValidation(new JavaScriptCodec(), IMMUNE_JAVASCRIPT, "IMMUNE_JAVASCRIPT"));
+        params.addAll(buildImmunitiyValidation(new MySQLCodec(0), IMMUNE_SQL, "IMMUNE_SQL"));
+        params.addAll(buildImmunitiyValidation(new MySQLCodec(1), IMMUNE_SQL, "IMMUNE_SQL"));
+        params.addAll(buildImmunitiyValidation(new OracleCodec(), IMMUNE_HTML, "IMMUNE_HTML"));
+            // No standard Immunity char array defined for PercentEncoder, but for
+            // GitHub issues #306 and $350, we use '%'.
+        params.addAll(buildImmunitiyValidation(new PercentCodec(), IMMUNE_PERCENT, "IMMUNE_PERCENT"));
+        params.addAll(buildImmunitiyValidation(new UnixCodec(), IMMUNE_OS, "IMMUNE_OS"));
+        params.addAll(buildImmunitiyValidation(new VBScriptCodec(), IMMUNE_VBSCRIPT, "IMMUNE_VBSCRIPT"));
+        params.addAll(buildImmunitiyValidation(new WindowsCodec(), IMMUNE_OS, "IMMUNE_OS"));
+        params.addAll(buildImmunitiyValidation(new XMLEntityCodec(), IMMUNE_XML, "IMMUNE_XML"));
+        params.addAll(buildImmunitiyValidation(new XMLEntityCodec(), IMMUNE_XMLATTR, "IMMUNE_XMLATTR"));
+
+        params.addAll(fullCharacterCodecValidation(knownCodecs));
+
+        return params;
+    }
+
+    private static Collection buildImmunitiyValidation(Codec codec, char[] immunities, String descriptor) {
+        Collection params = new ArrayList();
+        for (char c : immunities) {
+            params.add(new Object[]{codec.getClass().getSimpleName() + " " + descriptor + " ("+ c + ")", codec, String.valueOf(c)});
+        }
+        return params;
+    }
+
+    private static Collection fullCharacterCodecValidation(Collection codecs) {
+        char[] holyCowTesting = StringUtilities.union(EncoderConstants.CHAR_ALPHANUMERICS, EncoderConstants.CHAR_SPECIALS); 
+        Collection params = new ArrayList();
+        for (Codec codec: codecs) {
+            params.addAll(buildImmunitiyValidation(codec, holyCowTesting, "Full_ALPHA_AND_SPECIALS"));
+        }
+
+        return params;
+    }
+
+    private final Codec codec;
+    private final String string;
+    private final char[] immunityList;
+
+    public CodecImmunityTest(String ignored, Codec codec, String toTest) {
+        this.codec = codec;
+        this.string = toTest;
+        /**
+         * The Immunity character array is every character in the String we're testing.
+         * 
+         */
+        this.immunityList = toTest.toCharArray();
+    }
+
+    @Test
+    public void testImmuneEncode() {
+        String encoded = codec.encode(immunityList, string);
+        Assert.assertEquals(string, encoded);
+    }
+    /*
+    @Test
+    public void testImmuneDecode() {
+        String decoded = codec.decode(string);
+        Assert.assertEquals(string, decoded);
+    }
+*/
+}

From 436549341d14f34538cbff4232d8f349803bb19e Mon Sep 17 00:00:00 2001
From: kwwall 
Date: Sun, 31 Jan 2016 13:38:06 -0500
Subject: [PATCH 359/812] Close #261.

---
 .../java/org/owasp/esapi/filters/SecurityWrapperResponse.java   | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/main/java/org/owasp/esapi/filters/SecurityWrapperResponse.java b/src/main/java/org/owasp/esapi/filters/SecurityWrapperResponse.java
index a57e743f5..9dd0632ce 100644
--- a/src/main/java/org/owasp/esapi/filters/SecurityWrapperResponse.java
+++ b/src/main/java/org/owasp/esapi/filters/SecurityWrapperResponse.java
@@ -172,7 +172,7 @@ public void addHeader(String name, String value) {
             String strippedValue = StringUtilities.stripControls(value);
             String safeName = ESAPI.validator().getValidInput("addHeader", strippedName, "HTTPHeaderName", 20, false);
             String safeValue = ESAPI.validator().getValidInput("addHeader", strippedValue, "HTTPHeaderValue", ESAPI.securityConfiguration().getMaxHttpHeaderSize(), false);
-            getHttpServletResponse().setHeader(safeName, safeValue);
+            getHttpServletResponse().addHeader(safeName, safeValue);
         } catch (ValidationException e) {
             logger.warning(Logger.SECURITY_FAILURE, "Attempt to add invalid header denied", e);
         }

From fb711682e97da692599c6f0769dfc7cfdbc16e87 Mon Sep 17 00:00:00 2001
From: kwwall 
Date: Sun, 31 Jan 2016 18:47:00 -0500
Subject: [PATCH 360/812] Close issue #288.

---
 src/test/java/org/owasp/esapi/reference/UserTest.java | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/src/test/java/org/owasp/esapi/reference/UserTest.java b/src/test/java/org/owasp/esapi/reference/UserTest.java
index 27e5b617c..e2cf8aa6a 100644
--- a/src/test/java/org/owasp/esapi/reference/UserTest.java
+++ b/src/test/java/org/owasp/esapi/reference/UserTest.java
@@ -163,6 +163,13 @@ public void testChangePassword() throws Exception {
 		} catch( AuthenticationException e ) {
 			// expected
 		}
+		try {
+			// Test for GitHub issue 288
+			user.changePassword(password2, oldPassword, oldPassword);
+			fail("Shouldn't be able to reuse original (initial) password.")
+		} catch( AuthenticationException e ) {
+			// expected
+		}
 		assertTrue(user.verifyPassword(password2));
 		assertFalse(user.verifyPassword("badpass"));
 	}

From f6d7a61e1dda3b18bbf4f7ed748e4747412f9acb Mon Sep 17 00:00:00 2001
From: kwwall 
Date: Sun, 31 Jan 2016 18:51:45 -0500
Subject: [PATCH 361/812] Close issue #288.

---
 src/test/java/org/owasp/esapi/reference/UserTest.java | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/test/java/org/owasp/esapi/reference/UserTest.java b/src/test/java/org/owasp/esapi/reference/UserTest.java
index e2cf8aa6a..3bad13287 100644
--- a/src/test/java/org/owasp/esapi/reference/UserTest.java
+++ b/src/test/java/org/owasp/esapi/reference/UserTest.java
@@ -166,7 +166,7 @@ public void testChangePassword() throws Exception {
 		try {
 			// Test for GitHub issue 288
 			user.changePassword(password2, oldPassword, oldPassword);
-			fail("Shouldn't be able to reuse original (initial) password.")
+			fail("Shouldn't be able to reuse original (initial) password.");
 		} catch( AuthenticationException e ) {
 			// expected
 		}

From 7943011198b980d323c436b36bf9e965c5271d6c Mon Sep 17 00:00:00 2001
From: kwwall 
Date: Sun, 31 Jan 2016 19:12:55 -0500
Subject: [PATCH 362/812] Comment out previously proposed test changes. See
 comments in GitHub issue history for reason.

---
 .../java/org/owasp/esapi/reference/UserTest.java  | 15 ++++++++-------
 1 file changed, 8 insertions(+), 7 deletions(-)

diff --git a/src/test/java/org/owasp/esapi/reference/UserTest.java b/src/test/java/org/owasp/esapi/reference/UserTest.java
index 3bad13287..201383c38 100644
--- a/src/test/java/org/owasp/esapi/reference/UserTest.java
+++ b/src/test/java/org/owasp/esapi/reference/UserTest.java
@@ -163,13 +163,14 @@ public void testChangePassword() throws Exception {
 		} catch( AuthenticationException e ) {
 			// expected
 		}
-		try {
-			// Test for GitHub issue 288
-			user.changePassword(password2, oldPassword, oldPassword);
-			fail("Shouldn't be able to reuse original (initial) password.");
-		} catch( AuthenticationException e ) {
-			// expected
-		}
+        // Invalid test until we implement an actual password history!
+		// try {
+		// 	// Test for GitHub issue 288
+		// 	user.changePassword(password2, oldPassword, oldPassword);
+		// 	fail("Shouldn't be able to reuse original (initial) password.");
+		// } catch( AuthenticationException e ) {
+		//  // expected
+		// }
 		assertTrue(user.verifyPassword(password2));
 		assertFalse(user.verifyPassword("badpass"));
 	}

From 46a625ca24216c72830e6a8bf26a0441237ca593 Mon Sep 17 00:00:00 2001
From: kwwall 
Date: Sun, 31 Jan 2016 21:45:48 -0500
Subject: [PATCH 363/812] Close #287.

---
 .../org/owasp/esapi/reference/FileBasedAuthenticator.java   | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/src/main/java/org/owasp/esapi/reference/FileBasedAuthenticator.java b/src/main/java/org/owasp/esapi/reference/FileBasedAuthenticator.java
index 0077e6908..cee3685ad 100644
--- a/src/main/java/org/owasp/esapi/reference/FileBasedAuthenticator.java
+++ b/src/main/java/org/owasp/esapi/reference/FileBasedAuthenticator.java
@@ -161,12 +161,12 @@ String getHashedPassword(User user) {
      * Set the specified User's old password hashes.  This will not set the User's current password hash.
      *
      * @param user      the User whose old password hashes will be set
-     * @param oldHashes a list of the User's old password hashes     *
+     * @param oldHashes a list of the User's old password hashes
      */
     void setOldPasswordHashes(User user, List oldHashes) {
         List hashes = getAllHashedPasswords(user, true);
         if (hashes.size() > 1) {
-            hashes.removeAll(hashes.subList(1, hashes.size() - 1));
+            hashes.removeAll(hashes.subList(1, hashes.size()));
         }
         hashes.addAll(oldHashes);
     }
@@ -205,7 +205,7 @@ List getAllHashedPasswords(User user, boolean create) {
     List getOldPasswordHashes(User user) {
         List hashes = getAllHashedPasswords(user, false);
         if (hashes.size() > 1) {
-            return Collections.unmodifiableList(hashes.subList(1, hashes.size() - 1));
+            return Collections.unmodifiableList(hashes.subList(1, hashes.size()));
         }
         return Collections.emptyList();
     }

From f4ce180c9aab7103f9f1d6c90630267a3257025c Mon Sep 17 00:00:00 2001
From: kwwall 
Date: Sun, 31 Jan 2016 21:46:58 -0500
Subject: [PATCH 364/812] Close issue #288. No, really! This time I *mean* it.
 :)

---
 .../org/owasp/esapi/reference/UserTest.java     | 17 +++++++++--------
 1 file changed, 9 insertions(+), 8 deletions(-)

diff --git a/src/test/java/org/owasp/esapi/reference/UserTest.java b/src/test/java/org/owasp/esapi/reference/UserTest.java
index 201383c38..e091526ea 100644
--- a/src/test/java/org/owasp/esapi/reference/UserTest.java
+++ b/src/test/java/org/owasp/esapi/reference/UserTest.java
@@ -163,14 +163,15 @@ public void testChangePassword() throws Exception {
 		} catch( AuthenticationException e ) {
 			// expected
 		}
-        // Invalid test until we implement an actual password history!
-		// try {
-		// 	// Test for GitHub issue 288
-		// 	user.changePassword(password2, oldPassword, oldPassword);
-		// 	fail("Shouldn't be able to reuse original (initial) password.");
-		// } catch( AuthenticationException e ) {
-		//  // expected
-		// }
+		try {
+			// Test for GitHub issue 288; note that GitHub issue 287
+			// needed fixed first, because that's what made the password
+			// history work!
+			user.changePassword(password2, oldPassword, oldPassword);
+			fail("Shouldn't be able to reuse original (initial) password.");
+		} catch( AuthenticationException e ) {
+			// expected
+		}
 		assertTrue(user.verifyPassword(password2));
 		assertFalse(user.verifyPassword("badpass"));
 	}

From e9d0328a59cebd3e36972b965f7176fc3a135cf7 Mon Sep 17 00:00:00 2001
From: kwwall 
Date: Sun, 31 Jan 2016 22:27:40 -0500
Subject: [PATCH 365/812] Close issue #276.

---
 .../java/org/owasp/esapi/reference/DefaultExecutor.java     | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/src/main/java/org/owasp/esapi/reference/DefaultExecutor.java b/src/main/java/org/owasp/esapi/reference/DefaultExecutor.java
index f948ad8ca..eabb840cb 100644
--- a/src/main/java/org/owasp/esapi/reference/DefaultExecutor.java
+++ b/src/main/java/org/owasp/esapi/reference/DefaultExecutor.java
@@ -143,9 +143,9 @@ public ExecuteResult executeSystemCommand(File executable, List params, File wor
             pb.redirectErrorStream(redirectErrorStream);
 
             if ( logParams ) {
-            	logger.warning(Logger.SECURITY_SUCCESS, "Initiating executable: " + executable + " " + params + " in " + workdir);
+            	logger.debug(Logger.SECURITY_SUCCESS, "Initiating executable: " + executable + " " + params + " in " + workdir);
             } else {
-            	logger.warning(Logger.SECURITY_SUCCESS, "Initiating executable: " + executable + " [sensitive parameters obscured] in " + workdir);
+            	logger.debug(Logger.SECURITY_SUCCESS, "Initiating executable: " + executable + " [sensitive parameters obscured] in " + workdir);
             }
 
             final StringBuilder outputBuffer = new StringBuilder();
@@ -187,7 +187,7 @@ public ExecuteResult executeSystemCommand(File executable, List params, File wor
             	logger.warning( Logger.EVENT_FAILURE, "System command exited with non-zero status: " + exitValue );
             }
 
-            logger.warning(Logger.SECURITY_SUCCESS, "System command complete");
+            logger.debug(Logger.SECURITY_SUCCESS, "System command complete");
             return new ExecuteResult(exitValue, output, errors);
         } catch (IOException e) {
             throw new ExecutorException("Execution failure", "Exception thrown during execution of system command: " + e.getMessage(), e);

From 82b82e952c55dcaddf6f5fe1b0df907c7673e0c1 Mon Sep 17 00:00:00 2001
From: kwwall 
Date: Sun, 31 Jan 2016 22:54:46 -0500
Subject: [PATCH 366/812] Tentative 2.1.0.1 release notes.

---
 .../esapi4java-core-2.1.0.1-release-notes.txt | 126 ++++++++++++++++++
 1 file changed, 126 insertions(+)
 create mode 100644 documentation/esapi4java-core-2.1.0.1-release-notes.txt

diff --git a/documentation/esapi4java-core-2.1.0.1-release-notes.txt b/documentation/esapi4java-core-2.1.0.1-release-notes.txt
new file mode 100644
index 000000000..0820404d8
--- /dev/null
+++ b/documentation/esapi4java-core-2.1.0.1-release-notes.txt
@@ -0,0 +1,126 @@
+Release notes for ESAPI 2.1.0.1
+    Release date: 2016-Feb-??
+    -Kevin W. Wall 
+
+Previous release: ESAPI 2.1.0, Sept 2013
+
+
+-----------------------------------------------------------------------------
+                GitHub Issues fixed in this release:
+                          35 issues closed
+
+32 - URLs in doc for HTTPUtilities.setNoCacheHeaders are wrong
+58 - Separate Crypto Related Properties into Separate File
+     Fixed as part of issue #350. Can be addressed by placing sensitive
+     ESAPI crypto properties into a separate properties file controlled by
+     the operations team and not checked into your SCM. For further details,
+     see documentation/ESAPI-configuration-user-guide.md and use system property
+     org.owasp.esapi.opsteam.
+96 - Need validation configuration enhancements
+103 - Make ESAPI configuration XML
+200 - DefaultHttpUtilities.sendRedirect should throw AccessControlException, not IOException
+205 - BaseValidationRule.assertValid(String context, String input) causes NPE if input is not valid.
+221 - IntrusionException should extend EnterpriseRuntimeException
+229 - printStackTrace when loading configuration file
+237 - how can we use esapi in java for validation,please see files attached containing java code and for errors
+261 - Could not set multiple cookies one by one at single request
+275 - Log4JLogger.java doesn't output correct file & line number because FQCN isn't forwarded to Log4J
+276 - Patch for /branches/2.1/src/main/java/org/owasp/esapi/reference/DefaultExecutor.java
+287 - Patch for /branches/2.1/src/main/java/org/owasp/esapi/reference/FileBasedAuthenticator.java
+288 - Patch for /trunk/src/test/java/org/owasp/esapi/reference/UserTest.java
+289 - ClickjackFilter after doFilter
+306 - Canonicalizing "%Device% changes the meaning of the input string
+313 - Insecure default configuation for Executor.ApprovedExecutables in ESAPI.properties file
+315 - ValidatorTest.testIsValidDate fails if default locale is not US
+318 - Incorrect Equality test on floating point values
+319 - Resource leak: FileInputStream is not closed on method exit
+321 - Unsynchronized get method, synchronized set method
+322 - RequestRateThrottleFilter may not work as expected with hits=1 or hits=2
+323 - PolicyFactory Sanitize method weird output
+328 - StringUtils.union broken which has minor impact on CSRF Protection and random file name generation
+330 - setHeader blocks legitimate headers due to header name size limit being too low
+331 - Log4j configuration with no root level causes NPE in Log4jLogger.java
+334 - Regex in ESAPI.properties is not considering few of the french characters
+336 - Log4JLogger.java doesn't output correct file & line number-Similar issue as reported in Issue 268
+344 - JUnit test failure in ValidatorTest.testGetValidSafeHTML()
+345 - JUnit test failure in ValidatorTest.testIsValidDate()
+347 - Fixes #345 - JUnit test failure in ValidatorTest.testIsValidDate()
+349 - Package correctly the esapi.tld into ESAPI jar
+350 - [ESAPI Spring Code Sprint – May / June 2015] Implementation of requirements
+351 - getHeader length limit error
+354 - Add stern javadoc warning about Base64.decodeToObject() being unsafe and mark method as deprecated.
+      Note: This method no longer functions unless the system property org.owasp.esapi.enableUnsafeSerialization
+      is set to "true". This breaks backward compatibility in favor of taking a more secure posture.
+355 - Temp files created by org.owasp.esapi.waf.internal.InterceptingServletOutputStream not removed by WAF JUnit tests
+356 - Make end-of-line terminators consistent for .java, .xml, and other ESAPI source files.
+359 - CodecTest unit tests never test with a populated char array.
+
+
+-----------------------------------------------------------------------------
+
+        Other changes in this release not tracked via GitHub issues
+
+* Miscellaneous minor javadoc fixes and updates.
+* Fixed grammatical error in CipherTextSerializer class error message.
+* Upgraded versions of several ESAPI dependencies (i.e., 3rd party jars), including several that had unpatched CVEs.
+* Added the Maven plug-in for OWASP Dependency Check so 3rd party dependencies can be kept up-to-date.
+* Added .gitignore file so that certain files won't get accidentally commited such as IDE files.
+* Added .gitattributes file so to help resolve end-of-line issues. (Part of issue 356.)
+* Added new documentation (documentation/ESAPI-configuration-user-guide.md) describing new ESAPI configuration feature.
+* Changed many assertions in ESAPI crypto to explicit runtime checks that
+  throw IllegalArgumentException instead.
+
+-----------------------------------------------------------------------------
+                    ATTENTION: Other Important Notes
+
+The JUnit test AuthenticatorTest.setCurrentUser() is periodically failing
+due to an apparent race condition either in the test itself or in
+FileBasedAuthenticator. See GitHub issue #360 for details, including
+why we don't think it is worth holding up the release for.
+
+-----------------------------------------------------------------------------
+
+                Contributors for ESAPI 2.1.0.1 release
+
+Notice: My appologies if I've missed anyone, but you did have an opportunity
+        to send me your names. (I solicited for contributors names to emails
+        to the ESAPI-Dev and ESAPI-User mailing lists sent on 1/23/2016.)
+        If I missed you and you contributed to THIS release, please send
+        me an email with your first and last name and what your SPECIFIC
+        contribution was and I will see you name is added to this list.
+                                                    - Kevin W. Wall
+
+Project co-leaders
+    Kevin W. Wall (kwwall)
+    Chris Schmidt (chrisisbeef)
+
+Special shout-outs to:
+    Matt Seil (xeno6696)
+    Jeremiah Stacey (jeremiahjstacey)
+
+Special contributions:
+    ESAPI Hackathon participants - November 18, 2014 - January 20, 2014
+        Daniel Amodio
+        Eric Kobrin
+        Eric Citaire
+        Eamonn Washington
+        John Melton
+        Special thanks to Samantha Groves for assisting with the ESAPI hackathon
+
+    Professor and students involved in ESAPI Spring Code Sprint (May - June, 2015):
+        Marek Zachara - instructor
+        Patryk Bak - student
+        Marcin Siedlarz - student
+        Szymon Bobowiec - student
+        Karol Kapcia - student
+        Fabio Cerullo - OWASP board coordination for code sprint
+
+Other Contributors:
+    Karan Sanwal
+    Arpit Gupta
+    Constantino Cronemberger
+    Tàrin Gamberìni
+    Kad Dembele
+    Anthony Musyoki
+    Andrew VanLoo
+    Ashish Tripathy

From a45a134d064aefaf17d2f82c220532ac747afc1d Mon Sep 17 00:00:00 2001
From: kwwall 
Date: Sun, 31 Jan 2016 23:03:13 -0500
Subject: [PATCH 367/812] Added contributor.

---
 documentation/esapi4java-core-2.1.0.1-release-notes.txt | 1 +
 1 file changed, 1 insertion(+)

diff --git a/documentation/esapi4java-core-2.1.0.1-release-notes.txt b/documentation/esapi4java-core-2.1.0.1-release-notes.txt
index 0820404d8..568b4e234 100644
--- a/documentation/esapi4java-core-2.1.0.1-release-notes.txt
+++ b/documentation/esapi4java-core-2.1.0.1-release-notes.txt
@@ -124,3 +124,4 @@ Other Contributors:
     Anthony Musyoki
     Andrew VanLoo
     Ashish Tripathy
+    Brad Schoening

From 18bdb4db742d5242a34e1cd9649fa675584196fe Mon Sep 17 00:00:00 2001
From: kwwall 
Date: Mon, 1 Feb 2016 21:10:56 -0500
Subject: [PATCH 368/812] Changes for new 2.1.0.1 release and to work with
 Cygwin.

---
 src/examples/scripts/findjar.sh    | 17 ++++++++++++++---
 src/examples/scripts/setenv-svn.sh |  8 ++++----
 src/examples/scripts/setenv-zip.sh |  2 +-
 3 files changed, 19 insertions(+), 8 deletions(-)

diff --git a/src/examples/scripts/findjar.sh b/src/examples/scripts/findjar.sh
index 611c32909..882c12b52 100755
--- a/src/examples/scripts/findjar.sh
+++ b/src/examples/scripts/findjar.sh
@@ -10,8 +10,13 @@ PROG=${0##*/}
 #   Default starting directory is Maven2 repository under $HOME ...
 starting_dir=$HOME/.m2/repository
 
+# If we are on Cygwin on Windows, the Maven repo may be under $USERPROFILE.
+if [[ $(uname -o) == "Cygwin" && ! -d "$starting_dir" ]]
+then    starting_dir="$(cygpath --unix ${USERPROFILE:-$HOME}/.m2/repository)"
+fi
+
 case "$1" in
--start) shift; starting_dir="$1"; shift ;;
+-start) shift; starting_dir="$1"; shift ;;  # Expected to be right if provided
 -\?)    echo "$USAGE" >&2; exit 2 ;;
 -*)     echo "$PROG: Unknown option: $1; treating as a jar pattern." >&2 ;;
 esac
@@ -25,5 +30,11 @@ esac
 
 # echo "Starting location: $starting_dir"   # DEBUG
 # echo "Jar pattern: $jar_pattern"          # DEBUG
-find "$starting_dir" -type f -name "$jar_pattern" -print |
-    egrep -v 'javadoc|sources'
+if [[ -d "$starting_dir" ]]
+then
+    find "$starting_dir" -type f -name "$jar_pattern" -print |
+        egrep -v 'javadoc|sources'
+else
+    echo "$PROG: Can't find starting directory for Maven repo: $starting_dir" >&2
+    exit 1
+fi
diff --git a/src/examples/scripts/setenv-svn.sh b/src/examples/scripts/setenv-svn.sh
index 41024857f..db4846e7c 100755
--- a/src/examples/scripts/setenv-svn.sh
+++ b/src/examples/scripts/setenv-svn.sh
@@ -1,6 +1,6 @@
 #/bin/bash
 # Purpose:  Use to set up environment to compile and run examples if ESAPI
-#           downloaded from the SVN repository.
+#           downloaded from the Svn or Git repository.
 # Usage:    From csh, tcsh:
 #               $ source ./setenv-svn.sh
 #           From most other *nix shells:
@@ -18,9 +18,9 @@
 esapi_classpath=".:\
 ../../../target/classes:\
 $(ls ../../../target/esapi-*.jar 2>&- || echo .):\
-$(./findjar.sh log4j-1.2.16.jar):\
-$(./findjar.sh commons-fileupload-1.2.jar):\
-$(./findjar.sh servlet-api-2.4.jar)"
+$(./findjar.sh log4j-1.2.17.jar):\
+$(./findjar.sh commons-fileupload-1.3.1.jar):\
+$(./findjar.sh servlet-api-2.5.jar)"
 
 esapi_resources="$(\cd ../../../configuration/esapi >&- 2>&- && pwd)"
 esapi_resources_test="$(\cd ../../../src/test/resources/esapi >&- 2>&- && pwd)"
diff --git a/src/examples/scripts/setenv-zip.sh b/src/examples/scripts/setenv-zip.sh
index 2a455791c..310864ac0 100755
--- a/src/examples/scripts/setenv-zip.sh
+++ b/src/examples/scripts/setenv-zip.sh
@@ -13,7 +13,7 @@
 # since the specific version of the library is delivered as part of the
 # ESAPI zip file. In this manner, we do not have to update this if these
 # versions change. For the record, at the time of this writing, these were
-# log4j-1.2.16.jar, commons-fileupload-1.2.jar, and servlet-api-2.4.jar.
+# log4j-1.2.17.jar, commons-fileupload-1.3.1.jar, and servlet-api-2.5.jar.
 esapi_classpath=".:\
 $(ls ../../../esapi*.jar):\
 $(./findjar.sh -start ../../../libs log4j-*.jar):\

From a907633752d17c6b5ae7dc3b5e9c02f45e1fd8ab Mon Sep 17 00:00:00 2001
From: kwwall 
Date: Mon, 1 Feb 2016 21:28:23 -0500
Subject: [PATCH 369/812] Added System.err.println() to comment about GitHub
 issue 306.

---
 src/test/java/org/owasp/esapi/reference/AuthenticatorTest.java | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/src/test/java/org/owasp/esapi/reference/AuthenticatorTest.java b/src/test/java/org/owasp/esapi/reference/AuthenticatorTest.java
index 1603689c7..f3dd16ddb 100644
--- a/src/test/java/org/owasp/esapi/reference/AuthenticatorTest.java
+++ b/src/test/java/org/owasp/esapi/reference/AuthenticatorTest.java
@@ -413,6 +413,9 @@ public void run() {
 	 */
 	@Test public void testSetCurrentUser() throws AuthenticationException, InterruptedException {
 		System.out.println("setCurrentUser");
+        System.err.println("AuthenticatorTest.setCurrentUser(): This test " +
+                           "occasionally fails due to some undiscovered race condition. " +
+                           "This has been reported as GitHub issue #360. Patches to fix welcome.");
 		String user1 = ESAPI.randomizer().getRandomString(8, EncoderConstants.CHAR_UPPERS);
 		String user2 = ESAPI.randomizer().getRandomString(8, EncoderConstants.CHAR_UPPERS);
 		User userOne = instance.createUser(user1, "getCurrentUser", "getCurrentUser");

From 150de3a2c5ba37523612ee07341255139bab1c87 Mon Sep 17 00:00:00 2001
From: kwwall 
Date: Mon, 1 Feb 2016 21:30:04 -0500
Subject: [PATCH 370/812] Remove '-SNAPSHOT' in prep for 2.1.0.1 release.

---
 pom.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pom.xml b/pom.xml
index f867c9b1a..140c6bf9d 100644
--- a/pom.xml
+++ b/pom.xml
@@ -3,7 +3,7 @@
     4.0.0
     org.owasp.esapi
     esapi
-    2.1.0.1-SNAPSHOT
+    2.1.0.1
     jar
 
     

From 66f1e5a93f701957be82e73d045917ec2b1136a9 Mon Sep 17 00:00:00 2001
From: kwwall 
Date: Mon, 1 Feb 2016 21:34:59 -0500
Subject: [PATCH 371/812] Add more closed issues and contributors.

---
 documentation/esapi4java-core-2.1.0.1-release-notes.txt | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/documentation/esapi4java-core-2.1.0.1-release-notes.txt b/documentation/esapi4java-core-2.1.0.1-release-notes.txt
index 568b4e234..306b34f30 100644
--- a/documentation/esapi4java-core-2.1.0.1-release-notes.txt
+++ b/documentation/esapi4java-core-2.1.0.1-release-notes.txt
@@ -1,13 +1,14 @@
 Release notes for ESAPI 2.1.0.1
     Release date: 2016-Feb-??
-    -Kevin W. Wall 
+        -Kevin W. Wall 
+        -Chris Schmidt 
 
 Previous release: ESAPI 2.1.0, Sept 2013
 
 
 -----------------------------------------------------------------------------
                 GitHub Issues fixed in this release:
-                          35 issues closed
+                          36 issues closed
 
 32 - URLs in doc for HTTPUtilities.setNoCacheHeaders are wrong
 58 - Separate Crypto Related Properties into Separate File
@@ -23,6 +24,7 @@ Previous release: ESAPI 2.1.0, Sept 2013
 221 - IntrusionException should extend EnterpriseRuntimeException
 229 - printStackTrace when loading configuration file
 237 - how can we use esapi in java for validation,please see files attached containing java code and for errors
+254 - Patch for /trunk/src/main/java/org/owasp/esapi/reference/crypto/JavaEncryptor.java
 261 - Could not set multiple cookies one by one at single request
 275 - Log4JLogger.java doesn't output correct file & line number because FQCN isn't forwarded to Log4J
 276 - Patch for /branches/2.1/src/main/java/org/owasp/esapi/reference/DefaultExecutor.java

From 5582e1ffb6afce1208d65cf890986fb70d8b0aac Mon Sep 17 00:00:00 2001
From: kwwall 
Date: Fri, 5 Feb 2016 00:56:03 -0500
Subject: [PATCH 372/812] Set release date to 2016-Feb-05

---
 documentation/esapi4java-core-2.1.0.1-release-notes.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/documentation/esapi4java-core-2.1.0.1-release-notes.txt b/documentation/esapi4java-core-2.1.0.1-release-notes.txt
index 306b34f30..4c599ff59 100644
--- a/documentation/esapi4java-core-2.1.0.1-release-notes.txt
+++ b/documentation/esapi4java-core-2.1.0.1-release-notes.txt
@@ -1,5 +1,5 @@
 Release notes for ESAPI 2.1.0.1
-    Release date: 2016-Feb-??
+    Release date: 2016-Feb-05
         -Kevin W. Wall 
         -Chris Schmidt 
 

From 74f4baa1cc70be14590f849b07205ed8a97bd1a5 Mon Sep 17 00:00:00 2001
From: "Kevin W. Wall" 
Date: Fri, 5 Feb 2016 12:30:46 -0500
Subject: [PATCH 373/812] Update pom.xml

Change version from 2.1.0.1 to 2.1.0.2-SNAPSHOT to get ready for next development cycle.
---
 pom.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pom.xml b/pom.xml
index 140c6bf9d..32d10efb8 100644
--- a/pom.xml
+++ b/pom.xml
@@ -3,7 +3,7 @@
     4.0.0
     org.owasp.esapi
     esapi
-    2.1.0.1
+    2.1.0.2-SNAPSHOT
     jar
 
     

From c0a8c3e92ca6d9c7c0b5820dc58232b99b976aac Mon Sep 17 00:00:00 2001
From: "Kevin W. Wall" 
Date: Fri, 5 Feb 2016 23:10:22 -0500
Subject: [PATCH 374/812] Update README.md

Add note about the 'master' branch no longer being default.
---
 README.md | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/README.md b/README.md
index 96ce300c8..41f968157 100644
--- a/README.md
+++ b/README.md
@@ -11,6 +11,9 @@ OWASP ESAPI (The OWASP Enterprise Security API) is a free, open source, web appl
 What does Legacy mean?
    
 
    This is the legacy branch of ESAPI which means it is an actively maintained branch of the project, however feature development for this branch will not be done. Features that have already been scheduled for the 2.x branch will move forward, but the main focus will be working on the ESAPI 3.x branch.
 
+IMPORTANT NOTE:
+The default branch for ESAPI legacy is now the 'develop' branch (rather than the 'master' branch), where future development, bug fixes, etc. will now be done. The 'master' branch is now marked as "protected"; it reflects the latest stable ESAPI release (2.1.0.1 as of this date). Note that this change of making the 'develop' branch the default may affect any pull requests that you were intending to make.
+
 Where can I find ESAPI 3.x
    
 https://github.com/ESAPI/esapi-java
 

From 6696001960616bd99a2c9c0e94e6e8b7830a2924 Mon Sep 17 00:00:00 2001
From: "Kevin W. Wall" 
Date: Fri, 5 Feb 2016 23:11:13 -0500
Subject: [PATCH 375/812] Update README.md

Fixed screwed up formatting.
---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 41f968157..a5bc91456 100644
--- a/README.md
+++ b/README.md
@@ -11,7 +11,7 @@ OWASP ESAPI (The OWASP Enterprise Security API) is a free, open source, web appl
 What does Legacy mean?
    
 
    This is the legacy branch of ESAPI which means it is an actively maintained branch of the project, however feature development for this branch will not be done. Features that have already been scheduled for the 2.x branch will move forward, but the main focus will be working on the ESAPI 3.x branch.
 
-IMPORTANT NOTE:
+IMPORTANT NOTE:
 The default branch for ESAPI legacy is now the 'develop' branch (rather than the 'master' branch), where future development, bug fixes, etc. will now be done. The 'master' branch is now marked as "protected"; it reflects the latest stable ESAPI release (2.1.0.1 as of this date). Note that this change of making the 'develop' branch the default may affect any pull requests that you were intending to make.
 
 Where can I find ESAPI 3.x
    

From 4cb93e4c3d1587379b7fe00d1c586299c331d639 Mon Sep 17 00:00:00 2001
From: Anthony Musyoki 
Date: Mon, 8 Feb 2016 09:40:24 +0300
Subject: [PATCH 376/812] Updates outdated plugin versions.

---
 pom.xml | 36 ++++++++++++++++++------------------
 1 file changed, 18 insertions(+), 18 deletions(-)

diff --git a/pom.xml b/pom.xml
index 140c6bf9d..6aee8b282 100644
--- a/pom.xml
+++ b/pom.xml
@@ -201,7 +201,7 @@
         
             
                 maven-compiler-plugin
-                3.1
+                3.3
                 
                     1.6
                     1.6
@@ -214,7 +214,7 @@
             
                 org.apache.maven.plugins
                 maven-eclipse-plugin
-                2.9
+                2.10
                 
                     true
                 
@@ -222,7 +222,7 @@
 
             
                 maven-jar-plugin
-                2.4
+                2.6
                 
                     
                         
@@ -237,7 +237,7 @@
             
                 org.codehaus.mojo
                 versions-maven-plugin
-                2.1
+                2.2
                 
                     
                         check-for-dependency-updates
@@ -259,7 +259,7 @@
             
                 org.codehaus.mojo
                 findbugs-maven-plugin
-                2.5.3
+                2.5.5
                 
                     true
                     true
@@ -272,7 +272,7 @@
             
                 org.codehaus.mojo
                 cobertura-maven-plugin
-                2.6
+                2.7
                 
                     
                         html
@@ -287,7 +287,7 @@
             
             
                 maven-pmd-plugin
-                3.1
+                3.6
                 
                     1.5
                     utf-8
@@ -296,7 +296,7 @@
             
                 org.apache.maven.plugins
                 maven-javadoc-plugin
-                2.9.1
+                2.10.3
                 
                     false
                     false
@@ -310,7 +310,7 @@
             
                 org.apache.maven.plugins
                 maven-changelog-plugin
-                2.2
+                2.3
                 
                     [Ii]ssue[# ]*(\d)+
                     http://code.google.com/p/owasp-esapi-java/issues/detail?id=%ISSUE%
@@ -323,7 +323,7 @@
             
                 org.codehaus.mojo
                 versions-maven-plugin
-                2.1
+                2.2
                 
                     
                         
@@ -337,7 +337,7 @@
             
                 org.owasp
                 dependency-check-maven
-                1.2.11
+                1.3.3
                 
                     false
                 
@@ -345,7 +345,7 @@
             
                 org.apache.maven.plugins
                 maven-surefire-report-plugin
-                2.17
+                2.19.1
             
         
     
@@ -384,7 +384,7 @@
                     
                         org.apache.maven.plugins
                         maven-gpg-plugin
-                        1.5
+                        1.6
                         
                             
                                 sign-artifacts
@@ -402,7 +402,7 @@
 					
 						org.apache.maven.plugins
 						maven-jar-plugin
-						2.4
+						2.6
 
+            1.9.3
         
         
             junit
@@ -150,13 +151,13 @@
         
             commons-fileupload
             commons-fileupload
-            1.3.1
+            1.3.2
             compile
         
         
             commons-io
             commons-io
-            2.4
+            2.5
             test
         
         
@@ -185,12 +186,24 @@
         
             org.owasp.antisamy
             antisamy
-            1.5.3
+            1.5.5
+        
+        
+        
+            xalan
+            xalan
+            2.7.2
         
         
             org.apache.xmlgraphics
             batik-css
-            1.8
+            1.9
         
 		
 		    org.mockito
@@ -272,6 +285,21 @@
                 4.1.0
             
 
+            
+                org.owasp
+                dependency-check-maven
+                1.4.4
+                
+                    1
+                
+                
+                    
+                        
+                            check
+                        
+                    
+                
+            
         
     
 
@@ -344,14 +372,6 @@
                     
                 
             
-            
-                org.owasp
-                dependency-check-maven
-                1.3.3
-                
-                    false
-                
-            
             
                 org.apache.maven.plugins
                 maven-surefire-report-plugin

From bd199f6f2fc41027040f14104fe557f38d726ce4 Mon Sep 17 00:00:00 2001
From: augustd 
Date: Wed, 3 May 2017 14:39:43 -0700
Subject: [PATCH 399/812] Suppress CVE-2016-1000031 in dependency check

---
 pom.xml          |  3 ++-
 suppressions.xml | 10 ++++++++++
 2 files changed, 12 insertions(+), 1 deletion(-)
 create mode 100644 suppressions.xml

diff --git a/pom.xml b/pom.xml
index 857d7491b..637fe8fb0 100644
--- a/pom.xml
+++ b/pom.xml
@@ -7,7 +7,7 @@
     jar
 
     
-        3.0
+        3.1
     
 
     
@@ -291,6 +291,7 @@
                 1.4.4
                 
                     1
+                    ./suppressions.xml
                 
                 
                     
diff --git a/suppressions.xml b/suppressions.xml
new file mode 100644
index 000000000..181b75909
--- /dev/null
+++ b/suppressions.xml
@@ -0,0 +1,10 @@
+
+
+    
+        
+        .*\bcommons-fileupload-1.3.2.jar
+        CVE-2016-1000031
+    
+
\ No newline at end of file

From 3d72ea0fd2842687793f284bee62ba29407a46f3 Mon Sep 17 00:00:00 2001
From: augustd 
Date: Thu, 4 May 2017 23:57:59 -0700
Subject: [PATCH 400/812] Update to servlet API 3.0.1

This version compiles with dependency check only failing the build on
CVSS 5.9+
---
 pom.xml                                       |  10 +-
 .../esapi/http/MockHttpServletRequest.java    |  69 +++++++++
 .../esapi/http/MockHttpServletResponse.java   |   6 +
 .../owasp/esapi/http/MockServletContext.java  | 138 ++++++++++++++++++
 .../esapi/reference/HTTPUtilitiesTest.java    |  17 ++-
 5 files changed, 232 insertions(+), 8 deletions(-)

diff --git a/pom.xml b/pom.xml
index 637fe8fb0..224f1f5c7 100644
--- a/pom.xml
+++ b/pom.xml
@@ -138,14 +138,14 @@
         
         
             javax.servlet
-            servlet-api
-            2.5
+            javax.servlet-api
+            3.0.1
             provided
         
         
-            javax.servlet
+            javax.servlet.jsp
             jsp-api
-            2.0
+            2.2
             provided
         
         
@@ -290,7 +290,7 @@
                 dependency-check-maven
                 1.4.4
                 
-                    1
+                    5.9
                     ./suppressions.xml
                 
                 
diff --git a/src/test/java/org/owasp/esapi/http/MockHttpServletRequest.java b/src/test/java/org/owasp/esapi/http/MockHttpServletRequest.java
index 4910499f4..c89a498ba 100644
--- a/src/test/java/org/owasp/esapi/http/MockHttpServletRequest.java
+++ b/src/test/java/org/owasp/esapi/http/MockHttpServletRequest.java
@@ -24,6 +24,7 @@
 import java.text.SimpleDateFormat;
 import java.util.Arrays;
 import java.util.ArrayList;
+import java.util.Collection;
 import java.util.Collections;
 import java.util.Date;
 import java.util.Enumeration;
@@ -32,12 +33,20 @@
 import java.util.Locale;
 import java.util.Map;
 import java.util.Vector;
+import javax.servlet.AsyncContext;
+import javax.servlet.DispatcherType;
 
 import javax.servlet.RequestDispatcher;
+import javax.servlet.ServletContext;
+import javax.servlet.ServletException;
 import javax.servlet.ServletInputStream;
+import javax.servlet.ServletRequest;
+import javax.servlet.ServletResponse;
 import javax.servlet.http.Cookie;
 import javax.servlet.http.HttpServletRequest;
+import javax.servlet.http.HttpServletResponse;
 import javax.servlet.http.HttpSession;
+import javax.servlet.http.Part;
 
 /**
  * The Class MockHttpServletRequest.
@@ -779,4 +788,64 @@ public void dump()
 		System.out.println( "\n" );
 	}
 
+    @Override
+    public boolean authenticate(HttpServletResponse hsr) throws IOException, ServletException {
+        throw new UnsupportedOperationException("Not supported yet."); //To change body of generated methods, choose Tools | Templates.
+    }
+
+    @Override
+    public void login(String string, String string1) throws ServletException {
+        throw new UnsupportedOperationException("Not supported yet."); //To change body of generated methods, choose Tools | Templates.
+    }
+
+    @Override
+    public void logout() throws ServletException {
+        throw new UnsupportedOperationException("Not supported yet."); //To change body of generated methods, choose Tools | Templates.
+    }
+
+    @Override
+    public Collection getParts() throws IOException, ServletException {
+        throw new UnsupportedOperationException("Not supported yet."); //To change body of generated methods, choose Tools | Templates.
+    }
+
+    @Override
+    public Part getPart(String string) throws IOException, ServletException {
+        throw new UnsupportedOperationException("Not supported yet."); //To change body of generated methods, choose Tools | Templates.
+    }
+
+    @Override
+    public ServletContext getServletContext() {
+        throw new UnsupportedOperationException("Not supported yet."); //To change body of generated methods, choose Tools | Templates.
+    }
+
+    @Override
+    public AsyncContext startAsync() throws IllegalStateException {
+        throw new UnsupportedOperationException("Not supported yet."); //To change body of generated methods, choose Tools | Templates.
+    }
+
+    @Override
+    public AsyncContext startAsync(ServletRequest sr, ServletResponse sr1) throws IllegalStateException {
+        throw new UnsupportedOperationException("Not supported yet."); //To change body of generated methods, choose Tools | Templates.
+    }
+
+    @Override
+    public boolean isAsyncStarted() {
+        throw new UnsupportedOperationException("Not supported yet."); //To change body of generated methods, choose Tools | Templates.
+    }
+
+    @Override
+    public boolean isAsyncSupported() {
+        throw new UnsupportedOperationException("Not supported yet."); //To change body of generated methods, choose Tools | Templates.
+    }
+
+    @Override
+    public AsyncContext getAsyncContext() {
+        throw new UnsupportedOperationException("Not supported yet."); //To change body of generated methods, choose Tools | Templates.
+    }
+
+    @Override
+    public DispatcherType getDispatcherType() {
+        throw new UnsupportedOperationException("Not supported yet."); //To change body of generated methods, choose Tools | Templates.
+    }
+
 }
diff --git a/src/test/java/org/owasp/esapi/http/MockHttpServletResponse.java b/src/test/java/org/owasp/esapi/http/MockHttpServletResponse.java
index d45e3aa0b..0858f9be5 100644
--- a/src/test/java/org/owasp/esapi/http/MockHttpServletResponse.java
+++ b/src/test/java/org/owasp/esapi/http/MockHttpServletResponse.java
@@ -18,6 +18,7 @@
 import java.io.IOException;
 import java.io.PrintWriter;
 import java.util.ArrayList;
+import java.util.Collection;
 import java.util.Iterator;
 import java.util.List;
 import java.util.Locale;
@@ -459,5 +460,10 @@ public void dump() {
         System.out.println( "  BODY: " + this.getBody() );
         System.out.println();
 	}
+
+    @Override
+    public Collection getHeaders(String string) {
+        throw new UnsupportedOperationException("Not supported yet."); //To change body of generated methods, choose Tools | Templates.
+    }
 	
 }
diff --git a/src/test/java/org/owasp/esapi/http/MockServletContext.java b/src/test/java/org/owasp/esapi/http/MockServletContext.java
index dd1d01929..b4b042fc7 100644
--- a/src/test/java/org/owasp/esapi/http/MockServletContext.java
+++ b/src/test/java/org/owasp/esapi/http/MockServletContext.java
@@ -19,13 +19,21 @@
 import java.net.MalformedURLException;
 import java.net.URL;
 import java.util.Enumeration;
+import java.util.EventListener;
+import java.util.Map;
 import java.util.Set;
+import javax.servlet.Filter;
+import javax.servlet.FilterRegistration;
 
 import javax.servlet.RequestDispatcher;
 import javax.servlet.Servlet;
 import javax.servlet.ServletConfig;
 import javax.servlet.ServletContext;
 import javax.servlet.ServletException;
+import javax.servlet.ServletRegistration;
+import javax.servlet.SessionCookieConfig;
+import javax.servlet.SessionTrackingMode;
+import javax.servlet.descriptor.JspConfigDescriptor;
 
 import org.owasp.esapi.ESAPI;
 import org.owasp.esapi.Logger;
@@ -551,4 +559,134 @@ public void removeAttribute(String name) {
     public String getServletContextName() {
     	return null;
     }
+
+    @Override
+    public int getEffectiveMajorVersion() {
+        throw new UnsupportedOperationException("Not supported yet."); //To change body of generated methods, choose Tools | Templates.
+    }
+
+    @Override
+    public int getEffectiveMinorVersion() {
+        throw new UnsupportedOperationException("Not supported yet."); //To change body of generated methods, choose Tools | Templates.
+    }
+
+    @Override
+    public boolean setInitParameter(String string, String string1) {
+        throw new UnsupportedOperationException("Not supported yet."); //To change body of generated methods, choose Tools | Templates.
+    }
+
+    @Override
+    public ServletRegistration.Dynamic addServlet(String string, String string1) {
+        throw new UnsupportedOperationException("Not supported yet."); //To change body of generated methods, choose Tools | Templates.
+    }
+
+    @Override
+    public ServletRegistration.Dynamic addServlet(String string, Servlet srvlt) {
+        throw new UnsupportedOperationException("Not supported yet."); //To change body of generated methods, choose Tools | Templates.
+    }
+
+    @Override
+    public ServletRegistration.Dynamic addServlet(String string, Class type) {
+        throw new UnsupportedOperationException("Not supported yet."); //To change body of generated methods, choose Tools | Templates.
+    }
+
+    @Override
+    public  T createServlet(Class type) throws ServletException {
+        throw new UnsupportedOperationException("Not supported yet."); //To change body of generated methods, choose Tools | Templates.
+    }
+
+    @Override
+    public ServletRegistration getServletRegistration(String string) {
+        throw new UnsupportedOperationException("Not supported yet."); //To change body of generated methods, choose Tools | Templates.
+    }
+
+    @Override
+    public Map getServletRegistrations() {
+        throw new UnsupportedOperationException("Not supported yet."); //To change body of generated methods, choose Tools | Templates.
+    }
+
+    @Override
+    public FilterRegistration.Dynamic addFilter(String string, String string1) {
+        throw new UnsupportedOperationException("Not supported yet."); //To change body of generated methods, choose Tools | Templates.
+    }
+
+    @Override
+    public FilterRegistration.Dynamic addFilter(String string, Filter filter) {
+        throw new UnsupportedOperationException("Not supported yet."); //To change body of generated methods, choose Tools | Templates.
+    }
+
+    @Override
+    public FilterRegistration.Dynamic addFilter(String string, Class type) {
+        throw new UnsupportedOperationException("Not supported yet."); //To change body of generated methods, choose Tools | Templates.
+    }
+
+    @Override
+    public  T createFilter(Class type) throws ServletException {
+        throw new UnsupportedOperationException("Not supported yet."); //To change body of generated methods, choose Tools | Templates.
+    }
+
+    @Override
+    public FilterRegistration getFilterRegistration(String string) {
+        throw new UnsupportedOperationException("Not supported yet."); //To change body of generated methods, choose Tools | Templates.
+    }
+
+    @Override
+    public Map getFilterRegistrations() {
+        throw new UnsupportedOperationException("Not supported yet."); //To change body of generated methods, choose Tools | Templates.
+    }
+
+    @Override
+    public SessionCookieConfig getSessionCookieConfig() {
+        throw new UnsupportedOperationException("Not supported yet."); //To change body of generated methods, choose Tools | Templates.
+    }
+
+    @Override
+    public void setSessionTrackingModes(Set set) {
+        throw new UnsupportedOperationException("Not supported yet."); //To change body of generated methods, choose Tools | Templates.
+    }
+
+    @Override
+    public Set getDefaultSessionTrackingModes() {
+        throw new UnsupportedOperationException("Not supported yet."); //To change body of generated methods, choose Tools | Templates.
+    }
+
+    @Override
+    public Set getEffectiveSessionTrackingModes() {
+        throw new UnsupportedOperationException("Not supported yet."); //To change body of generated methods, choose Tools | Templates.
+    }
+
+    @Override
+    public void addListener(String string) {
+        throw new UnsupportedOperationException("Not supported yet."); //To change body of generated methods, choose Tools | Templates.
+    }
+
+    @Override
+    public  void addListener(T t) {
+        throw new UnsupportedOperationException("Not supported yet."); //To change body of generated methods, choose Tools | Templates.
+    }
+
+    @Override
+    public void addListener(Class type) {
+        throw new UnsupportedOperationException("Not supported yet."); //To change body of generated methods, choose Tools | Templates.
+    }
+
+    @Override
+    public  T createListener(Class type) throws ServletException {
+        throw new UnsupportedOperationException("Not supported yet."); //To change body of generated methods, choose Tools | Templates.
+    }
+
+    @Override
+    public JspConfigDescriptor getJspConfigDescriptor() {
+        throw new UnsupportedOperationException("Not supported yet."); //To change body of generated methods, choose Tools | Templates.
+    }
+
+    @Override
+    public ClassLoader getClassLoader() {
+        throw new UnsupportedOperationException("Not supported yet."); //To change body of generated methods, choose Tools | Templates.
+    }
+
+    @Override
+    public void declareRoles(String... strings) {
+        throw new UnsupportedOperationException("Not supported yet."); //To change body of generated methods, choose Tools | Templates.
+    }
 }
\ No newline at end of file
diff --git a/src/test/java/org/owasp/esapi/reference/HTTPUtilitiesTest.java b/src/test/java/org/owasp/esapi/reference/HTTPUtilitiesTest.java
index c58eecaa3..130534ee8 100644
--- a/src/test/java/org/owasp/esapi/reference/HTTPUtilitiesTest.java
+++ b/src/test/java/org/owasp/esapi/reference/HTTPUtilitiesTest.java
@@ -49,6 +49,10 @@
 import junit.framework.Test;
 import junit.framework.TestCase;
 import junit.framework.TestSuite;
+import static org.hamcrest.CoreMatchers.is;
+import static org.junit.Assert.assertThat;
+import org.junit.Rule;
+import org.junit.rules.ExpectedException;
 /**
  * The Class HTTPUtilitiesTest.
  * 
@@ -334,6 +338,9 @@ public void testSendSafeRedirect() throws Exception {
 		}
 	}
 
+        @Rule
+        public ExpectedException thrown = ExpectedException.none();
+        
 	/**
 	 * Test of setCookie method, of class org.owasp.esapi.HTTPUtilities.
 	 */
@@ -349,9 +356,13 @@ public void testSetCookie() {
 		instance.addCookie( response, new Cookie( "test2", "test2" ) );
 		assertTrue(response.getHeaderNames().size() == 2);
 
-		// test illegal name
-		instance.addCookie( response, new Cookie( "tes
Date: Sat, 17 Jun 2017 14:30:31 -0700
Subject: [PATCH 401/812] Issue #376 -- Addressed Kevin Wall's CR comments.

---
 src/main/java/org/owasp/esapi/Validator.java  |  2 ++
 .../esapi/reference/DefaultValidator.java     | 23 ++++++++++++++-----
 .../owasp/esapi/reference/ValidatorTest.java  | 20 ++++++++++++++++
 src/test/resources/urisForTest.txt            |  1 +
 4 files changed, 40 insertions(+), 6 deletions(-)

diff --git a/src/main/java/org/owasp/esapi/Validator.java b/src/main/java/org/owasp/esapi/Validator.java
index 00d950d82..7db159d94 100644
--- a/src/main/java/org/owasp/esapi/Validator.java
+++ b/src/main/java/org/owasp/esapi/Validator.java
@@ -694,6 +694,8 @@ public interface Validator {
 	 * the kind of regex required for subsequent validation to mitigate regex-based 
 	 * DoS attacks.  
 	 * 
+	 * @see https://www.ietf.org/rfc/rfc3986.txt
+	 * 
  	 *	@param context
 	 *  		A descriptive name of the parameter that you are validating (e.g., LoginPage_UsernameField). This value is used by any logging or error handling that is done with respect to the value passed in.
 	 *  @param input
diff --git a/src/main/java/org/owasp/esapi/reference/DefaultValidator.java b/src/main/java/org/owasp/esapi/reference/DefaultValidator.java
index 8b830d56e..02595f5d2 100644
--- a/src/main/java/org/owasp/esapi/reference/DefaultValidator.java
+++ b/src/main/java/org/owasp/esapi/reference/DefaultValidator.java
@@ -66,6 +66,7 @@
  *
  * @author Jeff Williams (jeff.williams .at. aspectsecurity.com) Aspect Security
  * @author Jim Manico (jim@manico.net) Manico.net
+ * @author Matt Seil (mseil .at. acm.org) 
  *
  * @since June 1, 2007
  * @see org.owasp.esapi.Validator
@@ -1208,14 +1209,15 @@ private final boolean isEmpty(char[] input) {
 	 */
 	public boolean isValidURI(String context, String input, boolean allowNull) {
 		boolean isValid = false;
-		URI compliantURI = this.getRfcCompliantURI(input);
+		boolean inputIsNullOrEmpty = input == null || "".equals(input);
 		
 		try{
-			if(null != compliantURI){
+			URI compliantURI = null == input ? new URI("") :  this.getRfcCompliantURI(input);
+			if(null != compliantURI && input != null){
 				String canonicalizedURI = getCanonicalizedURI(compliantURI);
 				//if getCanonicalizedURI doesn't throw an IntrusionException, then the URI contains no mixed or 
 				//double-encoding attacks.  
-				logger.info(Logger.SECURITY_SUCCESS, "We did not detect any mixed or multiple encoding in the uri:[" + input + "]");
+				logger.debug(Logger.SECURITY_SUCCESS, "We did not detect any mixed or multiple encoding in the uri:[" + input + "]");
 				Validator v = ESAPI.validator();
 				//This part will use the regex from validation.properties.  This regex should be super-simple, and 
 				//used mainly to restrict certain parts of a URL.  
@@ -1224,11 +1226,17 @@ public boolean isValidURI(String context, String input, boolean allowNull) {
 				//and if the URI has any queries that also happen to match HTML entities, like ¶
 				//it will cease conforming to the regex we now specify for a URL.
 				isValid = p.matcher(canonicalizedURI).matches();
+			}else{
+				if(allowNull && inputIsNullOrEmpty ){
+					isValid = true;
+				}
 			}
 			
 		}catch (IntrusionException e){
 			logger.error(Logger.SECURITY_FAILURE, e.getMessage());
 			isValid = false;
+		} catch (URISyntaxException e) {
+			logger.error(Logger.EVENT_FAILURE, e.getMessage());
 		}
 		
 		
@@ -1249,11 +1257,14 @@ public URI getRfcCompliantURI(String input){
 	}
 	
 	/**
-	 * This does alot.  This will extract each piece of a URI according to parse zone, and it will construct 
-	 * a canonicalized String representing a version of the URI that is safe to run regex against to it. 
+	 * {@inheritDoc}
+	 * 
+	 * This will extract each piece of a URI according to parse zone as specified in RFC-3986 section 3, 
+	 * and it will construct a canonicalized String representing a version of the URI that is safe to 
+	 * run regex against. 
 	 * 
 	 * @param dirtyUri
-	 * @return
+	 * @return Canonicalized URI string.
 	 * @throws IntrusionException
 	 */
 	public String getCanonicalizedURI(URI dirtyUri) throws IntrusionException{
diff --git a/src/test/java/org/owasp/esapi/reference/ValidatorTest.java b/src/test/java/org/owasp/esapi/reference/ValidatorTest.java
index d2ce97256..614d25f1f 100644
--- a/src/test/java/org/owasp/esapi/reference/ValidatorTest.java
+++ b/src/test/java/org/owasp/esapi/reference/ValidatorTest.java
@@ -1156,6 +1156,12 @@ public void testGetValidUri(){
     	assertFalse(v.isValidURI("test", "http://core-jenkins.scansafe.cisco.com/佐贺诺伦-^ńörén.jpg", false));
     }
     
+    public void testGetValidUriNullInput(){
+    	Validator v = ESAPI.validator();
+    	boolean isValid = v.isValidURI("test", null, true);
+    	assertTrue(isValid);
+    }
+    
     public void testGetCanonicalizedUri() throws Exception {
     	Validator v = ESAPI.validator();
     	
@@ -1169,5 +1175,19 @@ public void testGetCanonicalizedUri() throws Exception {
     	assertEquals(expectedUri, v.getCanonicalizedURI(uri));
     	
     }
+    
+    public void testGetCanonicalizedUriWithMailto() throws Exception {
+    	Validator v = ESAPI.validator();
+    	
+    	String expectedUri = "http://palpatine@foo bar.com/path_to/resource?foo=bar#frag";
+    	//Please note that section 3.2.1 of RFC-3986 explicitly states not to encode
+    	//password information as in http://palpatine:password@foo.com, and this will
+    	//not appear in the userinfo field.  
+    	String input = "http://palpatine@foo%20bar.com/path_to/resource?foo=bar#frag";
+    	URI uri = new URI(input);
+    	System.out.println(uri.toString());
+    	assertEquals(expectedUri, v.getCanonicalizedURI(uri));
+    	
+    }
 }
 
diff --git a/src/test/resources/urisForTest.txt b/src/test/resources/urisForTest.txt
index 2f28b60a1..43f795e3d 100644
--- a/src/test/resources/urisForTest.txt
+++ b/src/test/resources/urisForTest.txt
@@ -1,3 +1,4 @@
+#Format is URI,Expected test value
 https://127.0.0.1:8080/foo/bar,TRUE
 http://shareasale.com:8080/sem/fusce.xml?sed=sodales&tristique=scelerisque,TRUE
 http://shareasale.com/sem/fusce.xml?sed=sodales&tristique=scelerisque,TRUE

From c126de7b24c5a72008433f87162eb1a19eb7ce70 Mon Sep 17 00:00:00 2001
From: Matt Seil 
Date: Sat, 17 Jun 2017 14:41:28 -0700
Subject: [PATCH 402/812] Issue #376 -- Addressed Kevin Wall's CR comment
 regarding the deprecated Security Configuration issue.

---
 .../java/org/owasp/esapi/reference/DefaultValidator.java    | 6 ++----
 1 file changed, 2 insertions(+), 4 deletions(-)

diff --git a/src/main/java/org/owasp/esapi/reference/DefaultValidator.java b/src/main/java/org/owasp/esapi/reference/DefaultValidator.java
index 02595f5d2..0c29ba579 100644
--- a/src/main/java/org/owasp/esapi/reference/DefaultValidator.java
+++ b/src/main/java/org/owasp/esapi/reference/DefaultValidator.java
@@ -1307,10 +1307,8 @@ public String getCanonicalizedURI(URI dirtyUri) throws IntrusionException{
 		Set set = parseMap.keySet();
 		
 		SecurityConfiguration sg = ESAPI.securityConfiguration();
-//		boolean restrictMixed = sg.getBooleanProp("AllowMixedEncoding");
-//		boolean restrictMultiple = sg.getBooleanProp("AllowMultipleEncoding");
-		boolean allowMixed = sg.getAllowMixedEncoding();
-		boolean allowMultiple = sg.getAllowMultipleEncoding();
+		boolean allowMixed = sg.getBooleanProp("Encoder.AllowMixedEncoding");
+		boolean allowMultiple = sg.getBooleanProp("Encoder.AllowMultipleEncoding");
 		for(UriSegment seg: set){
 			String value = encoder.canonicalize(parseMap.get(seg), allowMultiple, allowMixed);
 			value = value == null ? "" : value;

From 4ef0a497e1aa75c74e4e2e9476255b6f25f52181 Mon Sep 17 00:00:00 2001
From: Matt Seil 
Date: Sun, 18 Jun 2017 15:22:31 -0700
Subject: [PATCH 403/812] Issue 376 -- Added missed null check on regex
 pattern.

---
 .../org/owasp/esapi/reference/DefaultValidator.java  | 12 ++++++++----
 1 file changed, 8 insertions(+), 4 deletions(-)

diff --git a/src/main/java/org/owasp/esapi/reference/DefaultValidator.java b/src/main/java/org/owasp/esapi/reference/DefaultValidator.java
index 0c29ba579..9b5197824 100644
--- a/src/main/java/org/owasp/esapi/reference/DefaultValidator.java
+++ b/src/main/java/org/owasp/esapi/reference/DefaultValidator.java
@@ -1222,10 +1222,14 @@ public boolean isValidURI(String context, String input, boolean allowNull) {
 				//This part will use the regex from validation.properties.  This regex should be super-simple, and 
 				//used mainly to restrict certain parts of a URL.  
 				Pattern p = ESAPI.securityConfiguration().getValidationPattern( "URL" );
-				//We're doing this instead of using the normal validator API, because it will canonicalize the input again
-				//and if the URI has any queries that also happen to match HTML entities, like ¶
-				//it will cease conforming to the regex we now specify for a URL.
-				isValid = p.matcher(canonicalizedURI).matches();
+				if(p != null){
+					//We're doing this instead of using the normal validator API, because it will canonicalize the input again
+					//and if the URI has any queries that also happen to match HTML entities, like ¶
+					//it will cease conforming to the regex we now specify for a URL.
+					isValid = p.matcher(canonicalizedURI).matches();
+				}else{
+					logger.error(Logger.EVENT_FAILURE, "Invalid regex pulled from configuration.  Check the regex for URL and correct.");
+				}
 			}else{
 				if(allowNull && inputIsNullOrEmpty ){
 					isValid = true;

From 1895c821231d6cab8e9c529ae17873177a14e577 Mon Sep 17 00:00:00 2001
From: Matt Seil 
Date: Sun, 18 Jun 2017 15:29:03 -0700
Subject: [PATCH 404/812] Issue #376 -- Addressed comment about the RFC-3986
 link.

---
 src/main/java/org/owasp/esapi/Validator.java | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/main/java/org/owasp/esapi/Validator.java b/src/main/java/org/owasp/esapi/Validator.java
index 7db159d94..c01dae247 100644
--- a/src/main/java/org/owasp/esapi/Validator.java
+++ b/src/main/java/org/owasp/esapi/Validator.java
@@ -694,7 +694,7 @@ public interface Validator {
 	 * the kind of regex required for subsequent validation to mitigate regex-based 
 	 * DoS attacks.  
 	 * 
-	 * @see https://www.ietf.org/rfc/rfc3986.txt
+	 * @see RFC-3986.
 	 * 
  	 *	@param context
 	 *  		A descriptive name of the parameter that you are validating (e.g., LoginPage_UsernameField). This value is used by any logging or error handling that is done with respect to the value passed in.

From 8e3b5736b2bc05a1d11c9d0054404ff76a718db1 Mon Sep 17 00:00:00 2001
From: Matt Seil 
Date: Sun, 18 Jun 2017 15:49:54 -0700
Subject: [PATCH 405/812] Issue 316 -- updated code to account for httpOnly and
 Secure ccookie options.

---
 .../owasp/esapi/reference/DefaultHTTPUtilities.java  | 12 +++++++++++-
 1 file changed, 11 insertions(+), 1 deletion(-)

diff --git a/src/main/java/org/owasp/esapi/reference/DefaultHTTPUtilities.java b/src/main/java/org/owasp/esapi/reference/DefaultHTTPUtilities.java
index 3c460c872..659e1cc4e 100644
--- a/src/main/java/org/owasp/esapi/reference/DefaultHTTPUtilities.java
+++ b/src/main/java/org/owasp/esapi/reference/DefaultHTTPUtilities.java
@@ -41,6 +41,7 @@
 import org.owasp.esapi.ESAPI;
 import org.owasp.esapi.HTTPUtilities;
 import org.owasp.esapi.Logger;
+import org.owasp.esapi.SecurityConfiguration;
 import org.owasp.esapi.StringUtilities;
 import org.owasp.esapi.User;
 import org.owasp.esapi.ValidationErrorList;
@@ -929,6 +930,9 @@ public String setRememberToken( HttpServletRequest request, HttpServletResponse
 			String clearToken = user.getAccountName() + "|" + password;
 			long expiry = ESAPI.encryptor().getRelativeTimeStamp(maxAge * 1000);
 			String cryptToken = ESAPI.encryptor().seal(clearToken, expiry);
+			SecurityConfiguration sg = ESAPI.securityConfiguration();
+			boolean forceSecureCookies = sg.getBooleanProp("HttpUtilities.ForceSecureCookies");
+			boolean forceHttpOnly = sg.getBooleanProp("HttpUtilities.ForceHttpOnlyCookies");
 
             // Do NOT URLEncode cryptToken before creating cookie. See Google Issue # 144,
 			// which was marked as "WontFix".
@@ -937,6 +941,8 @@ public String setRememberToken( HttpServletRequest request, HttpServletResponse
 			cookie.setMaxAge( maxAge );
 			cookie.setDomain( domain );
 			cookie.setPath( path );
+			cookie.setHttpOnly(forceHttpOnly);
+			cookie.setSecure(forceSecureCookies);
 			response.addCookie( cookie );
 			logger.info(Logger.SECURITY_SUCCESS, "Enabled remember me token for " + user.getAccountName() );
 			return cryptToken;
@@ -957,7 +963,9 @@ public String setRememberToken(HttpServletRequest request, HttpServletResponse r
 			String clearToken = user.getAccountName();
 			long expiry = ESAPI.encryptor().getRelativeTimeStamp(maxAge * 1000);
 			String cryptToken = ESAPI.encryptor().seal(clearToken, expiry);
-
+			SecurityConfiguration sg = ESAPI.securityConfiguration();
+			boolean forceSecureCookies = sg.getBooleanProp("HttpUtilities.ForceSecureCookies");
+			boolean forceHttpOnly = sg.getBooleanProp("HttpUtilities.ForceHttpOnlyCookies");
             // Do NOT URLEncode cryptToken before creating cookie. See Google Issue # 144,
 			// which was marked as "WontFix".
 
@@ -965,6 +973,8 @@ public String setRememberToken(HttpServletRequest request, HttpServletResponse r
 			cookie.setMaxAge( maxAge );
 			cookie.setDomain( domain );
 			cookie.setPath( path );
+			cookie.setHttpOnly(forceHttpOnly);
+			cookie.setSecure(forceSecureCookies);
 			response.addCookie( cookie );
 			logger.info(Logger.SECURITY_SUCCESS, "Enabled remember me token for " + user.getAccountName() );
 		} catch( IntegrityException e){

From 22663ed9ab5f17ddebe28e22d6ecaf6223763e21 Mon Sep 17 00:00:00 2001
From: Matt Seil 
Date: Sun, 18 Jun 2017 16:22:19 -0700
Subject: [PATCH 406/812] Issue 291 -- Closed due to Issue #376 resolving the
 original problem.

---
 src/test/resources/urisForTest.txt | 1 +
 1 file changed, 1 insertion(+)

diff --git a/src/test/resources/urisForTest.txt b/src/test/resources/urisForTest.txt
index 43f795e3d..df34cbc8e 100644
--- a/src/test/resources/urisForTest.txt
+++ b/src/test/resources/urisForTest.txt
@@ -1,4 +1,5 @@
 #Format is URI,Expected test value
+http://www.google.com?connectid=68470072-44c2-417b-822b-d945dc0364f4&request=GetFeature&service=wfs&version=1.1.0&typeName=DigitalGlobe%3AFinishedFeature&bbox=37.5%2C41.5%2C37.8%2C41.7&PROPERTYNAME=source%2CsourceUnit%2CproductType,FALSE
 https://127.0.0.1:8080/foo/bar,TRUE
 http://shareasale.com:8080/sem/fusce.xml?sed=sodales&tristique=scelerisque,TRUE
 http://shareasale.com/sem/fusce.xml?sed=sodales&tristique=scelerisque,TRUE

From e5ebcab94a60ecf8a9c513ac61d8e99ac91b74f5 Mon Sep 17 00:00:00 2001
From: Matt Seil 
Date: Sun, 18 Jun 2017 16:42:05 -0700
Subject: [PATCH 407/812] Issue #394 -- Refactor the URI canonicalization into
 the Encoder class.

---
 src/main/java/org/owasp/esapi/Encoder.java    |  12 ++
 src/main/java/org/owasp/esapi/Validator.java  |  11 --
 .../owasp/esapi/reference/DefaultEncoder.java | 154 ++++++++++++++++++
 .../esapi/reference/DefaultValidator.java     | 150 +----------------
 .../owasp/esapi/reference/EncoderTest.java    |  28 ++++
 .../owasp/esapi/reference/ValidatorTest.java  |  28 ----
 6 files changed, 196 insertions(+), 187 deletions(-)

diff --git a/src/main/java/org/owasp/esapi/Encoder.java b/src/main/java/org/owasp/esapi/Encoder.java
index 2d2bfb7b9..cf83c472c 100644
--- a/src/main/java/org/owasp/esapi/Encoder.java
+++ b/src/main/java/org/owasp/esapi/Encoder.java
@@ -16,6 +16,7 @@
 package org.owasp.esapi;
 
 import java.io.IOException;
+import java.net.URI;
 
 import org.owasp.esapi.codecs.Codec;
 import org.owasp.esapi.errors.EncodingException;
@@ -513,4 +514,15 @@ public interface Encoder {
 	 */
 	byte[] decodeFromBase64(String input) throws IOException;
 
+	/**
+	 * 
+	 * Get a version of the input URI that will be safe to run regex and other validations against.  
+	 * It is not recommended to persist this value as it will transform user input.  This method 
+	 * will not test to see if the URI is RFC-3986 compliant.
+	 * 
+	 * @param input
+	 * @return
+	 */
+	public String getCanonicalizedURI(URI dirtyUri);
+
 }
diff --git a/src/main/java/org/owasp/esapi/Validator.java b/src/main/java/org/owasp/esapi/Validator.java
index c01dae247..12c87ea15 100644
--- a/src/main/java/org/owasp/esapi/Validator.java
+++ b/src/main/java/org/owasp/esapi/Validator.java
@@ -708,17 +708,6 @@ public interface Validator {
 	 */
 	boolean isValidURI(String context, String input, boolean allowNull);
 
-	/**
-	 * 
-	 * Get a version of the input URI that will be safe to run regex and other validations against.  
-	 * It is not recommended to persist this value as it will transform user input.  This method 
-	 * will not test to see if the URI is RFC-3986 compliant.
-	 * 
-	 * @param input
-	 * @return
-	 */
-	public String getCanonicalizedURI(URI dirtyUri);
-	
 	/**
 	 * Will return a {@code URI} object that will represent a fully parsed and legal URI
 	 * as specified in RFC-3986.  
diff --git a/src/main/java/org/owasp/esapi/reference/DefaultEncoder.java b/src/main/java/org/owasp/esapi/reference/DefaultEncoder.java
index c40c0d60b..c24fac4b5 100644
--- a/src/main/java/org/owasp/esapi/reference/DefaultEncoder.java
+++ b/src/main/java/org/owasp/esapi/reference/DefaultEncoder.java
@@ -17,15 +17,23 @@
 
 import java.io.IOException;
 import java.io.UnsupportedEncodingException;
+import java.net.URI;
 import java.net.URLDecoder;
 import java.net.URLEncoder;
 import java.util.ArrayList;
+import java.util.EnumMap;
 import java.util.Iterator;
+import java.util.LinkedHashMap;
+import java.util.LinkedList;
 import java.util.List;
+import java.util.Map;
+import java.util.Map.Entry;
+import java.util.Set;
 
 import org.owasp.esapi.ESAPI;
 import org.owasp.esapi.Encoder;
 import org.owasp.esapi.Logger;
+import org.owasp.esapi.SecurityConfiguration;
 import org.owasp.esapi.codecs.Base64;
 import org.owasp.esapi.codecs.CSSCodec;
 import org.owasp.esapi.codecs.Codec;
@@ -445,4 +453,150 @@ public byte[] decodeFromBase64(String input) throws IOException {
 		}
 		return Base64.decode( input );
 	}
+	
+	/**
+	 * {@inheritDoc}
+	 * 
+	 * This will extract each piece of a URI according to parse zone as specified in RFC-3986 section 3, 
+	 * and it will construct a canonicalized String representing a version of the URI that is safe to 
+	 * run regex against. 
+	 * 
+	 * @param dirtyUri
+	 * @return Canonicalized URI string.
+	 * @throws IntrusionException
+	 */
+	public String getCanonicalizedURI(URI dirtyUri) throws IntrusionException{
+		
+//		From RFC-3986 section 3		
+//	      URI         = scheme ":" hier-part [ "?" query ] [ "#" fragment ]
+//
+//	    	      hier-part   = "//" authority path-abempty
+//	    	                  / path-absolute
+//	    	                  / path-rootless
+//	    	                  / path-empty
+		
+//		   The following are two example URIs and their component parts:
+//
+//		         foo://example.com:8042/over/there?name=ferret#nose
+//		         \_/   \______________/\_________/ \_________/ \__/
+//		          |           |            |            |        |
+//		       scheme     authority       path        query   fragment
+//		          |   _____________________|__
+//		         / \ /                        \
+//		         urn:example:animal:ferret:nose
+		Map parseMap = new EnumMap(UriSegment.class);
+		parseMap.put(UriSegment.SCHEME, dirtyUri.getScheme());
+		//authority   = [ userinfo "@" ] host [ ":" port ]
+		parseMap.put(UriSegment.AUTHORITY, dirtyUri.getRawAuthority());
+		parseMap.put(UriSegment.SCHEMSPECIFICPART, dirtyUri.getRawSchemeSpecificPart());
+		parseMap.put(UriSegment.HOST, dirtyUri.getHost());
+		//if port is undefined, it will return -1
+		Integer port = new Integer(dirtyUri.getPort());
+		parseMap.put(UriSegment.PORT, port == -1 ? "": port.toString());
+		parseMap.put(UriSegment.PATH, dirtyUri.getRawPath());
+		parseMap.put(UriSegment.QUERY, dirtyUri.getRawQuery());
+		parseMap.put(UriSegment.FRAGMENT, dirtyUri.getRawFragment());
+		
+		//Now we canonicalize each part and build our string.  
+		StringBuilder sb = new StringBuilder();
+		
+		//Replace all the items in the map with canonicalized versions.
+		
+		Set set = parseMap.keySet();
+		
+		SecurityConfiguration sg = ESAPI.securityConfiguration();
+		boolean allowMixed = sg.getBooleanProp("Encoder.AllowMixedEncoding");
+		boolean allowMultiple = sg.getBooleanProp("Encoder.AllowMultipleEncoding");
+		for(UriSegment seg: set){
+			String value = canonicalize(parseMap.get(seg), allowMultiple, allowMixed);
+			value = value == null ? "" : value;
+			//In the case of a uri query, we need to break up and canonicalize the internal parts of the query.
+			if(seg == UriSegment.QUERY && null != parseMap.get(seg)){
+				StringBuilder qBuilder = new StringBuilder();
+				try {
+					Map> canonicalizedMap = this.splitQuery(dirtyUri);
+					Set>> query = canonicalizedMap.entrySet();
+					Iterator>> i = query.iterator();
+					while(i.hasNext()){
+						Entry> e = i.next(); 
+						String key = (String) e.getKey();
+						String qVal = "";
+						List list = (List) e.getValue();
+						if(!list.isEmpty()){
+							qVal = list.get(0);
+						}
+						qBuilder.append(key)
+						.append("=")
+						.append(qVal);
+						
+						if(i.hasNext()){
+							qBuilder.append("&");
+						}
+					}
+					value = qBuilder.toString();
+				} catch (UnsupportedEncodingException e) {
+					logger.debug(Logger.EVENT_FAILURE, "decoding error when parsing [" + dirtyUri.toString() + "]");
+				}
+			}
+			//Check if the port is -1, if it is, omit it from the output.
+			if(seg == UriSegment.PORT){
+				if("-1" == parseMap.get(seg)){
+					value = "";
+				}
+			}
+			parseMap.put(seg, value );
+		}
+		
+		return buildUrl(parseMap);
+	}
+	
+	/**
+	 * All the parts should be canonicalized by this point.  This is straightforward assembly.  
+	 * 
+	 * @param set
+	 * @return
+	 */
+	protected String buildUrl(Map parseMap){
+		StringBuilder sb = new StringBuilder();
+		sb.append(parseMap.get(UriSegment.SCHEME))
+		.append("://")
+		//can't use SCHEMESPECIFICPART for this, because we need to canonicalize all the parts of the query.
+		//USERINFO is also deprecated.  So we technically have more than we need.  
+		.append(parseMap.get(UriSegment.AUTHORITY) == null || parseMap.get(UriSegment.AUTHORITY).equals("") ? "" : parseMap.get(UriSegment.AUTHORITY))
+		.append(parseMap.get(UriSegment.PATH) == null || parseMap.get(UriSegment.PATH).equals("") ? ""  : parseMap.get(UriSegment.PATH))
+		.append(parseMap.get(UriSegment.QUERY) == null || parseMap.get(UriSegment.QUERY).equals("") 
+				? "" : "?" + parseMap.get(UriSegment.QUERY))
+		.append((parseMap.get(UriSegment.FRAGMENT) == null) || parseMap.get(UriSegment.FRAGMENT).equals("")
+				? "": "#" + parseMap.get(UriSegment.FRAGMENT))
+		;
+		return sb.toString();
+	}
+	
+	public enum UriSegment {
+		AUTHORITY, SCHEME, SCHEMSPECIFICPART, USERINFO, HOST, PORT, PATH, QUERY, FRAGMENT
+	}
+	
+	
+	/**
+	 * The meat of this method was taken from StackOverflow:  http://stackoverflow.com/a/13592567/557153
+	 * It has been modified to return a canonicalized key and value pairing.  
+	 * 
+	 * @param java URI
+	 * @return a map of canonicalized query parameters.  
+	 * @throws UnsupportedEncodingException
+	 */
+	public Map> splitQuery(URI uri) throws UnsupportedEncodingException {
+	  final Map> query_pairs = new LinkedHashMap>();
+	  final String[] pairs = uri.getQuery().split("&");
+	  for (String pair : pairs) {
+	    final int idx = pair.indexOf("=");
+	    final String key = idx > 0 ? canonicalize(pair.substring(0, idx)) : pair;
+	    if (!query_pairs.containsKey(key)) {
+	      query_pairs.put(key, new LinkedList());
+	    }
+	    final String value = idx > 0 && pair.length() > idx + 1 ? URLDecoder.decode(pair.substring(idx + 1), "UTF-8") : null;
+	    query_pairs.get(key).add(canonicalize(value));
+	  }
+	  return query_pairs;
+	}
 }
diff --git a/src/main/java/org/owasp/esapi/reference/DefaultValidator.java b/src/main/java/org/owasp/esapi/reference/DefaultValidator.java
index 9b5197824..7b45f1d26 100644
--- a/src/main/java/org/owasp/esapi/reference/DefaultValidator.java
+++ b/src/main/java/org/owasp/esapi/reference/DefaultValidator.java
@@ -1210,11 +1210,11 @@ private final boolean isEmpty(char[] input) {
 	public boolean isValidURI(String context, String input, boolean allowNull) {
 		boolean isValid = false;
 		boolean inputIsNullOrEmpty = input == null || "".equals(input);
-		
+		Encoder encoder = ESAPI.encoder();
 		try{
 			URI compliantURI = null == input ? new URI("") :  this.getRfcCompliantURI(input);
 			if(null != compliantURI && input != null){
-				String canonicalizedURI = getCanonicalizedURI(compliantURI);
+				String canonicalizedURI = encoder.getCanonicalizedURI(compliantURI);
 				//if getCanonicalizedURI doesn't throw an IntrusionException, then the URI contains no mixed or 
 				//double-encoding attacks.  
 				logger.debug(Logger.SECURITY_SUCCESS, "We did not detect any mixed or multiple encoding in the uri:[" + input + "]");
@@ -1259,150 +1259,4 @@ public URI getRfcCompliantURI(String input){
 		}
 		return rval;
 	}
-	
-	/**
-	 * {@inheritDoc}
-	 * 
-	 * This will extract each piece of a URI according to parse zone as specified in RFC-3986 section 3, 
-	 * and it will construct a canonicalized String representing a version of the URI that is safe to 
-	 * run regex against. 
-	 * 
-	 * @param dirtyUri
-	 * @return Canonicalized URI string.
-	 * @throws IntrusionException
-	 */
-	public String getCanonicalizedURI(URI dirtyUri) throws IntrusionException{
-		
-//		From RFC-3986 section 3		
-//	      URI         = scheme ":" hier-part [ "?" query ] [ "#" fragment ]
-//
-//	    	      hier-part   = "//" authority path-abempty
-//	    	                  / path-absolute
-//	    	                  / path-rootless
-//	    	                  / path-empty
-		
-//		   The following are two example URIs and their component parts:
-//
-//		         foo://example.com:8042/over/there?name=ferret#nose
-//		         \_/   \______________/\_________/ \_________/ \__/
-//		          |           |            |            |        |
-//		       scheme     authority       path        query   fragment
-//		          |   _____________________|__
-//		         / \ /                        \
-//		         urn:example:animal:ferret:nose
-		Map parseMap = new EnumMap(UriSegment.class);
-		parseMap.put(UriSegment.SCHEME, dirtyUri.getScheme());
-		//authority   = [ userinfo "@" ] host [ ":" port ]
-		parseMap.put(UriSegment.AUTHORITY, dirtyUri.getRawAuthority());
-		parseMap.put(UriSegment.SCHEMSPECIFICPART, dirtyUri.getRawSchemeSpecificPart());
-		parseMap.put(UriSegment.HOST, dirtyUri.getHost());
-		//if port is undefined, it will return -1
-		Integer port = new Integer(dirtyUri.getPort());
-		parseMap.put(UriSegment.PORT, port == -1 ? "": port.toString());
-		parseMap.put(UriSegment.PATH, dirtyUri.getRawPath());
-		parseMap.put(UriSegment.QUERY, dirtyUri.getRawQuery());
-		parseMap.put(UriSegment.FRAGMENT, dirtyUri.getRawFragment());
-		
-		//Now we canonicalize each part and build our string.  
-		StringBuilder sb = new StringBuilder();
-		
-		//Replace all the items in the map with canonicalized versions.
-		
-		Set set = parseMap.keySet();
-		
-		SecurityConfiguration sg = ESAPI.securityConfiguration();
-		boolean allowMixed = sg.getBooleanProp("Encoder.AllowMixedEncoding");
-		boolean allowMultiple = sg.getBooleanProp("Encoder.AllowMultipleEncoding");
-		for(UriSegment seg: set){
-			String value = encoder.canonicalize(parseMap.get(seg), allowMultiple, allowMixed);
-			value = value == null ? "" : value;
-			//In the case of a uri query, we need to break up and canonicalize the internal parts of the query.
-			if(seg == UriSegment.QUERY && null != parseMap.get(seg)){
-				StringBuilder qBuilder = new StringBuilder();
-				try {
-					Map> canonicalizedMap = this.splitQuery(dirtyUri);
-					Set>> query = canonicalizedMap.entrySet();
-					Iterator>> i = query.iterator();
-					while(i.hasNext()){
-						Entry> e = i.next(); 
-						String key = (String) e.getKey();
-						String qVal = "";
-						List list = (List) e.getValue();
-						if(!list.isEmpty()){
-							qVal = list.get(0);
-						}
-						qBuilder.append(key)
-						.append("=")
-						.append(qVal);
-						
-						if(i.hasNext()){
-							qBuilder.append("&");
-						}
-					}
-					value = qBuilder.toString();
-				} catch (UnsupportedEncodingException e) {
-					logger.debug(Logger.EVENT_FAILURE, "decoding error when parsing [" + dirtyUri.toString() + "]");
-				}
-			}
-			//Check if the port is -1, if it is, omit it from the output.
-			if(seg == UriSegment.PORT){
-				if("-1" == parseMap.get(seg)){
-					value = "";
-				}
-			}
-			parseMap.put(seg, value );
-		}
-		
-		return buildUrl(parseMap);
-	}
-	
-/**
- * The meat of this method was taken from StackOverflow:  http://stackoverflow.com/a/13592567/557153
- * It has been modified to return a canonicalized key and value pairing.  
- * 
- * @param java URI
- * @return a map of canonicalized query parameters.  
- * @throws UnsupportedEncodingException
- */
-	public Map> splitQuery(URI uri) throws UnsupportedEncodingException {
-	  final Map> query_pairs = new LinkedHashMap>();
-	  final String[] pairs = uri.getQuery().split("&");
-	  for (String pair : pairs) {
-	    final int idx = pair.indexOf("=");
-	    final String key = idx > 0 ? encoder.canonicalize(pair.substring(0, idx)) : pair;
-	    if (!query_pairs.containsKey(key)) {
-	      query_pairs.put(key, new LinkedList());
-	    }
-	    final String value = idx > 0 && pair.length() > idx + 1 ? URLDecoder.decode(pair.substring(idx + 1), "UTF-8") : null;
-	    query_pairs.get(key).add(encoder.canonicalize(value));
-	  }
-	  return query_pairs;
-	}
-	
-	public enum UriSegment {
-		AUTHORITY, SCHEME, SCHEMSPECIFICPART, USERINFO, HOST, PORT, PATH, QUERY, FRAGMENT
-	}
-	
-	/**
-	 * All the parts should be canonicalized by this point.  This is straightforward assembly.  
-	 * 
-	 * @param set
-	 * @return
-	 */
-	protected String buildUrl(Map parseMap){
-		StringBuilder sb = new StringBuilder();
-		sb.append(parseMap.get(UriSegment.SCHEME))
-		.append("://")
-		//can't use SCHEMESPECIFICPART for this, because we need to canonicalize all the parts of the query.
-		//USERINFO is also deprecated.  So we technically have more than we need.  
-		.append(parseMap.get(UriSegment.AUTHORITY) == null || parseMap.get(UriSegment.AUTHORITY).equals("") ? "" : parseMap.get(UriSegment.AUTHORITY))
-		.append(parseMap.get(UriSegment.PATH) == null || parseMap.get(UriSegment.PATH).equals("") ? ""  : parseMap.get(UriSegment.PATH))
-		.append(parseMap.get(UriSegment.QUERY) == null || parseMap.get(UriSegment.QUERY).equals("") 
-				? "" : "?" + parseMap.get(UriSegment.QUERY))
-		.append((parseMap.get(UriSegment.FRAGMENT) == null) || parseMap.get(UriSegment.FRAGMENT).equals("")
-				? "": "#" + parseMap.get(UriSegment.FRAGMENT))
-		;
-		return sb.toString();
-	}
-	
 }
diff --git a/src/test/java/org/owasp/esapi/reference/EncoderTest.java b/src/test/java/org/owasp/esapi/reference/EncoderTest.java
index bc2e1afde..e7979af4c 100644
--- a/src/test/java/org/owasp/esapi/reference/EncoderTest.java
+++ b/src/test/java/org/owasp/esapi/reference/EncoderTest.java
@@ -17,6 +17,7 @@
 
 import java.io.IOException;
 import java.io.UnsupportedEncodingException;
+import java.net.URI;
 import java.util.ArrayList;
 import java.util.Arrays;
 import java.io.ByteArrayOutputStream;
@@ -854,5 +855,32 @@ public String javaScriptEncode(String str) {
 		}
     }
     
+    public void testGetCanonicalizedUri() throws Exception {
+    	Encoder e = ESAPI.encoder();
+    	
+    	String expectedUri = "http://palpatine@foo bar.com/path_to/resource?foo=bar#frag";
+    	//Please note that section 3.2.1 of RFC-3986 explicitly states not to encode
+    	//password information as in http://palpatine:password@foo.com, and this will
+    	//not appear in the userinfo field.  
+    	String input = "http://palpatine@foo%20bar.com/path_to/resource?foo=bar#frag";
+    	URI uri = new URI(input);
+    	System.out.println(uri.toString());
+    	assertEquals(expectedUri, e.getCanonicalizedURI(uri));
+    	
+    }
+    
+    public void testGetCanonicalizedUriWithMailto() throws Exception {
+    	Encoder e = ESAPI.encoder();
+    	
+    	String expectedUri = "http://palpatine@foo bar.com/path_to/resource?foo=bar#frag";
+    	//Please note that section 3.2.1 of RFC-3986 explicitly states not to encode
+    	//password information as in http://palpatine:password@foo.com, and this will
+    	//not appear in the userinfo field.  
+    	String input = "http://palpatine@foo%20bar.com/path_to/resource?foo=bar#frag";
+    	URI uri = new URI(input);
+    	System.out.println(uri.toString());
+    	assertEquals(expectedUri, e.getCanonicalizedURI(uri));
+    	
+    }
 }
 
diff --git a/src/test/java/org/owasp/esapi/reference/ValidatorTest.java b/src/test/java/org/owasp/esapi/reference/ValidatorTest.java
index 614d25f1f..7df1227b0 100644
--- a/src/test/java/org/owasp/esapi/reference/ValidatorTest.java
+++ b/src/test/java/org/owasp/esapi/reference/ValidatorTest.java
@@ -1161,33 +1161,5 @@ public void testGetValidUriNullInput(){
     	boolean isValid = v.isValidURI("test", null, true);
     	assertTrue(isValid);
     }
-    
-    public void testGetCanonicalizedUri() throws Exception {
-    	Validator v = ESAPI.validator();
-    	
-    	String expectedUri = "http://palpatine@foo bar.com/path_to/resource?foo=bar#frag";
-    	//Please note that section 3.2.1 of RFC-3986 explicitly states not to encode
-    	//password information as in http://palpatine:password@foo.com, and this will
-    	//not appear in the userinfo field.  
-    	String input = "http://palpatine@foo%20bar.com/path_to/resource?foo=bar#frag";
-    	URI uri = new URI(input);
-    	System.out.println(uri.toString());
-    	assertEquals(expectedUri, v.getCanonicalizedURI(uri));
-    	
-    }
-    
-    public void testGetCanonicalizedUriWithMailto() throws Exception {
-    	Validator v = ESAPI.validator();
-    	
-    	String expectedUri = "http://palpatine@foo bar.com/path_to/resource?foo=bar#frag";
-    	//Please note that section 3.2.1 of RFC-3986 explicitly states not to encode
-    	//password information as in http://palpatine:password@foo.com, and this will
-    	//not appear in the userinfo field.  
-    	String input = "http://palpatine@foo%20bar.com/path_to/resource?foo=bar#frag";
-    	URI uri = new URI(input);
-    	System.out.println(uri.toString());
-    	assertEquals(expectedUri, v.getCanonicalizedURI(uri));
-    	
-    }
 }
 

From c97f70735b30b41cf4f6147b4893acf3d61795c8 Mon Sep 17 00:00:00 2001
From: Matt Seil 
Date: Sat, 1 Jul 2017 12:26:02 -0700
Subject: [PATCH 408/812] Issue #397 -- Restore search directory to maintain
 legacy search behavior.

---
 .../DefaultSecurityConfiguration.java         | 33 ++++++++++++++-----
 1 file changed, 25 insertions(+), 8 deletions(-)

diff --git a/src/main/java/org/owasp/esapi/reference/DefaultSecurityConfiguration.java b/src/main/java/org/owasp/esapi/reference/DefaultSecurityConfiguration.java
index 22b0f2067..1d59f2b24 100644
--- a/src/main/java/org/owasp/esapi/reference/DefaultSecurityConfiguration.java
+++ b/src/main/java/org/owasp/esapi/reference/DefaultSecurityConfiguration.java
@@ -15,6 +15,23 @@
  */
 package org.owasp.esapi.reference;
 
+import java.io.File;
+import java.io.FileInputStream;
+import java.io.FileNotFoundException;
+import java.io.IOException;
+import java.io.InputStream;
+import java.net.URL;
+import java.util.ArrayList;
+import java.util.Arrays;
+import java.util.Collections;
+import java.util.HashMap;
+import java.util.Iterator;
+import java.util.List;
+import java.util.Map;
+import java.util.Properties;
+import java.util.regex.Pattern;
+import java.util.regex.PatternSyntaxException;
+
 import org.apache.commons.lang.text.StrTokenizer;
 import org.owasp.esapi.ESAPI;
 import org.owasp.esapi.Logger;
@@ -22,12 +39,6 @@
 import org.owasp.esapi.configuration.EsapiPropertyManager;
 import org.owasp.esapi.errors.ConfigurationException;
 
-import java.io.*;
-import java.net.URL;
-import java.util.*;
-import java.util.regex.Pattern;
-import java.util.regex.PatternSyntaxException;
-
 /**
  * The reference {@code SecurityConfiguration} manages all the settings used by the ESAPI in a single place. In this reference
  * implementation, resources can be put in several locations, which are searched in the following order:
@@ -653,8 +664,14 @@ private Properties loadConfigurationFromClasspath(String fileName) throws Illega
 					
 					// try resources folder
 					if (in == null) {
-						currentClasspathSearchLocation = "src/main/resources/";
-						in = currentLoader.getResourceAsStream("src/main/resources/" + fileName);
+						currentClasspathSearchLocation = "resources/";
+						in = currentLoader.getResourceAsStream("resources/" + fileName);
+					}
+					
+					// try src/main/resources folder
+					if (in == null) {
+						currentClasspathSearchLocation = "resources/";
+						in = currentLoader.getResourceAsStream("resources/" + fileName);
 					}
 		
 					// now load the properties

From 26911a1da4577622c0f9f60f96004c5c25fc8988 Mon Sep 17 00:00:00 2001
From: JoelRabinovitch 
Date: Mon, 3 Jul 2017 13:14:53 -0400
Subject: [PATCH 409/812] Issue #389 (#390)

* Issue #389

Overloaded the encodeForLDAP method to provide the option of not
encoding wildcard (*) characters.

This would be used when doing queries against an LDAP directory using
wildcards, while at the same time, encoding other potentially dangerous
characters.

* Issue #389

Renamed the escapeWildcards variable to encodeWildcards to be consistent
with the interface definition.
---
 src/main/java/org/owasp/esapi/Encoder.java    | 14 +++++-
 .../owasp/esapi/reference/DefaultEncoder.java | 45 +++++++++++--------
 .../owasp/esapi/reference/EncoderTest.java    | 14 +++++-
 3 files changed, 52 insertions(+), 21 deletions(-)

diff --git a/src/main/java/org/owasp/esapi/Encoder.java b/src/main/java/org/owasp/esapi/Encoder.java
index 2d2bfb7b9..a1a850b62 100644
--- a/src/main/java/org/owasp/esapi/Encoder.java
+++ b/src/main/java/org/owasp/esapi/Encoder.java
@@ -369,7 +369,7 @@ public interface Encoder {
 	String encodeForOS(Codec codec, String input);
 
 	/**
-	 * Encode data for use in LDAP queries.
+	 * Encode data for use in LDAP queries. Wildcard (*) characters will be encoded.
 	 * 
 	 * @param input 
 	 * 		the text to encode for LDAP
@@ -378,6 +378,18 @@ public interface Encoder {
 	 */
 	String encodeForLDAP(String input);
 
+	/**
+	 * Encode data for use in LDAP queries. You have the option whether or not to encode wildcard (*) characters.
+	 * 
+	 * @param input 
+	 * 		the text to encode for LDAP
+	 * @param encodeWildcards 
+	 *      whether or not wildcard (*) characters will be encoded.
+     *
+	 * @return input encoded for use in LDAP
+	 */
+	String encodeForLDAP(String input, boolean encodeWildcards);
+	 
 	/**
 	 * Encode data for use in an LDAP distinguished name.
 	 * 
diff --git a/src/main/java/org/owasp/esapi/reference/DefaultEncoder.java b/src/main/java/org/owasp/esapi/reference/DefaultEncoder.java
index c40c0d60b..3e0ea4f50 100644
--- a/src/main/java/org/owasp/esapi/reference/DefaultEncoder.java
+++ b/src/main/java/org/owasp/esapi/reference/DefaultEncoder.java
@@ -281,6 +281,13 @@ public String encodeForOS(Codec codec, String input) {
 	 * {@inheritDoc}
 	 */
 	public String encodeForLDAP(String input) {
+		return encodeForLDAP(input, true);
+	}
+	
+	/**
+	 * {@inheritDoc}
+	 */
+	public String encodeForLDAP(String input, boolean encodeWildcards) {
 	    if( input == null ) {
 	    	return null;	
 	    }
@@ -288,25 +295,25 @@ public String encodeForLDAP(String input) {
 	    StringBuilder sb = new StringBuilder();
 		for (int i = 0; i < input.length(); i++) {
 			char c = input.charAt(i);
-			switch (c) {
-			case '\\':
-				sb.append("\\5c");
-				break;
-			case '*':
-				sb.append("\\2a");
-				break;
-			case '(':
-				sb.append("\\28");
-				break;
-			case ')':
-				sb.append("\\29");
-				break;
-			case '\0':
-				sb.append("\\00");
-				break;
-			default:
-				sb.append(c);
-			}
+
+			if (c == '\\') {
+	            sb.append("\\5c");
+	        }
+	        else if ((c == '*') && encodeWildcards) {
+	            sb.append("\\2a");
+	        }
+	        else if (c == '(') {
+	            sb.append("\\28");
+	        }
+	        else if (c == ')') {
+	            sb.append("\\29");
+	        }
+	        else if (c == '\0') {
+	            sb.append("\\00");
+	        }
+	        else {
+	            sb.append(c);
+	        }
 		}
 		return sb.toString();
 	}
diff --git a/src/test/java/org/owasp/esapi/reference/EncoderTest.java b/src/test/java/org/owasp/esapi/reference/EncoderTest.java
index bc2e1afde..c4ebd900f 100644
--- a/src/test/java/org/owasp/esapi/reference/EncoderTest.java
+++ b/src/test/java/org/owasp/esapi/reference/EncoderTest.java
@@ -471,7 +471,19 @@ public void testEncodeForLDAP() {
     }
     
     /**
-	 * Test of encodeForLDAP method, of class org.owasp.esapi.Encoder.
+	 * Test of encodeForLDAP method with without encoding wildcard characters, of class org.owasp.esapi.Encoder.
+	 */
+    public void testEncodeForLDAPWithoutEncodingWildcards() {
+        System.out.println("encodeForLDAPWithoutEncodingWildcards");
+        Encoder instance = ESAPI.encoder();
+        assertEquals(null, instance.encodeForLDAP(null, false));
+        assertEquals("No special characters to escape", "Hi This is a test #��", instance.encodeForLDAP("Hi This is a test #��", false));
+        assertEquals("Zeros", "Hi \\00", instance.encodeForLDAP("Hi \u0000", false));
+        assertEquals("LDAP Christams Tree", "Hi \\28This\\29 = is * a \\5c test # � � �", instance.encodeForLDAP("Hi (This) = is * a \\ test # � � �", false));
+    }
+    
+    /**
+	 * Test of encodeForDN method, of class org.owasp.esapi.Encoder.
 	 */
     public void testEncodeForDN() {
         System.out.println("encodeForDN");

From 603408f73173145258e8677d0e1364d2e60c876e Mon Sep 17 00:00:00 2001
From: Matt Seil 
Date: Sat, 15 Jul 2017 12:07:52 -0700
Subject: [PATCH 410/812] Issue #399 -- Fixed mvn site so that the build no
 longer breaks on legacy javadoc comments.

---
 pom.xml | 35 ++++++++++++++++++++++++++++++++++-
 1 file changed, 34 insertions(+), 1 deletion(-)

diff --git a/pom.xml b/pom.xml
index 224f1f5c7..fd8551117 100644
--- a/pom.xml
+++ b/pom.xml
@@ -309,7 +309,7 @@
             
                 org.codehaus.mojo
                 findbugs-maven-plugin
-                2.5.5
+                3.0.4
                 
                     true
                     true
@@ -412,6 +412,39 @@
     
 
     
+        
+          doclint-java8-disable
+          
+            [1.8,)
+          
+          
+            
+              
+                org.apache.maven.plugins
+                maven-javadoc-plugin
+                
+                  -Xdoclint:none
+                
+              
+              
+                org.apache.maven.plugins
+                maven-site-plugin
+                3.4
+                
+                  
+                    
+                      org.apache.maven.plugins
+                      maven-javadoc-plugin
+                      
+                        -Xdoclint:none
+                      
+                    
+                  
+                
+              
+            
+          
+        
         
             
             dist

From a607dba2112bffcf005fdb8c9b2d4e08391e05ca Mon Sep 17 00:00:00 2001
From: Matt Seil 
Date: Sat, 15 Jul 2017 12:24:19 -0700
Subject: [PATCH 411/812] Issue #316 -- Fixed error where I got rid of
 src/main/resources and also updated the unit test to use non-deprecated
 asserts.

---
 .../DefaultSecurityConfiguration.java         |   4 +-
 .../DefaultSecurityConfigurationTest.java     | 193 +++++++++---------
 2 files changed, 101 insertions(+), 96 deletions(-)

diff --git a/src/main/java/org/owasp/esapi/reference/DefaultSecurityConfiguration.java b/src/main/java/org/owasp/esapi/reference/DefaultSecurityConfiguration.java
index 1d59f2b24..861fced2b 100644
--- a/src/main/java/org/owasp/esapi/reference/DefaultSecurityConfiguration.java
+++ b/src/main/java/org/owasp/esapi/reference/DefaultSecurityConfiguration.java
@@ -670,8 +670,8 @@ private Properties loadConfigurationFromClasspath(String fileName) throws Illega
 					
 					// try src/main/resources folder
 					if (in == null) {
-						currentClasspathSearchLocation = "resources/";
-						in = currentLoader.getResourceAsStream("resources/" + fileName);
+						currentClasspathSearchLocation = "src/main/resources/";
+						in = currentLoader.getResourceAsStream("src/main/resources/" + fileName);
 					}
 		
 					// now load the properties
diff --git a/src/test/java/org/owasp/esapi/reference/DefaultSecurityConfigurationTest.java b/src/test/java/org/owasp/esapi/reference/DefaultSecurityConfigurationTest.java
index 0a7654871..fed8647af 100644
--- a/src/test/java/org/owasp/esapi/reference/DefaultSecurityConfigurationTest.java
+++ b/src/test/java/org/owasp/esapi/reference/DefaultSecurityConfigurationTest.java
@@ -1,8 +1,13 @@
 package org.owasp.esapi.reference;
 
-import java.util.regex.Pattern;
+import static org.junit.Assert.assertEquals;
+import static org.junit.Assert.assertFalse;
+import static org.junit.Assert.assertNotNull;
+import static org.junit.Assert.assertNull;
+import static org.junit.Assert.assertTrue;
+import static org.junit.Assert.fail;
 
-import junit.framework.Assert;
+import java.util.regex.Pattern;
 
 import org.junit.Test;
 import org.owasp.esapi.ESAPI;
@@ -21,139 +26,139 @@ private DefaultSecurityConfiguration createWithProperty(String key, String val)
 	public void testGetApplicationName() {
 		final String expected = "ESAPI_UnitTests";
 		DefaultSecurityConfiguration secConf = this.createWithProperty(DefaultSecurityConfiguration.APPLICATION_NAME, expected);
-		Assert.assertEquals(expected, secConf.getApplicationName());
+		assertEquals(expected, secConf.getApplicationName());
 	}
 	
 	@Test
 	public void testGetLogImplementation() {
 		//test the default
 		DefaultSecurityConfiguration secConf = new DefaultSecurityConfiguration(new java.util.Properties());
-		Assert.assertEquals(DefaultSecurityConfiguration.DEFAULT_LOG_IMPLEMENTATION, secConf.getLogImplementation());
+		assertEquals(DefaultSecurityConfiguration.DEFAULT_LOG_IMPLEMENTATION, secConf.getLogImplementation());
 		
 		final String expected = "TestLogger";
 		secConf = this.createWithProperty(DefaultSecurityConfiguration.LOG_IMPLEMENTATION, expected);
-		Assert.assertEquals(expected, secConf.getLogImplementation());
+		assertEquals(expected, secConf.getLogImplementation());
 	}
 	
 	@Test
 	public void testAuthenticationImplementation() {
 		//test the default
 		DefaultSecurityConfiguration secConf = new DefaultSecurityConfiguration(new java.util.Properties());
-		Assert.assertEquals(DefaultSecurityConfiguration.DEFAULT_AUTHENTICATION_IMPLEMENTATION, secConf.getAuthenticationImplementation());
+		assertEquals(DefaultSecurityConfiguration.DEFAULT_AUTHENTICATION_IMPLEMENTATION, secConf.getAuthenticationImplementation());
 		
 		final String expected = "TestAuthentication";
 		secConf = this.createWithProperty(DefaultSecurityConfiguration.AUTHENTICATION_IMPLEMENTATION, expected);
-		Assert.assertEquals(expected, secConf.getAuthenticationImplementation());
+		assertEquals(expected, secConf.getAuthenticationImplementation());
 	}
 	
 	@Test
 	public void testEncoderImplementation() {
 		//test the default
 		DefaultSecurityConfiguration secConf = new DefaultSecurityConfiguration(new java.util.Properties());
-		Assert.assertEquals(DefaultSecurityConfiguration.DEFAULT_ENCODER_IMPLEMENTATION, secConf.getEncoderImplementation());
+		assertEquals(DefaultSecurityConfiguration.DEFAULT_ENCODER_IMPLEMENTATION, secConf.getEncoderImplementation());
 		
 		final String expected = "TestEncoder";
 		secConf = this.createWithProperty(DefaultSecurityConfiguration.ENCODER_IMPLEMENTATION, expected);
-		Assert.assertEquals(expected, secConf.getEncoderImplementation());
+		assertEquals(expected, secConf.getEncoderImplementation());
 	}
 	
 	@Test
 	public void testAccessControlImplementation() {
 		//test the default
 		DefaultSecurityConfiguration secConf = new DefaultSecurityConfiguration(new java.util.Properties());
-		Assert.assertEquals(DefaultSecurityConfiguration.DEFAULT_ACCESS_CONTROL_IMPLEMENTATION, secConf.getAccessControlImplementation());
+		assertEquals(DefaultSecurityConfiguration.DEFAULT_ACCESS_CONTROL_IMPLEMENTATION, secConf.getAccessControlImplementation());
 		
 		final String expected = "TestAccessControl";
 		secConf = this.createWithProperty(DefaultSecurityConfiguration.ACCESS_CONTROL_IMPLEMENTATION, expected);
-		Assert.assertEquals(expected, secConf.getAccessControlImplementation());
+		assertEquals(expected, secConf.getAccessControlImplementation());
 	}
 	
 	@Test
 	public void testEncryptionImplementation() {
 		//test the default
 		DefaultSecurityConfiguration secConf = new DefaultSecurityConfiguration(new java.util.Properties());
-		Assert.assertEquals(DefaultSecurityConfiguration.DEFAULT_ENCRYPTION_IMPLEMENTATION, secConf.getEncryptionImplementation());
+		assertEquals(DefaultSecurityConfiguration.DEFAULT_ENCRYPTION_IMPLEMENTATION, secConf.getEncryptionImplementation());
 		
 		final String expected = "TestEncryption";
 		secConf = this.createWithProperty(DefaultSecurityConfiguration.ENCRYPTION_IMPLEMENTATION, expected);
-		Assert.assertEquals(expected, secConf.getEncryptionImplementation());
+		assertEquals(expected, secConf.getEncryptionImplementation());
 	}
 	
 	@Test
 	public void testIntrusionDetectionImplementation() {
 		//test the default
 		DefaultSecurityConfiguration secConf = new DefaultSecurityConfiguration(new java.util.Properties());
-		Assert.assertEquals(DefaultSecurityConfiguration.DEFAULT_INTRUSION_DETECTION_IMPLEMENTATION, secConf.getIntrusionDetectionImplementation());
+		assertEquals(DefaultSecurityConfiguration.DEFAULT_INTRUSION_DETECTION_IMPLEMENTATION, secConf.getIntrusionDetectionImplementation());
 		
 		final String expected = "TestIntrusionDetection";
 		secConf = this.createWithProperty(DefaultSecurityConfiguration.INTRUSION_DETECTION_IMPLEMENTATION, expected);
-		Assert.assertEquals(expected, secConf.getIntrusionDetectionImplementation());
+		assertEquals(expected, secConf.getIntrusionDetectionImplementation());
 	}
 	
 	@Test
 	public void testRandomizerImplementation() {
 		//test the default
 		DefaultSecurityConfiguration secConf = new DefaultSecurityConfiguration(new java.util.Properties());
-		Assert.assertEquals(DefaultSecurityConfiguration.DEFAULT_RANDOMIZER_IMPLEMENTATION, secConf.getRandomizerImplementation());
+		assertEquals(DefaultSecurityConfiguration.DEFAULT_RANDOMIZER_IMPLEMENTATION, secConf.getRandomizerImplementation());
 		
 		final String expected = "TestRandomizer";
 		secConf = this.createWithProperty(DefaultSecurityConfiguration.RANDOMIZER_IMPLEMENTATION, expected);
-		Assert.assertEquals(expected, secConf.getRandomizerImplementation());
+		assertEquals(expected, secConf.getRandomizerImplementation());
 	}
 	
 	@Test
 	public void testExecutorImplementation() {
 		//test the default
 		DefaultSecurityConfiguration secConf = new DefaultSecurityConfiguration(new java.util.Properties());
-		Assert.assertEquals(DefaultSecurityConfiguration.DEFAULT_EXECUTOR_IMPLEMENTATION, secConf.getExecutorImplementation());
+		assertEquals(DefaultSecurityConfiguration.DEFAULT_EXECUTOR_IMPLEMENTATION, secConf.getExecutorImplementation());
 		
 		final String expected = "TestExecutor";
 		secConf = this.createWithProperty(DefaultSecurityConfiguration.EXECUTOR_IMPLEMENTATION, expected);
-		Assert.assertEquals(expected, secConf.getExecutorImplementation());
+		assertEquals(expected, secConf.getExecutorImplementation());
 	}
 	
 	@Test
 	public void testHTTPUtilitiesImplementation() {
 		//test the default
 		DefaultSecurityConfiguration secConf = new DefaultSecurityConfiguration(new java.util.Properties());
-		Assert.assertEquals(DefaultSecurityConfiguration.DEFAULT_HTTP_UTILITIES_IMPLEMENTATION, secConf.getHTTPUtilitiesImplementation());
+		assertEquals(DefaultSecurityConfiguration.DEFAULT_HTTP_UTILITIES_IMPLEMENTATION, secConf.getHTTPUtilitiesImplementation());
 		
 		final String expected = "TestHTTPUtilities";
 		secConf = this.createWithProperty(DefaultSecurityConfiguration.HTTP_UTILITIES_IMPLEMENTATION, expected);
-		Assert.assertEquals(expected, secConf.getHTTPUtilitiesImplementation());
+		assertEquals(expected, secConf.getHTTPUtilitiesImplementation());
 	}
 	
 	@Test
 	public void testValidationImplementation() {
 		//test the default
 		DefaultSecurityConfiguration secConf = new DefaultSecurityConfiguration(new java.util.Properties());
-		Assert.assertEquals(DefaultSecurityConfiguration.DEFAULT_VALIDATOR_IMPLEMENTATION, secConf.getValidationImplementation());
+		assertEquals(DefaultSecurityConfiguration.DEFAULT_VALIDATOR_IMPLEMENTATION, secConf.getValidationImplementation());
 		
 		final String expected = "TestValidation";
 		secConf = this.createWithProperty(DefaultSecurityConfiguration.VALIDATOR_IMPLEMENTATION, expected);
-		Assert.assertEquals(expected, secConf.getValidationImplementation());
+		assertEquals(expected, secConf.getValidationImplementation());
 	}
 	
 	@Test
 	public void testGetEncryptionKeyLength() {
 		// test the default
 		DefaultSecurityConfiguration secConf = new DefaultSecurityConfiguration(new java.util.Properties());
-		Assert.assertEquals(128, secConf.getEncryptionKeyLength());
+		assertEquals(128, secConf.getEncryptionKeyLength());
 		
 		final int expected = 256;
 		secConf = this.createWithProperty(DefaultSecurityConfiguration.KEY_LENGTH, String.valueOf(expected));
-		Assert.assertEquals(expected, secConf.getEncryptionKeyLength());
+		assertEquals(expected, secConf.getEncryptionKeyLength());
 	}
 	
 	@Test
 	public void testGetKDFPseudoRandomFunction() {
 		// test the default
 		DefaultSecurityConfiguration secConf = new DefaultSecurityConfiguration(new java.util.Properties());
-		Assert.assertEquals("HmacSHA256", secConf.getKDFPseudoRandomFunction());
+		assertEquals("HmacSHA256", secConf.getKDFPseudoRandomFunction());
 		
 		final String expected = "HmacSHA1";
 		secConf = this.createWithProperty(DefaultSecurityConfiguration.KDF_PRF_ALG, expected);
-		Assert.assertEquals(expected, secConf.getKDFPseudoRandomFunction());
+		assertEquals(expected, secConf.getKDFPseudoRandomFunction());
 	}
 	
 	@Test
@@ -161,10 +166,10 @@ public void testGetMasterSalt() {
 		try {
 			DefaultSecurityConfiguration secConf = new DefaultSecurityConfiguration(new java.util.Properties());
 			secConf.getMasterSalt();
-			Assert.fail("Expected Exception not thrown");
+			fail("Expected Exception not thrown");
 		}
 		catch (ConfigurationException ce) {
-			Assert.assertNotNull(ce.getMessage());
+			assertNotNull(ce.getMessage());
 		}
 		
 		final String salt = "53081";
@@ -172,7 +177,7 @@ public void testGetMasterSalt() {
 		java.util.Properties properties = new java.util.Properties();
 		properties.setProperty(DefaultSecurityConfiguration.MASTER_SALT, property);
 		DefaultSecurityConfiguration secConf = new DefaultSecurityConfiguration(properties);
-		Assert.assertEquals(salt, new String(secConf.getMasterSalt()));
+		assertEquals(salt, new String(secConf.getMasterSalt()));
 	}
 	
 	@Test
@@ -181,21 +186,21 @@ public void testGetAllowedExecutables() {
 		java.util.List allowedExecutables = secConf.getAllowedExecutables();
 		
 		//is this really what should be returned? what about an empty list?
-		Assert.assertEquals(1, allowedExecutables.size());
-		Assert.assertEquals("", allowedExecutables.get(0));
+		assertEquals(1, allowedExecutables.size());
+		assertEquals("", allowedExecutables.get(0));
 		
 		
 		java.util.Properties properties = new java.util.Properties();
 		properties.setProperty(DefaultSecurityConfiguration.APPROVED_EXECUTABLES, String.valueOf("/bin/bzip2,/bin/diff, /bin/cvs"));
 		secConf = new DefaultSecurityConfiguration(properties);
 		allowedExecutables = secConf.getAllowedExecutables();
-		Assert.assertEquals(3, allowedExecutables.size());
-		Assert.assertEquals("/bin/bzip2", allowedExecutables.get(0));
-		Assert.assertEquals("/bin/diff", allowedExecutables.get(1));
+		assertEquals(3, allowedExecutables.size());
+		assertEquals("/bin/bzip2", allowedExecutables.get(0));
+		assertEquals("/bin/diff", allowedExecutables.get(1));
 		
 		//this seems less than optimal, maybe each value should have a trim() done to it
 		//at least we know that this behavior exists, the property should'nt have spaces between values
-		Assert.assertEquals(" /bin/cvs", allowedExecutables.get(2));
+		assertEquals(" /bin/cvs", allowedExecutables.get(2));
 	}
 	
 	@Test
@@ -203,189 +208,189 @@ public void testGetAllowedFileExtensions() {
 		
 		DefaultSecurityConfiguration secConf = new DefaultSecurityConfiguration(new java.util.Properties());
 		java.util.List allowedFileExtensions = secConf.getAllowedFileExtensions();
-		Assert.assertFalse(allowedFileExtensions.isEmpty());
+		assertFalse(allowedFileExtensions.isEmpty());
 		
 		
 		java.util.Properties properties = new java.util.Properties();
 		properties.setProperty(DefaultSecurityConfiguration.APPROVED_UPLOAD_EXTENSIONS, String.valueOf(".txt,.xml,.html,.png"));
 		secConf = new DefaultSecurityConfiguration(properties);
 		allowedFileExtensions = secConf.getAllowedFileExtensions();
-		Assert.assertEquals(4, allowedFileExtensions.size());
-		Assert.assertEquals(".html", allowedFileExtensions.get(2));
+		assertEquals(4, allowedFileExtensions.size());
+		assertEquals(".html", allowedFileExtensions.get(2));
 	}
 	
 	@Test
 	public void testGetAllowedFileUploadSize() {
 		DefaultSecurityConfiguration secConf = new DefaultSecurityConfiguration(new java.util.Properties());
 		//assert that the default is of some reasonable size
-		Assert.assertTrue(secConf.getAllowedFileUploadSize() > (1024 * 100));
+		assertTrue(secConf.getAllowedFileUploadSize() > (1024 * 100));
 		
 		final int expected = (1024 * 1000);
 		secConf = this.createWithProperty(DefaultSecurityConfiguration.MAX_UPLOAD_FILE_BYTES, String.valueOf(expected));
-		Assert.assertEquals(expected, secConf.getAllowedFileUploadSize());
+		assertEquals(expected, secConf.getAllowedFileUploadSize());
 	}
 	
 	@Test
 	public void testGetParameterNames() {
 		//test the default
 		DefaultSecurityConfiguration secConf = new DefaultSecurityConfiguration(new java.util.Properties());
-		Assert.assertEquals("password", secConf.getPasswordParameterName());
-		Assert.assertEquals("username", secConf.getUsernameParameterName());
+		assertEquals("password", secConf.getPasswordParameterName());
+		assertEquals("username", secConf.getUsernameParameterName());
 		
 		java.util.Properties properties = new java.util.Properties();
 		properties.setProperty(DefaultSecurityConfiguration.PASSWORD_PARAMETER_NAME, "j_password");
 		properties.setProperty(DefaultSecurityConfiguration.USERNAME_PARAMETER_NAME, "j_username");
 		secConf = new DefaultSecurityConfiguration(properties);
-		Assert.assertEquals("j_password", secConf.getPasswordParameterName());
-		Assert.assertEquals("j_username", secConf.getUsernameParameterName());
+		assertEquals("j_password", secConf.getPasswordParameterName());
+		assertEquals("j_username", secConf.getUsernameParameterName());
 	}
 	
 	@Test
 	public void testGetEncryptionAlgorithm() {
 		//test the default
 		DefaultSecurityConfiguration secConf = new DefaultSecurityConfiguration(new java.util.Properties());
-		Assert.assertEquals("AES", secConf.getEncryptionAlgorithm());
+		assertEquals("AES", secConf.getEncryptionAlgorithm());
 		
 		secConf = this.createWithProperty(DefaultSecurityConfiguration.ENCRYPTION_ALGORITHM, "3DES");
-		Assert.assertEquals("3DES", secConf.getEncryptionAlgorithm());
+		assertEquals("3DES", secConf.getEncryptionAlgorithm());
 	}
 	
 	@Test
 	public void testGetCipherXProperties() {
 		DefaultSecurityConfiguration secConf = new DefaultSecurityConfiguration(new java.util.Properties());
-		Assert.assertEquals("AES/CBC/PKCS5Padding", secConf.getCipherTransformation());
-		//Assert.assertEquals("AES/CBC/PKCS5Padding", secConf.getC);
+		assertEquals("AES/CBC/PKCS5Padding", secConf.getCipherTransformation());
+		//assertEquals("AES/CBC/PKCS5Padding", secConf.getC);
 		
 		java.util.Properties properties = new java.util.Properties();
 		properties.setProperty(DefaultSecurityConfiguration.CIPHER_TRANSFORMATION_IMPLEMENTATION, "Blowfish/CFB/ISO10126Padding");
 		secConf = new DefaultSecurityConfiguration(properties);
-		Assert.assertEquals("Blowfish/CFB/ISO10126Padding", secConf.getCipherTransformation());
+		assertEquals("Blowfish/CFB/ISO10126Padding", secConf.getCipherTransformation());
 		
 		secConf.setCipherTransformation("DESede/PCBC/PKCS5Padding");
-		Assert.assertEquals("DESede/PCBC/PKCS5Padding", secConf.getCipherTransformation());
+		assertEquals("DESede/PCBC/PKCS5Padding", secConf.getCipherTransformation());
 		
 		secConf.setCipherTransformation(null);//sets it back to default
-		Assert.assertEquals("Blowfish/CFB/ISO10126Padding", secConf.getCipherTransformation());
+		assertEquals("Blowfish/CFB/ISO10126Padding", secConf.getCipherTransformation());
 	}
 	
 	@Test
 	public void testIV() {
 		DefaultSecurityConfiguration secConf = new DefaultSecurityConfiguration(new java.util.Properties());
-		Assert.assertEquals("random", secConf.getIVType());
+		assertEquals("random", secConf.getIVType());
 		try {
 			secConf.getFixedIV();
-			Assert.fail();
+			fail();
 		}
 		catch (ConfigurationException ce) {
-			Assert.assertNotNull(ce.getMessage());
+			assertNotNull(ce.getMessage());
 		}
 		
 		java.util.Properties properties = new java.util.Properties();
 		properties.setProperty(DefaultSecurityConfiguration.IV_TYPE, "fixed");
 		properties.setProperty(DefaultSecurityConfiguration.FIXED_IV, "ivValue");
 		secConf = new DefaultSecurityConfiguration(properties);
-		Assert.assertEquals("fixed", secConf.getIVType());
-		Assert.assertEquals("ivValue", secConf.getFixedIV());
+		assertEquals("fixed", secConf.getIVType());
+		assertEquals("ivValue", secConf.getFixedIV());
 		
 		properties.setProperty(DefaultSecurityConfiguration.IV_TYPE, "illegal");
 		secConf = new DefaultSecurityConfiguration(properties);
 		try {
 			secConf.getIVType();
-			Assert.fail();
+			fail();
 		}
 		catch (ConfigurationException ce) {
-			Assert.assertNotNull(ce.getMessage());
+			assertNotNull(ce.getMessage());
 		}
 		try {
 			secConf.getFixedIV();
-			Assert.fail();
+			fail();
 		}
 		catch (ConfigurationException ce) {
-			Assert.assertNotNull(ce.getMessage());
+			assertNotNull(ce.getMessage());
 		}
 	}
 	
 	@Test
 	public void testGetAllowMultipleEncoding() {
 		DefaultSecurityConfiguration secConf = new DefaultSecurityConfiguration(new java.util.Properties());
-		Assert.assertFalse(secConf.getAllowMultipleEncoding());
+		assertFalse(secConf.getAllowMultipleEncoding());
 		
 		secConf = this.createWithProperty(DefaultSecurityConfiguration.ALLOW_MULTIPLE_ENCODING, "yes");
-		Assert.assertTrue(secConf.getAllowMultipleEncoding());
+		assertTrue(secConf.getAllowMultipleEncoding());
 		
 		secConf = this.createWithProperty(DefaultSecurityConfiguration.ALLOW_MULTIPLE_ENCODING, "true");
-		Assert.assertTrue(secConf.getAllowMultipleEncoding());
+		assertTrue(secConf.getAllowMultipleEncoding());
 		
 		secConf = this.createWithProperty(DefaultSecurityConfiguration.ALLOW_MULTIPLE_ENCODING, "no");
-		Assert.assertFalse(secConf.getAllowMultipleEncoding());
+		assertFalse(secConf.getAllowMultipleEncoding());
 	}
 	
 	@Test
 	public void testGetDefaultCanonicalizationCodecs() {
 		DefaultSecurityConfiguration secConf = new DefaultSecurityConfiguration(new java.util.Properties());
-		Assert.assertFalse(secConf.getDefaultCanonicalizationCodecs().isEmpty());
+		assertFalse(secConf.getDefaultCanonicalizationCodecs().isEmpty());
 		
 		String property = "org.owasp.esapi.codecs.TestCodec1,org.owasp.esapi.codecs.TestCodec2";
 		secConf = this.createWithProperty(DefaultSecurityConfiguration.CANONICALIZATION_CODECS, property);
-		Assert.assertTrue(secConf.getDefaultCanonicalizationCodecs().contains("org.owasp.esapi.codecs.TestCodec1"));
+		assertTrue(secConf.getDefaultCanonicalizationCodecs().contains("org.owasp.esapi.codecs.TestCodec1"));
 	}
 	
 	@Test
 	public void testGetDisableIntrusionDetection() {
 		DefaultSecurityConfiguration secConf = new DefaultSecurityConfiguration(new java.util.Properties());
-		Assert.assertFalse(secConf.getDisableIntrusionDetection());
+		assertFalse(secConf.getDisableIntrusionDetection());
 		
 		secConf = this.createWithProperty(DefaultSecurityConfiguration.DISABLE_INTRUSION_DETECTION, "TRUE");
-		Assert.assertTrue(secConf.getDisableIntrusionDetection());
+		assertTrue(secConf.getDisableIntrusionDetection());
 		
 		secConf = this.createWithProperty(DefaultSecurityConfiguration.DISABLE_INTRUSION_DETECTION, "true");
-		Assert.assertTrue(secConf.getDisableIntrusionDetection());
+		assertTrue(secConf.getDisableIntrusionDetection());
 		
 		secConf = this.createWithProperty(DefaultSecurityConfiguration.DISABLE_INTRUSION_DETECTION, "false");
-		Assert.assertFalse(secConf.getDisableIntrusionDetection());
+		assertFalse(secConf.getDisableIntrusionDetection());
 	}
 	
 	@Test
 	public void testGetLogLevel() {
 		DefaultSecurityConfiguration secConf = new DefaultSecurityConfiguration(new java.util.Properties());
-		Assert.assertEquals(Logger.WARNING, secConf.getLogLevel());
+		assertEquals(Logger.WARNING, secConf.getLogLevel());
 		
 		secConf = this.createWithProperty(DefaultSecurityConfiguration.LOG_LEVEL, "trace");
-		Assert.assertEquals(Logger.TRACE, secConf.getLogLevel());
+		assertEquals(Logger.TRACE, secConf.getLogLevel());
 		
 		secConf = this.createWithProperty(DefaultSecurityConfiguration.LOG_LEVEL, "Off");
-		Assert.assertEquals(Logger.OFF, secConf.getLogLevel());
+		assertEquals(Logger.OFF, secConf.getLogLevel());
 		
 		secConf = this.createWithProperty(DefaultSecurityConfiguration.LOG_LEVEL, "all");
-		Assert.assertEquals(Logger.ALL, secConf.getLogLevel());
+		assertEquals(Logger.ALL, secConf.getLogLevel());
 		
 		secConf = this.createWithProperty(DefaultSecurityConfiguration.LOG_LEVEL, "DEBUG");
-		Assert.assertEquals(Logger.DEBUG, secConf.getLogLevel());
+		assertEquals(Logger.DEBUG, secConf.getLogLevel());
 		
 		secConf = this.createWithProperty(DefaultSecurityConfiguration.LOG_LEVEL, "info");
-		Assert.assertEquals(Logger.INFO, secConf.getLogLevel());
+		assertEquals(Logger.INFO, secConf.getLogLevel());
 		
 		secConf = this.createWithProperty(DefaultSecurityConfiguration.LOG_LEVEL, "ERROR");
-		Assert.assertEquals(Logger.ERROR, secConf.getLogLevel());
+		assertEquals(Logger.ERROR, secConf.getLogLevel());
 	}
 	
 	@Test
 	public void testGetLogFileName() {
 		DefaultSecurityConfiguration secConf = new DefaultSecurityConfiguration(new java.util.Properties());
-		Assert.assertEquals("ESAPI_logging_file", secConf.getLogFileName());
+		assertEquals("ESAPI_logging_file", secConf.getLogFileName());
 		
 		secConf = this.createWithProperty(DefaultSecurityConfiguration.LOG_FILE_NAME, "log.txt");
-		Assert.assertEquals("log.txt", secConf.getLogFileName());
+		assertEquals("log.txt", secConf.getLogFileName());
 	}
 	
 	@Test
 	public void testGetMaxLogFileSize() {
 		DefaultSecurityConfiguration secConf = new DefaultSecurityConfiguration(new java.util.Properties());
-		Assert.assertEquals(DefaultSecurityConfiguration.DEFAULT_MAX_LOG_FILE_SIZE, secConf.getMaxLogFileSize());
+		assertEquals(DefaultSecurityConfiguration.DEFAULT_MAX_LOG_FILE_SIZE, secConf.getMaxLogFileSize());
 		
 		int maxLogSize = (1024 * 1000);
 		secConf = this.createWithProperty(DefaultSecurityConfiguration.MAX_LOG_FILE_SIZE, String.valueOf(maxLogSize));
-		Assert.assertEquals(maxLogSize, secConf.getMaxLogFileSize());
+		assertEquals(maxLogSize, secConf.getMaxLogFileSize());
 	}
 	
 	private String patternOrNull(Pattern p){
@@ -395,24 +400,24 @@ private String patternOrNull(Pattern p){
 	@Test
 	public void testValidationsPropertiesFileOptions(){
 		DefaultSecurityConfiguration secConf = new DefaultSecurityConfiguration("ESAPI-SingleValidatorFileChecker.properties");
-		Assert.assertEquals(patternOrNull(secConf.getValidationPattern("Test1")), "ValueFromFile1");
-		Assert.assertNull(secConf.getValidationPattern("Test2"));
-		Assert.assertNull(secConf.getValidationPattern("TestC"));
+		assertEquals(patternOrNull(secConf.getValidationPattern("Test1")), "ValueFromFile1");
+		assertNull(secConf.getValidationPattern("Test2"));
+		assertNull(secConf.getValidationPattern("TestC"));
 		
 		secConf = new DefaultSecurityConfiguration("ESAPI-DualValidatorFileChecker.properties");
-		Assert.assertEquals(patternOrNull(secConf.getValidationPattern("Test1")), "ValueFromFile1");
-		Assert.assertEquals(patternOrNull(secConf.getValidationPattern("Test2")), "ValueFromFile2");
-		Assert.assertNull(secConf.getValidationPattern("TestC"));
+		assertEquals(patternOrNull(secConf.getValidationPattern("Test1")), "ValueFromFile1");
+		assertEquals(patternOrNull(secConf.getValidationPattern("Test2")), "ValueFromFile2");
+		assertNull(secConf.getValidationPattern("TestC"));
 
 		secConf = new DefaultSecurityConfiguration("ESAPI-CommaValidatorFileChecker.properties");
-		Assert.assertEquals(patternOrNull(secConf.getValidationPattern("TestC")), "ValueFromCommaFile");
-		Assert.assertNull(secConf.getValidationPattern("Test1"));
-		Assert.assertNull(secConf.getValidationPattern("Test2"));
+		assertEquals(patternOrNull(secConf.getValidationPattern("TestC")), "ValueFromCommaFile");
+		assertNull(secConf.getValidationPattern("Test1"));
+		assertNull(secConf.getValidationPattern("Test2"));
 
 		secConf = new DefaultSecurityConfiguration("ESAPI-QuotedValidatorFileChecker.properties");
-		Assert.assertEquals(patternOrNull(secConf.getValidationPattern("Test1")), "ValueFromFile1");
-		Assert.assertEquals(patternOrNull(secConf.getValidationPattern("Test2")), "ValueFromFile2");
-		Assert.assertEquals(patternOrNull(secConf.getValidationPattern("TestC")), "ValueFromCommaFile");
+		assertEquals(patternOrNull(secConf.getValidationPattern("Test1")), "ValueFromFile1");
+		assertEquals(patternOrNull(secConf.getValidationPattern("Test2")), "ValueFromFile2");
+		assertEquals(patternOrNull(secConf.getValidationPattern("TestC")), "ValueFromCommaFile");
 	}
 	
 }

From 283753841aa927eb535ddfddb5c899fd7721d39d Mon Sep 17 00:00:00 2001
From: Matt Seil 
Date: Sat, 15 Jul 2017 19:21:21 -0700
Subject: [PATCH 412/812] Issue #316 -- Added unit test to ensure search
 directory changes are adequately updated in the future, and upped JVM
 compliance level to 1.7 since we already decided that 1.6 is more than
 defunct.

---
 .../DefaultSecurityConfiguration.java         | 34 +++++++++++++++----
 .../DefaultSecurityConfigurationTest.java     | 17 ++++++++++
 2 files changed, 45 insertions(+), 6 deletions(-)

diff --git a/src/main/java/org/owasp/esapi/reference/DefaultSecurityConfiguration.java b/src/main/java/org/owasp/esapi/reference/DefaultSecurityConfiguration.java
index 861fced2b..a1f551e7d 100644
--- a/src/main/java/org/owasp/esapi/reference/DefaultSecurityConfiguration.java
+++ b/src/main/java/org/owasp/esapi/reference/DefaultSecurityConfiguration.java
@@ -642,36 +642,36 @@ private Properties loadConfigurationFromClasspath(String fileName) throws Illega
 				try {
 					// try root
 					String currentClasspathSearchLocation = "/ (root)";
-					in = loaders[i].getResourceAsStream(fileName);
+					in = loaders[i].getResourceAsStream(DefaultSearchPath.ROOT.toString());
 					
 					// try resourceDirectory folder
 					if (in == null) {
 						currentClasspathSearchLocation = resourceDirectory + "/";
-						in = currentLoader.getResourceAsStream(resourceDirectory + "/" + fileName);
+						in = currentLoader.getResourceAsStream(DefaultSearchPath.RESOURCE_DIRECTORY + fileName);
 					}
 
 					// try .esapi folder. Look here first for backward compatibility.
 					if (in == null) {
 						currentClasspathSearchLocation = ".esapi/";
-						in = currentLoader.getResourceAsStream(".esapi/" + fileName);
+						in = currentLoader.getResourceAsStream(DefaultSearchPath.DOT_ESAPI + fileName);
 					} 
 					
 					// try esapi folder (new directory)
 					if (in == null) {
 						currentClasspathSearchLocation = "esapi/";
-						in = currentLoader.getResourceAsStream("esapi/" + fileName);
+						in = currentLoader.getResourceAsStream(DefaultSearchPath.ESAPI + fileName);
 					} 
 					
 					// try resources folder
 					if (in == null) {
 						currentClasspathSearchLocation = "resources/";
-						in = currentLoader.getResourceAsStream("resources/" + fileName);
+						in = currentLoader.getResourceAsStream(DefaultSearchPath.RESOURCES + fileName);
 					}
 					
 					// try src/main/resources folder
 					if (in == null) {
 						currentClasspathSearchLocation = "src/main/resources/";
-						in = currentLoader.getResourceAsStream("src/main/resources/" + fileName);
+						in = currentLoader.getResourceAsStream(DefaultSearchPath.SRC_MAIN_RESOURCES + fileName);
 					}
 		
 					// now load the properties
@@ -1347,4 +1347,26 @@ protected boolean shouldPrintProperties() {
     protected Properties getESAPIProperties() {
         return properties;
     }
+    
+    public enum DefaultSearchPath {
+    	
+    	RESOURCE_DIRECTORY("resourceDirectory/"),
+    	SRC_MAIN_RESOURCES("src/main/resources/"),
+    	ROOT("/"),
+    	DOT_ESAPI(".esapi/"),
+    	ESAPI("esapi/"),
+    	RESOURCES("resources/");
+    	
+    	private final String path;
+    	
+
+    	
+    	private DefaultSearchPath(String s){
+    		this.path = s;
+    	}
+    	
+    	public String value(){
+    		return path;
+    	}
+    }
 }
diff --git a/src/test/java/org/owasp/esapi/reference/DefaultSecurityConfigurationTest.java b/src/test/java/org/owasp/esapi/reference/DefaultSecurityConfigurationTest.java
index fed8647af..5171da6a5 100644
--- a/src/test/java/org/owasp/esapi/reference/DefaultSecurityConfigurationTest.java
+++ b/src/test/java/org/owasp/esapi/reference/DefaultSecurityConfigurationTest.java
@@ -13,6 +13,7 @@
 import org.owasp.esapi.ESAPI;
 import org.owasp.esapi.Logger;
 import org.owasp.esapi.errors.ConfigurationException;
+import org.owasp.esapi.reference.DefaultSecurityConfiguration.DefaultSearchPath;
 
 public class DefaultSecurityConfigurationTest {
 
@@ -420,4 +421,20 @@ public void testValidationsPropertiesFileOptions(){
 		assertEquals(patternOrNull(secConf.getValidationPattern("TestC")), "ValueFromCommaFile");
 	}
 	
+	@Test 
+	public void DefaultSearchPathTest(){
+		assertEquals("/", DefaultSearchPath.ROOT.value());
+		assertEquals("resourceDirectory/", DefaultSearchPath.RESOURCE_DIRECTORY.value());
+		assertEquals(".esapi/", DefaultSearchPath.DOT_ESAPI.value());
+		assertEquals("esapi/", DefaultSearchPath.ESAPI.value());
+		assertEquals("resources/", DefaultSearchPath.RESOURCES.value());
+		assertEquals("src/main/resources/", DefaultSearchPath.SRC_MAIN_RESOURCES.value());
+	}
+	
+	@Test
+	public void DefaultSearchPathEnumChanges(){
+		int expected = 6;
+		int testValue = DefaultSearchPath.values().length;
+		assertEquals(expected, testValue);
+	}
 }

From 262c342723d9c043559ada1c440dc061bdec1161 Mon Sep 17 00:00:00 2001
From: Matt Seil 
Date: Sun, 16 Jul 2017 09:27:46 -0700
Subject: [PATCH 413/812] Issue #399 -- Updated pom.xml so the base compile
 version is 1.7 instead of 1.6.  This eliminates incompatibilities with mvn
 site that was preventing newer plugins from using items like
 java.util.Function.

---
 pom.xml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/pom.xml b/pom.xml
index fd8551117..b66f5ee1a 100644
--- a/pom.xml
+++ b/pom.xml
@@ -219,8 +219,8 @@
                 maven-compiler-plugin
                 3.3
                 
-                    1.6
-                    1.6
+                    1.7
+                    1.7
                     true
                     true
                     false

From df2c9783b3e4112519af3722e21c3d7499eab101 Mon Sep 17 00:00:00 2001
From: Matt Seil 
Date: Sun, 16 Jul 2017 13:13:43 -0700
Subject: [PATCH 414/812] Issue #398 -- Fixed hardcoded instance of HTTP header
 and made it configurable.

---
 .../org/owasp/esapi/filters/SecurityWrapperResponse.java   | 6 ++++--
 .../esapi/reference/DefaultSecurityConfiguration.java      | 2 --
 src/test/java/org/owasp/esapi/reference/ValidatorTest.java | 7 +++++++
 src/test/resources/esapi/ESAPI.properties                  | 6 ++++--
 4 files changed, 15 insertions(+), 6 deletions(-)

diff --git a/src/main/java/org/owasp/esapi/filters/SecurityWrapperResponse.java b/src/main/java/org/owasp/esapi/filters/SecurityWrapperResponse.java
index 9dd0632ce..63a403879 100644
--- a/src/main/java/org/owasp/esapi/filters/SecurityWrapperResponse.java
+++ b/src/main/java/org/owasp/esapi/filters/SecurityWrapperResponse.java
@@ -24,6 +24,7 @@
 
 import org.owasp.esapi.ESAPI;
 import org.owasp.esapi.Logger;
+import org.owasp.esapi.SecurityConfiguration;
 import org.owasp.esapi.StringUtilities;
 import org.owasp.esapi.ValidationErrorList;
 import org.owasp.esapi.errors.IntrusionException;
@@ -168,10 +169,11 @@ public void addDateHeader(String name, long date) {
     public void addHeader(String name, String value) {
         try {
             // TODO: make stripping a global config
+        	SecurityConfiguration sc = ESAPI.securityConfiguration();
             String strippedName = StringUtilities.stripControls(name);
             String strippedValue = StringUtilities.stripControls(value);
-            String safeName = ESAPI.validator().getValidInput("addHeader", strippedName, "HTTPHeaderName", 20, false);
-            String safeValue = ESAPI.validator().getValidInput("addHeader", strippedValue, "HTTPHeaderValue", ESAPI.securityConfiguration().getMaxHttpHeaderSize(), false);
+            String safeName = ESAPI.validator().getValidInput("addHeader", strippedName, "HTTPHeaderName", sc.getIntProp("HttpUtilities.MaxHeaderKeySize"), false);
+            String safeValue = ESAPI.validator().getValidInput("addHeader", strippedValue, "HTTPHeaderValue", sc.getIntProp("HttpUtilities.MaxHeaderValueSize"), false);
             getHttpServletResponse().addHeader(safeName, safeValue);
         } catch (ValidationException e) {
             logger.warning(Logger.SECURITY_FAILURE, "Attempt to add invalid header denied", e);
diff --git a/src/main/java/org/owasp/esapi/reference/DefaultSecurityConfiguration.java b/src/main/java/org/owasp/esapi/reference/DefaultSecurityConfiguration.java
index a1f551e7d..bf2a79696 100644
--- a/src/main/java/org/owasp/esapi/reference/DefaultSecurityConfiguration.java
+++ b/src/main/java/org/owasp/esapi/reference/DefaultSecurityConfiguration.java
@@ -1359,8 +1359,6 @@ public enum DefaultSearchPath {
     	
     	private final String path;
     	
-
-    	
     	private DefaultSearchPath(String s){
     		this.path = s;
     	}
diff --git a/src/test/java/org/owasp/esapi/reference/ValidatorTest.java b/src/test/java/org/owasp/esapi/reference/ValidatorTest.java
index 7df1227b0..e10b47e48 100644
--- a/src/test/java/org/owasp/esapi/reference/ValidatorTest.java
+++ b/src/test/java/org/owasp/esapi/reference/ValidatorTest.java
@@ -1087,6 +1087,13 @@ public void testGetHeader() {
         assertFalse(safeRequest.getHeader("f2").equals(request.getHeader("f2")));
         assertNull(safeRequest.getHeader("p3"));
     }
+    
+    public void testHeaderLengthChecks(){
+    	Validator v = ESAPI.validator();
+    	SecurityConfiguration sc = ESAPI.securityConfiguration();
+    	assertFalse(v.isValidInput("addHeader", generateStringOfLength(257), "HTTPHeaderName", sc.getIntProp("HttpUtilities.MaxHeaderKeySize"), false));
+    	assertFalse(v.isValidInput("addHeader", generateStringOfLength(4097), "HTTPHeaderValue", sc.getIntProp("HttpUtilities.MaxHeaderValueSize"), false));
+    }
 
     public void testGetHeaderNames() {
 //testing Validator.HTTPHeaderName
diff --git a/src/test/resources/esapi/ESAPI.properties b/src/test/resources/esapi/ESAPI.properties
index 2727d4ada..becadfee7 100644
--- a/src/test/resources/esapi/ESAPI.properties
+++ b/src/test/resources/esapi/ESAPI.properties
@@ -331,8 +331,10 @@ HttpUtilities.ForceHttpOnlySession=false
 HttpUtilities.ForceSecureSession=false
 HttpUtilities.ForceHttpOnlyCookies=true
 HttpUtilities.ForceSecureCookies=true
-# Maximum size of HTTP headers
-HttpUtilities.MaxHeaderSize=4096
+# Maximum size of HTTP header key
+HttpUtilities.MaxHeaderKeySize=256
+# Maximum size of HTTP header value
+HttpUtilities.MaxHeaderValueSize=4096
 # File upload configuration
 HttpUtilities.ApprovedUploadExtensions=.zip,.pdf,.doc,.docx,.ppt,.pptx,.tar,.gz,.tgz,.rar,.war,.jar,.ear,.xls,.rtf,.properties,.java,.class,.txt,.xml,.jsp,.jsf,.exe,.dll
 HttpUtilities.MaxUploadFileBytes=500000000

From 005173a2892f0a9bacd2b8edd98843751008cd19 Mon Sep 17 00:00:00 2001
From: Matt Seil 
Date: Fri, 21 Jul 2017 09:56:23 -0700
Subject: [PATCH 415/812] Added simple unit test to validate changes that made
 HTML entities always lower case.  Associated with issues #285 and #302.

---
 src/test/java/org/owasp/esapi/reference/EncoderTest.java | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/src/test/java/org/owasp/esapi/reference/EncoderTest.java b/src/test/java/org/owasp/esapi/reference/EncoderTest.java
index 6aad8c773..5bd553b25 100644
--- a/src/test/java/org/owasp/esapi/reference/EncoderTest.java
+++ b/src/test/java/org/owasp/esapi/reference/EncoderTest.java
@@ -469,6 +469,7 @@ public void testEncodeForLDAP() {
         assertEquals("No special characters to escape", "Hi This is a test #��", instance.encodeForLDAP("Hi This is a test #��"));
         assertEquals("Zeros", "Hi \\00", instance.encodeForLDAP("Hi \u0000"));
         assertEquals("LDAP Christams Tree", "Hi \\28This\\29 = is \\2a a \\5c test # � � �", instance.encodeForLDAP("Hi (This) = is * a \\ test # � � �"));
+        assertEquals("Hi \\28This\\29 =", instance.encodeForLDAP("Hi (This) ="));
     }
     
     /**
@@ -499,6 +500,14 @@ public void testEncodeForDN() {
         assertEquals("Christmas Tree DN", "\\ Hello\\\\ \\+ \\, \\\"World\\\" \\;\\ ", instance.encodeForDN(" Hello\\ + , \"World\" ; "));
     }
     
+    /**
+     * Longstanding issue of always lowercasing named HTML entities.  This will be set right now. 
+     */
+    public void testNamedUpperCaseDecoding(){
+    	String input = "Ü";
+    	String expected = "Ü";
+    	assertEquals(expected, ESAPI.encoder().decodeForHTML(input));
+    }
     public void testEncodeForXMLNull() {
         Encoder instance = ESAPI.encoder();
         assertEquals(null, instance.encodeForXML(null));

From 4a7357d07ab46d7a659790200a22fd8085b5819e Mon Sep 17 00:00:00 2001
From: Matt Seil 
Date: Fri, 21 Jul 2017 15:04:53 -0700
Subject: [PATCH 416/812] Issue #403 -- Converted SecurityWrapperResponse.java
 to get rid of magic numbers and to get header lengths from ESAPI.properties.

---
 .../filters/SecurityWrapperResponse.java      | 19 ++++++++++++-------
 1 file changed, 12 insertions(+), 7 deletions(-)

diff --git a/src/main/java/org/owasp/esapi/filters/SecurityWrapperResponse.java b/src/main/java/org/owasp/esapi/filters/SecurityWrapperResponse.java
index 3d8796649..515bf7376 100644
--- a/src/main/java/org/owasp/esapi/filters/SecurityWrapperResponse.java
+++ b/src/main/java/org/owasp/esapi/filters/SecurityWrapperResponse.java
@@ -151,7 +151,8 @@ private String createCookieHeader(String name, String value, int maxAge, String
      */
     public void addDateHeader(String name, long date) {
         try {
-            String safeName = ESAPI.validator().getValidInput("safeSetDateHeader", name, "HTTPHeaderName", 20, false);
+        	SecurityConfiguration sc = ESAPI.securityConfiguration();
+            String safeName = ESAPI.validator().getValidInput("safeSetDateHeader", name, "HTTPHeaderName", sc.getIntProp("HttpUtilities.MaxHeaderKeySize"), false);
             getHttpServletResponse().addDateHeader(safeName, date);
         } catch (ValidationException e) {
             logger.warning(Logger.SECURITY_FAILURE, "Attempt to set invalid date header name denied", e);
@@ -184,13 +185,14 @@ public void addHeader(String name, String value) {
 
     /**
      * Add an int header to the response after ensuring that there are no
-     * encoded or illegal characters in the name and name.
+     * encoded or illegal characters in the name and value.
      * @param name 
      * @param value
      */
     public void addIntHeader(String name, int value) {
         try {
-            String safeName = ESAPI.validator().getValidInput("safeSetDateHeader", name, "HTTPHeaderName", 20, false);
+        	SecurityConfiguration sc = ESAPI.securityConfiguration();
+            String safeName = ESAPI.validator().getValidInput("safeSetDateHeader", name, "HTTPHeaderName", sc.getIntProp("HttpUtilities.MaxHeaderKeySize"), false);
             getHttpServletResponse().addIntHeader(safeName, value);
         } catch (ValidationException e) {
             logger.warning(Logger.SECURITY_FAILURE, "Attempt to set invalid int header name denied", e);
@@ -428,7 +430,8 @@ public void setContentType(String type) {
      */
     public void setDateHeader(String name, long date) {
         try {
-            String safeName = ESAPI.validator().getValidInput("safeSetDateHeader", name, "HTTPHeaderName", 20, false);
+        	SecurityConfiguration sc = ESAPI.securityConfiguration();
+            String safeName = ESAPI.validator().getValidInput("safeSetDateHeader", name, "HTTPHeaderName", sc.getIntProp("HttpUtilities.MaxHeaderKeySize"), false);
             getHttpServletResponse().setDateHeader(safeName, date);
         } catch (ValidationException e) {
             logger.warning(Logger.SECURITY_FAILURE, "Attempt to set invalid date header name denied", e);
@@ -448,8 +451,9 @@ public void setHeader(String name, String value) {
         try {
             String strippedName = StringUtilities.stripControls(name);
             String strippedValue = StringUtilities.stripControls(value);
-            String safeName = ESAPI.validator().getValidInput("setHeader", strippedName, "HTTPHeaderName", 50, false);
-            String safeValue = ESAPI.validator().getValidInput("setHeader", strippedValue, "HTTPHeaderValue", ESAPI.securityConfiguration().getMaxHttpHeaderSize(), false);
+            SecurityConfiguration sc = ESAPI.securityConfiguration();
+            String safeName = ESAPI.validator().getValidInput("setHeader", strippedName, "HTTPHeaderName", sc.getIntProp("HttpUtilities.MaxHeaderKeySize"), false);
+            String safeValue = ESAPI.validator().getValidInput("setHeader", strippedValue, "HTTPHeaderValue", sc.getIntProp("HttpUtilities.MaxHeaderValueSize"), false);
             getHttpServletResponse().setHeader(safeName, safeValue);
         } catch (ValidationException e) {
             logger.warning(Logger.SECURITY_FAILURE, "Attempt to set invalid header denied", e);
@@ -464,7 +468,8 @@ public void setHeader(String name, String value) {
      */
     public void setIntHeader(String name, int value) {
         try {
-            String safeName = ESAPI.validator().getValidInput("safeSetDateHeader", name, "HTTPHeaderName", 20, false);
+        	SecurityConfiguration sc = ESAPI.securityConfiguration();
+            String safeName = ESAPI.validator().getValidInput("safeSetDateHeader", name, "HTTPHeaderName", sc.getIntProp("HttpUtilities.MaxHeaderKeySize"), false);
             getHttpServletResponse().setIntHeader(safeName, value);
         } catch (ValidationException e) {
             logger.warning(Logger.SECURITY_FAILURE, "Attempt to set invalid int header name denied", e);

From 86ffb3d33a2846b9b0a3e34a1ca0461f6a680247 Mon Sep 17 00:00:00 2001
From: Matt Seil 
Date: Fri, 21 Jul 2017 15:07:14 -0700
Subject: [PATCH 417/812] Issue #400 -- Added mocking framework to maven test
 baseline and completed first minor unit tests of SecurityWrapperResponse.

---
 pom.xml                                       | 38 ++++++++++++++-
 .../filters/SecurityWrapperResponseTest.java  | 46 +++++++++++++++++++
 2 files changed, 83 insertions(+), 1 deletion(-)
 create mode 100644 src/test/java/org/owasp/esapi/filters/SecurityWrapperResponseTest.java

diff --git a/pom.xml b/pom.xml
index b66f5ee1a..7bc646277 100644
--- a/pom.xml
+++ b/pom.xml
@@ -205,12 +205,48 @@
             batik-css
             1.9
         
-		
+		
+		
+		
+		    org.powermock
+		    powermock-api-mockito
+		    1.7.0
+		    test
+		
+		
+		    org.powermock
+		    powermock-module-junit4
+		    1.7.0
+		    test
 		
+		
+				
+		
+		
+		
     
 
     
diff --git a/src/test/java/org/owasp/esapi/filters/SecurityWrapperResponseTest.java b/src/test/java/org/owasp/esapi/filters/SecurityWrapperResponseTest.java
new file mode 100644
index 000000000..01eb5aca8
--- /dev/null
+++ b/src/test/java/org/owasp/esapi/filters/SecurityWrapperResponseTest.java
@@ -0,0 +1,46 @@
+package org.owasp.esapi.filters;
+
+import static org.mockito.Mockito.mock;
+import static org.mockito.Mockito.spy;
+import static org.mockito.Mockito.times;
+import static org.mockito.Mockito.verify;
+import static org.mockito.Mockito.when;
+import javax.servlet.http.HttpServletResponse;
+
+import org.junit.Test;
+import org.junit.runner.RunWith;
+import org.mockito.Mockito;
+import org.owasp.esapi.util.TestUtils;
+import org.powermock.modules.junit4.PowerMockRunner;
+
+//@PrepareForTest({SecurityWrapperResponse.class})
+@RunWith(PowerMockRunner.class)
+public class SecurityWrapperResponseTest {
+	
+	@Test
+	public void testAddHeader(){
+		HttpServletResponse servResp = mock(HttpServletResponse.class);
+		SecurityWrapperResponse resp = new SecurityWrapperResponse(servResp);
+		resp.addHeader("Foo", "bar");
+		verify(servResp, times(1)).addHeader("Foo", "bar");
+	}
+	
+	@Test
+	public void testAddHeaderInvalidValueLength(){
+		//refactor this to use a spy. 
+		HttpServletResponse servResp = mock(HttpServletResponse.class);
+		SecurityWrapperResponse resp = new SecurityWrapperResponse(servResp);
+		SecurityWrapperResponse spyResp = spy(resp);
+		Mockito.doCallRealMethod().when(spyResp).addHeader("Foo", TestUtils.generateStringOfLength(4097));
+		resp.addHeader("Foo", TestUtils.generateStringOfLength(4097));
+		verify(servResp, times(0)).addHeader("Foo", "bar");
+	}
+	
+	@Test
+	public void testAddHeaderInvalidKeyLength(){
+		HttpServletResponse servResp = mock(HttpServletResponse.class);
+		SecurityWrapperResponse resp = new SecurityWrapperResponse(servResp);
+		resp.addHeader(TestUtils.generateStringOfLength(257), "bar");
+		verify(servResp, times(0)).addHeader("Foo", "bar");
+	}
+}

From 7c90eb797c52f0d070c2edeebcab2c9781f7f389 Mon Sep 17 00:00:00 2001
From: Matt Seil 
Date: Sun, 23 Jul 2017 11:24:22 -0700
Subject: [PATCH 418/812] Issue #400 -- added unit tests for addCookie method,
 implicitly tests a private method within the class as well.  I also converted
 the class under test to use configurable header length from
 securityConfiguration.

---
 .../filters/SecurityWrapperResponse.java      |  9 +-
 .../filters/SecurityWrapperResponseTest.java  | 84 ++++++++++++++++++-
 2 files changed, 88 insertions(+), 5 deletions(-)

diff --git a/src/main/java/org/owasp/esapi/filters/SecurityWrapperResponse.java b/src/main/java/org/owasp/esapi/filters/SecurityWrapperResponse.java
index 515bf7376..019b26c0a 100644
--- a/src/main/java/org/owasp/esapi/filters/SecurityWrapperResponse.java
+++ b/src/main/java/org/owasp/esapi/filters/SecurityWrapperResponse.java
@@ -82,11 +82,12 @@ public void addCookie(Cookie cookie) {
         String domain = cookie.getDomain();
         String path = cookie.getPath();
         boolean secure = cookie.getSecure();
+        SecurityConfiguration sc = ESAPI.securityConfiguration();
 
         // validate the name and value
         ValidationErrorList errors = new ValidationErrorList();
-        String cookieName = ESAPI.validator().getValidInput("cookie name", name, "HTTPCookieName", 50, false, errors);
-        String cookieValue = ESAPI.validator().getValidInput("cookie value", value, "HTTPCookieValue", ESAPI.securityConfiguration().getMaxHttpHeaderSize(), false, errors);
+        String cookieName = ESAPI.validator().getValidInput("cookie name", name, "HTTPCookieName", sc.getIntProp("HttpUtilities.MaxHeaderKeySize"), false, errors);
+        String cookieValue = ESAPI.validator().getValidInput("cookie value", value, "HTTPCookieValue", sc.getIntProp("HttpUtilities.MaxHeaderValueSize"), false, errors);
 
         // if there are no errors, then just set a cookie header
         if (errors.size() == 0) {
@@ -134,10 +135,10 @@ private String createCookieHeader(String name, String value, int maxAge, String
         if (path != null) {
             header += "; Path=" + path;
         }
-        if ( secure || ESAPI.securityConfiguration().getForceSecureCookies() ) {
+        if ( secure || ESAPI.securityConfiguration().getBooleanProp("HttpUtilities.ForceSecureCookies") ) {
 			header += "; Secure";
         }
-        if ( ESAPI.securityConfiguration().getForceHttpOnlyCookies() ) {
+        if ( ESAPI.securityConfiguration().getBooleanProp("HttpUtilities.ForceHttpOnlyCookies") ) {
 			header += "; HttpOnly";
         }
         return header;
diff --git a/src/test/java/org/owasp/esapi/filters/SecurityWrapperResponseTest.java b/src/test/java/org/owasp/esapi/filters/SecurityWrapperResponseTest.java
index 01eb5aca8..ecbbad138 100644
--- a/src/test/java/org/owasp/esapi/filters/SecurityWrapperResponseTest.java
+++ b/src/test/java/org/owasp/esapi/filters/SecurityWrapperResponseTest.java
@@ -1,15 +1,20 @@
 package org.owasp.esapi.filters;
 
+import static org.junit.Assert.assertEquals;
 import static org.mockito.Mockito.mock;
 import static org.mockito.Mockito.spy;
 import static org.mockito.Mockito.times;
 import static org.mockito.Mockito.verify;
-import static org.mockito.Mockito.when;
+
+import java.util.Collection;
+
+import javax.servlet.http.Cookie;
 import javax.servlet.http.HttpServletResponse;
 
 import org.junit.Test;
 import org.junit.runner.RunWith;
 import org.mockito.Mockito;
+import org.owasp.esapi.http.MockHttpServletResponse;
 import org.owasp.esapi.util.TestUtils;
 import org.powermock.modules.junit4.PowerMockRunner;
 
@@ -25,6 +30,24 @@ public void testAddHeader(){
 		verify(servResp, times(1)).addHeader("Foo", "bar");
 	}
 	
+	@Test
+	public void testAddDateHeader(){
+		HttpServletResponse servResp = mock(HttpServletResponse.class);
+		SecurityWrapperResponse resp = new SecurityWrapperResponse(servResp);
+		long currentTime = System.currentTimeMillis();
+		resp.addDateHeader("Foo", currentTime);
+		verify(servResp, times(1)).addDateHeader("Foo", currentTime);
+	}
+	
+	@Test
+	public void testInvalidDateHeader(){
+		HttpServletResponse servResp = mock(HttpServletResponse.class);
+		SecurityWrapperResponse resp = new SecurityWrapperResponse(servResp);
+		long currentTime = System.currentTimeMillis();
+		resp.addDateHeader("Foo\\r\\n", currentTime);
+		verify(servResp, times(0)).addDateHeader("Foo", currentTime);
+	}
+	
 	@Test
 	public void testAddHeaderInvalidValueLength(){
 		//refactor this to use a spy. 
@@ -43,4 +66,63 @@ public void testAddHeaderInvalidKeyLength(){
 		resp.addHeader(TestUtils.generateStringOfLength(257), "bar");
 		verify(servResp, times(0)).addHeader("Foo", "bar");
 	}
+	
+	@Test
+	public void testAddValidCookie(){
+		HttpServletResponse servResp = new MockHttpServletResponse();
+		servResp = spy(servResp);
+		SecurityWrapperResponse resp = new SecurityWrapperResponse(servResp);
+		SecurityWrapperResponse spyResp = spy(resp);
+		Cookie cookie = new Cookie("Foo", TestUtils.generateStringOfLength(10));
+		Mockito.doCallRealMethod().when(spyResp).addCookie(cookie);
+		spyResp.addCookie(cookie);
+		/*
+		 * We're indirectly testing our class.  Since it ultimately
+		 * delegates to HttpServletResponse.addHeader, we're actually 
+		 * validating that our test method constructs a header with the
+		 * expected properties.  This implicitly tests the 
+		 * createCookieHeader method as well.
+		 */
+		verify(servResp, times(1)).addHeader("Set-Cookie", "Foo=aaaaaaaaaa; Secure; HttpOnly");
+	}
+	
+	@Test
+	public void testAddValidCookieWithDomain(){
+		HttpServletResponse servResp = new MockHttpServletResponse();
+		servResp = spy(servResp);
+		SecurityWrapperResponse resp = new SecurityWrapperResponse(servResp);
+		SecurityWrapperResponse spyResp = spy(resp);
+		Cookie cookie = new Cookie("Foo", TestUtils.generateStringOfLength(10));
+		cookie.setDomain("evil.com");
+		Mockito.doCallRealMethod().when(spyResp).addCookie(cookie);
+		spyResp.addCookie(cookie);
+		verify(servResp, times(1)).addHeader("Set-Cookie", "Foo=aaaaaaaaaa; Domain=evil.com; Secure; HttpOnly");
+	}
+	
+	@Test
+	public void testAddValidCookieWithPath(){
+		HttpServletResponse servResp = new MockHttpServletResponse();
+		servResp = spy(servResp);
+		SecurityWrapperResponse resp = new SecurityWrapperResponse(servResp);
+		SecurityWrapperResponse spyResp = spy(resp);
+		Cookie cookie = new Cookie("Foo", TestUtils.generateStringOfLength(10));
+		cookie.setDomain("evil.com");
+		cookie.setPath("/foo/bar");
+		Mockito.doCallRealMethod().when(spyResp).addCookie(cookie);
+		spyResp.addCookie(cookie);
+		verify(servResp, times(1)).addHeader("Set-Cookie", "Foo=aaaaaaaaaa; Domain=evil.com; Path=/foo/bar; Secure; HttpOnly");
+	}
+	
+	@Test
+	public void testAddInValidCookie(){
+		HttpServletResponse servResp = new MockHttpServletResponse();
+		servResp = spy(servResp);
+		SecurityWrapperResponse resp = new SecurityWrapperResponse(servResp);
+		SecurityWrapperResponse spyResp = spy(resp);
+		Cookie cookie = new Cookie("Foo", TestUtils.generateStringOfLength(5000));
+		Mockito.doCallRealMethod().when(spyResp).addCookie(cookie);
+		
+		spyResp.addCookie(cookie);
+		verify(servResp, times(0)).addHeader("Set-Cookie", "Foo=" + TestUtils.generateStringOfLength(5000) + "; Secure; HttpOnly");
+	}
 }

From f97a93ab7498579ce79488ee63f48e63b93ae4f2 Mon Sep 17 00:00:00 2001
From: Matt Seil 
Date: Mon, 24 Jul 2017 14:53:02 -0700
Subject: [PATCH 419/812] Issue #400 -- Added more unit tests.  Also did work
 for #403, as well as #383.

---
 .../esapi/filters/SecurityWrapperRequest.java |  6 ++-
 .../filters/SecurityWrapperResponse.java      | 42 ++++++++++++------
 .../filters/SecurityWrapperResponseTest.java  | 27 ++++++++++++
 .../owasp/esapi/reference/EncoderTest.java    |  1 +
 .../owasp/esapi/reference/ValidatorTest.java  | 44 ++++++++-----------
 .../java/org/owasp/esapi/util/TestUtils.java  | 14 ++++++
 src/test/resources/esapi/ESAPI.properties     |  9 ++--
 7 files changed, 98 insertions(+), 45 deletions(-)
 create mode 100644 src/test/java/org/owasp/esapi/util/TestUtils.java

diff --git a/src/main/java/org/owasp/esapi/filters/SecurityWrapperRequest.java b/src/main/java/org/owasp/esapi/filters/SecurityWrapperRequest.java
index c267361c2..3f6a53f3c 100644
--- a/src/main/java/org/owasp/esapi/filters/SecurityWrapperRequest.java
+++ b/src/main/java/org/owasp/esapi/filters/SecurityWrapperRequest.java
@@ -35,8 +35,9 @@
 
 import org.owasp.esapi.ESAPI;
 import org.owasp.esapi.Logger;
-import org.owasp.esapi.errors.ValidationException;
+import org.owasp.esapi.SecurityConfiguration;
 import org.owasp.esapi.errors.AccessControlException;
+import org.owasp.esapi.errors.ValidationException;
 
 // TODO: Parameterize these various lengths in calls to ESAPI.validator().getValidInput()
 // so that they can be placed in ESAPI.properties file (or other property file,
@@ -217,10 +218,11 @@ public String getHeader(String name) {
     public Enumeration getHeaderNames() {
         Vector v = new Vector();
         Enumeration en = getHttpServletRequest().getHeaderNames();
+        SecurityConfiguration sc = ESAPI.securityConfiguration();
         while (en.hasMoreElements()) {
             try {
                 String name = (String) en.nextElement();
-                String clean = ESAPI.validator().getValidInput("HTTP header name: " + name, name, "HTTPHeaderName", 150, true);
+                String clean = ESAPI.validator().getValidInput("HTTP header name: " + name, name, "HTTPHeaderName", sc.getIntProp("HttpUtilities.MaxHeaderNameSize"), true);
                 v.add(clean);
             } catch (ValidationException e) {
                 // already logged
diff --git a/src/main/java/org/owasp/esapi/filters/SecurityWrapperResponse.java b/src/main/java/org/owasp/esapi/filters/SecurityWrapperResponse.java
index 019b26c0a..82e629557 100644
--- a/src/main/java/org/owasp/esapi/filters/SecurityWrapperResponse.java
+++ b/src/main/java/org/owasp/esapi/filters/SecurityWrapperResponse.java
@@ -86,7 +86,7 @@ public void addCookie(Cookie cookie) {
 
         // validate the name and value
         ValidationErrorList errors = new ValidationErrorList();
-        String cookieName = ESAPI.validator().getValidInput("cookie name", name, "HTTPCookieName", sc.getIntProp("HttpUtilities.MaxHeaderKeySize"), false, errors);
+        String cookieName = ESAPI.validator().getValidInput("cookie name", name, "HTTPCookieName", sc.getIntProp("HttpUtilities.MaxHeaderNameSize"), false, errors);
         String cookieValue = ESAPI.validator().getValidInput("cookie value", value, "HTTPCookieValue", sc.getIntProp("HttpUtilities.MaxHeaderValueSize"), false, errors);
 
         // if there are no errors, then just set a cookie header
@@ -153,7 +153,7 @@ private String createCookieHeader(String name, String value, int maxAge, String
     public void addDateHeader(String name, long date) {
         try {
         	SecurityConfiguration sc = ESAPI.securityConfiguration();
-            String safeName = ESAPI.validator().getValidInput("safeSetDateHeader", name, "HTTPHeaderName", sc.getIntProp("HttpUtilities.MaxHeaderKeySize"), false);
+            String safeName = ESAPI.validator().getValidInput("safeSetDateHeader", name, "HTTPHeaderName", sc.getIntProp("HttpUtilities.MaxHeaderNameSize"), false);
             getHttpServletResponse().addDateHeader(safeName, date);
         } catch (ValidationException e) {
             logger.warning(Logger.SECURITY_FAILURE, "Attempt to set invalid date header name denied", e);
@@ -176,7 +176,7 @@ public void addHeader(String name, String value) {
         	SecurityConfiguration sc = ESAPI.securityConfiguration();
             String strippedName = StringUtilities.stripControls(name);
             String strippedValue = StringUtilities.stripControls(value);
-            String safeName = ESAPI.validator().getValidInput("addHeader", strippedName, "HTTPHeaderName", sc.getIntProp("HttpUtilities.MaxHeaderKeySize"), false);
+            String safeName = ESAPI.validator().getValidInput("addHeader", strippedName, "HTTPHeaderName", sc.getIntProp("HttpUtilities.MaxHeaderNameSize"), false);
             String safeValue = ESAPI.validator().getValidInput("addHeader", strippedValue, "HTTPHeaderValue", sc.getIntProp("HttpUtilities.MaxHeaderValueSize"), false);
             getHttpServletResponse().addHeader(safeName, safeValue);
         } catch (ValidationException e) {
@@ -193,7 +193,7 @@ public void addHeader(String name, String value) {
     public void addIntHeader(String name, int value) {
         try {
         	SecurityConfiguration sc = ESAPI.securityConfiguration();
-            String safeName = ESAPI.validator().getValidInput("safeSetDateHeader", name, "HTTPHeaderName", sc.getIntProp("HttpUtilities.MaxHeaderKeySize"), false);
+            String safeName = ESAPI.validator().getValidInput("safeSetDateHeader", name, "HTTPHeaderName", sc.getIntProp("HttpUtilities.MaxHeaderNameSize"), false);
             getHttpServletResponse().addIntHeader(safeName, value);
         } catch (ValidationException e) {
             logger.warning(Logger.SECURITY_FAILURE, "Attempt to set invalid int header name denied", e);
@@ -353,24 +353,38 @@ public void resetBuffer() {
 
     /**
      * Override the error code with a 200 in order to confound attackers using
-     * automated scanners.
-     * @param sc 
+     * automated scanners.  Overwriting is controlled by {@code HttpUtilities.OverwriteStatusCodes}
+     * in ESAPI.properties. 
+     * @param sc -- http status code
      * @throws IOException
      */
     public void sendError(int sc) throws IOException {
-        getHttpServletResponse().sendError(HttpServletResponse.SC_OK, getHTTPMessage(sc));
+    	SecurityConfiguration config = ESAPI.securityConfiguration();
+    	if(config.getBooleanProp("HttpUtilities.OverwriteStatusCodes")){
+    		getHttpServletResponse().sendError(HttpServletResponse.SC_OK, getHTTPMessage(sc));
+    	}else{
+    		getHttpServletResponse().sendError(sc, getHTTPMessage(sc));
+    	}
+        
     }
 
     /**
      * Override the error code with a 200 in order to confound attackers using
      * automated scanners. The message is canonicalized and filtered for
-     * dangerous characters.
-     * @param sc 
-     * @param msg
+     * dangerous characters.  Overwriting is controlled by {@code HttpUtilities.OverwriteStatusCodes}
+     * in ESAPI.properties.  
+     * @param sc -- http status code
+     * @param msg -- error message
      * @throws IOException
      */
     public void sendError(int sc, String msg) throws IOException {
-        getHttpServletResponse().sendError(HttpServletResponse.SC_OK, ESAPI.encoder().encodeForHTML(msg));
+    	SecurityConfiguration config = ESAPI.securityConfiguration();
+    	if(config.getBooleanProp("HttpUtilities.OverwriteStatusCodes")){
+    		getHttpServletResponse().sendError(HttpServletResponse.SC_OK, ESAPI.encoder().encodeForHTML(msg));
+    	}else{
+    		getHttpServletResponse().sendError(sc, ESAPI.encoder().encodeForHTML(msg));
+    	}
+        
     }
 
     /**
@@ -432,7 +446,7 @@ public void setContentType(String type) {
     public void setDateHeader(String name, long date) {
         try {
         	SecurityConfiguration sc = ESAPI.securityConfiguration();
-            String safeName = ESAPI.validator().getValidInput("safeSetDateHeader", name, "HTTPHeaderName", sc.getIntProp("HttpUtilities.MaxHeaderKeySize"), false);
+            String safeName = ESAPI.validator().getValidInput("safeSetDateHeader", name, "HTTPHeaderName", sc.getIntProp("HttpUtilities.MaxHeaderNameSize"), false);
             getHttpServletResponse().setDateHeader(safeName, date);
         } catch (ValidationException e) {
             logger.warning(Logger.SECURITY_FAILURE, "Attempt to set invalid date header name denied", e);
@@ -453,7 +467,7 @@ public void setHeader(String name, String value) {
             String strippedName = StringUtilities.stripControls(name);
             String strippedValue = StringUtilities.stripControls(value);
             SecurityConfiguration sc = ESAPI.securityConfiguration();
-            String safeName = ESAPI.validator().getValidInput("setHeader", strippedName, "HTTPHeaderName", sc.getIntProp("HttpUtilities.MaxHeaderKeySize"), false);
+            String safeName = ESAPI.validator().getValidInput("setHeader", strippedName, "HTTPHeaderName", sc.getIntProp("HttpUtilities.MaxHeaderNameSize"), false);
             String safeValue = ESAPI.validator().getValidInput("setHeader", strippedValue, "HTTPHeaderValue", sc.getIntProp("HttpUtilities.MaxHeaderValueSize"), false);
             getHttpServletResponse().setHeader(safeName, safeValue);
         } catch (ValidationException e) {
@@ -470,7 +484,7 @@ public void setHeader(String name, String value) {
     public void setIntHeader(String name, int value) {
         try {
         	SecurityConfiguration sc = ESAPI.securityConfiguration();
-            String safeName = ESAPI.validator().getValidInput("safeSetDateHeader", name, "HTTPHeaderName", sc.getIntProp("HttpUtilities.MaxHeaderKeySize"), false);
+            String safeName = ESAPI.validator().getValidInput("safeSetDateHeader", name, "HTTPHeaderName", sc.getIntProp("HttpUtilities.MaxHeaderNameSize"), false);
             getHttpServletResponse().setIntHeader(safeName, value);
         } catch (ValidationException e) {
             logger.warning(Logger.SECURITY_FAILURE, "Attempt to set invalid int header name denied", e);
diff --git a/src/test/java/org/owasp/esapi/filters/SecurityWrapperResponseTest.java b/src/test/java/org/owasp/esapi/filters/SecurityWrapperResponseTest.java
index ecbbad138..c61a20a20 100644
--- a/src/test/java/org/owasp/esapi/filters/SecurityWrapperResponseTest.java
+++ b/src/test/java/org/owasp/esapi/filters/SecurityWrapperResponseTest.java
@@ -67,6 +67,33 @@ public void testAddHeaderInvalidKeyLength(){
 		verify(servResp, times(0)).addHeader("Foo", "bar");
 	}
 	
+	@Test
+	public void testAddIntHeader(){
+		HttpServletResponse servResp = mock(HttpServletResponse.class);
+		SecurityWrapperResponse resp = new SecurityWrapperResponse(servResp);
+		resp.addIntHeader("aaaa", 4);
+		verify(servResp, times(1)).addIntHeader("aaaa", 4);
+	}
+	
+	@Test
+	public void testAddInvalidIntHeader(){
+		HttpServletResponse servResp = mock(HttpServletResponse.class);
+		SecurityWrapperResponse resp = new SecurityWrapperResponse(servResp);
+		resp.addIntHeader(TestUtils.generateStringOfLength(257), Integer.MIN_VALUE);
+		verify(servResp, times(0)).addIntHeader(TestUtils.generateStringOfLength(257), Integer.MIN_VALUE);
+	}
+	
+	@Test
+	public void testContainsHeader(){
+		HttpServletResponse servResp = new MockHttpServletResponse();
+		servResp = spy(servResp);
+		SecurityWrapperResponse resp = new SecurityWrapperResponse(servResp);
+		resp = spy(resp);
+		resp.addIntHeader("aaaa", Integer.MIN_VALUE);
+		verify(servResp, times(1)).addIntHeader("aaaa", Integer.MIN_VALUE);
+		assertEquals(true, servResp.containsHeader("aaaa"));
+	}
+	
 	@Test
 	public void testAddValidCookie(){
 		HttpServletResponse servResp = new MockHttpServletResponse();
diff --git a/src/test/java/org/owasp/esapi/reference/EncoderTest.java b/src/test/java/org/owasp/esapi/reference/EncoderTest.java
index 5bd553b25..45702ced4 100644
--- a/src/test/java/org/owasp/esapi/reference/EncoderTest.java
+++ b/src/test/java/org/owasp/esapi/reference/EncoderTest.java
@@ -508,6 +508,7 @@ public void testNamedUpperCaseDecoding(){
     	String expected = "Ü";
     	assertEquals(expected, ESAPI.encoder().decodeForHTML(input));
     }
+    
     public void testEncodeForXMLNull() {
         Encoder instance = ESAPI.encoder();
         assertEquals(null, instance.encodeForXML(null));
diff --git a/src/test/java/org/owasp/esapi/reference/ValidatorTest.java b/src/test/java/org/owasp/esapi/reference/ValidatorTest.java
index e10b47e48..c98620320 100644
--- a/src/test/java/org/owasp/esapi/reference/ValidatorTest.java
+++ b/src/test/java/org/owasp/esapi/reference/ValidatorTest.java
@@ -25,6 +25,7 @@
 import org.owasp.esapi.http.MockHttpServletResponse;
 import org.owasp.esapi.reference.validation.HTMLValidationRule;
 import org.owasp.esapi.reference.validation.StringValidationRule;
+import org.owasp.esapi.util.TestUtils;
 
 import javax.servlet.http.Cookie;
 import java.io.*;
@@ -592,10 +593,11 @@ public void testisValidInput() {
         assertTrue(instance.isValidInput("test", "jeffWILLIAMS123", "HTTPParameterValue", 100, false));
         assertTrue(instance.isValidInput("test", "jeff .-/+=@_ WILLIAMS", "HTTPParameterValue", 100, false));
         // Removed per Issue 116 - The '*' character is valid as a parameter character
-//        assertFalse(instance.isValidInput("test", "jeff*WILLIAMS", "HTTPParameterValue", 100, false));
+//        assertFalse(instance.isValidInput("test", "jeff*WILLIAMS", "HTTPParameterValue", 100, false))
+        System.err.println(instance.isValidInput("test", "jeff\\WILLIAMS", "HTTPParameterValue", 100, false));;
         assertFalse(instance.isValidInput("test", "jeff^WILLIAMS", "HTTPParameterValue", 100, false));
         assertFalse(instance.isValidInput("test", "jeff\\WILLIAMS", "HTTPParameterValue", 100, false));
-
+        
         assertTrue(instance.isValidInput("test", null, "Email", 100, true));
         assertFalse(instance.isValidInput("test", null, "Email", 100, false));
 
@@ -1005,11 +1007,11 @@ public void testGetParameterMap() {
 //an example of a parameter from displaytag, should pass
         request.addParameter("d-49653-p", "pass");
         request.addParameter("XSS");
-        request.addHeader("p2", generateStringOfLength(200));   // Upper limit increased from 150 -> 200, GitHub issue #351
-        request.addHeader("f2", generateStringOfLength(201));
+        request.addHeader("p2", TestUtils.generateStringOfLength(200));   // Upper limit increased from 150 -> 200, GitHub issue #351
+        request.addHeader("f2", TestUtils.generateStringOfLength(201));
         assertEquals(safeRequest.getHeader("p1"), request.getHeader("p1"));
         assertEquals(safeRequest.getHeader("p2"), request.getHeader("p2"));
         assertFalse(safeRequest.getHeader("f1").equals(request.getHeader("f1")));
@@ -1091,8 +1093,8 @@ public void testGetHeader() {
     public void testHeaderLengthChecks(){
     	Validator v = ESAPI.validator();
     	SecurityConfiguration sc = ESAPI.securityConfiguration();
-    	assertFalse(v.isValidInput("addHeader", generateStringOfLength(257), "HTTPHeaderName", sc.getIntProp("HttpUtilities.MaxHeaderKeySize"), false));
-    	assertFalse(v.isValidInput("addHeader", generateStringOfLength(4097), "HTTPHeaderValue", sc.getIntProp("HttpUtilities.MaxHeaderValueSize"), false));
+    	assertFalse(v.isValidInput("addHeader", TestUtils.generateStringOfLength(257), "HTTPHeaderName", sc.getIntProp("HttpUtilities.MaxHeaderNameSize"), false));
+    	assertFalse(v.isValidInput("addHeader", TestUtils.generateStringOfLength(4097), "HTTPHeaderValue", sc.getIntProp("HttpUtilities.MaxHeaderValueSize"), false));
     }
 
     public void testGetHeaderNames() {
@@ -1102,11 +1104,12 @@ public void testGetHeaderNames() {
         request.addHeader("d-49653-p", "pass");
         request.addHeader("= 0 : "length must be >= 0";
-        StringBuilder longString = new StringBuilder(length);
-        for (int i = 0; i < length; i++) {
-            longString.append("a");
-        }
-        return longString.toString();
-    }
-
     public void testGetContextPath() {
         // Root Context Path ("")
         assertTrue(ESAPI.validator().isValidInput("HTTPContextPath", "", "HTTPContextPath", 512, true));
diff --git a/src/test/java/org/owasp/esapi/util/TestUtils.java b/src/test/java/org/owasp/esapi/util/TestUtils.java
new file mode 100644
index 000000000..f7f117fc5
--- /dev/null
+++ b/src/test/java/org/owasp/esapi/util/TestUtils.java
@@ -0,0 +1,14 @@
+package org.owasp.esapi.util;
+
+public class TestUtils {
+
+	public static String generateStringOfLength(int length) {
+	    assert length >= 0 : "length must be >= 0";
+	    StringBuilder longString = new StringBuilder(length);
+	    for (int i = 0; i < length; i++) {
+	        longString.append("a");
+	    }
+	    return longString.toString();
+	}
+
+}
diff --git a/src/test/resources/esapi/ESAPI.properties b/src/test/resources/esapi/ESAPI.properties
index becadfee7..1ff0c4e65 100644
--- a/src/test/resources/esapi/ESAPI.properties
+++ b/src/test/resources/esapi/ESAPI.properties
@@ -332,7 +332,7 @@ HttpUtilities.ForceSecureSession=false
 HttpUtilities.ForceHttpOnlyCookies=true
 HttpUtilities.ForceSecureCookies=true
 # Maximum size of HTTP header key
-HttpUtilities.MaxHeaderKeySize=256
+HttpUtilities.MaxHeaderNameSize=256
 # Maximum size of HTTP header value
 HttpUtilities.MaxHeaderValueSize=4096
 # File upload configuration
@@ -345,7 +345,8 @@ HttpUtilities.ResponseContentType=text/html; charset=UTF-8
 # This is the name of the cookie used to represent the HTTP session
 # Typically this will be the default "JSESSIONID" 
 HttpUtilities.HttpSessionIdName=JSESSIONID
-
+#Sets whether or not will will overwrite http status codes to 200.
+HttpUtilities.OverwriteStatusCodes=true
 
 
 #===========================================================================
@@ -447,8 +448,8 @@ Validator.HTTPScheme=^(http|https)$
 Validator.HTTPServerName=^[a-zA-Z0-9_.\\-]*$
 Validator.HTTPCookieName=^[a-zA-Z0-9\\-_]{1,32}$
 Validator.HTTPCookieValue=^[a-zA-Z0-9\\-\\/+=_ ]*$
-# Note that max header name capped at 150 in SecurityRequestWrapper!
-Validator.HTTPHeaderName=^[a-zA-Z0-9\\-_]{1,50}$
+# Note that headerName and Value length is also configured in the HTTPUtilities section
+Validator.HTTPHeaderName=^[a-zA-Z0-9\\-_]{1,256}$
 Validator.HTTPHeaderValue=^[a-zA-Z0-9()\\-=\\*\\.\\?;,+\\/:&_ ]*$
 Validator.HTTPServletPath=^[a-zA-Z0-9.\\-\\/_]*$
 Validator.HTTPPath=^[a-zA-Z0-9.\\-_]*$

From 5c0e1de2ba09a2f606d26740a70a35fbe42a5090 Mon Sep 17 00:00:00 2001
From: Matt Seil 
Date: Mon, 24 Jul 2017 17:22:24 -0700
Subject: [PATCH 420/812] Issue #400 -- Added more unit tests for
 SecurityWrapperResponse.

---
 .../filters/SecurityWrapperResponse.java      | 19 ++++++++--
 .../filters/SecurityWrapperResponseTest.java  | 37 +++++++++++++++++++
 src/test/resources/esapi/ESAPI.properties     |  3 +-
 3 files changed, 54 insertions(+), 5 deletions(-)

diff --git a/src/main/java/org/owasp/esapi/filters/SecurityWrapperResponse.java b/src/main/java/org/owasp/esapi/filters/SecurityWrapperResponse.java
index 82e629557..343a44396 100644
--- a/src/main/java/org/owasp/esapi/filters/SecurityWrapperResponse.java
+++ b/src/main/java/org/owasp/esapi/filters/SecurityWrapperResponse.java
@@ -418,7 +418,8 @@ public void setBufferSize(int size) {
      * @param charset
      */
     public void setCharacterEncoding(String charset) {
-        getHttpServletResponse().setCharacterEncoding(ESAPI.securityConfiguration().getCharacterEncoding());
+    	SecurityConfiguration sc = ESAPI.securityConfiguration();
+        getHttpServletResponse().setCharacterEncoding(sc.getStringProp("HttpUtilities.CharacterEncoding"));
     }
 
     /**
@@ -506,7 +507,13 @@ public void setLocale(Locale loc) {
      * @param sc
      */
     public void setStatus(int sc) {
-        getHttpServletResponse().setStatus(HttpServletResponse.SC_OK);
+    	SecurityConfiguration config = ESAPI.securityConfiguration();
+    	if(config.getBooleanProp("HttpUtilities.OverwriteStatusCodes")){
+    		getHttpServletResponse().setStatus(HttpServletResponse.SC_OK);
+    	}else{
+    		getHttpServletResponse().setStatus(sc);
+    	}
+        
     }
 
     /**
@@ -520,8 +527,12 @@ public void setStatus(int sc) {
     @Deprecated
     public void setStatus(int sc, String sm) {
         try {
-            // setStatus is deprecated so use sendError instead
-            sendError(HttpServletResponse.SC_OK, sm);
+        	SecurityConfiguration config = ESAPI.securityConfiguration();
+        	if(config.getBooleanProp("HttpUtilities.OverwriteStatusCodes")){
+        		sendError(HttpServletResponse.SC_OK, sm);
+        	}else{
+        		sendError(sc, sm);
+        	}
         } catch (IOException e) {
             logger.warning(Logger.SECURITY_FAILURE, "Attempt to set response status failed", e);
         }
diff --git a/src/test/java/org/owasp/esapi/filters/SecurityWrapperResponseTest.java b/src/test/java/org/owasp/esapi/filters/SecurityWrapperResponseTest.java
index c61a20a20..8811f99f5 100644
--- a/src/test/java/org/owasp/esapi/filters/SecurityWrapperResponseTest.java
+++ b/src/test/java/org/owasp/esapi/filters/SecurityWrapperResponseTest.java
@@ -121,6 +121,7 @@ public void testAddValidCookieWithDomain(){
 		SecurityWrapperResponse spyResp = spy(resp);
 		Cookie cookie = new Cookie("Foo", TestUtils.generateStringOfLength(10));
 		cookie.setDomain("evil.com");
+		cookie.setMaxAge(-1);
 		Mockito.doCallRealMethod().when(spyResp).addCookie(cookie);
 		spyResp.addCookie(cookie);
 		verify(servResp, times(1)).addHeader("Set-Cookie", "Foo=aaaaaaaaaa; Domain=evil.com; Secure; HttpOnly");
@@ -152,4 +153,40 @@ public void testAddInValidCookie(){
 		spyResp.addCookie(cookie);
 		verify(servResp, times(0)).addHeader("Set-Cookie", "Foo=" + TestUtils.generateStringOfLength(5000) + "; Secure; HttpOnly");
 	}
+	
+	@Test
+	public void testSendError() throws Exception{
+		HttpServletResponse servResp = new MockHttpServletResponse();
+		servResp = spy(servResp);
+		SecurityWrapperResponse resp = new SecurityWrapperResponse(servResp);
+		SecurityWrapperResponse spyResp = spy(resp);
+		Mockito.doCallRealMethod().when(spyResp).sendError(200);
+		spyResp.sendError(200);
+		
+		verify(servResp, times(1)).sendError(200, "HTTP error code: 200");;
+	}
+	
+	@Test
+	public void testSendStatus() throws Exception{
+		HttpServletResponse servResp = new MockHttpServletResponse();
+		servResp = spy(servResp);
+		SecurityWrapperResponse resp = new SecurityWrapperResponse(servResp);
+		SecurityWrapperResponse spyResp = spy(resp);
+		Mockito.doCallRealMethod().when(spyResp).setStatus(200);;
+		spyResp.setStatus(200);
+		
+		verify(servResp, times(1)).setStatus(200);;
+	}
+	
+	@Test
+	public void testSendStatusWithString() throws Exception{
+		HttpServletResponse servResp = new MockHttpServletResponse();
+		servResp = spy(servResp);
+		SecurityWrapperResponse resp = new SecurityWrapperResponse(servResp);
+		SecurityWrapperResponse spyResp = spy(resp);
+		Mockito.doCallRealMethod().when(spyResp).setStatus(200, "foo");;
+		spyResp.setStatus(200, "foo");
+		
+		verify(servResp, times(1)).sendError(200, "foo");;
+	}
 }
diff --git a/src/test/resources/esapi/ESAPI.properties b/src/test/resources/esapi/ESAPI.properties
index 1ff0c4e65..6e4bc6246 100644
--- a/src/test/resources/esapi/ESAPI.properties
+++ b/src/test/resources/esapi/ESAPI.properties
@@ -347,7 +347,8 @@ HttpUtilities.ResponseContentType=text/html; charset=UTF-8
 HttpUtilities.HttpSessionIdName=JSESSIONID
 #Sets whether or not will will overwrite http status codes to 200.
 HttpUtilities.OverwriteStatusCodes=true
-
+#Sets the application's base character encoding.  This is forked from the Java Encryptor property.
+HttpUtilities.CharacterEncoding=UTF-8
 
 #===========================================================================
 # ESAPI Executor

From f73b9dbb7b1460b669f68231d8cefee9ac39881a Mon Sep 17 00:00:00 2001
From: Matt Seil 
Date: Mon, 24 Jul 2017 17:41:32 -0700
Subject: [PATCH 421/812] Issue #400 -- Got unit test coverage up to 65.5%

---
 .../filters/SecurityWrapperResponse.java      |  1 -
 .../filters/SecurityWrapperResponseTest.java  | 38 ++++++++++++++++++-
 2 files changed, 37 insertions(+), 2 deletions(-)

diff --git a/src/main/java/org/owasp/esapi/filters/SecurityWrapperResponse.java b/src/main/java/org/owasp/esapi/filters/SecurityWrapperResponse.java
index 343a44396..c1de913c4 100644
--- a/src/main/java/org/owasp/esapi/filters/SecurityWrapperResponse.java
+++ b/src/main/java/org/owasp/esapi/filters/SecurityWrapperResponse.java
@@ -384,7 +384,6 @@ public void sendError(int sc, String msg) throws IOException {
     	}else{
     		getHttpServletResponse().sendError(sc, ESAPI.encoder().encodeForHTML(msg));
     	}
-        
     }
 
     /**
diff --git a/src/test/java/org/owasp/esapi/filters/SecurityWrapperResponseTest.java b/src/test/java/org/owasp/esapi/filters/SecurityWrapperResponseTest.java
index 8811f99f5..478f0b050 100644
--- a/src/test/java/org/owasp/esapi/filters/SecurityWrapperResponseTest.java
+++ b/src/test/java/org/owasp/esapi/filters/SecurityWrapperResponseTest.java
@@ -39,6 +39,40 @@ public void testAddDateHeader(){
 		verify(servResp, times(1)).addDateHeader("Foo", currentTime);
 	}
 	
+	@Test
+	public void testSetDateHeader(){
+		HttpServletResponse servResp = mock(HttpServletResponse.class);
+		SecurityWrapperResponse resp = new SecurityWrapperResponse(servResp);
+		long currentTime = System.currentTimeMillis();
+		resp.setDateHeader("Foo", currentTime);
+		verify(servResp, times(1)).setDateHeader("Foo", currentTime);
+	}
+	
+	@Test
+	public void testSetInvalidDateHeader(){
+		HttpServletResponse servResp = mock(HttpServletResponse.class);
+		SecurityWrapperResponse resp = new SecurityWrapperResponse(servResp);
+		long currentTime = System.currentTimeMillis();
+		resp.setDateHeader("alert");
+		verify(servResp, times(0)).setHeader("foo", "");
+	}
+	
 	@Test
 	public void testInvalidDateHeader(){
 		HttpServletResponse servResp = mock(HttpServletResponse.class);
@@ -101,8 +135,10 @@ public void testAddValidCookie(){
 		SecurityWrapperResponse resp = new SecurityWrapperResponse(servResp);
 		SecurityWrapperResponse spyResp = spy(resp);
 		Cookie cookie = new Cookie("Foo", TestUtils.generateStringOfLength(10));
+		cookie.setMaxAge(5000);
 		Mockito.doCallRealMethod().when(spyResp).addCookie(cookie);
 		spyResp.addCookie(cookie);
+		
 		/*
 		 * We're indirectly testing our class.  Since it ultimately
 		 * delegates to HttpServletResponse.addHeader, we're actually 
@@ -110,7 +146,7 @@ public void testAddValidCookie(){
 		 * expected properties.  This implicitly tests the 
 		 * createCookieHeader method as well.
 		 */
-		verify(servResp, times(1)).addHeader("Set-Cookie", "Foo=aaaaaaaaaa; Secure; HttpOnly");
+		verify(servResp, times(1)).addHeader("Set-Cookie", "Foo=aaaaaaaaaa; Max-Age=5000; Secure; HttpOnly");
 	}
 	
 	@Test

From 271284e3c407e2be47d43062680e1fba6b058128 Mon Sep 17 00:00:00 2001
From: Matt Seil 
Date: Mon, 24 Jul 2017 18:14:24 -0700
Subject: [PATCH 422/812] Issue #317 -- Fixed resource leak.  Special thanks to
 eamonn.

---
 .../owasp/esapi/waf/rules/BeanShellRule.java  | 71 ++++++++++---------
 1 file changed, 37 insertions(+), 34 deletions(-)

diff --git a/src/main/java/org/owasp/esapi/waf/rules/BeanShellRule.java b/src/main/java/org/owasp/esapi/waf/rules/BeanShellRule.java
index ea0caa786..f90da574e 100644
--- a/src/main/java/org/owasp/esapi/waf/rules/BeanShellRule.java
+++ b/src/main/java/org/owasp/esapi/waf/rules/BeanShellRule.java
@@ -34,6 +34,7 @@
 
 /**
  * This is the Rule subclass executed for <bean-shell-script> rules.
+ *
  * @author Arshan Dabirsiaghi
  *
  */
@@ -42,43 +43,41 @@ public class BeanShellRule extends Rule {
 	private Interpreter i;
 	private String script;
 	private Pattern path;
-	
-	public BeanShellRule(String fileLocation, String id, Pattern path) throws IOException, EvalError { 
+
+	public BeanShellRule(String fileLocation, String id, Pattern path) throws IOException, EvalError {
 		i = new Interpreter();
 		i.set("logger", logger);
-		this.script = getFileContents( ESAPI.securityConfiguration().getResourceFile(fileLocation));
+		this.script = getFileContents(ESAPI.securityConfiguration().getResourceFile(fileLocation));
 		this.id = id;
 		this.path = path;
 	}
-	
-	public Action check(HttpServletRequest request,
-			InterceptingHTTPServletResponse response, 
+
+	public Action check(HttpServletRequest request, InterceptingHTTPServletResponse response,
 			HttpServletResponse httpResponse) {
 
 		/*
 		 * Early fail: if the URL doesn't match one we're interested in.
 		 */
-		
-		if ( path != null && ! path.matcher(request.getRequestURI()).matches() ) {
+
+		if (path != null && !path.matcher(request.getRequestURI()).matches()) {
 			return new DoNothingAction();
 		}
-		
+
 		/*
-		 * Run the beanshell that we've already parsed
-		 * and pre-compiled. Populate the "request"
-		 * and "response" objects so the script has
+		 * Run the beanshell that we've already parsed and pre-compiled.
+		 * Populate the "request" and "response" objects so the script has
 		 * access to the same variables we do here.
 		 */
-		
+
 		try {
-		
+
 			Action a = null;
-			
+
 			i.set("action", a);
 			i.set("request", request);
-			
-			if ( response != null ) {
-				i.set("response", response);	
+
+			if (response != null) {
+				i.set("response", response);
 			} else {
 				i.set("response", httpResponse);
 			}
@@ -86,31 +85,35 @@ public Action check(HttpServletRequest request,
 			i.set("session", request.getSession());
 			i.eval(script);
 
-			a = (Action)i.get("action");
-	
-			if ( a != null ) {
+			a = (Action) i.get("action");
+
+			if (a != null) {
 				return a;
 			}
-			
+
 		} catch (EvalError e) {
-			log(request,"Error running custom beanshell rule (" + id + ") - " + e.getMessage());
+			log(request, "Error running custom beanshell rule (" + id + ") - " + e.getMessage());
 		}
-	
+
 		return new DoNothingAction();
 	}
-	
+
 	private String getFileContents(File f) throws IOException {
-		
-		FileReader fr = new FileReader(f);
 		StringBuffer sb = new StringBuffer();
-		String line;
-		BufferedReader br = new BufferedReader(fr);
-		
-		while( (line=br.readLine()) != null ) {
-			sb.append(line + System.getProperty("line.separator"));
+		BufferedReader br = null;
+
+		try {
+			br = new BufferedReader(new FileReader(f));
+			String line;
+			while ((line = br.readLine()) != null) {
+				sb.append(line + System.getProperty("line.separator"));
+			}
+
+		} finally {
+			if (br != null) {
+				br.close();
+			}
 		}
-		
 		return sb.toString();
 	}
-
 }

From 9177ca3034b1af7fb7cd95a6433338b0b3a0ec03 Mon Sep 17 00:00:00 2001
From: Matt Seil 
Date: Tue, 25 Jul 2017 20:51:55 -0700
Subject: [PATCH 423/812] Issue #327 -- got rid of misleading HTML entity in
 URL regex.

---
 configuration/esapi/validation.properties | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/configuration/esapi/validation.properties b/configuration/esapi/validation.properties
index 433fa0b6b..dd24e46c3 100644
--- a/configuration/esapi/validation.properties
+++ b/configuration/esapi/validation.properties
@@ -23,7 +23,7 @@
 Validator.SafeString=^[.\\p{Alnum}\\p{Space}]{0,1024}$
 Validator.Email=^[A-Za-z0-9._%'-]+@[A-Za-z0-9.-]+\\.[a-zA-Z]{2,4}$
 Validator.IPAddress=^(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$
-Validator.URL=^(ht|f)tp(s?)\\:\\/\\/[0-9a-zA-Z]([-.\\w]*[0-9a-zA-Z])*(:(0-9)*)*(\\/?)([a-zA-Z0-9\\-\\.\\?\\,\\:\\'\\/\\\\\\+=&%\\$#_]*)?$
+Validator.URL=^(ht|f)tp(s?)\\:\\/\\/[0-9a-zA-Z]([-.\\w]*[0-9a-zA-Z])*(:(0-9)*)*(\\/?)([a-zA-Z0-9\\-\\.\\?\\,\\:\\'\\/\\\\\\+=&;%\\$#_]*)?$
 Validator.CreditCard=^(\\d{4}[- ]?){3}\\d{4}$
 Validator.SSN=^(?!000)([0-6]\\d{2}|7([0-6]\\d|7[012]))([ -]?)(?!00)\\d\\d\\3(?!0000)\\d{4}$
 

From 158c78924d624e26ea8a0110a50371420ad4e2ab Mon Sep 17 00:00:00 2001
From: adetlefsen-rms 
Date: Thu, 27 Jul 2017 12:32:27 -0700
Subject: [PATCH 424/812] Update AntiSamy and XOM versions

---
 pom.xml | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/pom.xml b/pom.xml
index 7bc646277..40386fbf6 100644
--- a/pom.xml
+++ b/pom.xml
@@ -174,9 +174,9 @@
             jar
         
         
-            xom
+            com.io7m.xom
             xom
-            1.2.5
+            1.2.10
         
         
             org.beanshell
@@ -186,7 +186,7 @@
         
             org.owasp.antisamy
             antisamy
-            1.5.5
+            1.5.6
         
         
+                                    8A2A524F
                                 
                             
                         

From 5e4e201e8552f94785e02ecc0c33e7c8d24efee7 Mon Sep 17 00:00:00 2001
From: kwwall 
Date: Mon, 31 Jul 2017 22:21:05 -0400
Subject: [PATCH 436/812] Remove trailing tab on line 881.

---
 src/main/java/org/owasp/esapi/crypto/CipherText.java | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/main/java/org/owasp/esapi/crypto/CipherText.java b/src/main/java/org/owasp/esapi/crypto/CipherText.java
index b327d1a2f..15a0b4675 100644
--- a/src/main/java/org/owasp/esapi/crypto/CipherText.java
+++ b/src/main/java/org/owasp/esapi/crypto/CipherText.java
@@ -878,7 +878,7 @@ private void received(EnumSet ctSet) {
      */
 	public int getKDFInfo() {
 		final int unusedBit28 = 0x8000000;  // 1000000000000000000000000000
-	
+
 		// 		kdf version is bits 1-27, bit 28 (reserved) should be 0, and
 		//		bits 29-32 are the MAC algorithm indicating which PRF to use for the KDF.
 		int kdfVers = this.getKDFVersion();

From 660054db9a8a366dee499928108fc9239894e84a Mon Sep 17 00:00:00 2001
From: Matt Seil 
Date: Tue, 1 Aug 2017 21:27:57 -0700
Subject: [PATCH 437/812] Issue #300 -- Solved the root problem, now have many
 unit tests to clean up.

---
 .../java/org/owasp/esapi/codecs/Codec.java    | 43 +++++++++++++++++--
 .../owasp/esapi/codecs/HTMLEntityCodec.java   | 36 ++++++++++++++++
 .../owasp/esapi/reference/EncoderTest.java    | 23 +++++++++-
 3 files changed, 98 insertions(+), 4 deletions(-)

diff --git a/src/main/java/org/owasp/esapi/codecs/Codec.java b/src/main/java/org/owasp/esapi/codecs/Codec.java
index ec02a806a..b9f545e52 100644
--- a/src/main/java/org/owasp/esapi/codecs/Codec.java
+++ b/src/main/java/org/owasp/esapi/codecs/Codec.java
@@ -64,9 +64,15 @@ public Codec() {
 	 */
 	public String encode(char[] immune, String input) {
 		StringBuilder sb = new StringBuilder();
-		for (int i = 0; i < input.length(); i++) {
-			char c = input.charAt(i);
-			sb.append(encodeCharacter(immune, c));
+		for(int offset  = 0; offset < input.length(); ){
+			final int point = input.codePointAt(offset);
+			if(Character.isBmpCodePoint(point)){
+				//We can then safely cast this to char and maintain legacy behavior.
+				sb.append(encodeCharacter(immune, (char) point));
+			}else{
+				sb.append(encodeCharacter(immune, point));	
+			}
+			offset += Character.charCount(point);
 		}
 		return sb.toString();
 	}
@@ -83,6 +89,19 @@ public String encode(char[] immune, String input) {
 	public String encodeCharacter( char[] immune, Character c ) {
 		return ""+c;
 	}
+	
+	/**
+	 * Default codepoint implementation that should be overridden in specific codecs.
+	 * 
+	 * @param immune
+	 * @param codePoint
+	 * 		the integer to encode
+	 * @return
+	 * 		the encoded Character
+	 */
+	public String encodeCharacter( char[] immune, int codePoint ) {
+		return new StringBuilder().appendCodePoint(codePoint).toString();
+	}
 
 	/**
 	 * Decode a String that was encoded using the encode method in this Class
@@ -131,6 +150,19 @@ public static String getHexForNonAlphanumeric(char c)
 			return hex[c];
 		return toHex(c);
 	}
+	
+	/**
+	 * Lookup the hex value of any character that is not alphanumeric.
+	 * @param c The character to lookup.
+	 * @return, return null if alphanumeric or the character code
+	 * 	in hex.
+	 */
+	public static String getHexForNonAlphanumeric(int c)
+	{
+		if(c<0xFF)
+			return hex[c];
+		return toHex(c);
+	}
 
 	public static String toOctal(char c)
 	{
@@ -141,6 +173,11 @@ public static String toHex(char c)
 	{
 		return Integer.toHexString(c);
 	}
+	
+	public static String toHex(int c)
+	{
+		return Integer.toHexString(c);
+	}
 
 	/**
 	 * Utility to search a char[] for a specific char.
diff --git a/src/main/java/org/owasp/esapi/codecs/HTMLEntityCodec.java b/src/main/java/org/owasp/esapi/codecs/HTMLEntityCodec.java
index cd72dc79c..c9ad38ca1 100644
--- a/src/main/java/org/owasp/esapi/codecs/HTMLEntityCodec.java
+++ b/src/main/java/org/owasp/esapi/codecs/HTMLEntityCodec.java
@@ -78,6 +78,42 @@ public String encodeCharacter( char[] immune, Character c ) {
 		return "&#x" + hex + ";";
 	}
 	
+	/**
+	 * {@inheritDoc}
+	 * 
+     * Encodes a Character for safe use in an HTML entity field.
+     * @param immune
+     */
+	public String encodeCharacter( char[] immune, int codePoint ) {
+
+		// check for immune characters
+//		if ( containsCharacter(codePoint, immune ) ) {
+//			return ""+codePoint;
+//		}
+		
+//		// check for alphanumeric characters
+		String hex = Codec.getHexForNonAlphanumeric(codePoint);
+//		if ( hex == null ) {
+//			return ""+c;
+//		}
+//		
+//		// check for illegal characters
+//		if ( ( c <= 0x1f && c != '\t' && c != '\n' && c != '\r' ) || ( c >= 0x7f && c <= 0x9f ) )
+//		{
+//			hex = REPLACEMENT_HEX;	// Let's entity encode this instead of returning it
+//			c = REPLACEMENT_CHAR;
+//		}
+//		
+//		// check if there's a defined entity
+//		String entityName = (String) characterToEntityMap.get(c);
+//		if (entityName != null) {
+//			return "&" + entityName + ";";
+//		}
+		
+		// return the hex entity as suggested in the spec
+		return "&#x" + hex + ";";
+	}
+	
 	/**
 	 * {@inheritDoc}
 	 * 
diff --git a/src/test/java/org/owasp/esapi/reference/EncoderTest.java b/src/test/java/org/owasp/esapi/reference/EncoderTest.java
index 45702ced4..896a93661 100644
--- a/src/test/java/org/owasp/esapi/reference/EncoderTest.java
+++ b/src/test/java/org/owasp/esapi/reference/EncoderTest.java
@@ -32,6 +32,7 @@
 import org.owasp.esapi.EncoderConstants;
 import org.owasp.esapi.codecs.Base64;
 import org.owasp.esapi.codecs.Codec;
+import org.owasp.esapi.codecs.HTMLEntityCodec;
 import org.owasp.esapi.codecs.MySQLCodec;
 import org.owasp.esapi.codecs.OracleCodec;
 import org.owasp.esapi.codecs.PushbackString;
@@ -902,7 +903,27 @@ public void testGetCanonicalizedUriWithMailto() throws Exception {
     	URI uri = new URI(input);
     	System.out.println(uri.toString());
     	assertEquals(expectedUri, e.getCanonicalizedURI(uri));
-    	
+    }
+    
+    public void testHtmlEncodeStrSurrogatePair()
+    {
+    	Encoder enc = ESAPI.encoder();
+        String inStr = new String (new int[]{0x2f804}, 0, 1);
+        assertEquals(false, Character.isBmpCodePoint(inStr.codePointAt(0)));
+        assertEquals(true, Character.isBmpCodePoint(new String(new int[] {0x0a}, 0, 1).codePointAt(0)));
+        String expected = "你";
+        String result;
+
+        result = enc.encodeForHTML(inStr);
+        assertEquals(expected, result);
+    }
+    
+    public void testHtmlDecodeHexEntititesSurrogatePair()
+    {
+    	HTMLEntityCodec htmlCodec = new HTMLEntityCodec();
+        String expected = new String (new int[]{0x2f804}, 0, 1);
+        assertEquals( expected, htmlCodec.decode("你") );
+        assertEquals( expected, htmlCodec.decode("你") );
     }
 }
 

From 45b3d1680bf90133f1ac6fc2addafe9c5855de98 Mon Sep 17 00:00:00 2001
From: Matt Seil 
Date: Tue, 1 Aug 2017 23:00:10 -0700
Subject: [PATCH 438/812] Issue #300 -- Fixed most unit tests.  chars are NOT
 autoboxed to Characters, make sure we update documentation!

---
 .../java/org/owasp/esapi/PreparedString.java  |   1 +
 .../org/owasp/esapi/codecs/AbstractCodec.java | 173 ++++++++++++++++++
 .../java/org/owasp/esapi/codecs/CSSCodec.java |   4 +-
 .../java/org/owasp/esapi/codecs/Codec.java    | 104 ++---------
 .../java/org/owasp/esapi/codecs/DB2Codec.java |   2 +-
 .../owasp/esapi/codecs/HTMLEntityCodec.java   |   6 +-
 .../owasp/esapi/codecs/JavaScriptCodec.java   |   4 +-
 .../org/owasp/esapi/codecs/MySQLCodec.java    |   4 +-
 .../org/owasp/esapi/codecs/OracleCodec.java   |   2 +-
 .../org/owasp/esapi/codecs/PercentCodec.java  |   2 +-
 .../org/owasp/esapi/codecs/UnixCodec.java     |   4 +-
 .../org/owasp/esapi/codecs/VBScriptCodec.java |   4 +-
 .../org/owasp/esapi/codecs/WindowsCodec.java  |   4 +-
 .../owasp/esapi/codecs/XMLEntityCodec.java    |   2 +-
 .../org/owasp/esapi/PreparedStringTest.java   |   1 +
 ...{CodecTest.java => AbstractCodecTest.java} |  38 ++--
 .../owasp/esapi/codecs/CodecImmunityTest.java |   4 +-
 .../owasp/esapi/reference/RandomizerTest.java |   2 +-
 18 files changed, 228 insertions(+), 133 deletions(-)
 create mode 100644 src/main/java/org/owasp/esapi/codecs/AbstractCodec.java
 rename src/test/java/org/owasp/esapi/codecs/{CodecTest.java => AbstractCodecTest.java} (96%)

diff --git a/src/main/java/org/owasp/esapi/PreparedString.java b/src/main/java/org/owasp/esapi/PreparedString.java
index 3dccff055..176421347 100644
--- a/src/main/java/org/owasp/esapi/PreparedString.java
+++ b/src/main/java/org/owasp/esapi/PreparedString.java
@@ -16,6 +16,7 @@
 package org.owasp.esapi;
 
 import java.util.ArrayList;
+
 import org.owasp.esapi.codecs.Codec;
 import org.owasp.esapi.codecs.HTMLEntityCodec;
 
diff --git a/src/main/java/org/owasp/esapi/codecs/AbstractCodec.java b/src/main/java/org/owasp/esapi/codecs/AbstractCodec.java
new file mode 100644
index 000000000..11d33f8a8
--- /dev/null
+++ b/src/main/java/org/owasp/esapi/codecs/AbstractCodec.java
@@ -0,0 +1,173 @@
+/**
+ * OWASP Enterprise Security API (ESAPI)
+ * 
+ * This file is part of the Open Web Application Security Project (OWASP)
+ * Enterprise Security API (ESAPI) project. For details, please see
+ * http://www.owasp.org/index.php/ESAPI.
+ *
+ * Copyright (c) 2007 - The OWASP Foundation
+ * 
+ * The ESAPI is published by OWASP under the BSD license. You should read and accept the
+ * LICENSE before you use, modify, and/or redistribute this software.
+ * 
+ * @author Jeff Williams Aspect Security
+ * @created 2007
+ */
+package org.owasp.esapi.codecs;
+
+
+/**
+ * The Codec interface defines a set of methods for encoding and decoding application level encoding schemes,
+ * such as HTML entity encoding and percent encoding (aka URL encoding). Codecs are used in output encoding
+ * and canonicalization.  The design of these codecs allows for character-by-character decoding, which is
+ * necessary to detect double-encoding and the use of multiple encoding schemes, both of which are techniques
+ * used by attackers to bypass validation and bury encoded attacks in data.
+ * 
+ * @author Jeff Williams (jeff.williams .at. aspectsecurity.com) Aspect Security
+ * @since June 1, 2007
+ * @see org.owasp.esapi.Encoder
+ */
+public abstract class AbstractCodec implements Codec {
+
+	/**
+	 * Initialize an array to mark which characters are to be encoded. Store the hex
+	 * string for that character to save time later. If the character shouldn't be
+	 * encoded, then store null.
+	 */
+	private final String[] hex = new String[256];
+
+	/**
+	 * Default constructor
+	 */
+	public AbstractCodec() {
+		for ( char c = 0; c < 0xFF; c++ ) {
+			if ( c >= 0x30 && c <= 0x39 || c >= 0x41 && c <= 0x5A || c >= 0x61 && c <= 0x7A ) {
+				hex[c] = null;
+			} else {
+				hex[c] = toHex(c).intern();
+			}
+		}
+	}
+
+	/* (non-Javadoc)
+	 * @see org.owasp.esapi.codecs.Codec#encode(char[], java.lang.String)
+	 */
+	@Override
+	public String encode(char[] immune, String input) {
+		StringBuilder sb = new StringBuilder();
+		for(int offset  = 0; offset < input.length(); ){
+			final int point = input.codePointAt(offset);
+			if(Character.isBmpCodePoint(point)){
+				//We can then safely cast this to char and maintain legacy behavior.
+				sb.append(encodeCharacter(immune, new Character((char) point)));
+			}else{
+				sb.append(encodeCharacter(immune, point));	
+			}
+			offset += Character.charCount(point);
+		}
+		return sb.toString();
+	}
+
+	/**
+	 * WARNING!!!!  Passing a standard char to this method will resolve to the 
+	 * @{code public String encodeCharacter( char[] immune, int codePoint )} method
+	 * instead of this one!!!  YOU HAVE BEEN WARNED!!!!
+	 * 
+	 * @{Inherit}
+	 */
+	@Override
+	public String encodeCharacter( char[] immune, Character c ) {
+		return ""+c;
+	}
+	
+	/* (non-Javadoc)
+	 * @see org.owasp.esapi.codecs.Codec#encodeCharacter(char[], int)
+	 */
+	@Override
+	public String encodeCharacter( char[] immune, int codePoint ) {
+		return new StringBuilder().appendCodePoint(codePoint).toString();
+	}
+
+	/* (non-Javadoc)
+	 * @see org.owasp.esapi.codecs.Codec#decode(java.lang.String)
+	 */
+	@Override
+	public String decode(String input) {
+		StringBuilder sb = new StringBuilder();
+		PushbackString pbs = new PushbackString(input);
+		while (pbs.hasNext()) {
+			Character c = decodeCharacter(pbs);
+			if (c != null) {
+				sb.append(c);
+			} else {
+				sb.append(pbs.next());
+			}
+		}
+		return sb.toString();
+	}
+
+	/* (non-Javadoc)
+	 * @see org.owasp.esapi.codecs.Codec#decodeCharacter(org.owasp.esapi.codecs.PushbackString)
+	 */
+	@Override
+	public Character decodeCharacter( PushbackString input ) {
+		return input.next();
+	}
+
+	/**
+	 * Lookup the hex value of any character that is not alphanumeric.
+	 * @param c The character to lookup.
+	 * @return, return null if alphanumeric or the character code
+	 * 	in hex.
+	 */
+	public String getHexForNonAlphanumeric(char c)
+	{
+		if(c<0xFF)
+			return hex[c];
+		return toHex(c);
+	}
+	
+	/**
+	 * Lookup the hex value of any character that is not alphanumeric.
+	 * @param c The character to lookup.
+	 * @return, return null if alphanumeric or the character code
+	 * 	in hex.
+	 */
+	public String getHexForNonAlphanumeric(int c)
+	{
+		if(c<0xFF)
+			return hex[c];
+		return toHex(c);
+	}
+
+	public String toOctal(char c)
+	{
+		return Integer.toOctalString(c);
+	}
+
+	public String toHex(char c)
+	{
+		return Integer.toHexString(c);
+	}
+	
+	public String toHex(int c)
+	{
+		return Integer.toHexString(c);
+	}
+
+	/**
+	 * Utility to search a char[] for a specific char.
+	 * 
+	 * @param c
+	 * @param array
+	 * @return
+	 */
+	public boolean containsCharacter( char c, char[] array ) {
+		for (char ch : array) {
+			if (c == ch) return true;
+		}
+		return false;
+	}
+
+}
diff --git a/src/main/java/org/owasp/esapi/codecs/CSSCodec.java b/src/main/java/org/owasp/esapi/codecs/CSSCodec.java
index cee77ccaf..a44cebeed 100644
--- a/src/main/java/org/owasp/esapi/codecs/CSSCodec.java
+++ b/src/main/java/org/owasp/esapi/codecs/CSSCodec.java
@@ -23,7 +23,7 @@
  * @since June 1, 2007
  * @see org.owasp.esapi.Encoder
  */
-public class CSSCodec extends Codec
+public class CSSCodec extends AbstractCodec
 {
 	private static final Character REPLACEMENT = '\ufffd';
 
@@ -42,7 +42,7 @@ public String encodeCharacter(char[] immune, Character c) {
 		}
 		
 		// check for alphanumeric characters
-		String hex = Codec.getHexForNonAlphanumeric(c);
+		String hex = super.getHexForNonAlphanumeric(c);
 		if ( hex == null ) {
 			return ""+c;
 		}
diff --git a/src/main/java/org/owasp/esapi/codecs/Codec.java b/src/main/java/org/owasp/esapi/codecs/Codec.java
index b9f545e52..3f7cd2554 100644
--- a/src/main/java/org/owasp/esapi/codecs/Codec.java
+++ b/src/main/java/org/owasp/esapi/codecs/Codec.java
@@ -28,32 +28,7 @@
  * @since June 1, 2007
  * @see org.owasp.esapi.Encoder
  */
-public abstract class Codec {
-
-	/**
-	 * Initialize an array to mark which characters are to be encoded. Store the hex
-	 * string for that character to save time later. If the character shouldn't be
-	 * encoded, then store null.
-	 */
-	private static final String[] hex = new String[256];
-
-	static {
-		for ( char c = 0; c < 0xFF; c++ ) {
-			if ( c >= 0x30 && c <= 0x39 || c >= 0x41 && c <= 0x5A || c >= 0x61 && c <= 0x7A ) {
-				hex[c] = null;
-			} else {
-				hex[c] = toHex(c).intern();
-			}
-		}
-	}
-
-
-	/**
-	 * Default constructor
-	 */
-	public Codec() {
-	}
-
+public interface Codec {
 	/**
 	 * Encode a String so that it can be safely used in a specific context.
 	 * 
@@ -62,20 +37,7 @@ public Codec() {
 	 * 		the String to encode
 	 * @return the encoded String
 	 */
-	public String encode(char[] immune, String input) {
-		StringBuilder sb = new StringBuilder();
-		for(int offset  = 0; offset < input.length(); ){
-			final int point = input.codePointAt(offset);
-			if(Character.isBmpCodePoint(point)){
-				//We can then safely cast this to char and maintain legacy behavior.
-				sb.append(encodeCharacter(immune, (char) point));
-			}else{
-				sb.append(encodeCharacter(immune, point));	
-			}
-			offset += Character.charCount(point);
-		}
-		return sb.toString();
-	}
+	public String encode(char[] immune, String input);
 
 	/**
 	 * Default implementation that should be overridden in specific codecs.
@@ -86,9 +48,7 @@ public String encode(char[] immune, String input) {
 	 * @return
 	 * 		the encoded Character
 	 */
-	public String encodeCharacter( char[] immune, Character c ) {
-		return ""+c;
-	}
+	public String encodeCharacter( char[] immune, Character c );
 	
 	/**
 	 * Default codepoint implementation that should be overridden in specific codecs.
@@ -99,9 +59,7 @@ public String encodeCharacter( char[] immune, Character c ) {
 	 * @return
 	 * 		the encoded Character
 	 */
-	public String encodeCharacter( char[] immune, int codePoint ) {
-		return new StringBuilder().appendCodePoint(codePoint).toString();
-	}
+	public String encodeCharacter( char[] immune, int codePoint );
 
 	/**
 	 * Decode a String that was encoded using the encode method in this Class
@@ -111,19 +69,7 @@ public String encodeCharacter( char[] immune, int codePoint ) {
 	 * @return
 	 *		the decoded String
 	 */
-	public String decode(String input) {
-		StringBuilder sb = new StringBuilder();
-		PushbackString pbs = new PushbackString(input);
-		while (pbs.hasNext()) {
-			Character c = decodeCharacter(pbs);
-			if (c != null) {
-				sb.append(c);
-			} else {
-				sb.append(pbs.next());
-			}
-		}
-		return sb.toString();
-	}
+	public String decode(String input);
 
 	/**
 	 * Returns the decoded version of the next character from the input string and advances the
@@ -134,9 +80,7 @@ public String decode(String input) {
 	 * 
 	 * @return the decoded Character
 	 */
-	public Character decodeCharacter( PushbackString input ) {
-		return input.next();
-	}
+	public Character decodeCharacter( PushbackString input );
 
 	/**
 	 * Lookup the hex value of any character that is not alphanumeric.
@@ -144,12 +88,7 @@ public Character decodeCharacter( PushbackString input ) {
 	 * @return, return null if alphanumeric or the character code
 	 * 	in hex.
 	 */
-	public static String getHexForNonAlphanumeric(char c)
-	{
-		if(c<0xFF)
-			return hex[c];
-		return toHex(c);
-	}
+	public String getHexForNonAlphanumeric(char c);
 	
 	/**
 	 * Lookup the hex value of any character that is not alphanumeric.
@@ -157,27 +96,13 @@ public static String getHexForNonAlphanumeric(char c)
 	 * @return, return null if alphanumeric or the character code
 	 * 	in hex.
 	 */
-	public static String getHexForNonAlphanumeric(int c)
-	{
-		if(c<0xFF)
-			return hex[c];
-		return toHex(c);
-	}
+	public String getHexForNonAlphanumeric(int c);
 
-	public static String toOctal(char c)
-	{
-		return Integer.toOctalString(c);
-	}
+	public String toOctal(char c);
 
-	public static String toHex(char c)
-	{
-		return Integer.toHexString(c);
-	}
+	public String toHex(char c);
 	
-	public static String toHex(int c)
-	{
-		return Integer.toHexString(c);
-	}
+	public String toHex(int c);
 
 	/**
 	 * Utility to search a char[] for a specific char.
@@ -186,11 +111,6 @@ public static String toHex(int c)
 	 * @param array
 	 * @return
 	 */
-	public static boolean containsCharacter( char c, char[] array ) {
-		for (char ch : array) {
-			if (c == ch) return true;
-		}
-		return false;
-	}
+	public boolean containsCharacter( char c, char[] array );
 
 }
diff --git a/src/main/java/org/owasp/esapi/codecs/DB2Codec.java b/src/main/java/org/owasp/esapi/codecs/DB2Codec.java
index 4ff63ea1a..236bed78e 100644
--- a/src/main/java/org/owasp/esapi/codecs/DB2Codec.java
+++ b/src/main/java/org/owasp/esapi/codecs/DB2Codec.java
@@ -20,7 +20,7 @@
  * @since October 26, 2010
  * @see org.owasp.esapi.Encoder
  */
-public class DB2Codec extends Codec {
+public class DB2Codec extends AbstractCodec {
 
 	public String encodeCharacter(char[] immune, Character c) {
 
diff --git a/src/main/java/org/owasp/esapi/codecs/HTMLEntityCodec.java b/src/main/java/org/owasp/esapi/codecs/HTMLEntityCodec.java
index c9ad38ca1..e3892d2f8 100644
--- a/src/main/java/org/owasp/esapi/codecs/HTMLEntityCodec.java
+++ b/src/main/java/org/owasp/esapi/codecs/HTMLEntityCodec.java
@@ -27,7 +27,7 @@
  * @since June 1, 2007
  * @see org.owasp.esapi.Encoder
  */
-public class HTMLEntityCodec extends Codec
+public class HTMLEntityCodec extends AbstractCodec
 {
 	private static final char REPLACEMENT_CHAR = '\ufffd';
 	private static final String REPLACEMENT_HEX = "fffd";
@@ -56,7 +56,7 @@ public String encodeCharacter( char[] immune, Character c ) {
 		}
 		
 		// check for alphanumeric characters
-		String hex = Codec.getHexForNonAlphanumeric(c);
+		String hex = super.getHexForNonAlphanumeric(c);
 		if ( hex == null ) {
 			return ""+c;
 		}
@@ -92,7 +92,7 @@ public String encodeCharacter( char[] immune, int codePoint ) {
 //		}
 		
 //		// check for alphanumeric characters
-		String hex = Codec.getHexForNonAlphanumeric(codePoint);
+		String hex = super.getHexForNonAlphanumeric(codePoint);
 //		if ( hex == null ) {
 //			return ""+c;
 //		}
diff --git a/src/main/java/org/owasp/esapi/codecs/JavaScriptCodec.java b/src/main/java/org/owasp/esapi/codecs/JavaScriptCodec.java
index 7980155e1..98c38c7b2 100644
--- a/src/main/java/org/owasp/esapi/codecs/JavaScriptCodec.java
+++ b/src/main/java/org/owasp/esapi/codecs/JavaScriptCodec.java
@@ -24,7 +24,7 @@
  * @since June 1, 2007
  * @see org.owasp.esapi.Encoder
  */
-public class JavaScriptCodec extends Codec {
+public class JavaScriptCodec extends AbstractCodec {
 
 
 	/**
@@ -45,7 +45,7 @@ public String encodeCharacter( char[] immune, Character c ) {
 		}
 		
 		// check for alphanumeric characters
-		String hex = Codec.getHexForNonAlphanumeric(c);
+		String hex = super.getHexForNonAlphanumeric(c);
 		if ( hex == null ) {
 			return ""+c;
 		}
diff --git a/src/main/java/org/owasp/esapi/codecs/MySQLCodec.java b/src/main/java/org/owasp/esapi/codecs/MySQLCodec.java
index 7d2aacbaa..e43f13ca2 100644
--- a/src/main/java/org/owasp/esapi/codecs/MySQLCodec.java
+++ b/src/main/java/org/owasp/esapi/codecs/MySQLCodec.java
@@ -26,7 +26,7 @@
  * @since June 1, 2007
  * @see org.owasp.esapi.Encoder
  */
-public class MySQLCodec extends Codec {
+public class MySQLCodec extends AbstractCodec {
     /**
      * Specifies the SQL Mode the target MySQL Server is running with. For details about MySQL Server Modes
      * please see the Manual at {@link http://dev.mysql.com/doc/refman/5.0/en/server-sql-mode.html#sqlmode_ansi}
@@ -95,7 +95,7 @@ public String encodeCharacter( char[] immune, Character c ) {
 		}
 		
 		// check for alphanumeric characters
-		String hex = Codec.getHexForNonAlphanumeric( ch );
+		String hex = super.getHexForNonAlphanumeric( ch );
 		if ( hex == null ) {
 			return ""+ch;
 		}
diff --git a/src/main/java/org/owasp/esapi/codecs/OracleCodec.java b/src/main/java/org/owasp/esapi/codecs/OracleCodec.java
index 540920d24..06cca0609 100644
--- a/src/main/java/org/owasp/esapi/codecs/OracleCodec.java
+++ b/src/main/java/org/owasp/esapi/codecs/OracleCodec.java
@@ -30,7 +30,7 @@
  * @since June 1, 2007
  * @see org.owasp.esapi.Encoder
  */
-public class OracleCodec extends Codec {
+public class OracleCodec extends AbstractCodec {
 
 
 	/**
diff --git a/src/main/java/org/owasp/esapi/codecs/PercentCodec.java b/src/main/java/org/owasp/esapi/codecs/PercentCodec.java
index 42e1d040e..ed7e65dd8 100644
--- a/src/main/java/org/owasp/esapi/codecs/PercentCodec.java
+++ b/src/main/java/org/owasp/esapi/codecs/PercentCodec.java
@@ -28,7 +28,7 @@
  * @since June 1, 2007
  * @see org.owasp.esapi.Encoder
  */
-public class PercentCodec extends Codec
+public class PercentCodec extends AbstractCodec
 {
 	private static final String ALPHA_NUMERIC_STR = "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789";
 	@SuppressWarnings("unused")
diff --git a/src/main/java/org/owasp/esapi/codecs/UnixCodec.java b/src/main/java/org/owasp/esapi/codecs/UnixCodec.java
index 489cf073b..3381e82f0 100644
--- a/src/main/java/org/owasp/esapi/codecs/UnixCodec.java
+++ b/src/main/java/org/owasp/esapi/codecs/UnixCodec.java
@@ -24,7 +24,7 @@
  * @since June 1, 2007
  * @see org.owasp.esapi.Encoder
  */
-public class UnixCodec extends Codec {
+public class UnixCodec extends AbstractCodec {
 
 	/**
 	 * {@inheritDoc}
@@ -42,7 +42,7 @@ public String encodeCharacter( char[] immune, Character c ) {
 		}
 		
 		// check for alphanumeric characters
-		String hex = Codec.getHexForNonAlphanumeric( ch );
+		String hex = super.getHexForNonAlphanumeric( ch );
 		if ( hex == null ) {
 			return ""+ch;
 		}
diff --git a/src/main/java/org/owasp/esapi/codecs/VBScriptCodec.java b/src/main/java/org/owasp/esapi/codecs/VBScriptCodec.java
index 31442127a..85ce820e9 100644
--- a/src/main/java/org/owasp/esapi/codecs/VBScriptCodec.java
+++ b/src/main/java/org/owasp/esapi/codecs/VBScriptCodec.java
@@ -26,7 +26,7 @@
  * @since June 1, 2007
  * @see org.owasp.esapi.Encoder
  */
-public class VBScriptCodec extends Codec {
+public class VBScriptCodec extends AbstractCodec {
 
 	/**
 	 * Encode a String so that it can be safely used in a specific context.
@@ -78,7 +78,7 @@ public String encodeCharacter( char[] immune, Character c ) {
 		}
 		
 		// check for alphanumeric characters
-		String hex = Codec.getHexForNonAlphanumeric( ch );
+		String hex = super.getHexForNonAlphanumeric( ch );
 		if ( hex == null ) {
 			return ""+ch;
 		}
diff --git a/src/main/java/org/owasp/esapi/codecs/WindowsCodec.java b/src/main/java/org/owasp/esapi/codecs/WindowsCodec.java
index f7abb3a4b..bcc53f626 100644
--- a/src/main/java/org/owasp/esapi/codecs/WindowsCodec.java
+++ b/src/main/java/org/owasp/esapi/codecs/WindowsCodec.java
@@ -24,7 +24,7 @@
  * @since June 1, 2007
  * @see org.owasp.esapi.Encoder
  */
-public class WindowsCodec extends Codec {
+public class WindowsCodec extends AbstractCodec {
 
 	
 	/**
@@ -43,7 +43,7 @@ public String encodeCharacter( char[] immune, Character c ) {
 		}
 		
 		// check for alphanumeric characters
-		String hex = Codec.getHexForNonAlphanumeric( ch );
+		String hex = super.getHexForNonAlphanumeric( ch );
 		if ( hex == null ) {
 			return ""+ch;
 		}
diff --git a/src/main/java/org/owasp/esapi/codecs/XMLEntityCodec.java b/src/main/java/org/owasp/esapi/codecs/XMLEntityCodec.java
index e248392ac..25b4ffbc4 100644
--- a/src/main/java/org/owasp/esapi/codecs/XMLEntityCodec.java
+++ b/src/main/java/org/owasp/esapi/codecs/XMLEntityCodec.java
@@ -41,7 +41,7 @@
  * of knowing about. Decoding is included for completeness but it's use
  * is not recommended. Use a XML parser instead!
  */
-public class XMLEntityCodec extends Codec
+public class XMLEntityCodec extends AbstractCodec
 {
 	private static final String ALPHA_NUMERIC_STR = "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789";
 	private static final String UNENCODED_STR = ALPHA_NUMERIC_STR + " \t";
diff --git a/src/test/java/org/owasp/esapi/PreparedStringTest.java b/src/test/java/org/owasp/esapi/PreparedStringTest.java
index b288c1325..c3ddf8ece 100644
--- a/src/test/java/org/owasp/esapi/PreparedStringTest.java
+++ b/src/test/java/org/owasp/esapi/PreparedStringTest.java
@@ -17,6 +17,7 @@
 package org.owasp.esapi;
 
 import junit.framework.TestCase;
+
 import org.owasp.esapi.codecs.Codec;
 import org.owasp.esapi.codecs.HTMLEntityCodec;
 
diff --git a/src/test/java/org/owasp/esapi/codecs/CodecTest.java b/src/test/java/org/owasp/esapi/codecs/AbstractCodecTest.java
similarity index 96%
rename from src/test/java/org/owasp/esapi/codecs/CodecTest.java
rename to src/test/java/org/owasp/esapi/codecs/AbstractCodecTest.java
index 8a7a225ba..1472e5dfb 100644
--- a/src/test/java/org/owasp/esapi/codecs/CodecTest.java
+++ b/src/test/java/org/owasp/esapi/codecs/AbstractCodecTest.java
@@ -26,7 +26,7 @@
  *         href="http://www.aspectsecurity.com">Aspect Security
  * @since June 1, 2007
  */
-public class CodecTest extends TestCase {
+public class AbstractCodecTest extends TestCase {
 
     private static final char[] EMPTY_CHAR_ARRAY = new char[0];
     private static final Character LESS_THAN = Character.valueOf('<');
@@ -48,7 +48,7 @@ public class CodecTest extends TestCase {
      * @param testName
      *            the test name
      */
-    public CodecTest(String testName) {
+    public AbstractCodecTest(String testName) {
         super(testName);
     }
 
@@ -74,7 +74,7 @@ protected void tearDown() throws Exception {
      * @return the test
      */
     public static Test suite() {
-        TestSuite suite = new TestSuite(CodecTest.class);
+        TestSuite suite = new TestSuite(AbstractCodecTest.class);
         return suite;
     }
 
@@ -142,7 +142,7 @@ public void testHtmlEncodeChar()
 
 	public void testHtmlEncodeChar0x100()
 	{
-		char in = 0x100;
+		Character in = 0x100;
 		String inStr = Character.toString(in);
 		String expected = "Ā";
 		String result;
@@ -156,7 +156,7 @@ public void testHtmlEncodeChar0x100()
 
 	public void testHtmlEncodeStr0x100()
 	{
-		char in = 0x100;
+		Character in = 0x100;
 		String inStr = Character.toString(in);
 		String expected = "Ā";
 		String result;
@@ -175,7 +175,7 @@ public void testPercentEncodeChar()
 
 	public void testPercentEncodeChar0x100()
 	{
-		char in = 0x100;
+		Character in = 0x100;
 		String inStr = Character.toString(in);
 		String expected = "%C4%80";
 		String result;
@@ -189,7 +189,7 @@ public void testPercentEncodeChar0x100()
 
 	public void testPercentEncodeStr0x100()
 	{
-		char in = 0x100;
+		Character in = 0x100;
 		String inStr = Character.toString(in);
 		String expected = "%C4%80";
 		String result;
@@ -208,7 +208,7 @@ public void testJavaScriptEncodeChar()
 
 	public void testJavaScriptEncodeChar0x100()
 	{
-		char in = 0x100;
+		Character in = 0x100;
 		String inStr = Character.toString(in);
 		String expected = "\\u0100";
 		String result;
@@ -221,7 +221,7 @@ public void testJavaScriptEncodeChar0x100()
 
 	public void testJavaScriptEncodeStr0x100()
 	{
-		char in = 0x100;
+		Character in = 0x100;
 		String inStr = Character.toString(in);
 		String expected = "\\u0100";
 		String result;
@@ -239,7 +239,7 @@ public void testVBScriptEncodeChar()
 
 	public void testVBScriptEncodeChar0x100()
 	{
-		char in = 0x100;
+		Character in = 0x100;
 		String inStr = Character.toString(in);
 		// FIXME I don't know vb...
 		// String expected = "\\u0100";
@@ -253,7 +253,7 @@ public void testVBScriptEncodeChar0x100()
 
 	public void testVBScriptEncodeStr0x100()
 	{
-		char in = 0x100;
+		Character in = 0x100;
 		String inStr = Character.toString(in);
 		// FIXME I don't know vb...
 		// String expected = "chrw(0x100)";
@@ -272,7 +272,7 @@ public void testCSSEncodeChar()
 
 	public void testCSSEncodeChar0x100()
 	{
-		char in = 0x100;
+		Character in = 0x100;
 		String inStr = Character.toString(in);
 		String expected = "\\100 ";
 		String result;
@@ -285,7 +285,7 @@ public void testCSSEncodeChar0x100()
 
 	public void testCSSEncodeStr0x100()
 	{
-		char in = 0x100;
+		Character in = 0x100;
 		String inStr = Character.toString(in);
 		String expected = "\\100 ";
 		String result;
@@ -303,7 +303,7 @@ public void testMySQLANSIEncodeChar()
 
 	public void testMySQLStandardEncodeChar0x100()
 	{
-		char in = 0x100;
+		Character in = 0x100;
 		String inStr = Character.toString(in);
 		String expected = "\\" + in;
 		String result;
@@ -316,7 +316,7 @@ public void testMySQLStandardEncodeChar0x100()
 
 	public void testMySQLStandardEncodeStr0x100()
 	{
-		char in = 0x100;
+		Character in = 0x100;
 		String inStr = Character.toString(in);
 		String expected = "\\" + in;
 		String result;
@@ -344,7 +344,7 @@ public void testUnixEncodeChar()
 
 	public void testUnixEncodeChar0x100()
 	{
-		char in = 0x100;
+		Character in = 0x100;
 		String inStr = Character.toString(in);
 		String expected = "\\" + in;
 		String result;
@@ -357,7 +357,7 @@ public void testUnixEncodeChar0x100()
 
 	public void testUnixEncodeStr0x100()
 	{
-		char in = 0x100;
+		Character in = 0x100;
 		String inStr = Character.toString(in);
 		String expected = "\\" + in;
 		String result;
@@ -375,7 +375,7 @@ public void testWindowsEncodeChar()
 
 	public void testWindowsEncodeChar0x100()
 	{
-		char in = 0x100;
+		Character in = 0x100;
 		String inStr = Character.toString(in);
 		String expected = "^" + in;
 		String result;
@@ -388,7 +388,7 @@ public void testWindowsEncodeChar0x100()
 
 	public void testWindowsEncodeStr0x100()
 	{
-		char in = 0x100;
+		Character in = 0x100;
 		String inStr = Character.toString(in);
 		String expected = "^" + in;
 		String result;
diff --git a/src/test/java/org/owasp/esapi/codecs/CodecImmunityTest.java b/src/test/java/org/owasp/esapi/codecs/CodecImmunityTest.java
index 7d35dc168..9a3b8806f 100644
--- a/src/test/java/org/owasp/esapi/codecs/CodecImmunityTest.java
+++ b/src/test/java/org/owasp/esapi/codecs/CodecImmunityTest.java
@@ -43,7 +43,7 @@ public class CodecImmunityTest {
 
     @Parameters(name = "{0}")
     public static Collection getParams() {
-        Collection knownCodecs = new ArrayList();
+        Collection knownCodecs = new ArrayList();
         knownCodecs.add(new CSSCodec());
         knownCodecs.add(new DB2Codec());
         knownCodecs.add(new HTMLEntityCodec());
@@ -99,7 +99,7 @@ private static Collection buildImmunitiyValidation(Codec codec, char[]
         return params;
     }
 
-    private static Collection fullCharacterCodecValidation(Collection codecs) {
+    private static Collection fullCharacterCodecValidation(Collection codecs) {
         char[] holyCowTesting = StringUtilities.union(EncoderConstants.CHAR_ALPHANUMERICS, EncoderConstants.CHAR_SPECIALS); 
         Collection params = new ArrayList();
         for (Codec codec: codecs) {
diff --git a/src/test/java/org/owasp/esapi/reference/RandomizerTest.java b/src/test/java/org/owasp/esapi/reference/RandomizerTest.java
index b73a0241d..32dc9bd1f 100644
--- a/src/test/java/org/owasp/esapi/reference/RandomizerTest.java
+++ b/src/test/java/org/owasp/esapi/reference/RandomizerTest.java
@@ -26,7 +26,7 @@
 import org.owasp.esapi.ESAPI;
 import org.owasp.esapi.EncoderConstants;
 import org.owasp.esapi.Randomizer;
-import org.owasp.esapi.codecs.Codec;
+import org.owasp.esapi.codecs.AbstractCodec;
 import org.owasp.esapi.errors.EncryptionException;
 
 /**

From ca044492e3678f38323cd1c89c39dbfeed920a74 Mon Sep 17 00:00:00 2001
From: Matt Seil 
Date: Fri, 4 Aug 2017 15:40:50 -0700
Subject: [PATCH 439/812] Issue #300 -- Refactored PushbackString into a more
 generic class, and created a new Integer based impl to support codePoints. 
 Refactored PusbhbackString to also use the same interface.

---
 .../codecs/AbstractPushbackSequence.java      |  47 +++
 .../esapi/codecs/PushBackSequenceImpl.java    | 137 +++++++++
 .../owasp/esapi/codecs/PushbackSequence.java  |  64 +++++
 .../owasp/esapi/codecs/PushbackString.java    | 272 ++++++++++--------
 .../esapi/codecs/PushBackStringTest.java      |  41 +++
 5 files changed, 434 insertions(+), 127 deletions(-)
 create mode 100644 src/main/java/org/owasp/esapi/codecs/AbstractPushbackSequence.java
 create mode 100644 src/main/java/org/owasp/esapi/codecs/PushBackSequenceImpl.java
 create mode 100644 src/main/java/org/owasp/esapi/codecs/PushbackSequence.java
 create mode 100644 src/test/java/org/owasp/esapi/codecs/PushBackStringTest.java

diff --git a/src/main/java/org/owasp/esapi/codecs/AbstractPushbackSequence.java b/src/main/java/org/owasp/esapi/codecs/AbstractPushbackSequence.java
new file mode 100644
index 000000000..ee35478c3
--- /dev/null
+++ b/src/main/java/org/owasp/esapi/codecs/AbstractPushbackSequence.java
@@ -0,0 +1,47 @@
+package org.owasp.esapi.codecs;
+
+public abstract class AbstractPushbackSequence implements PushbackSequence {
+	protected String input;
+	protected T pushback;
+	protected T temp;
+	protected int index = 0;
+	protected int mark = 0;
+
+	public AbstractPushbackSequence(String input) {
+		this.input = input;
+	}
+
+	/**
+	 *
+	 * @param c
+	 */
+	public void pushback(T c) {
+		pushback = c;
+	}
+
+	/**
+	 * Get the current index of the PushbackString. Typically used in error
+	 * messages.
+	 * 
+	 * @return The current index of the PushbackString.
+	 */
+	public int index() {
+		return index;
+	}
+
+	/**
+	 *
+	 * @return
+	 */
+	public boolean hasNext() {
+		if (pushback != null)
+			return true;
+		if (input == null)
+			return false;
+		if (input.length() == 0)
+			return false;
+		if (index >= input.length())
+			return false;
+		return true;
+	}
+}
diff --git a/src/main/java/org/owasp/esapi/codecs/PushBackSequenceImpl.java b/src/main/java/org/owasp/esapi/codecs/PushBackSequenceImpl.java
new file mode 100644
index 000000000..ea31e88d6
--- /dev/null
+++ b/src/main/java/org/owasp/esapi/codecs/PushBackSequenceImpl.java
@@ -0,0 +1,137 @@
+package org.owasp.esapi.codecs;
+
+
+/**
+ * The pushback string is used by Codecs to allow them to push decoded characters back onto a string
+ * for further decoding. This is necessary to detect double-encoding.
+ * 
+ * @author Jeff Williams (jeff.williams .at. aspectsecurity.com) Aspect Security
+ * @since June 1, 2007
+ * @see org.owasp.esapi.Encoder
+ */
+public class PushBackSequenceImpl extends AbstractPushbackSequence{
+    /**
+     *
+     * @param input
+     */
+    public PushBackSequenceImpl( String input ) {
+		super(input);
+	}
+	
+    /**
+     *
+     * @return
+     */
+    public Integer next() {
+		if ( pushback != null ) {
+			Integer save = pushback;
+			pushback = null;
+			return save;
+		}
+		if ( input == null ) return null;
+		if ( input.length() == 0 ) return null;
+		if ( index >= input.length() ) return null;
+		final Integer point = input.codePointAt(index);
+		index += Character.charCount(point);
+		return point;
+	}
+	
+    /**
+    *
+    * @return
+    */
+   public Integer nextHex() {
+		Integer c = next();
+		if ( c == null ) return null;
+		if ( isHexDigit( c ) ) return c;
+		return null;
+	}
+
+   /**
+   *
+   * @return
+   */
+  public Integer nextOctal() {
+		Integer c = next();
+		if ( c == null ) return null;
+		if ( isOctalDigit( c ) ) return c;
+		return null;
+	}
+
+	  /**
+	  * Returns true if the parameter character is a hexidecimal digit 0 through 9, a through f, or A through F.
+	  * @param c
+	  * @return
+	  */
+	 public static boolean isHexDigit( Integer c ) {
+		if ( c == null ) return false;
+		Integer ch = Integer.valueOf(c);
+		return (ch >= '0' && ch <= '9' ) || (ch >= 'a' && ch <= 'f' ) || (ch >= 'A' && ch <= 'F' );
+	}
+
+	 /**
+	 * Returns true if the parameter character is an octal digit 0 through 7.
+	 * @param c
+	 * @return
+	 */
+	public static boolean isOctalDigit( Integer c ) {
+		if ( c == null ) return false;
+		Integer ch = Integer.valueOf(c); 
+		return ch >= '0' && ch <= '7';
+	}
+
+    /**
+     * Return the next codePoint without affecting the current index.
+     * @return
+     */
+    public Integer peek() {
+		if ( pushback != null ) return pushback;
+		if ( input == null ) return null;
+		if ( input.length() == 0 ) return null;
+		if ( index >= input.length() ) return null;		
+		return input.codePointAt(index);
+	}
+	
+    /**
+     * Test to see if the next codePoint is a particular value without affecting the current index.
+     * @param c
+     * @return
+     */
+    public boolean peek( Integer c ) {
+		if ( pushback != null && pushback.intValue() == c ) return true;
+		if ( input == null ) return false;
+		if ( input.length() == 0 ) return false;
+		if ( index >= input.length() ) return false;		
+		return input.codePointAt(index) == c;
+	}	
+	
+    /**
+     *
+     */
+    public void mark() {
+		temp = pushback;
+		mark = index;
+	}
+
+    /**
+     *
+     */
+    public void reset() {
+		pushback = temp;
+		index = mark;
+	}
+	
+    /**
+     *
+     * @return
+     */
+    protected String remainder() {
+		String output = input.substring( index );
+		if ( pushback != null ) {
+			output = pushback + output;
+		}
+		return output;
+	}
+
+}
diff --git a/src/main/java/org/owasp/esapi/codecs/PushbackSequence.java b/src/main/java/org/owasp/esapi/codecs/PushbackSequence.java
new file mode 100644
index 000000000..58fe4a930
--- /dev/null
+++ b/src/main/java/org/owasp/esapi/codecs/PushbackSequence.java
@@ -0,0 +1,64 @@
+package org.owasp.esapi.codecs;
+
+public interface PushbackSequence {
+
+	/**
+	 *
+	 * @param c
+	 */
+	void pushback(T c);
+
+	/**
+	 * Get the current index of the PushbackString. Typically used in error messages.
+	 * @return The current index of the PushbackString.
+	 */
+	int index();
+
+	/**
+	 *
+	 * @return
+	 */
+	boolean hasNext();
+
+	/**
+	 *
+	 * @return
+	 */
+	T next();
+
+	/**
+	    *
+	    * @return
+	    */
+	T nextHex();
+
+	/**
+	   *
+	   * @return
+	   */
+	T nextOctal();
+
+	/**
+	 * Return the next character without affecting the current index.
+	 * @return
+	 */
+	T peek();
+
+	/**
+	 * Test to see if the next character is a particular value without affecting the current index.
+	 * @param c
+	 * @return
+	 */
+	boolean peek(T c);
+
+	/**
+	 *
+	 */
+	void mark();
+
+	/**
+	 *
+	 */
+	void reset();
+
+}
\ No newline at end of file
diff --git a/src/main/java/org/owasp/esapi/codecs/PushbackString.java b/src/main/java/org/owasp/esapi/codecs/PushbackString.java
index 1119b223c..9982d48e2 100644
--- a/src/main/java/org/owasp/esapi/codecs/PushbackString.java
+++ b/src/main/java/org/owasp/esapi/codecs/PushbackString.java
@@ -15,169 +15,187 @@
  */
 package org.owasp.esapi.codecs;
 
-
 /**
- * The pushback string is used by Codecs to allow them to push decoded characters back onto a string
- * for further decoding. This is necessary to detect double-encoding.
+ * The pushback string is used by Codecs to allow them to push decoded
+ * characters back onto a string for further decoding. This is necessary to
+ * detect double-encoding.
  * 
- * @author Jeff Williams (jeff.williams .at. aspectsecurity.com) Aspect Security
+ * @author Jeff Williams (jeff.williams .at. aspectsecurity.com)
+ *         Aspect Security
  * @since June 1, 2007
  * @see org.owasp.esapi.Encoder
  */
-public class PushbackString {
-
-	private String input;
-	private Character pushback;
-	private Character temp;
-	private int index = 0;
-	private int mark = 0;
-	
-    /**
-     *
-     * @param input
-     */
-    public PushbackString( String input ) {
-		this.input = input;
-	}
-
-    /**
-     *
-     * @param c
-     */
-    public void pushback( Character c ) {
-		pushback = c;
+public class PushbackString extends AbstractPushbackSequence{
+	/**
+	 *
+	 * @param input
+	 */
+	public PushbackString(String input) {
+		super(input);
 	}
-	
 
-    /**
-     * Get the current index of the PushbackString. Typically used in error messages.
-     * @return The current index of the PushbackString.
-     */
-    public int index() {
+	/*
+	 * (non-Javadoc)
+	 * 
+	 * @see org.owasp.esapi.codecs.PushbackSequence#index()
+	 */
+	public int index() {
 		return index;
 	}
-	
-    /**
-     *
-     * @return
-     */
-    public boolean hasNext() {
-		if ( pushback != null ) return true;
-		if ( input == null ) return false;
-		if ( input.length() == 0 ) return false;
-		if ( index >= input.length() ) return false;
-		return true;		
+
+	/*
+	 * (non-Javadoc)
+	 * 
+	 * @see org.owasp.esapi.codecs.PushbackSequence#hasNext()
+	 */
+	public boolean hasNext() {
+		if (pushback != null)
+			return true;
+		if (input == null)
+			return false;
+		if (input.length() == 0)
+			return false;
+		if (index >= input.length())
+			return false;
+		return true;
 	}
-	
-    /**
-     *
-     * @return
-     */
-    public Character next() {
-		if ( pushback != null ) {
+
+	/*
+	 * (non-Javadoc)
+	 * 
+	 * @see org.owasp.esapi.codecs.PushbackSequence#next()
+	 */
+	public Character next() {
+		if (pushback != null) {
 			Character save = pushback;
 			pushback = null;
 			return save;
 		}
-		if ( input == null ) return null;
-		if ( input.length() == 0 ) return null;
-		if ( index >= input.length() ) return null;		
-		return Character.valueOf( input.charAt(index++) );
+		if (input == null)
+			return null;
+		if (input.length() == 0)
+			return null;
+		if (index >= input.length())
+			return null;
+		return Character.valueOf(input.charAt(index++));
 	}
-	
-    /**
-    *
-    * @return
-    */
-   public Character nextHex() {
+
+	/*
+	 * (non-Javadoc)
+	 * 
+	 * @see org.owasp.esapi.codecs.PushbackSequence#nextHex()
+	 */
+	public Character nextHex() {
 		Character c = next();
-		if ( c == null ) return null;
-		if ( isHexDigit( c ) ) return c;
+		if (c == null)
+			return null;
+		if (isHexDigit(c))
+			return c;
 		return null;
 	}
 
-   /**
-   *
-   * @return
-   */
-  public Character nextOctal() {
+	/*
+	 * (non-Javadoc)
+	 * 
+	 * @see org.owasp.esapi.codecs.PushbackSequence#nextOctal()
+	 */
+	public Character nextOctal() {
 		Character c = next();
-		if ( c == null ) return null;
-		if ( isOctalDigit( c ) ) return c;
+		if (c == null)
+			return null;
+		if (isOctalDigit(c))
+			return c;
 		return null;
 	}
 
-  /**
- * Returns true if the parameter character is a hexidecimal digit 0 through 9, a through f, or A through F.
-  * @param c
-  * @return
-  */
- public static boolean isHexDigit( Character c ) {
-		if ( c == null ) return false;
+	/**
+	 * Returns true if the parameter character is a hexidecimal digit 0 through
+	 * 9, a through f, or A through F.
+	 * 
+	 * @param c
+	 * @return
+	 */
+	public static boolean isHexDigit(Character c) {
+		if (c == null)
+			return false;
 		char ch = c.charValue();
-		return (ch >= '0' && ch <= '9' ) || (ch >= 'a' && ch <= 'f' ) || (ch >= 'A' && ch <= 'F' );
+		return (ch >= '0' && ch <= '9') || (ch >= 'a' && ch <= 'f') || (ch >= 'A' && ch <= 'F');
 	}
 
- /**
- * Returns true if the parameter character is an octal digit 0 through 7.
- * @param c
- * @return
- */
-public static boolean isOctalDigit( Character c ) {
-	if ( c == null ) return false;
-	char ch = c.charValue();
-	return ch >= '0' && ch <= '7';
-}
+	/**
+	 * Returns true if the parameter character is an octal digit 0 through 7.
+	 * 
+	 * @param c
+	 * @return
+	 */
+	public static boolean isOctalDigit(Character c) {
+		if (c == null)
+			return false;
+		char ch = c.charValue();
+		return ch >= '0' && ch <= '7';
+	}
 
-    /**
-     * Return the next character without affecting the current index.
-     * @return
-     */
-    public Character peek() {
-		if ( pushback != null ) return pushback;
-		if ( input == null ) return null;
-		if ( input.length() == 0 ) return null;
-		if ( index >= input.length() ) return null;		
-		return Character.valueOf( input.charAt(index) );
+	/*
+	 * (non-Javadoc)
+	 * 
+	 * @see org.owasp.esapi.codecs.PushbackSequence#peek()
+	 */
+	public Character peek() {
+		if (pushback != null)
+			return pushback;
+		if (input == null)
+			return null;
+		if (input.length() == 0)
+			return null;
+		if (index >= input.length())
+			return null;
+		return Character.valueOf(input.charAt(index));
 	}
-	
-    /**
-     * Test to see if the next character is a particular value without affecting the current index.
-     * @param c
-     * @return
-     */
-    public boolean peek( char c ) {
-		if ( pushback != null && pushback.charValue() == c ) return true;
-		if ( input == null ) return false;
-		if ( input.length() == 0 ) return false;
-		if ( index >= input.length() ) return false;		
+
+	/*
+	 * (non-Javadoc)
+	 * 
+	 * @see org.owasp.esapi.codecs.PushbackSequence#peek(char)
+	 */
+	public boolean peek(Character c) {
+		if (pushback != null && pushback.charValue() == c)
+			return true;
+		if (input == null)
+			return false;
+		if (input.length() == 0)
+			return false;
+		if (index >= input.length())
+			return false;
 		return input.charAt(index) == c;
-	}	
-	
-    /**
-     *
-     */
-    public void mark() {
+	}
+
+	/*
+	 * (non-Javadoc)
+	 * 
+	 * @see org.owasp.esapi.codecs.PushbackSequence#mark()
+	 */
+	public void mark() {
 		temp = pushback;
 		mark = index;
 	}
 
-    /**
-     *
-     */
-    public void reset() {
+	/*
+	 * (non-Javadoc)
+	 * 
+	 * @see org.owasp.esapi.codecs.PushbackSequence#reset()
+	 */
+	public void reset() {
 		pushback = temp;
 		index = mark;
 	}
-	
-    /**
-     *
-     * @return
-     */
-    protected String remainder() {
-		String output = input.substring( index );
-		if ( pushback != null ) {
+
+	/**
+	 *
+	 * @return
+	 */
+	protected String remainder() {
+		String output = input.substring(index);
+		if (pushback != null) {
 			output = pushback + output;
 		}
 		return output;
diff --git a/src/test/java/org/owasp/esapi/codecs/PushBackStringTest.java b/src/test/java/org/owasp/esapi/codecs/PushBackStringTest.java
new file mode 100644
index 000000000..2a4ed84e2
--- /dev/null
+++ b/src/test/java/org/owasp/esapi/codecs/PushBackStringTest.java
@@ -0,0 +1,41 @@
+package org.owasp.esapi.codecs;
+
+import static org.junit.Assert.assertEquals;
+
+import org.junit.Test;
+
+public class PushBackStringTest {
+
+	@Test
+	public void testPushbackString() {
+		PushbackSequence pbs = new PushbackString("012345");
+		
+		pbs.mark();
+		assertEquals(0, pbs.index());
+		Character first = pbs.next();
+		
+		System.out.println("0x" + Integer.toHexString(first));
+		
+		assertEquals("0", new StringBuilder().appendCodePoint(first).toString());
+	}
+	
+	@Test
+	public void testPushbackSequence() {
+		AbstractPushbackSequence pbs = new PushBackSequenceImpl("12345");
+		
+		pbs.mark();
+		assertEquals(0, pbs.index());
+		Integer first = pbs.next();
+		
+		System.out.println("0x" + Integer.toHexString(first));
+		
+		assertEquals("&", new StringBuilder().appendCodePoint(first).toString());
+		
+		Integer second = pbs.next();
+		
+		if(second == '#'){
+			System.out.printf("[%d]:[%d]\n", second, (int) '#');
+			
+		}
+	}
+}

From 65646f174e42be2bd1a88706f53d6be56d94d4a7 Mon Sep 17 00:00:00 2001
From: Matt Seil 
Date: Sat, 5 Aug 2017 15:34:50 -0700
Subject: [PATCH 440/812] Issue #300 -- Finally got the core issue whacked! 
 Now we have to clean up the rest of the unit tests.

---
 .../esapi/codecs/AbstractCharacterCodec.java  |  21 +
 .../org/owasp/esapi/codecs/AbstractCodec.java |  23 +-
 .../esapi/codecs/AbstractIntegerCodec.java    |  22 +
 .../java/org/owasp/esapi/codecs/CSSCodec.java |   4 +-
 .../java/org/owasp/esapi/codecs/Codec.java    |   6 +-
 .../java/org/owasp/esapi/codecs/DB2Codec.java |   2 +-
 .../owasp/esapi/codecs/HTMLEntityCodec.java   | 565 +++++++++---------
 .../owasp/esapi/codecs/JavaScriptCodec.java   |   2 +-
 .../org/owasp/esapi/codecs/MySQLCodec.java    |   2 +-
 .../org/owasp/esapi/codecs/OracleCodec.java   |   2 +-
 .../org/owasp/esapi/codecs/PercentCodec.java  |   2 +-
 .../esapi/codecs/PushBackSequenceImpl.java    |   2 +-
 .../owasp/esapi/codecs/PushbackSequence.java  |   8 +
 .../owasp/esapi/codecs/PushbackString.java    |   2 +-
 .../org/owasp/esapi/codecs/UnixCodec.java     |   2 +-
 .../org/owasp/esapi/codecs/VBScriptCodec.java |   2 +-
 .../org/owasp/esapi/codecs/WindowsCodec.java  |   2 +-
 .../owasp/esapi/codecs/XMLEntityCodec.java    |   2 +-
 .../owasp/esapi/codecs/AbstractCodecTest.java |   2 +-
 .../owasp/esapi/reference/EncoderTest.java    |  19 +-
 20 files changed, 366 insertions(+), 326 deletions(-)
 create mode 100644 src/main/java/org/owasp/esapi/codecs/AbstractCharacterCodec.java
 create mode 100644 src/main/java/org/owasp/esapi/codecs/AbstractIntegerCodec.java

diff --git a/src/main/java/org/owasp/esapi/codecs/AbstractCharacterCodec.java b/src/main/java/org/owasp/esapi/codecs/AbstractCharacterCodec.java
new file mode 100644
index 000000000..5868d2bc0
--- /dev/null
+++ b/src/main/java/org/owasp/esapi/codecs/AbstractCharacterCodec.java
@@ -0,0 +1,21 @@
+package org.owasp.esapi.codecs;
+
+public abstract class AbstractCharacterCodec extends AbstractCodec {
+	/* (non-Javadoc)
+	 * @see org.owasp.esapi.codecs.Codec#decode(java.lang.String)
+	 */
+	@Override
+	public String decode(String input) {
+		StringBuilder sb = new StringBuilder();
+		PushbackSequence pbs = new PushbackString(input);
+		while (pbs.hasNext()) {
+			Character c = decodeCharacter(pbs);
+			if (c != null) {
+				sb.append(c);
+			} else {
+				sb.append(pbs.next());
+			}
+		}
+		return sb.toString();
+	}
+}
diff --git a/src/main/java/org/owasp/esapi/codecs/AbstractCodec.java b/src/main/java/org/owasp/esapi/codecs/AbstractCodec.java
index 11d33f8a8..236125497 100644
--- a/src/main/java/org/owasp/esapi/codecs/AbstractCodec.java
+++ b/src/main/java/org/owasp/esapi/codecs/AbstractCodec.java
@@ -25,10 +25,11 @@
  * 
  * @author Jeff Williams (jeff.williams .at. aspectsecurity.com) Aspect Security
+ * @param 
  * @since June 1, 2007
  * @see org.owasp.esapi.Encoder
  */
-public abstract class AbstractCodec implements Codec {
+public abstract class AbstractCodec implements Codec {
 
 	/**
 	 * Initialize an array to mark which characters are to be encoded. Store the hex
@@ -89,29 +90,13 @@ public String encodeCharacter( char[] immune, int codePoint ) {
 		return new StringBuilder().appendCodePoint(codePoint).toString();
 	}
 
-	/* (non-Javadoc)
-	 * @see org.owasp.esapi.codecs.Codec#decode(java.lang.String)
-	 */
-	@Override
-	public String decode(String input) {
-		StringBuilder sb = new StringBuilder();
-		PushbackString pbs = new PushbackString(input);
-		while (pbs.hasNext()) {
-			Character c = decodeCharacter(pbs);
-			if (c != null) {
-				sb.append(c);
-			} else {
-				sb.append(pbs.next());
-			}
-		}
-		return sb.toString();
-	}
+
 
 	/* (non-Javadoc)
 	 * @see org.owasp.esapi.codecs.Codec#decodeCharacter(org.owasp.esapi.codecs.PushbackString)
 	 */
 	@Override
-	public Character decodeCharacter( PushbackString input ) {
+	public T decodeCharacter( PushbackSequence input ) {
 		return input.next();
 	}
 
diff --git a/src/main/java/org/owasp/esapi/codecs/AbstractIntegerCodec.java b/src/main/java/org/owasp/esapi/codecs/AbstractIntegerCodec.java
new file mode 100644
index 000000000..f43891481
--- /dev/null
+++ b/src/main/java/org/owasp/esapi/codecs/AbstractIntegerCodec.java
@@ -0,0 +1,22 @@
+package org.owasp.esapi.codecs;
+
+public class AbstractIntegerCodec extends AbstractCodec {
+
+	/**
+	 * {@inheritDoc}
+	 */
+	@Override
+	public String decode(String input) {
+		StringBuilder sb = new StringBuilder();
+		PushbackSequence pbs = new PushBackSequenceImpl(input);
+		while (pbs.hasNext()) {
+			Integer c = decodeCharacter(pbs);
+			if (c != null) {
+				sb.appendCodePoint(c);
+			} else {
+				sb.appendCodePoint(pbs.next());
+			}
+		}
+		return sb.toString();
+	}
+}
diff --git a/src/main/java/org/owasp/esapi/codecs/CSSCodec.java b/src/main/java/org/owasp/esapi/codecs/CSSCodec.java
index a44cebeed..088463889 100644
--- a/src/main/java/org/owasp/esapi/codecs/CSSCodec.java
+++ b/src/main/java/org/owasp/esapi/codecs/CSSCodec.java
@@ -23,7 +23,7 @@
  * @since June 1, 2007
  * @see org.owasp.esapi.Encoder
  */
-public class CSSCodec extends AbstractCodec
+public class CSSCodec extends AbstractCharacterCodec
 {
 	private static final Character REPLACEMENT = '\ufffd';
 
@@ -58,7 +58,7 @@ public String encodeCharacter(char[] immune, Character c) {
 	 * Returns the decoded version of the character starting at index,
 	 * or null if no decoding is possible.
 	 */
-	public Character decodeCharacter(PushbackString input)
+	public Character decodeCharacter(PushbackSequence input)
 	{
 		input.mark();
 		Character first = input.next();
diff --git a/src/main/java/org/owasp/esapi/codecs/Codec.java b/src/main/java/org/owasp/esapi/codecs/Codec.java
index 3f7cd2554..c205d1b3f 100644
--- a/src/main/java/org/owasp/esapi/codecs/Codec.java
+++ b/src/main/java/org/owasp/esapi/codecs/Codec.java
@@ -28,7 +28,7 @@
  * @since June 1, 2007
  * @see org.owasp.esapi.Encoder
  */
-public interface Codec {
+public interface Codec {
 	/**
 	 * Encode a String so that it can be safely used in a specific context.
 	 * 
@@ -73,14 +73,14 @@ public interface Codec {
 
 	/**
 	 * Returns the decoded version of the next character from the input string and advances the
-	 * current character in the PushbackString.  If the current character is not encoded, this 
+	 * current character in the PushbackSequence.  If the current character is not encoded, this 
 	 * method MUST reset the PushbackString.
 	 * 
 	 * @param input	the Character to decode
 	 * 
 	 * @return the decoded Character
 	 */
-	public Character decodeCharacter( PushbackString input );
+	public T decodeCharacter( PushbackSequence input );
 
 	/**
 	 * Lookup the hex value of any character that is not alphanumeric.
diff --git a/src/main/java/org/owasp/esapi/codecs/DB2Codec.java b/src/main/java/org/owasp/esapi/codecs/DB2Codec.java
index 236bed78e..850d9a6aa 100644
--- a/src/main/java/org/owasp/esapi/codecs/DB2Codec.java
+++ b/src/main/java/org/owasp/esapi/codecs/DB2Codec.java
@@ -20,7 +20,7 @@
  * @since October 26, 2010
  * @see org.owasp.esapi.Encoder
  */
-public class DB2Codec extends AbstractCodec {
+public class DB2Codec extends AbstractCharacterCodec {
 
 	public String encodeCharacter(char[] immune, Character c) {
 
diff --git a/src/main/java/org/owasp/esapi/codecs/HTMLEntityCodec.java b/src/main/java/org/owasp/esapi/codecs/HTMLEntityCodec.java
index e3892d2f8..4adfdf84c 100644
--- a/src/main/java/org/owasp/esapi/codecs/HTMLEntityCodec.java
+++ b/src/main/java/org/owasp/esapi/codecs/HTMLEntityCodec.java
@@ -18,6 +18,7 @@
 import java.util.HashMap;
 import java.util.Collections;
 import java.util.Map;
+import java.util.Map.Entry;
 
 /**
  * Implementation of the Codec interface for HTML entity encoding.
@@ -27,14 +28,14 @@
  * @since June 1, 2007
  * @see org.owasp.esapi.Encoder
  */
-public class HTMLEntityCodec extends AbstractCodec
+public class HTMLEntityCodec extends AbstractIntegerCodec
 {
 	private static final char REPLACEMENT_CHAR = '\ufffd';
 	private static final String REPLACEMENT_HEX = "fffd";
 	private static final String REPLACEMENT_STR = "" + REPLACEMENT_CHAR;
-	private static final Map characterToEntityMap = mkCharacterToEntityMap();
+	private static final Map characterToEntityMap = mkCharacterToEntityMap();
 
-	private static final Trie entityToCharacterTrie = mkEntityToCharacterTrie();
+	private static final Trie entityToCharacterTrie = mkEntityToCharacterTrie();
 
     /**
      *
@@ -69,7 +70,7 @@ public String encodeCharacter( char[] immune, Character c ) {
 		}
 		
 		// check if there's a defined entity
-		String entityName = (String) characterToEntityMap.get(c);
+		String entityName = (String) characterToEntityMap.get(Integer.valueOf(c));
 		if (entityName != null) {
 			return "&" + entityName + ";";
 		}
@@ -125,9 +126,9 @@ public String encodeCharacter( char[] immune, int codePoint ) {
 	 *   &#xhhhh;
 	 *   &name;
 	 */
-	public Character decodeCharacter( PushbackString input ) {
+	public Integer decodeCharacter( PushbackSequence input ) {
 		input.mark();
-		Character first = input.next();
+		Integer first = input.next();
 		if ( first == null ) {
 			input.reset();
 			return null;
@@ -140,7 +141,7 @@ public Character decodeCharacter( PushbackString input ) {
 		}
 		
 		// test for numeric encodings
-		Character second = input.next();
+		Integer second = input.next();
 		if ( second == null ) {
 			input.reset();
 			return null;
@@ -148,12 +149,12 @@ public Character decodeCharacter( PushbackString input ) {
 		
 		if (second == '#' ) {
 			// handle numbers
-			Character c = getNumericEntity( input );
+			Integer c = getNumericEntity( input );
 			if ( c != null ) return c;
-		} else if ( Character.isLetter( second.charValue() ) ) {
+		} else if ( Character.isLetter( second ) ) {
 			// handle entities
 			input.pushback( second );
-			Character c = getNamedEntity( input );
+			Integer c = getNamedEntity( input );
 			if ( c != null ) return c;
 		}
 		input.reset();
@@ -169,8 +170,8 @@ public Character decodeCharacter( PushbackString input ) {
 	 * @return
 	 * 			null if input is null, the character of input after decoding
 	 */
-	private Character getNumericEntity( PushbackString input ) {
-		Character first = input.peek();
+	private Integer getNumericEntity( PushbackSequence input ) {
+		Integer first = input.peek();
 		if ( first == null ) return null;
 
 		if (first == 'x' || first == 'X' ) {
@@ -189,14 +190,14 @@ private Character getNumericEntity( PushbackString input ) {
 	 * 			character representation of this decimal value, e.g. A 
 	 * @throws NumberFormatException
 	 */
-	private Character parseNumber( PushbackString input ) {
+	private Integer parseNumber( PushbackSequence input ) {
 		StringBuilder sb = new StringBuilder();
 		while( input.hasNext() ) {
-			Character c = input.peek();
+			Integer c = input.peek();
 			
 			// if character is a digit then add it on and keep going
-			if ( Character.isDigit( c.charValue() ) ) {
-				sb.append( c );
+			if ( Character.isDigit( c ) ) {
+				sb.appendCodePoint( c );
 				input.next();
 				
 			// if character is a semi-colon, eat it and quit
@@ -212,7 +213,7 @@ private Character parseNumber( PushbackString input ) {
 		try {
 			int i = Integer.parseInt(sb.toString());
             if (Character.isValidCodePoint(i)) {
-                return (char) i;
+                return i;
             }
 		} catch( NumberFormatException e ) {
 			// throw an exception for malformed entity?
@@ -229,14 +230,14 @@ private Character parseNumber( PushbackString input ) {
 	 * 			A single character from the string
 	 * @throws NumberFormatException
 	 */
-	private Character parseHex( PushbackString input ) {
+	private Integer parseHex( PushbackSequence input ) {
 		StringBuilder sb = new StringBuilder();
 		while( input.hasNext() ) {
-			Character c = input.peek();
+			Integer c = input.peek();
 			
 			// if character is a hex digit then add it on and keep going
 			if ( "0123456789ABCDEFabcdef".indexOf(c) != -1 ) {
-				sb.append( c );
+				sb.appendCodePoint( c );
 				input.next();
 				
 			// if character is a semi-colon, eat it and quit
@@ -252,7 +253,7 @@ private Character parseHex( PushbackString input ) {
 		try {
 			int i = Integer.parseInt(sb.toString(), 16);
             if (Character.isValidCodePoint(i)) {
-                return (char) i;
+                return i;
             }
 		} catch( NumberFormatException e ) {
 			// throw an exception for malformed entity?
@@ -278,9 +279,9 @@ private Character parseHex( PushbackString input ) {
 	 * @return
 	 * 		Returns the decoded version of the character starting at index, or null if no decoding is possible.
 	 */
-	private Character getNamedEntity( PushbackString input ) {
+	private Integer getNamedEntity( PushbackSequence input ) {
 		StringBuilder possible = new StringBuilder();
-		Map.Entry entry;
+		Entry entry;
 		int len;
 		
 		// kludge around PushbackString....
@@ -296,7 +297,7 @@ private Character getNamedEntity( PushbackString input ) {
 			String possibleString = possible.toString();
 			String possibleStringLowerCase = possibleString.toLowerCase();
 		        if(!possibleString.equals(possibleStringLowerCase)) {
-		           Map.Entry exactEntry = entityToCharacterTrie.getLongestMatch(possibleStringLowerCase);
+		           Map.Entry exactEntry = entityToCharacterTrie.getLongestMatch(possibleStringLowerCase);
 		           if(exactEntry != null) entry = exactEntry;
 		        }
 		        if(entry == null) return null; // no match, caller will reset input
@@ -310,7 +311,7 @@ private Character getNamedEntity( PushbackString input ) {
 			input.next();
 
 		// check for a trailing semicolen
-		if(input.peek(';'))
+		if(input.peek(Integer.valueOf(';')))
 			input.next();
 
 		return entry.getValue();
@@ -320,262 +321,262 @@ private Character getNamedEntity( PushbackString input ) {
 	 * Build a unmodifiable Map from entity Character to Name.
 	 * @return Unmodifiable map.
 	 */
-	private static synchronized Map mkCharacterToEntityMap()
+	private static synchronized Map mkCharacterToEntityMap()
 	{
-		Map map = new HashMap(252);
+		Map map = new HashMap(252);
 
-		map.put((char)34,	"quot");	/* quotation mark */
-		map.put((char)38,	"amp");		/* ampersand */
-		map.put((char)60,	"lt");		/* less-than sign */
-		map.put((char)62,	"gt");		/* greater-than sign */
-		map.put((char)160,	"nbsp");	/* no-break space */
-		map.put((char)161,	"iexcl");	/* inverted exclamation mark */
-		map.put((char)162,	"cent");	/* cent sign */
-		map.put((char)163,	"pound");	/* pound sign */
-		map.put((char)164,	"curren");	/* currency sign */
-		map.put((char)165,	"yen");		/* yen sign */
-		map.put((char)166,	"brvbar");	/* broken bar */
-		map.put((char)167,	"sect");	/* section sign */
-		map.put((char)168,	"uml");		/* diaeresis */
-		map.put((char)169,	"copy");	/* copyright sign */
-		map.put((char)170,	"ordf");	/* feminine ordinal indicator */
-		map.put((char)171,	"laquo");	/* left-pointing double angle quotation mark */
-		map.put((char)172,	"not");		/* not sign */
-		map.put((char)173,	"shy");		/* soft hyphen */
-		map.put((char)174,	"reg");		/* registered sign */
-		map.put((char)175,	"macr");	/* macron */
-		map.put((char)176,	"deg");		/* degree sign */
-		map.put((char)177,	"plusmn");	/* plus-minus sign */
-		map.put((char)178,	"sup2");	/* superscript two */
-		map.put((char)179,	"sup3");	/* superscript three */
-		map.put((char)180,	"acute");	/* acute accent */
-		map.put((char)181,	"micro");	/* micro sign */
-		map.put((char)182,	"para");	/* pilcrow sign */
-		map.put((char)183,	"middot");	/* middle dot */
-		map.put((char)184,	"cedil");	/* cedilla */
-		map.put((char)185,	"sup1");	/* superscript one */
-		map.put((char)186,	"ordm");	/* masculine ordinal indicator */
-		map.put((char)187,	"raquo");	/* right-pointing double angle quotation mark */
-		map.put((char)188,	"frac14");	/* vulgar fraction one quarter */
-		map.put((char)189,	"frac12");	/* vulgar fraction one half */
-		map.put((char)190,	"frac34");	/* vulgar fraction three quarters */
-		map.put((char)191,	"iquest");	/* inverted question mark */
-		map.put((char)192,	"Agrave");	/* Latin capital letter a with grave */
-		map.put((char)193,	"Aacute");	/* Latin capital letter a with acute */
-		map.put((char)194,	"Acirc");	/* Latin capital letter a with circumflex */
-		map.put((char)195,	"Atilde");	/* Latin capital letter a with tilde */
-		map.put((char)196,	"Auml");	/* Latin capital letter a with diaeresis */
-		map.put((char)197,	"Aring");	/* Latin capital letter a with ring above */
-		map.put((char)198,	"AElig");	/* Latin capital letter ae */
-		map.put((char)199,	"Ccedil");	/* Latin capital letter c with cedilla */
-		map.put((char)200,	"Egrave");	/* Latin capital letter e with grave */
-		map.put((char)201,	"Eacute");	/* Latin capital letter e with acute */
-		map.put((char)202,	"Ecirc");	/* Latin capital letter e with circumflex */
-		map.put((char)203,	"Euml");	/* Latin capital letter e with diaeresis */
-		map.put((char)204,	"Igrave");	/* Latin capital letter i with grave */
-		map.put((char)205,	"Iacute");	/* Latin capital letter i with acute */
-		map.put((char)206,	"Icirc");	/* Latin capital letter i with circumflex */
-		map.put((char)207,	"Iuml");	/* Latin capital letter i with diaeresis */
-		map.put((char)208,	"ETH");		/* Latin capital letter eth */
-		map.put((char)209,	"Ntilde");	/* Latin capital letter n with tilde */
-		map.put((char)210,	"Ograve");	/* Latin capital letter o with grave */
-		map.put((char)211,	"Oacute");	/* Latin capital letter o with acute */
-		map.put((char)212,	"Ocirc");	/* Latin capital letter o with circumflex */
-		map.put((char)213,	"Otilde");	/* Latin capital letter o with tilde */
-		map.put((char)214,	"Ouml");	/* Latin capital letter o with diaeresis */
-		map.put((char)215,	"times");	/* multiplication sign */
-		map.put((char)216,	"Oslash");	/* Latin capital letter o with stroke */
-		map.put((char)217,	"Ugrave");	/* Latin capital letter u with grave */
-		map.put((char)218,	"Uacute");	/* Latin capital letter u with acute */
-		map.put((char)219,	"Ucirc");	/* Latin capital letter u with circumflex */
-		map.put((char)220,	"Uuml");	/* Latin capital letter u with diaeresis */
-		map.put((char)221,	"Yacute");	/* Latin capital letter y with acute */
-		map.put((char)222,	"THORN");	/* Latin capital letter thorn */
-		map.put((char)223,	"szlig");	/* Latin small letter sharp sXCOMMAX German Eszett */
-		map.put((char)224,	"agrave");	/* Latin small letter a with grave */
-		map.put((char)225,	"aacute");	/* Latin small letter a with acute */
-		map.put((char)226,	"acirc");	/* Latin small letter a with circumflex */
-		map.put((char)227,	"atilde");	/* Latin small letter a with tilde */
-		map.put((char)228,	"auml");	/* Latin small letter a with diaeresis */
-		map.put((char)229,	"aring");	/* Latin small letter a with ring above */
-		map.put((char)230,	"aelig");	/* Latin lowercase ligature ae */
-		map.put((char)231,	"ccedil");	/* Latin small letter c with cedilla */
-		map.put((char)232,	"egrave");	/* Latin small letter e with grave */
-		map.put((char)233,	"eacute");	/* Latin small letter e with acute */
-		map.put((char)234,	"ecirc");	/* Latin small letter e with circumflex */
-		map.put((char)235,	"euml");	/* Latin small letter e with diaeresis */
-		map.put((char)236,	"igrave");	/* Latin small letter i with grave */
-		map.put((char)237,	"iacute");	/* Latin small letter i with acute */
-		map.put((char)238,	"icirc");	/* Latin small letter i with circumflex */
-		map.put((char)239,	"iuml");	/* Latin small letter i with diaeresis */
-		map.put((char)240,	"eth");		/* Latin small letter eth */
-		map.put((char)241,	"ntilde");	/* Latin small letter n with tilde */
-		map.put((char)242,	"ograve");	/* Latin small letter o with grave */
-		map.put((char)243,	"oacute");	/* Latin small letter o with acute */
-		map.put((char)244,	"ocirc");	/* Latin small letter o with circumflex */
-		map.put((char)245,	"otilde");	/* Latin small letter o with tilde */
-		map.put((char)246,	"ouml");	/* Latin small letter o with diaeresis */
-		map.put((char)247,	"divide");	/* division sign */
-		map.put((char)248,	"oslash");	/* Latin small letter o with stroke */
-		map.put((char)249,	"ugrave");	/* Latin small letter u with grave */
-		map.put((char)250,	"uacute");	/* Latin small letter u with acute */
-		map.put((char)251,	"ucirc");	/* Latin small letter u with circumflex */
-		map.put((char)252,	"uuml");	/* Latin small letter u with diaeresis */
-		map.put((char)253,	"yacute");	/* Latin small letter y with acute */
-		map.put((char)254,	"thorn");	/* Latin small letter thorn */
-		map.put((char)255,	"yuml");	/* Latin small letter y with diaeresis */
-		map.put((char)338,	"OElig");	/* Latin capital ligature oe */
-		map.put((char)339,	"oelig");	/* Latin small ligature oe */
-		map.put((char)352,	"Scaron");	/* Latin capital letter s with caron */
-		map.put((char)353,	"scaron");	/* Latin small letter s with caron */
-		map.put((char)376,	"Yuml");	/* Latin capital letter y with diaeresis */
-		map.put((char)402,	"fnof");	/* Latin small letter f with hook */
-		map.put((char)710,	"circ");	/* modifier letter circumflex accent */
-		map.put((char)732,	"tilde");	/* small tilde */
-		map.put((char)913,	"Alpha");	/* Greek capital letter alpha */
-		map.put((char)914,	"Beta");	/* Greek capital letter beta */
-		map.put((char)915,	"Gamma");	/* Greek capital letter gamma */
-		map.put((char)916,	"Delta");	/* Greek capital letter delta */
-		map.put((char)917,	"Epsilon");	/* Greek capital letter epsilon */
-		map.put((char)918,	"Zeta");	/* Greek capital letter zeta */
-		map.put((char)919,	"Eta");		/* Greek capital letter eta */
-		map.put((char)920,	"Theta");	/* Greek capital letter theta */
-		map.put((char)921,	"Iota");	/* Greek capital letter iota */
-		map.put((char)922,	"Kappa");	/* Greek capital letter kappa */
-		map.put((char)923,	"Lambda");	/* Greek capital letter lambda */
-		map.put((char)924,	"Mu");		/* Greek capital letter mu */
-		map.put((char)925,	"Nu");		/* Greek capital letter nu */
-		map.put((char)926,	"Xi");		/* Greek capital letter xi */
-		map.put((char)927,	"Omicron");	/* Greek capital letter omicron */
-		map.put((char)928,	"Pi");		/* Greek capital letter pi */
-		map.put((char)929,	"Rho");		/* Greek capital letter rho */
-		map.put((char)931,	"Sigma");	/* Greek capital letter sigma */
-		map.put((char)932,	"Tau");		/* Greek capital letter tau */
-		map.put((char)933,	"Upsilon");	/* Greek capital letter upsilon */
-		map.put((char)934,	"Phi");		/* Greek capital letter phi */
-		map.put((char)935,	"Chi");		/* Greek capital letter chi */
-		map.put((char)936,	"Psi");		/* Greek capital letter psi */
-		map.put((char)937,	"Omega");	/* Greek capital letter omega */
-		map.put((char)945,	"alpha");	/* Greek small letter alpha */
-		map.put((char)946,	"beta");	/* Greek small letter beta */
-		map.put((char)947,	"gamma");	/* Greek small letter gamma */
-		map.put((char)948,	"delta");	/* Greek small letter delta */
-		map.put((char)949,	"epsilon");	/* Greek small letter epsilon */
-		map.put((char)950,	"zeta");	/* Greek small letter zeta */
-		map.put((char)951,	"eta");		/* Greek small letter eta */
-		map.put((char)952,	"theta");	/* Greek small letter theta */
-		map.put((char)953,	"iota");	/* Greek small letter iota */
-		map.put((char)954,	"kappa");	/* Greek small letter kappa */
-		map.put((char)955,	"lambda");	/* Greek small letter lambda */
-		map.put((char)956,	"mu");		/* Greek small letter mu */
-		map.put((char)957,	"nu");		/* Greek small letter nu */
-		map.put((char)958,	"xi");		/* Greek small letter xi */
-		map.put((char)959,	"omicron");	/* Greek small letter omicron */
-		map.put((char)960,	"pi");		/* Greek small letter pi */
-		map.put((char)961,	"rho");		/* Greek small letter rho */
-		map.put((char)962,	"sigmaf");	/* Greek small letter final sigma */
-		map.put((char)963,	"sigma");	/* Greek small letter sigma */
-		map.put((char)964,	"tau");		/* Greek small letter tau */
-		map.put((char)965,	"upsilon");	/* Greek small letter upsilon */
-		map.put((char)966,	"phi");		/* Greek small letter phi */
-		map.put((char)967,	"chi");		/* Greek small letter chi */
-		map.put((char)968,	"psi");		/* Greek small letter psi */
-		map.put((char)969,	"omega");	/* Greek small letter omega */
-		map.put((char)977,	"thetasym");	/* Greek theta symbol */
-		map.put((char)978,	"upsih");	/* Greek upsilon with hook symbol */
-		map.put((char)982,	"piv");		/* Greek pi symbol */
-		map.put((char)8194,	"ensp");	/* en space */
-		map.put((char)8195,	"emsp");	/* em space */
-		map.put((char)8201,	"thinsp");	/* thin space */
-		map.put((char)8204,	"zwnj");	/* zero width non-joiner */
-		map.put((char)8205,	"zwj");		/* zero width joiner */
-		map.put((char)8206,	"lrm");		/* left-to-right mark */
-		map.put((char)8207,	"rlm");		/* right-to-left mark */
-		map.put((char)8211,	"ndash");	/* en dash */
-		map.put((char)8212,	"mdash");	/* em dash */
-		map.put((char)8216,	"lsquo");	/* left single quotation mark */
-		map.put((char)8217,	"rsquo");	/* right single quotation mark */
-		map.put((char)8218,	"sbquo");	/* single low-9 quotation mark */
-		map.put((char)8220,	"ldquo");	/* left double quotation mark */
-		map.put((char)8221,	"rdquo");	/* right double quotation mark */
-		map.put((char)8222,	"bdquo");	/* double low-9 quotation mark */
-		map.put((char)8224,	"dagger");	/* dagger */
-		map.put((char)8225,	"Dagger");	/* double dagger */
-		map.put((char)8226,	"bull");	/* bullet */
-		map.put((char)8230,	"hellip");	/* horizontal ellipsis */
-		map.put((char)8240,	"permil");	/* per mille sign */
-		map.put((char)8242,	"prime");	/* prime */
-		map.put((char)8243,	"Prime");	/* double prime */
-		map.put((char)8249,	"lsaquo");	/* single left-pointing angle quotation mark */
-		map.put((char)8250,	"rsaquo");	/* single right-pointing angle quotation mark */
-		map.put((char)8254,	"oline");	/* overline */
-		map.put((char)8260,	"frasl");	/* fraction slash */
-		map.put((char)8364,	"euro");	/* euro sign */
-		map.put((char)8465,	"image");	/* black-letter capital i */
-		map.put((char)8472,	"weierp");	/* script capital pXCOMMAX Weierstrass p */
-		map.put((char)8476,	"real");	/* black-letter capital r */
-		map.put((char)8482,	"trade");	/* trademark sign */
-		map.put((char)8501,	"alefsym");	/* alef symbol */
-		map.put((char)8592,	"larr");	/* leftwards arrow */
-		map.put((char)8593,	"uarr");	/* upwards arrow */
-		map.put((char)8594,	"rarr");	/* rightwards arrow */
-		map.put((char)8595,	"darr");	/* downwards arrow */
-		map.put((char)8596,	"harr");	/* left right arrow */
-		map.put((char)8629,	"crarr");	/* downwards arrow with corner leftwards */
-		map.put((char)8656,	"lArr");	/* leftwards double arrow */
-		map.put((char)8657,	"uArr");	/* upwards double arrow */
-		map.put((char)8658,	"rArr");	/* rightwards double arrow */
-		map.put((char)8659,	"dArr");	/* downwards double arrow */
-		map.put((char)8660,	"hArr");	/* left right double arrow */
-		map.put((char)8704,	"forall");	/* for all */
-		map.put((char)8706,	"part");	/* partial differential */
-		map.put((char)8707,	"exist");	/* there exists */
-		map.put((char)8709,	"empty");	/* empty set */
-		map.put((char)8711,	"nabla");	/* nabla */
-		map.put((char)8712,	"isin");	/* element of */
-		map.put((char)8713,	"notin");	/* not an element of */
-		map.put((char)8715,	"ni");		/* contains as member */
-		map.put((char)8719,	"prod");	/* n-ary product */
-		map.put((char)8721,	"sum");		/* n-ary summation */
-		map.put((char)8722,	"minus");	/* minus sign */
-		map.put((char)8727,	"lowast");	/* asterisk operator */
-		map.put((char)8730,	"radic");	/* square root */
-		map.put((char)8733,	"prop");	/* proportional to */
-		map.put((char)8734,	"infin");	/* infinity */
-		map.put((char)8736,	"ang");		/* angle */
-		map.put((char)8743,	"and");		/* logical and */
-		map.put((char)8744,	"or");		/* logical or */
-		map.put((char)8745,	"cap");		/* intersection */
-		map.put((char)8746,	"cup");		/* union */
-		map.put((char)8747,	"int");		/* integral */
-		map.put((char)8756,	"there4");	/* therefore */
-		map.put((char)8764,	"sim");		/* tilde operator */
-		map.put((char)8773,	"cong");	/* congruent to */
-		map.put((char)8776,	"asymp");	/* almost equal to */
-		map.put((char)8800,	"ne");		/* not equal to */
-		map.put((char)8801,	"equiv");	/* identical toXCOMMAX equivalent to */
-		map.put((char)8804,	"le");		/* less-than or equal to */
-		map.put((char)8805,	"ge");		/* greater-than or equal to */
-		map.put((char)8834,	"sub");		/* subset of */
-		map.put((char)8835,	"sup");		/* superset of */
-		map.put((char)8836,	"nsub");	/* not a subset of */
-		map.put((char)8838,	"sube");	/* subset of or equal to */
-		map.put((char)8839,	"supe");	/* superset of or equal to */
-		map.put((char)8853,	"oplus");	/* circled plus */
-		map.put((char)8855,	"otimes");	/* circled times */
-		map.put((char)8869,	"perp");	/* up tack */
-		map.put((char)8901,	"sdot");	/* dot operator */
-		map.put((char)8968,	"lceil");	/* left ceiling */
-		map.put((char)8969,	"rceil");	/* right ceiling */
-		map.put((char)8970,	"lfloor");	/* left floor */
-		map.put((char)8971,	"rfloor");	/* right floor */
-		map.put((char)9001,	"lang");	/* left-pointing angle bracket */
-		map.put((char)9002,	"rang");	/* right-pointing angle bracket */
-		map.put((char)9674,	"loz");		/* lozenge */
-		map.put((char)9824,	"spades");	/* black spade suit */
-		map.put((char)9827,	"clubs");	/* black club suit */
-		map.put((char)9829,	"hearts");	/* black heart suit */
-		map.put((char)9830,	"diams");	/* black diamond suit */
+		map.put(34,	"quot");	/* quotation mark */
+		map.put(38,	"amp");		/* ampersand */
+		map.put(60,	"lt");		/* less-than sign */
+		map.put(62,	"gt");		/* greater-than sign */
+		map.put(160,	"nbsp");	/* no-break space */
+		map.put(161,	"iexcl");	/* inverted exclamation mark */
+		map.put(162,	"cent");	/* cent sign */
+		map.put(163,	"pound");	/* pound sign */
+		map.put(164,	"curren");	/* currency sign */
+		map.put(165,	"yen");		/* yen sign */
+		map.put(166,	"brvbar");	/* broken bar */
+		map.put(167,	"sect");	/* section sign */
+		map.put(168,	"uml");		/* diaeresis */
+		map.put(169,	"copy");	/* copyright sign */
+		map.put(170,	"ordf");	/* feminine ordinal indicator */
+		map.put(171,	"laquo");	/* left-pointing double angle quotation mark */
+		map.put(172,	"not");		/* not sign */
+		map.put(173,	"shy");		/* soft hyphen */
+		map.put(174,	"reg");		/* registered sign */
+		map.put(175,	"macr");	/* macron */
+		map.put(176,	"deg");		/* degree sign */
+		map.put(177,	"plusmn");	/* plus-minus sign */
+		map.put(178,	"sup2");	/* superscript two */
+		map.put(179,	"sup3");	/* superscript three */
+		map.put(180,	"acute");	/* acute accent */
+		map.put(181,	"micro");	/* micro sign */
+		map.put(182,	"para");	/* pilcrow sign */
+		map.put(183,	"middot");	/* middle dot */
+		map.put(184,	"cedil");	/* cedilla */
+		map.put(185,	"sup1");	/* superscript one */
+		map.put(186,	"ordm");	/* masculine ordinal indicator */
+		map.put(187,	"raquo");	/* right-pointing double angle quotation mark */
+		map.put(188,	"frac14");	/* vulgar fraction one quarter */
+		map.put(189,	"frac12");	/* vulgar fraction one half */
+		map.put(190,	"frac34");	/* vulgar fraction three quarters */
+		map.put(191,	"iquest");	/* inverted question mark */
+		map.put(192,	"Agrave");	/* Latin capital letter a with grave */
+		map.put(193,	"Aacute");	/* Latin capital letter a with acute */
+		map.put(194,	"Acirc");	/* Latin capital letter a with circumflex */
+		map.put(195,	"Atilde");	/* Latin capital letter a with tilde */
+		map.put(196,	"Auml");	/* Latin capital letter a with diaeresis */
+		map.put(197,	"Aring");	/* Latin capital letter a with ring above */
+		map.put(198,	"AElig");	/* Latin capital letter ae */
+		map.put(199,	"Ccedil");	/* Latin capital letter c with cedilla */
+		map.put(200,	"Egrave");	/* Latin capital letter e with grave */
+		map.put(201,	"Eacute");	/* Latin capital letter e with acute */
+		map.put(202,	"Ecirc");	/* Latin capital letter e with circumflex */
+		map.put(203,	"Euml");	/* Latin capital letter e with diaeresis */
+		map.put(204,	"Igrave");	/* Latin capital letter i with grave */
+		map.put(205,	"Iacute");	/* Latin capital letter i with acute */
+		map.put(206,	"Icirc");	/* Latin capital letter i with circumflex */
+		map.put(207,	"Iuml");	/* Latin capital letter i with diaeresis */
+		map.put(208,	"ETH");		/* Latin capital letter eth */
+		map.put(209,	"Ntilde");	/* Latin capital letter n with tilde */
+		map.put(210,	"Ograve");	/* Latin capital letter o with grave */
+		map.put(211,	"Oacute");	/* Latin capital letter o with acute */
+		map.put(212,	"Ocirc");	/* Latin capital letter o with circumflex */
+		map.put(213,	"Otilde");	/* Latin capital letter o with tilde */
+		map.put(214,	"Ouml");	/* Latin capital letter o with diaeresis */
+		map.put(215,	"times");	/* multiplication sign */
+		map.put(216,	"Oslash");	/* Latin capital letter o with stroke */
+		map.put(217,	"Ugrave");	/* Latin capital letter u with grave */
+		map.put(218,	"Uacute");	/* Latin capital letter u with acute */
+		map.put(219,	"Ucirc");	/* Latin capital letter u with circumflex */
+		map.put(220,	"Uuml");	/* Latin capital letter u with diaeresis */
+		map.put(221,	"Yacute");	/* Latin capital letter y with acute */
+		map.put(222,	"THORN");	/* Latin capital letter thorn */
+		map.put(223,	"szlig");	/* Latin small letter sharp sXCOMMAX German Eszett */
+		map.put(224,	"agrave");	/* Latin small letter a with grave */
+		map.put(225,	"aacute");	/* Latin small letter a with acute */
+		map.put(226,	"acirc");	/* Latin small letter a with circumflex */
+		map.put(227,	"atilde");	/* Latin small letter a with tilde */
+		map.put(228,	"auml");	/* Latin small letter a with diaeresis */
+		map.put(229,	"aring");	/* Latin small letter a with ring above */
+		map.put(230,	"aelig");	/* Latin lowercase ligature ae */
+		map.put(231,	"ccedil");	/* Latin small letter c with cedilla */
+		map.put(232,	"egrave");	/* Latin small letter e with grave */
+		map.put(233,	"eacute");	/* Latin small letter e with acute */
+		map.put(234,	"ecirc");	/* Latin small letter e with circumflex */
+		map.put(235,	"euml");	/* Latin small letter e with diaeresis */
+		map.put(236,	"igrave");	/* Latin small letter i with grave */
+		map.put(237,	"iacute");	/* Latin small letter i with acute */
+		map.put(238,	"icirc");	/* Latin small letter i with circumflex */
+		map.put(239,	"iuml");	/* Latin small letter i with diaeresis */
+		map.put(240,	"eth");		/* Latin small letter eth */
+		map.put(241,	"ntilde");	/* Latin small letter n with tilde */
+		map.put(242,	"ograve");	/* Latin small letter o with grave */
+		map.put(243,	"oacute");	/* Latin small letter o with acute */
+		map.put(244,	"ocirc");	/* Latin small letter o with circumflex */
+		map.put(245,	"otilde");	/* Latin small letter o with tilde */
+		map.put(246,	"ouml");	/* Latin small letter o with diaeresis */
+		map.put(247,	"divide");	/* division sign */
+		map.put(248,	"oslash");	/* Latin small letter o with stroke */
+		map.put(249,	"ugrave");	/* Latin small letter u with grave */
+		map.put(250,	"uacute");	/* Latin small letter u with acute */
+		map.put(251,	"ucirc");	/* Latin small letter u with circumflex */
+		map.put(252,	"uuml");	/* Latin small letter u with diaeresis */
+		map.put(253,	"yacute");	/* Latin small letter y with acute */
+		map.put(254,	"thorn");	/* Latin small letter thorn */
+		map.put(255,	"yuml");	/* Latin small letter y with diaeresis */
+		map.put(338,	"OElig");	/* Latin capital ligature oe */
+		map.put(339,	"oelig");	/* Latin small ligature oe */
+		map.put(352,	"Scaron");	/* Latin capital letter s with caron */
+		map.put(353,	"scaron");	/* Latin small letter s with caron */
+		map.put(376,	"Yuml");	/* Latin capital letter y with diaeresis */
+		map.put(402,	"fnof");	/* Latin small letter f with hook */
+		map.put(710,	"circ");	/* modifier letter circumflex accent */
+		map.put(732,	"tilde");	/* small tilde */
+		map.put(913,	"Alpha");	/* Greek capital letter alpha */
+		map.put(914,	"Beta");	/* Greek capital letter beta */
+		map.put(915,	"Gamma");	/* Greek capital letter gamma */
+		map.put(916,	"Delta");	/* Greek capital letter delta */
+		map.put(917,	"Epsilon");	/* Greek capital letter epsilon */
+		map.put(918,	"Zeta");	/* Greek capital letter zeta */
+		map.put(919,	"Eta");		/* Greek capital letter eta */
+		map.put(920,	"Theta");	/* Greek capital letter theta */
+		map.put(921,	"Iota");	/* Greek capital letter iota */
+		map.put(922,	"Kappa");	/* Greek capital letter kappa */
+		map.put(923,	"Lambda");	/* Greek capital letter lambda */
+		map.put(924,	"Mu");		/* Greek capital letter mu */
+		map.put(925,	"Nu");		/* Greek capital letter nu */
+		map.put(926,	"Xi");		/* Greek capital letter xi */
+		map.put(927,	"Omicron");	/* Greek capital letter omicron */
+		map.put(928,	"Pi");		/* Greek capital letter pi */
+		map.put(929,	"Rho");		/* Greek capital letter rho */
+		map.put(931,	"Sigma");	/* Greek capital letter sigma */
+		map.put(932,	"Tau");		/* Greek capital letter tau */
+		map.put(933,	"Upsilon");	/* Greek capital letter upsilon */
+		map.put(934,	"Phi");		/* Greek capital letter phi */
+		map.put(935,	"Chi");		/* Greek capital letter chi */
+		map.put(936,	"Psi");		/* Greek capital letter psi */
+		map.put(937,	"Omega");	/* Greek capital letter omega */
+		map.put(945,	"alpha");	/* Greek small letter alpha */
+		map.put(946,	"beta");	/* Greek small letter beta */
+		map.put(947,	"gamma");	/* Greek small letter gamma */
+		map.put(948,	"delta");	/* Greek small letter delta */
+		map.put(949,	"epsilon");	/* Greek small letter epsilon */
+		map.put(950,	"zeta");	/* Greek small letter zeta */
+		map.put(951,	"eta");		/* Greek small letter eta */
+		map.put(952,	"theta");	/* Greek small letter theta */
+		map.put(953,	"iota");	/* Greek small letter iota */
+		map.put(954,	"kappa");	/* Greek small letter kappa */
+		map.put(955,	"lambda");	/* Greek small letter lambda */
+		map.put(956,	"mu");		/* Greek small letter mu */
+		map.put(957,	"nu");		/* Greek small letter nu */
+		map.put(958,	"xi");		/* Greek small letter xi */
+		map.put(959,	"omicron");	/* Greek small letter omicron */
+		map.put(960,	"pi");		/* Greek small letter pi */
+		map.put(961,	"rho");		/* Greek small letter rho */
+		map.put(962,	"sigmaf");	/* Greek small letter final sigma */
+		map.put(963,	"sigma");	/* Greek small letter sigma */
+		map.put(964,	"tau");		/* Greek small letter tau */
+		map.put(965,	"upsilon");	/* Greek small letter upsilon */
+		map.put(966,	"phi");		/* Greek small letter phi */
+		map.put(967,	"chi");		/* Greek small letter chi */
+		map.put(968,	"psi");		/* Greek small letter psi */
+		map.put(969,	"omega");	/* Greek small letter omega */
+		map.put(977,	"thetasym");	/* Greek theta symbol */
+		map.put(978,	"upsih");	/* Greek upsilon with hook symbol */
+		map.put(982,	"piv");		/* Greek pi symbol */
+		map.put(8194,	"ensp");	/* en space */
+		map.put(8195,	"emsp");	/* em space */
+		map.put(8201,	"thinsp");	/* thin space */
+		map.put(8204,	"zwnj");	/* zero width non-joiner */
+		map.put(8205,	"zwj");		/* zero width joiner */
+		map.put(8206,	"lrm");		/* left-to-right mark */
+		map.put(8207,	"rlm");		/* right-to-left mark */
+		map.put(8211,	"ndash");	/* en dash */
+		map.put(8212,	"mdash");	/* em dash */
+		map.put(8216,	"lsquo");	/* left single quotation mark */
+		map.put(8217,	"rsquo");	/* right single quotation mark */
+		map.put(8218,	"sbquo");	/* single low-9 quotation mark */
+		map.put(8220,	"ldquo");	/* left double quotation mark */
+		map.put(8221,	"rdquo");	/* right double quotation mark */
+		map.put(8222,	"bdquo");	/* double low-9 quotation mark */
+		map.put(8224,	"dagger");	/* dagger */
+		map.put(8225,	"Dagger");	/* double dagger */
+		map.put(8226,	"bull");	/* bullet */
+		map.put(8230,	"hellip");	/* horizontal ellipsis */
+		map.put(8240,	"permil");	/* per mille sign */
+		map.put(8242,	"prime");	/* prime */
+		map.put(8243,	"Prime");	/* double prime */
+		map.put(8249,	"lsaquo");	/* single left-pointing angle quotation mark */
+		map.put(8250,	"rsaquo");	/* single right-pointing angle quotation mark */
+		map.put(8254,	"oline");	/* overline */
+		map.put(8260,	"frasl");	/* fraction slash */
+		map.put(8364,	"euro");	/* euro sign */
+		map.put(8465,	"image");	/* black-letter capital i */
+		map.put(8472,	"weierp");	/* script capital pXCOMMAX Weierstrass p */
+		map.put(8476,	"real");	/* black-letter capital r */
+		map.put(8482,	"trade");	/* trademark sign */
+		map.put(8501,	"alefsym");	/* alef symbol */
+		map.put(8592,	"larr");	/* leftwards arrow */
+		map.put(8593,	"uarr");	/* upwards arrow */
+		map.put(8594,	"rarr");	/* rightwards arrow */
+		map.put(8595,	"darr");	/* downwards arrow */
+		map.put(8596,	"harr");	/* left right arrow */
+		map.put(8629,	"crarr");	/* downwards arrow with corner leftwards */
+		map.put(8656,	"lArr");	/* leftwards double arrow */
+		map.put(8657,	"uArr");	/* upwards double arrow */
+		map.put(8658,	"rArr");	/* rightwards double arrow */
+		map.put(8659,	"dArr");	/* downwards double arrow */
+		map.put(8660,	"hArr");	/* left right double arrow */
+		map.put(8704,	"forall");	/* for all */
+		map.put(8706,	"part");	/* partial differential */
+		map.put(8707,	"exist");	/* there exists */
+		map.put(8709,	"empty");	/* empty set */
+		map.put(8711,	"nabla");	/* nabla */
+		map.put(8712,	"isin");	/* element of */
+		map.put(8713,	"notin");	/* not an element of */
+		map.put(8715,	"ni");		/* contains as member */
+		map.put(8719,	"prod");	/* n-ary product */
+		map.put(8721,	"sum");		/* n-ary summation */
+		map.put(8722,	"minus");	/* minus sign */
+		map.put(8727,	"lowast");	/* asterisk operator */
+		map.put(8730,	"radic");	/* square root */
+		map.put(8733,	"prop");	/* proportional to */
+		map.put(8734,	"infin");	/* infinity */
+		map.put(8736,	"ang");		/* angle */
+		map.put(8743,	"and");		/* logical and */
+		map.put(8744,	"or");		/* logical or */
+		map.put(8745,	"cap");		/* intersection */
+		map.put(8746,	"cup");		/* union */
+		map.put(8747,	"int");		/* integral */
+		map.put(8756,	"there4");	/* therefore */
+		map.put(8764,	"sim");		/* tilde operator */
+		map.put(8773,	"cong");	/* congruent to */
+		map.put(8776,	"asymp");	/* almost equal to */
+		map.put(8800,	"ne");		/* not equal to */
+		map.put(8801,	"equiv");	/* identical toXCOMMAX equivalent to */
+		map.put(8804,	"le");		/* less-than or equal to */
+		map.put(8805,	"ge");		/* greater-than or equal to */
+		map.put(8834,	"sub");		/* subset of */
+		map.put(8835,	"sup");		/* superset of */
+		map.put(8836,	"nsub");	/* not a subset of */
+		map.put(8838,	"sube");	/* subset of or equal to */
+		map.put(8839,	"supe");	/* superset of or equal to */
+		map.put(8853,	"oplus");	/* circled plus */
+		map.put(8855,	"otimes");	/* circled times */
+		map.put(8869,	"perp");	/* up tack */
+		map.put(8901,	"sdot");	/* dot operator */
+		map.put(8968,	"lceil");	/* left ceiling */
+		map.put(8969,	"rceil");	/* right ceiling */
+		map.put(8970,	"lfloor");	/* left floor */
+		map.put(8971,	"rfloor");	/* right floor */
+		map.put(9001,	"lang");	/* left-pointing angle bracket */
+		map.put(9002,	"rang");	/* right-pointing angle bracket */
+		map.put(9674,	"loz");		/* lozenge */
+		map.put(9824,	"spades");	/* black spade suit */
+		map.put(9827,	"clubs");	/* black club suit */
+		map.put(9829,	"hearts");	/* black heart suit */
+		map.put(9830,	"diams");	/* black diamond suit */
 
 		return Collections.unmodifiableMap(map);
 	}
@@ -584,11 +585,11 @@ private static synchronized Map mkCharacterToEntityMap()
 	 * Build a unmodifiable Trie from entitiy Name to Character
 	 * @return Unmodifiable trie.
 	 */
-	private static synchronized Trie mkEntityToCharacterTrie()
+	private static synchronized Trie mkEntityToCharacterTrie()
 	{
-		Trie trie = new HashTrie();
+		Trie trie = new HashTrie();
 
-		for(Map.Entry entry : characterToEntityMap.entrySet())
+		for(Map.Entry entry : characterToEntityMap.entrySet())
 			trie.put(entry.getValue(),entry.getKey());
 		return Trie.Util.unmodifiable(trie);
 	}
diff --git a/src/main/java/org/owasp/esapi/codecs/JavaScriptCodec.java b/src/main/java/org/owasp/esapi/codecs/JavaScriptCodec.java
index 98c38c7b2..a10d9b588 100644
--- a/src/main/java/org/owasp/esapi/codecs/JavaScriptCodec.java
+++ b/src/main/java/org/owasp/esapi/codecs/JavaScriptCodec.java
@@ -24,7 +24,7 @@
  * @since June 1, 2007
  * @see org.owasp.esapi.Encoder
  */
-public class JavaScriptCodec extends AbstractCodec {
+public class JavaScriptCodec extends AbstractCharacterCodec {
 
 
 	/**
diff --git a/src/main/java/org/owasp/esapi/codecs/MySQLCodec.java b/src/main/java/org/owasp/esapi/codecs/MySQLCodec.java
index e43f13ca2..6552d089f 100644
--- a/src/main/java/org/owasp/esapi/codecs/MySQLCodec.java
+++ b/src/main/java/org/owasp/esapi/codecs/MySQLCodec.java
@@ -26,7 +26,7 @@
  * @since June 1, 2007
  * @see org.owasp.esapi.Encoder
  */
-public class MySQLCodec extends AbstractCodec {
+public class MySQLCodec extends AbstractCharacterCodec {
     /**
      * Specifies the SQL Mode the target MySQL Server is running with. For details about MySQL Server Modes
      * please see the Manual at {@link http://dev.mysql.com/doc/refman/5.0/en/server-sql-mode.html#sqlmode_ansi}
diff --git a/src/main/java/org/owasp/esapi/codecs/OracleCodec.java b/src/main/java/org/owasp/esapi/codecs/OracleCodec.java
index 06cca0609..ff87ea8c0 100644
--- a/src/main/java/org/owasp/esapi/codecs/OracleCodec.java
+++ b/src/main/java/org/owasp/esapi/codecs/OracleCodec.java
@@ -30,7 +30,7 @@
  * @since June 1, 2007
  * @see org.owasp.esapi.Encoder
  */
-public class OracleCodec extends AbstractCodec {
+public class OracleCodec extends AbstractCharacterCodec {
 
 
 	/**
diff --git a/src/main/java/org/owasp/esapi/codecs/PercentCodec.java b/src/main/java/org/owasp/esapi/codecs/PercentCodec.java
index ed7e65dd8..6b3d5d0a5 100644
--- a/src/main/java/org/owasp/esapi/codecs/PercentCodec.java
+++ b/src/main/java/org/owasp/esapi/codecs/PercentCodec.java
@@ -28,7 +28,7 @@
  * @since June 1, 2007
  * @see org.owasp.esapi.Encoder
  */
-public class PercentCodec extends AbstractCodec
+public class PercentCodec extends AbstractCharacterCodec
 {
 	private static final String ALPHA_NUMERIC_STR = "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789";
 	@SuppressWarnings("unused")
diff --git a/src/main/java/org/owasp/esapi/codecs/PushBackSequenceImpl.java b/src/main/java/org/owasp/esapi/codecs/PushBackSequenceImpl.java
index ea31e88d6..c10f4de22 100644
--- a/src/main/java/org/owasp/esapi/codecs/PushBackSequenceImpl.java
+++ b/src/main/java/org/owasp/esapi/codecs/PushBackSequenceImpl.java
@@ -126,7 +126,7 @@ public void reset() {
      *
      * @return
      */
-    protected String remainder() {
+    public String remainder() {
 		String output = input.substring( index );
 		if ( pushback != null ) {
 			output = pushback + output;
diff --git a/src/main/java/org/owasp/esapi/codecs/PushbackSequence.java b/src/main/java/org/owasp/esapi/codecs/PushbackSequence.java
index 58fe4a930..5588ca91f 100644
--- a/src/main/java/org/owasp/esapi/codecs/PushbackSequence.java
+++ b/src/main/java/org/owasp/esapi/codecs/PushbackSequence.java
@@ -61,4 +61,12 @@ public interface PushbackSequence {
 	 */
 	void reset();
 
+	/**
+	 * Not at all sure what this method is intended to do.  There 
+	 * is a line in HTMLEntityCodec that said calling this method 
+	 * is a "kludge around PushbackString..."
+	 * @return
+	 */
+	String remainder();
+
 }
\ No newline at end of file
diff --git a/src/main/java/org/owasp/esapi/codecs/PushbackString.java b/src/main/java/org/owasp/esapi/codecs/PushbackString.java
index 9982d48e2..4255045f9 100644
--- a/src/main/java/org/owasp/esapi/codecs/PushbackString.java
+++ b/src/main/java/org/owasp/esapi/codecs/PushbackString.java
@@ -193,7 +193,7 @@ public void reset() {
 	 *
 	 * @return
 	 */
-	protected String remainder() {
+	public String remainder() {
 		String output = input.substring(index);
 		if (pushback != null) {
 			output = pushback + output;
diff --git a/src/main/java/org/owasp/esapi/codecs/UnixCodec.java b/src/main/java/org/owasp/esapi/codecs/UnixCodec.java
index 3381e82f0..da2dddc0b 100644
--- a/src/main/java/org/owasp/esapi/codecs/UnixCodec.java
+++ b/src/main/java/org/owasp/esapi/codecs/UnixCodec.java
@@ -24,7 +24,7 @@
  * @since June 1, 2007
  * @see org.owasp.esapi.Encoder
  */
-public class UnixCodec extends AbstractCodec {
+public class UnixCodec extends AbstractCharacterCodec {
 
 	/**
 	 * {@inheritDoc}
diff --git a/src/main/java/org/owasp/esapi/codecs/VBScriptCodec.java b/src/main/java/org/owasp/esapi/codecs/VBScriptCodec.java
index 85ce820e9..ae7f1f6ac 100644
--- a/src/main/java/org/owasp/esapi/codecs/VBScriptCodec.java
+++ b/src/main/java/org/owasp/esapi/codecs/VBScriptCodec.java
@@ -26,7 +26,7 @@
  * @since June 1, 2007
  * @see org.owasp.esapi.Encoder
  */
-public class VBScriptCodec extends AbstractCodec {
+public class VBScriptCodec extends AbstractCharacterCodec {
 
 	/**
 	 * Encode a String so that it can be safely used in a specific context.
diff --git a/src/main/java/org/owasp/esapi/codecs/WindowsCodec.java b/src/main/java/org/owasp/esapi/codecs/WindowsCodec.java
index bcc53f626..c0a5540ea 100644
--- a/src/main/java/org/owasp/esapi/codecs/WindowsCodec.java
+++ b/src/main/java/org/owasp/esapi/codecs/WindowsCodec.java
@@ -24,7 +24,7 @@
  * @since June 1, 2007
  * @see org.owasp.esapi.Encoder
  */
-public class WindowsCodec extends AbstractCodec {
+public class WindowsCodec extends AbstractCharacterCodec {
 
 	
 	/**
diff --git a/src/main/java/org/owasp/esapi/codecs/XMLEntityCodec.java b/src/main/java/org/owasp/esapi/codecs/XMLEntityCodec.java
index 25b4ffbc4..45482adae 100644
--- a/src/main/java/org/owasp/esapi/codecs/XMLEntityCodec.java
+++ b/src/main/java/org/owasp/esapi/codecs/XMLEntityCodec.java
@@ -41,7 +41,7 @@
  * of knowing about. Decoding is included for completeness but it's use
  * is not recommended. Use a XML parser instead!
  */
-public class XMLEntityCodec extends AbstractCodec
+public class XMLEntityCodec extends AbstractCharacterCodec
 {
 	private static final String ALPHA_NUMERIC_STR = "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789";
 	private static final String UNENCODED_STR = ALPHA_NUMERIC_STR + " \t";
diff --git a/src/test/java/org/owasp/esapi/codecs/AbstractCodecTest.java b/src/test/java/org/owasp/esapi/codecs/AbstractCodecTest.java
index 1472e5dfb..9e0a5477b 100644
--- a/src/test/java/org/owasp/esapi/codecs/AbstractCodecTest.java
+++ b/src/test/java/org/owasp/esapi/codecs/AbstractCodecTest.java
@@ -574,7 +574,7 @@ public void testWindowsDecode()
 	
 	public void testHtmlDecodeCharLessThan()
 	{
-        	assertEquals( LESS_THAN, htmlCodec.decodeCharacter(new PushbackString("<")) );
+        	assertEquals( LESS_THAN, htmlCodec.decodeCharacter(new PushBackSequenceImpl("<")) );
 	}
 
 	public void testPercentDecodeChar()
diff --git a/src/test/java/org/owasp/esapi/reference/EncoderTest.java b/src/test/java/org/owasp/esapi/reference/EncoderTest.java
index 896a93661..125e8ed48 100644
--- a/src/test/java/org/owasp/esapi/reference/EncoderTest.java
+++ b/src/test/java/org/owasp/esapi/reference/EncoderTest.java
@@ -15,18 +15,15 @@
  */
 package org.owasp.esapi.reference;
 
+import java.io.ByteArrayOutputStream;
 import java.io.IOException;
+import java.io.ObjectOutputStream;
 import java.io.UnsupportedEncodingException;
 import java.net.URI;
 import java.util.ArrayList;
 import java.util.Arrays;
-import java.io.ByteArrayOutputStream;
-import java.io.ObjectOutputStream;
-
-import junit.framework.Test;
-import junit.framework.TestCase;
-import junit.framework.TestSuite;
 
+import org.junit.Ignore;
 import org.owasp.esapi.ESAPI;
 import org.owasp.esapi.Encoder;
 import org.owasp.esapi.EncoderConstants;
@@ -41,6 +38,10 @@
 import org.owasp.esapi.errors.EncodingException;
 import org.owasp.esapi.errors.IntrusionException;
 
+import junit.framework.Test;
+import junit.framework.TestCase;
+import junit.framework.TestSuite;
+
 /**
  * The Class EncoderTest.
  * 
@@ -91,6 +92,8 @@ public static Test suite() {
 	 * 
 	 * @throws EncodingException
 	 */
+    //FIXME:  Remove @Ignore
+    @Ignore
 	public void testCanonicalize() throws EncodingException {
 		System.out.println("canonicalize");
 
@@ -720,7 +723,7 @@ public void testWindowsCodec() {
         System.out.println("WindowsCodec");
         Encoder instance = ESAPI.encoder();
 
-        Codec win = new WindowsCodec();
+        Codec win = new WindowsCodec();
         char[] immune = new char[0];
         assertEquals(null, instance.encodeForOS(win, null));
         
@@ -754,7 +757,7 @@ public void testUnixCodec() {
         System.out.println("UnixCodec");
         Encoder instance = ESAPI.encoder();
 
-        Codec unix = new UnixCodec();
+        Codec unix = new UnixCodec();
         char[] immune = new char[0];
         assertEquals(null, instance.encodeForOS(unix, null));
         

From 914edd7584fa9bfa1e5a307787e64d82318a2aee Mon Sep 17 00:00:00 2001
From: Matt Seil 
Date: Sun, 6 Aug 2017 09:55:22 -0700
Subject: [PATCH 441/812] Issue #300 -- Fixed a tricky polymorphism bug with
 Jeremiah Stacey's help.  Added a unit test for PercentCodec.

---
 .../org/owasp/esapi/codecs/JavaScriptCodec.java  |  2 +-
 .../java/org/owasp/esapi/codecs/MySQLCodec.java  |  2 +-
 .../java/org/owasp/esapi/codecs/OracleCodec.java |  2 +-
 .../org/owasp/esapi/codecs/PercentCodec.java     |  2 +-
 .../java/org/owasp/esapi/codecs/UnixCodec.java   |  2 +-
 .../org/owasp/esapi/codecs/VBScriptCodec.java    |  2 +-
 .../org/owasp/esapi/codecs/WindowsCodec.java     |  2 +-
 .../org/owasp/esapi/codecs/PercentCodecTest.java | 16 ++++++++++++++++
 8 files changed, 23 insertions(+), 7 deletions(-)
 create mode 100644 src/test/java/org/owasp/esapi/codecs/PercentCodecTest.java

diff --git a/src/main/java/org/owasp/esapi/codecs/JavaScriptCodec.java b/src/main/java/org/owasp/esapi/codecs/JavaScriptCodec.java
index a10d9b588..a43cbd004 100644
--- a/src/main/java/org/owasp/esapi/codecs/JavaScriptCodec.java
+++ b/src/main/java/org/owasp/esapi/codecs/JavaScriptCodec.java
@@ -87,7 +87,7 @@ public String encodeCharacter( char[] immune, Character c ) {
 	 *   \\uHHHH
 	 *   \\OOO (1, 2, or 3 digits)
 	 */
-	public Character decodeCharacter( PushbackString input ) {
+	public Character decodeCharacter( PushbackSequence input ) {
 		input.mark();
 		Character first = input.next();
 		if ( first == null ) {
diff --git a/src/main/java/org/owasp/esapi/codecs/MySQLCodec.java b/src/main/java/org/owasp/esapi/codecs/MySQLCodec.java
index 6552d089f..1bc902342 100644
--- a/src/main/java/org/owasp/esapi/codecs/MySQLCodec.java
+++ b/src/main/java/org/owasp/esapi/codecs/MySQLCodec.java
@@ -162,7 +162,7 @@ private String encodeCharacterMySQL( Character c ) {
 	 *   In ANSI_MODE '' decodes to '
 	 *   In MYSQL_MODE \x decodes to x (or a small list of specials)
 	 */
-	public Character decodeCharacter( PushbackString input ) {
+	public Character decodeCharacter( PushbackSequence input ) {
 		switch( mode ) {
 			case ANSI: return decodeCharacterANSI( input );
 			case STANDARD: return decodeCharacterMySQL( input );
diff --git a/src/main/java/org/owasp/esapi/codecs/OracleCodec.java b/src/main/java/org/owasp/esapi/codecs/OracleCodec.java
index ff87ea8c0..0021a8613 100644
--- a/src/main/java/org/owasp/esapi/codecs/OracleCodec.java
+++ b/src/main/java/org/owasp/esapi/codecs/OracleCodec.java
@@ -59,7 +59,7 @@ public String encodeCharacter( char[] immune, Character c ) {
 	 * Formats all are legal
 	 *   '' decodes to '
 	 */
-	public Character decodeCharacter( PushbackString input ) {
+	public Character decodeCharacter( PushbackSequence input ) {
 		input.mark();
 		Character first = input.next();
 		if ( first == null ) {
diff --git a/src/main/java/org/owasp/esapi/codecs/PercentCodec.java b/src/main/java/org/owasp/esapi/codecs/PercentCodec.java
index 6b3d5d0a5..ac9e9a59e 100644
--- a/src/main/java/org/owasp/esapi/codecs/PercentCodec.java
+++ b/src/main/java/org/owasp/esapi/codecs/PercentCodec.java
@@ -128,7 +128,7 @@ public String encodeCharacter( char[] immune, Character c )
 	 * @param input
 	 * 			encoded character using percent characters (such as URL encoding)
 	 */
-	public Character decodeCharacter( PushbackString input ) {
+	public Character decodeCharacter( PushbackSequence input ) {
 		input.mark();
 		Character first = input.next();
 		if ( first == null ) {
diff --git a/src/main/java/org/owasp/esapi/codecs/UnixCodec.java b/src/main/java/org/owasp/esapi/codecs/UnixCodec.java
index da2dddc0b..faeebad65 100644
--- a/src/main/java/org/owasp/esapi/codecs/UnixCodec.java
+++ b/src/main/java/org/owasp/esapi/codecs/UnixCodec.java
@@ -61,7 +61,7 @@ public String encodeCharacter( char[] immune, Character c ) {
 	 *   \x - all special characters
 	 *   
 	 */
-	public Character decodeCharacter( PushbackString input ) {
+	public Character decodeCharacter( PushbackSequence input ) {
 		input.mark();
 		Character first = input.next();
 		if ( first == null ) {
diff --git a/src/main/java/org/owasp/esapi/codecs/VBScriptCodec.java b/src/main/java/org/owasp/esapi/codecs/VBScriptCodec.java
index ae7f1f6ac..122e90aad 100644
--- a/src/main/java/org/owasp/esapi/codecs/VBScriptCodec.java
+++ b/src/main/java/org/owasp/esapi/codecs/VBScriptCodec.java
@@ -96,7 +96,7 @@ public String encodeCharacter( char[] immune, Character c ) {
 	 *   "x - all special characters
 	 *   " + chr(x) + "  - not supported yet
 	 */
-	public Character decodeCharacter( PushbackString input ) {
+	public Character decodeCharacter( PushbackSequence input ) {
 		input.mark();
 		Character first = input.next();
 		if ( first == null ) {
diff --git a/src/main/java/org/owasp/esapi/codecs/WindowsCodec.java b/src/main/java/org/owasp/esapi/codecs/WindowsCodec.java
index c0a5540ea..be22640ad 100644
--- a/src/main/java/org/owasp/esapi/codecs/WindowsCodec.java
+++ b/src/main/java/org/owasp/esapi/codecs/WindowsCodec.java
@@ -61,7 +61,7 @@ public String encodeCharacter( char[] immune, Character c ) {
 	 * Formats all are legal both upper/lower case:
 	 *   ^x - all special characters
 	 */
-	public Character decodeCharacter( PushbackString input ) {
+	public Character decodeCharacter( PushbackSequence input ) {
 		input.mark();
 		Character first = input.next();
 		if ( first == null ) {
diff --git a/src/test/java/org/owasp/esapi/codecs/PercentCodecTest.java b/src/test/java/org/owasp/esapi/codecs/PercentCodecTest.java
new file mode 100644
index 000000000..c1b2b7ad8
--- /dev/null
+++ b/src/test/java/org/owasp/esapi/codecs/PercentCodecTest.java
@@ -0,0 +1,16 @@
+package org.owasp.esapi.codecs;
+
+import static org.junit.Assert.assertEquals;
+
+import org.junit.Test;
+
+public class PercentCodecTest {
+	
+	@Test
+	public void testPercentDecode(){
+		Codec codec = new PercentCodec();
+		
+		String expected = " ";
+		assertEquals(expected, codec.decode("%20"));
+	}
+}

From 946158b501d5d17c52cc5bbf88dedc7888fe59f2 Mon Sep 17 00:00:00 2001
From: Matt Seil 
Date: Sun, 6 Aug 2017 11:04:45 -0700
Subject: [PATCH 442/812] Issue #300 -- We need to get more data driven unit
 tests, but this issue is now completely whacked!

---
 .../org/owasp/esapi/codecs/HTMLEntityCodec.java |  9 ++++++---
 .../java/org/owasp/esapi/codecs/MySQLCodec.java |  4 ++--
 .../org/owasp/esapi/codecs/XMLEntityCodec.java  | 10 +++++-----
 .../owasp/esapi/codecs/AbstractCodecTest.java   |  5 ++++-
 .../owasp/esapi/codecs/HTMLEntityCodecTest.java | 17 +++++++++++++++++
 .../org/owasp/esapi/reference/EncoderTest.java  |  2 --
 6 files changed, 34 insertions(+), 13 deletions(-)
 create mode 100644 src/test/java/org/owasp/esapi/codecs/HTMLEntityCodecTest.java

diff --git a/src/main/java/org/owasp/esapi/codecs/HTMLEntityCodec.java b/src/main/java/org/owasp/esapi/codecs/HTMLEntityCodec.java
index 4adfdf84c..14564372f 100644
--- a/src/main/java/org/owasp/esapi/codecs/HTMLEntityCodec.java
+++ b/src/main/java/org/owasp/esapi/codecs/HTMLEntityCodec.java
@@ -286,9 +286,12 @@ private Integer getNamedEntity( PushbackSequence input ) {
 		
 		// kludge around PushbackString....
 		len = Math.min(input.remainder().length(), entityToCharacterTrie.getMaxKeyLength());
-		for(int i=0;i input ) {
 	 * @return
 	 * 			A single character, decoded
 	 */
-	private Character decodeCharacterANSI( PushbackString input ) {
+	private Character decodeCharacterANSI( PushbackSequence  input ) {
 		input.mark();
 		Character first = input.next();
 		if ( first == null ) {
@@ -214,7 +214,7 @@ private Character decodeCharacterANSI( PushbackString input ) {
 	 * @return
 	 * 			A single character from that string, decoded.
 	 */
-	private Character decodeCharacterMySQL( PushbackString input ) {
+	private Character decodeCharacterMySQL( PushbackSequence input ) {
 		input.mark();
 		Character first = input.next();
 		if ( first == null ) {
diff --git a/src/main/java/org/owasp/esapi/codecs/XMLEntityCodec.java b/src/main/java/org/owasp/esapi/codecs/XMLEntityCodec.java
index 45482adae..418f4c5a7 100644
--- a/src/main/java/org/owasp/esapi/codecs/XMLEntityCodec.java
+++ b/src/main/java/org/owasp/esapi/codecs/XMLEntityCodec.java
@@ -91,7 +91,7 @@ public String encodeCharacter(char[] immune, Character c)
 	 * 	
  • &name;
    • 
 	 *
*/ - public Character decodeCharacter(PushbackString input) + public Character decodeCharacter(PushbackSequence input) { Character ret = null; Character first; @@ -137,7 +137,7 @@ else if(Character.isLetter(second.charValue())) * is positioned at the character after the &# * @return The character decoded or null on failure. */ - private static Character getNumericEntity(PushbackString input) + private static Character getNumericEntity(PushbackSequence input) { Character first = input.peek(); @@ -174,7 +174,7 @@ private static Character int2char(int i) * the next char is not a 'x' or 'X'. * @return The character decoded or null on failutre. */ - private static Character parseNumber(PushbackString input) + private static Character parseNumber(PushbackSequence input) { StringBuilder sb = new StringBuilder(); Character c; @@ -209,7 +209,7 @@ private static Character parseNumber(PushbackString input) * is positioned at the character after the &#[xX] * @return The character decoded or null on failutre. */ - private static Character parseHex(PushbackString input) + private static Character parseHex(PushbackSequence input) { Character c; StringBuilder sb = new StringBuilder(); @@ -268,7 +268,7 @@ private static Character parseHex(PushbackString input) * is positioned at the character after the &. * @return The character decoded or null on failutre. */ - private Character getNamedEntity(PushbackString input) + private Character getNamedEntity(PushbackSequence input) { StringBuilder possible = new StringBuilder(); Map.Entry entry; diff --git a/src/test/java/org/owasp/esapi/codecs/AbstractCodecTest.java b/src/test/java/org/owasp/esapi/codecs/AbstractCodecTest.java index 9e0a5477b..1456058bd 100644 --- a/src/test/java/org/owasp/esapi/codecs/AbstractCodecTest.java +++ b/src/test/java/org/owasp/esapi/codecs/AbstractCodecTest.java @@ -574,7 +574,10 @@ public void testWindowsDecode() public void testHtmlDecodeCharLessThan() { - assertEquals( LESS_THAN, htmlCodec.decodeCharacter(new PushBackSequenceImpl("<")) ); + Integer value = htmlCodec.decodeCharacter(new PushBackSequenceImpl("<")); + assertEquals(new Integer(60), value); + StringBuilder sb = new StringBuilder().appendCodePoint(value); + assertEquals( LESS_THAN.toString(), sb.toString()); } public void testPercentDecodeChar() diff --git a/src/test/java/org/owasp/esapi/codecs/HTMLEntityCodecTest.java b/src/test/java/org/owasp/esapi/codecs/HTMLEntityCodecTest.java new file mode 100644 index 000000000..a12f287cd --- /dev/null +++ b/src/test/java/org/owasp/esapi/codecs/HTMLEntityCodecTest.java @@ -0,0 +1,17 @@ +package org.owasp.esapi.codecs; + +import static org.junit.Assert.assertEquals; + +import org.junit.Test; + +public class HTMLEntityCodecTest { + Codec codec = new HTMLEntityCodec(); + + @Test + public void testEntityDecoding(){ + assertEquals("<", codec.decode("<")); + assertEquals( "<", codec.decode("<")); + assertEquals( "<", codec.decode("<")); + assertEquals( "<", codec.decode("<")); + } +} diff --git a/src/test/java/org/owasp/esapi/reference/EncoderTest.java b/src/test/java/org/owasp/esapi/reference/EncoderTest.java index 125e8ed48..64bb88ac9 100644 --- a/src/test/java/org/owasp/esapi/reference/EncoderTest.java +++ b/src/test/java/org/owasp/esapi/reference/EncoderTest.java @@ -92,8 +92,6 @@ public static Test suite() { * * @throws EncodingException */ - //FIXME: Remove @Ignore - @Ignore public void testCanonicalize() throws EncodingException { System.out.println("canonicalize"); From 62c5100f4654eab3df7191c90e458120fff71133 Mon Sep 17 00:00:00 2001 From: Matt Seil Date: Sun, 6 Aug 2017 11:29:49 -0700 Subject: [PATCH 443/812] Issue #303 -- Added unit test to prove that this issue is resolved. --- .../java/org/owasp/esapi/codecs/HTMLEntityCodecTest.java | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/src/test/java/org/owasp/esapi/codecs/HTMLEntityCodecTest.java b/src/test/java/org/owasp/esapi/codecs/HTMLEntityCodecTest.java index a12f287cd..bae3732dc 100644 --- a/src/test/java/org/owasp/esapi/codecs/HTMLEntityCodecTest.java +++ b/src/test/java/org/owasp/esapi/codecs/HTMLEntityCodecTest.java @@ -14,4 +14,13 @@ public void testEntityDecoding(){ assertEquals( "<", codec.decode("<")); assertEquals( "<", codec.decode("<")); } + + @Test + public void test32BitCJK(){ + String s = "𡘾𦴩𥻂"; + String expected = "𡘾𦴩𥻂"; + String bad = "������"; + assertEquals(false, expected.equals(bad)); + assertEquals(expected, codec.encode(new char[0], s)); + } } From 957a9c79f290b9d67dfa5cbdbfee78f6c2fbca4a Mon Sep 17 00:00:00 2001 From: Matt Seil Date: Mon, 7 Aug 2017 19:50:44 -0700 Subject: [PATCH 444/812] Issue #300 -- Brought back a slightly modified version of the old HTMLEntityCodec for backwards compatability purposes. --- .../esapi/codecs/LegacyHTMLEntityCodec.java | 552 ++++++++++++++++++ 1 file changed, 552 insertions(+) create mode 100644 src/main/java/org/owasp/esapi/codecs/LegacyHTMLEntityCodec.java diff --git a/src/main/java/org/owasp/esapi/codecs/LegacyHTMLEntityCodec.java b/src/main/java/org/owasp/esapi/codecs/LegacyHTMLEntityCodec.java new file mode 100644 index 000000000..e35296b62 --- /dev/null +++ b/src/main/java/org/owasp/esapi/codecs/LegacyHTMLEntityCodec.java @@ -0,0 +1,552 @@ +/** + * OWASP Enterprise Security API (ESAPI) + * + * This file is part of the Open Web Application Security Project (OWASP) + * Enterprise Security API (ESAPI) project. For details, please see + * http://www.owasp.org/index.php/ESAPI. + * + * Copyright (c) 2007 - The OWASP Foundation + * + * The ESAPI is published by OWASP under the BSD license. You should read and accept the + * LICENSE before you use, modify, and/or redistribute this software. + * + * @author Jeff Williams Aspect Security + * @created 2007 + */ +package org.owasp.esapi.codecs; + +import java.util.HashMap; +import java.util.Collections; +import java.util.Map; + +/** + * Implementation of the Codec interface for HTML entity encoding. + * + * @author Jeff Williams (jeff.williams .at. aspectsecurity.com) Aspect Security + * @since June 1, 2007 + * @see org.owasp.esapi.Encoder + */ +public class LegacyHTMLEntityCodec extends AbstractCharacterCodec { + + private static final char REPLACEMENT_CHAR = '\ufffd'; + private static final String REPLACEMENT_HEX = "fffd"; + private static final String REPLACEMENT_STR = "" + REPLACEMENT_CHAR; + private static final Map characterToEntityMap = mkCharacterToEntityMap(); + private static final Trie entityToCharacterTrie = mkEntityToCharacterTrie(); + + /** + * {@inheritDoc} + * + * Encodes a Character for safe use in an HTML entity field. + * @param immune + */ + public String encodeCharacter( char[] immune, Character c ) { + + // check for immune characters + if ( containsCharacter(c, immune ) ) { + return ""+c; + } + + // check for alphanumeric characters + String hex = super.getHexForNonAlphanumeric(c); + if ( hex == null ) { + return ""+c; + } + + // check for illegal characters + if ( ( c <= 0x1f && c != '\t' && c != '\n' && c != '\r' ) || ( c >= 0x7f && c <= 0x9f ) ) + { + hex = REPLACEMENT_HEX; // Let's entity encode this instead of returning it + c = REPLACEMENT_CHAR; + } + + // check if there's a defined entity + String entityName = (String) characterToEntityMap.get(c); + if (entityName != null) { + return "&" + entityName + ";"; + } + + // return the hex entity as suggested in the spec + return "&#x" + hex + ";"; + } + + /** + * {@inheritDoc} + * + * Returns the decoded version of the character starting at index, or + * null if no decoding is possible. + * + * Formats all are legal both with and without semi-colon, upper/lower case: + * &#dddd; + * &#xhhhh; + * &name; + */ + public Character decodeCharacter( PushbackString input ) { + input.mark(); + Character first = input.next(); + if ( first == null ) { + input.reset(); + return null; + } + + // if this is not an encoded character, return null + if (first != '&' ) { + input.reset(); + return null; + } + + // test for numeric encodings + Character second = input.next(); + if ( second == null ) { + input.reset(); + return null; + } + + if (second == '#' ) { + // handle numbers + Character c = getNumericEntity( input ); + if ( c != null ) return c; + } else if ( Character.isLetter( second.charValue() ) ) { + // handle entities + input.pushback( second ); + Character c = getNamedEntity( input ); + if ( c != null ) return c; + } + input.reset(); + return null; + } + + /** + * getNumericEntry checks input to see if it is a numeric entity + * + * @param input + * The input to test for being a numeric entity + * + * @return + * null if input is null, the character of input after decoding + */ + private Character getNumericEntity( PushbackString input ) { + Character first = input.peek(); + if ( first == null ) return null; + + if (first == 'x' || first == 'X' ) { + input.next(); + return parseHex( input ); + } + return parseNumber( input ); + } + + /** + * Parse a decimal number, such as those from JavaScript's String.fromCharCode(value) + * + * @param input + * decimal encoded string, such as 65 + * @return + * character representation of this decimal value, e.g. A + * @throws NumberFormatException + */ + private Character parseNumber( PushbackString input ) { + StringBuilder sb = new StringBuilder(); + while( input.hasNext() ) { + Character c = input.peek(); + + // if character is a digit then add it on and keep going + if ( Character.isDigit( c.charValue() ) ) { + sb.append( c ); + input.next(); + + // if character is a semi-colon, eat it and quit + } else if (c == ';' ) { + input.next(); + break; + + // otherwise just quit + } else { + break; + } + } + try { + int i = Integer.parseInt(sb.toString()); + if (Character.isValidCodePoint(i)) { + return (char) i; + } + } catch( NumberFormatException e ) { + // throw an exception for malformed entity? + } + return null; + } + + /** + * Parse a hex encoded entity + * + * @param input + * Hex encoded input (such as 437ae;) + * @return + * A single character from the string + * @throws NumberFormatException + */ + private Character parseHex( PushbackString input ) { + StringBuilder sb = new StringBuilder(); + while( input.hasNext() ) { + Character c = input.peek(); + + // if character is a hex digit then add it on and keep going + if ( "0123456789ABCDEFabcdef".indexOf(c) != -1 ) { + sb.append( c ); + input.next(); + + // if character is a semi-colon, eat it and quit + } else if (c == ';' ) { + input.next(); + break; + + // otherwise just quit + } else { + break; + } + } + try { + int i = Integer.parseInt(sb.toString(), 16); + if (Character.isValidCodePoint(i)) { + return (char) i; + } + } catch( NumberFormatException e ) { + // throw an exception for malformed entity? + } + return null; + } + + /** + * + * Returns the decoded version of the character starting at index, or + * null if no decoding is possible. + * + * Formats all are legal both with and without semi-colon, upper/lower case: + * &aa; + * &aaa; + * &aaaa; + * &aaaaa; + * &aaaaaa; + * &aaaaaaa; + * + * @param input + * A string containing a named entity like " + * @return + * Returns the decoded version of the character starting at index, or null if no decoding is possible. + */ + private Character getNamedEntity( PushbackString input ) { + StringBuilder possible = new StringBuilder(); + Map.Entry entry; + int len; + + // kludge around PushbackString.... + len = Math.min(input.remainder().length(), entityToCharacterTrie.getMaxKeyLength()); + for(int i=0;i exactEntry = entityToCharacterTrie.getLongestMatch(possibleStringLowerCase); + if(exactEntry != null) entry = exactEntry; + } + if(entry == null) return null; // no match, caller will reset input + } + + // fixup input + input.reset(); + input.next(); // read & + len = entry.getKey().length(); // what matched's length + for(int i=0;i mkCharacterToEntityMap() + { + Map map = new HashMap(252); + + map.put((char)34, "quot"); /* quotation mark */ + map.put((char)38, "amp"); /* ampersand */ + map.put((char)60, "lt"); /* less-than sign */ + map.put((char)62, "gt"); /* greater-than sign */ + map.put((char)160, "nbsp"); /* no-break space */ + map.put((char)161, "iexcl"); /* inverted exclamation mark */ + map.put((char)162, "cent"); /* cent sign */ + map.put((char)163, "pound"); /* pound sign */ + map.put((char)164, "curren"); /* currency sign */ + map.put((char)165, "yen"); /* yen sign */ + map.put((char)166, "brvbar"); /* broken bar */ + map.put((char)167, "sect"); /* section sign */ + map.put((char)168, "uml"); /* diaeresis */ + map.put((char)169, "copy"); /* copyright sign */ + map.put((char)170, "ordf"); /* feminine ordinal indicator */ + map.put((char)171, "laquo"); /* left-pointing double angle quotation mark */ + map.put((char)172, "not"); /* not sign */ + map.put((char)173, "shy"); /* soft hyphen */ + map.put((char)174, "reg"); /* registered sign */ + map.put((char)175, "macr"); /* macron */ + map.put((char)176, "deg"); /* degree sign */ + map.put((char)177, "plusmn"); /* plus-minus sign */ + map.put((char)178, "sup2"); /* superscript two */ + map.put((char)179, "sup3"); /* superscript three */ + map.put((char)180, "acute"); /* acute accent */ + map.put((char)181, "micro"); /* micro sign */ + map.put((char)182, "para"); /* pilcrow sign */ + map.put((char)183, "middot"); /* middle dot */ + map.put((char)184, "cedil"); /* cedilla */ + map.put((char)185, "sup1"); /* superscript one */ + map.put((char)186, "ordm"); /* masculine ordinal indicator */ + map.put((char)187, "raquo"); /* right-pointing double angle quotation mark */ + map.put((char)188, "frac14"); /* vulgar fraction one quarter */ + map.put((char)189, "frac12"); /* vulgar fraction one half */ + map.put((char)190, "frac34"); /* vulgar fraction three quarters */ + map.put((char)191, "iquest"); /* inverted question mark */ + map.put((char)192, "Agrave"); /* Latin capital letter a with grave */ + map.put((char)193, "Aacute"); /* Latin capital letter a with acute */ + map.put((char)194, "Acirc"); /* Latin capital letter a with circumflex */ + map.put((char)195, "Atilde"); /* Latin capital letter a with tilde */ + map.put((char)196, "Auml"); /* Latin capital letter a with diaeresis */ + map.put((char)197, "Aring"); /* Latin capital letter a with ring above */ + map.put((char)198, "AElig"); /* Latin capital letter ae */ + map.put((char)199, "Ccedil"); /* Latin capital letter c with cedilla */ + map.put((char)200, "Egrave"); /* Latin capital letter e with grave */ + map.put((char)201, "Eacute"); /* Latin capital letter e with acute */ + map.put((char)202, "Ecirc"); /* Latin capital letter e with circumflex */ + map.put((char)203, "Euml"); /* Latin capital letter e with diaeresis */ + map.put((char)204, "Igrave"); /* Latin capital letter i with grave */ + map.put((char)205, "Iacute"); /* Latin capital letter i with acute */ + map.put((char)206, "Icirc"); /* Latin capital letter i with circumflex */ + map.put((char)207, "Iuml"); /* Latin capital letter i with diaeresis */ + map.put((char)208, "ETH"); /* Latin capital letter eth */ + map.put((char)209, "Ntilde"); /* Latin capital letter n with tilde */ + map.put((char)210, "Ograve"); /* Latin capital letter o with grave */ + map.put((char)211, "Oacute"); /* Latin capital letter o with acute */ + map.put((char)212, "Ocirc"); /* Latin capital letter o with circumflex */ + map.put((char)213, "Otilde"); /* Latin capital letter o with tilde */ + map.put((char)214, "Ouml"); /* Latin capital letter o with diaeresis */ + map.put((char)215, "times"); /* multiplication sign */ + map.put((char)216, "Oslash"); /* Latin capital letter o with stroke */ + map.put((char)217, "Ugrave"); /* Latin capital letter u with grave */ + map.put((char)218, "Uacute"); /* Latin capital letter u with acute */ + map.put((char)219, "Ucirc"); /* Latin capital letter u with circumflex */ + map.put((char)220, "Uuml"); /* Latin capital letter u with diaeresis */ + map.put((char)221, "Yacute"); /* Latin capital letter y with acute */ + map.put((char)222, "THORN"); /* Latin capital letter thorn */ + map.put((char)223, "szlig"); /* Latin small letter sharp sXCOMMAX German Eszett */ + map.put((char)224, "agrave"); /* Latin small letter a with grave */ + map.put((char)225, "aacute"); /* Latin small letter a with acute */ + map.put((char)226, "acirc"); /* Latin small letter a with circumflex */ + map.put((char)227, "atilde"); /* Latin small letter a with tilde */ + map.put((char)228, "auml"); /* Latin small letter a with diaeresis */ + map.put((char)229, "aring"); /* Latin small letter a with ring above */ + map.put((char)230, "aelig"); /* Latin lowercase ligature ae */ + map.put((char)231, "ccedil"); /* Latin small letter c with cedilla */ + map.put((char)232, "egrave"); /* Latin small letter e with grave */ + map.put((char)233, "eacute"); /* Latin small letter e with acute */ + map.put((char)234, "ecirc"); /* Latin small letter e with circumflex */ + map.put((char)235, "euml"); /* Latin small letter e with diaeresis */ + map.put((char)236, "igrave"); /* Latin small letter i with grave */ + map.put((char)237, "iacute"); /* Latin small letter i with acute */ + map.put((char)238, "icirc"); /* Latin small letter i with circumflex */ + map.put((char)239, "iuml"); /* Latin small letter i with diaeresis */ + map.put((char)240, "eth"); /* Latin small letter eth */ + map.put((char)241, "ntilde"); /* Latin small letter n with tilde */ + map.put((char)242, "ograve"); /* Latin small letter o with grave */ + map.put((char)243, "oacute"); /* Latin small letter o with acute */ + map.put((char)244, "ocirc"); /* Latin small letter o with circumflex */ + map.put((char)245, "otilde"); /* Latin small letter o with tilde */ + map.put((char)246, "ouml"); /* Latin small letter o with diaeresis */ + map.put((char)247, "divide"); /* division sign */ + map.put((char)248, "oslash"); /* Latin small letter o with stroke */ + map.put((char)249, "ugrave"); /* Latin small letter u with grave */ + map.put((char)250, "uacute"); /* Latin small letter u with acute */ + map.put((char)251, "ucirc"); /* Latin small letter u with circumflex */ + map.put((char)252, "uuml"); /* Latin small letter u with diaeresis */ + map.put((char)253, "yacute"); /* Latin small letter y with acute */ + map.put((char)254, "thorn"); /* Latin small letter thorn */ + map.put((char)255, "yuml"); /* Latin small letter y with diaeresis */ + map.put((char)338, "OElig"); /* Latin capital ligature oe */ + map.put((char)339, "oelig"); /* Latin small ligature oe */ + map.put((char)352, "Scaron"); /* Latin capital letter s with caron */ + map.put((char)353, "scaron"); /* Latin small letter s with caron */ + map.put((char)376, "Yuml"); /* Latin capital letter y with diaeresis */ + map.put((char)402, "fnof"); /* Latin small letter f with hook */ + map.put((char)710, "circ"); /* modifier letter circumflex accent */ + map.put((char)732, "tilde"); /* small tilde */ + map.put((char)913, "Alpha"); /* Greek capital letter alpha */ + map.put((char)914, "Beta"); /* Greek capital letter beta */ + map.put((char)915, "Gamma"); /* Greek capital letter gamma */ + map.put((char)916, "Delta"); /* Greek capital letter delta */ + map.put((char)917, "Epsilon"); /* Greek capital letter epsilon */ + map.put((char)918, "Zeta"); /* Greek capital letter zeta */ + map.put((char)919, "Eta"); /* Greek capital letter eta */ + map.put((char)920, "Theta"); /* Greek capital letter theta */ + map.put((char)921, "Iota"); /* Greek capital letter iota */ + map.put((char)922, "Kappa"); /* Greek capital letter kappa */ + map.put((char)923, "Lambda"); /* Greek capital letter lambda */ + map.put((char)924, "Mu"); /* Greek capital letter mu */ + map.put((char)925, "Nu"); /* Greek capital letter nu */ + map.put((char)926, "Xi"); /* Greek capital letter xi */ + map.put((char)927, "Omicron"); /* Greek capital letter omicron */ + map.put((char)928, "Pi"); /* Greek capital letter pi */ + map.put((char)929, "Rho"); /* Greek capital letter rho */ + map.put((char)931, "Sigma"); /* Greek capital letter sigma */ + map.put((char)932, "Tau"); /* Greek capital letter tau */ + map.put((char)933, "Upsilon"); /* Greek capital letter upsilon */ + map.put((char)934, "Phi"); /* Greek capital letter phi */ + map.put((char)935, "Chi"); /* Greek capital letter chi */ + map.put((char)936, "Psi"); /* Greek capital letter psi */ + map.put((char)937, "Omega"); /* Greek capital letter omega */ + map.put((char)945, "alpha"); /* Greek small letter alpha */ + map.put((char)946, "beta"); /* Greek small letter beta */ + map.put((char)947, "gamma"); /* Greek small letter gamma */ + map.put((char)948, "delta"); /* Greek small letter delta */ + map.put((char)949, "epsilon"); /* Greek small letter epsilon */ + map.put((char)950, "zeta"); /* Greek small letter zeta */ + map.put((char)951, "eta"); /* Greek small letter eta */ + map.put((char)952, "theta"); /* Greek small letter theta */ + map.put((char)953, "iota"); /* Greek small letter iota */ + map.put((char)954, "kappa"); /* Greek small letter kappa */ + map.put((char)955, "lambda"); /* Greek small letter lambda */ + map.put((char)956, "mu"); /* Greek small letter mu */ + map.put((char)957, "nu"); /* Greek small letter nu */ + map.put((char)958, "xi"); /* Greek small letter xi */ + map.put((char)959, "omicron"); /* Greek small letter omicron */ + map.put((char)960, "pi"); /* Greek small letter pi */ + map.put((char)961, "rho"); /* Greek small letter rho */ + map.put((char)962, "sigmaf"); /* Greek small letter final sigma */ + map.put((char)963, "sigma"); /* Greek small letter sigma */ + map.put((char)964, "tau"); /* Greek small letter tau */ + map.put((char)965, "upsilon"); /* Greek small letter upsilon */ + map.put((char)966, "phi"); /* Greek small letter phi */ + map.put((char)967, "chi"); /* Greek small letter chi */ + map.put((char)968, "psi"); /* Greek small letter psi */ + map.put((char)969, "omega"); /* Greek small letter omega */ + map.put((char)977, "thetasym"); /* Greek theta symbol */ + map.put((char)978, "upsih"); /* Greek upsilon with hook symbol */ + map.put((char)982, "piv"); /* Greek pi symbol */ + map.put((char)8194, "ensp"); /* en space */ + map.put((char)8195, "emsp"); /* em space */ + map.put((char)8201, "thinsp"); /* thin space */ + map.put((char)8204, "zwnj"); /* zero width non-joiner */ + map.put((char)8205, "zwj"); /* zero width joiner */ + map.put((char)8206, "lrm"); /* left-to-right mark */ + map.put((char)8207, "rlm"); /* right-to-left mark */ + map.put((char)8211, "ndash"); /* en dash */ + map.put((char)8212, "mdash"); /* em dash */ + map.put((char)8216, "lsquo"); /* left single quotation mark */ + map.put((char)8217, "rsquo"); /* right single quotation mark */ + map.put((char)8218, "sbquo"); /* single low-9 quotation mark */ + map.put((char)8220, "ldquo"); /* left double quotation mark */ + map.put((char)8221, "rdquo"); /* right double quotation mark */ + map.put((char)8222, "bdquo"); /* double low-9 quotation mark */ + map.put((char)8224, "dagger"); /* dagger */ + map.put((char)8225, "Dagger"); /* double dagger */ + map.put((char)8226, "bull"); /* bullet */ + map.put((char)8230, "hellip"); /* horizontal ellipsis */ + map.put((char)8240, "permil"); /* per mille sign */ + map.put((char)8242, "prime"); /* prime */ + map.put((char)8243, "Prime"); /* double prime */ + map.put((char)8249, "lsaquo"); /* single left-pointing angle quotation mark */ + map.put((char)8250, "rsaquo"); /* single right-pointing angle quotation mark */ + map.put((char)8254, "oline"); /* overline */ + map.put((char)8260, "frasl"); /* fraction slash */ + map.put((char)8364, "euro"); /* euro sign */ + map.put((char)8465, "image"); /* black-letter capital i */ + map.put((char)8472, "weierp"); /* script capital pXCOMMAX Weierstrass p */ + map.put((char)8476, "real"); /* black-letter capital r */ + map.put((char)8482, "trade"); /* trademark sign */ + map.put((char)8501, "alefsym"); /* alef symbol */ + map.put((char)8592, "larr"); /* leftwards arrow */ + map.put((char)8593, "uarr"); /* upwards arrow */ + map.put((char)8594, "rarr"); /* rightwards arrow */ + map.put((char)8595, "darr"); /* downwards arrow */ + map.put((char)8596, "harr"); /* left right arrow */ + map.put((char)8629, "crarr"); /* downwards arrow with corner leftwards */ + map.put((char)8656, "lArr"); /* leftwards double arrow */ + map.put((char)8657, "uArr"); /* upwards double arrow */ + map.put((char)8658, "rArr"); /* rightwards double arrow */ + map.put((char)8659, "dArr"); /* downwards double arrow */ + map.put((char)8660, "hArr"); /* left right double arrow */ + map.put((char)8704, "forall"); /* for all */ + map.put((char)8706, "part"); /* partial differential */ + map.put((char)8707, "exist"); /* there exists */ + map.put((char)8709, "empty"); /* empty set */ + map.put((char)8711, "nabla"); /* nabla */ + map.put((char)8712, "isin"); /* element of */ + map.put((char)8713, "notin"); /* not an element of */ + map.put((char)8715, "ni"); /* contains as member */ + map.put((char)8719, "prod"); /* n-ary product */ + map.put((char)8721, "sum"); /* n-ary summation */ + map.put((char)8722, "minus"); /* minus sign */ + map.put((char)8727, "lowast"); /* asterisk operator */ + map.put((char)8730, "radic"); /* square root */ + map.put((char)8733, "prop"); /* proportional to */ + map.put((char)8734, "infin"); /* infinity */ + map.put((char)8736, "ang"); /* angle */ + map.put((char)8743, "and"); /* logical and */ + map.put((char)8744, "or"); /* logical or */ + map.put((char)8745, "cap"); /* intersection */ + map.put((char)8746, "cup"); /* union */ + map.put((char)8747, "int"); /* integral */ + map.put((char)8756, "there4"); /* therefore */ + map.put((char)8764, "sim"); /* tilde operator */ + map.put((char)8773, "cong"); /* congruent to */ + map.put((char)8776, "asymp"); /* almost equal to */ + map.put((char)8800, "ne"); /* not equal to */ + map.put((char)8801, "equiv"); /* identical toXCOMMAX equivalent to */ + map.put((char)8804, "le"); /* less-than or equal to */ + map.put((char)8805, "ge"); /* greater-than or equal to */ + map.put((char)8834, "sub"); /* subset of */ + map.put((char)8835, "sup"); /* superset of */ + map.put((char)8836, "nsub"); /* not a subset of */ + map.put((char)8838, "sube"); /* subset of or equal to */ + map.put((char)8839, "supe"); /* superset of or equal to */ + map.put((char)8853, "oplus"); /* circled plus */ + map.put((char)8855, "otimes"); /* circled times */ + map.put((char)8869, "perp"); /* up tack */ + map.put((char)8901, "sdot"); /* dot operator */ + map.put((char)8968, "lceil"); /* left ceiling */ + map.put((char)8969, "rceil"); /* right ceiling */ + map.put((char)8970, "lfloor"); /* left floor */ + map.put((char)8971, "rfloor"); /* right floor */ + map.put((char)9001, "lang"); /* left-pointing angle bracket */ + map.put((char)9002, "rang"); /* right-pointing angle bracket */ + map.put((char)9674, "loz"); /* lozenge */ + map.put((char)9824, "spades"); /* black spade suit */ + map.put((char)9827, "clubs"); /* black club suit */ + map.put((char)9829, "hearts"); /* black heart suit */ + map.put((char)9830, "diams"); /* black diamond suit */ + + return Collections.unmodifiableMap(map); + } + + /** + * Build a unmodifiable Trie from entitiy Name to Character + * @return Unmodifiable trie. + */ + private static synchronized Trie mkEntityToCharacterTrie() + { + Trie trie = new HashTrie(); + + for(Map.Entry entry : characterToEntityMap.entrySet()) + trie.put(entry.getValue(),entry.getKey()); + return Trie.Util.unmodifiable(trie); + } +} From 524950f2eaa65dbadd1583c2ed84e14b921893e7 Mon Sep 17 00:00:00 2001 From: Matt Seil Date: Mon, 7 Aug 2017 19:51:26 -0700 Subject: [PATCH 445/812] Issue #300 -- Brought back a slightly modified version of the old HTMLEntityCodec for backwards compatability purposes. --- .../java/org/owasp/esapi/codecs/LegacyHTMLEntityCodec.java | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/src/main/java/org/owasp/esapi/codecs/LegacyHTMLEntityCodec.java b/src/main/java/org/owasp/esapi/codecs/LegacyHTMLEntityCodec.java index e35296b62..57e5cb6b8 100644 --- a/src/main/java/org/owasp/esapi/codecs/LegacyHTMLEntityCodec.java +++ b/src/main/java/org/owasp/esapi/codecs/LegacyHTMLEntityCodec.java @@ -20,6 +20,12 @@ import java.util.Map; /** + * + * This class is DEPRECATED. It did not correctly handle encoding of non-BMP + * unicode code points. This class is provided solely for any fatal bugs + * not accounted for in the new version and will be removed entirely in + * a future release. + * * Implementation of the Codec interface for HTML entity encoding. * * @author Jeff Williams (jeff.williams .at. aspectsecurity.com) Date: Mon, 7 Aug 2017 23:22:53 -0700 Subject: [PATCH 446/812] Issue #300 -- Addressed a review comment. --- src/main/java/org/owasp/esapi/codecs/AbstractCodec.java | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/src/main/java/org/owasp/esapi/codecs/AbstractCodec.java b/src/main/java/org/owasp/esapi/codecs/AbstractCodec.java index 236125497..99188bc1b 100644 --- a/src/main/java/org/owasp/esapi/codecs/AbstractCodec.java +++ b/src/main/java/org/owasp/esapi/codecs/AbstractCodec.java @@ -121,9 +121,11 @@ public String getHexForNonAlphanumeric(char c) */ public String getHexForNonAlphanumeric(int c) { - if(c<0xFF) + if(c<0xFF){ return hex[c]; - return toHex(c); + }else{ + return toHex(c); + } } public String toOctal(char c) From 4c92b64ca3d64ca7b8801f52203689315ec803a6 Mon Sep 17 00:00:00 2001 From: Matt Seil Date: Tue, 8 Aug 2017 22:50:15 -0700 Subject: [PATCH 447/812] Issue #300 -- Added OWASP file headers, and did some lexical cleanup on if statements. --- .../esapi/codecs/AbstractCharacterCodec.java | 26 +++++++ .../org/owasp/esapi/codecs/AbstractCodec.java | 6 +- .../esapi/codecs/AbstractIntegerCodec.java | 28 +++++++ .../codecs/AbstractPushbackSequence.java | 29 ++++++++ .../java/org/owasp/esapi/codecs/Codec.java | 3 + .../owasp/esapi/codecs/HTMLEntityCodec.java | 11 ++- .../owasp/esapi/codecs/PushbackSequence.java | 18 ++++- .../owasp/esapi/codecs/PushbackString.java | 73 +++++++++++++------ 8 files changed, 164 insertions(+), 30 deletions(-) diff --git a/src/main/java/org/owasp/esapi/codecs/AbstractCharacterCodec.java b/src/main/java/org/owasp/esapi/codecs/AbstractCharacterCodec.java index 5868d2bc0..ed73e4bd9 100644 --- a/src/main/java/org/owasp/esapi/codecs/AbstractCharacterCodec.java +++ b/src/main/java/org/owasp/esapi/codecs/AbstractCharacterCodec.java @@ -1,5 +1,31 @@ +/** + * OWASP Enterprise Security API (ESAPI) + * + * This file is part of the Open Web Application Security Project (OWASP) + * Enterprise Security API (ESAPI) project. For details, please see + * http://www.owasp.org/index.php/ESAPI. + * + * Copyright (c) 2017 - The OWASP Foundation + * + * The ESAPI is published by OWASP under the BSD license. You should read and accept the + * LICENSE before you use, modify, and/or redistribute this software. + * + * @author Matt Seil (mseil .at. owasp.org) + * @created 2017 + * + * @author Jeff Williams (jeff.williams .at. aspectsecurity.com) Aspect Security + * @created 2007 + */ + package org.owasp.esapi.codecs; +/** + * + * This abstract Impl is broken off from the original {@code Codec} class and + * provides the {@code Character} parsing logic that has been with ESAPI from the beginning. + * + */ public abstract class AbstractCharacterCodec extends AbstractCodec { /* (non-Javadoc) * @see org.owasp.esapi.codecs.Codec#decode(java.lang.String) diff --git a/src/main/java/org/owasp/esapi/codecs/AbstractCodec.java b/src/main/java/org/owasp/esapi/codecs/AbstractCodec.java index 99188bc1b..d6ee5ffcf 100644 --- a/src/main/java/org/owasp/esapi/codecs/AbstractCodec.java +++ b/src/main/java/org/owasp/esapi/codecs/AbstractCodec.java @@ -5,13 +5,13 @@ * Enterprise Security API (ESAPI) project. For details, please see * http://www.owasp.org/index.php/ESAPI. * - * Copyright (c) 2007 - The OWASP Foundation + * Copyright (c) 2017 - The OWASP Foundation * * The ESAPI is published by OWASP under the BSD license. You should read and accept the * LICENSE before you use, modify, and/or redistribute this software. * - * @author Jeff Williams Aspect Security - * @created 2007 + * @author Matt Seil (mseil .at. owasp.org) + * @created 2017 */ package org.owasp.esapi.codecs; diff --git a/src/main/java/org/owasp/esapi/codecs/AbstractIntegerCodec.java b/src/main/java/org/owasp/esapi/codecs/AbstractIntegerCodec.java index f43891481..6e6a9c1a9 100644 --- a/src/main/java/org/owasp/esapi/codecs/AbstractIntegerCodec.java +++ b/src/main/java/org/owasp/esapi/codecs/AbstractIntegerCodec.java @@ -1,5 +1,33 @@ +/** + * OWASP Enterprise Security API (ESAPI) + * + * This file is part of the Open Web Application Security Project (OWASP) + * Enterprise Security API (ESAPI) project. For details, please see + * http://www.owasp.org/index.php/ESAPI. + * + * Copyright (c) 2017 - The OWASP Foundation + * + * The ESAPI is published by OWASP under the BSD license. You should read and accept the + * LICENSE before you use, modify, and/or redistribute this software. + * + * @author Matt Seil (mseil .at. owasp.org) + * @created 2017 + * + * @author Jeff Williams (jeff.williams .at. aspectsecurity.com) Aspect Security + * @created 2007 + */ package org.owasp.esapi.codecs; +/** + * This class is intended to be an alternative Abstract Implementation for parsing encoding + * data by focusing on {@code int} as opposed to {@code Character}. Because non-BMP code + * points cannot be represented by a {@code char}, this class remedies that by parsing string + * data as codePoints as opposed to a stream of {@code char}s. + * + * @author Matt Seil (mseil .at. owasp.org) + * @Created 2017 -- Adapted from Jeff Williams' original {@code Codec} class. + */ public class AbstractIntegerCodec extends AbstractCodec { /** diff --git a/src/main/java/org/owasp/esapi/codecs/AbstractPushbackSequence.java b/src/main/java/org/owasp/esapi/codecs/AbstractPushbackSequence.java index ee35478c3..bf9f78a8e 100644 --- a/src/main/java/org/owasp/esapi/codecs/AbstractPushbackSequence.java +++ b/src/main/java/org/owasp/esapi/codecs/AbstractPushbackSequence.java @@ -1,5 +1,34 @@ +/** + * OWASP Enterprise Security API (ESAPI) + * + * This file is part of the Open Web Application Security Project (OWASP) + * Enterprise Security API (ESAPI) project. For details, please see + * http://www.owasp.org/index.php/ESAPI. + * + * Copyright (c) 2017 - The OWASP Foundation + * + * The ESAPI is published by OWASP under the BSD license. You should read and accept the + * LICENSE before you use, modify, and/or redistribute this software. + * + * @author Matt Seil (mseil .at. owasp.org) + * @created 2017 + * + */ + package org.owasp.esapi.codecs; +/** + * + * This Abstract class provides the generic logic for using a {@code PushbackSequence} + * in regards to iterating strings. The final Impl is intended for the user to supply + * a type {@code T} such that the pushback interface can be utilized for sequences + * of type {@code T}. Presently this generic class is limited by the fact that + * @{code input} is a {@code String}. + * + * @author Matt Seil + * + * @param + */ public abstract class AbstractPushbackSequence implements PushbackSequence { protected String input; protected T pushback; diff --git a/src/main/java/org/owasp/esapi/codecs/Codec.java b/src/main/java/org/owasp/esapi/codecs/Codec.java index c205d1b3f..5e914a4a0 100644 --- a/src/main/java/org/owasp/esapi/codecs/Codec.java +++ b/src/main/java/org/owasp/esapi/codecs/Codec.java @@ -26,6 +26,9 @@ * @author Jeff Williams (jeff.williams .at. aspectsecurity.com) Aspect Security * @since June 1, 2007 + * + * @author Matt Seil (mseil .at. owasp.org) + * @since June 1, 2017 * @see org.owasp.esapi.Encoder */ public interface Codec { diff --git a/src/main/java/org/owasp/esapi/codecs/HTMLEntityCodec.java b/src/main/java/org/owasp/esapi/codecs/HTMLEntityCodec.java index 14564372f..fd2c866cc 100644 --- a/src/main/java/org/owasp/esapi/codecs/HTMLEntityCodec.java +++ b/src/main/java/org/owasp/esapi/codecs/HTMLEntityCodec.java @@ -5,12 +5,16 @@ * Enterprise Security API (ESAPI) project. For details, please see * http://www.owasp.org/index.php/ESAPI. * - * Copyright (c) 2007 - The OWASP Foundation + * Copyright (c) 2017 - The OWASP Foundation * * The ESAPI is published by OWASP under the BSD license. You should read and accept the * LICENSE before you use, modify, and/or redistribute this software. * - * @author Jeff Williams Aspect Security + * @author Matt Seil (mseil .at. owasp.org) + * @created 2017 + * + * @author Jeff Williams (jeff.williams .at. aspectsecurity.com) Aspect Security * @created 2007 */ package org.owasp.esapi.codecs; @@ -26,6 +30,9 @@ * @author Jeff Williams (jeff.williams .at. aspectsecurity.com) Aspect Security * @since June 1, 2007 + * + * @author Matt Seil (mseil .at. owasp.org) (mseil .at. owasp.org) + * * @see org.owasp.esapi.Encoder */ public class HTMLEntityCodec extends AbstractIntegerCodec diff --git a/src/main/java/org/owasp/esapi/codecs/PushbackSequence.java b/src/main/java/org/owasp/esapi/codecs/PushbackSequence.java index 5588ca91f..bcdbff635 100644 --- a/src/main/java/org/owasp/esapi/codecs/PushbackSequence.java +++ b/src/main/java/org/owasp/esapi/codecs/PushbackSequence.java @@ -1,3 +1,19 @@ +/** + * OWASP Enterprise Security API (ESAPI) + * + * This file is part of the Open Web Application Security Project (OWASP) + * Enterprise Security API (ESAPI) project. For details, please see + * http://www.owasp.org/index.php/ESAPI. + * + * Copyright (c) 2017 - The OWASP Foundation + * + * The ESAPI is published by OWASP under the BSD license. You should read and accept the + * LICENSE before you use, modify, and/or redistribute this software. + * + * @author Matt Seil (mseil .at. owasp.org) + * @created 2017 + * + */ package org.owasp.esapi.codecs; public interface PushbackSequence { @@ -10,7 +26,7 @@ public interface PushbackSequence { /** * Get the current index of the PushbackString. Typically used in error messages. - * @return The current index of the PushbackString. + * @return The current index of the PushbackSequence. */ int index(); diff --git a/src/main/java/org/owasp/esapi/codecs/PushbackString.java b/src/main/java/org/owasp/esapi/codecs/PushbackString.java index 4255045f9..103993c05 100644 --- a/src/main/java/org/owasp/esapi/codecs/PushbackString.java +++ b/src/main/java/org/owasp/esapi/codecs/PushbackString.java @@ -5,12 +5,16 @@ * Enterprise Security API (ESAPI) project. For details, please see * http://www.owasp.org/index.php/ESAPI. * - * Copyright (c) 2007 - The OWASP Foundation + * Copyright (c) 2017 - The OWASP Foundation * * The ESAPI is published by OWASP under the BSD license. You should read and accept the * LICENSE before you use, modify, and/or redistribute this software. * - * @author Jeff Williams Aspect Security + * @author Matt Seil (mseil .at. owasp.org) + * @updated 2017 + * + * @author Jeff Williams (jeff.williams .at. aspectsecurity.com) Aspect Security * @created 2007 */ package org.owasp.esapi.codecs; @@ -25,7 +29,7 @@ * @since June 1, 2007 * @see org.owasp.esapi.Encoder */ -public class PushbackString extends AbstractPushbackSequence{ +public class PushbackString extends AbstractPushbackSequence { /** * * @param input @@ -49,14 +53,18 @@ public int index() { * @see org.owasp.esapi.codecs.PushbackSequence#hasNext() */ public boolean hasNext() { - if (pushback != null) + if (pushback != null){ return true; - if (input == null) + } + if (input == null){ return false; - if (input.length() == 0) + } + if (input.length() == 0){ return false; - if (index >= input.length()) + } + if (index >= input.length()){ return false; + } return true; } @@ -71,12 +79,15 @@ public Character next() { pushback = null; return save; } - if (input == null) + if (input == null){ return null; - if (input.length() == 0) + } + if (input.length() == 0){ return null; - if (index >= input.length()) + } + if (index >= input.length()){ return null; + } return Character.valueOf(input.charAt(index++)); } @@ -87,10 +98,12 @@ public Character next() { */ public Character nextHex() { Character c = next(); - if (c == null) + if (c == null){ return null; - if (isHexDigit(c)) + } + if (isHexDigit(c)){ return c; + } return null; } @@ -101,10 +114,12 @@ public Character nextHex() { */ public Character nextOctal() { Character c = next(); - if (c == null) + if (c == null){ return null; - if (isOctalDigit(c)) + } + if (isOctalDigit(c)){ return c; + } return null; } @@ -116,8 +131,9 @@ public Character nextOctal() { * @return */ public static boolean isHexDigit(Character c) { - if (c == null) + if (c == null){ return false; + } char ch = c.charValue(); return (ch >= '0' && ch <= '9') || (ch >= 'a' && ch <= 'f') || (ch >= 'A' && ch <= 'F'); } @@ -129,8 +145,9 @@ public static boolean isHexDigit(Character c) { * @return */ public static boolean isOctalDigit(Character c) { - if (c == null) + if (c == null){ return false; + } char ch = c.charValue(); return ch >= '0' && ch <= '7'; } @@ -141,14 +158,18 @@ public static boolean isOctalDigit(Character c) { * @see org.owasp.esapi.codecs.PushbackSequence#peek() */ public Character peek() { - if (pushback != null) + if (pushback != null){ return pushback; - if (input == null) + } + if (input == null){ return null; - if (input.length() == 0) + } + if (input.length() == 0){ return null; - if (index >= input.length()) + } + if (index >= input.length()){ return null; + } return Character.valueOf(input.charAt(index)); } @@ -158,14 +179,18 @@ public Character peek() { * @see org.owasp.esapi.codecs.PushbackSequence#peek(char) */ public boolean peek(Character c) { - if (pushback != null && pushback.charValue() == c) + if (pushback != null && pushback.charValue() == c){ return true; - if (input == null) + } + if (input == null){ return false; - if (input.length() == 0) + } + if (input.length() == 0){ return false; - if (index >= input.length()) + } + if (index >= input.length()){ return false; + } return input.charAt(index) == c; } From 039040686faeeed649b1ed544417731dddc08aaa Mon Sep 17 00:00:00 2001 From: Matt Seil Date: Thu, 10 Aug 2017 00:09:18 -0700 Subject: [PATCH 448/812] Issue #300 -- implemented HTMLEntityCodec and affected unit tests. --- src/main/java/org/owasp/esapi/codecs/AbstractCodec.java | 6 +++++- .../java/org/owasp/esapi/codecs/AbstractIntegerCodec.java | 5 ++--- src/main/java/org/owasp/esapi/codecs/HTMLEntityCodec.java | 5 +++-- 3 files changed, 10 insertions(+), 6 deletions(-) diff --git a/src/main/java/org/owasp/esapi/codecs/AbstractCodec.java b/src/main/java/org/owasp/esapi/codecs/AbstractCodec.java index d6ee5ffcf..2a71c1b1c 100644 --- a/src/main/java/org/owasp/esapi/codecs/AbstractCodec.java +++ b/src/main/java/org/owasp/esapi/codecs/AbstractCodec.java @@ -87,7 +87,11 @@ public String encodeCharacter( char[] immune, Character c ) { */ @Override public String encodeCharacter( char[] immune, int codePoint ) { - return new StringBuilder().appendCodePoint(codePoint).toString(); + String rval = ""; + if(Character.isValidCodePoint(codePoint)){ + rval = new StringBuilder().appendCodePoint(codePoint).toString(); + } + return rval; } diff --git a/src/main/java/org/owasp/esapi/codecs/AbstractIntegerCodec.java b/src/main/java/org/owasp/esapi/codecs/AbstractIntegerCodec.java index 6e6a9c1a9..61dadbc76 100644 --- a/src/main/java/org/owasp/esapi/codecs/AbstractIntegerCodec.java +++ b/src/main/java/org/owasp/esapi/codecs/AbstractIntegerCodec.java @@ -39,10 +39,9 @@ public String decode(String input) { PushbackSequence pbs = new PushBackSequenceImpl(input); while (pbs.hasNext()) { Integer c = decodeCharacter(pbs); - if (c != null) { + boolean isValid = Character.isValidCodePoint(c); + if (c != null && isValid) { sb.appendCodePoint(c); - } else { - sb.appendCodePoint(pbs.next()); } } return sb.toString(); diff --git a/src/main/java/org/owasp/esapi/codecs/HTMLEntityCodec.java b/src/main/java/org/owasp/esapi/codecs/HTMLEntityCodec.java index fd2c866cc..3976d9e14 100644 --- a/src/main/java/org/owasp/esapi/codecs/HTMLEntityCodec.java +++ b/src/main/java/org/owasp/esapi/codecs/HTMLEntityCodec.java @@ -203,7 +203,7 @@ private Integer parseNumber( PushbackSequence input ) { Integer c = input.peek(); // if character is a digit then add it on and keep going - if ( Character.isDigit( c ) ) { + if ( Character.isDigit( c ) && Character.isValidCodePoint(c) ) { sb.appendCodePoint( c ); input.next(); @@ -243,6 +243,7 @@ private Integer parseHex( PushbackSequence input ) { Integer c = input.peek(); // if character is a hex digit then add it on and keep going + //This statement implicitly tests for Character.isValidCodePoint(int) if ( "0123456789ABCDEFabcdef".indexOf(c) != -1 ) { sb.appendCodePoint( c ); input.next(); @@ -295,7 +296,7 @@ private Integer getNamedEntity( PushbackSequence input ) { len = Math.min(input.remainder().length(), entityToCharacterTrie.getMaxKeyLength()); for(int i=0;i Date: Thu, 10 Aug 2017 19:57:35 -0700 Subject: [PATCH 449/812] Issue #300 -- Added test cases with mixed BMP and non BMP data. --- .../org/owasp/esapi/codecs/AbstractCodec.java | 4 + .../esapi/codecs/AbstractIntegerCodec.java | 4 +- .../owasp/esapi/codecs/HTMLEntityCodec.java | 80 ++++++++----------- .../owasp/esapi/codecs/AbstractCodecTest.java | 16 ++-- .../esapi/codecs/HTMLEntityCodecTest.java | 25 ++++++ .../owasp/esapi/reference/EncoderTest.java | 3 +- 6 files changed, 76 insertions(+), 56 deletions(-) diff --git a/src/main/java/org/owasp/esapi/codecs/AbstractCodec.java b/src/main/java/org/owasp/esapi/codecs/AbstractCodec.java index 2a71c1b1c..b9c0ac6c7 100644 --- a/src/main/java/org/owasp/esapi/codecs/AbstractCodec.java +++ b/src/main/java/org/owasp/esapi/codecs/AbstractCodec.java @@ -82,6 +82,10 @@ public String encodeCharacter( char[] immune, Character c ) { return ""+c; } + public String encodeCharacter(char[] immune, char c){ + throw new IllegalArgumentException("You tried to call encodeCharacter with a char. Nope. Use Character instead!"); + } + /* (non-Javadoc) * @see org.owasp.esapi.codecs.Codec#encodeCharacter(char[], int) */ diff --git a/src/main/java/org/owasp/esapi/codecs/AbstractIntegerCodec.java b/src/main/java/org/owasp/esapi/codecs/AbstractIntegerCodec.java index 61dadbc76..635f2f1e0 100644 --- a/src/main/java/org/owasp/esapi/codecs/AbstractIntegerCodec.java +++ b/src/main/java/org/owasp/esapi/codecs/AbstractIntegerCodec.java @@ -39,9 +39,11 @@ public String decode(String input) { PushbackSequence pbs = new PushBackSequenceImpl(input); while (pbs.hasNext()) { Integer c = decodeCharacter(pbs); - boolean isValid = Character.isValidCodePoint(c); + boolean isValid = null == c ? false:Character.isValidCodePoint(c); if (c != null && isValid) { sb.appendCodePoint(c); + }else{ + sb.appendCodePoint(pbs.next()); } } return sb.toString(); diff --git a/src/main/java/org/owasp/esapi/codecs/HTMLEntityCodec.java b/src/main/java/org/owasp/esapi/codecs/HTMLEntityCodec.java index 3976d9e14..ee7139450 100644 --- a/src/main/java/org/owasp/esapi/codecs/HTMLEntityCodec.java +++ b/src/main/java/org/owasp/esapi/codecs/HTMLEntityCodec.java @@ -50,34 +50,56 @@ public class HTMLEntityCodec extends AbstractIntegerCodec public HTMLEntityCodec() { } + /** + * Overrides the AbstractImpl to keep this code performing entirely at the {@code int} + * level. + */ + @Override + public String encode(char[] immune, String input) { + StringBuilder sb = new StringBuilder(); + for(int offset = 0; offset < input.length(); ){ + final int point = input.codePointAt(offset); + if(Character.isValidCodePoint(point)){ + sb.append(encodeCharacter(immune, point)); + } + offset += Character.charCount(point); + } + return sb.toString(); + } + /** * {@inheritDoc} * - * Encodes a Character for safe use in an HTML entity field. + * Encodes a codePoint for safe use in an HTML entity field. * @param immune */ - public String encodeCharacter( char[] immune, Character c ) { + @Override + public String encodeCharacter( char[] immune, int codePoint ) { // check for immune characters - if ( containsCharacter(c, immune ) ) { - return ""+c; + // Cast the codePoint to a char because we want to limit immunity to the BMP field only. + if ( containsCharacter( (char) codePoint, immune ) && Character.isValidCodePoint(codePoint)) { + return new StringBuilder().appendCodePoint(codePoint).toString(); } // check for alphanumeric characters - String hex = super.getHexForNonAlphanumeric(c); - if ( hex == null ) { - return ""+c; + String hex = super.getHexForNonAlphanumeric(codePoint); + if ( hex == null && Character.isValidCodePoint(codePoint)) { + return new StringBuilder().appendCodePoint(codePoint).toString(); } - // check for illegal characters - if ( ( c <= 0x1f && c != '\t' && c != '\n' && c != '\r' ) || ( c >= 0x7f && c <= 0x9f ) ) + if ( ( codePoint <= 0x1f + && codePoint != '\t' + && codePoint != '\n' + && codePoint != '\r' ) + || ( codePoint >= 0x7f && codePoint <= 0x9f ) ) { hex = REPLACEMENT_HEX; // Let's entity encode this instead of returning it - c = REPLACEMENT_CHAR; + codePoint = REPLACEMENT_CHAR; } // check if there's a defined entity - String entityName = (String) characterToEntityMap.get(Integer.valueOf(c)); + String entityName = (String) characterToEntityMap.get(codePoint); if (entityName != null) { return "&" + entityName + ";"; } @@ -86,42 +108,6 @@ public String encodeCharacter( char[] immune, Character c ) { return "&#x" + hex + ";"; } - /** - * {@inheritDoc} - * - * Encodes a Character for safe use in an HTML entity field. - * @param immune - */ - public String encodeCharacter( char[] immune, int codePoint ) { - - // check for immune characters -// if ( containsCharacter(codePoint, immune ) ) { -// return ""+codePoint; -// } - -// // check for alphanumeric characters - String hex = super.getHexForNonAlphanumeric(codePoint); -// if ( hex == null ) { -// return ""+c; -// } -// -// // check for illegal characters -// if ( ( c <= 0x1f && c != '\t' && c != '\n' && c != '\r' ) || ( c >= 0x7f && c <= 0x9f ) ) -// { -// hex = REPLACEMENT_HEX; // Let's entity encode this instead of returning it -// c = REPLACEMENT_CHAR; -// } -// -// // check if there's a defined entity -// String entityName = (String) characterToEntityMap.get(c); -// if (entityName != null) { -// return "&" + entityName + ";"; -// } - - // return the hex entity as suggested in the spec - return "&#x" + hex + ";"; - } - /** * {@inheritDoc} * diff --git a/src/test/java/org/owasp/esapi/codecs/AbstractCodecTest.java b/src/test/java/org/owasp/esapi/codecs/AbstractCodecTest.java index 1456058bd..813330ed6 100644 --- a/src/test/java/org/owasp/esapi/codecs/AbstractCodecTest.java +++ b/src/test/java/org/owasp/esapi/codecs/AbstractCodecTest.java @@ -137,7 +137,8 @@ public void testWindowsEncode() public void testHtmlEncodeChar() { - assertEquals( "<", htmlCodec.encodeCharacter(EMPTY_CHAR_ARRAY, LESS_THAN) ); + + assertEquals( "<", htmlCodec.encodeCharacter(EMPTY_CHAR_ARRAY, (int) LESS_THAN) ); } public void testHtmlEncodeChar0x100() @@ -146,12 +147,13 @@ public void testHtmlEncodeChar0x100() String inStr = Character.toString(in); String expected = "Ā"; String result; - - result = htmlCodec.encodeCharacter(EMPTY_CHAR_ARRAY, in); - // this should be escaped - assertFalse(inStr.equals(result)); - // UTF-8 encoded and then percent escaped - assertEquals(expected, result); + //The new default for HTMLEntityCodec is ints/Integers. Use Character/char at your own risk! + //Characters destroy non-BMP codepoints. This Codec is now supposed surpass that. + result = htmlCodec.encodeCharacter(EMPTY_CHAR_ARRAY, (int) in); + // this should be escaped + assertFalse(inStr.equals(result)); + // UTF-8 encoded and then percent escaped + assertEquals(expected, result); } public void testHtmlEncodeStr0x100() diff --git a/src/test/java/org/owasp/esapi/codecs/HTMLEntityCodecTest.java b/src/test/java/org/owasp/esapi/codecs/HTMLEntityCodecTest.java index bae3732dc..c81031692 100644 --- a/src/test/java/org/owasp/esapi/codecs/HTMLEntityCodecTest.java +++ b/src/test/java/org/owasp/esapi/codecs/HTMLEntityCodecTest.java @@ -23,4 +23,29 @@ public void test32BitCJK(){ assertEquals(false, expected.equals(bad)); assertEquals(expected, codec.encode(new char[0], s)); } + + @Test + public void test32BitCJKMixedWithBmp(){ + String s = "𡘾𦴩<𥻂"; + String expected = "𡘾𦴩<𥻂"; + String bad = "������"; + assertEquals(false, expected.equals(bad)); + assertEquals(expected, codec.encode(new char[0], s)); + } + + @Test + public void testDecodeforChars(){ + String s = "!@$%()=+{}[]"; + String expected = "!@$%()=+{}[]"; + assertEquals(expected, codec.decode(s)); + } + + @Test + public void testMixedBmpAndNonBmp(){ + String nonBMP = new String(new int[]{0x2f804}, 0, 1); + String bmp = "")); assertEquals("&lt;script&gt;", instance.encodeForHTML("<script>")); assertEquals("!@$%()=+{}[]", instance.encodeForHTML("!@$%()=+{}[]")); - assertEquals("!@$%()=+{}[]", instance.encodeForHTML(instance.canonicalize("!@$%()=+{}[]") ) ); + String canonicalized = instance.canonicalize("!@$%()=+{}[]"); + assertEquals("!@$%()=+{}[]", instance.encodeForHTML( canonicalized ) ); assertEquals(",.-_ ", instance.encodeForHTML(",.-_ ")); assertEquals("dir&", instance.encodeForHTML("dir&")); assertEquals("one&two", instance.encodeForHTML("one&two")); From 3f9d208d8fe4ff5b6a03f78112dec5a6a0a909eb Mon Sep 17 00:00:00 2001 From: Matt Seil Date: Thu, 10 Aug 2017 21:49:16 -0700 Subject: [PATCH 450/812] Issue #300 -- Added documentation warnings in regards to the destructive nature of the codecs on non-UTF data inserted into a string. --- .../java/org/owasp/esapi/codecs/AbstractCodec.java | 12 ++++++++++-- src/main/java/org/owasp/esapi/codecs/Codec.java | 3 ++- .../java/org/owasp/esapi/codecs/HTMLEntityCodec.java | 9 +++++++-- 3 files changed, 19 insertions(+), 5 deletions(-) diff --git a/src/main/java/org/owasp/esapi/codecs/AbstractCodec.java b/src/main/java/org/owasp/esapi/codecs/AbstractCodec.java index b9c0ac6c7..8660fb7a7 100644 --- a/src/main/java/org/owasp/esapi/codecs/AbstractCodec.java +++ b/src/main/java/org/owasp/esapi/codecs/AbstractCodec.java @@ -51,8 +51,16 @@ public AbstractCodec() { } } - /* (non-Javadoc) - * @see org.owasp.esapi.codecs.Codec#encode(char[], java.lang.String) + /** + * WARNING!! {@code Character} based Codecs will silently transform code points that are not + * legal UTF code points into garbage data as they will cast them to {@code char}s. + *

+ * If you are implementing an {@code Integer} based codec, these will be silently discarded + * based on the return from {@code Character.isValidCodePoint( int )}. This is the preferred + * behavior moving forward. + * + * + * {@inheritDoc} */ @Override public String encode(char[] immune, String input) { diff --git a/src/main/java/org/owasp/esapi/codecs/Codec.java b/src/main/java/org/owasp/esapi/codecs/Codec.java index 5e914a4a0..cd0b66f03 100644 --- a/src/main/java/org/owasp/esapi/codecs/Codec.java +++ b/src/main/java/org/owasp/esapi/codecs/Codec.java @@ -45,7 +45,8 @@ public interface Codec { /** * Default implementation that should be overridden in specific codecs. * - * @param immune + * @param immune + * array of chars to NOT encode. Use with caution. * @param c * the Character to encode * @return diff --git a/src/main/java/org/owasp/esapi/codecs/HTMLEntityCodec.java b/src/main/java/org/owasp/esapi/codecs/HTMLEntityCodec.java index ee7139450..984a02105 100644 --- a/src/main/java/org/owasp/esapi/codecs/HTMLEntityCodec.java +++ b/src/main/java/org/owasp/esapi/codecs/HTMLEntityCodec.java @@ -51,8 +51,13 @@ public HTMLEntityCodec() { } /** - * Overrides the AbstractImpl to keep this code performing entirely at the {@code int} - * level. + * Given an array of {@code char}, scan the input {@code String} and encode unsafe + * codePoints, except for codePoints passed into the {@code char} array. + *

+ * WARNING: This method will silently discard any code point per the + * call to {@code Character.isValidCodePoint( int )} method. + * + * {@inheritDoc} */ @Override public String encode(char[] immune, String input) { From 3ed0a2fa4dfe43c14bbb282c0662ed6d8bbf35bd Mon Sep 17 00:00:00 2001 From: Matt Seil Date: Thu, 10 Aug 2017 22:13:33 -0700 Subject: [PATCH 451/812] Issue #281 -- Updated unit tests with missing assertions. --- .../org/owasp/esapi/reference/SafeFileTest.java | 17 ++++++----------- 1 file changed, 6 insertions(+), 11 deletions(-) diff --git a/src/test/java/org/owasp/esapi/reference/SafeFileTest.java b/src/test/java/org/owasp/esapi/reference/SafeFileTest.java index a946bdc7c..f2acd589c 100644 --- a/src/test/java/org/owasp/esapi/reference/SafeFileTest.java +++ b/src/test/java/org/owasp/esapi/reference/SafeFileTest.java @@ -80,21 +80,17 @@ public void testEscapeCharactersInFilename() { } File sf = new File(testDir, "test^.file" ); - if ( sf.exists() ) { - System.out.println( " Injection allowed "+ sf.getAbsolutePath() ); - } else { - System.out.println( " Injection didn't work "+ sf.getAbsolutePath() ); - } + assertFalse("Injection didn't work " + sf.getAbsolutePath(), + sf.exists()); + assertTrue(" Injection allowed " + sf.getAbsolutePath(), sf.exists()); } public void testEscapeCharacterInDirectoryInjection() { System.out.println("testEscapeCharacterInDirectoryInjection"); File sf = new File(testDir, "test\\^.^.\\file"); - if ( sf.exists() ) { - System.out.println( " Injection allowed "+ sf.getAbsolutePath() ); - } else { - System.out.println( " Injection didn't work "+ sf.getAbsolutePath() ); - } + assertFalse(" Injection didn't work " + sf.getAbsolutePath(), + sf.exists()); + assertTrue(" Injection allowed " + sf.getAbsolutePath(), sf.exists()); } public void testJavaFileInjectionGood() throws ValidationException @@ -275,5 +271,4 @@ public void testCreateParentPercentNull() // expected } } - } From 98aaaa06cb7ba37f932c7db26cb967d92695d23f Mon Sep 17 00:00:00 2001 From: Matt Seil Date: Thu, 10 Aug 2017 22:20:00 -0700 Subject: [PATCH 452/812] Issue #278 -- Added default local to date test to avoid non-us unit test failures. --- src/test/java/org/owasp/esapi/reference/ValidatorTest.java | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/test/java/org/owasp/esapi/reference/ValidatorTest.java b/src/test/java/org/owasp/esapi/reference/ValidatorTest.java index f5a8fb330..8fb0a2e8a 100644 --- a/src/test/java/org/owasp/esapi/reference/ValidatorTest.java +++ b/src/test/java/org/owasp/esapi/reference/ValidatorTest.java @@ -142,7 +142,7 @@ public void testGetValidDate() throws Exception { // TODO: This test case fails due to an apparent bug in SimpleDateFormat // Note: This seems to be fixed in JDK 6. Will leave it commented out since // we only require JDK 5. -kww - instance.getValidDate("test", "June 32, 2008", DateFormat.getDateInstance(), false, errors); + instance.getValidDate("test", "June 32, 2008", DateFormat.getDateInstance(DateFormat.DEFAULT, Locale.US), false, errors); // assertEquals( 2, errors.size() ); } From c27d5e06cd11034cf2f5529da023b4d2ca43c72a Mon Sep 17 00:00:00 2001 From: Matt Seil Date: Fri, 11 Aug 2017 18:34:04 -0700 Subject: [PATCH 453/812] Issue #281 -- added windows escape char to blacklist in SafeFile to adhere to intended contract. --- src/main/java/org/owasp/esapi/SafeFile.java | 8 ++-- .../owasp/esapi/reference/SafeFileTest.java | 44 ++++++++++++------- 2 files changed, 33 insertions(+), 19 deletions(-) diff --git a/src/main/java/org/owasp/esapi/SafeFile.java b/src/main/java/org/owasp/esapi/SafeFile.java index 6a4f239c5..7df86bb38 100644 --- a/src/main/java/org/owasp/esapi/SafeFile.java +++ b/src/main/java/org/owasp/esapi/SafeFile.java @@ -32,8 +32,8 @@ public class SafeFile extends File { private static final long serialVersionUID = 1L; private static final Pattern PERCENTS_PAT = Pattern.compile("(%)([0-9a-fA-F])([0-9a-fA-F])"); - private static final Pattern FILE_BLACKLIST_PAT = Pattern.compile("([\\\\/:*?<>|])"); - private static final Pattern DIR_BLACKLIST_PAT = Pattern.compile("([*?<>|])"); + private static final Pattern FILE_BLACKLIST_PAT = Pattern.compile("([\\\\/:*?<>|^])"); + private static final Pattern DIR_BLACKLIST_PAT = Pattern.compile("([*?<>|^])"); public SafeFile(String path) throws ValidationException { super(path); @@ -62,12 +62,12 @@ public SafeFile(URI uri) throws ValidationException { private void doDirCheck(String path) throws ValidationException { Matcher m1 = DIR_BLACKLIST_PAT.matcher( path ); - if ( m1.find() ) { + if ( null != m1 && m1.find() ) { throw new ValidationException( "Invalid directory", "Directory path (" + path + ") contains illegal character: " + m1.group() ); } Matcher m2 = PERCENTS_PAT.matcher( path ); - if ( m2.find() ) { + if (null != m2 && m2.find() ) { throw new ValidationException( "Invalid directory", "Directory path (" + path + ") contains encoded characters: " + m2.group() ); } diff --git a/src/test/java/org/owasp/esapi/reference/SafeFileTest.java b/src/test/java/org/owasp/esapi/reference/SafeFileTest.java index f2acd589c..923b75ec0 100644 --- a/src/test/java/org/owasp/esapi/reference/SafeFileTest.java +++ b/src/test/java/org/owasp/esapi/reference/SafeFileTest.java @@ -16,19 +16,17 @@ package org.owasp.esapi.reference; import java.io.File; -import java.net.URI; -import java.net.URLDecoder; import java.util.Iterator; import java.util.Set; -import junit.framework.Test; -import junit.framework.TestCase; -import junit.framework.TestSuite; - import org.owasp.esapi.SafeFile; import org.owasp.esapi.errors.ValidationException; -import org.owasp.esapi.util.FileTestUtils; import org.owasp.esapi.util.CollectionsUtil; +import org.owasp.esapi.util.FileTestUtils; + +import junit.framework.Test; +import junit.framework.TestCase; +import junit.framework.TestSuite; /** * @author Jeff Williams (jeff.williams@aspectsecurity.com) @@ -79,18 +77,21 @@ public void testEscapeCharactersInFilename() { System.out.println( "File is there: " + tf ); } - File sf = new File(testDir, "test^.file" ); - assertFalse("Injection didn't work " + sf.getAbsolutePath(), - sf.exists()); - assertTrue(" Injection allowed " + sf.getAbsolutePath(), sf.exists()); + try { + File sf = new SafeFile(testDir, "test^.file" ); + } catch (ValidationException e) { + assertEquals("Invalid directory", e.getMessage()); + } + } public void testEscapeCharacterInDirectoryInjection() { System.out.println("testEscapeCharacterInDirectoryInjection"); - File sf = new File(testDir, "test\\^.^.\\file"); - assertFalse(" Injection didn't work " + sf.getAbsolutePath(), - sf.exists()); - assertTrue(" Injection allowed " + sf.getAbsolutePath(), sf.exists()); + try { + File sf = new SafeFile(testDir, "test\\^.^.\\file"); + } catch (ValidationException e) { + assertEquals("Invalid directory", e.getMessage()); + } } public void testJavaFileInjectionGood() throws ValidationException @@ -271,4 +272,17 @@ public void testCreateParentPercentNull() // expected } } + + public final void testSafeFileShouldAcceptEmptyPath() throws ValidationException + { + String filename = "hello.txt"; + //API dictates that NPE should be thrown. + try{ + SafeFile file = new SafeFile(filename); + }catch(NullPointerException npe){ + assertNotNull(npe); + } + + + } } From a663a4be2ff75b05e283e1365c8812c71d0570af Mon Sep 17 00:00:00 2001 From: Matt Seil Date: Thu, 17 Aug 2017 17:03:45 -0700 Subject: [PATCH 454/812] Catching up ESAPI.properties prod and test version. --- configuration/esapi/ESAPI.properties | 51 ++++++++++++++++++++++------ 1 file changed, 41 insertions(+), 10 deletions(-) diff --git a/configuration/esapi/ESAPI.properties b/configuration/esapi/ESAPI.properties index f98cc5a49..82d7fad92 100644 --- a/configuration/esapi/ESAPI.properties +++ b/configuration/esapi/ESAPI.properties @@ -319,8 +319,30 @@ HttpUtilities.ForceHttpOnlySession=false HttpUtilities.ForceSecureSession=false HttpUtilities.ForceHttpOnlyCookies=true HttpUtilities.ForceSecureCookies=true -# Maximum size of HTTP headers -HttpUtilities.MaxHeaderSize=4096 +# Maximum size of HTTP header key--the validator regex may have additional values. +HttpUtilities.MaxHeaderNameSize=256 +# Maximum size of HTTP header value--the validator regex may have additional values. +HttpUtilities.MaxHeaderValueSize=4096 +# Maximum size of JSESSIONID for the application--the validator regex may have additional values. +HttpUtilities.HTTPJSESSIONIDLENGTH=50 +# Maximum length of a URL (see https://stackoverflow.com/questions/417142/what-is-the-maximum-length-of-a-url-in-different-browsers) +HttpUtilities.URILENGTH=2000 +# Maximum length of a redirect +HttpUtilities.maxRedirectLength=512 +# Maximum length for an http scheme +HttpUtilities.HTTPSCHEMELENGTH=10 +# Maximum length for an http host +HttpUtilities.HTTPHOSTLENGTH=100 +# Maximum length for an http path +HttpUtilities.HTTPPATHLENGTH=150 +#Maximum length for a context path +HttpUtilities.contextPathLength=150 +#Maximum length for an httpServletPath +HttpUtilities.HTTPSERVLETPATHLENGTH=100 +#Maximum length for an http query parameter name +HttpUtilities.httpQueryParamNameLength=100 +#Maximum length for an http query parameter -- old default was 2000, but that's the max length for a URL... +HttpUtilities.httpQueryParamValueLength=500 # File upload configuration HttpUtilities.ApprovedUploadExtensions=.zip,.pdf,.doc,.docx,.ppt,.pptx,.tar,.gz,.tgz,.rar,.war,.jar,.ear,.xls,.rtf,.properties,.java,.class,.txt,.xml,.jsp,.jsf,.exe,.dll HttpUtilities.MaxUploadFileBytes=500000000 @@ -331,8 +353,10 @@ HttpUtilities.ResponseContentType=text/html; charset=UTF-8 # This is the name of the cookie used to represent the HTTP session # Typically this will be the default "JSESSIONID" HttpUtilities.HttpSessionIdName=JSESSIONID - - +#Sets whether or not will will overwrite http status codes to 200. +HttpUtilities.OverwriteStatusCodes=true +#Sets the application's base character encoding. This is forked from the Java Encryptor property. +HttpUtilities.CharacterEncoding=UTF-8 #=========================================================================== # ESAPI Executor @@ -441,20 +465,27 @@ Validator.Redirect=^\\/test.*$ # Values with Base64 encoded data (e.g. encrypted state) will need at least [a-zA-Z0-9\/+=] Validator.HTTPScheme=^(http|https)$ Validator.HTTPServerName=^[a-zA-Z0-9_.\\-]*$ -Validator.HTTPParameterName=^[a-zA-Z0-9_]{1,32}$ -Validator.HTTPParameterValue=^[a-zA-Z0-9.\\-\\/+=@_ ]*$ Validator.HTTPCookieName=^[a-zA-Z0-9\\-_]{1,32}$ Validator.HTTPCookieValue=^[a-zA-Z0-9\\-\\/+=_ ]*$ -# Note that max header name capped at 150 in SecurityRequestWrapper! -Validator.HTTPHeaderName=^[a-zA-Z0-9\\-_]{1,50}$ +# Note that headerName and Value length is also configured in the HTTPUtilities section +Validator.HTTPHeaderName=^[a-zA-Z0-9\\-_]{1,256}$ Validator.HTTPHeaderValue=^[a-zA-Z0-9()\\-=\\*\\.\\?;,+\\/:&_ ]*$ -Validator.HTTPContextPath=^\\/?[a-zA-Z0-9.\\-\\/_]*$ Validator.HTTPServletPath=^[a-zA-Z0-9.\\-\\/_]*$ Validator.HTTPPath=^[a-zA-Z0-9.\\-_]*$ Validator.HTTPQueryString=^[a-zA-Z0-9()\\-=\\*\\.\\?;,+\\/:&_ %]*$ Validator.HTTPURI=^[a-zA-Z0-9()\\-=\\*\\.\\?;,+\\/:&_ ]*$ Validator.HTTPURL=^.*$ -Validator.HTTPJSESSIONID=^[A-Z0-9]{10,30}$ +Validator.HTTPJSESSIONID=^[A-Z0-9]{10,32}$ + + +# Contributed by Fraenku@gmx.ch +# Googlecode Issue 116 (http://code.google.com/p/owasp-esapi-java/issues/detail?id=116) +Validator.HTTPParameterName=^[a-zA-Z0-9_\\-]{1,32}$ +Validator.HTTPParameterValue=^[\\p{L}\\p{N}.\\-/+=_ !$*?@]{0,1000}$ +Validator.HTTPContextPath=^/[a-zA-Z0-9.\\-_]*$ +Validator.HTTPQueryString=^([a-zA-Z0-9_\\-]{1,32}=[\\p{L}\\p{N}.\\-/+=_ !$*?@%]*&?)*$ +Validator.HTTPURI=^/([a-zA-Z0-9.\\-_]*/?)*$ + # Validation of file related input Validator.FileName=^[a-zA-Z0-9!@#$%^&{}\\[\\]()_+\\-=,.~'` ]{1,255}$ From 97366649c5caf81c9671599c400bd70382bbe250 Mon Sep 17 00:00:00 2001 From: Matt Seil Date: Sat, 19 Aug 2017 15:44:48 -0700 Subject: [PATCH 455/812] Fixing some minor issues of duplication and grammar. --- configuration/esapi/ESAPI.properties | 6 ++---- src/test/resources/esapi/ESAPI.properties | 2 +- 2 files changed, 3 insertions(+), 5 deletions(-) diff --git a/configuration/esapi/ESAPI.properties b/configuration/esapi/ESAPI.properties index 82d7fad92..6a7ef055c 100644 --- a/configuration/esapi/ESAPI.properties +++ b/configuration/esapi/ESAPI.properties @@ -353,7 +353,7 @@ HttpUtilities.ResponseContentType=text/html; charset=UTF-8 # This is the name of the cookie used to represent the HTTP session # Typically this will be the default "JSESSIONID" HttpUtilities.HttpSessionIdName=JSESSIONID -#Sets whether or not will will overwrite http status codes to 200. +#Sets whether or not we will overwrite http status codes to 200. HttpUtilities.OverwriteStatusCodes=true #Sets the application's base character encoding. This is forked from the Java Encryptor property. HttpUtilities.CharacterEncoding=UTF-8 @@ -472,14 +472,12 @@ Validator.HTTPHeaderName=^[a-zA-Z0-9\\-_]{1,256}$ Validator.HTTPHeaderValue=^[a-zA-Z0-9()\\-=\\*\\.\\?;,+\\/:&_ ]*$ Validator.HTTPServletPath=^[a-zA-Z0-9.\\-\\/_]*$ Validator.HTTPPath=^[a-zA-Z0-9.\\-_]*$ -Validator.HTTPQueryString=^[a-zA-Z0-9()\\-=\\*\\.\\?;,+\\/:&_ %]*$ -Validator.HTTPURI=^[a-zA-Z0-9()\\-=\\*\\.\\?;,+\\/:&_ ]*$ Validator.HTTPURL=^.*$ Validator.HTTPJSESSIONID=^[A-Z0-9]{10,32}$ # Contributed by Fraenku@gmx.ch -# Googlecode Issue 116 (http://code.google.com/p/owasp-esapi-java/issues/detail?id=116) +# Github Issue 126 https://github.com/ESAPI/esapi-java-legacy/issues/126 Validator.HTTPParameterName=^[a-zA-Z0-9_\\-]{1,32}$ Validator.HTTPParameterValue=^[\\p{L}\\p{N}.\\-/+=_ !$*?@]{0,1000}$ Validator.HTTPContextPath=^/[a-zA-Z0-9.\\-_]*$ diff --git a/src/test/resources/esapi/ESAPI.properties b/src/test/resources/esapi/ESAPI.properties index 9003ff97a..6e184a46e 100644 --- a/src/test/resources/esapi/ESAPI.properties +++ b/src/test/resources/esapi/ESAPI.properties @@ -365,7 +365,7 @@ HttpUtilities.ResponseContentType=text/html; charset=UTF-8 # This is the name of the cookie used to represent the HTTP session # Typically this will be the default "JSESSIONID" HttpUtilities.HttpSessionIdName=JSESSIONID -#Sets whether or not will will overwrite http status codes to 200. +#Sets whether or not we will overwrite http status codes to 200. HttpUtilities.OverwriteStatusCodes=true #Sets the application's base character encoding. This is forked from the Java Encryptor property. HttpUtilities.CharacterEncoding=UTF-8 From 8f531164201d05c3a2acd7f3e1eb43c1f36d7551 Mon Sep 17 00:00:00 2001 From: Matt Seil Date: Sat, 19 Aug 2017 15:53:55 -0700 Subject: [PATCH 456/812] Cleaned up imports. --- .../java/org/owasp/esapi/reference/DefaultValidator.java | 6 ------ 1 file changed, 6 deletions(-) diff --git a/src/main/java/org/owasp/esapi/reference/DefaultValidator.java b/src/main/java/org/owasp/esapi/reference/DefaultValidator.java index 074b44dd1..d2ac1996a 100644 --- a/src/main/java/org/owasp/esapi/reference/DefaultValidator.java +++ b/src/main/java/org/owasp/esapi/reference/DefaultValidator.java @@ -20,22 +20,16 @@ import java.io.File; import java.io.IOException; import java.io.InputStream; -import java.io.UnsupportedEncodingException; import java.net.URI; import java.net.URISyntaxException; -import java.net.URLDecoder; import java.text.DateFormat; import java.util.ArrayList; import java.util.Date; -import java.util.EnumMap; import java.util.HashMap; import java.util.HashSet; import java.util.Iterator; -import java.util.LinkedHashMap; -import java.util.LinkedList; import java.util.List; import java.util.Map; -import java.util.Map.Entry; import java.util.Set; import java.util.regex.Pattern; From a9849f1421617b5087685daeb7239015bd753930 Mon Sep 17 00:00:00 2001 From: Matt Seil Date: Sat, 26 Aug 2017 16:13:21 -0700 Subject: [PATCH 457/812] Issue #284 -- Restored original canonicalization behavior due to issue #54 being an invalid fix for a legacy URL issue where query params would get flagged as HTML Entities. --- .../esapi/reference/DefaultValidator.java | 2 - .../validation/StringValidationRule.java | 50 +++---------------- .../owasp/esapi/reference/ValidatorTest.java | 2 +- 3 files changed, 8 insertions(+), 46 deletions(-) diff --git a/src/main/java/org/owasp/esapi/reference/DefaultValidator.java b/src/main/java/org/owasp/esapi/reference/DefaultValidator.java index d2ac1996a..92bef36c6 100644 --- a/src/main/java/org/owasp/esapi/reference/DefaultValidator.java +++ b/src/main/java/org/owasp/esapi/reference/DefaultValidator.java @@ -216,7 +216,6 @@ public String getValidInput(String context, String input, String type, int maxLe } rvr.setMaximumLength(maxLength); rvr.setAllowNull(allowNull); - rvr.setValidateInputAndCanonical(canonicalize); return rvr.getValid(context, input); } @@ -343,7 +342,6 @@ public String getValidSafeHTML( String context, String input, int maxLength, boo HTMLValidationRule hvr = new HTMLValidationRule( "safehtml", encoder ); hvr.setMaximumLength(maxLength); hvr.setAllowNull(allowNull); - hvr.setValidateInputAndCanonical(false); return hvr.getValid(context, input); } diff --git a/src/main/java/org/owasp/esapi/reference/validation/StringValidationRule.java b/src/main/java/org/owasp/esapi/reference/validation/StringValidationRule.java index c48286cf5..3163c532d 100644 --- a/src/main/java/org/owasp/esapi/reference/validation/StringValidationRule.java +++ b/src/main/java/org/owasp/esapi/reference/validation/StringValidationRule.java @@ -44,7 +44,6 @@ public class StringValidationRule extends BaseValidationRule { protected List blacklistPatterns = new ArrayList(); protected int minLength = 0; protected int maxLength = Integer.MAX_VALUE; - protected boolean validateInputAndCanonical = true; public StringValidationRule( String typeName ) { super( typeName ); @@ -116,16 +115,6 @@ public void setMaximumLength( int length ) { maxLength = length; } - /** - * Set the flag which determines whether the in input itself is - * checked as well as the canonical form of the input. - * @param flag The value to set - */ - public void setValidateInputAndCanonical(boolean flag) - { - validateInputAndCanonical = flag; - } - /** * checks input against whitelists. * @param context The context to include in exception messages @@ -267,47 +256,22 @@ public String getValid( String context, String input ) throws ValidationExceptio { String data = null; - // checks on input itself - // check for empty/null if(checkEmpty(context, input) == null) return null; - if (validateInputAndCanonical) - { - //first validate pre-canonicalized data - - // check length - checkLength(context, input); - - // check whitelist patterns - checkWhitelist(context, input); - - // check blacklist patterns - checkBlacklist(context, input); - - // canonicalize - data = encoder.canonicalize( input ); - - } else { - - //skip canonicalization - data = input; - } - - // check for empty/null - if(checkEmpty(context, data, input) == null) - return null; - // check length - checkLength(context, data, input); + checkLength(context, input); + + // canonicalize + data = encoder.canonicalize( input ); // check whitelist patterns - checkWhitelist(context, data, input); + checkWhitelist(context, input); // check blacklist patterns - checkBlacklist(context, data, input); - + checkBlacklist(context, input); + // validation passed return data; } diff --git a/src/test/java/org/owasp/esapi/reference/ValidatorTest.java b/src/test/java/org/owasp/esapi/reference/ValidatorTest.java index 8fb0a2e8a..bcef424b4 100644 --- a/src/test/java/org/owasp/esapi/reference/ValidatorTest.java +++ b/src/test/java/org/owasp/esapi/reference/ValidatorTest.java @@ -232,7 +232,7 @@ public void testGetValidFileName() throws Exception { assertEquals("Percent encoding is not changed", testName, instance.getValidFileName("test", testName, ESAPI.securityConfiguration().getAllowedFileExtensions(), false, errors)); } - public void testGetValidInput() { + public void testGetValidInput() throws Exception { System.out.println("getValidInput"); Validator instance = ESAPI.validator(); ValidationErrorList errors = new ValidationErrorList(); From 66745aef119a661f35eb8ef9cbae2aa514926f59 Mon Sep 17 00:00:00 2001 From: Matt Seil Date: Sat, 26 Aug 2017 16:15:42 -0700 Subject: [PATCH 458/812] Issue #284 -- Fixed code no longer needed for testing. --- src/test/java/org/owasp/esapi/reference/ValidatorTest.java | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/test/java/org/owasp/esapi/reference/ValidatorTest.java b/src/test/java/org/owasp/esapi/reference/ValidatorTest.java index bcef424b4..6222ebeb2 100644 --- a/src/test/java/org/owasp/esapi/reference/ValidatorTest.java +++ b/src/test/java/org/owasp/esapi/reference/ValidatorTest.java @@ -232,7 +232,7 @@ public void testGetValidFileName() throws Exception { assertEquals("Percent encoding is not changed", testName, instance.getValidFileName("test", testName, ESAPI.securityConfiguration().getAllowedFileExtensions(), false, errors)); } - public void testGetValidInput() throws Exception { + public void testGetValidInput(){ System.out.println("getValidInput"); Validator instance = ESAPI.validator(); ValidationErrorList errors = new ValidationErrorList(); From f01719ad13ad19e7f6bb7e88e2d384f44dd32ef3 Mon Sep 17 00:00:00 2001 From: Matt Seil Date: Sat, 26 Aug 2017 18:10:32 -0700 Subject: [PATCH 459/812] Adding mocking frameworks for testing. --- pom.xml | 34 ++++++++++++++++++++-------------- 1 file changed, 20 insertions(+), 14 deletions(-) diff --git a/pom.xml b/pom.xml index 25b4cebff..ddf78c307 100644 --- a/pom.xml +++ b/pom.xml @@ -88,13 +88,6 @@ Project Inventor - - Chris Schmidt - Aspect Security - - Project Co-owner - - Kevin W. Wall Wells Fargo @@ -102,6 +95,13 @@ Project Co-owner + + Matt Seil + OWASP + + Project Co-owner + + @@ -119,6 +119,12 @@ + + + joda-time + joda-time + 2.9.9 + commons-configuration commons-configuration @@ -224,29 +230,29 @@ 1.7.0 test - - - - - + @@ -529,7 +535,7 @@ - + org.apache.maven.plugins maven-jar-plugin @@ -561,7 +567,7 @@ - + From a47d8e70ec57e362ed58225fd97b12cb5b7cf2da Mon Sep 17 00:00:00 2001 From: NiklasMehner Date: Tue, 7 Nov 2017 03:52:51 +0100 Subject: [PATCH 460/812] Fix configuration loading: Use value instead of constants also update vulnerable dependencies (#426) * Fix configuration loading: Use value instead of constants * Update dependencies with vulnerabilities Close #426 --- pom.xml | 10 +++++----- .../esapi/reference/DefaultSecurityConfiguration.java | 10 +++++----- 2 files changed, 10 insertions(+), 10 deletions(-) diff --git a/pom.xml b/pom.xml index ddf78c307..44db96788 100644 --- a/pom.xml +++ b/pom.xml @@ -157,7 +157,7 @@ commons-fileupload commons-fileupload - 1.3.2 + 1.3.3 compile @@ -185,14 +185,14 @@ 1.2.10 - org.beanshell - bsh-core - 2.0b4 + org.apache-extras.beanshell + bsh + 2.0b6 org.owasp.antisamy antisamy - 1.5.6 + 1.5.7 + -Xmaxwarns + 2000 + + + -Xlint:all,-deprecation,-rawtypes,-unchecked + + @@ -330,7 +362,7 @@ org.owasp dependency-check-maven - 1.4.4 + 2.1.0 5.9 ./suppressions.xml @@ -370,7 +402,7 @@ maven-pmd-plugin 3.6 - 1.5 + 1.7 utf-8 @@ -464,6 +496,7 @@ org.apache.maven.plugins maven-javadoc-plugin + 3.0.0-M1 -Xdoclint:none @@ -568,7 +601,7 @@ - org.apache.maven.plugins @@ -583,10 +616,10 @@ - 1.6 + 1.7 - ESAPI 2.1 uses the JDK1.6 for it's baseline. Please make sure that your - JAVA_HOME environment variable is pointed to a JDK1.6 distribution. + ESAPI 2.x now uses the JDK1.7 for it's baseline. Please make sure that your + JAVA_HOME environment variable is pointed to a JDK1.7 distribution. From f3cdc694e56f5bb5c248dc6294ec174df5bd6e20 Mon Sep 17 00:00:00 2001 From: "Kevin W. Wall" Date: Tue, 26 Dec 2017 11:37:14 -0500 Subject: [PATCH 464/812] Update README.md file to fix minor typo --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 3c5ccd2c0..f6f3e4721 100644 --- a/README.md +++ b/README.md @@ -35,7 +35,7 @@ In mid-2014 ESAPI Migrated all code to GitHub. This migration was completed in N ### What about the issues still located on Google Code? All issues from Google Code have been migrated to GitHub issues. We have a JIRA/Confluence instance allocated to us, but it has not be configured to synchronize with the GitHub issues, and thus is should not be used. JIRA is fine, but if we can't have it synchronized with GitHub issues (which is where the majority of our users report issues), it is not usuable. As developers, we do not want to spent time having to close issues from multiple bug-tracking sites. Therefore, until this synchronization happens (see GitHub issue #371), please ONLY use GitHub for reporting bugs. -When reporting an issue, please be clear and try to ensure that the ESAPI development team has sufficient information to be able to reproduce your results. If you have not already done son, this might be a good time to read Eric S. Raymond's classic "How to Ask Questions the Smart Way", at http://www.catb.org/esr/faqs/smart-questions.html before posting your issue. +When reporting an issue, please be clear and try to ensure that the ESAPI development team has sufficient information to be able to reproduce your results. If you have not already done so, this might be a good time to read Eric S. Raymond's classic "How to Ask Questions the Smart Way", at http://www.catb.org/esr/faqs/smart-questions.html before posting your issue. ### Find an Issue? If you have found a bug, then create an issue on the esapi-legacy-java repo: https://github.com/ESAPI/esapi-java-legacy/issues From 15b5b767f16cb590c5a6aba273a33da15bbb9730 Mon Sep 17 00:00:00 2001 From: "Kevin W. Wall" Date: Sat, 30 Dec 2017 15:05:04 -0500 Subject: [PATCH 465/812] Update README.md to refer to GitHub's suggested begiiner label for issues. Previously we were using the label 'FirstBug' to reflect issues appropriate for beginners to work on. That label was created prior to GitHub suggesting the use of 'help wanted' or 'good first issue' for that label. I have created the 'good first use' label (with the same color as suggested by GitHub) and replaced all the (now obsolete) 'FirstBug' labels with the label 'good first use' and then deleted the custom 'FirstBug' label. Updating this README.md file is the file step. --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index f6f3e4721..27168a156 100644 --- a/README.md +++ b/README.md @@ -27,7 +27,7 @@ https://github.com/ESAPI/esapi-java ## How can I contribute or help with fix bugs? Fork and submit a pull request! Simple as pi! We generally only accept bug fixes, not new features because as a legacy project, we don't intend on adding new features, although we may make exceptions. If you wish to propose a new feature, the best place to discuss it is via the ESAPI-DEV mailing list mentioned below. Note that we vet all pull requests, including coding style of any contributions; use the same coding style found in the files you are already editing. -If you are new to ESAPI, a good place to start is to look for GitHub issues labled as 'FirstBug'. (E.g., https://github.com/ESAPI/esapi-java-legacy/labels/FirstBug) +If you are new to ESAPI, a good place to start is to look for GitHub issues labled as 'good first issue'. (E.g., to find all open issues with that label, use https://github.com/ESAPI/esapi-java-legacy/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22.) ### What happened to Google code? In mid-2014 ESAPI Migrated all code to GitHub. This migration was completed in November 2014. From b712af5a543e8428a44a363c96a4b0ee8d2e300b Mon Sep 17 00:00:00 2001 From: Jeremiah Stacey Date: Fri, 5 Jan 2018 13:31:05 -0600 Subject: [PATCH 466/812] GITHUB #135 Updating SecurityWrapperRequest.getQueryString to return the original encoded string to the caller IFF that string can be converted into a 'safe' string by the ESAPI Validator instance/configuration. --- .../org/owasp/esapi/filters/SecurityWrapperRequest.java | 7 ++++++- .../java/org/owasp/esapi/filters/SafeRequestTest.java | 8 +++----- 2 files changed, 9 insertions(+), 6 deletions(-) diff --git a/src/main/java/org/owasp/esapi/filters/SecurityWrapperRequest.java b/src/main/java/org/owasp/esapi/filters/SecurityWrapperRequest.java index 095069918..72f9f9bdc 100644 --- a/src/main/java/org/owasp/esapi/filters/SecurityWrapperRequest.java +++ b/src/main/java/org/owasp/esapi/filters/SecurityWrapperRequest.java @@ -513,7 +513,12 @@ public String getQueryString() { } catch (ValidationException e) { // already logged } - return clean; + /* GITHUB #135 + * as long as the original query can be cleaned then we assume it's safe. + * Returning the decoded 'clean' value changes how the string is interpreted, + * so we need to return the original query value. + */ + return clean == null || clean.isEmpty() ? clean : query; } /** diff --git a/src/test/java/org/owasp/esapi/filters/SafeRequestTest.java b/src/test/java/org/owasp/esapi/filters/SafeRequestTest.java index e4d55950d..e758fe02f 100644 --- a/src/test/java/org/owasp/esapi/filters/SafeRequestTest.java +++ b/src/test/java/org/owasp/esapi/filters/SafeRequestTest.java @@ -121,7 +121,7 @@ public void testGetQueryStringPercent() req.setQueryString("a=%62"); wrappedReq = new SecurityWrapperRequest(req); - assertEquals("a=b",wrappedReq.getQueryString()); + assertEquals("a=%62",wrappedReq.getQueryString()); } public void testGetQueryStringPercentNUL() @@ -131,11 +131,9 @@ public void testGetQueryStringPercentNUL() req.setQueryString("a=%00"); wrappedReq = new SecurityWrapperRequest(req); - assertEquals("",wrappedReq.getQueryString()); + assertEquals("a=%00", wrappedReq.getQueryString()); } - /* these tests need to be enabled&changed based on the decisions - * made regarding issue 125. Currently they fail. public void testGetQueryStringPercentEquals() { MockHttpServletRequest req = new MockHttpServletRequest(); @@ -155,7 +153,7 @@ public void testGetQueryStringPercentAmpersand() wrappedReq = new SecurityWrapperRequest(req); assertEquals("a=%26b",wrappedReq.getQueryString()); } - */ + // Test to ensure null-value contract defined by ServletRequest.getParameterNames(String) is met. public void testGetParameterValuesReturnsNullWhenParameterDoesNotExistInRequest() { From 2c199e5e84ebee32e1147440c8ef9b72ecf8e198 Mon Sep 17 00:00:00 2001 From: Jeremiah Stacey Date: Sat, 20 Jan 2018 09:19:24 -0600 Subject: [PATCH 467/812] Canonicalize SecurityWrapperRequest.getQueryString Reverts last change which removed canonicalization from the return value. Tests being updated to reflect the expected behavior, which includes both canonicalization as well as test-scoped whitelist functionality from validation. --- .../org/owasp/esapi/filters/SecurityWrapperRequest.java | 7 +------ .../java/org/owasp/esapi/filters/SafeRequestTest.java | 8 ++++---- 2 files changed, 5 insertions(+), 10 deletions(-) diff --git a/src/main/java/org/owasp/esapi/filters/SecurityWrapperRequest.java b/src/main/java/org/owasp/esapi/filters/SecurityWrapperRequest.java index 72f9f9bdc..095069918 100644 --- a/src/main/java/org/owasp/esapi/filters/SecurityWrapperRequest.java +++ b/src/main/java/org/owasp/esapi/filters/SecurityWrapperRequest.java @@ -513,12 +513,7 @@ public String getQueryString() { } catch (ValidationException e) { // already logged } - /* GITHUB #135 - * as long as the original query can be cleaned then we assume it's safe. - * Returning the decoded 'clean' value changes how the string is interpreted, - * so we need to return the original query value. - */ - return clean == null || clean.isEmpty() ? clean : query; + return clean; } /** diff --git a/src/test/java/org/owasp/esapi/filters/SafeRequestTest.java b/src/test/java/org/owasp/esapi/filters/SafeRequestTest.java index e758fe02f..e404f8c46 100644 --- a/src/test/java/org/owasp/esapi/filters/SafeRequestTest.java +++ b/src/test/java/org/owasp/esapi/filters/SafeRequestTest.java @@ -121,7 +121,7 @@ public void testGetQueryStringPercent() req.setQueryString("a=%62"); wrappedReq = new SecurityWrapperRequest(req); - assertEquals("a=%62",wrappedReq.getQueryString()); + assertEquals("a=b",wrappedReq.getQueryString()); } public void testGetQueryStringPercentNUL() @@ -131,7 +131,7 @@ public void testGetQueryStringPercentNUL() req.setQueryString("a=%00"); wrappedReq = new SecurityWrapperRequest(req); - assertEquals("a=%00", wrappedReq.getQueryString()); + assertEquals("a="+Character.MIN_VALUE, wrappedReq.getQueryString()); } public void testGetQueryStringPercentEquals() @@ -141,7 +141,7 @@ public void testGetQueryStringPercentEquals() req.setQueryString("a=%3d"); wrappedReq = new SecurityWrapperRequest(req); - assertEquals("a=%3d",wrappedReq.getQueryString()); + assertEquals("a==",wrappedReq.getQueryString()); } public void testGetQueryStringPercentAmpersand() @@ -151,7 +151,7 @@ public void testGetQueryStringPercentAmpersand() req.setQueryString("a=%26b"); wrappedReq = new SecurityWrapperRequest(req); - assertEquals("a=%26b",wrappedReq.getQueryString()); + assertEquals("a=&b",wrappedReq.getQueryString()); } From f006b5308eb54e2ba316a4b55e24cc6430fdcfed Mon Sep 17 00:00:00 2001 From: Jeremiah Stacey Date: Sat, 20 Jan 2018 09:26:35 -0600 Subject: [PATCH 468/812] SecurityWrapperRequest Workflow Test Using PowerMock to assert the happy-path and exception cases when requesting a QueryString reference. This approach removes the test environment from the unit and focuses on the behavior of the class in isolation. --- .../filters/SecurityWrapperRequestTest.java | 108 ++++++++++++++++++ 1 file changed, 108 insertions(+) create mode 100644 src/test/java/org/owasp/esapi/filters/SecurityWrapperRequestTest.java diff --git a/src/test/java/org/owasp/esapi/filters/SecurityWrapperRequestTest.java b/src/test/java/org/owasp/esapi/filters/SecurityWrapperRequestTest.java new file mode 100644 index 000000000..3200700c1 --- /dev/null +++ b/src/test/java/org/owasp/esapi/filters/SecurityWrapperRequestTest.java @@ -0,0 +1,108 @@ +package org.owasp.esapi.filters; + +import javax.servlet.http.HttpServletRequest; + +import org.junit.Assert; +import org.junit.Before; +import org.junit.Test; +import org.junit.runner.RunWith; +import org.mockito.ArgumentCaptor; +import org.mockito.Matchers; +import org.mockito.Mock; +import org.mockito.Mockito; +import org.owasp.esapi.ESAPI; +import org.owasp.esapi.SecurityConfiguration; +import org.owasp.esapi.Validator; +import org.owasp.esapi.errors.IntrusionException; +import org.owasp.esapi.errors.ValidationException; +import org.owasp.esapi.filters.SecurityWrapperRequest; +import org.powermock.api.mockito.PowerMockito; +import org.powermock.core.classloader.annotations.PrepareForTest; +import org.powermock.modules.junit4.PowerMockRunner; + +/** + * FIXME: Document intent of class. General Function, purpose of creation, intended feature, etc. + * Why do people care this exists? + * + * @author Jeremiah + * @since Jan 3, 2018 + */ +@RunWith(PowerMockRunner.class) +@PrepareForTest(ESAPI.class) +public class SecurityWrapperRequestTest { + + @Mock + private HttpServletRequest mockRequest; + @Mock + private Validator mockValidator; + @Mock + private SecurityConfiguration mockSecConfig; + + @Before + public void setup() throws Exception { + PowerMockito.mockStatic(ESAPI.class); + PowerMockito.when(ESAPI.class, "validator").thenReturn(mockValidator); + PowerMockito.when(ESAPI.class, "securityConfiguration").thenReturn(mockSecConfig); + } + + @Test + public void testGetQueryString() throws IntrusionException, ValidationException { + String queryString = "queryString"; + int maxLength = 255; + + ArgumentCaptor inputCapture = ArgumentCaptor.forClass(String.class); + ArgumentCaptor typeCapture = ArgumentCaptor.forClass(String.class); + ArgumentCaptor lenghtCapture = ArgumentCaptor.forClass(Integer.class); + ArgumentCaptor allowNullCapture = ArgumentCaptor.forClass(Boolean.class); + + PowerMockito.when(mockValidator.getValidInput(Matchers.anyString(), inputCapture.capture(), typeCapture + .capture(), lenghtCapture.capture(), allowNullCapture.capture())).thenReturn("canonicalized"); + PowerMockito.when(mockSecConfig.getIntProp("HttpUtilities.URILENGTH")).thenReturn(maxLength); + PowerMockito.when(mockRequest.getQueryString()).thenReturn(queryString); + + SecurityWrapperRequest request = new SecurityWrapperRequest(mockRequest); + String rval = request.getQueryString(); + Assert.assertEquals("canonicalized", rval); + + Assert.assertEquals(queryString, inputCapture.getValue()); + Assert.assertEquals("HTTPQueryString", typeCapture.getValue()); + Assert.assertTrue(maxLength == lenghtCapture.getValue().intValue()); + Assert.assertEquals(true, allowNullCapture.getValue()); + + Mockito.verify(mockValidator, Mockito.times(1)).getValidInput(Matchers.anyString(), Matchers.anyString(), + Matchers.anyString(), Matchers.anyInt(), Matchers.anyBoolean()); + Mockito.verify(mockSecConfig, Mockito.times(1)).getIntProp("HttpUtilities.URILENGTH"); + Mockito.verify(mockRequest, Mockito.times(1)).getQueryString(); + } + + @SuppressWarnings("unchecked") + @Test + public void testGetQueryStringCanonicalizeException() throws IntrusionException, ValidationException { + String queryString = "queryString"; + int maxLength = 255; + + ArgumentCaptor inputCapture = ArgumentCaptor.forClass(String.class); + ArgumentCaptor typeCapture = ArgumentCaptor.forClass(String.class); + ArgumentCaptor lenghtCapture = ArgumentCaptor.forClass(Integer.class); + ArgumentCaptor allowNullCapture = ArgumentCaptor.forClass(Boolean.class); + + PowerMockito.when(mockValidator.getValidInput(Matchers.anyString(), inputCapture.capture(), typeCapture + .capture(), lenghtCapture.capture(), allowNullCapture.capture())).thenThrow(ValidationException.class); + PowerMockito.when(mockSecConfig.getIntProp("HttpUtilities.URILENGTH")).thenReturn(maxLength); + PowerMockito.when(mockRequest.getQueryString()).thenReturn(queryString); + + SecurityWrapperRequest request = new SecurityWrapperRequest(mockRequest); + String rval = request.getQueryString(); + Assert.assertEquals("", rval); + + Assert.assertEquals(queryString, inputCapture.getValue()); + Assert.assertEquals("HTTPQueryString", typeCapture.getValue()); + Assert.assertTrue(maxLength == lenghtCapture.getValue().intValue()); + Assert.assertEquals(true, allowNullCapture.getValue()); + + Mockito.verify(mockValidator, Mockito.times(1)).getValidInput(Matchers.anyString(), Matchers.anyString(), + Matchers.anyString(), Matchers.anyInt(), Matchers.anyBoolean()); + Mockito.verify(mockSecConfig, Mockito.times(1)).getIntProp("HttpUtilities.URILENGTH"); + Mockito.verify(mockRequest, Mockito.times(1)).getQueryString(); + } +} From 5f91df0a6a454bc5df04e2e64918ebba59f4512a Mon Sep 17 00:00:00 2001 From: Jeremiah Stacey Date: Sat, 20 Jan 2018 09:29:03 -0600 Subject: [PATCH 469/812] Whitelist Regex Validation Tests Providing a structure to assert that the enviroment configurations will provide expected responses when passed controlled values. Performing a preliminary whitelist test set on HttpQueryString regex from ESAPI.properties. The test implementation asserts that the regex being tested matches the test environment's regex for a given property. If the regex strings differ, the tests associated with that property will be skipped to prevent false-positives from being provided to a client. --- .../esapi/reference/AbstractPatternTest.java | 49 ++++++++++ ...EsapiWhitelistValidationPatternTester.java | 91 +++++++++++++++++++ 2 files changed, 140 insertions(+) create mode 100644 src/test/java/org/owasp/esapi/reference/AbstractPatternTest.java create mode 100644 src/test/java/org/owasp/esapi/reference/EsapiWhitelistValidationPatternTester.java diff --git a/src/test/java/org/owasp/esapi/reference/AbstractPatternTest.java b/src/test/java/org/owasp/esapi/reference/AbstractPatternTest.java new file mode 100644 index 000000000..3fd72ebaf --- /dev/null +++ b/src/test/java/org/owasp/esapi/reference/AbstractPatternTest.java @@ -0,0 +1,49 @@ +package org.owasp.esapi.reference; + +import java.util.regex.Pattern; + +import org.junit.Assert; +import org.junit.Test; +import org.junit.runner.RunWith; +import org.junit.runners.Parameterized; + + +/** + * FIXME: Document intent of class. General Function, purpose of creation, intended feature, etc. + * Why do people care this exists? + * @author Jeremiah + * @since Jan 20, 2018 + * + */ +@RunWith (Parameterized.class) +public abstract class AbstractPatternTest { + + protected static class PatternTestTuple { + String input; + String regex; + boolean shouldMatch; + String description; + /** {@inheritDoc}*/ + @Override + public String toString() { + return description != null ? description : regex; + } + } + + private String input; + private Pattern pattern; + private boolean shouldMatch; + + + public AbstractPatternTest(PatternTestTuple tuple) { + this.input = tuple.input; + this.pattern = Pattern.compile(tuple.regex); + this.shouldMatch = tuple.shouldMatch; + } + + @Test + public void checkPatternMatches() { + Assert.assertEquals(shouldMatch, pattern.matcher(input).matches()); + } + +} diff --git a/src/test/java/org/owasp/esapi/reference/EsapiWhitelistValidationPatternTester.java b/src/test/java/org/owasp/esapi/reference/EsapiWhitelistValidationPatternTester.java new file mode 100644 index 000000000..4a1bd5ffb --- /dev/null +++ b/src/test/java/org/owasp/esapi/reference/EsapiWhitelistValidationPatternTester.java @@ -0,0 +1,91 @@ +package org.owasp.esapi.reference; + +import java.util.ArrayList; +import java.util.Collection; + +import org.junit.Assume; +import org.junit.runners.Parameterized.Parameters; +import org.owasp.esapi.reference.DefaultSecurityConfiguration; + +/** + * Extension of the AbstractPatternTest which focuses on asserting that the default whitelist regex values applied in + * the validation process are performing the intended function in the environment. + * + *
+ * + * If the regex values in this test are found to not match the running environment configurations, then the tests will + * be skipped. + * + * @author Jeremiah + * @since Jan 20, 2018 + */ +public class EsapiWhitelistValidationPatternTester extends AbstractPatternTest { + //See ESAPI.properties + private static final String HTTP_QUERY_STRING_PROP_NAME="HTTPQueryString"; + private static final String HTTP_QUERY_STRING_REGEX="^([a-zA-Z0-9_\\-]{1,32}=[\\p{L}\\p{N}.\\-/+=_ !$*?@%]*&?)*$"; + + @Parameters(name = "{0}-{1}") + public static Collection createDefaultPatternTests() { + Collection parameters = new ArrayList<>(); + + for(PatternTestTuple tuple : buildHttpQueryStringTests()) { + parameters.add(new Object[] { HTTP_QUERY_STRING_PROP_NAME, tuple }); + } + + + return parameters; + } + + private static Collection buildHttpQueryStringTests() { + Collection httpQueryStringTests = new ArrayList<>(); + + //MATCHING CASES + PatternTestTuple tuple = newHttpQueryStringTuple("Default Case", "b", true); + httpQueryStringTests.add(tuple); + tuple = newHttpQueryStringTuple("Percent Encoded Value", "%62", true); + httpQueryStringTests.add(tuple); + tuple = newHttpQueryStringTuple("Percent Encoded Null Character", "%00", true); + httpQueryStringTests.add(tuple); + tuple = newHttpQueryStringTuple("Double Equals", "=", true); + httpQueryStringTests.add(tuple); + + //NON-MATCHING CASES + tuple = newHttpQueryStringTuple("Ampersand In Value", "&b", false); + httpQueryStringTests.add(tuple); + tuple = newHttpQueryStringTuple("Null Character", ""+Character.MIN_VALUE, false); + httpQueryStringTests.add(tuple); + tuple = newHttpQueryStringTuple("Encoded Null Character", "\u0000", false); + httpQueryStringTests.add(tuple); + + return httpQueryStringTests; + } + + private static PatternTestTuple newHttpQueryStringTuple(String description, String value, boolean shouldPass) { + PatternTestTuple tuple = new PatternTestTuple(); + tuple.input = "a="+value; + tuple.shouldMatch = shouldPass; + tuple.regex = HTTP_QUERY_STRING_REGEX; + tuple.description = description; + return tuple; + } + + public EsapiWhitelistValidationPatternTester(String property, PatternTestTuple tuple) { + super(tuple); + /* + * This next block causes the case to be skipped programatically if the regex being tested + * is different than the one being loaded at runtime. + * This is being done to prevent a false sense of security. + * If the configurations are changed to meet additional environmental concerns, the intent of this test should + * be copied into that environment and tested there to assert the additional expectations or changes in desired + * behavior. + */ + DefaultSecurityConfiguration configuration = new DefaultSecurityConfiguration(); + Assume.assumeTrue( + "The regular expression specified does not match the configuration settings.\n" + + "If the value was changed from the ESAPI default, it is recommended to copy " + + "this class into your project, update the regex being tested, and update all " + + "associated input expectations for your unique environment.", + configuration.getValidationPattern(property).toString().equals(tuple.regex)); + } + +} From f5a190ff8a709bf712783cac12280c4f786c2624 Mon Sep 17 00:00:00 2001 From: Jeremiah Stacey Date: Sat, 20 Jan 2018 09:34:08 -0600 Subject: [PATCH 470/812] PercentCodec String/character encode/decode Set of tests for PercentCodec which tests the encode and decode features using both String and Character api calls. Initial test data sets are derived from 'AbstractCodecTest', 'SafeRequestTest', as well as the interal immune character set from PercentCodec implementation. --- .../codecs/AbstractCodecCharacterTest.java | 72 ++++++++++++ .../esapi/codecs/AbstractCodecStringTest.java | 61 ++++++++++ .../codecs/PercentCodecCharacterTest.java | 108 ++++++++++++++++++ .../esapi/codecs/PercentCodecStringTest.java | 85 ++++++++++++++ 4 files changed, 326 insertions(+) create mode 100644 src/test/java/org/owasp/esapi/codecs/AbstractCodecCharacterTest.java create mode 100644 src/test/java/org/owasp/esapi/codecs/AbstractCodecStringTest.java create mode 100644 src/test/java/org/owasp/esapi/codecs/PercentCodecCharacterTest.java create mode 100644 src/test/java/org/owasp/esapi/codecs/PercentCodecStringTest.java diff --git a/src/test/java/org/owasp/esapi/codecs/AbstractCodecCharacterTest.java b/src/test/java/org/owasp/esapi/codecs/AbstractCodecCharacterTest.java new file mode 100644 index 000000000..f6b708a67 --- /dev/null +++ b/src/test/java/org/owasp/esapi/codecs/AbstractCodecCharacterTest.java @@ -0,0 +1,72 @@ +package org.owasp.esapi.codecs; + +import java.util.Arrays; + +import org.junit.Assert; +import org.junit.Test; +import org.junit.runner.RunWith; +import org.junit.runners.Parameterized; +import org.owasp.esapi.codecs.Codec; +import org.owasp.esapi.codecs.PushbackString; + + +/** + * FIXME: Document intent of class. General Function, purpose of creation, intended feature, etc. + * Why do people care this exists? + * @author Jeremiah + * @since Jan 20, 2018 + * + */ +@RunWith(Parameterized.class) +public abstract class AbstractCodecCharacterTest { + + protected static class CodecCharacterTestTuple { + Codec codec; + char[] encodeImmune; + String input; + Character decodedValue; + String description; + /** {@inheritDoc}*/ + + @Override + public String toString() { + return description != null ? description : codec.getClass().getSimpleName() + " "+input; + } + } + + + protected final Codec codec; + protected final String input; + protected final char[] encodeImmune; + protected final Character decodedValue; + + public AbstractCodecCharacterTest(CodecCharacterTestTuple tuple) { + this.codec = tuple.codec; + this.input = tuple.input; + this.decodedValue = tuple.decodedValue; + this.encodeImmune = tuple.encodeImmune; + } + + @Test + public void testEncodeCharacter() { + Assert.assertEquals(input, codec.encodeCharacter(encodeImmune, decodedValue)); + } + + @Test + public void testEncode() { + String expected = Arrays.asList(encodeImmune).contains(decodedValue) ? decodedValue.toString() : input; + Assert.assertEquals(expected, codec.encode(encodeImmune, decodedValue.toString())); + } + + @Test + public void testDecode() { + Assert.assertEquals(decodedValue.toString(), codec.decode(input)); + } + + + @Test + public void testDecodePushbackSequence() { + Assert.assertEquals(decodedValue, codec.decodeCharacter(new PushbackString(input))); + } + +} diff --git a/src/test/java/org/owasp/esapi/codecs/AbstractCodecStringTest.java b/src/test/java/org/owasp/esapi/codecs/AbstractCodecStringTest.java new file mode 100644 index 000000000..27d0ea12e --- /dev/null +++ b/src/test/java/org/owasp/esapi/codecs/AbstractCodecStringTest.java @@ -0,0 +1,61 @@ +package org.owasp.esapi.codecs; + +import java.util.Arrays; + +import org.junit.Assert; +import org.junit.Test; +import org.junit.runner.RunWith; +import org.junit.runners.Parameterized; +import org.owasp.esapi.codecs.Codec; + + +/** + * FIXME: Document intent of class. General Function, purpose of creation, intended feature, etc. + * Why do people care this exists? + * @author Jeremiah + * @since Jan 20, 2018 + * + */ +@RunWith(Parameterized.class) +public abstract class AbstractCodecStringTest { + + protected static class CodecStringTestTuple { + Codec codec; + char[] encodeImmune; + String input; + String decodedValue; + String description; + /** {@inheritDoc}*/ + + @Override + public String toString() { + return description != null ? description : codec.getClass().getSimpleName() + " "+input; + } + } + + + private final Codec codec; + private final String input; + private final char[] encodeImmune; + private final String decodedValue; + + public AbstractCodecStringTest(CodecStringTestTuple tuple) { + this.codec = tuple.codec; + this.input = tuple.input; + this.decodedValue = tuple.decodedValue; + this.encodeImmune = tuple.encodeImmune; + } + + @Test + public void testDecode() { + Assert.assertEquals(decodedValue, codec.decode(input)); + } + + + @Test + public void testEncode() { + String expected = Arrays.asList(encodeImmune).contains(decodedValue) ? decodedValue : input; + Assert.assertEquals(expected, codec.encode(encodeImmune, decodedValue)); + } + +} diff --git a/src/test/java/org/owasp/esapi/codecs/PercentCodecCharacterTest.java b/src/test/java/org/owasp/esapi/codecs/PercentCodecCharacterTest.java new file mode 100644 index 000000000..9617ccb9c --- /dev/null +++ b/src/test/java/org/owasp/esapi/codecs/PercentCodecCharacterTest.java @@ -0,0 +1,108 @@ +package org.owasp.esapi.codecs; + +import java.util.ArrayList; +import java.util.Collection; +import java.util.List; + +import org.junit.Assert; +import org.junit.Test; +import org.junit.runners.Parameterized.Parameters; +import org.owasp.esapi.codecs.PercentCodec; +import org.owasp.esapi.codecs.PushbackString; + +/** + * FIXME: Document intent of class. General Function, purpose of creation, intended feature, etc. + * Why do people care this exists? + * @author Jeremiah + * @since Jan 20, 2018 + * + */ +public class PercentCodecCharacterTest extends AbstractCodecCharacterTest { + private static final char[] PERCENT_CODEC_IMMUNE; + + static { + /* + * The percent codec contains a unique immune character set which include letters and numbers that will not be transformed. + * + * It is being replicated here to allow the test to reasonably expect the correct state back. + */ + List immune = new ArrayList<>(); + // 65 - 90 (capital letters) 97 - 122 lower case 48 - 57 digits + //numbers + for (int index = 48 ; index < 58; index ++) { + immune.add((char)index); + } + //letters + for (int index = 65 ; index < 91; index ++) { + Character capsChar = (char)index; + immune.add(capsChar); + immune.add(Character.toLowerCase(capsChar)); + } + + PERCENT_CODEC_IMMUNE = new char[immune.size()]; + for (int index = 0; index < immune.size(); index++) { + PERCENT_CODEC_IMMUNE[index] = immune.get(index).charValue(); + } + } + + @Parameters(name="{0}") + public static Collection buildTests() { + Collection tests = new ArrayList<>(); + + Collection tuples = new ArrayList<>(); + tuples.add(newTuple("%3C",Character.valueOf('<'))); + + tuples.add(newTuple("%C4%80",Character.valueOf((char)0x100))); + tuples.add(newTuple("%00",Character.MIN_VALUE)); + tuples.add(newTuple("%3D",'=')); + tuples.add(newTuple("%26",'&')); + + for (char c : PERCENT_CODEC_IMMUNE) { + tuples.add(newTuple(Character.toString(c), c)); + } + + for (CodecCharacterTestTuple tuple : tuples) { + tests.add(new Object[]{tuple}); + } + + return tests; + } + + + + private static CodecCharacterTestTuple newTuple(String encodedInput, Character decoded) { + CodecCharacterTestTuple tuple = new CodecCharacterTestTuple(); + tuple.codec = new PercentCodec(); + tuple.encodeImmune = PERCENT_CODEC_IMMUNE; + tuple.decodedValue = decoded; + tuple.input = encodedInput; + + return tuple; + } + /** + * @param tuple + */ + public PercentCodecCharacterTest(CodecCharacterTestTuple tuple) { + super(tuple); + } + + + @Override + @Test + public void testDecodePushbackSequence() { + //If the input is not decoded, then null should be returned and the pushback string index should be unchanged. + //If the input is decode then the decoded value should be returned, and the pushback string index should have progressed forward. + + PushbackString pbs = new PushbackString(input); + int startIndex = pbs.index(); + boolean shouldDecode = input.startsWith("%"); + if (shouldDecode) { + Assert.assertEquals(decodedValue, codec.decodeCharacter(pbs)); + Assert.assertTrue(startIndex < pbs.index()); + } else { + Assert.assertEquals(null, codec.decodeCharacter(pbs)); + Assert.assertEquals(startIndex, pbs.index()); + } + } + +} diff --git a/src/test/java/org/owasp/esapi/codecs/PercentCodecStringTest.java b/src/test/java/org/owasp/esapi/codecs/PercentCodecStringTest.java new file mode 100644 index 000000000..91ca18b87 --- /dev/null +++ b/src/test/java/org/owasp/esapi/codecs/PercentCodecStringTest.java @@ -0,0 +1,85 @@ +package org.owasp.esapi.codecs; + +import java.util.ArrayList; +import java.util.Collection; +import java.util.List; + +import org.junit.runners.Parameterized.Parameters; +import org.owasp.esapi.codecs.PercentCodec; + +/** + * FIXME: Document intent of class. General Function, purpose of creation, intended feature, etc. + * Why do people care this exists? + * + * @author Jeremiah + * @since Jan 20, 2018 + */ +public class PercentCodecStringTest extends AbstractCodecStringTest { + private static final char[] PERCENT_CODEC_IMMUNE; + + static { + /* + * The percent codec contains a unique immune character set which include letters and numbers that will not be transformed. + * + * It is being replicated here to allow the test to reasonably expect the correct state back. + */ + List immune = new ArrayList(); + // 65 - 90 (capital letters) 97 - 122 lower case 48 - 57 digits + //numbers + for (int index = 48 ; index < 58; index ++) { + immune.add((char)index); + } + //letters + for (int index = 65 ; index < 91; index ++) { + Character capsChar = (char)index; + immune.add(capsChar); + immune.add(Character.toLowerCase(capsChar)); + } + + PERCENT_CODEC_IMMUNE = new char[immune.size()]; + for (int index = 0; index < immune.size(); index++) { + PERCENT_CODEC_IMMUNE[index] = immune.get(index).charValue(); + } + } + + @Parameters(name = "{0}") + public static Collection buildTests() { + Collection tests = new ArrayList<>(); + + List tuples = new ArrayList<>(); + tuples.add(newTuple("%3C", "<")); + + tuples.add(newTuple("%C4%80", (char) 0x100)); + tuples.add(newTuple("%00", Character.MIN_VALUE)); + tuples.add(newTuple("%3D", '=')); + tuples.add(newTuple("%26", '&')); + + for (char c : PERCENT_CODEC_IMMUNE) { + tuples.add(newTuple(Character.toString(c), c)); + } + + for (CodecStringTestTuple tuple : tuples) { + tests.add(new Object[] { tuple }); + } + + return tests; + } + + private static CodecStringTestTuple newTuple(String input, Object decoded) { + CodecStringTestTuple tuple = new CodecStringTestTuple(); + tuple.codec = new PercentCodec(); + tuple.encodeImmune = PERCENT_CODEC_IMMUNE; + tuple.decodedValue = decoded.toString(); + tuple.input = input; + + return tuple; + } + + /** + * @param tuple + */ + public PercentCodecStringTest(CodecStringTestTuple tuple) { + super(tuple); + } + +} From 6f60045cdd20e7b32cb2814734e58eb2c23e8ffe Mon Sep 17 00:00:00 2001 From: Jeremiah Stacey Date: Sat, 20 Jan 2018 09:38:11 -0600 Subject: [PATCH 471/812] Removing unstable tests The tests removed from SafeRequestTest were attempting to validate environment state as well as the unit functionality. The intent of these tests has been distributed to a workflow test check (SecurityWrapperRequestTest), a whitelist validation test (EsapiWhitelistValidationPatternTester), and tests for the PercentCodec's impact on input data (PercentCodecStringTest, PercentCodecCharacterTest). The combination of these tests assert that the pieces that were composing the removed content will function under more explict and controlled conditions. Changes to configuration will nChanges to configuration will now be revealed closer to the component that is directly impacted. --- .../owasp/esapi/filters/SafeRequestTest.java | 61 ------------------- 1 file changed, 61 deletions(-) diff --git a/src/test/java/org/owasp/esapi/filters/SafeRequestTest.java b/src/test/java/org/owasp/esapi/filters/SafeRequestTest.java index e404f8c46..db2f0d770 100644 --- a/src/test/java/org/owasp/esapi/filters/SafeRequestTest.java +++ b/src/test/java/org/owasp/esapi/filters/SafeRequestTest.java @@ -94,67 +94,6 @@ public void testGetQueryStringNull() assertNull(wrappedReq.getQueryString()); } - public void testGetQueryStringNonNull() - { - MockHttpServletRequest req = new MockHttpServletRequest(); - SecurityWrapperRequest wrappedReq; - - req.setQueryString("a=b"); - wrappedReq = new SecurityWrapperRequest(req); - assertEquals("a=b",wrappedReq.getQueryString()); - } - - public void testGetQueryStringNUL() - { - MockHttpServletRequest req = new MockHttpServletRequest(); - SecurityWrapperRequest wrappedReq; - - req.setQueryString("a=\u0000"); - wrappedReq = new SecurityWrapperRequest(req); - assertEquals("",wrappedReq.getQueryString()); - } - - public void testGetQueryStringPercent() - { - MockHttpServletRequest req = new MockHttpServletRequest(); - SecurityWrapperRequest wrappedReq; - - req.setQueryString("a=%62"); - wrappedReq = new SecurityWrapperRequest(req); - assertEquals("a=b",wrappedReq.getQueryString()); - } - - public void testGetQueryStringPercentNUL() - { - MockHttpServletRequest req = new MockHttpServletRequest(); - SecurityWrapperRequest wrappedReq; - - req.setQueryString("a=%00"); - wrappedReq = new SecurityWrapperRequest(req); - assertEquals("a="+Character.MIN_VALUE, wrappedReq.getQueryString()); - } - - public void testGetQueryStringPercentEquals() - { - MockHttpServletRequest req = new MockHttpServletRequest(); - SecurityWrapperRequest wrappedReq; - - req.setQueryString("a=%3d"); - wrappedReq = new SecurityWrapperRequest(req); - assertEquals("a==",wrappedReq.getQueryString()); - } - - public void testGetQueryStringPercentAmpersand() - { - MockHttpServletRequest req = new MockHttpServletRequest(); - SecurityWrapperRequest wrappedReq; - - req.setQueryString("a=%26b"); - wrappedReq = new SecurityWrapperRequest(req); - assertEquals("a=&b",wrappedReq.getQueryString()); - } - - // Test to ensure null-value contract defined by ServletRequest.getParameterNames(String) is met. public void testGetParameterValuesReturnsNullWhenParameterDoesNotExistInRequest() { MockHttpServletRequest request = new MockHttpServletRequest(); From 9d3d93a39d5192bac7835317f76a1cd1a26c921c Mon Sep 17 00:00:00 2001 From: Jeremiah Stacey Date: Mon, 22 Jan 2018 08:33:48 -0600 Subject: [PATCH 472/812] Updating SecurityWrapperRequestTest Test cleanup. Extracting constants & static imports. Adding documentation. Fixing spelling errors. --- .../filters/SecurityWrapperRequestTest.java | 137 ++++++++++++------ 1 file changed, 92 insertions(+), 45 deletions(-) diff --git a/src/test/java/org/owasp/esapi/filters/SecurityWrapperRequestTest.java b/src/test/java/org/owasp/esapi/filters/SecurityWrapperRequestTest.java index 3200700c1..bf1a2d627 100644 --- a/src/test/java/org/owasp/esapi/filters/SecurityWrapperRequestTest.java +++ b/src/test/java/org/owasp/esapi/filters/SecurityWrapperRequestTest.java @@ -1,35 +1,48 @@ package org.owasp.esapi.filters; +import static org.junit.Assert.assertEquals; +import static org.junit.Assert.assertTrue; +import static org.mockito.Matchers.anyBoolean; +import static org.mockito.Matchers.anyInt; +import static org.mockito.Matchers.anyString; +import static org.mockito.Mockito.times; +import static org.mockito.Mockito.verify; + import javax.servlet.http.HttpServletRequest; -import org.junit.Assert; import org.junit.Before; import org.junit.Test; import org.junit.runner.RunWith; import org.mockito.ArgumentCaptor; -import org.mockito.Matchers; import org.mockito.Mock; -import org.mockito.Mockito; import org.owasp.esapi.ESAPI; import org.owasp.esapi.SecurityConfiguration; import org.owasp.esapi.Validator; import org.owasp.esapi.errors.IntrusionException; import org.owasp.esapi.errors.ValidationException; -import org.owasp.esapi.filters.SecurityWrapperRequest; import org.powermock.api.mockito.PowerMockito; import org.powermock.core.classloader.annotations.PrepareForTest; import org.powermock.modules.junit4.PowerMockRunner; /** - * FIXME: Document intent of class. General Function, purpose of creation, intended feature, etc. - * Why do people care this exists? - * - * @author Jeremiah - * @since Jan 3, 2018 + * Unit tests for {@link SecurityWrapperRequest}. + *
+ * This test uses static context mocking! This can affect certain behaviors if it is executed in a JVM container with + * other tests depending on the same static reference - Which is going to be everything. + *
+ * This may affect some test environments, mostly IDE's. It is not expected that this impacts the Maven build, as + * surefire plugin isolates JVM's for tests during that phase. */ @RunWith(PowerMockRunner.class) @PrepareForTest(ESAPI.class) public class SecurityWrapperRequestTest { + private static final String ESAPI_VALIDATOR_GETTER_METHOD_NAME = "validator"; + private static final String ESAPY_SECURITY_CONFIGURATION_GETTER_METHOD_NAME = "securityConfiguration"; + private static final String SECURITY_CONFIGURATION_LENGTH_KEY_NAME = "HttpUtilities.URILENGTH"; + + private static final int SECURITY_CONFIGURATION_MOCK_LENGTH = 255; + + private static final String QUERY_STRING_CANONCALIZE_TYPE_KEY = "HTTPQueryString"; @Mock private HttpServletRequest mockRequest; @@ -41,68 +54,102 @@ public class SecurityWrapperRequestTest { @Before public void setup() throws Exception { PowerMockito.mockStatic(ESAPI.class); - PowerMockito.when(ESAPI.class, "validator").thenReturn(mockValidator); - PowerMockito.when(ESAPI.class, "securityConfiguration").thenReturn(mockSecConfig); + PowerMockito.when(ESAPI.class, ESAPI_VALIDATOR_GETTER_METHOD_NAME).thenReturn(mockValidator); + PowerMockito.when(ESAPI.class, ESAPY_SECURITY_CONFIGURATION_GETTER_METHOD_NAME).thenReturn(mockSecConfig); } - + + /** + * Workflow test for happy-path getQueryString. Asserts delegation calls and parameters to delegate + * behaviors. + */ @Test - public void testGetQueryString() throws IntrusionException, ValidationException { - String queryString = "queryString"; - int maxLength = 255; + public void testGetQueryString() throws Exception { + String originalQuery = "queryString"; + String canonicalizedResponse = "canonicalized_query"; ArgumentCaptor inputCapture = ArgumentCaptor.forClass(String.class); ArgumentCaptor typeCapture = ArgumentCaptor.forClass(String.class); - ArgumentCaptor lenghtCapture = ArgumentCaptor.forClass(Integer.class); + ArgumentCaptor lengthCapture = ArgumentCaptor.forClass(Integer.class); ArgumentCaptor allowNullCapture = ArgumentCaptor.forClass(Boolean.class); - PowerMockito.when(mockValidator.getValidInput(Matchers.anyString(), inputCapture.capture(), typeCapture - .capture(), lenghtCapture.capture(), allowNullCapture.capture())).thenReturn("canonicalized"); - PowerMockito.when(mockSecConfig.getIntProp("HttpUtilities.URILENGTH")).thenReturn(maxLength); - PowerMockito.when(mockRequest.getQueryString()).thenReturn(queryString); + String context = anyString(); + String input = inputCapture.capture(); + String type = typeCapture.capture(); + Integer length = lengthCapture.capture(); + Boolean allowNull = allowNullCapture.capture(); + + PowerMockito.when(mockValidator.getValidInput(context, input, type, length, allowNull)).thenReturn( + canonicalizedResponse); + PowerMockito.when(mockSecConfig.getIntProp(SECURITY_CONFIGURATION_LENGTH_KEY_NAME)).thenReturn( + SECURITY_CONFIGURATION_MOCK_LENGTH); + + PowerMockito.when(mockRequest.getQueryString()).thenReturn(originalQuery); SecurityWrapperRequest request = new SecurityWrapperRequest(mockRequest); String rval = request.getQueryString(); - Assert.assertEquals("canonicalized", rval); + assertEquals(canonicalizedResponse, rval); - Assert.assertEquals(queryString, inputCapture.getValue()); - Assert.assertEquals("HTTPQueryString", typeCapture.getValue()); - Assert.assertTrue(maxLength == lenghtCapture.getValue().intValue()); - Assert.assertEquals(true, allowNullCapture.getValue()); + String actualInput = inputCapture.getValue(); + String actualType = typeCapture.getValue(); + int actualLength = lengthCapture.getValue().intValue(); + boolean actualAllowNull = allowNullCapture.getValue().booleanValue(); - Mockito.verify(mockValidator, Mockito.times(1)).getValidInput(Matchers.anyString(), Matchers.anyString(), - Matchers.anyString(), Matchers.anyInt(), Matchers.anyBoolean()); - Mockito.verify(mockSecConfig, Mockito.times(1)).getIntProp("HttpUtilities.URILENGTH"); - Mockito.verify(mockRequest, Mockito.times(1)).getQueryString(); + assertEquals(originalQuery, actualInput); + assertEquals(QUERY_STRING_CANONCALIZE_TYPE_KEY, actualType); + assertTrue(SECURITY_CONFIGURATION_MOCK_LENGTH == actualLength); + assertTrue(actualAllowNull); + + verify(mockValidator, times(1)).getValidInput(anyString(), anyString(), anyString(), anyInt(), anyBoolean()); + verify(mockSecConfig, times(1)).getIntProp(SECURITY_CONFIGURATION_LENGTH_KEY_NAME); + verify(mockRequest, times(1)).getQueryString(); } + /** + * Test for getQueryString when validation throws an Exception. + *
+ * Asserts delegation calls and parameters to delegate behaviors. + */ @SuppressWarnings("unchecked") @Test public void testGetQueryStringCanonicalizeException() throws IntrusionException, ValidationException { - String queryString = "queryString"; - int maxLength = 255; + String originalQuery = "queryString"; ArgumentCaptor inputCapture = ArgumentCaptor.forClass(String.class); ArgumentCaptor typeCapture = ArgumentCaptor.forClass(String.class); - ArgumentCaptor lenghtCapture = ArgumentCaptor.forClass(Integer.class); + ArgumentCaptor lengthCapture = ArgumentCaptor.forClass(Integer.class); ArgumentCaptor allowNullCapture = ArgumentCaptor.forClass(Boolean.class); - PowerMockito.when(mockValidator.getValidInput(Matchers.anyString(), inputCapture.capture(), typeCapture - .capture(), lenghtCapture.capture(), allowNullCapture.capture())).thenThrow(ValidationException.class); - PowerMockito.when(mockSecConfig.getIntProp("HttpUtilities.URILENGTH")).thenReturn(maxLength); - PowerMockito.when(mockRequest.getQueryString()).thenReturn(queryString); + String context = anyString(); + String input = inputCapture.capture(); + String type = typeCapture.capture(); + Integer length = lengthCapture.capture(); + Boolean allowNull = allowNullCapture.capture(); + + PowerMockito.when(mockValidator.getValidInput(context, input, type, length, allowNull)).thenThrow( + ValidationException.class); + PowerMockito.when(mockSecConfig.getIntProp(SECURITY_CONFIGURATION_LENGTH_KEY_NAME)).thenReturn( + SECURITY_CONFIGURATION_MOCK_LENGTH); + + PowerMockito.when(mockRequest.getQueryString()).thenReturn(originalQuery); SecurityWrapperRequest request = new SecurityWrapperRequest(mockRequest); String rval = request.getQueryString(); - Assert.assertEquals("", rval); - Assert.assertEquals(queryString, inputCapture.getValue()); - Assert.assertEquals("HTTPQueryString", typeCapture.getValue()); - Assert.assertTrue(maxLength == lenghtCapture.getValue().intValue()); - Assert.assertEquals(true, allowNullCapture.getValue()); + assertTrue("SecurityWrapperRequest should return an empty String when an exception occurs in validation", rval + .isEmpty()); + + String actualInput = inputCapture.getValue(); + String actualType = typeCapture.getValue(); + int actualLength = lengthCapture.getValue().intValue(); + boolean actualAllowNull = allowNullCapture.getValue().booleanValue(); + + assertEquals(originalQuery, actualInput); + assertEquals(QUERY_STRING_CANONCALIZE_TYPE_KEY, actualType); + assertTrue(SECURITY_CONFIGURATION_MOCK_LENGTH == actualLength); + assertTrue(actualAllowNull); - Mockito.verify(mockValidator, Mockito.times(1)).getValidInput(Matchers.anyString(), Matchers.anyString(), - Matchers.anyString(), Matchers.anyInt(), Matchers.anyBoolean()); - Mockito.verify(mockSecConfig, Mockito.times(1)).getIntProp("HttpUtilities.URILENGTH"); - Mockito.verify(mockRequest, Mockito.times(1)).getQueryString(); + verify(mockValidator, times(1)).getValidInput(anyString(), anyString(), anyString(), anyInt(), anyBoolean()); + verify(mockSecConfig, times(1)).getIntProp(SECURITY_CONFIGURATION_LENGTH_KEY_NAME); + verify(mockRequest, times(1)).getQueryString(); } } From c3870f660439e39a22a14ca013c8da17aa59eb66 Mon Sep 17 00:00:00 2001 From: Jeremiah Stacey Date: Mon, 22 Jan 2018 08:47:34 -0600 Subject: [PATCH 473/812] Pattern Validation Test Cleanup Adding documentation to the AbstractPatternTest to help with usability. Extracting message constant to a class var in EsapiWhitelistValidaitonPatternTests for improved readability. --- .../esapi/reference/AbstractPatternTest.java | 35 ++++++++------ ...EsapiWhitelistValidationPatternTester.java | 46 +++++++++---------- 2 files changed, 43 insertions(+), 38 deletions(-) diff --git a/src/test/java/org/owasp/esapi/reference/AbstractPatternTest.java b/src/test/java/org/owasp/esapi/reference/AbstractPatternTest.java index 3fd72ebaf..9cf1e0e20 100644 --- a/src/test/java/org/owasp/esapi/reference/AbstractPatternTest.java +++ b/src/test/java/org/owasp/esapi/reference/AbstractPatternTest.java @@ -7,43 +7,50 @@ import org.junit.runner.RunWith; import org.junit.runners.Parameterized; - /** - * FIXME: Document intent of class. General Function, purpose of creation, intended feature, etc. - * Why do people care this exists? - * @author Jeremiah - * @since Jan 20, 2018 - * + * Abstract parameterized test case meant to assist with verifying regular expressions in test scope. + *
+ * Sub-classes are expected to provide instances of {@link PatternTestTuple} to this instance. + *
+ * For better test naming output specify {@link PatternTestTuple#description} and use {@code} @Parameters (name="{0}")}, + * where '0' is the index that the PatternTestTuple reference appears in the constructor. */ -@RunWith (Parameterized.class) +@RunWith(Parameterized.class) public abstract class AbstractPatternTest { - + + /** + * Test tuple for Pattern validation. + */ protected static class PatternTestTuple { + /** String value to be tested against the compiled regex reference. */ String input; + /** Regular expression string that will be compiled and be passed the input. */ String regex; + /** Test Expectation whether input should match the compiled regex. */ boolean shouldMatch; + /** Optional field to override the toString value of this tuple. */ String description; - /** {@inheritDoc}*/ + + /** {@inheritDoc} */ @Override public String toString() { - return description != null ? description : regex; + return description != null ? description : regex; } } private String input; private Pattern pattern; private boolean shouldMatch; - - + public AbstractPatternTest(PatternTestTuple tuple) { this.input = tuple.input; this.pattern = Pattern.compile(tuple.regex); this.shouldMatch = tuple.shouldMatch; } - + @Test public void checkPatternMatches() { Assert.assertEquals(shouldMatch, pattern.matcher(input).matches()); } - + } diff --git a/src/test/java/org/owasp/esapi/reference/EsapiWhitelistValidationPatternTester.java b/src/test/java/org/owasp/esapi/reference/EsapiWhitelistValidationPatternTester.java index 4a1bd5ffb..d00d4c19a 100644 --- a/src/test/java/org/owasp/esapi/reference/EsapiWhitelistValidationPatternTester.java +++ b/src/test/java/org/owasp/esapi/reference/EsapiWhitelistValidationPatternTester.java @@ -10,9 +10,7 @@ /** * Extension of the AbstractPatternTest which focuses on asserting that the default whitelist regex values applied in * the validation process are performing the intended function in the environment. - * *
- * * If the regex values in this test are found to not match the running environment configurations, then the tests will * be skipped. * @@ -20,26 +18,30 @@ * @since Jan 20, 2018 */ public class EsapiWhitelistValidationPatternTester extends AbstractPatternTest { - //See ESAPI.properties - private static final String HTTP_QUERY_STRING_PROP_NAME="HTTPQueryString"; - private static final String HTTP_QUERY_STRING_REGEX="^([a-zA-Z0-9_\\-]{1,32}=[\\p{L}\\p{N}.\\-/+=_ !$*?@%]*&?)*$"; + // See ESAPI.properties + private static final String HTTP_QUERY_STRING_PROP_NAME = "HTTPQueryString"; + private static final String HTTP_QUERY_STRING_REGEX = "^([a-zA-Z0-9_\\-]{1,32}=[\\p{L}\\p{N}.\\-/+=_ !$*?@%]*&?)*$"; + + private static final String CONFIGURATION_PATTERN_MISMATCH_MESSAGE = "The regular expression specified does not match the configuration settings.\n" + + "If the value was changed from the ESAPI default, it is recommended to copy " + + "this class into your project, update the regex being tested, and update all " + + "associated input expectations for your unique environment."; @Parameters(name = "{0}-{1}") public static Collection createDefaultPatternTests() { Collection parameters = new ArrayList<>(); - - for(PatternTestTuple tuple : buildHttpQueryStringTests()) { + + for (PatternTestTuple tuple : buildHttpQueryStringTests()) { parameters.add(new Object[] { HTTP_QUERY_STRING_PROP_NAME, tuple }); } - return parameters; } - + private static Collection buildHttpQueryStringTests() { - Collection httpQueryStringTests = new ArrayList<>(); - - //MATCHING CASES + Collection httpQueryStringTests = new ArrayList<>(); + + // MATCHING CASES PatternTestTuple tuple = newHttpQueryStringTuple("Default Case", "b", true); httpQueryStringTests.add(tuple); tuple = newHttpQueryStringTuple("Percent Encoded Value", "%62", true); @@ -48,27 +50,27 @@ private static Collection buildHttpQueryStringTests() { httpQueryStringTests.add(tuple); tuple = newHttpQueryStringTuple("Double Equals", "=", true); httpQueryStringTests.add(tuple); - - //NON-MATCHING CASES + + // NON-MATCHING CASES tuple = newHttpQueryStringTuple("Ampersand In Value", "&b", false); httpQueryStringTests.add(tuple); - tuple = newHttpQueryStringTuple("Null Character", ""+Character.MIN_VALUE, false); + tuple = newHttpQueryStringTuple("Null Character", "" + Character.MIN_VALUE, false); httpQueryStringTests.add(tuple); tuple = newHttpQueryStringTuple("Encoded Null Character", "\u0000", false); httpQueryStringTests.add(tuple); - + return httpQueryStringTests; } private static PatternTestTuple newHttpQueryStringTuple(String description, String value, boolean shouldPass) { PatternTestTuple tuple = new PatternTestTuple(); - tuple.input = "a="+value; + tuple.input = "a=" + value; tuple.shouldMatch = shouldPass; tuple.regex = HTTP_QUERY_STRING_REGEX; tuple.description = description; return tuple; } - + public EsapiWhitelistValidationPatternTester(String property, PatternTestTuple tuple) { super(tuple); /* @@ -80,12 +82,8 @@ public EsapiWhitelistValidationPatternTester(String property, PatternTestTuple t * behavior. */ DefaultSecurityConfiguration configuration = new DefaultSecurityConfiguration(); - Assume.assumeTrue( - "The regular expression specified does not match the configuration settings.\n" - + "If the value was changed from the ESAPI default, it is recommended to copy " - + "this class into your project, update the regex being tested, and update all " - + "associated input expectations for your unique environment.", - configuration.getValidationPattern(property).toString().equals(tuple.regex)); + Assume.assumeTrue(CONFIGURATION_PATTERN_MISMATCH_MESSAGE, configuration.getValidationPattern(property) + .toString().equals(tuple.regex)); } } From c4d77b142edc14d22fcba6b6d7f8ffc7f0221394 Mon Sep 17 00:00:00 2001 From: Jeremiah Stacey Date: Mon, 22 Jan 2018 09:30:24 -0600 Subject: [PATCH 474/812] PercentCodecCharacterTest cleanup Splitting up the PushbackSequence test for better readability. Adding documentation. Whitespace cleanup. --- .../codecs/PercentCodecCharacterTest.java | 105 ++++++++++-------- 1 file changed, 58 insertions(+), 47 deletions(-) diff --git a/src/test/java/org/owasp/esapi/codecs/PercentCodecCharacterTest.java b/src/test/java/org/owasp/esapi/codecs/PercentCodecCharacterTest.java index 9617ccb9c..ca7ddf1b6 100644 --- a/src/test/java/org/owasp/esapi/codecs/PercentCodecCharacterTest.java +++ b/src/test/java/org/owasp/esapi/codecs/PercentCodecCharacterTest.java @@ -11,98 +11,109 @@ import org.owasp.esapi.codecs.PushbackString; /** - * FIXME: Document intent of class. General Function, purpose of creation, intended feature, etc. - * Why do people care this exists? - * @author Jeremiah - * @since Jan 20, 2018 - * + * Codec validation focused on the PercentCodec Character-based api. + * */ public class PercentCodecCharacterTest extends AbstractCodecCharacterTest { private static final char[] PERCENT_CODEC_IMMUNE; static { /* - * The percent codec contains a unique immune character set which include letters and numbers that will not be transformed. - * + * The percent codec contains a unique immune character set which include letters and numbers that will not be + * transformed. * It is being replicated here to allow the test to reasonably expect the correct state back. */ List immune = new ArrayList<>(); // 65 - 90 (capital letters) 97 - 122 lower case 48 - 57 digits - //numbers - for (int index = 48 ; index < 58; index ++) { - immune.add((char)index); + // numbers + for (int index = 48; index < 58; index++) { + immune.add((char) index); } - //letters - for (int index = 65 ; index < 91; index ++) { - Character capsChar = (char)index; + // letters + for (int index = 65; index < 91; index++) { + Character capsChar = (char) index; immune.add(capsChar); - immune.add(Character.toLowerCase(capsChar)); + immune.add(Character.toLowerCase(capsChar)); } - + PERCENT_CODEC_IMMUNE = new char[immune.size()]; for (int index = 0; index < immune.size(); index++) { PERCENT_CODEC_IMMUNE[index] = immune.get(index).charValue(); } } - @Parameters(name="{0}") + @Parameters(name = "{0}") public static Collection buildTests() { Collection tests = new ArrayList<>(); - + Collection tuples = new ArrayList<>(); - tuples.add(newTuple("%3C",Character.valueOf('<'))); - - tuples.add(newTuple("%C4%80",Character.valueOf((char)0x100))); - tuples.add(newTuple("%00",Character.MIN_VALUE)); - tuples.add(newTuple("%3D",'=')); - tuples.add(newTuple("%26",'&')); - + tuples.add(newTuple("%3C", Character.valueOf('<'))); + + tuples.add(newTuple("%C4%80", Character.valueOf((char) 0x100))); + tuples.add(newTuple("%00", Character.MIN_VALUE)); + tuples.add(newTuple("%3D", '=')); + tuples.add(newTuple("%26", '&')); + for (char c : PERCENT_CODEC_IMMUNE) { tuples.add(newTuple(Character.toString(c), c)); } - + for (CodecCharacterTestTuple tuple : tuples) { - tests.add(new Object[]{tuple}); + tests.add(new Object[] { tuple }); } - + return tests; } - - - + private static CodecCharacterTestTuple newTuple(String encodedInput, Character decoded) { CodecCharacterTestTuple tuple = new CodecCharacterTestTuple(); tuple.codec = new PercentCodec(); tuple.encodeImmune = PERCENT_CODEC_IMMUNE; tuple.decodedValue = decoded; tuple.input = encodedInput; - + return tuple; } - /** - * @param tuple - */ + public PercentCodecCharacterTest(CodecCharacterTestTuple tuple) { super(tuple); } - - + @Override @Test public void testDecodePushbackSequence() { - //If the input is not decoded, then null should be returned and the pushback string index should be unchanged. - //If the input is decode then the decoded value should be returned, and the pushback string index should have progressed forward. - - PushbackString pbs = new PushbackString(input); - int startIndex = pbs.index(); - boolean shouldDecode = input.startsWith("%"); - if (shouldDecode) { - Assert.assertEquals(decodedValue, codec.decodeCharacter(pbs)); - Assert.assertTrue(startIndex < pbs.index()); + // check duplicated from PushbackSequence handling in PercentCodec. + boolean inputIsEncoded = input.startsWith("%"); + + if (inputIsEncoded) { + assertInputIsDecodedToValue(); } else { - Assert.assertEquals(null, codec.decodeCharacter(pbs)); - Assert.assertEquals(startIndex, pbs.index()); + assertInputIsDecodedToNull(); } } + /** + * tests that when Input is decoded through a PushbackString that the decodedValue reference is returned and that + * the PushbackString index has incremented. + */ + @SuppressWarnings("unchecked") + private void assertInputIsDecodedToValue() { + PushbackString pbs = new PushbackString(input); + int startIndex = pbs.index(); + Assert.assertEquals(decodedValue, codec.decodeCharacter(pbs)); + Assert.assertTrue(startIndex < pbs.index()); + } + + /** + * tests that when Input is decoded through a PushbackString that null is returned and that the PushbackString index + * remains unchanged. + */ + @SuppressWarnings("unchecked") + private void assertInputIsDecodedToNull() { + PushbackString pbs = new PushbackString(input); + int startIndex = pbs.index(); + Assert.assertEquals(null, codec.decodeCharacter(pbs)); + Assert.assertEquals(startIndex, pbs.index()); + } + } From d44275761b28169fcff1ed9a61450a68855b7a9f Mon Sep 17 00:00:00 2001 From: Jeremiah Stacey Date: Mon, 22 Jan 2018 09:50:51 -0600 Subject: [PATCH 475/812] AbstractCodecCharacterTest Cleanup Adding documentation. Updating static imports. --- .../codecs/AbstractCodecCharacterTest.java | 41 ++++++++++++------- 1 file changed, 27 insertions(+), 14 deletions(-) diff --git a/src/test/java/org/owasp/esapi/codecs/AbstractCodecCharacterTest.java b/src/test/java/org/owasp/esapi/codecs/AbstractCodecCharacterTest.java index f6b708a67..1101be47f 100644 --- a/src/test/java/org/owasp/esapi/codecs/AbstractCodecCharacterTest.java +++ b/src/test/java/org/owasp/esapi/codecs/AbstractCodecCharacterTest.java @@ -1,30 +1,36 @@ package org.owasp.esapi.codecs; +import static org.junit.Assert.assertEquals; + import java.util.Arrays; -import org.junit.Assert; import org.junit.Test; import org.junit.runner.RunWith; import org.junit.runners.Parameterized; -import org.owasp.esapi.codecs.Codec; -import org.owasp.esapi.codecs.PushbackString; /** - * FIXME: Document intent of class. General Function, purpose of creation, intended feature, etc. - * Why do people care this exists? - * @author Jeremiah - * @since Jan 20, 2018 - * + * Abstract parameterized test case meant to assist with verifying Character api of a Codec implementation. + *
+ * Sub-classes are expected to provide instances of {@link CodecCharacterTestTuple} to this instance. + *
+ * For better test naming output specify {@link CodecCharacterTestTuple#description} and use {@code} @Parameters (name="{0}")}, + * where '0' is the index that the CodecCharacterTestTuple reference appears in the constructor. */ @RunWith(Parameterized.class) public abstract class AbstractCodecCharacterTest { + /** Test Data Tuple.*/ protected static class CodecCharacterTestTuple { + /** Codec reference to be tested.*/ Codec codec; + /** Set of characters that should be considered 'immune' from decoding processes.*/ char[] encodeImmune; + /** A String representing a single encoded character.*/ String input; + /** The single character that input represents.*/ Character decodedValue; + /** Optional field to override the toString value of this tuple. */ String description; /** {@inheritDoc}*/ @@ -46,27 +52,34 @@ public AbstractCodecCharacterTest(CodecCharacterTestTuple tuple) { this.decodedValue = tuple.decodedValue; this.encodeImmune = tuple.encodeImmune; } - + + /** Checks that the input value matches the result of the codec encoding the decoded value. */ @Test public void testEncodeCharacter() { - Assert.assertEquals(input, codec.encodeCharacter(encodeImmune, decodedValue)); + assertEquals(input, codec.encodeCharacter(encodeImmune, decodedValue)); } + /** Checks encoding the character as a String. + *
+ * If the decoded value is in the immunity list, the the decoded value should be returned from the encode call. + * Otherwise, input is expected as the return. + */ @Test public void testEncode() { String expected = Arrays.asList(encodeImmune).contains(decodedValue) ? decodedValue.toString() : input; - Assert.assertEquals(expected, codec.encode(encodeImmune, decodedValue.toString())); + assertEquals(expected, codec.encode(encodeImmune, decodedValue.toString())); } + /** Checks that decoding the input value yeilds the decodedValue.*/ @Test public void testDecode() { - Assert.assertEquals(decodedValue.toString(), codec.decode(input)); + assertEquals(decodedValue.toString(), codec.decode(input)); } - + /** Checks that the encoded input String is correctly decoded to the single decodedValue character reference.*/ @Test public void testDecodePushbackSequence() { - Assert.assertEquals(decodedValue, codec.decodeCharacter(new PushbackString(input))); + assertEquals(decodedValue, codec.decodeCharacter(new PushbackString(input))); } } From dc20f53efbf026b9470ecc0092c25cbc7243b9f8 Mon Sep 17 00:00:00 2001 From: Jeremiah Stacey Date: Mon, 22 Jan 2018 09:58:25 -0600 Subject: [PATCH 476/812] AbstractCodecStringTest Cleanup Adding documentation. Removed a copy/pasta check from testEncode (originally from AbstractCodecCharacterTest). --- .../esapi/codecs/AbstractCodecStringTest.java | 26 ++++++++++++------- 1 file changed, 16 insertions(+), 10 deletions(-) diff --git a/src/test/java/org/owasp/esapi/codecs/AbstractCodecStringTest.java b/src/test/java/org/owasp/esapi/codecs/AbstractCodecStringTest.java index 27d0ea12e..eb31da763 100644 --- a/src/test/java/org/owasp/esapi/codecs/AbstractCodecStringTest.java +++ b/src/test/java/org/owasp/esapi/codecs/AbstractCodecStringTest.java @@ -7,23 +7,30 @@ import org.junit.runner.RunWith; import org.junit.runners.Parameterized; import org.owasp.esapi.codecs.Codec; +import org.owasp.esapi.codecs.AbstractCodecCharacterTest.CodecCharacterTestTuple; /** - * FIXME: Document intent of class. General Function, purpose of creation, intended feature, etc. - * Why do people care this exists? - * @author Jeremiah - * @since Jan 20, 2018 - * + * Abstract parameterized test case meant to assist with verifying String api of a Codec implementation. + *
+ * Sub-classes are expected to provide instances of {@link CodecStringTestTuple} to this instance. + *
+ * For better test naming output specify {@link CodecStringTestTuple#description} and use {@code} @Parameters (name="{0}")}, + * where '0' is the index that the CodecStringTestTuple reference appears in the constructor. */ @RunWith(Parameterized.class) public abstract class AbstractCodecStringTest { protected static class CodecStringTestTuple { + /** Codec reference to be tested.*/ Codec codec; + /** Set of characters that should be considered 'immune' from decoding processes.*/ char[] encodeImmune; + /** A String representing a contextually encoded String.*/ String input; + /** The decoded representation of the input value.*/ String decodedValue; + /** Optional field to override the toString value of this tuple. */ String description; /** {@inheritDoc}*/ @@ -32,8 +39,6 @@ public String toString() { return description != null ? description : codec.getClass().getSimpleName() + " "+input; } } - - private final Codec codec; private final String input; private final char[] encodeImmune; @@ -46,16 +51,17 @@ public AbstractCodecStringTest(CodecStringTestTuple tuple) { this.encodeImmune = tuple.encodeImmune; } + + /** Checks that when the input is decoded using the specified codec, that the return matches the expected decoded value.*/ @Test public void testDecode() { Assert.assertEquals(decodedValue, codec.decode(input)); } - + /** Checks that when the decoded value is encoded (using immunity), that the return matches the provided input.*/ @Test public void testEncode() { - String expected = Arrays.asList(encodeImmune).contains(decodedValue) ? decodedValue : input; - Assert.assertEquals(expected, codec.encode(encodeImmune, decodedValue)); + Assert.assertEquals(input, codec.encode(encodeImmune, decodedValue)); } } From eb42bc0598099ae19b0896add592740aa718a38b Mon Sep 17 00:00:00 2001 From: Jeremiah Stacey Date: Mon, 22 Jan 2018 10:01:39 -0600 Subject: [PATCH 477/812] Round2: AbstractCodecStringTest cleanup Correcting imports that snuck in while I was working on documentation updates. --- .../java/org/owasp/esapi/codecs/AbstractCodecStringTest.java | 4 ---- 1 file changed, 4 deletions(-) diff --git a/src/test/java/org/owasp/esapi/codecs/AbstractCodecStringTest.java b/src/test/java/org/owasp/esapi/codecs/AbstractCodecStringTest.java index eb31da763..b3fe53156 100644 --- a/src/test/java/org/owasp/esapi/codecs/AbstractCodecStringTest.java +++ b/src/test/java/org/owasp/esapi/codecs/AbstractCodecStringTest.java @@ -1,13 +1,9 @@ package org.owasp.esapi.codecs; -import java.util.Arrays; - import org.junit.Assert; import org.junit.Test; import org.junit.runner.RunWith; import org.junit.runners.Parameterized; -import org.owasp.esapi.codecs.Codec; -import org.owasp.esapi.codecs.AbstractCodecCharacterTest.CodecCharacterTestTuple; /** From 674dee017337b89aa1a28a9c67b5004f538ba4ab Mon Sep 17 00:00:00 2001 From: Jeremiah Stacey Date: Mon, 22 Jan 2018 10:02:52 -0600 Subject: [PATCH 478/812] PercentCodecStringTest cleanup Adding documentation. Fixing a java generics declaration warning. --- .../org/owasp/esapi/codecs/PercentCodecStringTest.java | 9 +++------ 1 file changed, 3 insertions(+), 6 deletions(-) diff --git a/src/test/java/org/owasp/esapi/codecs/PercentCodecStringTest.java b/src/test/java/org/owasp/esapi/codecs/PercentCodecStringTest.java index 91ca18b87..a851ebcae 100644 --- a/src/test/java/org/owasp/esapi/codecs/PercentCodecStringTest.java +++ b/src/test/java/org/owasp/esapi/codecs/PercentCodecStringTest.java @@ -8,11 +8,8 @@ import org.owasp.esapi.codecs.PercentCodec; /** - * FIXME: Document intent of class. General Function, purpose of creation, intended feature, etc. - * Why do people care this exists? - * - * @author Jeremiah - * @since Jan 20, 2018 + * Codec validation focused on the PercentCodec String-based api. + * */ public class PercentCodecStringTest extends AbstractCodecStringTest { private static final char[] PERCENT_CODEC_IMMUNE; @@ -23,7 +20,7 @@ public class PercentCodecStringTest extends AbstractCodecStringTest { * * It is being replicated here to allow the test to reasonably expect the correct state back. */ - List immune = new ArrayList(); + List immune = new ArrayList<>(); // 65 - 90 (capital letters) 97 - 122 lower case 48 - 57 digits //numbers for (int index = 48 ; index < 58; index ++) { From 93bf6928bb36ac4ac947d2b42c727c5513371b19 Mon Sep 17 00:00:00 2001 From: Jeremiah Stacey Date: Mon, 22 Jan 2018 14:06:55 -0600 Subject: [PATCH 479/812] Introducing Codec CodePoint abstraction Adding ignored test structure to share implementation thought. Has failing tests presently, probably due to incorrect test structure and/or expectations. Working to resolve. --- .../codecs/AbstractCodecCodePointTest.java | 78 +++++++++++ .../codecs/PercentCodecCodePointTest.java | 121 ++++++++++++++++++ 2 files changed, 199 insertions(+) create mode 100644 src/test/java/org/owasp/esapi/codecs/AbstractCodecCodePointTest.java create mode 100644 src/test/java/org/owasp/esapi/codecs/PercentCodecCodePointTest.java diff --git a/src/test/java/org/owasp/esapi/codecs/AbstractCodecCodePointTest.java b/src/test/java/org/owasp/esapi/codecs/AbstractCodecCodePointTest.java new file mode 100644 index 000000000..7d79d55bc --- /dev/null +++ b/src/test/java/org/owasp/esapi/codecs/AbstractCodecCodePointTest.java @@ -0,0 +1,78 @@ +package org.owasp.esapi.codecs; + +import static org.junit.Assert.assertEquals; +import static org.junit.Assert.assertTrue; + +import org.junit.Test; +import org.junit.runner.RunWith; +import org.junit.runners.Parameterized; + + +/** + * Abstract parameterized test case meant to assist with verifying Character api of a Codec implementation. + *
+ * Sub-classes are expected to provide instances of {@link CodecCodePointTestTuple} to this instance. + *
+ * For better test naming output specify {@link CodecCodePointTestTuple#description} and use {@code} @Parameters (name="{0}")}, + * where '0' is the index that the CodecCodePointTestTuple reference appears in the constructor. + */ +@RunWith(Parameterized.class) +public abstract class AbstractCodecCodePointTest { + + /** Test Data Tuple.*/ + protected static class CodecCodePointTestTuple { + /** Codec reference to be tested.*/ + Codec codec; + /** Set of characters that should be considered 'immune' from decoding processes.*/ + char[] encodeImmune; + /** A String representing a single encoded character.*/ + String input; + /** The int code point that input represents.*/ + int codePoint; + /** Optional field to override the toString value of this tuple. */ + String description; + /** {@inheritDoc}*/ + + @Override + public String toString() { + return description != null ? description : codec.getClass().getSimpleName() + " "+input; + } + } + + + protected final Codec codec; + protected final String input; + protected final char[] encodeImmune; + protected final int decodedValue; + protected final char codePointChar; + + public AbstractCodecCodePointTest(CodecCodePointTestTuple tuple) { + this.codec = tuple.codec; + this.input = tuple.input; + this.decodedValue = tuple.codePoint; + this.encodeImmune = tuple.encodeImmune; + this.codePointChar = (char) tuple.codePoint; + } + + /** Checks that the input value matches the result of the codec encoding the decoded value. */ + @Test + public void testEncodeCharacter() { + assertEquals(input, codec.encodeCharacter(encodeImmune, decodedValue)); + } + + /** Checks that decoding the input value yeilds the same code point decodedValue.*/ + @Test + public void testDecode() { + int expectedLength = Character.toString(codePointChar).length(); + String actualDecode = codec.decode(input); + assertTrue("CodePoint test input should decode to a String consisting of a single character: " + actualDecode + " " + actualDecode.length(),actualDecode.length() == expectedLength); + assertEquals(decodedValue, (int)actualDecode.charAt(0)); + } + + /** Checks that the encoded input String is correctly decoded to the single decodedValue character reference.*/ + @Test + public void testDecodePushbackSequence() { + assertEquals(decodedValue, codec.decodeCharacter(new PushbackString(input))); + } + +} diff --git a/src/test/java/org/owasp/esapi/codecs/PercentCodecCodePointTest.java b/src/test/java/org/owasp/esapi/codecs/PercentCodecCodePointTest.java new file mode 100644 index 000000000..d44d16097 --- /dev/null +++ b/src/test/java/org/owasp/esapi/codecs/PercentCodecCodePointTest.java @@ -0,0 +1,121 @@ +package org.owasp.esapi.codecs; + +import java.util.ArrayList; +import java.util.Collection; +import java.util.List; + +import org.junit.Assert; +import org.junit.Ignore; +import org.junit.Test; +import org.junit.runners.Parameterized.Parameters; + +/** + * Codec validation focused on the PercentCodec codepoint-based api. + * + */ +@Ignore(value="Implementation pending") +public class PercentCodecCodePointTest extends AbstractCodecCodePointTest { + private static final char[] PERCENT_CODEC_IMMUNE; + + static { + /* + * The percent codec contains a unique immune character set which include letters and numbers that will not be + * transformed. + * It is being replicated here to allow the test to reasonably expect the correct state back. + */ + List immune = new ArrayList<>(); + // 65 - 90 (capital letters) 97 - 122 lower case 48 - 57 digits + // numbers + for (int index = 48; index < 58; index++) { + immune.add((char) index); + } + // letters + for (int index = 65; index < 91; index++) { + Character capsChar = (char) index; + immune.add(capsChar); + immune.add(Character.toLowerCase(capsChar)); + } + + PERCENT_CODEC_IMMUNE = new char[immune.size()]; + for (int index = 0; index < immune.size(); index++) { + PERCENT_CODEC_IMMUNE[index] = immune.get(index).charValue(); + } + } + + @Parameters(name = "{0}") + public static Collection buildTests() { + Collection tests = new ArrayList<>(); + + Collection tuples = new ArrayList<>(); + tuples.add(newTuple("%3C", Character.valueOf('<'))); + + tuples.add(newTuple("%C4%80", Character.valueOf((char) 0x100))); + tuples.add(newTuple("%00", Character.MIN_VALUE)); + tuples.add(newTuple("%3D", '=')); + tuples.add(newTuple("%26", '&')); + + for (char c : PERCENT_CODEC_IMMUNE) { + tuples.add(newTuple(Character.toString(c), c)); + } + + for (CodecCodePointTestTuple tuple : tuples) { + tests.add(new Object[] { tuple }); + } + + return tests; + } + + private static CodecCodePointTestTuple newTuple(String encodedInput, Character decoded) { + CodecCodePointTestTuple tuple = new CodecCodePointTestTuple(); + tuple.codec = new PercentCodec(); + tuple.encodeImmune = PERCENT_CODEC_IMMUNE; + tuple.codePoint = decoded.charValue(); + tuple.input = encodedInput; + + return tuple; + } + + public PercentCodecCodePointTest(CodecCodePointTestTuple tuple) { + super(tuple); + } + + @Override + @Test + public void testDecodePushbackSequence() { + // check duplicated from PushbackSequence handling in PercentCodec. + boolean inputIsEncoded = input.startsWith("%"); + + if (inputIsEncoded) { + assertInputIsDecodedToValue(); + } else { + assertInputIsDecodedToNull(); + } + } + + /** + * tests that when Input is decoded through a PushbackString that the decodedValue reference is returned and that + * the PushbackString index has incremented. + */ + @SuppressWarnings("unchecked") + private void assertInputIsDecodedToValue() { + PushbackString pbs = new PushbackString(input); + int startIndex = pbs.index(); + Character decChar = (Character) codec.decodeCharacter(pbs); + char actual = decChar.charValue(); + Assert.assertEquals(String.format("%s(%s) != %s(%s)", (char)decodedValue, decodedValue, actual, (int)actual), decodedValue, (int)actual); + Assert.assertTrue(startIndex < pbs.index()); + } + + /** + * tests that when Input is decoded through a PushbackString that null is returned and that the PushbackString index + * remains unchanged. + */ + @SuppressWarnings("unchecked") + private void assertInputIsDecodedToNull() { + PushbackString pbs = new PushbackString(input); + int startIndex = pbs.index(); + Assert.assertEquals(null, codec.decodeCharacter(pbs)); + Assert.assertEquals(startIndex, pbs.index()); + } + +} From 46d2484972a4b5e67817c3c63c8c8ddf9b177c5f Mon Sep 17 00:00:00 2001 From: Jeremiah Stacey Date: Sat, 3 Feb 2018 06:03:08 -0600 Subject: [PATCH 480/812] Removing CodePoint test & abstraction The management and testing of code point handling is out of scope of the current effort. Future work on code point handling will allow the PercentCodec to be tested in this way. --- .../codecs/AbstractCodecCodePointTest.java | 78 ----------- .../codecs/PercentCodecCodePointTest.java | 121 ------------------ 2 files changed, 199 deletions(-) delete mode 100644 src/test/java/org/owasp/esapi/codecs/AbstractCodecCodePointTest.java delete mode 100644 src/test/java/org/owasp/esapi/codecs/PercentCodecCodePointTest.java diff --git a/src/test/java/org/owasp/esapi/codecs/AbstractCodecCodePointTest.java b/src/test/java/org/owasp/esapi/codecs/AbstractCodecCodePointTest.java deleted file mode 100644 index 7d79d55bc..000000000 --- a/src/test/java/org/owasp/esapi/codecs/AbstractCodecCodePointTest.java +++ /dev/null @@ -1,78 +0,0 @@ -package org.owasp.esapi.codecs; - -import static org.junit.Assert.assertEquals; -import static org.junit.Assert.assertTrue; - -import org.junit.Test; -import org.junit.runner.RunWith; -import org.junit.runners.Parameterized; - - -/** - * Abstract parameterized test case meant to assist with verifying Character api of a Codec implementation. - *
- * Sub-classes are expected to provide instances of {@link CodecCodePointTestTuple} to this instance. - *
- * For better test naming output specify {@link CodecCodePointTestTuple#description} and use {@code} @Parameters (name="{0}")}, - * where '0' is the index that the CodecCodePointTestTuple reference appears in the constructor. - */ -@RunWith(Parameterized.class) -public abstract class AbstractCodecCodePointTest { - - /** Test Data Tuple.*/ - protected static class CodecCodePointTestTuple { - /** Codec reference to be tested.*/ - Codec codec; - /** Set of characters that should be considered 'immune' from decoding processes.*/ - char[] encodeImmune; - /** A String representing a single encoded character.*/ - String input; - /** The int code point that input represents.*/ - int codePoint; - /** Optional field to override the toString value of this tuple. */ - String description; - /** {@inheritDoc}*/ - - @Override - public String toString() { - return description != null ? description : codec.getClass().getSimpleName() + " "+input; - } - } - - - protected final Codec codec; - protected final String input; - protected final char[] encodeImmune; - protected final int decodedValue; - protected final char codePointChar; - - public AbstractCodecCodePointTest(CodecCodePointTestTuple tuple) { - this.codec = tuple.codec; - this.input = tuple.input; - this.decodedValue = tuple.codePoint; - this.encodeImmune = tuple.encodeImmune; - this.codePointChar = (char) tuple.codePoint; - } - - /** Checks that the input value matches the result of the codec encoding the decoded value. */ - @Test - public void testEncodeCharacter() { - assertEquals(input, codec.encodeCharacter(encodeImmune, decodedValue)); - } - - /** Checks that decoding the input value yeilds the same code point decodedValue.*/ - @Test - public void testDecode() { - int expectedLength = Character.toString(codePointChar).length(); - String actualDecode = codec.decode(input); - assertTrue("CodePoint test input should decode to a String consisting of a single character: " + actualDecode + " " + actualDecode.length(),actualDecode.length() == expectedLength); - assertEquals(decodedValue, (int)actualDecode.charAt(0)); - } - - /** Checks that the encoded input String is correctly decoded to the single decodedValue character reference.*/ - @Test - public void testDecodePushbackSequence() { - assertEquals(decodedValue, codec.decodeCharacter(new PushbackString(input))); - } - -} diff --git a/src/test/java/org/owasp/esapi/codecs/PercentCodecCodePointTest.java b/src/test/java/org/owasp/esapi/codecs/PercentCodecCodePointTest.java deleted file mode 100644 index d44d16097..000000000 --- a/src/test/java/org/owasp/esapi/codecs/PercentCodecCodePointTest.java +++ /dev/null @@ -1,121 +0,0 @@ -package org.owasp.esapi.codecs; - -import java.util.ArrayList; -import java.util.Collection; -import java.util.List; - -import org.junit.Assert; -import org.junit.Ignore; -import org.junit.Test; -import org.junit.runners.Parameterized.Parameters; - -/** - * Codec validation focused on the PercentCodec codepoint-based api. - * - */ -@Ignore(value="Implementation pending") -public class PercentCodecCodePointTest extends AbstractCodecCodePointTest { - private static final char[] PERCENT_CODEC_IMMUNE; - - static { - /* - * The percent codec contains a unique immune character set which include letters and numbers that will not be - * transformed. - * It is being replicated here to allow the test to reasonably expect the correct state back. - */ - List immune = new ArrayList<>(); - // 65 - 90 (capital letters) 97 - 122 lower case 48 - 57 digits - // numbers - for (int index = 48; index < 58; index++) { - immune.add((char) index); - } - // letters - for (int index = 65; index < 91; index++) { - Character capsChar = (char) index; - immune.add(capsChar); - immune.add(Character.toLowerCase(capsChar)); - } - - PERCENT_CODEC_IMMUNE = new char[immune.size()]; - for (int index = 0; index < immune.size(); index++) { - PERCENT_CODEC_IMMUNE[index] = immune.get(index).charValue(); - } - } - - @Parameters(name = "{0}") - public static Collection buildTests() { - Collection tests = new ArrayList<>(); - - Collection tuples = new ArrayList<>(); - tuples.add(newTuple("%3C", Character.valueOf('<'))); - - tuples.add(newTuple("%C4%80", Character.valueOf((char) 0x100))); - tuples.add(newTuple("%00", Character.MIN_VALUE)); - tuples.add(newTuple("%3D", '=')); - tuples.add(newTuple("%26", '&')); - - for (char c : PERCENT_CODEC_IMMUNE) { - tuples.add(newTuple(Character.toString(c), c)); - } - - for (CodecCodePointTestTuple tuple : tuples) { - tests.add(new Object[] { tuple }); - } - - return tests; - } - - private static CodecCodePointTestTuple newTuple(String encodedInput, Character decoded) { - CodecCodePointTestTuple tuple = new CodecCodePointTestTuple(); - tuple.codec = new PercentCodec(); - tuple.encodeImmune = PERCENT_CODEC_IMMUNE; - tuple.codePoint = decoded.charValue(); - tuple.input = encodedInput; - - return tuple; - } - - public PercentCodecCodePointTest(CodecCodePointTestTuple tuple) { - super(tuple); - } - - @Override - @Test - public void testDecodePushbackSequence() { - // check duplicated from PushbackSequence handling in PercentCodec. - boolean inputIsEncoded = input.startsWith("%"); - - if (inputIsEncoded) { - assertInputIsDecodedToValue(); - } else { - assertInputIsDecodedToNull(); - } - } - - /** - * tests that when Input is decoded through a PushbackString that the decodedValue reference is returned and that - * the PushbackString index has incremented. - */ - @SuppressWarnings("unchecked") - private void assertInputIsDecodedToValue() { - PushbackString pbs = new PushbackString(input); - int startIndex = pbs.index(); - Character decChar = (Character) codec.decodeCharacter(pbs); - char actual = decChar.charValue(); - Assert.assertEquals(String.format("%s(%s) != %s(%s)", (char)decodedValue, decodedValue, actual, (int)actual), decodedValue, (int)actual); - Assert.assertTrue(startIndex < pbs.index()); - } - - /** - * tests that when Input is decoded through a PushbackString that null is returned and that the PushbackString index - * remains unchanged. - */ - @SuppressWarnings("unchecked") - private void assertInputIsDecodedToNull() { - PushbackString pbs = new PushbackString(input); - int startIndex = pbs.index(); - Assert.assertEquals(null, codec.decodeCharacter(pbs)); - Assert.assertEquals(startIndex, pbs.index()); - } - -} From 172828eeaab482dee229b88e0c380893f12e0c51 Mon Sep 17 00:00:00 2001 From: Jeremiah Stacey Date: Sat, 3 Feb 2018 06:12:43 -0600 Subject: [PATCH 481/812] Reorganizing new test classes Breaking the new abstract parameterizations and percent codec test implementations into sub-packages within test scope. Updating dependencies and references to resolve compilation issues. --- .../AbstractCodecCharacterTest.java | 18 +++++++++++------- .../AbstractCodecStringTest.java | 18 +++++++++++------- .../PercentCodecCharacterTest.java | 3 ++- .../{ => percent}/PercentCodecStringTest.java | 3 ++- 4 files changed, 26 insertions(+), 16 deletions(-) rename src/test/java/org/owasp/esapi/codecs/{ => abstraction}/AbstractCodecCharacterTest.java (88%) rename src/test/java/org/owasp/esapi/codecs/{ => abstraction}/AbstractCodecStringTest.java (85%) rename src/test/java/org/owasp/esapi/codecs/{ => percent}/PercentCodecCharacterTest.java (97%) rename src/test/java/org/owasp/esapi/codecs/{ => percent}/PercentCodecStringTest.java (95%) diff --git a/src/test/java/org/owasp/esapi/codecs/AbstractCodecCharacterTest.java b/src/test/java/org/owasp/esapi/codecs/abstraction/AbstractCodecCharacterTest.java similarity index 88% rename from src/test/java/org/owasp/esapi/codecs/AbstractCodecCharacterTest.java rename to src/test/java/org/owasp/esapi/codecs/abstraction/AbstractCodecCharacterTest.java index 1101be47f..438d86e26 100644 --- a/src/test/java/org/owasp/esapi/codecs/AbstractCodecCharacterTest.java +++ b/src/test/java/org/owasp/esapi/codecs/abstraction/AbstractCodecCharacterTest.java @@ -1,4 +1,4 @@ -package org.owasp.esapi.codecs; +package org.owasp.esapi.codecs.abstraction; import static org.junit.Assert.assertEquals; @@ -7,6 +7,8 @@ import org.junit.Test; import org.junit.runner.RunWith; import org.junit.runners.Parameterized; +import org.owasp.esapi.codecs.Codec; +import org.owasp.esapi.codecs.PushbackString; /** @@ -23,17 +25,19 @@ public abstract class AbstractCodecCharacterTest { /** Test Data Tuple.*/ protected static class CodecCharacterTestTuple { /** Codec reference to be tested.*/ - Codec codec; + public Codec codec; /** Set of characters that should be considered 'immune' from decoding processes.*/ - char[] encodeImmune; + public char[] encodeImmune; /** A String representing a single encoded character.*/ - String input; + public String input; /** The single character that input represents.*/ - Character decodedValue; + public Character decodedValue; /** Optional field to override the toString value of this tuple. */ - String description; - /** {@inheritDoc}*/ + public String description; + /**Default public constructor.*/ + public CodecCharacterTestTuple() { /* No Op*/ } + /** {@inheritDoc}*/ @Override public String toString() { return description != null ? description : codec.getClass().getSimpleName() + " "+input; diff --git a/src/test/java/org/owasp/esapi/codecs/AbstractCodecStringTest.java b/src/test/java/org/owasp/esapi/codecs/abstraction/AbstractCodecStringTest.java similarity index 85% rename from src/test/java/org/owasp/esapi/codecs/AbstractCodecStringTest.java rename to src/test/java/org/owasp/esapi/codecs/abstraction/AbstractCodecStringTest.java index b3fe53156..e54d1172d 100644 --- a/src/test/java/org/owasp/esapi/codecs/AbstractCodecStringTest.java +++ b/src/test/java/org/owasp/esapi/codecs/abstraction/AbstractCodecStringTest.java @@ -1,9 +1,10 @@ -package org.owasp.esapi.codecs; +package org.owasp.esapi.codecs.abstraction; import org.junit.Assert; import org.junit.Test; import org.junit.runner.RunWith; import org.junit.runners.Parameterized; +import org.owasp.esapi.codecs.Codec; /** @@ -19,17 +20,20 @@ public abstract class AbstractCodecStringTest { protected static class CodecStringTestTuple { /** Codec reference to be tested.*/ - Codec codec; + public Codec codec; /** Set of characters that should be considered 'immune' from decoding processes.*/ - char[] encodeImmune; + public char[] encodeImmune; /** A String representing a contextually encoded String.*/ - String input; + public String input; /** The decoded representation of the input value.*/ - String decodedValue; + public String decodedValue; /** Optional field to override the toString value of this tuple. */ - String description; - /** {@inheritDoc}*/ + public String description; + + /**Default public constructor.*/ + public CodecStringTestTuple() { /* No Op*/ } + /** {@inheritDoc}*/ @Override public String toString() { return description != null ? description : codec.getClass().getSimpleName() + " "+input; diff --git a/src/test/java/org/owasp/esapi/codecs/PercentCodecCharacterTest.java b/src/test/java/org/owasp/esapi/codecs/percent/PercentCodecCharacterTest.java similarity index 97% rename from src/test/java/org/owasp/esapi/codecs/PercentCodecCharacterTest.java rename to src/test/java/org/owasp/esapi/codecs/percent/PercentCodecCharacterTest.java index ca7ddf1b6..76c5c1c52 100644 --- a/src/test/java/org/owasp/esapi/codecs/PercentCodecCharacterTest.java +++ b/src/test/java/org/owasp/esapi/codecs/percent/PercentCodecCharacterTest.java @@ -1,4 +1,4 @@ -package org.owasp.esapi.codecs; +package org.owasp.esapi.codecs.percent; import java.util.ArrayList; import java.util.Collection; @@ -9,6 +9,7 @@ import org.junit.runners.Parameterized.Parameters; import org.owasp.esapi.codecs.PercentCodec; import org.owasp.esapi.codecs.PushbackString; +import org.owasp.esapi.codecs.abstraction.AbstractCodecCharacterTest; /** * Codec validation focused on the PercentCodec Character-based api. diff --git a/src/test/java/org/owasp/esapi/codecs/PercentCodecStringTest.java b/src/test/java/org/owasp/esapi/codecs/percent/PercentCodecStringTest.java similarity index 95% rename from src/test/java/org/owasp/esapi/codecs/PercentCodecStringTest.java rename to src/test/java/org/owasp/esapi/codecs/percent/PercentCodecStringTest.java index a851ebcae..c769a2e01 100644 --- a/src/test/java/org/owasp/esapi/codecs/PercentCodecStringTest.java +++ b/src/test/java/org/owasp/esapi/codecs/percent/PercentCodecStringTest.java @@ -1,4 +1,4 @@ -package org.owasp.esapi.codecs; +package org.owasp.esapi.codecs.percent; import java.util.ArrayList; import java.util.Collection; @@ -6,6 +6,7 @@ import org.junit.runners.Parameterized.Parameters; import org.owasp.esapi.codecs.PercentCodec; +import org.owasp.esapi.codecs.abstraction.AbstractCodecStringTest; /** * Codec validation focused on the PercentCodec String-based api. From 2c960807e2060956848158fed146be375de92804 Mon Sep 17 00:00:00 2001 From: Jeremiah Stacey Date: Thu, 8 Feb 2018 15:38:41 -0600 Subject: [PATCH 482/812] Removing invalid test content Removing entries that would otherwise test the codepoint handling of the PercentCodec. The feature of code point handling has not been fully implemented on the PercentCodec at this time. --- .../owasp/esapi/codecs/percent/PercentCodecCharacterTest.java | 2 +- .../org/owasp/esapi/codecs/percent/PercentCodecStringTest.java | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/src/test/java/org/owasp/esapi/codecs/percent/PercentCodecCharacterTest.java b/src/test/java/org/owasp/esapi/codecs/percent/PercentCodecCharacterTest.java index 76c5c1c52..f9e1d616d 100644 --- a/src/test/java/org/owasp/esapi/codecs/percent/PercentCodecCharacterTest.java +++ b/src/test/java/org/owasp/esapi/codecs/percent/PercentCodecCharacterTest.java @@ -50,7 +50,7 @@ public static Collection buildTests() { Collection tuples = new ArrayList<>(); tuples.add(newTuple("%3C", Character.valueOf('<'))); - tuples.add(newTuple("%C4%80", Character.valueOf((char) 0x100))); + //CODEPOINT tuples.add(newTuple("%C4%80", Character.valueOf((char) 0x100))); tuples.add(newTuple("%00", Character.MIN_VALUE)); tuples.add(newTuple("%3D", '=')); tuples.add(newTuple("%26", '&')); diff --git a/src/test/java/org/owasp/esapi/codecs/percent/PercentCodecStringTest.java b/src/test/java/org/owasp/esapi/codecs/percent/PercentCodecStringTest.java index c769a2e01..786444b27 100644 --- a/src/test/java/org/owasp/esapi/codecs/percent/PercentCodecStringTest.java +++ b/src/test/java/org/owasp/esapi/codecs/percent/PercentCodecStringTest.java @@ -47,7 +47,7 @@ public static Collection buildTests() { List tuples = new ArrayList<>(); tuples.add(newTuple("%3C", "<")); - tuples.add(newTuple("%C4%80", (char) 0x100)); + //CODEPOINT tuples.add(newTuple("%C4%80", (char) 0x100)); tuples.add(newTuple("%00", Character.MIN_VALUE)); tuples.add(newTuple("%3D", '=')); tuples.add(newTuple("%26", '&')); From 804350f0f25605da3cf69df3885c133636f3860b Mon Sep 17 00:00:00 2001 From: Jeremiah Stacey Date: Thu, 8 Feb 2018 15:44:02 -0600 Subject: [PATCH 483/812] Relocating Tests & Updating references Moving the pattern validation test constructs into a sub directory intended to hold regex-type testing elements. --- .../owasp/esapi/reference/{ => regex}/AbstractPatternTest.java | 2 +- .../{ => regex}/EsapiWhitelistValidationPatternTester.java | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) rename src/test/java/org/owasp/esapi/reference/{ => regex}/AbstractPatternTest.java (97%) rename src/test/java/org/owasp/esapi/reference/{ => regex}/EsapiWhitelistValidationPatternTester.java (98%) diff --git a/src/test/java/org/owasp/esapi/reference/AbstractPatternTest.java b/src/test/java/org/owasp/esapi/reference/regex/AbstractPatternTest.java similarity index 97% rename from src/test/java/org/owasp/esapi/reference/AbstractPatternTest.java rename to src/test/java/org/owasp/esapi/reference/regex/AbstractPatternTest.java index 9cf1e0e20..3e3847719 100644 --- a/src/test/java/org/owasp/esapi/reference/AbstractPatternTest.java +++ b/src/test/java/org/owasp/esapi/reference/regex/AbstractPatternTest.java @@ -1,4 +1,4 @@ -package org.owasp.esapi.reference; +package org.owasp.esapi.reference.regex; import java.util.regex.Pattern; diff --git a/src/test/java/org/owasp/esapi/reference/EsapiWhitelistValidationPatternTester.java b/src/test/java/org/owasp/esapi/reference/regex/EsapiWhitelistValidationPatternTester.java similarity index 98% rename from src/test/java/org/owasp/esapi/reference/EsapiWhitelistValidationPatternTester.java rename to src/test/java/org/owasp/esapi/reference/regex/EsapiWhitelistValidationPatternTester.java index d00d4c19a..2042eee33 100644 --- a/src/test/java/org/owasp/esapi/reference/EsapiWhitelistValidationPatternTester.java +++ b/src/test/java/org/owasp/esapi/reference/regex/EsapiWhitelistValidationPatternTester.java @@ -1,4 +1,4 @@ -package org.owasp.esapi.reference; +package org.owasp.esapi.reference.regex; import java.util.ArrayList; import java.util.Collection; From 4f903d37feb4b32c6d9d1f2339d3f5c3b45162c5 Mon Sep 17 00:00:00 2001 From: Jeremiah Stacey Date: Mon, 19 Feb 2018 08:06:06 -0600 Subject: [PATCH 484/812] Adding known exception testing for PercentCodec Making a test that will fail when the UTF16 handling is corrected for the implementation. Also centralizing the test-scope of the immune character set to just the StringTest impl for easier maintenance later when it's replaced. --- .../percent/PercentCodecCharacterTest.java | 31 ++----------------- .../percent/PercentCodecStringTest.java | 2 +- 2 files changed, 3 insertions(+), 30 deletions(-) diff --git a/src/test/java/org/owasp/esapi/codecs/percent/PercentCodecCharacterTest.java b/src/test/java/org/owasp/esapi/codecs/percent/PercentCodecCharacterTest.java index f9e1d616d..419762dc1 100644 --- a/src/test/java/org/owasp/esapi/codecs/percent/PercentCodecCharacterTest.java +++ b/src/test/java/org/owasp/esapi/codecs/percent/PercentCodecCharacterTest.java @@ -1,8 +1,9 @@ package org.owasp.esapi.codecs.percent; +import static org.owasp.esapi.codecs.percent.PercentCodecStringTest.PERCENT_CODEC_IMMUNE; + import java.util.ArrayList; import java.util.Collection; -import java.util.List; import org.junit.Assert; import org.junit.Test; @@ -16,33 +17,6 @@ * */ public class PercentCodecCharacterTest extends AbstractCodecCharacterTest { - private static final char[] PERCENT_CODEC_IMMUNE; - - static { - /* - * The percent codec contains a unique immune character set which include letters and numbers that will not be - * transformed. - * It is being replicated here to allow the test to reasonably expect the correct state back. - */ - List immune = new ArrayList<>(); - // 65 - 90 (capital letters) 97 - 122 lower case 48 - 57 digits - // numbers - for (int index = 48; index < 58; index++) { - immune.add((char) index); - } - // letters - for (int index = 65; index < 91; index++) { - Character capsChar = (char) index; - immune.add(capsChar); - immune.add(Character.toLowerCase(capsChar)); - } - - PERCENT_CODEC_IMMUNE = new char[immune.size()]; - for (int index = 0; index < immune.size(); index++) { - PERCENT_CODEC_IMMUNE[index] = immune.get(index).charValue(); - } - } - @Parameters(name = "{0}") public static Collection buildTests() { Collection tests = new ArrayList<>(); @@ -50,7 +24,6 @@ public static Collection buildTests() { Collection tuples = new ArrayList<>(); tuples.add(newTuple("%3C", Character.valueOf('<'))); - //CODEPOINT tuples.add(newTuple("%C4%80", Character.valueOf((char) 0x100))); tuples.add(newTuple("%00", Character.MIN_VALUE)); tuples.add(newTuple("%3D", '=')); tuples.add(newTuple("%26", '&')); diff --git a/src/test/java/org/owasp/esapi/codecs/percent/PercentCodecStringTest.java b/src/test/java/org/owasp/esapi/codecs/percent/PercentCodecStringTest.java index 786444b27..665a8ab71 100644 --- a/src/test/java/org/owasp/esapi/codecs/percent/PercentCodecStringTest.java +++ b/src/test/java/org/owasp/esapi/codecs/percent/PercentCodecStringTest.java @@ -13,7 +13,7 @@ * */ public class PercentCodecStringTest extends AbstractCodecStringTest { - private static final char[] PERCENT_CODEC_IMMUNE; + public static final char[] PERCENT_CODEC_IMMUNE; static { /* From d9e12d6be4c2b556fafdaab14e4c62b68b30a679 Mon Sep 17 00:00:00 2001 From: Jeremiah Stacey Date: Wed, 21 Feb 2018 17:40:10 -0600 Subject: [PATCH 485/812] Really committing known exceptions test Lost a workflow argument with git, so I'm making another commit to actually add the file that I intended to add last commit. --- .../percent/PercentCodecKnownIssuesTest.java | 41 +++++++++++++++++++ 1 file changed, 41 insertions(+) create mode 100644 src/test/java/org/owasp/esapi/codecs/percent/PercentCodecKnownIssuesTest.java diff --git a/src/test/java/org/owasp/esapi/codecs/percent/PercentCodecKnownIssuesTest.java b/src/test/java/org/owasp/esapi/codecs/percent/PercentCodecKnownIssuesTest.java new file mode 100644 index 000000000..9b163b4bf --- /dev/null +++ b/src/test/java/org/owasp/esapi/codecs/percent/PercentCodecKnownIssuesTest.java @@ -0,0 +1,41 @@ +package org.owasp.esapi.codecs.percent; +import static org.owasp.esapi.codecs.percent.PercentCodecStringTest.PERCENT_CODEC_IMMUNE; + +import org.junit.Assert; +import org.junit.Test; +import org.owasp.esapi.codecs.PercentCodec; +/** + * This test class holds the proof of known deficiencies, inconsistencies, or bugs with the PercentCodec implementation. + *
+ * The intent is that when that functionality is corrected, these tests should break. That should hopefully encourage + * the author to move the test to an appropriate Test file and update the functionality to a working expectation. + */ +public class PercentCodecKnownIssuesTest { + + private PercentCodec codec = new PercentCodec(); + + /** + * PercentCodec has not been fully implemented for codepoint support, which handles UTF16 characters (based on my current understanding). + * As such, the encoding/decoding of UTF16 will not function as desired through the codec implementation. + *
+ * When the functionality is corrected this test will break. At that point UTF16 tests should be added to {@link PercentCodecStringTest} and {@link PercentCodecCharacterTest}. + */ + @Test + public void failsUTF16Conversions() { + //This should be 195 + int incorrectDecodeExpect = 196; + + char[] encodeImmune = PERCENT_CODEC_IMMUNE; + String decodedValue = ""+(char) 0x100; + String input = "%C4%80"; + + String actualDecodeChar = codec.decode(input); + int actualChar = (int)actualDecodeChar.charAt(0); + + Assert.assertEquals(incorrectDecodeExpect, actualChar); + + //This works as expected. + Assert.assertEquals(input, codec.encode(encodeImmune, decodedValue)); + } + +} From bf91374d3acb5cf79943ac9127a7fd39473af881 Mon Sep 17 00:00:00 2001 From: Jeremiah Stacey Date: Wed, 21 Feb 2018 17:47:00 -0600 Subject: [PATCH 486/812] Adding License Information Adding license content to files created in this effort. --- .../abstraction/AbstractCodecCharacterTest.java | 14 ++++++++++++++ .../abstraction/AbstractCodecStringTest.java | 14 ++++++++++++++ .../codecs/percent/PercentCodecCharacterTest.java | 14 ++++++++++++++ .../percent/PercentCodecKnownIssuesTest.java | 15 +++++++++++++++ .../codecs/percent/PercentCodecStringTest.java | 14 ++++++++++++++ .../esapi/filters/SecurityWrapperRequestTest.java | 14 ++++++++++++++ .../reference/regex/AbstractPatternTest.java | 13 +++++++++++++ .../EsapiWhitelistValidationPatternTester.java | 14 ++++++++++++++ 8 files changed, 112 insertions(+) diff --git a/src/test/java/org/owasp/esapi/codecs/abstraction/AbstractCodecCharacterTest.java b/src/test/java/org/owasp/esapi/codecs/abstraction/AbstractCodecCharacterTest.java index 438d86e26..66ff3cb82 100644 --- a/src/test/java/org/owasp/esapi/codecs/abstraction/AbstractCodecCharacterTest.java +++ b/src/test/java/org/owasp/esapi/codecs/abstraction/AbstractCodecCharacterTest.java @@ -1,3 +1,17 @@ +/** + * OWASP Enterprise Security API (ESAPI) + * + * This file is part of the Open Web Application Security Project (OWASP) + * Enterprise Security API (ESAPI) project. For details, please see + * http://www.owasp.org/index.php/ESAPI. + * + * Copyright (c) 2008-2018 - The OWASP Foundation + * + * The ESAPI is published by OWASP under the BSD license. You should read and accept the + * LICENSE before you use, modify, and/or redistribute this software. + * + */ + package org.owasp.esapi.codecs.abstraction; import static org.junit.Assert.assertEquals; diff --git a/src/test/java/org/owasp/esapi/codecs/abstraction/AbstractCodecStringTest.java b/src/test/java/org/owasp/esapi/codecs/abstraction/AbstractCodecStringTest.java index e54d1172d..c00cbf699 100644 --- a/src/test/java/org/owasp/esapi/codecs/abstraction/AbstractCodecStringTest.java +++ b/src/test/java/org/owasp/esapi/codecs/abstraction/AbstractCodecStringTest.java @@ -1,3 +1,17 @@ +/** + * OWASP Enterprise Security API (ESAPI) + * + * This file is part of the Open Web Application Security Project (OWASP) + * Enterprise Security API (ESAPI) project. For details, please see + * http://www.owasp.org/index.php/ESAPI. + * + * Copyright (c) 2008-2018 - The OWASP Foundation + * + * The ESAPI is published by OWASP under the BSD license. You should read and accept the + * LICENSE before you use, modify, and/or redistribute this software. + * + */ + package org.owasp.esapi.codecs.abstraction; import org.junit.Assert; diff --git a/src/test/java/org/owasp/esapi/codecs/percent/PercentCodecCharacterTest.java b/src/test/java/org/owasp/esapi/codecs/percent/PercentCodecCharacterTest.java index 419762dc1..2c7199c23 100644 --- a/src/test/java/org/owasp/esapi/codecs/percent/PercentCodecCharacterTest.java +++ b/src/test/java/org/owasp/esapi/codecs/percent/PercentCodecCharacterTest.java @@ -1,3 +1,17 @@ +/** + * OWASP Enterprise Security API (ESAPI) + * + * This file is part of the Open Web Application Security Project (OWASP) + * Enterprise Security API (ESAPI) project. For details, please see + * http://www.owasp.org/index.php/ESAPI. + * + * Copyright (c) 2008-2018 - The OWASP Foundation + * + * The ESAPI is published by OWASP under the BSD license. You should read and accept the + * LICENSE before you use, modify, and/or redistribute this software. + * + */ + package org.owasp.esapi.codecs.percent; import static org.owasp.esapi.codecs.percent.PercentCodecStringTest.PERCENT_CODEC_IMMUNE; diff --git a/src/test/java/org/owasp/esapi/codecs/percent/PercentCodecKnownIssuesTest.java b/src/test/java/org/owasp/esapi/codecs/percent/PercentCodecKnownIssuesTest.java index 9b163b4bf..2f3f1049c 100644 --- a/src/test/java/org/owasp/esapi/codecs/percent/PercentCodecKnownIssuesTest.java +++ b/src/test/java/org/owasp/esapi/codecs/percent/PercentCodecKnownIssuesTest.java @@ -1,4 +1,19 @@ +/** + * OWASP Enterprise Security API (ESAPI) + * + * This file is part of the Open Web Application Security Project (OWASP) + * Enterprise Security API (ESAPI) project. For details, please see + * http://www.owasp.org/index.php/ESAPI. + * + * Copyright (c) 2008-2018 - The OWASP Foundation + * + * The ESAPI is published by OWASP under the BSD license. You should read and accept the + * LICENSE before you use, modify, and/or redistribute this software. + * + */ + package org.owasp.esapi.codecs.percent; + import static org.owasp.esapi.codecs.percent.PercentCodecStringTest.PERCENT_CODEC_IMMUNE; import org.junit.Assert; diff --git a/src/test/java/org/owasp/esapi/codecs/percent/PercentCodecStringTest.java b/src/test/java/org/owasp/esapi/codecs/percent/PercentCodecStringTest.java index 665a8ab71..38bb6fb27 100644 --- a/src/test/java/org/owasp/esapi/codecs/percent/PercentCodecStringTest.java +++ b/src/test/java/org/owasp/esapi/codecs/percent/PercentCodecStringTest.java @@ -1,3 +1,17 @@ +/** + * OWASP Enterprise Security API (ESAPI) + * + * This file is part of the Open Web Application Security Project (OWASP) + * Enterprise Security API (ESAPI) project. For details, please see + * http://www.owasp.org/index.php/ESAPI. + * + * Copyright (c) 2008-2018 - The OWASP Foundation + * + * The ESAPI is published by OWASP under the BSD license. You should read and accept the + * LICENSE before you use, modify, and/or redistribute this software. + * + */ + package org.owasp.esapi.codecs.percent; import java.util.ArrayList; diff --git a/src/test/java/org/owasp/esapi/filters/SecurityWrapperRequestTest.java b/src/test/java/org/owasp/esapi/filters/SecurityWrapperRequestTest.java index bf1a2d627..c5c1c3c5e 100644 --- a/src/test/java/org/owasp/esapi/filters/SecurityWrapperRequestTest.java +++ b/src/test/java/org/owasp/esapi/filters/SecurityWrapperRequestTest.java @@ -1,3 +1,17 @@ +/** + * OWASP Enterprise Security API (ESAPI) + * + * This file is part of the Open Web Application Security Project (OWASP) + * Enterprise Security API (ESAPI) project. For details, please see + * http://www.owasp.org/index.php/ESAPI. + * + * Copyright (c) 2008-2018 - The OWASP Foundation + * + * The ESAPI is published by OWASP under the BSD license. You should read and accept the + * LICENSE before you use, modify, and/or redistribute this software. + * + */ + package org.owasp.esapi.filters; import static org.junit.Assert.assertEquals; diff --git a/src/test/java/org/owasp/esapi/reference/regex/AbstractPatternTest.java b/src/test/java/org/owasp/esapi/reference/regex/AbstractPatternTest.java index 3e3847719..f05397dfb 100644 --- a/src/test/java/org/owasp/esapi/reference/regex/AbstractPatternTest.java +++ b/src/test/java/org/owasp/esapi/reference/regex/AbstractPatternTest.java @@ -1,3 +1,16 @@ +/** + * OWASP Enterprise Security API (ESAPI) + * + * This file is part of the Open Web Application Security Project (OWASP) + * Enterprise Security API (ESAPI) project. For details, please see + * http://www.owasp.org/index.php/ESAPI. + * + * Copyright (c) 2008-2018 - The OWASP Foundation + * + * The ESAPI is published by OWASP under the BSD license. You should read and accept the + * LICENSE before you use, modify, and/or redistribute this software. + * + */ package org.owasp.esapi.reference.regex; import java.util.regex.Pattern; diff --git a/src/test/java/org/owasp/esapi/reference/regex/EsapiWhitelistValidationPatternTester.java b/src/test/java/org/owasp/esapi/reference/regex/EsapiWhitelistValidationPatternTester.java index 2042eee33..b6080344d 100644 --- a/src/test/java/org/owasp/esapi/reference/regex/EsapiWhitelistValidationPatternTester.java +++ b/src/test/java/org/owasp/esapi/reference/regex/EsapiWhitelistValidationPatternTester.java @@ -1,3 +1,17 @@ +/** + * OWASP Enterprise Security API (ESAPI) + * + * This file is part of the Open Web Application Security Project (OWASP) + * Enterprise Security API (ESAPI) project. For details, please see + * http://www.owasp.org/index.php/ESAPI. + * + * Copyright (c) 2008-2018 - The OWASP Foundation + * + * The ESAPI is published by OWASP under the BSD license. You should read and accept the + * LICENSE before you use, modify, and/or redistribute this software. + * + */ + package org.owasp.esapi.reference.regex; import java.util.ArrayList; From 113add5fa9e280eb2bae9263c8c9868b963ec938 Mon Sep 17 00:00:00 2001 From: Jeremiah Stacey Date: Thu, 22 Feb 2018 04:47:54 -0600 Subject: [PATCH 487/812] Documentation updates Feedback from pull request. --- .../esapi/codecs/abstraction/AbstractCodecCharacterTest.java | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/src/test/java/org/owasp/esapi/codecs/abstraction/AbstractCodecCharacterTest.java b/src/test/java/org/owasp/esapi/codecs/abstraction/AbstractCodecCharacterTest.java index 66ff3cb82..aa7208399 100644 --- a/src/test/java/org/owasp/esapi/codecs/abstraction/AbstractCodecCharacterTest.java +++ b/src/test/java/org/owasp/esapi/codecs/abstraction/AbstractCodecCharacterTest.java @@ -30,7 +30,7 @@ *
* Sub-classes are expected to provide instances of {@link CodecCharacterTestTuple} to this instance. *
- * For better test naming output specify {@link CodecCharacterTestTuple#description} and use {@code} @Parameters (name="{0}")}, + * For better test naming output specify {@link CodecCharacterTestTuple#description} and use @Parameters (name="{0}"), * where '0' is the index that the CodecCharacterTestTuple reference appears in the constructor. */ @RunWith(Parameterized.class) @@ -88,7 +88,7 @@ public void testEncode() { assertEquals(expected, codec.encode(encodeImmune, decodedValue.toString())); } - /** Checks that decoding the input value yeilds the decodedValue.*/ + /** Checks that decoding the input value yields the decodedValue.*/ @Test public void testDecode() { assertEquals(decodedValue.toString(), codec.decode(input)); From e5b7c0d8d9f93e1d8617db2362e2cf59b1d093bd Mon Sep 17 00:00:00 2001 From: Jeremiah Stacey Date: Thu, 22 Feb 2018 04:50:16 -0600 Subject: [PATCH 488/812] Updating Imports Pull request feedback. Setting Assert.assertEquals to a static import to match other implementations within this effort. --- .../esapi/codecs/abstraction/AbstractCodecStringTest.java | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/src/test/java/org/owasp/esapi/codecs/abstraction/AbstractCodecStringTest.java b/src/test/java/org/owasp/esapi/codecs/abstraction/AbstractCodecStringTest.java index c00cbf699..789c8a153 100644 --- a/src/test/java/org/owasp/esapi/codecs/abstraction/AbstractCodecStringTest.java +++ b/src/test/java/org/owasp/esapi/codecs/abstraction/AbstractCodecStringTest.java @@ -14,7 +14,8 @@ package org.owasp.esapi.codecs.abstraction; -import org.junit.Assert; +import static org.junit.Assert.assertEquals; + import org.junit.Test; import org.junit.runner.RunWith; import org.junit.runners.Parameterized; @@ -69,13 +70,13 @@ public AbstractCodecStringTest(CodecStringTestTuple tuple) { /** Checks that when the input is decoded using the specified codec, that the return matches the expected decoded value.*/ @Test public void testDecode() { - Assert.assertEquals(decodedValue, codec.decode(input)); + assertEquals(decodedValue, codec.decode(input)); } /** Checks that when the decoded value is encoded (using immunity), that the return matches the provided input.*/ @Test public void testEncode() { - Assert.assertEquals(input, codec.encode(encodeImmune, decodedValue)); + assertEquals(input, codec.encode(encodeImmune, decodedValue)); } } From ce025aa4b5e2e8952d0cc87239cc916d88b84c8e Mon Sep 17 00:00:00 2001 From: Jeremiah Stacey Date: Thu, 22 Feb 2018 04:54:45 -0600 Subject: [PATCH 489/812] Updating Imports, readability improvements. Pull request feedback. Using static Assert imports for consistency within this effort. Altering whitespace for better readability in parameter construction. --- .../codecs/percent/PercentCodecCharacterTest.java | 13 +++++++------ 1 file changed, 7 insertions(+), 6 deletions(-) diff --git a/src/test/java/org/owasp/esapi/codecs/percent/PercentCodecCharacterTest.java b/src/test/java/org/owasp/esapi/codecs/percent/PercentCodecCharacterTest.java index 2c7199c23..7d4425ddc 100644 --- a/src/test/java/org/owasp/esapi/codecs/percent/PercentCodecCharacterTest.java +++ b/src/test/java/org/owasp/esapi/codecs/percent/PercentCodecCharacterTest.java @@ -14,12 +14,13 @@ package org.owasp.esapi.codecs.percent; +import static org.junit.Assert.assertEquals; +import static org.junit.Assert.assertTrue; import static org.owasp.esapi.codecs.percent.PercentCodecStringTest.PERCENT_CODEC_IMMUNE; import java.util.ArrayList; import java.util.Collection; -import org.junit.Assert; import org.junit.Test; import org.junit.runners.Parameterized.Parameters; import org.owasp.esapi.codecs.PercentCodec; @@ -34,8 +35,8 @@ public class PercentCodecCharacterTest extends AbstractCodecCharacterTest { @Parameters(name = "{0}") public static Collection buildTests() { Collection tests = new ArrayList<>(); - Collection tuples = new ArrayList<>(); + tuples.add(newTuple("%3C", Character.valueOf('<'))); tuples.add(newTuple("%00", Character.MIN_VALUE)); @@ -88,8 +89,8 @@ public void testDecodePushbackSequence() { private void assertInputIsDecodedToValue() { PushbackString pbs = new PushbackString(input); int startIndex = pbs.index(); - Assert.assertEquals(decodedValue, codec.decodeCharacter(pbs)); - Assert.assertTrue(startIndex < pbs.index()); + assertEquals(decodedValue, codec.decodeCharacter(pbs)); + assertTrue(startIndex < pbs.index()); } /** @@ -100,8 +101,8 @@ private void assertInputIsDecodedToValue() { private void assertInputIsDecodedToNull() { PushbackString pbs = new PushbackString(input); int startIndex = pbs.index(); - Assert.assertEquals(null, codec.decodeCharacter(pbs)); - Assert.assertEquals(startIndex, pbs.index()); + assertEquals(null, codec.decodeCharacter(pbs)); + assertEquals(startIndex, pbs.index()); } } From b468673f93155fcfbf1c0f7ed1f1c15c31731758 Mon Sep 17 00:00:00 2001 From: Jeremiah Stacey Date: Thu, 22 Feb 2018 05:12:09 -0600 Subject: [PATCH 490/812] Updating imports Applying static Assert imports for implementation consistency. --- .../esapi/codecs/percent/PercentCodecKnownIssuesTest.java | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/src/test/java/org/owasp/esapi/codecs/percent/PercentCodecKnownIssuesTest.java b/src/test/java/org/owasp/esapi/codecs/percent/PercentCodecKnownIssuesTest.java index 2f3f1049c..ac8c6d6e2 100644 --- a/src/test/java/org/owasp/esapi/codecs/percent/PercentCodecKnownIssuesTest.java +++ b/src/test/java/org/owasp/esapi/codecs/percent/PercentCodecKnownIssuesTest.java @@ -14,9 +14,9 @@ package org.owasp.esapi.codecs.percent; +import static org.junit.Assert.assertEquals; import static org.owasp.esapi.codecs.percent.PercentCodecStringTest.PERCENT_CODEC_IMMUNE; -import org.junit.Assert; import org.junit.Test; import org.owasp.esapi.codecs.PercentCodec; /** @@ -47,10 +47,10 @@ public void failsUTF16Conversions() { String actualDecodeChar = codec.decode(input); int actualChar = (int)actualDecodeChar.charAt(0); - Assert.assertEquals(incorrectDecodeExpect, actualChar); + assertEquals(incorrectDecodeExpect, actualChar); //This works as expected. - Assert.assertEquals(input, codec.encode(encodeImmune, decodedValue)); + assertEquals(input, codec.encode(encodeImmune, decodedValue)); } } From 5a65083bfd4d2c1966e00e04701190db6d397a96 Mon Sep 17 00:00:00 2001 From: Jeremiah Stacey Date: Thu, 22 Feb 2018 05:14:32 -0600 Subject: [PATCH 491/812] Readability Improvements Pull Request Cleanup. Clarifying the capital letters are ASCII specific. Applying better whitespace formatting for readability. --- .../owasp/esapi/codecs/percent/PercentCodecStringTest.java | 6 ++---- 1 file changed, 2 insertions(+), 4 deletions(-) diff --git a/src/test/java/org/owasp/esapi/codecs/percent/PercentCodecStringTest.java b/src/test/java/org/owasp/esapi/codecs/percent/PercentCodecStringTest.java index 38bb6fb27..edec02321 100644 --- a/src/test/java/org/owasp/esapi/codecs/percent/PercentCodecStringTest.java +++ b/src/test/java/org/owasp/esapi/codecs/percent/PercentCodecStringTest.java @@ -36,7 +36,7 @@ public class PercentCodecStringTest extends AbstractCodecStringTest { * It is being replicated here to allow the test to reasonably expect the correct state back. */ List immune = new ArrayList<>(); - // 65 - 90 (capital letters) 97 - 122 lower case 48 - 57 digits + // 65 - 90 (capital letters in ASCII) 97 - 122 lower case 48 - 57 digits //numbers for (int index = 48 ; index < 58; index ++) { immune.add((char)index); @@ -57,11 +57,9 @@ public class PercentCodecStringTest extends AbstractCodecStringTest { @Parameters(name = "{0}") public static Collection buildTests() { Collection tests = new ArrayList<>(); - List tuples = new ArrayList<>(); + tuples.add(newTuple("%3C", "<")); - - //CODEPOINT tuples.add(newTuple("%C4%80", (char) 0x100)); tuples.add(newTuple("%00", Character.MIN_VALUE)); tuples.add(newTuple("%3D", '=')); tuples.add(newTuple("%26", '&')); From 5d42bfe5544da508aafaa3cef78a0dde2b47d4a2 Mon Sep 17 00:00:00 2001 From: Jeremiah Stacey Date: Thu, 22 Feb 2018 05:18:09 -0600 Subject: [PATCH 492/812] Import cleanup Using static Assert imports for implementation consistency. --- .../org/owasp/esapi/reference/regex/AbstractPatternTest.java | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/src/test/java/org/owasp/esapi/reference/regex/AbstractPatternTest.java b/src/test/java/org/owasp/esapi/reference/regex/AbstractPatternTest.java index f05397dfb..89dd1f126 100644 --- a/src/test/java/org/owasp/esapi/reference/regex/AbstractPatternTest.java +++ b/src/test/java/org/owasp/esapi/reference/regex/AbstractPatternTest.java @@ -13,9 +13,10 @@ */ package org.owasp.esapi.reference.regex; +import static org.junit.Assert.assertEquals; + import java.util.regex.Pattern; -import org.junit.Assert; import org.junit.Test; import org.junit.runner.RunWith; import org.junit.runners.Parameterized; @@ -63,7 +64,7 @@ public AbstractPatternTest(PatternTestTuple tuple) { @Test public void checkPatternMatches() { - Assert.assertEquals(shouldMatch, pattern.matcher(input).matches()); + assertEquals(shouldMatch, pattern.matcher(input).matches()); } } From 7ad97030300b3c0f4e6dc2533370445e0cfa7d59 Mon Sep 17 00:00:00 2001 From: Jeremiah Stacey Date: Thu, 22 Feb 2018 05:19:42 -0600 Subject: [PATCH 493/812] Documentation Cleanup Correcting use of javadoc {@code} to for better readability of parameterization usage and suggestions. --- .../owasp/esapi/codecs/abstraction/AbstractCodecStringTest.java | 2 +- .../org/owasp/esapi/reference/regex/AbstractPatternTest.java | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/src/test/java/org/owasp/esapi/codecs/abstraction/AbstractCodecStringTest.java b/src/test/java/org/owasp/esapi/codecs/abstraction/AbstractCodecStringTest.java index 789c8a153..cf48dcfff 100644 --- a/src/test/java/org/owasp/esapi/codecs/abstraction/AbstractCodecStringTest.java +++ b/src/test/java/org/owasp/esapi/codecs/abstraction/AbstractCodecStringTest.java @@ -27,7 +27,7 @@ *
* Sub-classes are expected to provide instances of {@link CodecStringTestTuple} to this instance. *
- * For better test naming output specify {@link CodecStringTestTuple#description} and use {@code} @Parameters (name="{0}")}, + * For better test naming output specify {@link CodecStringTestTuple#description} and use @Parameters (name="{0}"), * where '0' is the index that the CodecStringTestTuple reference appears in the constructor. */ @RunWith(Parameterized.class) diff --git a/src/test/java/org/owasp/esapi/reference/regex/AbstractPatternTest.java b/src/test/java/org/owasp/esapi/reference/regex/AbstractPatternTest.java index 89dd1f126..f887db57b 100644 --- a/src/test/java/org/owasp/esapi/reference/regex/AbstractPatternTest.java +++ b/src/test/java/org/owasp/esapi/reference/regex/AbstractPatternTest.java @@ -26,7 +26,7 @@ *
* Sub-classes are expected to provide instances of {@link PatternTestTuple} to this instance. *
- * For better test naming output specify {@link PatternTestTuple#description} and use {@code} @Parameters (name="{0}")}, + * For better test naming output specify {@link PatternTestTuple#description} and use @Parameters (name="{0}"), * where '0' is the index that the PatternTestTuple reference appears in the constructor. */ @RunWith(Parameterized.class) From 3bf59c6c02d929412ad551ef566f08938e4696af Mon Sep 17 00:00:00 2001 From: Matt Seil Date: Sun, 13 May 2018 15:41:29 -0700 Subject: [PATCH 494/812] Moved esapi.tld into the correct resources location. Fixes issues #213, #244, #253. --- {configuration => src/main/resources}/META-INF/esapi.tld | 0 1 file changed, 0 insertions(+), 0 deletions(-) rename {configuration => src/main/resources}/META-INF/esapi.tld (100%) diff --git a/configuration/META-INF/esapi.tld b/src/main/resources/META-INF/esapi.tld similarity index 100% rename from configuration/META-INF/esapi.tld rename to src/main/resources/META-INF/esapi.tld From b54019eab92f58cdf017a26568f079b028cc5f35 Mon Sep 17 00:00:00 2001 From: Jeremiah Stacey Date: Mon, 9 Jul 2018 17:08:38 -0500 Subject: [PATCH 495/812] Updating Asserts for Additional Output Converting AssertTrue to other Assert API (mostly assertEquals) to see the values being compared in the test output. --- .../owasp/esapi/reference/crypto/EncryptorTest.java | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/src/test/java/org/owasp/esapi/reference/crypto/EncryptorTest.java b/src/test/java/org/owasp/esapi/reference/crypto/EncryptorTest.java index 787464cb8..180a590ed 100644 --- a/src/test/java/org/owasp/esapi/reference/crypto/EncryptorTest.java +++ b/src/test/java/org/owasp/esapi/reference/crypto/EncryptorTest.java @@ -251,7 +251,7 @@ private String runNewEncryptDecryptTestCase(String cipherXform, int keySize, byt } else if ( cipherAlg.equals( "DES" ) ) { keySize = 64; } // Else... use specified keySize. - assertTrue( (keySize / 8) == skey.getEncoded().length ); + assertEquals(cipherXform + " encoded key size does not match provided key size", (keySize / 8), skey.getEncoded().length ); // System.out.println("testNewEncryptDecrypt(): Skey length (bits) = " + 8 * skey.getEncoded().length); // Change to a possibly different cipher. This is kludgey at best. Am thinking about an @@ -271,7 +271,7 @@ private String runNewEncryptDecryptTestCase(String cipherXform, int keySize, byt // Do the encryption with the new encrypt() method and get back the CipherText. CipherText ciphertext = instance.encrypt(skey, plaintext); // The new encrypt() method. System.out.println("DEBUG: Encrypt(): CipherText object is -- " + ciphertext); - assertTrue( ciphertext != null ); + assertNotNull( ciphertext ); // System.out.println("DEBUG: After encryption: base64-encoded IV+ciphertext: " + ciphertext.getEncodedIVCipherText()); // System.out.println("\t\tOr... " + ESAPI.encoder().decodeFromBase64(ciphertext.getEncodedIVCipherText()) ); // System.out.println("DEBUG: After encryption: base64-encoded raw ciphertext: " + ciphertext.getBase64EncodedRawCipherText()); @@ -290,14 +290,14 @@ private String runNewEncryptDecryptTestCase(String cipherXform, int keySize, byt // Make sure we got back the same thing we started with. System.out.println("\tOriginal plaintext: " + origPlainText); System.out.println("\tResult after decryption: " + decryptedPlaintext); - assertTrue( "Failed to decrypt properly.", origPlainText.toString().equals( decryptedPlaintext.toString() ) ); + assertEquals( "Failed to decrypt properly.", origPlainText.toString(), decryptedPlaintext.toString() ); // Restore the previous cipher transformation. For now, this is only way to do this. @SuppressWarnings("deprecation") String previousCipherXform = ESAPI.securityConfiguration().setCipherTransformation(null); - assertTrue( previousCipherXform.equals( cipherXform ) ); + assertEquals( previousCipherXform, cipherXform ); String defaultCipherXform = ESAPI.securityConfiguration().getCipherTransformation(); - assertTrue( defaultCipherXform.equals( oldCipherXform ) ); + assertEquals( defaultCipherXform, oldCipherXform ); return ciphertext.getEncodedIVCipherText(); } catch (Exception e) { From 5232e21036f2959875c7ec7996406f9692d8e5fe Mon Sep 17 00:00:00 2001 From: Jeremiah Stacey Date: Sun, 22 Jul 2018 08:04:57 -0500 Subject: [PATCH 496/812] Attempt at SLF4J Implementation Experimenting with one method that may be functional for slf4j hooks. This implementation has not been tested at either the unit or integration level. I do not know if it works yet. --- pom.xml | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/pom.xml b/pom.xml index 086f70917..6112a4e7f 100644 --- a/pom.xml +++ b/pom.xml @@ -243,6 +243,11 @@ 1.7.0 test + + org.slf4j + slf4j-api + 1.7.25 + org.powermock - powermock-api-mockito - 1.7.0 + powermock-api-mockito2 + 2.0.0-beta.5 test org.powermock powermock-module-junit4 - 1.7.0 + 2.0.0-beta.5 test org.slf4j slf4j-api - 1.7.25 + 1.8.0-beta2 - - joda-time - joda-time - 2.10 - + + + joda-time + joda-time + 2.10 + commons-configuration commons-configuration @@ -142,18 +145,11 @@ commons-beanutils 1.9.3 - - - junit - junit - 4.12 - test - - - org.bouncycastle - bcprov-jdk15on - 1.60 - test + javax.servlet @@ -163,8 +159,8 @@ javax.servlet.jsp - jsp-api - 2.2.1-b03 + javax.servlet.jsp-api + 2.3.3 provided @@ -173,12 +169,6 @@ 1.3.3 compile - - commons-io - commons-io - 2.6 - test - org.apache.commons commons-collections4 @@ -191,121 +181,104 @@ compile jar + + org.slf4j + slf4j-api + 1.7.25 + com.io7m.xom xom 1.2.10 - - xerces - xercesImpl - - - xml-apis - xml-apis - - - - - xml-apis - xml-apis - 1.4.01 - - - xerces - xercesImpl - 2.12.0 + + xerces + xercesImpl + + + xml-apis + xml-apis + + org.apache-extras.beanshell - bsh - 2.0b6 + bsh + 2.0b6 org.owasp.antisamy antisamy 1.5.7 - - xml-apis - xml-apis - - - xerces - xercesImpl - - + + xml-apis + xml-apis + + + xerces + xercesImpl + + - xalan xalan 2.7.2 - - - xml-apis - xml-apis - - + + + xml-apis + xml-apis + 1.4.01 org.apache.xmlgraphics batik-css 1.10 - - - - org.powermock - powermock-api-mockito2 - 2.0.0-beta.5 - test - - - org.powermock - powermock-module-junit4 - 2.0.0-beta.5 - test - - - org.slf4j - slf4j-api - 1.7.25 - - - - - + + xerces + xercesImpl + 2.12.0 + + + + junit + junit + 4.12 + test + + + org.bouncycastle + bcprov-jdk15on + 1.60 + test + + + commons-io + commons-io + 2.6 + test + + + + org.powermock + powermock-api-mockito2 + 2.0.0-beta.5 + test + + + org.powermock + powermock-module-junit4 + 2.0.0-beta.5 + test + @@ -404,7 +377,7 @@ dependency-check-maven 2.1.0 - 5.9 + ./suppressions.xml @@ -609,37 +582,37 @@ - - org.apache.maven.plugins - maven-jar-plugin - 2.6 + + org.apache.maven.plugins + maven-jar-plugin + 2.6 - + - - - true - true - - - true - - - - + + + true + true + + + true + + + + diff --git a/src/main/java/org/owasp/esapi/reference/accesscontrol/DelegatingACR.java b/src/main/java/org/owasp/esapi/reference/accesscontrol/DelegatingACR.java index fa532ddaf..8c7698908 100644 --- a/src/main/java/org/owasp/esapi/reference/accesscontrol/DelegatingACR.java +++ b/src/main/java/org/owasp/esapi/reference/accesscontrol/DelegatingACR.java @@ -5,7 +5,7 @@ import java.util.Iterator; import java.util.Vector; -import org.apache.commons.collections.iterators.ArrayListIterator; +import org.apache.commons.collections4.iterators.ArrayListIterator; public class DelegatingACR extends BaseACR { protected Method delegateMethod; From fe2cfff3c415d43f5c0a5f53dbba32f636e57dae Mon Sep 17 00:00:00 2001 From: kwwall Date: Fri, 5 Oct 2018 15:43:47 -0400 Subject: [PATCH 515/812] Close issue #444. Delete deprecated decodeToObject() method and 2 related encodeObject() methods. General whitespace clean-up. Delete EncoderTest.testBase64decodToObject() method which is no longer relevant. --- .../java/org/owasp/esapi/codecs/Base64.java | 839 ++++++------------ .../owasp/esapi/reference/EncoderTest.java | 54 -- 2 files changed, 293 insertions(+), 600 deletions(-) diff --git a/src/main/java/org/owasp/esapi/codecs/Base64.java b/src/main/java/org/owasp/esapi/codecs/Base64.java index b92f35590..150bd29ef 100644 --- a/src/main/java/org/owasp/esapi/codecs/Base64.java +++ b/src/main/java/org/owasp/esapi/codecs/Base64.java @@ -15,14 +15,14 @@ *

Homepage: http://iharder.net/base64 * (based on version 2.2.2).

* - *

The options parameter, which appears in a few places, is used to pass - * several pieces of information to the encoder. In the "higher level" methods such as - * encodeBytes( bytes, options ) the options parameter can be used to indicate such - * things as first gzipping the bytes before encoding them, not inserting linefeeds - * (though that breaks strict Base64 compatibility), and encoding using the URL-safe + *

The options parameter, which appears in a few places, is used to pass + * several pieces of information to the encoder. In the "higher level" methods such as + * encodeBytes( bytes, options ) the options parameter can be used to indicate such + * things as first gzipping the bytes before encoding them, not inserting linefeeds + * (though that breaks strict Base64 compatibility), and encoding using the URL-safe * and Ordered dialects.

* - *

The constants defined in Base64 can be OR-ed together to combine options, so you + *

The constants defined in Base64 can be OR-ed together to combine options, so you * might make a call like this:

* * String encoded = Base64.encodeBytes( mybytes, Base64.GZIP | Base64.DONT_BREAK_LINES ); @@ -54,24 +54,24 @@ * Special thanks to Jim Kellerman at http://www.powerset.com/ * for contributing the new Base64 dialects. * - * + * *
  • v2.1 - Cleaned up javadoc comments and unused variables and methods. Added * some convenience methods for reading and writing to and from files.
    • *
  • v2.0.2 - Now specifies UTF-8 encoding in places where the code fails on systems * with other encodings (like EBCDIC).
    • *
  • v2.0.1 - Fixed an error when decoding a single byte, that is, when the * encoded data was a single byte.
    • - *
  • v2.0 - I got rid of methods that used booleans to set options. + *
  • v2.0 - I got rid of methods that used booleans to set options. * Now everything is more consolidated and cleaner. The code now detects * when data that's being decoded is gzip-compressed and will decompress it * automatically. Generally things are cleaner. You'll probably have to * change some method calls that you were making to support the new * options format (ints that you "OR" together).
    • - *
  • v1.5.1 - Fixed bug when decompressing and decoding to a - * byte[] using decode( String s, boolean gzipCompressed ). - * Added the ability to "suspend" encoding in the Output Stream so - * you can turn on and off the encoding if you need to embed base64 - * data in an otherwise "normal" stream (like an XML file).
    • + *
  • v1.5.1 - Fixed bug when decompressing and decoding to a + * byte[] using decode( String s, boolean gzipCompressed ). + * Added the ability to "suspend" encoding in the Output Stream so + * you can turn on and off the encoding if you need to embed base64 + * data in an otherwise "normal" stream (like an XML file).
    • *
  • v1.5 - Output stream pases on flush() command but doesn't do anything itself. * This helps when using GZIP streams. * Added the ability to GZip-compress objects before encoding them.
    • @@ -97,108 +97,98 @@ */ public class Base64 { - -/* ******** P U B L I C F I E L D S ******** */ - - + +/* ******** P U B L I C F I E L D S ******** */ + + /** No options specified. Value is zero. */ public final static int NO_OPTIONS = 0; - + /** Specify encoding. */ public final static int ENCODE = 1; - - + /** Specify decoding. */ public final static int DECODE = 0; - - + /** Specify that data should be gzip-compressed. */ public final static int GZIP = 2; - - + /** Don't break lines when encoding (violates strict Base64 specification) */ public final static int DONT_BREAK_LINES = 8; - - /** - * Encode using Base64-like encoding that is URL- and Filename-safe as described - * in Section 4 of RFC3548: - * http://www.faqs.org/rfcs/rfc3548.html. - * It is important to note that data encoded this way is not officially valid Base64, - * or at the very least should not be called Base64 without also specifying that is - * was encoded using the URL- and Filename-safe dialect. - */ - public final static int URL_SAFE = 16; - - - /** - * Encode using the special "ordered" dialect of Base64 described here: - * http://www.faqs.org/qa/rfcc-1940.html. - */ - public final static int ORDERED = 32; - + + /** + * Encode using Base64-like encoding that is URL- and Filename-safe as described + * in Section 4 of RFC3548: + * http://www.faqs.org/rfcs/rfc3548.html. + * It is important to note that data encoded this way is not officially valid Base64, + * or at the very least should not be called Base64 without also specifying that is + * was encoded using the URL- and Filename-safe dialect. + */ + public final static int URL_SAFE = 16; + + /** + * Encode using the special "ordered" dialect of Base64 described here: + * http://www.faqs.org/qa/rfcc-1940.html. + */ + public final static int ORDERED = 32; + /** * System property name that must be set to true in order to invoke {@code Base64.decodeToObject()}. * @see https://github.com/ESAPI/esapi-java-legacy/issues/354 * @see http://foxglovesecurity.com/2015/11/06/what-do-weblogic-websphere-jboss-jenkins-opennms-and-your-application-have-in-common-this-vulnerability/ */ public final static String ENABLE_UNSAFE_SERIALIZATION = "org.owasp.esapi.enableUnsafeSerialization"; // Do NOT change! - -/* ******** P R I V A T E F I E L D S ******** */ - - + +/* ******** P R I V A T E F I E L D S ******** */ + /** Maximum line length (76) of Base64 output. */ private final static int MAX_LINE_LENGTH = 76; - - + /** The equals sign (=) as a byte. */ private final static byte EQUALS_SIGN = (byte)'='; - - + /** The new line character (\n) as a byte. */ private final static byte NEW_LINE = (byte)'\n'; - - + /** Preferred encoding. */ private final static String PREFERRED_ENCODING = "UTF-8"; - + /** End of line character. */ private final static String EOL = System.getProperty("line.separator", "\n"); - - + + // I think I end up not using the BAD_ENCODING indicator. //private final static byte BAD_ENCODING = -9; // Indicates error in encoding private final static byte WHITE_SPACE_ENC = -5; // Indicates white space in encoding private final static byte EQUALS_SIGN_ENC = -1; // Indicates equals sign in encoding - + private static final Logger logger = ESAPI.getLogger("Base64"); - - -/* ******** S T A N D A R D B A S E 6 4 A L P H A B E T ******** */ - + +/* ******** S T A N D A R D B A S E 6 4 A L P H A B E T ******** */ + /** The 64 valid Base64 values. */ //private final static byte[] ALPHABET; - /* Host platform me be something funny like EBCDIC, so we hard code these values. */ - private final static byte[] _STANDARD_ALPHABET = + /* Host platform me be something funny like EBCDIC, so we hard code these values. */ + private final static byte[] _STANDARD_ALPHABET = { (byte)'A', (byte)'B', (byte)'C', (byte)'D', (byte)'E', (byte)'F', (byte)'G', (byte)'H', (byte)'I', (byte)'J', (byte)'K', (byte)'L', (byte)'M', (byte)'N', - (byte)'O', (byte)'P', (byte)'Q', (byte)'R', (byte)'S', (byte)'T', (byte)'U', + (byte)'O', (byte)'P', (byte)'Q', (byte)'R', (byte)'S', (byte)'T', (byte)'U', (byte)'V', (byte)'W', (byte)'X', (byte)'Y', (byte)'Z', (byte)'a', (byte)'b', (byte)'c', (byte)'d', (byte)'e', (byte)'f', (byte)'g', (byte)'h', (byte)'i', (byte)'j', (byte)'k', (byte)'l', (byte)'m', (byte)'n', - (byte)'o', (byte)'p', (byte)'q', (byte)'r', (byte)'s', (byte)'t', (byte)'u', + (byte)'o', (byte)'p', (byte)'q', (byte)'r', (byte)'s', (byte)'t', (byte)'u', (byte)'v', (byte)'w', (byte)'x', (byte)'y', (byte)'z', - (byte)'0', (byte)'1', (byte)'2', (byte)'3', (byte)'4', (byte)'5', + (byte)'0', (byte)'1', (byte)'2', (byte)'3', (byte)'4', (byte)'5', (byte)'6', (byte)'7', (byte)'8', (byte)'9', (byte)'+', (byte)'/' }; - - - /** + + /** * Translates a Base64 value to either its 6-bit reconstruction value * or a negative number indicating some other meaning. **/ private final static byte[] _STANDARD_DECODABET = - { + { -9,-9,-9,-9,-9,-9,-9,-9,-9, // Decimal 0 - 8 -5,-5, // Whitespace: Tab and Linefeed -9,-9, // Decimal 11 - 12 @@ -231,34 +221,34 @@ public class Base64 -9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9, // Decimal 231 - 243 -9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9 // Decimal 244 - 255 */ }; - - + + /* ******** U R L S A F E B A S E 6 4 A L P H A B E T ******** */ - - /** - * Used in the URL- and Filename-safe dialect described in Section 4 of RFC3548: - * http://www.faqs.org/rfcs/rfc3548.html. - * Notice that the last two bytes become "hyphen" and "underscore" instead of "plus" and "slash." - */ + + /** + * Used in the URL- and Filename-safe dialect described in Section 4 of RFC3548: + * http://www.faqs.org/rfcs/rfc3548.html. + * Notice that the last two bytes become "hyphen" and "underscore" instead of "plus" and "slash." + */ private final static byte[] _URL_SAFE_ALPHABET = { (byte)'A', (byte)'B', (byte)'C', (byte)'D', (byte)'E', (byte)'F', (byte)'G', (byte)'H', (byte)'I', (byte)'J', (byte)'K', (byte)'L', (byte)'M', (byte)'N', - (byte)'O', (byte)'P', (byte)'Q', (byte)'R', (byte)'S', (byte)'T', (byte)'U', + (byte)'O', (byte)'P', (byte)'Q', (byte)'R', (byte)'S', (byte)'T', (byte)'U', (byte)'V', (byte)'W', (byte)'X', (byte)'Y', (byte)'Z', (byte)'a', (byte)'b', (byte)'c', (byte)'d', (byte)'e', (byte)'f', (byte)'g', (byte)'h', (byte)'i', (byte)'j', (byte)'k', (byte)'l', (byte)'m', (byte)'n', - (byte)'o', (byte)'p', (byte)'q', (byte)'r', (byte)'s', (byte)'t', (byte)'u', + (byte)'o', (byte)'p', (byte)'q', (byte)'r', (byte)'s', (byte)'t', (byte)'u', (byte)'v', (byte)'w', (byte)'x', (byte)'y', (byte)'z', - (byte)'0', (byte)'1', (byte)'2', (byte)'3', (byte)'4', (byte)'5', + (byte)'0', (byte)'1', (byte)'2', (byte)'3', (byte)'4', (byte)'5', (byte)'6', (byte)'7', (byte)'8', (byte)'9', (byte)'-', (byte)'_' }; - - /** - * Used in decoding URL- and Filename-safe dialects of Base64. - */ + + /** + * Used in decoding URL- and Filename-safe dialects of Base64. + */ private final static byte[] _URL_SAFE_DECODABET = - { + { -9,-9,-9,-9,-9,-9,-9,-9,-9, // Decimal 0 - 8 -5,-5, // Whitespace: Tab and Linefeed -9,-9, // Decimal 11 - 12 @@ -300,10 +290,10 @@ public class Base64 /* ******** O R D E R E D B A S E 6 4 A L P H A B E T ******** */ - /** - * I don't get the point of this technique, but it is described here: - * http://www.faqs.org/qa/rfcc-1940.html. - */ + /** + * I don't get the point of this technique, but it is described here: + * http://www.faqs.org/qa/rfcc-1940.html. + */ private final static byte[] _ORDERED_ALPHABET = { (byte)'-', @@ -319,12 +309,12 @@ public class Base64 (byte)'o', (byte)'p', (byte)'q', (byte)'r', (byte)'s', (byte)'t', (byte)'u', (byte)'v', (byte)'w', (byte)'x', (byte)'y', (byte)'z' }; - - /** - * Used in decoding the "ordered" dialect of Base64. - */ + + /** + * Used in decoding the "ordered" dialect of Base64. + */ private final static byte[] _ORDERED_DECODABET = - { + { -9,-9,-9,-9,-9,-9,-9,-9,-9, // Decimal 0 - 8 -5,-5, // Whitespace: Tab and Linefeed -9,-9, // Decimal 11 - 12 @@ -362,46 +352,43 @@ public class Base64 -9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9,-9 // Decimal 244 - 255 */ }; - + /* ******** D E T E R M I N E W H I C H A L H A B E T ******** */ - /** - * Returns one of the _SOMETHING_ALPHABET byte arrays depending on - * the options specified. - * It's possible, though silly, to specify ORDERED and URLSAFE - * in which case one of them will be picked, though there is - * no guarantee as to which one will be picked. - */ - private final static byte[] getAlphabet( int options ) - { - if( (options & URL_SAFE) == URL_SAFE ) return _URL_SAFE_ALPHABET; - else if( (options & ORDERED) == ORDERED ) return _ORDERED_ALPHABET; - else return _STANDARD_ALPHABET; - - } // end getAlphabet - - - /** - * Returns one of the _SOMETHING_DECODABET byte arrays depending on - * the options specified. - * It's possible, though silly, to specify ORDERED and URL_SAFE - * in which case one of them will be picked, though there is - * no guarantee as to which one will be picked. - */ - private final static byte[] getDecodabet( int options ) - { - if( (options & URL_SAFE) == URL_SAFE ) return _URL_SAFE_DECODABET; - else if( (options & ORDERED) == ORDERED ) return _ORDERED_DECODABET; - else return _STANDARD_DECODABET; - - } // end getAlphabet - - - + /** + * Returns one of the _SOMETHING_ALPHABET byte arrays depending on + * the options specified. + * It's possible, though silly, to specify ORDERED and URLSAFE + * in which case one of them will be picked, though there is + * no guarantee as to which one will be picked. + */ + private final static byte[] getAlphabet( int options ) + { + if( (options & URL_SAFE) == URL_SAFE ) return _URL_SAFE_ALPHABET; + else if( (options & ORDERED) == ORDERED ) return _ORDERED_ALPHABET; + else return _STANDARD_ALPHABET; + + } // end getAlphabet + + + /** + * Returns one of the _SOMETHING_DECODABET byte arrays depending on + * the options specified. + * It's possible, though silly, to specify ORDERED and URL_SAFE + * in which case one of them will be picked, though there is + * no guarantee as to which one will be picked. + */ + private final static byte[] getDecodabet( int options ) + { + if( (options & URL_SAFE) == URL_SAFE ) return _URL_SAFE_DECODABET; + else if( (options & ORDERED) == ORDERED ) return _ORDERED_DECODABET; + else return _STANDARD_DECODABET; + + } // end getDecodaabet + /** Defeats instantiation. */ private Base64(){} - /** * Encodes or decodes two files from the command line; @@ -423,10 +410,10 @@ public final static void main( String[] args ) } // end if: encode else if( flag.equals( "-d" ) ) { Base64.decodeFileToFile( infile, outfile ); - } // end else if: decode + } // end else if: decode else { usage( "Unknown flag: " + flag ); - } // end else + } // end else } // end else } // end main @@ -440,11 +427,9 @@ private final static void usage( String msg ) System.err.println( msg ); System.err.println( "Usage: java Base64 -e|-d inputfile outputfile" ); } // end usage - - -/* ******** E N C O D I N G M E T H O D S ******** */ - - + +/* ******** E N C O D I N G M E T H O D S ******** */ + /** * Encodes up to the first three bytes of array threeBytes * and returns a four-byte array in Base64 notation. @@ -466,12 +451,11 @@ private static byte[] encode3to4( byte[] b4, byte[] threeBytes, int numSigBytes, return b4; } // end encode3to4 - /** *

    Encodes up to three bytes of the array source * and writes the resulting four Base64 bytes to destination. * The source and destination arrays can be manipulated - * anywhere along their length by specifying + * anywhere along their length by specifying * srcOffset and destOffset. * This method does not check to make sure your arrays * are large enough to accomodate srcOffset + 3 for @@ -479,8 +463,8 @@ private static byte[] encode3to4( byte[] b4, byte[] threeBytes, int numSigBytes, * the destination array. * The actual number of significant bytes in your array is * given by numSigBytes.

    - *

    This is the lowest level of the encoding methods with - * all possible parameters.

    + *

    This is the lowest level of the encoding methods with + * all possible parameters.

    * * @param source the array to convert * @param srcOffset the index where conversion begins @@ -490,19 +474,19 @@ private static byte[] encode3to4( byte[] b4, byte[] threeBytes, int numSigBytes, * @return the destination array * @since 1.3 */ - private static byte[] encode3to4( - byte[] source, int srcOffset, int numSigBytes, - byte[] destination, int destOffset, int options ) + private static byte[] encode3to4( + byte[] source, int srcOffset, int numSigBytes, + byte[] destination, int destOffset, int options ) { - byte[] ALPHABET = getAlphabet( options ); - - // 1 2 3 + byte[] ALPHABET = getAlphabet( options ); + + // 1 2 3 // 01234567890123456789012345678901 Bit position // --------000000001111111122222222 Array position from threeBytes // --------| || || || | Six bit groups to index ALPHABET // >>18 >>12 >> 6 >> 0 Right shift necessary // 0x3f 0x3f 0x3f Additional AND - + // Create buffer with zero-padding if there are only one or two // significant bytes passed in the array. // We have to shift left 24 in order to flush out the 1's that appear @@ -519,124 +503,25 @@ private static byte[] encode3to4( destination[ destOffset + 2 ] = ALPHABET[ (inBuff >>> 6) & 0x3f ]; destination[ destOffset + 3 ] = ALPHABET[ (inBuff ) & 0x3f ]; return destination; - + case 2: destination[ destOffset ] = ALPHABET[ (inBuff >>> 18) ]; destination[ destOffset + 1 ] = ALPHABET[ (inBuff >>> 12) & 0x3f ]; destination[ destOffset + 2 ] = ALPHABET[ (inBuff >>> 6) & 0x3f ]; destination[ destOffset + 3 ] = EQUALS_SIGN; return destination; - + case 1: destination[ destOffset ] = ALPHABET[ (inBuff >>> 18) ]; destination[ destOffset + 1 ] = ALPHABET[ (inBuff >>> 12) & 0x3f ]; destination[ destOffset + 2 ] = EQUALS_SIGN; destination[ destOffset + 3 ] = EQUALS_SIGN; return destination; - + default: return destination; } // end switch } // end encode3to4 - - - - /** - * Serializes an object and returns the Base64-encoded - * version of that serialized object. If the object - * cannot be serialized or there is another error, - * the method will return null. - * The object is not GZip-compressed before being encoded. - * - * @param serializableObject The object to encode - * @return The Base64-encoded object - * @since 1.4 - */ - public static String encodeObject( java.io.Serializable serializableObject ) - { - return encodeObject( serializableObject, NO_OPTIONS ); - } // end encodeObject - - - - /** - * Serializes an object and returns the Base64-encoded - * version of that serialized object. If the object - * cannot be serialized or there is another error, - * the method will return null. - *

    - * Valid options:

    -     *   GZIP: gzip-compresses object before encoding it.
-     *   DONT_BREAK_LINES: don't break lines at 76 characters
-     *     Note: Technically, this makes your encoding non-compliant.
-     *
    - *

    - * Example: encodeObject( myObj, Base64.GZIP ) or - *

    - * Example: encodeObject( myObj, Base64.GZIP | Base64.DONT_BREAK_LINES ) - * - * @param serializableObject The object to encode - * @param options Specified options - * @return The Base64-encoded object - * @see Base64#GZIP - * @see Base64#DONT_BREAK_LINES - * @since 2.0 - */ - public static String encodeObject( java.io.Serializable serializableObject, int options ) - { - // Streams - java.io.ByteArrayOutputStream baos = null; - java.io.OutputStream b64os = null; - java.io.ObjectOutputStream oos = null; - java.util.zip.GZIPOutputStream gzos = null; - - // Isolate options - int gzip = (options & GZIP); - //int dontBreakLines = (options & DONT_BREAK_LINES); - - try - { - // ObjectOutputStream -> (GZIP) -> Base64 -> ByteArrayOutputStream - baos = new java.io.ByteArrayOutputStream(); - b64os = new Base64.OutputStream( baos, ENCODE | options ); - - // GZip? - if( gzip == GZIP ) - { - gzos = new java.util.zip.GZIPOutputStream( b64os ); - oos = new java.io.ObjectOutputStream( gzos ); - } // end if: gzip - else - oos = new java.io.ObjectOutputStream( b64os ); - - oos.writeObject( serializableObject ); - } // end try - catch( java.io.IOException e ) - { - logger.error( Logger.SECURITY_FAILURE, "Problem writing object", e ); - return null; - } // end catch - finally - { - try{ oos.close(); } catch( Exception e ){} - try{ gzos.close(); } catch( Exception e ){} - try{ b64os.close(); } catch( Exception e ){} - try{ baos.close(); } catch( Exception e ){} - } // end finally - - // Return value according to relevant encoding. - try - { - return new String( baos.toByteArray(), PREFERRED_ENCODING ); - } // end try - catch (java.io.UnsupportedEncodingException uue) - { - return new String( baos.toByteArray() ); - } // end catch - - } // end encode - - /** * Encodes a byte array into Base64 notation. @@ -650,7 +535,7 @@ public static String encodeBytes( byte[] source ) { return encodeBytes( source, 0, source.length, NO_OPTIONS ); } // end encodeBytes - + /** @@ -675,11 +560,10 @@ public static String encodeBytes( byte[] source ) * @since 2.0 */ public static String encodeBytes( byte[] source, int options ) - { + { return encodeBytes( source, 0, source.length, options ); } // end encodeBytes - - + /** * Encodes a byte array into Base64 notation. * Does not GZip-compress data. @@ -694,8 +578,6 @@ public static String encodeBytes( byte[] source, int off, int len ) { return encodeBytes( source, off, len, NO_OPTIONS ); } // end encodeBytes - - /** * Encodes a byte array into Base64 notation. @@ -725,22 +607,21 @@ public static String encodeBytes( byte[] source, int off, int len, int options ) // Isolate options int dontBreakLines = ( options & DONT_BREAK_LINES ); int gzip = ( options & GZIP ); - + // Compress? if( gzip == GZIP ) { java.io.ByteArrayOutputStream baos = null; java.util.zip.GZIPOutputStream gzos = null; Base64.OutputStream b64os = null; - - + try { // GZip -> Base64 -> ByteArray baos = new java.io.ByteArrayOutputStream(); b64os = new Base64.OutputStream( baos, ENCODE | options ); - gzos = new java.util.zip.GZIPOutputStream( b64os ); - + gzos = new java.util.zip.GZIPOutputStream( b64os ); + gzos.write( source, off, len ); gzos.close(); } // end try @@ -766,17 +647,17 @@ public static String encodeBytes( byte[] source, int off, int len, int options ) return new String( baos.toByteArray() ); } // end catch } // end if: compress - + // Else, don't compress. Better not to use streams at all then. else { // Convert option to boolean in way that code likes it. boolean breakLines = dontBreakLines == 0; - + int len43 = len * 4 / 3; byte[] outBuff = new byte[ ( len43 ) // Main 4:3 + ( (len % 3) > 0 ? 4 : 0 ) // Account for padding - + (breakLines ? ( len43 / MAX_LINE_LENGTH ) : 0) ]; // New lines + + (breakLines ? ( len43 / MAX_LINE_LENGTH ) : 0) ]; // New lines int d = 0; int e = 0; int len2 = len - 2; @@ -787,7 +668,7 @@ public static String encodeBytes( byte[] source, int off, int len, int options ) lineLength += 4; if( breakLines && lineLength == MAX_LINE_LENGTH ) - { + { outBuff[e+4] = NEW_LINE; e++; lineLength = 0; @@ -800,7 +681,7 @@ public static String encodeBytes( byte[] source, int off, int len, int options ) e += 4; } // end if: some padding needed - + // Return value according to relevant encoding. try { @@ -810,47 +691,42 @@ public static String encodeBytes( byte[] source, int off, int len, int options ) { return new String( outBuff, 0, e ); } // end catch - + } // end else: don't compress - + } // end encodeBytes - - - - /* ******** D E C O D I N G M E T H O D S ******** */ - - + /** * Decodes four bytes from array source * and writes the resulting bytes (up to three of them) * to destination. * The source and destination arrays can be manipulated - * anywhere along their length by specifying + * anywhere along their length by specifying * srcOffset and destOffset. * This method does not check to make sure your arrays * are large enough to accomodate srcOffset + 4 for * the source array or destOffset + 3 for * the destination array. - * This method returns the actual number of bytes that + * This method returns the actual number of bytes that * were converted from the Base64 encoding. - *

    This is the lowest level of the decoding methods with - * all possible parameters.

    - * + *

    This is the lowest level of the decoding methods with + * all possible parameters.

    + * * * @param source the array to convert * @param srcOffset the index where conversion begins * @param destination the array to hold the conversion * @param destOffset the index where output will be put - * @param options alphabet type is pulled from this (standard, url-safe, ordered) + * @param options alphabet type is pulled from this (standard, url-safe, ordered) * @return the number of decoded bytes converted * @since 1.3 */ private static int decode4to3( byte[] source, int srcOffset, byte[] destination, int destOffset, int options ) { - byte[] DECODABET = getDecodabet( options ); - + byte[] DECODABET = getDecodabet( options ); + // Example: Dk== if( source[ srcOffset + 2] == EQUALS_SIGN ) { @@ -859,11 +735,11 @@ private static int decode4to3( byte[] source, int srcOffset, byte[] destination, // | ( ( DECODABET[ source[ srcOffset + 1] ] << 24 ) >>> 12 ); int outBuff = ( ( DECODABET[ source[ srcOffset ] ] & 0xFF ) << 18 ) | ( ( DECODABET[ source[ srcOffset + 1] ] & 0xFF ) << 12 ); - + destination[ destOffset ] = (byte)( outBuff >>> 16 ); return 1; } - + // Example: DkL= else if( source[ srcOffset + 3 ] == EQUALS_SIGN ) { @@ -874,12 +750,12 @@ else if( source[ srcOffset + 3 ] == EQUALS_SIGN ) int outBuff = ( ( DECODABET[ source[ srcOffset ] ] & 0xFF ) << 18 ) | ( ( DECODABET[ source[ srcOffset + 1 ] ] & 0xFF ) << 12 ) | ( ( DECODABET[ source[ srcOffset + 2 ] ] & 0xFF ) << 6 ); - + destination[ destOffset ] = (byte)( outBuff >>> 16 ); destination[ destOffset + 1 ] = (byte)( outBuff >>> 8 ); return 2; } - + // Example: DkLE else { @@ -894,44 +770,41 @@ else if( source[ srcOffset + 3 ] == EQUALS_SIGN ) | ( ( DECODABET[ source[ srcOffset + 2 ] ] & 0xFF ) << 6) | ( ( DECODABET[ source[ srcOffset + 3 ] ] & 0xFF ) ); - + destination[ destOffset ] = (byte)( outBuff >> 16 ); destination[ destOffset + 1 ] = (byte)( outBuff >> 8 ); destination[ destOffset + 2 ] = (byte)( outBuff ); return 3; }catch( Exception e){ - + // Remove these after checking -- for context only. // logger.error( Logger.SECURITY_FAILURE, "Problem writing object", e ); // logger.error( Logger.SECURITY_FAILURE, ""+source[srcOffset]+ ": " + ( DECODABET[ source[ srcOffset ] ] ) ); // logger.error( Logger.SECURITY_FAILURE, ""+source[srcOffset+1]+ ": " + ( DECODABET[ source[ srcOffset + 1 ] ] ) ); // logger.error( Logger.SECURITY_FAILURE, ""+source[srcOffset+2]+ ": " + ( DECODABET[ source[ srcOffset + 2 ] ] ) ); // logger.error( Logger.SECURITY_FAILURE, ""+source[srcOffset+3]+ ": " + ( DECODABET[ source[ srcOffset + 3 ] ] ) ); - - // CHECKME: I replaced the 5 separate logger.error() calls above with a single logger.error() call so they can't - // become interleaved with other log entries from other threads. Normally this would have placed log entries - // on separate lines, so I also added line terminators here as well. (Probably don't want it all on one single - // really long log entry, do we?) Anyhow, somebody should check the formatting to ensure that it's - // esthetically pleasing, etc. But this works for me. I'm also OK if you want to remove all the line terminators - // in which case the declaration for EOL should be removed as well. - Kevin Wall - + + // CHECKME: I replaced the 5 separate logger.error() calls above with a single logger.error() call so they can't + // become interleaved with other log entries from other threads. Normally this would have placed log entries + // on separate lines, so I also added line terminators here as well. (Probably don't want it all on one single + // really long log entry, do we?) Anyhow, somebody should check the formatting to ensure that it's + // esthetically pleasing, etc. But this works for me. I'm also OK if you want to remove all the line terminators + // in which case the declaration for EOL should be removed as well. - Kevin Wall + StringBuilder sb = new StringBuilder("Problem writing object:"); sb.append(EOL); sb.append( source[srcOffset] ).append(": ").append( ( DECODABET[ source[ srcOffset ] ] ) ).append(EOL); sb.append( source[srcOffset+1] ).append(": ").append( ( DECODABET[ source[ srcOffset + 1 ] ] ) ).append(EOL); sb.append( source[srcOffset+2] ).append(": ").append( ( DECODABET[ source[ srcOffset + 2 ] ] ) ).append(EOL); sb.append( source[srcOffset+3] ).append(": ").append( ( DECODABET[ source[ srcOffset + 3 ] ] ) ).append(EOL); - + logger.error( Logger.SECURITY_FAILURE, sb.toString(), e ); return -1; } // end catch } } // end decodeToBytes - - - - + /** * Very low-level access to decoding ASCII characters in * the form of a byte array. Does not support automatically @@ -946,12 +819,12 @@ else if( source[ srcOffset + 3 ] == EQUALS_SIGN ) */ public static byte[] decode( byte[] source, int off, int len, int options ) { - byte[] DECODABET = getDecodabet( options ); - + byte[] DECODABET = getDecodabet( options ); + int len34 = len * 3 / 4; byte[] outBuff = new byte[ len34 ]; // Upper limit on size of output int outBuffPosn = 0; - + byte[] b4 = new byte[4]; int b4Posn = 0; int i = 0; @@ -961,7 +834,7 @@ public static byte[] decode( byte[] source, int off, int len, int options ) { sbiCrop = (byte)(source[i] & 0x7f); // Only the low seven bits sbiDecode = DECODABET[ sbiCrop ]; - + if( sbiDecode >= WHITE_SPACE_ENC ) // White space, Equals sign or better { if( sbiDecode >= EQUALS_SIGN_ENC ) @@ -971,30 +844,27 @@ public static byte[] decode( byte[] source, int off, int len, int options ) { outBuffPosn += decode4to3( b4, 0, outBuff, outBuffPosn, options ); b4Posn = 0; - + // If that was the equals sign, break out of 'for' loop if( sbiCrop == EQUALS_SIGN ) break; } // end if: quartet built - + } // end if: equals sign or better - + } // end if: white space, equals sign or better else { - logger.error( Logger.SECURITY_FAILURE, "Bad Base64 input character at " + i + ": " + source[i] + "(decimal)" ); + logger.error( Logger.SECURITY_FAILURE, "Bad Base64 input character at " + i + ": " + source[i] + "(decimal)" ); return null; - } // end else: + } // end else: } // each input character - + byte[] out = new byte[ outBuffPosn ]; - System.arraycopy( outBuff, 0, out, 0, outBuffPosn ); + System.arraycopy( outBuff, 0, out, 0, outBuffPosn ); return out; } // end decode - - - - + /** * Decodes data from Base64 notation, automatically * detecting gzip-compressed data and decompressing it. @@ -1004,22 +874,21 @@ public static byte[] decode( byte[] source, int off, int len, int options ) * @since 1.4 */ public static byte[] decode( String s ) - { - return decode( s, NO_OPTIONS ); - } - - + { + return decode( s, NO_OPTIONS ); + } + /** * Decodes data from Base64 notation, automatically * detecting gzip-compressed data and decompressing it. * * @param s the string to decode - * @param options encode options such as URL_SAFE + * @param options encode options such as URL_SAFE * @return the decoded data * @since 1.4 */ public static byte[] decode( String s, int options ) - { + { byte[] bytes; try { @@ -1027,25 +896,24 @@ public static byte[] decode( String s, int options ) } catch( java.io.UnsupportedEncodingException uee ) { - bytes = s.getBytes(); // Uses native encoding + bytes = s.getBytes(); // Uses native encoding // CHECKME: Is this correct? I think it should be a warning instead of an error since nothing // is re-thrown. I do think that *some* sort of logging is in order here especially since UTF-8 should // always be available on all platforms. If it's not, then all bets are off on your runtime env. - Kevin Wall logger.warning( Logger.SECURITY_FAILURE, "Problem decoding string using " + - PREFERRED_ENCODING + "; substituting native platform encoding instead", uee ); + PREFERRED_ENCODING + "; substituting native platform encoding instead", uee ); } - + // Decode bytes = decode( bytes, 0, bytes.length, options ); - - + // Check to see if it's gzip-compressed // GZIP Magic Two-Byte Number: 0x8b1f (35615) if( bytes != null && bytes.length >= 4 ) { - - int head = ((int)bytes[0] & 0xff) | ((bytes[1] << 8) & 0xff00); - if( java.util.zip.GZIPInputStream.GZIP_MAGIC == head ) + + int head = ((int)bytes[0] & 0xff) | ((bytes[1] << 8) & 0xff00); + if ( java.util.zip.GZIPInputStream.GZIP_MAGIC == head ) { java.io.ByteArrayInputStream bais = null; java.util.zip.GZIPInputStream gzis = null; @@ -1081,95 +949,10 @@ public static byte[] decode( String s, int options ) } // end if: gzipped } // end if: bytes.length >= 2 - + return bytes; } // end decode - - - - /** - * Attempts to decode Base64 data and deserialize a Java - * Object within. Returns null if there was an error. - * - *

    - * WARNING: Using this method to decode non-validated / - * untrusted data from a string and deserialize it into - * an object can potentially result in remote command - * injection vulnerabilities. Use at your own risk! - *

    IMPORTANT BACKWARD COMPATIBILITY NOTICE
    - * Because this static method can easily be used as an attack vector - * for those passing in deserialized objects, in a manner similar to the - * Apache Commons Collections InvokerTransformer - * issue, we are requiring that the system property - * {@code org.owasp.esapi.enableUnsafeSerialization} - * be set to "true" in order for this method to be successfully invoked. - * We apologize for the inconvenience this may cause in breaking anyone's - * application, but we feel that it is for the greater good. - *

    - * - * @param encodedObject The Base64 data to decode - * @return The decoded and deserialized object - * @since 1.5 - * - * @deprecated Because of security issues, this method will be - * removed from ESAPI in a future release and no substitute - * is planned. Because as of JDK 8 (in 1Q2016) there is - * currently no way to restrict which objects - * ObjectInputStream.readObject() - * may safely deserialize in the general case. Oracle - * may decide to address this deficiency in a future Java - * release, but until they do, there is no simple way for - * a general class library like ESAPI to address this. - */ - @Deprecated - public static Object decodeToObject( String encodedObject ) - { - // We will do better when we attempt this again, allowing for a second argument - // to specify some sort of a collection of white-listed classes. Until then... - // See: http://www.ibm.com/developerworks/library/se-lookahead/ for how-to. - if ( ! "true".equalsIgnoreCase( System.getProperty( ENABLE_UNSAFE_SERIALIZATION ) ) ) { - throw new UnsupportedOperationException( - "Deserialization by Base64.decodeToObject(String) is disabled for security reasons. " + - "To re-enable it, set the system property '" + ENABLE_UNSAFE_SERIALIZATION + "' to 'true'." + - "For details, see: https://github.com/ESAPI/esapi-java-legacy/issues/354"); - } - - // Decode and gunzip if necessary - byte[] objBytes = decode( encodedObject ); - - java.io.ByteArrayInputStream bais = null; - java.io.ObjectInputStream ois = null; - Object obj = null; - - try - { - bais = new java.io.ByteArrayInputStream( objBytes ); - ois = new java.io.ObjectInputStream( bais ); - - obj = ois.readObject(); - } // end try - catch( java.io.IOException e ) - { - logger.error( Logger.SECURITY_FAILURE, "Problem reading object", e ); - obj = null; - } // end catch - catch( java.lang.ClassNotFoundException e ) - { - logger.error( Logger.SECURITY_FAILURE, "Problem reading object", e ); - obj = null; - } // end catch - finally - { - try{ bais.close(); } catch( Exception e ){} - try{ ois.close(); } catch( Exception e ){} - } // end finally - - return obj; - } // end decodeObject - - - /** * Convenience method for encoding data to a file. * @@ -1185,25 +968,24 @@ public static boolean encodeToFile( byte[] dataToEncode, String filename ) Base64.OutputStream bos = null; try { - bos = new Base64.OutputStream( + bos = new Base64.OutputStream( new java.io.FileOutputStream( filename ), Base64.ENCODE ); bos.write( dataToEncode ); success = true; } // end try catch( java.io.IOException e ) { - + success = false; } // end catch: IOException finally { try{ bos.close(); } catch( Exception e ){} } // end finally - + return success; } // end encodeToFile - - + /** * Convenience method for decoding data to a file. * @@ -1219,7 +1001,7 @@ public static boolean decodeToFile( String dataToDecode, String filename ) Base64.OutputStream bos = null; try { - bos = new Base64.OutputStream( + bos = new Base64.OutputStream( new java.io.FileOutputStream( filename ), Base64.DECODE ); bos.write( dataToDecode.getBytes( PREFERRED_ENCODING ) ); success = true; @@ -1232,13 +1014,10 @@ public static boolean decodeToFile( String dataToDecode, String filename ) { try{ bos.close(); } catch( Exception e ){} } // end finally - + return success; } // end decodeToFile - - - - + /** * Convenience method for reading a base64-encoded * file and decoding it. @@ -1259,7 +1038,7 @@ public static byte[] decodeFromFile( String filename ) byte[] buffer = null; int length = 0; int numBytes = 0; - + // Check for size of file if( file.length() > Integer.MAX_VALUE ) { @@ -1267,20 +1046,20 @@ public static byte[] decodeFromFile( String filename ) return null; } // end if: file too big for int index buffer = new byte[ (int)file.length() ]; - + // Open a stream - bis = new Base64.InputStream( - new java.io.BufferedInputStream( + bis = new Base64.InputStream( + new java.io.BufferedInputStream( new java.io.FileInputStream( file ) ), Base64.DECODE ); - + // Read until done while( ( numBytes = bis.read( buffer, length, 4096 ) ) >= 0 ) length += numBytes; - + // Save in a variable to return decodedData = new byte[ length ]; System.arraycopy( buffer, 0, decodedData, 0, length ); - + } // end try catch( java.io.IOException e ) { @@ -1290,12 +1069,10 @@ public static byte[] decodeFromFile( String filename ) { try{ if (bis != null ) bis.close(); } catch( Exception e) {} } // end finally - + return decodedData; } // end decodeFromFile - - - + /** * Convenience method for reading a binary file * and base64-encoding it. @@ -1316,19 +1093,19 @@ public static String encodeFromFile( String filename ) byte[] buffer = new byte[ Math.max((int)(file.length() * 1.4),40) ]; // Need max() for math on small files (v2.2.1) int length = 0; int numBytes = 0; - + // Open a stream - bis = new Base64.InputStream( - new java.io.BufferedInputStream( + bis = new Base64.InputStream( + new java.io.BufferedInputStream( new java.io.FileInputStream( file ) ), Base64.ENCODE ); - + // Read until done while( ( numBytes = bis.read( buffer, length, 4096 ) ) >= 0 ) length += numBytes; - + // Save in a variable to return encodedData = new String( buffer, 0, length, Base64.PREFERRED_ENCODING ); - + } // end try catch( java.io.IOException e ) { @@ -1338,13 +1115,10 @@ public static String encodeFromFile( String filename ) { try{ bis.close(); } catch( Exception e) {} } // end finally - + return encodedData; } // end encodeFromFile - - - - + /** * Reads infile and encodes it to outfile. * @@ -1359,9 +1133,9 @@ public static boolean encodeFileToFile( String infile, String outfile ) java.io.InputStream in = null; java.io.OutputStream out = null; try{ - in = new Base64.InputStream( - new java.io.BufferedInputStream( - new java.io.FileInputStream( infile ) ), + in = new Base64.InputStream( + new java.io.BufferedInputStream( + new java.io.FileInputStream( infile ) ), Base64.ENCODE ); out = new java.io.BufferedOutputStream( new java.io.FileOutputStream( outfile ) ); byte[] buffer = new byte[65536]; // 64K @@ -1376,12 +1150,10 @@ public static boolean encodeFileToFile( String infile, String outfile ) try{ in.close(); } catch( Exception exc ){} try{ out.close(); } catch( Exception exc ){} } // end finally - + return success; } // end encodeFileToFile - - - + /** * Reads infile and decodes it to outfile. * @@ -1396,9 +1168,9 @@ public static boolean decodeFileToFile( String infile, String outfile ) java.io.InputStream in = null; java.io.OutputStream out = null; try{ - in = new Base64.InputStream( - new java.io.BufferedInputStream( - new java.io.FileInputStream( infile ) ), + in = new Base64.InputStream( + new java.io.BufferedInputStream( + new java.io.FileInputStream( infile ) ), Base64.DECODE ); out = new java.io.BufferedOutputStream( new java.io.FileOutputStream( outfile ) ); byte[] buffer = new byte[65536]; // 64K @@ -1413,15 +1185,12 @@ public static boolean decodeFileToFile( String infile, String outfile ) try{ in.close(); } catch( Exception exc ){} try{ out.close(); } catch( Exception exc ){} } // end finally - + return success; } // end decodeFileToFile - - + /* ******** I N N E R C L A S S I N P U T S T R E A M ******** */ - - - + /** * A {@link Base64.InputStream} will read data from another * java.io.InputStream, given in the constructor, @@ -1439,10 +1208,9 @@ public static class InputStream extends java.io.FilterInputStream private int numSigBytes; // Number of meaningful bytes in the buffer private int lineLength; private boolean breakLines; // Break lines at less than 80 characters - private int options; // Record options used to create the stream. - private byte[] decodabet; // Local copies to avoid extra method calls - - + private int options; // Record options used to create the stream. + private byte[] decodabet; // Local copies to avoid extra method calls + /** * Constructs a {@link Base64.InputStream} in DECODE mode. * @@ -1450,11 +1218,10 @@ public static class InputStream extends java.io.FilterInputStream * @since 1.3 */ public InputStream( java.io.InputStream in ) - { + { this( in, DECODE ); } // end constructor - - + /** * Constructs a {@link Base64.InputStream} in * either ENCODE or DECODE mode. @@ -1477,7 +1244,7 @@ public InputStream( java.io.InputStream in ) * @since 2.0 */ public InputStream( java.io.InputStream in, int options ) - { + { super( in ); this.breakLines = (options & DONT_BREAK_LINES) != DONT_BREAK_LINES; this.encode = (options & ENCODE) == ENCODE; @@ -1485,10 +1252,10 @@ public InputStream( java.io.InputStream in, int options ) this.buffer = new byte[ bufferLength ]; this.position = -1; this.lineLength = 0; - this.options = options; // Record for later, mostly to determine which alphabet to use - this.decodabet = getDecodabet(options); + this.options = options; // Record for later, mostly to determine which alphabet to use + this.decodabet = getDecodabet(options); } // end constructor - + /** * Reads enough of the input stream to convert * to/from Base64 and returns the next byte. @@ -1497,8 +1264,8 @@ public InputStream( java.io.InputStream in, int options ) * @throws java.io.IOException * @since 1.3 */ - public int read() throws java.io.IOException - { + public int read() throws java.io.IOException + { // Do we need to get data? if( position < 0 ) { @@ -1509,26 +1276,26 @@ public int read() throws java.io.IOException for( int i = 0; i < 3; i++ ) { try - { + { int b = in.read(); - + // If end of stream, b is -1. if( b >= 0 ) { b3[i] = (byte)b; numBinaryBytes++; } // end if: not end of stream - + } // end try: read catch( java.io.IOException e ) - { + { // Only a problem if we got no data at all. if( i == 0 ) throw e; - + } // end catch } // end for: each needed input byte - + if( numBinaryBytes > 0 ) { encode3to4( b3, 0, numBinaryBytes, buffer, 0, options ); @@ -1540,7 +1307,7 @@ public int read() throws java.io.IOException return -1; } // end else } // end if: encoding - + // Else decoding else { @@ -1552,13 +1319,13 @@ public int read() throws java.io.IOException int b = 0; do{ b = in.read(); } while( b >= 0 && decodabet[ b & 0x7f ] <= WHITE_SPACE_ENC ); - + if( b < 0 ) break; // Reads a -1 if end of stream - + b4[i] = (byte)b; } // end for: each needed input byte - + if( i == 4 ) { numSigBytes = decode4to3( b4, 0, buffer, 0, options ); @@ -1571,18 +1338,18 @@ else if( i == 0 ){ { // Must have broken out from above. throw new java.io.IOException( "Improperly padded Base64 input." ); - } // end - + } // end + } // end else: decode } // end else: get data - + // Got data? if( position >= 0 ) { // End of relevant data? if( /*!encode &&*/ position >= numSigBytes ) return -1; - + if( encode && breakLines && lineLength >= MAX_LINE_LENGTH ) { lineLength = 0; @@ -1593,7 +1360,7 @@ else if( i == 0 ){ lineLength++; // This isn't important when decoding // but throwing an extra "if" seems // just as wasteful. - + int b = buffer[ position++ ]; if( position >= bufferLength ) @@ -1603,16 +1370,15 @@ else if( i == 0 ){ // intended to be unsigned. } // end else } // end if: position >= 0 - + // Else error else - { + { // When JDK1.4 is more accepted, use an assertion here. throw new java.io.IOException( "Error in Base64 code reading stream." ); } // end else } // end read - - + /** * Calls {@link #read()} repeatedly until the end of stream * is reached or len bytes are read. @@ -1633,10 +1399,10 @@ public int read( byte[] dest, int off, int len ) throws java.io.IOException for( i = 0; i < len; i++ ) { b = read(); - + //if( b < 0 && i == 0 ) // return -1; - + if( b >= 0 ) dest[off + i] = (byte)b; else if( i == 0 ) @@ -1646,18 +1412,12 @@ else if( i == 0 ) } // end for: each byte read return i; } // end read - + } // end inner class InputStream - - - - - - + + /* ******** I N N E R C L A S S O U T P U T S T R E A M ******** */ - - - + /** * A {@link Base64.OutputStream} will write data to another * java.io.OutputStream, given in the constructor, @@ -1676,9 +1436,9 @@ public static class OutputStream extends java.io.FilterOutputStream private boolean breakLines; private byte[] b4; // Scratch used in a few places private boolean suspendEncoding; - private int options; // Record for later - private byte[] decodabet; // Local copies to avoid extra method calls - + private int options; // Record for later + private byte[] decodabet; // Local copies to avoid extra method calls + /** * Constructs a {@link Base64.OutputStream} in ENCODE mode. * @@ -1686,11 +1446,10 @@ public static class OutputStream extends java.io.FilterOutputStream * @since 1.3 */ public OutputStream( java.io.OutputStream out ) - { + { this( out, ENCODE ); } // end constructor - - + /** * Constructs a {@link Base64.OutputStream} in * either ENCODE or DECODE mode. @@ -1712,7 +1471,7 @@ public OutputStream( java.io.OutputStream out ) * @since 1.3 */ public OutputStream( java.io.OutputStream out, int options ) - { + { super( out ); this.breakLines = (options & DONT_BREAK_LINES) != DONT_BREAK_LINES; this.encode = (options & ENCODE) == ENCODE; @@ -1722,11 +1481,10 @@ public OutputStream( java.io.OutputStream out, int options ) this.lineLength = 0; this.suspendEncoding = false; this.b4 = new byte[4]; - this.options = options; - this.decodabet = getDecodabet(options); + this.options = options; + this.decodabet = getDecodabet(options); } // end constructor - - + /** * Writes the byte to the output stream after * converting to/from Base64 notation. @@ -1748,7 +1506,7 @@ public void write(int theByte) throws java.io.IOException super.out.write( theByte ); return; } // end if: supsended - + // Encode? if( encode ) { @@ -1789,11 +1547,9 @@ else if( decodabet[ theByte & 0x7f ] != WHITE_SPACE_ENC ) } // end else: not white space either } // end else: decoding } // end write - - - + /** - * Calls {@link #write(int)} repeatedly until len + * Calls {@link #write(int)} repeatedly until len * bytes are written. * * @param theBytes array from which to read bytes @@ -1810,22 +1566,20 @@ public void write( byte[] theBytes, int off, int len ) throws java.io.IOExceptio super.out.write( theBytes, off, len ); return; } // end if: supsended - + for( int i = 0; i < len; i++ ) { write( theBytes[ off + i ] ); } // end for: each byte written - + } // end write - - - + /** * Method added by PHIL. [Thanks, PHIL. -Rob] * This pads the buffer without closing the stream. * @throws java.io.IOException */ - public void flushBase64() throws java.io.IOException + public void flushBase64() throws java.io.IOException { if( position > 0 ) { @@ -1842,9 +1596,8 @@ public void flushBase64() throws java.io.IOException } // end flush - - /** - * Flushes and closes (I think, in the superclass) the stream. + /** + * Flushes and closes (I think, in the superclass) the stream. * * @throws java.io.IOException * @since 1.3 @@ -1857,13 +1610,11 @@ public void close() throws java.io.IOException // 2. Actually close the stream // Base class both flushes and closes. super.close(); - + buffer = null; out = null; } // end close - - - + /** * Suspends encoding of the stream. * May be helpful if you need to embed a piece of @@ -1872,13 +1623,12 @@ public void close() throws java.io.IOException * @throws java.io.IOException * @since 1.5.1 */ - public void suspendEncoding() throws java.io.IOException + public void suspendEncoding() throws java.io.IOException { flushBase64(); this.suspendEncoding = true; } // end suspendEncoding - - + /** * Resumes encoding of the stream. * May be helpful if you need to embed a piece of @@ -1890,10 +1640,7 @@ public void resumeEncoding() { this.suspendEncoding = false; } // end resumeEncoding - - - + } // end inner class OutputStream - - + } // end class Base64 diff --git a/src/test/java/org/owasp/esapi/reference/EncoderTest.java b/src/test/java/org/owasp/esapi/reference/EncoderTest.java index 631dd96b2..255519752 100644 --- a/src/test/java/org/owasp/esapi/reference/EncoderTest.java +++ b/src/test/java/org/owasp/esapi/reference/EncoderTest.java @@ -661,60 +661,6 @@ public void testDecodeFromBase64() { } } - /** - * Test of Base64.decodeToObject() method. Should really be put into a - * separate Base64Test.java class, but this method has been deprecated - * so hopefully, we can kill it off soon. - */ - public void testBase64decodToObject() { - try { - System.out.println("testBase64decodeToObject"); - - ByteArrayOutputStream baos = new ByteArrayOutputStream(); - ObjectOutputStream dout = new ObjectOutputStream(baos); - - // If you don't get the joke, google John Draper. (And, BTW, you should - // be ashamed of yourself if you call yourself a hacker!) - String cerealizeThis = new String("Cap'n Crunch - every hacker's favorite cereal"); - dout.writeObject( cerealizeThis ); - byte[] serializedData = baos.toByteArray(); - dout.close(); - - String b64serialized = Base64.encodeBytes( serializedData ); - final String propName = Base64.ENABLE_UNSAFE_SERIALIZATION; - - // Make sure the property is not set. - try { System.clearProperty( propName ); } catch(Throwable t) { ; } - String capnCrunch = null; - - try { - capnCrunch = (String)Base64.decodeToObject( b64serialized ); - fail("Case 1: Did not throw UnsupportedOperationException"); - } catch(UnsupportedOperationException uoex) { - ; // Expected case - } - - try { - System.setProperty( propName, "false" ); - capnCrunch = (String)Base64.decodeToObject( b64serialized ); - fail("Case 2: Did not throw UnsupportedOperationException"); - } catch(UnsupportedOperationException uoex) { - ; // Expected case - } - - try { - // This case should work. - System.setProperty( propName, "true" ); - capnCrunch = (String)Base64.decodeToObject( b64serialized ); - assertTrue( capnCrunch.equals( cerealizeThis ) ); - } catch(Throwable t) { - fail("Case 3: Caught unexpected exception: " + t); - } - } catch(Throwable t) { - fail("Caught unexpected exception: " + t); - } - } - /** * Test of WindowsCodec */ From 32dd026374de4db9527ff0b50778c74078a7cd87 Mon Sep 17 00:00:00 2001 From: "Kevin W. Wall" Date: Mon, 8 Oct 2018 20:37:36 -0400 Subject: [PATCH 516/812] Update README.md Add short paragraph of how this GitHub issues is not appropriate forum for asking questions about ESAPI. --- README.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/README.md b/README.md index c36670d59..09f0df50d 100644 --- a/README.md +++ b/README.md @@ -42,6 +42,8 @@ When reporting an issue, please be clear and try to ensure that the ESAPI develo ### Find an Issue? If you have found a bug, then create an issue on the esapi-legacy-java repo: https://github.com/ESAPI/esapi-java-legacy/issues +NOTE: Please do NOT use GitHub issues to ask questions about ESAPI. If you wish to do this, post to either of the 2 mailing lists found at the bottom of this page. If we find questions as GitHub issues, we simply will close them and direct you to do this anyhow. + ### Find a Vulnerability? If you have found a vulnerability in ESAPI legacy, first search the issues list (see above) to see if it has already been reported. If it has not, then please contact both Kevin W. Wall (kevin.w.wall at gmail.com) and Matt Seil (matt.seil at owasp.org) directly. Please do not report vulnerabilities via GitHub issues or via the ESAPI mailing lists as we wish to keep our users secure while a patch is implemented and deployed. If you wish to be acknowledged for finding the vulnerability, then please follow this process. (Eventually, we would like to have BugCrowd handle this, but that's still a ways off.) Also, when you post the email describing the vulnerability, please do so from an email address that you usually monitor. From bbf431afab90b5b7f0012b13bcbc4f96cbeeb927 Mon Sep 17 00:00:00 2001 From: "Kevin W. Wall" Date: Mon, 8 Oct 2018 23:59:52 -0400 Subject: [PATCH 517/812] Log special (#451) * Close issue #448 * Close issue #444. Delete deprecated decodeToObject() method and 2 related encodeObject() methods. General whitespace clean-up. Delete EncoderTest.testBase64decodToObject() method which is no longer relevant. * Close issue #385. Close issue #386. NOTE: Was unwilling to comply with request in these 2 issues to make logSpecial() 'protected'. Could not do so without introducing potential security vulnerabilities. However, since the intent of the user submitting these 2 GitHub issues was only to override logSpecial() in order to completely suppress the output from them to stdout or stderr, I have arranged it so that setting the System property 'org.owasp.esapi.logSpecial.discard' to 'true' will do exactly this...it will suppress all output from logSpecial. (Also, the calls to System.err.println() and System.out.println() have been replaced by calls to logSpecial(), which will log to System.out if not suppressed. So the end result is all or nothing. I suspect that most will keep the default behavior, which is to print to System.out rather than suppressing all output. --- .../AbstractPrioritizedPropertyLoader.java | 33 +++++++++- .../StandardEsapiPropertyLoader.java | 4 +- .../DefaultSecurityConfiguration.java | 62 ++++++++++++++++--- 3 files changed, 85 insertions(+), 14 deletions(-) diff --git a/src/main/java/org/owasp/esapi/configuration/AbstractPrioritizedPropertyLoader.java b/src/main/java/org/owasp/esapi/configuration/AbstractPrioritizedPropertyLoader.java index 75e6497c7..61c5c7d26 100644 --- a/src/main/java/org/owasp/esapi/configuration/AbstractPrioritizedPropertyLoader.java +++ b/src/main/java/org/owasp/esapi/configuration/AbstractPrioritizedPropertyLoader.java @@ -44,13 +44,13 @@ public String name() { /** * Initializes properties object and fills it with data from configuration file. */ - protected void initProperties() { + private void initProperties() { properties = new Properties(); File file = new File(filename); if (file.exists() && file.isFile()) { loadPropertiesFromFile(file); } else { - System.err.println("Configuration file " + filename + " does not exist"); + logSpecial("Configuration file " + filename + " does not exist"); } } @@ -59,4 +59,33 @@ protected void initProperties() { * @param file */ protected abstract void loadPropertiesFromFile(File file); + + /** + * Used to log errors to the console during the loading of the properties file itself. Can't use + * standard logging in this case, since the Logger may not be initialized yet. Output is sent to + * {@code PrintStream} {@code System.out}. Output is discarded if the {@code System} property + * "org.owasp.esapi.logSpecial.discard" is set to {@code true}. + * + * @param msg The message to log to the console. + * @param t Associated exception that was caught. + */ + protected final void logSpecial(String msg, Throwable t) { + // Note: It is really distasteful to tie this class to DefaultSecurityConfiguration + // like this, but the alternative is to move the logSpecial() and + // logToStdout() some utilities class and that is even more + // distasteful because it may encourage people to use these. -kwwall + org.owasp.esapi.reference.DefaultSecurityConfiguration.logToStdout(msg, t); + } + + /** + * Used to log errors to the console during the loading of the properties file itself. Can't use + * standard logging in this case, since the Logger may not be initialized yet. Output is sent to + * {@code PrintStream} {@code System.out}. Output is discarded if the {@code System} property + * "org.owasp.esapi.logSpecial.discard" is set to {@code true}. + * + * @param msg The message to log to the console. + */ + protected final void logSpecial(String msg) { + logSpecial(msg, null); + } } diff --git a/src/main/java/org/owasp/esapi/configuration/StandardEsapiPropertyLoader.java b/src/main/java/org/owasp/esapi/configuration/StandardEsapiPropertyLoader.java index 6a896a2cd..850b16905 100644 --- a/src/main/java/org/owasp/esapi/configuration/StandardEsapiPropertyLoader.java +++ b/src/main/java/org/owasp/esapi/configuration/StandardEsapiPropertyLoader.java @@ -90,13 +90,13 @@ protected void loadPropertiesFromFile(File file) { input = new FileInputStream(file); properties.load(input); } catch (IOException ex) { - System.err.println("Loading " + file.getName() + " via file I/O failed. Exception was: " + ex); + logSpecial("Loading " + file.getName() + " via file I/O failed.", ex); } finally { if (input != null) { try { input.close(); } catch (IOException e) { - System.err.println("Could not close stream"); + logSpecial("Could not close stream"); } } } diff --git a/src/main/java/org/owasp/esapi/reference/DefaultSecurityConfiguration.java b/src/main/java/org/owasp/esapi/reference/DefaultSecurityConfiguration.java index 403fd4922..504372037 100644 --- a/src/main/java/org/owasp/esapi/reference/DefaultSecurityConfiguration.java +++ b/src/main/java/org/owasp/esapi/reference/DefaultSecurityConfiguration.java @@ -153,6 +153,18 @@ public static SecurityConfiguration getInstance() { public static final String VALIDATION_PROPERTIES_MULTIVALUED = "Validator.ConfigurationFile.MultiValued"; public static final String ACCEPT_LENIENT_DATES = "Validator.AcceptLenientDates"; + /** + * Special {@code System} property that, if set to {@code true}, will + * disable logging from {@code DefaultSecurityConfiguration.logToStdout()} + * methods, which is called from various {@code logSpecial()} methods. + * @see org.owasp.esapi.reference.DefaultSecurityConfiguration#logToStdout(String msg, Throwable t) + * @see org.owasp.esapi.reference.DefaultSecurityConfiguration#logToStdout(String msg) + */ + public static final String DISCARD_LOGSPECIAL = "org.owasp.esapi.logSpecial.discard"; + + // We assume that this does not change in the middle of processing the + // ESAPI.properties files and thus only fetch its value once. + private static final String logSpecialValue = System.getProperty(DISCARD_LOGSPECIAL, "false"); /** @@ -702,34 +714,64 @@ private Properties loadConfigurationFromClasspath(String fileName) throws Illega return result; } + /** + * Log to standard output (i.e., {@code System.out}. This method is + * synchronized to reduce the possibility of interleaving the message + * output (since the {@code System.out} {@code PrintStream} is buffered) + * it invoked from multiple threads. Output is discarded if the + * {@code System} property "org.owasp.esapi.logSpecial.discard" is set to + * {@code true}. + * + * @param msg Message to be logged. + * @param t Associated exception that was caught. The class name and + * exception message is also logged. + * @see #logToStdout(String msg) + */ + public final synchronized static void logToStdout(String msg, Throwable t) { + // Note that this class was made final because it is called from this class' + // CTOR and we want to prohibit someone from easily doing sneaky + // things like subclassing this class and inserting a malicious code as a + // shim. Of course, really in hindsight, this entire class should have been + // declared 'final', but doing so at this point would likely break someone's + // code, including possibly some of our own test code. But since this is a + // new method, we can get away with it here. + boolean discard = logSpecialValue.trim().equalsIgnoreCase("true"); + if ( discard ) { + return; // Output is discarded! + } + if ( t == null ) { + System.out.println("ESAPI: " + msg); + } else { + System.out.println("ESAPI: " + msg + + ". Caught " + t.getClass().getName() + + "; exception message was: " + t); + } + } + /** * Used to log errors to the console during the loading of the properties file itself. Can't use * standard logging in this case, since the Logger may not be initialized yet. Output is sent to - * {@code PrintStream} {@code System.out}. + * {@code PrintStream} {@code System.out}. Output is discarded if the {@code System} property + * "org.owasp.esapi.logSpecial.discard" is set to {@code true}. * * @param message The message to send to the console. * @param e The error that occurred. (This value printed via {@code e.toString()}.) */ private void logSpecial(String message, Throwable e) { - StringBuffer msg = new StringBuffer(message); - if (e != null) { - msg.append(" Exception was: ").append( e.toString() ); - } - System.out.println( msg.toString() ); - // if ( e != null) e.printStackTrace(); // TODO ??? Do we want this? + logToStdout(message, e); } /** * Used to log errors to the console during the loading of the properties file itself. Can't use * standard logging in this case, since the Logger may not be initialized yet. Output is sent to - * {@code PrintStream} {@code System.out}. + * {@code PrintStream} {@code System.out}. Output is discarded if the {@code System} property + * "org.owasp.esapi.logSpecial.discard" is set to {@code true}. * * @param message The message to send to the console. */ private void logSpecial(String message) { - System.out.println(message); + logToStdout(message, null); } - /** * {@inheritDoc} */ From 74a38b0096f68a2dcd17427f054d5fe31c5a1335 Mon Sep 17 00:00:00 2001 From: Jacky Date: Sat, 3 Nov 2018 10:16:58 +0800 Subject: [PATCH 518/812] #304 encodeForCSS breaks color values (#453) --- .../java/org/owasp/esapi/reference/DefaultEncoder.java | 2 +- src/test/java/org/owasp/esapi/reference/EncoderTest.java | 8 ++++++-- 2 files changed, 7 insertions(+), 3 deletions(-) diff --git a/src/main/java/org/owasp/esapi/reference/DefaultEncoder.java b/src/main/java/org/owasp/esapi/reference/DefaultEncoder.java index 8100632a7..9a0eefa1a 100644 --- a/src/main/java/org/owasp/esapi/reference/DefaultEncoder.java +++ b/src/main/java/org/owasp/esapi/reference/DefaultEncoder.java @@ -88,7 +88,7 @@ public static Encoder getInstance() { */ private final static char[] IMMUNE_HTML = { ',', '.', '-', '_', ' ' }; private final static char[] IMMUNE_HTMLATTR = { ',', '.', '-', '_' }; - private final static char[] IMMUNE_CSS = {}; + private final static char[] IMMUNE_CSS = { '#' }; private final static char[] IMMUNE_JAVASCRIPT = { ',', '.', '_' }; private final static char[] IMMUNE_VBSCRIPT = { ',', '.', '_' }; private final static char[] IMMUNE_XML = { ',', '.', '-', '_', ' ' }; diff --git a/src/test/java/org/owasp/esapi/reference/EncoderTest.java b/src/test/java/org/owasp/esapi/reference/EncoderTest.java index 255519752..cdef5e06a 100644 --- a/src/test/java/org/owasp/esapi/reference/EncoderTest.java +++ b/src/test/java/org/owasp/esapi/reference/EncoderTest.java @@ -382,10 +382,14 @@ public void testEncodeForCSS() { assertEquals(null, instance.encodeForCSS(null)); assertEquals("\\3c script\\3e ", instance.encodeForCSS(""); verify(servResp, times(0)).setHeader("foo", ""); } - + @Test public void testInvalidDateHeader(){ HttpServletResponse servResp = mock(HttpServletResponse.class); @@ -91,7 +662,7 @@ public void testInvalidDateHeader(){ resp.addDateHeader("Foo\\r\\n", currentTime); verify(servResp, times(0)).addDateHeader("Foo", currentTime); } - + @Test public void testAddHeaderInvalidValueLength(){ //refactor this to use a spy. @@ -102,7 +673,7 @@ public void testAddHeaderInvalidValueLength(){ resp.addHeader("Foo", TestUtils.generateStringOfLength(4097)); verify(servResp, times(0)).addHeader("Foo", "bar"); } - + @Test public void testAddHeaderInvalidKeyLength(){ HttpServletResponse servResp = mock(HttpServletResponse.class); @@ -110,7 +681,7 @@ public void testAddHeaderInvalidKeyLength(){ resp.addHeader(TestUtils.generateStringOfLength(257), "bar"); verify(servResp, times(0)).addHeader("Foo", "bar"); } - + @Test public void testAddIntHeader(){ HttpServletResponse servResp = mock(HttpServletResponse.class); @@ -118,7 +689,7 @@ public void testAddIntHeader(){ resp.addIntHeader("aaaa", 4); verify(servResp, times(1)).addIntHeader("aaaa", 4); } - + @Test public void testAddInvalidIntHeader(){ HttpServletResponse servResp = mock(HttpServletResponse.class); @@ -126,7 +697,7 @@ public void testAddInvalidIntHeader(){ resp.addIntHeader(TestUtils.generateStringOfLength(257), Integer.MIN_VALUE); verify(servResp, times(0)).addIntHeader(TestUtils.generateStringOfLength(257), Integer.MIN_VALUE); } - + @Test public void testContainsHeader(){ HttpServletResponse servResp = new MockHttpServletResponse(); @@ -137,7 +708,7 @@ public void testContainsHeader(){ verify(servResp, times(1)).addIntHeader("aaaa", Integer.MIN_VALUE); assertEquals(true, servResp.containsHeader("aaaa")); } - + @Test public void testAddValidCookie(){ HttpServletResponse servResp = new MockHttpServletResponse(); @@ -148,7 +719,7 @@ public void testAddValidCookie(){ cookie.setMaxAge(5000); Mockito.doCallRealMethod().when(spyResp).addCookie(cookie); spyResp.addCookie(cookie); - + /* * We're indirectly testing our class. Since it ultimately * delegates to HttpServletResponse.addHeader, we're actually @@ -158,7 +729,7 @@ public void testAddValidCookie(){ */ verify(servResp, times(1)).addHeader("Set-Cookie", "Foo=aaaaaaaaaa; Max-Age=5000; Secure; HttpOnly"); } - + @Test public void testAddValidCookieWithDomain(){ HttpServletResponse servResp = new MockHttpServletResponse(); @@ -172,7 +743,7 @@ public void testAddValidCookieWithDomain(){ spyResp.addCookie(cookie); verify(servResp, times(1)).addHeader("Set-Cookie", "Foo=aaaaaaaaaa; Domain=evil.com; Secure; HttpOnly"); } - + @Test public void testAddValidCookieWithPath(){ HttpServletResponse servResp = new MockHttpServletResponse(); @@ -186,7 +757,7 @@ public void testAddValidCookieWithPath(){ spyResp.addCookie(cookie); verify(servResp, times(1)).addHeader("Set-Cookie", "Foo=aaaaaaaaaa; Domain=evil.com; Path=/foo/bar; Secure; HttpOnly"); } - + @Test public void testAddInValidCookie(){ HttpServletResponse servResp = new MockHttpServletResponse(); @@ -195,11 +766,11 @@ public void testAddInValidCookie(){ SecurityWrapperResponse spyResp = spy(resp); Cookie cookie = new Cookie("Foo", TestUtils.generateStringOfLength(5000)); Mockito.doCallRealMethod().when(spyResp).addCookie(cookie); - + spyResp.addCookie(cookie); verify(servResp, times(0)).addHeader("Set-Cookie", "Foo=" + TestUtils.generateStringOfLength(5000) + "; Secure; HttpOnly"); } - + @Test public void testSendError() throws Exception{ HttpServletResponse servResp = new MockHttpServletResponse(); @@ -208,10 +779,10 @@ public void testSendError() throws Exception{ SecurityWrapperResponse spyResp = spy(resp); Mockito.doCallRealMethod().when(spyResp).sendError(200); spyResp.sendError(200); - + verify(servResp, times(1)).sendError(200, "HTTP error code: 200");; } - + @Test public void testSendStatus() throws Exception{ HttpServletResponse servResp = new MockHttpServletResponse(); @@ -220,10 +791,10 @@ public void testSendStatus() throws Exception{ SecurityWrapperResponse spyResp = spy(resp); Mockito.doCallRealMethod().when(spyResp).setStatus(200);; spyResp.setStatus(200); - + verify(servResp, times(1)).setStatus(200);; } - + @Test public void testSendStatusWithString() throws Exception{ HttpServletResponse servResp = new MockHttpServletResponse(); @@ -232,7 +803,7 @@ public void testSendStatusWithString() throws Exception{ SecurityWrapperResponse spyResp = spy(resp); Mockito.doCallRealMethod().when(spyResp).setStatus(200, "foo");; spyResp.setStatus(200, "foo"); - + verify(servResp, times(1)).sendError(200, "foo");; } } From 422ba9f27ad1956682a7b0903c9f8119e6cd598d Mon Sep 17 00:00:00 2001 From: "Kevin W. Wall" Date: Sat, 8 Feb 2020 22:34:19 -0500 Subject: [PATCH 653/812] Issue 521 (#535) * Add formal deprecation policy. * Add property Validator.ValidationRule.getValid.ignore509Fix. Truly a kludge if there every was one. * Add static field VALIDATOR_IGNORE509 for kludge. * Address issue #521 by splitting out failing JUnit test cases, testGetValidSafeHTML() and testIsValidSafeHTML() into separate test files. New files will be src/test/java/org/owasp/esapi/reference/validation/HTMLValidationRuleLogsTest.java and src/test/java/org/owasp/esapi/reference/validation/HTMLValidationRuleThrowsTest.java * Address issue #521 by kludge to add backward-compatibility flag to restore the old behavior accidentally broken by the changes to address issue #509. * Javadoc clarifications to address issue #521 for behavior broken by issue #509 commits. * New test files for GitHub issue #521; initial commit. * Add additional sentence about ESAPI deprecation policy. * Since we've deprecated Log4J 1 logger, let's go all in and remove it from the default ESAPI.Logger in ESAPI.properties as well. * Changed new property name from the horribly named Validator.ValidationRule.getValid.ignore509Fix to the more appropriately named Validator.HtmlValidationAction whose possible values are "clean" (for legacy behavior) and "throw" for the new behavior as fixed by GitHub issue #509. If the property is not encountered, it is treated as if "clean" had been specified, i.e., the legacy behavior. * Added string constant for new property, Validator.HtmlValidationAction. * Changes in keeping with new prop name, Validator.HtmlValidationAction * Rename JUnit test file. * Rename JUnit test class to sync w/ new file name. * Convert from JUnit 3 to JUnit 4. --- README.md | 4 + configuration/esapi/ESAPI.properties | 40 ++++- .../java/org/owasp/esapi/ValidationRule.java | 20 ++- .../DefaultSecurityConfiguration.java | 3 +- .../validation/HTMLValidationRule.java | 60 ++++++- .../owasp/esapi/reference/ValidatorTest.java | 63 +------ .../HTMLValidationRuleCleanTest.java | 158 +++++++++++++++++ .../HTMLValidationRuleThrowsTest.java | 167 ++++++++++++++++++ src/test/resources/esapi/ESAPI.properties | 41 ++++- 9 files changed, 484 insertions(+), 72 deletions(-) create mode 100644 src/test/java/org/owasp/esapi/reference/validation/HTMLValidationRuleCleanTest.java create mode 100644 src/test/java/org/owasp/esapi/reference/validation/HTMLValidationRuleThrowsTest.java diff --git a/README.md b/README.md index e6701c280..f7c38d99d 100644 --- a/README.md +++ b/README.md @@ -23,6 +23,10 @@ The default branch for ESAPI legacy is now the 'develop' branch (rather than the # Where can I find ESAPI 3.x? https://github.com/ESAPI/esapi-java +# ESAPI Deprecation Policy +Unless we unintentionally screw-up, our intent is to keep classes, methods, and/or fields whihc have been annotated as "@deprecated" for a minimum of two (2) years or until the next major release number (e.g., 3.x as of now), which ever comes first, before we remove them. +Note that this policy does not apply to classes under the **org.owasp.esapi.reference** package. You are not expected to be using such classes directly in your code. + # Contributing to ESAPI legacy ## How can I contribute or help with fix bugs? Fork and submit a pull request! Simple as pi! We generally only accept bug fixes, not new features because as a legacy project, we don't intend on adding new features, although we may make exceptions. If you wish to propose a new feature, the best place to discuss it is via the ESAPI-DEV mailing list mentioned below. Note that we vet all pull requests, including coding style of any contributions; use the same coding style found in the files you are already editing. diff --git a/configuration/esapi/ESAPI.properties b/configuration/esapi/ESAPI.properties index 20421a0bd..7ac0fb9d3 100644 --- a/configuration/esapi/ESAPI.properties +++ b/configuration/esapi/ESAPI.properties @@ -67,8 +67,9 @@ ESAPI.Executor=org.owasp.esapi.reference.DefaultExecutor ESAPI.HTTPUtilities=org.owasp.esapi.reference.DefaultHTTPUtilities ESAPI.IntrusionDetector=org.owasp.esapi.reference.DefaultIntrusionDetector # Log4JFactory Requires log4j.xml or log4j.properties in classpath - http://www.laliluna.de/log4j-tutorial.html -ESAPI.Logger=org.owasp.esapi.logging.log4j.Log4JLogFactory -#ESAPI.Logger=org.owasp.esapi.reference.JavaLogFactory +# Note that this is now considered deprecated! +#ESAPI.Logger=org.owasp.esapi.logging.log4j.Log4JLogFactory +ESAPI.Logger=org.owasp.esapi.logging.java.JavaLogFactory # To use the new SLF4J logger in ESAPI (see GitHub issue #129), set # ESAPI.Logger=org.owasp.esapi.logging.slf4j.Slf4JLogFactory # and do whatever other normal SLF4J configuration that you normally would do for your application. @@ -499,3 +500,38 @@ Validator.DirectoryName=^[a-zA-Z0-9:/\\\\!@#$%^&{}\\[\\]()_+\\-=,.~'` ]{1,255}$ # Validation of dates. Controls whether or not 'lenient' dates are accepted. # See DataFormat.setLenient(boolean flag) for further details. Validator.AcceptLenientDates=false + +# ~~~~~ Important Note ~~~~~ +# This is a workaround to make sure that a commit to address GitHub issue #509 +# doesn't accidentally break someone's production code. So essentially what we +# are doing is to reverting back to the previous possibly buggy (by +# documentation intent at least), but, by now, expected legacy behavior. +# Prior to the code changes for issue #509, if invalid / malicious HTML input was +# observed, AntiSamy would simply attempt to sanitize (cleanse) it and it would +# only be logged. However, the code change made ESAPI comply with its +# documentation, which stated that a ValidationException should be thrown in +# such cases. Unfortunately, changing this behavior--especially when no one is +# 100% certain that the documentation was correct--could break existing code +# using ESAPI so after a lot of debate, issue #521 was created to restore the +# previous behavior, but still allow the documented behavior. (We did this +# because it wasn't really causing an security issues since AntiSamy would clean +# it up anyway and we value backward compatibility as long as it doesn't clearly +# present security vulnerabilities.) +# More defaults about this are written up under GitHub issue #521 and +# the pull request it references. Future major releases of ESAPI (e.g., ESAPI 3.x) +# will not support this previous behavior, but it will remain for ESAPI 2.x. +# Set this to 'throw' if you want the originally intended behavior of throwing +# that was fixed via issue #509. Set to 'clean' if you want want the HTML input +# sanitized instead. +# +# Possible values: +# clean -- Use the legacy behavior where unsafe HTML input is logged and the +# sanitized (i.e., clean) input as determined by AntiSamy and your +# AntiSamy rules is returned. This is the default behavior if this +# new property is not found. +# throw -- The new, presumably correct and originally intended behavior where +# a ValidationException is thrown when unsafe HTML input is +# encountered. +# +#Validator.HtmlValidationAction=clean +Validator.HtmlValidationAction=throw diff --git a/src/main/java/org/owasp/esapi/ValidationRule.java b/src/main/java/org/owasp/esapi/ValidationRule.java index 25cc95ac1..8f186a54b 100644 --- a/src/main/java/org/owasp/esapi/ValidationRule.java +++ b/src/main/java/org/owasp/esapi/ValidationRule.java @@ -15,14 +15,23 @@ public interface ValidationRule { * the value to be parsed * @return a validated value * @throws ValidationException - * if any validation rules fail + * if any validation rules fail, except if the + * {@code ESAPI.properties}> property + * "Validator.ValidationRule.getValid.ignore509Fix" is set to + * {@code true}, which is the default behavior for ESAPI 2.x + * releases. See + * {@link https://github.com/ESAPI/esapi-java-legacy/issues/509} + * and {@link https://github.com/ESAPI/esapi-java-legacy/issues/521} + * for futher details. + * + * @see #getValid(String context, String input, ValidationErrorList errorList) */ Object getValid(String context, String input) throws ValidationException; /** - * Whether or not a valid valid can be null. getValid will throw an - * Exception and getSafe will return the default value if flag is set to + * Whether or not a valid valid can be null. {@code getValid} will throw an + * Exception and {#code getSafe} will return the default value if flag is set to * true * * @param flag @@ -59,7 +68,8 @@ Object getValid(String context, String input, ValidationErrorList errorList) throws ValidationException; /** - * Try to call get valid, then call sanitize, finally return a default value + * Try to call {@code getvalid}, then call a 'sanitize' method for sanitization (if one exists), + * finally return a default value. */ Object getSafe(String context, String input); @@ -78,4 +88,4 @@ Object getValid(String context, String input, */ String whitelist(String input, Set list); -} \ No newline at end of file +} diff --git a/src/main/java/org/owasp/esapi/reference/DefaultSecurityConfiguration.java b/src/main/java/org/owasp/esapi/reference/DefaultSecurityConfiguration.java index a91e0e9b7..a9fd89cc9 100644 --- a/src/main/java/org/owasp/esapi/reference/DefaultSecurityConfiguration.java +++ b/src/main/java/org/owasp/esapi/reference/DefaultSecurityConfiguration.java @@ -114,7 +114,7 @@ public static SecurityConfiguration getInstance() { public static final String DIGITAL_SIGNATURE_ALGORITHM = "Encryptor.DigitalSignatureAlgorithm"; public static final String DIGITAL_SIGNATURE_KEY_LENGTH = "Encryptor.DigitalSignatureKeyLength"; // ==================================// - // New in ESAPI Java 2.0 // + // New in ESAPI Java 2.x // // ================================= // public static final String PREFERRED_JCE_PROVIDER = "Encryptor.PreferredJCEProvider"; public static final String CIPHER_TRANSFORMATION_IMPLEMENTATION = "Encryptor.CipherTransformation"; @@ -157,6 +157,7 @@ public static SecurityConfiguration getInstance() { public static final String VALIDATION_PROPERTIES = "Validator.ConfigurationFile"; public static final String VALIDATION_PROPERTIES_MULTIVALUED = "Validator.ConfigurationFile.MultiValued"; public static final String ACCEPT_LENIENT_DATES = "Validator.AcceptLenientDates"; + public static final String VALIDATOR_HTML_VALIDATION_ACTION = "Validator.HtmlValidationAction"; /** * Special {@code System} property that, if set to {@code true}, will diff --git a/src/main/java/org/owasp/esapi/reference/validation/HTMLValidationRule.java b/src/main/java/org/owasp/esapi/reference/validation/HTMLValidationRule.java index f0196fc04..0670860d9 100644 --- a/src/main/java/org/owasp/esapi/reference/validation/HTMLValidationRule.java +++ b/src/main/java/org/owasp/esapi/reference/validation/HTMLValidationRule.java @@ -97,8 +97,60 @@ public String sanitize( String context, String input ) { return safe; } + /** + * Check whether we want the legacy behavior ("clean") or the presumably intended + * behavior of "throw" for how to treat unsafe HTML input when AntiSamy is invoked. + * This admittedly is an UGLY hack to ensure that issue 509 and its corresponding + * fix in PR #510 does not break existing developer's existing code. Full + * details are described in GitHub issue 521. + * + * Checks new ESAPI property "Validator.HtmlValidationAction". A value of "clean" + * means to revert to legacy behavior. A value of "throw" means to use the new + * behavior as implemented in GitHub issue 509. + * + * @return false - If "Validator.HtmlValidationAction" is set to "throw". Otherwise {@code true}. + * @since 2.2.1.0 + */ + private boolean legacyHtmlValidation() { + boolean legacy = true; // Make legacy support the default behavior for backward compatibility. + String propValue = "clean"; // For legacy support. + try { + // DISCUSS: + // Hindsight: maybe we should have getBooleanProp(), getStringProp(), + // getIntProp() methods that take a default arg as well? + // At least for ESAPI 3.x. + propValue = ESAPI.securityConfiguration().getStringProp( + // Future: This will be moved to a new PropNames class + org.owasp.esapi.reference.DefaultSecurityConfiguration.VALIDATOR_HTML_VALIDATION_ACTION ); + switch ( propValue.toLowerCase() ) { + case "throw": + legacy = false; // New, presumably correct behavior, as addressed by GitHub issue 509 + break; + case "clean": + legacy = true; // Give the caller that legacy behavior of sanitizing. + break; + default: + LOGGER.warning(Logger.EVENT_FAILURE, "ESAPI property " + + org.owasp.esapi.reference.DefaultSecurityConfiguration.VALIDATOR_HTML_VALIDATION_ACTION + + " was set to \"" + propValue + "\". Must be set to either \"clean\"" + + " (the default for legacy support) or \"throw\"; assuming \"clean\" for legacy behavior."); + legacy = true; + break; + } + } catch( ConfigurationException cex ) { + // OPEN ISSUE: Should we log this? I think so. Convince me otherwise. But maybe + // we should only log it once or every Nth time?? + LOGGER.warning(Logger.EVENT_FAILURE, "ESAPI property " + + org.owasp.esapi.reference.DefaultSecurityConfiguration.VALIDATOR_HTML_VALIDATION_ACTION + + " must be set to either \"clean\" (the default for legacy support) or \"throw\"; assuming \"clean\"", + cex); + } + + return legacy; + } + private String invokeAntiSamy( String context, String input ) throws ValidationException { - // CHECKME should this allow empty Strings? " " us IsBlank instead? + // CHECKME should this allow empty Strings? " " use IsBlank instead? if ( StringUtilities.isEmpty(input) ) { if (allowNull) { return null; @@ -114,7 +166,11 @@ private String invokeAntiSamy( String context, String input ) throws ValidationE List errors = test.getErrorMessages(); if ( !errors.isEmpty() ) { - throw new ValidationException( context + ": Invalid HTML input", "Invalid HTML input does not follow rules in antisamy-esapi.xml: context=" + context + " errors=" + errors.toString()); + if ( legacyHtmlValidation() ) { // See GitHub issues 509 and 521 + LOGGER.info(Logger.SECURITY_FAILURE, "Cleaned up invalid HTML input: " + errors ); + } else { + throw new ValidationException( context + ": Invalid HTML input", "Invalid HTML input does not follow rules in antisamy-esapi.xml: context=" + context + " errors=" + errors.toString()); + } } return test.getCleanHTML().trim(); diff --git a/src/test/java/org/owasp/esapi/reference/ValidatorTest.java b/src/test/java/org/owasp/esapi/reference/ValidatorTest.java index ad48ef53b..b0fd24789 100644 --- a/src/test/java/org/owasp/esapi/reference/ValidatorTest.java +++ b/src/test/java/org/owasp/esapi/reference/ValidatorTest.java @@ -238,39 +238,8 @@ public void testGetValidRedirectLocation() { // instance.getValidRedirectLocation(String, String, boolean, ValidationErrorList) } - public void testGetValidSafeHTML() throws Exception { - System.out.println("getValidSafeHTML"); - Validator instance = ESAPI.validator(); - ValidationErrorList errors = new ValidationErrorList(); - - // new school test case setup - HTMLValidationRule rule = new HTMLValidationRule("test"); - ESAPI.validator().addRule(rule); - - assertEquals("Test.", ESAPI.validator().getRule("test").getValid("test", "Test. ")); - - String test1 = "Jeff"; - String result1 = instance.getValidSafeHTML("test", test1, 100, false, errors); - assertEquals(test1, result1); - - String test2 = "Aspect Security"; - String result2 = instance.getValidSafeHTML("test", test2, 100, false, errors); - assertEquals(test2, result2); - - String test3 = "Test. "; - assertEquals("Test.", rule.getSafe("test", test3)); - - assertEquals("Test. <
    load=alert()
    ", rule.getSafe("test", "Test. <
    load=alert()")); - assertEquals("Test.
    b
    ", rule.getSafe("test", "Test.
    b
    ")); - assertEquals("Test. alert(document.cookie)", rule.getSafe("test", "Test. alert(document.cookie)")); - assertEquals("Test. alert(document.cookie)", rule.getSafe("test", "Test. alert(document.cookie)")); - assertEquals("Test. alert(document.cookie)", rule.getSafe("test", "Test. alert(document.cookie)")); - // TODO: ENHANCE waiting for a way to validate text headed for an attribute for scripts - // This would be nice to catch, but just looks like text to AntiSamy - // assertFalse(instance.isValidSafeHTML("test", "\" onload=\"alert(document.cookie)\" ")); - // String result4 = instance.getValidSafeHTML("test", test4); - // assertEquals("", result4); - } + // Test split out and moved to HTMLValidationRuleLogsTest.java & HTMLValidationRuleThrowsTest.java + // public void testGetValidSafeHTML() throws Exception { public void testIsInvalidFilename() { System.out.println("testIsInvalidFilename"); @@ -881,32 +850,8 @@ public void testIsValidRedirectLocation() { // isValidRedirectLocation(String, String, boolean) } - public void testIsValidSafeHTML() { - System.out.println("isValidSafeHTML"); - Validator instance = ESAPI.validator(); - - assertTrue(instance.isValidSafeHTML("test", "Jeff", 100, false)); - assertTrue(instance.isValidSafeHTML("test", "Aspect Security", 100, false)); - assertTrue(instance.isValidSafeHTML("test", "Test. ", 100, false)); - assertTrue(instance.isValidSafeHTML("test", "Test.
    ", 100, false)); - assertTrue(instance.isValidSafeHTML("test", "Test. alert(document.cookie)", 100, false)); - assertTrue(instance.isValidSafeHTML("test", "Test. alert(document.cookie)", 100, false)); - assertTrue(instance.isValidSafeHTML("test", "Test. alert(document.cookie)", 100, false)); - - // TODO: waiting for a way to validate text headed for an attribute for scripts - // This would be nice to catch, but just looks like text to AntiSamy - // assertFalse(instance.isValidSafeHTML("test", "\" onload=\"alert(document.cookie)\" ")); - ValidationErrorList errors = new ValidationErrorList(); - assertTrue(instance.isValidSafeHTML("test1", "Jeff", 100, false, errors)); - assertTrue(instance.isValidSafeHTML("test2", "Aspect Security", 100, false, errors)); - assertTrue(instance.isValidSafeHTML("test3", "Test. ", 100, false, errors)); - assertTrue(instance.isValidSafeHTML("test4", "Test.
    ", 100, false, errors)); - assertTrue(instance.isValidSafeHTML("test5", "Test. alert(document.cookie)", 100, false, errors)); - assertTrue(instance.isValidSafeHTML("test6", "Test. alert(document.cookie)", 100, false, errors)); - assertTrue(instance.isValidSafeHTML("test7", "Test. alert(document.cookie)", 100, false, errors)); - assertTrue(errors.size() == 0); - - } + // Test split out and moved to HTMLValidationRuleLogsTest.java & HTMLValidationRuleThrowsTest.java + // public void testIsValidSafeHTML() { public void testSafeReadLine() { System.out.println("safeReadLine"); diff --git a/src/test/java/org/owasp/esapi/reference/validation/HTMLValidationRuleCleanTest.java b/src/test/java/org/owasp/esapi/reference/validation/HTMLValidationRuleCleanTest.java new file mode 100644 index 000000000..dfed45607 --- /dev/null +++ b/src/test/java/org/owasp/esapi/reference/validation/HTMLValidationRuleCleanTest.java @@ -0,0 +1,158 @@ +/** + * OWASP Enterprise Security API (ESAPI) + * + * This file is part of the Open Web Application Security Project (OWASP) + * Enterprise Security API (ESAPI) project. For details, please see + * http://www.owasp.org/index.php/ESAPI. + * + * Copyright (c) 2019 - The OWASP Foundation + * + * The ESAPI is published by OWASP under the BSD license. You should read and accept the + * LICENSE before you use, modify, and/or redistribute this software. + * + * @author kevin.w.wall@gmail.com + * @since 2019 + */ +package org.owasp.esapi.reference; + +import org.owasp.esapi.ESAPI; +import org.owasp.esapi.EncoderConstants; +import org.owasp.esapi.SecurityConfiguration; +import org.owasp.esapi.SecurityConfigurationWrapper; +import org.owasp.esapi.ValidationErrorList; +import org.owasp.esapi.ValidationRule; +import org.owasp.esapi.Validator; +import org.owasp.esapi.errors.ValidationException; +import org.owasp.esapi.filters.SecurityWrapperRequest; +import org.owasp.esapi.reference.validation.HTMLValidationRule; + +import org.junit.Test; +import org.junit.Before; +import org.junit.After; +import org.junit.Rule; +import org.junit.rules.ExpectedException; +import static org.junit.Assert.*; + +/** + * The Class HTMLValidationRuleCleanTest. + * + * Based on original test cases, testGetValidSafeHTML() and + * testIsValidSafeHTML() from ValidatorTest by + * Mike Fauzy (mike.fauzy@aspectsecurity.com) and + * Jeff Williams (jeff.williams@aspectsecurity.com) + * that were originally part of src/test/java/org/owasp/esapi/reference/ValidatorTest.java. + * + * This class tests the cases where the new ESAPI.property + * Validator.HtmlValidationAction + * is set to "clean", which causes certain calls to + * ESAPI.validator().getValidSafeHTML() or ESAPI.validator().isValidSafeHTML() + * to simply log a warning and return the cleansed (sanitizied) output rather + * than throwing a ValidationException when certain unsafe input is + * encountered. + */ +public class HTMLValidationRuleCleanTest { + + private static class ConfOverride extends SecurityConfigurationWrapper { + private String desiredReturn = "clean"; + + ConfOverride(SecurityConfiguration orig, String desiredReturn) { + super(orig); + this.desiredReturn = desiredReturn; + } + + @Override + public String getStringProp(String propName) { + // Would it be better making this file a static import? + if ( propName.equals( org.owasp.esapi.reference.DefaultSecurityConfiguration.VALIDATOR_HTML_VALIDATION_ACTION ) ) { + return desiredReturn; + } else { + return super.getStringProp( propName ); + } + } + } + + + /** + * Instantiates a new HTTP utilities test. + * + * @param testName the test name + */ + public HTMLValidationRuleCleanTest() { + } + + @After + public void tearDown() throws Exception { + ESAPI.override(null); + } + + @Before + public void setUp() throws Exception { + ESAPI.override( + new ConfOverride( ESAPI.securityConfiguration(), "clean" ) + ); + + } + + @Test + public void testGetValidSafeHTML() throws Exception { + System.out.println("getValidSafeHTML"); + Validator instance = ESAPI.validator(); + ValidationErrorList errors = new ValidationErrorList(); + + HTMLValidationRule rule = new HTMLValidationRule("test"); + ESAPI.validator().addRule(rule); + + assertEquals("Test.", ESAPI.validator().getRule("test").getValid("test", "Test. ")); + + String test1 = "Jeff"; + String result1 = instance.getValidSafeHTML("test", test1, 100, false, errors); + assertEquals(test1, result1); + + String test2 = "Aspect Security"; + String result2 = instance.getValidSafeHTML("test", test2, 100, false, errors); + assertEquals(test2, result2); + + String test3 = "Test. Cookie :-)"; + assertEquals("Test. Cookie :-)", rule.getSafe("test", test3)); + + assertEquals("Test. <
    load=alert()
    ", rule.getSafe("test", "Test. <
    load=alert()")); + assertEquals("Test.
    b
    ", rule.getSafe("test", "Test.
    b
    ")); + assertEquals("Test. alert(document.cookie)", rule.getSafe("test", "Test. alert(document.cookie)")); + assertEquals("Test. alert(document.cookie)", rule.getSafe("test", "Test. alert(document.cookie)")); + assertEquals("Test. alert(document.cookie)", rule.getSafe("test", "Test. alert(document.cookie)")); + // TODO: ENHANCE waiting for a way to validate text headed for an attribute for scripts + // This would be nice to catch, but just looks like text to AntiSamy + // assertFalse(instance.isValidSafeHTML("test", "\" onload=\"alert(document.cookie)\" ")); + // String result4 = instance.getValidSafeHTML("test", test4); + // assertEquals("", result4); + } + + + @Test + public void testIsValidSafeHTML() { + System.out.println("isValidSafeHTML"); + Validator instance = ESAPI.validator(); + + assertTrue(instance.isValidSafeHTML("test", "Jeff", 100, false)); + assertTrue(instance.isValidSafeHTML("test", "Aspect Security", 100, false)); + assertTrue(instance.isValidSafeHTML("test", "Test. ", 100, false)); + assertTrue(instance.isValidSafeHTML("test", "Test.
    ", 100, false)); + assertTrue(instance.isValidSafeHTML("test", "Test. alert(document.cookie)", 100, false)); + assertTrue(instance.isValidSafeHTML("test", "Test. alert(document.cookie)", 100, false)); + assertTrue(instance.isValidSafeHTML("test", "Test. alert(document.cookie)", 100, false)); + + // TODO: waiting for a way to validate text headed for an attribute for scripts + // This would be nice to catch, but just looks like text to AntiSamy + // assertFalse(instance.isValidSafeHTML("test", "\" onload=\"alert(document.cookie)\" ")); + ValidationErrorList errors = new ValidationErrorList(); + assertTrue(instance.isValidSafeHTML("test1", "Jeff", 100, false, errors)); + assertTrue(instance.isValidSafeHTML("test2", "Aspect Security", 100, false, errors)); + assertTrue(instance.isValidSafeHTML("test3", "Test. ", 100, false, errors)); + assertTrue(instance.isValidSafeHTML("test4", "Test.
    ", 100, false, errors)); + assertTrue(instance.isValidSafeHTML("test5", "Test. alert(document.cookie)", 100, false, errors)); + assertTrue(instance.isValidSafeHTML("test6", "Test. alert(document.cookie)", 100, false, errors)); + assertTrue(instance.isValidSafeHTML("test7", "Test. alert(document.cookie)", 100, false, errors)); + assertTrue(errors.size() == 0); + + } +} diff --git a/src/test/java/org/owasp/esapi/reference/validation/HTMLValidationRuleThrowsTest.java b/src/test/java/org/owasp/esapi/reference/validation/HTMLValidationRuleThrowsTest.java new file mode 100644 index 000000000..6726ef56f --- /dev/null +++ b/src/test/java/org/owasp/esapi/reference/validation/HTMLValidationRuleThrowsTest.java @@ -0,0 +1,167 @@ +/** + * OWASP Enterprise Security API (ESAPI) + * + * This file is part of the Open Web Application Security Project (OWASP) + * Enterprise Security API (ESAPI) project. For details, please see + * http://www.owasp.org/index.php/ESAPI. + * + * Copyright (c) 2019 - The OWASP Foundation + * + * The ESAPI is published by OWASP under the BSD license. You should read and accept the + * LICENSE before you use, modify, and/or redistribute this software. + * + * @author kevin.w.wall@gmail.com + * @since 2019 + */ +package org.owasp.esapi.reference; + +import org.owasp.esapi.ESAPI; +import org.owasp.esapi.SecurityConfiguration; +import org.owasp.esapi.SecurityConfigurationWrapper; +import org.owasp.esapi.ValidationErrorList; +import org.owasp.esapi.ValidationRule; +import org.owasp.esapi.Validator; +import org.owasp.esapi.errors.ValidationException; +import org.owasp.esapi.reference.validation.HTMLValidationRule; + +import org.junit.Test; +import org.junit.Before; +import org.junit.After; +import org.junit.Rule; +import org.junit.rules.ExpectedException; +import static org.junit.Assert.*; + +/** + * The Class HTMLValidationRuleThrowsTest. + * + * Based on original test cases, testGetValidSafeHTML() and + * testIsValidSafeHTML() from ValidatorTest by + * Mike Fauzy (mike.fauzy@aspectsecurity.com) and + * Jeff Williams (jeff.williams@aspectsecurity.com) + * that were originally part of src/test/java/org/owasp/esapi/reference/ValidatorTest.java. + * + * This class tests the cases where the new ESAPI.property + * Validator.HtmlValidationAction + * is set to "throw", which causes certain calls to + * ESAPI.validator().getValidSafeHTML() or ESAPI.validator().isValidSafeHTML() + * to throw a ValidationException rather than simply logging a warning and returning + * the cleansed (sanitizied) output when certain unsafe input is encountered. + */ +public class HTMLValidationRuleThrowsTest { + private static class ConfOverride extends SecurityConfigurationWrapper { + private String desiredReturn = "clean"; + + ConfOverride(SecurityConfiguration orig, String desiredReturn) { + super(orig); + this.desiredReturn = desiredReturn; + } + + @Override + public String getStringProp(String propName) { + // Would it be better making this file a static import? + if ( propName.equals( org.owasp.esapi.reference.DefaultSecurityConfiguration.VALIDATOR_HTML_VALIDATION_ACTION ) ) { + return desiredReturn; + } else { + return super.getStringProp( propName ); + } + } + } + + // Must be public! + @Rule + public ExpectedException thrownEx = ExpectedException.none(); + + @After + public void tearDown() throws Exception { + ESAPI.override(null); + thrownEx = ExpectedException.none(); + } + + @Before + public void setUp() throws Exception { + ESAPI.override( + new ConfOverride( ESAPI.securityConfiguration(), "throw" ) + ); + + } + + @Test + public void testGetValid() throws Exception { + System.out.println("getValid"); + Validator instance = ESAPI.validator(); + HTMLValidationRule rule = new HTMLValidationRule("test"); + ESAPI.validator().addRule(rule); + + thrownEx.expect(ValidationException.class); + thrownEx.expectMessage("test: Invalid HTML input"); + + instance.getRule("test").getValid("test", "Test. "); + } + + @Test + public void testGetValidSafeHTML() throws Exception { + System.out.println("getValidSafeHTML"); + Validator instance = ESAPI.validator(); + + HTMLValidationRule rule = new HTMLValidationRule("test"); + ESAPI.validator().addRule(rule); + + String[] testInput = { + // These first two don't cause AntiSamy to throw. + // "Test. Aspect Security", + // "Test. <
    load=alert()", + "Test. ", + "Test. ", + "Test.
    b
    ", + "Test. alert(document.cookie)", + "Test. alert(document.cookie)", + "Test. alert(document.cookie)" + }; + + int errors = 0; + for( int i = 0; i < testInput.length; i++ ) { + try { + String result = instance.getValidSafeHTML("test", testInput[i], 100, false); + errors++; + System.out.println("testGetValidSafeHTML(): testInput '" + testInput[i] + "' failed to throw."); + } + catch( ValidationException vex ) { + System.out.println("testGetValidSafeHTML(): testInput '" + testInput[i] + "' returned:"); + System.out.println("\t" + i + ": logMsg =" + vex.getLogMessage()); + assertEquals( vex.getUserMessage(), "test: Invalid HTML input"); + } + catch( Exception ex ) { + errors++; + System.out.println("testGetValidSafeHTML(): testInput '" + testInput[i] + + "' threw wrong exception type: " + ex.getClass().getName() ); + } + } + + if ( errors > 0 ) { + fail("testGetValidSafeHTML() encountered " + errors + " failures."); + } + } + + @Test + public void testIsValidSafeHTML() { + System.out.println("isValidSafeHTML"); + Validator instance = ESAPI.validator(); + thrownEx = ExpectedException.none(); // Not expecting any exceptions here. + + assertTrue(instance.isValidSafeHTML("test", "Jeff", 100, false)); + assertTrue(instance.isValidSafeHTML("test", "Aspect Security", 100, false)); + assertFalse(instance.isValidSafeHTML("test", "Test. ", 100, false)); + assertFalse(instance.isValidSafeHTML("test", "Test.
    ", 100, false)); + assertFalse(instance.isValidSafeHTML("test", "Test. alert(document.cookie)", 100, false)); + assertFalse(instance.isValidSafeHTML("test", "Test. alert(document.cookie)", 100, false)); + assertFalse(instance.isValidSafeHTML("test", "Test. alert(document.cookie)", 100, false)); + + ValidationErrorList errors = new ValidationErrorList(); + assertFalse(instance.isValidSafeHTML("test1", "Test. ", 100, false, errors)); + assertFalse(instance.isValidSafeHTML("test2", "Test.
    ", 100, false, errors)); + assertFalse(instance.isValidSafeHTML("test3", "Test. alert(document.cookie)", 100, false, errors)); + assertFalse(instance.isValidSafeHTML("test4", "Test. alert(document.cookie)", 100, false, errors)); + assertFalse(instance.isValidSafeHTML("test5", "Test. alert(document.cookie)", 100, false, errors)); + assertTrue( errors.size() == 5 ); + } +} diff --git a/src/test/resources/esapi/ESAPI.properties b/src/test/resources/esapi/ESAPI.properties index 2537757c1..14b47d32f 100644 --- a/src/test/resources/esapi/ESAPI.properties +++ b/src/test/resources/esapi/ESAPI.properties @@ -97,9 +97,9 @@ ESAPI.Executor=org.owasp.esapi.reference.DefaultExecutor ESAPI.HTTPUtilities=org.owasp.esapi.reference.DefaultHTTPUtilities ESAPI.IntrusionDetector=org.owasp.esapi.reference.DefaultIntrusionDetector # Log4JFactory Requires log4j.xml or log4j.properties in classpath - http://www.laliluna.de/log4j-tutorial.html -ESAPI.Logger=org.owasp.esapi.logging.log4j.Log4JLogFactory -#ESAPI.Logger=org.owasp.esapi.logging.java.JavaLogFactory -#ESAPI.Logger=org.owasp.esapi.reference.ExampleExtendedLog4JLogFactory +# Note that this is now considered deprecated! +#ESAPI.Logger=org.owasp.esapi.logging.log4j.Log4JLogFactory +ESAPI.Logger=org.owasp.esapi.logging.java.JavaLogFactory # To use the new SLF4J logger in ESAPI (see GitHub issue #129), set # ESAPI.Logger=org.owasp.esapi.logging.slf4j.Slf4JLogFactory # and do whatever other normal SLF4J configuration that you normally would do for your application. @@ -529,3 +529,38 @@ Validator.DirectoryName=^[a-zA-Z0-9:/\\\\!@#$%^&{}\\[\\]()_+\\-=,.~'` ]{1,255}$ # Validation of dates. Controls whether or not 'lenient' dates are accepted. # See DataFormat.setLenient(boolean flag) for further details. Validator.AcceptLenientDates=false + +# ~~~~~ Important Note ~~~~~ +# This is a workaround to make sure that a commit to address GitHub issue #509 +# doesn't accidentally break someone's production code. So essentially what we +# are doing is to reverting back to the previous possibly buggy (by +# documentation intent at least), but, by now, expected legacy behavior. +# Prior to the code changes for issue #509, if invalid / malicious HTML input was +# observed, AntiSamy would simply attempt to sanitize (cleanse) it and it would +# only be logged. However, the code change made ESAPI comply with its +# documentation, which stated that a ValidationException should be thrown in +# such cases. Unfortunately, changing this behavior--especially when no one is +# 100% certain that the documentation was correct--could break existing code +# using ESAPI so after a lot of debate, issue #521 was created to restore the +# previous behavior, but still allow the documented behavior. (We did this +# because it wasn't really causing an security issues since AntiSamy would clean +# it up anyway and we value backward compatibility as long as it doesn't clearly +# present security vulnerabilities.) +# More defaults about this are written up under GitHub issue #521 and +# the pull request it references. Future major releases of ESAPI (e.g., ESAPI 3.x) +# will not support this previous behavior, but it will remain for ESAPI 2.x. +# Set this to 'throw' if you want the originally intended behavior of throwing +# that was fixed via issue #509. Set to 'clean' if you want want the HTML input +# sanitized instead. +# +# Possible values: +# clean -- Use the legacy behavior where unsafe HTML input is logged and the +# sanitized (i.e., clean) input as determined by AntiSamy and your +# AntiSamy rules is returned. This is the default behavior if this +# new property is not found. +# throw -- The new, presumably correct and originally intended behavior where +# a ValidationException is thrown when unsafe HTML input is +# encountered. +# +#Validator.HtmlValidationAction=clean +Validator.HtmlValidationAction=throw From 74492fee25b9640c985da28a91db478f21e6de92 Mon Sep 17 00:00:00 2001 From: kwwall Date: Sun, 9 Feb 2020 00:37:18 -0500 Subject: [PATCH 654/812] Close issue #538 addressing CVE-2019-17571 with security bulletin. --- SECURITY.md | 8 ++++++++ documentation/ESAPI-security-bulletin2.odt | Bin 0 -> 31990 bytes documentation/ESAPI-security-bulletin2.pdf | Bin 0 -> 103931 bytes 3 files changed, 8 insertions(+) create mode 100644 documentation/ESAPI-security-bulletin2.odt create mode 100644 documentation/ESAPI-security-bulletin2.pdf diff --git a/SECURITY.md b/SECURITY.md index f4d5ecb55..bee2b246a 100644 --- a/SECURITY.md +++ b/SECURITY.md @@ -40,3 +40,11 @@ can understand what needs to be done to fix it. Unfortunately at this time, we are not in a position to pay out bug bounties for vulnerabilities. Eventually, we would like to have BugCrowd handle this, but that's still a ways off. + +## Security Bulletins + +There are some ESAPI security bulletins published in the "documentation" directory on GitHub. +For details see: + +* (Security Bulletin #1 - MAC Bypass in ESAPI Symmetric Encryption)[documentation/ESAPI-security-bulletin1.pdf], which covers CVE-2013-5679 and CVE-2013-5960 +* (Security Bulletin #2 - How Does CVE-2019-17571 Impact ESAPI?)[documentation/ESAPI-security-bulletin2.pdf], which covers the Log4J 1 deserialization CVE. diff --git a/documentation/ESAPI-security-bulletin2.odt b/documentation/ESAPI-security-bulletin2.odt new file mode 100644 index 0000000000000000000000000000000000000000..c65623126fc7cab343fded85c86ac6b1b636ca78 GIT binary patch literal 31990 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 hu8LAtC6J)dh{>{Mu-IV&pn?RhbK0;$T~CAi{{R Date: Sun, 9 Feb 2020 00:53:42 -0500 Subject: [PATCH 655/812] Update SECURITY.md to fix security bulletin links. It must be past my bedtime. Sigh. ;-) --- SECURITY.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/SECURITY.md b/SECURITY.md index bee2b246a..18d510ad9 100644 --- a/SECURITY.md +++ b/SECURITY.md @@ -46,5 +46,5 @@ Eventually, we would like to have BugCrowd handle this, but that's still a ways There are some ESAPI security bulletins published in the "documentation" directory on GitHub. For details see: -* (Security Bulletin #1 - MAC Bypass in ESAPI Symmetric Encryption)[documentation/ESAPI-security-bulletin1.pdf], which covers CVE-2013-5679 and CVE-2013-5960 -* (Security Bulletin #2 - How Does CVE-2019-17571 Impact ESAPI?)[documentation/ESAPI-security-bulletin2.pdf], which covers the Log4J 1 deserialization CVE. +* [Security Bulletin #1 - MAC Bypass in ESAPI Symmetric Encryption](documentation/ESAPI-security-bulletin1.pdf), which covers CVE-2013-5679 and CVE-2013-5960 +* [Security Bulletin #2 - How Does CVE-2019-17571 Impact ESAPI?](documentation/ESAPI-security-bulletin2.pdf), which covers the Log4J 1 deserialization CVE. From 5ed5f253e3e9a5135a627942e17f9c5791b09f07 Mon Sep 17 00:00:00 2001 From: Wiiitek Date: Sun, 9 Feb 2020 21:53:35 +0100 Subject: [PATCH 656/812] upgrade for convergence --- pom.xml | 29 +++++++++-------------------- 1 file changed, 9 insertions(+), 20 deletions(-) diff --git a/pom.xml b/pom.xml index 6a34d2cc0..1997e5a00 100644 --- a/pom.xml +++ b/pom.xml @@ -364,7 +364,7 @@ org.powermock powermock-reflect - 2.0.0 + 2.0.2 test @@ -526,36 +526,25 @@ - enforce-bytecode-version enforce + + + 1.7 + + ESAPI 2.x now uses the JDK1.7 for it's baseline. Please make sure that your + JAVA_HOME environment variable is pointed to a JDK1.7 distribution. + + 1.7 - true - - enforce-jdk-version - - enforce - - - - - 1.7 - - ESAPI 2.x now uses the JDK1.7 for it's baseline. Please make sure that your - JAVA_HOME environment variable is pointed to a JDK1.7 distribution. - - - - - From e179580e133c03044fd6c0adfc93d335afb98549 Mon Sep 17 00:00:00 2001 From: Wiiitek Date: Sun, 9 Feb 2020 22:25:30 +0100 Subject: [PATCH 657/812] new way for getting file content from filesystem --- .../reference/ExtensiveEncoderURITest.java | 26 ++++++++++++++----- 1 file changed, 19 insertions(+), 7 deletions(-) diff --git a/src/test/java/org/owasp/esapi/reference/ExtensiveEncoderURITest.java b/src/test/java/org/owasp/esapi/reference/ExtensiveEncoderURITest.java index 37e9ea213..36bd7c116 100644 --- a/src/test/java/org/owasp/esapi/reference/ExtensiveEncoderURITest.java +++ b/src/test/java/org/owasp/esapi/reference/ExtensiveEncoderURITest.java @@ -2,10 +2,12 @@ import static org.junit.Assert.assertEquals; -import java.io.File; +import java.io.BufferedReader; +import java.io.IOException; +import java.io.InputStream; +import java.io.InputStreamReader; import java.net.URL; import java.nio.charset.StandardCharsets; -import java.nio.file.Files; import java.util.ArrayList; import java.util.Collection; import java.util.List; @@ -34,14 +36,24 @@ public ExtensiveEncoderURITest(String uri){ @Parameters public static Collection getMyUris() throws Exception{ URL url = ExtensiveEncoderURITest.class.getResource("/urisForTest.txt"); - String fileName = url.getFile(); - File urisForText = new File(fileName); - - inputs = Files.readAllLines(urisForText.toPath(), StandardCharsets.UTF_8); + try( InputStream is = url.openStream() ) { + InputStreamReader isr = new InputStreamReader(is, StandardCharsets.UTF_8); + BufferedReader br = new BufferedReader(isr); + inputs = readAllLines(br); + } return inputs; } - + + private static List readAllLines(BufferedReader br) throws IOException { + List lines = new ArrayList<>(); + String line; + while ((line = br.readLine()) != null) { + lines.add(line); + } + return lines; + } + @Test public void testUrlsFromFile() throws Exception{ assertEquals(this.expected, v.isValidURI("URL", uri, false)); From c951b1cd05112bf9760d3cd3d08c842c418c443a Mon Sep 17 00:00:00 2001 From: Wiiitek Date: Sun, 9 Feb 2020 23:32:58 +0100 Subject: [PATCH 658/812] update for reading configuration from file path with spaces --- .../DefaultSecurityConfiguration.java | 19 ++++++++++++------- 1 file changed, 12 insertions(+), 7 deletions(-) diff --git a/src/main/java/org/owasp/esapi/reference/DefaultSecurityConfiguration.java b/src/main/java/org/owasp/esapi/reference/DefaultSecurityConfiguration.java index a9fd89cc9..d578850ba 100644 --- a/src/main/java/org/owasp/esapi/reference/DefaultSecurityConfiguration.java +++ b/src/main/java/org/owasp/esapi/reference/DefaultSecurityConfiguration.java @@ -20,6 +20,7 @@ import java.io.FileNotFoundException; import java.io.IOException; import java.io.InputStream; +import java.net.URISyntaxException; import java.net.URL; import java.util.ArrayList; import java.util.Arrays; @@ -581,13 +582,17 @@ public File getResourceFile(String filename) { } if (fileUrl != null) { - String fileLocation = fileUrl.getFile(); - f = new File(fileLocation); - if (f.exists()) { - logSpecial("Found in SystemResource Directory/resourceDirectory: " + f.getAbsolutePath()); - return f; - } else { - logSpecial("Not found in SystemResource Directory/resourceDirectory (this should never happen): " + f.getAbsolutePath()); + try { + String fileLocation = fileUrl.toURI().getPath(); + f = new File(fileLocation); + if (f.exists()) { + logSpecial("Found in SystemResource Directory/resourceDirectory: " + f.getAbsolutePath()); + return f; + } else { + logSpecial("Not found in SystemResource Directory/resourceDirectory (this should never happen): " + f.getAbsolutePath()); + } + } catch (URISyntaxException e) { + logSpecial("Error while converting URL " + fileUrl + " to file path: " + e.getMessage()); } } else { logSpecial("Not found in SystemResource Directory/resourceDirectory: " + resourceDirectory + File.separator + filename); From fd1650d4fd8da129843a1346811f26dc43466de7 Mon Sep 17 00:00:00 2001 From: "Kevin W. Wall" Date: Mon, 17 Feb 2020 14:14:54 -0500 Subject: [PATCH 659/812] Update pom.xml SNAPSHOT version Changed from 2.3.0.0-SNAPSHOT to 2.2.1.0-SNAPSHOT. --- pom.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pom.xml b/pom.xml index 1997e5a00..881b59c5e 100644 --- a/pom.xml +++ b/pom.xml @@ -3,7 +3,7 @@ 4.0.0 org.owasp.esapi esapi - 2.3.0.0-SNAPSHOT + 2.2.1.0-SNAPSHOT jar From f8180f59c636e90a9677deb9c29afae2f1f7c665 Mon Sep 17 00:00:00 2001 From: kwwall Date: Mon, 17 Feb 2020 20:42:13 -0500 Subject: [PATCH 660/812] Drop 'failBuildOnCVSS' from 5.9 to 5.0. Corrected spelling of 'suppressionFiles'. (Old value still worked.) --- pom.xml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/pom.xml b/pom.xml index 881b59c5e..132075ffd 100644 --- a/pom.xml +++ b/pom.xml @@ -689,8 +689,8 @@ dependency-check-maven 5.0.0 - 5.9 - ./suppressions.xml + 5.0 + ./suppressions.xml From 448c8f3a1feb517ba07880e709ea4ed37ab447ee Mon Sep 17 00:00:00 2001 From: kwwall Date: Mon, 17 Feb 2020 20:45:04 -0500 Subject: [PATCH 661/812] Added suppression of CVE-2019-17571; deleted suppression of CVE-2016-1000031. --- suppressions.xml | 22 +++++++++++++++++----- 1 file changed, 17 insertions(+), 5 deletions(-) diff --git a/suppressions.xml b/suppressions.xml index 181b75909..ebedb9648 100644 --- a/suppressions.xml +++ b/suppressions.xml @@ -1,10 +1,22 @@ - + + - .*\bcommons-fileupload-1.3.2.jar - CVE-2016-1000031 + ^log4j:log4j:1\.2\.17$ + cpe:/a:apache:log4j + CVE-2019-17571 - \ No newline at end of file + From 7aafaeeb3476c86886756699501f09963b8657f8 Mon Sep 17 00:00:00 2001 From: Wiiitek Date: Sun, 23 Feb 2020 18:12:58 +0100 Subject: [PATCH 662/812] additional time for windows to always sleep more than given seconds --- src/test/java/org/owasp/esapi/crypto/CryptoTokenTest.java | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/src/test/java/org/owasp/esapi/crypto/CryptoTokenTest.java b/src/test/java/org/owasp/esapi/crypto/CryptoTokenTest.java index 8f43d3b1b..0d2b8a519 100644 --- a/src/test/java/org/owasp/esapi/crypto/CryptoTokenTest.java +++ b/src/test/java/org/owasp/esapi/crypto/CryptoTokenTest.java @@ -391,7 +391,9 @@ public final void testAddandGetAttributes() { private static void nap(int n) { try { System.out.println("Sleeping " + n + " seconds..."); - Thread.sleep( n * 1000 ); + // adds additional time to make sure we sleep more than n seconds + int additionalTimeToSleep = 100; + Thread.sleep( n * 1000 + additionalTimeToSleep ); } catch (InterruptedException e) { ; // Ignore } From b479d5908d10100a32355c9b9cde05964d4075f0 Mon Sep 17 00:00:00 2001 From: Wiiitek Date: Sun, 23 Feb 2020 19:16:36 +0100 Subject: [PATCH 663/812] inline reader for try-with-resource --- .../org/owasp/esapi/reference/ExtensiveEncoderURITest.java | 6 ++---- 1 file changed, 2 insertions(+), 4 deletions(-) diff --git a/src/test/java/org/owasp/esapi/reference/ExtensiveEncoderURITest.java b/src/test/java/org/owasp/esapi/reference/ExtensiveEncoderURITest.java index 36bd7c116..0283492c7 100644 --- a/src/test/java/org/owasp/esapi/reference/ExtensiveEncoderURITest.java +++ b/src/test/java/org/owasp/esapi/reference/ExtensiveEncoderURITest.java @@ -36,10 +36,8 @@ public ExtensiveEncoderURITest(String uri){ @Parameters public static Collection getMyUris() throws Exception{ URL url = ExtensiveEncoderURITest.class.getResource("/urisForTest.txt"); - - try( InputStream is = url.openStream() ) { - InputStreamReader isr = new InputStreamReader(is, StandardCharsets.UTF_8); - BufferedReader br = new BufferedReader(isr); + + try( BufferedReader br = new BufferedReader(new InputStreamReader(url.openStream(), StandardCharsets.UTF_8)) ) { inputs = readAllLines(br); } return inputs; From 048fc0c40549cd86b28d0ac5ef89cbfdc4cbb289 Mon Sep 17 00:00:00 2001 From: Wiiitek Date: Sun, 23 Feb 2020 19:17:42 +0100 Subject: [PATCH 664/812] removing not needed code --- .../org/owasp/esapi/reference/ExtensiveEncoderURITest.java | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/src/test/java/org/owasp/esapi/reference/ExtensiveEncoderURITest.java b/src/test/java/org/owasp/esapi/reference/ExtensiveEncoderURITest.java index 0283492c7..18d88c79e 100644 --- a/src/test/java/org/owasp/esapi/reference/ExtensiveEncoderURITest.java +++ b/src/test/java/org/owasp/esapi/reference/ExtensiveEncoderURITest.java @@ -4,7 +4,6 @@ import java.io.BufferedReader; import java.io.IOException; -import java.io.InputStream; import java.io.InputStreamReader; import java.net.URL; import java.nio.charset.StandardCharsets; @@ -22,7 +21,7 @@ @RunWith(Parameterized.class) public class ExtensiveEncoderURITest { - static List inputs = new ArrayList(); + static List inputs = new ArrayList<>(); Validator v = ESAPI.validator(); String uri; boolean expected; @@ -53,7 +52,7 @@ private static List readAllLines(BufferedReader br) throws IOException { } @Test - public void testUrlsFromFile() throws Exception{ + public void testUrlsFromFile() { assertEquals(this.expected, v.isValidURI("URL", uri, false)); } From 7003acc1da17eb68bc92c97a2b7d47a093021385 Mon Sep 17 00:00:00 2001 From: "Kevin W. Wall" Date: Sun, 23 Feb 2020 17:17:02 -0500 Subject: [PATCH 665/812] Updated README.md to refer to config jar Updated 2.2.0.0 release on GitHub and added jar and signature for ESAPI default config files. This README.md update just references that. --- README.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/README.md b/README.md index f7c38d99d..fd3e2d5bf 100644 --- a/README.md +++ b/README.md @@ -23,6 +23,12 @@ The default branch for ESAPI legacy is now the 'develop' branch (rather than the # Where can I find ESAPI 3.x? https://github.com/ESAPI/esapi-java +# Locating ESAPI Jar files +The latest ESAPI 2.2.0.0 default configuration jar and its GPG signature can be found at [esapi-2.2.0.0-configuration.jar](https://github.com/ESAPI/esapi-java-legacy/releases/download/esapi-2.2.0.0/esapi-2.2.0.0-configuration.jar) and [esapi-2.2.0.0-configuration.jar.asc](https://github.com/ESAPI/esapi-java-legacy/releases/download/esapi-2.2.0.0/esapi-2.2.0.0-configuration.jar.asc) respectively. + +The latest regular ESAPI jars can are available from Maven Central. + + # ESAPI Deprecation Policy Unless we unintentionally screw-up, our intent is to keep classes, methods, and/or fields whihc have been annotated as "@deprecated" for a minimum of two (2) years or until the next major release number (e.g., 3.x as of now), which ever comes first, before we remove them. Note that this policy does not apply to classes under the **org.owasp.esapi.reference** package. You are not expected to be using such classes directly in your code. From e007ec83f5169a7f75ba63354a63c697af685fe2 Mon Sep 17 00:00:00 2001 From: "Kevin W. Wall" Date: Tue, 25 Feb 2020 22:22:57 -0500 Subject: [PATCH 666/812] Update to include link to the latest release. --- README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index fd3e2d5bf..68037a5d2 100644 --- a/README.md +++ b/README.md @@ -15,7 +15,7 @@ OWASP ESAPI (The OWASP Enterprise Security API) is a free, open source, web appl # What does Legacy mean? -

    This is the legacy branch of ESAPI which means it is an actively maintained branch of the project, however feature development for this branch will not be done. Features that have already been scheduled for the 2.x branch will move forward, but the main focus will be working on the ESAPI 3.x branch. +

    This is the legacy branch of ESAPI which means it is an actively maintained branch of the project, however feature development for this branch will not be done. Features that have already been scheduled for the 2.x branch will move forward, but the main focus will be working on the ESAPI 3.x branch. IMPORTANT NOTE: The default branch for ESAPI legacy is now the 'develop' branch (rather than the 'master' branch), where future development, bug fixes, etc. will now be done. The 'master' branch is now marked as "protected"; it reflects the latest stable ESAPI release (2.1.0.1 as of this date). Note that this change of making the 'develop' branch the default may affect any pull requests that you were intending to make. @@ -24,7 +24,7 @@ The default branch for ESAPI legacy is now the 'develop' branch (rather than the https://github.com/ESAPI/esapi-java # Locating ESAPI Jar files -The latest ESAPI 2.2.0.0 default configuration jar and its GPG signature can be found at [esapi-2.2.0.0-configuration.jar](https://github.com/ESAPI/esapi-java-legacy/releases/download/esapi-2.2.0.0/esapi-2.2.0.0-configuration.jar) and [esapi-2.2.0.0-configuration.jar.asc](https://github.com/ESAPI/esapi-java-legacy/releases/download/esapi-2.2.0.0/esapi-2.2.0.0-configuration.jar.asc) respectively. +The [latest ESAPI release](https://github.com/ESAPI/esapi-java-legacy/releases/latest) is 2.2.0.0. The default configuration jar and its GPG signature can be found at [esapi-2.2.0.0-configuration.jar](https://github.com/ESAPI/esapi-java-legacy/releases/download/esapi-2.2.0.0/esapi-2.2.0.0-configuration.jar) and [esapi-2.2.0.0-configuration.jar.asc](https://github.com/ESAPI/esapi-java-legacy/releases/download/esapi-2.2.0.0/esapi-2.2.0.0-configuration.jar.asc) respectively. The latest regular ESAPI jars can are available from Maven Central. From d26b98f11d0d1bacc66df36d7c659c822bb3fba7 Mon Sep 17 00:00:00 2001 From: Bill Sempf Date: Tue, 19 May 2020 00:01:59 -0400 Subject: [PATCH 667/812] Release notes for 2.2.1.0 (#543) I have no idea how to associate this with Issue 542 but if I figure it out I will do it. --- .../esapi4java-core-2.2.1.0-release-notes.txt | 115 ++++++++++++++++++ 1 file changed, 115 insertions(+) create mode 100644 documentation/esapi4java-core-2.2.1.0-release-notes.txt diff --git a/documentation/esapi4java-core-2.2.1.0-release-notes.txt b/documentation/esapi4java-core-2.2.1.0-release-notes.txt new file mode 100644 index 000000000..7f91e07a5 --- /dev/null +++ b/documentation/esapi4java-core-2.2.1.0-release-notes.txt @@ -0,0 +1,115 @@ +Release notes for ESAPI 2.2.1.0 + Release date: 2020-May-12 + Project leaders: + -Kevin W. Wall + -Matt Seil + +Previous release: ESAPI 2.2.0.0, 2019-June-24 + + +Executive Summary: Important Things to Note for this Release +------------------------------------------------------------ + + TBD + +================================================================================================================= + +Basic ESAPI facts + +ESAPI 2.2.0.0 release: + 194 Java source files + 4150 JUnit tests in 118 Java source files + +ESAPI 2.2.1.0 release: + TBD + +GitHub Issues fixed in this release + +Issue # GitHub Issue Title +---------------------------------------------------------------------------------------------- + +143 Enchance encodeForOS to auto-detect the underling OS +226 Javadoc Inaccuracy in getRandomInteger() and getRandomReal() +245 KeyDerivationFunction::computeDerivedKey - possible security level mismatch +256 White space clean up +382 Build Fails on path with space +494 Encoder's encodeForCSS doesn't handle RGB Triplets +503 Bug on on referrer header when value contains `§ion` like `www.asdf.com?a=1§ion=2` +509 HTMLValidationRule.getValid(String,String) does not follow documented specifications +511 Add missing documentation to Validator.addRule() and Validator.getRule() +512 Update Apache Commons Bean Utils to 1.9.4 +515 Adding tests for getCookies (also 516) +519 Issue 494 CSSCodec RGB Triplets +530 Log Bridge Tests +536 Various fixes +538 Addressing log4j 1.x CVE-2019-17571 + +----------------------------------------------------------------------------- + + Changes requiring special attention + +----------------------------------------------------------------------------- + +TBD + +----------------------------------------------------------------------------- + + Other changes in this release, some of which not tracked via GitHub issues + +----------------------------------------------------------------------------- + +Documentation updates for locating Jar files +Unneeded code removed from ExtensiveEncoder +Inline reader added to ExtensiveEncoder +Additional time for windows to always sleep more than given seconds in CryptoTokenTest +Change required by tweak to CipherText.toString() method +Removed call to deprecated CryptoHelper.computeDerivedKey() method +New JUnit tests for org.owasp.esapi.crypto.KeyDerivationFunction class +Use existing toString method rather than a StringBuilder +Documentation and tests +JavaLogger move +Splitting user infor from Client Supplier + +----------------------------------------------------------------------------- + +Developer Activity Report (Changes between release 2.2.0.0 and 2.2.1.0, i.e., between 2019-06-25 and 2020-05-12) +Generated manually (this time) + +Developer Total commits Total Number + of Files Changed +===================================================== +jeremiahjstacey 11 68 +kwwall 15 26 +wiitek 3 6 +xeno6696 8 9 +Michael-Ziluck 2 3 +===================================================== + +----------------------------------------------------------------------------- + +53 Closed PRs since 2.2.0.0 release +=================================== +504 New scripts to suppress noise for 'mvn test' +510 Resolve #509 - Properly throw exception when HTML fails +513 Close issue #512 by updating to 1.9.4 of Commons Beans Util.\ +519 Issue 494 CSSCodec RGB Triplets +520 OS Name DefaultExecutorTests #143 +540 Issue 382: Build Fails on path with space +596 Closes Issue 245 + +----------------------------------------------------------------------------- + +Notice: + + Release notes written by Bill Sempf (bill.sempf@owasp.org) please direct any communication to me. + +Project co-leaders + Kevin W. Wall (kwwall) + Matt Seil (xeno6696) + +Special shout-outs to: + Jeremiah Stacey (jeremiahjstacey) -- All around ESAPI support and JUnit test case developer extraordinaire + Dave Wichers (davewichers) - for Maven Central / Sonatype help + +Thanks you all for your time and effort to ESAPI and making it a better project. And if I've missed any, my apologies; let me know and I will correct it. + From 482194884f5db00b8d22bfde6e5a8823374dd128 Mon Sep 17 00:00:00 2001 From: "Kevin W. Wall" Date: Tue, 19 May 2020 00:03:59 -0400 Subject: [PATCH 668/812] Update release date to 2020-TBD Need to wait until other PR is merged. --- documentation/esapi4java-core-2.2.1.0-release-notes.txt | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/documentation/esapi4java-core-2.2.1.0-release-notes.txt b/documentation/esapi4java-core-2.2.1.0-release-notes.txt index 7f91e07a5..bb46556b8 100644 --- a/documentation/esapi4java-core-2.2.1.0-release-notes.txt +++ b/documentation/esapi4java-core-2.2.1.0-release-notes.txt @@ -1,5 +1,5 @@ Release notes for ESAPI 2.2.1.0 - Release date: 2020-May-12 + Release date: 2020-TBD Project leaders: -Kevin W. Wall -Matt Seil From 90d3d0d9ba48c6b372980cdded869faf31fd59e7 Mon Sep 17 00:00:00 2001 From: kwwall Date: Sat, 6 Jun 2020 17:25:09 -0400 Subject: [PATCH 669/812] Fix Javadoc --- src/main/java/org/owasp/esapi/codecs/HashTrie.java | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/src/main/java/org/owasp/esapi/codecs/HashTrie.java b/src/main/java/org/owasp/esapi/codecs/HashTrie.java index 4c8d41910..fef14aee7 100644 --- a/src/main/java/org/owasp/esapi/codecs/HashTrie.java +++ b/src/main/java/org/owasp/esapi/codecs/HashTrie.java @@ -252,8 +252,7 @@ Entry getLongestMatch(CharSequence key, int pos) /** * Recursively lookup the longest key match. * @param keyIn Where to read the key from - * @param pos The position in the key that is being - * looked up at this level. + * @param key The key that is being looked up at this level. * @return The Entry associated with the longest key * match or null if none exists. */ From 9be40d4055c0bc186845e8679c72cf4b476ad710 Mon Sep 17 00:00:00 2001 From: kwwall Date: Sat, 6 Jun 2020 17:27:51 -0400 Subject: [PATCH 670/812] Fix Javadoc --- src/main/java/org/owasp/esapi/crypto/CipherText.java | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/src/main/java/org/owasp/esapi/crypto/CipherText.java b/src/main/java/org/owasp/esapi/crypto/CipherText.java index 8e57f03e7..1047116fa 100644 --- a/src/main/java/org/owasp/esapi/crypto/CipherText.java +++ b/src/main/java/org/owasp/esapi/crypto/CipherText.java @@ -804,7 +804,8 @@ protected boolean canEqual(Object other) { * proved in 1996 [see http://pssic.free.fr/Extra%20Reading/SEC+/SEC+/hmac-cb.pdf] that * HMAC security doesn’t require that the underlying hash function be collision resistant, * but only that it acts as a pseudo-random function, which SHA1 satisfies. - * @param ciphertext The ciphertext value for which the MAC is computed. + * @param authKey The {@Code SecretKey} used with the computed HMAC-SHA1 + * to ensure authenticity. * @return The value for the MAC. */ private byte[] computeMAC(SecretKey authKey) { From 23608fc130683b1ec1b3efea9331be92a815272b Mon Sep 17 00:00:00 2001 From: kwwall Date: Sat, 6 Jun 2020 17:59:19 -0400 Subject: [PATCH 671/812] Converted String array explicity to string, which is probably what was intended in exception messages. Otherwise end up with something that looks like '[Ljava.lang.String;@7825ed4c' which is not very helpful. --- .../esapi/reference/accesscontrol/DelegatingACR.java | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) diff --git a/src/main/java/org/owasp/esapi/reference/accesscontrol/DelegatingACR.java b/src/main/java/org/owasp/esapi/reference/accesscontrol/DelegatingACR.java index 07af135d7..65cb0ebb9 100644 --- a/src/main/java/org/owasp/esapi/reference/accesscontrol/DelegatingACR.java +++ b/src/main/java/org/owasp/esapi/reference/accesscontrol/DelegatingACR.java @@ -4,6 +4,7 @@ import java.lang.reflect.Modifier; import java.util.Iterator; import java.util.Vector; +import java.util.Arrays; import org.apache.commons.collections4.iterators.ArrayListIterator; @@ -25,12 +26,12 @@ public void setPolicyParameters(DynaBeanACRParameter policyParameter) { } catch (SecurityException e) { throw new IllegalArgumentException(e.getMessage() + " delegateClass.delegateMethod(parameterClasses): \"" + - delegateClassName + "." + methodName + "(" + parameterClassNames + + delegateClassName + "." + methodName + "(" + Arrays.toString(parameterClassNames) + ")\" must be public.", e); } catch (NoSuchMethodException e) { throw new IllegalArgumentException(e.getMessage() + " delegateClass.delegateMethod(parameterClasses): \"" + - delegateClassName + "." + methodName + "(" + parameterClassNames + + delegateClassName + "." + methodName + "(" + Arrays.toString(parameterClassNames) + ")\" does not exist.", e); } @@ -42,14 +43,14 @@ public void setPolicyParameters(DynaBeanACRParameter policyParameter) { throw new IllegalArgumentException( " Delegate class \"" + delegateClassName + "\" must be concrete, because method " + - delegateClassName + "." + methodName + "(" + parameterClassNames + + delegateClassName + "." + methodName + "(" + Arrays.toString(parameterClassNames) + ") is not static.", ex); } catch (IllegalAccessException ex) { new IllegalArgumentException( " Delegate class \"" + delegateClassName + "\" must must have a zero-argument constructor, because " + "method delegateClass.delegateMethod(parameterClasses): \"" + - delegateClassName + "." + methodName + "(" + parameterClassNames + + delegateClassName + "." + methodName + "(" + Arrays.toString(parameterClassNames) + ")\" is not static.", ex); } } else { From 1531303c2d5f0904740124031043f552d77c351e Mon Sep 17 00:00:00 2001 From: kwwall Date: Sat, 6 Jun 2020 18:09:03 -0400 Subject: [PATCH 672/812] Add missing space in exception message. --- src/main/java/org/owasp/esapi/util/ObjFactory.java | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/main/java/org/owasp/esapi/util/ObjFactory.java b/src/main/java/org/owasp/esapi/util/ObjFactory.java index 2c23e5f00..7853ef593 100644 --- a/src/main/java/org/owasp/esapi/util/ObjFactory.java +++ b/src/main/java/org/owasp/esapi/util/ObjFactory.java @@ -92,7 +92,7 @@ public static T make(String className, String typeName) throws Configuration // The class is meant to be singleton, however, the SecurityManager restricts us from calling the // getInstance method on the class, thus this is a configuration issue and a ConfigurationException // is thrown - throw new ConfigurationException( "The SecurityManager has restricted the object factory from getting a reference to the singleton implementation" + + throw new ConfigurationException( "The SecurityManager has restricted the object factory from getting a reference to the singleton implementation " + "of the class [" + className + "]", e ); } From b8c48a9c22317eff3ac52003de9b6eaecce0f7de Mon Sep 17 00:00:00 2001 From: kwwall Date: Sat, 6 Jun 2020 18:10:40 -0400 Subject: [PATCH 673/812] Make conversion from String array to String explicit for exception message. --- src/main/java/org/owasp/esapi/reference/DefaultValidator.java | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/src/main/java/org/owasp/esapi/reference/DefaultValidator.java b/src/main/java/org/owasp/esapi/reference/DefaultValidator.java index abe6c93a5..530e2efa8 100644 --- a/src/main/java/org/owasp/esapi/reference/DefaultValidator.java +++ b/src/main/java/org/owasp/esapi/reference/DefaultValidator.java @@ -23,6 +23,7 @@ import java.net.URI; import java.net.URISyntaxException; import java.text.DateFormat; +import java.util.Arrays; import java.util.ArrayList; import java.util.Date; import java.util.HashMap; @@ -764,7 +765,7 @@ public boolean isValidFileContent(String context, byte[] input, int maxBytes, bo public byte[] getValidFileContent(String context, byte[] input, int maxBytes, boolean allowNull) throws ValidationException, IntrusionException { if (isEmpty(input)) { if (allowNull) return null; - throw new ValidationException( context + ": Input required", "Input required: context=" + context + ", input=" + input, context ); + throw new ValidationException( context + ": Input required", "Input required: context=" + context + ", input=" + Arrays.toString(input), context ); } long esapiMaxBytes = ESAPI.securityConfiguration().getAllowedFileUploadSize(); From 120ff02fe530ac2933d36253316cf1e208d13023 Mon Sep 17 00:00:00 2001 From: kwwall Date: Sun, 7 Jun 2020 13:27:52 -0400 Subject: [PATCH 674/812] Remove references to WAF aliases. Feature not fullyed developed. Issue identifed by LGTM. Checked with Arshan and he confirmed it should be removed. --- configuration/esapi/waf-policy.xsd | Bin 20582 -> 19482 bytes .../AppGuardianConfiguration.java | 10 -------- .../configuration/ConfigurationParser.java | 22 +----------------- 3 files changed, 1 insertion(+), 31 deletions(-) diff --git a/configuration/esapi/waf-policy.xsd b/configuration/esapi/waf-policy.xsd index 4287e792b508ce0b8010b83473965465fca10b2d..1ddc99039e59d5d626245497c0e53a33e74f38f1 100644 GIT binary patch delta 28 kcmaF1fN|Cg#toHBn-!U*94FVyv2A|oUdzG4z{|h|0GodZ(EtDd delta 128 zcmbO=gYnq{#toHBoQVuM44Djx48@Z_u#57-c?_vQkpzd}&HhX-j!26B$<1bmDw_O( yMU)+;Sx?M)vOaGTOm33A_~iA@Rg+mw%_iR#u>jH)lPk^kP5v*=v3a(0H3tBCASYA+ diff --git a/src/main/java/org/owasp/esapi/waf/configuration/AppGuardianConfiguration.java b/src/main/java/org/owasp/esapi/waf/configuration/AppGuardianConfiguration.java index 36f5239fe..53e6c3404 100644 --- a/src/main/java/org/owasp/esapi/waf/configuration/AppGuardianConfiguration.java +++ b/src/main/java/org/owasp/esapi/waf/configuration/AppGuardianConfiguration.java @@ -77,11 +77,6 @@ public class AppGuardianConfiguration { public static final String JAVASCRIPT_TARGET_TOKEN = "##1##"; public static final String JAVASCRIPT_REDIRECT = ""; - /* - * The aliases declared in the beginning of the config file. - */ - private HashMap aliases; - /* * Fail response settings. */ @@ -114,8 +109,6 @@ public AppGuardianConfiguration() { afterBodyRules = new ArrayList(); beforeResponseRules = new ArrayList(); cookieRules = new ArrayList(); - - aliases = new HashMap(); } /* @@ -160,9 +153,6 @@ public void setDefaultResponseCode(int defaultResponseCode) { this.defaultResponseCode = defaultResponseCode; } - public void addAlias(String key, Object obj) { - aliases.put(key, obj); - } public List getBeforeBodyRules() { return beforeBodyRules; diff --git a/src/main/java/org/owasp/esapi/waf/configuration/ConfigurationParser.java b/src/main/java/org/owasp/esapi/waf/configuration/ConfigurationParser.java index 4531ed058..cc429d182 100644 --- a/src/main/java/org/owasp/esapi/waf/configuration/ConfigurationParser.java +++ b/src/main/java/org/owasp/esapi/waf/configuration/ConfigurationParser.java @@ -94,7 +94,6 @@ public static AppGuardianConfiguration readConfigurationFile(InputStream stream, doc = parser.build(stream); root = doc.getRootElement(); - Element aliasesRoot = root.getFirstChildElement("aliases"); Element settingsRoot = root.getFirstChildElement("settings"); Element authNRoot = root.getFirstChildElement("authentication-rules"); Element authZRoot = root.getFirstChildElement("authorization-rules"); @@ -106,30 +105,11 @@ public static AppGuardianConfiguration readConfigurationFile(InputStream stream, Element beanShellRoot = root.getFirstChildElement("bean-shell-rules"); - /** - * Parse the 'aliases' section. - */ - if ( aliasesRoot != null ) { - Elements aliases = aliasesRoot.getChildElements("alias"); - - for(int i=0;i section is required"); + throw new ConfigurationException("", "The section is required"); } else if ( settingsRoot != null ) { From 9fb1ff81b9ced9108e64ec79661d958d28dd293a Mon Sep 17 00:00:00 2001 From: kwwall Date: Sun, 7 Jun 2020 16:53:10 -0400 Subject: [PATCH 675/812] Address LGTM alerts about failure to use 'secure' cookies. --- .../esapi/filters/SecurityWrapperRequest.java | 92 +++++++++---------- 1 file changed, 42 insertions(+), 50 deletions(-) diff --git a/src/main/java/org/owasp/esapi/filters/SecurityWrapperRequest.java b/src/main/java/org/owasp/esapi/filters/SecurityWrapperRequest.java index 910733d99..939f572b6 100644 --- a/src/main/java/org/owasp/esapi/filters/SecurityWrapperRequest.java +++ b/src/main/java/org/owasp/esapi/filters/SecurityWrapperRequest.java @@ -64,11 +64,11 @@ public class SecurityWrapperRequest extends HttpServletRequestWrapper implements * @param request The {@code HttpServletRequest} we are wrapping. */ public SecurityWrapperRequest(HttpServletRequest request) { - super( request ); + super( request ); } private HttpServletRequest getHttpServletRequest() { - return (HttpServletRequest)super.getRequest(); + return (HttpServletRequest)super.getRequest(); } /** @@ -128,8 +128,8 @@ public String getContentType() { public String getContextPath() { String path = getHttpServletRequest().getContextPath(); SecurityConfiguration sc = ESAPI.securityConfiguration(); - //Return empty String for the ROOT context - if (path == null || "".equals(path.trim())) return ""; + //Return empty String for the ROOT context + if (path == null || "".equals(path.trim())) return ""; String clean = ""; try { @@ -159,7 +159,7 @@ public Cookie[] getCookies() { int maxAge = c.getMaxAge(); String domain = c.getDomain(); String path = c.getPath(); - + Cookie n = new Cookie(name, value); n.setMaxAge(maxAge); @@ -347,7 +347,7 @@ public String getParameter(String name) { * @return The "scrubbed" parameter value. */ public String getParameter(String name, boolean allowNull) { - SecurityConfiguration sc = ESAPI.securityConfiguration(); + SecurityConfiguration sc = ESAPI.securityConfiguration(); return getParameter(name, allowNull, sc.getIntProp("HttpUtilities.httpQueryParamValueLength"), "HTTPParameterValue"); } @@ -423,7 +423,7 @@ public Enumeration getParameterNames() { Enumeration en = getHttpServletRequest().getParameterNames(); while (en.hasMoreElements()) { try { - SecurityConfiguration sc = ESAPI.securityConfiguration(); + SecurityConfiguration sc = ESAPI.securityConfiguration(); String name = (String) en.nextElement(); String clean = ESAPI.validator().getValidInput("HTTP parameter name: " + name, name, "HTTPParameterName", sc.getIntProp("HttpUtilities.httpQueryParamNameLength"), true); v.add(clean); @@ -446,8 +446,8 @@ public String[] getParameterValues(String name) { String[] values = getHttpServletRequest().getParameterValues(name); List newValues; - if(values == null) - return null; + if(values == null) + return null; newValues = new ArrayList(); SecurityConfiguration sc = ESAPI.securityConfiguration(); for (String value : values) { @@ -469,7 +469,7 @@ public String[] getParameterValues(String name) { */ public String getPathInfo() { String path = getHttpServletRequest().getPathInfo(); - if (path == null) return null; + if (path == null) return null; String clean = ""; SecurityConfiguration sc = ESAPI.securityConfiguration(); try { @@ -681,15 +681,15 @@ public String getServerName() { * HttpServletRequest after parsing and checking the range 0-65536. * @return The local server port */ - public int getServerPort() { - int port = getHttpServletRequest().getServerPort(); - if ( port < 0 || port > 0xFFFF ) { - logger.warning( Logger.SECURITY_FAILURE, "HTTP server port out of range: " + port ); - port = 0; - } - return port; - } - + public int getServerPort() { + int port = getHttpServletRequest().getServerPort(); + if ( port < 0 || port > 0xFFFF ) { + logger.warning( Logger.SECURITY_FAILURE, "HTTP server port out of range: " + port ); + port = 0; + } + return port; + } + /** * Returns the server path from the HttpServletRequest after canonicalizing @@ -710,52 +710,44 @@ public String getServletPath() { /** * Returns a session, creating it if necessary, and sets the HttpOnly flag - * on the Session ID cookie. + * on the Session ID cookie. The 'secure' flag is also set if the property + * {@Code HttpUtilities.ForceSecureCookies} is set to {@Code true} in the ESAPI.properties file. * @return The current session */ public HttpSession getSession() { - HttpSession session = getHttpServletRequest().getSession(); - - // send a new cookie header with HttpOnly on first and second responses - if (ESAPI.securityConfiguration().getBooleanProp("HttpUtilities.ForceHttpOnlySession")) { - if (session.getAttribute("HTTP_ONLY") == null) { - session.setAttribute("HTTP_ONLY", "set"); - Cookie cookie = new Cookie(ESAPI.securityConfiguration().getStringProp("HttpUtilities.HttpSessionIdName"), session.getId()); - cookie.setPath( getHttpServletRequest().getContextPath() ); - cookie.setMaxAge(-1); // session cookie - HttpServletResponse response = ESAPI.currentResponse(); - if (response != null) { - ESAPI.currentResponse().addCookie(cookie); - } - } - } - return session; + return getSession(true); } /** - * Returns a session, creating it if necessary, and sets the HttpOnly flag - * on the Session ID cookie. - * @param create Create a new session if one doesn't exist + * Returns the current session associated with this request or, if there is no current session and + * {@Code create} is {@Code true}, returns a new session and sets the HttpOnly flag on the session ID cookie. + * The 'secure' flag is also set if the property {@Code HttpUtilities.ForceSecureCookies} is set to + * {@Code true} in the ESAPI.properties file. + * @param create If set to {@Code true}, create a new session if one doesn't exist, otherwise return {@Code null} * @return The current session */ public HttpSession getSession(boolean create) { HttpSession session = getHttpServletRequest().getSession(create); + if (session == null) { return null; } + SecurityConfiguration sc = ESAPI.securityConfiguration(); + // send a new cookie header with HttpOnly on first and second responses - if (ESAPI.securityConfiguration().getBooleanProp("HttpUtilities.ForceHttpOnlySession")) { - if (session.getAttribute("HTTP_ONLY") == null) { - session.setAttribute("HTTP_ONLY", "set"); - Cookie cookie = new Cookie(ESAPI.securityConfiguration().getStringProp("HttpUtilities.HttpSessionIdName"), session.getId()); - cookie.setMaxAge(-1); // session cookie - cookie.setPath( getHttpServletRequest().getContextPath() ); - HttpServletResponse response = ESAPI.currentResponse(); - if (response != null) { - ESAPI.currentResponse().addCookie(cookie); - } - } + if ( sc.getBooleanProp("HttpUtilities.ForceHttpOnlySession") ) { + if (session.getAttribute("HTTP_ONLY") == null) { + session.setAttribute("HTTP_ONLY", "set"); + Cookie cookie = new Cookie( sc.getStringProp("HttpUtilities.HttpSessionIdName"), session.getId() ); + cookie.setMaxAge(-1); // session cookie + cookie.setPath( getHttpServletRequest().getContextPath() ); + cookie.setSecure( sc.getBooleanProp("HttpUtilities.ForceSecureCookies") ); + HttpServletResponse response = ESAPI.currentResponse(); + if (response != null) { + ESAPI.currentResponse().addCookie(cookie); + } + } } return session; } From e700d20f5d3b3bdb7f4323b3174ca64468385c23 Mon Sep 17 00:00:00 2001 From: kwwall Date: Sun, 7 Jun 2020 20:31:38 -0400 Subject: [PATCH 676/812] Reorganized one of the tests and added some new test cases. --- .../owasp/esapi/crypto/CryptoTokenTest.java | 36 +++++++++++-------- 1 file changed, 22 insertions(+), 14 deletions(-) diff --git a/src/test/java/org/owasp/esapi/crypto/CryptoTokenTest.java b/src/test/java/org/owasp/esapi/crypto/CryptoTokenTest.java index 0d2b8a519..52c60c6ee 100644 --- a/src/test/java/org/owasp/esapi/crypto/CryptoTokenTest.java +++ b/src/test/java/org/owasp/esapi/crypto/CryptoTokenTest.java @@ -288,34 +288,42 @@ public final void testSetAndGetAttribute() { // where attribute values contains each of the values that will // be quoted, namely: '\', '=', and ';' try { + String[] attrValues = { "\\", ";", "=", "foo=", "bar\\=", "foobar=\"" }; String complexValue = "kwwall;1291183520293;abc=x=yx;xyz=;efg=a;a;;bbb=quotes\\tuff"; - - ctok.setAttribute("..--__", ""); // Ugly, but legal attr name; empty is legal value. - ctok.setAttribute("attr1", "\\"); - ctok.setAttribute("attr2", ";"); - ctok.setAttribute("attr3", "="); + ctok.setAttribute("complexAttr", complexValue); + ctok.setAttribute("..--__", ""); // Ugly weird but legal attr name; empty is legal value. + + for ( int i = 0; i < attrValues.length; i++ ) { + String attrName = "attr" + i; + String attrVal = attrValues[i]; + + ctok.setAttribute( attrName, attrVal ); + } + String tokenVal = ctok.getToken(); assertNotNull("tokenVal should not be null", tokenVal); CryptoToken ctok2 = new CryptoToken(tokenVal); + String weirdAttr = ctok2.getAttribute("..--__"); assertTrue("Expecting empty string for value of weird attr, but got: " + weirdAttr, weirdAttr.equals("")); - String attr1 = ctok2.getAttribute("attr1"); - assertTrue("attr1 has unexpected value of " + attr1, attr1.equals("\\") ); - - String attr2 = ctok2.getAttribute("attr2"); - assertTrue("attr2 has unexpected value of " + attr2, attr2.equals(";") ); - - String attr3 = ctok2.getAttribute("attr3"); - assertTrue("attr3 has unexpected value of " + attr3, attr3.equals("=") ); - String complexAttr = ctok2.getAttribute("complexAttr"); assertNotNull(complexAttr); assertTrue("complexAttr has unexpected value of " + complexAttr, complexAttr.equals(complexValue) ); + for ( int i = 0; i < attrValues.length; i++ ) { + String attrName = "attr" + i; + String attrVal = attrValues[i]; + String retrieved = ctok2.getAttribute( attrName ); + String assertMsg = "Exptected attribute '" + attrName + "' to have value of '" + attrVal + "', but had value of '" + retrieved; + + assertTrue( assertMsg, attrVal.equals( attrVal ) ); + ctok.setAttribute( attrName, attrVal ); + } + } catch (ValidationException e) { fail("Caught unexpected ValidationException: " + e); } catch (Exception e) { From e1b634e81606b1a2c7cd60b1251af13ee1831511 Mon Sep 17 00:00:00 2001 From: kwwall Date: Sun, 21 Jun 2020 17:08:52 -0400 Subject: [PATCH 677/812] Add registered trademark to first 'OWASP' referene. --- README.md | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 68037a5d2..155838fae 100644 --- a/README.md +++ b/README.md @@ -9,7 +9,7 @@ Enterprise Security API for Java (Legacy)
    -OWASP ESAPI (The OWASP Enterprise Security API) is a free, open source, web application security control library that makes it easier for programmers to write lower-risk applications. The ESAPI for Java library is designed to make it easier for programmers to retrofit security into existing applications. ESAPI for Java also serves as a solid foundation for new development. +OWASP® ESAPI (The OWASP Enterprise Security API) is a free, open source, web application security control library that makes it easier for programmers to write lower-risk applications. The ESAPI for Java library is designed to make it easier for programmers to retrofit security into existing applications. ESAPI for Java also serves as a solid foundation for new development.
    @@ -85,3 +85,6 @@ Old archives for the old Mailman mailing lists for ESAPI-Users and ESAPI-Dev are For a general overview of Google Groups and its web interface, see https://groups.google.com/forum/#!overview For assistance subscribing and unsubscribing to Google Groups, see https://webapps.stackexchange.com/questions/13508/how-can-i-subscribe-to-a-google-mailing-list-with-a-non-google-e-mail-address/15593#15593 + +---------- +OWASP is a registered trademark of The OWASP Foundation. From 8eb9d0fa5528aadbdf474908f18cb4b27ee70df4 Mon Sep 17 00:00:00 2001 From: kwwall Date: Sun, 21 Jun 2020 17:10:55 -0400 Subject: [PATCH 678/812] Update Jaavdoc. --- src/main/java/org/owasp/esapi/ESAPI.java | 2 ++ 1 file changed, 2 insertions(+) diff --git a/src/main/java/org/owasp/esapi/ESAPI.java b/src/main/java/org/owasp/esapi/ESAPI.java index 33eca3fcc..e11239c75 100644 --- a/src/main/java/org/owasp/esapi/ESAPI.java +++ b/src/main/java/org/owasp/esapi/ESAPI.java @@ -93,6 +93,8 @@ public static Authenticator authenticator() { } /** + * The ESAPI Encoder is primarilly used to provide output encoding to + * prevent Cross-Site Scripting (XSS). * @return the current ESAPI Encoder object being used to encode and decode data for this application. */ public static Encoder encoder() { From 56b4aa68c6dafa6b85f6d187756bad1f4da75074 Mon Sep 17 00:00:00 2001 From: kwwall Date: Sun, 21 Jun 2020 17:11:18 -0400 Subject: [PATCH 679/812] Update Javadoc. --- src/main/java/org/owasp/esapi/Encoder.java | 106 +++++++++++++++++---- 1 file changed, 90 insertions(+), 16 deletions(-) diff --git a/src/main/java/org/owasp/esapi/Encoder.java b/src/main/java/org/owasp/esapi/Encoder.java index ca82238be..b89c85e82 100644 --- a/src/main/java/org/owasp/esapi/Encoder.java +++ b/src/main/java/org/owasp/esapi/Encoder.java @@ -23,28 +23,102 @@ /** - * The Encoder interface contains a number of methods for decoding input and encoding output - * so that it will be safe for a variety of interpreters. To prevent - * double-encoding, callers should make sure input does not already contain encoded characters - * by calling canonicalize. Validator implementations should call canonicalize on user input - * before validating to prevent encoded attacks. + * The {@code Encoder} interface contains a number of methods for decoding input and encoding output + * so that it will be safe for a variety of interpreters. Its primary use is to + * provide output encoding to prevent XSS. *

    - * All of the methods must use a "whitelist" or "positive" security model. - * For the encoding methods, this means that all characters should be encoded, except for a specific list of - * "immune" characters that are known to be safe. - *

    - * The Encoder performs two key functions, encoding and decoding. These functions rely + * To prevent double-encoding, callers should make sure input does not already contain encoded characters + * by calling one of the {@code canonicalize()} methods. Validator implementations should call + * {@code canonicalize()} on user input before validating to prevent encoded attacks. + *

    + * All of the methods must use an "allow list" or "positive" security model rather + * than a "deny list" or "negative" security model. For the encoding methods, this means that + * all characters should be encoded, except for a specific list of "immune" characters that are + * known to be safe. + *

    + * The {@code Encoder} performs two key functions, encoding and decoding. These functions rely * on a set of codecs that can be found in the org.owasp.esapi.codecs package. These include: - *

    • CSS Escaping
      • + *
        + *
      • CSS Escaping
        • *
      • HTMLEntity Encoding
        • *
      • JavaScript Escaping
        • - *
      • MySQL Escaping
        • - *
      • Oracle Escaping
        • + *
      • MySQL Database Escaping
        • + *
      • Oracle Database Escaping
        • *
      • Percent Encoding (aka URL Encoding)
        • - *
      • Unix Escaping
        • + *
      • Unix Shell Escaping
        • *
      • VBScript Escaping
        • - *
      • Windows Encoding
      - *

      + *

    • Windows Cmd Escaping
      • + *
    • LDAP Escaping
      • + *
    • XML and XML Attribute Encoding
      • + *
    • XPath Escaping
      • + *
    • Base64 Encoding
      • + *
    + *

    + * Note that in addition to these encoder methods, ESAPI also provides a JSP Tag + * Library ({@code META-INF/esapi.tld}) in the ESAPI jar. This allows one to use + * the more convenient JSP tags in JSPs. These * tags are simply wrappers for the + * various "encodeForXXYZ()" methods. + *

    + * Some important final words: + *

      + *
    • Where to output encode: + * Knowing where to place the output encoding in your code + * is just as important as knowing which context (HTML, HTML attribute, CSS, + * JavaScript, or URL) to use for the output encoding and surprisingly the two + * are often related. In general, output encoding should be done just prior to the + * output being rendered because that is what determines what the appropriate + * context is for the output encoding. In fact, doing output encoding on + * untrusted data that is stored and to be used later--whether stored in an HTTP + * session or in a database--is almost always considered an anti-pattern. An + * example of this is one gathers and stores some untrusted data item such as an + * email address from a user. A developer thinks "let's output encode this and + * store the encoded data in the database, thus making the untrusted data safe + * to use, thus saving us all the encoding troubles later on". On the surface, + * that sounds like a reasonable approach. The problem is how to know what + * output encoding to use, not only for now, but for all possible future + * uses? It might be that the current application code base is only using it in + * an HTML contexxt that is displayed in an HTML report or shown in an HTML + * context in the user's profile. But what it it is later used in a mailto: URL? + * Then instead of HTML encoding, it would need to have URL encoding. Similarly, + * what if there is a later switch made to use AJAX and the untrusted email + * address gets used in a JavaScript context? The complication is that even if + * you know with certainty today all the ways that an untrusted data item is + * used in your application, it is genrally impossible to predict all the + * contexts that it may be used in the future, not only in your application, but + * in other applications that could access that data in the database. + *
      • + *
    • Avoiding multiple nested contexts: + * A really tricky situation to get correct is hen there are multiple nested + * encoding contexts. But far, the most common place this seems to come up is + * untrusted URLs used in JavaScript. How should you handle that? Well, to be + * honest, the best way is to rewrite your code to avoid it. An example of + * this that is well worth reading may be found at + * ESAPI-DEV mailing list archives: + * URL encoding within JavaScript. Be sure to read the entire thread. + * The question itself is too nuanced to be answered in Javadoc, but now, + * hopefully you are at least aware of the potential pitfalls. + *
      • + *
    * * @author Jeff Williams (jeff.williams .at. aspectsecurity.com) Aspect Security From eae125386565b5b89ed4c11565eac041a4b50f57 Mon Sep 17 00:00:00 2001 From: kwwall Date: Sun, 21 Jun 2020 17:12:08 -0400 Subject: [PATCH 680/812] Change cookie path from "//" to "/". --- .../java/org/owasp/esapi/reference/DefaultHTTPUtilities.java | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/main/java/org/owasp/esapi/reference/DefaultHTTPUtilities.java b/src/main/java/org/owasp/esapi/reference/DefaultHTTPUtilities.java index 149937579..f690e26bd 100644 --- a/src/main/java/org/owasp/esapi/reference/DefaultHTTPUtilities.java +++ b/src/main/java/org/owasp/esapi/reference/DefaultHTTPUtilities.java @@ -715,7 +715,7 @@ public void killAllCookies(HttpServletRequest request, HttpServletResponse respo * @param name */ public void killCookie(HttpServletRequest request, HttpServletResponse response, String name) { - String path = "//"; + String path = "/"; String domain=""; Cookie cookie = getFirstCookie(request, name); if ( cookie != null ) { From 195f07c6553e9c62ea520468c3c34faf2a4aaccd Mon Sep 17 00:00:00 2001 From: kwwall Date: Fri, 26 Jun 2020 20:40:09 -0400 Subject: [PATCH 681/812] Minor typo fix; add Inc. --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 155838fae..01095ed7d 100644 --- a/README.md +++ b/README.md @@ -87,4 +87,4 @@ For a general overview of Google Groups and its web interface, see https://group For assistance subscribing and unsubscribing to Google Groups, see https://webapps.stackexchange.com/questions/13508/how-can-i-subscribe-to-a-google-mailing-list-with-a-non-google-e-mail-address/15593#15593 ---------- -OWASP is a registered trademark of The OWASP Foundation. +OWASP is a registered trademark of the OWASP Foundation, Inc. From 980cce5b2e20770088c7a68641a95706864e32d5 Mon Sep 17 00:00:00 2001 From: kwwall Date: Fri, 26 Jun 2020 20:47:26 -0400 Subject: [PATCH 682/812] Update pom.xml to use latest versions of AntiSamy, slf4j, & batik-css. Antisamy: 1.5.8 -> 1.5.10 slf4j: 1.7.26 -> 1.7.30 batik: 1.11 -> 1.13 (addresses CVE-2019-17566) --- pom.xml | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/pom.xml b/pom.xml index 132075ffd..a57922307 100644 --- a/pom.xml +++ b/pom.xml @@ -228,7 +228,7 @@ org.owasp.antisamy antisamy - 1.5.8 + 1.5.10 xml-apis @@ -243,7 +243,7 @@ org.slf4j slf4j-api - 1.7.26 + 1.7.30 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + From ecf4a202c46c910b3b98559fd635b44b683dfa7a Mon Sep 17 00:00:00 2001 From: kwwall Date: Thu, 2 Jul 2020 16:30:30 -0400 Subject: [PATCH 691/812] Update wiki link to new OWASP URL --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 01095ed7d..baddc52bb 100644 --- a/README.md +++ b/README.md @@ -61,7 +61,7 @@ More detail is available in the file '[SECURITY.md](https://raw.githubuserconten ## Where to Find More Information on ESAPI -*Wiki:* https://www.owasp.org/index.php/Category:OWASP_Enterprise_Security_API +*Wiki:* https://owasp.org/www-project-enterprise-security-api/ *Nightly Build:* Travis CI - https://travis-ci.org/bkimminich/esapi-java-legacy From 7abf4a5cfe296a04003ca5222cfb5a53f3bca935 Mon Sep 17 00:00:00 2001 From: kwwall Date: Fri, 3 Jul 2020 00:20:56 -0400 Subject: [PATCH 692/812] Fix typo. s/parse/parser/ --- src/main/java/org/owasp/esapi/Encoder.java | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/main/java/org/owasp/esapi/Encoder.java b/src/main/java/org/owasp/esapi/Encoder.java index 48b1e9cf4..b9d42dea5 100644 --- a/src/main/java/org/owasp/esapi/Encoder.java +++ b/src/main/java/org/owasp/esapi/Encoder.java @@ -468,7 +468,7 @@ public interface Encoder { *

    * The use of a real XML parser is strongly encouraged. However, in the * hopefully rare case that you need to make sure that data is safe for - * inclusion in an XML document and cannot use a parse, this method provides + * inclusion in an XML document and cannot use a parser, this method provides * a safe mechanism to do so. * * @see Character Encoding in Entities From 807adf71fa3c1efd7a3b09a7a190b87c4c18f228 Mon Sep 17 00:00:00 2001 From: davewichers Date: Fri, 3 Jul 2020 16:35:08 -0400 Subject: [PATCH 693/812] Upgrade some dependencies and most plugins. Add FindSecBugs plugin to SpotBugs. Add animal sniffer plugin to try to detect use of Java APIs not in Java 7. Plugin runs but doesn't detect use of APIs currently causing compilation errors with Java 7. --- pom.xml | 204 ++++++++++++++++++++++++++++++++------------------------ 1 file changed, 118 insertions(+), 86 deletions(-) diff --git a/pom.xml b/pom.xml index a9dcd8a5e..3235520cd 100644 --- a/pom.xml +++ b/pom.xml @@ -49,7 +49,7 @@ The Open Web Application Security Project (OWASP) - http://www.owasp.org/index.php + https://owasp.org @@ -90,7 +90,7 @@ Jeff Williams - Aspect Security + Contrast Security Project Inventor @@ -121,7 +121,6 @@ Dave Wichers - Aspect Security Jim Manico @@ -133,12 +132,17 @@ UTF-8 + 1.23 + 2.0.7 + 4.0.4 + 3.0.0-M5 javax.servlet javax.servlet-api + 3.0.1 provided @@ -253,6 +257,7 @@ commons-io commons-io + 2.6 @@ -292,24 +297,38 @@ 1.4.01 + + + com.github.spotbugs + spotbugs-annotations + ${version.spotbugs} + true + + + net.jcip + jcip-annotations + 1.0 + true + + junit junit - 4.12 + 4.13 test org.bouncycastle bcprov-jdk15on - 1.61 + 1.65.01 test org.powermock powermock-api-mockito2 - 2.0.2 + ${version.powermock} test @@ -319,31 +338,13 @@ org.javassist javassist - - - org.mockito - mockito-core - - - org.powermock - powermock-reflect - - - net.bytebuddy - byte-buddy - - - net.bytebuddy - byte-buddy-agent - - + org.javassist javassist 3.25.0-GA @@ -352,19 +353,26 @@ org.mockito mockito-core - 2.27.0 + + 2.28.2 test org.powermock powermock-module-junit4 - 2.0.2 + ${version.powermock} test + + + junit + junit + + org.powermock powermock-reflect - 2.0.2 + ${version.powermock} test @@ -384,13 +392,13 @@ org.openjdk.jmh jmh-core - 1.21 + ${version.jmh} test org.openjdk.jmh jmh-generator-annprocess - 1.21 + ${version.jmh} test @@ -401,51 +409,22 @@ org.apache.maven.plugins maven-assembly-plugin - 3.1.1 + 3.3.0 org.apache.maven.plugins maven-dependency-plugin - 3.1.1 + 3.1.2 org.apache.maven.plugins maven-release-plugin - 2.5.3 + 3.0.0-M1 - - - com.github.spotbugs - spotbugs-maven-plugin - 3.1.11 - - - - com.github.spotbugs - spotbugs - 3.1.12 - - - - - - ${PhaseIfJava8plus} - - - - true - true - true - Low - Max - false - - - + net.sourceforge.maven-taglib maven-taglib-plugin @@ -467,7 +446,7 @@ org.apache.maven.plugins maven-compiler-plugin - 3.8.0 + 3.8.1 1.7 1.7 @@ -501,7 +480,7 @@ org.apache.maven.plugins maven-deploy-plugin - 2.8.2 + 3.0.0-M1 @@ -516,33 +495,60 @@ org.apache.maven.plugins maven-enforcer-plugin - 3.0.0-M2 + 3.0.0-M3 org.codehaus.mojo extra-enforcer-rules 1.2 + + org.codehaus.mojo + animal-sniffer-enforcer-rule + + 1.17 + - - enforce - + check-java-versions + compile + enforce 1.7 - + ESAPI 2.x now uses the JDK1.7 for its baseline. Please make sure that your JAVA_HOME environment variable is pointed to a JDK1.7 or later distribution. - + 1.7 + true + + Dependencies shouldn't require Java 8+ + true + + + + check-java7API-signatures + compile + enforce + + + + + org.codehaus.mojo.signature + + java17 + 1.0 + + + @@ -564,13 +570,13 @@ org.apache.maven.plugins maven-install-plugin - 2.5.2 + 3.0.0-M1 org.apache.maven.plugins maven-jar-plugin - 3.1.0 + 3.2.0 @@ -584,7 +590,7 @@ org.apache.maven.plugins maven-javadoc-plugin - 3.1.0 + 3.2.0 7 none @@ -608,13 +614,13 @@ org.apache.maven.plugins maven-pmd-plugin - 3.11.0 + 3.13.0 org.apache.maven.plugins maven-project-info-reports-plugin - 3.0.0 + 3.1.0 @@ -626,13 +632,13 @@ org.apache.maven.plugins maven-site-plugin - 3.7.1 + 3.9.1 org.apache.maven.plugins maven-source-plugin - 3.0.1 + 3.2.1 attach-sources @@ -644,14 +650,14 @@ org.apache.maven.plugins - maven-surefire-report-plugin - 2.22.1 + maven-surefire-plugin + ${version.surefire} org.apache.maven.plugins - maven-surefire-plugin - 2.22.1 + maven-surefire-report-plugin + ${version.surefire} @@ -687,7 +693,7 @@ org.owasp dependency-check-maven - 5.0.0 + 5.3.2 5.0 ./suppressions.xml @@ -767,11 +773,11 @@ org.apache.maven.plugins - maven-surefire-report-plugin + maven-surefire-plugin org.apache.maven.plugins - maven-surefire-plugin + maven-surefire-report-plugin + org.codehaus.mojo versions-maven-plugin @@ -799,12 +805,38 @@ + Java8plus [1.8,) site + + + + + + + com.github.spotbugs + spotbugs-maven-plugin + ${version.spotbugs} + + + + com.h3xstream.findsecbugs + findsecbugs-plugin + 1.10.1 + + + Max + false + + + + + From cceffa6aab0887e379be1c7117d2e620b36cfdee Mon Sep 17 00:00:00 2001 From: davewichers Date: Fri, 3 Jul 2020 17:56:33 -0400 Subject: [PATCH 694/812] Fix 1 link to the OWASP web site in pom. --- pom.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pom.xml b/pom.xml index 3235520cd..8623ac2e6 100644 --- a/pom.xml +++ b/pom.xml @@ -37,7 +37,7 @@ ESAPI - https://www.owasp.org/index.php/Category:OWASP_Enterprise_Security_API + https://owasp.org/www-project-enterprise-security-api/ The Enterprise Security API (ESAPI) project is an OWASP project to create simple strong security controls for every web platform. Security controls are not simple to build. You can read about the From f94ca94e15237c0f0887913d5d33c697fb97594a Mon Sep 17 00:00:00 2001 From: "Kevin W. Wall" Date: Fri, 3 Jul 2020 18:48:59 -0400 Subject: [PATCH 695/812] Fix for GitHub Issue 552 (#553) * Fix #552 * Undesired commit, but 'git checkout -- documentation/esapi4java-core-2.2.1.0-release-notes.txt' has no effect. Sigh. * Updated from 'misc-cleanup' branch. --- .../esapi4java-core-2.2.1.0-release-notes.txt | 248 ++++++++++-------- .../logging/appender/ClientInfoSupplier.java | 8 +- .../appender/EventTypeLogSupplier.java | 8 +- .../logging/appender/ServerInfoSupplier.java | 8 +- .../logging/appender/UserInfoSupplier.java | 8 +- 5 files changed, 153 insertions(+), 127 deletions(-) diff --git a/documentation/esapi4java-core-2.2.1.0-release-notes.txt b/documentation/esapi4java-core-2.2.1.0-release-notes.txt index bb46556b8..46f8bab9d 100644 --- a/documentation/esapi4java-core-2.2.1.0-release-notes.txt +++ b/documentation/esapi4java-core-2.2.1.0-release-notes.txt @@ -1,115 +1,133 @@ -Release notes for ESAPI 2.2.1.0 - Release date: 2020-TBD - Project leaders: - -Kevin W. Wall - -Matt Seil - -Previous release: ESAPI 2.2.0.0, 2019-June-24 - - -Executive Summary: Important Things to Note for this Release ------------------------------------------------------------- - - TBD - -================================================================================================================= - -Basic ESAPI facts - -ESAPI 2.2.0.0 release: - 194 Java source files - 4150 JUnit tests in 118 Java source files - -ESAPI 2.2.1.0 release: - TBD - -GitHub Issues fixed in this release - -Issue # GitHub Issue Title ----------------------------------------------------------------------------------------------- - -143 Enchance encodeForOS to auto-detect the underling OS -226 Javadoc Inaccuracy in getRandomInteger() and getRandomReal() -245 KeyDerivationFunction::computeDerivedKey - possible security level mismatch -256 White space clean up -382 Build Fails on path with space -494 Encoder's encodeForCSS doesn't handle RGB Triplets -503 Bug on on referrer header when value contains `§ion` like `www.asdf.com?a=1§ion=2` -509 HTMLValidationRule.getValid(String,String) does not follow documented specifications -511 Add missing documentation to Validator.addRule() and Validator.getRule() -512 Update Apache Commons Bean Utils to 1.9.4 -515 Adding tests for getCookies (also 516) -519 Issue 494 CSSCodec RGB Triplets -530 Log Bridge Tests -536 Various fixes -538 Addressing log4j 1.x CVE-2019-17571 - ------------------------------------------------------------------------------ - - Changes requiring special attention - ------------------------------------------------------------------------------ - -TBD - ------------------------------------------------------------------------------ - - Other changes in this release, some of which not tracked via GitHub issues - ------------------------------------------------------------------------------ - -Documentation updates for locating Jar files -Unneeded code removed from ExtensiveEncoder -Inline reader added to ExtensiveEncoder -Additional time for windows to always sleep more than given seconds in CryptoTokenTest -Change required by tweak to CipherText.toString() method -Removed call to deprecated CryptoHelper.computeDerivedKey() method -New JUnit tests for org.owasp.esapi.crypto.KeyDerivationFunction class -Use existing toString method rather than a StringBuilder -Documentation and tests -JavaLogger move -Splitting user infor from Client Supplier - ------------------------------------------------------------------------------ - -Developer Activity Report (Changes between release 2.2.0.0 and 2.2.1.0, i.e., between 2019-06-25 and 2020-05-12) -Generated manually (this time) - -Developer Total commits Total Number - of Files Changed -===================================================== -jeremiahjstacey 11 68 -kwwall 15 26 -wiitek 3 6 -xeno6696 8 9 -Michael-Ziluck 2 3 -===================================================== - ------------------------------------------------------------------------------ - -53 Closed PRs since 2.2.0.0 release -=================================== -504 New scripts to suppress noise for 'mvn test' -510 Resolve #509 - Properly throw exception when HTML fails -513 Close issue #512 by updating to 1.9.4 of Commons Beans Util.\ -519 Issue 494 CSSCodec RGB Triplets -520 OS Name DefaultExecutorTests #143 -540 Issue 382: Build Fails on path with space -596 Closes Issue 245 - ------------------------------------------------------------------------------ - -Notice: - - Release notes written by Bill Sempf (bill.sempf@owasp.org) please direct any communication to me. - -Project co-leaders - Kevin W. Wall (kwwall) - Matt Seil (xeno6696) - -Special shout-outs to: - Jeremiah Stacey (jeremiahjstacey) -- All around ESAPI support and JUnit test case developer extraordinaire - Dave Wichers (davewichers) - for Maven Central / Sonatype help - -Thanks you all for your time and effort to ESAPI and making it a better project. And if I've missed any, my apologies; let me know and I will correct it. - +Release notes for ESAPI 2.2.1.0 + Release date: 2020-July-?? + Project leaders: + -Kevin W. Wall + -Matt Seil + +Previous release: ESAPI 2.2.0.0, 2019-June-24 + + +Executive Summary: Important Things to Note for this Release +------------------------------------------------------------ + +This is a minor release. It's main purpose was to update dependencies to eliminate potential vulnerabilities arising from dependencies with known CVEs. See the section "Changes requiring special attention" below for additional details. + +Also special props to Bill Sempf for stepping up and volunteering to prepare the initial cut of these release notes. Had he not done so, this release either would not have release notes or it would have been delayed another 6 months while I procrastinated further with various distractions. (Squirrel!) + +================================================================================================================= + +Basic ESAPI facts +----------------- + +ESAPI 2.2.0.0 release: + 194 Java source files + 4150 JUnit tests in 118 Java source files + +ESAPI 2.2.1.0 release: + 211 Java source files + 4309 JUnit tests in 134 Java source files + +GitHub Issues fixed in this release + +Issue # GitHub Issue Title +---------------------------------------------------------------------------------------------- + +143 Enchance encodeForOS to auto-detect the underling OS +226 Javadoc Inaccuracy in getRandomInteger() and getRandomReal() +245 KeyDerivationFunction::computeDerivedKey - possible security level mismatch +256 White space clean up +382 Build Fails on path with space +494 Encoder's encodeForCSS doesn't handle RGB Triplets +503 Bug on on referrer header when value contains `§ion` like `www.asdf.com?a=1§ion=2` +509 HTMLValidationRule.getValid(String,String) does not follow documented specifications +511 Add missing documentation to Validator.addRule() and Validator.getRule() +512 Update Apache Commons Bean Utils to 1.9.4 +515 Adding tests for getCookies (also 516) +519 Issue 494 CSSCodec RGB Triplets +522 javadoc corrections for Encoder.canonicalize() +530 Log Bridge Tests +536 Various fixes +538 Addressing log4j 1.x CVE-2019-17571 +552 Rewrite implementation of some ESAPI classes to remove Java 8 dependencies + +----------------------------------------------------------------------------- + + Changes requiring special attention + +----------------------------------------------------------------------------- +The new default ESAPI logger is JUL (java.util.logging packages) and we have deprecated the use of Log4j 1.x as it is way past the end-of-life and we now support SLF4J. We did not want to make SLF4J the default logger (at least not yet) as we did not want to have the default ESAPI use require additional dependencies. However, SLF4J is likely to be the future choice, at least once we start on EsAPI 3.0. A special shout-out to Jeremiah Stacey for making this possible by re-factoring much of the ESAPI logger code. Note, the straw that broke the proverbial camel's back was the announcement of CVE-2019-17571 (rated Critical), for which there is no fix available and likely will never be. + +Related to that CVE and how it affects ESAPI, be sure to read + https://github.com/ESAPI/esapi-java-legacy/blob/develop/documentation/ESAPI-security-bulletin2.pdf +which describes CVE-2019-17571, a deserialization vulnerability in Log4j 1.2.17. ESAPI is not affected by this (even if you chose to use Log4j 1 as you default ESAPI logger). This security bulletin describes why this CVE is not exploitable as used by ESAPI. + +Notable dependency updates (excludes those only used with JUnit tests): + antiSamy 1.5.8 -> 1.5.10 + batik-css 1.11 -> 1.13 + commons-beansutil 1.9.3 -> 1.9.4 + slf4j-api 1.7.26 -> 1.7.30 + +Finally, while ESAPI still supports JDK 7 (even though that too is way past end-of-life), the next ESAPI release will move to JDK 8 as the minimal baseline. (We already use Java 8 for development but still to Java 7 source and runtime compatiblity.) + +----------------------------------------------------------------------------- + + Other changes in this release, some of which not tracked via GitHub issues + +----------------------------------------------------------------------------- + +Documentation updates for locating Jar files +Unneeded code removed from ExtensiveEncoder +Inline reader added to ExtensiveEncoder +Additional time for windows to always sleep more than given seconds in CryptoTokenTest +Change required by tweak to CipherText.toString() method +Removed call to deprecated CryptoHelper.computeDerivedKey() method +New JUnit tests for org.owasp.esapi.crypto.KeyDerivationFunction class +Use existing toString method rather than a StringBuilder +Documentation and tests +JavaLogger moved +Splitting user info from Client Supplier + +----------------------------------------------------------------------------- + +Developer Activity Report (Changes between release 2.2.0.0 and 2.2.1.0, i.e., between 2019-06-25 and 2020-05-12) +Generated manually (this time) + +Developer Total Total Number +(GitHub ID) commits of Files Changed +===================================================== +jeremiahjstacey 11 68 +kwwall 16 26 +wiitek 3 6 +xeno6696 8 9 +Michael-Ziluck 2 3 +sempf 1 1 +===================================================== + +----------------------------------------------------------------------------- + +53 Closed PRs since 2.2.0.0 release (those rejected not listed) +=============================================================== +504 New scripts to suppress noise for 'mvn test' +510 Resolve #509 - Properly throw exception when HTML fails +513 Close issue #512 by updating to 1.9.4 of Commons Beans Util.\ +519 Issue 494 CSSCodec RGB Triplets +520 OS Name DefaultExecutorTests #143 +540 Issue 382: Build Fails on path with space +596 Closes Issue 245 + +----------------------------------------------------------------------------- + +Notice: + + Release notes written by Bill Sempf (bill.sempf@owasp.org), but please direct any communication to the project leaders. + +Project co-leaders + Kevin W. Wall (kwwall) + Matt Seil (xeno6696) + +Special shout-outs to: + Jeremiah Stacey (jeremiahjstacey) -- All around ESAPI support and JUnit test case developer extraordinaire + Dave Wichers (davewichers) - for pom.xml improvements + Bill Sempf -- for these release notes. Awesome job, Bill. I owe you a brew. + +Thanks you all for your time and effort to ESAPI and making it a better project. And if I've missed any, my apologies; let me know and I will correct it. diff --git a/src/main/java/org/owasp/esapi/logging/appender/ClientInfoSupplier.java b/src/main/java/org/owasp/esapi/logging/appender/ClientInfoSupplier.java index 2ff07a19a..5a8524340 100644 --- a/src/main/java/org/owasp/esapi/logging/appender/ClientInfoSupplier.java +++ b/src/main/java/org/owasp/esapi/logging/appender/ClientInfoSupplier.java @@ -15,7 +15,8 @@ package org.owasp.esapi.logging.appender; -import java.util.function.Supplier; +// Uncomment and use once ESAPI supports Java 8 as the minimal baseline. +// import java.util.function.Supplier; import javax.servlet.http.HttpServletRequest; import javax.servlet.http.HttpSession; @@ -27,7 +28,8 @@ * Supplier which can provide a String representing the client-side connection * information. */ -public class ClientInfoSupplier implements Supplier { +public class ClientInfoSupplier // implements Supplier +{ /** Default Last Host string if the Authenticated user is null.*/ private static final String DEFAULT_LAST_HOST = "#UNKNOWN_HOST#"; /** Session Attribute containing the ESAPI Session id. */ @@ -47,7 +49,7 @@ public class ClientInfoSupplier implements Supplier { /** Whether to log the user info from this instance. */ private boolean logClientInfo = true; - @Override + // @Override -- Uncomment when we switch to Java 8 as minimal baseline. public String get() { String clientInfo = ""; diff --git a/src/main/java/org/owasp/esapi/logging/appender/EventTypeLogSupplier.java b/src/main/java/org/owasp/esapi/logging/appender/EventTypeLogSupplier.java index 2f857f128..4af1bd50b 100644 --- a/src/main/java/org/owasp/esapi/logging/appender/EventTypeLogSupplier.java +++ b/src/main/java/org/owasp/esapi/logging/appender/EventTypeLogSupplier.java @@ -15,7 +15,8 @@ package org.owasp.esapi.logging.appender; -import java.util.function.Supplier; +// Uncomment and use once ESAPI supports Java 8 as the minimal baseline. +// import java.util.function.Supplier; import org.owasp.esapi.Logger; import org.owasp.esapi.Logger.EventType; @@ -25,7 +26,8 @@ * an EventType for logging * */ -public class EventTypeLogSupplier implements Supplier { +public class EventTypeLogSupplier // implements Supplier +{ /** EventType reference to supply log representation of. */ private final EventType eventType; @@ -38,7 +40,7 @@ public EventTypeLogSupplier(EventType evtyp) { this.eventType = evtyp == null ? Logger.EVENT_UNSPECIFIED : evtyp; } - @Override + // @Override -- Uncomment when we switch to Java 8 as minimal baseline. public String get() { return eventType.toString(); } diff --git a/src/main/java/org/owasp/esapi/logging/appender/ServerInfoSupplier.java b/src/main/java/org/owasp/esapi/logging/appender/ServerInfoSupplier.java index ca9b4bbd8..c9e0d8e02 100644 --- a/src/main/java/org/owasp/esapi/logging/appender/ServerInfoSupplier.java +++ b/src/main/java/org/owasp/esapi/logging/appender/ServerInfoSupplier.java @@ -15,7 +15,8 @@ package org.owasp.esapi.logging.appender; -import java.util.function.Supplier; +// Uncomment and use once ESAPI supports Java 8 as the minimal baseline. +// import java.util.function.Supplier; import javax.servlet.http.HttpServletRequest; @@ -25,7 +26,8 @@ * Supplier which can provide a String representing the server-side connection * information. */ -public class ServerInfoSupplier implements Supplier { +public class ServerInfoSupplier // implements Supplier +{ /** Whether to log the server connection info. */ private boolean logServerIP = true; /** Whether to log the application name. */ @@ -45,7 +47,7 @@ public ServerInfoSupplier(String logName) { this.logName = logName; } - @Override + // @Override -- Uncomment when we switch to Java 8 as minimal baseline. public String get() { // log server, port, app name, module name -- server:80/app/module StringBuilder appInfo = new StringBuilder(); diff --git a/src/main/java/org/owasp/esapi/logging/appender/UserInfoSupplier.java b/src/main/java/org/owasp/esapi/logging/appender/UserInfoSupplier.java index e9c34e31a..6065ed366 100644 --- a/src/main/java/org/owasp/esapi/logging/appender/UserInfoSupplier.java +++ b/src/main/java/org/owasp/esapi/logging/appender/UserInfoSupplier.java @@ -15,7 +15,8 @@ package org.owasp.esapi.logging.appender; -import java.util.function.Supplier; +// Uncomment and use once ESAPI supports Java 8 as the minimal baseline. +// import java.util.function.Supplier; import org.owasp.esapi.ESAPI; import org.owasp.esapi.User; @@ -24,14 +25,15 @@ * Supplier which can provide a String representing the client-side connection * information. */ -public class UserInfoSupplier implements Supplier { +public class UserInfoSupplier // implements Supplier +{ /** Default UserName string if the Authenticated user is null.*/ private static final String DEFAULT_USERNAME = "#ANONYMOUS#"; /** Whether to log the user info from this instance. */ private boolean logUserInfo = true; - @Override + // @Override -- Uncomment when we switch to Java 8 as minimal baseline. public String get() { // log user information - username:session@ipaddr User user = ESAPI.authenticator().getCurrentUser(); From e8e613fefb24e263a1676c042261e388f16c4569 Mon Sep 17 00:00:00 2001 From: "Kevin W. Wall" Date: Sun, 12 Jul 2020 21:59:43 -0400 Subject: [PATCH 696/812] Prep 2.2.1.0 (#557) * Delete the release notes that prevents me from doing a 'git pull origin' from my fork. * Add note referring to minimal Java 7 baseline. * Close #542 - final release notes for 2.2.1.0. * Close #556 - Add some final additional 'see also' refs. * Close #554 * Close #555 * Added issue 521 which should have been closed per PR 535. Issue now closed. * Close #558 * Update to reflect fix to issue #558 * Find/fix dependency causing java.lang.OutOfMemoryError: PermGen space that only occurs on Mac with Java 7. Apparently it was the surefire plugin. Co-authored-by: davewichers --- README.md | 4 +- .../esapi4java-core-2.2.1.0-release-notes.txt | 253 ++++++++++++++---- pom.xml | 5 +- src/main/java/org/owasp/esapi/Encoder.java | 3 + .../org/owasp/esapi/crypto/CryptoHelper.java | 10 +- .../owasp/esapi/crypto/CryptoHelperTest.java | 10 +- .../esapi/reference/AccessControllerTest.java | 2 +- .../owasp/esapi/reference/ValidatorTest.java | 8 +- .../esapi/fbac-policies/DataAccessRules.txt | 4 +- 9 files changed, 234 insertions(+), 65 deletions(-) diff --git a/README.md b/README.md index baddc52bb..dc59e7a2a 100644 --- a/README.md +++ b/README.md @@ -17,9 +17,11 @@ OWASP® ESAPI (The OWASP Enterprise Security API) is a free, open source, web ap # What does Legacy mean?

    This is the legacy branch of ESAPI which means it is an actively maintained branch of the project, however feature development for this branch will not be done. Features that have already been scheduled for the 2.x branch will move forward, but the main focus will be working on the ESAPI 3.x branch. -IMPORTANT NOTE: +IMPORTANT NOTES: The default branch for ESAPI legacy is now the 'develop' branch (rather than the 'master' branch), where future development, bug fixes, etc. will now be done. The 'master' branch is now marked as "protected"; it reflects the latest stable ESAPI release (2.1.0.1 as of this date). Note that this change of making the 'develop' branch the default may affect any pull requests that you were intending to make. +Also, the minimal baseline Java version to use ESAPI is Java 7. (This was changed from Java 6 during the 2.2.0.0 release.) + # Where can I find ESAPI 3.x? https://github.com/ESAPI/esapi-java diff --git a/documentation/esapi4java-core-2.2.1.0-release-notes.txt b/documentation/esapi4java-core-2.2.1.0-release-notes.txt index 94da6b95d..ee3caf5ea 100644 --- a/documentation/esapi4java-core-2.2.1.0-release-notes.txt +++ b/documentation/esapi4java-core-2.2.1.0-release-notes.txt @@ -27,40 +27,61 @@ ESAPI 2.2.1.0 release: 211 Java source files 4309 JUnit tests in 134 Java source files -GitHub Issues fixed in this release +39 GitHub Issues closed in this release Issue # GitHub Issue Title ---------------------------------------------------------------------------------------------- -143 Enchance encodeForOS to auto-detect the underling OS -226 Javadoc Inaccuracy in getRandomInteger() and getRandomReal() -245 KeyDerivationFunction::computeDerivedKey - possible security level mismatch -256 White space clean up -382 Build Fails on path with space -494 Encoder's encodeForCSS doesn't handle RGB Triplets -503 Bug on on referrer header when value contains `§ion` like `www.asdf.com?a=1§ion=2` -509 HTMLValidationRule.getValid(String,String) does not follow documented specifications -511 Add missing documentation to Validator.addRule() and Validator.getRule() -512 Update Apache Commons Bean Utils to 1.9.4 -515 Adding tests for getCookies (also 516) -519 Issue 494 CSSCodec RGB Triplets -522 javadoc corrections for Encoder.canonicalize() -530 Log Bridge Tests -536 Various fixes -538 Addressing log4j 1.x CVE-2019-17571 -552 Rewrite implementation of some ESAPI classes to remove Java 8 dependencies - +143 - Enchance encodeForOS to auto-detect the underling OS +173 - DOMConfigurator is being used inappropriately in the ESAPIWebApplicationFirewallFilter +226 - Javadoc Inaccuracy in getRandomInteger() and getRandomReal() +232 - SecurityWrapperResponse.createCookieHeader modification request (closed; marked 'wontfix') +235 - exception is java.lang.NoClassDefFoundError: org.owasp.esapi.codecs.Codec +245 - KeyDerivationFunction::computeDerivedKey - possible security level mismatch +256 - Whitespace in JavaEncryptor +263 - I am getting validation exception while validating a paramter coming from http request +268 - SecurityWrapperResponse setStatus should not always set SC_OK +269 - org.owasp.esapi.reference.DefaultValidator reports ValidationException with IE 9 +271 - Add Constructor to DefaultSecurityConfiguration to accept a properties file (1.4) +276 - Patch for /branches/2.1/src/main/java/org/owasp/esapi/reference/DefaultExecutor.java +310 - Make HTMLValidationRule to look for antisamy-esapi.xml in classpaths enhancement +382 - Build Fails on path with space +465 - Update both ESAPI.properties files to show comment for ESAPI logger support for SLF4J +488 - Missed a legal input case in DefaultSecurityConfiguration.java +494 - Encoder's encodeForCSS doesn't handle RGB Triplets +495 - Maven Install Requires GPG Key +499 - ValidatorTest.isValidDirectoryPath() has tests that fail under Windows if ESAPI tests run from different drive where Windows installed +500 - Suppress noise from ESAPI searching for properties and stop ignoring important IOExceptions +503 - Bug on on referrer header when value contains `§ion` like `www.asdf.com?a=1§ion=2` +509 - HTMLValidationRule.getValid(String,String) does not follow documented specifications +511 - Add missing documentation to Validator.addRule() and Validator.getRule() +512 - Update Apache Commons Bean Utils to 1.9.4 +515 - NullPointerException can result from line 163 of SecurityWrapperRequest.java: +521 - JUnit test ValidatorTest.testIsValidSafeHTML() now failing +522 - javadoc corrections for Encoder.canonicalize() +523 - Links in README to users list and dev list are reversed +527 - Configuration flag for disabling Logger User and App Information +530 - Apply default logging content to SLF4J messages +532 - Update JUL and Log4J code structure and workflow to match SLF4J +536 - SecurityWrapperResponse setHeader error message is unclear +538 - Addressing log4j 1.x CVE-2019-17571 +542 - Write up ESAPI release notes for planned 2.2.1.0 release +552 - Rewrite implementation of some ESAPI classes to remove Java 8 dependencies +554 - CryptoHelper.arrayCompare() fails with NPE under Java 7 when one of the arguments is null +555 - JUnit test org.owasp.esapi.reference.AccessControllerTest.testIsAuthorizedForData fails when run against Java 7 on Linux +556 - Major overhaul to ESAPI Encoder Javadoc based on ESAPI Encoder Usability Study +558 - ValidatorTest.testIsValidDirectoryPath() JUnit test fails under MacOS ----------------------------------------------------------------------------- - Changes requiring special attention + Changes Requiring Special Attention ----------------------------------------------------------------------------- -The new default ESAPI logger is JUL (java.util.logging packages) and we have deprecated the use of Log4j 1.x as it is way past the end-of-life and we now support SLF4J. We did not want to make SLF4J the default logger (at least not yet) as we did not want to have the default ESAPI use require additional dependencies. However, SLF4J is likely to be the future choice, at least once we start on EsAPI 3.0. A special shout-out to Jeremiah Stacey for making this possible by re-factoring much of the ESAPI logger code. Note, the straw that broke the proverbial camel's back was the announcement of CVE-2019-17571 (rated Critical), for which there is no fix available and likely will never be. +The new default ESAPI logger is JUL (java.util.logging packages) and we have deprecated the use of Log4J 1.x because we now support SLF4J and Log4J 1.x is way past its end-of-life. We did not want to make SLF4J the default logger (at least not yet) as we did not want to have the default ESAPI use require additional dependencies. However, SLF4J is likely to be the future choice, at least once we start on EsAPI 3.0. A special shout-out to Jeremiah Stacey for making this possible by re-factoring much of the ESAPI logger code. Note, the straw that broke the proverbial camel's back was the announcement of CVE-2019-17571 (rated Critical), for which there is no fix available and likely will never be. Related to that CVE and how it affects ESAPI, be sure to read https://github.com/ESAPI/esapi-java-legacy/blob/develop/documentation/ESAPI-security-bulletin2.pdf -which describes CVE-2019-17571, a deserialization vulnerability in Log4j 1.2.17. ESAPI is not affected by this (even if you chose to use Log4j 1 as you default ESAPI logger). This security bulletin describes why this CVE is not exploitable as used by ESAPI. +which describes CVE-2019-17571, a deserialization vulnerability in Log4J 1.2.17. ESAPI is not affected by this (even if you chose to use Log4J 1 as you default ESAPI logger). This security bulletin describes why this CVE is not exploitable as used by ESAPI. Notable dependency updates (excludes those only used with JUnit tests): antiSamy 1.5.8 -> 1.5.10 @@ -70,6 +91,32 @@ Notable dependency updates (excludes those only used with JUnit tests): Finally, while ESAPI still supports JDK 7 (even though that too is way past end-of-life), the next ESAPI release will move to JDK 8 as the minimal baseline. (We already use Java 8 for development but still to Java 7 source and runtime compatiblity.) +----------------------------------------------------------------------------- + + Known Issues / Problems + +----------------------------------------------------------------------------- +If you use Java 7 (the minimal Java baseline supported by ESAPI) and try to run 'mvn test' there is one test that fails. This test passes with Java 8. The failing test is: + + [ERROR] Tests run: 5, Failures: 1, Errors: 0, Skipped: 0, Time elapsed: 0.203 s + <<< FAILURE! - in org.owasp.esapi.crypto.SecurityProviderLoaderTest + [ERROR] org.owasp.esapi.crypto.SecurityProviderLoaderTest.testWithBouncyCastle + Time elapsed: 0.116 s <<< FAILURE! + java.lang.AssertionError: Encryption w/ Bouncy Castle failed with + EncryptionException for preferred cipher transformation; exception was: + org.owasp.esapi.errors.EncryptionException: Encryption failure (unavailable + cipher requested) + at + org.owasp.esapi.crypto.SecurityProviderLoaderTest.testWithBouncyCastle(Security + ProviderLoaderTest.java:133) + +I will spare you all the details and tell you that this has to do with Java 7 not being able to correctly parse the signed Bouncy Castle JCE provider jar. More details are available at: + https://www.bouncycastle.org/latest_releases.html +and + https://github.com/bcgit/bc-java/issues/477 +I am sure that there are ways of making Bouncy Castle work with Java 7, but since ESAPI does not rely on Bouncy Castle (it can use any compliant JCE provider), this should not be a problem. (It works fine with the default SunJCE provider.) If it is important to get the BC provider working with the ESAPI Encryptor and Java 7, then open a GitHub issue and we will take a deeper look at it and see if we can suggest something. + + ----------------------------------------------------------------------------- Other changes in this release, some of which not tracked via GitHub issues @@ -77,60 +124,154 @@ Finally, while ESAPI still supports JDK 7 (even though that too is way past end- ----------------------------------------------------------------------------- Documentation updates for locating Jar files -Unneeded code removed from ExtensiveEncoder +Unneeded code removed from ExtensiveEncoderURI test Inline reader added to ExtensiveEncoder Additional time for windows to always sleep more than given seconds in CryptoTokenTest Change required by tweak to CipherText.toString() method Removed call to deprecated CryptoHelper.computeDerivedKey() method New JUnit tests for org.owasp.esapi.crypto.KeyDerivationFunction class -Use existing toString method rather than a StringBuilder -Documentation and tests -JavaLogger moved -Splitting user info from Client Supplier +Miscellaneous documentation and tests +JavaLogger moved to new package +Log4J 1.x no longer ESAPI's default logger ----------------------------------------------------------------------------- -Developer Activity Report (Changes between release 2.2.0.0 and 2.2.1.0, i.e., between 2019-06-25 and 2020-05-12) -Generated manually (this time) +Developer Activity Report (Changes between release 2.2.0.0 and 2.2.1.0, i.e., between 2019-06-25 and 2020-07-11) +Generated manually (this time) -- all errors are the fault of kwwall and his inability to do simple arithmetic. + +Developer Total Total Number # Merged +(GitHub ID) commits of Files Changed PRs +======================================================== +HJW8472 11 8 1 +jeremiahjstacey 78 70 6 +kwwall 65 64 8 +Michael-Ziluck 3 2 2 +sempf 1 1 1 +wiitek 6 4 2 +xeno6696 3 5 1 +======================================================== + Total: 21 -Developer Total Total Number -(GitHub ID) commits of Files Changed -===================================================== -jeremiahjstacey 11 68 -kwwall 16 26 -wiitek 3 6 -xeno6696 8 9 -Michael-Ziluck 2 3 -sempf 1 1 -===================================================== ----------------------------------------------------------------------------- -53 Closed PRs since 2.2.0.0 release (those rejected not listed) -=============================================================== +21 Closed PRs merged since 2.2.0.0 release (those rejected not listed) +====================================================================== +PR# GitHub ID Description +---------------------------------------------------------------------- +504 -- kwwall -- New scripts to suppress noise for 'mvn test' +505 -- kwwall -- Close issue #256. White-space clean up. +506 -- kwwall -- Closes Issue 245 +508 -- Michael-Ziluck -- Resolves #226 - Corrected docs for the bounded, numeric, random methods +510 -- Michael-Ziluck -- Resolve #509 - Properly throw exception when HTML fails +513 -- kwwall -- Close issue #512 by updating to 1.9.4 of Commons Beans Util. +514 -- xeno6696 -- Fixed issues #503 by writing a new addReferer method, also temporaril… +516 -- jeremiahjstacey -- Issue 515 +518 -- jeremiahjstacey -- Issue #511 Copying Docs from DefaultValidator +519 -- jeremiahjstacey -- Issue 494 CSSCodec RGB Triplets +520 -- jeremiahjstacey -- OS Name DefaultExecutorTests #143 +533 -- jeremiahjstacey -- #532 JUL and Log4J match SLF4J class structure and Workflow +535 -- kwwall -- Issue 521 +537 -- jeremiahjstacey -- Issue 536 +539 -- wiiitek -- upgrade for convergence +540 -- wiiitek -- Issue 382: Build Fails on path with space +541 -- HJW8472 -- Fixed issue #310 +543 -- sempf -- Release notes for 2.2.1.0 +551 -- kwwall -- Misc cleanup +553 -- kwwall -- Fix for GitHub Issue 552 +557 -- kwwall -- Final prep for 2.2.1.0 release + + +CHANGELOG: Create your own. May I suggest: + + git log --since=2019-06-25 --reverse --pretty=medium + + which will show all the commits since just after the last (2.2.0.0) release. + +----------------------------------------------------------------------------- -504 New scripts to suppress noise for 'mvn test' -510 Resolve #509 - Properly throw exception when HTML fails -513 Close issue #512 by updating to 1.9.4 of Commons Beans Util.\ -519 Issue 494 CSSCodec RGB Triplets -520 OS Name DefaultExecutorTests #143 -540 Issue 382: Build Fails on path with space -596 Closes Issue 245 +Direct and Transitive Runtime and Test Dependencies: + + $ mvn dependency:tree + [INFO] Scanning for projects... + [INFO] + [INFO] -----------------------< org.owasp.esapi:esapi >------------------------ + [INFO] Building ESAPI 2.2.1.0 + [INFO] --------------------------------[ jar ]--------------------------------- + [INFO] + [INFO] --- maven-dependency-plugin:3.1.2:tree (default-cli) @ esapi --- + [INFO] org.owasp.esapi:esapi:jar:2.2.1.0-RC1 + [INFO] +- javax.servlet:javax.servlet-api:jar:3.0.1:provided + [INFO] +- javax.servlet.jsp:javax.servlet.jsp-api:jar:2.3.3:provided + [INFO] +- com.io7m.xom:xom:jar:1.2.10:compile + [INFO] +- commons-beanutils:commons-beanutils:jar:1.9.4:compile + [INFO] | +- commons-logging:commons-logging:jar:1.2:compile + [INFO] | \- commons-collections:commons-collections:jar:3.2.2:compile + [INFO] +- commons-configuration:commons-configuration:jar:1.10:compile + [INFO] +- commons-lang:commons-lang:jar:2.6:compile + [INFO] +- commons-fileupload:commons-fileupload:jar:1.3.3:compile + [INFO] +- log4j:log4j:jar:1.2.17:compile + [INFO] +- org.apache.commons:commons-collections4:jar:4.2:compile + [INFO] +- org.apache-extras.beanshell:bsh:jar:2.0b6:compile + [INFO] +- org.owasp.antisamy:antisamy:jar:1.5.10:compile + [INFO] | +- net.sourceforge.nekohtml:nekohtml:jar:1.9.22:compile + [INFO] | +- org.apache.httpcomponents:httpclient:jar:4.5.12:compile + [INFO] | | \- org.apache.httpcomponents:httpcore:jar:4.4.13:compile + [INFO] | \- commons-codec:commons-codec:jar:1.14:compile + [INFO] +- org.slf4j:slf4j-api:jar:1.7.30:compile + [INFO] +- commons-io:commons-io:jar:2.6:compile + [INFO] +- org.apache.xmlgraphics:batik-css:jar:1.13:compile + [INFO] | +- org.apache.xmlgraphics:batik-shared-resources:jar:1.13:compile + [INFO] | +- org.apache.xmlgraphics:batik-util:jar:1.13:compile + [INFO] | | +- org.apache.xmlgraphics:batik-constants:jar:1.13:compile + [INFO] | | \- org.apache.xmlgraphics:batik-i18n:jar:1.13:compile + [INFO] | +- org.apache.xmlgraphics:xmlgraphics-commons:jar:2.4:compile + [INFO] | \- xml-apis:xml-apis-ext:jar:1.3.04:compile + [INFO] +- xalan:xalan:jar:2.7.2:compile + [INFO] | \- xalan:serializer:jar:2.7.2:compile + [INFO] +- xerces:xercesImpl:jar:2.12.0:compile + [INFO] +- xml-apis:xml-apis:jar:1.4.01:compile + [INFO] +- com.github.spotbugs:spotbugs-annotations:jar:4.0.4:compile (optional) + [INFO] | \- com.google.code.findbugs:jsr305:jar:3.0.2:compile (optional) + [INFO] +- net.jcip:jcip-annotations:jar:1.0:compile (optional) + [INFO] +- junit:junit:jar:4.13:test + [INFO] | \- org.hamcrest:hamcrest-core:jar:1.3:test + [INFO] +- org.bouncycastle:bcprov-jdk15on:jar:1.65.01:test + [INFO] +- org.powermock:powermock-api-mockito2:jar:2.0.7:test + [INFO] | \- org.powermock:powermock-api-support:jar:2.0.7:test + [INFO] | \- org.powermock:powermock-core:jar:2.0.7:test + [INFO] +- org.javassist:javassist:jar:3.25.0-GA:test + [INFO] +- org.mockito:mockito-core:jar:2.28.2:test + [INFO] | +- net.bytebuddy:byte-buddy:jar:1.9.10:test + [INFO] | +- net.bytebuddy:byte-buddy-agent:jar:1.9.10:test + [INFO] | \- org.objenesis:objenesis:jar:2.6:test + [INFO] +- org.powermock:powermock-module-junit4:jar:2.0.7:test + [INFO] | \- org.powermock:powermock-module-junit4-common:jar:2.0.7:test + [INFO] +- org.powermock:powermock-reflect:jar:2.0.7:test + [INFO] +- org.openjdk.jmh:jmh-core:jar:1.23:test + [INFO] | +- net.sf.jopt-simple:jopt-simple:jar:4.6:test + [INFO] | \- org.apache.commons:commons-math3:jar:3.2:test + [INFO] \- org.openjdk.jmh:jmh-generator-annprocess:jar:1.23:test + [INFO] ------------------------------------------------------------------------ + [INFO] BUILD SUCCESS + [INFO] ------------------------------------------------------------------------ ----------------------------------------------------------------------------- -Notice: +Ackknowledgements: Release notes written by Bill Sempf (bill.sempf@owasp.org), but please direct any communication to the project leaders. -Project co-leaders - Kevin W. Wall (kwwall) - Matt Seil (xeno6696) - Special shout-outs to: - Jeremiah Stacey (jeremiahjstacey) -- All around ESAPI support and JUnit test case developer extraordinaire - Dave Wichers (davewichers) - for pom.xml improvements - Bill Sempf -- for these release notes. Awesome job, Bill. I owe you a brew. + Jeremiah Stacey (jeremiahjstacey) -- All around ESAPI support and JUnit test case developer extraordinaire and for refactoring ESAPI loggers. + Dave Wichers (davewichers) - for several extremely useful pom.xml improvements. + Bill Sempf (sempf) -- for these release notes. Awesome job, Bill. I owe you a brew. + Chamila Wijayarathna and Nalin A. G. Arachchilage for their authorship and subsequent extensive discussion of their paper "Fighting Against XSS Attacks: A Usability Evaluation of OWASP ESAPI Output Encoding" (https://scholarspace.manoa.hawaii.edu/bitstream/10125/60167/0727.pdf). Their paper and their willingness to engage with me to discuss it was what led to the (hopefully) improved Javadoc for the ESAPI Encoder interface. + And lastly a special thanks to first-time contributors Michael-Ziluck, wiiitek, and HJW8472. Thanks you all for your time and effort to ESAPI and making it a better project. And if I've missed any, my apologies; let me know and I will correct it. + +A special thanks to the ESAPI community from the ESAPI project co-leaders: + Kevin W. Wall (kwwall) <== The irresponsible party for these release notes! + Matt Seil (xeno6696) diff --git a/pom.xml b/pom.xml index 8623ac2e6..8a383d6f2 100644 --- a/pom.xml +++ b/pom.xml @@ -135,7 +135,10 @@ 1.23 2.0.7 4.0.4 - 3.0.0-M5 + + 3.0.0-M2 diff --git a/src/main/java/org/owasp/esapi/Encoder.java b/src/main/java/org/owasp/esapi/Encoder.java index b9d42dea5..a8b949d71 100644 --- a/src/main/java/org/owasp/esapi/Encoder.java +++ b/src/main/java/org/owasp/esapi/Encoder.java @@ -149,6 +149,9 @@ * * * + * @see OWASP Cross-Site Scripting Prevention Cheat Sheet. + * @see OWASP Proactive Controls: C4: Encode and Escape Data + * @see Properly encoding and escaping for the web. * @author Jeff Williams (jeff.williams .at. aspectsecurity.com) Aspect Security * @since June 1, 2007 diff --git a/src/main/java/org/owasp/esapi/crypto/CryptoHelper.java b/src/main/java/org/owasp/esapi/crypto/CryptoHelper.java index 11a6bcb9f..31f276ac4 100644 --- a/src/main/java/org/owasp/esapi/crypto/CryptoHelper.java +++ b/src/main/java/org/owasp/esapi/crypto/CryptoHelper.java @@ -352,7 +352,15 @@ public static void copyByteArray(final byte[] src, byte[] dest) */ @Deprecated public static boolean arrayCompare(byte[] b1, byte[] b2) { - // Note: See GitHub issue #246 + // Note: See GitHub issue #246 and #554. + // If we make Java 8 the minimal ESAPI baseline before we remove this + // method, we can at least remove these next 6 lines. (Issue 554.) + if ( b1 == null && b2 == null ) { // Must test this first! + return true; // Prevent NPE; compatibility with Java 8 and later. + } + if ( b1 == null || b2 == null ) { + return false; // Prevent NPE; compatibility with Java 8 and later. + } return java.security.MessageDigest.isEqual(b1, b2); } diff --git a/src/test/java/org/owasp/esapi/crypto/CryptoHelperTest.java b/src/test/java/org/owasp/esapi/crypto/CryptoHelperTest.java index 678b0acf8..aa7ae0cf3 100644 --- a/src/test/java/org/owasp/esapi/crypto/CryptoHelperTest.java +++ b/src/test/java/org/owasp/esapi/crypto/CryptoHelperTest.java @@ -131,7 +131,13 @@ public final void testArrayCompare() { // stop = System.nanoTime(); // diff = stop - start; // System.out.println("diff: " + diff + " nanosec"); - + +// start = System.nanoTime(); + assertFalse(CryptoHelper.arrayCompare(null, ba1)); +// stop = System.nanoTime(); +// diff = stop - start; +// System.out.println("diff: " + diff + " nanosec"); + ba2 = ba1; // start = System.nanoTime(); assertTrue(CryptoHelper.arrayCompare(ba1, ba2)); @@ -186,4 +192,4 @@ private boolean checkByteArray(byte[] ba, byte b) { public static junit.framework.Test suite() { return new JUnit4TestAdapter(CryptoHelperTest.class); } -} \ No newline at end of file +} diff --git a/src/test/java/org/owasp/esapi/reference/AccessControllerTest.java b/src/test/java/org/owasp/esapi/reference/AccessControllerTest.java index ad53d9ea3..107c1da71 100644 --- a/src/test/java/org/owasp/esapi/reference/AccessControllerTest.java +++ b/src/test/java/org/owasp/esapi/reference/AccessControllerTest.java @@ -226,7 +226,7 @@ public void testIsAuthorizedForData() { userRW = Class.forName("java.lang.String"); anyR = Class.forName("java.io.BufferedReader"); userAdminR = Class.forName("java.util.Random"); - userAdminRW = Class.forName("java.awt.event.MouseWheelEvent"); + userAdminRW = Class.forName("javax.crypto.Cipher"); undefined = Class.forName("java.io.FileWriter"); }catch(ClassNotFoundException cnf){ diff --git a/src/test/java/org/owasp/esapi/reference/ValidatorTest.java b/src/test/java/org/owasp/esapi/reference/ValidatorTest.java index b0fd24789..fc0dc7e06 100644 --- a/src/test/java/org/owasp/esapi/reference/ValidatorTest.java +++ b/src/test/java/org/owasp/esapi/reference/ValidatorTest.java @@ -350,7 +350,13 @@ public void testIsValidDirectoryPath() throws IOException { // Unix specific paths should pass assertTrue(instance.isValidDirectoryPath("test", "/", parent, false)); // Root directory - assertTrue(instance.isValidDirectoryPath("test", "/etc", parent, false)); // Always exist directory + // Unfortunately, on MacOS both "/etc" and "/var" are symlinks + // to "/private/etc" and "/private/var" respectively, and "/sbin" + // and "/bin" sometimes are symlinks on certain *nix OSs, so we need + // to special case MacOS here. + boolean isMac = System.getProperty("os.name").toLowerCase().contains("mac"); + String testDirNotSymLink = isMac ? "/private" : "/etc"; + assertTrue(instance.isValidDirectoryPath("test", testDirNotSymLink, parent, false)); // Always exist directory // Unix specific paths that should not exist or work assertFalse(instance.isValidDirectoryPath("test", "/bin/sh", parent, false)); // Standard shell, not dir diff --git a/src/test/resources/esapi/fbac-policies/DataAccessRules.txt b/src/test/resources/esapi/fbac-policies/DataAccessRules.txt index f21e8c869..0341aa56f 100644 --- a/src/test/resources/esapi/fbac-policies/DataAccessRules.txt +++ b/src/test/resources/esapi/fbac-policies/DataAccessRules.txt @@ -4,6 +4,6 @@ java.io.BufferedReader | any | read | default deny java.lang.String | User | read, write | java.lang.Math | Admin | read, write | java.util.ArrayList | Admin | read | -java.awt.event.MouseWheelEvent | Admin, User | write, read | +javax.crypto.Cipher | Admin, User | write, read | java.util.Date | User | write | -java.util.Random | User, Admin | read | \ No newline at end of file +java.util.Random | User, Admin | read | From 6bc2889e370acfdee6d8ffd711fc9a354506893d Mon Sep 17 00:00:00 2001 From: kwwall Date: Sun, 12 Jul 2020 22:40:52 -0400 Subject: [PATCH 697/812] Change release from 2.2.1.0-RC1 to 2.2.1.0. Also add additional comment about surefire plug-in. --- pom.xml | 9 ++++++--- 1 file changed, 6 insertions(+), 3 deletions(-) diff --git a/pom.xml b/pom.xml index 8a383d6f2..33af4721a 100644 --- a/pom.xml +++ b/pom.xml @@ -3,7 +3,7 @@ 4.0.0 org.owasp.esapi esapi - 2.2.1.0-RC1 + 2.2.1.0 jar @@ -136,8 +136,11 @@ 2.0.7 4.0.4 + org.owasp.esapi.reference.DefaultValidatorInputStringAPITest.getValidInputNullAllowedPassthrough Time elapsed: 2.057 s <<< ERROR! + java.lang.OutOfMemoryError: PermGen space + + when running tests with Java 7 on Mac OS X. No problems observed on Linux. + --> 3.0.0-M2 From fefe6033d8e21963ab5f84b1649b8708366cd524 Mon Sep 17 00:00:00 2001 From: kwwall Date: Sun, 12 Jul 2020 22:42:38 -0400 Subject: [PATCH 698/812] Correct # of commits. --- documentation/esapi4java-core-2.2.1.0-release-notes.txt | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/documentation/esapi4java-core-2.2.1.0-release-notes.txt b/documentation/esapi4java-core-2.2.1.0-release-notes.txt index ee3caf5ea..f91f82332 100644 --- a/documentation/esapi4java-core-2.2.1.0-release-notes.txt +++ b/documentation/esapi4java-core-2.2.1.0-release-notes.txt @@ -142,9 +142,10 @@ Generated manually (this time) -- all errors are the fault of kwwall and his ina Developer Total Total Number # Merged (GitHub ID) commits of Files Changed PRs ======================================================== +davewichers 2 1 0 HJW8472 11 8 1 jeremiahjstacey 78 70 6 -kwwall 65 64 8 +kwwall 67 64 8 Michael-Ziluck 3 2 2 sempf 1 1 1 wiitek 6 4 2 From fd009ec4cb166f8ecd72e4cb0fa303109558372e Mon Sep 17 00:00:00 2001 From: kwwall Date: Sun, 12 Jul 2020 22:57:35 -0400 Subject: [PATCH 699/812] Prep for next development release and change version from 2.2.1.0 to 2.3.0.0-SNAPSHOT. --- pom.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pom.xml b/pom.xml index 33af4721a..6356f1973 100644 --- a/pom.xml +++ b/pom.xml @@ -3,7 +3,7 @@ 4.0.0 org.owasp.esapi esapi - 2.2.1.0 + 2.3.0.0-SNAPSHOT jar From 5ddb8399e60d947dd454007976910e3f51c37f87 Mon Sep 17 00:00:00 2001 From: kwwall Date: Mon, 13 Jul 2020 23:23:44 -0400 Subject: [PATCH 700/812] Miscellaneous minor clean-up of release notes. 1) Add release date. 2) Fix multiple spelling errors 3) Document new 'Known Issue' about running 'mvn test' from Windows 10 'cmd' prompt. --- .../esapi4java-core-2.2.1.0-release-notes.txt | 21 ++++++++++++------- 1 file changed, 14 insertions(+), 7 deletions(-) diff --git a/documentation/esapi4java-core-2.2.1.0-release-notes.txt b/documentation/esapi4java-core-2.2.1.0-release-notes.txt index f91f82332..7d6c54ef7 100644 --- a/documentation/esapi4java-core-2.2.1.0-release-notes.txt +++ b/documentation/esapi4java-core-2.2.1.0-release-notes.txt @@ -1,5 +1,5 @@ Release notes for ESAPI 2.2.1.0 - Release date: 2020-July-?? + Release date: 2020-July-12 Project leaders: -Kevin W. Wall -Matt Seil @@ -32,14 +32,14 @@ ESAPI 2.2.1.0 release: Issue # GitHub Issue Title ---------------------------------------------------------------------------------------------- -143 - Enchance encodeForOS to auto-detect the underling OS +143 - Enhance encodeForOS to auto-detect the underling OS 173 - DOMConfigurator is being used inappropriately in the ESAPIWebApplicationFirewallFilter 226 - Javadoc Inaccuracy in getRandomInteger() and getRandomReal() 232 - SecurityWrapperResponse.createCookieHeader modification request (closed; marked 'wontfix') 235 - exception is java.lang.NoClassDefFoundError: org.owasp.esapi.codecs.Codec 245 - KeyDerivationFunction::computeDerivedKey - possible security level mismatch 256 - Whitespace in JavaEncryptor -263 - I am getting validation exception while validating a paramter coming from http request +263 - I am getting validation exception while validating a parameter coming from http request 268 - SecurityWrapperResponse setStatus should not always set SC_OK 269 - org.owasp.esapi.reference.DefaultValidator reports ValidationException with IE 9 271 - Add Constructor to DefaultSecurityConfiguration to accept a properties file (1.4) @@ -77,7 +77,7 @@ Issue # GitHub Issue Title Changes Requiring Special Attention ----------------------------------------------------------------------------- -The new default ESAPI logger is JUL (java.util.logging packages) and we have deprecated the use of Log4J 1.x because we now support SLF4J and Log4J 1.x is way past its end-of-life. We did not want to make SLF4J the default logger (at least not yet) as we did not want to have the default ESAPI use require additional dependencies. However, SLF4J is likely to be the future choice, at least once we start on EsAPI 3.0. A special shout-out to Jeremiah Stacey for making this possible by re-factoring much of the ESAPI logger code. Note, the straw that broke the proverbial camel's back was the announcement of CVE-2019-17571 (rated Critical), for which there is no fix available and likely will never be. +The new default ESAPI logger is JUL (java.util.logging packages) and we have deprecated the use of Log4J 1.x because we now support SLF4J and Log4J 1.x is way past its end-of-life. We did not want to make SLF4J the default logger (at least not yet) as we did not want to have the default ESAPI use require additional dependencies. However, SLF4J is likely to be the future choice, at least once we start on ESAPI 3.0. A special shout-out to Jeremiah Stacey for making this possible by re-factoring much of the ESAPI logger code. Note, the straw that broke the proverbial camel's back was the announcement of CVE-2019-17571 (rated Critical), for which there is no fix available and likely will never be. Related to that CVE and how it affects ESAPI, be sure to read https://github.com/ESAPI/esapi-java-legacy/blob/develop/documentation/ESAPI-security-bulletin2.pdf @@ -89,7 +89,7 @@ Notable dependency updates (excludes those only used with JUnit tests): commons-beansutil 1.9.3 -> 1.9.4 slf4j-api 1.7.26 -> 1.7.30 -Finally, while ESAPI still supports JDK 7 (even though that too is way past end-of-life), the next ESAPI release will move to JDK 8 as the minimal baseline. (We already use Java 8 for development but still to Java 7 source and runtime compatiblity.) +Finally, while ESAPI still supports JDK 7 (even though that too is way past end-of-life), the next ESAPI release will move to JDK 8 as the minimal baseline. (We already use Java 8 for development but still to Java 7 source and runtime compatibility.) ----------------------------------------------------------------------------- @@ -117,6 +117,13 @@ and I am sure that there are ways of making Bouncy Castle work with Java 7, but since ESAPI does not rely on Bouncy Castle (it can use any compliant JCE provider), this should not be a problem. (It works fine with the default SunJCE provider.) If it is important to get the BC provider working with the ESAPI Encryptor and Java 7, then open a GitHub issue and we will take a deeper look at it and see if we can suggest something. + +Another problem is if you run 'mvn test' from the 'cmd' prompt (and possibly PowerShell as well), you will get intermittent failures (generally between 10-25% of the time) at arbitrary spots. If you run it again without any changes it will work fine without any failures. We have discovered that it doesn't seem to fail if you run the tests from an IDE like Eclipse or if you redirect both stdout and stderr to a file; e.g., + + C:\code\esapi-java-legacy> mvn test >testoutput.txt 2>&1 + +We do not know the reason for these failures, but only that we have observed them on Windows 10. If you see this error, please do NOT report it as a GitHub issue unless you know a fix for it. + ----------------------------------------------------------------------------- Other changes in this release, some of which not tracked via GitHub issues @@ -167,7 +174,7 @@ PR# GitHub ID Description 508 -- Michael-Ziluck -- Resolves #226 - Corrected docs for the bounded, numeric, random methods 510 -- Michael-Ziluck -- Resolve #509 - Properly throw exception when HTML fails 513 -- kwwall -- Close issue #512 by updating to 1.9.4 of Commons Beans Util. -514 -- xeno6696 -- Fixed issues #503 by writing a new addReferer method, also temporaril… +514 -- xeno6696 -- Fixed issues #503 by writing a new addReferer method, also temporarily… 516 -- jeremiahjstacey -- Issue 515 518 -- jeremiahjstacey -- Issue #511 Copying Docs from DefaultValidator 519 -- jeremiahjstacey -- Issue 494 CSSCodec RGB Triplets @@ -260,7 +267,7 @@ Direct and Transitive Runtime and Test Dependencies: ----------------------------------------------------------------------------- -Ackknowledgements: +Acknowledgments: Release notes written by Bill Sempf (bill.sempf@owasp.org), but please direct any communication to the project leaders. From 31f0f988d45de4ed08e515dc3a82842fad4f5bd4 Mon Sep 17 00:00:00 2001 From: kwwall Date: Fri, 17 Jul 2020 21:28:21 -0400 Subject: [PATCH 701/812] Rephrase potentially confusing or misleading statements about ESAPI 3. Thanks to Timo Pagel for bringing this to our awareness. --- README.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index dc59e7a2a..85874bed9 100644 --- a/README.md +++ b/README.md @@ -15,7 +15,7 @@ OWASP® ESAPI (The OWASP Enterprise Security API) is a free, open source, web ap # What does Legacy mean? -

    This is the legacy branch of ESAPI which means it is an actively maintained branch of the project, however feature development for this branch will not be done. Features that have already been scheduled for the 2.x branch will move forward, but the main focus will be working on the ESAPI 3.x branch. +

    This is the legacy branch of ESAPI which means it is an actively maintained branch of the project, however significan _new_ feature development for this branch will _not_ be done. Features that have already been scheduled for the 2.x branch will move forward. IMPORTANT NOTES: The default branch for ESAPI legacy is now the 'develop' branch (rather than the 'master' branch), where future development, bug fixes, etc. will now be done. The 'master' branch is now marked as "protected"; it reflects the latest stable ESAPI release (2.1.0.1 as of this date). Note that this change of making the 'develop' branch the default may affect any pull requests that you were intending to make. @@ -25,6 +25,8 @@ Also, the minimal baseline Java version to use ESAPI is Java 7. (This was # Where can I find ESAPI 3.x? https://github.com/ESAPI/esapi-java +Note however that work on ESAPI 3 has not yet become in earnest and is only in its earliest planning stages. Even the code that is presently there will likely change. + # Locating ESAPI Jar files The [latest ESAPI release](https://github.com/ESAPI/esapi-java-legacy/releases/latest) is 2.2.0.0. The default configuration jar and its GPG signature can be found at [esapi-2.2.0.0-configuration.jar](https://github.com/ESAPI/esapi-java-legacy/releases/download/esapi-2.2.0.0/esapi-2.2.0.0-configuration.jar) and [esapi-2.2.0.0-configuration.jar.asc](https://github.com/ESAPI/esapi-java-legacy/releases/download/esapi-2.2.0.0/esapi-2.2.0.0-configuration.jar.asc) respectively. From 92ae8e11b2d16e47e85c61db0e47f503da6162d4 Mon Sep 17 00:00:00 2001 From: kwwall Date: Sun, 19 Jul 2020 22:56:06 -0400 Subject: [PATCH 702/812] Fix latest release #s. Fix some MarkDown. Add link to 'Should I use ESAPI?'. --- README.md | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index 85874bed9..3f7970602 100644 --- a/README.md +++ b/README.md @@ -15,7 +15,7 @@ OWASP® ESAPI (The OWASP Enterprise Security API) is a free, open source, web ap # What does Legacy mean? -

    This is the legacy branch of ESAPI which means it is an actively maintained branch of the project, however significan _new_ feature development for this branch will _not_ be done. Features that have already been scheduled for the 2.x branch will move forward. +

    This is the legacy branch of ESAPI which means it is an actively maintained branch of the project, however significan *new* feature development for this branch will *not* be done. Features that have already been scheduled for the 2.x branch will move forward. IMPORTANT NOTES: The default branch for ESAPI legacy is now the 'develop' branch (rather than the 'master' branch), where future development, bug fixes, etc. will now be done. The 'master' branch is now marked as "protected"; it reflects the latest stable ESAPI release (2.1.0.1 as of this date). Note that this change of making the 'develop' branch the default may affect any pull requests that you were intending to make. @@ -28,10 +28,11 @@ https://github.com/ESAPI/esapi-java Note however that work on ESAPI 3 has not yet become in earnest and is only in its earliest planning stages. Even the code that is presently there will likely change. # Locating ESAPI Jar files -The [latest ESAPI release](https://github.com/ESAPI/esapi-java-legacy/releases/latest) is 2.2.0.0. The default configuration jar and its GPG signature can be found at [esapi-2.2.0.0-configuration.jar](https://github.com/ESAPI/esapi-java-legacy/releases/download/esapi-2.2.0.0/esapi-2.2.0.0-configuration.jar) and [esapi-2.2.0.0-configuration.jar.asc](https://github.com/ESAPI/esapi-java-legacy/releases/download/esapi-2.2.0.0/esapi-2.2.0.0-configuration.jar.asc) respectively. +The [latest ESAPI release](https://github.com/ESAPI/esapi-java-legacy/releases/latest) is 2.2.1.0. The default configuration jar and its GPG signature can be found at [esapi-2.2.1.0-configuration.jar](https://github.com/ESAPI/esapi-java-legacy/releases/download/esapi-2.2.1.0/esapi-2.2.1.0-configuration.jar) and [esapi-2.2.1.0-configuration.jar.asc](https://github.com/ESAPI/esapi-java-legacy/releases/download/esapi-2.2.1.0/esapi-2.2.1.0-configuration.jar.asc) respectively. The latest regular ESAPI jars can are available from Maven Central. +However, before you start a *new* project using ESAPI, but sure to read "[Should I use ESAPI?](https://owasp.org/www-project-enterprise-security-api/#div-shouldiuseesapi)". # ESAPI Deprecation Policy Unless we unintentionally screw-up, our intent is to keep classes, methods, and/or fields whihc have been annotated as "@deprecated" for a minimum of two (2) years or until the next major release number (e.g., 3.x as of now), which ever comes first, before we remove them. @@ -82,7 +83,7 @@ Webchat http://webchat.freenode.net/ *Mailing lists:* As of 2019-03-25, ESAPI's 2 mailing lists were officially moved OFF of their Mailman mailing lists to a new home on Google Groups. -The names of the 2 Google Groups are "[esapi-project-users](mailto:esapi-project-users@owasp.org)" and "[esapi-project-dev](mailto:esapi-project-dev@owasp.org)", which you may POST to _after_ you subscribe to them via "[Subscribe to ESAPI Users list](https://groups.google.com/a/owasp.org/forum/#!forum/esapi-project-users/join)" and "[Subscribe to ESAPI Developers list](https://groups.google.com/a/owasp.org/forum/#!forum/esapi-project-dev/join)" respectively. +The names of the 2 Google Groups are "[esapi-project-users](mailto:esapi-project-users@owasp.org)" and "[esapi-project-dev](mailto:esapi-project-dev@owasp.org)", which you may POST to *after* you subscribe to them via "[Subscribe to ESAPI Users list](https://groups.google.com/a/owasp.org/forum/#!forum/esapi-project-users/join)" and "[Subscribe to ESAPI Developers list](https://groups.google.com/a/owasp.org/forum/#!forum/esapi-project-dev/join)" respectively. Old archives for the old Mailman mailing lists for ESAPI-Users and ESAPI-Dev are still available at https://lists.owasp.org/pipermail/esapi-users/ and https://lists.owasp.org/pipermail/esapi-dev/ respectively. From 073193e4498c83a325c1caec6bd42f3912438ee2 Mon Sep 17 00:00:00 2001 From: jeremiahjstacey Date: Fri, 24 Jul 2020 18:46:39 -0500 Subject: [PATCH 703/812] Issue #560 JUL fixes (#562) * JUL Property Resource Logic fix Adjusting the loading behavior of the esapi-java-logging.properties file to account for a possible null stream resolution. Updating the error handling from system error output to throwing ConfigurationExceptions. Tests updated accordingly * JUL Default Logging configuration Adding a default version of esapi-java-logging.properties to the configuration directory. * JUL Documentation updates Noting the property file requirement and resource location in the class java doc. * Property Comment Updates Supplying a more accurate description of the effect of Logger.ClientInfo * Property Comment Updates Supplying a more accurate description of the effect of Logger.ClientInfo --- configuration/esapi/ESAPI.properties | 2 +- .../esapi/esapi-java-logging.properties | 6 +++ .../esapi/logging/java/JavaLogFactory.java | 10 ++++- .../logging/java/JavaLogFactoryTest.java | 44 +++++++------------ src/test/resources/esapi/ESAPI.properties | 2 +- 5 files changed, 32 insertions(+), 32 deletions(-) create mode 100644 configuration/esapi/esapi-java-logging.properties diff --git a/configuration/esapi/ESAPI.properties b/configuration/esapi/ESAPI.properties index bafe1e38c..ccf146114 100644 --- a/configuration/esapi/ESAPI.properties +++ b/configuration/esapi/ESAPI.properties @@ -394,7 +394,7 @@ Logger.LogFileName=ESAPI_logging_file Logger.MaxLogFileSize=10000000 # Determines whether ESAPI should log the user info. Logger.UserInfo=true -# Determines whether ESAPI should log the app info. +# Determines whether ESAPI should log the session id and client IP. Logger.ClientInfo=true #=========================================================================== diff --git a/configuration/esapi/esapi-java-logging.properties b/configuration/esapi/esapi-java-logging.properties new file mode 100644 index 000000000..71011acc5 --- /dev/null +++ b/configuration/esapi/esapi-java-logging.properties @@ -0,0 +1,6 @@ +handlers= java.util.logging.ConsoleHandler +.level= INFO +java.util.logging.ConsoleHandler.level = INFO +java.util.logging.ConsoleHandler.formatter = java.util.logging.SimpleFormatter +java.util.logging.SimpleFormatter.format=[%1$tF %1$tT] [%3$-7s] %5$s %n +#https://www.logicbig.com/tutorials/core-java-tutorial/logging/customizing-default-format.html \ No newline at end of file diff --git a/src/main/java/org/owasp/esapi/logging/java/JavaLogFactory.java b/src/main/java/org/owasp/esapi/logging/java/JavaLogFactory.java index 93230c8e5..601d0da2a 100644 --- a/src/main/java/org/owasp/esapi/logging/java/JavaLogFactory.java +++ b/src/main/java/org/owasp/esapi/logging/java/JavaLogFactory.java @@ -26,6 +26,7 @@ import org.owasp.esapi.LogFactory; import org.owasp.esapi.Logger; import org.owasp.esapi.codecs.HTMLEntityCodec; +import org.owasp.esapi.errors.ConfigurationException; import org.owasp.esapi.logging.appender.LogAppender; import org.owasp.esapi.logging.appender.LogPrefixAppender; import org.owasp.esapi.logging.cleaning.CodecLogScrubber; @@ -35,6 +36,10 @@ import org.owasp.esapi.reference.DefaultSecurityConfiguration; /** * LogFactory implementation which creates JAVA supporting Loggers. + * + * This implementation requires that a file named 'esapi-java-logging.properties' exists on the classpath. + *
    + * A default file implementation is available in the configuration jar on GitHub under the 'Releases' * */ public class JavaLogFactory implements LogFactory { @@ -86,9 +91,12 @@ public class JavaLogFactory implements LogFactory { */ try (InputStream stream = JavaLogFactory.class.getClassLoader(). getResourceAsStream("esapi-java-logging.properties")) { + if (stream == null) { + throw new ConfigurationException("Unable to locate resource: esapi-java-logging.properties"); + } logManager.readConfiguration(stream); } catch (IOException ioe) { - System.err.print(new IOException("Failed to load esapi-java-logging.properties.", ioe)); + throw new ConfigurationException("Failed to load esapi-java-logging.properties.", ioe); } } diff --git a/src/test/java/org/owasp/esapi/logging/java/JavaLogFactoryTest.java b/src/test/java/org/owasp/esapi/logging/java/JavaLogFactoryTest.java index c0713f239..465083da3 100644 --- a/src/test/java/org/owasp/esapi/logging/java/JavaLogFactoryTest.java +++ b/src/test/java/org/owasp/esapi/logging/java/JavaLogFactoryTest.java @@ -14,24 +14,21 @@ */ package org.owasp.esapi.logging.java; -import static org.junit.Assert.assertEquals; -import static org.junit.Assert.assertTrue; - import java.io.IOException; import java.io.InputStream; -import java.io.OutputStream; -import java.io.PrintStream; import java.util.List; import java.util.logging.LogManager; +import org.hamcrest.CustomMatcher; import org.junit.Assert; import org.junit.Rule; import org.junit.Test; +import org.junit.rules.ExpectedException; import org.junit.rules.TestName; import org.junit.runner.RunWith; import org.mockito.ArgumentCaptor; -import org.mockito.Mockito; import org.owasp.esapi.Logger; +import org.owasp.esapi.errors.ConfigurationException; import org.owasp.esapi.logging.appender.LogAppender; import org.owasp.esapi.logging.appender.LogPrefixAppender; import org.owasp.esapi.logging.cleaning.CodecLogScrubber; @@ -47,9 +44,12 @@ public class JavaLogFactoryTest { @Rule public TestName testName = new TestName(); + + @Rule + public ExpectedException exEx = ExpectedException.none(); @Test - public void testIOExceptionOnMissingConfiguration() throws Exception { + public void testConfigurationExceptionOnMissingConfiguration() throws Exception { final IOException originException = new IOException(testName.getMethodName()); LogManager testLogManager = new LogManager() { @@ -59,31 +59,17 @@ public void readConfiguration(InputStream ins) throws IOException, SecurityExcep } }; - OutputStream nullOutputStream = new OutputStream() { + exEx.expectMessage("Failed to load esapi-java-logging.properties"); + exEx.expect(ConfigurationException.class); + + exEx.expectCause(new CustomMatcher("Check for IOException") { @Override - public void write(int b) throws IOException { - //No Op + public boolean matches(Object item) { + return item instanceof IOException; } - }; - - ArgumentCaptor stdErrOut = ArgumentCaptor.forClass(Object.class); - PrintStream orig = System.err; - try (PrintStream errPrinter = new PrintStream(nullOutputStream)) { - PrintStream spyPrinter = PowerMockito.spy(errPrinter); - Mockito.doCallRealMethod().when(spyPrinter).print(stdErrOut.capture()); - System.setErr(spyPrinter); - - JavaLogFactory.readLoggerConfiguration(testLogManager); - - Object writeData = stdErrOut.getValue(); - assertTrue(writeData instanceof IOException); - IOException actual = (IOException) writeData; - assertEquals(originException, actual.getCause()); - assertEquals("Failed to load esapi-java-logging.properties.", actual.getMessage()); - } finally { - System.setErr(orig); - } + }); + JavaLogFactory.readLoggerConfiguration(testLogManager); } @Test diff --git a/src/test/resources/esapi/ESAPI.properties b/src/test/resources/esapi/ESAPI.properties index 14b47d32f..6df0acc93 100644 --- a/src/test/resources/esapi/ESAPI.properties +++ b/src/test/resources/esapi/ESAPI.properties @@ -426,7 +426,7 @@ Logger.LogFileName=ESAPI_logging_file Logger.MaxLogFileSize=10000000 # Determines whether ESAPI should log the user info. Logger.UserInfo=true -# Determines whether ESAPI should log the app info. +# Determines whether ESAPI should log the session id and client IP. Logger.ClientInfo=true #=========================================================================== From 4b97073075a26facadf2931de792eddf0f8141b4 Mon Sep 17 00:00:00 2001 From: Snyk bot Date: Mon, 27 Jul 2020 03:29:35 +0100 Subject: [PATCH 704/812] fix: upgrade com.github.spotbugs:spotbugs-annotations from 4.0.4 to 4.0.5 (#559) Snyk has created this PR to upgrade com.github.spotbugs:spotbugs-annotations from 4.0.4 to 4.0.5. See this package in NPM: https://www.npmjs.com/package/com.github.spotbugs:spotbugs-annotations See this project in Snyk: https://app.snyk.io/org/planetlevel/project/f53b118f-f068-49f2-98e2-0b5681787cd7?utm_source=github&utm_medium=upgrade-pr --- pom.xml | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/pom.xml b/pom.xml index 6356f1973..5c574aca3 100644 --- a/pom.xml +++ b/pom.xml @@ -134,7 +134,7 @@ UTF-8 1.23 2.0.7 - 4.0.4 + 4.0.5 + Dependencies shouldn't require Java 8+ From b7a7043963b09acf2c2401a4b565298b90c32308 Mon Sep 17 00:00:00 2001 From: kwwall Date: Sun, 26 Jul 2020 22:59:44 -0400 Subject: [PATCH 705/812] Revert "fix: upgrade com.github.spotbugs:spotbugs-annotations from 4.0.4 to 4.0.5 (#559)" This reverts commit 4b97073075a26facadf2931de792eddf0f8141b4. Synk-bot PR #559 results in errors when running 'mvn site' about the '4.0.5' version of com.github.spotbugs:spotbugs-annotations not being found (in Maven Central). I should have tested it first. :-( Lesson learned. --- pom.xml | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/pom.xml b/pom.xml index 5c574aca3..6356f1973 100644 --- a/pom.xml +++ b/pom.xml @@ -134,7 +134,7 @@ UTF-8 1.23 2.0.7 - 4.0.5 + 4.0.4 + Dependencies shouldn't require Java 8+ From ba79395ecbddcfb0896f565cf54ba26936268668 Mon Sep 17 00:00:00 2001 From: kwwall Date: Sun, 26 Jul 2020 23:20:58 -0400 Subject: [PATCH 706/812] Update pom to reflect new 2.2.1.1 patch release. --- pom.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pom.xml b/pom.xml index 6356f1973..4a60e515e 100644 --- a/pom.xml +++ b/pom.xml @@ -3,7 +3,7 @@ 4.0.0 org.owasp.esapi esapi - 2.3.0.0-SNAPSHOT + 2.2.1.1 jar From 3200f669ce3ae1fe7685a592d1e2f32eb987b892 Mon Sep 17 00:00:00 2001 From: kwwall Date: Sun, 26 Jul 2020 23:28:22 -0400 Subject: [PATCH 707/812] Javadoc fix-ups. --- src/main/java/org/owasp/esapi/Encoder.java | 11 +++++------ 1 file changed, 5 insertions(+), 6 deletions(-) diff --git a/src/main/java/org/owasp/esapi/Encoder.java b/src/main/java/org/owasp/esapi/Encoder.java index a8b949d71..4c831d281 100644 --- a/src/main/java/org/owasp/esapi/Encoder.java +++ b/src/main/java/org/owasp/esapi/Encoder.java @@ -149,11 +149,10 @@ * * * - * @see OWASP Cross-Site Scripting Prevention Cheat Sheet. + * @see OWASP Cross-Site Scripting Prevention Cheat Sheet * @see OWASP Proactive Controls: C4: Encode and Escape Data - * @see Properly encoding and escaping for the web. - * @author Jeff Williams (jeff.williams .at. aspectsecurity.com) Aspect Security + * @see Properly encoding and escaping for the web + * @author Jeff Williams (jeff.williams .at. owasp.org) * @since June 1, 2007 */ public interface Encoder { @@ -167,7 +166,7 @@ public interface Encoder { * Encoder.AllowMixedEncoding=false * * - * @see Encoder#canonicalize(String, boolean, boolean) canonicalize + * @see #canonicalize(String, boolean, boolean) * @see W3C specifications * * @param input the text to canonicalize @@ -178,7 +177,7 @@ public interface Encoder { /** * This method is the equivalent to calling {@code Encoder.canonicalize(input, strict, strict);}. * - * @see Encoder#canonicalize(String, boolean, boolean) canonicalize + * @see #canonicalize(String, boolean, boolean) * @see W3C specifications * * @param input From 5b95e700c8ef812b01a4d788daad9cf30cf35e29 Mon Sep 17 00:00:00 2001 From: kwwall Date: Sun, 26 Jul 2020 23:36:37 -0400 Subject: [PATCH 708/812] Added 'IMPORTANT WORKAROUND for 2.2.1.0 ESAPI Logging' section. --- .../esapi4java-core-2.2.1.0-release-notes.txt | 33 ++++++++++++++++++- 1 file changed, 32 insertions(+), 1 deletion(-) diff --git a/documentation/esapi4java-core-2.2.1.0-release-notes.txt b/documentation/esapi4java-core-2.2.1.0-release-notes.txt index 7d6c54ef7..6119a5c4c 100644 --- a/documentation/esapi4java-core-2.2.1.0-release-notes.txt +++ b/documentation/esapi4java-core-2.2.1.0-release-notes.txt @@ -124,6 +124,37 @@ Another problem is if you run 'mvn test' from the 'cmd' prompt (and possibly Pow We do not know the reason for these failures, but only that we have observed them on Windows 10. If you see this error, please do NOT report it as a GitHub issue unless you know a fix for it. + + *** IMPORTANT WORKAROUND for 2.2.1.0 ESAPI Logging *** + +Lastly, if you try to use the new ESAPI 2.2.1.0 logging, you will notice that you need to change ESAPI.Logger and also possibly provide some other logging properties as well. This is because the logger packages were reorganized to improve maintainability, but we failed to mention it. To use ESAPI logging in ESAPI 2.2.1.0 (and later), you MUST set the ESAPI.Logger property to one of: + + org.owasp.esapi.logging.java.JavaLogFactory - To use the new default, java.util.logging (JUL) + org.owasp.esapi.logging.log4j.Log4JLogFactory - To use the end-of-life Log4J 1.x logger + org.owasp.esapi.logging.slf4j.Slf4JLogFactory - To use the new (to release 2.2.0.0) SLF4J logger + +In addition, if you wish to use JUL for logging, you *must* supply an "esapi-java-logging.properties" file in your classpath. Unfortunately, we failed to drop add that to the ESAPI configuration jar under the GitHub 'Releases', so this file has been added explicitly to the 2.2.1.0 release 'Assets' for this release (for details, see https://github.com/ESAPI/esapi-java-legacy/releases/esapi-2.2.1.0). Even worse, there was a logic error in the static initializer of JavaLogFactory (now fixed in the 2.2.1.1 patch release) that causes a NullPointerException to be thrown so that the message about the missing "esapi-java-logging.properties" file was never seen. + +If you are using JavaLogFactory or Slf4JLogFactory, you will also want to ensure that you have the following ESAPI logging properties set to get the logs to appear what you are used to with Log4J 1.x logging: + # Set the application name if these logs are combined with other applications + Logger.ApplicationName=ExampleApplication + # If you use an HTML log viewer that does not properly HTML escape log data, you can set LogEncodingRequired to true + Logger.LogEncodingRequired=false + # Determines whether ESAPI should log the application name. This might be clutter in some single-server/single-app environments. + Logger.LogApplicationName=true + # Determines whether ESAPI should log the server IP and port. This might be clutter in some single-server environments. + Logger.LogServerIP=true + # LogFileName, the name of the logging file. Provide a full directory path (e.g., C:\\ESAPI\\ESAPI_logging_file) if you + # want to place it in a specific directory. + Logger.LogFileName=ESAPI_logging_file + # MaxLogFileSize, the max size (in bytes) of a single log file before it cuts over to a new one (default is 10,000,000) + Logger.MaxLogFileSize=10000000 + # Determines whether ESAPI should log the user info. + Logger.UserInfo=true + # Determines whether ESAPI should log the session id and client IP. + Logger.ClientInfo=true + +See GitHub issue #560 for additional details. ----------------------------------------------------------------------------- Other changes in this release, some of which not tracked via GitHub issues @@ -209,7 +240,7 @@ Direct and Transitive Runtime and Test Dependencies: [INFO] --------------------------------[ jar ]--------------------------------- [INFO] [INFO] --- maven-dependency-plugin:3.1.2:tree (default-cli) @ esapi --- - [INFO] org.owasp.esapi:esapi:jar:2.2.1.0-RC1 + [INFO] org.owasp.esapi:esapi:jar:2.2.1.0 [INFO] +- javax.servlet:javax.servlet-api:jar:3.0.1:provided [INFO] +- javax.servlet.jsp:javax.servlet.jsp-api:jar:2.3.3:provided [INFO] +- com.io7m.xom:xom:jar:1.2.10:compile From 156b98cd8aaa7a21d483bded315f3509663576b2 Mon Sep 17 00:00:00 2001 From: kwwall Date: Sun, 26 Jul 2020 23:51:12 -0400 Subject: [PATCH 709/812] New release notes for 2.2.1.1 patch release. --- .../esapi4java-core-2.2.1.1-release-notes.txt | 237 ++++++++++++++++++ 1 file changed, 237 insertions(+) create mode 100644 documentation/esapi4java-core-2.2.1.1-release-notes.txt diff --git a/documentation/esapi4java-core-2.2.1.1-release-notes.txt b/documentation/esapi4java-core-2.2.1.1-release-notes.txt new file mode 100644 index 000000000..7fa3ffc35 --- /dev/null +++ b/documentation/esapi4java-core-2.2.1.1-release-notes.txt @@ -0,0 +1,237 @@ +Release notes for ESAPI 2.2.1.1 + Release date: 2020-July-26 + Project leaders: + -Kevin W. Wall + -Matt Seil + +Previous release: ESAPI 2.2.1.0, 2020-July-12 + + +Executive Summary: Important Things to Note for this Release +------------------------------------------------------------ + +This is a patch release to address GitHub issue #560. See that GitHub issue and + +Also special props to Bill Sempf for stepping up and volunteering to prepare the initial cut of these release notes. Had he not done so, this release either would not have release notes or it would have been delayed another 6 months while I procrastinated further with various distractions. (Squirrel!) + +================================================================================================================= + +Basic ESAPI facts +----------------- + +ESAPI 2.2.1.0 release: + 211 Java source files + 4309 JUnit tests in 134 Java source files + +ESAPI 2.2.1.1 release: + 211 Java source files + 4312 JUnit tests in 134 Java source files + +39 GitHub Issues closed in this release + +Issue # GitHub Issue Title +---------------------------------------------------------------------------------------------- + +560 - Could not initialize class org.owasp.esapi.logging.java.JavaLogFactory (ESAPI 2.2.1.0) +561 - Update ESAPI-release-steps.odt to note how to do 'Release' on GitHub +564 - Create release notes for 2.2.1.1 patch release + +----------------------------------------------------------------------------- + + Changes Requiring Special Attention + +----------------------------------------------------------------------------- +As of ESAPI 2.2.1.0 (the previous release), the new default ESAPI logger is JUL (java.util.logging packages) and we have deprecated the use of Log4J 1.x because we now support SLF4J and Log4J 1.x is way past its end-of-life. We did not want to make SLF4J the default logger (at least not yet) as we did not want to have the default ESAPI use require additional dependencies. However, SLF4J is likely to be the future choice, at least once we start on ESAPI 3.0. A special shout-out to Jeremiah Stacey for making this possible by re-factoring much of the ESAPI logger code. Note, the straw that broke the proverbial camel's back was the announcement of CVE-2019-17571 (rated Critical), for which there is no fix available and likely will never be. + +However, if you try to juse the new ESAPI 2.2.1.0 logging you will notice that you need to change ESAPI.Logger and also possibly provide some other properties as well to get the logging behavior that you desire. + +To use ESAPI logging in ESAPI 2.2.1.0 (and later), you will need to set the ESAPI.Logger property to + + org.owasp.esapi.logging.java.JavaLogFactory - To use the new default, java.util.logging (JUL) + org.owasp.esapi.logging.log4j.Log4JLogFactory - To use the end-of-life Log4J 1.x logger + org.owasp.esapi.logging.slf4j.Slf4JLogFactory - To use the new (to release 2.2.0.0) SLF4J logger + +In addition, if you wish to use JUL for logging, you *MUST* supply an "esapi-java-logging.properties" file in your classpath. This file is included in the 'esapi-2.2.1.1-configuration.jar' file provided under the 'Assets' section of the GitHub Release at + https://github.com/ESAPI/esapi-java-legacy/releases/esapi-2.2.1.1 + +Unfortunately, there was a logic error in the static initializer of JavaLogFactory (now fixed in this release) that caused a NullPointerException to be thrown so that the message about the missing "esapi-java-logging.properties" file was never seen. + +If you are using JavaLogFactory, you will also want to ensure that you have the following ESAPI logging properties set: + # Set the application name if these logs are combined with other applications + Logger.ApplicationName=ExampleApplication + # If you use an HTML log viewer that does not properly HTML escape log data, you can set LogEncodingRequired to true + Logger.LogEncodingRequired=false + # Determines whether ESAPI should log the application name. This might be clutter in some single-server/single-app environments. + Logger.LogApplicationName=true + # Determines whether ESAPI should log the server IP and port. This might be clutter in some single-server environments. + Logger.LogServerIP=true + # LogFileName, the name of the logging file. Provide a full directory path (e.g., C:\\ESAPI\\ESAPI_logging_file) if you + # want to place it in a specific directory. + Logger.LogFileName=ESAPI_logging_file + # MaxLogFileSize, the max size (in bytes) of a single log file before it cuts over to a new one (default is 10,000,000) + Logger.MaxLogFileSize=10000000 + # Determines whether ESAPI should log the user info. + Logger.UserInfo=true + # Determines whether ESAPI should log the session id and client IP. + Logger.ClientInfo=true + +See GitHub issue #560 for additional details. + + +Related to that aforemented Log4J 1.x CVE and how it affects ESAPI, be sure to read + https://github.com/ESAPI/esapi-java-legacy/blob/develop/documentation/ESAPI-security-bulletin2.pdf +which describes CVE-2019-17571, a deserialization vulnerability in Log4J 1.2.17. ESAPI is *NOT* affected by this (even if you chose to use Log4J 1 as you default ESAPI logger). This security bulletin describes why this CVE is not exploitable as used by ESAPI. + + +Finally, while ESAPI still supports JDK 7 (even though that too is way past end-of-life), the next ESAPI release will move to JDK 8 as the minimal baseline. (We already use Java 8 for development but still to Java 7 source and runtime compatibility.) + +----------------------------------------------------------------------------- + + Known Issues / Problems + +----------------------------------------------------------------------------- +If you use Java 7 (the minimal Java baseline supported by ESAPI) and try to run 'mvn test' there is one test that fails. This test passes with Java 8. The failing test is: + + [ERROR] Tests run: 5, Failures: 1, Errors: 0, Skipped: 0, Time elapsed: 0.203 s + <<< FAILURE! - in org.owasp.esapi.crypto.SecurityProviderLoaderTest + [ERROR] org.owasp.esapi.crypto.SecurityProviderLoaderTest.testWithBouncyCastle + Time elapsed: 0.116 s <<< FAILURE! + java.lang.AssertionError: Encryption w/ Bouncy Castle failed with + EncryptionException for preferred cipher transformation; exception was: + org.owasp.esapi.errors.EncryptionException: Encryption failure (unavailable + cipher requested) + at + org.owasp.esapi.crypto.SecurityProviderLoaderTest.testWithBouncyCastle(Security + ProviderLoaderTest.java:133) + +I will spare you all the details and tell you that this has to do with Java 7 not being able to correctly parse the signed Bouncy Castle JCE provider jar. More details are available at: + https://www.bouncycastle.org/latest_releases.html +and + https://github.com/bcgit/bc-java/issues/477 +I am sure that there are ways of making Bouncy Castle work with Java 7, but since ESAPI does not rely on Bouncy Castle (it can use any compliant JCE provider), this should not be a problem. (It works fine with the default SunJCE provider.) If it is important to get the BC provider working with the ESAPI Encryptor and Java 7, then open a GitHub issue and we will take a deeper look at it and see if we can suggest something. + + + +Another problem is if you run 'mvn test' from the 'cmd' prompt (and possibly PowerShell as well), you will get intermittent failures (generally between 10-25% of the time) at arbitrary spots. If you run it again without any changes it will work fine without any failures. We have discovered that it doesn't seem to fail if you run the tests from an IDE like Eclipse or if you redirect both stdout and stderr to a file; e.g., + + C:\code\esapi-java-legacy> mvn test >testoutput.txt 2>&1 + +We do not know the reason for these failures, but only that we have observed them on Windows 10. If you see this error, please do NOT report it as a GitHub issue unless you know a fix for it. + +----------------------------------------------------------------------------- + + Other changes in this release, some of which not tracked via GitHub issues + +----------------------------------------------------------------------------- + +* Updates to README.md fileg +* Minor Javadoc fixes to org.owasp.esapi.Encoder +* Fixes / cleanup to 2.2.1.0 release notes (documentation/esapi4java-core-2.2.1.0-release-notes.txt) + +----------------------------------------------------------------------------- + +Developer Activity Report (Changes between release 2.2.1.0 and 2.2.1.1, i.e., between 2020-07-12 and 2020-07-26) +Generated manually (this time) -- all errors are the fault of kwwall and his inability to do simple arithmetic. + +Developer Total Total Number # Merged +(GitHub ID) commits of Files Changed PRs +======================================================== +jeremiahjstacey 5 5 1 +kwwall 67 64 8 +======================================================== + Total: 21 + + +----------------------------------------------------------------------------- + + +2 Closed PRs merged since 2.2.1.0 release (those rejected not listed) +====================================================================== +PR# GitHub ID Description +---------------------------------------------------------------------- +559 -- synk-bot -- Upgrade com.github.spotbugs:spotbugs-annotations from 4.0.4 to 4.0.5 +562 -- jeremiahjstacey -- Issue #560 JUL fixes + +CHANGELOG: Create your own. May I suggest: + + git log --since=2020-07-13 --reverse --pretty=medium + + which will show all the commits since just after the last (2.2.1.0) release. + +----------------------------------------------------------------------------- + +Direct and Transitive Runtime and Test Dependencies: + + $ mvn dependency:tree + [INFO] Scanning for projects... + [INFO] + [INFO] -----------------------< org.owasp.esapi:esapi >------------------------ + [INFO] Building ESAPI 2.2.1.1 + [INFO] --------------------------------[ jar ]--------------------------------- + [INFO] + [INFO] --- maven-dependency-plugin:3.1.2:tree (default-cli) @ esapi --- + [INFO] org.owasp.esapi:esapi:jar:2.2.1.1 + [INFO] +- javax.servlet:javax.servlet-api:jar:3.0.1:provided + [INFO] +- javax.servlet.jsp:javax.servlet.jsp-api:jar:2.3.3:provided + [INFO] +- com.io7m.xom:xom:jar:1.2.10:compile + [INFO] +- commons-beanutils:commons-beanutils:jar:1.9.4:compile + [INFO] | +- commons-logging:commons-logging:jar:1.2:compile + [INFO] | \- commons-collections:commons-collections:jar:3.2.2:compile + [INFO] +- commons-configuration:commons-configuration:jar:1.10:compile + [INFO] +- commons-lang:commons-lang:jar:2.6:compile + [INFO] +- commons-fileupload:commons-fileupload:jar:1.3.3:compile + [INFO] +- log4j:log4j:jar:1.2.17:compile + [INFO] +- org.apache.commons:commons-collections4:jar:4.2:compile + [INFO] +- org.apache-extras.beanshell:bsh:jar:2.0b6:compile + [INFO] +- org.owasp.antisamy:antisamy:jar:1.5.10:compile + [INFO] | +- net.sourceforge.nekohtml:nekohtml:jar:1.9.22:compile + [INFO] | +- org.apache.httpcomponents:httpclient:jar:4.5.12:compile + [INFO] | | \- org.apache.httpcomponents:httpcore:jar:4.4.13:compile + [INFO] | \- commons-codec:commons-codec:jar:1.14:compile + [INFO] +- org.slf4j:slf4j-api:jar:1.7.30:compile + [INFO] +- commons-io:commons-io:jar:2.6:compile + [INFO] +- org.apache.xmlgraphics:batik-css:jar:1.13:compile + [INFO] | +- org.apache.xmlgraphics:batik-shared-resources:jar:1.13:compile + [INFO] | +- org.apache.xmlgraphics:batik-util:jar:1.13:compile + [INFO] | | +- org.apache.xmlgraphics:batik-constants:jar:1.13:compile + [INFO] | | \- org.apache.xmlgraphics:batik-i18n:jar:1.13:compile + [INFO] | +- org.apache.xmlgraphics:xmlgraphics-commons:jar:2.4:compile + [INFO] | \- xml-apis:xml-apis-ext:jar:1.3.04:compile + [INFO] +- xalan:xalan:jar:2.7.2:compile + [INFO] | \- xalan:serializer:jar:2.7.2:compile + [INFO] +- xerces:xercesImpl:jar:2.12.0:compile + [INFO] +- xml-apis:xml-apis:jar:1.4.01:compile + [INFO] +- com.github.spotbugs:spotbugs-annotations:jar:4.0.5:compile (optional) + [INFO] | \- com.google.code.findbugs:jsr305:jar:3.0.2:compile (optional) + [INFO] +- net.jcip:jcip-annotations:jar:1.0:compile (optional) + [INFO] +- junit:junit:jar:4.13:test + [INFO] | \- org.hamcrest:hamcrest-core:jar:1.3:test + [INFO] +- org.bouncycastle:bcprov-jdk15on:jar:1.65.01:test + [INFO] +- org.powermock:powermock-api-mockito2:jar:2.0.7:test + [INFO] | \- org.powermock:powermock-api-support:jar:2.0.7:test + [INFO] | \- org.powermock:powermock-core:jar:2.0.7:test + [INFO] +- org.javassist:javassist:jar:3.25.0-GA:test + [INFO] +- org.mockito:mockito-core:jar:2.28.2:test + [INFO] | +- net.bytebuddy:byte-buddy:jar:1.9.10:test + [INFO] | +- net.bytebuddy:byte-buddy-agent:jar:1.9.10:test + [INFO] | \- org.objenesis:objenesis:jar:2.6:test + [INFO] +- org.powermock:powermock-module-junit4:jar:2.0.7:test + [INFO] | \- org.powermock:powermock-module-junit4-common:jar:2.0.7:test + [INFO] +- org.powermock:powermock-reflect:jar:2.0.7:test + [INFO] +- org.openjdk.jmh:jmh-core:jar:1.23:test + [INFO] | +- net.sf.jopt-simple:jopt-simple:jar:4.6:test + [INFO] | \- org.apache.commons:commons-math3:jar:3.2:test + [INFO] \- org.openjdk.jmh:jmh-generator-annprocess:jar:1.23:test + [INFO] ------------------------------------------------------------------------ + [INFO] BUILD SUCCESS + [INFO] ------------------------------------------------------------------------ + +----------------------------------------------------------------------------- + +Acknowledgments: + +elangoravi for bringing GitHub issue #560 to our attention. This is one where we thought the workaround instructions was harder than just trying to fix it and thus we were encouraged to release a patch. + +A special thanks to the ESAPI community from the ESAPI project co-leaders: + Kevin W. Wall (kwwall) <== The irresponsible party for these release notes! + Matt Seil (xeno6696) From 74fc4ba1fa9d356efa5e7052286482c689aafa09 Mon Sep 17 00:00:00 2001 From: kwwall Date: Mon, 27 Jul 2020 00:01:15 -0400 Subject: [PATCH 710/812] Close #561 plus other major changes and cleanup. --- documentation/ESAPI-release-steps.odt | Bin 273380 -> 165319 bytes 1 file changed, 0 insertions(+), 0 deletions(-) diff --git a/documentation/ESAPI-release-steps.odt b/documentation/ESAPI-release-steps.odt index bf188f05f965c9d5051d1f4fc60a4ff4df2e1b23..33e7a367d25f75d5535c1da7d9ec4f8ee7888f6c 100644 GIT binary patch delta 58060 zcmaI7Q*h@`&^{U)n`C3#+1T3Hww;Y_eBx}(4Zg9RY;4=w*tYHSd*5?&{^wMkr>bYV z=Ax_TVyb((``KUmHXMb3q9h9m^&Jch4h+nf_)RGRMH=mYb~O2f7g267u>TR9)NU#$ z{Dfc%;6q7HO`M2`jF^&(`gDX8kI$ZBb5NvWI4 zX_?9ESj*`Kp$u26SD`)LqSWoUIMKEmXWLwR~;$ep&wd zW$SF`Xm8`}>1_MU$==c3+1As;)5;^%%P+`3z}GG?#Wyg_EBuc~be?ZQae$+KfSpl@ zhgFcTXQH2VpnqU!pl@QZYf_j`a)f_+m}^#qTY8jVevDU1l7H}j2#pB)9TFN59T^%7 z{0{#e6%iU06%`zs5FD8p5|bVklMoS`5gQ*HmXH#fkQtMZ9GwV?4+~6+3{HrNOpggk zkNuqx7oU_6mYfiinii80AC{3Am71CwnUWu!U7MDbpOu@LnOB@#P#0g+mQ>maDz42c zt;?=xEli8f&rGe&iOS8%EzCED{aO@E6U{#Lcu7Pi(`cD7X3|A(g5hSrYOrn>gl#*U5-P)%=E?O<_3PiYg-U)|DE z*)>_#Ior_DSKB$#+11nC(_P&&UDN-szIURlr>A9Pv2|*vYi_5vI&-ACxVN*Rr>kSE zv#zhFYq7s(d7x%tq_wA~XJBY-Xrym=WPD_>Z+x_WWMrgoVxfO(Wo&Y8`rp*R?E3iJ zzwv+T^JD#UQzI)={R^|>YqR~p`oHn{`T5z!)!F6E^_9id)wPkOgVl|l)!pN@!+jJ=hN$lv%BZ3=Z}Yr{oBj4*UO#jtLw+xv&YBBo5z=jm-iRo@%HuQ@$>Vu z3gLbL42%O@TI{Eq=jw$Yay0aYbr@-*#e*gPp`%jDo9 z1db-$B>O?Z^@1Z)sLukySkKh)x~v%Y@l;`{Pu|5P-(f5l}u`}#xh=62;|=*n&C>p(wlsp-V} zZrAJ<5ah=-^!<$62YMAhrq-=c1zC75E;|SkqmnjdfgSfB(bP$bFkjJT?~lm3Yg-@V zy7b+e?A;y8{9oZ)k0*0ugQFR-TTW1ULft1%lUpAz>n~O7i0y|jqYk~(3jVu%pSQ(v zhk^z^=lxTIPbK9`od-i#2DP6M*=79A4Ij&K3jXKh4j+!tfZwR=?bBDU13wJlQE-o+ zG#W8z*>$5y{RIwtB@``qQ?hk8FXX=;OTNY7rR>vRBTw|w!tqiyeJ=R6Tkd_6BQ_NE zq6-|(sBXE#y^q8Zcf)jDKXJY9D|SCDQ91BlcgohZce%|!*>K@;ea$_retizzzfn=M z3bDRKcn}E!&%}-Y0@=B_z2+Shx`4fst?L{7&HMJfC7~k!H&}nyTiDY+$!?e4&c|9v z`mc+PCEuOZtCxD>%=hVjV$Zv?9|~Q#9dC$3ec=vE)qcZ`h%{n0v-{p)&hrD;hG)eCy@SBJs6#ftyXa%_*J~G-|9jY1A#v;HMR@noK%9cX z=O@?K7WDln@%yiv)f}I#GvM@^1902hpRVy4|1vToIV*fMebQ$WEPS8aAGDzc9^|7e zXQu&5)Phud|2xw?2Z7Hyp%||0w}R2s&sW)L0r&m-q-i0(bl=OOX&~XU<9fG#TIlJv zKB?q~|L3~Pv=H0N7+cb4>XZN*<7ZQS7=YXEq$zU-CcbUja4{@~|&nPbDIy6@4<@qZ1q z%*pV*yvu3-Tsi7`zn}l&CtrvHJ{s|YyKVck=gV5l zY5hzbz;hnf-|yB#a`UTe0eh;m@?aX#zkLg=8`v21pvd{)rPv#O$Vh(rdX3t02KM$B zxhw!Gr{TVQ!B%n~(L+Tl49X;xPm&LdgJFXf&&&1wL0D{64__+3&&B5Vxg~PkZr|&V zC4JwU9>VTh@4NG-k9$JI94UFCw^)p=huacr2l>vO5ygOvYx$A1=w11J zTRqmz_P@EXy(ecwn{M}rkgr2E%|T;9br{!n79HytaN23d?!G%Rcxt;6a%A=#k9+_7X&3z2oPA?2cq_Wye%W%e=FnwN z>hgTp-hDQ}0SiY>2IrUwOtYXc>kfJ2)sA|e#`d>w`S_i#Rl_cAIBo3oE^;h2Rl~y! zJsCjOv{pO!^Pw2#v_5VVO4>64K94uvbnnKH`#w7#_G%Jdjulax2vn$UG}-rj4whj~Z&7Ci1Z;SgoBLvL_};L=T$ z8lA`cIF~WnC^o1ACOn^5UW`Z58gcS`8;Pwu;Q(tQeJFJ3QJ)Z59alpAwPzr@6)h`~ zc3yb`0tfqty=etd9U~~Y^#{bhmCv6$emIBYr&>Lu>REn@2)5uftG2dCUelhNYz?>k zJ9TINcsELAGB7`tM>XuqTV5%upT^4SlzemTy62tcIdAZvjzdM3Gz*dJfP@vqw0Ff1 zH_h>PtLgmj%|^Hzwql_Sr;-OhQneANEb~~5%dSGD>3IW$6GfdZ`@h)z$(V54jeKO) z@kbbU8=>lCH2SHAZA0psT5IKmDrT72m5$IAatu4qmA;9Q2MK3r;;|fZTI|76sXGcX zMIGIoPSNRU{zJ_&Fql(I(}4eHgtZBSPHSdE(!RZ}(i(T3z8ohn@y>-xfq&)2B2436 z-+%x3*t7#2iy4IHOMDXDBs~w|JRvxFnbJ4!^_nyqch;gBxWiSZq#UBjaOD z_}q=?SM#LGHHJ+JE$7Q^F>S4t&aRZrH`4hny$H%?Zcn8&jJnp9U^7g+=l97vd69p| ziDiRDIT--Z5TyFi-V#O}{KMu*NPWFArQ?{!C1DWOgho{UBQ9*m9m$ltZ0R1esVz<~ypL%FmfArIoppU4!Of zC`gN7my)%!SKDC1f-_gx53}KALHANN{SqK3m?OV0m~)8GDUe9_k#4S#Y}`WxOO_{aEh&Jl5C2xpt&~1Hs0!DXiJQ zd#^l4d2o()#8u24?rZUC7FW0KIWt@kkH9)r(y@h9;LnaH9`D4SNJ!U$RG67R-3dH9 z|FF+|TwZ3_(Ki{&ZF5>w7<~~xY$`}LgWBTZg9^)zSmXj zP*Pz-EHZ5dyO4sZ?GhJOalz931Dry%z!ZYX;f*f~law75@0tCzRLXv{J6bwX;@Sd( z^~p}Q{Uhj&$WmKJQbOYoQcE!h&@?!~7j_<-;)RJ5NuAA}C5fgJ$S=j&N72^Glk#KB zlCiGjV4tOsQ)Fg)!f+Lvn6iE?NuCDQ-NuXAh; zN@-V>*U)ksBpDLt^_%G<8V*Fn+QZ>fQ{Jn4mR`_SC8S82f=aA^z?HJf)_*!5rLWzR<_%Xy=k7kGs)@GVt%=rj#`)h!TPZDUpSXL^yUA zHL}WwlWw}uu!|IU0+YETL+qlD>sI(kX)IZ`Z#b>KUu zi7Dcug!RUw<`T@*ee{Fxk=Asq9g3bE_Y!*hY;J zuH%tyTL-K(6-lP(?{AswuTuvFnz56+6;E8tHa?SecQcj8Jrg@JOr;>^RB>yn)X>9P ztgtgM5Z(lEAP2{LHAA{ApR`a*l~k74DBE}HL7i4L-H1I;}@noSfb}h!NA$(tV(d^HW0a$ zKGjwKNX;^Oym7&MuYPLs@0LHRyf{W)&+WKIa?oYkS(mY093WfsNH}`qI7?nSe-(5d zjuF{&Pjfn`~bmH#3jeXL*8dOo;n?=L)@Eh8-G- zPtJ~Bg|wKjV(=O6Db**pv8nV(B8911ndgp{QXCSyf-4LS@u1$Hq@Ujq8%-$2h zd0$Wh1fD{WXxT=-Q@n{mZibb;g%AQH)p6wm5h;0j}gK9tuVm3G=ZxbXHWJgQ?8-d+)PQi#yc z4)zN>014`BdnDrD4#P+2G~T-!gRs>4 zzo259gR;5O=srDIe0FBWoYwU2BjMpNG<7AbuN}NYV1{e~bFS zwAe7q9C)_sdEF%0H;T{ce}eXuYVk@o_~ZCSZ8O+p+RiNLOfu{f<}lk2$z&EPq@_gz zN!1B!8hBP{WnB(04}RlFQq!A`jR@cOg90?k8y}*R@FM&B-pCab?rEng^N$VCP*EM) ztkSgB=N>*a(?{IkjYar*Z5N7AiO&~S3@b%$huZw%-}|(2x)^z|WGT3jf<_VkG8BTJ4crF1%&IxRK&koxu9~d z3tK^WHRwm&u_^`vX`6uih1oD5vOdbw%@SFesCdlQgaxwgT@tle!Ixk{_E+y5MV+{@ zpkC6i=Rdm!zum25*-h>w`jreoNRBT>lGPja++fuw26I@qKDf0i_l4Iw zu(5+WPDtwQZ8gy^A}iGYWm=WCs^oc>{dB)li_oa#!MI*`q7W+4STFYm1e+d*+rZ4_ z!==s)N1&EzlKnzf00}J}eV)hyh%nakf4_T3>CP~H-{V?>WuZ4UL)aL<>Dvyp<9$&X z6Gl{`z0;9@_AIkSFn(s6h{6iEkTA?Nm`1mfdQ;e!E&YK(Vm)IMrF$xhQ#=+`dAy84 zO22vcwD?SxV~MoQ+C`WLx};#{n20iveti6e9RXEmaE|GonPXsbl%r{@eTmUHSZeU1 zVNtpu@jKL!&hbb;4umqJpd5f^HeTjItk6r~;k}-MGFA*(g?kdW<1C{+6&X0Y&1VWs zcE@;_#xGF(-r*=NI~VW=dAi#_S+^Y{rpW~n1JPbOxyR6(pdN_;@%rmsI6&_ksavt! zsEre1dyA55tdd*$ax2&6JU4Py*rJtdt!gKqafStQdZ|ifm0gldQPaNK_@Y{)t=b_! zV~VQJZ|P%!>}(y;sRN#_t7cR3^_>6~LQE~Fx9BID@Ok@PRz<3} z7}&X@K2L3ae}Z(t(TU;>F1__NUvN+&xXd@RZ?$!krpUU%1_$AWj=jJBCP$)KlfvKW z{D^T=TF>6N4=&0d11TLd)+S}|=q$QaROokE}t`ftYOg5pV=)8wPX*5EN1KLA@;+%4W zg|i~^jzk=2fnU|r+}`EqTK0+It)auR%va28z#`rW6Gbr#7mcOn{!J-bjm8>9L5zCB zt;huv2nUfn;z;7!NVzDoEwGb~+Hd7Zfp#SQllxE;)CMOh!jM=NG&D)$lE8Kod|#+5 zo@Ns^#}L8OaJZ#Frp(f4=}5I*Q1s1PEX^gP{oxOQ=CMaJmw0}2B!d|lg7!?7=$EGB zhzaMhHt(dq_LDC(%(Oz?qjvT5N1#Sy%se!PdyKnICw6<2YK_jrj9Z0<`9U^0X7i=_ zLes_xZpsTv>{OKf$81mc3KFGQ`9N$Q&HTabI-L zwKxXUrrEyx#j6JdEOK6+{Ubot-g-Z$Ii#ED`Cl|*WQ zr6IC_+|U=7Ctoya{3bGHeCJc{h4pAg!XzK7WqKsZyT^oDI9-xCR*~Xa76P@w#lg-A zPVtt7iExEuddm7=PV)p%<^yMc#yE2U=CQXteq?Bx# zfi>TU7zyiCO&h*>I)jn-W-cYo)qd9n-XD1S9-=RN*FsP9IDcY$USx%zQ?!XIYHsdj^i4>=yH6y{9S;uyThwP6{)KggBj@x`uO zq??ymEBo4ztJE&edyli69X?t$pd{NDD7#+UFZqrX>o7EAiZt#l67P1+vp)3!y!M@& zl`g6D8OO$L6+iK{?(2s{(FiWh-O{#Fve(UWCfhC?4J*(7WjS|hC&}Z{R7>wLWV=H% z<%im{^`H!XiSo`W>@9evq7M8T^{+OjAwVPhRCuNeU1d2Ga+Ts9Fh?372jRdFDBF^V zZ8%bJ%ccc~>Z-=}kk69&#~VlidA8{&90P;j*LGpZOuJ=ZNbCD$Ad}^JRSZq#1l)!Z zBQTMfSgWP%C2oBbVaEQ=v0)iI{QUO9S`AT_*WU}Pf$oC|2`}Yw1`G6G z^I$ztd_@rX^if92s)~>WxhK0Ytx7|EG9)CN31PTACOfpwm{{drOsNH#0Gts51t;ot z_6VhW>%wwJZM*eLkD==7hiG+TEh|0jb-9Mj@rDe9bvmDe;=bF=61o+kZS#AIkdW7G zIU5c9~Q$8@CT!7&OTOYIqUR9=?SlK-0cDzZX8Z6{la8g6TS?U z9=A+*w^M6_^UuQe*L#!PK5PcW<8Z6LMIpTi8BEeb^o{AJiqPoI5a_!lXt+Tr4E&c? z41aWdF==($hr*j0G%$6lb%RjEB|g@g=&Mda3oL|)KdeR?;R%C*@zPMe-|J&H&0m%! zfqLVTpqP_mI6AB`>~`0xHp01tImxUf+WodJQ!W?R@ml^0s~v$Jfp1j$C!IU|Q#YnG z=OWoU$~6!>kH$;E7QAK0Z56nF3o~;bT^|x1h1GsEHN8;B+XZ;yT|J-Rj2~>z*<+0h zuGXR}P?GR+B8+}O&t&T5G?lRmz@G{(yWItgnu5N8pi&ne0Fpii+ka>UmlX?uarr5A zN5y1s8~id>@01f}QFX+t%Y%6M-xpTQ{i_t-#Sy-d&H|-C1oHr{b~X&*jx*pGyAOe1 zW%O(kLa)q~OUB%0A;jIyr&Dc8cllo~v~D}k@9Ra*hPVSj$zW0)>w*9T*;wC5uNAP7|-OJS4I?-pZ03K7qcNkscl#nH)b{r?hBNU@_8X8J@Q0TaxFQ zISLaE9me)Rp8OL$aGxsAdy3^-eb1n#2@eQ<*iG=zMOgNoDVB(TxMRYRoKib3Tzj-D zAlN@#*YgDMXixA<)((Jv&){($(K{qY>ysQqMa%!o#ll>;^$ovtYp%%Kuq^in=`qeY zHMYxxK7uo%MQ1RA;#J?d% zxZhG*Z?hOG^yglOEH`lHfaSzzf*!}yP3=+1r!!Q>J~dL6mqZEcN6sdZ45A`4C`y26 zrw*GB<>^Lu>YlyM!YZ_AA75n^VaAcH3NIiTOv(adC|^Sx%o6M$uT60QBRC_x3Y;~- z+zP=^$-xm&XW=smAzWl9T%Lanf(a59-^Pwg2y zfvn&ei?L9dZyHu!XCXfHn-suG9i*38f!%1XdA?snrIZ6BWpRF)V1;QWnyrJO9MzaZ z#RuKcFSyBbU3Lf}R|Y$OK4}$@{B7IXe>q+xTR7Dh7f$+%1<+OA9Cgqb4_Ns3PKeaMC@HVd#E&sky5?nibQ)rGGW`OwJ z#VgP!lCj#4>K{-3uPLe%@8pFM3+l+-O46l*9zP@P5oEvYBALDABAuf|gLne04Sv#M zYgQ@~zYz@%F%oN{d!G3(UGXjN;6nLFY%5ILnVvtLaG9iv8@%Wf`H81?DolHs^$3()gg0&B9{AzUQU|xg%@PyN z!_J=8KC^8V3%M`#H!yApyOeKCEJl-`ft0Mwk)VlRVSavZqT5S=ImZ+mYL;Ro@CmiH zl{=tp|9GETozfBP?Tdn&VV`(s0i(%icU14>2vo^ZA8N)kPcCSv_(1@)S~6Oduj=<3 zp`Lr#uHOH0U-;tx^08q%m(_TREO?R#9I?KR_`NU+vf06g#hW`>I}; zHU23di=k&=~Knnh=!T!Zw8Zp{Fy&=lXNCcv|E0f#&r<8W$o?l z08!t{k1%}EIWNFfM3N9mp6K!ihmN}Ny8oBPS>g>f!3M?ThXF>|W>^W*NJ&K?bvL`& zuu!)YUyVRqxAuezibb^6pdv32Ca-9ni}Fl;Zh@8aiYL||!J|mBK-kO*;g+>_vK3q1 zaffwOW5KL`by3B!JfF15>yfAHQt$frqQ5G(lGEaxfqI z;MnxZRCbG4I56!yYc5IK7bCFE$-h>~5$EPucIdr9H(1PR^<96z4W*9j64Jdfx?+K; z?&>15YpFYFf0ea{d<)N0e{?0B7VNlMO*U@j+@oLyE0UPI2cV z+&Kzd-@P$`dx~#IokZ^(b9vlt^3ZVx1J8|Au2}?}I$unYnK-a_rO?vrnC@G3^F679)$oG%RbHK9$u9V>DvV}u4l8x6 zKca0GK&jD3ZXV<>gV^?i`FJL3+V%ol@Ez;e_r3X_5zW|_r&bVz!Of5c8bg|$%S;pH zDw|6Bg>Distmu;17)o4VB-DXb0T&ntVlXNZSs`jY{TSX0Za}T{j%!!jG4jNcqT>zhKf^WU zj%EI=4x5bRVfXT*Y7m@Fh1IXLR=W4!U+WbG+izVAH$`WfXQ$-BaZ^OcnWrG8(C(2Q z(sHb~k6xq9%cpOJiiM)m(1+hoim-_!cue7B7_};R5utL2hpW2%$?$qv2xGXEZt;R( z03iOn2n@t=OnBfsmINi7;a4@vWAhk9m4m@GbtoLWr*Y1_cr64$SK5`)bE>2I&JQB< zwuh7xHg?J0GInp+w0}M)ujSz(7REj9`?WXXZFbu1`45+LS6{{A&E#vk*zp!u%fW_d zw=6U)BDlOU#hNVP-k|GGm}qGt#cM=o0*NDRe(W>ChqxoNl zo;vC(>ALp~#R2<=Yb0uFjzcqvqlFNzwm7_UYuoXOTHZ_WN*!lrr;Ot#!3-uF+@|r8 zC^%~U|6=ajerKH^I|;vsi|mGx%F_)L6LU4=zemAKS{ zi=SU@KpSRf;fe>Nm4}tpLV8Vg4+66oa~ipEbGq2Jg9-UMcm=&k4t3njp;Sx}y(9=S zuI9)c7cGWfG~)MfArewFYf?xrV4|EADJWjLU6~tc;5Q!BIhk6zSr}kHk{~nmYYLO8 zODl|Srlup3ThD!ukk{g^(&v>`+*KjLbgyGNfZiTHmGQ<<8xK_#q9x!rnZEc{9NBfr zizXTwQVXY?*$I(yjxd#BeGXmIccFyS$`ekyme3;mBE5+x<4Dn(4E^13G0Os*{&qMt0xlHyWx z=x$^Q9@6x;@jO#}aT%O+!z|#Y2 z&J^u6V;R8#GPM08>85}baLZHIB+n-&TpYogfW^lsNNsXc;D|_|Ows2=84!27%i^lB z*Jj1Pym9Jn0oe;t+njRYrWQ2AIvz)z&}c@jwAmoj>T}Vd-z55`)iuB68)x2ceYwoy zTB$m!{M|OIWqLMV4kjz3TvNm1Y+l}{%>yr7cMbZ{#FkGT$8n+`cmq>xNa=-Pq*_@| zfa^}lO;uOiVSz<+a76L=TiMPmTW>}xqbGX6)6ReFC{|onptcU9Vv2dnlJ3L}{JJUl z&R@S)FI{7Hb99C%;hKuzsfP9*t)2D#Fqo0F=HOnZ&_Q3N(?Q`SmYqA$dDtgttrn_% zj+Zi;SGgnunlvF7uv9nYgP~hhP$aCnYzcD`mZe}DOD__ek;7RH0?AcUu^z{7mj4pw z^PjfZ5r9o<{;~N-J*7r1&XHkUG}=4|8`Q$S98-`BT|F}PU%U5kEuprRq1BVo-F2+Zxxus>EJPlx-)hj8f$+7yHy}9v>v%Y9 zlzFRuns)Fzz>Is5;z@oxo|_}`{#OzHOY`7=O;bj=`{uj zYwhIfAYC6Yy8%(!a9nB6don3mb>0RuSy^4%kSBXP;MrPZL9vTtP^GX`DFAW(XQ8k3 zJQEXf4Uo@&PPgE12Ym~)OCu;erh&UA*+w@8DaDnRb7q2EX!((UF!B&cG~JX9z>)8; zWOC(PjY{?wXuF5plQLtnbs>9nsYcJvbSKTkt9HmO-a~69?yUY z145rkWu~-yNX+pDGQU890dDLrYO2o3anav(beIl6tz6$ZE{x!ldmx7b3+U8HSzL25 z(gX_a!ypEoB~Znl2f-vqf3g z{%a*`jFhJ$7$BE(fG>3rE}~{K{c%eMaaMS;KgNf6ESpYmU0r-T8983^?jkmqh3)SZ z{P(R9prdY*KGPy#NWk5SW07q;bHHaKo^+m~4OgWmONGV2wB4F7vZ$@4Rz{ zVTQgewz!v{0VjEQ@h4a5>C0{60p(o#O1W!-PqwrFXSSH<_j+?cn& zn?Boi8Tbr8W9zu(Xh2S2nu|%|l(i`;rC<|%?>}+)oeS%H{h$N-!|ac*q=BslcTe?& za8x?0zjt>h-(|3`)@2$rQ;8?5bYyr^r!3?jymf0Gv^7+{PyBSSOQbF z0-1BvYBi)SwzI;@1AV#TAEPTAk)rLkIP|yrvVF$twUnyuS{DdV=xxUB*KTcxsq80h z{*C@U)jV-p;y>2Oc37*{vP+mi9&dzK#g}az%`ci>0RXIIT)&YtYI7to z4jG5_8~BWL^B{*l5114au<NZ6&<4OkT0nz+#Zd7GDtRGoHM2d&VT z)0|r^$$4em#NPR|zbmNKeyz%#0fp>mBPSZH4g|t{C z+npl3QEZc_?md8r!iJA-0#XzjqyksZL$2&82Z#ye9cVmZ)myXL`{am)2%40ExT zt<~6VmQ)?0>u|zf8SHBWzlb2L_mGTnUDDR{$TIw<<2R8tgCA!_uE#^Zz7aVu%+DV8F&LHjd?BXBKjg`w)t)!bAyKUmZzI#g_RbOBtHb8K#$Xp66vFE)x$!eVd^ zc2<&!B;9^w5{-=$z$5>m{;iWbN{ShNn7oYF-|0Fz|Nh+gy)Tdf`bU(~wIxBA3;b;5 z7poyMhO%w4a){X12v8dFUNw$GYL!L`9{Z9r_|V?k>4V z`}%*u>iZ67?;{^g$3nDuBp?0jaxREqe0zpK>z*A$GJ7tjIZ3 zd)g~~om9cHbftQ%BNCV~mOH=aPIdzSy97;Nl?>pS0Va)*hgmLaU2Z~=2&1NYR^By6^Z6zu)1%#%v7sooLK09f=aSS++H?}rtk=zWWy1ttb#O<) z`voK~VU0T5O?wH4br?gn`1vap(2BR3NW(y{Ryy z2A-#ME+NW%vsJhXk(L%SM#V5&aYdDFp~eFNf7uT(b5ai}`G8RO?;ZgKbwAKK$K?R6 zbaf15ZO_MMXl8##=t!|kuNDW3sB}59#$P0f;}BW*G>nV*`aPd}(C5+f)=WvcZ9HSW z{#a&L2tQHq7DxZ+Vxwt&eA99!VZI%E1hd!1lR2{qh{fS4d5>p5XSX;pZ`AxQlP5Xu z6Kbj&sHw~(4zfZ+2@`!ZbS6{zS!f2#9!;xqi}@G2PK~Q*@s}D01oy^&?L)qBeG9Io z!DK}-Q)fJ_{#06t#;K%3D#C7QwFE;PYyaB5wysA3#=3#;tL#~l&^}%FDiTu z)19k{5l0hp=L;sWMK*86)K(6Wqo9FIy*bS zCNGl8`1MrYhFE>?M=m_@S~CGBYTtFw)X!4)qqChyfj_}Bf}YbT`E}P>k=FZBtz25^ zZ-=sEP_thL*Mw$@qag|RDJ(d?FAzwMw44qh7WLqKF@v{l>a_~xZu1tr=a5J>D6`&- z{2HR}RX2v{jo<#9imFvGxMvot=EgTp&dt)vO50@7Rk==J;##0O5z_;x{Z+hVdzG6F zrw`#;2R=;;g>TjhNvVdp^^A#grw?`43yT>KRIb&##Kg-5W)LyzLuV+sT;T*Ib>%<@ z9t7LA!pP#Z3>-MN={yj(BPa~c+);wO4ej4Gpx;sZ52a0{PmX6tY z{HPGL-+G~lF42GEr22sdUQrFy(bUmO&Xd&ecc&|9My#~dVRE#W9CK%_o&;5N#jjl{ zPYUxYg9sCI%9XMzDFdk{jNZoyQ3#!H5HG9Mibkw_O~;Xbq1l62twcgavqky4-rrDUr$ zy)g)W!*D*ON%O*NN=a^k8w4gy+hE2Kf@}1!ik=`bh*1ot%xNWF>exmGx{HH@n-U$y zGPH@(LG)9SH&kZ~y_^~TuJ=SJ(o26CA+mrp(q@0BUfc9W=eY4U9Plts>Nfr8u}iK; zt6#uOGHV!oyal9$_@zXbxZ!x=LWh}&e?X>44b_e03%SGfY5VCnG3Kwg5(ZjkhKu}+ zWk4crWr!zViWj5yeC zr?%J8t>@#Ci;E?OsIT7oH^@st+&8oHq*}$H|A$he&6@o(Hjgd%wld20L+EK@zus^! zgI{uM`s-nTeSCU|a_{EzO7Qv3(w*@BUwX02t4-9*m%R&cTc-NQGH1)T5REJQw6;XB z7Q?^VrOiRWWe6XL!HgN&zh8b`lfF|eYEh_1RP1^mJQ50@7PuMg?wQW{Sf#6+-n%p8 zd3%>NJm&X!+@g!R`hPk0|8@0$PHtAyK80lXUM`8OrdavG{)4o*f>^bPQPBU*U4(;! z`(N&25<4R)@I2Df^Q~vJrzaoUEaaM%*)a_qH=0?2HyKic6?y|x2>L&k%H(JINp!ktKrJcaz{=EHyTf6^<* zMX|k?Nx{JWlT@z>aD03g4i@JB1)C_d2oHyt2s1ky7b_PBD?3{PfCYdn|7U_94&r|d z!4pw}fsy9?FXt@tLLXUARsBnd(!(X#u1BIzq9w2|bH~^5_pTfZ`X4oh5t1y*cXc8( z4k>U^3_0n%?;H&?K}f7hH=$xg=<+?^_N`2~l|tmcnZvCaF-yD(dF+`xJl_sPjeVR- zUI{$CPrYnxz4!ssFIg^Emn`1T*Q7lG;QjG|vqtm*;E-Y9&_iBGIAK^wE?uof@~i9X zvo}v*Hf-$1X6(_nCMG8QzS|WkQiby95hAmK*XpLnn%g(rst8cpUx`dd#QeTm9yP|x z<3Ez3W5RKf@xMKU@qS)D>n_eg@M({0mj39zpX*V3-R=c~yX}{d@HwMpiqOMQMLdG@ z3};st7nePW-H&T@*bMw%%qL~rGQ&f-s8ELYu78ML;nRHK?=s^()}e`{j33NA-=j4I zmfb&I;IaOfB_t3D`aXl{4*Tr{4DVG{9>>JQ{LQnoHCX5<9Q3lPCy2f7zwyk91sCmx zc&w7>H(&)=sG8`F5gS0?;6Lt;xJPe#Q?cfvm;}Q`mND z8A4eBQ~Ou^E4+3KOfAHC1{}Xl-X})GLojY~2Nn%TyJ0~B`+IbU!;HjelsOz={0n^V z{SM{kY8d5GDD%rlJs2W8;dt*wa9s1XMeAPHoWtW3Jqd-2lcQ5`@Zh4gzHL4(dxEZw zfk4pLvnMeWiGJL_3}2LZ2YTQ4VKmDJ&(aR#ui^W`$m{#afo{n8lV~&1vXyKiqa!?y&VptCjXJ+1KUCBJ$jNl(;(6r*A)f3vn{<(#2_M zS~F!N9KD0qw1JuB9k3dG@iwR`0$ChC!$webl}^j+!ksg^TmNe5d`Gqo{JscJn*3K| z$%Ua5ln%-$<3~16QIQTPqMN}b< z_bT|^%FM%vFBFjMH$vI*R@aI=%x%M3T%je)l!9~%+bxYO54wxYV|#pIsYT!m^sorQ zgdE6mx$0sU^i-PR^;PAN*aV7Bf6FFby3a{>>dB*dy=1o1KIQIU2R`cb=f2)fP0$hl z5g68+jdLtg@7=J&V?VHa`dpqbYKSXGIBuK@yRb#_q7n7Xmri@|@;Mp9 zi2g_6rfxSk0~=5SLCX(%kpNhq_ZvI!<#@OxvxJ*k_d5`ra@b$!ozf#dImut5Xr?bq zfqRAd7!k135oQ60+qG$$ALc0w#f*2`G1B6eT|(JDRXU3b`7RqB*wgMLQT}i%>LeQ9 zZQ&TMBR82PQ;6z1y%k)K@p+wm5o_UyQ%y9TNvnwQN!zs1GsxN zJ(b0Qv_4K)H)>Ri^}i1&I{afD1x!L0GlA?$aNrqWm?;rV99@_V*;WeH^wLu_9Crv` z@$z8;Q)QyG)HU|sI~EJ(4(>mAj27#ZG~1MIycV;s0Dg0{1^|q+c6N&kK^!9$#@806 zuupU?_CRmXGtR4v3Nn9PHd?zEEB7`-|EpHt&pwYX*?ht~qw}D+3i6(mHoY+ZalGc> zpV}2w2cBah>KCEiuy=WWq1V<0BNb!py9pigzx|7?lz9904^gHL41$()!>%47i5{|E z+KHVIwn*H(cHpSKF#moa_y8dj^Z%mjoudN@nttKf$;Q~&ww;Y_+s4MuL>t>SHs08_ zwXtp6cc1&5_n!Cr|W^t7^z9J zzWkQo+&T8;pXufh&4{LEZ3wb|%$2G8*p8RX?{62rY&J#EZdHD3U71oXP6bd}%0{>; ztV(G`l>E3@EY-*!{xWDVT4>3tQ~x|Hqy1>j`V=n$|1I@RFH!!@bQ%E6>#x}@INkts z=~w0xz39ur(@-^=DJGKcPgenW16K;;6A9vmLP3TCa6Eap$FQGAOA@3z{H2VZoO~hf z*0ftcTkcd=<8$X?PszH@J|5czuK1F(U1uz^C>1;yGi*eO@*r7SYMA8@)W-cue>1eQ zuRBu5f`(f5*}#_=&;wF-^C)bDZ{JDJp60yYQEEW`S;4Iv-0*GS?6Y5MZ2tx}i>Hgw zkff-r8@wGhc&8~SEpKL#@9 zITK^i+SRKZ-*{U0$2ZFmbG1zCPiH4ygh~0#{%gTH&1*;URQYqj&|QYBy@;O`|CU@k zSZLX+QRwb1BOvz7iP~Y8Pv)1k?YlHkpw0Fn{W^_Uy>q6EW7*c|nLUx%c5@`B zc+Nu!!N;XgF6b>TncEePXip%C#X}bwEI~hgt=UR7c;{h1*?#4&;dFN{g)+`)-$esH zZgTMc;gCC3rByW6lR^70M(10|aGzr>bL)Y>;8dRPUtoQ)=tGc_?|9tx4asq|EbH#T zSPMGq+`YjqEhhM@nSI<}iZdHVeUUWE{unN!HoMYEnkHl2fVor0?V%cRIvzrsHsi8c zjUen@gmf$H?Q}^wT6U7x+a8VbNh(#jE0V4r&t%#yi|NyVgW`Lk>wKrUp+G)wIV&?K zYXS!cEda{1N8~ysVQ67^&nM8PNQLf!hZHi#0!g&TJDJ~-;&xB5f%R}u4lm}B`s)Lm zb+uNU<(RZhq3rN5?i!*`<~$@^p`e*VCi`qk;Ta7kV*#wk1(YG-}Fa@g!lr}yUc z&%7PAEUYCCs>U^m;0b;&m-l^tf0$!K$_->yE5{glnhR?36dOkI; zVE|1vAMWZGXVJS7Nq*XBXaJ8TJD4~Hn!3;JB2{)r^f4tx+cZqmrOlE;c^PtYlHTO& zt8UCVG~smPWg)LuNkC~l`YsgpPlA4mi!btSzbSQ%y!78c*n|?`M_i=WD zG{}GUI|1DgVGqkEquODKT#w~G3Jr9hTHsLjsgd%99c0rJBkSUfY*DcBdtJ33)b{Ty zpX~M@4k&Z3NLTfpS_l66ey?!OZe$g#^*ULftlT^E>YLRxXYt2}p1H^b_xMMHoS&!I zCsQJ@-~4Z&4vxL-yiR+ zdz4ldCv{Uq31=(G_TBP#U{GB-iB^4$Ip+DZpiFqjL=~?TAg3`;<}dg{62Q{6VdDk+ z0eg=~G6P!Vnibut$y;-mar<}QK~FSiG)1R+ZJq$R7WW5D{p@(9OxZ=y;|XSUJ8sYJ z_HLe>zjQn)?zqe>_oqQP-USP-GL&nVE7$l7WX(8VjP(Ns@}B}@7Vj`b45M60iz8ni zIMcc+(puS=PkSFHkq``vrofD@bA4IzK(JlWxpMeLAD`Q~?kB_*wM*d}u%Fc}=IlF; zI`r=AG9CmMsWtxc#^I;5e_M7pY(V(c!uv6wyNQr04Vu0#7+V^f!{=MJ@9y!(WT`7w zqvqM7fpYfuwz6kyl3)xSgZxxy&~U$yJ|ounEN1HM-HP@jLYr`sAMh&O?xoxC)6FDX zQqU)**$E1tkwGx)&)0Xx-T9SrDSw0uY(*&PamIa4Ci9k6YwaMuooL58Mx+u0=j$dr z#!c_zI;yh~$S z3r}aX-EO{pl=cx&0|1;f=}&={l*EU38{Ha?^9n4rw}QeJPbOr!{5e0vAyiu#_c!Zl z@|?#_w#@35+lwa+Ni^_WdzAg$!Wu3I9>>djn=%}wT#!19H+sS==HRP@t}O{o%=?t- z%G1ADRq>@T>NS(DxvGifoVgm|vFSoG;V_OCe`6Fl?jtS*zK&%WJ+ z6^Ax{{Su9tXW(iIjlu`(JB+04@UKt8pN_TO?sgqdC+n$kF$&@9&O>~IU*qrV+ zd?i#egI*bDV+(ax^Sc_w>>zmA><2-~^-A0T0~*#B>zk=Y5>}bJMH$RiRA*hT|RM?1dl8cX8nLcdUnBg=aR(Lscam)B3h> z>`Re#s?Jj3~v~#WW{v>dCrpuY#bem|! z-zclyF4i1;1pe$ep6K@-c;0r;{NOCtZyKJ*8{%#E{p0GBZSxY1Z+x%tf`A|E!=&p`1HW?X4G0N|`gQlVGnFl~`(OcY=#ys-n|@Kt zqAa3|xQu1%uD9a3i=S#J2_G`NNXXaZmJJ&rcrNV@ukaI|lSn9|{;ZjMRSI*8@KWkc zk&@8e_wZ^1=egJ5E(lRg0U*82=P1kLrGIpTcY2>Ko6+YK)H=Ex!FGqlIss(eTGdCAKwFw%vz~!Cwmr8h+yvJ`R?tGZ=i$< z>aqk?hp(|eE$+Yit>%8W$^;!gdb4Be1De}f_Ozs5qkX-s5R==$pKHFZxWIq*moI$m zBW6Qv?U~(<_*o_~@AlJTd4wPkOP@l}6<(NFk=51J5Rgm7`AMPzl0HOLKI3KS@r2Toef@K!>6--0OefE7Xk z4?|-4#M30Ji*%~YTJPlXbV z_}is(nci&gh!iWYtk3;3|NM9g(x9`1 zne(>&1}Y^__#=pcD!I|nTj?8uD&Vbz`)vZIMyV{GJ%}NB?EClct82-zSUuOeprIlo zWT*j5c%l9L<_6mAd0&Ws;El08gjO@t(=*brzdkq@Te~eiPKr~B7It82y17vwEA1u0 zc_5H<>hO(wxMD&3XTbhz#bTN=>0xT{cO(E0$%l;kU&a>TN9x^$d$7bD%XH)^SryE| z!tA_{j}Lwsh$>mNd^1dBngctP^dsy(q@&T%i{lOhl)(Hv8BKNLt|L|K*c~?2S%h@5 zZmC9YJ+#5DARHN;2Jh~kGZK2+s_~zP8DX)$)2R6PvqMXtszL#GZ`0zXE|9ZL-$NX; zXpSRttUY63F4^aYDM)C*NQDf`6S>a{DjrG?0olbXs;Isp0v5BRxu=%fA)>;uMeN8O z*ZRxF@H$G?QS{vd`ATWPw$`qXyADDVi9!Uh%^CzjKV>jI(P4Cid)2S@(HGL^asyAS zUwPTkrQ~ZRt?HvyRTOmD#5ORziOq&yO!lSe(Too;voxje5Hgvt-Q#%<-UR>6(vkKj za>2S1%B?LC^5ehT?pkkin*pW5+X4xwz=)z?AdsA3NbIpqsg_B3t!wnDF20rZF}}<_ ze#;{*>8*%KDp_YF6~lA?sYhl1TSMC$`b}Z}RUn~=?&58~uMHDKb|r^4Mb@0^OL95Q z{yQG9V-wV%QSytD=A*D91NHAmt+E86*GbO)T>F@gj?R0EvomMKttxrt6x(B6HDjwD zV+v}v&+MDpXL90CrcPxm+re}TcTO$7JE866sn>(P;OF{A)ZL-9MKvQExqz9!>QzFnIpOGLXgtu%%#g)HtplohQ;alMQ28Xs9n zuQJ6Q_{iz3STz||p7g}G7Q@jyJ|uCvVQ`ZTFyXMlCZknRaiV<^N(85j6Y3W3&4U?$ zP<#1)@O>cfOw7ngdZ3{KrptIqLQ+c-tsG4H2}gLE9v_RW&G|y}W+6XxW7Wte&U$r< zBzezkr%(W^oSy(g316`n$Mi8f|TVtbQ#i?7@{M&l$ft?9$zWa3s^%HK@pnj40J)1DGO@+(|tZ(h?; zrm}_{|2?^hjRJzDh{kj8)3iOh*DY109yZWUr$toJAT5FB6@GPB^8KbHop88S$tckw zO6I`!?&$GP*QKa2$CS;U0G71OPFGyg`RJODEOC`s^NG@rJL<7Bsm#6lijo)L!AHBL zn2Eh>fRBqNOe6`N?0h+UGU5i0_WF&U?jX<`rj$sGYm6~4$REtrKD=6>mld-9?(v`h zC(QXiWNWq=NnW|^B|gS2jl2^x4PK{#yuNk0kN8A&8D_%n^YIplPXAf>x{#o}BLgRm zX&v)#nT7c+u4Z>Fdex7#I9MN`?}=M!^(remMt;hu=72a%RF#v5g+izz^X*Ks4`+bU zIG0p8@#A2q2tMl%3QUV0#kYtR$krPT>xSxI!(nqss;d%1Ud*!JS*9HMJuv-SGeA21FJ38(MmB<% zU-51SgG~uPI7%|b(E%#JEnIYe7^6yHupl#Ac{1Wa?{x5xK*O_@8g5SM^zt}HW<;-u z84lBdti}=i(1u1_a?fFi7S(%k_X~p!%R3~J@bzMg*CN;{hA}rHq?bd*p!9;O1+s;I z9$IG0j@i;CPh?E9t*C$?hVObkW>}0AX`nBJ4r`PhT_q)1xA`X!xt+II^iQu$+*v-b zvfA0d$ZTd6=+czG3wIJFjhi|T%Mr+%+Wv6DR}0|zWgQ?n`-ZWBf5L)v0ZQGmB9CL{ zBqAL0ps^^Bf1Vw|!Y#2Kyh%A_-N#lTYgCN7@ogbweE#KfFPkNQUEhBb%Wy(Bb30^P z2oeM$28{>1y!sT-TDB4kBvtg~-%+c^CqeK3(Y^-iU2C*twq9teCca>oy#`4#z^&Oh z$T_>Y0lT7io7xj?67Snd5S1KxIk!QvfThmvsa%uF5#`3(v4L$NC7b1CLiyd9?Lf8) zqG{&=*MF}j0xsQNMZ!$i1NH3TlAGoarJTB09Re@KNV`5@V@QktfUn$YZ=&`oIJH0{ z=OI%z?g{RvmOuO*za9~Zja#7z<$yh5^IkYiuM_m$piFh_K$@iZ%$-ZLu2#7kqRNRp zV3XWVmU!flX0{I|5Dk`m^y~jMz!9TV_ca?-*9)|vGqEt0zv0PP4B`rS7S1)jA z=vLcI1D6O8Z^?OO53s(q7>dD2*BewCVG?Tezt0$z{_Kcq&MCxDJUKIYW-aG=q74Pw zfKXd$(jXnEVuaJLfx6oeOp^R@WKj~O6_V5nRpPUu;F%DZe4XCvt2|`tf$EA^%#^Ju zsj>G5q&BMtWjYDIMwiRMkc|bkdxi@2AEmDQPM$#jV9TGt>RXgjbs>{zb@R=*zwBxm z&iq=Ob&T(24d|P-`ztsE=GyjplJf1(rA6QooZ+Af#pb-V<1wOjWih#r#+{q|64|jc zp2=ZCgqMw!&=A@hgNi|zA5kG6(!-Hn^u9#-qn@Xh950eNe@4yftTdEWq=sOb)V7Nl z!;pdSFx|P;QMF@JQ5F>Buz&GrsqEThRj2a3%jR`N9(5p+)uk7)QZ$Fp@zJAvy$qnk zdE&e9ZwdAak?+eJaG;i=st+wXLbBl_RJqsD_B`VPuH05?StqhatG_Zva1f&5+g^kD zMypRmAwcP+Jsd3Q<&K4x;1Q1h^`B^Y?K@CibSFxaN@}S<%$$biR_ESMM_+?QOU-ss z(T1rGhxYALSQiiD7m~VJxY4Ng;DdQT!%C9G$oDQZ6_N#hkHng2b#C4E5U|+?iXK$O zN|Xv7BdNh$^eLZyku3vCRF-7@9cBi_;%?>sr{+9sRLA3)g07QAidHw

    + * The primary use of ESAPI {@code Encoder} is to prevent XSS vulnerabilities by + * providing output encoding using the various "encodeForXYZ()" methods, + * where XYZ is one of CSS, HTML, HTMLAttribute, JavaScript, or URL. When + * using the ESAPI output encoders, it is important that you use the one for the + * appropriate context where the output will be rendered. For example, it + * the output appears in an JavaScript context, you should use {@code encodeForJavaScript} + * (note this includes all of the DOM JavaScript event handler attributes such as + * 'onfocus', 'onclick', 'onload', etc.). If the output would be rendered in an HTML + * attribute context (with the exception of the aforementioned 'onevent' type event + * handler attributes), you would use {@code encodeForHTMLAttribute}. If you are + * encoding anywhere a URL is expected (e.g., a 'href' attribute for for <a> or + * a 'src' attribute on a <img> tag, etc.), then you should use use {@code encodeForURL}. + * If encoding CSS, then use {@code encodeForCSS}. Etc. This is because there are + * different escaping requirements for these different contexts. Developers who are + * new to ESAPI or to defending against XSS vulnerabilities are highly encouraged to + * first read the + * + * OWASP Cross-Site Scripting Prevention Cheat Sheet. + *