ssrfcheck is an npm package that serves to provide protection from SSRF by validating URLs or hostname inputs.
Resources:
- Project's GitHub code repository: https://github.com/felippe-regazio/ssrfcheck
- Project's npm package: https://www.npmjs.com/package/ssrfcheck
The ssrfcheck package maintains a denylist of IP addresses and ranges to check against when validating if an IP address is to be considered as safe or not.
However, the IP address list used for the denylist is incomplete and misses a reserved IP address space as defined by the IANA (Internet Assigned Numbers Authority):
- 224.0.0.0/4 - Multicast
Practically, this reserved IP address space is used for multicast traffic and would most commonly be used for reserved local communication over network protocols such as UDP, which would make it less likely to be used in a typical SSRF attack in practice.
However, such reserved IP address space shouldn't be allowed and it would be responsible of the SSRF protection package to align and conform to an agreed-upon standard of special-purposed addresses that should not be considered a valid public IP address. For reference, the popular npm packages private-ip and ipaddr.js that are highly dependent-upon to make decisions about SSRF protection and both consider the above mentioned IP address space as reserved and is not considered a valid public IP address.
- Install the
ssrfcheckpackage:
npm install ssrfcheck- Define an
app.jsfile with the programmatic API ofssrfcheck:
import { isSSRFSafeURL } from 'ssrfcheck';
let result
result = isSSRFSafeURL('https://012.1.2.3/whatever');
console.log(result); // returns false
result = isSSRFSafeURL('https://localhost:8080/whatever');
console.log(result); // returns false
result = isSSRFSafeURL('https://239.255.255.250:8080/whatever');
console.log(result); // returns true - bypassedAll versions of ssrfcheck are vulnerable to this issue, up to and including to the latest version of 1.1.1.
Liran Tal
Hello @lirantal! Thank you for the report, very valuable for the package! I created an issue on the repository and will be working on a patch to solve this problem in the next few days - feel free to PR or comment on the issue: felippe-regazio/ssrfcheck#5.