Safety on Leanku 的博客

GitHub 接入与 OAuth 2.0 授权全指南

Mon, 02 Dec 2024 00:00:00 +0000

接入 GitHub（第三方登录或调用 API）主要依赖 OAuth 2.0 授权协议。通过接入 GitHub，开发者可以实现“用 GitHub 账号一键登录平台”以及“获取用户公开信息、仓库数据”等功能。

在开始写代码前，必须先在 GitHub 注册一个 OAuth Application。

登录 GitHub，点击右上角头像 -> Settings（设置）。
在左侧边栏最下方，点击 Developer settings（开发者设置）。
选择 OAuth Apps，点击 New OAuth App（或 Register a new application）。
填写应用信息：
- Application name：应用名称（如 MyApp）。
- Homepage URL：应用主页地址（本地测试可填 http://localhost:3000）。
- Authorization callback URL：核心字段，授权成功后的回调地址（如 http://localhost:3000/api/v1/auth/callback/github）。
点击 Register application 完成注册。
注册完成后，系统会生成：
- Client ID：应用的公开唯一标识。
- Client Secret：密钥，点击 Generate a new client secret 生成（切记妥善保管，严禁暴露在前端）。

官方参考文档：Creating an OAuth app - GitHub Docs

GitHub OAuth 2.0 采用标准的授权码模式（Authorization Code Grant）：

Fri, 12 May 2023 13:46:01 +0800

MFA（Multi-Factor Authentication，多因素认证）是一种提高账户安全性的认证方式。它要求用户在登录或进行敏感操作时提供多种不同类别的验证因素，从而增强安全性。

通常 MFA 包含三类因素：

核心理念：仅凭密码不安全，增加第二甚至第三因素可以有效防止账号被盗。

Fri, 12 May 2023 13:46:01 +0800

OAuth 2.0 是一种开放标准的授权协议，用于在不暴露账号密码的情况下，让用户授权第三方应用访问其受保护的资源。
它主要解决的问题是：如何安全地委托访问权限。

核心概念：

第三方登录（Social Login）
用户使用微信、GitHub、Google 登录你的站点，后端获取 Access Token 调用接口获取用户信息。
开放 API / 平台化
向合作伙伴提供 API，使用 OAuth 2.0 控制访问权限和作用域。
微服务内部接口调用
服务 A 调用服务 B 的接口，通过 Client Credentials 模式获取 Token，避免硬编码密码。
企业内部 SSO（单点登录）
多系统统一认证，用户在登录一次后，访问其他系统不需要重复登录。
前后端分离应用（SPA / Mobile App）
前端获取授权码，换取 Access Token，安全访问 API，密码不在前端传递。

以 授权码模式（Authorization Code Grant） 为例：