mcpField
D
descope-auth

descope-auth

github.com/descope安全1876 次安装1 天前更新
代码仓库

关于 descope-auth

descope-auth 是将 Descope 无密码身份验证集成到前端和后端项目中的 Skill，按框架提供配置指引，并强调安全的会话验证。

主要功能

  1. 01按框架提供配置指引
  2. 02选择 Descope Flow
  3. 03支持 OTP、魔法链接和通行密钥
  4. 04提供 OAuth 与 SSO 选项
  5. 05指导安全验证会话

适用场景

  1. 01为 Next.js 应用添加无密码登录
  2. 02在 React 或 Angular 中集成身份验证
  3. 03在后端验证会话
  4. 04选择受支持的 Descope Flow

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/descope/skills --skill descope-auth

安装后在 Claude Code 中输入/descope-auth确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
angular.md
backend.md
nextjs.md
react.md
vanilla-js.md

详细介绍

Descope 身份验证

使用 Descope Flows 和 SDK 集成安全的无密码身份验证。

框架检测

检测用户使用的框架，并使用相应的参考文档：

如果项目包含……使用参考文档
next in package.jsonreferences/nextjs.md
react (no Next.js)references/react.md
@angular/core in package.jsonreferences/angular.md
No frontend framework (plain HTML/JS)references/vanilla-js.md
Python/Node.js backend onlyreferences/backend.md

快速入门（所有框架）

  1. 从 https://app.descope.com/settings/project 获取 Project ID
  2. 设置环境变量：NEXT_PUBLIC_DESCOPE_PROJECT_ID=<your-id>
  3. 按照框架专属参考文档操作
  4. 验证：完成设置后，确认 <Descope> 组件已渲染登录表单。检查浏览器控制台——缺少或无效的 Project ID 会产生明确的 Could not load flows 错误。
最简内联示例（Next.js）
// src/app/login/page.tsx
import { Descope } from '@descope/nextjs-sdk';

export default function LoginPage() {
  return (
    <Descope
      flowId="sign-up-or-in"
      onSuccess={(e) => console.log('Authenticated:', e.detail.user)}
      onError={(e) => console.error('Auth failed:', e.detail)}
    />
  );
}

对于 React SPA 或仅后端的设置，请参阅下方的框架专属参考文档。

有效的 Flow ID（重要——不要编造其他 ID）

Flow ID用途
sign-up-or-in注册/登录组合流程（推荐）
sign-up仅注册
sign-in仅登录
step-upMFA 增强身份验证
update-user更新个人资料、添加身份验证方式

身份验证方式

方式适用场景
OTP（Email/SMS）快速验证码
Magic Link无密码电子邮件链接
Passkeys生物识别/WebAuthn（最安全）
OAuth社交登录（Google、GitHub 等）
SSO企业级 SAML/OIDC
Passwords传统身份验证（不推荐）

请勿执行（安全防护）

  • 请勿手动解析 JWT——始终使用 SDK 的 validateSession()
  • 请勿将令牌存储在 localStorage 中——SDK 会安全地处理这些操作
  • 请勿编造 Flow ID——只能使用上表中的 ID
  • 请勿跳过服务端验证——始终在后端进行验证
  • 请勿在客户端代码中暴露 DESCOPE_MANAGEMENT_KEY

参考文档

  • references/nextjs.md - Next.js App Router 和 Pages Router 集成
  • references/react.md - React SPA 集成
  • references/angular.md - Angular 集成
  • references/vanilla-js.md - Vanilla JavaScript / 纯 HTML 集成
  • references/backend.md - 后端会话验证

评论

支持 Markdown