
# Spring との違い

`spring_security_core` は Spring Security に従います。同じ型、アノテーション、式、ログインの保証です。このページでは、そうでない箇所とその理由を挙げます。

## 使う理由

Spring アプリケーションを移植するときは、どこで動作が期待と異なるかを知っておく必要があります。違いは、Dart (スレッドなし、リフレクションなし)、暗号を決して手書きしないというプロジェクトのルール、そしていくつかのより安全なデフォルトから来ています。

## 例

```dart
@Service()
class OrderService {
  @PreAuthorize("hasRole('ADMIN')")
  Future<void> cancel(Order order) async {}
}
// @EnableMethodSecurity は不要: 依存関係だけで十分。
```

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

## 違い

| Spring Security | ここ | 理由 |
|---|---|---|
| `@EnableMethodSecurity` でメソッドセキュリティを有効にする | 常に有効 | アノテーションが黙って無視されることがない。 |
| プロキシ化できないアノテーション付きの Bean はチェックなしで動く | 起動を失敗させる | 誤ってメソッドを開放しない。 |
| 式は最初の呼び出しで解析される | 起動時に解析される | タイプミスがアプリケーションを止める。 |
| 式の中の Bean (`@shop.isOpen()`) はリフレクションで扱われる | Bean のクラスに `@Introspected` が必要 | 実行時のリフレクションがない。 |
| コンテキストはスレッドごとに保持される | `Zone` ごと | Dart はスレッドが一つ。リクエストは `await` をまたいでユーザーを保つ。 |
| BCrypt がデフォルト (`{bcrypt}`) | 使えない。新しいハッシュは `{argon2}` | 検証済みの Dart 実装がなく、暗号を手書きしない。`{bcrypt}` ハッシュはその旨のエラーで失敗する。 |
| `{pbkdf2}` は v5_5 の設定で読まれる (Spring 6 以降) | v5_8 の設定で読まれる | `{pbkdf2}` として保存された Java のハッシュは検証できないことがある。`{pbkdf2@SpringSecurity_v5_8}` のものは検証できる。 |
| パスワードのチェックはコンテナのスレッドで制限される | `spring.security.password-checks.*`、別の isolate で | ログインの大量送信が使う CPU は最大でも半分。 |
| Spring Security 7 はパスワードログインに `FACTOR_PASSWORD` を追加する | まだない | 多要素認証はここにはない。 |

Argon2、PBKDF2、scrypt のハッシュは、Spring Security 7.1 と双方向で検証できます。

## まだサポートされていないもの

- JSR-250 (`@RolesAllowed`、`@PermitAll`、`@DenyAll`)。
- パラメーター付きのアノテーションテンプレート (`{value}` を使う `@HasRole("ADMIN")`)。`PreAuthorize` を継承する `const` クラスは、固定の合成アノテーションとして動きます。
- `@AuthorizeReturnObject` と `@HandleAuthorizationDenied`。
- 認可イベント (`AuthorizationDeniedEvent`): 発行されるのは認証イベントだけです。
- ACL テーブルと `AclService`: `hasPermission` には独自の `PermissionEvaluator` が必要です。
- `JdbcUserDetailsManager` と LDAP: 独自の `UserDetailsService` を宣言してください。
- 漏洩したパスワードのチェック (`CompromisedPasswordChecker`)。
- 多要素認証と `Authentication.Builder`。

## 関連項目

- [概要](index.md)
- [メソッドセキュリティ](method-security.md)
- [パスワードエンコーダー](password-encoders.md)
