0Pricing
API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway) · Lekcja

Uwierzytelnianie i autoryzacja JWT

Zaimplementują Państwo uwierzytelnianie i autoryzację opartą na JWT w Spring Cloud Gateway, aby zabezpieczyć dostęp do API.

Uwierzytelnianie i autoryzacja JWT to bezpłatna lekcja API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway) na CoddyKit. To lekcja 1 z 4. Możesz przeczytać całą lekcję poniżej za darmo — a potem ćwiczyć ją interaktywnie w przeglądarce z wbudowanym edytorem kodu i tutorem AI dostępnym 24/7. To część ścieżki edukacyjnej API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway), a Twój postęp synchronizuje się między webem a aplikacją CoddyKit. Kurs API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway) zawiera 4 lekcji w sumie.

Części tej lekcji nie zostały jeszcze przetłumaczone i są wyświetlane po angielsku.

Securing Your API Gateway

In a microservices architecture, securing your APIs is paramount. Spring Cloud Gateway acts as a central entry point, making it the perfect place to enforce security policies.

This lesson focuses on using JSON Web Tokens (JWTs) for both authentication (who is this user?) and authorization (what can this user do?) directly within your Gateway.

Introducing JSON Web Tokens (JWTs)

A JSON Web Token (JWT) is a compact, URL-safe means of representing claims to be transferred between two parties. It's often used for authentication and information exchange.

  • Stateless: The server doesn't need to store session information.
  • Self-contained: Contains all the necessary user information and claims.
  • Scalable: Easy to use across multiple services without complex session management.

JWT Structure: Header, Payload, Signature

A JWT consists of three parts, separated by dots (.), which are Base64Url-encoded:

  • Header: Specifies the token type (JWT) and the signing algorithm (e.g., HMAC SHA256).
  • Payload: Contains the claims (statements about an entity, like a user ID or roles).
  • Signature: Used to verify the token's authenticity and ensure it hasn't been tampered with. It's created using the header, payload, and a secret key.

AuthN vs. AuthZ in the Gateway

It's crucial to distinguish between Authentication (AuthN) and Authorization (AuthZ):

  • Authentication: Verifying the identity of a user or service (e.g., validating a JWT's signature and expiration).
  • Authorization: Determining if an authenticated user or service has permission to perform a specific action or access a particular resource (e.g., checking user roles from JWT claims).

The Gateway can handle both, ensuring only valid and authorized requests reach your backend services.

Setting Up Gateway for JWT Security

To integrate JWT security, your Spring Cloud Gateway project typically needs the spring-cloud-starter-gateway and spring-boot-starter-security dependencies.

While spring-boot-starter-security provides a robust security framework, we'll focus on manually handling JWT validation using Gateway filters to illustrate the core concepts.

JWT Validation Flow in Gateway

When a client sends a request with a JWT, the Gateway intercepts it. The typical flow is:

  1. Extract Token: Get the JWT from the Authorization header.
  2. Validate Token: Verify its signature, check expiration, and ensure it's well-formed.
  3. Extract Claims: Parse the token to get user details and roles.
  4. Authorize Request: Based on claims, decide if the request can proceed to the backend service.

Implementing a Custom JWT Filter

We can implement JWT validation using a custom GlobalFilter in Spring Cloud Gateway. This filter will run for all incoming requests before they are routed.

Inside the filter, you'll access the request headers, extract the JWT, and perform your validation logic. If the token is invalid, you can reject the request directly from the Gateway.

Example: Simple JWT Filter

This example demonstrates a basic Spring Cloud Gateway application with a GlobalFilter. It logs the presence of an Authorization: Bearer header, simulating the first step of JWT validation. Run it and try accessing /test with an Authorization header!

package com.example.gateway;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.cloud.gateway.route.RouteLocator;
import org.springframework.cloud.gateway.route.builder.RouteLocatorBuilder;
import org.springframework.context.annotation.Bean;
import org.springframework.cloud.gateway.filter.GlobalFilter;
import org.springframework.http.HttpHeaders;
import reactor.core.publisher.Mono;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

@SpringBootApplication
public class GatewayApplication {

    public static void main(String[] args) {
        SpringApplication.run(GatewayApplication.class, args);
        System.out.println("Gateway started! Try accessing /test with 'Authorization' header.");
    }

    // Configures a dummy route for the filter to act on
    @Bean
    public RouteLocator customRouteLocator(RouteLocatorBuilder builder) {
        return builder.routes()
            .route("test_route", r -> r.path("/test")
                .uri("http://httpbin.org:80/get")) // A public echo service
            .build();
    }

    // Our simplified JWT validation filter
    @Bean
    public GlobalFilter jwtValidationFilter() {
        Logger logger = LoggerFactory.getLogger(GatewayApplication.class);
        return (exchange, chain) -> {
            HttpHeaders headers = exchange.getRequest().getHeaders();
            String authHeader = headers.getFirst(HttpHeaders.AUTHORIZATION);

            logger.info("Intercepted request to: {}", exchange.getRequest().getURI());

            if (authHeader != null && authHeader.startsWith("Bearer ")) {
                String jwt = authHeader.substring(7);
                logger.info("Found JWT in header: {}", jwt);
                // In a real scenario, full JWT validation happens here.
                // For this example, we just log it and proceed.
            } else {
                logger.warn("No 'Authorization: Bearer' header found.");
            }
            return chain.filter(exchange); // Continue to the next filter/route
        };
    }
}

Securing Routes with Authorization

Once a JWT is validated and its claims (like user roles or scopes) are extracted, you can use these claims for authorization. Spring Cloud Gateway allows you to define authorization rules directly on your routes.

For instance, you could configure a route to only permit requests if the authenticated user has an 'ADMIN' role specified in their JWT payload.

Quick Check: JWT Authorization

After a JWT is validated by the Gateway, which of the following are key benefits of using JWTs for API authentication and authorization in a stateless microservice architecture?

Recap: Secure Gateway with JWTs

You've learned how Spring Cloud Gateway serves as a critical enforcement point for API security. We covered the basics of JWTs—their structure, benefits, and how they enable stateless authentication and authorization.

By implementing custom filters, you can integrate robust JWT validation and leverage claims to secure access to your microservices, ensuring only authorized requests reach your backend.

Często zadawane pytania

Czy lekcja „Uwierzytelnianie i autoryzacja JWT” jest bezpłatna?

Tak — pełny tekst „Uwierzytelnianie i autoryzacja JWT” jest dostępny za darmo tutaj w sieci. Aby ćwiczyć ją interaktywnie (wbudowany edytor kodu i tutor AI dostępny 24/7) i odblokować resztę kursu API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway), przejdź na CoddyKit PRO. Kurs API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway) zawiera 4 lekcji w sumie.

Co nauczysz się w „Uwierzytelnianie i autoryzacja JWT”?

Zaimplementują Państwo uwierzytelnianie i autoryzację opartą na JWT w Spring Cloud Gateway, aby zabezpieczyć dostęp do API. Ćwiczysz API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway) z praktycznym kodem, który uruchamiasz bezpośrednio w przeglądarce, a tutor AI dostępny 24/7 odpowiada na Twoje pytania podczas pracy nad lekcją.

Czy potrzebuję doświadczenia, aby zacząć API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway)?

Nie wymagamy żadnego doświadczenia. API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway) w CoddyKit jest strukturyzowany dla początkujących i zaawansowanych użytkowników, więc możesz zacząć tutaj lub od początku i uczyć się w swoim tempie. To lekcja 1 z 4.

Ile czasu zajmuje lekcja „Uwierzytelnianie i autoryzacja JWT”?

Większość lekcji CoddyKit trwa około 5–10 minut. Każda lekcja to mały, interaktywny krok, dzięki czemu robisz systematyczne postępy i zawsze wracasz dokładnie do tego samego miejsca — na webie i w aplikacji.

Czy mogę pisać i uruchamiać kod w tej lekcji API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway)?

Tak. Każda lekcja API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway) zawiera wbudowany edytor kodu, więc piszesz i uruchamiasz prawdziwy kod bezpośrednio w przeglądarce i od razu otrzymujesz sprzężenie zwrotne od AI — bez konfiguracji na komputerze.

Wszystkie lekcje w tym kursie

  1. Uwierzytelnianie i autoryzacja JWT
  2. Śledzenie rozproszone za pomocą Sleuth i Zipkin
  3. Scentralizowana konfiguracja za pomocą Config Server
  4. Udostępnianie metryk za pomocą Actuator i Prometheus
← Powrót do API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway)