Skip to content

Commit 40026bf

Browse files
committed
Add 2 properties associated w/ disabling stuff by default.
1 parent 849c15e commit 40026bf

File tree

1 file changed

+34
-0
lines changed

1 file changed

+34
-0
lines changed

src/test/resources/esapi/ESAPI.properties

Lines changed: 34 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -578,3 +578,37 @@ Validator.AcceptLenientDates=false
578578
#
579579
#Validator.HtmlValidationAction=clean
580580
Validator.HtmlValidationAction=throw
581+
582+
########################################################################################
583+
# The following methods are now disabled in the default configuration and must
584+
# be explicity enabled. If you try to invoke a method disabled by default, ESAPI
585+
# will thrown a NotConfiguredByDefaultException.
586+
#
587+
# The reason for this varies, but ranges from they are not really suitable for
588+
# enterprise scale to that are only marginally tested (if at all) versus the are
589+
# unsafe for general use, although them may be fine when combined with other
590+
# security-in-depth techiques.
591+
#
592+
# The disabled-by-default methods are:
593+
# org.owasp.esapi.reference.DefaultEncoder.encodeForSQL
594+
# org.owasp.esapi.ESAPI.accessController [FUTURE]
595+
#
596+
# The format is a comma-separated list of fully,Qualified.ClassNames.methodName
597+
#
598+
# Note to ESAPI Devs: There is presently no way to specific which specific
599+
# method to indicate here when the method name alone,
600+
# absent from its signature, is ambiguous, so it is
601+
# best to avoid those if at all possible!
602+
#
603+
# An example of that would be something like:
604+
# org.owasp.esapi.reference.DefaultValidator.getValidPrintable
605+
# which has 4 interfaces so currently, there's no way to
606+
# specify a specific one.
607+
#
608+
ESAPI.enableLegCannonModeAndGetMyAssFired.methodNames=org.owasp.esapi.reference.DefaultEncoder.encodeForSQL
609+
610+
# Normally you would put some text here (that will be logged) that provides some
611+
# justification as to why you have enabled these functions. This can be
612+
# anythuing such as a Jira or ServiceNow ticket number, a security exception
613+
# reference, etc. If it is left empty, it will just like "Justification: none".`
614+
ESAPI.enableLegCannonModeAndGetMyAssFired.justification=blah,blah. Please don't fire my @$$. Ticket # 12345

0 commit comments

Comments
 (0)