konga - More than just another GUI to Kong Admin API

我们知道 kong 的 admin api 是 rest api,意味着你可以通过 http 请求调用,同时意味着没有 gui,但是可以选择第三方的工具,比如 konga 、kong-dashboard 等,本文的主题是 konga,在阅读本文之前建议您先阅读 kong 开源微服务 API 网关 ,本文的内容和这篇的内容有一定关系,你可以理解为是它的中篇吧,中篇?不错,kong 会有一系列博文,我们进入主题。

konga 的介绍

首先,我们看看 konga 的介绍以及能做什么吧,github地址是:https://github.com/pantsel/konga ,官方的介绍是 不只是另外一款管理 kong admin api的gui,至于能做什么,可以归结如下:

  1. 管理 kong 所有的 admin api
  2. 管理多个节点的 kong
  3. 数据导入导出
  4. 监控 kong 节点以及 api
  5. 多用户支持
  6. 邮件提醒

看起来很不错的样子,关键是兼容性 ok,那么,我们看看如何安装吧。

konga 的安装和使用

安装可以用下面的命令:

docker run --network=host --name konga -e "NODE_ENV=production" -itd pantsel/konga

这里,development 可以改为 production,安装后 打开 http://localhost:1337 ,用户名为 admin  密码为  adminadminadmin,另外,这里的 kong-net 为我之前为 kong 创建的网络,具体请看  kong 开源微服务 API 网关  ,登陆进去后可以添加 连接,地址为  http://kong:8001  ,接着,你可以添加服务以及消费者并创建应用了,当然还可以添加 oauth2。

创建 service、routes、consumers

接下来,我们创建一个服务,api-ssyer,并用 local.ssyer.com 作为客户端访问的域名,而 kong 则代理到 web.ssyer.com,并添加消费者和创建应用。

首先,点击左侧的 service,接着点击 add new service,弹出来的窗口里,填写的是 proxy server 的信息,即你要代理到的地址,一般是内网地址,但是,只要你记得这里填写的信息是 被代理的服务器的信息就足够了,比如,要实现 访问 local.kpromise.top 时代理到 web.ssyer.com 那么,这里填写的信息是 web.ssyer.com 的。

创建完 service 后 进入这个 service 的详情页,然后点击 route,这里填写的信息是 暴露给终端用户的,比如 local.kpromise.top ,但是要记得,填写完后需要按回车确认,这个和上面的不太一样。现在,你可以通过local.kpromise.top 作为别名调用 web.ssyer.com 的api 了,不过,记得将local.kpromise.top写到你的hosts文件里,确保解析的是 127.0.0.1,route 创建完毕后,点击 plugins,然后添加插件,选择 oauth2,在弹出的窗口里 打开 mandatory scope、并在 scopes 里填写需要的权限,之后打开 global credentials 和 enable authorization cod 选项,并删除 provision key 里的 function,否则创建好之后 provision key 的值就是 function,感觉是 bug …添加插件后再调用 local.kpromise.top 发现输出是: {"error_description":"The access token is missing","error":"invalid_request"},不错,需要 oauth2了。

进行 oauth2 授权

现在,我们创建 consumer,点击左侧 consumer ,然后点击创建,随便输入 用户名和用户id即可,创建完成后进入其详情页,点击 credentials 我们添加 oauth2 验证,首先,点击 oauth2,接着点击 create credentials,弹出的窗口里,需要填写 应用名以及 授权后的跳转链接,创建完成后 点击 应用名旁边的 眼睛 你将看到 client_id 以及 client_secret 等信息。

现在我们 服务创建完毕了,并且添加了 oauth2 验证,并创建了消费者以及应用,那么,我们接下来进行 oauth2 授权,然后通过 access_token 访问 api

curl -X POST https://local.kpromise.top:8443/oauth2/authorize --data "client_id=wfXkVmQyw9e6SScTME8OU2Ik75jnY3xE" --data "response_type=code" --data "scope=userInfo" --data "authenticated_userid=kpromise" --data "provision_key=zm074CKz8peOz2f2xtvdWdRlPKLTJH7Q" --insecure

这里,client_id 是创建 consumer 后创建的应用的 client_id,而 provision_key 是在给服务添加 oauth2 插件时你填写的  provision key 或者自动生成的  provision key,这行命令的输出如下:

{"redirect_uri":"https:\/\/www.ssyer.com\/oauth2?code=eUYtcNk1DvoOD3iQUnjEDtuQ3e3YUbXE"}

这里的 code 就是 oauth2 生成的 code,接下来用 code 交换 access_token 以及 refresh_token

curl -X POST https://local.kpromise.top:8443/oauth2/token --data "client_id=wfXkVmQyw9e6SScTME8OU2Ik75jnY3xE" --data "client_secret=14Nncu2x5AQ3ourfisRS2TUCBVv4ydO9" --data "grant_type=authorization_code" --data "code=eUYtcNk1DvoOD3iQUnjEDtuQ3e3YUbXE" --insecure

输出:

{"refresh_token":"ozFW1ToPXhqGyt0V1rwj2HDfJ3DU5ekw","token_type":"bearer","access_token":"55kzSAk46yvvFlcKPTxOdWbUlGPiLnq5","expires_in":7200}

接下来,我们调用 api:curl -X GET https://local.kpromise.top:8443/tag/hotTag?access_token=55kzSAk46yvvFlcKPTxOdWbUlGPiLnq5

最终发现 正常返回,而 web.ssyer.com 这边收到的请求的 header 如下:

'X-Consumer-ID': 'd855a97b-f21b-4373-a94e-249595a6c1b4',
'X-Consumer-Username': '123456',
'x-authenticated-scope': 'userInfo',
'x-authenticated-userid': 'kpromise'

这里,kpromise 是关键,获取 code 的时候曾经 传递过 authenticated_userid ,这里的 kpromise 便是 authenticated_userid 的值。

通过以上短暂的介绍,我相信你已经入门,但是依旧有一些问题,比如证书,我们可是用  --insecure 的,正式环境这不可能哦,另外 access_token 当作参数传递,这也有问题吧。预知解决之道,请待我更新。

本博客若无特殊说明则由 full-stack-trip 原创发布
转载请点名出处:全栈之旅 > konga - More than just another GUI to Kong Admin API
本文地址:https://www.kpromise.top/konga-gui-to-kong-admin-api/

发表回复

您的电子邮箱地址不会被公开。 必填项已用*标注