認可設定画面¶

認可設定画面では

• リソース、リソースグループの追加・編集・削除
• サブジェクトグループ（およびサブジェクト）の追加・編集・削除
• ポリシーの変更

が行えます。

画面の縦軸がリソース、およびリソースグループで、横軸がサブジェクトグループ（画面表示上は条件）になっており、格子状に並んでいるのが各リソース／サブジェクトに対する許可・禁止の設定です。

認可設定画面は設定画面を部分的に切り出して部品化して使用できます。

この機能は、特定のアプリケーション用に準備したリソース群についてのみ権限設定できる認可設定画面を、そのアプリケーションの管理機能の一環として使用するという形を想定しています。

そのために以下が必要です。

1. 部品化された画面を管理するリソースグループセットの作成

   部品化機能を利用しようとするアプリケーションが、認可設定のために使用するリソース／リソースグループの構造を定義しなければなりません。intra-mart Accel Platform でもメニューやポータルが利用するために特定のリソースグループセットを定義しています。intra-mart Accel Platform で予約しているリソースセットについては 予約されているリソースグループセット一覧 を参照してください。

2. 部品化された画面についての設定（XMLファイル）の設置

   部品化のためのID、上記で定義したリソースグループセット、使用するサブジェクトタイプについて定義した設定ファイルを記述します。

   設定ファイルの配置場所

   %CONTEXT_PATH%/WEB-INF/conf/authz-partial-policy-edit-config/

   XMLスキーマファイル

   %CONTEXT_PATH%/WEB-INF/schema/authz-partial-policy-edit-config.xsd

   以下サンプルをもとに設定内容について説明します。

   <?xml version="1.0" encoding="UTF-8"?>
   <authz-partial-policy-edit-config
       xmlns="http://www.intra-mart.jp/authz/authz-partial-policy-edit-config"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xsi:schemaLocation="http://www.intra-mart.jp/authz/authz-partial-policy-edit-config ../../schema/authz-partial-policy-edit-config.xsd">
   
     <part-config>
       <part-id>im_authz_impl_router</part-id>
       <caption-cd>CAP.Z.IWP.ROUTER.AUTHZ.PARTCONFIG.TITLE</caption-cd>
       <resource-groups>
         <resource-group-id>http-services</resource-group-id>
       </resource-groups>
       <subject-types>
         <subject-type-id>im_authz_meta_subject</subject-type-id>
         <subject-type-id>imm_user</subject-type-id>
         <subject-type-id>imm_company_post</subject-type-id>
         <subject-type-id>imm_department</subject-type-id>
         <subject-type-id>imm_public_grp</subject-type-id>
         <subject-type-id>imm_public_grp_role</subject-type-id>
         <subject-type-id>b_m_role</subject-type-id>
       </subject-types>
       <callbacks>
          <resource-group-authorizer>jp.co.intra_mart.system.authz.ResourceGroupAuthorizer</resource-group-authorizer>
       </callbacks>
     </part-config>
   
   </authz-partial-policy-edit-config>
   

   • part-config要素 : 設定のルートになる要素です。

   • part-id要素 : この設定のIDを付与します。他の設定と重複しないよう注意してください。
   • caption-cd要素 : この設定の名称を引くためのメッセージコードを指定します。認可設定画面のリソースの種類の欄に表示されるため、国際化を考慮してメッセージリソースを用意してください。
   • resource-groups要素 : 部品化した認可設定画面の編集対象にするリソースグループのIDを設定します。

   • resource-group-id要素 : 対象にするリソースグループのIDを設定します。resource-groups要素内に複数指定可能できますが、単一のリソースグループセット内である必要があります。

   • subject-types要素 : 部品化した認可設定画面で使用できるサブジェクトタイプIDを設定します。ここに挙げられている以外のサブジェクトタイプは選択できなくなります。

   • subject-type-id要素 : 使用するサブジェクトタイプIDを設定します。subject-types要素内に複数指定できます。

   • callbacks要素 : 認可設定画面を部品として呼び出す場合に認可から呼び出されるリソース群の表示可否判断を行うコールバックを指定できます。任意項目です。

   • resource-group-authorizer要素 : 認可設定画面を部品として呼び出す場合に指定されたリソースグループに対する権限設定可否判断クラスを指定できます。権限設定可否判断クラスとは、 jp.co.intra_mart.foundation.authz.partial.AuthzPartialResourceGroupAuthorizer インタフェースを実装したクラスです。任意項目です。

3. <imart> タグまたはカスタムタグによる呼び出し

   以下のように指定すると、画面にボタンが表示され、ポップアップ画面として認可設定画面を呼び出せます。

   <imart type="imAuthzPolicyEditor" displayType="button" partId="sample_part_id">ボタンで表示</imart>
   

   partId には 2. で作成した設定ファイルで指定した part-id を指定します。resource-group-authorizer のクラスの詳細については「認可 拡張プログラミングガイド」を参照してください。そのほかのパラメータや、使い方の詳細についてはAPIリストを参照してください。

サブジェクトタイプを独自に追加した場合などに認可設定画面でも追加したサブジェクトタイプを対象者として検索できるようにする必要があるため、検索画面を開くためのボタンを追加できます。

ここでは検索画面を開くためのボタンを追加するための仕様について説明します。

追加のボタンはプラグインの機構を使用します。プラグインに関してはAPIリストの PluginManager を参照してください。以下のような設定ファイルを作成します。

配置先

%CONTEXT_PATH%/WEB-INF/plugin/<Plugin ID>/plugin.xml

拡張ポイント

jp.co.intra_mart.authz.subject.search

以下IM共通マスタのユーザの場合をサンプルに設定内容を説明します。

<?xml version="1.0" encoding="UTF-8"?>
<plugin>
  <extension
      point="jp.co.intra_mart.authz.subject.search" >
    <subjectSearchConfig
        name="IM-Master Authz Subject Search Config"
        id="jp.co.intra_mart.im_master.authz.subject.search"
        version="8.0.0"
        rank="10"
        enable="true">

      <!-- サブジェクト共通のヘッダ埋込ページ -->
      <headerPage>im_master_subjecttypes/authz/subject/search</headerPage>

      <buttons>
        <!-- ボタン情報。複数のボタンを記述可能 -->
        <!-- [属性] subjectType サブジェクトタイプ -->
        <!-- [属性] displayName 表示名（多言語化） -->
        <!-- [属性] action ボタン押下時の関数名 function(pluginInfo：この設定情報)。"a.b.c" のようにオブジェクトプロパティの指定が可能。 -->
        <button
            subjectType="imm_department"
            displayName="%button.department"
            action="immSubjectSearch"
            >
          <!-- 付加条件セットからこのサブジェクトで使う設定を選ぶ。 -->
          <!-- [属性] id この検索ボタンで利用する付加条件セットのID -->
          <!-- [属性] value 付加条件セットのうち初期表示する付加条件の種別 -->
          <condition id="im_master.condition" value="eq"/>

          <!-- ボタン表示イメージ置き換え用ページ。 -->
          <!-- これを指定するとボタンではなく指定のjsspをインクルードします -->
          <!-- <viewPage>sample/authz/subject_plugins/sample/view</viewPage> -->

          <!-- オプション key/value で設定。内容は任意です  -->
          <options>
            <target>jp.co.intra_mart.master.search.department</target>
            <callback>immDeptSearchCallback</callback>
          </options>
        </button>
      </buttons>

      <!-- 付加条件セットマスタ -->
      <conditions>
        <!-- 付加条件セット 複数記述可能 -->
        <!-- [属性] id 付加条件セットのID -->
        <condition id="im_master.condition">
          <!-- Comparator 定義。複数記述可能。Selectボックスに表示される。 -->
          <!-- typeが 選択肢のvalue値、displayが表示名 -->
          <!-- [属性] type 付加条件の値 -->
          <!-- [属性] displayName 表示名 -->
          <comparator type="gt" displayName="より大きい" />
          <comparator type="ge" displayName="以上" />
          <comparator type="eq" displayName="等価" />
          <comparator type="le" displayName="以下" />
          <comparator type="lt" displayName="より小さい" />
        </condition>
      </conditions>
    </subjectSearchConfig>
  </extension>
</plugin>

<subjectSearchConfig> 要素までは PluginManager で既定している書式のため、 ここでは <subjectSearchConfig> より下の要素について説明します。

• headerPage 要素: ヘッダとして読み込むページを指定します。追加したボタンでのイベントハンドラ等を記述する場所です。
• buttons 要素: 下記のボタン要素のコンテナです。

• button 要素: 追加するボタンを表す要素です。複数記述可能です。

• subjectType 属性: このボタンで扱うサブジェクトタイプIDを指定します。
• displayName 属性: このボタンの表示名を指定します。先頭が%のコードを指定するとメッセージリソースからそのコードに設定された文字列を取得します。
• action 属性: このボタンをクリックされた場合に実行するイベントハンドラを指定します。このイベントハンドラはheaderPageで指定したページに記述しておきます。
• condition 要素: 付加条件として使用する条件セットを指定します。下記のconditions要素で指定したものから選択します。

• id 属性: 下記のconditions要素で設定しているものから使用する条件セットを指定します。
• value 属性: デフォルト選択値を指定します。
• viewPage 要素: ボタンの代わりにjsspを読み込んで表示させたい場合、この要素に読み込むjsspのパスを指定します。
• options 要素: 任意の値を設定できます。タグ名をキー、タグ内のテキストを値としたハッシュ配列がボタンに対して設定されます。

• conditions 要素: 付加条件として使用する条件セットのマスタ定義です。

• condition 要素: 付加条件のひとまとまり（条件セット）を表します。

• id 属性: この条件セットのIDです。
• comparator 要素: 付加条件の選択肢を表します。

• type 属性: 選択肢の値です。
• displayName 属性: 選択肢の表示名を表します。