Walter.Web.FireWall.EventLog 2020.9.28.2

Reporting interface for the firewall and the windows to support structured logging to the windows EventLog.
The Package extends the reporting functionality to NuGet package Walter.Web.Firewall.Core.3.x and is easily activated by dependency injection during service configuration

services.AddFireWall(FireWallTrail.License, FireWallTrail.DomainKey
, domainName: new Uri("https://www.your-domain.com/", UriKind.Absolute)
, options =>
{
  //your firewall settings
}).UseEventLogLogging(options=>{
  options.LogName = "FireWall";
  options.SourceName = "www.your-domain.com";
});

More information on how to use this Add-On is available in this manual https://www.asp-waf.com/download/ASP-WAF-FireWall-Getting-Started.pdf as well as on-line at https://www.asp-waf.com/NuGet

Install-Package Walter.Web.FireWall.EventLog -Version 2020.9.28.2

dotnet add package Walter.Web.FireWall.EventLog --version 2020.9.28.2

<PackageReference Include="Walter.Web.FireWall.EventLog" Version="2020.9.28.2" />

paket add Walter.Web.FireWall.EventLog --version 2020.9.28.2

#r "nuget: Walter.Web.FireWall.EventLog, 2020.9.28.2"

// Install Walter.Web.FireWall.EventLog as a Cake Addin
#addin nuget:?package=Walter.Web.FireWall.EventLog&version=2020.9.28.2

// Install Walter.Web.FireWall.EventLog as a Cake Tool
#tool nuget:?package=Walter.Web.FireWall.EventLog&version=2020.9.28.2

services.AddFireWall(FireWallTrail.License, FireWallTrail.DomainKey
    , domainName: new Uri("https://www.your-domain.com", UriKind.Absolute)
    , options =>
    {
        options.Cypher.ApplicationPassword = "123456$even";
        options.ApplicationName = "Name as used for reporting";
        options.ApplicationTag = "ITIL Tag";
        options.Rules.BlockRequest.BlockDuration.SlideExpiration = true;
        options.Rules.BlockRequest.BlockDuration.Expires = TimeSpan.FromSeconds(10);

        //used by JavaScript in the browser
        options.WebServices.IsUserApiUrl = new Uri(Links.IsUserEndpoint, UriKind.Relative);
        options.WebServices.RegisterLinksApiUrl = new Uri(Links.SiteMapEndPoint, UriKind.Relative);
        options.WebServices.BeaconApiUrl = new Uri(Links.BeaconPoint, UriKind.Relative);
    }).UseEventLogLogging(options=>{
		     options.LogName = "FireWall";
		     options.SourceName = "www.test.dll";    
		});
//protect each MVC controller
services.AddMvc(options =>
    options.Filters.Add<Walter.Web.FireWall.Filters.FireWallFilter>()
);

   namespace MyProject.Controllers
   {
       using Walter.Web.FireWall;
       using Walter.Web.FireWall.Annotations;
       using Walter.BOM.Geo;

       [Geo(blockLocation: GeoLocation.AFRICA | GeoLocation.LATIN_AMERICA | GeoLocation.Netherlands)]
       [Users(users: UserTypes.IsHuman | UserTypes.IsSearchEngine)]
       [BlockDuration(duration: 60, sliding: true, doubleDurationPerIncedent: true)]
       public sealed class MembersController : Controller
       {
           private readonly ILogger<MembersController> _logger;
            private readonly IPageRequest _page;
           public HomeController(ILogger<MembersController> logger,IPageRequest page)
           {
               _logger = logger;
               _page=page;
           }

           public IActionResult Index()
           {
               return View();
           }


           [Ignore]
           [ResponseCache(Duration = 0, Location = ResponseCacheLocation.None, NoStore = true)]
           public IActionResult Error()
           {
               //the page field will contain all the errors the user ran into
               return View(new ErrorViewModel { RequestId = Activity.Current?.Id ?? HttpContext.TraceIdentifier });
           }
       }
   }

services.AddFireWall(FireWallTrail.License, FireWallTrail.DomainKey
    , domainName: new Uri("https://www.your-domain.com", UriKind.Absolute)
    , options =>
    {
        options.Cypher.ApplicationPassword = "123456$even";
        options.ApplicationName = "Name as used for reporting";
        options.ApplicationTag = "ITIL Tag";
        options.Rules.BlockRequest.BlockDuration.SlideExpiration = true;
        options.Rules.BlockRequest.BlockDuration.Expires = TimeSpan.FromSeconds(10);

        //used by JavaScript in the browser
        options.WebServices.IsUserApiUrl = new Uri(Links.IsUserEndpoint, UriKind.Relative);
        options.WebServices.RegisterLinksApiUrl = new Uri(Links.SiteMapEndPoint, UriKind.Relative);
        options.WebServices.BeaconApiUrl = new Uri(Links.BeaconPoint, UriKind.Relative);
    }).UseEventLogLogging(options=>{
		     options.LogName = "FireWall";
		     options.SourceName = "www.test.dll";    
		});
//protect each MVC controller
services.AddMvc(options =>
    options.Filters.Add<Walter.Web.FireWall.Filters.FireWallFilter>()
);

   namespace MyProject.Controllers
   {
       using Walter.Web.FireWall;
       using Walter.Web.FireWall.Annotations;
       using Walter.BOM.Geo;

       [Geo(blockLocation: GeoLocation.AFRICA | GeoLocation.LATIN_AMERICA | GeoLocation.Netherlands)]
       [Users(users: UserTypes.IsHuman | UserTypes.IsSearchEngine)]
       [BlockDuration(duration: 60, sliding: true, doubleDurationPerIncedent: true)]
       public sealed class MembersController : Controller
       {
           private readonly ILogger<MembersController> _logger;
            private readonly IPageRequest _page;
           public HomeController(ILogger<MembersController> logger,IPageRequest page)
           {
               _logger = logger;
               _page=page;
           }

           public IActionResult Index()
           {
               return View();
           }


           [Ignore]
           [ResponseCache(Duration = 0, Location = ResponseCacheLocation.None, NoStore = true)]
           public IActionResult Error()
           {
               //the page field will contain all the errors the user ran into
               return View(new ErrorViewModel { RequestId = Activity.Current?.Id ?? HttpContext.TraceIdentifier });
           }
       }
   }

Release Notes

09 September 2020
     - update NuGet package references
     
     08 September 2020
     - Add support for .net core 3.0 and 3.1
     - Update NuGet package references
     - Update Documentation

     04 September 2020
     - Update package reference to firewall package

     27.08.2020
     - Add Referrer and root page to event log incident if user is blocked

     01.01.2020
     - Initial release

Dependencies

• .NETCoreApp 3.0

  • Microsoft.Windows.Compatibility (>= 3.1.1)
  • Walter.BOM (>= 2020.9.28.1)
  • Walter.Web.Firewall.Core.3.x (>= 2020.9.28.2)

• .NETCoreApp 3.1

  • Microsoft.Windows.Compatibility (>= 3.1.1)
  • Walter.BOM (>= 2020.9.28.1)
  • Walter.Web.Firewall.Core.3.x (>= 2020.9.28.2)

• .NETStandard 2.1

  • Microsoft.Windows.Compatibility (>= 3.1.1)
  • Walter.BOM (>= 2020.9.28.1)
  • Walter.Web.Firewall.Core.3.x (>= 2020.9.28.2)

Used By

Version History