
# spring_security_core

`spring_security_core` は、HTTP に依存しないセキュリティの部分です。誰がログインしているか、ユーザーとそのパスワードハッシュ、ログインのチェック、そして Bean のメソッドのアクセスルール (`@PreAuthorize`、`@PostAuthorize`、`@Secured`、`@PreFilter`、`@PostFilter`) を扱います。Spring Security のコアとメソッドセキュリティの Dart への移植です。

## 使う理由

アプリケーションは、呼び出しがどこから来たか (Web リクエスト、スケジュールされたジョブ、Flutter アプリのボタン) にかかわらず、ユーザーを知り、そのユーザーに何が許されるかをチェックしなければなりません。このパッケージを使えば、ルールはコード中に散らばる `if` のチェックではなく、保護するメソッドの上にそれぞれ一行で置かれます。パスワードは Spring Security の形式で、遅いソルト付きのハッシュとして保存されるため、Dart のサービスと Java のサービスでユーザーテーブルを共有できます。

- **サーバーでは**、代わりに [spring_boot_starter_security](../spring-boot-starter-security/index.md) を加えてください。このパッケージを取り込み、各リクエストのユーザーをログインさせるフィルターチェーンを追加します。
- **Flutter アプリ**や HTTP を使わないプログラムでは、このパッケージだけで足ります。

## セットアップ

```yaml
# pubspec.yaml
dependencies:
  spring_security_core: ^0.9.0

dev_dependencies:
  build_runner: ^2.17.0
  spring_core_dart_generator: ^0.9.0   # メソッドセキュリティに必要なプロキシを書き出す
```

`spring_boot_dart` とロギングのスターターを取り込んで再エクスポートするため、アプリケーションはこれ (またはセキュリティスターター) だけを加えれば済みます。インポートは一つで足ります: `package:spring_security_core/spring_security_core.dart`。

## 例

```dart
import 'package:spring_security_core/spring_security_core.dart';

@Service()
class OrderService {
  OrderService(this.orders);

  final OrderRepository orders;

  // 管理者はどの注文もキャンセルでき、他のユーザーは自分のものだけ。
  @PreAuthorize("hasRole('ADMIN') or #order.owner == principal.username")
  Future<void> cancel(Order order) => orders.delete(order);

  // 各ユーザーはリストから自分の注文だけを受け取る。
  @PostFilter('filterObject.owner == authentication.name')
  Future<List<Order>> all() => orders.findAll();
}

@Configuration()
class Users {
  // ユーザーとそのハッシュ化されたパスワード。
  @Bean()
  UserDetailsService users() => InMemoryUserDetailsManager([
        User.withUsername('ada').password('{argon2}\$argon2id\$v=19\$...').roles(['ADMIN']).build(),
        User.withUsername('bob').password('{argon2}\$argon2id\$v=19\$...').roles(['USER']).build(),
      ]);
}
```

```dart
// Flutter アプリがユーザーをログインさせ、結果を保持する。
final result = await authenticationManager.authenticate(
  UsernamePasswordAuthenticationToken.unauthenticated(name, password),
);
SecurityContextHolder.setContext(SecurityContextImpl(result));

await orderService.cancel(order); // ログイン中のユーザーでチェックされる
```

## 起動するもの

- **メソッドセキュリティは常に有効です。** `@EnableMethodSecurity` はありません。依存関係だけで十分なので、アノテーションが黙って無視されることはありません。そうしたアノテーションを持ちながらプロキシ化できない Bean は、チェックなしで動く代わりに起動を失敗させます。
- **式は起動時に解析されます。** タイプミスはメソッドを開放する代わりにアプリケーションを止めます。
- **`AuthenticationManager`** は、`UserDetailsService` Bean (`PasswordEncoder` Bean、またはデリゲーティングエンコーダーを使う `DaoAuthenticationProvider`) から、または `AuthenticationProvider` Bean から組み立てられます。
- **パスワードのチェックには上限があります:** 同時にハッシュ化するのはプロセッサー数の半分までで、Dart VM では別の isolate で行われます。

## 内容

- [メソッドセキュリティ](method-security.md): `@PreAuthorize`、`@PostAuthorize`、`@Secured`、`@PreFilter`、`@PostFilter`、式、ロール階層。
- [セキュリティコンテキスト](security-context.md): `SecurityContextHolder`、ゾーン、ユーザーとしての実行、ログインの受信。
- [認証](authentication.md): ユーザー、`UserDetailsService`、`AuthenticationManager`、イベント。
- [パスワードエンコーダー](password-encoders.md): Argon2、PBKDF2、scrypt、デリゲーティングエンコーダーとハッシュのアップグレード。
- [LoginSession と共有インターフェース](login-session.md): プロバイダーが何であってもクライアントアプリケーションのログイン、`SecretStore`、`AuthorizationWindow`、`OAuth2Token`。
- [テスト](testing.md): `withMockUser`、`withAuthentication`、`withAnonymousUser`。
- [すべてのプロパティ](properties.md): パスワードチェックの二つの上限。
- [Spring との違い](differences.md): Spring Security と動作が異なる点。

## Spring (Java) との対応

```java
@EnableMethodSecurity
@Configuration
class SecurityConfig {}

@Service
class OrderService {
  @PreAuthorize("hasRole('ADMIN') or #order.owner == principal.username")
  public void cancel(Order order) { ... }
}
```

重要な違い:

- `@EnableMethodSecurity` はありません。メソッドセキュリティは常に有効です。
- セキュリティコンテキストはスレッドごとではなく `Zone` ごとに保持されます。
- BCrypt はありません。新しいハッシュは `{argon2}` で、Spring もこれをチェックできます。
- すべての違いは [Spring との違い](differences.md) にあります。

## 関連項目

- [spring_boot_starter_security](../spring-boot-starter-security/index.md)
- [spring_boot_starter_supabase](../spring-boot-starter-supabase/index.md)
- [SpEL](../spring-core-dart/spel/index.md)
- [AOP プロキシ](../spring-core-dart/aop/proxies.md)
