[pal-cvs 3459] [1193] added cookietranserfilter.

svnno****@sourc***** svnno****@sourc*****
2008年 9月 28日 (日) 09:51:43 JST


Revision: 1193
          http://svn.sourceforge.jp/cgi-bin/viewcvs.cgi?root=pal&view=rev&rev=1193
Author:   shinsuke
Date:     2008-09-28 09:51:43 +0900 (Sun, 28 Sep 2008)

Log Message:
-----------
added cookietranserfilter.

Modified Paths:
--------------
    pal-portal/docs/ja/configuration-guide/trunk/xdocs/navigation.xml

Added Paths:
-----------
    pal-portal/docs/ja/configuration-guide/trunk/xdocs/security/transferfilter.xml


-------------- next part --------------
Modified: pal-portal/docs/ja/configuration-guide/trunk/xdocs/navigation.xml
===================================================================
--- pal-portal/docs/ja/configuration-guide/trunk/xdocs/navigation.xml	2008-09-28 00:51:13 UTC (rev 1192)
+++ pal-portal/docs/ja/configuration-guide/trunk/xdocs/navigation.xml	2008-09-28 00:51:43 UTC (rev 1193)
@@ -41,6 +41,7 @@
       <item name="資格管理" href="security/credential.html"/>
       <item name="ポートレットからの利用" href="security/portlet.html"/>
       <item name="認証フィルター" href="security/authfilter.html"/>
+      <item name="情報転送フィルター" href="security/transferfilter.html"/>
     </menu>
     <menu name="デザイン">
       <item name="デザインについて" href="design/guide.html"/>

Added: pal-portal/docs/ja/configuration-guide/trunk/xdocs/security/transferfilter.xml
===================================================================
--- pal-portal/docs/ja/configuration-guide/trunk/xdocs/security/transferfilter.xml	                        (rev 0)
+++ pal-portal/docs/ja/configuration-guide/trunk/xdocs/security/transferfilter.xml	2008-09-28 00:51:43 UTC (rev 1193)
@@ -0,0 +1,100 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<document>
+  <properties>
+    <title>設定</title>
+    <subtitle>情報転送フィルター</subtitle>
+    <authors>
+      <person name="菅谷信介" email="shins****@yahoo*****"/>
+    </authors>
+  </properties>
+  <body>
+    <section name="情報転送フィルターについて">
+      <p>
+PALポータルにログイン後、そのログインユーザーの情報を他アプリケーションに転送するためのフィルターを提供しています。
+このフィルターを利用することで、他アプリケーションに対して、シングルサインオン環境を実現することができます。
+      </p>
+    </section>
+    <section name="認証フィルターの種類">
+      <p>
+PALポータルでは、次の認証フィルターを提供しています。
+<ul>
+<li>jp.sf.pal.portal.filter.CookieTransferFilter: ユーザー名やユーザー情報をクッキーに設定します。</li>
+</ul>
+      </p>
+    </section>
+    <section name="初期値">
+      <p>
+web.xml で filter 要素内の init-param 要素で値を指定できます。
+      </p>
+<subsection name="transferred.info">
+<p>
+<ul>
+<li>転送対象の情報を指定する。転送対象となる情報は、ユーザー情報(JSR 168 PLT.17)として格納されている情報です。それ以外にユーザーIDをusernameとして定義しています。</li>
+<li>「名前キー=値キー」を , 区切りで指定する。名前キーがクッキーでキーとして利用されます。値キーはユーザー情報で利用されるキーの部分または username を利用します。</li>
+</ul>
+</p>
+</subsection>
+<subsection name="path">
+<p>
+<ul>
+<li>クッキーに指定する際の path として渡される情報。</li>
+</ul>
+</p>
+</subsection>
+<subsection name="domain">
+<p>
+<ul>
+<li>クッキーに指定する際の domain として渡される情報。</li>
+</ul>
+</p>
+</subsection>
+<subsection name="max.age">
+<p>
+<ul>
+<li>クッキーに指定する際の maxAge として渡される情報。</li>
+</ul>
+</p>
+</subsection>
+<subsection name="secure">
+<p>
+<ul>
+<li>クッキーに指定する際の secure として渡される情報。</li>
+</ul>
+</p>
+</subsection>
+    </section>
+    <section name="設定方法">
+<p>
+web.xml に以下のように記述します。
+</p>
+<source><![CDATA[
+...
+  <filter>
+    <filter-name>CookieTransferFilter</filter-name>
+    <filter-class>jp.sf.pal.portal.filter.CookieTransferFilter</filter-class>
+    <init-param>
+      <param-name>transferred.info</param-name>
+      <param-value>H=username,NAME=user.name.given</param-value>
+    </init-param>
+    <init-param>
+      <param-name>path</param-name>
+      <param-value>/</param-value>
+    </init-param>
+    <init-param>
+      <param-name>max.age</param-name>
+      <param-value>-1</param-value>
+    </init-param>
+  </filter>
+...
+  <filter-mapping>
+    <filter-name>CookieTransferFilter</filter-name>
+    <url-pattern>/*</url-pattern>
+  </filter-mapping>
+...
+]]></source>
+      <p>
+設定を保存し、ポータルを再起動後に有効になります。
+      </p>
+    </section>
+  </body>
+</document>


Property changes on: pal-portal/docs/ja/configuration-guide/trunk/xdocs/security/transferfilter.xml
___________________________________________________________________
Name: svn:eol-style
   + native


pal-cvs メーリングリストの案内