功能入口：【平台配置管理】-【权限设置】-【黑白名单管理】 # **业务场景如下分为3类** ## **交易黑名单：** 列表包含字段：校验对象、工号、证件号、证件号前缀、手机号、手机号前缀、工号、姓名、姓名关键字、平台、法人、保险公司、险种、产品名称、产品编码、状态、开始时间、结束时间、操作人、操作（详情、编辑、删除）； 新增\\编辑\\详情页面的【校验对象配置】标题后显示提示按钮，点击后显示提示气泡，内容为： *\*注：配置字段数据完全匹配时才会被成功校验。例如配置了手机号和姓名，外部调用黑白名单接口时传递了手机号和姓名且和配置的手机号和姓名相同，校验对象才会被校验，匹配其一或者多传了另外一个校验对象配置则不会被校验。* **查询条件说明：** *1.控制时效* 能够查询**时间范围**为不限制的数据，以及时间范围有交集的数据。例如控制时间范围查询条件是2022-08-04到2022-08-15，有一条数据是2022-08-01 到 2022-08-12有效，这条数据是有交集的，应该被查询出来 *2.状态* 生效：包含时间范围不限制，以及配置了时间范围，生效时间小于等于当前日期，失效时间大于当前日期的数据； 失效：配置了时间范围，且失效日期小于当前日期的数据 未启用：配置了时间范围，且开始时间大于当前日期的数据 ## **交易白名单：** 列表包含字段：校验对象、工号、产品名称、产品编码、状态、开始时间、结束时间、操作人、操作（详情、编辑、删除）； 控制时效与状态查询条件同交易黑名单 ## **登录黑名单：** 列表包含字段：校验对象、工号、证件号、证件号前缀、手机号、手机号前缀、工号、姓名、姓名关键字、平台、状态、开始时间、结束时间、操作人、操作（详情、编辑、删除）； 控制时效与状态查询条件同交易黑名单 **1、字段说明：** - 控制类型说明：          登录黑名单：不允许登录限制平台；          交易黑名单：不可见且不允许出单、投保限制范围中的产品；          交易白名单：可见且允许出单、投保限制范围中的产品； - 框定校验目标用户字段说明：      注：同一条数据中校验目标为交集关系；          校验对象：包含用户、投保人、被保人、不限制          手机号：根据手机号全位数精准校验，输入手机号后，手机号前缀字段不允许输入；          手机号前缀：根据手机号顺位校验，校验对象的手机号号与校验值顺位一致时会被校验到；输入手机号前缀后，手机号字段不允许输入；          证件号：根据证件号全位数精准校验；输入证件号后，证件号前缀字段不允许输入；          证件号前缀：根据证件号顺位校验，校验对象的证件号与校验值顺位一致时会被校验到；输入证件号前缀后，证件号字段不允许输入；          工号：根据工号全位数精准校验；          姓名关键字：根据姓名关键字顺位校验，校验对象的姓名中包含且连贯包含校验值时不给投保，例如限制了关键字是【杜政】，那【杜小政】是不符合校验的，但是【杜杜政】和【杜政杜】是符合校验的；输入姓名关键字后，姓名段不允许输入；          -姓名：根据姓名全字段精准校验；输入姓名后，姓名关键字段不允许输入； - 确定控制范围相关字段说明：  注：同一条数据中控制范围为交集关系；          平台：确定平台范围；          法人：确定法人范围；          保司：确定保险公司范围；          险种：确定险种范围；          产品名称\\产品编码：确定产品范围；          起止时间：控制的时间区间；          状态：控制时间内为生效状态，控制时间外为失效状态，未到开始时间为未启用状态； **2、前端显示规则：**    1）登录黑名单：统一显示提示弹窗，内容为“登录失败，无权登录该平台！”；    2）交易黑名单：“当前账号无法投保该产品！” **新增编辑弹窗规则：** 新增弹窗    1）字段规则说明：         黑白名单类型：单选必选项，默认不选择，包含登录黑名单、交易黑名单、交易白名单；        校验对象：单选必选项，默认不选择，包含无限制、用户、投保人、被保人、投被保人；         工号：非必填输入框，默认无内容，上限20位；校验对象为【代理人】时才会显示；当保存时未填该项，页面展示为“不限制”         手机号：非必填输入框，默认无内容，上限11位；当保存时未填该项，页面展示为“不限制”         手机号前缀：非必填输入框，默认无内容，上限11位；当保存时未填该项，页面展示为“不限制”；     证件号：非必填输入框，默认无内容，上限20位；当保存时未填该项，页面展示为“不限制”        证件号前缀：非必填输入框，默认无内容，上限20位；当保存时未填该项，页面展示为“不限制”        姓名：非必填输入框，默认无内容，上限10个汉字；当保存时未填该项，页面展示为“不限制”         姓名关键字：非必填输入框，默认无内容，上限10个汉字；当保存时未填该项，页面展示为“不限制”；         平台范围：显示时必选，默认选中所有平台，若选中「所有平台」时，不显示平台穿梭框，页面展示为“不限制”；选中「部分平台」时显示平台穿梭框；平台穿梭框内容为saas租户的所有自建平台；         法人：显示时必选，默认选中“不限制”，可下拉多选租户的法人；         保险公司：显示时必选，默认选中“不限制”，可下拉多选租户已配置的保险公司；         险种：显示时必选，默认选中“不限制”，可下拉多选险种；         产品范围：显示时必选，默认选中“不限制”，当选择“部分产品”时，显示产品列表，可新增、查询所有产品，也可删除、查询已添加的产品，列表每10条分页；         时间范围：必选项，默认选中“无止期”，当选中“设置截至时间”时，显示【起止日期】字段，可选择起止时间，精确到日；    2）未选中【黑白名单类型】字段时不显示【控制范围配置】下的字段，只显示提示文案：“请选择黑白名单类型”    3）选择类型为【登录黑名单】时，控制范围配置中，只显示平台范围、时间范围配置字段。    4）新增弹窗中操作按钮为【取消】【保存】；编辑弹窗按钮为【取消】【保存】；点击详情进入的弹窗内按钮为【编辑】 # **黑白名单命中** 黑白名单命中需满足以下条件 1. 校验对象配置中填写过的内容全部匹配（交集） 2. 控制范围中的所有条件匹配（交易） 只有上述条件同时满足时，才算命中 ***** 示例：  如上图所示，交易黑名单配置了校验对象、工号、手机号，以及控制范围中法人选择了榕数星直，保险公司选择了太平洋保险 接口传递数据如下 { 校验对象：用户， 工号： 54378432， 法人：榕数星直 } 此时是无法命中的，因为校验对象配置中填写了手机号，而传递的参数中缺少手机号，无法满足校验对象配交集的条件 ***** 参数为以下情况时也无法命中，因为控制范围配置中选择了具体的保险公司，下列参数也无法满足控制范围配置的交集条件 { 校验对象：用户， 工号： 54378432， 手机号：15391542389 法人：榕数星直 } ****** 下列参数同时满足了校验对象配置填写属性的交集，以及控制范围配置的交集 { 校验对象：用户， 工号： 54378432， 手机号：15391542389 法人：榕数星直， 保险公司：太平洋健康保险股份有限公司 }