Ely Prism Launcher OAuth2设备码流程深度解析：ElyDeviceCodeStep逐行解读

【免费下载链接】LauncherThis fork of Prism Launcher adds integrated support for Ely.by accounts.项目地址https://gitcode.com/GitHub_Trending/ely/Launcher点击查看免费下载Ely Prism LauncherPineconeMC是一款基于 Prism Launcher 的 Minecraft 启动器分支为 Ely.by 账号提供OAuth2 设备码Device Code登录。本文逐行解读核心类ElyDeviceCodeStep的实现帮助你完整理解设备码登录流程是如何一步步跑通的。一、什么是 OAuth2 设备码流程为什么启动器需要它设备码流程RFC 8628是为不方便内置浏览器登录的程序设计的启动器向授权服务器申请一组设备码 用户码用户打开浏览器在官方网页上输入用户码并登录启动器在后台定时轮询直到服务器确认用户已授权授权完成后服务器下发access_token和refresh_token。这个流程的安全价值在 README.md 中说得非常清楚你的账号密码永远不经过启动器你只在浏览器里登录 Ely.by 官方页面启动器拿到的只是一个权限有限的令牌。这就是 Ely Prism Launcher 相比填账号密码式 fork 的最大卖点 。二、代码结构总览Ely 版只写了 34 行设备码流程的绝大部分逻辑由父类完成Ely 版只需替换三个参数。两个关键文件子类ElyDeviceCodeStep.cpp含头文件 ElyDeviceCodeStep.h父类MSADeviceCodeStep.cpp// ElyDeviceCodeStep.h class ElyDeviceCodeStep : public MSADeviceCodeStep { public: explicit ElyDeviceCodeStep(AccountData* data); QString describe() override; };父类在 MSADeviceCodeStep.h 中声明了整套状态机成员作用m_clientId/m_scopesOAuth2 客户端标识与权限范围m_deviceCodeUrl/m_tokenUrl申请设备码、换取令牌的端点m_pool_timer轮询计时器每次到期发起一次令牌请求m_expiration_timer一次性到期计时器超时自动中止interval轮询间隔默认 5 秒可被服务器动态调整三、构造函数逐行解读Ely 专属的 3 个参数ElyDeviceCodeStep.cpp 的构造函数只有 4 行却完成了从微软切换到 Ely的全部工作ElyDeviceCodeStep::ElyDeviceCodeStep(AccountData* data) : MSADeviceCodeStep(data) { m_clientId APPLICATION-getElyClientID(); m_scopes account_info offline_access minecraft_server_session; m_deviceCodeUrl QUrl(https://account.ely.by/api/oauth2/v1/devicecode); m_tokenUrl QUrl(https://account.ely.by/api/oauth2/v1/token); }逐行拆解m_clientId APPLICATION-getElyClientID()读取 Ely 平台的 Client ID。实现见 Application.cpp——优先取用户设置里的ElyClientIDOverride否则用编译期常量BuildConfig.ELY_CLIENT_ID。m_scopes权限范围与微软的XboxLive.SignIn不同Ely 申请的是三个 scope——account_info读取账号信息、offline_access允许颁发 refresh_token实现离线续期、minecraft_server_session加入服务器会话的凭证。两个 URL指向 Ely 自己的 OAuth2 端点而不是login.microsoftonline.com父类默认值。最后 describe() 只是把进度条文案改成Logging in with Ely.by account(device code).让用户明确当前登录的是 Ely 通道。四、perform()向服务器申请设备码父类的 perform() 是流程的起点QUrlQuery data; data.addQueryItem(client_id, m_clientId); data.addQueryItem(scope, m_scopes); auto payload data.query(QUrl::FullyEncoded).toUtf8();要点有三表单编码请求以application/x-www-form-urlencodedPOST 到m_deviceCodeUrl只带client_id和scope两个参数——此时还不需要任何用户凭证。网络层封装通过Net::Upload::makeByteArray创建请求用RawHeaderProxy附加请求头并enableAutoRetry(true)让传输层自动重试。任务化执行请求被包进NetJob命名MSADeviceCodeStep完成后回调 deviceAuthorizationFinished()。五、deviceAuthorizationFinished()解析响应弹出登录页服务器响应是一个 JSON被解析为 DeviceAuthorizationResponse 结构device_code / user_code / verification_uri / expires_in / interval处理逻辑按顺序做了四件事双重校验先检查 HTTP 层是否成功、JSON 中是否带error字段再确认device_code、user_code、verification_uri、expires_in四项必填字段齐全缺任何一项都以STATE_FAILED_HARD终止。通知界面emit authorizeWithBrowser(verification_uri, user_code, expires_in)。信号沿 AuthFlow.cpp 中建立的连接冒泡到 MSALoginDialog.cpp 的authorizeWithBrowserWithExtra()——它把用户码显示为等宽字体文本、提供一键复制按钮并用qrencode现场绘制出验证页的二维码扫码即可登录 。启动到期计时器m_expiration_timer设为一次性、时长expires_in秒超时直接调用 abort() 停止一切并报错。启动轮询计时器调用startPoolTimer()进入等待状态。一个精妙细节在 startPoolTimer()如果到期剩余时间已不足一个轮询间隔它会重新调用perform()申请一组新的设备码避免轮询一次都没发出去码就过期了的边界情况。六、轮询机制authorization_pending 与 slow_down 的优雅处理每过interval秒authenticateUser() 向m_tokenUrl提交grant_type urn:ietf:params:oauth:grant-type:device_code device_code 上一步拿到的设备码authenticationFinished() 对五种结果分别处置完全遵循 RFC 8628 §3.5服务器/网络反馈处理方式authorization_pending用户还没在浏览器完成登录 → 按原间隔继续轮询slow_down服务器嫌轮询太快 →间隔 5 秒后继续连接超时指数退避interval * 2防止雪崩式重试其他请求失败不增加间隔立即再试一次其他error判定失败STATE_FAILED_HARD终止流程注意轮询重试复用的是m_request而非NetJob且只在拿到成功令牌时才stop()到期计时器——任何一次失败都不会让流程误判为结束。七、登录成功token 写入 AccountData 的 5 个字段拿到令牌后代码只写入了 AccountData.h 中Token结构的几个字段m_data-msaClientID m_clientId; // 记录是哪个客户端拿的 token m_data-msaToken.issueInstant 当前UTC时间; // 颁发时间 m_data-msaToken.notAfter 当前时间 rsp.expires_in; // 过期时间 m_data-msaToken.refresh_token rsp.refresh_token; // 离线续期用 m_data-msaToken.token rsp.access_token; // 主令牌随后以STATE_WORKING状态发出finished(Got MSA token)——注意这里不算流程结束只是本步骤完成接下来交给上层编排。八、上层编排AuthFlow 如何串起 4 个步骤AuthFlow.cpp 根据AccountType和登录动作装配步骤链。Ely 账号 设备码登录时队列是ElyDeviceCodeStep—— 本文主角拿到 Ely 平台的 OAuth2 令牌ElyYggdrasilTokenStep—— 把令牌换成 YggdrasilMinecraft 服务器侧令牌MinecraftProfileStepEly—— 拉取游戏档案玩家名、UUIDGetSkinStep—— 下载皮肤数据。AuthFlow::nextStep() 每次取出队首步骤执行靠AuthStep::finished信号驱动下一步任何一步进入失败状态STATE_FAILED_HARD等都会通过 changeState() 把账号标记为Expired/Errored并终止整条链。九、安全模型小结为什么设备码登录更放心 ️密码零接触整个 ElyDeviceCodeStep.cpp 中不存在任何密码字段凭据交换发生在浏览器与 Ely.by 之间。权限最小化scope 限定为account_info offline_access minecraft_server_session启动器拿不到超出登录 Minecraft 所需的能力。令牌可随时撤销失效的只有令牌而非账号密码本身到期由refresh_token静默续期体验与安全性兼得。十、小结一张图看懂完整生命周期构造(替换 clientId/scopes/URL) ↓ perform() ──POST client_idscope──→ account.ely.by/devicecode ↓ deviceAuthorizationFinished()校验 → 弹码二维码 → 起双计时器 ↓ 循环轮询 authenticateUser()pending→继续 / slow_down→5s / 超时→退避 ↓ authenticationFinished()成功 → 写入 msaToken → STATE_WORKING ↓ AuthFlow 继续执行 Yggdrasil 令牌 → 档案 → 皮肤ElyDeviceCodeStep本体只有 34 行代码真正的工作由父类 MSADeviceCodeStep.cpp 的状态机完成——这种模板方法模式让 MSA 与 Ely 两条登录通道共享同一套轮询、退避与超时逻辑是理解本项目 OAuth2 认证体系的最佳入口。赞分享【免费下载链接】LauncherThis fork of Prism Launcher adds integrated support for Ely.by accounts.项目地址https://gitcode.com/GitHub_Trending/ely/Launcher点击查看免费下载相关推荐Ely Prism Launcher认证流程源码解析AuthFlow多步骤编排完整走读Ely Prism Launcher认证流程源码解析AuthFlow多步骤编排完整走读 Ely Prism Launcher 是基于 Prism Launch为什么Ely Prism Launcher登录时看不到你的密码Ely.by OAuth2安全设计原理为什么Ely Prism Launcher登录时看不到你的密码Ely.by OAuth2安全设计原理 使用 Ely Prism Launcher 登录 ElyEly Prism Launcher实例数据模型MinecraftInstance与BaseInstance完整解读Ely Prism Launcher实例数据模型MinecraftInstance与BaseInstance完整解读 Ely Prism Launcher 是创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考