10.3.1. 概要¶

統合Windows認証機能は、ドメインコントローラ上の認証済みユーザと同じユーザコードをもつユーザで intra-mart Accel Platform アクセス時に、統合Windows認証済みユーザ情報を取得して自動ログインを行うことができる機能です。

これにより、シングルサインオンを実現することができます。

注意

ログイン画面からのログインはサポートしません。詳しくは以下の制限を参照してください。

SSO（SingleSignOn）環境での注意点があります。

10.3.2. 前提条件¶

• アプリケーションサーバには Resin を使用してください。

• Resin を Windows Server 上で動作させる必要があります。

• Resin を実行する Windows Server がドメインに参加している必要があります。

• 統合Windows認証モジュールが必要になります。

  • IM-Juggling 上で「追加機能」-「統合Windows認証モジュール」を選択し intra-mart Accel Platform を構築する必要があります。
  • 統合Windows認証モジュールは、8.0.0-PATCH_001 以降のバージョンを使用してください。

注意

シングルサインオンを実現するためには、ドメインコントローラ上のユーザコードと intra-mart Accel Platform 上のユーザコードが一致している必要があります。

注意

統合Windows認証機能には、ドメインコントローラ、統合Windows認証に対応したブラウザが必要になります。

注意

統合Windows認証は intra-mart Accel Platform の機能として Resin 上で実行されます。そのため、IIS の Windows 認証を無効化してください。

その他認証は必要に応じて設定してください。

10.3.3. セットアップ¶

10.3.4. 統合Windows認証機能を無効化するには¶

統合Windows認証機能を無効化したい場合、以下の手順を実施するか、または単に統合Windows認証モジュールを含めずに war を作成し、再デプロイを行ってください。

1. <（展開したwar）>/WEB-INF/conf/im-sso-windows-config.xml ファイルを開きます。

   • <im-sso-windows-config>/<authentication>/<@enable> を false に設定します。

     <?xml version="1.0" encoding="UTF-8"?>
     <im-sso-windows-config
         xmlns="http://www.intra-mart.jp/sso-windows/config/im-sso-windows-config"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://www.intra-mart.jp/sso-windows/config/im-sso-windows-config ../schema/im-sso-windows-config.xsd">
     
       <authentication enable="false"> <!-- enable="false" を設定 -->
         <parameter>
           <param-name>allow-guest-login</param-name>
           <param-value>false</param-value>
         </parameter>
       </authentication>
     </im-sso-windows-config>
     

2. <（展開したwar）>/WEB-INF/plugin/jp.co.intra_mart.foundation.security.certification.sso.user.provider.windows_8.0.0/plugin.xml ファイルを開きます。

   • <plugin>/<extension>/<sso-user-providers>/<@enable> を false に設定します（enable 属性がない場合、追加してください）

     <?xml version="1.0" encoding="UTF-8"?>
     <plugin>
       <extension point="jp.co.intra_mart.foundation.security.certification.sso.user.providers">
         <sso-user-providers
           id="jp.co.intra_mart.foundation.security.certification.sso.user.provider.windows"
           name="Windows SSO User Provider"
           version="8.0.0"
           rank="90"
           enable="false">　<!-- enable="false" を設定または追加 -->
           <sso-user-provider class="jp.co.intra_mart.foundation.security.certification.sso.WindowsSSOUserProvider"/>
         </sso-user-providers>
       </extension>
     </plugin>
     

3. <（展開したwar）>/WEB-INF/plugin/jp.co.intra_mart.foundation.admin.tenant.context.tenant.resolver.windows_8.0.1/plugin.xml ファイルを開きます。

   • <plugin>/<extension>/<tenant-id-resolvers>/<@enable> を false に設定します（enable 属性がない場合、追加してください）

     <?xml version="1.0" encoding="UTF-8"?>
     <plugin>
       <extension point="jp.co.intra_mart.foundation.admin.tenant.context.tenant.resolvers">
         <tenant-id-resolvers
           id="jp.co.intra_mart.foundation.admin.tenant.context.tenant.resolver.windows"
           name="Windows Tenant Id Resolver"
           version="8.0.1"
           rank="90"
           enable="false">　<!-- enable="false" を設定または追加 -->
     
           <!-- ドメインをテナントIDとするリゾルバー
                参加しているドメインをテナントIDとして解決します。 -->
           <!--tenant-id-resolver class="jp.co.intra_mart.foundation.admin.tenant.context.DomainBasedWindowsTenantIdResolver"/-->
     
           <!-- 設定された固定値をテナントIDとするリゾルバー
                tenant_idパラメータに設定した値をテナントIDとして解決します。 -->
           <!--tenant-id-resolver class="jp.co.intra_mart.foundation.admin.tenant.context.FixedConfigBasedWindowsTenantIdResolver">
             <init-param>
               <param-name>tenant_id</param-name>
               <param-value>default</param-value>
             </init-param>
           </tenant-id-resolver-->
         </tenant-id-resolvers>
       </extension>
     </plugin>
     

4. <（展開したwar）>/WEB-INF/plugin/jp.co.intra_mart.foundation.admin.tenant.context.tenant.validator.windows_8.0.1/plugin.xml ファイルを開きます。

   • <plugin>/<extension>/<tenant-id-validators>/<@enable> を false に設定します

     <?xml version="1.0" encoding="UTF-8"?>
     <plugin>
       <extension point="jp.co.intra_mart.foundation.admin.tenant.context.tenant.validators">
         <tenant-id-validators
           id="jp.co.intra_mart.foundation.admin.tenant.context.tenant.validator.windows"
           name="Windows TenantIdValidator"
           version="8.0.1"
           rank="100"
           enable="false"> <!-- enable="false" を設定 -->
           <tenant-id-validator class="jp.co.intra_mart.system.sso_windows.context.WindowsSSOTenantIdValidator">
             <!-- テナントID解決必須チェック -->
             <init-param>
               <param-name>required_tenant_id</param-name>
               <param-value>true</param-value>
             </init-param>
             <!-- テナントID存在チェック -->
             <init-param>
               <param-name>valid_tenant_id</param-name>
               <param-value>true</param-value>
             </init-param>
           </tenant-id-validator>
         </tenant-id-validators>
       </extension>
     </plugin>
     

     コラム

     intra-mart Accel Platform 2014 Spring(Granada) 以前の場合、<plugin>/<extension>/<tenant-id-validators>/<@id> 等の設定値が上記と異なる場合がありますが、手順通り enable=”false” を設定してください。

10.3.5. 統合Windows認証機能をリクエストに応じて無効化するには¶

以下のリクエストヘッダーを設定することで、統合Windows認証機能、テナントバリデーション機能を無効化することができます。

リクエストヘッダー	値	動作
x-jp-co-intra-mart-sso-windows-disable-authentication	true	該当のリクエストにおいて統合Windows認証を行いません。
x-jp-co-intra-mart-sso-windows-disable-tenant-validation	true	該当のリクエストにおいてテナントバリデーションを行いません。

注意

値には “true” を指定してください。その他の値を指定した場合の動作は保証しません。