cxf-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From conflue...@apache.org
Subject [CONF] Apache CXF > Tomcat
Date Fri, 11 May 2012 19:58:00 GMT
<html>
<head>
    <base href="https://cwiki.apache.org/confluence">
            <link rel="stylesheet" href="/confluence/s/2042/9/15/_/styles/combined.css?spaceKey=CXF&amp;forWysiwyg=true"
type="text/css">
    </head>
<body style="background: white;" bgcolor="white" class="email-body">
<div id="pageContent">
<div id="notificationFormat">
<div class="wiki-content">
<div class="email">
    <h2><a href="https://cwiki.apache.org/confluence/display/CXF/Tomcat">Tomcat</a></h2>
    <h4>Page <b>edited</b> by             <a href="https://cwiki.apache.org/confluence/display/~owulff@apache.org">Oliver
Wulff</a>
    </h4>
        <br/>
                         <h4>Changes (18)</h4>
                                 
    
<div id="page-diffs">
                    <table class="diff" cellpadding="0" cellspacing="0">
    
            <tr><td class="diff-snipped" >...<br></td></tr>
            <tr><td class="diff-unchanged" > <br>h3. Installation <br></td></tr>
            <tr><td class="diff-deleted-lines" style="color:#999;background-color:#fdd;text-decoration:line-through;">tbd
<br></td></tr>
            <tr><td class="diff-unchanged" > <br></td></tr>
            <tr><td class="diff-added-lines" style="background-color: #dfd;">You
can either build the plugin on your own or download the package here (tbd). If you have built
the plugin on your own you&#39;ll find the required libraries in plugins/tomcat/target/...zip-with-dependencies.zip
<br></td></tr>
            <tr><td class="diff-unchanged" > <br></td></tr>
            <tr><td class="diff-deleted-lines" style="color:#999;background-color:#fdd;text-decoration:line-through;">h3.
Configuration <br></td></tr>
            <tr><td class="diff-unchanged" > <br></td></tr>
            <tr><td class="diff-added-lines" style="background-color: #dfd;">#
Create sub-directory {{fediz}} in {{$\{catalina.home\}/lib}} <br># Update calatina.properties
in $\{catalina.home\}/conf <br>add the previously created directory to the common loader:
<br>{{common.loader=$\{catalina.base\}/lib,$\{catalina.base\}/lib/\*.jar,$\{catalina.home\}/lib,$\{catalina.home\}/lib/\*.jar,$\{catalina.home\}/lib/fediz/\*.jar}}
<br># Deploy the libraries to the directory created in (1) <br></td></tr>
            <tr><td class="diff-unchanged" > <br></td></tr>
            <tr><td class="diff-added-lines" style="background-color: #dfd;">
<br>h3. Configuration <br> <br></td></tr>
            <tr><td class="diff-unchanged" >The current release of the federation
plugin requires to configure the FederationAuthenticator of Fediz like any other Valve in
Tomcat which is described here [here|http://tomcat.apache.org/tomcat-7.0-doc/config/valve.html].
<br> <br></td></tr>
            <tr><td class="diff-snipped" >...<br></td></tr>
            <tr><td class="diff-unchanged" > <br>h5. META-INF/context.xml
<br></td></tr>
            <tr><td class="diff-changed-lines" ><span class="diff-deleted-words"style="color:#999;background-color:#fdd;text-decoration:line-through;">
</span> <span class="diff-added-words"style="background-color: #dfd;">{code:xml}</span>
<br></td></tr>
            <tr><td class="diff-unchanged" >  &lt;Context&gt;  <br>
   &lt;Valve className=&quot;org.apache.cxf.fediz.tomcat.FederationAuthenticator&quot;
<br>      configFile=&quot;conf/Fediz_config.xml&quot; /&gt; <br>
 &lt;/Context&gt;  <br></td></tr>
            <tr><td class="diff-added-lines" style="background-color: #dfd;">{code}
<br></td></tr>
            <tr><td class="diff-unchanged" > <br>h5. Host level in server.xml
<br></td></tr>
            <tr><td class="diff-changed-lines" ><span class="diff-deleted-words"style="color:#999;background-color:#fdd;text-decoration:line-through;">...</span>
<span class="diff-added-words"style="background-color: #dfd;">{code:xml}</span>
<br></td></tr>
            <tr><td class="diff-unchanged" >  &lt;Host name=&quot;localhost&quot;
 appBase=&quot;webapps&quot; <br></td></tr>
            <tr><td class="diff-changed-lines" >unpackWARs=&quot;true&quot;
<span class="diff-changed-words">autoDeploy=&quot;true&quot;<span class="diff-added-chars"style="background-color:
#dfd;">&gt;</span></span> <br></td></tr>
            <tr><td class="diff-deleted-lines" style="color:#999;background-color:#fdd;text-decoration:line-through;">
       xmlValidation=&quot;false&quot; xmlNamespaceAware=&quot;false&quot;&gt;
<br></td></tr>
            <tr><td class="diff-unchanged" >    &lt;Valve className=&quot;org.apache.cxf.fediz.tomcat.FederationAuthenticator&quot;
<br>           configFile=&quot;conf/Fediz_config.xml&quot; /&gt; <br>
 &lt;/Host&gt; <br></td></tr>
            <tr><td class="diff-changed-lines" ><span class="diff-deleted-words"style="color:#999;background-color:#fdd;text-decoration:line-through;">...</span>
<span class="diff-added-words"style="background-color: #dfd;">{code}</span> <br></td></tr>
            <tr><td class="diff-added-lines" style="background-color: #dfd;">
     &lt;Host name=&quot;localhost&quot;  appBase=&quot;webapps&quot;
<br></td></tr>
            <tr><td class="diff-unchanged" > <br></td></tr>
            <tr><td class="diff-deleted-lines" style="color:#999;background-color:#fdd;text-decoration:line-through;">h5.
Context level in server.xml <br></td></tr>
            <tr><td class="diff-added-lines" style="background-color: #dfd;">
           unpackWARs=&quot;true&quot; autoDeploy=&quot;true&quot;&gt;
<br></td></tr>
            <tr><td class="diff-unchanged" > <br></td></tr>
            <tr><td class="diff-added-lines" style="background-color: #dfd;">h5.
Context level in server.xml <br></td></tr>
            <tr><td class="diff-changed-lines" ><span class="diff-deleted-words"style="color:#999;background-color:#fdd;text-decoration:line-through;">...</span>
<span class="diff-added-words"style="background-color: #dfd;">{code:xml}</span>
<br></td></tr>
            <tr><td class="diff-unchanged" >  &lt;Context path=&quot;/fedizhelloworld&quot;
docBase=&quot;fedizhelloworld&quot;&gt; <br>    &lt;Valve className=&quot;org.apache.cxf.fediz.tomcat.FederationAuthenticator&quot;
<br>      configFile=&quot;conf/Fediz_config.xml&quot; /&gt; <br>
 &lt;/Context&gt; <br></td></tr>
            <tr><td class="diff-changed-lines" ><span class="diff-deleted-words"style="color:#999;background-color:#fdd;text-decoration:line-through;">...</span>
<span class="diff-added-words"style="background-color: #dfd;">{code}</span> <br></td></tr>
            <tr><td class="diff-added-lines" style="background-color: #dfd;">
<br>The Fediz configuration file is container independent and described here. <br></td></tr>
    
            </table>
    </div>                            <h4>Full Content</h4>
                    <div class="notificationGreySide">
        <h1><a name="Tomcat-TomcatPlugin"></a>Tomcat Plugin</h1>
<p>This page describes how to enable Federation in Tomcat. This Tomcat instance acts
as the Relying Party which means it validates the incoming SignInResponse which has been created
by the Identity Provider (IDP) server.</p>

<h3><a name="Tomcat-Installation"></a>Installation</h3>

<p>You can either build the plugin on your own or download the package here (tbd). If
you have built the plugin on your own you'll find the required libraries in plugins/tomcat/target/...zip-with-dependencies.zip</p>


<ol>
	<li>Create sub-directory <tt>fediz</tt> in <tt>${catalina.home}/lib</tt></li>
	<li>Update calatina.properties in ${catalina.home}/conf<br/>
add the previously created directory to the common loader:<br/>
<tt>common.loader=${catalina.base}/lib,${catalina.base}/lib/&#42;.jar,${catalina.home}/lib,${catalina.home}/lib/&#42;.jar,${catalina.home}/lib/fediz/&#42;.jar</tt></li>
	<li>Deploy the libraries to the directory created in (1)</li>
</ol>



<h3><a name="Tomcat-Configuration"></a>Configuration</h3>

<p>The current release of the federation plugin requires to configure the FederationAuthenticator
of Fediz like any other Valve in Tomcat which is described here <a href="http://tomcat.apache.org/tomcat-7.0-doc/config/valve.html"
class="external-link" rel="nofollow">here</a>.</p>

<p>A valve can be configured on different levels like <em>Host</em> or <em>Context</em>.
The Fediz configuration file allows to configure all servlet contexts in one file or choose
one file per Servlet Context. If you choose to have one Fediz configuration file per Servlet
Context then you must configure the FederationAuthenticator on the <em>Context</em>
level otherwise on the <em>Host</em> level in the Tomcat configuration file <em>server.xml</em></p>


<p>You can either configure the context in the server.xml or in META-INF/context.xml
as part of your WAR file.</p>

<h5><a name="Tomcat-METAINF%2Fcontext.xml"></a>META-INF/context.xml</h5>
<div class="code panel" style="border-width: 1px;"><div class="codeContent panelContent">
<pre class="code-xml"> 
  <span class="code-tag">&lt;Context&gt;</span> 
    &lt;Valve className=<span class="code-quote">"org.apache.cxf.fediz.tomcat.FederationAuthenticator"</span>
      configFile=<span class="code-quote">"conf/Fediz_config.xml"</span> /&gt;
  <span class="code-tag">&lt;/Context&gt;</span> 
</pre>
</div></div>

<h5><a name="Tomcat-Hostlevelinserver.xml"></a>Host level in server.xml</h5>
<div class="code panel" style="border-width: 1px;"><div class="codeContent panelContent">
<pre class="code-xml"> 
  &lt;Host name=<span class="code-quote">"localhost"</span>  appBase=<span
class="code-quote">"webapps"</span>
        unpackWARs=<span class="code-quote">"true"</span> autoDeploy=<span
class="code-quote">"true"</span>&gt;
    &lt;Valve className=<span class="code-quote">"org.apache.cxf.fediz.tomcat.FederationAuthenticator"</span>
           configFile=<span class="code-quote">"conf/Fediz_config.xml"</span>
/&gt;
  <span class="code-tag">&lt;/Host&gt;</span>
</pre>
</div></div> 
<p>      &lt;Host name="localhost"  appBase="webapps"</p>

<p>            unpackWARs="true" autoDeploy="true"&gt;</p>

<h5><a name="Tomcat-Contextlevelinserver.xml"></a>Context level in server.xml</h5>
<div class="code panel" style="border-width: 1px;"><div class="codeContent panelContent">
<pre class="code-xml"> 
  <span class="code-tag">&lt;Context path=<span class="code-quote">"/fedizhelloworld"</span>
docBase=<span class="code-quote">"fedizhelloworld"</span>&gt;</span>
    &lt;Valve className=<span class="code-quote">"org.apache.cxf.fediz.tomcat.FederationAuthenticator"</span>
      configFile=<span class="code-quote">"conf/Fediz_config.xml"</span> /&gt;
  <span class="code-tag">&lt;/Context&gt;</span>
</pre>
</div></div>

<p>The Fediz configuration file is container independent and described here.</p>


    </div>
        <div id="commentsSection" class="wiki-content pageSection">
        <div style="float: right;">
            <a href="https://cwiki.apache.org/confluence/users/viewnotifications.action"
class="grey">Change Notification Preferences</a>
        </div>
        <a href="https://cwiki.apache.org/confluence/display/CXF/Tomcat">View Online</a>
        |
        <a href="https://cwiki.apache.org/confluence/pages/diffpagesbyversion.action?pageId=27846677&revisedVersion=2&originalVersion=1">View
Changes</a>
                |
        <a href="https://cwiki.apache.org/confluence/display/CXF/Tomcat?showComments=true&amp;showCommentArea=true#addcomment">Add
Comment</a>
            </div>
</div>
</div>
</div>
</div>
</body>
</html>

Mime
View raw message