owltide/docs/admin/config.md
Hornwitser aaa2faffb1 Implement register and login with Telegram
Add the concept of authentication methods that authenticate an account
where using the telegram login widget is one such method.  If a login is
done with an authentication method that's not associated with any
account the session ends up with the data from the authentication
method in order to allow registering a new account with the
authentication method.

This has to be stored on the session as otherwise it wouldn't be
possible to implement authentication methods such as OAuth2 that takes
the user to a third-party site and then redirects the browser back.
2025-07-09 15:34:57 +02:00

2 KiB

Configuration

Quoting

Environment variables are parsed using destr which contain arbitrary unspecified and undocumented rules for converting strings to data. If an environment input looks like JSON it'll most likely be parsed as JSON and my cause a type missmatch error to be reported. To avoid strings being converted into other unintended values put the value into " marks. Depending on your configuration environment you may have to double up the quotation marks and/or use escapes.

Environment Variables

NUXT_SESSION_ROTATES_TIMEOUT

Time in seconds before a session need to be rotated over into a new session. When an endpoint using a session is hit after the session rotates timeout but before the session is discarded a new session is created as the successor with a new rotates and discard timeout. The old session then marked to expire in 10 seconds any requests using the old session will result in a 403 Forbidden with the message the session has been taken after the expiry.

NUXT_SESSION_DISCARD_TIMEOUT

Time in seconds before a session is deleted from the client and server, resulting in the user having to authenticate again if the session wasn't rotated over into a new session before this timeout.

This should be several times greater that NUXT_SESSION_ROTATES_TIMEOUT.

NUXT_TELEGRAM_BOT_TOKEN_FILE

Path to a file containing the token for the Telegram bot used for authenticating users via Telegram.

Does nothing if NUXT_AUTH_TELEGRAM_ENABLED is not enabled.

NUXT_PUBLIC_TELEGRAM_BOT_USERNAME

Username of the Telegram bot used for authenticating users via Telegram.

Does nothing if NUXT_AUTH_TELEGRAM_ENABLED is not enabled.

NUXT_AUTH_TELEGRAM_ENABLED

Boolean indicating if authentication via Telegram is enabled or not. Requires NUXT_PUBLIC_TELEGRAM_BOT_USERNAME and NUXT_TELEGRAM_BOT_TOKEN_FILE to be set in order to work.

Defaults to false.