
# ガードされた画面

このパッケージを使うと、[spring_boot_starter_flutter_navigation](../spring-boot-starter-flutter-navigation/index.md) (このパッケージが持ち込むもの) の画面に付けた `@PreAuthorize` が、メソッドセキュリティの式を受け取ります。ログインしていない人は `spring.flutter.navigation.login` へ行き、ログインがどのように行われても、ログイン後にその画面へ戻ります。権限のないログイン中のユーザーは、エラー画面を受け取ります。

## 使う理由

ユーザーがどの画面を開けるかは、ナビゲーションがどこから来ても (タップ、ブラウザーのアドレスバー、ディープリンク)、一つのルールです。`routeSecurity` Bean は、アプリケーションの `MethodSecurityExpressionHandler` で、すべてのナビゲーションについてそれをチェックするので、ロールの階層と独自の式が Bean と同じように適用されます。

## 例

```dart
@ScreenRoute('/admin', title: 'Admin')
@PreAuthorize("hasRole('ADMIN')")
class AdminPage extends StatelessWidget { ... }

@ScreenRoute('/login', title: 'Log in')
class LoginPage extends StatelessWidget {
  const LoginPage({super.key});

  // ログイン後、ナビゲーションは自動でガードされた画面に戻る。
  @override
  Widget build(BuildContext context) => const LoginForm();
}
```

```yaml
spring:
  flutter:
    navigation:
      login: /login
```

## ルール

- ログインしていない人は `spring.flutter.navigation.login` へ行き、次のログイン (フォーム、プロバイダーのボタン、`restore()`) の後、求められたアドレスに戻ります。
- `login` がなければ、そのようなナビゲーションはエラー画面を表示します。
- 権限のないログイン中のユーザーはエラー画面を受け取ります。
- ログアウトの後、一番上の画面はガードを通して再び開かれます。
- Dart の設定では: `nest` のルートに `.filter(RouteSecurity.preAuthorize("hasRole('ADMIN')"))`。
- ガードは `routeSecurity` Bean (`RouteAuthorizationFilter`) です。それがない場合 (ナビゲーションのスターターだけの場合)、ガードされたルートは、ルートを誰にでも開く代わりに、起動を止めます。

ガードはデバイス上で画面を隠すだけです。サーバーは引き続きすべてのリクエストをチェックします。

## 関連項目

- [フィルター、ガード、エラー](../spring-boot-starter-flutter-navigation/filters-and-guards.md)
- [ユーザーに従うウィジェット](principal-widgets.md)
- [spring_security_core](../spring-security-core/index.md)
