cxf-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From conflue...@apache.org
Subject [CONF] Apache CXF > Fediz Tomcat
Date Tue, 05 Jun 2012 20:27: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/Fediz+Tomcat">Fediz
Tomcat</a></h2>
    <h4>Page <b>edited</b> by             <a href="https://cwiki.apache.org/confluence/display/~mazzag">Glen
Mazza</a>
    </h4>
        <div id="versionComment">
        <b>Comment:</b>
        Editorial cleanup.<br />
    </div>
        <br/>
                         <h4>Changes (2)</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" >The Fediz related configuration is
Container independent and described [here|Fediz Configuration]. <br> <br></td></tr>
            <tr><td class="diff-changed-lines" >The Fediz plugin requires <span
class="diff-deleted-words"style="color:#999;background-color:#fdd;text-decoration:line-through;">to
configure</span> <span class="diff-added-words"style="background-color: #dfd;">configuring</span>
the FederationAuthenticator like any other Valve in Tomcat which is described here [here|http://tomcat.apache.org/tomcat-7.0-doc/config/valve.html].
<br></td></tr>
            <tr><td class="diff-unchanged" > <br></td></tr>
            <tr><td class="diff-changed-lines" >A valve can be configured on different
levels like _Host_ or _Context_. The Fediz configuration file allows to configure all servlet
contexts in one file or <span class="diff-deleted-words"style="color:#999;background-color:#fdd;text-decoration:line-through;">choose</span>
<span class="diff-added-words"style="background-color: #dfd;">choosing</span>
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 _Context_ level otherwise
on the _Host_ level in the Tomcat configuration file _server.xml_ <br></td></tr>
            <tr><td class="diff-unchanged" > <br> <br></td></tr>
            <tr><td class="diff-snipped" >...<br></td></tr>
    
            </table>
    </div>                            <h4>Full Content</h4>
                    <div class="notificationGreySide">
        <p><img class="emoticon" src="/confluence/images/icons/emoticons/warning.gif"
height="16" width="16" align="absmiddle" alt="" border="0"/> Under construction</p>

<h1><a name="FedizTomcat-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="FedizTomcat-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="FedizTomcat-Configuration"></a>Configuration</h3>

<p>The Fediz related configuration is Container independent and described <a href="/confluence/display/CXF/Fediz+Configuration"
title="Fediz Configuration">here</a>.</p>

<p>The Fediz plugin requires configuring the FederationAuthenticator 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 choosing
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="FedizTomcat-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="FedizTomcat-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> 

<h5><a name="FedizTomcat-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/Fediz+Tomcat">View
Online</a>
        |
        <a href="https://cwiki.apache.org/confluence/pages/diffpagesbyversion.action?pageId=27846677&revisedVersion=9&originalVersion=8">View
Changes</a>
                |
        <a href="https://cwiki.apache.org/confluence/display/CXF/Fediz+Tomcat?showComments=true&amp;showCommentArea=true#addcomment">Add
Comment</a>
            </div>
</div>
</div>
</div>
</div>
</body>
</html>

Mime
View raw message