ntra-mart Accel Platform — IM-Authz（認可）インポート・エクスポート仕様書 第4版 2019-08-01

Copyright © 2014 NTT DATA INTRAMART CORPORATION

↑Top

1

ntra-mart Accel Platform — IM-Authz（認可）インポート・エクスポート仕様書 第4版 2019-08-01

目次
1. 改訂情報
2. はじめに
本書の目的
対象読者
本書の構成
3. インポート・エクスポートの概要
インポート・エクスポート機能
インポート・エクスポートで扱う情報
インポート・エクスポート手順
4. ファイルフォーマット
リソースグループ
リソース
サブジェクトグループ
ポリシー
5. インポート更新モード
リソースグループ
リソース
サブジェクトグループ
ポリシー
6. エクスポート
リソースグループ
リソース
サブジェクトグループ
ポリシー
7. オプション
インポートオプション
エクスポートオプション
8. 実行方法
ジョブスケジューラを利用する
認可設定画面を利用する
9. 付録
IM-Authz（認可）インポートデータ定義書2ntra-mart Accel Platform — IM-Authz（認可）インポート・エクスポート仕様書 第4版 2019-08-01

改訂情報
変更年月日

変更内容

2014-08-01

初版

2014-12-24

第２版

下記を追加・変更しました「IM-Authz（認可）インポートデータ定義書」で、「XML （ポリシー）」
シートのDBテーブル名が誤っていた箇所を修正 （imaz_resource_group > imaz_policy）

2018-08-01

第３版

下記を追加・変更しました「リソースグループ」の更新モード「replace」の説明が誤っていたため修正

2019-08-01

第４版

下記を追加・変更しました「XMLのポリシー専用オプション」のXMLのオプション「リソースグルー

プ・リソース存在検証フラグ」の説明を追加

3

ntra-mart Accel Platform — IM-Authz（認可）インポート・エクスポート仕様書 第4版 2019-08-01

はじめに
本書の目的
本書ではIM-Authz（認可）情報のインポート・エクスポート機能の詳細について説明します。
説明範囲は以下のとおりです。
IM-Authz（認可）情報のインポート・エクスポートの概要
IM-Authz（認可）情報のインポート・エクスポートファイルのデータフォーマット
IM-Authz（認可）情報のインポート・エクスポートの実行方法
IM-Authz（認可）情報のインポート・エクスポートの実行オプション

対象読者
本書では次の利用者を対象としています。
intra-mart Accel Platform のIM-Authz（認可）を管理する運用担当者
IM-Authz（認可）情報のインポート・エクスポート機能を利用したアプリケーションを開発する開発者

本書の構成
インポート・エクスポートの概要
IM-Authz（認可）のインポート・エクスポートの概要について説明します。

ファイルフォーマット
インポートファイルのデータフォーマットについて説明します。

インポート
インポートの処理について説明します。更新モードについても説明します。

エクスポート
エクスポートの処理について説明します。

オプション
インポート・エクスポート実行時に指定可能なオプションについて説明します。

実行方法
インポート・エクスポート実行方法について説明します。

4

ntra-mart Accel Platform — IM-Authz（認可）インポート・エクスポート仕様書 第4版 2019-08-01

インポート・エクスポートの概要
項目
インポート・エクスポート機能
インポート・エクスポートで扱う情報
インポート・エクスポート手順
リソースグループ
インポート
エクスポートリソース
インポート
エクスポートサブジェクトグループ
インポート
エクスポートポリシー - XML形式
インポート
エクスポートポリシー - Excel（xlsx）形式
インポート
エクスポート

インポート・エクスポート機能
IM-Authz（認可）には、「リソース」「リソースグループ」「サブジェクトグループ」、および、「ポリシー」の４つのインポート・エクスポート機能があります。
対応しているフォーマットは「XML」形式と「Excel（xlsx）」形式の２つですが、取り扱うことができるデータの種類と更新モードが異なります。
それぞれ取り扱うことができるデータの種類は、以下の通りです。
形式

データの種類

更新モード

導入バージョン

XML

リソースグループ

replace2012 Autumn

リソース

merge

サブジェクトグループ（ポリシーは指定不

ポリシー

可）

ポリシー

（指定不可）

Excel（xlsx）

2014 Summer

注意
Excel（xlsx）フォーマットの出力機能を使用するためには、IM-Jugglingで「追加機能」 - 「IMAuthz（認可）Excelインポート・エクスポート」モジュールを追加する必要があります。

インポート・エクスポートで扱う情報5

ntra-mart Accel Platform — IM-Authz（認可）インポート・エクスポート仕様書 第4版 2019-08-01
IM-Authz（認可）のインポート・エクスポートで扱う情報は、以下の通りです。
リソースグループ
表示名
説明
親リソースグループ
リソース
表示名
説明
親リソースグループ
サブジェクトグループ
表示名
説明
サブジェクトグループの条件式
ポリシー
権限状態
各情報についての詳細は、「ファイルフォーマット 」および「認可仕様書 - 認可 概要 」を参照してください。

インポート・エクスポート手順
リソースグループ
インポート
リソースグループのインポートを行う手順は、以下の通りです。
1. インポートファイルをXML形式で作成します。
フォーマットについては、「ファイルフォーマット 」 - 「リソースグループ 」 - 「XMLファイル形式 」を参照してください。
2. インポートファイルを、パブリックストレージに配置します。
3. インポートファイルを、次のいずれかの方法でインポートします。
「ジョブスケジューラを利用する 」「ジョブ 」 - 「インポート 」 - 「リソースグループ 」「ジョブネット 」 - 「インポート 」 - 「リソースグループ 」

エクスポート
リソースグループのエクスポートを行う手順は、以下の通りです。
1. 次のいずれかの方法でエクスポートします。
「ジョブスケジューラを利用する 」「ジョブ 」 - 「エクスポート 」 - 「リソースグループ 」

6ntra-mart Accel Platform — IM-Authz（認可）インポート・エクスポート仕様書 第4版 2019-08-01「ジョブネット 」 - 「エクスポート 」 - 「リソースグループ 」「認可設定画面を利用する 」
2. パブリックストレージに、エクスポートファイルが出力されます。

リソース
インポート
リソースのインポートを行う手順は、以下の通りです。
1. インポートファイルをXML形式で作成します。
フォーマットについては、「ファイルフォーマット 」 - 「リソース 」 - 「XMLファイル形式 」を参照してください。
2. インポートファイルを、パブリックストレージに配置します。
3. インポートファイルを、次のいずれかの方法でインポートします。
「ジョブスケジューラを利用する 」「ジョブ 」 - 「インポート 」 - 「リソース 」「ジョブネット 」 - 「インポート 」 - 「リソース 」

エクスポートリソースのエクスポートを行う手順は、以下の通りです。
1. 次のいずれかの方法でエクスポートします。
「ジョブスケジューラを利用する 」「ジョブ 」 - 「エクスポート 」 - 「リソース 」「ジョブネット 」 - 「エクスポート 」 - 「リソース 」「認可設定画面を利用する 」
2. パブリックストレージに、エクスポートファイルが出力されます。

サブジェクトグループ
インポート
サブジェクトグループのインポートを行う手順は、以下の通りです。
1. インポートファイルをXML形式で作成します。
フォーマットについては、「ファイルフォーマット 」 - 「サブジェクトグループ 」 - 「XMLファイル形式」を参照してください。
2. インポートファイルを、パブリックストレージに配置します。
3. インポートファイルを、次のいずれかの方法でインポートします。
「ジョブスケジューラを利用する 」「ジョブ 」 - 「インポート 」 - 「サブジェクトグループ 」

7ntra-mart Accel Platform — IM-Authz（認可）インポート・エクスポート仕様書 第4版 2019-08-01「ジョブネット 」 - 「インポート 」 - 「サブジェクトグループ 」

エクスポートサブジェクトグループのエクスポートを行う手順は、以下の通りです。
1. 次のいずれかの方法でエクスポートします。
「ジョブスケジューラを利用する 」「ジョブ 」 - 「エクスポート 」 - 「サブジェクトグループ 」「ジョブネット 」 - 「エクスポート 」 - 「サブジェクトグループ 」「認可設定画面を利用する 」
2. パブリックストレージに、エクスポートファイルが出力されます。

ポリシー - XML形式
インポート
ポリシーのインポートを行う手順は、以下の通りです。
1. インポートファイルをXML形式で作成します。
フォーマットについては、「ファイルフォーマット 」 - 「ポリシー 」 - 「XMLファイル形式 」を参照してください。
2. インポートファイルを、パブリックストレージに配置します。
3. インポートファイルを、次のいずれかの方法でインポートします。
「ジョブスケジューラを利用する 」「ジョブ 」 - 「インポート 」 - 「ポリシー - XML形式 」「ジョブネット 」 - 「インポート 」 - 「ポリシー - XML形式 」

エクスポートポリシーのエクスポートを行う手順は、以下の通りです。
1. 次のいずれかの方法でエクスポートします。
「ジョブスケジューラを利用する 」「ジョブ 」 - 「エクスポート 」 - 「ポリシー - XML形式 」「ジョブネット 」 - 「エクスポート 」 - 「ポリシー - XML形式 」「認可設定画面を利用する 」
2. パブリックストレージに、エクスポートファイルが出力されます。

ポリシー - Excel（xlsx）形式
インポート
ポリシーのインポートを行う手順は、以下の通りです。

8ntra-mart Accel Platform — IM-Authz（認可）インポート・エクスポート仕様書 第4版 2019-08-01
1. インポートファイルをExcel（xlsx）形式で作成します。
フォーマットについては、「ファイルフォーマット 」 - 「ポリシー 」 - 「Excel（xlsx）形式 」を参照してください。

コラム
一度エクスポートしたExcel（xlsx）形式のファイルをExcelなどの表計算ソフトで編集して、上書き保存したファイルをインポートすることを想定しています。
2. ジョブスケジューラを使用する場合のみ、インポートファイルを、パブリックストレージに配置します。
3. インポートファイルを、次のいずれかの方法でインポートします。
「ジョブスケジューラを利用する 」「ジョブ 」 - 「インポート 」 - 「ポリシー - Excel（xlsx）形式 」「ジョブネット 」 - 「インポート 」 - 「ポリシー - Excel（xlsx）形式 」「認可設定画面を利用する 」

エクスポートポリシーのエクスポートを行う手順は、以下の通りです。
1. 次のいずれかの方法でエクスポートします。
「ジョブスケジューラを利用する 」「ジョブ 」 - 「エクスポート 」 - 「ポリシー - Excel（xlsx）形式 」「ジョブネット 」 - 「エクスポート 」 - 「ポリシー - Excel（xlsx）形式 」「認可設定画面を利用する 」
2. パブリックストレージに、エクスポートファイルが出力されます。
認可設定画面でエクスポートを実行した場合は、認可設定画面から直接ダウンロードすることができます。

9

ntra-mart Accel Platform — IM-Authz（認可）インポート・エクスポート仕様書 第4版 2019-08-01

ファイルフォーマット
項目
リソースグループ
XMLファイル形式
リソース
XMLファイル形式
サブジェクトグループ
XMLファイル形式
ポリシー
XMLファイル形式
Excel（xlsx）形式
出力例
テンプレートファイルの仕様

リソースグループ
XMLファイル形式
以下は、XMLファイルの例です。
<authz-resource-group> タグで囲まれた１要素が１件のリソースグループに該当します。
XML schema の場所：
%CONTEXT_PATH%/WEB-INF/schema/authz-resource-group.xsd<?xml version="1.0" encoding="UTF-8"?><root xmlns="http://www.intra-mart.jp/authz/imex/resource-group"><authz-resource-group id="im-authz-service"><display-name><name locale="ja">認可</name><name locale="en">Authz Maintenance</name></display-name><resource-group-description><description locale="ja">認可設定画面関連の画面リソースです。</description></resource-group-description><parent-group id="http-services"/></authz-resource-group></root>各タグ・属性の説明は、以下の通りです。
「IM-Authz（認可）インポートデータ定義書 」も合わせて、参照してください。
項目

タグ名

説明

10

ntra-mart Accel Platform — IM-Authz（認可）インポート・エクスポート仕様書 第4版 2019-08-01
項目

タグ名

説明

リソースグループ

authz-resource-

１つのリソースグループを定義します。

group

このタグに指定可能な属性は、以下の通りです。
属性

説明

id

リソースグループID

表示名

display-name

リソースグループに設定する表示名を指定します。
ロケールごとに指定可能です。

ロケールごとの表示名

name

ロケール別に、リソースグループに設定する表示名
を、256文字以内で指定します。
このタグに指定可能な属性は、以下の通りです。
属性

説明

locale ロケールID
説明

ロケールごとの説明

resource-group-

リソースグループに設定する説明を指定します。

description

ロケールごとに設定可能です。

description

ロケール別に、リソースグループに設定する説明を、1,000文字以内で指定します。
このタグに指定可能な属性は、以下の通りです。
属性

説明

locale ロケールID
親リソースグループ

parent-group

このリソースグループの親になるリソースグループのIDを指定します。
このタグに指定可能な属性は、以下の通りです。
属性

説明

id

リソースグループID

インポートしたリソースグループは、認可設定画面で確認できます。

11

ntra-mart Accel Platform — IM-Authz（認可）インポート・エクスポート仕様書 第4版 2019-08-01

図 「XMLファイルの例」をインポートした時の認可設定画面

注意
リソースグループ配下に、１つ以上のリソースが登録されている場合のみ表示されます。

リソース
XMLファイル形式
以下は、XMLファイルの例です。
<authz-resource> タグで囲まれた１要素が１件のリソースに該当します。
XML schema の場所：
%CONTEXT_PATH%/WEB-INF/schema/authz-resource.xsd

12ntra-mart Accel Platform — IM-Authz（認可）インポート・エクスポート仕様書 第4版 2019-08-01<?xml version="1.0" encoding="UTF-8"?><root xmlns="http://www.intra-mart.jp/authz/imex/resource"><authz-resource uri="service://authz/settings/basic" id="im-authz-settings-basic-service"><display-name><name locale="ja">認可設定 （基本画面）</name><name locale="en">Authz setting (Basic Screen)</name></display-name><resource-description><description locale="ja">認可設定画面の画面リソースです。</description></resource-description><parent-group id="im-authz-service"/></authz-resource><authz-resource uri="service://authz/settings/parts" id="im-authz-settings-parts-service"><display-name><name locale="ja">認可設定 （ポップアップ）</name><name locale="en">Authz setting (Parts)</name></display-name><resource-description><description locale="ja">ポップアップで表示される認可設定画面の画面リソースです。</description></resource-description><parent-group id="im-authz-service"/></authz-resource><authz-resource uri="service://authz/settings/procedure" id="im-authz-settings-procedure-service"><display-name><name locale="ja">認可設定 （Ajax用）</name><name locale="en">Authz setting (Ajax)</name></display-name><resource-description><description locale="ja">認可設定画面で使用する処理リソースです。</description></resource-description><parent-group id="im-authz-service"/></authz-resource></root>各タグ・属性の説明は、以下の通りです。
「IM-Authz（認可）インポートデータ定義書 」も合わせて、参照してください。
項目

タグ名

説明

リソース

authz-resource

１つのリソースを定義します。
このタグに指定可能な属性は、以下の通りです。
属性

説明

uri

リソースの識別子であるURIを指
定します。

id

リソースとセットで登録されるリソースグループのIDを指定します。
省略した場合は、uri 属性の設定
値をもとに、自動的に作成されます。

13

ntra-mart Accel Platform — IM-Authz（認可）インポート・エクスポート仕様書 第4版 2019-08-01
項目

タグ名

説明

表示名

display-name

リソースとセットで登録されるリソースグループに設定する表示名を、256文字以内で指定します。
ロケールごとに設定可能です。

ロケールごとの表示名

name

ロケール別に、リソースとセットで登録されるリソー
スグループに設定する表示名を指定します。
このタグに指定可能な属性は、以下の通りです。
属性

説明

locale ロケールID
説明

resource-description

リソースとセットで登録されるリソースグループに設定する説明を、1,000文字以内で指定します。
ロケールごとに指定可能です。

ロケールごとの説明

description

ロケール別に、リソースとセットで登録されるリソー
スグループに設定する説明を指定します。
このタグに指定可能な属性は、以下の通りです。
属性

説明

locale ロケールID
親リソースグループ

parent-group

このリソースとセットで登録されるリソースグループの親になるリソースグループです。
このリソースがインポートされる時点で、親になるリ
ソースグループが登録されている必要があります。
このタグに指定可能な属性は、以下の通りです。
属性

説明

id

リソースグループID

インポートしたリソースは、認可設定画面で確認できます。

14

ntra-mart Accel Platform — IM-Authz（認可）インポート・エクスポート仕様書 第4版 2019-08-01

図 「XMLファイルの例」をインポートした時の認可設定画面

サブジェクトグループ
XMLファイル形式
以下は、XMLファイルの例です。
<authz-subject-group> タグで囲まれた１要素が１件のサブジェクトグループに該当します。
XML schema の場所：
%CONTEXT_PATH%/WEB-INF/schema/authz-subject-group.xsd

15

ntra-mart Accel Platform — IM-Authz（認可）インポート・エクスポート仕様書 第4版 2019-08-01<?xml version="1.0" encoding="UTF-8"?><root xmlns="http://www.intra-mart.jp/authz/imex/subject-group"><authz-subject-group sort-key="1"><display-name><name locale="ja">ゲストユーザ</name><name locale="en">Guest User</name></display-name><subject-group-description><description locale="ja">ゲストユーザです</description></subject-group-description><expression>S(im_authz_meta_subject:anonymous)</expression></authz-subject-group><authz-subject-group sort-key="2"><display-name><name locale="ja">認証済みユーザ</name><name locale="en">Authenticated User</name></display-name><subject-group-description><description locale="ja">認証済みユーザです</description></subject-group-description><expression>S(im_authz_meta_subject:authenticated)</expression></authz-subject-group><authz-subject-group sort-key="1"><display-name><name locale="ja">認可 管理者</name><name locale="en">Authz Setting Manager</name></display-name><subject-group-description><description locale="ja">認可管理者です</description></subject-group-description><expression>S(b_m_role:authz_manager)</expression></authz-subject-group></root>各タグ・属性の説明は、以下の通りです。
「IM-Authz（認可）インポートデータ定義書 」も合わせて、参照してください。
項目

タグ名

説明

サブジェクトグループ

authz-subject-group

１つのサブジェクトグループを定義します。
このタグに指定可能な属性は、以下の通りです。
属性

説明

sort-key

サブジェクトグループカテゴリ
内でのソート番号。

表示名display-name

サブジェクトグループに設定する表示名を指定します。
ロケールごとに指定可能です。

16

ntra-mart Accel Platform — IM-Authz（認可）インポート・エクスポート仕様書 第4版 2019-08-01
項目

タグ名

説明

ロケールごとの表示名

name

ロケール別に、サブジェクトグループに設定する表示
名を、64文字以内で指定します。
このタグに指定可能な属性は、以下の通りです。
属性

説明

locale ロケールID
説明

ロケールごとの説明

subject-group-

サブジェクトグループに設定する説明を指定します。

description

ロケールごとに指定可能です。

description

ロケール別に、サブジェクトグループに設定する説明を、1,000文字以内で指定します。
このタグに指定可能な属性は、以下の通りです。
属性

説明

locale ロケールID
expression

条件式

サブジェクトグループの条件式を、半角4,000文字以内で指定します。
条件式の詳細は、「認可仕様書 - サブジェクト管理 式表現 」を参照してください。

コラム
サブジェクトグループカテゴリは、インポートしたサブジェクトグループの条件式によって、インポート時に自動的に作成されます。
インポートしたサブジェクトグループは、認可設定画面で確認できます。

17

ntra-mart Accel Platform — IM-Authz（認可）インポート・エクスポート仕様書 第4版 2019-08-01
図 「XMLファイルの例」をインポートした時の認可設定画面

ポリシー
XMLファイル形式
以下は、XMLファイルの例です。
<authz-policy> タグで囲まれた１要素が１件のポリシーに該当します。
XML schema の場所：
%CONTEXT_PATH%/WEB-INF/schema/authz-policy.xsd<?xml version="1.0" encoding="UTF-8"?><root xmlns="http://www.intra-mart.jp/authz/imex/policy"><authz-policy subject="S(b_m_role:tenant_manager)" action="execute" type="service" resource="imauthz-settings-basic-service">PERMIT</authz-policy><authz-policy subject="S(b_m_role:authz_manager)" action="execute" type="service" resource="imauthz-settings-basic-service">PERMIT</authz-policy><authz-policy subject="S(b_m_role:tenant_manager)" action="execute" type="service" resource="imauthz-settings-parts-service">PERMIT</authz-policy><authz-policy subject="S(b_m_role:authz_manager)" action="execute" type="service" resource="imauthz-settings-parts-service">PERMIT</authz-policy><authz-policy subject="S(b_m_role:menu_manager)" action="execute" type="service" resource="imauthz-settings-parts-service">PERMIT</authz-policy><authz-policy subject="S(b_m_role:menu_operator)" action="execute" type="service" resource="imauthz-settings-parts-service">PERMIT</authz-policy><authz-policy subject="S(b_m_role:tenant_manager)" action="execute" type="service" resource="imauthz-settings-procedure-service">PERMIT</authz-policy><authz-policy subject="S(b_m_role:authz_manager)" action="execute" type="service" resource="imauthz-settings-procedure-service">PERMIT</authz-policy><authz-policy subject="S(b_m_role:menu_manager)" action="execute" type="service" resource="imauthz-settings-procedure-service">PERMIT</authz-policy><authz-policy subject="S(b_m_role:menu_operator)" action="execute" type="service" resource="imauthz-settings-procedure-service">PERMIT</authz-policy></root><authz-policy> では「許可」「禁止」の権限設定状態（エフェクト）を管理します。
各タグ・属性の説明は、以下の通りです。
「IM-Authz（認可）インポートデータ定義書 」も合わせて、参照してください。
項目

タグ名

説明

18

ntra-mart Accel Platform — IM-Authz（認可）インポート・エクスポート仕様書 第4版 2019-08-01
項目

タグ名

説明

ポリシー

authz-policy

１つのポリシーを定義します。
タグ内にはエフェクトを指定します。以下の文字列からいずれかを指定してください。
値

説明

PERMIT「許可」を設定します。

DENY「禁止」を設定します。

UNSET「未設定」（設定を解除し、上位リソースの設定を継承します）。

このタグに指定可能な属性は、以下の通りです。
属性

説明

subject

エフェクトを設定するサブジェクトグループの条件式を、半角4,000文字以内で指定します。
条件式の詳細は、「認可仕様書 - サブジェクト
管理 - 式表現 」を参照してください。

resource

エフェクトを設定するリソースグループのIDを指定します。

type

エフェクトを設定するアクションが定義されているリソースタイプのIDを指定します。

actionエフェクトを設定するアクションのIDを指定します。

インポートしたポリシーは、認可設定画面で確認できます。

図 「XMLファイルの例」をインポートした時の認可設定画面

19

ntra-mart Accel Platform — IM-Authz（認可）インポート・エクスポート仕様書 第4版 2019-08-01
Excel（xlsx）形式
出力例
Excel（xlsx）形式の場合は、規定のテンプレートで作成された権限設定マトリクスシートを使用します。
ファイルは SpreadsheetML フォーマットを使用します。この形式は、Excel(R) 2007 以上などの表計算ソフトで作成できます。

注意
xls形式のファイルには非対応です。
Excel(R) 2007 以上を使用している場合でも、必ずxlsx形式で保存してください。
intra-mart Accel Platform で用意されているデフォルトのテンプレートを使用した場合、認可設定画面の権限設
定マトリクスと同じようなデザインで表示されます。

図 Excel（xlsx）形式で出力したファイルの全体イメージ
各箇所についての説明は、以下の通りです。
図中の番
号

項目

１

リソースグループ・リソースの リソースグループ・リソースの親子関係をツリー形式で定義し

２

説明

ツリー（縦軸）ます。

サブジェクトグループの一覧

サブジェクトグループカテゴリと、配下にサブジェクトグルー（横軸）

プを横並びで定義します。

20

ntra-mart Accel Platform — IM-Authz（認可）インポート・エクスポート仕様書 第4版 2019-08-01
図中の番
号

項目

説明

３

ポリシーのマトリクス

リソースグループ・リソース・サブジェクトグループの組み合
わせに対して設定するエフェクトを定義します。
定義方法は使用するテンプレートによって異なります。intramart Accel Platform で用意されているデフォルトのテンプ
レートを使用した場合の定義は、以下の通りです。
設定値

説明

レ

許可

×

禁止

↑レ

未設定（親リソースを継承した結果、許可）↑×

未設定（親リソースを継承した結果、禁止）ポリシーのマトリクスでは、各セルに指定された文字列で内容を判断しますので、背景色・文字色などの装飾は影響しません。
４

リソースの種類（シート別）

リソースの種類にシートを分けて定義します。

注意
Excel（xlsx）形式では、リソースグループ・リソース・サブジェクトグループを特定するために、隠しセルにIDなどのキー値を保存しています。
したがって、インポート用のファイルとして用意するためには、あらかじめエクスポート機能を使用してテンプレートから出力しておいたファイルを使用する必要があります。
また、行（リソースグループ）・列（サブジェクトグループ）を手動で増減させた場合、増やした分のデータIDや親子関係が特定できなくなるため、インポートに失敗します。
※エクスポート直後のファイルは、行・列を操作できなくするために、保護がかけられています。

テンプレートファイルの仕様
intra-mart Accel Platform で用意されているデフォルトのテンプレートには、認可設定画面の権限設定マトリク
スと同じようなデザインで出力するための定義が行われています。
テンプレートファイルは、パブリックストレージの以下の場所に保存されています。
%PUBLIC_STORAGE%/products/im_authz_xlsx_import_export/authz_template.xlsx
テンプレートファイルの一部は、デザインの変更を目的として、定義を編集できます。
変更できる箇所とその説明は、以下の通りです。

21

ntra-mart Accel Platform — IM-Authz（認可）インポート・エクスポート仕様書 第4版 2019-08-01

図 Excel（xlsx）のテンプレートファイル
図中の番
号

項目

説明

１

ヘッダ領域

出力するExcel（xlsx）形式のヘッダ部を定義します。
例えば、会社名などの簡単な情報をあらかじめ配置できます。
出力日など、エクスポートの状況によって出力内容が変わる可変項目には対応していません。
エクスポート時、D〜G列目は自動的に非表示に変わりますので、何も入力しないでください。
また、最後に文字列が設定されているセルから、右方向に連続して11以上の空きセルがある場合、それ以降右側に定義されたセルは出力されませんので注意してください。
intra-mart Accel Platform で用意されているデフォルトのテンプレートには、凡例が定義されています。

２

エフェクトを表すセ 左から「許可」「禁止」「未設定（継承した結果、許可）」「未設定（継ル

承した結果、禁止）」の４つのセルを定義します。
ポリシーのマトリクスを出力する際、このセルの中から状態が一致するものがコピーされますので、このセルの背景色・文字色・文字列を変更すると、エクスポート時のマトリクスでエフェクトの表現方法を変更できます。
ヘッダ部の凡例とは独立していますので注意してください。

３

権限表の左上ヘッダ 「リソース」と「アクション」となる部分です。
背景色と文字色を変更できます。
文字列は自動的に設定されますので、何も入力しないでください。

４

権限表のリソース・ リソースグループとアクションの名称を表示するセルのデザインを定義し
アクション

ます。
背景色と文字色を変更できます。
文字列は自動的に設定されますので、何も入力しないでください。

22

ntra-mart Accel Platform — IM-Authz（認可）インポート・エクスポート仕様書 第4版 2019-08-01
図中の番
号

項目

５

権限表のサブジェク サブジェクトグループとサブジェクトグループカテゴリの名称を表示する
トグループ・サブ

説明

セルのデザインを定義します。

ジェクトグループカ
テゴリ

背景色と文字色を変更できます。
文字列は自動的に設定されますので、何も入力しないでください。

注意
上記以外の場所は変更しないでください。変更した場合、エクスポートに失敗する可能性があります。
装飾については、文字色・背景色・文字サイズの設定のみコピーされます。その他の装飾（条件付書式、グループ化など）は反映されません。

23

ntra-mart Accel Platform — IM-Authz（認可）インポート・エクスポート仕様書 第4版 2019-08-01

インポート
項目
更新モード
merge
replace
リソースグループ
XML
更新モード
merge
replace
インポートの依存関係
リソース
XML
更新モード
merge
replace
インポートの依存関係
サブジェクトグループ
XML
更新モード
merge
replace
インポートの依存関係
ポリシー
XML
Excel（xlsx）
更新モード
インポートの依存関係ポリシーの置換インポート

更新モード
更新モードを使用することで、インポートの目的にあわせたデータの更新を行うことができます。
更新モードには、「merge」、および、「replace」が提供されています。
XML形式の場合、ポリシーを除いて、update-mode 属性を指定することでモードを設定します。
Excel（xlsx）形式の場合、更新モードの指定はありません。

merge
インポートファイルのデータとデータベース上のデータをマージして更新します。
インポートファイルに存在しない項目は既存のデータをそのまま設定します。

24

ntra-mart Accel Platform — IM-Authz（認可）インポート・エクスポート仕様書 第4版 2019-08-01
replace
インポートファイルのデータに存在しない情報は未設定の値（デフォルト値）で更新します。
インポートファイルに存在しない項目は値無しとして設定されます。

リソースグループXML
XML形式では、<authz-resource-group> タグを１レコードとしてインポートします。
ファイルのフォーマットについては「XMLファイル形式 」を参照してください。
インポート時の動作をオプションとして指定が可能です。
インポート時に利用可能なオプションについては、「XMLのオプション 」を参照してください。

更新モード
リソースグループの更新モードには「merge 」、「replace 」が提供されています。
update-mode 属性は、<authz-resource-group> タグに指定します。
特に指定していない場合、「merge」モードで動作します。

merge
未登録ロケールの表示名、または、説明を追加する場合に使用します。
更新対象のリソースグループ配下に子のリソースグループが登録されていた場合、 子のリソースグループには影響しません。

図 mergeモードによるインポート結果のイメージ

replace
既存の表示名、または、説明を削除して、新たに登録する場合に使用します。
更新対象のリソースグループ配下に子のリソースグループが登録されていた場合、子のリソースグループはすべて削除されます。

25

ntra-mart Accel Platform — IM-Authz（認可）インポート・エクスポート仕様書 第4版 2019-08-01

図 replaceモードによるインポート結果のイメージ

インポートの依存関係
リソースグループをインポートする際、指定した親となるリソースグループをあらかじめ登録してください。
同じインポートファイル内で親子を定義する場合は、親を子よりもファイルの先頭側に定義してください。
親となるリソースグループが登録されていない場合、エラー E.IWP.AUTHZ.IMPORT.10010 が発生します。

リソース
XML
XML形式では、<authz-resource> タグを１レコードとしてインポートします。
ファイルのフォーマットについては「XMLファイル形式 」を参照してください。
インポート時の動作をオプションとして指定が可能です。
インポート時に利用可能なオプションについては、「XMLのオプション 」を参照してください。

注意<authz-resource> タグの id 属性に指定されたIDがキーとなり更新処理が行われますが、id 属性が指定されなかった場合は uri 属性に指定されたURIをもとに、URIで一意になるIDが自動的に作成され、IDとして使用されます。
IDと同様に、URIもテナント内で一意になるように指定する必要があります。

更新モード
リソースの更新モードには「merge 」、「replace 」が提供されています。
update-mode 属性は、<authz-resource> タグに指定します。
特に指定していない場合、「merge」モードで動作します。

merge
未登録ロケールの表示名、または、説明を追加する場合に使用します。

26

ntra-mart Accel Platform — IM-Authz（認可）インポート・エクスポート仕様書 第4版 2019-08-01

図 mergeモードによるインポート結果のイメージ

replace
既存の表示名、または、説明を削除して、新たに登録する場合に使用します。

図 replaceモードによるインポート結果のイメージ

インポートの依存関係
リソースをインポートする際、指定した親となるリソースグループをあらかじめ登録する必要があります。
同じインポートファイル内で親子を定義する場合は、親を子よりもファイルの先頭側に定義してください。
親となるリソースグループが登録されていない場合、エラー E.IWP.AUTHZ.IMPORT.10007 が発生します。

サブジェクトグループ
XML
XML形式では、<authz-subject-group> タグを１レコードとしてインポートします。
ファイルのフォーマットについては「XMLファイル形式 」を参照してください。
インポート時の動作をオプションとして指定が可能です。
インポート時に利用可能なオプションについては、「XMLのオプション 」を参照してください。

更新モード
サブジェクトグループの更新モードには「merge 」、「replace 」が提供されています。
update-mode 属性は、<authz-subject-group> タグに指定します。
特に指定していない場合、「merge」モードで動作します。

27

ntra-mart Accel Platform — IM-Authz（認可）インポート・エクスポート仕様書 第4版 2019-08-01
merge
未登録ロケールの表示名、または、説明を追加する場合に使用します。

図 mergeモードによるインポート結果のイメージ

replace
既存の表示名、または、説明を削除して、新たに登録する場合に使用します。

図 replaceモードによるインポート結果のイメージ

インポートの依存関係
サブジェクトグループをインポートする際、特に依存するデータはありませんが、サブジェクトの条件式に指定する対象者データをあらかじめ登録しておくことをお勧めします。
例えば、S(b_m_role:tenant_manager) を条件式に指定する場合、あらかじめ「tenant_manager」のIDでロールを作成してください。

ポリシー
XML
XML形式では、<authz-policy> タグを１レコードとしてインポートします。
ファイルのフォーマットについては「XMLファイル形式 」を参照してください。
インポート時の動作をオプションとして指定が可能です。
インポート時に利用可能なオプションについては、「XMLのオプション 」を参照してください。

Excel（xlsx）
28

ntra-mart Accel Platform — IM-Authz（認可）インポート・エクスポート仕様書 第4版 2019-08-01
Excel（xlsx）形式では、シート上のポリシー部分（下図の赤枠部分）の１セルを１レコードとしてインポートします。
インポート時は、左上のセルを開始点として右方向へ走査し、順次下方向へ進みインポートが行われます。
ファイルのフォーマットについては「Excel（xlsx）形式 」を参照してください。

図 Excel（xlsx）形式で出力したファイルのポリシー部分
インポート時の動作をオプションとして指定が可能です。
インポート時に利用可能なオプションについては、「Excel（xlsx）のオプション 」を参照してください。
intra-mart Accel Platform で用意されているデフォルトのテンプレートを使用した場合、ポリシー部分に指定可
能な文字列は、以下の通りです。
また、「未設定認可ポリシー検証フラグ 」の設定値によってチェック内容が変わります。
「未設定認可ポリシー検証フラグ 」 「未設定認可ポリシー検証フラグ 」
設定値

説明＝ true＝ falseレ

許可「許可」として更新します。

「許可」として更新します。

×禁止「禁止」として更新します。

「禁止」として更新します。

↑レ

未設定（親リソース 継承結果が「許可」以外の場合、エ継承結果にかかわらず、「未設定」を継承した結果、許 ラー E.IWP.AUTHZ.XLSX.21012

として更新します。

可）↑×が発生します。

未設定（親リソース 継承結果が「禁止」以外の場合、エ継承結果にかかわらず、「未設定」を継承した結果、禁 ラー E.IWP.AUTHZ.XLSX.21013

として更新します。

止）が発生します。

29

ntra-mart Accel Platform — IM-Authz（認可）インポート・エクスポート仕様書 第4版 2019-08-01「未設定認可ポリシー検証フラグ 」 「未設定認可ポリシー検証フラグ 」
設定値

説明

上記以外 不明な指定＝ true＝ false

必ずエラー

更新しません。

E.IWP.AUTHZ.XLSX.21014 が発生
します。

更新モード
ポリシーの場合、更新モード指定はできず、常にインポートデータで上書きされます。
リソースグループ・リソース・サブジェクトグループのインポートとは異なり、 エフェクトに「未設定」が定義されている場合は、該当するポリシーが削除されます。
ただし、インポートデータに含まれないキーのポリシーには影響しません。

図 インポート結果のイメージ

インポートの依存関係ポリシーをインポートする際、エフェクトの設定対象となるリソースグループ、リソースをあらかじめ登録する必要があります。
また、存在しないリソースタイプID、アクションIDを指定することはできません。
エフェクトの設定対象となるリソースグループ、または、リソースが登録されていない場合の動作は以下のとおりです。

30

ntra-mart Accel Platform — IM-Authz（認可）インポート・エクスポート仕様書 第4版 2019-08-01
ファイル形式

動作

XML形式

エラー E.IWP.AUTHZ.IMPORT.10001 が発生します。

Excel（xlsx）形式

エラー E.IWP.AUTHZ.XLSX.21006 が発生します。
「リソースグループ・リソース存在検証フラグ 」に false を設定している場合は、無視します。

エフェクトの設定対象となるリソースタイプIDが存在しない場合の動作は以下のとおりです。
ファイル形式

動作

XML形式

エラー E.IWP.AUTHZ.IMPORT.10002 が発生します。

Excel（xlsx）形式

エラー E.IWP.AUTHZ.XLSX.21008 が発生します。
「リソースグループ・リソース存在検証フラグ 」に false を設定している場合は、無視します。

エフェクトの設定対象となるアクションIDが存在しない場合の動作は以下のとおりです。
ファイル形式

動作

XML形式

システムエラーが発生します。

Excel（xlsx）形式

エラー E.IWP.AUTHZ.XLSX.21009 が発生します。
「リソースグループ・リソース存在検証フラグ 」に false を設定している場合は、無視します。

エフェクトの設定対象となるサブジェクトグループが登録されていない場合の動作は以下のとおりです。
ファイル形式

動作

XML形式

指定されている条件式でサブジェクトグループが作成されますが、名称が設定されません。

Excel（xlsx）形式

エラー E.IWP.AUTHZ.XLSX.21010、または、E.IWP.AUTHZ.XLSX.21011 が発生します。
「サブジェクトグループ存在検証フラグ 」に false を設定している場合は、無視します。

ポリシーの置換インポート
XML形式を使用してインポートする場合、明示的に「未設定」をエフェクトに指定した場合に限り、ポリシーの削除処理を行います。
そのため、「未設定」のエフェクトを指定していないXML形式のファイルを使用してシステム全体のポリシーを完
全に置き換えるために、「認可（ポリシー）置換インポート」ジョブネットを使用できます。

31

ntra-mart Accel Platform — IM-Authz（認可）インポート・エクスポート仕様書 第4版 2019-08-01

エクスポート項目
リソースグループ
XML
リソース
XML
サブジェクトグループ
XML
ポリシー
XML
Excel（xlsx）

リソースグループXML
すべてのリソースグループとそれに関連する情報を、XML形式でファイルに出力します。
ファイルのフォーマットについては「XMLファイル形式 」を参照してください。

リソース
XML
すべてのリソースとそれに関連する情報を、XML形式でファイルに出力します。
ファイルのフォーマットについては「XMLファイル形式 」を参照してください。

サブジェクトグループ
XML
すべてのサブジェクトグループとそれに関連する情報を、XML形式でファイルに出力します。
ファイルのフォーマットについては「XMLファイル形式 」を参照してください。

ポリシー
XML
すべてのポリシー情報を、XML形式でファイルに出力します。
ファイルのフォーマットについては「XMLファイル形式 」を参照してください。

Excel（xlsx）
32

ntra-mart Accel Platform — IM-Authz（認可）インポート・エクスポート仕様書 第4版 2019-08-01
すべて、または、指定されたリソースの種類に登録されているポリシー情報、および、ポリシーに関連するリソー
スグループ・リソース・サブジェクトグループ情報を、Excel（xlsx）形式でファイルに出力します。
ファイルのフォーマットについては「Excel（xlsx）形式 」を参照してください。

33

ntra-mart Accel Platform — IM-Authz（認可）インポート・エクスポート仕様書 第4版 2019-08-01

オプション
項目
インポートオプション
XMLのオプション
XMLのポリシー専用オプション
Excel（xlsx）のオプション
エクスポートオプション
XMLのオプション
Excel（xlsx）のオプション

インポートオプション
XMLのオプション
コラム
この項で説明されているインポートオプションは、リソースグループ・リソース・サブジェクトグ
ループ・ポリシーのすべてにおいて使用可能です。

名前

キー名

型

デフォルト値

導入バージョン

エンコーディング

encoding

文字列

UTF-8

2012 Autumn

ファイルパス

file

文字列2012 Autumn

データの種
類

デフォルト値

リソースグ authz-resourceループ

group.xml

リソース

authzresource.xml

サブジェク authz-subjectトグループ group.xml
ポリシー

authzpolicy.xml

コミット件数

commit-数値

02012 Autumn

真偽値

true

2012 Autumn

count
XML検証フラグ

validate-xml

エンコーディング
キー名 encoding
インポートするXMLファイルの文字エンコーディングを指定します。

34

ntra-mart Accel Platform — IM-Authz（認可）インポート・エクスポート仕様書 第4版 2019-08-01
ファイルパス
キー名 file
インポートするXMLファイルのパス（パブリックストレージのルートからの相対パス）を指定します。

コミット件数
キー名 commit-count
インポート処理で、コミットを行うまでのデータ件数を指定します。
コミット件数に「0」（デフォルト値）が指定された場合は、インポート処理が完了するまでコミットが行われません。

注意
commit-count を指定した場合、インポート実行元で管理しているトランザクションがコミットされる可能性があります。

XML検証フラグ
キー名 validate-xml
インポートするXMLファイルの構文を検証するかどうかを指定します。
指定する値

説明

true

XML構文の検証を行います。（デフォルト
値）

false

XML構文の検証を行いません。

XMLのポリシー専用オプション
名前

キー名

リソースグループ・リソース存 validate-resource-

型

デフォルト値

導入バージョン

真偽値

true2019 Summer

exists

在検証フラグ

リソースグループ・リソース存在検証フラグ
キー名

validate-resourceexists

インポートするXMLファイルに定義されたリソースグループ・リソースに関するデータが登録されているかどうか検証します。
指定する値

説明

35

ntra-mart Accel Platform — IM-Authz（認可）インポート・エクスポート仕様書 第4版 2019-08-01
指定する値

説明

true

リソースグループ・リソースの存在を検証します。（デフォルト値）
存在しないリソースグループ・リソースが定義されていた場合、エラー扱いとしてインポート処理を中断します。

false

リソースグループ・リソースの存在を検証しません。
存在しないリソースグループ・リソースに対してのポリシー設定は無視されます。

Excel（xlsx）のオプション
名前

キー名

型

デフォルト値

導入バージョン

ファイルパスfile

文字列authz.xml

2014 Summer

コミット件数

commit-count数値02014 Summer

未設定認可ポリシー検証フラグ validate-inherits

真偽値

false

2014 Summer

リソースグループ・リソース存 validate-resource-

真偽値

true

2014 Summer

真偽値

false

2014 Summer

在検証フラグexists

サブジェクトグループ存在検証 validate-subject-exists
フラグ

ファイルパス
キー名 file
インポートするExcel（xlsx）ファイルのパス（パブリックストレージのルートからの相対パス）を指定します。

コミット件数
キー名 commit-count
インポート処理で、コミットを行うまでのデータ件数を指定します。
コミット件数に「0」（デフォルト値）が指定された場合は、インポート処理が完了するまでコミットが行われません。

注意
commit-count を指定した場合、インポート実行元で管理しているトランザクションがコミットされる可能性があります。

未設定認可ポリシー検証フラグ
キー名 validate-inherits
インポートするExcel（xlsx）ファイルに定義されたポリシーのセルのうち「未設定」に指定されているエフェク
トにおいて、親リソースを継承した結果が一致するかどうかを検証します。

36

ntra-mart Accel Platform — IM-Authz（認可）インポート・エクスポート仕様書 第4版 2019-08-01
指定する値

説明

true

継承した結果が一致するか検証します。
結果が一致しないセルが含まれる場合、エラー扱いとしてインポート処理を中断
します。

false

継承した結果が一致するか検証しません。（デフォルト値）
結果が一致しないセルが含まれている場合でも、継承扱いとしてインポートします（無視されません）。

リソースグループ・リソース存在検証フラグ
キー名

validate-resourceexists

インポートするExcel（xlsx）ファイルに定義されたリソースグループ・リソースに関するデータが登録されているかどうか検証します。
指定する値

説明

true

リソースグループ・リソースの存在を検証します。（デフォルト値）
存在しないリソースグループ・リソースが定義されていた場合、エラー扱いとしてインポート処理を中断します。

false

リソースグループ・リソースの存在を検証しません。
存在しないリソースグループ・リソースに対してのポリシー設定は無視されます。

サブジェクトグループ存在検証フラグ
キー名

validate-subject-exists

インポートするExcel（xlsx）ファイルに定義されたサブジェクトグループに関するデータが登録されているかど
うか検証します。
指定する値

説明

true

サブジェクトグループの存在を検証します。
存在しないサブジェクトグループが定義されていた場合、エラー扱いとしてインポート処理を中断します。

false

サブジェクトグループの存在を検証しません。（デフォルト値）
存在しないサブジェクトグループに対してのポリシー設定は無視されます。

エクスポートオプション
XMLのオプション

37

ntra-mart Accel Platform — IM-Authz（認可）インポート・エクスポート仕様書 第4版 2019-08-01
コラム
この項で説明されているインポートオプションは、リソースグループ・リソース・サブジェクトグ
ループ・ポリシーのすべてにおいて使用可能です。

名前

キー名

型

デフォルト値

導入バージョン

エンコーディング

encoding

文字列

UTF-8

2012 Autumn

ファイルパス

file

文字列2012 Autumn

データの種
類

デフォルト値

リソースグ authz-resourceループ

group.xml

リソース

authzresource.xml

サブジェク authz-subjectトグループ group.xml
ポリシー

authzpolicy.xml

XML整形フラグ

format-xml

真偽値

false

2012 Autumn

ルートタグ名root-tag-

文字列

root

2012 Autumn

数値

5000

2012 Autumn

nameflush-count

書き込み件数

エンコーディング
キー名 encoding
エクスポートするXMLファイルの文字エンコーディングを指定します。

ファイルパス
キー名 file
エクスポートするXMLファイルのパス（パブリックストレージのルートからの相対パス）を指定します。

XML整形フラグ
キー名 format-xml
エクスポートするXMLファイルを整形するかどうかを指定します。
指定する値

説明

true

XMLの整形を行います。

false

XMLの整形を行いません。（デフォルト値）

38

ntra-mart Accel Platform — IM-Authz（認可）インポート・エクスポート仕様書 第4版 2019-08-01
ルートタグ名キー名 root-tag-name
エクスポートするXMLファイルのルートタグ名を指定します。

書き込み件数
キー名 flush-count
エクスポートするXMLファイルに一度に書き込むデータ件数を指定します。

Excel（xlsx）のオプション
導入バー
名前

キー名

型

デフォルト値

ジョン

ファイ

file

文

authz.xlsx

2014

ルパス

Summer字
列

ロケー

locale-id

ル

文

ja

2014
Summer字列

リソー

part-id

文

スの種

字

類

列

テンプ

template-

文

レート

file

字

ファイ

2014

（空文字列）

Summerproducts/im_authz_xlsx_import_export/authz_template.xlsx 2014
Summer

列

ル
保護パ

xlsx-

文

スワー

password字ド

intramart

2014
Summer列

ファイルパス
キー名 file
エクスポートするExcel（xlsx）ファイルのパス（パブリックストレージのルートからの相対パス）を指定します。

ロケール
キー名 locale-id
エクスポートするExcel（xlsx）ファイルに書き込むリソースグループ・リソース・サブジェクトグループの名称
をどの言語で出力するか指定します。

39

ntra-mart Accel Platform — IM-Authz（認可）インポート・エクスポート仕様書 第4版 2019-08-01
リソースの種類
キー名 part-id
エクスポートするExcel（xlsx）ファイルに書き込むリソースの種類を、設定IDで指定します。
設定IDは、認可設定画面のタイトル部分に表示されます。
指定しない場合、すべてのリソースの種類をシート別に分けて出力します。

テンプレートファイル
キー名 template-file
エクスポートするExcel（xlsx）ファイルを作成するための、テンプレートファイルのパス（パブリックストレージのルートからの相対パス）を指定します。

保護パスワード
キー名 xlsx-password
エクスポートするExcel（xlsx）ファイルの変更不可部分を保護するパスワードを指定します。
指定しない場合、保護パスワードはかからず行・列の追加・更新・削除が可能ですが、実際に行うとインポート時にエラーが発生する原因です。

40

ntra-mart Accel Platform — IM-Authz（認可）インポート・エクスポート仕様書 第4版 2019-08-01

実行方法
項目
ジョブスケジューラを利用する
ジョブ
インポート
リソースグループ
リソース
サブジェクトグループ
ポリシー - XML形式
ポリシー - Excel（xlsx）形式
エクスポート
リソースグループ
リソース
サブジェクトグループ
ポリシー - XML形式
ポリシー - Excel（xlsx）形式
ジョブネット
インポート
リソースグループ
リソース
サブジェクトグループ
ポリシー - XML形式
ポリシー - Excel（xlsx）形式
エクスポート
リソースグループ
リソース
サブジェクトグループ
ポリシー - XML形式
ポリシー - Excel（xlsx）形式
認可設定画面を利用する

ジョブスケジューラを利用する
ジョブスケジューラの機能を使用して、認可に関する情報のインポート・エクスポートを実行することができます。
ジョブスケジューラの詳細については「ジョブスケジューラ仕様書 」を参照してください。
intra-mart Accel Platform では、リソースグループ・リソース・サブジェクトグループ・ポリシーのインポー
ト・エクスポートを行うためのジョブ・ジョブネットを提供しています。
この項では、intra-mart Accel Platform が標準で提供しているジョブ・ジョブネットの情報を紹介します。

ジョブ
41

ntra-mart Accel Platform — IM-Authz（認可）インポート・エクスポート仕様書 第4版 2019-08-01
インポート
リソースグループ
ジョブカテゴリ テナントマスタ > インポート
ジョブID

authz-resource-group-import

ジョブ名

認可（リソースグループ）インポート

リソース
ジョブカテゴリ テナントマスタ > インポート
ジョブID

authz-resource-import

ジョブ名

認可（リソース）インポート

サブジェクトグループ
ジョブカテゴリ

テナントマスタ > インポート

ジョブID

authz-subject-group-import

ジョブ名

認可（サブジェクトおよびグループ）インポート

ポリシー - XML形式
ジョブカテゴリ テナントマスタ > インポート
ジョブID

authz-policy-import

ジョブ名

認可（ポリシー）インポート

ジョブカテゴリ テナントマスタ > インポート
ジョブID

authz-policy-sweeper

ジョブ名

認可（ポリシー）一括削除

コラム「認可（ポリシー）一括削除」ジョブは、「認可（ポリシー）置換インポート」で使用するためのジョブです。

ポリシー - Excel（xlsx）形式
ジョブカテゴリ

テナントマスタ > インポート（Excel）

ジョブID

authz-import-xlsx

ジョブ名

認可インポート（Excel）

42

ntra-mart Accel Platform — IM-Authz（認可）インポート・エクスポート仕様書 第4版 2019-08-01
エクスポート
リソースグループ
ジョブカテゴリ

テナントマスタ > エクスポート

ジョブID

authz-resource-group-export

ジョブ名

認可（リソースグループ）エクスポー
トリソース
ジョブカテゴリ テナントマスタ > エクスポート
ジョブID

authz-resource-export

ジョブ名

認可（リソース）エクスポート

サブジェクトグループ
ジョブカテゴリ

テナントマスタ > エクスポート

ジョブID

authz-subject-group-export

ジョブ名

認可（サブジェクトおよびグループ）エクスポート

ポリシー - XML形式
ジョブカテゴリ テナントマスタ > エクスポート
ジョブID

authz-policy-export

ジョブ名

認可（ポリシー）エクスポート

ポリシー - Excel（xlsx）形式
ジョブカテゴリ

テナントマスタ > エクスポート（Excel）

ジョブID

authz-export-xlsx

ジョブ名

認可エクスポート（Excel）

ジョブネット
インポート
リソースグループ
ジョブネットカテゴリ テナントマスタ > インポート

43

ntra-mart Accel Platform — IM-Authz（認可）インポート・エクスポート仕様書 第4版 2019-08-01
ジョブネットID

authz-resource-group-import-jobnet

ジョブネット名

認可（リソースグループ）インポート

リソース
ジョブネットカテゴリ テナントマスタ > インポート
ジョブネットID

authz-resource-import-jobnet

ジョブネット名

認可（リソース）インポート

サブジェクトグループ
ジョブネットカテゴリ テナントマスタ > インポート
ジョブネットID

authz-subject-group-import-jobnet

ジョブネット名

認可（サブジェクトおよびグループ）インポート

ポリシー - XML形式
ジョブネットカテゴリ テナントマスタ > インポート
ジョブネットID

authz-policy-import-jobnet

ジョブネット名

認可（ポリシー）インポート

ジョブネットカテゴリ テナントマスタ > インポート
ジョブネットID

authz-policy-replace-import-jobnet

ジョブネット名

認可（ポリシー）置換インポート

コラム「認可（ポリシー）置換インポート」ジョブネットは、テナントに登録されているポリシーの全デー
タをインポート対象のXML形式のファイル内容で完全に置き換えるためのジョブネットです。
このジョブネットは「認可（ポリシー）一括削除」ジョブを実行後、「認可（ポリシー）インポー
ト」ジョブを実行します。

ポリシー - Excel（xlsx）形式
ジョブネットカテゴリ テナントマスタ > インポート（Excel）
ジョブネットID

authz-import-xlsx-jobnet

ジョブネット名

認可インポート（Excel）

エクスポート
リソースグループ44

ntra-mart Accel Platform — IM-Authz（認可）インポート・エクスポート仕様書 第4版 2019-08-01
ジョブネットカテゴリ テナントマスタ > エクスポート
ジョブネットID

authz-resource-group-export-jobnet

ジョブネット名

認可（リソースグループ）エクスポート

リソース
ジョブネットカテゴリ テナントマスタ > エクスポート
ジョブネットID

authz-resource-export-jobnet

ジョブネット名

認可（リソース）エクスポート

サブジェクトグループ
ジョブネットカテゴリ テナントマスタ > エクスポート
ジョブネットID

authz-subject-group-export-jobnet

ジョブネット名

認可（サブジェクトおよびグループ）エクスポート

ポリシー - XML形式
ジョブネットカテゴリ テナントマスタ > エクスポート
ジョブネットID

authz-policy-export-jobnet

ジョブネット名

認可（ポリシー）エクスポート

ポリシー - Excel（xlsx）形式
ジョブネットカテゴリ テナントマスタ > エクスポート（Excel）
ジョブネットID

authz-export-xlsx-jobnet

ジョブネット名

認可エクスポート（Excel）

認可設定画面を利用する
テナント管理機能の認可設定画面から、認可に関する情報のインポート・エクスポートを実行することができます。
認可設定画面の詳細については「テナント管理者操作ガイド - 認可を設定する 」を参照してください。
認可設定画面からインポートできるデータは、以下の通りです。
ポリシー - Excel（xlsx）形式
認可設定画面からエクスポートできるデータは、以下の通りです。
リソースグループ（パブリックストレージに保存）
リソース（パブリックストレージに保存）

45

ntra-mart Accel Platform — IM-Authz（認可）インポート・エクスポート仕様書 第4版 2019-08-01
サブジェクトグループ（パブリックストレージに保存）ポリシー - XML形式（パブリックストレージに保存）ポリシー - Excel（xlsx）形式（パブリックストレージに保存され、認可設定画面上からダウンロード可能）46

ntra-mart Accel Platform — IM-Authz（認可）インポート・エクスポート仕様書 第4版 2019-08-01

付録
項目
IM-Authz（認可）インポートデータ定義書

IM-Authz（認可）インポートデータ定義書
リソースグループ・リソース・サブジェクトグループ・ポリシーのインポート・エクスポートで利用するデータの
詳細は、IM-Authz（認可）インポートデータ定義書として提供します。
IM-Authz（認可）インポートデータ定義書は、以下からダウンロードできます。
「im_authz_import_export_definition.xls」

47