C#桌面应用如何在不运行本地服务器的情况下实现Strava OAuth

针对无法启动本地服务器的场景，自定义URI协议是桌面应用实现Strava OAuth的最优方案，无需占用端口，直接通过系统协议回调应用。

步骤1：配置Strava开发者后台 #

在Strava开发者控制台的应用设置中，将Authorization Callback Domain设置为你的自定义URI协议，例如：mystravaapp://auth。

步骤2：注册自定义URI协议（Windows系统） #

首次运行应用时，需要注册自定义协议（需管理员权限），让系统识别该协议并关联到你的应用：

private void RegisterCustomUriScheme()
{
    using (var registryKey = Microsoft.Win32.Registry.CurrentUser.CreateSubKey(@"Software\Classes\mystravaapp"))
    {
        registryKey.SetValue("", "URL:My Strava Auth Protocol");
        registryKey.SetValue("URL Protocol", string.Empty);
        
        using (var commandSubKey = registryKey.CreateSubKey(@"shell\open\command"))
        {
            // 将应用程序路径与协议关联，%1会传递回调的URI参数
            commandSubKey.SetValue("", $"\"{Application.ExecutablePath}\" \"%1\"");
        }
    }
}

提示：可以在应用启动时检查注册表是否已注册，未注册则提示用户以管理员身份运行并执行注册逻辑。

步骤3：发起授权请求 #

构造Strava授权URL，调用系统默认浏览器打开，引导用户完成登录授权：

var clientId = "你的Strava客户端ID";
var redirectUri = Uri.EscapeDataString("mystravaapp://auth");
var requiredScopes = "read,activity:read_all"; // 根据需求调整权限范围

var authUrl = $"https://www.strava.com/oauth/authorize?client_id={clientId}" +
              $"&response_type=code&redirect_uri={redirectUri}&scope={requiredScopes}";

// 打开默认浏览器
Process.Start(new ProcessStartInfo(authUrl) { UseShellExecute = true });

步骤4：处理回调并交换令牌 #

用户授权完成后，系统会通过自定义URI唤起你的应用，并传递授权码。在应用入口处捕获命令行参数，提取授权码后交换访问令牌：

static void Main(string[] args)
{
    // 检查是否是回调唤起
    if (args.Length > 0 && args[0].StartsWith("mystravaapp://auth"))
    {
        var callbackUri = new Uri(args[0]);
        var authCode = HttpUtility.ParseQueryString(callbackUri.Query).Get("code");
        
        // 异步交换令牌
        _ = ExchangeAuthCodeForToken(authCode);
    }

    // 启动主窗体
    Application.Run(new MainForm());
}

private static async Task ExchangeAuthCodeForToken(string authCode)
{
    var clientId = "你的Strava客户端ID";
    var clientSecret = "你的Strava客户端密钥";
    var redirectUri = "mystravaapp://auth";

    using (var httpClient = new HttpClient())
    {
        var requestContent = new FormUrlEncodedContent(new[]
        {
            new KeyValuePair<string, string>("client_id", clientId),
            new KeyValuePair<string, string>("client_secret", clientSecret),
            new KeyValuePair<string, string>("code", authCode),
            new KeyValuePair<string, string>("grant_type", "authorization_code")
        });

        var response = await httpClient.PostAsync("https://www.strava.com/oauth/token", requestContent);
        var responseJson = await response.Content.ReadAsStringAsync();
        
        // 解析JSON获取access_token、refresh_token等信息
        // 建议使用Newtonsoft.Json或System.Text.Json进行序列化
        // 示例：var tokenResponse = JsonConvert.DeserializeObject<StravaTokenResponse>(responseJson);
    }
}

// 定义令牌响应模型（示例）
public class StravaTokenResponse
{
    public string access_token { get; set; }
    public string refresh_token { get; set; }
    public int expires_at { get; set; }
}

注意事项 #

• 自定义URI协议的名称需唯一，避免与其他应用冲突
• 令牌需安全存储，推荐使用Windows凭据管理器（CredentialManager类）或加密存储，禁止明文保存
• 如果应用未运行，系统会启动应用并传递回调参数，需确保应用能正确处理冷启动时的命令行参数

内容的提问来源于stack exchange，提问作者Dmitry Sokolov