Subversion Repositories XServices

Rev

Rev 59 | Rev 166 | Go to most recent revision | Only display areas with differences | Ignore whitespace | Details | Blame | Last modification | View Log | RSS feed

Rev 59 Rev 159
1 
<?xml version="1.0" encoding="UTF-8"?>
 1 
<?xml version="1.0" encoding="UTF-8"?>
2 
<section xmlns="http://docbook.org/ns/docbook" version="5.0"
 2 
<section xmlns="http://docbook.org/ns/docbook" version="5.0"
3 
	xmlns:xi="http://www.w3.org/2001/XInclude"
 3 
	xmlns:xi="http://www.w3.org/2001/XInclude"
4 
	xmlns:xlink="http://www.w3.org/1999/xlink">
 4 
	xmlns:xlink="http://www.w3.org/1999/xlink">
5 
 
 5 
 
6 
	<section>
 6 
	<section>
7 
		<title>Installation</title>
 7 
		<title>Installation</title>
8 
		<para>tbd.</para>
 - 
 
9 
		<para>Sun Java SE 1.6.0</para>
 8 
		<para>As of February 2013, XServices require Java 7. Older builds run against Java 5.</para>
10 
		<para>Apache Tomcat 7</para>
 9 
		<para>Apache Tomcat 7</para>
11 
		<para>tbd.</para>
 10 
		<para>tbd.</para>
12 
		<para>In short: Deploy .WAR file to Apache Tomcat</para>
 11 
		<para>In short: Deploy .WAR file to Apache Tomcat</para>
13 
		<section>
 12 
		<section>
14 
			<title>Securing with Basic Authentication</title>
 13 
			<title>Securing with Basic Authentication</title>
15 
			<para>There is a quick guide explaining Basic Authentication for Tomcat here: <link
 14 
			<para>There is a quick guide explaining Basic Authentication for Tomcat here: <link
16 
					xlink:href="http://oreilly.com/pub/a/java/archive/tomcat-tips.html?page=1">
 15 
					xlink:href="http://oreilly.com/pub/a/java/archive/tomcat-tips.html?page=1">
17 
					http://oreilly.com/pub/a/java/archive/tomcat-tips.html?page=1</link>
 16 
					http://oreilly.com/pub/a/java/archive/tomcat-tips.html?page=1</link>
18 
					</para>
 17 
					</para>
19 
			<para>
 18 
			<para>
20
19
21 
			</para>
 20 
			</para>
22 
		</section>
 21 
		</section>
23 
		<section>
 22 
		<section>
24 
			<title>Limit access to</title>
 23 
			<title>Limit access to</title>
25 
			<para>Sometimes you&apos;ll only want to restrict access to to
 24 
			<para>Sometimes you&apos;ll only want to restrict access to to
26 
				only
 25 
				only
27 
				specified host names or IP addresses. This way, only
 26 
				specified host names or IP addresses. This way, only
28 
				clients at
 27 
				clients at
29 
				those specified addresses can use the web services.
 28 
				those specified addresses can use the web services.
30 
				Tomcat provides
 29 
				Tomcat provides
31 
				two configuration values for that:
 30 
				two configuration values for that:
32 
				RemoteHostValve and
 31 
				RemoteHostValve and
33 
				RemoteAddrValve.</para>
 32 
				RemoteAddrValve.</para>
34 
			<para>These Valves allow you to filter requests by host name or
 33 
			<para>These Valves allow you to filter requests by host name or
35 
				by IP
 34 
				by IP
36 
				address, and to allow or deny hosts that match. The
 35 
				address, and to allow or deny hosts that match. The
37 
				example below
 36 
				example below
38 
				restricts access to the ArchiveService from any
 37 
				restricts access to the ArchiveService from any
39 
				machine that is not
 38 
				machine that is not
40 
				the local host.</para>
 39 
				the local host.</para>
41 
			<programlisting language="xml">&lt;Context
 40 
			<programlisting language="xml">&lt;Context
42 
				path=&quot;/XService/ArchiveService&quot;
 41 
				path=&quot;/XService/ArchiveService&quot;
43 
				...&gt; &lt;Valve
 42 
				...&gt; &lt;Valve
44 
				className=&quot;org.apache.catalina.valves.RemoteAddrValve&quot;
 43 
				className=&quot;org.apache.catalina.valves.RemoteAddrValve&quot;
45 
				allow=&quot;127.0.0.1&quot; deny=&quot;&quot;/&gt; &lt;/Context&gt;
 44 
				allow=&quot;127.0.0.1&quot; deny=&quot;&quot;/&gt; &lt;/Context&gt;
46 
			</programlisting>
 45 
			</programlisting>
47 
			<para>If no allow pattern is given, then patterns that match
 46 
			<para>If no allow pattern is given, then patterns that match
48 
				the deny
 47 
				the deny
49 
				attribute patterns will be rejected, and all others
 48 
				attribute patterns will be rejected, and all others
50 
				will be allowed.
 49 
				will be allowed.
51 
				Similarly, if no deny pattern is given,
 50 
				Similarly, if no deny pattern is given,
52 
				patterns that match the
 51 
				patterns that match the
53 
				allow attribute will be allowed, and
 52 
				allow attribute will be allowed, and
54 
				all others will be denied.
 53 
				all others will be denied.
55 
				</para>
 54 
				</para>
56 
			<para>The &lt;context&gt; element must be placed into the
 55 
			<para>The &lt;context&gt; element must be placed into the
57 
				server.xml
 56 
				server.xml
58 
				file (into &lt;engine&gt;&lt;host&gt;).</para>
 57 
				file (into &lt;engine&gt;&lt;host&gt;).</para>
59 
		</section>
 58 
		</section>
60 
	</section>
 59 
	</section>
61 
</section>
 60 
</section>
62 
 
 61 
 
63 
Generated by GNU Enscript 1.6.5.90.
 62 
Generated by GNU Enscript 1.6.5.90.
64 
 
 63 
 
65 
 
 64