如何在ASP.NET Core 7中集成Appwrite身份验证？

核心思路 #

Appwrite的用户身份验证依赖其签发的JWT令牌，验证逻辑和Firebase类似，但需要针对Appwrite的JWT结构调整验证参数，重点是配置正确的签发者（Issuer）、受众（Audience）和签名验证密钥。

步骤1：获取Appwrite配置信息 #

从Appwrite控制台或API获取以下信息：

• InstanceUrl：你的Appwrite实例地址（例如Appwrite Cloud为https://cloud.appwrite.io/v1，自部署实例为https://your-appwrite-server.com/v1）
• ProjectId：你的Appwrite项目ID（控制台项目设置中可查看）
• PublicKey：Appwrite的RSA公钥，可通过调用无认证接口GET {InstanceUrl}/health/security获取，或在控制台「API」选项卡中复制

步骤2：配置appsettings.json #

将上述信息添加到配置文件中：

"AppwriteAuthentication": {
  "InstanceUrl": "https://cloud.appwrite.io/v1",
  "ProjectId": "your-project-id",
  "PublicKey": "-----BEGIN PUBLIC KEY-----\n...你的公钥内容...\n-----END PUBLIC KEY-----"
}

步骤3：编写身份验证配置方法 #

创建和Firebase类似的配置方法，替换为Appwrite的验证逻辑：

// 配置模型类，用于绑定配置
public class AppwriteAuthSettings
{
    public string InstanceUrl { get; set; } = string.Empty;
    public string ProjectId { get; set; } = string.Empty;
    public string PublicKey { get; set; } = string.Empty;
}

private static void ConfigureAppwriteAuthentication(IServiceCollection services, IConfiguration configuration)
{
    // 绑定配置
    var authSettings = configuration.GetSection("AppwriteAuthentication")
                                    .Get<AppwriteAuthSettings>() 
                        ?? throw new InvalidOperationException("Appwrite身份验证配置缺失");

    // 将Appwrite公钥转换为RSA安全密钥
    var rsa = RSA.Create();
    rsa.ImportFromPem(authSettings.PublicKey);
    var signingKey = new RsaSecurityKey(rsa);

    // 配置JWT Bearer验证
    services.AddAuthentication(JwtBearerDefaults.AuthenticationScheme)
            .AddJwtBearer(options =>
            {
                options.IncludeErrorDetails = true;
                options.TokenValidationParameters = new TokenValidationParameters
                {
                    // 验证签发者
                    ValidateIssuer = true,
                    ValidIssuer = authSettings.InstanceUrl,
                    // 验证受众（Appwrite JWT的受众为项目ID）
                    ValidateAudience = true,
                    ValidAudience = authSettings.ProjectId,
                    // 验证令牌有效期
                    ValidateLifetime = true,
                    // 验证签名密钥
                    ValidateIssuerSigningKey = true,
                    IssuerSigningKey = signingKey,
                    // 可选：允许时钟偏移（处理服务器时间差）
                    ClockSkew = TimeSpan.FromSeconds(30)
                };
            });
}

步骤4：启用身份验证中间件 #

在Program.cs中调用配置方法，并启用认证、授权中间件：

var builder = WebApplication.CreateBuilder(args);

// 注册Appwrite身份验证
ConfigureAppwriteAuthentication(builder.Services, builder.Configuration);

// 添加授权服务
builder.Services.AddAuthorization();

var app = builder.Build();

// 启用身份验证和授权中间件（顺序不能错）
app.UseAuthentication();
app.UseAuthorization();

// 配置API端点等其他逻辑
app.MapControllers();

app.Run();

注意事项 #

1. 令牌传递：前端需要将用户登录后获取的Appwrite JWT令牌，以Bearer {token}的格式放在请求头Authorization中
2. 公钥更新：如果Appwrite实例的公钥更新，需要同步更新配置文件中的PublicKey
3. 动态获取公钥：如果不想硬编码公钥，可在启动时通过HttpClient调用{InstanceUrl}/health/security接口动态获取（注意同步处理启动逻辑）

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