ユーザーに従うウィジェット
いくつかのウィジェットと一つの 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'}');
部品
PrincipalNotifier、Bean:Listenableとしての現在のAuthenticationで、ログインとログアウトのたびに変わります。SecurityContextHolder(Spring Security のListeningSecurityContextHolderStrategyを通して) と、OAuth2LoginServiceとAuthenticationManagerの認証のイベントを聞きます。別のユーザーとして実行される作業 (runWithContext) は数えられず、匿名のユーザーは誰もいないとみなされます。context.principalは、任意のウィジェットのbuildの中でそれを読み、それが変わるとウィジェットを再ビルドします。PrincipalBuilder(builder:)は、現在の認証で組み立てます。誰もログインしていなければnullです。PrincipalViewは、一致するプリンシパルにはchildを、そうでなければotherwise(デフォルトは何もなし) を表示します。
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 です。