認可サブジェクトコンテキスト¶

コンテキストインタフェース¶

完全修飾クラス名

jp.co.intra_mart.foundation.authz.context.AuthzSubjectContext

利用サンプル

Set<String> subjectIds = new HashSet<String>();
AuthzSubjectContext authzContext = null;

try {
    authzContext = Contexts.get(AuthzSubjectContext.class); // コンテキストの取得
} catch (final ContextNotFoundException e) {
    LOGGER.debug("AuthzSubjectContext not defined", e);
}

if (authzContext != null ) {
    subjectIds.addAll(authzContext.getSubjectIds());
    LOGGER.debug("user {} can use authz subject context", authzContext.getUserIdentifier());
}

...

保持する属性¶

属性	型	説明
subjectIds	Set<String>	アカウントコンテキストの示すユーザに対するあらかじめ明示されるサブジェクトIDの一覧。
subjectGroupIds	Set<String>	上記 subjectIds から解決可能なサブジェクトグループIDの一覧。
userIdentifier	String	ユーザ識別子。現在のデフォルト実装ではユーザコードをそのまま格納しています。
revision	long	コンテキストリビジョン。このコンテキストの内容がアップデートされたり再構築されると値が変更されます。順序や連続性は保証されません。デフォルトの実装ではコンテキストビルダーがコンテキストを変更した時の System.currentTimeMillis() が入っています。

AuthzSubjectContextBuilder¶

完全修飾クラス名

jp.co.intra_mart.system.authz.context.impl.AuthzSubjectContextBuilder

処理内容

認可サブジェクトコンテキストのインスタンスを作成して特に何もせず返すビルダーです。Web以外の環境などで後述の StandardAuthzSubjectContextBuilder が動作できる環境にない場合に使用します。

ほぼ空の状態のコンテキストが返されるので、ユーザのサブジェクトはありません。

StandardAuthzSubjectContextBuilder¶

完全修飾クラス名

jp.co.intra_mart.system.authz.context.impl.StandardAuthzSubjectContextBuilder

処理内容

アカウントコンテキストやユーザコンテキストを参照して、それらのコンテキストが構築されるタイミングで同時に認可サブジェクトコンテキストを構築します。デコレータを実行することでサブジェクトIDをコンテキストに登録させ、そのあとでそれらのサブジェクトIDをもとにサブジェクトグループIDの解決を行います。

通常のWebでの利用を想定したコンテキストビルダです。

コラム

このコンテキストビルダはテナント管理機能のテナント環境セットアップが完了していなければデコレータを一切実行しません。

これによりテナント環境セットアップが完了していない環境下ではユーザのサブジェクトが一切解決されなくなり、

OnDemandSubjectResolver によって追加でサブジェクトが解決されない限りすべての認可判定が「禁止」の状態です。

ParameterizedAuthzContextBuilder¶

完全修飾クラス名

jp.co.intra_mart.system.authz.context.impl.ParameterizedAuthzContextBuilder

処理内容

おもにユニットテスト目的で使用するビルダーですcontext-config.xmlに指定可能な <init-param> の値からコンテキストの内容を固定的に生成します。

<init-param> に以下のキーを指定可能です

キー	説明
userCd	設定した値が userIdentifier に設定されます。
subject	サブジェクトIDに格納する値を指定します。サブジェクトタイプとビジネスキーで指定できます。ただし実際認可に使用されるのは後述のサブジェクトグループIDに指定する内容なので、内容の整合性が取れている必要があります。複数指定可能です。 書式： [サブジェクトタイプID]:[キー] ... この書式については「式の文字列表現 」を参照してください。 例： b_m_role:menu_manager
subjectGroupId	サブジェクトグループIDに格納する値を指定します。実際認可に利用されるのはこの値です。複数指定可能です。 書式： オペレータ(式, 式, 式, ... ) この書式については「式の文字列表現 」を参照してください。 例： AND(S(b_m_role:menu_manager), S(imm_user:aoyagi))

デフォルトで存在するサブジェクトコンテキストデコレータ¶