logo
0
0
WeChat Login

Coze OAuth 服务

一个基于Express的注册登录接口,同时支持Coze OAuth认证服务,提供完整的OAuth认证流程,支持PKCE安全认证。

快速开始

直接将docker-compose.yml复制到服务器指定文件夹下,修改配置,然后在此目录下运行

docker compose -f up -d --build

本地运行

# 安装依赖 npm install # 启动服务 npm run start-server

项目结构

├── coze/ # 配置和静态资源 │ ├── coze_oauth_config.json # OAuth配置文件 │ ├── websites/ # 网站模板 │ └── assets/ # 静态资源 ├── src/ # 源代码 │ ├── router/ # 路由处理 │ ├── websites/ # 网站模板源文件 │ ├── server.ts # 服务器入口 │ ├── template.ts # 模板处理 │ ├── types.ts # 类型定义 │ └── utils.ts # 工具函数 └── docker-compose.yml # Docker配置

API 列表

服务运行在端口 3000,主要分为以下几类:

1. OAuth 认证相关

页面上自行处理授权,无需手动调用接口

方法路径说明
GET/OAuth 功能测试页
GET/cozeOAuth 首页
GET/coze/auth授权跳转(重定向到 Coze 授权页)
GET/coze/callback授权回调处理
POST/coze/refresh_token刷新访问令牌
GET/coze/get_accessToken获取最新的 access_token
GET/coze/get_refreshToken获取最新的 refresh_token

2. 用户认证相关

方法路径说明
POST/coze/register用户注册
POST/coze/login用户登录(返回 JWT token)
POST/coze/verify验证 JWT token 有效性

3. AI 摘要生成

方法路径说明
GET/coze/summary生成网页摘要(需要 url 参数)

具体使用可查看apifox接口文档,密码GW9nor87

OAuth流程

服务实现了完整的OAuth 2.0认证流程,包括:

  1. 初始化OAuth流程:生成授权URL,包含PKCE验证
  2. 处理OAuth回调:处理授权码,获取访问令牌
  3. 刷新访问令牌:使用刷新令牌获取新的访问令牌

主要功能

  • 注册登录
  • PKCE安全认证:使用PKCE (Proof Key for Code Exchange)增强安全性
  • 状态参数:支持状态参数防止CSRF攻击
  • 自动刷新令牌:令牌过期时自动刷新
  • 模板渲染:支持HTML模板渲染,自动替换变量
  • 静态资源服务:提供静态资源服务

安全性

  • 使用PKCE (Proof Key for Code Exchange)增强安全性
  • 支持状态参数防止CSRF攻击
  • 自动脱敏敏感信息
  • 使用安全Cookie存储刷新令牌

注意事项

  1. 配置文件:确保docker-compose文件修改mysql, redis, coze token等配置,否则会启动失败
  2. 错误处理:如果配置文件加载失败,会使用默认配置并输出错误信息

About

一个基于express的注册登录接口,以及coze工作流的摘要生成和oauth授权

Language
HTML47.7%
TypeScript44%
JavaScript7.3%
Dockerfile1%