meldestelle/docs/07_Infrastructure/api-gateway.md
Stefan Mogeritsch 3465cab246 Standardize documentation with headers and archive old files
Applied a unified header format to all documentation files for better status identification, referencing, and ownership tracking. Archived outdated roadmaps, reports, and journal entries. Updated playbooks with new responsibilities, lifecycle rules, and consistent handover formats to align with the new archiving strategy.
2026-01-16 12:17:47 +01:00

1.3 KiB

type status owner last_update
Reference ACTIVE DevOps Engineer 2026-01-15

Infrastruktur: API-Gateway

Dieses Dokument beschreibt die Konfiguration und die Aufgaben des API-Gateways im "Meldestelle"-Projekt.

Zweck

Das API-Gateway (implementiert mit Spring Cloud Gateway) ist der zentrale, nach außen exponierte Einstiegspunkt für alle HTTP-Anfragen an das System.

Seine Hauptaufgaben sind:

  • Routing: Leitet Anfragen an den korrekten Microservice weiter (z.B. /api/ping/** -> ping-service).
  • Security: Erzwingt die Authentifizierung und Autorisierung für alle eingehenden Anfragen. Es validiert die von Keycloak ausgestellten JWTs.
  • Cross-Cutting Concerns: Implementiert übergreifende Funktionalitäten wie Rate Limiting, Logging und Circuit Breaking (mit Resilience4j).

Konfiguration

Die Routen werden in der application.yml des Gateways definiert. Die Konfiguration für die Service Discovery erfolgt über Consul.

spring:
  cloud:
    gateway:
      discovery:
        locator:
          enabled: true
          lower-case-service-id: true
      routes:
        - id: ping-service
          uri: lb://ping-service
          predicates:
            - Path=/api/ping/**
          filters:
            - StripPrefix=2