Fastify Logto Integration

🔐 Fastify plugin for integrating with Logto, a modern open-source identity platform.

Features

• Plug-and-play authentication and session management with Logto.
• Secure route protection using Fastify decorators.
• Works seamlessly with Fastify 4+ and TypeScript.

Installation

To install the package, use your preferred package manager:

1npm install @albirex/fastify-logto
2# or
3yarn add @albirex/fastify-logto
4# or
5pnpm add @albirex/fastify-logto

Usage

Basic setup

1import Fastify from 'fastify';
2import fastifyLogto from 'fastify-logto';
3
4const app = Fastify();
5
6app.register(fastifyLogto, {
7  appId: 'your-logto-app-id',
8  appSecret: 'your-logto-app-secret',
9  endpoint: 'https://your-logto-endpoint.com',
10  baseUrl: 'http://localhost:3000',
11  cookieSecret: 'your-cookie-secret', // use a strong secret in production
12});
13

Protecting routes

1app.get('/profile', {
2  preHandler: app.verifyLogto,
3  handler: async (request, reply) => {
4    const userInfo = await request.getLogtoUser();
5    return { user: userInfo };
6  }
7});

Configuration options

Property	Type	Description
appId	string	Your Logto application's ID.
appSecret	string	Your Logto application's secret.
endpoint	string	Your Logto server endpoint.
cookieSecret	string	Secret used for signing cookies (sessions).
baseUrl	string, optional	Your app's base URL (for callback routing).
scopes	string[], optional	Define the scopes required for your application.

API

Decorators

• request.getLogtoUser(): Retrieves the authenticated user's information.
• app.verifyLogto: PreHandler function to enforce authentication.

Development

1pnpm install
2pnpm build
3pnpm test

Local linking

1pnpm link --global
2cd ../your-app
3pnpm link --global fastify-logto

License

This project is licensed under the MIT License.

Contributing

Contributions are welcome! Please open an issue or submit a pull request for any enhancements or bug fixes.

For more information and advanced usage, please refer to the official documentation for Platformatic and LogTo.