
Security News
npm Adopts OIDC for Trusted Publishing in CI/CD Workflows
npm now supports Trusted Publishing with OIDC, enabling secure package publishing directly from CI/CD workflows without relying on long-lived tokens.
Unofficial Node.js module for the Maxmind GeoIP2 Web Services.
The configuration parameters must be wrapped in an object.
This allows the use of spread { ...config, ip: '1.2.3.4' }
if you want to keep the main config in a variable.
The lookup always returns a Promise.
const geo = require( 'geoip2ws' );
geo( {
userId: '12345',
licenseKey: 'abc678',
service: 'city',
ip: '1.2.3.4',
} )
.then( console.log )
.catch( console.error )
;
You need a Maxmind account ID and license key with enough credits for one of their GeoIP web services. You can find both here.
npm i geoip2ws
parameter | type | default | description |
---|---|---|---|
userId | string | User ID | |
licenseKey | string | License key | |
[ip] | string | me | The IP address or 'me' for your current IP |
[service] | string | city | insights , country or city |
[endpoint] | string | https://geoip.maxmind.com | Override endpoint url, include the protocol prefix |
[timeout] | number | 5000 | Request timeout in ms |
{
ip: '2a02:abc:def::123',
userId: '1234',
licenseKey: 'abc',
service: 'country',
timeout: 2000,
}
You can change the endpoint
to use a http proxy or target a specific datacenter.
Make sure to prefix the hostname with the protocol, i.e. https://
.
For the GeoLite2 web service set the endpoint
to https://geolite.info
.
Errors from the request or API are thrown and can be caught in the Promise.
For API errors the message is prefixed with API:
string.
This is free and unencumbered software released into the public domain.
Anyone is free to copy, modify, publish, use, compile, sell, or distribute this software, either in source code form or as a compiled binary, for any purpose, commercial or non-commercial, and by any means.
In jurisdictions that recognize copyright laws, the author or authors of this software dedicate any and all copyright interest in the software to the public domain. We make this dedication for the benefit of the public at large and to the detriment of our heirs and successors. We intend this dedication to be an overt act of relinquishment in perpetuity of all present and future rights to this software under copyright law.
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 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.
For more information, please refer to https://unlicense.org/
FAQs
Maxmind GeoIP2 Web Services (unofficial) - IP and hostname geolocation
The npm package geoip2ws receives a total of 92,693 weekly downloads. As such, geoip2ws popularity was classified as popular.
We found that geoip2ws demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
npm now supports Trusted Publishing with OIDC, enabling secure package publishing directly from CI/CD workflows without relying on long-lived tokens.
Research
/Security News
A RubyGems malware campaign used 60 malicious packages posing as automation tools to steal credentials from social media and marketing tool users.
Security News
The CNA Scorecard ranks CVE issuers by data completeness, revealing major gaps in patch info and software identifiers across thousands of vulnerabilities.