前往小程序,Get更优阅读体验!
立即前往
首页
学习
活动
专区
工具
TVP
发布
社区首页 >专栏 >IdentityServer Topics(1)- 启动说明

IdentityServer Topics(1)- 启动说明

作者头像
晓晨
发布2018-06-22 15:38:23
6210
发布2018-06-22 15:38:23
举报
文章被收录于专栏:晓晨的专栏晓晨的专栏

启动

IdentityServer的启动是中间件和服务的组合来实现的。 所有配置都在你的启动类(Startup.cs)中完成。

配置服务

通过以下方式调用将IdentityServer服务添加到DI系统:

代码语言:javascript
复制
public void ConfigureServices(IServiceCollection services)
{
    var builder = services.AddIdentityServer();
}

这将返回一个生成器对象,而这个对象又有一些方便的方法来连接其他的服务。

密钥

  • AddSigningCredential 添加一个签名密钥服务,该服务将指定的密钥提供给各种令牌创建/验证服务。 您可以传入X509Certificate2SigningCredential或对证书存储区中证书的引用。
  • AddDeveloperSigningCredential 在启动时创建临时密钥。 这是仅用于开发场景,当您没有证书使用。 生成的密钥将被保存到文件系统,以便在服务器重新启动之间保持稳定(可以通过传递false来禁用)。 这解决了在开发期间client / api元数据缓存不同步的问题。
  • AddValidationKey 添加验证令牌的密钥。 它们将被内部令牌验证器使用,并将显示在发现文档中。 您可以传入X509Certificate2SigningCredential或对证书存储区中证书的引用。 这对于关键的转换场景很有用。

内存存储配置

各种“in-memory“配置API允许从配置对象的内存列表配置IdentityServer。 这些“in-memory”的集合可以在宿主应用程序中进行硬编码,也可以从配置文件或数据库动态加载。 但是,在设计时,只有托管应用程序启动时才会创建这些集合。

使用这些配置API可用于原型设计,开发和/或测试时不需要在运行时动态查询配置数据的数据库。 如果配置很少改变,这种配置方式也可能适用于生产方案,或者如果必须更改值,则需要重新启动应用程序并不方便。

  • AddInMemoryClients 添加基于IClientStoreICorsPolicyService的内存集合注册实现,以注册客户端配置对象。
  • AddInMemoryIdentityResources 添加基于IResourceStoreIdentityResource的内存集合注册实现,以注册身份验证资源。
  • AddInMemoryApiResources 添加基于IResourceStoreApiResource的内存集合注册实现,以注册API资源。

测试存储

TestUser类在IdentityServer中模拟用户,凭据和声明。 TestUser的使用与使用“in-memory”存储类似,因为它适用于原型开发和/或测试。 生产中不推荐使用TestUser

  • AddTestUsers 基于TestUserStoreTestUser对象的集合注册实现。 还注册IProfileServiceIResourceOwnerPasswordValidator的实现。

额外服务

  • AddExtensionGrantValidator 添加用于扩展授权的IExtensionGrantValidator实现。
  • AddSecretParser 添加用于解析客户端或API资源凭证的ISecretParser实现。
  • AddSecretValidator 添加ISecretValidator实现,以针对凭证存储验证客户端或API资源凭证。
  • AddResourceOwnerValidator 添加IResourceOwnerPasswordValidator`实现,用于验证资源所有者密码凭据授权类型的用户凭证。
  • AddProfileService 添加IProfileService以实现连接到您的自定义用户配置文件存储。DefaultProfileService`类提供了默认实现,它依靠身份验证cookie作为唯一的令牌发放源。
  • AddAuthorizeInteractionResponseGenerator 添加IAuthorizeInteractionResponseGenerator实现来在授权端点定制逻辑,以便显示用户错误,登录,同意或任何其他自定义页面的UI。 AuthorizeInteractionResponseGenerator类提供了一个默认的实现,因此如果需要增加现有的行为,可以考虑从这个现有的类派生。
  • AddCustomAuthorizeRequestValidator 添加ICustomAuthorizeRequestValidator实现,以在授权端点定制请求参数验证。
  • AddCustomTokenRequestValidator 添加ICustomTokenRequestValidator实现来定制令牌端点处的请求参数验证。
  • AddRedirectUriValidator 添加IRedirectUriValidator实现来自定义重定向URI验证。
  • AddAppAuthRedirectUriValidator 添加一个“AppAuth”(OAuth 2.0 for Native Apps)兼容的重定向URI验证器(进行严格的验证,但也允许随机端口为http://127.0.0.1)。
  • AddJwtBearerClientAuthentication 使用JWT对客户机认证的支持。

缓存

客户端和资源配置数据经常被IdentityServer使用。 如果从数据库或其他外部存储装载此数据,那么频繁地重新加载相同的数据代价可能是昂贵的。

  • AddInMemoryCaching 要使用下面描述的任何缓存,必须在DI中注册ICache的实现。 此API注册基于ASP.NET Core的ICache 的MemoryCache默认内存缓存实现。
  • AddClientStoreCache 注册一个IClientStore装饰器实现,它将维护客户端配置对象的内存缓存。 缓存持续时间可以在IdentityServerOptions上的缓存配置选项上配置。
  • AddResourceStoreCache 注册一个IResourceStore装饰器实现,它将维护IdentityResourceApiResource配置对象的内存缓存。 缓存持续时间可以在IdentityServerOptions上的缓存配置选项上配置。
  • AddCorsPolicyCache 注册一个ICorsPolicyService装饰器实现,它将维护一个CORS策略服务评估结果的内存缓存。 缓存持续时间可以在IdentityServerOptions上的缓存配置选项上配置。

可以进一步定制缓存: 默认缓存依赖于ICache实现。 如果您希望自定义特定配置对象的缓存行为,则可以在依赖注入系统中替换此实现。

ICache<T>的默认实现依赖于.NET提供的IMemoryCache接口(和MemoryCache实现)。 如果您希望自定义内存中的缓存行为,则可以替换依赖注入系统中的IMemoryCache实现。

配置中间件

您需要通过以下方式调用将IdentityServer添加到管道中:

代码语言:javascript
复制
public void Configure(IApplicationBuilder app)
{
    app.UseIdentityServer();
}

UseIdentityServer包含对UseAuthentication的调用,所以没有必要同时调用这两个。

中间件没有额外的配置。

请注意,添加顺序在管道配置中很重要。 例如,您需要在添加MVC中间件之前添加IdentitySever。

本文参与 腾讯云自媒体分享计划,分享自作者个人站点/博客。
原始发表:2017-12-29 ,如有侵权请联系 cloudcommunity@tencent.com 删除

本文分享自 作者个人站点/博客 前往查看

如有侵权,请联系 cloudcommunity@tencent.com 删除。

本文参与 腾讯云自媒体分享计划  ,欢迎热爱写作的你一起参与!

评论
登录后参与评论
0 条评论
热度
最新
推荐阅读
目录
  • 启动
    • 配置服务
    • 密钥
    • 内存存储配置
    • 测试存储
    • 额外服务
    • 缓存
    • 配置中间件
    相关产品与服务
    消息队列 TDMQ
    消息队列 TDMQ (Tencent Distributed Message Queue)是腾讯基于 Apache Pulsar 自研的一个云原生消息中间件系列,其中包含兼容Pulsar、RabbitMQ、RocketMQ 等协议的消息队列子产品,得益于其底层计算与存储分离的架构,TDMQ 具备良好的弹性伸缩以及故障恢复能力。
    领券
    问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档