Added PermissionService and added docs to all methods with potential user contact

HopFrame.Security/Authentication/HopFrameAuthenticationExtensions.cs

@@ -1,5 +1,6 @@
 using HopFrame.Database;
 using HopFrame.Security.Claims;
+using HopFrame.Security.Services;
 using Microsoft.AspNetCore.Authentication;
 using Microsoft.AspNetCore.Http;
 using Microsoft.Extensions.DependencyInjection;
@@ -9,9 +10,16 @@ namespace HopFrame.Security.Authentication;
 
 public static class HopFrameAuthenticationExtensions {
 
+    /// <summary>
+    /// Configures the WebApplication to use the authentication and authorization of the HopFrame API
+    /// </summary>
+    /// <param name="service">The service provider to add the services to</param>
+    /// <typeparam name="TDbContext">The database object that saves all entities that are important for the security api</typeparam>
+    /// <returns></returns>
     public static AuthenticationBuilder AddHopFrameAuthentication<TDbContext>(this IServiceCollection service) where TDbContext : HopDbContextBase {
         service.TryAddSingleton<IHttpContextAccessor, HttpContextAccessor>();
         service.AddScoped<ITokenContext, TokenContextImplementor<TDbContext>>();
+        service.AddScoped<IPermissionService, PermissionService<TDbContext>>();
         return service.AddAuthentication(HopFrameAuthentication<TDbContext>.SchemeName).AddScheme<AuthenticationSchemeOptions, HopFrameAuthentication<TDbContext>>(HopFrameAuthentication<TDbContext>.SchemeName, _ => {});
     }