springboot-security

Spring Boot セキュリティレビュー

認証の追加、入力の処理、エンドポイントの作成、またはシークレットの取り扱いを行う際に使用します。

アクティブ化のタイミング

• 認証の追加（JWT、OAuth2、セッションベース）
• 認可の実装（@PreAuthorize、ロールベースアクセス）
• ユーザー入力の検証（Bean Validation、カスタムバリデータ）
• CORS、CSRF、またはセキュリティヘッダーの設定
• シークレットの管理（Vault、環境変数）
• レート制限またはブルートフォース対策の追加
• 依存関係のCVEスキャン

認証

• ステートレスなJWTまたは失効リスト付きの不透明トークンを優先する
• セッションにはhttpOnly、Secure、SameSite=Strictクッキーを使用する
• OncePerRequestFilterまたはリソースサーバーでトークンを検証する

@Component
public class JwtAuthFilter extends OncePerRequestFilter {
  private final JwtService jwtService;

  public JwtAuthFilter(JwtService jwtService) {
    this.jwtService = jwtService;
  }

  @Override
  protected void doFilterInternal(HttpServletRequest request, HttpServletResponse response,
      FilterChain chain) throws ServletException, IOException {
    String header = request.getHeader(HttpHeaders.AUTHORIZATION);
    if (header != null && header.startsWith("Bearer ")) {
      String token = header.substring(7);
      Authentication auth = jwtService.authenticate(token);
      SecurityContextHolder.getContext().setAuthentication(auth);
    }
    chain.doFilter(request, response);
  }
}

認可

• メソッドセキュリティを有効にする：@EnableMethodSecurity
• @PreAuthorize("hasRole('ADMIN')") または @PreAuthorize("@authz.canEdit(#id)") を使用する
• デフォルトで拒否し、必要なスコープのみを公開する

@RestController
@RequestMapping("/api/admin")
public class AdminController {

  @PreAuthorize("hasRole('ADMIN')")
  @GetMapping("/users")
  public List<UserDto> listUsers() {
    return userService.findAll();
  }

  @PreAuthorize("@authz.isOwner(#id, authentication)")
  @DeleteMapping("/users/{id}")
  public ResponseEntity<Void> deleteUser(@PathVariable Long id) {
    userService.delete(id);
    return ResponseEntity.noContent().build();
  }
}

入力検証

• コントローラーで@Validアノテーションを使用してBean Validationを適用する
• DTOに制約を付与する：@NotBlank、@Email、@Size、カスタムバリデータ
• HTMLをレンダリングする前に、許可リストを使用してサニタイズする

// 悪い例：検証なし
@PostMapping("/users")
public User createUser(@RequestBody UserDto dto) {
  return userService.create(dto);
}

// 良い例：検証済みDTO
public record CreateUserDto(
    @NotBlank @Size(max = 100) String name,
    @NotBlank @Email String email,
    @NotNull @Min(0) @Max(150) Integer age
) {}

@PostMapping("/users")
public ResponseEntity<UserDto> createUser(@Valid @RequestBody CreateUserDto dto) {
  return ResponseEntity.status(HttpStatus.CREATED)
      .body(userService.create(dto));
}

SQLインジェクション対策

• Spring Dataリポジトリまたはパラメータ化クエリを使用する
• ネイティブクエリでは:paramバインディングを使用し、文字列連結は決して行わない

// 悪い例：ネイティブクエリでの文字列連結
@Query(value = "SELECT * FROM users WHERE name = '" + name + "'", nativeQuery = true)

// 良い例：パラメータ化されたネイティブクエリ
@Query(value = "SELECT * FROM users WHERE name = :name", nativeQuery = true)
List<User> findByName(@Param("name") String name);

// 良い例：Spring Data派生クエリ（自動パラメータ化）
List<User> findByEmailAndActiveTrue(String email);

パスワードエンコーディング

• パスワードは常にBCryptまたはArgon2でハッシュ化する — 平文で保存しない
• 手動ハッシュ化ではなく、PasswordEncoder Beanを使用する

@Bean
public PasswordEncoder passwordEncoder() {
  return new BCryptPasswordEncoder(12); // コスト係数12
}

// サービス内
public User register(CreateUserDto dto) {
  String hashedPassword = passwordEncoder.encode(dto.password());
  return userRepository.save(new User(dto.email(), hashedPassword));
}

CSRF保護

• ブラウザセッションアプリではCSRFを有効にし、フォーム/ヘッダーにトークンを含める
• Bearerトークンを使用する純粋なAPIではCSRFを無効にし、ステートレス認証に依存する

http
  .csrf(csrf -> csrf.disable())
  .sessionManagement(sm -> sm.sessionCreationPolicy(SessionCreationPolicy.STATELESS));

シークレット管理

• ソースコード内にシークレットを置かない；環境変数またはVaultから読み込む
• application.ymlに資格情報をハードコードせず、プレースホルダーを使用する
• トークンとDB資格情報を定期的にローテーションする

# 悪い例：application.ymlにハードコード
spring:
  datasource:
    password: mySecretPassword123

# 良い例：環境変数のプレースホルダー
spring:
  datasource:
    password: ${DB_PASSWORD}

# 良い例：Spring Cloud Vaultとの統合
spring:
  cloud:
    vault:
      uri: https://vault.example.com
      token: ${VAULT_TOKEN}

セキュリティヘッダー

http
  .headers(headers -> headers
    .contentSecurityPolicy(csp -> csp
      .policyDirectives("default-src 'self'"))
    .frameOptions(HeadersConfigurer.FrameOptionsConfig::sameOrigin)
    .xssProtection(Customizer.withDefaults())
    .referrerPolicy(rp -> rp.policy(ReferrerPolicyHeaderWriter.ReferrerPolicy.NO_REFERRER)));

CORS設定

• CORSはコントローラーレベルではなく、セキュリティフィルターレベルで設定する
• 許可するオリジンを制限する — 本番環境では決して*を使用しない

@Bean
public CorsConfigurationSource corsConfigurationSource() {
  CorsConfiguration config = new CorsConfiguration();
  config.setAllowedOrigins(List.of("https://app.example.com"));
  config.setAllowedMethods(List.of("GET", "POST", "PUT", "DELETE"));
  config.setAllowedHeaders(List.of("Authorization", "Content-Type"));
  config.setAllowCredentials(true);
  config.setMaxAge(3600L);

  UrlBasedCorsConfigurationSource source = new UrlBasedCorsConfigurationSource();
  source.registerCorsConfiguration("/api/**", config);
  return source;
}

// SecurityFilterChain内：
http.cors(cors -> cors.configurationSource(corsConfigurationSource()));

レート制限

• 高負荷なエンドポイントにはBucket4jまたはゲートウェイレベルの制限を適用する
• バーストをログ記録してアラートを送信し、リトライヒントとともに429を返す

// Bucket4jを使用したエンドポイントごとのレート制限
@Component
public class RateLimitFilter extends OncePerRequestFilter {
  private final Map<String, Bucket> buckets = new ConcurrentHashMap<>();

  private Bucket createBucket() {
    return Bucket.builder()
        .addLimit(Bandwidth.classic(100, Refill.intervally(100, Duration.ofMinutes(1))))
        .build();
  }

  @Override
  protected void doFilterInternal(HttpServletRequest request, HttpServletResponse response,
      FilterChain chain) throws ServletException, IOException {
    String clientIp = request.getRemoteAddr();
    Bucket bucket = buckets.computeIfAbsent(clientIp, k -> createBucket());

    if (bucket.tryConsume(1)) {
      chain.doFilter(request, response);
    } else {
      response.setStatus(HttpStatus.TOO_MANY_REQUESTS.value());
      response.getWriter().write("{\"error\": \"Rate limit exceeded\"}");
    }
  }
}

依存関係のセキュリティ

• CIでOWASP Dependency Check / Snykを実行する
• Spring BootとSpring Securityをサポート対象バージョンに保つ
• 既知のCVEがある場合はビルドを失敗させる

ロギングとPII

• シークレット、トークン、パスワード、完全なPANデータをログに記録しない
• 機密フィールドを難読化し、構造化JSONロギングを使用する

ファイルアップロード

• サイズ、コンテンツタイプ、拡張子を検証する
• Webルートの外部に保存し、必要に応じてスキャンする

リリース前のチェックリスト

• 認証トークンが正しく検証され、期限切れになっている
• すべての機密パスに認可ガードが設定されている
• すべての入力が検証され、サニタイズされている
• 文字列連結によるSQLがない
• CSRFの姿勢がアプリのタイプに適切である
• シークレットが外部化され、コミットされていない
• セキュリティヘッダーが設定されている
• APIにレート制限が設定されている
• 依存関係がスキャンされ、最新である
• ログに機密データが含まれていない

覚えておいてください：デフォルトで拒否、入力検証、最小権限、そして何よりも設定によるセキュリティを実現すること。