Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/aabbtree77/auth-starter-backend
Backend for a complete session-based user authentication: Bun, Hono, Drizzle, SQLite.
https://github.com/aabbtree77/auth-starter-backend
authentication authorization backend-api bun cookie cors credentials crud drizzle hono minimalism ngrok security session sqlite typescript user-password xss
Last synced: about 2 months ago
JSON representation
Backend for a complete session-based user authentication: Bun, Hono, Drizzle, SQLite.
- Host: GitHub
- URL: https://github.com/aabbtree77/auth-starter-backend
- Owner: aabbtree77
- License: mit
- Created: 2024-06-25T13:54:32.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2024-07-27T20:07:18.000Z (5 months ago)
- Last Synced: 2024-07-28T09:02:06.851Z (5 months ago)
- Topics: authentication, authorization, backend-api, bun, cookie, cors, credentials, crud, drizzle, hono, minimalism, ngrok, security, session, sqlite, typescript, user-password, xss
- Language: TypeScript
- Homepage:
- Size: 20.5 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
> "Sad thoughts come to me when I look in a bookcase full of biochemistry books. I realise that the bookcase will last much longer than the contents of the books in it." - Bolesław Skarżyński (1901-1963)
# Introduction
This is the backend part of a session-based user name and password authentication with a [frontend](https://github.com/aabbtree77/auth-starter-frontend).
The stack is Bun, SQLite via Drizzle, Hono, TypeScript.
Open three terminal windows:
Terminal 1:
```sh
bun install
bun run dev
```Terminal 2:
```sh
bun run db:generate
bun run db:push
bun run db:studio
```Terminal 3:
cd into the cloned frontend part and run TypeScript as documented in [README.md](https://github.com/aabbtree77/auth-starter-frontend).
# Debugging
Delete the tables with the browser GUI in Drizzle Studio. Use `bun run db:generate` if you adjust the tables/schema. `bun run db:push` creates and updates the actual database file in `/storage`. If some weird problems appear, delete the `*.db` file inside that folder. This is how I handle "migrations" ;).
I use `bun:sqlite` instead of `better-sqlite3`, but the latter is still needed by drizzle-kit, so better-sqlite3 is in `package.json`, but not in the code. See [this issue](https://github.com/drizzle-team/drizzle-orm/issues/1520).
If you plan on changing the database, pay attention to how they handle the time zones and TypeScript's Date.Now(). `src/utils/sessionhelper.ts` appends `Z` to enforce the UTC when extracting the session expiry from the session table. Without such care, storing and reading may not result in the same value, and with the use of Date.Now() one can easily get some weird bugs where everything works only for longer session expiration times.
In my case, I am 3 hours ahead of the UTC, and could not see any problems when setting a session expiry to 5 hours, at first. It turned out that the program had a bug as it would subtract 3 hours from `session.expiresAt` due to UTC not enforced, killing a session instantly for the TTL values smaller or equal to 3 hours.
# Security
This is a bare-bones minimal authentication, use it at your own risk.
Notice that there is no `.env` inside `.gitignore`. You may need to change that.
I could not set any cookies at first, but ChatGPT 4o helped to solve the problem admirably.
It involves using Hono CORS middleware with the frontend URL and `credentials: true`:
```ts
app.use(
cors({
origin: 'http://localhost:5173',
allowHeaders: ['Content-Type'],
allowMethods: ['GET,HEAD,PUT,PATCH,POST,DELETE'],
credentials: true,
})
);
```Also, the fetch API at the frontend always needs an extra line
```
credentials: 'include'
```Finally, there is a difference between the local (dev) and prod modes not shown in this code (which is tested only with the local development).
For the production mode, the cookie creation in Hono would need to be set this way:
```
setCookie(c, 'sessionId', sessionId, {
path: '/',
maxAge: ttlSeconds,
httpOnly: true,
sameSite: 'None', // Use 'None' for cross-origin requests
secure: true, // Requires HTTPS
});
```Locally, `sameSite: Lax` while `secure: true` needs to be removed due to HTTP, as in this code.
It is possible to test HTTPS locally and retain `secure: true`, but one needs to install `ngrok` and forward `localhost:3000` via
```sh
ngrok http 3000
```Notice that `httpOnly: true` works both locally and globally. It blocks any client Js code access to a cookie value via `document.cookie`, which limits the XSS attacks.
# Further Notes
- One reason for SQLite is that it is just a file, not the whole server that needs a Docker container. However, SQLite has no date and uuid types and they say it is worse at "horizontal scaling" when compared to PostgreSQL. I am not pedantic and advanced enough to worry about such matters.
- It makes sense to keep the backend for the DB and security, mostly, as opposed to old MPAs or metaframeworks. The DB part is already complex enough.
- TypeScript all the way. According to [the latest news](https://2023.stateofjs.com/en-US/usage/), there are fewer than 10% of JavaScript purists left among us.
- A strong side of this particular stack is that it is developer-friendly and its parts are replaceable. It would not be a big issue to replace Bun with Node, Hono with Express, SQLite with PostgreSQL. It may require some time, but it would not involve rearchitecting everything, it would be a linear process.
# References
[The 2023 State of JavaScript survey](https://2023.stateofjs.com/en-US/usage/)
[Complex Schema Design with Drizzle ORM. youtube, 2024](https://www.youtube.com/watch?v=vLze97zZKsU&t=2305s)
[You should learn Drizzle, the TypeScript SQL ORM. Syntax podcast #721, 2024](https://syntax.fm/show/721/you-should-learn-drizzle-the-typescript-sql-orm)