認可のキャッシュ設定¶
認可機能は頻繁に使用されるため、キャッシュを使用して処理を高速化しています。ここでは、認可機能で使用しているキャッシュの箇所と、キャッシュするオブジェクトの単位、キャッシュサイズの計算式についての情報を記載しています。
インストールするアプリケーションとサーバ環境に応じて、キャッシュを設定してください。
項目
キャッシュの概要¶
intra-mart Accel Platform の機能のうち、頻繁に利用される機能のひとつに認可があります。認可は画面やデータ、各サービスにおける権限チェックを統括して行うため、あらゆる機能から使用される機能です。
例えば、intra-mart Accel Platform にログインした後に表示されるグローバルナビや、各機能へのリンクを表示するサイトマップでは、アクセス権限のあるリンクのみを表示しているため、各リンクごとに認可の判断処理が行われます。メニューを例として、認可が行われるまでの処理の流れは下図の通りです。
このように、認可の判断結果が確定するまでには多くの処理があり、各処理においてファイルやデータベースへのアクセスが発生します。そこで認可機能では、各処理のうちデータの更新頻度が低く、参照頻度が高いものについて、キャッシュを利用して高速化しています。
これらの処理を高速化するために、大きく以下の４つについてキャッシュしています。
(※) メニュー側のキャッシュですが、便宜上この資料で説明します。
キャッシュされるデータのサイズは、ほとんどの場合、認可に登録されているリソースグループの数に比例します。ユーザモジュールを追加でインストールしたり、取り扱う認可リソースの数が想定数より多くなったりする場合は、キャッシュサイズを見直してください。
キャッシュのサイズは intra-mart Accel Platform と代表的なアプリケーションをインストールした環境のためにサイジングした値をデフォルト値として設定しています。デフォルト値の説明については各キャッシュの計算式を参照してください。
コラム
設定可能な値については「設定ファイルリファレンス キャッシュ設定」を参照してください。コラム
キャッシュするオブジェクトの上限値に関して、以下の設定方法があります。運用環境に応じて、どちらの設定を採用するか決めてください。
- オブジェクトを格納する際の最大サイズ（max-bytes-XXXX）
- キャッシュするオブジェクトの最大数（max-elements-on-XXXX）
ルーティング設定のキャッシュ¶
キャッシュ内容¶
メニューアイテムに登録されている「URL＋引数」を「リソースURI」「アクション」に変換するマッピングをキャッシュします。このキャッシュは、概要図の １ の部分に該当します。キャッシュサイズは、「認可リソースマッピング情報キャッシュ設定 (im-ehcache-config/authz-mapped-entry-url.xml)」で設定されています。
キャッシュするオブジェクトの単位¶
ルーティング設定は、メニューアイテム単位でキャッシュされます。そのため、キャッシュするオブジェクト数は、登録されているメニューアイテムの数によって見積もります。
キャッシュサイズの計算式¶
キャッシュが行われる対象データのおおまかなサイズは以下の計算式で求めることができます。
キャッシュサイズ ＝ ( (１) ＋ (２) ) × (３)(１) … 各メニューアイテムに設定されている内容のサイズ (平均 50byte)(１) ＝ (１ａ) ＋ (１ｂ) × (１ｃ)(１ａ) … URLのバイト数(１ｂ) … 引数(キー＋値) のバイト数(１ｃ) … 引数の数(２) … リソースグループIDとアクションを格納したモデルのサイズ (平均 180byte)(２) ＝ (２ａ) ＋ (２ｂ)(２ａ) … リソースグループIDのバイト数(２ｂ) … アクションのバイト数(３) … 登録されているメニューアイテムの数intra-mart Accel Platform のデフォルト値は以下の計算をもとに設定されています。
(50 ＋ 180) × 500 ＝ 115,000 (約 115KB)⇒ 128KB
リソースグループ設定のキャッシュ¶
キャッシュ内容¶
「リソースURI」を「認可リソースグループ」に変換するマッピングをキャッシュします。このキャッシュは、概要図の ２ の部分に該当します。intra-mart Accel Platform をインストールした直後の状態では、画面・処理 (service) のリソースタイプのみキャッシュが行われます。他のリソースタイプでキャッシュを行う場合は、別途設定が必要です。リソースタイプごとのキャッシュ設定については、「設定ファイルリファレンス」の「リソースタイプ拡張設定」を参照してください。キャッシュサイズは、「認可リソース情報キャッシュ設定(画面・処理用) (im-ehcache-config/authz-resourcetype-service.xml)」で設定されています。
キャッシュするオブジェクトの単位¶
リソースグループ設定は、リソースURI 単位でキャッシュされます。そのため、キャッシュするオブジェクト数は、登録されているリソースURI の数によって見積もります。
キャッシュサイズの計算式¶
キャッシュが行われる対象データのおおまかなサイズは以下の計算式で求めることができます。
キャッシュサイズ ＝ ( (１) ＋ (２) ) × (３)(１) … リソースURI のバイト数 (平均 44byte)(２) … リソースグループID のバイト数 (平均 40byte)(３) … 登録されているリソースURI の数intra-mart Accel Platform のデフォルト値は以下の計算をもとに設定されています。
(44 ＋ 40) × 1,000 ＝ 84,000 (約 84KB)⇒ 128KB
リソース閉塞状態のキャッシュ¶
キャッシュ内容¶
「認可リソースグループ」１件あたりの閉塞状態をキャッシュします。このキャッシュは、概要図の ３ の部分に該当します。このキャッシュはすべてのリソースグループに対して行われます。キャッシュサイズは、「認可リソース閉塞情報キャッシュ設定 (im-ehcache-config/authz-resource-block.xml)」で設定されています。
キャッシュするオブジェクトの単位¶
リソース閉塞状態は、リソースグループ単位でキャッシュされます。そのため、キャッシュするオブジェクト数は、登録されているリソースグループの数によって見積もります。
キャッシュサイズの計算式¶
キャッシュが行われる対象データのおおまかなサイズは以下の計算式で求めることができます。
キャッシュサイズ ＝ (１) × (２)(１) … リソースグループID、閉塞状態のセット (平均 320byte)(２) … 登録されているリソースグループの数intra-mart Accel Platform のデフォルト値は以下の計算をもとに設定されています。
320 × 1,000 ＝ 320,000 (約 312.5KB)⇒ 320KB
ポリシー設定のキャッシュ¶
キャッシュ内容¶
「認可リソースグループ」「認可サブジェクトグループ」「アクション」から取得した「ポリシー」の状態をキャッシュします。このキャッシュは、概要図の ４ の部分に該当します。intra-mart Accel Platform をインストールした直後の状態では、画面・処理 (service) のリソースタイプのみキャッシュが行われます。他のリソースタイプでキャッシュを行う場合は、別途設定が必要です。リソースタイプごとのキャッシュ設定については、「設定ファイルリファレンス」の「認可ポリシーキャッシュ対象設定」を参照してください。キャッシュサイズは、「認可ポリシー情報キャッシュ設定 (im-ehcache-config/authz-policy.xml)」で設定されています。
キャッシュするオブジェクトの単位¶
intra-mart Accel Platform 2013 Autumn 以降の場合
ポリシー設定は、単一の「サブジェクトグループ」に対しての「リソースグループ、リソースタイプ、リソースタイプが指すアクション」毎のポリシー設定をキャッシュします。そのため、キャッシュするオブジェクト数は、以下の計算式で求めることができます。キャッシュするオブジェクト数 ＝ (１) × (２) × (３) × (４)(１) … 登録されているリソースグループの数(２) … リソースグループがリソースとして持つリソースタイプの数(３) … リソースタイプが定義するアクションの数(４) … 登録されているサブジェクトグループの数intra-mart Accel Platform 2013 Autumn より前の場合
ポリシー設定は、サブジェクトグループ単位でキャッシュされます。そのため、キャッシュするオブジェクト数は、登録されているサブジェクトグループの数によって見積もります。
キャッシュサイズの計算式¶
intra-mart Accel Platform 2013 Autumn 以降の場合
キャッシュが行われる対象データのおおまかなサイズは以下の計算式で求めることができます。キャッシュサイズ ＝ (１) × (２) × (３) × (４)(１) … 登録されているサブジェクトグループの数(２) … サブジェクトグループID、リソースグループID、リソースタイプ、アクションのセット(約 170byte)(３) … 登録されているリソースグループの数(４) … ポリシー設定数の係数 (認可設定マトリクス全体のうち、運用中キャッシュされる割合)intra-mart Accel Platform のデフォルト値は以下の計算をもとに設定されています。
2,200 × 170 × 1,000 × 0.5 ＝ 187,000,000 (約 178.3MB)⇒ 180MBintra-mart Accel Platform 2013 Autumn より前の場合
キャッシュが行われる対象データのおおまかなサイズは以下の計算式で求めることができます。キャッシュサイズ ＝ (１) × ((２) × (３) ＋ (４)) × (５)(１) … 登録されているサブジェクトグループの数(２) … リソースグループID、リソースタイプ、アクションのセット (平均 600byte)(３) … 登録されているリソースグループの数(４) … (２)(３)を保持するためのマップの初期サイズ (約 2000byte)(５) … ポリシー設定数の係数 (認可設定マトリクス全体のうち、運用中キャッシュされる割合)intra-mart Accel Platform のデフォルト値は以下の計算をもとに設定されています。
2,200 × (150 × 1,000 ＋ 2,000) × 0.5 ＝ 167,200,000 (約 159.5MB)⇒ 160MBコラム
- ポリシー設定数の係数について