Zum Hauptinhalt springen

cca.ccaonline Berechtigungssystem

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

Fokus: Wie cca.ccaonline Authentifizierung (AuthN) und Berechtigungen (AuthZ) fĂĽr Web/MVC, WebApi und CoreDataService abbildet.

Pipeline (AuthN + Claims-Transformation)​

  • ASP.NET Core Pipeline nutzt UseAuthentication() + UseAuthorization() und mappt Controller.
    • Evidence: cca.ccaonline/ccaonline-dotnet/src/CCAOnline/Extensions/Startup/WebApplicationExtensions.cs
  • JwtBearer-Identitäten werden als "CoreDataService V1 Token" erkannt, wenn AuthenticationType == "JWT".
    • Evidence: cca.ccaonline/src/CCAOnline.Core/Identity/CCAOnlineClaimsIdentity.cs
    • Evidence: cca.ccaonline/ccaonline-dotnet/src/CCAOnline/ServiceConfiguration/ConfigureJwtBearerOptions.cs
  • Danach wird die Identität zu CCAOnlineClaimsIdentity angereichert (inkl. Rollenclaims und nameid/NameIdentifier).
    • Evidence: cca.ccaonline/ccaonline-dotnet/src/CCAOnline/Extensions/Startup/CCAOnlineClaimsTransformation.cs
    • Evidence: cca.ccaonline/src/CCAOnline.Core/Identity/ICCAOnlineClaimsIdentityBuilder.cs

Rollenclaims (ClaimTypes.Role) und WebApi-Security-Profiles​

  • Rollen sind String-Values (z.B. CCAOnlineBestandExplorerRole.Read) und werden als ClaimTypes.Role ausgegeben.
    • Evidence: cca.ccaonline/src/CCAOnline.Core/Identity/CCAOnlineRole.cs
    • Evidence: cca.ccaonline/src/CCAOnline.Core/Identity/CCAOnlineUserStore.cs
  • WebApi setzt eine globale Action-Filter-Logik ein (WebApiHandleSecurityAttribute), die Controller/Action gegen konfigurierte Policies prĂĽft.
    • Evidence: cca.ccaonline/src/CCAOnline.Core/Infrastructure/Security/WebApiAuthorization/Attributes/WebApiHandleSecurityAttribute.cs
    • Evidence: cca.ccaonline/src/CCAOnline.Core/Infrastructure/Security/WebApiAuthorization/WebApiSecurityHandler.cs
  • Die Mapping-Matrix (Controller/Action -> RequireAnyRole/...) liegt in Security-Profiles.
    • Evidence: cca.ccaonline/ccaonline-dotnet/src/CCAOnline/Controllers/Security/WebApiSecurityEntityProfile.cs

Token-Ausgabe für CoreDataService (V1)​

  • POST /coredataservice/api/token bzw. /coredataservice/api/token/NT liefern Access Tokens.
    • Evidence: cca.ccaonline/ccaonline-dotnet/src/CCAOnline/Controllers/Authorization/AuthorizationController.cs
  • Das JWT enthält primär cca:context (JSON mit serialisiertem CCAUserKey) + optional client_id.
    • Evidence: cca.ccaonline/ccaonline-dotnet/src/CCAOnline/Services/Security/Jwt/JwtTokenGenerator.cs

Ausreisser (wichtig für Debugging)​

  • Die Token-Form enthält nicht direkt nameid/NameIdentifier; diese Claims werden erst durch Claims-Transformation erzeugt.
    • Evidence: cca.ccaonline/ccaonline-dotnet/src/CCAOnline/Extensions/Startup/CCAOnlineClaimsTransformation.cs
    • Evidence: cca.ccaonline/src/CCA.CoreDataService/CCA.CoreDataService.WebApi/ApiControllerExtensions.cs
  • Es existieren parallele Legacy-OWIN Pfade (historische Middleware, FluentSecurity, usw.).
    • Evidence: cca.ccaonline/src/CCAOnline/App_Start/OwinStartUp.cs

Diagrams​

  • docs/products/cca/ccaonline/diagrams/ccaonline-auth-flow.d2
  • docs/products/cca/ccaonline/diagrams/ccaonline-auth-flow.svg

Evidence Snippets​

ClaimsTransformation für CoreDataService Tokens​

// 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);
}

JWT enthält cca:context (nicht nameid)​

// cca.ccaonline/ccaonline-dotnet/src/CCAOnline/Services/Security/Jwt/JwtTokenGenerator.cs:33-54
List<Claim> claims =
[
new Claim(CCAOnlineClaims.MainClaimContainerName, userClaim.ToJson()),
];

Rollenclaim mismatch (wichtig für WebApiSecurityProfile)​

  • Token-Ausgabe setzt ClaimTypes.Role auf validatedUser.CCAUserRole (z.B. Mitarbeiter), während WebApiSecurityProfile typischerweise CCAOnline*Role.* Strings erwartet.
// cca.ccaonline/ccaonline-dotnet/src/CCAOnline/Services/Authorization/AuthorizationService.cs:199-205
new(CCAOnlineClaims.UserRole, validatedUser.CCAUserRole.ToString()),
new(ClaimTypes.Role, validatedUser.CCAUserRole.ToString())
// cca.ccaonline/src/CCAOnline/Areas/Entity/WebApiSecurityEntityProfile.cs:25-27
configuration.For<VUController>().RequireAnyRole(CCAOnlineBestandExplorerRole.Read.Value);