diff --git a/LICENSE.txt b/LICENSE.txt new file mode 100644 index 0000000..96195a2 --- /dev/null +++ b/LICENSE.txt @@ -0,0 +1,21 @@ +MIT License + +Copyright (c) 2018 Lithnet + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. diff --git a/README.md b/README.md new file mode 100644 index 0000000..31db00d --- /dev/null +++ b/README.md @@ -0,0 +1,37 @@ +![](https://lithnet.github.io/images/logo-ex-small.png) +# Active Directory Password Filter +The Lithnet Active Directory Password filter enhances the options available to an organization for protecting their accounts in Active Directory with strong passwords. + +We're firm believers that good password hygeine is essential in every organization, and it should not be a premium that you pay extra for. + +## Features +* No internet access required +* Group policy support +* Supports checked passwords against a breached password list +* Supports checking for banned words in passwords +* Checks common character substitutions (eg P@ssw0rd is normalized to password before being checked against the banned word store) +* Supports custom complexity password rules + * Minimum password length + * Length-based complexity rules (allow longer passwords to be less complex) + * Points-based complexity rules + * Regular expression matching +* Full PowerShell support + * Managing the breached password and banned word stores. Add your own banned words and known breached passwords, as well as use popular databases such as the haveibeenpwned downloadable password list + * Testing passwords and existing hashes against the store + * Test your user's current passwords in AD against the banned password store + +## System Requirements +#### Password Filter +* Windows Server 2008 R2 or higher +#### PowerShell module +* .NET Framework 4.6 +* PowerShell 5 + +## Getting started +Download the installer from the [releases page](https://github.com/lithnet/ad-password-filter/releases) + +Read the [getting started guide](https://github.com/lithnet/ad-password-filter/wiki) + +## Keep up to date +* [Visit my blog](http://blog.lithiumblue.com) +* [Follow me on twitter](https://twitter.com/RyanLNewington)![](http://twitter.com/favicon.ico)