官网文档地址:点我点我
准备
创建一个名为IdentityServer
的ASP.NET Core Web Api 项目,端口5000
创建一个名为Api
的ASP.NET Core Web Api 项目,端口5001
创建一个名为Web
的应用程序,端口5002
基本配置
首先创建一个新的ASP.NET Core项目。
然后选择“空白”选项。
注:这里创建空的应用程序是为了后面方便引入UI界面
接下来,使用nuget添加IdentityServer4
包
或者,也可以使用软件包管理器控制台通过运行以下命令来添加依赖项
Install-Package IdentityServer4
在IdentityServer
中使用通常的模式来配置和添加服务到ASP.NET Core Host
在ConfigureServices
中,所有的服务必须配置并且依赖注入到系统中。
在Configure
中,中间件被添加到HTTP管道中。
public void ConfigureServices(IServiceCollection services)
{
//配置身份服务器与内存中的存储,密钥,客户端和资源
services.AddIdentityServer().AddDeveloperSigningCredential();
}
public void Configure(IApplicationBuilder app, IHostingEnvironment env)
{
if (env.IsDevelopment())
{
app.UseDeveloperExceptionPage();
}
//添加到HTTP管道中。
app.UseIdentityServer(); app.Run(async (context) =>
{
await context.Response.WriteAsync("Hello World!");
});
}
AddIdentityServer
方法在依赖注入系统中注册IdentityServer,它还会注册一个基于内存存储的运行时状态,这对于开发场景非常有用,对于生产场景,您需要一个持久化或共享存储,如数据库或缓存。
扩展的AddDeveloperSigningCredential
用于签署令牌创建临时密钥。
修改hosting
修改启动端口,打开Properties下的launchSettings.json修改applicationUrl
中的端口改为5000,注:这里修改启动端口是为了方便调试
使用客户端凭证保护API
在这种情况下,我们将定义一个API和一个想要访问它的客户端。客户端将在IdentityServer
上请求访问令牌,并使用它来访问API。
在IdentityServer
项目中新建个Config.cs
类,并添加以下代码:
/// <summary>
/// 定义api信息
/// </summary>
/// <returns></returns>
public static IEnumerable<ApiResource> GetApiResources()
{
return new List<ApiResource>
{
new ApiResource("api1", "My API")
};
}
ps:ApiResource
类为IdentityServer
中的实体类,这里引用IdentityServer4.Models
命名空间即可。
定义客户端
定义一个可以访问这个API的客户端。对于这种情况,客户端将不具有交互式用户,并将使用IdentityServer
的所有客户端密钥进行身份验证。在Config.cs
中添加如下代码:
public static IEnumerable<Client> GetClients()
{
return new List<Client>
{
new Client
{
ClientId = "client",
//没有交互式用户,使用clientid / secret进行身份验证
AllowedGrantTypes = GrantTypes.ClientCredentials,
//秘密认证
ClientSecrets =
{
new Secret("secret".Sha256())
},
//客户端可以访问的范围
AllowedScopes = {"api1"}
}
};
}
注册IdentityServer服务
要配置IdentityServer
以便使用定义好的访问控制,您需要向该ConfigureServices
方法添加代码。您可以使用方便的扩展方法 ,将相关的存储和数据添加到DI系统中:
public void ConfigureServices(IServiceCollection services)
{
//配置身份服务器与内存中的存储,密钥,客户端和资源
services.AddIdentityServer()
.AddDeveloperSigningCredential()
.AddInMemoryApiResources(Config.GetApiResources())//添加api资源
.AddInMemoryClients(Config.GetClients());//添加客户端
}
运行项目并在浏览器中访问:http://localhost:5000/.well-known/openid-configuration
,可以看到所有的文档。这将被您的客户端和API用于下载必要的配置数据。