¶ GenAuth - C#
GenAuth C# SDK 由两部分组成：ManagementClient 和 AuthenticationClient。
AuthenticationClient 以终端用户（End User）的身份进行请求，提供了登录、注册、登出、管理用户资料、获取授权资源等所有管理用户身份的方法；此模块还提供了各种身份协议的 SDK，如 OpenID Connect, OAuth 2.0, SAML 和 CAS。此模块适合用于非受信任的浏览器环境和纯后端交互的服务器环境。
ManagementClient 以管理员（Administrator）的身份进行请求，用于管理用户池资源和执行管理任务，提供了管理用户、角色、应用、资源等方法；一般来说，你在 GenAuth 控制台 (opens new window) 中能做的所有操作，都能用此模块完成。此模块适合在后端或者可信任的前端环境下使用。
¶ GitHub 下载地址
| 条目 | 说明 |
|---|---|
| 支持版本 | 所有版本 |
| 仓库地址 | https://github.com/Authing/authing-api-client-net (opens new window) |
¶ 安装
安装 GenAuth.ApiClient (opens new window)：
# 包管理器
Install-Package GenAuth.ApiClient -Version {LATEST_VERSION}
# .Net Cli
dotnet add package GenAuth.ApiClient --version {LATEST_VERSION}
# packagereference
<PackageReference Include="GenAuth.ApiClient" Version="{LATEST_VERSION}" />
注意检查最新版本号，格式如：4.2.4.12。
其他方式，请参考 GenAuth.ApiClient (opens new window)
¶ 使用管理模块
初始化 ManagementClient 需要 userPoolId（用户池 ID） 和 secret（用户池密钥）:
你可以在此了解如何获取 UserPoolId 和 Secret .
using GenAuth.ApiClient;
var managementClient = new ManagementClient("GEN_AUTH_USERPOOL_ID", "GEN_AUTH_USERPOOL_SECRET");
现在 ManagementClient() 实例就可以使用了。例如可以获取用户池中的用户列表：
var managementClient = new ManagementClient("GEN_AUTH_USERPOOL_ID", "GEN_AUTH_USERPOOL_SECRET");
var data = await managementClient.Users.List();
¶ 管理模块包含以下子模块：
¶ 使用认证模块
初始化 ManagementClient 需要 AppId （应用 ID）：
你可以在控制台的 应用 中查看自己的应用列表。
using GenAuth.ApiClient;
var authenticationClient = new AuthenticationClient(opt =>
{
opt.AppId = "GEN_AUTH_APP_ID";
});
接下来可以进行注册登录等操作：
var username = GetRandomString(10);
var password = GetRandomString(10);
var user = await authenticationClient.LoginByUsername(
username,
password,
)
完成登录之后，update_profile 等要求用户登录的方法就可用了：
await authenticationClient.UpdateProfile(new UpdateUserInput() {
Nickname = "Nick",
})
你也可以在初始化后设置 Token 参数, 不需要每次都调用 LoginByXXX 方法:
using GenAuth.ApiClient;
var authenticationClient = new AuthenticationClient(
opt =>
{
opt.AppId = "GEN_AUTH_APP_ID";
}
);
authenticationClient.Token = "ID_TOKEN";
再次执行 UpdateProfile 方法，发现也成功了:
await authenticationClient.UpdateProfile(new UpdateUserInput() {
Nickname = "Nick",
})
¶ 私有化部署
私有化部署场景需要指定你私有化的 GenAuth 服务的 GraphQL 端点（不带协议头和 Path）以及密码加密公钥，如果你不清楚可以联系 GenAuth IDaaS 服务管理员。