.NET Core API网关Ocelot(十四)【转换Claims,日志，跟踪】

Ocelot允许用户访问claims并把它们转换到头部,请求字符串参数和其他claims中.这仅在用户通过身份验证后才可用。

用户通过身份验证之后,我们运行claims转换中间件.这个中间件允许在授权中间件调用之前转换claims.当用户身份验证之后,首先会调用claims转换到头的中间件,然后调用claims转换到查询字符串的中间件，最后调用claims转换到downstream路径中间件.

执行转换的语法对于每个处理都是相同的。在Route配置中，使用特定名称AddClaimsToRequest，AddHeadersToRequest，AddQueriesToRequest添加一个json字典。

注意,我不是一个编程专家,所以不知道这个语法是否好…

在词典中，这些条目指定了Ocelot应该如何转换！字典的键将成为claim,header,query parameter的键。对于ChangeDownstreamPathTemplate，还必须在DownstreamPathTemplate中指定key，以便进行转换。

条目的值将被解析成转换的逻辑.首先指定了一个字典访问器,例如Claims[CustomerId].意思是我们想访问claims并获取键为CustomerId的claim类型.然后一个大于号(>)用于分隔.下一个条目是值或带索引器的值.如果指定了单个值，Ocelot将取该值并将其添加到变换中。如果该值有一个索引器，Ocelot将查找在另一个大于符号后面提供的分隔符。然后，Ocelot会使用分隔符将值分开，并将所需的索引添加到转换中。

`Claims`到 `Claims`转换

下面是一个Claims到Claims转换的例子

"AddClaimsToRequest": {"UserType": "Claims[sub] > value[0] > |","UserId": "Claims[sub] > value[1] > |"
}

这显示了Ocelot查看用户的sub声明并将其转换为UserType和UserId声明的转换。假设sub声明看起来像这样“usertypevalue | useridvalue”。

Claims到`header`的转换

下面是一个Claims到头转换的例子

"AddHeadersToRequest": {"CustomerId": "Claims[sub] > value[1] > |"
}

这显示了Ocelot查看用户的sub声明并将其转换为CustomerId头的转换。假设sub声明看起来像这样“usertypevalue | useridvalue”。

Claims 到查询字符串参数的转换

下面是一个Claims到查询字符串参数转换的例子

"AddQueriesToRequest": {"LocationId": "Claims[LocationId] > value",
}

这显示了Ocelot查看用户的LocationId声明并将其作为发往下游服务的查询字符串参数LocationId的转换。

Claims 到`Downstream`路径转换

以下是将claims转换为下游路径自定义占位符的示例配置

"UpstreamPathTemplate": "/api/users/me/{everything}",
"DownstreamPathTemplate": "/api/users/{userId}/{everything}",
"ChangeDownstreamPathTemplate": {"userId": "Claims[sub] > value[1] > |",
}

这显示了一个转换，其中Ocelot着眼于用户userId声明，并将该值替换为DownstreamPathTemplate中指定的“ {userId}”占位符。考虑到ChangeDownstreamPathTemplate中指定的密钥必须与DownstreamPathTemplate中指定的占位符相同。

注意：如果ChangeDownstreamPathTemplate中指定的键在DownstreamPathTemplate中不作为占位符存在，则它将在运行时失败，并在响应中返回错误。

日志

目前，Ocelot使用标准的日志记录接口ILoggerFactory / ILogger<T> 。在IOcelotLogger / IOcelotLoggerFactory中提供了标准的asp.net core日志记录的一个实现。因为Ocelot在日志中添加了一些额外的信息，如请求ID（如果已配置的话）。

这有个全局的错误处理程序，可以捕获所有异常并作为错误记录他们。

最后，如果日志记录设置为跟踪级别，Ocelot将记录开始，结束和任何抛出异常的中间件，这些异常可能非常有用。

不是使用标准框架的日志记录的原因是，我无法覆盖将IncludeScopes设置为true时记录的请求标识。

警告
如果您记录日志到控制台，您将获得糟糕的性能。我遇到过很多关于Ocelot性能的问题，它始终记录调试级别的日志，并记录到控制台