blob: 6344fc33f5968b6fa3e987658eb0481d9d3bc840 [file] [log] [blame]
<?xml version="1.0"?>
<!DOCTYPE document [
<!ENTITY project SYSTEM "project.xml">
]>
<document url="index.html">
&project;
<properties>
<author email="mturk@apache.org">Mladen Turk</author>
<author email="rjung@apache.org">Rainer Jung</author>
<title>Documentation Index</title>
</properties>
<body>
<section name="Introduction">
<p>This is the top-level entry point of the documentation bundle for the
<strong>Apache Tomcat Connectors</strong>
</p>
<p>Select one of the links from the navigation menu (to the left) to drill
down to the more detailed documentation that is available. Each available
manual is described in more detail below.</p>
</section>
<section name="Headlines">
<br />
<ul>
<li><a href="news/20070301.html#20070518.1">18 May 2007 - <b>JK-1.2.23 released</b></a>
<p>The Apache Tomcat team is proud to announce the immediate availability
of Tomcat Connectors 1.2.23 Stable.
</p>
<p>This version addresses the security flaw:
<br />
<a href="http://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2007-1860"><b>CVE-2007-1860</b></a>
A double encoded ".." in a URL can be used to access URLs on the AJP backend,
for which no mod_jk forwarding rule exists (patch for CVE-2007-0450 was insufficient).
</p><p>
This version fixes the problem by using ForwardURICompatUnparsed
as the default for the forwarding JkOption.
You can similarly fix the problem for all previous versions of mod_jk by setting
"JkOption ForwardURICompatUnparsed".
If you upgrade to version 1.2.23 please ensure, that you do not have
a different forwarding option in your existing configuration.
We highly recommend, that you are consulting the
<a href="reference/apache.html#Forwarding">forwarding documentation</a>,
especially concerning the implications for interaction with mod_rewrite.
</p><p>
Please note that this issue only affects configurations,
which use a prefix forwarding rule like "/myapp/*" or "/myapp/*.jsp"
to restrict access to the context "/myapp". The issue will allow
malicious URLs to reach "/otherapp" or "/otherapp/*.jsp" as well.
</p><p>
The Tomcat Project thanks Kazu Nambo for his responsible reporting of this
vulnerability.
</p>
<p>Download the <a href="http://www.apache.org/dist/tomcat/tomcat-connectors/jk/source/jk-1.2.23/tomcat-connectors-1.2.23-src.tar.gz">JK 1.2.23 release sources</a>
| <a href="http://www.apache.org/dist/tomcat/tomcat-connectors/jk/source/jk-1.2.23/tomcat-connectors-1.2.23-src.tar.gz.asc">PGP signature</a>
</p>
<p>Download the <a href="http://www.apache.org/dist/tomcat/tomcat-connectors/jk/binaries/">binaries</a> for selected platforms.
</p>
</li>
<li><a href="news/20070301.html#20070417.1">17 April 2007 - <b>JK-1.2.22 released</b></a>
<p>The Apache Tomcat team is proud to announce the immediate availability
of Tomcat Connectors 1.2.22 Stable.
</p>
<p>Download the <a href="http://www.apache.org/dist/tomcat/tomcat-connectors/jk/source/jk-1.2.22/tomcat-connectors-1.2.22-src.tar.gz">JK 1.2.22 release sources</a>
| <a href="http://www.apache.org/dist/tomcat/tomcat-connectors/jk/source/jk-1.2.22/tomcat-connectors-1.2.22-src.tar.gz.asc">PGP signature</a>
</p>
<p>Download the <a href="http://www.apache.org/dist/tomcat/tomcat-connectors/jk/binaries/">binaries</a> for selected platforms.
</p>
</li>
<li><a href="news/20070301.html#20070301.1">1 March 2007 - <b>JK-1.2.21 released</b></a>
<p>The Apache Tomcat team is proud to announce the immediate availability
of Tomcat Connectors 1.2.21 Stable.
</p>
<p>This version addresses the security flaw:
<br />
<a href="http://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2007-0774"><b>CVE-2007-0774</b></a>
A Long URL Stack Overflow Vulnerability exists in the URI handler for the mod_jk library.
When parsing a long URL request, the URI worker map routine performs an
unsafe memory copy. This results in a stack overflow condition which can
be leveraged execute arbitrary code.
</p><p>
Please note this issue only affected versions 1.2.19 and 1.2.20 of the
JK Apache Tomcat Connector and not previous versions.
Tomcat 5.5.20 and Tomcat 4.1.34
included a vulnerable version in their source packages.
<strong>No </strong>other source code releases <strong> and no binary packages</strong>
of Tomcat were affected.
</p><p>
The Apache Tomcat project recommends that all users who have built mod_jk from source apply the patch or upgrade to the latest level and rebuild. Providers of mod_jk-based modules in pre-compiled form will be able to determine if this vulnerability applies to their builds. That determination has no bearing on any other builds of mod_jk, and mod_jk users are urged to exercise caution and apply patches or upgrade unless they have specific instructions from the provider of their module.
</p><p>
The Tomcat Project thanks an anonymous researcher working with
TippingPoint (www.tippingpoint.com) and the Zero Day Initiative
(www.zerodayintiative.com) for their responsible reporting of this
vulnerability.
</p>
<p>Download the <a href="http://www.apache.org/dist/tomcat/tomcat-connectors/jk/source/jk-1.2.21/tomcat-connectors-1.2.21-src.tar.gz">JK 1.2.21 release sources</a>
| <a href="http://www.apache.org/dist/tomcat/tomcat-connectors/jk/source/jk-1.2.21/tomcat-connectors-1.2.21-src.tar.gz.asc">PGP signature</a>
</p>
<p>Download the <a href="http://www.apache.org/dist/tomcat/tomcat-connectors/jk/binaries/">binaries</a> for selected platforms.
</p>
</li>
<li><a href="news/20060101.html#20061210.1">10 December 2006 - <b>JK-1.2.20 released</b></a>
<p>The Apache Tomcat team is proud to announce the immediate availability
of Tomcat Connectors 1.2.20 Stable.
</p>
<p>Download the <a href="http://www.apache.org/dist/tomcat/tomcat-connectors/jk/source/jk-1.2.20/tomcat-connectors-1.2.20-src.tar.gz">JK 1.2.20 release sources</a>
| <a href="http://www.apache.org/dist/tomcat/tomcat-connectors/jk/source/jk-1.2.20/tomcat-connectors-1.2.20-src.tar.gz.asc">PGP signature</a>
</p>
<p>Download the <a href="http://www.apache.org/dist/tomcat/tomcat-connectors/jk/binaries/">binaries</a> for selected platforms.
</p>
</li>
<li><a href="news/20060101.html#20060917.1">17 September 2006 - <b>JK-1.2.19 released</b></a>
<p>The Apache Tomcat team is proud to announce the immediate availability
of Tomcat Connectors 1.2.19 Stable.
</p>
<p>Download the <a href="http://www.apache.org/dist/tomcat/tomcat-connectors/jk/source/jk-1.2.19/tomcat-connectors-1.2.19-src.tar.gz">JK 1.2.19 release sources</a>
| <a href="http://www.apache.org/dist/tomcat/tomcat-connectors/jk/source/jk-1.2.19/tomcat-connectors-1.2.19-src.tar.gz.asc">PGP signature</a>
</p>
<p>Download the <a href="http://www.apache.org/dist/tomcat/tomcat-connectors/jk/binaries/">binaries</a> for selected platforms.
</p>
</li>
</ul>
</section>
<section name="Reference Guide">
<br />
<ul>
<li><a href="reference/workers.html"><b>workers.properties</b></a>
<p>A Tomcat worker is a Tomcat instance that is waiting to execute servlets
on behalf of some web server. For example, we can have a web server such as Apache
forwarding servlet requests to a Tomcat process (the worker) running behind it.
</p>
<p>This page contains detailed description of all workers.properties
directives.
</p>
</li>
<li><a href="reference/uriworkermap.html"><b>uriworkermap.properties</b></a>
<p>
The forwarding of requests from the web server to tomcat gets configured by defining mapping rules.
The so-called <b>uriworkermap</b> file is a mechanism of defining those rules.
</p>
</li>
<li><a href="reference/apache.html"><b>Apache</b></a>
<p>This page contains detailed description of all directives related to
Apache web server.
</p>
</li>
<li><a href="reference/iis.html"><b>IIS</b></a>
<p>This page contains detailed description of all IIS directives.
</p>
</li>
</ul>
</section>
<section name="Generic HowTo">
<br />
<ul>
<li><a href="generic_howto/quick.html"><b>Quick Start</b></a>
<p>This page describes the configuration files used by JK on the
Web Server side for the 'impatients'.
</p>
</li>
<li><a href="generic_howto/workers.html"><b>All about workers</b></a>
<p>This page contains an overview about the various aspects of defining
and using workers.
</p>
</li>
<li><a href="generic_howto/loadbalancers.html"><b>Load Balancing</b></a>
<p>This page contains an introduction on load balancing with JK.
</p>
</li>
</ul>
</section>
<section name="Webserver HowTo">
<br />
<p>These pages contain detailed descriptions of how to build and
install JK for the various web servers.
</p>
<ul>
<li><a href="webserver_howto/apache.html"><b>Apache</b></a>
</li>
<li><a href="webserver_howto/iis.html"><b>IIS</b></a>
</li>
<li><a href="webserver_howto/nes.html"><b>Netscape/SunOne/Sun</b></a>
</li>
</ul>
</section>
<section name="AJP Protocol Reference">
<br />
<ul>
<li><a href="ajp/ajpv13a.html"><b>AJPv13</b></a>
<p>This page describes the Apache JServ Protocol version 1.3 (hereafter
<b>ajp13</b>).
</p>
</li>
<li><a href="ajp/ajpv13ext.html"><b>AJPv13 Extension Proposal</b></a>
<p>This page describes an extension proposal for ajp13.
</p>
</li>
</ul>
</section>
<section name="Miscellaneous documentation">
<br />
<ul>
<li><a href="miscellaneous/faq.html"><b>Frequently asked questions</b></a>
<p>
</p>
</li>
<li><a href="miscellaneous/changelog.html"><b>Changelog</b></a>
<p>
The FAQ detail the changes made in each version of JK.
</p>
</li>
<li><a href="http://issues.apache.org/bugzilla/buglist.cgi?query_format=advanced&amp;short_desc_type=allwordssubstr&amp;short_desc=&amp;product=Tomcat+5&amp;component=Native%3AJK&amp;long_desc_type=substring&amp;long_desc=&amp;bug_file_loc_type=allwordssubstr&amp;bug_file_loc=&amp;keywords_type=allwords&amp;keywords=&amp;bug_status=NEW&amp;bug_status=ASSIGNED&amp;bug_status=REOPENED&amp;emailassigned_to1=1&amp;emailtype1=substring&amp;email1=&amp;emailassigned_to2=1&amp;emailreporter2=1&amp;emailcc2=1&amp;emailtype2=substring&amp;email2=&amp;bugidtype=include&amp;bug_id=&amp;votes=&amp;chfieldfrom=&amp;chfieldto=Now&amp;chfieldvalue=&amp;cmdtype=doit&amp;order=Reuse+same+sort+as+last+time&amp;field0-0-0=noop&amp;type0-0-0=noop&amp;value0-0-0=">
<b>Current Native:JK bugs</b></a>
<p>This is the Bugzilla Bug List related to Native:JK.
</p>
</li>
<li><a href="miscellaneous/doccontrib.html"><b>Contribute documentation</b></a>
<p>
This page describes, how to contribute to the JK documentation.
</p>
</li>
<li><a href="miscellaneous/tools.html"><b>Tools</b></a>
<p>
This page contains information, on some tool scripts contained in the Jk distribution.
</p>
</li>
<li><a href="http://tomcat.apache.org/connectors-doc-archive/jk2/index.html">
<b>Old JK/JK2 documentation archive.</b></a>
<p>Here you can find old JK and JK2 documentation.
</p>
</li>
</ul>
</section>
<section name="News">
<br />
<p>Release news from various years.
</p>
<ul>
<li><a href="news/20070301.html"><b>2007</b></a>
</li>
<li><a href="news/20060101.html"><b>2006</b></a>
</li>
<li><a href="news/20050101.html"><b>2005</b></a>
</li>
<li><a href="news/20041100.html"><b>2004</b></a>
</li>
</ul>
</section>
</body>
</document>