Heavstal Auth — NextAuth Provider 为 Heavstal Tech

Source: Dev.to

概述

官方的 NextAuth.js (Auth.js) provider，用于 Heavstal Tech。
轻松在你的 Next.js 应用中集成 “使用 Heavstal 登录”，无需手动配置授权 URL、令牌端点或用户资料映射。

• 📦 npm:
• 📂 GitHub:

安装

npm install heavstal-auth
# or
yarn add heavstal-auth
# or
pnpm add heavstal-auth

注意： 项目中必须已安装 next-auth。

配置

1. 前往 Heavstal 开发者控制台，创建新应用以获取 Client ID 和 Client Secret。
2. 将它们添加到你的环境变量文件（.env 或 .env.local）：

HEAVSTAL_CLIENT_ID=ht_id_xxxxxxxxxxxx
HEAVSTAL_CLIENT_SECRET=ht_secret_xxxxxxxxxxxx

使用方法

在你的 NextAuth 配置中加入该 provider。

// app/api/auth/[...nextauth]/route.ts (or auth.ts)
import NextAuth from "next-auth";
import HeavstalProvider from "heavstal-auth";

const handler = NextAuth({
  providers: [
    HeavstalProvider({
      clientId: process.env.HEAVSTAL_CLIENT_ID!,
      clientSecret: process.env.HEAVSTAL_CLIENT_SECRET!,
    }),
  ],
  debug: process.env.NODE_ENV === "development",
});

export { handler as GET, handler as POST };

该包使用 TypeScript 编写，并自带类型定义。

Provider 细节

Heavstal 用户资料包含：

• id
• name
• email
• image

预配置的端点

• 授权 URL： https://accounts-heavstal.vercel.app/oauth/authorize
• 令牌 URL： https://accounts-heavstal.vercel.app/api/oauth/token
• 用户信息 URL： https://accounts-heavstal.vercel.app/api/oauth/userinfo
• 令牌方式： client_secret_post

无需手动设置端点或进行 OIDC 发现。

资源

• Heavstal 开发者控制台：
• OAuth 文档：
• Heavstal Tech 平台：

---

由 Heavstal Tech ❤️ 制作