Appearance
Foxnox
Foxnox is a password and account-security service. It keeps credentials, second factors, recovery tokens and trusted devices out of the rest of your system, and it serves the pages users need to recover or secure their account.
Foxnox is an internal password store. Put a Backend for Frontend in front of it as the public API layer. Gatelin is one such BFF, not a requirement.
Full documentation
foxnox.fr has the integration guide, the frontend guide and the API reference.
What it is used for
Use Foxnox when you want account security done once, correctly, and isolated:
- Password hashes, rotation dates, expiry and lockout state live in their own database, away from user profiles
- Two-factor authentication, recovery and trusted devices come ready to use
- Users get working, translated account pages without you building them
What it does
| Capability | Details |
|---|---|
| Credentials | Password hashes, rotation dates, expiry and lockout state |
| Authentication factors | TOTP 2FA enrollment and mid-login verification |
| Tokens | Short-lived typed tokens for reset, unlock, recovery and login challenges, stored as HMAC only |
| Trusted devices | Remember a browser for a limited time so 2FA is not prompted on every sign-in |
| Security questions | Recover an account when the authenticator is lost |
| Policies | Length and character rules used to generate and validate passwords |
| Account workflows | Server-rendered recovery, unlock, 2FA and device pages in English and French, white-label ready |
| Admin UI | Angular front end to manage passwords, policies, tokens and devices |
Where it fits
Foxnox never mints JWTs and never stores user profiles. Gatelin asks it to verify a password and to run the 2FA or expired-password steps of a sign-in. Megadex asks it to create a password when a user is created. Foxnox asks Megadex to resolve an email address to a user ID during recovery, unlock and 2FA recovery. See the reference architecture.
Run it
| Image | Registry |
|---|---|
| API, including the workflow pages and Admin UI | ghcr.io/alten-group/foxnox |
| Migration | ghcr.io/alten-group/foxnox-migration |