FyinDotCom.AccessCode.AspNetCore 6.2.0

1. Add the following json object to the appsettings.json file...

  "AccessCodeSettings": {
      "Enable": "true", // true|false, Optional Default: true
      "AccessCode": "fyin", // Required
      "CheckWhiteListedIpAddresses": "false", // Required
      "WhiteListedIpAddresses": [
        "127.0.0.1",
        "::1",
        "::2"
      ], // Required if you're checking whitelisted ip addresses.
      "IgnoredPaths": [
        "^/api/",
        "^/assets/"
      ], // Include if you want certain paths to be ignored (regex pattern)
      "SplashImagePathOrUrl" : "splashImagePathOrUrl" // Optional
      // SplashImagePathOrUrl: If left empty it will use the blue bird denver image.else,
      // If image is hosted somewhere specify full url path.
      // If hosted in project then just give relative wwwroot path.
      // For example "/images/AccessCodeImage.jpg"
  }

2. Add the following lines of code to the ConfigureServices method...

services.AddSession(); // add session
services.Configure<AccessCodeSettings>(options => Configuration.GetSection("AccessCodeSettings").Bind(options));
services.AddHttpContextAccessor();
services.AddTransient<IAccessCodeRequestValidationService, AccessCodeRequestValidationService>();
services.AddTransient<IAccessCodeCookieService, AccessCodeCookieService>();

3. Add the following lines of code to the Configure method...

//Remove this line when you want full production live without access code functionality.
app.UseSession().UseAccessCodeMiddleware();

General Notes

If you want to disable the accesscode check without an app restart, then just delete the AccessCode.html file in your project.

If you can do an app-restart or deployment, then just remove the line of code in #3.