本資料はSpotfire 環境内のセッションタイムアウト設定について情報を整理します。
動作確認環境
・Spotfire Server 14.0 LTS
本資料記載の内容はSpotfire Server 12.0 LTS 以降に利用できます。
Analytics画面のタイムアウト
ブラウザで「Analytics」画面を開いて、分析の閲覧・作成・編集を行う際に、操作なしでアイドル状態が続いた場合は以下の動きになります。
1.「inactivityTimeout」(デフォルト:2時間)が経過すると、以下の画面に遷移します。
「分析を再度開く」ボタンを押すと分析の閲覧・作成・編集画面に戻ります。
「inactivityTimeout」は Web Player サービス設定変更手順 に従って変更できます。
変更箇所は以下の通りに太字で示しています。
・Spotfire.Dxp.Worker.Web.config
<analysis
antiAliasEnabled="true"
useClearType="true"
documentStateEnabled="true"
closedTimeout="120"
checkClosedInterval="60"
inactivityTimeout="02:00:00"
checkInactivityInterval="300"
regularPollChangesInterval="500"
maxPollChangesInterval="3000"
......
2.「分析を再度開く」ボタンを押さずにアイドル状態が続くと、「Idle session timeout」(デフォルト:30分)に達する2分前になった際には以下の「セッションの期限切れ」ダイアログが表示しカウントダウンが開始します。
「セッションの延長」を押すと前の画面(「分析が終了しました。」の画面)へ戻ります。
「Idle session timeout」は Spotfire-Server設定変更手順 に従って変更できます。
変更箇所は以下の通りに赤い枠で示しています。
3.「セッションの延長」ボタンを押さずにアイドル状態が続くと、2分後に警告ダイアログが消え、以下の画面に遷移します。
「続行する」を押すと前の画面(「分析が終了しました。」の画面)へ戻ります。
4.「続行する」ボタンを押さずにアイドル状態が続くと、さらに「Idle session timeout」の時間が経った後には該当ユーザーがログアウトされます。ログアウト時に画面表示には特に変更はありません。ログアウト後に「続行する」を押すとログイン画面へ遷移します。
Analytics画面終了後の動き
Analytics画面(分析閲覧・編集画面)をメニュー(ファイル⇒閉じる)から閉じた場合は該当分析のセッションが直ちに終了され、分析関連のリソースが破棄されます。
Analytics画面が表示されているブラウザのウィンドウまたはタブを直接閉じた場合、「closedTimeout」(デフォルト:120秒)が経過すると該当分析のセッションが終了され、分析関連のリソースが破棄されます。
「closedTimeout」は Web Player サービス設定変更手順 に従って変更できます。
変更箇所は以下の通りに太字で示しています。
・Spotfire.Dxp.Worker.Web.config
<analysis
antiAliasEnabled="true"
useClearType="true"
documentStateEnabled="true"
closedTimeout="120"
checkClosedInterval="60"
inactivityTimeout="02:00:00"
checkInactivityInterval="300"
regularPollChangesInterval="500"
maxPollChangesInterval="3000"
......
Web管理画面のタイムアウト
Analytics画面以外のWeb管理画面(メイン画面、Library、Users、Nodes & Servicesなど)を開いた後に、操作なしでアイドル状態が続いた場合は以下の動きになります。
メイン画面の例:
1.「Idle session timeout」(デフォルト:30分)に達する2分前になった際には以下の「セッションの期限切れ」ダイアログが表示しカウントダウンが開始します。
「セッションの延長」を押すと前の画面(メイン画面など)へ戻ります。
2.「セッションの延長」ボタンを押さずにアイドル状態が続くと、2分後に警告ダイアログが消え、以下の画面に遷移します。
「続行する」を押すと前の画面(メイン画面など)へ戻ります。
3.「続行する」ボタンを押さずにアイドル状態が続くと、さらに「Idle session timeout」の時間が経った後には該当ユーザーがログアウトされます。ログアウト時に画面表示には特に変更はありません。ログアウト後に「続行する」を押すとログイン画面へ遷移します。
Absolute session timeout
ユーザーがログインした後に操作の有無にかかわらず「Absolute session timeout」が経つと、Analystやブラウザ画面などすべてのユーザーセッションが終了されます。
- Analystではセッション終了後に自動的に再ログインを行いますのでユーザーの利用は中断されません。
- ブラウザ画面(Analytics画面、Web管理画面を含む)はすべて強制的にログアウトされます。
「Absolute session timeout」は Spotfire-Server設定変更手順 に従って変更できます。
変更箇所は以下の通りに赤い枠で示しています。
UserSessionTimeout
Web Playerには設定「UserSessionTimeout」も設けられており、Analytics画面が終了した後にこの時間が経つと該当Web Playerセッションが終了されます。これで対象ユーザーがWeb Playerからログアウトされ、利用していたWeb Playerリソースが解放されます。「UserSessionTimeout」によってログアウトされた場合はブラウザ画面には特に変更はありません。
注意点としては該当ユーザーがSpotfire Serverへログインしたセッションが続きますので、再度Analytics画面を開く際には新たにWeb Playerセッションが確立され、ユーザーの操作には特に影響はありません。
「UserSessionTimeout」は Web Player サービス設定変更手順 に従って変更できます。
変更箇所は以下の通りに太字で示しています。
・Spotfire.Dxp.Worker.Web.config
<application checkUserSessionTimeoutIntervalSeconds="120"
userSessionTimeout="00:20:00"
maxConcurrentWebServiceCallsPerCore="16"
maxReceivedMessageSizeMb="1024"
maxReaderQuotasSizeKb="256"
requestTimeoutSeconds="3600"/>
Web Player側のタイムアウト設定項目一覧
Web Player側の設定項目は「Analytics画面」利用時に適用されます。
設定項目 | 説明 | デフォルト値 | 設定範囲 |
inactivityTimeout | 操作なしでアイドル状態にいられる時間の最大値 |
02:00:00 (日数.時:分:秒) |
・00:01:00~10675199.02:48:05 ・Infinite(無制限) |
checkInactivityInterval | アイドル状態のタイムアウトをチェックする間隔 | 300(秒) | 30~43200 |
userSessionTimeout |
Analytics画面が閉じた後にユーザーセッションが残る時間の最大値 |
00:20:00 (日数.時:分:秒) |
・00:01:00~10675199.02:48:05 ・Infinite(無制限) |
checkUserSessionTimeoutIntervalSeconds | ユーザーセッションのタイムアウトをチェックする間隔 | 120(秒) | 15~600 |
closedTimeout | 分析が閉じた後に分析のセッションが残る時間の最大値 | 120(秒) | 60~4,000,000 |
checkClosedInterval | 分析セッションのタイムアウトをチェックする間隔 | 60(秒) | 30~600 |
Spotfire Server側のタイムアウト設定項目一覧
Spotfire Server側の設定項目はWeb管理画面(メイン画面、Library、Users、Nodes & Servicesなど)に適用されます。Analytics画面にはこれらの設定が適応されません。
- Absolute session timeoutはAnalystにも適用されます。
設定項目 | 説明 | デフォルト値 | 設定可能な値 |
Idle session timeout security.idle-session-timeout |
操作なしでアイドル状態にいられる時間の最大値 | 30(分) |
・1~2,147,483,647 ・0(無制限) |
Absolute session timeout security.absolute-session-timeout |
ログイン後にセッションの存続期間の最大値 | 1440(分) |
・1~2,147,483,647 ・0(無制限) |
security.web-client-idle-timeout.enabled |
アイドル状態が続く場合に「セッションの延長」ダイアログの表示有無を制御 | true |
true / false |
security.web-client-idle-timeout.display-time-seconds |
「セッションの延長」ダイアログの表示期間 | 120(秒) |
1~2,147,483,647 ・0(無制限) |
security.web-client-idle-timeout.explicit-logout |
アイドルタイムアウトに達した際にブラウザ内のすべてのタブのセッションをログアウトさせるかどうかを制御 | false |
true / false ※trueの場合、Analytics画面を含めて対象ブラウザ内のすべてのセッションがログアウトされる ※falseの場合、アイドルタイムアウトはブラウザのタブごとに動作する |
参考資料
Overview of session timeouts in Spotfire
How to look for userSessionTimeout in Spotfire Web Player logs
How to look for inactivityTimeout in Spotfire Web Player logs
Absolute session timeout and idle session timeout
Setting web client idle time behavior by using the command line
Spotfire.Dxp.Worker.Web.config file