缘起
如题,想要用geoserver实现一个互联网地图那样的key许可功能,来控制地图服务的访问权限。
最终想要的效果就是类似下图中百度地图那样,申请个key,可以设置这个key能访问哪些地图服务资源,可以设置应用服务器ip白名单
然后把key放到地图API中,就能控制地图服务的访问权限。
可行性分析
要使用geoserver实现上述功能,需要解决下面3个问题:
- 如何实现key验证访问?
- 如何控制key能访问哪些地图服务?
- 如何实现服务器ip白名单?
如何实现key验证访问
geoserver发布的地图服务,默认没有进行权限控制,任何人拿到地址都可以访问地图。
我们想要的效果是,在访问geoserver服务时,需要在参数中增加一个key的参数,有这个key才能访问地图。
这个功能,geoserver是支持的
geoserver有个AuthKey的插件,支持接入外部的身份验证接口,我们可以通过自己编写外部的身份验证接口,来自己生成key、验证key,geoserver只负责转发和获取验证结果。外部接口返回的是geoserver用户名称。
然后再设置一下geoserver的拦截器,规定哪些请求必须要进行上面的验证。
如何控制key能访问哪些地图服务?
key的访问权限是通过geoserver用户的访问权限来设置的,前面验证key时,已经返回了用户名。
用户的权限通过角色控制,所以每次创建key时,需要同时创建用户和角色,并设置角色的访问权限。
这个环节可以使用geoserver的rest控制接口解决,使用rest控制接口可以通过程序自动完成上述配置。
如何实现服务器ip白名单
geoserver 作为一个服务端,它只能获取到客户端的ip,无法获取到应用服务器的ip。
如果想要获取的应用服务器的ip,就需要前端有个内应,这个内应就是js地图api,它可以在客户端的地址栏中获取到应用服务器的ip,然后传给服务端。
具体到geoserver这边,我们还是利用前面外部验证接口,在js地图Api中,把地址栏获取到的应用服务器ip和key拼一起,通过 AuthKey 的外部验证接口转发给自己的后台,后台再将ip提取出来。
地址栏ip和key的拼接,可以使用公钥、私钥模式,js地图api中使用公钥加密,后台使用私钥解密,这样可以避免明文传输ip地址。防止别人串改ip后非法访问地图。
这样就能实现对应用服务器ip的验证了。
流程梳理
好了,现在我们已经完成了可行性分析
接下来我们梳理一下,申请key和使用key访问地图的流程。
申请key
- 在申请地图key的页面,输入应用名称、应用部署的服务器ip、勾选需要的地图服务,然后生成个key
- 调用geoserver的rest控制接口,创建角色、用户、设置角色可以访问的地图服务
- 将key、应用服务器ip和geoserver用户进行关联并保存到数据库
访问地图
- 开发地图应用时,把申请到的key传入自己写的js地图api
- js地图api内部获取浏览器地址栏ip,这个ip就是应用服务器ip,将ip和key使用公钥加密,生成newkey,并在请求geoserver服务时将newkey作为参数传给geoserver
- geoserver的拦截器拦截到请求后,将newkey提取出来,转发给我们自己写的权限验证接口
- 权限验证接口接收到newkey后,使用私钥解密,就能获取到key和应用服务器ip,然后去数据库比对是否有符合这两个条件的数据,如果有就返回对应的geoserver用户名
- geoserver拦截器接收到验证接口返回的用户名后,查询该用户拥有的角色,再比对角色的权限中是否有本次请求的地图服务。有就返回数据,没有就打回。
这样一整套流程下来,就实现了用geoserver,实现类似互联网地图那样的key验证方式来控制地图的访问权限
实施步骤
接下来详细介绍一下拦截器设置和用户权限设置。
geoserver的拦截器设置一次就行。
key、用户、角色是一一对应的,所以每次新增key时,都要去通过rest接口去新建用户和角色并设置角色的地图访问权限。
拦截器设置
这一步其实就是通过界面来配置geoserver的拦截器,分两步,一是配置访问哪些地址时进行拦截,也就是配置拦截规则,二是配置拦截下来后验证key是否有效,也就是配置验证规则
具体操作为先配置验证规则,再将验证规则添加拦截规则中
配置key验证规则
按下图操作
低版本geoserver可能没有authkey功能,需要去官网下载对应版本的
Key authentication
插件并手动安装
点击AuthKey后,会出现下图中的界面
“1”那里自己随便填一个,比如就叫做uuid_authkey
。
“2”那里选择webservice
。这个选项的意思是,geoserver会使用外部接口验证key是否有效,到时geoserver会通过get方式将key传给外部接口,外部接口负责验证key是否有效,如果有效就返回用户名。
“3”那里配置外部接口的调用地址,geoserver调用时,会自动将{key}
换成真实的key
其它选项保持默认就可以
我用java写了个外部接口的示意代码,来大概说明一下里面的逻辑,其实就是根据key获取geoserver用户名
身份验证设置完以后点击保存按钮,它就会出现在下面的列表中。
配置服务拦截规则
接下来我们配置拦截规则,配置界面如下图:
我们点击最下面的 default
把我们刚才设置的身份验证规则添加到 anonymous
规则前面
这个列表从上到下是身份验证的先后顺序,anonymous
的意思是任何人可以匿名访问,如果把我们新增的规则放到了anonymous
的后面,就不会起作用了。
default
里面能拦截wms和wfs请求,但不会拦截wmts和tms请求,我们需要新建一个规则,用来拦截wmts和tms请求。
wmts和tms属于瓦片缓存,归geowebcache管理,geowebcache的网络请求地址为 gwc
,所以我们新建拦截规则时,规则设置为/gwc/**
,然后将我们的uuid_authkey
用户验证规则添加上,名称随便填一个,比如 tile
,如下图:
注意:这个页面没有保存按钮,编辑后需要返回上一个界面进行保存。
添加完成后,调整 tile
规则的位置,放到 default
上面,然后保存。
这样就实现了geoserver的key验证。
用户权限设置
这里直接列出需要使用的rest接口地址
名称 | 地址 |
---|---|
添加角色 | http://127.0.0.1:7200/geoserv...{role} |
添加用户 | http://127.0.0.1:7200/geoserv... |
用户指定角色 | http://127.0.0.1:7200/geoserv...{role}/user/{user} |
设置角色访问权限 | http://127.0.0.1:7200/geoserv... |
使用rest接口时要注意两点:
1、geoserver的rest接口原则上支持xml和json格式的参数,但实际不一定,如果你用其中一种格式没有成功,这时不要吊死在一棵树上,可以换个格式试试。我就遇到了在添加用户时xml格式好使json格式不好使,但在设置权限时xml格式又不好使,json格式好使。
2、设置角色访问权限
接口的参数和文档介绍的有所不同,这里要注意一下,正确的是下面这种:
{
"workspace.*.r": "rolename"
}
geoserver的rest接口说明:https://www.osgeo.cn/geoserver-user-manual/rest/index.html#rest
我用 Postman 导出了一份儿 java Unirest 的代码,供大家参考:http://gisarmory.xyz/blog/index.html?source=geosreverAuthkey
总结
- geoserver用户权限不仅支持对管理界面的控制,还支持对地图服务请求的控制
- 地图服务的控制需要结合key验证的方式实现,通过配置geoserver的拦截器和验证规则,可以把key和用户关联起来
- geoserver只支持对客户端ip的验证,想要验证应用服务器的ip,需要借助js地图api实现
参考资料:
- https://blog.csdn.net/a571574...
- https://blog.csdn.net/qq_3800...
- https://www.cnblogs.com/defin...
- https://www.cnblogs.com/Handy...
- https://www.osgeo.cn/geoserve...
- https://www.osgeo.cn/geoserve...
- https://github.com/geoserver/...
原文地址:http://gisarmory.xyz/blog/index.html?blog=geosreverAuthkey
欢迎关注《GIS兵器库》
本文章采用 知识共享署名-非商业性使用-相同方式共享 4.0 国际许可协议 进行许可。欢迎转载、使用、重新发布,但务必保留文章署名《GIS兵器库》(包含链接: http://gisarmory.xyz/blog/),不得用于商业目的,基于本文修改后的作品务必以相同的许可发布。
**粗体** _斜体_ [链接](http://example.com) `代码` - 列表 > 引用
。你还可以使用@
来通知其他用户。