[Sharing the Jetspeed Realm Across Tomcat Webapps]複数のTomcat Web アプリケーション間でのJetspeedレルムを共有化

This guide provides a tutorial for creating a shared authentication Realm between multiple webapps running in the same Tomcat(>=5.5) container.

このガイドは、同じTomcat(v5.5以上)コンテナ上の複数のWeb アプリケーションの間で、 共有された認証レルムを作成するためのチュートリアルを提供します。

[1. The Jetspeed Realm]1. Jetspeed レルム

Realms are configured in the Engine element of $CATALINA_HOME/conf/server.xml. Move the Jetspeed Realm element from $CATALINA_HOME/conf/Catalina/localhost/jetspeed.xml to $CATALINA_HOME/conf/server.xml replacng or commenting out the UserDatabase Realm. 

<Realm className="org.apache.catalina.realm.JAASRealm"
           appName="Jetspeed"
           userClassNames="org.apache.jetspeed.security.impl.UserPrincipalImpl"
           roleClassNames="org.apache.jetspeed.security.impl.RolePrincipalImpl"
           useContextClassLoader="false"
           debug="0"/>

レルムは$CATALINA_HOME/conf/server.xmlのEngine要素で構成されます。 Jetspeedレルム要素を$CATALINA_HOME/conf/Catalina/localhost/jetspeed.xmlから、UserDatabaseレルムを置き換えもしくはコメントアウトした$CATALINA_HOME/conf/server.xmlへ移動してください。 

<Realm className="org.apache.catalina.realm.JAASRealm"
           appName="Jetspeed"
           userClassNames="org.apache.jetspeed.security.impl.UserPrincipalImpl"
           roleClassNames="org.apache.jetspeed.security.impl.RolePrincipalImpl"
           useContextClassLoader="false"
           debug="0"/>

[2. Enable the Tomcat SingleSignOn Valve]2. Tomcatのシングルサインオンバルブを使用可能にしてください

Uncomment the Tomcat single sign on Valve in $CATALINA_HOME/conf/server.xml. 

<Host name="localhost" appBase="webapps">
    <!-- Enable tomcat SSO *** -->
    <Valve className="org.apache.catalina.authenticator.SingleSignOn" />
</Host>

$CATALINA_HOME/conf/server.xml内のTomcatのシングルサインオンバルブのコメントを外してください。 

<Host name="localhost" appBase="webapps">
    <!-- tomcat SSOを使用可能にしてください *** -->
    <Valve className="org.apache.catalina.authenticator.SingleSignOn" />
</Host>

[3. Each web.xml]3. 各web.xml

Create a security-constraint in each webapp web.xml descriptor. 

  <security-constraint>
    <web-resource-collection>
       <web-resource-name>Whatever</web-resource-name>
       <url-pattern>/*</url-pattern>
    </web-resource-collection>
    <auth-constraint>
      <role-name>manager</role-name>
    </auth-constraint>
  </security-constraint>

  <!-- Define the Login Configuration for this Application -->
  <login-config>
    <auth-method>BASIC</auth-method>
    <realm-name>Jetspeed</realm-name>
  </login-config>

  <!-- Security roles referenced by this web application -->
  <security-role>
    <description>
        The role that is required to log in to the Manager Application
    </description>
    <role-name>manager</role-name>
  </security-role>

それぞれのWeb アプリケーションのweb.xml記述でセキュリティ規制を作成してください。 

  <security-constraint>
    <web-resource-collection>
       <web-resource-name>Whatever</web-resource-name>
       <url-pattern>/*</url-pattern>
    </web-resource-collection>
    <auth-constraint>
      <role-name>manager</role-name>
    </auth-constraint>
  </security-constraint>

  <!-- アプリケーションのためにログイン構成を定義してください。 -->
  <login-config>
    <auth-method>BASIC</auth-method>
    <realm-name>Jetspeed</realm-name>
  </login-config>

  <!-- このウェブアプリケーションで参照されるセキュリティの役割 -->
  <security-role>
    <description>
        The role that is required to log in to the Manager Application
    </description>
    <role-name>manager</role-name>
  </security-role>

[4. Known Issues]4. 既知の問題

1. The default Tomcat Realm must be replaced, removed, or commented out. A known side effect of this prevents the Tomcat manager application from working. It can be resolved by using the Jetspeed realm in $CATALINA_HOME/server/webapps/manager/manager.xml. 

  <login-config>
    <auth-method>BASIC</auth-method>
    <realm-name>Jetspeed</realm-name>
  </login-config>

1. デフォルトTomcat レルムは置き換えられなければならないか、取り除かれなければならないか、コメントアウトされなければなりません。この既知の副作用は、Tomcatマネージャアプリケーションが働くのを防ぎます。それは、$CATALINA_HOME/server/webapps/manager/manager.xmlのJetspeedレルムを用いて解決することができます。 

  <login-config>
    <auth-method>BASIC</auth-method>
    <realm-name>Jetspeed</realm-name>
  </login-config>

2. Authentication must be made in Jetspeed before accessing other webapps.

2. 他のwebappsにアクセスする前に、Jetspeedで認証を作成しなければなりません。