Generic Entity Manager (権限制御)

GEM機能に対する権限制御のため、ロールやUtilityクラスを標準機能として提供しています。

テナント作成時に AppAdmin GemUser ロールが作成されます。次の用途を想定しています。

ロール(ロールコード)役割

AppAdmin

アプリケーション管理者。
AdminConsoleなどを利用できる管理者(開発者)とは異なり、アプリケーションの設定などを制御できる権限。

GemUser

アプリケーション利用者。
GEM機能(汎用画面やTopViewなど)を利用することができる権限。

ユーザがそれぞれロールコードと同名のグループに所属することを条件としています。

ロールの役割に対応するため、以下の権限が予め設定されています。

権限AppAdminGemUser

Entity権限

mtp.auth.*

参照更新可能

参照のみ

mtp.listing.*

参照更新可能

SavedList

ownerかshared=trueの参照可能、ownerかcanOthersEdit=trueの更新可能

SavedListFolder

参照のみ(TopViewで更新系が可能の場合は、特権実行にて実行)

mtp.maintenance.*

権限なし(開発者用)

権限なし

mtp.scheduling.*

参照のみ(機能上更新が必要な場合は、コード上からの特権実行)

権限なし

mtp.workflow.*

参照のみ(機能上更新が必要な場合は、コード上からの特権実行)

権限なし

mtp.Information

参照更新可能

参照のみ

Action権限

gem/*

org.iplass.gem.auth.GemAuth.isPermitAction(action, parameter) で制御

WebApi権限

gem/*

org.iplass.gem.auth.GemAuth.isPermitWebApi(webApi, parameter) で制御

Action権限、WebApi権限については、 GemAuth Utilityクラスを利用して制御しています。

GEMに対するAction権限、WebApi権限を制御するためにUtilityクラスを提供しています。

org.iplass.gem.auth.GemAuth
org.iplass.gem.auth.GemAuth#isPermitAction(String actionName, ActionParameterBinding param)
  • 指定された actionName の先頭が gem/generic/ の場合は、EntityViewの権限チェック を行います。

  • 指定された actionName の先頭が gem/ の場合は、GemUser または AppAdmin ロールを保持していれば true を、 それ以外の場合は false を返します。

  • 指定された actionName が上記以外の場合、 true を返します。

org.iplass.gem.auth.GemAuth#isPermitWebApi(String webApiName, WebApiParameterBinding param)
  • 指定された webApiName の先頭が gem/generic/ の場合は、EntityViewの権限チェック を行います。

  • 指定された webApiName の先頭が gem/ の場合は、GemUser または AppAdmin ロールを保持していれば true を、 それ以外の場合は false を返します。

  • 指定された webApiName が上記以外の場合、 true を返します。

指定されたパラメータから対象の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の権限チェックだけが適用されるようになります。