本文介绍Ocelot中的配置管理,配置管理允许在Api网关运行时动态通过Http Api查看/修改当前配置。由于该功能权限很高,所以需要授权才能进行相关操作。有两种方式来认证,外部Identity Server或内部Identity Server。
1、外部Identity Server
修改 Startup
中的 ConfigureServices
方法如下:
public void ConfigureServices(IServiceCollection services)
{
services.AddMvc();
void options(IdentityServerAuthenticationOptions o)
{
o.Authority = "http://localhost:6000";
o.RequireHttpsMetadata = false;
o.ApiName = "api1";
}
services
.AddOcelot(new ConfigurationBuilder()
.AddJsonFile("configuration.json")
.Build())
.AddAdministration("/administration", options);
services
.AddAuthentication(JwtBearerDefaults.AuthenticationScheme)
.AddIdentityServerAuthentication("TestKey", options);
}
其中复用了Identity Server的配置。
2、内部Identity Server
修改 Startup
中的 ConfigureServices
方法如下:
public void ConfigureServices(IServiceCollection services)
{
services.AddMvc();
services.AddOcelot(new ConfigurationBuilder()
.AddJsonFile("configuration.json")
.Build())
.AddAdministration("/administration", "secret");
services
.AddAuthentication(JwtBearerDefaults.AuthenticationScheme)
.AddIdentityServerAuthentication("TestKey", options =>
{
options.Authority = "http://localhost:6000";
options.RequireHttpsMetadata = false;
options.ApiName = "api1";
});
}
其中为secret值为"secret",后边会用得到。
其上为添加配置管理的两种方式,本例中以内部Identity Server为例。
Administration一共提供了3组Api
Token获取
配置管理
缓存管理
其中Token获取Api只在使用内部Identity Server时有效。由于缓存的教程还没更新,所以缓存管理的Api在后边的文章介绍。
1、Token获取
使用Postman请求http://localhost:5000/administration/connect/token如下所示,可以获得一个token
token from internal id server.png
注意Body的数据类型要选择 form-data
,并且 client_secret
要填写代码中配置的secret,当前教程为secret。
2、配置管理
使用Postman请求http://localhost:5000/administration/configuration如下所示,获取配置
get configuration.png
使用上次获取的token。
以http://localhost:5000/GetUserInfo?name=Jonathan为例请求数据如下
GetUserInfo.png
可以成功请求并且获取数据。
然后修改配置如下
change configuration.png
注意此次请求为Post请求,并且不要忘记添加认证头token,此次请求的body参数为之前获取的配置并且修改了/GetUserInfo链接为/GetUserInfochanged。
再次使用Postman请求http://localhost:5000/GetUserInfo?name=Jonathan如下
GetUserInfo 404.png
得到了404,修改链接为http://localhost:5000/GetUserInfochanged?name=Jonathan再次请求如下
GetUserInfochanged.png
此次配置修改成功,打开到路径/OcelotTutorial/OcelotGetway/bin/Debug/netcoreapp2.0下有一个 configuration.Development.json
文件打开查看如下
configuration.Development.json.png
配置文件也已经修改。
可能在开发时会遇到修改完配置之后,下次调试时配置又回到了原来,是因为 configuration.json
选择成了总是复制,所以每次开始调试的时候都会替换 configuration.development.json
中的内容。
如果Ocelot Api网关程序没有读写文件的权限也会遇到修改配置失败的情况。
原文地址:https://www.jianshu.com/p/9e2fa5783211
.NET社区新闻,深度好文,欢迎访问公众号文章汇总 http://www.csharpkit.com