@xtrctio/express-auto-blacklist v0.0.3

express-auto-blacklist

Automatically blacklist IPs based on request patterns

Use:

const AutoBlacklist = require('@xtrctio/auto-blacklist');

const autoBlacklist = new AutoBlacklist([/some-blacklist-url/]);
app.use(autoBlacklist.check);

AutoBlacklist

Kind: global class

• AutoBlacklist
  • new AutoBlacklist([blockPatterns], [maxStrikes], [strikeAgeMs], [maxBlockedIPs], [whitelist], [blacklist])
  • .setBlockedCallback(callback)
  • .check(req, res, next) ⇒ *
  • .block(ip) ⇒ void
  • .strike(ip) ⇒ boolean
  • .whitelistIP(ip) ⇒ void
  • .blacklistIP(ip) ⇒ void
  • .isBlocked(ip, path) ⇒ boolean

new AutoBlacklist(blockPatterns, maxStrikes, strikeAgeMs, maxBlockedIPs, whitelist, blacklist)

autoBlacklist.setBlockedCallback(callback)

Set callback for when an IP is blocked

Kind: instance method of AutoBlacklist

autoBlacklist.check(req, res, next) ⇒ *

Check if request should be blocked

Kind: instance method of AutoBlacklist

autoBlacklist.block(ip) ⇒ void

Add IP to the LRU blocklist

Kind: instance method of AutoBlacklist

autoBlacklist.strike(ip) ⇒ boolean

Apply strike to IP

Kind: instance method of AutoBlacklist

autoBlacklist.whitelistIP(ip) ⇒ void

Whitelist an IP

Kind: instance method of AutoBlacklist

autoBlacklist.blacklistIP(ip) ⇒ void

Blacklist an IP

Kind: instance method of AutoBlacklist

autoBlacklist.isBlocked(ip, path) ⇒ boolean

Check if request should be blocked

Kind: instance method of AutoBlacklist