$
This commit is contained in:
161
node_modules/proxy-addr/HISTORY.md
generated
vendored
Normal file
161
node_modules/proxy-addr/HISTORY.md
generated
vendored
Normal file
@@ -0,0 +1,161 @@
|
||||
2.0.7 / 2021-05-31
|
||||
==================
|
||||
|
||||
* deps: forwarded@0.2.0
|
||||
- Use `req.socket` over deprecated `req.connection`
|
||||
|
||||
2.0.6 / 2020-02-24
|
||||
==================
|
||||
|
||||
* deps: ipaddr.js@1.9.1
|
||||
|
||||
2.0.5 / 2019-04-16
|
||||
==================
|
||||
|
||||
* deps: ipaddr.js@1.9.0
|
||||
|
||||
2.0.4 / 2018-07-26
|
||||
==================
|
||||
|
||||
* deps: ipaddr.js@1.8.0
|
||||
|
||||
2.0.3 / 2018-02-19
|
||||
==================
|
||||
|
||||
* deps: ipaddr.js@1.6.0
|
||||
|
||||
2.0.2 / 2017-09-24
|
||||
==================
|
||||
|
||||
* deps: forwarded@~0.1.2
|
||||
- perf: improve header parsing
|
||||
- perf: reduce overhead when no `X-Forwarded-For` header
|
||||
|
||||
2.0.1 / 2017-09-10
|
||||
==================
|
||||
|
||||
* deps: forwarded@~0.1.1
|
||||
- Fix trimming leading / trailing OWS
|
||||
- perf: hoist regular expression
|
||||
* deps: ipaddr.js@1.5.2
|
||||
|
||||
2.0.0 / 2017-08-08
|
||||
==================
|
||||
|
||||
* Drop support for Node.js below 0.10
|
||||
|
||||
1.1.5 / 2017-07-25
|
||||
==================
|
||||
|
||||
* Fix array argument being altered
|
||||
* deps: ipaddr.js@1.4.0
|
||||
|
||||
1.1.4 / 2017-03-24
|
||||
==================
|
||||
|
||||
* deps: ipaddr.js@1.3.0
|
||||
|
||||
1.1.3 / 2017-01-14
|
||||
==================
|
||||
|
||||
* deps: ipaddr.js@1.2.0
|
||||
|
||||
1.1.2 / 2016-05-29
|
||||
==================
|
||||
|
||||
* deps: ipaddr.js@1.1.1
|
||||
- Fix IPv6-mapped IPv4 validation edge cases
|
||||
|
||||
1.1.1 / 2016-05-03
|
||||
==================
|
||||
|
||||
* Fix regression matching mixed versions against multiple subnets
|
||||
|
||||
1.1.0 / 2016-05-01
|
||||
==================
|
||||
|
||||
* Fix accepting various invalid netmasks
|
||||
- IPv4 netmasks must be contingous
|
||||
- IPv6 addresses cannot be used as a netmask
|
||||
* deps: ipaddr.js@1.1.0
|
||||
|
||||
1.0.10 / 2015-12-09
|
||||
===================
|
||||
|
||||
* deps: ipaddr.js@1.0.5
|
||||
- Fix regression in `isValid` with non-string arguments
|
||||
|
||||
1.0.9 / 2015-12-01
|
||||
==================
|
||||
|
||||
* deps: ipaddr.js@1.0.4
|
||||
- Fix accepting some invalid IPv6 addresses
|
||||
- Reject CIDRs with negative or overlong masks
|
||||
* perf: enable strict mode
|
||||
|
||||
1.0.8 / 2015-05-10
|
||||
==================
|
||||
|
||||
* deps: ipaddr.js@1.0.1
|
||||
|
||||
1.0.7 / 2015-03-16
|
||||
==================
|
||||
|
||||
* deps: ipaddr.js@0.1.9
|
||||
- Fix OOM on certain inputs to `isValid`
|
||||
|
||||
1.0.6 / 2015-02-01
|
||||
==================
|
||||
|
||||
* deps: ipaddr.js@0.1.8
|
||||
|
||||
1.0.5 / 2015-01-08
|
||||
==================
|
||||
|
||||
* deps: ipaddr.js@0.1.6
|
||||
|
||||
1.0.4 / 2014-11-23
|
||||
==================
|
||||
|
||||
* deps: ipaddr.js@0.1.5
|
||||
- Fix edge cases with `isValid`
|
||||
|
||||
1.0.3 / 2014-09-21
|
||||
==================
|
||||
|
||||
* Use `forwarded` npm module
|
||||
|
||||
1.0.2 / 2014-09-18
|
||||
==================
|
||||
|
||||
* Fix a global leak when multiple subnets are trusted
|
||||
* Support Node.js 0.6
|
||||
* deps: ipaddr.js@0.1.3
|
||||
|
||||
1.0.1 / 2014-06-03
|
||||
==================
|
||||
|
||||
* Fix links in npm package
|
||||
|
||||
1.0.0 / 2014-05-08
|
||||
==================
|
||||
|
||||
* Add `trust` argument to determine proxy trust on
|
||||
* Accepts custom function
|
||||
* Accepts IPv4/IPv6 address(es)
|
||||
* Accepts subnets
|
||||
* Accepts pre-defined names
|
||||
* Add optional `trust` argument to `proxyaddr.all` to
|
||||
stop at first untrusted
|
||||
* Add `proxyaddr.compile` to pre-compile `trust` function
|
||||
to make subsequent calls faster
|
||||
|
||||
0.0.1 / 2014-05-04
|
||||
==================
|
||||
|
||||
* Fix bad npm publish
|
||||
|
||||
0.0.0 / 2014-05-04
|
||||
==================
|
||||
|
||||
* Initial release
|
22
node_modules/proxy-addr/LICENSE
generated
vendored
Normal file
22
node_modules/proxy-addr/LICENSE
generated
vendored
Normal file
@@ -0,0 +1,22 @@
|
||||
(The MIT License)
|
||||
|
||||
Copyright (c) 2014-2016 Douglas Christopher Wilson
|
||||
|
||||
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.
|
139
node_modules/proxy-addr/README.md
generated
vendored
Normal file
139
node_modules/proxy-addr/README.md
generated
vendored
Normal file
@@ -0,0 +1,139 @@
|
||||
# proxy-addr
|
||||
|
||||
[![NPM Version][npm-version-image]][npm-url]
|
||||
[![NPM Downloads][npm-downloads-image]][npm-url]
|
||||
[![Node.js Version][node-image]][node-url]
|
||||
[![Build Status][ci-image]][ci-url]
|
||||
[![Test Coverage][coveralls-image]][coveralls-url]
|
||||
|
||||
Determine address of proxied request
|
||||
|
||||
## Install
|
||||
|
||||
This is a [Node.js](https://nodejs.org/en/) module available through the
|
||||
[npm registry](https://www.npmjs.com/). Installation is done using the
|
||||
[`npm install` command](https://docs.npmjs.com/getting-started/installing-npm-packages-locally):
|
||||
|
||||
```sh
|
||||
$ npm install proxy-addr
|
||||
```
|
||||
|
||||
## API
|
||||
|
||||
```js
|
||||
var proxyaddr = require('proxy-addr')
|
||||
```
|
||||
|
||||
### proxyaddr(req, trust)
|
||||
|
||||
Return the address of the request, using the given `trust` parameter.
|
||||
|
||||
The `trust` argument is a function that returns `true` if you trust
|
||||
the address, `false` if you don't. The closest untrusted address is
|
||||
returned.
|
||||
|
||||
```js
|
||||
proxyaddr(req, function (addr) { return addr === '127.0.0.1' })
|
||||
proxyaddr(req, function (addr, i) { return i < 1 })
|
||||
```
|
||||
|
||||
The `trust` arugment may also be a single IP address string or an
|
||||
array of trusted addresses, as plain IP addresses, CIDR-formatted
|
||||
strings, or IP/netmask strings.
|
||||
|
||||
```js
|
||||
proxyaddr(req, '127.0.0.1')
|
||||
proxyaddr(req, ['127.0.0.0/8', '10.0.0.0/8'])
|
||||
proxyaddr(req, ['127.0.0.0/255.0.0.0', '192.168.0.0/255.255.0.0'])
|
||||
```
|
||||
|
||||
This module also supports IPv6. Your IPv6 addresses will be normalized
|
||||
automatically (i.e. `fe80::00ed:1` equals `fe80:0:0:0:0:0:ed:1`).
|
||||
|
||||
```js
|
||||
proxyaddr(req, '::1')
|
||||
proxyaddr(req, ['::1/128', 'fe80::/10'])
|
||||
```
|
||||
|
||||
This module will automatically work with IPv4-mapped IPv6 addresses
|
||||
as well to support node.js in IPv6-only mode. This means that you do
|
||||
not have to specify both `::ffff:a00:1` and `10.0.0.1`.
|
||||
|
||||
As a convenience, this module also takes certain pre-defined names
|
||||
in addition to IP addresses, which expand into IP addresses:
|
||||
|
||||
```js
|
||||
proxyaddr(req, 'loopback')
|
||||
proxyaddr(req, ['loopback', 'fc00:ac:1ab5:fff::1/64'])
|
||||
```
|
||||
|
||||
* `loopback`: IPv4 and IPv6 loopback addresses (like `::1` and
|
||||
`127.0.0.1`).
|
||||
* `linklocal`: IPv4 and IPv6 link-local addresses (like
|
||||
`fe80::1:1:1:1` and `169.254.0.1`).
|
||||
* `uniquelocal`: IPv4 private addresses and IPv6 unique-local
|
||||
addresses (like `fc00:ac:1ab5:fff::1` and `192.168.0.1`).
|
||||
|
||||
When `trust` is specified as a function, it will be called for each
|
||||
address to determine if it is a trusted address. The function is
|
||||
given two arguments: `addr` and `i`, where `addr` is a string of
|
||||
the address to check and `i` is a number that represents the distance
|
||||
from the socket address.
|
||||
|
||||
### proxyaddr.all(req, [trust])
|
||||
|
||||
Return all the addresses of the request, optionally stopping at the
|
||||
first untrusted. This array is ordered from closest to furthest
|
||||
(i.e. `arr[0] === req.connection.remoteAddress`).
|
||||
|
||||
```js
|
||||
proxyaddr.all(req)
|
||||
```
|
||||
|
||||
The optional `trust` argument takes the same arguments as `trust`
|
||||
does in `proxyaddr(req, trust)`.
|
||||
|
||||
```js
|
||||
proxyaddr.all(req, 'loopback')
|
||||
```
|
||||
|
||||
### proxyaddr.compile(val)
|
||||
|
||||
Compiles argument `val` into a `trust` function. This function takes
|
||||
the same arguments as `trust` does in `proxyaddr(req, trust)` and
|
||||
returns a function suitable for `proxyaddr(req, trust)`.
|
||||
|
||||
```js
|
||||
var trust = proxyaddr.compile('loopback')
|
||||
var addr = proxyaddr(req, trust)
|
||||
```
|
||||
|
||||
This function is meant to be optimized for use against every request.
|
||||
It is recommend to compile a trust function up-front for the trusted
|
||||
configuration and pass that to `proxyaddr(req, trust)` for each request.
|
||||
|
||||
## Testing
|
||||
|
||||
```sh
|
||||
$ npm test
|
||||
```
|
||||
|
||||
## Benchmarks
|
||||
|
||||
```sh
|
||||
$ npm run-script bench
|
||||
```
|
||||
|
||||
## License
|
||||
|
||||
[MIT](LICENSE)
|
||||
|
||||
[ci-image]: https://badgen.net/github/checks/jshttp/proxy-addr/master?label=ci
|
||||
[ci-url]: https://github.com/jshttp/proxy-addr/actions?query=workflow%3Aci
|
||||
[coveralls-image]: https://badgen.net/coveralls/c/github/jshttp/proxy-addr/master
|
||||
[coveralls-url]: https://coveralls.io/r/jshttp/proxy-addr?branch=master
|
||||
[node-image]: https://badgen.net/npm/node/proxy-addr
|
||||
[node-url]: https://nodejs.org/en/download
|
||||
[npm-downloads-image]: https://badgen.net/npm/dm/proxy-addr
|
||||
[npm-url]: https://npmjs.org/package/proxy-addr
|
||||
[npm-version-image]: https://badgen.net/npm/v/proxy-addr
|
327
node_modules/proxy-addr/index.js
generated
vendored
Normal file
327
node_modules/proxy-addr/index.js
generated
vendored
Normal file
@@ -0,0 +1,327 @@
|
||||
/*!
|
||||
* proxy-addr
|
||||
* Copyright(c) 2014-2016 Douglas Christopher Wilson
|
||||
* MIT Licensed
|
||||
*/
|
||||
|
||||
'use strict'
|
||||
|
||||
/**
|
||||
* Module exports.
|
||||
* @public
|
||||
*/
|
||||
|
||||
module.exports = proxyaddr
|
||||
module.exports.all = alladdrs
|
||||
module.exports.compile = compile
|
||||
|
||||
/**
|
||||
* Module dependencies.
|
||||
* @private
|
||||
*/
|
||||
|
||||
var forwarded = require('forwarded')
|
||||
var ipaddr = require('ipaddr.js')
|
||||
|
||||
/**
|
||||
* Variables.
|
||||
* @private
|
||||
*/
|
||||
|
||||
var DIGIT_REGEXP = /^[0-9]+$/
|
||||
var isip = ipaddr.isValid
|
||||
var parseip = ipaddr.parse
|
||||
|
||||
/**
|
||||
* Pre-defined IP ranges.
|
||||
* @private
|
||||
*/
|
||||
|
||||
var IP_RANGES = {
|
||||
linklocal: ['169.254.0.0/16', 'fe80::/10'],
|
||||
loopback: ['127.0.0.1/8', '::1/128'],
|
||||
uniquelocal: ['10.0.0.0/8', '172.16.0.0/12', '192.168.0.0/16', 'fc00::/7']
|
||||
}
|
||||
|
||||
/**
|
||||
* Get all addresses in the request, optionally stopping
|
||||
* at the first untrusted.
|
||||
*
|
||||
* @param {Object} request
|
||||
* @param {Function|Array|String} [trust]
|
||||
* @public
|
||||
*/
|
||||
|
||||
function alladdrs (req, trust) {
|
||||
// get addresses
|
||||
var addrs = forwarded(req)
|
||||
|
||||
if (!trust) {
|
||||
// Return all addresses
|
||||
return addrs
|
||||
}
|
||||
|
||||
if (typeof trust !== 'function') {
|
||||
trust = compile(trust)
|
||||
}
|
||||
|
||||
for (var i = 0; i < addrs.length - 1; i++) {
|
||||
if (trust(addrs[i], i)) continue
|
||||
|
||||
addrs.length = i + 1
|
||||
}
|
||||
|
||||
return addrs
|
||||
}
|
||||
|
||||
/**
|
||||
* Compile argument into trust function.
|
||||
*
|
||||
* @param {Array|String} val
|
||||
* @private
|
||||
*/
|
||||
|
||||
function compile (val) {
|
||||
if (!val) {
|
||||
throw new TypeError('argument is required')
|
||||
}
|
||||
|
||||
var trust
|
||||
|
||||
if (typeof val === 'string') {
|
||||
trust = [val]
|
||||
} else if (Array.isArray(val)) {
|
||||
trust = val.slice()
|
||||
} else {
|
||||
throw new TypeError('unsupported trust argument')
|
||||
}
|
||||
|
||||
for (var i = 0; i < trust.length; i++) {
|
||||
val = trust[i]
|
||||
|
||||
if (!Object.prototype.hasOwnProperty.call(IP_RANGES, val)) {
|
||||
continue
|
||||
}
|
||||
|
||||
// Splice in pre-defined range
|
||||
val = IP_RANGES[val]
|
||||
trust.splice.apply(trust, [i, 1].concat(val))
|
||||
i += val.length - 1
|
||||
}
|
||||
|
||||
return compileTrust(compileRangeSubnets(trust))
|
||||
}
|
||||
|
||||
/**
|
||||
* Compile `arr` elements into range subnets.
|
||||
*
|
||||
* @param {Array} arr
|
||||
* @private
|
||||
*/
|
||||
|
||||
function compileRangeSubnets (arr) {
|
||||
var rangeSubnets = new Array(arr.length)
|
||||
|
||||
for (var i = 0; i < arr.length; i++) {
|
||||
rangeSubnets[i] = parseipNotation(arr[i])
|
||||
}
|
||||
|
||||
return rangeSubnets
|
||||
}
|
||||
|
||||
/**
|
||||
* Compile range subnet array into trust function.
|
||||
*
|
||||
* @param {Array} rangeSubnets
|
||||
* @private
|
||||
*/
|
||||
|
||||
function compileTrust (rangeSubnets) {
|
||||
// Return optimized function based on length
|
||||
var len = rangeSubnets.length
|
||||
return len === 0
|
||||
? trustNone
|
||||
: len === 1
|
||||
? trustSingle(rangeSubnets[0])
|
||||
: trustMulti(rangeSubnets)
|
||||
}
|
||||
|
||||
/**
|
||||
* Parse IP notation string into range subnet.
|
||||
*
|
||||
* @param {String} note
|
||||
* @private
|
||||
*/
|
||||
|
||||
function parseipNotation (note) {
|
||||
var pos = note.lastIndexOf('/')
|
||||
var str = pos !== -1
|
||||
? note.substring(0, pos)
|
||||
: note
|
||||
|
||||
if (!isip(str)) {
|
||||
throw new TypeError('invalid IP address: ' + str)
|
||||
}
|
||||
|
||||
var ip = parseip(str)
|
||||
|
||||
if (pos === -1 && ip.kind() === 'ipv6' && ip.isIPv4MappedAddress()) {
|
||||
// Store as IPv4
|
||||
ip = ip.toIPv4Address()
|
||||
}
|
||||
|
||||
var max = ip.kind() === 'ipv6'
|
||||
? 128
|
||||
: 32
|
||||
|
||||
var range = pos !== -1
|
||||
? note.substring(pos + 1, note.length)
|
||||
: null
|
||||
|
||||
if (range === null) {
|
||||
range = max
|
||||
} else if (DIGIT_REGEXP.test(range)) {
|
||||
range = parseInt(range, 10)
|
||||
} else if (ip.kind() === 'ipv4' && isip(range)) {
|
||||
range = parseNetmask(range)
|
||||
} else {
|
||||
range = null
|
||||
}
|
||||
|
||||
if (range <= 0 || range > max) {
|
||||
throw new TypeError('invalid range on address: ' + note)
|
||||
}
|
||||
|
||||
return [ip, range]
|
||||
}
|
||||
|
||||
/**
|
||||
* Parse netmask string into CIDR range.
|
||||
*
|
||||
* @param {String} netmask
|
||||
* @private
|
||||
*/
|
||||
|
||||
function parseNetmask (netmask) {
|
||||
var ip = parseip(netmask)
|
||||
var kind = ip.kind()
|
||||
|
||||
return kind === 'ipv4'
|
||||
? ip.prefixLengthFromSubnetMask()
|
||||
: null
|
||||
}
|
||||
|
||||
/**
|
||||
* Determine address of proxied request.
|
||||
*
|
||||
* @param {Object} request
|
||||
* @param {Function|Array|String} trust
|
||||
* @public
|
||||
*/
|
||||
|
||||
function proxyaddr (req, trust) {
|
||||
if (!req) {
|
||||
throw new TypeError('req argument is required')
|
||||
}
|
||||
|
||||
if (!trust) {
|
||||
throw new TypeError('trust argument is required')
|
||||
}
|
||||
|
||||
var addrs = alladdrs(req, trust)
|
||||
var addr = addrs[addrs.length - 1]
|
||||
|
||||
return addr
|
||||
}
|
||||
|
||||
/**
|
||||
* Static trust function to trust nothing.
|
||||
*
|
||||
* @private
|
||||
*/
|
||||
|
||||
function trustNone () {
|
||||
return false
|
||||
}
|
||||
|
||||
/**
|
||||
* Compile trust function for multiple subnets.
|
||||
*
|
||||
* @param {Array} subnets
|
||||
* @private
|
||||
*/
|
||||
|
||||
function trustMulti (subnets) {
|
||||
return function trust (addr) {
|
||||
if (!isip(addr)) return false
|
||||
|
||||
var ip = parseip(addr)
|
||||
var ipconv
|
||||
var kind = ip.kind()
|
||||
|
||||
for (var i = 0; i < subnets.length; i++) {
|
||||
var subnet = subnets[i]
|
||||
var subnetip = subnet[0]
|
||||
var subnetkind = subnetip.kind()
|
||||
var subnetrange = subnet[1]
|
||||
var trusted = ip
|
||||
|
||||
if (kind !== subnetkind) {
|
||||
if (subnetkind === 'ipv4' && !ip.isIPv4MappedAddress()) {
|
||||
// Incompatible IP addresses
|
||||
continue
|
||||
}
|
||||
|
||||
if (!ipconv) {
|
||||
// Convert IP to match subnet IP kind
|
||||
ipconv = subnetkind === 'ipv4'
|
||||
? ip.toIPv4Address()
|
||||
: ip.toIPv4MappedAddress()
|
||||
}
|
||||
|
||||
trusted = ipconv
|
||||
}
|
||||
|
||||
if (trusted.match(subnetip, subnetrange)) {
|
||||
return true
|
||||
}
|
||||
}
|
||||
|
||||
return false
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Compile trust function for single subnet.
|
||||
*
|
||||
* @param {Object} subnet
|
||||
* @private
|
||||
*/
|
||||
|
||||
function trustSingle (subnet) {
|
||||
var subnetip = subnet[0]
|
||||
var subnetkind = subnetip.kind()
|
||||
var subnetisipv4 = subnetkind === 'ipv4'
|
||||
var subnetrange = subnet[1]
|
||||
|
||||
return function trust (addr) {
|
||||
if (!isip(addr)) return false
|
||||
|
||||
var ip = parseip(addr)
|
||||
var kind = ip.kind()
|
||||
|
||||
if (kind !== subnetkind) {
|
||||
if (subnetisipv4 && !ip.isIPv4MappedAddress()) {
|
||||
// Incompatible IP addresses
|
||||
return false
|
||||
}
|
||||
|
||||
// Convert IP to match subnet IP kind
|
||||
ip = subnetisipv4
|
||||
? ip.toIPv4Address()
|
||||
: ip.toIPv4MappedAddress()
|
||||
}
|
||||
|
||||
return ip.match(subnetip, subnetrange)
|
||||
}
|
||||
}
|
19
node_modules/proxy-addr/node_modules/ipaddr.js/LICENSE
generated
vendored
Normal file
19
node_modules/proxy-addr/node_modules/ipaddr.js/LICENSE
generated
vendored
Normal file
@@ -0,0 +1,19 @@
|
||||
Copyright (C) 2011-2017 whitequark <whitequark@whitequark.org>
|
||||
|
||||
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.
|
233
node_modules/proxy-addr/node_modules/ipaddr.js/README.md
generated
vendored
Normal file
233
node_modules/proxy-addr/node_modules/ipaddr.js/README.md
generated
vendored
Normal file
@@ -0,0 +1,233 @@
|
||||
# ipaddr.js — an IPv6 and IPv4 address manipulation library [](https://travis-ci.org/whitequark/ipaddr.js)
|
||||
|
||||
ipaddr.js is a small (1.9K minified and gzipped) library for manipulating
|
||||
IP addresses in JavaScript environments. It runs on both CommonJS runtimes
|
||||
(e.g. [nodejs]) and in a web browser.
|
||||
|
||||
ipaddr.js allows you to verify and parse string representation of an IP
|
||||
address, match it against a CIDR range or range list, determine if it falls
|
||||
into some reserved ranges (examples include loopback and private ranges),
|
||||
and convert between IPv4 and IPv4-mapped IPv6 addresses.
|
||||
|
||||
[nodejs]: http://nodejs.org
|
||||
|
||||
## Installation
|
||||
|
||||
`npm install ipaddr.js`
|
||||
|
||||
or
|
||||
|
||||
`bower install ipaddr.js`
|
||||
|
||||
## API
|
||||
|
||||
ipaddr.js defines one object in the global scope: `ipaddr`. In CommonJS,
|
||||
it is exported from the module:
|
||||
|
||||
```js
|
||||
var ipaddr = require('ipaddr.js');
|
||||
```
|
||||
|
||||
The API consists of several global methods and two classes: ipaddr.IPv6 and ipaddr.IPv4.
|
||||
|
||||
### Global methods
|
||||
|
||||
There are three global methods defined: `ipaddr.isValid`, `ipaddr.parse` and
|
||||
`ipaddr.process`. All of them receive a string as a single parameter.
|
||||
|
||||
The `ipaddr.isValid` method returns `true` if the address is a valid IPv4 or
|
||||
IPv6 address, and `false` otherwise. It does not throw any exceptions.
|
||||
|
||||
The `ipaddr.parse` method returns an object representing the IP address,
|
||||
or throws an `Error` if the passed string is not a valid representation of an
|
||||
IP address.
|
||||
|
||||
The `ipaddr.process` method works just like the `ipaddr.parse` one, but it
|
||||
automatically converts IPv4-mapped IPv6 addresses to their IPv4 counterparts
|
||||
before returning. It is useful when you have a Node.js instance listening
|
||||
on an IPv6 socket, and the `net.ivp6.bindv6only` sysctl parameter (or its
|
||||
equivalent on non-Linux OS) is set to 0. In this case, you can accept IPv4
|
||||
connections on your IPv6-only socket, but the remote address will be mangled.
|
||||
Use `ipaddr.process` method to automatically demangle it.
|
||||
|
||||
### Object representation
|
||||
|
||||
Parsing methods return an object which descends from `ipaddr.IPv6` or
|
||||
`ipaddr.IPv4`. These objects share some properties, but most of them differ.
|
||||
|
||||
#### Shared properties
|
||||
|
||||
One can determine the type of address by calling `addr.kind()`. It will return
|
||||
either `"ipv6"` or `"ipv4"`.
|
||||
|
||||
An address can be converted back to its string representation with `addr.toString()`.
|
||||
Note that this method:
|
||||
* does not return the original string used to create the object (in fact, there is
|
||||
no way of getting that string)
|
||||
* returns a compact representation (when it is applicable)
|
||||
|
||||
A `match(range, bits)` method can be used to check if the address falls into a
|
||||
certain CIDR range.
|
||||
Note that an address can be (obviously) matched only against an address of the same type.
|
||||
|
||||
For example:
|
||||
|
||||
```js
|
||||
var addr = ipaddr.parse("2001:db8:1234::1");
|
||||
var range = ipaddr.parse("2001:db8::");
|
||||
|
||||
addr.match(range, 32); // => true
|
||||
```
|
||||
|
||||
Alternatively, `match` can also be called as `match([range, bits])`. In this way,
|
||||
it can be used together with the `parseCIDR(string)` method, which parses an IP
|
||||
address together with a CIDR range.
|
||||
|
||||
For example:
|
||||
|
||||
```js
|
||||
var addr = ipaddr.parse("2001:db8:1234::1");
|
||||
|
||||
addr.match(ipaddr.parseCIDR("2001:db8::/32")); // => true
|
||||
```
|
||||
|
||||
A `range()` method returns one of predefined names for several special ranges defined
|
||||
by IP protocols. The exact names (and their respective CIDR ranges) can be looked up
|
||||
in the source: [IPv6 ranges] and [IPv4 ranges]. Some common ones include `"unicast"`
|
||||
(the default one) and `"reserved"`.
|
||||
|
||||
You can match against your own range list by using
|
||||
`ipaddr.subnetMatch(address, rangeList, defaultName)` method. It can work with a mix of IPv6 or IPv4 addresses, and accepts a name-to-subnet map as the range list. For example:
|
||||
|
||||
```js
|
||||
var rangeList = {
|
||||
documentationOnly: [ ipaddr.parse('2001:db8::'), 32 ],
|
||||
tunnelProviders: [
|
||||
[ ipaddr.parse('2001:470::'), 32 ], // he.net
|
||||
[ ipaddr.parse('2001:5c0::'), 32 ] // freenet6
|
||||
]
|
||||
};
|
||||
ipaddr.subnetMatch(ipaddr.parse('2001:470:8:66::1'), rangeList, 'unknown'); // => "tunnelProviders"
|
||||
```
|
||||
|
||||
The addresses can be converted to their byte representation with `toByteArray()`.
|
||||
(Actually, JavaScript mostly does not know about byte buffers. They are emulated with
|
||||
arrays of numbers, each in range of 0..255.)
|
||||
|
||||
```js
|
||||
var bytes = ipaddr.parse('2a00:1450:8007::68').toByteArray(); // ipv6.google.com
|
||||
bytes // => [42, 0x00, 0x14, 0x50, 0x80, 0x07, 0x00, <zeroes...>, 0x00, 0x68 ]
|
||||
```
|
||||
|
||||
The `ipaddr.IPv4` and `ipaddr.IPv6` objects have some methods defined, too. All of them
|
||||
have the same interface for both protocols, and are similar to global methods.
|
||||
|
||||
`ipaddr.IPvX.isValid(string)` can be used to check if the string is a valid address
|
||||
for particular protocol, and `ipaddr.IPvX.parse(string)` is the error-throwing parser.
|
||||
|
||||
`ipaddr.IPvX.isValid(string)` uses the same format for parsing as the POSIX `inet_ntoa` function, which accepts unusual formats like `0xc0.168.1.1` or `0x10000000`. The function `ipaddr.IPv4.isValidFourPartDecimal(string)` validates the IPv4 address and also ensures that it is written in four-part decimal format.
|
||||
|
||||
[IPv6 ranges]: https://github.com/whitequark/ipaddr.js/blob/master/src/ipaddr.coffee#L186
|
||||
[IPv4 ranges]: https://github.com/whitequark/ipaddr.js/blob/master/src/ipaddr.coffee#L71
|
||||
|
||||
#### IPv6 properties
|
||||
|
||||
Sometimes you will want to convert IPv6 not to a compact string representation (with
|
||||
the `::` substitution); the `toNormalizedString()` method will return an address where
|
||||
all zeroes are explicit.
|
||||
|
||||
For example:
|
||||
|
||||
```js
|
||||
var addr = ipaddr.parse("2001:0db8::0001");
|
||||
addr.toString(); // => "2001:db8::1"
|
||||
addr.toNormalizedString(); // => "2001:db8:0:0:0:0:0:1"
|
||||
```
|
||||
|
||||
The `isIPv4MappedAddress()` method will return `true` if this address is an IPv4-mapped
|
||||
one, and `toIPv4Address()` will return an IPv4 object address.
|
||||
|
||||
To access the underlying binary representation of the address, use `addr.parts`.
|
||||
|
||||
```js
|
||||
var addr = ipaddr.parse("2001:db8:10::1234:DEAD");
|
||||
addr.parts // => [0x2001, 0xdb8, 0x10, 0, 0, 0, 0x1234, 0xdead]
|
||||
```
|
||||
|
||||
A IPv6 zone index can be accessed via `addr.zoneId`:
|
||||
|
||||
```js
|
||||
var addr = ipaddr.parse("2001:db8::%eth0");
|
||||
addr.zoneId // => 'eth0'
|
||||
```
|
||||
|
||||
#### IPv4 properties
|
||||
|
||||
`toIPv4MappedAddress()` will return a corresponding IPv4-mapped IPv6 address.
|
||||
|
||||
To access the underlying representation of the address, use `addr.octets`.
|
||||
|
||||
```js
|
||||
var addr = ipaddr.parse("192.168.1.1");
|
||||
addr.octets // => [192, 168, 1, 1]
|
||||
```
|
||||
|
||||
`prefixLengthFromSubnetMask()` will return a CIDR prefix length for a valid IPv4 netmask or
|
||||
null if the netmask is not valid.
|
||||
|
||||
```js
|
||||
ipaddr.IPv4.parse('255.255.255.240').prefixLengthFromSubnetMask() == 28
|
||||
ipaddr.IPv4.parse('255.192.164.0').prefixLengthFromSubnetMask() == null
|
||||
```
|
||||
|
||||
`subnetMaskFromPrefixLength()` will return an IPv4 netmask for a valid CIDR prefix length.
|
||||
|
||||
```js
|
||||
ipaddr.IPv4.subnetMaskFromPrefixLength(24) == "255.255.255.0"
|
||||
ipaddr.IPv4.subnetMaskFromPrefixLength(29) == "255.255.255.248"
|
||||
```
|
||||
|
||||
`broadcastAddressFromCIDR()` will return the broadcast address for a given IPv4 interface and netmask in CIDR notation.
|
||||
```js
|
||||
ipaddr.IPv4.broadcastAddressFromCIDR("172.0.0.1/24") == "172.0.0.255"
|
||||
```
|
||||
`networkAddressFromCIDR()` will return the network address for a given IPv4 interface and netmask in CIDR notation.
|
||||
```js
|
||||
ipaddr.IPv4.networkAddressFromCIDR("172.0.0.1/24") == "172.0.0.0"
|
||||
```
|
||||
|
||||
#### Conversion
|
||||
|
||||
IPv4 and IPv6 can be converted bidirectionally to and from network byte order (MSB) byte arrays.
|
||||
|
||||
The `fromByteArray()` method will take an array and create an appropriate IPv4 or IPv6 object
|
||||
if the input satisfies the requirements. For IPv4 it has to be an array of four 8-bit values,
|
||||
while for IPv6 it has to be an array of sixteen 8-bit values.
|
||||
|
||||
For example:
|
||||
```js
|
||||
var addr = ipaddr.fromByteArray([0x7f, 0, 0, 1]);
|
||||
addr.toString(); // => "127.0.0.1"
|
||||
```
|
||||
|
||||
or
|
||||
|
||||
```js
|
||||
var addr = ipaddr.fromByteArray([0x20, 1, 0xd, 0xb8, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 1])
|
||||
addr.toString(); // => "2001:db8::1"
|
||||
```
|
||||
|
||||
Both objects also offer a `toByteArray()` method, which returns an array in network byte order (MSB).
|
||||
|
||||
For example:
|
||||
```js
|
||||
var addr = ipaddr.parse("127.0.0.1");
|
||||
addr.toByteArray(); // => [0x7f, 0, 0, 1]
|
||||
```
|
||||
|
||||
or
|
||||
|
||||
```js
|
||||
var addr = ipaddr.parse("2001:db8::1");
|
||||
addr.toByteArray(); // => [0x20, 1, 0xd, 0xb8, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 1]
|
||||
```
|
1
node_modules/proxy-addr/node_modules/ipaddr.js/ipaddr.min.js
generated
vendored
Normal file
1
node_modules/proxy-addr/node_modules/ipaddr.js/ipaddr.min.js
generated
vendored
Normal file
File diff suppressed because one or more lines are too long
673
node_modules/proxy-addr/node_modules/ipaddr.js/lib/ipaddr.js
generated
vendored
Normal file
673
node_modules/proxy-addr/node_modules/ipaddr.js/lib/ipaddr.js
generated
vendored
Normal file
File diff suppressed because it is too large
Load Diff
68
node_modules/proxy-addr/node_modules/ipaddr.js/lib/ipaddr.js.d.ts
generated
vendored
Normal file
68
node_modules/proxy-addr/node_modules/ipaddr.js/lib/ipaddr.js.d.ts
generated
vendored
Normal file
@@ -0,0 +1,68 @@
|
||||
declare module "ipaddr.js" {
|
||||
type IPv4Range = 'unicast' | 'unspecified' | 'broadcast' | 'multicast' | 'linkLocal' | 'loopback' | 'carrierGradeNat' | 'private' | 'reserved';
|
||||
type IPv6Range = 'unicast' | 'unspecified' | 'linkLocal' | 'multicast' | 'loopback' | 'uniqueLocal' | 'ipv4Mapped' | 'rfc6145' | 'rfc6052' | '6to4' | 'teredo' | 'reserved';
|
||||
|
||||
interface RangeList<T> {
|
||||
[name: string]: [T, number] | [T, number][];
|
||||
}
|
||||
|
||||
// Common methods/properties for IPv4 and IPv6 classes.
|
||||
class IP {
|
||||
prefixLengthFromSubnetMask(): number | null;
|
||||
toByteArray(): number[];
|
||||
toNormalizedString(): string;
|
||||
toString(): string;
|
||||
}
|
||||
|
||||
namespace Address {
|
||||
export function isValid(addr: string): boolean;
|
||||
export function fromByteArray(bytes: number[]): IPv4 | IPv6;
|
||||
export function parse(addr: string): IPv4 | IPv6;
|
||||
export function parseCIDR(mask: string): [IPv4 | IPv6, number];
|
||||
export function process(addr: string): IPv4 | IPv6;
|
||||
export function subnetMatch(addr: IPv4, rangeList: RangeList<IPv4>, defaultName?: string): string;
|
||||
export function subnetMatch(addr: IPv6, rangeList: RangeList<IPv6>, defaultName?: string): string;
|
||||
|
||||
export class IPv4 extends IP {
|
||||
static broadcastAddressFromCIDR(addr: string): IPv4;
|
||||
static isIPv4(addr: string): boolean;
|
||||
static isValidFourPartDecimal(addr: string): boolean;
|
||||
static isValid(addr: string): boolean;
|
||||
static networkAddressFromCIDR(addr: string): IPv4;
|
||||
static parse(addr: string): IPv4;
|
||||
static parseCIDR(addr: string): [IPv4, number];
|
||||
static subnetMaskFromPrefixLength(prefix: number): IPv4;
|
||||
constructor(octets: number[]);
|
||||
octets: number[]
|
||||
|
||||
kind(): 'ipv4';
|
||||
match(addr: IPv4, bits: number): boolean;
|
||||
match(mask: [IPv4, number]): boolean;
|
||||
range(): IPv4Range;
|
||||
subnetMatch(rangeList: RangeList<IPv4>, defaultName?: string): string;
|
||||
toIPv4MappedAddress(): IPv6;
|
||||
}
|
||||
|
||||
export class IPv6 extends IP {
|
||||
static broadcastAddressFromCIDR(addr: string): IPv6;
|
||||
static isIPv6(addr: string): boolean;
|
||||
static isValid(addr: string): boolean;
|
||||
static parse(addr: string): IPv6;
|
||||
static parseCIDR(addr: string): [IPv6, number];
|
||||
static subnetMaskFromPrefixLength(prefix: number): IPv6;
|
||||
constructor(parts: number[]);
|
||||
parts: number[]
|
||||
zoneId?: string
|
||||
|
||||
isIPv4MappedAddress(): boolean;
|
||||
kind(): 'ipv6';
|
||||
match(addr: IPv6, bits: number): boolean;
|
||||
match(mask: [IPv6, number]): boolean;
|
||||
range(): IPv6Range;
|
||||
subnetMatch(rangeList: RangeList<IPv6>, defaultName?: string): string;
|
||||
toIPv4Address(): IPv4;
|
||||
}
|
||||
}
|
||||
|
||||
export = Address;
|
||||
}
|
35
node_modules/proxy-addr/node_modules/ipaddr.js/package.json
generated
vendored
Normal file
35
node_modules/proxy-addr/node_modules/ipaddr.js/package.json
generated
vendored
Normal file
@@ -0,0 +1,35 @@
|
||||
{
|
||||
"name": "ipaddr.js",
|
||||
"description": "A library for manipulating IPv4 and IPv6 addresses in JavaScript.",
|
||||
"version": "1.9.1",
|
||||
"author": "whitequark <whitequark@whitequark.org>",
|
||||
"directories": {
|
||||
"lib": "./lib"
|
||||
},
|
||||
"dependencies": {},
|
||||
"devDependencies": {
|
||||
"coffee-script": "~1.12.6",
|
||||
"nodeunit": "^0.11.3",
|
||||
"uglify-js": "~3.0.19"
|
||||
},
|
||||
"scripts": {
|
||||
"test": "cake build test"
|
||||
},
|
||||
"files": [
|
||||
"lib/",
|
||||
"LICENSE",
|
||||
"ipaddr.min.js"
|
||||
],
|
||||
"keywords": [
|
||||
"ip",
|
||||
"ipv4",
|
||||
"ipv6"
|
||||
],
|
||||
"repository": "git://github.com/whitequark/ipaddr.js",
|
||||
"main": "./lib/ipaddr.js",
|
||||
"engines": {
|
||||
"node": ">= 0.10"
|
||||
},
|
||||
"license": "MIT",
|
||||
"types": "./lib/ipaddr.js.d.ts"
|
||||
}
|
47
node_modules/proxy-addr/package.json
generated
vendored
Normal file
47
node_modules/proxy-addr/package.json
generated
vendored
Normal file
@@ -0,0 +1,47 @@
|
||||
{
|
||||
"name": "proxy-addr",
|
||||
"description": "Determine address of proxied request",
|
||||
"version": "2.0.7",
|
||||
"author": "Douglas Christopher Wilson <doug@somethingdoug.com>",
|
||||
"license": "MIT",
|
||||
"keywords": [
|
||||
"ip",
|
||||
"proxy",
|
||||
"x-forwarded-for"
|
||||
],
|
||||
"repository": "jshttp/proxy-addr",
|
||||
"dependencies": {
|
||||
"forwarded": "0.2.0",
|
||||
"ipaddr.js": "1.9.1"
|
||||
},
|
||||
"devDependencies": {
|
||||
"benchmark": "2.1.4",
|
||||
"beautify-benchmark": "0.2.4",
|
||||
"deep-equal": "1.0.1",
|
||||
"eslint": "7.26.0",
|
||||
"eslint-config-standard": "14.1.1",
|
||||
"eslint-plugin-import": "2.23.4",
|
||||
"eslint-plugin-markdown": "2.2.0",
|
||||
"eslint-plugin-node": "11.1.0",
|
||||
"eslint-plugin-promise": "4.3.1",
|
||||
"eslint-plugin-standard": "4.1.0",
|
||||
"mocha": "8.4.0",
|
||||
"nyc": "15.1.0"
|
||||
},
|
||||
"files": [
|
||||
"LICENSE",
|
||||
"HISTORY.md",
|
||||
"README.md",
|
||||
"index.js"
|
||||
],
|
||||
"engines": {
|
||||
"node": ">= 0.10"
|
||||
},
|
||||
"scripts": {
|
||||
"bench": "node benchmark/index.js",
|
||||
"lint": "eslint .",
|
||||
"test": "mocha --reporter spec --bail --check-leaks test/",
|
||||
"test-ci": "nyc --reporter=lcov --reporter=text npm test",
|
||||
"test-cov": "nyc --reporter=html --reporter=text npm test"
|
||||
}
|
||||
}
|
Reference in New Issue
Block a user