Tomcat Valve: Difference between revisions

From RavenWiki
Jump to navigationJump to search
(Mention servlet filter)
(Add some installation instructions and note about the github project)
Line 1: Line 1:
William Billingsley ([[person:whb21 | whb21]] at cam.ac.uk) has written a Raven valve for Tomcat based on the [[Raven Java Toolkit]]. It is available as [http://raven.cam.ac.uk/project/java-toolkit/files/ Java source] and in a [http://raven.cam.ac.uk/project/java-toolkit/files/ .jar archive packed with a copy of the toolkit].
William Billingsley ([[person:whb21 | whb21]] at cam.ac.uk) has written a Raven valve for Tomcat based on the [[Raven Java Toolkit]]. It is available as [http://raven.cam.ac.uk/project/java-toolkit/files/ Java source], in a [http://raven.cam.ac.uk/project/java-toolkit/files/ .jar archive packed with a copy of the toolkit] and as a [https://github.com/ucam-cl-dtg/ucam-webauth-tomcat github project].


He writes:
He writes:
Line 12: Line 12:


See also [http://raven.cam.ac.uk/project/java-toolkit/ Java Toolkit], [[Servlet filter]], [[Tomcat authenticator and JAAS implementation]] and [[JAVA Servlet Library]].
See also [http://raven.cam.ac.uk/project/java-toolkit/ Java Toolkit], [[Servlet filter]], [[Tomcat authenticator and JAAS implementation]] and [[JAVA Servlet Library]].
==Installation==
These instructions are for Ubuntu/Debian and tomcat6, alteration may be required for other OSes/tomcat versions
* Add webauth.jar and webauth-tomcat.jar to /usr/share/tomcat6/lib/ probably by symlinking to the jar which is stored somewhere more sensible like /usr/local/share/java/ or if you have done pom to deb conversion (untested) then  they should be in /usr/share/java/.
* Install [https://raven.cam.ac.uk/project/keys/ raven_pubkey.crt] into /etc/tomcat6/
* Modify /etc/tomcat6/server.xml to add the following to the relevant Engine
<pre><nowiki>
      <!-- Use the raven valve to restrict access -->
      <Valve className="uk.ac.cam.ucs.webauth.tomcat.RavenValve"/>
</nowiki></pre>

Revision as of 11:05, 20 June 2012

William Billingsley ( whb21 at cam.ac.uk) has written a Raven valve for Tomcat based on the Raven Java Toolkit. It is available as Java source, in a .jar archive packed with a copy of the toolkit and as a github project.

He writes:

"I had to write this quickly for one of our servers. I'm sending it to the list because presumably others might need one too, and when I emailed Jon Warbrick in September he didn't have one. Alpha quality, but seems to work for me.
"source and jar attached. JAR also includes the webauth toolkit classes from the Raven project site so you can just drop it into server/lib and configure the valve in server.xml
"works for Tomcat 5.5, probably won't work for older Tomcat versions".

The valve is distributed under the terms of the GNU Lesser General Public License.

See also Java Toolkit, Servlet filter, Tomcat authenticator and JAAS implementation and JAVA Servlet Library.

Installation

These instructions are for Ubuntu/Debian and tomcat6, alteration may be required for other OSes/tomcat versions

  • Add webauth.jar and webauth-tomcat.jar to /usr/share/tomcat6/lib/ probably by symlinking to the jar which is stored somewhere more sensible like /usr/local/share/java/ or if you have done pom to deb conversion (untested) then they should be in /usr/share/java/.
  • Install raven_pubkey.crt into /etc/tomcat6/
  • Modify /etc/tomcat6/server.xml to add the following to the relevant Engine
      <!-- Use the raven valve to restrict access -->
      <Valve className="uk.ac.cam.ucs.webauth.tomcat.RavenValve"/>