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.
| Funktion | Beschreibung |
|---|---|
| Konfiguration laden | CCA9 und CCA-Online lesen ihre Settings |
| Konfiguration ändern | Applikationen können Settings zurückschreiben |
| Support-Zugriff | TOGETHER-Mitarbeiter können Konfigurationen auslesen/anpassen |
| Zentrales Rollout | Neue verpflichtende Settings werden zentral ausgerollt |
Komponenten​
| Komponente | Technologie | Aufgabe |
|---|---|---|
| Client Library | .NET (CCA.Extensions.Configuration.ConfigServer) | Lädt/schreibt Konfiguration, Fallback-Cache, Property-Entschlüsselung |
| Gateway (Proxy) | ASP.NET Core, Azure App Service | Authentifizierung, Client-Isolation (Zugriff nur auf eigene Config), Write-Operationen |
| Spring Cloud Config Server | Java/Spring Cloud, Docker Container auf VM | Read-Only Config-API, Git als Backend |
| Git Backend | Azure DevOps Git Repository | Konfigurationsdateien pro Mandant, vollständige Aenderungshistorie |
Authentifizierung​
OAuth2 Client Credentials Flow ĂĽber den TOGETHER Identity Server:
| Aspekt | Details |
|---|---|
| Flow | Client Credentials (RFC 6749 Section 4.4) |
| Identity Provider | TOGETHER Identity Server |
| Client-Registrierung | Jede CCA-DB ist ein eigener Client (dbo.TogetherEnvironment.tenClientID) |
| JWT Assertion | Signiert 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:
- Erfolgreicher Request → Response wird verschlüsselt als lokaler Cache gespeichert (
FallbackFilePath) - Fehler + Cache vorhanden → Verschlüsselter Cache wird verwendet
- Fehler + kein Cache → Fehler wird propagiert
VerschlĂĽsselung: JWE (JSON Web Encryption) ĂĽber JWEDataProtector.
Azure Resources​
| Resource | Name | Typ |
|---|---|---|
| Gateway/Proxy | TIS-PROD-CCAConfigServer-WE-APP | Azure App Service |
| Spring Cloud Config | TIS-PROD-CCAConfigServer-WE-VM01 | VM mit Docker Container |
| Healthcheck | https://config.cca.online/health |
Zugang zur VM: Bastion/SSH ĂĽber Secret-Server (togethercca@TIS-PROD-CCAConfigServer-WE-VM01).
API​
| Methode | Pfad | Beschreibung |
|---|---|---|
| GET | /{appName}/{clientId} | Gesamte Konfiguration laden |
| GET | /{appName}/{clientId}/{section} | Einzelne Section laden |
Default appName: cca
Produktions-URL: https://config.cca.online/
Related Documentation​
| Dokument | Inhalt |
|---|---|
cca.extensions/doc/configuration/CONFIGSERVER.md | Client Library: Setup, Options, Troubleshooting |
cca.extensions/doc/configuration/CONFIGURATION-FLOW.md | Wie CCA-Apps ihre Konfiguration zusammenbauen |
CCA.Extensions.Configuration.ConfigServer.Gateway | Gateway Implementierung (Azure DevOps) |
| Spring Cloud Config Server | Upstream-Dokumentation |