mirror of
https://github.com/disposable-email-domains/disposable-email-domains.git
synced 2024-11-23 09:08:11 +08:00
a8d1242292
- $path defined so the code works from anywhere in a framework folder structure - file is loaded to an “associative array” instead of a standard array. The prior approach had to search through entire array to find email address. This approach can use the key index.
145 lines
5.0 KiB
Markdown
145 lines
5.0 KiB
Markdown
List of disposable email domains
|
||
========================
|
||
|
||
[](https://creativecommons.org/publicdomain/zero/1.0/)
|
||
|
||
This repo contains a [list of disposable and temporary email address domains](disposable_email_blacklist.conf) often used to register dummy users in order to spam/abuse some services.
|
||
|
||
Originally collected to filter new user registration at https://usegalaxy.org and later merged with other lists found online. I cannot guarantee all of these can still be considered disposable but they probably were at one point in time.
|
||
|
||
Whitelist
|
||
=========
|
||
The file [whitelist.conf](whitelist.conf) gathers email domains that are often identified as disposable but in fact are not.
|
||
|
||
Example Usage
|
||
=============
|
||
**Python**
|
||
```Python
|
||
blacklist = ('disposable_email_blacklist.conf')
|
||
blacklist_content = [line.rstrip() for line in blacklist.readlines()]
|
||
if email.split('@')[1] in blacklist_content:
|
||
message = "Please enter your permanent email address."
|
||
return (False, message)
|
||
else:
|
||
return True
|
||
```
|
||
|
||
Available as [PyPI module](https://pypi.python.org/pypi/disposable-email-domains) thanks to @di
|
||
```
|
||
>>> from disposable_email_domains import blacklist
|
||
>>> 'bearsarefuzzy.com' in blacklist
|
||
True
|
||
```
|
||
|
||
**PHP** contributed by [@txt3rob](https://github.com/txt3rob), [@deguif](https://github.com/deguif) and [@pjebs](https://github.com/pjebs)
|
||
```php
|
||
function is_disposable_email($email) {
|
||
$path = realpath(dirname(__FILE__)) . '/disposable_email_blacklist.conf';
|
||
$mail_domains_ko = file($path, FILE_IGNORE_NEW_LINES | FILE_SKIP_EMPTY_LINES);
|
||
$mail_domains_ko = array_combine($mail_domains_ko, array_fill(0,count($mail_domains_ko), null));
|
||
$domain = mb_strtolower(explode('@', trim($email))[1])
|
||
return (isset($mail_domains_ko[$domain]) || array_key_exists($domain, $mail_domains_ko));
|
||
}
|
||
|
||
```
|
||
**Ruby on Rails** contributed by @MitsunChieh
|
||
|
||
In resource model, usually it is `user.rb`
|
||
```Ruby
|
||
before_validation :reject_email_blacklist
|
||
|
||
def reject_email_blacklist
|
||
blacklist = File.read('config/disposable_email_blacklist.conf').split("\n")
|
||
|
||
if blacklist.include?(email.split('@')[1])
|
||
errors[:email] << 'invalid email'
|
||
return false
|
||
else
|
||
return true
|
||
end
|
||
end
|
||
```
|
||
**NodeJs** contributed by @martin-fogelman
|
||
|
||
```Node
|
||
'use strict';
|
||
|
||
const readline = require('readline'),
|
||
fs = require('fs');
|
||
|
||
const input = fs.createReadStream('./disposable_email_blacklist.conf'),
|
||
output = [],
|
||
rl = readline.createInterface({input});
|
||
|
||
// PROCESS LINES
|
||
rl.on('line', (line) => {
|
||
console.log(`Processing line ${output.length}`);
|
||
output.push(line);
|
||
});
|
||
|
||
// SAVE AS JSON
|
||
rl.on('close', () => {
|
||
try {
|
||
const json = JSON.stringify(output);
|
||
fs.writeFile('disposable_email_blacklist.json', json, () => console.log('--- FINISHED ---'));
|
||
} catch (e) {
|
||
console.log(e);
|
||
}
|
||
});
|
||
```
|
||
|
||
**C#**
|
||
```C#
|
||
private static readonly Lazy<HashSet<string>> _emailBlackList =
|
||
new Lazy<HashSet<string>>(
|
||
() =>
|
||
{
|
||
var result = new HashSet<string>(StringComparer.OrdinalIgnoreCase);
|
||
using (var reader = new StreamReader("disposable_email_blacklist.conf"))
|
||
{
|
||
string line;
|
||
while ((line = reader.ReadLine()) != null)
|
||
if (!string.IsNullOrWhiteSpace(line) && !line.TrimStart().StartsWith("//"))
|
||
result.Add(line);
|
||
}
|
||
return result;
|
||
});
|
||
|
||
private static bool IsBlacklisted(string domain)
|
||
{
|
||
var parts = domain.Split('.');
|
||
var len = parts.Length;
|
||
return
|
||
len == 1 && _emailBlackList.Value.Contains(domain)
|
||
|| _emailBlackList.Value.Contains($"{parts[len - 2]}.{parts[len - 1]}")
|
||
|| len > 2 && _emailBlackList.Value.Contains($"{parts[len - 3]}.{parts[len - 2]}.{parts[len - 1]}");
|
||
}
|
||
|
||
...
|
||
|
||
var addr = new MailAddress(email);
|
||
if (IsBlacklisted(addr.Host)))
|
||
throw new ApplicationException("Email is blacklisted.");
|
||
```
|
||
|
||
Contributing
|
||
============
|
||
Feel free to create PR with additions or request removal of some domain (with reasons).
|
||
|
||
Use
|
||
|
||
`$ cat disposable_email_blacklist.conf your_file | tr '[:upper:]' '[:lower:]' | sort -f | uniq -i > new_file.conf`
|
||
|
||
`$ comm -23 new_file.conf whitelist.conf > disposable_email_blacklist.conf`
|
||
|
||
to add contents of another file in the same format (only second level domains on new line without @). It also converts uppercase to lowercase, sorts, removes duplicates and removes whitelisted domains.
|
||
|
||
Changelog
|
||
============
|
||
|
||
* 7/31/17 @deguif [joined](https://github.com/martenson/disposable-email-domains/issues/106) as a core maintainer of this project. Thanks!
|
||
|
||
* 12/6/16 - Available as [PyPI module](https://pypi.python.org/pypi/disposable-email-domains) thanks to @di
|
||
|
||
* 7/27/16 - Converted all domains to the second level. This means that starting from [this commit](https://github.com/martenson/disposable-email-domains/commit/61ae67aacdab0b19098de2e13069d7c35b74017a) the implementers should take care of matching the second level domain names properly i.e. `@xxx.yyy.zzz` should match `yyy.zzz` in blacklist more info in [#46](https://github.com/martenson/disposable-email-domains/issues/46)
|