Dead simple user account system so easy a caveman cow could do it.
The goal of Accownt is to be a full-featured, standalone account system that's straightforward for developers and users, easy to maintain, and as customizable as possible without introducing too much complexity.
Built and mantained by Ptorx and other Xyfir projects.
- Email + password login
- Passwordless login via links sent to emails also available
- Passwords are hashed with bcrypt
- Two-Factor Authentication (2FA)
- Authy, Google Authenticator, etc supported
- Email verification
- Plug in your SMTP credentials for Mailgun, Gmail, or anything else
- Account recovery
- Via passwordless login feature
- No dependencies other than Node and what npm will install
- Older Node versions not actively supported
- No database needed
- Users are simple JSON files stored to disk
- Standalone server and web client
- Easy integration into new and existing applications of any stack
- reCAPTCHA v2 support
- Optional, just set your reCAPTCHA key
- JSON Web Tokens (JWT)
- Shared JWT and cookie between Accownt and your app for session authentication
- Easy theming
- Thanks to Material-UI
As simple as Accownt is, you'll still need to install, configure, build, and integrate into your app. We've made it just about as easy as it could possibly be.
Note #1: If your system does not yet have Node installed, start with nvm (or nvm for Windows).
Note #2: You may alternatively download Accownt through npm (see here), however this is not currently the recommended installation method. In the future we'll likely have a CLI tool available through npm to make configuring, running, and managing Accownt instances easier.
git clone https://github.com/Xyfir/accownt.git
cd accownt/server
npm install
touch .env
Now open up accownt/server/.env
in your editor and fill out the values. See the Accownt.Env.Common
and Accownt.Env.Server
interfaces in types/accownt.d.ts for expected environment variables. Format is KEY=VALUE
(PORT=1234
, NAME="Accownt"
, etc).
npm run build
npm run start # or launch ./dist/app.js however you like
At this point the setup is based on your environment and what your needs are. Probably you'll run the server with pm2 and put Node behind Nginx or Apache.
cd ../web
npm install
touch .env
Now open up accownt/server/.env
in your editor and fill out the values. See the Accownt.Env.Common
and Accownt.Env.Web
interfaces in types/accownt.d.ts for expected environment variables.
npm run build
This part is largely up to you, so it's important to understand the flow of data between your app and Accownt:
- Your app sends users to Accownt's login/registration form either by user action or automatically through a forced redirection. All you need to do is get the user to Accownt, everything it needs to know is already in its config.
- Accownt will handle everything until there's a login, at which point it will redirect the user back to your app with the JWT in the URL based on your configuration. The same JWT will also be set as a cookie, so depending on your setup you may be able to and prefer to access this instead.
To be a bit more specific:
- Somewhere in your app you'll put login and/or registration links that point to the Accownt web client.
- If your app utilizes the JWT cookie that Accownt sets then all you need to do is verify the token with each request via jsonwebttoken or the equivalent in your preferred language.
- Once the JWT is verified and decoded, you can retrieve the
userId
andemail
properties from it to use however you need. Note thatuserId
is a unix timestamp in milliseconds (13 digits!) that corresponds to when the user created their account. Also keep in mind that if your app is receiving a JWT, the user's email has already been verified. - If the JWT is invalid or expired, redirect them back to the Accownt form or to unauthenticated parts of your app.
- Lastly, you'll need a route somewhere to catch redirections and tokens from Accownt after each successful login. You set this already in your config.
- Optionally, you can also add a link somewhere that takes authenticated users to Accownt so they can modify their account information, like their password or 2FA.