intra-mart Accel Platform 設定ファイルリファレンス 第34版 2024-04-01

認証設定(システム管理者用)

概要

システム管理者用のログイン処理で使用する設定を行います。
モジュール
システム管理機能
フォーマットファイル(xsd)
WEB-INF/schema/certification-config.xsd
設定場所
WEB-INF/conf/certification-config/im_admin_login.xml

<certification-config xmlns="http://www.intra-mart.jp/certification/certification-config"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://www.intra-mart.jp/certification/certification-config certification-config.xsd">

  <category name="im_admin_login">
    <param>
      <param-name>url</param-name>
      <param-value>/system/login</param-value>
    </param>
    <param>
      <param-name>enable_cookie_store</param-name>
      <param-value>false</param-value>
    </param>
    <param>
      <param-name>enable_localstorage_store</param-name>
      <param-value>true</param-value>
    </param>
  </category>

  <category name="im_admin_initial">
    <param>
      <param-name>url</param-name>
      <param-value>/system/initialsetting</param-value>
    </param>

  </category>

  <category name="im_admin_certification">
    <param>
      <param-name>url</param-name>
      <param-value>/system/certification</param-value>
    </param>
    <param>
      <param-name>enable_force_login_session_refresh</param-name>
      <param-value>true</param-value>
    </param>
  </category>

</certification-config>

リファレンス

ログインページURL

カテゴリタグ名 (属性) category (im_admin_login)
パラメータキータグ名 (キー名) param (url)
ログインページのURLを設定します。
初期設定から変更したい場合に設定します。

【設定項目】

<certification-config>
  <category name="im_admin_login">
    <param>
      <param-name>url</param-name>
      <param-value>/system/login</param-value>
    </param>
  </category>
</certification-config>

必須項目
複数設定 ×

キータグ
<param-name>url</param-name>
値タグ
<param-value>/system/login</param-value>
設定値・設定する内容
ログインページのURLを設定します。コンテキストパスからの相対パスを設定します。
単位・型
文字列 (/aaa/bbb/ccc)
省略時のデフォルト値 なし
親タグ certification-config

注意

この設定の変更は推奨していません。
この設定を変更した場合は、web.xml の設定、および、利用している画面の設定を全て変更する必要がありますが、 intra-mart Accel Platform では web.xml の変更を推奨していません。ログイン画面を変更する場合は、URLの変更ではなく「ログインページプロバイダ 」の利用を検討してください。

ユーザコードのCookie保存有無

カテゴリタグ名 (属性) category (im_admin_login)
パラメータキータグ名 (キー名) param (enable_cookie_store)
ログイン画面で入力したユーザコードをCookieに保存して、再表示時に初期設定するかどうかを設定します。

【設定項目】

<certification-config>
  <category name="im_admin_login">
    <param>
      <param-name>enable_cookie_store</param-name>
      <param-value>false</param-value>
    </param>
  </category>
</certification-config>

必須項目 ×
複数設定 ×

キータグ
<param-name>enable_cookie_store</param-name>
値タグ
<param-value>false</param-value>
設定値・設定する内容
true ユーザコードを Cookie に保存します。
false ユーザコードを Cookie に保存しません。
単位・型
真偽値 (true/false)
省略時のデフォルト値 false
親タグ certification-config

注意

ここで設定した値は、ログイン画面ページのプログラムで利用しています。
ログイン画面を変更した場合は、この設定は使用されません。

コラム

2018 Spring(Skylark) からは、enable_localstorage_store属性を有効にすることでユーザコードの保存先をlocalStorageに設定できるようになりました。
本設定とenable_localstorage_store属性をどちらも有効にした場合、本設定は無視されます。

ユーザコードのlocalStorage保存有無

カテゴリタグ名 (属性) category (im_admin_login)
パラメータキータグ名 (キー名) param (enable_localstorage_store)
ログイン画面で入力したユーザコードをlocalStorageに保存して、再表示時に初期設定するかどうかを設定します。

【設定項目】

<certification-config>
  <category name="im_admin_login">
    <param>
      <param-name>enable_localstorage_store</param-name>
      <param-value>true</param-value>
    </param>
  </category>
</certification-config>

必須項目 ×
複数設定 ×

キータグ
<param-name>enable_localstorage_store</param-name>
値タグ
<param-value>true</param-value>
設定値・設定する内容
true ユーザコードを localStorage に保存します。
false ユーザコードを localStorage に保存しません。
単位・型
真偽値 (true/false)
省略時のデフォルト値 false
親タグ certification-config

注意

ここで設定した値は、標準のログイン画面ページのプログラムで利用しています。
標準のログイン画面を変更した場合は、この設定は無視されます。

コラム

本設定は 2018 Spring(Skylark) から利用可能です。
2017 Winter(Rebecca) まではenable_cookie_storeのみ利用可能です。
本設定を有効にした場合、enable_cookie_storeの設定は無視されます。

ログイン実行ページURL

カテゴリタグ名 (属性) category (im_admin_certification)
パラメータキータグ名 (キー名) param (url)
ログイン実行ページのURLを設定します。
初期設定から変更したい場合に設定します。

【設定項目】

<certification-config>
  <category name="im_admin_certification">
    <param>
      <param-name>url</param-name>
      <param-value>/system/certification</param-value>
    </param>
  </category>
</certification-config>

必須項目
複数設定 ×

キータグ
<param-name>url</param-name>
値タグ
<param-value>/system/certification</param-value>
設定値・設定する内容
ログイン実行ページのURLを設定します。コンテキストパスからの相対パスを設定します。
単位・型
文字列 (/aaa/bbb/ccc)
省略時のデフォルト値 なし
親タグ certification-config

注意

この設定の変更は推奨していません。
この設定を変更した場合は、web.xml の設定、および、利用している画面の設定を全て変更する必要がありますが、 intra-mart Accel Platform では web.xml の変更を推奨していません。認証処理を変更する場合は、URLの変更ではなく「認証プロバイダ 」の利用を検討してください。

強制ログイン時のセッション再作成の有無

カテゴリタグ名 (属性) category (im_admin_certification)
パラメータキータグ名 (キー名) param (enable_force_login_session_refresh)
強制ログイン時にセッションを再作成するかどうかを設定します。

コラム

intra-mart Accel Platform 2013 Winter 以前は、強制ログイン時にセッションが再作成されませんでした。
intra-mart Accel Platform 2013 Winter と同じ動作を行う場合は、明示的に false を設定してください。

【設定項目】

<certification-config>
  <category name="im_admin_certification">
    <param>
      <param-name>enable_force_login_session_refresh</param-name>
      <param-value>true</param-value>
    </param>
  </category>
</certification-config>

必須項目 ×
複数設定 ×

キータグ
<param-name>enable_force_login_session_refresh</param-name>
値タグ
<param-value>true</param-value>
設定値・設定する内容
true 強制ログイン時にセッションを再作成します。
false 強制ログイン時にセッションを再作成しません。
単位・型
真偽値 (true/false)
省略時のデフォルト値 true
親タグ certification-config

テナント初期設定ページURL

カテゴリタグ名 (属性) category (im_admin_initial)
パラメータキータグ名 (キー名) param (url)
テナント初期設定ページのURLを設定します。
初期設定から変更したい場合に設定します。

【設定項目】

<certification-config>
  <category name="im_admin_initial">
    <param>
      <param-name>url</param-name>
      <param-value>/system/initialsetting</param-value>
    </param>
  </category>
</certification-config>

必須項目
複数設定 ×

キータグ
<param-name>url</param-name>
値タグ
<param-value>/system/initialsetting</param-value>
設定値・設定する内容
テナント初期設定ページのURLを設定します。コンテキストパスからの相対パスを設定します。
単位・型
文字列 (/aaa/bbb/ccc)
省略時のデフォルト値 なし
親タグ certification-config

注意

この設定を変更した場合は、合わせて ルーティングテーブルの設定を変更する必要があります。