单管理节点场景

默认HTTPS方式

初始状态下，支持使用系统默认证书以HTTPS方式登录UI。

在管理节点执行以下命令，停止管理节点服务和UI服务
```
zstack-ctl stop
```

确保VNC控制台支持HTTPS功能。

执行以下命令，查看证书的路径和私钥密码（初始状态下均为系统默认值）。

zstack-ctl show_ui_config

例如：

[root@localhost ~]# zstack-ctl show_ui_config db_url = jdbc:mysql://10.0.233.184:3306 db_username = zstack_ui db_password = zstack.ui.password mn_host = 127.0.0.1 mn_port = 8080 webhook_host = 127.0.0.1 webhook_port = 5000 server_port = 5000 log = /usr/local/zstack/apache-tomcat/logs enable_ssl = false ssl_keyalias = zstackui ssl_keystore = /usr/local/zstack/zstack-ui/ui.keystore.p12 //证书路径 ssl_keystore_type = PKCS12 ssl_keystore_password = password //私钥密码

由于UI默认支持PKCS12格式证书，VNC控制台代理默认支持x509格式证书，如希望VNC控制台代理也能使用UI证书，需将PKCS12格式证书转换成x509格式。
```
openssl pkcs12 -in /path/to/mykeystore.p12 -out ui.keystore.pem -nodes
```
其中，/path/to/mykeystore.p12是PKCS12格式的证书，ui.keystore.pem是转换后x509格式的证书。
例如：
```
[root@localhost ~]# openssl pkcs12 -in /usr/local/zstack/zstack-ui/ui.keystore.p12 -out ui.keystore.pem -nodes Enter Import Password: MAC verified OK
```
进入/usr/local/zstack/apache-tomcat/webapps/zstack/WEB-INF/classes/zstack.properties修改zstack.properties配置文件，将证书路径设置为绝对路径（绝对路径指向证书私钥密码文件）。
```
consoleProxyCertFile = /usr/local/zstack/zstack-ui/ui.keystore.pem
```

执行以下命令，将基于默认配置自动生成证书，并使用默认证书以HTTPS方式登录UI，端口默认为5443。
```
zstack-ctl config_ui --enable-ssl True
```
在管理节点执行以下命令，启动管理节点服务和UI服务
```
zstack-ctl start
```
使用Chrome浏览器或FireFox浏览器进入ZStack Cloud管理界面（https://your_domain_name:5443），输入默认用户名和密码（admin/password），即可以默认HTTPS方式成功登录。
设置控制台代理地址。

登录UI界面，ZStack Cloud主菜单，点击运营管理 > 访问控制 > 控制台代理按钮，将控制台代理设置为your_domain_name，确保控制台正常打开。

自定义HTTPS方式

初始状态下，支持使用自定义证书以HTTPS方式登录UI。

准备好自定义证书，可使用相关工具生成自签证书，也可购买正规CA签发证书。

如使用Keytool（Java数据证书管理工具）生成自签证书：

mkdir certs  keytool -genkey -alias tomcat  -storetype PKCS12 -keyalg RSA -keysize 2048 -keystore ./certs/keystore.p12 -validity 365

例如：

[root@localhost ~]# mkdir certs [root@localhost ~]# keytool -genkey -alias tomcat  -storetype PKCS12 -keyalg RSA -keysize 2048 \ -keystore ./certs/keystore.p12 -validity 365 输入密钥库口令: 再次输入新口令: 您的名字与姓氏是什么?   [Unknown]:  Jack Chen 您的组织单位名称是什么?   [Unknown]:  ZStack 您的组织名称是什么?   [Unknown]:  DOC 您所在的城市或区域名称是什么?   [Unknown]:  SH 您所在的省/市/自治区名称是什么?   [Unknown]:  SH 该单位的双字母国家/地区代码是什么?   [Unknown]:  CN CN=Jack Chen, OU=Cloud, O=DOC, L=SH, ST=SH, C=CN是否正确?   [否]:  是 [root@localhost certs]# ls keystore.p12

在管理节点执行以下命令，停止管理节点服务和UI服务
```
zstack-ctl stop
```
确保VNC控制台支持HTTPS功能。
1. VNC控制台代理默认支持x509格式证书，如有需要，进行证书格式转换。
  如将PKCS12格式证书转换成x509格式：
```
openssl pkcs12 -in /path/to/mykeystore.p12 -out ui.keystore.pem -nodes
```
  其中，/path/to/mykeystore.p12是PKCS12格式的证书，ui.keystore.pem是转换后x509格式的证书。
  例如：
```
[root@localhost ~]# openssl pkcs12 -in /root/certs/keystore.p12 -out ui.keystore.pem -nodes Enter Import Password: MAC verified OK
```
2. 修改zstack.properties配置文件，将证书路径设置为绝对路径（绝对路径指向证书私钥密码文件）。
```
consoleProxyCertFile = /usr/local/zstack/zstack-ui/ui.keystore.pem
```

执行以下命令，自定义证书别名、证书路径、证书类型、私钥密码、HTTPS登录端口等信息，并使用自定义证书以HTTPS方式登录UI。

zstack-ctl config_ui --enable-ssl True \ --ssl-keyalias=*** --ssl-keystore=*** --ssl-keystore-type=*** \ --ssl-keystore-password=*** --server-port=*** --webhook-port=*** //将自定义参数信息记录到zstack.ui.properties配置文件 //包括设置：启用HTTPS功能、证书别名、证书路径、证书类型、私钥密码、HTTPS登录端口  zstack-ctl show_ui_config //可查看自定义参数信息  zstack-ctl stop_ui zstack-ctl start_ui //每次以HTTPS方式登录UI

例如：

[root@localhost ~]# zstack-ctl config_ui --enable-ssl True \ --ssl-keyalias=tomcat --ssl-keystore=/root/certs/keystore.p12 --ssl-keystore-type=PKCS12 \ --ssl-keystore-password=password --server-port=8888 [root@localhost ~]# zstack-ctl show_ui_config db_url = jdbc:mysql://10.0.233.184:3306 db_username = zstack_ui db_password = zstack.ui.password mn_host = 127.0.0.1 mn_port = 8080 webhook_host = 127.0.0.1 webhook_port = 5000 server_port = 8888 log = /usr/local/zstack/apache-tomcat/logs enable_ssl = true ssl_keyalias = tomcat ssl_keystore = /usr/local/zstack/zstack-ui/ui.keystore.p12.cp ssl_keystore_type = PKCS12 ssl_keystore_password = password [root@localhost ~]# zstack-ctl stop_ui successfully stopped the UI server [root@localhost ~]# zstack-ctl start_ui successfully started UI server on the local host, PID[32166], https://10.0.233.184:8888

在管理节点执行以下命令，启动管理节点服务和UI服务。
```
zstack-ctl start
```
使用Chrome浏览器或FireFox浏览器进入ZStack Cloud管理界面（https://your_domain_name:your_server_port），输入默认用户名和密码（admin/password），即可以自定义HTTPS方式成功登录。
说明:
若使用FireFox浏览器无法正常打开VNC控制台，请按如下步骤解决：
1. 使用FireFox浏览器访问https://your_domain_name:4900；
2. 根据FireFox浏览器的提示，将https://your_domain_name:4900添加到安全例外（Exception）；
3. 使用FireFox浏览器打开VNC控制台。
更多详情可参考FireFox官网文章。
设置控制台代理地址。

登录UI界面，ZStack Cloud主菜单，点击运营管理 > 访问控制 > 控制台代理按钮，将控制台代理设置为your_domain_name，确保控制台正常打开。

恢复HTTP方式登录UI

执行以下命令，将zstack.ui.properties中关于HTTPS功能的相关参数恢复到系统默认值。
```
zstack-ctl config_ui --restore
```

执行zstack-ctl stop_ui及zstack-ctl start_ui即可。

例如：

[root@localhost ~]# zstack-ctl config_ui --restore [root@localhost ~]# zstack-ctl show_ui_config db_url = jdbc:mysql://10.0.233.184:3306 db_username = zstack_ui db_password = zstack.ui.password mn_host = 127.0.0.1 mn_port = 8080 webhook_host = 127.0.0.1 webhook_port = 5000 server_port = 5000 log = /usr/local/zstack/apache-tomcat/logs enable_ssl = false ssl_keyalias = zstackui ssl_keystore = /usr/local/zstack/zstack-ui/ui.keystore.p12 ssl_keystore_type = PKCS12 ssl_keystore_password = password [root@localhost ~]# zstack-ctl stop_ui successfully stopped the UI server [root@localhost ~]# zstack-ctl start_ui successfully started UI server on the local host, PID[43261], http://10.0.233.184:5000

使用Chrome浏览器或FireFox浏览器进入ZStack Cloud管理界面（https://your_machine_ip:5000），输入默认用户名和密码（admin/password），即可恢复默认HTTP方式成功登录。
设置控制台代理地址

登录UI界面，ZStack Cloud主菜单，点击运营管理 > 访问控制 > 控制台代理按钮，将控制台代理设置为your_machine_ip，确保控制台正常打开。

至此，HTTPS方式登录UI的使用方法介绍完毕。

升级提醒

若您选择升级至4.0.0及之后版本，请注意以下功能调整：

1. 云路由器全面升级为VPC路由器，云路由网络全面升级为VPC网络，不再单独设云路由器页面。升级全程无感知，相关业务不受任何影响。

2. 企业管理账号体系取代用户组与用户，不再单独设用户/用户组页面，不可再使用用户/用户组账号登录云平台。升级前，请先将“用户组与用户”纳管的账号数据妥善迁移至“企业管理”纳管，再执行升级操作。注意：对于admin创建并具备admin权限的用户账号同步取消，如有需要，可使用企业管理账号体系中的平台管理员实现相同功能。

3. 调整AD/LDAP与账户的对接管理方式，统一由企业管理纳管，不再单独设AD/LDAP页面。升级前，请先将“账户”对接纳管的AD/LDAP账号数据妥善迁移至“企业管理”纳管，再执行升级操作。

如对上述升级提醒有任何疑问或需要升级帮助，请联系ZStack官方技术支持

默认HTTPS方式

自定义HTTPS方式

恢复HTTP方式登录UI

客户评论

撰写评论

产品

解决方案

支持

联系