Subversion Repositories XServices

<?xml version="1.0" encoding="UTF-8"?>

<section xmlns="http://docbook.org/ns/docbook" version="5.0"

	xmlns:xi="http://www.w3.org/2001/XInclude"

	xmlns:xlink="http://www.w3.org/1999/xlink">

		<title>Installation</title>

		<para>As of February 2013, XServices require Java 7. Older builds run against Java 5.</para>

		<para>Apache Tomcat 7</para>

		<para>tbd.</para>

		<para>In short: Deploy .WAR file to Apache Tomcat</para>

		<section>

			<title>Securing with Basic Authentication</title>

			<para>There is a quick guide explaining Basic Authentication for Tomcat here: <link

					xlink:href="http://oreilly.com/pub/a/java/archive/tomcat-tips.html?page=1">

					http://oreilly.com/pub/a/java/archive/tomcat-tips.html?page=1</link>

					</para>

			<para>

			</para>

		</section>

		<section>

			<title>Limit access by IP address</title>

			<para>Sometimes you&apos;ll only want to restrict access to to

				only

				specified host names or IP addresses. This way, only

				clients at

				those specified addresses can use the web services.

				Tomcat provides

				two configuration values for that:

				RemoteHostValve and

				RemoteAddrValve.</para>

			<para>These Valves allow you to filter requests by host name or

				by IP

				address, and to allow or deny hosts that match. The

				example below

				restricts access to the ArchiveService from any

				machine that is not

				the local host.</para>

			<programlisting language="xml">&lt;Context

				path="/XService/ArchiveService"

				...> <Valve

				className="org.apache.catalina.valves.RemoteAddrValve"

				allow="127.0.0.1" deny=""/> </Context>

			</programlisting>

			<para>If no allow pattern is given, then patterns that match

				the deny

				attribute patterns will be rejected, and all others

				will be allowed.

				Similarly, if no deny pattern is given,

				patterns that match the

				allow attribute will be allowed, and

				all others will be denied.

				</para>

			<para>The &lt;context&gt; element must be placed into the

				server.xml

				file (into &lt;engine&gt;&lt;host&gt;).</para>

		</section>

</section>