Skip to content

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 ​

CapabilityDetails
CredentialsPassword hashes, rotation dates, expiry and lockout state
Authentication factorsTOTP 2FA enrollment and mid-login verification
TokensShort-lived typed tokens for reset, unlock, recovery and login challenges, stored as HMAC only
Trusted devicesRemember a browser for a limited time so 2FA is not prompted on every sign-in
Security questionsRecover an account when the authenticator is lost
PoliciesLength and character rules used to generate and validate passwords
Account workflowsServer-rendered recovery, unlock, 2FA and device pages in English and French, white-label ready
Admin UIAngular 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 ​

ImageRegistry
API, including the workflow pages and Admin UIghcr.io/alten-group/foxnox
Migrationghcr.io/alten-group/foxnox-migration

Published and maintained by ALTEN