public/owltide
1
0
Fork 0
Code Issues 2 Pull requests Projects Releases Packages 1 Wiki Activity Actions
owltide/docs/admin/authentication.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

950 B
Raw Blame History

Authentication

It's possible to configure authentication using a third party Authentication Provider (referred to as AP). Currently only Telegram is supported as an AP.

Telegram

In order to use Telegram as an AP you need to be hosting Owltide under a domain name over https, using http will not work.

You will also need a bot which can be created by messaging @BotFather, with the domain of the bot set using the /setdomain command to the domain Owltide is hosted under.

Once you have the pre-requisites you need to configure NUXT_TELEGRAM_BOT_TOKEN_FILE to a path to a file containing the token of the bot with no spaces or new-lines. NUXT_PUBLIC_TELEGRAM_BOT_USERNAME to the username of the bot. And finally NUXT_AUTH_TELEGRAM_ENABLED to true to enable authentication via Telegram.