CCA Berechtigungssystem (Uebersicht)
🤖 Generated with OpenCode (OpenAI GPT)
Co-Authored-By: OpenAI (noreply@openai.com)
🤖 Generated with Claude Code
⚠️ Not yet reviewed
Co-Authored-By: Claude (noreply@anthropic.com)
Diese Uebersicht dokumentiert das Berechtigungssystem (AuthZ) ĂĽber folgende Artefakte:
cca.ccaonline(Web App + Token-Ausgabe + WebApi-Security-Profile)cca.ccaonline/src/CCA.CoreDataService(CoreDataService WebApi + Core)CCA.Domainservices(EF6-basierte Berechtigungslogik als Library)CCA9(DB-Schema/Views/Stored Procedures + Desktop-Client;CCA.SystemDB User Rights)
Begriffe (konkret im Code/DB sichtbar)​
CCAUserKey(ApplicationMode + UserId) wird serialisiert und als Claim transportiert.- Evidence:
cca.ccaonline/src/CCAOnline.Core/Identity/ICCAOnlineClaimsIdentityBuilder.cs - Evidence:
cca.ccaonline/src/CCA.CoreDataService/CCA.CoreDataService.WebApi/ApiControllerExtensions.cs
- Evidence:
Rolleist die zentrale Tabelle fĂĽr Mitarbeiter-Rechte (vielerol*Spalten).- Evidence:
CCA9/Database/Source_Db/Table_Create.sql
- Evidence:
BerechtigungSetist eine booleans-basierte Projektion ausRolle(Feature-/Funktionsrechte).- Evidence:
CCA.Domainservices/src/CCA9.DomainServices/Authorization/BerechtigungSet.cs
- Evidence:
BerechtigungSelectist eine materialisierte Sichtbarkeitsmatrix pro Login (brsSUser_SName) und Tabelle (brsTabelleID).- Evidence:
CCA9/Database/Source_Db/Table_Create.sql - Evidence:
CCA9/Database/Source_Db/Procedure/spBerechtigungSelectMitarbeiter.sql - Evidence:
CCA.Domainservices/src/CCA9.Infrastructure.EF6.Impl/Extensions/SecurityFilter.cs
- Evidence:
End-to-End (typischer API-Call nach /coredataservice)​
API Client
|
| POST /coredataservice/api/token (SQLLogin) oder /coredataservice/api/token/NT
v
cca.ccaonline: Token-Ausgabe
- JWT enthält primär Claim `cca:context` (JSON) + optional `client_id`
|
v
cca.ccaonline: JwtBearer + ClaimsTransformation
- erkennt "CoreDataService V1" an AuthenticationType == "JWT"
- baut daraus eine CCAOnlineClaimsIdentity und fĂĽgt `nameid` / NameIdentifier hinzu
|
v
CCA.CoreDataService (WebApi)
- liest `nameid`/NameIdentifier und deserialisiert `CCAUserKey`
- erzwingt Rechte in der Service-Schicht ĂĽber `IEntityActionAuthorization` / `IBerechtigungService`
|
v
CCA.Domainservices (EF6)
- liest `Rolle` / `BerechtigungSelect` und entscheidet (Read/Insert/Update/Delete/Link/...)
|
v
CCA9 DB
- Views joinen `BerechtigungSelect` (Sichtbarkeit + DSGVO-Sperren via `brsDarfGesperrteSehen`)
- (teilweise) Business-SPs rufen `spBerechtigung*Check` fĂĽr Write-Rechte
Ausreisser / Abweichungen (architekturell relevant)​
CoreDataServiceist kein eigenständiges Repo mit Service-Code:cca.coredataserviceist (derzeit) ein leeres Stub-Repo; die Implementierung liegt incca.ccaonline/src/CCA.CoreDataService.- Evidence:
cca.coredataservice/README.md - Evidence:
cca.ccaonline/src/CCA.CoreDataService/
- Evidence:
- Zwei parallele Web-Stacks in
cca.ccaonline(OWIN/Legacy und ASP.NET Core Pipeline) koexistieren.- Evidence:
cca.ccaonline/src/CCAOnline/App_Start/OwinStartUp.cs - Evidence:
cca.ccaonline/ccaonline-dotnet/src/CCAOnline/Program.cs
- Evidence:
- AuthZ findet auf mehreren Ebenen statt:
- API-Level Rollenclaims + Security-Profiles (cca.ccaonline)
- Service-Level
IEntityActionAuthorization/IBerechtigungService(CCA.CoreDataService + CCA.Domainservices) - DB-Level Views +
spBerechtigung*(CCA9)
Bewertung (kurz, evidence-basiert)​
- Stärke: Rechte sind (historisch) sehr nah am Datenmodell und skalieren für Sichtbarkeitsfilter (Views +
BerechtigungSelect). - Risiko: Mehrere nicht-äquivalente Implementierungen der gleichen Semantik (DB vs EF vs Web-Rollenclaims) erzeugen Drift.
- Risiko: Einige EF-Sicherheitsfilter enthalten explizite "No securityfilter rules"-Fälle; das weicht von DB-Views (DSGVO-Filter) ab.
- Risiko: Token-Form (nur
cca:context) erfordert zwingend Claims-Transformation, sonst fehlennameid/NameIdentifier fĂĽr CoreDataService.
Diagrams​
docs/products/cca/shared/authorization/diagrams/cca-authorization-overview.d2docs/products/cca/shared/authorization/diagrams/cca-authorization-overview.svg
Evidence Snippets (direkt aus Code/DB)​
Token shape: cca:context statt nameid​
// cca.ccaonline/ccaonline-dotnet/src/CCAOnline/Services/Security/Jwt/JwtTokenGenerator.cs:33-54
var userClaimValues = new UserClaimValues
{
UserId = CCAUserKey.Serialize(userKey),
// ...
};
List<Claim> claims =
[
new Claim(CCAOnlineClaims.MainClaimContainerName, userClaim.ToJson()),
];
CoreDataService V1 detection + upgrade​
// cca.ccaonline/src/CCAOnline.Core/Identity/CCAOnlineClaimsIdentity.cs:17-20
return claimsIdentity.AuthenticationType == "JWT";
// cca.ccaonline/ccaonline-dotnet/src/CCAOnline/Extensions/Startup/CCAOnlineClaimsTransformation.cs:61-72
if (id.IsCoreDataServiceV1Token())
{
var ccaId = await _builder.BuildIdentity(id, _userManager);
id.CopyClaimIfPresent(ccaId, "client_id");
return new ClaimsPrincipal(ccaId);
}
CoreDataService reads nameid / WS-Fed NameIdentifier​
// cca.ccaonline/src/CCA.CoreDataService/CCA.CoreDataService.WebApi/ApiControllerExtensions.cs:28-45
public const string SerialzedUserId = "nameid";
var serialized = claims.FirstOrDefault(x =>
x.Type == SerialzedUserId ||
x.Type == "http://schemas.xmlsoap.org/ws/2005/05/identity/claims/nameidentifier")?.Value;
Materialisierung: Scope Codes in spBerechtigungSelectMitarbeiter​
-- CCA9/Database/Source_Db/Procedure/spBerechtigungSelectMitarbeiter.sql:29-62
-- alles: @GruppeID = -3 -> brsBetreuerID NULL
-- eigen: @GruppeID = -1 -> brsBetreuerID = @MitarbeiterID
-- Gruppe: @GruppeID > 0 -> mitzMitarbeiterID aus MitarbeiterZuordnung (+ 0, + eigener Mitarbeiter)
Abweichung: EF hat "No securityfilter rules" für NKP/KFZ/Bankkonto/...​
// CCA.Domainservices/src/CCA9.Infrastructure.EF6.Impl/Extensions/SecurityFilter.cs:269-307
return query; //No securityfilter rules for NKP
DB erzwingt bei NKP DSGVO-Sichtbarkeit über rolDarfGesperrteSehen​
-- CCA9/Database/Source_Db/View/vwNKP.sql:56-60
WHERE (r.rolDarfGesperrteSehen=1 OR NKP.nkpDSEinschraenkungID is NULL)