13.7.4. HTTP/REDIRECT バインディングを使用したサービスプロバイダーの設定

手順13.2 サービスプロバイダー(SP)の設定

1. SP の Web アプリケーションセキュリティーの設定

   SP として設定される web アプリケーションは、web.xml ファイルで FORM ベースのセキュリティーを有効にする必要があります。

   例13.11 SP の web.xml 設定

   <display-name>SP</display-name>
   <description>SP</description>
   <!-- Define a security constraint that gives unlimited access to images -->
   <security-constraint>
     <web-resource-collection>
       <web-resource-name>Images</web-resource-name>
       <url-pattern>/images/*</url-pattern>
     </web-resource-collection>
   </security-constraint>
   <!-- Define a Security Constraint on this Application -->
   <security-constraint>
     <web-resource-collection>
       <web-resource-name>SP</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>FORM</auth-method>
     <realm-name>SP Application</realm-name>
     <form-login-config>
       <form-login-page>/jsp/login.jsp</form-login-page>
       <form-error-page>/jsp/loginerror.jsp</form-error-page>
     </form-login-config>
   </login-config>
   <!-- Security roles referenced by this web application -->
   <security-role>
       <description>
      The role that is required to log in to the SP Application
     </description>
     <role-name>manager</role-name>
   </security-role>
   </web-app>
   

   Copy to Clipboard Toggle word wrap

2. SP のセキュリティードメインの作成

   SAML2LoginModule を使用するセキュリティードメインを作成します。以下は設定例です。

   <security-domain name="sp" cache-type="default">
     <authentication>
       <login-module code="org.picketlink.identity.federation.bindings.jboss.auth.SAML2LoginModule" flag="required"/>
      </authentication>
   </security-domain>
   

   Copy to Clipboard Toggle word wrap

3. SP バルブの設定

   SP にバルブを設定するには、SP web アプリケーションの WEB-INF ディレクトリーに jboss-web.xml を作成します。

   例13.12 SP バルブの jboss-web.xml ファイル設定

   <jboss-web>
     <security-domain>sp</security-domain>
     <context-root>sales-post</context-root>
     <valve>
       <class-name>org.picketlink.identity.federation.bindings.tomcat.sp.ServiceProviderAuthenticator</class-name>
     </valve>
   </jboss-web>
   

   Copy to Clipboard Toggle word wrap

4. PicketLink 設定ファイル(picketlink.xml)の設定

   以下は、SP の picketlink.xml の設定例です。この設定ファイルでは、SP の URL および IDP の URL を SP に対応するハンドラーとともに提供します。

   例13.13 picketlink.xml Configuration

   <PicketLink xmlns="urn:picketlink:identity-federation:config:2.1">
     <PicketLinkSP xmlns="urn:picketlink:identity-federation:config:2.1" ServerEnvironment="tomcat" BindingType="REDIRECT">
       <IdentityURL>${idp.url::http://localhost:8080/idp/}</IdentityURL>
       <ServiceURL>${sales-post.url::http://localhost:8080/sales-post/}</ServiceURL>
     </PicketLinkSP>
     <Handlers xmlns="urn:picketlink:identity-federation:handler:config:2.1">
       <Handler class="org.picketlink.identity.federation.web.handlers.saml2.SAML2LogOutHandler" />
       <Handler class="org.picketlink.identity.federation.web.handlers.saml2.SAML2AuthenticationHandler" />
       <Handler class="org.picketlink.identity.federation.web.handlers.saml2.RolesGenerationHandler" />
     </Handlers>
   </PicketLink>
   

   Copy to Clipboard Toggle word wrap
   デフォルトでは、picketlink.xml はアプリケーションの WEB-INF ディレクトリーにあります。ただし、アプリケーションの外部にある picketlink.xml へのカスタムパスを設定できます。

   1. オプション： カスタムパスを picketlink.xmlに設定する設定

      アプリケーションの WEB-INF/jboss-web.xml の valve 要素に 2 つのパラメーターを追加します。configFile は、picketlink.xml へのパスに指定し、設定を再読み込みする間隔をミリ秒単位で指定する timerInterval です。以下に例を示します。

      <valve>
        <class-name>...</class-name>
          <param>
            <param-name>timerInterval</param-name>
            <param-value>5000</param-value>
          </param>
          <param>
            <param-name>configFile</param-name>
            <param-value>path-to/picketlink.xml</param-value>
          </param>
      </valve>
      

      Copy to Clipboard Toggle word wrap

5. PicketLink モジュールの依存関係を宣言します（META-INF/MANIFEST.MF または jboss-deployment-structure.xml）。

   Web アプリケーションには、PicketLink クラスを配置するために META-INF/MANIFEST.MF または jboss-deployment-structure.xml を定義する依存関係も必要です。

   例13.14 META-INF/MANIFEST.MFへの依存関係の定義

   Manifest-Version: 1.0
       Build-Jdk: 1.6.0_24
       Dependencies: org.picketlink

   Copy to Clipboard Toggle word wrap

   例13.15 META-INF/jboss-deployment-structure.xmlで依存関係を定義

   <jboss-deployment-structure>  
     <deployment>    
       <dependencies>
         <module name="org.picketlink" />
       </dependencies>
     </deployment>
   </jboss-deployment-structure>
   

   Copy to Clipboard Toggle word wrap