1. GEM権限制御
GEM機能に対する権限制御のため、ロールやUtilityクラスを標準機能として提供しています。
1.1. ロール
テナント作成時に AppAdmin GemUser ロールが作成されます。次の用途を想定しています。
| ロール(ロールコード) | 役割 |
|---|---|
AppAdmin | アプリケーション管理者。 |
GemUser | アプリケーション利用者。 |
ユーザがそれぞれロールコードと同名のグループに所属することを条件としています。
1.2. 権限設定
ロールの役割に対応するため、以下の権限が予め設定されています。
| 権限 | AppAdmin | GemUser | |
|---|---|---|---|
Entity権限 | mtp.auth.* | 参照更新可能 | 参照のみ |
mtp.listing.* | 参照更新可能 |
| |
mtp.maintenance.* | 権限なし(開発者用) | 権限なし | |
mtp.scheduling.* | 参照のみ(機能上更新が必要な場合は、コード上からの特権実行) | 権限なし | |
mtp.workflow.* | 参照のみ(機能上更新が必要な場合は、コード上からの特権実行) | 権限なし | |
mtp.Information | 参照更新可能 | 参照のみ | |
Action権限 | gem/* |
| |
WebApi権限 | gem/* |
| |
Action権限、WebApi権限については、 GemAuth Utilityクラスを利用して制御しています。
1.3. GemAuth
GEMに対するAction権限、WebApi権限を制御するためにUtilityクラスを提供しています。
org.iplass.gem.auth.GemAuth
Action権限制御
org.iplass.gem.auth.GemAuth#isPermitAction(String actionName, ActionParameterBinding param)
指定された
actionNameの先頭がgem/generic/の場合は、EntityViewの権限チェック を行います。指定された
actionNameの先頭がgem/の場合は、GemUserまたはAppAdminロールを保持していればtrueを、 それ以外の場合はfalseを返します。指定された
actionNameが上記以外の場合、trueを返します。
WebApi権限制御
org.iplass.gem.auth.GemAuth#isPermitWebApi(String webApiName, WebApiParameterBinding param)
指定された
webApiNameの先頭がgem/generic/の場合は、EntityViewの権限チェック を行います。指定された
webApiNameの先頭がgem/の場合は、GemUserまたはAppAdminロールを保持していればtrueを、 それ以外の場合はfalseを返します。指定された
webApiNameが上記以外の場合、trueを返します。
EntityViewの権限チェック
指定されたパラメータから対象のEntity定義名とView名を取得し、権限をチェックします。
対象のEnity定義に対する EntityView管理設定を取得します。
EntityView定義がない場合(defaultも含め1つもない)、
AppAdminロールを保持していればtrueを、 それ以外の場合はfalseを返します。EntityView定義があるが、管理設定がない場合、
trueを返します。(許可ロールが未指定と同等)対象Viewの管理設定に許可ロールが設定されていない場合、
trueを返します。対象Viewの管理設定に許可ロールが設定されている場合、設定されたロールを保持していれば
trueを、 それ以外の場合はfalseを返します。
独自ロールでの利用
GemAuthを利用するには、対象のユーザに対して AppAdmin や GemUser ロールを付与する必要があります。
付与するためには、対象のユーザに対して AppAdmin や GemUser グループを設定するか、
上記ロール条件を変更して付与対象を変更する必要があります。
もし付与することが難しい場合で、Top画面は見せたいけど、汎用画面はEntityViewの管理設定を利用して参照権限を制御したい場合は、
独自ロールのAction権限、WebApi権限の gem/generic/ に対して、 org.iplass.gem.auth.GemAuth を指定してください。
GEMが提供するTop画面( gem/ )などはチェックの対象外になり、汎用画面( gem/generic/ )に対する
EntityViewの権限チェックだけが適用されるようになります。