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:

npm install @albirex/fastify-logto
# or
yarn add @albirex/fastify-logto
# or
pnpm add @albirex/fastify-logto

Usage

Basic setup

import Fastify from 'fastify';
import fastifyLogto from 'fastify-logto';

const app = Fastify();

app.register(fastifyLogto, {
  appId: 'your-logto-app-id',
  appSecret: 'your-logto-app-secret',
  endpoint: 'https://your-logto-endpoint.com',
  baseUrl: 'http://localhost:3000',
  cookieSecret: 'your-cookie-secret', // use a strong secret in production
});

Protecting routes

app.get('/profile', {
  preHandler: app.verifyLogto,
  handler: async (request, reply) => {
    const userInfo = await request.getLogtoUser();
    return { user: userInfo };
  }
});

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

pnpm install
pnpm build
pnpm test

Local linking

pnpm link --global
cd ../your-app
pnpm 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.