Ứng dụng React, Vue, di động gọi API thường xác thực bằng token thay cho phiên đăng nhập. Bài này cấu hình Spring Boot làm OAuth2 Resource Server kiểm tra JWT và tạo endpoint đăng nhập cấp token.

60 phútNâng cao
Bạn sẽ học được
  • Phiên đăng nhập và token
  • Cấp JWT khi đăng nhập
  • Resource Server kiểm tra JWT
  • Tắt CSRF, phiên cho API không trạng thái

Cơ sở lý thuyết

Xác thực không trạng thái (stateless) bằng token phù hợp với SPA, ứng dụng di động và kiến trúc microservice (nhiều dịch vụ cùng kiểm tra một token mà không chia sẻ phiên).

  • OAuth 2.0 là khung ủy quyền (RFC 6749) với các vai trò: chủ sở hữu tài nguyên (người dùng), máy khách (ứng dụng), máy chủ ủy quyền (cấp token), máy chủ tài nguyên (API kiểm tra token).
  • OpenID Connect xây trên OAuth 2.0 để xác thực (đăng nhập bằng Google, Microsoft).
  • Spring Boot làm Resource Server: kiểm tra chữ ký, hạn dùng, nhà phát hành (iss) của JWT; chuyển các claim thành quyền.
  • Ký đối xứng (HS256, một khóa bí mật dùng chung) đơn giản; ký bất đối xứng (RS256, khóa riêng ký – khóa công khai kiểm tra) an toàn hơn khi nhiều dịch vụ cùng kiểm tra.
  • Trong hệ thống lớn, dùng máy chủ ủy quyền chuyên dụng (Keycloak, Spring Authorization Server) thay vì tự cấp token.

Cấu hình

<!-- pom.xml -->
<dependency>
  <groupId>org.springframework.boot</groupId>
  <artifactId>spring-boot-starter-oauth2-resource-server</artifactId>
</dependency>
@Bean
SecurityFilterChain api(HttpSecurity http) throws Exception {
    return http.securityMatcher("/api/**")
        .csrf(c -> c.disable())
        .sessionManagement(s -> s.sessionCreationPolicy(SessionCreationPolicy.STATELESS))
        .authorizeHttpRequests(a -> a.requestMatchers("/api/dang-nhap").permitAll().anyRequest().authenticated())
        .oauth2ResourceServer(o -> o.jwt(Customizer.withDefaults()))
        .build();
}

@PostMapping("/api/dang-nhap")
Map<String, String> dangNhap(@RequestBody DangNhapDto dto) {
    var xt = authManager.authenticate(new UsernamePasswordAuthenticationToken(dto.email(), dto.matKhau()));
    var claims = JwtClaimsSet.builder().subject(xt.getName())
        .expiresAt(Instant.now().plus(8, ChronoUnit.HOURS)).build();
    return Map.of("token", jwtEncoder.encode(JwtEncoderParameters.from(claims)).getTokenValue());
}

Cần khai báo bean JwtEncoder, JwtDecoder với khóa bí mật hoặc cặp khóa RSA; khóa đặt trong biến môi trường.

Ứng dụng thực tế

Bài toán: trường dùng tài khoản Microsoft 365 cho cán bộ, sinh viên. Thay vì tự quản lý mật khẩu, API của hệ thống quản lý học tập chấp nhận token do Microsoft Entra ID cấp – đăng nhập một lần (SSO):

# application.properties
spring.security.oauth2.resourceserver.jwt.issuer-uri=https://login.microsoftonline.com/<tenant-id>/v2.0
spring.security.oauth2.resourceserver.jwt.audiences=api://lms-tay-bac
@GetMapping("/api/toi")
Map<String, Object> toi(@AuthenticationPrincipal Jwt jwt) {
    return Map.of("email", jwt.getClaimAsString("preferred_username"),
                  "ten", jwt.getClaimAsString("name"));
}

Spring tự tải khóa công khai của nhà phát hành để kiểm tra chữ ký; ứng dụng không bao giờ thấy mật khẩu người dùng.

Thực hành
  1. Thêm endpoint đăng nhập trả JWT.
  2. Gọi API có header Authorization: Bearer.
  3. Kết nối ứng dụng React gọi API có token.
Tóm tắt bài học
  • API không trạng thái dùng token.
  • Resource Server tự kiểm tra JWT.
  • Không để lộ khóa ký token.