HugeGraph Hubble 配置 https 协议的操作步骤

背景

HugeGraph 图数据库的 Server 端支持 https 配置,官方文档中有说明相对比较容易,而 Hubble 部署过程都是 http的。

我们有一个应用要嵌入 hubble 页面,而且部署为 https ,那么 Hubble 是否支持配置 https 呢?网络上搜不到 hubble 的 https 配置说明,不知道别人都是怎么使用 HugeGraph 的,感觉能搜到的内容都很浅显。

跟源码,结合其他项目的 https 部署经验,最终找到了一种方法可以达到目标,本文将分享 HugeGraph Hubble 部署为 https 协议的过程。

部署方式确定

确定图数据库的各组件的版本及部署方式:

  1. HugeGraph Server 为 http,版本 V0.10.4
  2. Hubble 为 https,版本 1.6.0
  3. Hubble Web 嵌套的目标应用部署为 https

Hubble 启动脚本改造

跟踪 hubble 后端源码 hubble-be ,它是一个 spring-boot 项目,但是应用配置文件 application.properties 打包到类路径下了,应用启动通过指定主类并设置后台需要的根目录。

我们知道一个基于Spring 的 Java Web 应用部署为 https 通常只需要在配置文件中添加 server.ssl 配置项就可以了,有几个思路:

  1. 自定义一个 application.properties,放在哪里能生效呢?试了放在 lib 目录下,没有生效。
  2. 修改源码中的应用配置文件,重新打包,源码 maven 依赖下载失败,重打包还麻烦。
  3. 修改启动命令手动设置 ssl 的环境变量,这个最简单,直接复制一个 start-hubble.sh 文件,加上配置就可以了。

改造部署脚本 :进入 hugegraph-hubble-1.6.0/bin 目录下,拷贝一份启动文件重命名为 start-hubble-ssl.sh ,然后编辑该文件,大概在 63 行的位置,加上环境变量配置,67 行启动命令的 -Dhubble.home.path 前面加上 ${sslEnv}

powershell 复制代码
sslEnv=`echo -Dserver.ssl.enabled=true -Dserver.ssl.key-store=${HOME_PATH}/conf/hugegraph-server.keystore -Dserver.ssl.key-store-password=hugegraph`
echo 'ssl param is 'sslEnv
nohup nice -n 0 java -server ${java_opts} -Dhubble.home.path=${HOME_PATH} ${sslEnv} -cp ${class_path} ${main_class} ${args} > ${log} 2>&1 < /dev/null &

这里使用的证书是官网给出的 hugegraph server 的证书,密码是 hugegraph。

https 方式启动 Hubble :执行 start-hubble-ssl.sh ,由于 Tomcat 版本是 9.0.24 ,它的 SSL 启动有一个 Bug ,但不影响应用的访问: 异常说明参考《Tomcat SSL Support 异常说明》,如果有强迫症、见不得异常的话,直接升级 lib 目录下的 tomcat 9.0.24 的 三个 jar 为26 以上版本。

证书文件

官网上有 《hugegraph server 配置为 https 》 直接套用服务端的证书文件作为 hubble 的证书 hugegraph-server.keystore ,该文件在 1.0.0 的 server /conf 目录下,低版本 0.10.4 中没有。 如果服务端配置为该方式,那么还需要修改,同时官网 Hubble1.0.0 的配置文件少了可信任证书,需要从低版本 Hubble1.6.0 /conf 中弄一份 hugegraph.truststore 出来 ,并修改 hugegraph-hubble.properties 配置文件,添加一行 Server 端的协议类型:

java 复制代码
server.protocol=https

它的作用是配置 HugeGrape Server 请求客户端的协议为 https

启示录

本文用到的文件已经上传到 CSDN 资源库了,有需要的可以下载 hugegraph-hubble-1.6.0 https 配置文件

最后,再总结一下图数据库使用的部署方式:

  1. HugeGraph Server 配置为 https 时,Hubble 必须设置server.protocol=https保证与 Server 端通信正常。
  2. Hubble 自身部署方式默认是 http,如果有安全需要可以按本文配置为 https。
  3. Hubble 嵌套的目标系统如果是 https ,则 Hubble 也必须是 https 。
  4. Hubble 嵌套的目标系统如果是 http,则 Hubble 也必须是 http 。

版本维护工作不易,开源更不易!

相关推荐
程序员爱钓鱼1 小时前
Go语言实战案例-创建模型并自动迁移
后端·google·go
javachen__1 小时前
SpringBoot整合P6Spy实现全链路SQL监控
spring boot·后端·sql
uzong7 小时前
技术故障复盘模版
后端
GetcharZp7 小时前
基于 Dify + 通义千问的多模态大模型 搭建发票识别 Agent
后端·llm·agent
桦说编程7 小时前
Java 中如何创建不可变类型
java·后端·函数式编程
IT毕设实战小研7 小时前
基于Spring Boot 4s店车辆管理系统 租车管理系统 停车位管理系统 智慧车辆管理系统
java·开发语言·spring boot·后端·spring·毕业设计·课程设计
wyiyiyi8 小时前
【Web后端】Django、flask及其场景——以构建系统原型为例
前端·数据库·后端·python·django·flask
阿华的代码王国9 小时前
【Android】RecyclerView复用CheckBox的异常状态
android·xml·java·前端·后端
Jimmy9 小时前
AI 代理是什么,其有助于我们实现更智能编程
前端·后端·ai编程
AntBlack9 小时前
不当韭菜V1.1 :增强能力 ,辅助构建自己的交易规则
后端·python·pyqt