spring_security_core

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

使う理由

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

セットアップ

# 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); // ログイン中のユーザーでチェックされる

起動するもの

内容

Spring (Java) との対応

@EnableMethodSecurity
@Configuration
class SecurityConfig {}

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

重要な違い:

関連項目