NextAuth.js 实现多域名认证的最佳实践 - 无需自定义 Cookie

最新推荐文章于 2025-12-25 09:07:35 发布

原创最新推荐文章于 2025-12-25 09:07:35 发布 · 690 阅读

3 ·

CC 4.0 BY-SA版权

文章标签：

#javascript #开发语言 #googlecloud

背景介绍

在微服务架构中，我们经常需要处理多个子域名之间的用户认证问题。比如:

main.example.com (主站)

api.example.com (API服务)

admin.example.com (管理后台)

很多开发者会选择自定义 Cookie 来实现跨域认证，但这种方式:

需要额外的 Cookie 配置

增加了维护成本

可能存在安全隐患

本文将介绍一个更优雅的解决方案。

核心思路

主站点使用 NextAuth.js 进行常规认证

其他域名服务器接收到主站 JWT 后，验证并生成新的 JWT

在 session 中携带新生成的 JWT

具体实现

1. 主站配置 (main.example.com)

..nextauth.ts

import NextAuth from 'next-auth'

export default NextAuth({
  providers: [
    // 你的认证提供者配置
  ],
  callbacks: {
    async session({ session, token }) {
      // 在session中添加用户信息
      session.user.id = token.sub
      return session
    }
  }
})

2. API服务配置 (api.example.com)

session.ts1/1

import { getToken } from 'next-auth/jwt'
import jwt from 'jsonwebtoken'

export default async function handler(req, res) {
  // 验证来自主站的token
  const token = await getToken({ req })
  
  if (!token) {
    return res.status(401).json({ error: 'Unauthorized' })
  }

  // 生成新的JWT
  const newToken = jwt.sign(
    { 
      userId: token.sub,
      scope: 'api-access' 
    },
    process.env.JWT_SECRET,
    { expiresIn: '1h' }
  )

  // 将新token添加到session
  const session = {
    ...token,
    apiToken: newToken
  }

  res.json(session)
}

3. 前端调用示例

api.ts1/1

async function fetchWithAuth(url: string) {
  // 获取主站session
  const session = await getSession()
  
  if (!session) {
    throw new Error('Not authenticated')
  }

  // 获取API服务的token
  const apiSession = await fetch('https://api.example.com/api/auth/session', {
    headers: {
      Authorization: `Bearer ${session.accessToken}`
    }
  }).then(res => res.json())

  // 使用API token访问服务
  return fetch(url, {
    headers: {
      Authorization: `Bearer ${apiSession.apiToken}`
    }
  })
}