TFE.Umbraco.AccessRestriction 11.3.1

TFE.Umbraco.AccessRestriction

TFE.Umbraco.AccessRestriction is a IP access restriction manager for Umbraco. The package features a dashboard and editor that let's users manage whitelisted IP addresses from within the Umbraco backoffice. IP's can be added with a description and have both a creation and modified date and user.

Getting started

Package Installation

The Umbraco 11 version of this package is only available via NuGet. To install the package, you can use either .NET CLI:

dotnet add package TFE.Umbraco.AccessRestriction --version 11.3.1

or the older NuGet Package Manager:

NuGet\Install-Package TFE.Umbraco.AccessRestriction --version 11.3.1

Umbraco Installation

Before the Umbraco middleware, add the IPAccessRestrictionMiddleware to Startup.cs:

app.UseMiddleware<IPAccessRestrictionMiddleware>(); 

Add the necessary usings to Startup.cs:

using TFE.Umbraco.AccessRestriction.Middleware;

Add these settings to appsettings.json

"TFE.Umbraco.AccessRestriction": {
    "disable": true, 
    "logBlockedIP": false,
    "localHost": "127.0.0.1", 
    "excludePaths": "/umbraco, /App_Plugins, /api/keepalive/ping",
    "isCloudFlare": false,
    "customHeader": ""
  }

Azure / CloudFlare / Umbraco Cloud Installation

When installed on a cloud environment make sure to add your the cloud IP Addresses. Replace the following excludePaths property in appsettings.json :

"excludePaths": "/umbraco, /App_Plugins, /api/keepalive/ping, /umbraco-signin-oidc, /sb", 

Set to true when using Cloudflare

"isCloudFlare": true,

If a proxy is being used, set the value of the 'customHeader' field to 'header' with the IP address used by the proxy.

"customHeader": "",

Features

• Global dashboard for listing all whitelisted IP addresses.
• Package only handles IP addresses added manually by a user with admin rights.
• logBlockedIP enables you to see all blocked IP addresses in the Umbraco log.
• Use * as wildcard to add a range of IP addresses e.g. "192.168.1.*"

Contribution guidelines

To raise a new bug, create an issue on the GitHub repository. To fix a bug or add new features, fork the repository and send a pull request with your changes. Feel free to add ideas to the repository's issues list if you would like to discuss anything related to the library.

Who do I talk to?

This project is maintained by Rutger Dijkstra and contributors. If you have any questions about the project please raise a issue on GitHub.