第41章 CORS - Identity Server 4 中文文档(v1.0.0)

第41章 CORS

IdentityServer中的许多端点将通过基于JavaScript的客户端的Ajax调用进行访问。鉴于IdentityServer最有可能托管在与这些客户端不同的源上，这意味着需要配置跨源资源共享（CORS）。

41.1 基于客户端的CORS配置

配置CORS的一种方法是在客户端配置上使用AllowedCorsOrigins该集合。只需将客户端的原点添加到集合中，IdentityServer中的默认配置将查询这些值以允许来自源的跨源调用。

注意

配置CORS时，请务必使用原点（不是URL）。例如：https://foo:123/是一个URL，而是https://foo:123一个原点。

如果您使用我们提供的“内存中”或基于EF的客户端配置，则将使用此默认CORS实现。如果您定义自己的IClientStore，那么您将需要实现自己的自定义CORS策略服务（见下文）。

41.2 自定义Cors策略服务

IdentityServer允许托管应用程序实现ICorsPolicyService完全控制CORS策略。

要实现单一的方法是：Task<bool> IsOriginAllowedAsync(string origin)。如果允许原点则返回true，否则返回false

实现后，只需在DI中注册实现，然后IdentityServer将使用您的自定义实现。

41.2.1 DefaultCorsPolicyService

如果您只是希望对一组允许的原点进行硬编码，那么您可以使用一个预先构建ICorsPolicyService的实现调用DefaultCorsPolicyService。这将被配置为DI单例，并以其硬编码的AllowedOrigins收集，或设置标志AllowAll为true允许所有的源点。例如，在ConfigureServices：

var cors = new DefaultCorsPolicyService(_loggerFactory.CreateLogger<DefaultCorsPolicyService>())

{

    AllowedOrigins = { "https://foo", "https://bar" }

};

services.AddSingleton<ICorsPolicyService>(cors);

注意

AllowAll谨慎使用。

41.3 将IdentityServer的CORS策略与ASP.NET Core的CORS策略混合

IdentityServer使用ASP.NET Core的CORS中间件来提供其CORS实现。托管IdentityServer的应用程序可能还需要CORS用于自己的自定义端点。通常，两者应该在同一个应用程序中一起工作。

您的代码应使用ASP.NET Core中记录的CORS功能，而不考虑IdentityServer。这意味着您应该定义策略并正常注册中间件。如果您的应用程序在ConfigureServices中定义了策略，那么这些策略应继续在您使用它们的相同位置（在您配置CORS中间件的地方或在EnableCors控制器代码中使用MVC 属性的位置）。相反，如果您使用CORS中间件（通过策略构建器回调）定义内联策略，那么它也应该继续正常工作。

您使用ASP.NET Core CORS服务与IdentityServer之间可能存在冲突的一种情况是您决定创建自定义ICorsPolicyProvider。鉴于ASP.NET Core的CORS服务和中间件的设计，IdentityServer实现了自己的自定义ICorsPolicyProvider并将其注册到DI系统中。幸运的是，IdentityServer实现旨在使用装饰器模式来包装ICorsPolicyProvider已在DI中注册的任何现有模式。这意味着你也可以实现ICorsPolicyProvider，但它只需要在DI中的IdentityServer之前注册（例如，在ConfigureServices）。

github地址