# 常见问题

文档版本 内容修订 修订人 修订日期
V1.0 正式发布 王垚 2021-02-05
V1.1 追加关闭用户认证,重连数据库 王垚 2021-02-22
V1.2 添加更新密钥的方式 王垚 2021-03-23
V1.3 添加证书作用说明和 Win10 配置端口证书 王垚 2021-03-23
V1.4 多开窗口不显示问题 张宇 2021-04-27
V1.5 跨域配置,弹窗屏蔽时间设置 王垚 2021-08-08

# 如何获取软件?

下载地址: 上海三思通用中控 (opens new window)

下载URL: http://release.sansi.online/pkg/index.html?id=com.sansi.ccs.platform&history=true

通过上面的下载链接,到的通用中控软件为 x86_64 的二进制版本, 适用于在 x86 架构下的 64 位系统上运行, 如果需要 ARM 架构等特殊版本, 请联系研发团队获取.

相关辅助软件下载:


# 无法登录?

在开启 HTTPS 认证情况下登录过系统,关闭 HTTPS 后再去登录,发现无法登录。请重新开启 HTTPS 或者按照如下步骤操作: img_001

img_002

问题原因: 由于之前在 HTTPS 下设置了用户的 sid 到 Cookie 中,切换到 HTTP 模式后,浏览器读到了 HTTPS 设置的数据,拒绝重新设置新的 Cookie 数据,导致无法正常完成认证流程,清除 Cookie 数据或者重新开启 HTTPS 认证即可解决该问题。

相关链接:Browsers ignore Set-Cookie response header if we try to set a cookie which was Secure before (opens new window)

# 无法将网页添加到桌面?

在安卓平板上,无法在 Chrome 中将网页添加到桌面。可能是因为权限不足,需要开启添加到桌面的权限,在按照以下步骤操作:

设置 => 权限管理 => Google Chrome => 发送到桌面 =>开启发送到桌面权限

# 如何关闭用户认证模式?

到用户目录下检查 Sansi/CCS-Platform/config/ccs-server.json 配置文件。

将 true 修改为 false,即可关闭用户认证模式。之后重启软件即可关闭用户权限认证。

img_004

# 如何连接到新的数据库?

到用户目录下检查 Sansi/CCS-Platform/config/ccs-server.json 配置文件。

将 arangodb 字段后对面的内容删除,调整到如下所示,重启软件,即可重新指定数据库。

img_005

# 更新用户根密钥?

在配置文件中存在一个 encrypt_key 属性,该属性用于生成加密密钥,如果需要调整加密信息,请直接修改该属性即可。

可以将该属性指定为任意字符串,或者将该属性置空,当该属性为空时,会自动生成一段随机字符串填充该属性。

注意:当更新完用户密钥后,需要重新放置证书文件,否则证书无法正常解密可能导致程序出现异常。

img_006

# 如何开启拼控服务跨域

到用户目录下检查 Sansi/CCS-Platform/config/ccs-server.json 配置文件。

设置 proxy 为 true,并设置 proxy_cy 为拼控服务地址。

img_007

# 修改弹窗屏蔽时间

到用户目录下检查 Sansi/CCS-Platform/config/ccs-editor.json 配置文件。

当设备发生故障时,会弹窗提示用户,每检查一次就会进行提示一次,如果用户觉得提示过于频繁,可以通过设置弹窗屏蔽时长来限制弹窗的弹出频率。可以调整的参数有两个:

参数名称 参数类型 参数描述
SYSTEM_NOTIFY_WAIT_TIME number 系统级别的弹窗提示频率,默认为 600 秒,即 10 分钟
WEB_NOTIFY_WAIT_TIME number WEB 网页的弹窗提示频率,默认为 5 秒

notify_config_001

# 无法访问到服务?

无法正常访问服务请按照以下步骤检查:

img_003

# SSL 证书生成和用途

# 证书生成脚本
# 支持一键生成绑定IP的证书,生成的文件格式如下:
# pfx: Transfer 服务端证书
# crt + key:中控服务端证书
# pem: ArangoDB 服务端证书
#
# cer 或者 crt: 客户端证书

psw=Sansi@1280
if [ ! -d cert ]; then
  mkdir cert
fi
function makeSSL() {
  NAME=$1
  DNS=$2
  IP=$3
  echo $NAME $DNS $IP
  if [ ! -d "cert/$IP" ]; then
    mkdir "cert/$IP"
  fi
  openssl req -x509 -newkey rsa:4096 -sha256 -days 3650 -nodes -keyout "cert/$IP/$NAME.key" \
    -out "cert/$IP/$NAME.crt" -subj "/CN=$NAME-$IP" -addext "subjectAltName=DNS:$DNS,IP:$IP"
    
  cat "cert/$IP/$NAME.crt" "cert/$IP/$NAME.key" >"cert/$IP/$NAME.pem"
  
  openssl x509 -in "cert/$IP/$NAME.crt" -out "cert/$IP/$NAME.cer" -outform der
  openssl pkcs12 -export -inkey "cert/$IP/$NAME.key" -in "cert/$IP/$NAME.crt" -passout pass:"$psw" -out "cert/$IP/$NAME.pfx"
  echo "end ssl"
}

echo -n "请输入指定 IP 地址(默认为 localhost):"
read ip
echo "ip = $ip"
if [ "$ip" = "localhost" ]; then
  makeSSL localhost localhost 127.0.0.1
elif [ "$ip" = "127.0.0.1" ]; then
  makeSSL localhost localhost 127.0.0.1
elif [ "$ip" = "" ]; then
  makeSSL localhost localhost 127.0.0.1
else
  makeSSL SANSI_CCS ccs.sansi.com "$ip"
fi

# Windows 10 配置端口证书

为 Windows 服务端口安装证书,安装文件的格式需要携带证书和私钥,此处以 pfx 格式的证书为例讲解安装过程。

备注: CCS_Transfer 服务配置 SSL 需要通过服务端口进行绑定

安装过程中如果出现 SSL 证书添加失败, 错误: 1312 指定的登录会话不存在。 (opens new window) 请检查证书安装位置是否在本地计算机->个人下。

# 1. 安装证书

双击 pfx 文件进入安装程序,之后安装步骤执行即可。

win_ssl_00

win_ssl_01

win_ssl_02

win_ssl_03

Sansi 签发的证书默认密码为 Sansi@1280

win_ssl_04

win_ssl_05

win_ssl_06

win_ssl_07

win_ssl_08

# 2. 查看证书指纹

接下来为查看证书指纹和检查证书是否安装到正确位置的过程。

首先使用快捷键 Win + R 打开运行窗口,在输入框里吗输入 MMC 打开控制台管理程序。

win_ssl_09

打开控制台管理程序后在右上角文件处选择 文件 -> 添加/删除管理单元

win_ssl_10

win_ssl_11

win_ssl_12

win_ssl_13

win_ssl_14

添加完证书管理单元后,去查看对应目录中是否已经安装好了证书。选择 证书 -> 个人 -> 证书 进行查看,如下图所示表明证书已经正确安装了。双击证书,查看证书详情。

win_ssl_15

win_ssl_16

将指纹信息记录下来,稍后会用到。

# 3. 证书绑定

先使用管理员身份运行 PowerShell 。

win_ssl_17

之后在 PowerShell 中通过命令绑定端口或者解除绑定。其流程如下。

win_ssl_18

相关指令:

PS C:\Users\ccc> netsh 													# 进入网络配置
netsh> http show sslcert												# 查看端口绑定状态
netsh> http add sslcert ipport=0.0.0.0:9009 certhash=537cf713b335168bec44f03f815d04f2f3855715 appid={00112233-4455-6677-8899-AABBCCDDEEFF} 										# 绑定端口,注意替换 certhash 为证书指纹
netsh> http delete sslcert ipport=0.0.0.0:9009 	# 解除绑定
netsh> quit																			# 退出网络配置

# 多开窗口不显示问题

部分型号的集中式拼接器单个输出信号最大支持开8个窗,多开窗口会不显示。