One call after the password check
const fms = FollowMeSecurity.fromKey(process.env.FMS_KEY);\n\nconst r = await fms.check(user.fmsLinkToken, req.socket.remoteAddress);\nif (r.linked && !r.allowed) return res.status(403).send('Login not allowed from this location.');The followmesecurity package has no dependencies, uses Node 18's built-in fetch and crypto, and ships with TypeScript types. check() never throws: if our service can't be reached within 3 seconds, it follows the outage setting you chose (deny by default).
Linking accounts
Add a "Link with Follow Me Security" route to your account settings: linkUrl() sends the user to approve, and exchange() turns the returned code into a token you store on the user. The README includes a complete Express example.
Why location, not just more factors
Phishing kits relay passwords and 2FA codes in real time, and credential-stuffing bots rotate through thousands of IPs. None of them come from your user's network. Users set their approved network with one press in the Follow Me phone app, and you can manage office and VPN IPs for everyone in one place.
How Follow Me Security works
- Your site links up. Install the WordPress plugin, add the PHP drop-in, or use our Node.js or Python package. Any other language can call the API. Users click "Link with Follow Me Security" in their account settings.
- Users press Follow Me. From their phone, wherever they are. That network becomes their approved place to sign in.
- Every login is checked. After the password is right, your site asks us if the IP is approved. If not, the login is refused, before your own 2FA even runs.
Always an extra layer: passwords and two-factor sign-in still apply. IPs are stored only as keyed one-way hashes.
Frequently asked questions
Which frameworks does it work with?
Any: Express, Fastify, Koa, NestJS, Next.js API routes. It's a plain async function.
Which IP should I pass?
The real connection address (req.socket.remoteAddress), or req.ip if you have set Express's trust proxy for your own load balancer.
Does it add latency to logins?
One small signed HTTPS call after the password is verified, with a 3-second timeout.