Http Auth Module
This is Simple Http Authentication HttpModule for ASP.NET (MVC).
- Basic Authentication
- Digest Authentication
- Restrict IP Address (ip4 or ip6)
- Basic or Digest Authentication don't tounch HttpContext.Current.User.
- Ignore Path Regex.(specified path skip authentication)
- Ignore IP Address.(specified IP skip authentication)
** Http Auth Module targets the .NET Framework 4.5 **
Licence
Quick start
Get Nuget package. https://www.nuget.org/packages/HttpAuthModule/
PM> Install-Package HttpAuthModule
After Getting, configure Web.config file. It's all you do for using HttpAuthModule.
Configuration
Modify Web.config file.
Configure on httpAuthModule section or appSettings section.
** appSetting section is prior to httpAuthModule section. **
configure on httpAuthModule section
<configuration>
<configSections>
<section name="httpAuthModule" type="System.Configuration.NameValueFileSectionHandler" />
</configSections>
<httpAuthModule>
<!--
[required] Http Authentication Mode.
- Basic: Basic authentication
- Digest: Digest authentication
- None: No authentication -->
<add key="AuthMode" value="Digest"/>
<!-- [optional] default is "SecureZone" -->
<add key="Realm" value="SecureZone"/>
<!-- [required if http auth on] user1:pass1;user2:pass2;... -->
<add key="Credentials" value="hoge:hogepass;foo:foopass;"/>
<!-- [optional] Digest Auth Nonce Valid Duration Minutes. default is 120 -->
<add key="DigestNonceValidDuration" value="120"/>
<!-- [required if digest auth on] Digest Auth Nonce Salt -->
<add key="DigestNonceSalt" value="uht9987bbbSAX" />
<!--
[optional] If set, specified IPs are only allowed: otherwize All IPs are allowed.
value is joined IP Range Combination as following.
- 10.23.0.0/24
- 127.0.0.1 (equals to 127.0.0.1/32)
- 2001:0db8:bd05:01d2:288a:1fc0:0001:0000/16
- ::1 (equals to ::1/128)
e.g) 127.0.0.1;182.249.0.0/16;182.248.112.128/26;::1 -->
<add key="RestrictIPAddresses" value="127.0.0.1;::1"/>
<!-- [optional] If set, specified pattern url request skip http auth and IP Restriction. -->
<add key="IgnorePathRegex" value="^/Home/Ignore$|^/Ignore\.aspx$"/>
<!--
[optional] If set,specified IPs requests skip http auth Restriction.
value format is same as 'RestrictIPAddresses'
-->
<add key="IgnoreIPAddresses" value="127.0.0.1;::1"/>
<!-- [optional] If set, specified value of Request Header is regarded as Client IP. -->
<!-- <add key="ClientIPHeaders" value="CF-CONNECTING-IP;True-Client-IP"/> -->
<!-- [optional] If set, specified value of Server Variable is regarded as Client IP. -->
<!-- <add key="ClientIPServerVariables" value="HTTP_X_FORWARDED_FOR"/> -->
</httpAuthModule>
<system.webServer>
<modules>
<add type="HttpAuthModule.HttpAuthModule" name="HttpAuthModule"/>
</modules>
</system.webServer>
</configuration>configure on appSettings section
<configuration>
<appSettings>
<add key="HttpAuthModule.AuthMode" value="Digest" />
<add key="HttpAuthModule.Realm" value="SecureZone"/>
<add key="HttpAuthModule.Credentials" value="hoge:hogepass;foo:foopass;"/>
<add key="HttpAuthModule.DigestNonceValidDuration" value="120"/>
<add key="HttpAuthModule.DigestNonceSalt" value="uht9987bbbSAX" />
<add key="HttpAuthModule.RestrictIPAddresses" value="127.0.0.1;::1"/>
<add key="HttpAuthModule.IgnorePathRegex" value="^/Home/Ignore$|^/Ignore\.aspx$"/>
<add key="HttpAuthModule.IgnoreIPAddresses" value="127.0.0.1;::1"/>
</appSettings>
<system.webServer>
<modules>
<add type="HttpAuthModule.HttpAuthModule" name="HttpAuthModule"/>
</modules>
</system.webServer>
</configuration>If you apply only http requests for ASP.NET Resource(default.aspx /controller/action, but image.gif, index.html), change "modules -> add" element.
<modules>
<!-- add preCondition="managedHandler" -->
<add type="HttpAuthModule.HttpAuthModule" name="HttpAuthModule" preCondition="managedHandler" />
</modules>Disable HttpAuthModule by AppSettings
if you add HttpAuthModuleEnabled=false to appSettings, HttpAUthModule doesn't run.
<appSettings>
<add key="HttpAuthModuleEnabled" value="false" />
</appSettings>Usage for PHP
- create bin dir(ectory) into root dir.
- put HttpAuthModule.dll into bin dir.
- put Web.config into root dir.
HttpAuthModule.dll and Web.config is here, https://github.com/nabehiro/HttpAuthModule/PHPResources
please see detail, http://blogs.gine.jp/taka/archives/2753