Zum Hauptinhalt springen

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.System DB 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
  • Rolle ist die zentrale Tabelle fĂĽr Mitarbeiter-Rechte (viele rol* Spalten).
    • Evidence: CCA9/Database/Source_Db/Table_Create.sql
  • BerechtigungSet ist eine booleans-basierte Projektion aus Rolle (Feature-/Funktionsrechte).
    • Evidence: CCA.Domainservices/src/CCA9.DomainServices/Authorization/BerechtigungSet.cs
  • BerechtigungSelect ist 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

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)​

  • CoreDataService ist kein eigenständiges Repo mit Service-Code: cca.coredataservice ist (derzeit) ein leeres Stub-Repo; die Implementierung liegt in cca.ccaonline/src/CCA.CoreDataService.
    • Evidence: cca.coredataservice/README.md
    • Evidence: cca.ccaonline/src/CCA.CoreDataService/
  • 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
  • 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 fehlen nameid/NameIdentifier fĂĽr CoreDataService.

Diagrams​

  • docs/products/cca/shared/authorization/diagrams/cca-authorization-overview.d2
  • docs/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)