AskaEth
8194e38bcf
research/08 方案 A：GUI 的微软登录改走授权码流（HMCL 主流做法），设备码流保留给 CLI/无浏览器场景。两条流只差「怎么拿到 MS access_token」，拿到之后共用 chain::complete_chain 与 MicrosoftSession，落盘/刷新语义没有第二套。 core（crates/core/src/auth/microsoft/） - endpoints：新增 authorize（…/consumers/oauth2/v2.0/authorize），与 token 同租户。 - authcode：RedirectUri 是 http://localhost:{port}/auth 的唯一来源（授权 URL、 token 请求体、实际监听三处共用，坑 5）；AuthCodePolicy（回调超时 300s / 绑定重试 3 次 / 固定端口 / 固定 state）；authorization_url（response_type=code + prompt=select_account + scope=XboxLive.signin%20offline_access）；exchange_code 复用 flow 的 oauth_error/tokens_from。 - callback：本地 HTTP/1.1 回调服务器。内核分配端口（占用按次数退避重试）；非 /auth 路径 （favicon、预连）404 后继续等；state 不匹配 400 后继续等；error=access_denied 归 Canceled； 单条连接读头超时 5s，半开连接拖不垮时间预算。 - MicrosoftAuth::authcode_login(present)：绑端口 → present（宿主开浏览器）→ 等回调 → 换 token → 整链；失败与设备码流一样落 M38 失败日志。 app（crates/app） - AppCommand::StartBrowserLogin + host::accounts::start_browser_login；设备码/授权码共用 LoginJob 取消槽位、收尾入库（store_session）与面板 DTO。 - host::opener 用系统默认浏览器打开授权 URL（Windows rundll32 url.dll,FileProtocolHandler）。 - 账户页：主按钮「微软登录」走授权码流，「设备码登录」作备用；DeviceLoginView::browser_waiting 在面板里给出可复制的授权链接（user_code 留空）。 测试 - crates/core/tests/auth/microsoft_authcode.rs：授权 URL 向量（租户/编码/prompt）、 URI 一致性（授权 URL 与 token 表单同字面量）、mock 全链、favicon+陈旧 state 后仍拿到 code、 端口占用重试文案、超时、access_denied→Canceled、login_with_xbox 403 的 M38 诊断 （detail_code=login_with_xbox_403，真机白名单未批时验收止步于此）。 - 单测：authcode 编码/向量、callback query 解码与错误分流、DTO browser_waiting、conv 面板。 未做/未验证：真机完整登录需 Azure 公共客户端 id（ULL_MSA_CLIENT_ID）与 Minecraft API 许可， 本机只能到「授权页 302 到 login.live.com 且 redirect_uri/scope/prompt 原样保留」这一步。 AskaEth <i@yeij.top>
73 lines
2.5 KiB
Rust
73 lines
2.5 KiB
Rust
//! 用系统默认浏览器打开授权 URL（授权码流唯一需要宿主做的事）。
|
||
//!
|
||
//! core 只负责拼授权 URL 与等本地回调（`core::auth::microsoft::authcode`）；
|
||
//! 「谁来打开浏览器」是宿主的决定：GUI 走这里，CLI/无浏览器场景仍用设备码流。
|
||
//!
|
||
//! 平台差异收在 [`launcher`] 一处，不往业务代码里散写 `cfg` 补丁（`AGENTS.md` §7）。
|
||
|
||
use std::process::Command;
|
||
|
||
/// 拉起系统默认浏览器打开 `url`（只接受 http/https）。
|
||
///
|
||
/// 不等待浏览器退出：用户可能在浏览器里停留几分钟，宿主只关心「有没有拉起来」。
|
||
///
|
||
/// # Errors
|
||
///
|
||
/// URL 不是 http/https，或进程拉不起来时返回用户可读文案。
|
||
pub fn open_url(url: &str) -> Result<(), String> {
|
||
if !url.starts_with("https://") && !url.starts_with("http://") {
|
||
return Err(format!("不是可打开的网址：{url}"));
|
||
}
|
||
let (program, args) = launcher(url);
|
||
Command::new(program)
|
||
.args(args)
|
||
.spawn()
|
||
.map(|_child| ())
|
||
.map_err(|error| format!("拉起浏览器失败（{program}）：{error}"))
|
||
}
|
||
|
||
#[cfg(target_os = "windows")]
|
||
fn launcher(url: &str) -> (&'static str, Vec<String>) {
|
||
// `rundll32` 不用 shell，URL 里的 `&` 不会被当成命令分隔符（`cmd /C start` 会）。
|
||
(
|
||
"rundll32",
|
||
vec!["url.dll,FileProtocolHandler".to_string(), url.to_string()],
|
||
)
|
||
}
|
||
|
||
#[cfg(target_os = "macos")]
|
||
fn launcher(url: &str) -> (&'static str, Vec<String>) {
|
||
("open", vec![url.to_string()])
|
||
}
|
||
|
||
#[cfg(not(any(target_os = "windows", target_os = "macos")))]
|
||
fn launcher(url: &str) -> (&'static str, Vec<String>) {
|
||
("xdg-open", vec![url.to_string()])
|
||
}
|
||
|
||
#[cfg(test)]
|
||
mod tests {
|
||
use super::{launcher, open_url};
|
||
|
||
#[test]
|
||
fn rejects_non_http_urls() {
|
||
assert!(open_url("javascript:alert(1)").is_err());
|
||
assert!(open_url("").is_err());
|
||
// 合法 URL 只验命令形态，不在单测里真去拉浏览器。
|
||
let (program, args) = launcher("http://localhost:1234/auth?code=a&state=b");
|
||
assert!(!program.is_empty());
|
||
assert!(args
|
||
.iter()
|
||
.any(|arg| arg.contains("http://localhost:1234/auth")));
|
||
}
|
||
|
||
#[cfg(target_os = "windows")]
|
||
#[test]
|
||
fn windows_uses_the_file_protocol_handler() {
|
||
let (program, args) = launcher("https://example.invalid/");
|
||
assert_eq!(program, "rundll32");
|
||
assert_eq!(args[0], "url.dll,FileProtocolHandler");
|
||
assert_eq!(args[1], "https://example.invalid/");
|
||
}
|
||
}
|