ユーザーに従うウィジェット

いくつかのウィジェットと一つの Bean が、誰がログインしているかに従います。context.principal と PrincipalBuilder はログインとログアウトのたびに再ビルドされ、PrincipalView は、ロール、権限、SpEL 式に一致するユーザーにだけ子を表示します。これらは表示専用です。アクセスはサーバーがチェックします。

使う理由

アプリはユーザーの手の中にある (パッチを当てられ、API を直接呼ばれうる) ので、ボタンを隠しても何も保護されません。保護するのはサーバーのチェック (403) です。これらのウィジェットは、ページが何を描画するかを決めるだけの Thymeleaf の sec:authorize と同じく、失敗するボタンをユーザーに見せずに済ませるだけです。セキュリティではなくプリンシパル (誰がログインしているかを表す Spring の言葉) にちなんで名付けられているので、保護を約束しません。

例

// ユーザーに挨拶するか、ログインを提供するヘッダー。
PrincipalBuilder(
  builder: (context, authentication) => authentication == null
      ? const LoginButton()
      : Text('Hello, ${authentication.name}'),
)

// 管理者だけのための管理メニュー。
PrincipalView(
  hasRole: 'ADMIN',
  child: const AdminMenu(),
  otherwise: const SizedBox.shrink(),
)

// 任意のウィジェット: ユーザーが変わると再ビルドされる。
Text('Hello, ${context.principal?.name ?? 'guest'}');

部品

PrincipalView のパラメーター 意味
hasRole ユーザーがこのロールを持つ (ADMIN は権限 ROLE_ADMIN)
hasAuthority ユーザーがこの権限を持つ (SCOPE_admin)
authenticated true: 誰かがログインしている。false: 誰もいない場合だけ
expression @PreAuthorize と同じ SpEL 式: "hasRole('ADMIN') or hasAuthority('SCOPE_admin')"
child 与えられたすべての条件が成り立つときに表示される
otherwise それ以外のときに表示される。デフォルトは何もなし

条件はアプリケーションの MethodSecurityExpressionHandler で評価されるので、ロールの階層が適用されます。

Spring (Java) との対応

Spring にはウィジェットがありません。最も近いのは、サーバーのページが何を描画するかを決める Thymeleaf の sec:authorize と sec:authentication です。

関連項目