Zum Hauptinhalt springen

ConfigServer Architecture

🤖 Generated with Claude Code

⚠️ Not yet reviewed

Co-Authored-By: Claude (noreply@anthropic.com)

Sources (from cca.wiki):

  • Home/Config-Server.md → Zusammenfassung, Technologie, Azure Resources

Overview​

Der ConfigServer ist ein zentral gehosteter Dienst, der Konfigurationen pro CCA-Datenbank (Mandant) verwaltet.

FunktionBeschreibung
Konfiguration ladenCCA9 und CCA-Online lesen ihre Settings
Konfiguration ändernApplikationen können Settings zurückschreiben
Support-ZugriffTOGETHER-Mitarbeiter können Konfigurationen auslesen/anpassen
Zentrales RolloutNeue verpflichtende Settings werden zentral ausgerollt

Komponenten​

Architecture

KomponenteTechnologieAufgabe
Client Library.NET (CCA.Extensions.Configuration.ConfigServer)Lädt/schreibt Konfiguration, Fallback-Cache, Property-Entschlüsselung
Gateway (Proxy)ASP.NET Core, Azure App ServiceAuthentifizierung, Client-Isolation (Zugriff nur auf eigene Config), Write-Operationen
Spring Cloud Config ServerJava/Spring Cloud, Docker Container auf VMRead-Only Config-API, Git als Backend
Git BackendAzure DevOps Git RepositoryKonfigurationsdateien pro Mandant, vollständige Aenderungshistorie

Authentifizierung​

OAuth2 Client Credentials Flow ĂĽber den TOGETHER Identity Server:

AspektDetails
FlowClient Credentials (RFC 6749 Section 4.4)
Identity ProviderTOGETHER Identity Server
Client-RegistrierungJede CCA-DB ist ein eigener Client (dbo.TogetherEnvironment.tenClientID)
JWT AssertionSigniert mit SiteKey (dbo.Version.versSiteKey)
Scope (Read)configurationServer.read
Scope (Write)configurationServer.write

Datenfluss​

CCA9 / CCA-Online
│
│ 1. JWT Assertion (signiert mit SiteKey)
â–Ľ
TOGETHER Identity Server
│
│ 2. Access Token
â–Ľ
CCA-App ──── 3. GET /{app}/{clientId} ────▶ Gateway (Proxy)
│
│ 4. Validiert Token, prüft Client-Isolation
â–Ľ
Spring Cloud Config Server
│
│ 5. Liest aus Git
â–Ľ
Git Repository

Write-Flow: Gleicher Auth-Flow, aber POST/PUT an den Gateway. Der Gateway schreibt direkt ins Git-Repository (Spring Cloud ist read-only).

Fallback​

Bei Nichterreichbarkeit des ConfigServers:

  1. Erfolgreicher Request → Response wird verschlüsselt als lokaler Cache gespeichert (FallbackFilePath)
  2. Fehler + Cache vorhanden → Verschlüsselter Cache wird verwendet
  3. Fehler + kein Cache → Fehler wird propagiert

VerschlĂĽsselung: JWE (JSON Web Encryption) ĂĽber JWEDataProtector.

Azure Resources​

ResourceNameTyp
Gateway/ProxyTIS-PROD-CCAConfigServer-WE-APPAzure App Service
Spring Cloud ConfigTIS-PROD-CCAConfigServer-WE-VM01VM mit Docker Container
Healthcheckhttps://config.cca.online/health

Zugang zur VM: Bastion/SSH ĂĽber Secret-Server (togethercca@TIS-PROD-CCAConfigServer-WE-VM01).

API​

MethodePfadBeschreibung
GET/{appName}/{clientId}Gesamte Konfiguration laden
GET/{appName}/{clientId}/{section}Einzelne Section laden

Default appName: cca

Produktions-URL: https://config.cca.online/

DokumentInhalt
cca.extensions/doc/configuration/CONFIGSERVER.mdClient Library: Setup, Options, Troubleshooting
cca.extensions/doc/configuration/CONFIGURATION-FLOW.mdWie CCA-Apps ihre Konfiguration zusammenbauen
CCA.Extensions.Configuration.ConfigServer.GatewayGateway Implementierung (Azure DevOps)
Spring Cloud Config ServerUpstream-Dokumentation