使用 GitHub 进行第三方登录（OAuth2）的完整流程整理如下，以 Actix + Rust + JWT 的实现为示例。

1️⃣ 准备工作

1. 注册 GitHub OAuth App

   • 地址：https://github.com/settings/developers

   

   • 填写：
     • Application name: 项目名称
     • Homepage URL: 前端主页，如 http://localhost:3000
     • Authorization callback URL: GitHub 登录后重定向的后端 URL，如 http://localhost:8000/auth/github/callback
   • 获取：
     • Client ID
     • Client Secret

2. 后端环境变量

   • GITHUB_CLIENT_ID
   • GITHUB_CLIENT_SECRET
   • FRONTEND_URL （前端页面 URL，用于登录成功后跳转）
   • DATABASE_URL （可选，如果存用户信息）

2️⃣ 登录入口

用户点击 “使用 GitHub 登录” 按钮：

1. 后端生成 OAuth2 授权 URL：
   • 包含：
     • client_id
     • redirect_uri（回调地址）
     • scope（请求权限，如 user:email）
     • state（防 CSRF，可随机字符串）
     • code_challenge（如果使用 PKCE）
2. 返回这个 URL 给前端，前端跳转到 GitHub 授权页面。

// Actix 例子
let (auth_url, csrf_state, pkce_code_challenge) = client
    .authorize_url(CsrfToken::new_random)
    .add_scope(Scope::new("user:email".to_string()))
    .set_pkce_challenge(PkceCodeChallenge::from_code_verifier(&pkce_verifier))
    .url();

3️⃣ 用户授权

• 用户在 GitHub 页面点击 Authorize。

• GitHub 验证通过后，重定向到你的 callback URL：

  GET /auth/github/callback?code=xxxx&state=xxxx
  

4️⃣ 后端换取 Github Access Token

1. 后端收到 code 和 state。
2. 验证 state 是否和之前生成的一致（防 CSRF）。
3. 如果使用 PKCE，需要使用 code_verifier。