introduction.md · WeBank/WeBASE-Cdapp

# 证书管理平台使用介绍

证书管理平台分为三个部分：证书配置后台服务（WeBASE-Cdapp）、证书配置前端web页面（WeBASE-Cdappadmin）、C端H5页面（WeBASE-Cdappf）

![](./images/CertificateS.png)

## 1. 环境搭建

### 1.1. 一键搭建

适合前后端同机部署，快速体验的情况使用。具体搭建流程参见[**安装文档**](./deploy/install.md)。

## 2. 证书配置平台

### 2.1. 登录

访问证书配置平台需先登录，默认账号密码**（admin/Test123）**。

![](./images/login.png)

首次登录需要重置密码。

![](./images/pwd_set.png)

后续如果想要修改密码，可以右上角选择修改按钮进行修改。

![](./images/pwd_update.png)

![](./images/pwd_update_value.png)

### 2.2. 新建配置

平台提供证书配置模板，可以拷贝模板进行配置，也可以直接新建配置。模板简介请查看[证书模板介绍](https://docs.qq.com/doc/DYXFmcnFSV25oQ0lS?code=ouRCcAHHbwzezGrz3mw6_JbxiqBIKbz-Hinp_Q5Vbls&state=weworklogin&code=3H6mmj0jVoOQCcjNJWT-O-UAlZIrdM9vZn6ep8Z-2wo&state=weworklogin)

![](./images/template.png)

### 2.3. 证书图片配置

本配置页可以设置证书名称、证书底图**（支持png/jpg）**、证书二维码链接、证书填充字段信息、证书编号字体大小、填充字段字体大小、二维码坐标。相关坐标基于设计图。

二维码链接说明：这里配置的二维码链接为 **二维码根URL** ，配置H5域名或者IP端口，生成证书后扫描证书二维码可以进入H5证书详情页。示例：

```
http://127.0.0.1:5011/
```

填充字段坐标说明：设计图对应填充信息的坐标。

证书填充字段信息可以导出Excel模板进行字段填充，用于后续导入数据。

![](./images/config_fields.png)

预览模板可以预览证书图片：

![](./images/config_fields_view.png)

### 2.4. 查询页配置

本配置页可以设置H5查询页，包括顶部banner、发证机构、搜索提示字段（下拉列表）、底部logo、技术支持说明文案。

![](./images/config_search.png)

预览模板可以预览证书查询页效果：

![](./images/config_search_view.png)

### 2.5. 查询结果页配置

本配置页可以设置H5查询结果页，包括标题、显示字段、底部logo、技术支持说明文案。

![](./images/config_result.png)

预览模板可以预览证书查询结果页效果，上链哈希在证书上链后才有：

![](./images/config_result_view.png)

### 2.6. 导入数据

本配置页可以导入获奖数据，Excel文件基于导出模板进行填充，可以先在【2.3. 证书图片配置】导出。文件上传后保存配置。

Excel文件导入数据时，数值和时间可以设置为文本格式，避免有问题。

![](./images/config_import.png)

数据导入没问题则跳转证书列表页，支持重新上传Excel、预览和下载证书。

![](./images/cert_list.png)

### 2.7. 证书上链

单击证书上链，则对证书进行上链，上链后证书内容不可修改。

![](./images/cert_cochain.png)

上链后证书状态更新为已上链状态：

![](./images/cert_chain.png)

### 2.8. 证书发布

如果H5查询页要支持证书查询，需要对证书进行发布，正常发布后，才可以在查询页进行查询。

![](./images/cert_publish.png)

发布后，如果不想支持在查询页进行查询，可以停止发布，将证书状态更新回已上链状态：

![](./images/cert_chain.png)

## 3. 证书H5页面

### 3.1. 查询页

**证书H5页面首页为查询页，访问URL由证书配置页配置的H5域名或IP端口加上后缀，后缀里的Id值为配置平台首页对应的配置证书ID。**

搜索框内查询条件由证书配置页设置。

```
后缀：/#/pages/index/search?Id=2
例如：http://127.0.0.1:5001/#/pages/index/search?Id=2
```

![](./images/cert_search.png)

### 3.2. 验证码

查询时需输入验证码。

![](./images/cert_code.png)

### 3.3. 证书列表

根据查询条件返回查询到的证书列表。

![](./images/cert_search_result.png)

### 3.4. 证书详情

展示证书图片和相关信息，展示字段由证书配置页设置。本页面支持证书下载（长按另存）。

证书详情也可以扫描证书二维码进入，返回箭头可以跳转查询页。

![](./images/cert_result.png)

## 4. 常见使用问题
如果出现下述错误，可以通过修改mysql的配置解决：

mysql> SHOW VARIABLES LIKE 'max_allowed_packet';

mysql> SET GLOBAL max_allowed_packet=734003200;

![输入图片说明](images/image.png)

WeBank/WeBASE-Cdapp

简介

发行版

贡献者

近期动态

WeBank/WeBASE-Cdapp .gitee-modal { width: 500px !important; }

简介

发行版

贡献者

近期动态

搜索帮助

WeBank/WeBASE-Cdapp