astro-kinde
v2.4.1
Published
Astro integration module for Kinde authentication
Downloads
69
Maintainers
Readme
Astro Kinde Integration
This package provides an Astro integration for Kinde, simplifying the process of adding authentication to your Astro application using Kinde's OAuth 2.0 flow.
Features
- Easy setup and configuration
- Automatically injects authentication routes
- Provides authentication state in Astro pages
- Integrates with Kinde Management SDK for user and application management
Installation
- Create a Kinde back-end web account and set the following environment variables:
KINDE_MANAGEMENT_CLIENT_ID=your_management_client_id
KINDE_MANAGEMENT_CLIENT_SECRET=your_management_client_secret
KINDE_DOMAIN=your_kinde_domain
- Install the package and its dependencies:
npm install astro-kinde dotenv
Note: The dotenv
module is required for loading environment variables.
- Add the integration to your
astro.config.mjs
:
import { defineConfig } from "astro/config";
import kinde from "astro-kinde";
export default defineConfig({
integrations: [kinde()],
});
- Setup your
env.d.ts
:
/// <reference types="astro/client" />
declare namespace App {
interface Locals {
isAuthenticated: boolean;
accessToken: string | undefined;
}
}
Configuration
Configure the integration by passing options to the kinde
function in astro.config.mjs
.
import { defineConfig } from "astro/config";
import kinde from "astro-kinde";
import dotenv from "dotenv";
dotenv.config();
export default defineConfig({
output: "server", // Necessary for Astro headers
integrations: [
kinde({
clientId: process.env.KINDE_MANAGEMENT_CLIENT_ID,
clientSecret: process.env.KINDE_MANAGEMENT_CLIENT_SECRET,
domain: process.env.KINDE_DOMAIN,
callbackUri: "http://localhost:4321/api/kinde/callback",
signedInUri: "http://localhost:4321",
signedOutUri: "http://localhost:4321",
sessionMaxAge: 3600,
}),
],
});
You can set the uris based on your NODE_ENV
to handle development and production environments.
Usage
The integration automatically injects the following routes:
/api/kinde/login
: Redirects to the Kinde login page/api/kinde/register
: Redirects to the Kinde registration page/api/kinde/callback
: Handles the OAuth callback/api/kinde/signout
: Handles user sign-out/api/kinde/isAuthenticated
: Checks if the user is authenticated
Checking Authentication Status
You can check the authentication status in two ways:
- Using
Astro.locals
:
---
const isAuthenticated = Astro.locals.isAuthenticated;
---
- Using the
isAuthenticated
route:
---
const isAuthenticated = await fetch('/api/kinde/isAuthenticated').then(res => res.json());
---
Redirecting Authenticated Users
---
if (isAuthenticated) {
return Astro.redirect('/example');
}
---
Conditional Rendering Based on Authentication
{isAuthenticated ? (
<a href="/api/kinde/signout">Sign Out</a>
) : (
<a href="/api/kinde/login">Login</a>
)}
Registration with Pre-filled Email
<a href="/api/kinde/[email protected]">Register</a>
You can pass through query parameters to the login/register routes to control the behaviour of the Kinde flow. See what they are on the Kinde site. For example:
Management SDK
Kinde provides a Management SDK that you can use to manage your users and applications. To use the Management SDK:
If using separately - remember to store the env variables from the previous steps.
Install the SDK:
npm install @kinde-oss/kinde-management-api-js
- Initialise the SDK in
astro.config.mts
:
import { init } from "@kinde/management-api-js";
// Run the Kinde initialisation
init();
- Use the SDK in your Astro pages:
---
import { Oauth, OpenAPI } from "@kinde/management-api-js";
const isAuthenticated = Astro.locals.isAuthenticated;
const accessToken = Astro.locals.accessToken;
if (isAuthenticated) {
OpenAPI.TOKEN = accessToken;
const userProfile = await Oauth.getUserProfileV2();
console.log(userProfile);
}
---
That's it! You now have Kinde authentication set up in your Astro project and can use the Management SDK to manage your users and applications.
Contributing
If you'd like to contribute to this project, please follow these steps:
- Fork the repository.
- Create a new branch.
- Make your changes.
- Submit a pull request.
License
By contributing to Astro-Kinde, you agree that your contributions will be licensed under its MIT License.