KV配置
Last updated
Last updated
我们将一些配置数据从代码中抽离出来，形成KV配置与多语言配置。kv配置是对这些抽离出来的配置数据的编辑界面。此功能的开发是为了方便交易所运营方对交易所网站上的一些核心功能、测试繁杂的功能和重点界面进行直接编辑，以节省测试部门的人力和缩短每项改动配置的上线时间。
交易所品牌的配置主要包括logo、主站域名、icon、网页title、联系电话、短信签名等。交易所上线前，运营方必须在后台对这些品牌配置逐一进行修改，否则默认为空或链上科技相关文本。上线后，运营方仍可随时对其进行修改，详述见下。请注意，所有需要传图的地方，均可将图片上传至阿里云账号（见 文件上传），然后将生成的地址粘贴入对应位置即可。
如上图中所示的位置，可以依次编辑主站域名、联系电话、logo访问地址（需传图）、icon访问地址（需传图）和H5页面的登录logo（需传图）。点击修改并设置完成后，最右侧一栏的“发布上线”按钮变红，再点击【发布上线】，变为蓝色的【发布上线】，表示新的编辑已经同步到前台系统。
# 唯一key值：app_invitation_imgs
# 配置值：{"local_img_cn":"","local_img_en":"","online_img_cn":"","online_img_en":""}
# 配置说明：
"local_img_cn":"在这里填入尺寸为1125*1809的背景图片url，图片中文案需为中文","local_img_en":"在这里填入尺寸为1125*1809的背景图片url，图片中文案需为英文","online_img_cn":"在这里填入尺寸为1125px*1527的背景图片url，图片中文案需为中文","online_img_en":"在这里填入尺寸为1125px*1527的背景图片url，图片中文案需为英文"，
注意：1. 背景图左下角450px*450px的区域内不要设计关键信息，可能会被二维码遮挡；2. 建议图片格式为：不大于200k的.png格式文件；
3. 所谓长短只是因为实现逻辑需要不同尺寸的背景图，长短图内容要设计成一样的，只区分尺寸。
# 唯一key值：is_hide_agent_child_info
# 功能说明：控制前端经纪人信息页面下线信息是否做部分隐藏处理。
# 配置说明：配置值：1，即做部分隐藏；配置值：0，则全部显示。
隐藏后的效果如下：
# 唯一key值：is_enforce_google_auth
# 功能说明：开启后对用户币币提现、场外出售、发出红包等出金场景限制必须谷歌验证，未开启强制限制的，绑定手机或谷歌均可。
# 配置说明：配置：1，即开启强制；配置：0，即关闭。
# 唯一key值：CNY_otc_coinPrecision的值，CNY_coinPrecision
# 功能说明：
一、数字精度的作用
1. 显示：按照精度显示，超过则截尾显示，不足则自动补0至精度长度；
2. 输入框：控制输入框内小数点后可输入的位数；
二、前端的数字包括2种
1. 代表token的币种数量，如：数量、资产合计
2. 代表法币单位，如：单价、金额
三、控制逻辑
1. token精度：根据该币种的币种显示精度显示（超过则截尾显示，不足则自动补0至精度长度），或控制输入框内小数点后的位数控制。
2. 法币精度（场外模块）：区分法币币种控制，以CNY为例，先判断 KEY=CNY_otc_coinPrecision的值，无数据则判断KEY=CNY_coinPrecision的值，若都没有则取默认值为2；
3. 法币精度（除场外的其他模块）：区分法币币种控制，以CNY为例，先判断KEY=CNY_coinPrecision的值，若都没有则取默认值为2；
# 配置说明：默认为2, 配置数字。
如果您想限制指定国家的用户不能登录交易所（包括Web、H5、APP），可以在交易所后台管理系统 - 系统配置 - 基础配置 - KV配置 中搜索：LimitIpLoginCountryCode
配置值：输入想要限制的国家的国家代码，点击查询国家代码
说明：
修改后需要【发布上线】才能生效；
如果使用被限制国家的IP号段进行访问，会跳转到指定的说明页面；
如果用户使用VPN，即不使用被限制国家的IP号段，仍然可以正常使用交易所功能；
提示页面显示的暂停服务的国家根据KV配置的限制国家动态展示；
Web页面提示
APP&H5页面提示
限制注册
1）限制注册方式
如果您想限制登录&注册方式，比如只支持手机注册、同时支持手机和邮箱，可以在交易所后台管理系统 - 系统配置 - 基础配置 - KV配置 中搜索：login_regist_type
效果：
2）限制部分国家的手机号注册
如果您想限制指定国家的用户不能通过手机号进行登录&注册（包括Web、H5、APP），需要完成3步：
Step1. KV配置 中搜索：system_default_country_code，确认配置的值不是想要限制的国家的国际电话区号。
此处的配置值将决定用户登录&注册时，默认手机注册时，展示哪个国家的国际电话区号，如果想限制中国大陆，则配置值不能是+86。点击查看国际电话区号。
Step2. KV配置 中搜索：system_default_country_code_real，确认配置的值不是想要限制的国家的国家代码，此处的国家代码要和Step1中的国际电话区号所在国家保持一致。
Step3. KV配置 中搜索：exchange_limit_country_list，确认配置的值是想要限制的国家的国家代码。
发布上线后，选择手机进行注册&登录时，下拉选项中隐藏该国家的国际电话区号，用户无法选择，也收不到短信验证码。
3）限制部分国家的新用户注册
如果您想限制指定国家的用户可以继续登录使用，但不能进行新用户的注册，可以在交易所后台管理系统 - 系统配置 - 基础配置 - KV配置 中搜索：LimitIpRegisterCountryCode，确认配置的值是想要限制的国家的国家代码。
发布上线后，使用限制国家的IP号段进行手机&邮箱注册时，会提示：（通过VPN切换到非限制IP号段后，注册功能正常）。
功能概述：为避免单一验证系统出现问题，商户可在后台进行系统参数配置，灵活切换验证系统。配置生效后，用户在登录、注册等场景会调用对应的验证系统进行人机验证。配置流程如下：
准备Cloudflare配置参数：
注册账号地址：https://dash.cloudflare.com/
登录后，进入主页，点击左侧导航 Turnstile，页面内点击【添加站点】，如下图：
输入站点名称、域，选择小组件模式，点击创建。其中选择的小组件模式对应的在用户端展示的验证样式。如下图：
创建完成后，可查看【站点密钥、密钥】，如下图，将这两个值填入后台KV【sys_conf_cloudflare_config 】
在现货后台管理系统 - 系统配置 - 基础配置 - KV配置 中搜索：
sys_conf_geetest_config，配置极验账号相关配置，务必确认配置，否则验证不可用。
sys_conf_cloudflare_config ，Cloudflare账号相关配置，务必确认配置，否则验证不可用。
sys_conf_switch，Web验证总开关，管理Web、H5是否开启人机验证。配置：0表示关闭，1表示开启
access_open，后台验证开关，管理现货后台是否开启人机验证。配置：0表示关闭，1表示开启
sys_conf_validate，选择滑动验证服务商，管理Web、H5、现货后台验证方式。配置：0混合模式，2极验，3cloudflare。混合模式及为现有验证混合使用，随机验证。
app_access_open，App验证总开关，管理APP是否开启人机验证。配置：0表示关闭，1表示开启
app_sys_conf_validate，App验证方式。配置：0混合模式，2极验，3cloudflare。混合模式及为现有验证混合使用，随机验证。
验证方式配置除0、2、3以外的数字或为空时，默认调用极验验证
在合约后台管理系统 - 系统配置 - KV配置 中搜索：
sys_conf_geetest_config，配置极验账号相关配置，务必确认配置，否则验证不可用。
sys_conf_cloudflare_config ，Cloudflare账号相关配置，务必确认配置，否则验证不可用。
access_open，后台验证开关，管理合约后台是否开启人机验证。配置：0表示关闭，1表示开启
sys_conf_validate，选择滑动验证服务商，管理后台验证方式。配置：0混合模式，2极验，3cloudflare。混合模式及为现有验证混合使用，随机验证。
验证方式配置除0、2、3以外的数字或为空时，默认调用极验验证
KV编辑后，切记要发布上线方可生效，需要使用英文半角标点符号
注意：
配置好验证系统所需参数、验证类型，对应开关开启，验证功能才可用；
选择验证类型，开关开启，未配置sys_conf_cloudflare_config 或sys_conf_cloudflare_config 参数，用户端则会报错，后台不可登录；若不使用cloudflare，则sys_conf_cloudflare_config 为空无影响；
验证类型参数填写除0、2、3以外的数字，默认调用极验
开关未开启，不进行验证
