| 1 |
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN"> |
| 2 |
<html> |
| 3 |
<head> |
| 4 |
</head> |
| 5 |
|
| 6 |
<body bgcolor="white"> |
| 7 |
|
| 8 |
The ESAPI interfaces and {@code Exception} classes model the most |
| 9 |
important security functions to enterprise web applications. |
| 10 |
The interfaces in this package are intended to be extended and |
| 11 |
customized within an enterprise to match their custom data, |
| 12 |
security services, and application environment. A reference |
| 13 |
implementation of this interface is provided as an example of how this |
| 14 |
library can be implemented successfully, but is useful in many ways |
| 15 |
by itself as well. |
| 16 |
<p> |
| 17 |
OWASP ESAPI interfaces and reference implementation provides |
| 18 |
enterprise web application developers with the most important |
| 19 |
security functions they need in ordre to build secure web applications |
| 20 |
and web services that stand up to most common-day web-based attacks. |
| 21 |
</p> |
| 22 |
<h2>Sponsor</h2> |
| 23 |
<p>The <a href="http://www.owasp.org">The Open Web Application |
| 24 |
Security Project (OWASP)</a> is a worldwide free and open community focused |
| 25 |
on improving the security of application software. Our mission is to |
| 26 |
make application security "visible," so that people and organizations |
| 27 |
can make informed decisions about application security risks. Everyone |
| 28 |
is free to participate in OWASP and all of our materials are available |
| 29 |
under an open source license. The OWASP Foundation is a 501c3 |
| 30 |
not-for-profit charitable organization that ensures the ongoing |
| 31 |
availability and support for our work.</p> |
| 32 |
|
| 33 |
<p>The |
| 34 |
<a href="http://www.owasp.org/index.php/Category:OWASP_Enterprise_Security_API"> |
| 35 |
OWASP ESAPI Project</a> |
| 36 |
is led by Jeff Williams, |
| 37 |
<a href="http://www.aspectsecurity.com">Aspect Security</a>. |
| 38 |
|
| 39 |
<p>You can find more information about the ESAPI Java project, or join |
| 40 |
the mailing list and help us make it better from the OWASP project page |
| 41 |
at <a |
| 42 |
href="http://www.owasp.org/index.php/ESAPI#tab=Java_EE">http://www.owasp.org/index.php/ESAPI#tab=Java_EE</a>.</p> |
| 43 |
|
| 44 |
<h2>ESAPI Architecture</h2> |
| 45 |
|
| 46 |
<p>The ESAPI class library builds on the excellent security libraries available, |
| 47 |
such as Java Logging, JCE, and Adobe Commons FileUpload. It uses the |
| 48 |
concepts from many of the security packages out there, such as ACEGI, |
| 49 |
Apache Commons Validator, Microsoft's AntiXSS library, and many many |
| 50 |
more. This library provides a single consistent interface to security |
| 51 |
functions that is intuitive for enterprise developers.</p> |
| 52 |
|
| 53 |
<img src="doc-files/Architecture.jpg"> |
| 54 |
|
| 55 |
<h2>Addressing OWASP Top Ten</h2> |
| 56 |
|
| 57 |
<p>Used properly, the ESAPI provides enough functions to protect |
| 58 |
against most of the |
| 59 |
<a href="http://www.owasp.org/index.php/Category:OWASP_Top_Ten_Project"> |
| 60 |
OWASP Top Ten</a>. The only real exception is the |
| 61 |
Insecure Communications category, which is generally outside the control |
| 62 |
of the software developer.</p> |
| 63 |
<img src="doc-files/OWASPTopTen.jpg"> |
| 64 |
|
| 65 |
<h2>Copyright and License</h2> |
| 66 |
|
| 67 |
<p>This project and all associated code is Copyright (c) 2007 - The OWASP Foundation</p> |
| 68 |
|
| 69 |
<p>This project licensed under the <a href="http://en.wikipedia.org/wiki/BSD_license">BSD license</a>, |
| 70 |
which is very permissive and about as close to public domain as is possible. You can use or modify |
| 71 |
ESAPI however you want, even include it in commercial products.</p> |
| 72 |
|
| 73 |
<h2>References</h2> |
| 74 |
|
| 75 |
This library builds on some of the ideas found in: |
| 76 |
<ul> |
| 77 |
<li><a href="http://www.owasp.org/">OWASP</a></li> |
| 78 |
<li><a href="http://www.microsoft.com/downloads/details.aspx?FamilyId=051ee83c-5ccf-48ed-8463-02f56a6bfc09&displaylang=en">Microsoft's AntiXSS</a></li> |
| 79 |
<li><a href="http://java.sun.com/j2se/1.5.0/docs/guide/security/jce/JCERefGuide.html">Java JCE</a></li> |
| 80 |
<li><a href="http://java.sun.com/j2se/1.5.0/docs/guide/logging/overview.html">Java Logging API</a></li> |
| 81 |
<li><a href="http://commons.apache.org/fileupload/">Apache Commons FileUpload</a></li> |
| 82 |
</ul> |
| 83 |
|
| 84 |
</body> |
| 85 |
</html> |