| | | 1 | | using Microsoft.AspNetCore.Authorization; |
| | | 2 | | using Microsoft.Extensions.Options; |
| | | 3 | | using ProjectTemplate.Web.Authentication.Options; |
| | | 4 | | |
| | | 5 | | namespace ProjectTemplate.Web.Authentication.Extensions; |
| | | 6 | | |
| | | 7 | | /// <summary> |
| | | 8 | | /// Provides extension methods for registering application authorization services. |
| | | 9 | | /// </summary> |
| | | 10 | | public static class AuthorizationServiceExtensions |
| | | 11 | | { |
| | | 12 | | /// <summary> |
| | | 13 | | /// Adds application authorization services and baseline policies. |
| | | 14 | | /// </summary> |
| | | 15 | | /// <param name="services">The service collection to add authorization services to.</param> |
| | | 16 | | /// <param name="configuration">The application configuration source.</param> |
| | | 17 | | /// <returns>The same <see cref="IServiceCollection"/> instance for chaining.</returns> |
| | | 18 | | public static IServiceCollection AddApplicationAuthorization( |
| | | 19 | | this IServiceCollection services, |
| | | 20 | | IConfiguration configuration) |
| | | 21 | | { |
| | 110 | 22 | | ArgumentNullException.ThrowIfNull(services); |
| | 110 | 23 | | ArgumentNullException.ThrowIfNull(configuration); |
| | | 24 | | |
| | 110 | 25 | | services |
| | 110 | 26 | | .AddOptions<ApplicationAuthorizationOptions>() |
| | 110 | 27 | | .Bind(configuration.GetSection(ApplicationAuthorizationOptions.SectionName)) |
| | 110 | 28 | | .Validate( |
| | 110 | 29 | | authorizationOptions => |
| | 110 | 30 | | !authorizationOptions.RequireAuthenticatedUserByDefault || |
| | 110 | 31 | | configuration.GetValue<bool>($"{ApplicationAuthenticationOptions.SectionName}:Enabled"), |
| | 110 | 32 | | "ProjectTemplate:Authorization:RequireAuthenticatedUserByDefault cannot be true when ProjectTemplate:Aut |
| | 110 | 33 | | .Validate( |
| | 110 | 34 | | authorizationOptions => !string.IsNullOrWhiteSpace(authorizationOptions.RoleClaimType), |
| | 110 | 35 | | "ProjectTemplate:Authorization:RoleClaimType is required.") |
| | 110 | 36 | | .Validate( |
| | 110 | 37 | | authorizationOptions => !string.IsNullOrWhiteSpace(authorizationOptions.PermissionClaimType), |
| | 110 | 38 | | "ProjectTemplate:Authorization:PermissionClaimType is required.") |
| | 110 | 39 | | .Validate( |
| | 110 | 40 | | authorizationOptions => authorizationOptions.AdministratorRoles.Any(role => !string.IsNullOrWhiteSpace(r |
| | 110 | 41 | | "ProjectTemplate:Authorization:AdministratorRoles must contain at least one non-empty value.") |
| | 110 | 42 | | .Validate( |
| | 110 | 43 | | authorizationOptions => authorizationOptions.ManageApplicationPermissions.Any(permission => !string.IsNu |
| | 110 | 44 | | "ProjectTemplate:Authorization:ManageApplicationPermissions must contain at least one non-empty value.") |
| | 110 | 45 | | .ValidateOnStart(); |
| | | 46 | | |
| | 110 | 47 | | _ = services.AddAuthorization(); |
| | | 48 | | |
| | | 49 | | // Build every policy from the bound and validated ApplicationAuthorizationOptions instance, so the |
| | | 50 | | // policies and the validators above always see the same values. |
| | 110 | 51 | | services |
| | 110 | 52 | | .AddOptions<AuthorizationOptions>() |
| | 110 | 53 | | .Configure<IOptions<ApplicationAuthorizationOptions>>((authorizationOptions, applicationAuthorizationOptions |
| | 110 | 54 | | { |
| | 110 | 55 | | ApplicationAuthorizationOptions applicationAuthorizationOptions = applicationAuthorizationOptionsAccesso |
| | 110 | 56 | | |
| | 110 | 57 | | authorizationOptions.AddPolicy( |
| | 110 | 58 | | ApplicationAuthorizationPolicyNames.AuthenticatedUser, |
| | 110 | 59 | | policy => policy.RequireAuthenticatedUser()); |
| | 110 | 60 | | authorizationOptions.AddPolicy( |
| | 110 | 61 | | ApplicationAuthorizationPolicyNames.AdministratorRole, |
| | 110 | 62 | | policy => |
| | 110 | 63 | | { |
| | 110 | 64 | | policy.RequireAuthenticatedUser(); |
| | 110 | 65 | | policy.RequireClaim( |
| | 110 | 66 | | applicationAuthorizationOptions.RoleClaimType, |
| | 110 | 67 | | applicationAuthorizationOptions.AdministratorRoles); |
| | 110 | 68 | | }); |
| | 110 | 69 | | authorizationOptions.AddPolicy( |
| | 110 | 70 | | ApplicationAuthorizationPolicyNames.ManageApplicationPermission, |
| | 110 | 71 | | policy => |
| | 110 | 72 | | { |
| | 110 | 73 | | policy.RequireAuthenticatedUser(); |
| | 110 | 74 | | policy.RequireClaim( |
| | 110 | 75 | | applicationAuthorizationOptions.PermissionClaimType, |
| | 110 | 76 | | applicationAuthorizationOptions.ManageApplicationPermissions); |
| | 110 | 77 | | }); |
| | 110 | 78 | | |
| | 110 | 79 | | authorizationOptions.FallbackPolicy = applicationAuthorizationOptions.RequireAuthenticatedUserByDefault |
| | 110 | 80 | | ? new AuthorizationPolicyBuilder().RequireAuthenticatedUser().Build() |
| | 110 | 81 | | : null; |
| | 110 | 82 | | }); |
| | | 83 | | |
| | 110 | 84 | | return services; |
| | | 85 | | } |
| | | 86 | | } |
| | | 87 | | |
| | | 88 | | /// <summary> |
| | | 89 | | /// Provides application authorization policy names. |
| | | 90 | | /// </summary> |
| | | 91 | | public static class ApplicationAuthorizationPolicyNames |
| | | 92 | | { |
| | | 93 | | /// <summary> |
| | | 94 | | /// Policy requiring the current user to be authenticated. |
| | | 95 | | /// </summary> |
| | | 96 | | public const string AuthenticatedUser = "application.AuthenticatedUser"; |
| | | 97 | | |
| | | 98 | | /// <summary> |
| | | 99 | | /// Policy defining the administrator role. |
| | | 100 | | /// </summary> |
| | | 101 | | public const string AdministratorRole = "application.Role.Administrator"; |
| | | 102 | | |
| | | 103 | | /// <summary> |
| | | 104 | | /// Policy defining the manage application permission. |
| | | 105 | | /// </summary> |
| | | 106 | | public const string ManageApplicationPermission = "application.Permission.ManageApplication"; |
| | | 107 | | } |