Download the PHP package michaldudek/subdomain-blacklist without Composer
On this page you can find all versions of the php package michaldudek/subdomain-blacklist. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download michaldudek/subdomain-blacklist
More information about michaldudek/subdomain-blacklist
Files in michaldudek/subdomain-blacklist
Package subdomain-blacklist
Short Description Common words that your users shouldn't use when setting up accounts.
License MIT
Informations about the package subdomain-blacklist
Subdomain Blacklist
List of common words that your users shouldn't use when setting up accounts.
When your app or service allows users to access their accounts using subdomains, e.g. michaldudek.myapp.com
,
it is useful to block some words so they don't take away a subdomain you'd want to use in the future
or worse, try to trick your other users into believing they represent you (e.g. legal.myapp.com
or
support.myapp.com
).
Apart from the blacklist, the goal of this repository is to provide code in various languages that validates a username against the list.
Note that the goal of this library IS NOT to validate domain name. You still have to check whether or not the given username makes a valid subdomain.
Acknowledgement
The idea and the list was originally taken from Sandeep Shetty.
Spec
Implementation MUST have a method/function called validate
which takes a single string argument.
The validate
method/function MUST return a boolean value.
Before a string is validates it MUST be normalized. Normalization of the string MUST:
- remove any suffixed digits,
- change case to lowercase,
- remove a single
s
character if the string ends with ans
.
addToList
Implementation CAN contain addToList
(or add_to_list
if more appropriate for the language) method/function
that will add other items to the blacklist.
addToList
method/function MUST accept single string argument.
addToList
method/function CAN accept an array of strings as a single argument.
Before a string item is added to the blacklist via addToList
method/function the default blacklist MUST be loaded.
Before a string item is added to the blacklist it MUST be normalized with the rules above.
getList
Implementation CAN contain getList
(or get_list
if more appropriate for the language) method/function
that will return the blacklist.
Using and Languages
For more information about how to use this list in your specific language, please refer to README.md
file
in the language's folder.
Currently supported:
- php - more info -
$ composer require michaldudek/subdomain-blacklist dev-master
Planned:
- JavaScript (node.js)
- JavaScript (browser)
- Go
- Ruby
- Python
You are welcome to add support for other languages.
Contributing
At this moment pull requests with support for various languages are most welcome.
If you add a language support make sure to cover it with appropriate tests.
Also if you think some words should be added to the list either open an issue or do a PR.
If you are editing a code please make sure to adhere to common patterns and rules in that language.
See more in each languages specific README.md
file in their appropriate directory.