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
- Evidence:
- 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
- Evidence:
- Danach wird die Identität zu
CCAOnlineClaimsIdentityangereichert (inkl. Rollenclaims undnameid/NameIdentifier).- Evidence:
cca.ccaonline/ccaonline-dotnet/src/CCAOnline/Extensions/Startup/CCAOnlineClaimsTransformation.cs - Evidence:
cca.ccaonline/src/CCAOnline.Core/Identity/ICCAOnlineClaimsIdentityBuilder.cs
- Evidence:
Rollenclaims (ClaimTypes.Role) und WebApi-Security-Profiles​
- Rollen sind String-Values (z.B.
CCAOnlineBestandExplorerRole.Read) und werden alsClaimTypes.Roleausgegeben.- Evidence:
cca.ccaonline/src/CCAOnline.Core/Identity/CCAOnlineRole.cs - Evidence:
cca.ccaonline/src/CCAOnline.Core/Identity/CCAOnlineUserStore.cs
- Evidence:
- 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
- Evidence:
- Die Mapping-Matrix (Controller/Action -> RequireAnyRole/...) liegt in Security-Profiles.
- Evidence:
cca.ccaonline/ccaonline-dotnet/src/CCAOnline/Controllers/Security/WebApiSecurityEntityProfile.cs
- Evidence:
Token-Ausgabe für CoreDataService (V1)​
POST /coredataservice/api/tokenbzw./coredataservice/api/token/NTliefern Access Tokens.- Evidence:
cca.ccaonline/ccaonline-dotnet/src/CCAOnline/Controllers/Authorization/AuthorizationController.cs
- Evidence:
- Das JWT enthält primär
cca:context(JSON mit serialisiertemCCAUserKey) + optionalclient_id.- Evidence:
cca.ccaonline/ccaonline-dotnet/src/CCAOnline/Services/Security/Jwt/JwtTokenGenerator.cs
- Evidence:
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
- Evidence:
- Es existieren parallele Legacy-OWIN Pfade (historische Middleware, FluentSecurity, usw.).
- Evidence:
cca.ccaonline/src/CCAOnline/App_Start/OwinStartUp.cs
- Evidence:
Diagrams​
docs/products/cca/ccaonline/diagrams/ccaonline-auth-flow.d2docs/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.RoleaufvalidatedUser.CCAUserRole(z.B.Mitarbeiter), während WebApiSecurityProfile typischerweiseCCAOnline*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);