1 |
10567
|
antonis.le
|
#
|
2 |
|
|
# OWASP Enterprise Security API (ESAPI) Properties file -- PRODUCTION Version
|
3 |
|
|
#
|
4 |
|
|
# This file is part of the Open Web Application Security Project (OWASP)
|
5 |
|
|
# Enterprise Security API (ESAPI) project. For details, please see
|
6 |
|
|
# http://www.owasp.org/index.php/ESAPI.
|
7 |
|
|
#
|
8 |
|
|
# Copyright (c) 2008,2009 - The OWASP Foundation
|
9 |
|
|
#
|
10 |
|
|
# DISCUSS: This may cause a major backwards compatibility issue, etc. but
|
11 |
|
|
# from a name space perspective, we probably should have prefaced
|
12 |
|
|
# all the property names with ESAPI or at least OWASP. Otherwise
|
13 |
|
|
# there could be problems is someone loads this properties file into
|
14 |
|
|
# the System properties. We could also put this file into the
|
15 |
|
|
# esapi.jar file (perhaps as a ResourceBundle) and then allow an external
|
16 |
|
|
# ESAPI properties be defined that would overwrite these defaults.
|
17 |
|
|
# That keeps the application's properties relatively simple as usually
|
18 |
|
|
# they will only want to override a few properties. If looks like we
|
19 |
|
|
# already support multiple override levels of this in the
|
20 |
|
|
# DefaultSecurityConfiguration class, but I'm suggesting placing the
|
21 |
|
|
# defaults in the esapi.jar itself. That way, if the jar is signed,
|
22 |
|
|
# we could detect if those properties had been tampered with. (The
|
23 |
|
|
# code to check the jar signatures is pretty simple... maybe 70-90 LOC,
|
24 |
|
|
# but off course there is an execution penalty (similar to the way
|
25 |
|
|
# that the separate sunjce.jar used to be when a class from it was
|
26 |
|
|
# first loaded). Thoughts?
|
27 |
|
|
###############################################################################
|
28 |
|
|
#
|
29 |
|
|
# WARNING: Operating system protection should be used to lock down the .esapi
|
30 |
|
|
# resources directory and all the files inside and all the directories all the
|
31 |
|
|
# way up to the root directory of the file system. Note that if you are using
|
32 |
|
|
# file-based implementations, that some files may need to be read-write as they
|
33 |
|
|
# get updated dynamically.
|
34 |
|
|
#
|
35 |
|
|
# Before using, be sure to update the MasterKey and MasterSalt as described below.
|
36 |
|
|
# N.B.: If you had stored data that you have previously encrypted with ESAPI 1.4,
|
37 |
|
|
# you *must* FIRST decrypt it using ESAPI 1.4 and then (if so desired)
|
38 |
|
|
# re-encrypt it with ESAPI 2.0. If you fail to do this, you will NOT be
|
39 |
|
|
# able to decrypt your data with ESAPI 2.0.
|
40 |
|
|
#
|
41 |
|
|
# YOU HAVE BEEN WARNED!!! More details are in the ESAPI 2.0 Release Notes.
|
42 |
|
|
#
|
43 |
|
|
#===========================================================================
|
44 |
|
|
# ESAPI Configuration
|
45 |
|
|
#
|
46 |
|
|
# If true, then print all the ESAPI properties set here when they are loaded.
|
47 |
|
|
# If false, they are not printed. Useful to reduce output when running JUnit tests.
|
48 |
|
|
# If you need to troubleshoot a properties related problem, turning this on may help.
|
49 |
|
|
# This is 'false' in the src/test/resources/.esapi version. It is 'true' by
|
50 |
|
|
# default for reasons of backward compatibility with earlier ESAPI versions.
|
51 |
|
|
ESAPI.printProperties=true
|
52 |
|
|
|
53 |
|
|
# ESAPI is designed to be easily extensible. You can use the reference implementation
|
54 |
|
|
# or implement your own providers to take advantage of your enterprise's security
|
55 |
|
|
# infrastructure. The functions in ESAPI are referenced using the ESAPI locator, like:
|
56 |
|
|
#
|
57 |
|
|
# String ciphertext =
|
58 |
|
|
# ESAPI.encryptor().encrypt("Secret message"); // Deprecated in 2.0
|
59 |
|
|
# CipherText cipherText =
|
60 |
|
|
# ESAPI.encryptor().encrypt(new PlainText("Secret message")); // Preferred
|
61 |
|
|
#
|
62 |
|
|
# Below you can specify the classname for the provider that you wish to use in your
|
63 |
|
|
# application. The only requirement is that it implement the appropriate ESAPI interface.
|
64 |
|
|
# This allows you to switch security implementations in the future without rewriting the
|
65 |
|
|
# entire application.
|
66 |
|
|
#
|
67 |
|
|
# ExperimentalAccessController requires ESAPI-AccessControlPolicy.xml in .esapi directory
|
68 |
|
|
ESAPI.AccessControl=org.owasp.esapi.reference.DefaultAccessController
|
69 |
|
|
# FileBasedAuthenticator requires users.txt file in .esapi directory
|
70 |
|
|
ESAPI.Authenticator=org.owasp.esapi.reference.FileBasedAuthenticator
|
71 |
|
|
ESAPI.Encoder=org.owasp.esapi.reference.DefaultEncoder
|
72 |
|
|
ESAPI.Encryptor=org.owasp.esapi.reference.crypto.JavaEncryptor
|
73 |
|
|
|
74 |
|
|
ESAPI.Executor=org.owasp.esapi.reference.DefaultExecutor
|
75 |
|
|
ESAPI.HTTPUtilities=org.owasp.esapi.reference.DefaultHTTPUtilities
|
76 |
|
|
ESAPI.IntrusionDetector=org.owasp.esapi.reference.DefaultIntrusionDetector
|
77 |
|
|
# Log4JFactory Requires log4j.xml or log4j.properties in classpath - http://www.laliluna.de/log4j-tutorial.html
|
78 |
|
|
ESAPI.Logger=org.owasp.esapi.reference.Log4JLogFactory
|
79 |
|
|
#ESAPI.Logger=org.owasp.esapi.reference.JavaLogFactory
|
80 |
|
|
ESAPI.Randomizer=org.owasp.esapi.reference.DefaultRandomizer
|
81 |
|
|
ESAPI.Validator=org.owasp.esapi.reference.DefaultValidator
|
82 |
|
|
|
83 |
|
|
#===========================================================================
|
84 |
|
|
# ESAPI Authenticator
|
85 |
|
|
#
|
86 |
|
|
Authenticator.AllowedLoginAttempts=3
|
87 |
|
|
Authenticator.MaxOldPasswordHashes=13
|
88 |
|
|
Authenticator.UsernameParameterName=username
|
89 |
|
|
Authenticator.PasswordParameterName=password
|
90 |
|
|
# RememberTokenDuration (in days)
|
91 |
|
|
Authenticator.RememberTokenDuration=14
|
92 |
|
|
# Session Timeouts (in minutes)
|
93 |
|
|
Authenticator.IdleTimeoutDuration=20
|
94 |
|
|
Authenticator.AbsoluteTimeoutDuration=120
|
95 |
|
|
|
96 |
|
|
#===========================================================================
|
97 |
|
|
# ESAPI Encoder
|
98 |
|
|
#
|
99 |
|
|
# ESAPI canonicalizes input before validation to prevent bypassing filters with encoded attacks.
|
100 |
|
|
# Failure to canonicalize input is a very common mistake when implementing validation schemes.
|
101 |
|
|
# Canonicalization is automatic when using the ESAPI Validator, but you can also use the
|
102 |
|
|
# following code to canonicalize data.
|
103 |
|
|
#
|
104 |
|
|
# ESAPI.Encoder().canonicalize( "%22hello world"" );
|
105 |
|
|
#
|
106 |
|
|
# Multiple encoding is when a single encoding format is applied multiple times, multiple
|
107 |
|
|
# different encoding formats are applied, or when multiple formats are nested. Allowing
|
108 |
|
|
# multiple encoding is strongly discouraged.
|
109 |
|
|
Encoder.AllowMultipleEncoding=false
|
110 |
|
|
#
|
111 |
|
|
# The default list of codecs to apply when canonicalizing untrusted data. The list should include the codecs
|
112 |
|
|
# for all downstream interpreters or decoders. For example, if the data is likely to end up in a URL, HTML, or
|
113 |
|
|
# inside JavaScript, then the list of codecs below is appropriate. The order of the list is not terribly important.
|
114 |
|
|
Encoder.DefaultCodecList=HTMLEntityCodec,PercentCodec,JavaScriptCodec
|
115 |
|
|
|
116 |
|
|
|
117 |
|
|
#===========================================================================
|
118 |
|
|
# ESAPI Encryption
|
119 |
|
|
#
|
120 |
|
|
# The ESAPI Encryptor provides basic cryptographic functions with a simplified API.
|
121 |
|
|
# To get started, generate a new key using java -classpath esapi.jar org.owasp.esapi.reference.crypto.JavaEncryptor
|
122 |
|
|
# There is not currently any support for key rotation, so be careful when changing your key and salt as it
|
123 |
|
|
# will invalidate all signed, encrypted, and hashed data.
|
124 |
|
|
#
|
125 |
|
|
# WARNING: Not all combinations of algorithms and key lengths are supported.
|
126 |
|
|
# If you choose to use a key length greater than 128, you MUST download the
|
127 |
|
|
# unlimited strength policy files and install in the lib directory of your JRE/JDK.
|
128 |
|
|
# See http://java.sun.com/javase/downloads/index.jsp for more information.
|
129 |
|
|
#
|
130 |
|
|
# Backward compatibility with ESAPI Java 1.4 is supported by the two deprecated API
|
131 |
|
|
# methods, Encryptor.encrypt(String) and Encryptor.decrypt(String). However, whenever
|
132 |
|
|
# possible, these methods should be avoided as they use ECB cipher mode, which in almost
|
133 |
|
|
# all circumstances a poor choice because of it's weakness. CBC cipher mode is the default
|
134 |
|
|
# for the new Encryptor encrypt / decrypt methods for ESAPI Java 2.0. In general, you
|
135 |
|
|
# should only use this compatibility setting if you have persistent data encrypted with
|
136 |
|
|
# version 1.4 and even then, you should ONLY set this compatibility mode UNTIL
|
137 |
|
|
# you have decrypted all of your old encrypted data and then re-encrypted it with
|
138 |
|
|
# ESAPI 2.0 using CBC mode. If you have some reason to mix the deprecated 1.4 mode
|
139 |
|
|
# with the new 2.0 methods, make sure that you use the same cipher algorithm for both
|
140 |
|
|
# (256-bit AES was the default for 1.4; 128-bit is the default for 2.0; see below for
|
141 |
|
|
# more details.) Otherwise, you will have to use the new 2.0 encrypt / decrypt methods
|
142 |
|
|
# where you can specify a SecretKey. (Note that if you are using the 256-bit AES,
|
143 |
|
|
# that requires downloading the special jurisdiction policy files mentioned above.)
|
144 |
|
|
#
|
145 |
|
|
# ***** IMPORTANT: Do NOT forget to replace these with your own values! *****
|
146 |
|
|
# To calculate these values, you can run:
|
147 |
|
|
# java -classpath esapi.jar org.owasp.esapi.reference.crypto.JavaEncryptor
|
148 |
|
|
#
|
149 |
|
|
Encryptor.MasterKey=
|
150 |
|
|
Encryptor.MasterSalt=
|
151 |
|
|
|
152 |
|
|
# Provides the default JCE provider that ESAPI will "prefer" for its symmetric
|
153 |
|
|
# encryption and hashing. (That is it will look to this provider first, but it
|
154 |
|
|
# will defer to other providers if the requested algorithm is not implemented
|
155 |
|
|
# by this provider.) If left unset, ESAPI will just use your Java VM's current
|
156 |
|
|
# preferred JCE provider, which is generally set in the file
|
157 |
|
|
# "$JAVA_HOME/jre/lib/security/java.security".
|
158 |
|
|
#
|
159 |
|
|
# The main intent of this is to allow ESAPI symmetric encryption to be
|
160 |
|
|
# used with a FIPS 140-2 compliant crypto-module. For details, see the section
|
161 |
|
|
# "Using ESAPI Symmetric Encryption with FIPS 140-2 Cryptographic Modules" in
|
162 |
|
|
# the ESAPI 2.0 Symmetric Encryption User Guide, at:
|
163 |
|
|
# http://owasp-esapi-java.googlecode.com/svn/trunk/documentation/esapi4java-core-2.0-symmetric-crypto-user-guide.html
|
164 |
|
|
# However, this property also allows you to easily use an alternate JCE provider
|
165 |
|
|
# such as "Bouncy Castle" without having to make changes to "java.security".
|
166 |
|
|
# See Javadoc for SecurityProviderLoader for further details. If you wish to use
|
167 |
|
|
# a provider that is not known to SecurityProviderLoader, you may specify the
|
168 |
|
|
# fully-qualified class name of the JCE provider class that implements
|
169 |
|
|
# java.security.Provider. If the name contains a '.', this is interpreted as
|
170 |
|
|
# a fully-qualified class name that implements java.security.Provider.
|
171 |
|
|
#
|
172 |
|
|
# NOTE: Setting this property has the side-effect of changing it in your application
|
173 |
|
|
# as well, so if you are using JCE in your application directly rather than
|
174 |
|
|
# through ESAPI (you wouldn't do that, would you? ;-), it will change the
|
175 |
|
|
# preferred JCE provider there as well.
|
176 |
|
|
#
|
177 |
|
|
# Default: Keeps the JCE provider set to whatever JVM sets it to.
|
178 |
|
|
Encryptor.PreferredJCEProvider=
|
179 |
|
|
|
180 |
|
|
# AES is the most widely used and strongest encryption algorithm. This
|
181 |
|
|
# should agree with your Encryptor.CipherTransformation property.
|
182 |
|
|
# By default, ESAPI Java 1.4 uses "PBEWithMD5AndDES" and which is
|
183 |
|
|
# very weak. It is essentially a password-based encryption key, hashed
|
184 |
|
|
# with MD5 around 1K times and then encrypted with the weak DES algorithm
|
185 |
|
|
# (56-bits) using ECB mode and an unspecified padding (it is
|
186 |
|
|
# JCE provider specific, but most likely "NoPadding"). However, 2.0 uses
|
187 |
|
|
# "AES/CBC/PKCSPadding". If you want to change these, change them here.
|
188 |
|
|
# Warning: This property does not control the default reference implementation for
|
189 |
|
|
# ESAPI 2.0 using JavaEncryptor. Also, this property will be dropped
|
190 |
|
|
# in the future.
|
191 |
|
|
# @deprecated
|
192 |
|
|
Encryptor.EncryptionAlgorithm=AES
|
193 |
|
|
# For ESAPI Java 2.0 - New encrypt / decrypt methods use this.
|
194 |
|
|
Encryptor.CipherTransformation=AES/CBC/PKCS5Padding
|
195 |
|
|
|
196 |
|
|
# Applies to ESAPI 2.0 and later only!
|
197 |
|
|
# Comma-separated list of cipher modes that provide *BOTH*
|
198 |
|
|
# confidentiality *AND* message authenticity. (NIST refers to such cipher
|
199 |
|
|
# modes as "combined modes" so that's what we shall call them.) If any of these
|
200 |
|
|
# cipher modes are used then no MAC is calculated and stored
|
201 |
|
|
# in the CipherText upon encryption. Likewise, if one of these
|
202 |
|
|
# cipher modes is used with decryption, no attempt will be made
|
203 |
|
|
# to validate the MAC contained in the CipherText object regardless
|
204 |
|
|
# of whether it contains one or not. Since the expectation is that
|
205 |
|
|
# these cipher modes support support message authenticity already,
|
206 |
|
|
# injecting a MAC in the CipherText object would be at best redundant.
|
207 |
|
|
#
|
208 |
|
|
# Note that as of JDK 1.5, the SunJCE provider does not support *any*
|
209 |
|
|
# of these cipher modes. Of these listed, only GCM and CCM are currently
|
210 |
|
|
# NIST approved. YMMV for other JCE providers. E.g., Bouncy Castle supports
|
211 |
|
|
# GCM and CCM with "NoPadding" mode, but not with "PKCS5Padding" or other
|
212 |
|
|
# padding modes.
|
213 |
|
|
Encryptor.cipher_modes.combined_modes=GCM,CCM,IAPM,EAX,OCB,CWC
|
214 |
|
|
|
215 |
|
|
# Applies to ESAPI 2.0 and later only!
|
216 |
|
|
# Additional cipher modes allowed for ESAPI 2.0 encryption. These
|
217 |
|
|
# cipher modes are in _addition_ to those specified by the property
|
218 |
|
|
# 'Encryptor.cipher_modes.combined_modes'.
|
219 |
|
|
# Note: We will add support for streaming modes like CFB & OFB once
|
220 |
|
|
# we add support for 'specified' to the property 'Encryptor.ChooseIVMethod'
|
221 |
|
|
# (probably in ESAPI 2.1).
|
222 |
|
|
# DISCUSS: Better name?
|
223 |
|
|
Encryptor.cipher_modes.additional_allowed=CBC
|
224 |
|
|
|
225 |
|
|
# 128-bit is almost always sufficient and appears to be more resistant to
|
226 |
|
|
# related key attacks than is 256-bit AES. Use '_' to use default key size
|
227 |
|
|
# for cipher algorithms (where it makes sense because the algorithm supports
|
228 |
|
|
# a variable key size). Key length must agree to what's provided as the
|
229 |
|
|
# cipher transformation, otherwise this will be ignored after logging a
|
230 |
|
|
# warning.
|
231 |
|
|
#
|
232 |
|
|
# NOTE: This is what applies BOTH ESAPI 1.4 and 2.0. See warning above about mixing!
|
233 |
|
|
Encryptor.EncryptionKeyLength=128
|
234 |
|
|
|
235 |
|
|
# Because 2.0 uses CBC mode by default, it requires an initialization vector (IV).
|
236 |
|
|
# (All cipher modes except ECB require an IV.) There are two choices: we can either
|
237 |
|
|
# use a fixed IV known to both parties or allow ESAPI to choose a random IV. While
|
238 |
|
|
# the IV does not need to be hidden from adversaries, it is important that the
|
239 |
|
|
# adversary not be allowed to choose it. Also, random IVs are generally much more
|
240 |
|
|
# secure than fixed IVs. (In fact, it is essential that feed-back cipher modes
|
241 |
|
|
# such as CFB and OFB use a different IV for each encryption with a given key so
|
242 |
|
|
# in such cases, random IVs are much preferred. By default, ESAPI 2.0 uses random
|
243 |
|
|
# IVs. If you wish to use 'fixed' IVs, set 'Encryptor.ChooseIVMethod=fixed' and
|
244 |
|
|
# uncomment the Encryptor.fixedIV.
|
245 |
|
|
#
|
246 |
|
|
# Valid values: random|fixed|specified 'specified' not yet implemented; planned for 2.1
|
247 |
|
|
Encryptor.ChooseIVMethod=random
|
248 |
|
|
# If you choose to use a fixed IV, then you must place a fixed IV here that
|
249 |
|
|
# is known to all others who are sharing your secret key. The format should
|
250 |
|
|
# be a hex string that is the same length as the cipher block size for the
|
251 |
|
|
# cipher algorithm that you are using. The following is an example for AES
|
252 |
|
|
# from an AES test vector for AES-128/CBC as described in:
|
253 |
|
|
# NIST Special Publication 800-38A (2001 Edition)
|
254 |
|
|
# "Recommendation for Block Cipher Modes of Operation".
|
255 |
|
|
# (Note that the block size for AES is 16 bytes == 128 bits.)
|
256 |
|
|
#
|
257 |
|
|
Encryptor.fixedIV=0x000102030405060708090a0b0c0d0e0f
|
258 |
|
|
|
259 |
|
|
# Whether or not CipherText should use a message authentication code (MAC) with it.
|
260 |
|
|
# This prevents an adversary from altering the IV as well as allowing a more
|
261 |
|
|
# fool-proof way of determining the decryption failed because of an incorrect
|
262 |
|
|
# key being supplied. This refers to the "separate" MAC calculated and stored
|
263 |
|
|
# in CipherText, not part of any MAC that is calculated as a result of a
|
264 |
|
|
# "combined mode" cipher mode.
|
265 |
|
|
#
|
266 |
|
|
# If you are using ESAPI with a FIPS 140-2 cryptographic module, you *must* also
|
267 |
|
|
# set this property to false.
|
268 |
|
|
Encryptor.CipherText.useMAC=true
|
269 |
|
|
|
270 |
|
|
# Whether or not the PlainText object may be overwritten and then marked
|
271 |
|
|
# eligible for garbage collection. If not set, this is still treated as 'true'.
|
272 |
|
|
Encryptor.PlainText.overwrite=true
|
273 |
|
|
|
274 |
|
|
# Do not use DES except in a legacy situations. 56-bit is way too small key size.
|
275 |
|
|
#Encryptor.EncryptionKeyLength=56
|
276 |
|
|
#Encryptor.EncryptionAlgorithm=DES
|
277 |
|
|
|
278 |
|
|
# TripleDES is considered strong enough for most purposes.
|
279 |
|
|
# Note: There is also a 112-bit version of DESede. Using the 168-bit version
|
280 |
|
|
# requires downloading the special jurisdiction policy from Sun.
|
281 |
|
|
#Encryptor.EncryptionKeyLength=168
|
282 |
|
|
#Encryptor.EncryptionAlgorithm=DESede
|
283 |
|
|
|
284 |
|
|
Encryptor.HashAlgorithm=SHA-512
|
285 |
|
|
Encryptor.HashIterations=1024
|
286 |
|
|
Encryptor.DigitalSignatureAlgorithm=DSA
|
287 |
|
|
Encryptor.DigitalSignatureKeyLength=1024
|
288 |
|
|
Encryptor.RandomAlgorithm=SHA1PRNG
|
289 |
|
|
Encryptor.CharacterEncoding=UTF-8
|
290 |
|
|
|
291 |
|
|
|
292 |
|
|
#===========================================================================
|
293 |
|
|
# ESAPI HttpUtilties
|
294 |
|
|
#
|
295 |
|
|
# The HttpUtilities provide basic protections to HTTP requests and responses. Primarily these methods
|
296 |
|
|
# protect against malicious data from attackers, such as unprintable characters, escaped characters,
|
297 |
|
|
# and other simple attacks. The HttpUtilities also provides utility methods for dealing with cookies,
|
298 |
|
|
# headers, and CSRF tokens.
|
299 |
|
|
#
|
300 |
|
|
# Default file upload location (remember to escape backslashes with \\)
|
301 |
|
|
HttpUtilities.UploadDir=C:\\ESAPI\\testUpload
|
302 |
|
|
HttpUtilities.UploadTempDir=C:\\temp
|
303 |
|
|
# Force flags on cookies, if you use HttpUtilities to set cookies
|
304 |
|
|
HttpUtilities.ForceHttpOnlySession=false
|
305 |
|
|
HttpUtilities.ForceSecureSession=false
|
306 |
|
|
HttpUtilities.ForceHttpOnlyCookies=true
|
307 |
|
|
HttpUtilities.ForceSecureCookies=true
|
308 |
|
|
# File upload configuration
|
309 |
|
|
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
|
310 |
|
|
HttpUtilities.MaxUploadFileBytes=500000000
|
311 |
|
|
# Using UTF-8 throughout your stack is highly recommended. That includes your database driver,
|
312 |
|
|
# container, and any other technologies you may be using. Failure to do this may expose you
|
313 |
|
|
# to Unicode transcoding injection attacks. Use of UTF-8 does not hinder internationalization.
|
314 |
|
|
HttpUtilities.ResponseContentType=text/html; charset=UTF-8
|
315 |
|
|
|
316 |
|
|
|
317 |
|
|
|
318 |
|
|
#===========================================================================
|
319 |
|
|
# ESAPI Executor
|
320 |
|
|
# CHECKME - Not sure what this is used for, but surely it should be made OS independent.
|
321 |
|
|
Executor.WorkingDirectory=C:\\Windows\\Temp
|
322 |
|
|
Executor.ApprovedExecutables=C:\\Windows\\System32\\cmd.exe,C:\\Windows\\System32\\runas.exe
|
323 |
|
|
|
324 |
|
|
|
325 |
|
|
#===========================================================================
|
326 |
|
|
# ESAPI Logging
|
327 |
|
|
# Set the application name if these logs are combined with other applications
|
328 |
|
|
Logger.ApplicationName=ExampleApplication
|
329 |
|
|
# If you use an HTML log viewer that does not properly HTML escape log data, you can set LogEncodingRequired to true
|
330 |
|
|
Logger.LogEncodingRequired=false
|
331 |
|
|
# Determines whether ESAPI should log the application name. This might be clutter in some single-server/single-app environments.
|
332 |
|
|
Logger.LogApplicationName=true
|
333 |
|
|
# Determines whether ESAPI should log the server IP and port. This might be clutter in some single-server environments.
|
334 |
|
|
Logger.LogServerIP=true
|
335 |
|
|
# LogFileName, the name of the logging file. Provide a full directory path (e.g., C:\\ESAPI\\ESAPI_logging_file) if you
|
336 |
|
|
# want to place it in a specific directory.
|
337 |
|
|
Logger.LogFileName=ESAPI_logging_file
|
338 |
|
|
# MaxLogFileSize, the max size (in bytes) of a single log file before it cuts over to a new one (default is 10,000,000)
|
339 |
|
|
Logger.MaxLogFileSize=10000000
|
340 |
|
|
|
341 |
|
|
|
342 |
|
|
#===========================================================================
|
343 |
|
|
# ESAPI Intrusion Detection
|
344 |
|
|
#
|
345 |
|
|
# Each event has a base to which .count, .interval, and .action are added
|
346 |
|
|
# The IntrusionException will fire if we receive "count" events within "interval" seconds
|
347 |
|
|
# The IntrusionDetector is configurable to take the following actions: log, logout, and disable
|
348 |
|
|
# (multiple actions separated by commas are allowed e.g. event.test.actions=log,disable
|
349 |
|
|
#
|
350 |
|
|
# Custom Events
|
351 |
|
|
# Names must start with "event." as the base
|
352 |
|
|
# Use IntrusionDetector.addEvent( "test" ) in your code to trigger "event.test" here
|
353 |
|
|
# You can also disable intrusion detection completely by changing
|
354 |
|
|
# the following parameter to true
|
355 |
|
|
#
|
356 |
|
|
IntrusionDetector.Disable=false
|
357 |
|
|
#
|
358 |
|
|
IntrusionDetector.event.test.count=2
|
359 |
|
|
IntrusionDetector.event.test.interval=10
|
360 |
|
|
IntrusionDetector.event.test.actions=disable,log
|
361 |
|
|
|
362 |
|
|
# Exception Events
|
363 |
|
|
# All EnterpriseSecurityExceptions are registered automatically
|
364 |
|
|
# Call IntrusionDetector.getInstance().addException(e) for Exceptions that do not extend EnterpriseSecurityException
|
365 |
|
|
# Use the fully qualified classname of the exception as the base
|
366 |
|
|
|
367 |
|
|
# any intrusion is an attack
|
368 |
|
|
IntrusionDetector.org.owasp.esapi.errors.IntrusionException.count=1
|
369 |
|
|
IntrusionDetector.org.owasp.esapi.errors.IntrusionException.interval=1
|
370 |
|
|
IntrusionDetector.org.owasp.esapi.errors.IntrusionException.actions=log,disable,logout
|
371 |
|
|
|
372 |
|
|
# for test purposes
|
373 |
|
|
# CHECKME: Shouldn't there be something in the property name itself that designates
|
374 |
|
|
# that these are for testing???
|
375 |
|
|
IntrusionDetector.org.owasp.esapi.errors.IntegrityException.count=10
|
376 |
|
|
IntrusionDetector.org.owasp.esapi.errors.IntegrityException.interval=5
|
377 |
|
|
IntrusionDetector.org.owasp.esapi.errors.IntegrityException.actions=log,disable,logout
|
378 |
|
|
|
379 |
|
|
# rapid validation errors indicate scans or attacks in progress
|
380 |
|
|
# org.owasp.esapi.errors.ValidationException.count=10
|
381 |
|
|
# org.owasp.esapi.errors.ValidationException.interval=10
|
382 |
|
|
# org.owasp.esapi.errors.ValidationException.actions=log,logout
|
383 |
|
|
|
384 |
|
|
# sessions jumping between hosts indicates session hijacking
|
385 |
|
|
IntrusionDetector.org.owasp.esapi.errors.AuthenticationHostException.count=2
|
386 |
|
|
IntrusionDetector.org.owasp.esapi.errors.AuthenticationHostException.interval=10
|
387 |
|
|
IntrusionDetector.org.owasp.esapi.errors.AuthenticationHostException.actions=log,logout
|
388 |
|
|
|
389 |
|
|
|
390 |
|
|
#===========================================================================
|
391 |
|
|
# ESAPI Validation
|
392 |
|
|
#
|
393 |
|
|
# The ESAPI Validator works on regular expressions with defined names. You can define names
|
394 |
|
|
# either here, or you may define application specific patterns in a separate file defined below.
|
395 |
|
|
# This allows enterprises to specify both organizational standards as well as application specific
|
396 |
|
|
# validation rules.
|
397 |
|
|
#
|
398 |
|
|
Validator.ConfigurationFile=validation.properties
|
399 |
|
|
|
400 |
|
|
# Validators used by ESAPI
|
401 |
|
|
Validator.AccountName=^[a-zA-Z0-9]{3,20}$
|
402 |
|
|
Validator.SystemCommand=^[a-zA-Z\\-\\/]{1,64}$
|
403 |
|
|
Validator.RoleName=^[a-z]{1,20}$
|
404 |
|
|
|
405 |
|
|
#the word TEST below should be changed to your application
|
406 |
|
|
#name - only relative URL's are supported
|
407 |
|
|
Validator.Redirect=^\\/test.*$
|
408 |
|
|
|
409 |
|
|
# Global HTTP Validation Rules
|
410 |
|
|
# Values with Base64 encoded data (e.g. encrypted state) will need at least [a-zA-Z0-9\/+=]
|
411 |
|
|
Validator.HTTPScheme=^(http|https)$
|
412 |
|
|
Validator.HTTPServerName=^[a-zA-Z0-9_.\\-]*$
|
413 |
|
|
Validator.HTTPParameterName=^[a-zA-Z0-9_]{1,32}$
|
414 |
|
|
Validator.HTTPParameterValue=^[a-zA-Z0-9.\\-\\/+=_ ]*$
|
415 |
|
|
Validator.HTTPCookieName=^[a-zA-Z0-9\\-_]{1,32}$
|
416 |
|
|
Validator.HTTPCookieValue=^[a-zA-Z0-9\\-\\/+=_ ]*$
|
417 |
|
|
Validator.HTTPHeaderName=^[a-zA-Z0-9\\-_]{1,32}$
|
418 |
|
|
Validator.HTTPHeaderValue=^[a-zA-Z0-9()\\-=\\*\\.\\?;,+\\/:&_ ]*$
|
419 |
|
|
Validator.HTTPContextPath=^[a-zA-Z0-9.\\-_]*$
|
420 |
|
|
Validator.HTTPPath=^[a-zA-Z0-9.\\-_]*$
|
421 |
|
|
Validator.HTTPQueryString=^[a-zA-Z0-9()\\-=\\*\\.\\?;,+\\/:&_ %]*$
|
422 |
|
|
Validator.HTTPURI=^[a-zA-Z0-9()\\-=\\*\\.\\?;,+\\/:&_ ]*$
|
423 |
|
|
Validator.HTTPURL=^.*$
|
424 |
|
|
Validator.HTTPJSESSIONID=^[A-Z0-9]{10,30}$
|
425 |
|
|
|
426 |
|
|
# Validation of file related input
|
427 |
|
|
Validator.FileName=^[a-zA-Z0-9!@#$%^&{}\\[\\]()_+\\-=,.~'` ]{1,255}$
|
428 |
|
|
Validator.DirectoryName=^[a-zA-Z0-9:/\\\\!@#$%^&{}\\[\\]()_+\\-=,.~'` ]{1,255}$
|