如何在.NET Core中结合MongoDB Atlas与Realms实现JWT认证？

当然可以实现！你遇到的困惑主要是混淆了本地Realm数据库SDK和云端Realm App Services的对接方式——你安装的Realms NuGet包是用于本地离线数据库的，而咱们要对接的是MongoDB Atlas App Services（原MongoDB Realm）这个云端服务层，通过它来实现JWT认证并访问你的Atlas集群。下面给你两种可行的方案：

方案一：用MongoDB C#驱动 + Realm认证令牌（推荐，适合熟悉MongoDB驱动的场景） #

1. 前置准备 #

• 确认你的Realm App已经关联了Atlas集群，并且在Realm里配置好了JWT认证提供者（比如自定义JWT、Auth0、Okta这类，要记好你配置的提供者名称，比如custom-jwt）。
• 从Realm App的App Settings里复制你的App ID（格式类似your-app-id-xxxxxx）。

2. 安装所需NuGet包 #

需要这几个包：

• MongoDB.Driver：标准的MongoDB C#驱动
• System.Net.Http.Json：简化JSON格式的HTTP请求（可选，但能省不少代码）

3. 验证JWT并获取Realm访问令牌 #

首先，你需要把用户的JWT发给Realm的认证API，换取一个Realm认可的访问令牌——这个令牌是用来访问Atlas集群的凭证：

using System.Net.Http.Json;
using System.Text.Json.Serialization;

public async Task<string> GetRealmAccessToken(string userJwt, string realmAppId)
{
    using var httpClient = new HttpClient();
    var authPayload = new
    {
        token = userJwt,
        provider = "custom-jwt" // 这里要和你Realm里配置的JWT提供者名称完全一致
    };

    var response = await httpClient.PostAsJsonAsync(
        $"https://realm.mongodb.com/api/client/v2.0/app/{realmAppId}/auth/providers/custom-jwt/login",
        authPayload);

    response.EnsureSuccessStatusCode(); // 处理认证失败的情况，比如JWT无效
    var authResult = await response.Content.ReadFromJsonAsync<RealmAuthResponse>();
    return authResult.AccessToken;
}

// 用来解析Realm认证响应的模型
private class RealmAuthResponse
{
    [JsonPropertyName("access_token")]
    public string AccessToken { get; set; }
    
    [JsonPropertyName("refresh_token")]
    public string RefreshToken { get; set; } // 用来刷新过期的访问令牌
}

4. 用访问令牌连接Atlas集群 #

拿到Realm的访问令牌后，就可以配置MongoDB驱动用这个令牌认证，直接连接你的Atlas集群：

using MongoDB.Driver;

public async Task<IMongoDatabase> GetAuthenticatedDb(string atlasConnString, string realmAccessToken)
{
    var clientSettings = MongoClientSettings.FromConnectionString(atlasConnString);
    clientSettings.ServerApi = new ServerApi(ServerApiVersion.V1);
    // 配置Bearer认证，用Realm的访问令牌作为凭证
    clientSettings.Credential = MongoCredential.CreateBearerCredential("", realmAccessToken);

    var client = new MongoClient(clientSettings);
    // 可选：验证连接是否成功
    await client.ListDatabasesAsync();
    return client.GetDatabase("your-target-db-name");
}

注意：你的Atlas连接字符串不需要带用户名密码，因为我们用Bearer令牌做认证。另外一定要在Realm App里配置好权限规则，确保经过JWT认证的用户能访问对应的数据库和集合，否则会收到权限报错。

方案二：用Realm Data API（REST接口，适合轻量场景） #

如果你不想用MongoDB驱动，也可以直接调用Realm提供的Data API——这是一个RESTful接口，直接通过HTTP请求操作数据：

1. 开启Data API #

在Realm App的Data API页面启用这个功能，然后复制API端点（格式类似https://data.mongodb-api.com/app/your-app-id-xxxxxx/endpoint/data/v1）。

2. 在.NET Core中调用Data API #

用HTTP客户端带上Realm访问令牌（获取方式同方案一）发送请求即可，比如查询集合数据：

using System.Net.Http.Json;
using System.Text.Json.Serialization;

public async Task<List<T>> GetDocuments<T>(string dataApiEndpoint, string realmAccessToken, string dbName, string collName)
{
    using var httpClient = new HttpClient();
    httpClient.DefaultRequestHeaders.Add("Authorization", $"Bearer {realmAccessToken}");

    var response = await httpClient.GetAsync(
        $"{dataApiEndpoint}/action/find?database={dbName}&collection={collName}");

    response.EnsureSuccessStatusCode();
    var result = await response.Content.ReadFromJsonAsync<DataApiFindResult<T>>();
    return result.Documents;
}

// 解析Data API响应的模型
private class DataApiFindResult<T>
{
    [JsonPropertyName("documents")]
    public List<T> Documents { get; set; }
}

关键提醒 #

• 别再用Realms NuGet包对接云端服务了，那个是给本地离线数据库用的；
• 记得处理令牌过期：Realm的访问令牌会过期，你可以用返回的刷新令牌去换取新的访问令牌，避免频繁让用户重新登录；
• 权限规则是核心：一定要在Realm App里配置好用户权限，比如允许认证用户读写指定集合，否则哪怕令牌正确也会被拒绝访问。

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