SuperAPI AI 工具集

keycloak-auth-services

编程与开发

查看项目

更新于 10-16 01:38

技能介绍

Keycloak.AuthServices 是一套用于在 .NET 应用中集成 Keycloak 的库,本页是其实现指南,按任务给出参考文档入口。主要能力与用途分段如下。

用途与选型:指南先按任务指引加载对应文档——Web API 用 JWT Bearer,Web 应用用 OIDC,授权与 RBAC、资源保护与授权服务器、Admin REST API SDK、Protection API SDK、开发者体验(Aspire、模板)、配置参考、配方与排错、令牌内省、组织授权(多租户)、RFC 8414 服务器元数据发现、自定义令牌提供程序、可扩展策略构建器、可插拔参数解析器等,各自对应独立参考文件。

包概览:Authentication(JWT Bearer 与 OIDC)、Authorization(RBAC 领域/客户端角色、授权服务器客户端、[ProtectedResource] 特性、组织授权)、Sdk(手写 Admin REST API 与 Protection API 客户端)、Sdk.Kiota(自动生成的 Admin API 客户端,全 API 覆盖)、Common(共享配置与 claims 工具)、OpenTelemetry、Aspire.Hosting、Templates。

使用方式:最简 Web API 需添加 Keycloak.AuthServices.Authentication 与 Common 包,调用 AddKeycloakWebApiAuthentication 与 AddAuthorization,再 UseAuthentication/UseAuthorization;配置默认绑定 "Keycloak" 节,支持 kebab-case 与 PascalCase,关键项包括 realm、auth-server-url、resource、ssl-required、verify-token-audience、credentials.secret。授权可加 Keycloak.AuthServices.Authorization,用 RequireRealmRoles/RequireResourceRoles 定义策略;资源保护用 AddAuthorizationServer 与 RequireProtectedResource;Admin SDK 用 AddKeycloakAdminHttpClient 与 IKeycloakUserClient。安装命令如 dotnet add package Keycloak.AuthServices.Authentication。

限制:资料未提供定价、平台支持版本、许可证及具体性能效果等信息。