https://www.leanku.com/tags/oauth-2.0/Recent content in OAuth 2.0 on Leanku 的博客Hugozh-cnMon, 02 Dec 2024 00:00:00 +0000https://www.leanku.com/post/safety/a-complete-guide-to-github-access-and-oauth-2.0-authorization/Mon, 02 Dec 2024 00:00:00 +0000https://www.leanku.com/post/safety/a-complete-guide-to-github-access-and-oauth-2.0-authorization/<p>接入 GitHub（第三方登录或调用 API）主要依赖 <strong>OAuth 2.0 授权协议</strong>。通过接入 GitHub，开发者可以实现“用 GitHub 账号一键登录平台”以及“获取用户公开信息、仓库数据”等功能。</p> <h2 id="1-接入前的准备创建-oauth-app">1. 接入前的准备：创建 OAuth App</h2> <p>在开始写代码前，必须先在 GitHub 注册一个 OAuth Application。</p> <ol> <li> <p>登录 GitHub，点击右上角头像 -&gt; <strong>Settings</strong>（设置）。</p> </li> <li> <p>在左侧边栏最下方，点击 <strong>Developer settings</strong>（开发者设置）。</p> </li> <li> <p>选择 <strong>OAuth Apps</strong>，点击 <strong>New OAuth App</strong>（或 <strong>Register a new application</strong>）。</p> </li> <li> <p>填写应用信息：</p> <ul> <li> <p><strong>Application name</strong>：应用名称（如 <code>MyApp</code>）。</p> </li> <li> <p><strong>Homepage URL</strong>：应用主页地址（本地测试可填 <code>http://localhost:3000</code>）。</p> </li> <li> <p><strong>Authorization callback URL</strong>：<strong>核心字段</strong>，授权成功后的回调地址（如 <code>http://localhost:3000/api/v1/auth/callback/github</code>）。</p> </li> </ul> </li> <li> <p>点击 <strong>Register application</strong> 完成注册。</p> </li> <li> <p>注册完成后，系统会生成：</p> <ul> <li> <p><strong>Client ID</strong>：应用的公开唯一标识。</p> </li> <li> <p><strong>Client Secret</strong>：密钥，点击 <strong>Generate a new client secret</strong> 生成（<strong>切记妥善保管，严禁暴露在前端</strong>）。</p> </li> </ul> </li> </ol> <blockquote> <p><strong>官方参考文档</strong>：<a href="https://docs.github.com/en/apps/oauth-apps/building-oauth-apps/creating-an-oauth-app">Creating an OAuth app - GitHub Docs</a></p> </blockquote> <h2 id="2-github-oauth-20-核心交互流程">2. GitHub OAuth 2.0 核心交互流程</h2> <p>GitHub OAuth 2.0 采用标准的<strong>授权码模式（Authorization Code Grant）</strong>：</p>