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 を加えてください。このパッケージを取り込み、各リクエストのユーザーをログインさせるフィルターチェーンを追加します。
- Flutter アプリや HTTP を使わないプログラムでは、このパッケージだけで足ります。
セットアップ
# 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。
例
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(),
]);
}
// Flutter アプリがユーザーをログインさせ、結果を保持する。
final result = await authenticationManager.authenticate(
UsernamePasswordAuthenticationToken.unauthenticated(name, password),
);
SecurityContextHolder.setContext(SecurityContextImpl(result));
await orderService.cancel(order); // ログイン中のユーザーでチェックされる
起動するもの
- メソッドセキュリティは常に有効です。
@EnableMethodSecurityはありません。依存関係だけで十分なので、アノテーションが黙って無視されることはありません。そうしたアノテーションを持ちながらプロキシ化できない Bean は、チェックなしで動く代わりに起動を失敗させます。 - 式は起動時に解析されます。 タイプミスはメソッドを開放する代わりにアプリケーションを止めます。
AuthenticationManagerは、UserDetailsServiceBean (PasswordEncoderBean、またはデリゲーティングエンコーダーを使うDaoAuthenticationProvider) から、またはAuthenticationProviderBean から組み立てられます。- パスワードのチェックには上限があります: 同時にハッシュ化するのはプロセッサー数の半分までで、Dart VM では別の isolate で行われます。
内容
- メソッドセキュリティ:
@PreAuthorize、@PostAuthorize、@Secured、@PreFilter、@PostFilter、式、ロール階層。 - セキュリティコンテキスト:
SecurityContextHolder、ゾーン、ユーザーとしての実行、ログインの受信。 - 認証: ユーザー、
UserDetailsService、AuthenticationManager、イベント。 - パスワードエンコーダー: Argon2、PBKDF2、scrypt、デリゲーティングエンコーダーとハッシュのアップグレード。
- LoginSession と共有インターフェース: プロバイダーが何であってもクライアントアプリケーションのログイン、
SecretStore、AuthorizationWindow、OAuth2Token。 - テスト:
withMockUser、withAuthentication、withAnonymousUser。 - すべてのプロパティ: パスワードチェックの二つの上限。
- Spring との違い: Spring Security と動作が異なる点。
Spring (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 との違い にあります。