tencentcloud-sdk-python-essbasic 3.1.164__tar.gz → 3.1.169__tar.gz

{tencentcloud_sdk_python_essbasic-3.1.164 → tencentcloud_sdk_python_essbasic-3.1.169}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: tencentcloud-sdk-python-essbasic
-Version: 3.1.164
+Version: 3.1.169
 Summary: Tencent Cloud Essbasic SDK for Python
 Home-page: https://github.com/TencentCloud/tencentcloud-sdk-python
 Author: Tencent Cloud
@@ -15,7 +15,7 @@ Classifier: Programming Language :: Python :: 2.7
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.6
 Classifier: Programming Language :: Python :: 3.7
-Requires-Dist: tencentcloud-sdk-python-common<4.0.0,>=3.1.164
+Requires-Dist: tencentcloud-sdk-python-common<4.0.0,>=3.1.169
 
 ============================
 Tencent Cloud SDK for Python

{tencentcloud_sdk_python_essbasic-3.1.164 → tencentcloud_sdk_python_essbasic-3.1.169}/setup.py

@@ -8,7 +8,7 @@ ROOT = os.path.dirname(__file__)
 
 setup(
     name='tencentcloud-sdk-python-essbasic',
-    install_requires=["tencentcloud-sdk-python-common>=3.1.164,<4.0.0"],
+    install_requires=["tencentcloud-sdk-python-common>=3.1.169,<4.0.0"],
     
     version=tencentcloud.__version__,
     description='Tencent Cloud Essbasic SDK for Python',

{tencentcloud_sdk_python_essbasic-3.1.164 → tencentcloud_sdk_python_essbasic-3.1.169}/tencentcloud/__init__.py

@@ -14,4 +14,4 @@
 # limitations under the License.
 
 
-__version__ = '3.1.164'
+__version__ = '3.1.169'

{tencentcloud_sdk_python_essbasic-3.1.164 → tencentcloud_sdk_python_essbasic-3.1.169}/tencentcloud/essbasic/v20210526/essbasic_client.py

@@ -506,34 +506,33 @@ class EssbasicClient(AbstractClient):
 
 
     def ChannelCreateFlowByFiles(self, request):
-        r"""接口（ChannelCreateFlowByFiles）用PDF文件创建签署流程。
+        r"""本接口（ChannelCreateFlowByFiles）用于通过**已上传的 PDF 资源编号**创建待签署的合同流程。
 
-        适用场景：适用非制式的合同文件签署，开发者有每个签署流程的PDF，可以通过该接口传入完整的PDF文件及流程信息生成待签署的合同流程。
+        **适用场景**：适用于非制式的合同文件签署。当开发者已拥有每个签署流程完整的 PDF 文件时，可通过本接口传入完整的 PDF 文件及流程信息，生成待签署的合同流程。
 
-        **注**:
-        <ul>
-        <li>此接口静默签(企业自动签)能力为白名单功能，使用前请联系对接的客户经理沟通。</li>
-        <li>此接口需要依赖<a href="https://qian.tencent.com/developers/partnerApis/files/UploadFiles" target="_blank">文件上传接口</a>生成pdf资源编号（FileIds）进行使用。整体的逻辑如下图</li>
-        </ul>
+        ### 1.1 调用依赖
 
-        ![image](https://qcloudimg.tencent-cloud.cn/raw/bf86248a2c163228c4e894cf5926af69/ChannelCreateFlowByFiles.png)
-
-        **可以作为发起方和签署方的角色列表**
-        <table>     <thead>     <tr>         <th>场景编号</th>         <th>发起方</th>         <th>签署方</th>         <th>补充</th>     </tr>     </thead>     <tbody>     <tr>         <td>场景一</td>         <td>子企业A的员工</td>         <td>子企业A的员工</td>         <td>子企业是通过<a href="https://qian.tencent.com/developers/partnerApis/accounts/CreateConsoleLoginUrl" target="_blank">CreateConsoleLoginUrl</a>生成子客登录链接注册的企业</td>     </tr>     <tr>         <td>场景二</td>         <td>子企业A的员工</td>         <td>子企业B(不指定经办人走领取逻辑)</td>         <td>领取的逻辑可以参考文档<a href="https://qian.tencent.com/developers/partner/dynamic_signer" target="_blank">动态签署方</a> </td>     </tr>     <tr>         <td>场景三</td>         <td>子企业A的员工</td>         <td>子企业B的员工</td>         <td>-</td>     </tr>     <tr>         <td>场景四</td>         <td>子企业A的员工</td>         <td>个人</td>         <td>就是自然人，不是企业员工</td>     </tr>     <tr>         <td>场景五</td>         <td>子企业A的员工</td>         <td>SaaS平台企业员工</td>         <td>SaaS平台企业是通过<a href="https://qian.tencent.cn/console/company-register" target="_blank">https://qian.tencent.cn/console/company-register</a>链接注册的企业</td>     </tr>     </tbody> </table>
+        本接口需依赖[文件上传接口](https://qian.tencent.com/developers/partnerApis/files/UploadFiles)生成 PDF 资源编号（FileId）后使用，整体逻辑如下图：
 
+        ![image](https://qcloudimg.tencent-cloud.cn/raw/985b4bf10a40d65fe7b016bb2f82c3df.svg)
 
-        **注**:
-        `1. 发起合同时候,  作为发起方的第三方子企业A员工的企业和员工必须经过实名, 而作为签署方的第三方子企业A员工/个人/自然人/SaaS平台企业员工/第三方子企业B员工企业中的企业和个人/员工可以未实名`
+        ### 1.2  发起方和签署方
+        <table>     <thead>     <tr>         <th>场景编号</th>         <th>发起方</th>         <th>签署方</th>         <th>补充</th>     </tr>     </thead>     <tbody>     <tr>         <td>场景一</td>         <td>子企业A的员工</td>         <td>子企业A的员工</td>         <td>子企业是通过<a href="https://qian.tencent.com/developers/partnerApis/accounts/CreateConsoleLoginUrl" target="_blank">CreateConsoleLoginUrl</a>生成子客登录链接注册的企业</td>     </tr>     <tr>         <td>场景二</td>         <td>子企业A的员工</td>         <td>子企业B(不指定经办人走领取逻辑)</td>         <td>领取的逻辑可以参考文档<a href="https://qian.tencent.com/developers/partner/dynamic_signer" target="_blank">动态签署方</a> </td>     </tr>     <tr>         <td>场景三</td>         <td>子企业A的员工</td>         <td>子企业B的员工</td>         <td>-</td>     </tr>     <tr>         <td>场景四</td>         <td>子企业A的员工</td>         <td>个人</td>         <td>就是自然人，不是企业员工</td>     </tr>     <tr>         <td>场景五</td>         <td>子企业A的员工</td>         <td>SaaS平台企业员工</td>         <td>SaaS平台企业是通过<a href="https://qian.tencent.cn/console/company-register" target="_blank">https://qian.tencent.cn/console/company-register</a>链接注册的企业</td>     </tr>     </tbody> </table>
 
-        `2. 不同类型的签署方传参不同, 可以参考开发者中心的FlowApproverInfo结构体说明`
 
-        `3. 合同发起后就会扣减合同的额度, 只有撤销没有参与方签署过或只有自动签署签署过的合同，才会返还合同额度。（过期，拒签，签署完成，解除完成等状态不会返还额度）`
+         <font color="red">发起方（第三方子企业 A 的企业与员工）必须完成实名</font>；作为 **签署方** 的第三方子企业 A 员工 / 个人自然人 / SaaS 平台企业员工 / 第三方子企业 B 员工等，其企业和个人可以未实名。
 
-        `4. 静默（自动）签署不支持合同签署方存在填写功能`
+        ### 1.3 注意事项
+        -  合同<font color="red">发起后就会扣减合同的额度</font> , 只有撤销没有参与方签署过或只有自动签署签署过的合同，且<font color="red">有撤销合同额度</font>的情形下，才会返还合同额度。（**过期，拒签，签署完成，解除完成等状态不会返还额度**）。具体可以参考 [合同撤销返还额度说明](https://qian.tencent.com/developers/partner/contract_cancel_quota) 。
+        - <font color="red">支持的证件类型</font>可以参考 [支持的证件类型](https://qian.tencent.com/developers/partner/id_card_support) 。
+        - <font color="red">不同类型的签署方传参不同</font>，各类型签署方的信息传递方式详见  [签署方入参指引](https://qian.tencent.com/developers/partner/flow_approver) 。
+        - 如果合同正式发起前如需<font color="red">预览</font>效果，可参考 [使用文件发起的预览](https://qian.tencent.com/developers/partner/preview_guide#%E4%B8%80%E4%BD%BF%E7%94%A8%E6%96%87%E4%BB%B6%E5%8F%91%E8%B5%B7%E7%9A%84%E9%A2%84%E8%A7%88)
+        - 关于填写方与签署方的<font color="red">填写、签署先后顺序</font>设置，详见 [填写与签署顺序说明](https://qian.tencent.com/developers/partner/fill_sign_order)。
+        - 关于<font color="red">本企业自动签署与其他企业自动签署</font>的配置与使用，详见 [自动签署](https://qian.tencent.com/developers/partner/autosign_guide)。
 
-        <font color="red">相关视频指引</font> <br>
-        1. <a href="https://dyn.ess.tencent.cn/guide/apivideo/essbasic-UploadFiles.mp4" target="_blank">【上传文件代码】编写示例</a><br>
-        1. <a href="https://dyn.ess.tencent.cn/guide/apivideo/essbasic-ChannelCreateFlowByFiles.mp4" target="_blank">【用PDF文件创建签署流程】编写示例</a><br>
+        ### 1.4 视频教程
+        1. <a href="https://dyn.ess.tencent.cn/guide/apivideo/essbasic-UploadFiles.mp4" target="_blank">【上传文件代码】编写示例</a>
+        2. <a href="https://dyn.ess.tencent.cn/guide/apivideo/essbasic-ChannelCreateFlowByFiles.mp4" target="_blank">【用PDF文件创建签署流程】编写示例</a>
 
         :param request: Request instance for ChannelCreateFlowByFiles.
         :type request: :class:`tencentcloud.essbasic.v20210526.models.ChannelCreateFlowByFilesRequest`
@@ -2284,70 +2283,54 @@ class EssbasicClient(AbstractClient):
 
 
     def CreateFlowsByTemplates(self, request):
-        r"""接口（CreateFlowsByTemplates）用于使用模板批量创建签署流程。当前可批量发起合同（签署流程）数量为1-20个。
-        如若在模板中配置了动态表格, 上传的附件必须为A4大小
-        合同发起人必须在电子签已经进行实名。
+        r"""本接口（CreateFlowsByTemplates）用于**使用模板批量创建签署流程**，当前单次可批量发起合同（签署流程）数量为 1~20 个。
+
 
-        ### 一. 整体的逻辑如下
+        ### 1.1 整体逻辑如下
 
-        ![image](https://qcloudimg.tencent-cloud.cn/raw/e193519d4383fa74782a9e19147ef01a/CreateFlowsByTemplates.png)
+        ![image](https://qcloudimg.tencent-cloud.cn/raw/66f74308ca92590f5d96d9c4fed25563.svg)
 
-        ###  二. 可以作为发起方和签署方的角色列表
+        ### 1.2 发起方和签署方
 
         <table>     <thead>     <tr>         <th>场景编号</th>         <th>发起方</th>         <th>签署方</th>         <th>补充</th>     </tr>     </thead>     <tbody>     <tr>         <td>场景一</td>         <td>子企业A的员工</td>         <td>子企业A的员工</td>         <td>子企业是通过<a href="https://qian.tencent.com/developers/partnerApis/accounts/CreateConsoleLoginUrl" target="_blank">CreateConsoleLoginUrl</a>生成子客登录链接注册的企业</td>     </tr>     <tr>         <td>场景二</td>         <td>子企业A的员工</td>         <td>子企业B(不指定经办人走领取逻辑)</td>         <td>领取的逻辑可以参考文档<a href="https://qian.tencent.com/developers/partner/dynamic_signer" target="_blank">动态签署方</a> </td>     </tr>     <tr>         <td>场景三</td>         <td>子企业A的员工</td>         <td>子企业B的员工</td>         <td>-</td>     </tr>     <tr>         <td>场景四</td>         <td>子企业A的员工</td>         <td>个人</td>         <td>就是自然人，不是企业员工</td>     </tr>     <tr>         <td>场景五</td>         <td>子企业A的员工</td>         <td>SaaS平台企业员工</td>         <td>SaaS平台企业是通过<a href="https://qian.tencent.cn/console/company-register" target="_blank">https://qian.tencent.cn/console/company-register</a>链接注册的企业</td>     </tr>     </tbody> </table>
 
+        <font color="red">发起方（第三方子企业 A 的企业与员工）必须完成实名</font>；作为 **签署方** 的第三方子企业 A 员工 / 个人自然人 / SaaS 平台企业员工 / 第三方子企业 B 员工等，其企业和个人可以未实名。
 
 
+        ### 1.3 填充模板中定义的发起人填写控件
 
-        ### 三. 填充模板中定义的填写控件
-        模板中配置的<font color="red">发起人填充控件</font>可以通过本接口的**FormFields数组**字段填充
+        模板中配置的 **发起人填充控件** 可以通过本接口的 **FormFields 数组** 字段填充。<font color="red">只能填充分配给发起方的填写控件，不能填充分配给签署方的签署控件</font> ，分配给签署方的签署控件需要签署方在签署环节填充。
 
         ![image](https://qcloudimg.tencent-cloud.cn/raw/37457e0e450fc221effddfcb8b1bad55.png)
         填充的传参示例如下
 
         ```
-            request.FormFields = [{
-                    "ComponentName": "项目的名字",
-                    "ComponentValue": "休闲山庄"
-                }, {
-                    "ComponentName": "项目的地址",
-                    "ComponentValue": "凤凰山北侧",
-                }, {
-                    "ComponentName": "范围",
-                    "ComponentValue": "凤凰山至107国道",
-                }, {
-                    "ComponentName": "面积",
-                    "ComponentValue": "100亩",
-                }, {
-                    "ComponentName": "基本情况",
-                    "ComponentValue": "完好",
-                }, , {
-                    "ComponentName": "用途",
-                    "ComponentValue": "经营农家乐",
-                }
-            ]
+            request.FormFields = [
+            { "ComponentName": "项目的名字", "ComponentValue": "休闲山庄" },
+            { "ComponentName": "项目的地址", "ComponentValue": "凤凰山北侧" },
+            { "ComponentName": "范围", "ComponentValue": "凤凰山至107国道" },
+            { "ComponentName": "面积", "ComponentValue": "100亩" },
+            { "ComponentName": "基本情况", "ComponentValue": "完好" },
+            { "ComponentName": "用途", "ComponentValue": "经营农家乐" }
+        ]
         ```
-        合成后合同样子示例
+        合成后合同样子
 
         ![image](https://qcloudimg.tencent-cloud.cn/raw/140a2fb771ac66a185d0a000d37485f6.png)
 
+        ### 1.4 注意事项
+        -  合同<font color="red">发起后就会扣减合同的额度</font> , 只有撤销没有参与方签署过或只有自动签署签署过的合同，且<font color="red">有撤销合同额度</font>的情形下，才会返还合同额度。（**过期，拒签，签署完成，解除完成等状态不会返还额度**）。具体可以参考 [合同撤销返还额度说明](https://qian.tencent.com/developers/partner/contract_cancel_quota) 。
+        - <font color="red">支持的证件类型</font>可以参考 [支持的证件类型](https://qian.tencent.com/developers/partner/id_card_support) 。
+        - <font color="red">不同类型的签署方传参不同</font>，各类型签署方的信息传递方式详见  [签署方入参指引](https://qian.tencent.com/developers/partner/flow_approver) 。
+        - 如果合同正式发起前如需<font color="red">预览</font>效果，可参考 [使用模板发起的预览](https://qian.tencent.com/developers/partner/preview_guide/#%E4%BA%8C%E4%BD%BF%E7%94%A8%E6%A8%A1%E6%9D%BF%E5%8F%91%E8%B5%B7%E7%9A%84%E9%A2%84%E8%A7%88)
+        - 关于填写方与签署方的<font color="red">填写、签署先后顺序</font>设置，详见 [填写与签署顺序说明](https://qian.tencent.com/developers/partner/fill_sign_order)。
+        - 关于<font color="red">本企业自动签署与其他企业自动签署</font>的配置与使用，详见 [自动签署](https://qian.tencent.com/developers/partner/autosign_guide)。
+        - 如若在模板中配置了[动态表格](https://qian.tencent.com/developers/partner/dynamic_table), 如果模板中配有附件控件，上传的附件必须为A4尺寸的PDF。
 
+        ### 1.5 视频教程
 
-        ### 四. 注意
-        1. 发起合同时候,  作为<font color="red">发起方的第三方子企业A员工的企业和员工必须经过实名</font>, 而作为签署方的第三方子企业A员工/个人/自然人/SaaS平台企业员工/第三方子企业B员工企业中的企业和个人/员工可以未实名
-
-        2. 不同类型的签署方传参不同, 可以参考开发者中心的FlowApproverInfo结构体说明
-
-        3. <font color="red">调用接口发起合同成功就会扣减合同的额度</font>, 只有撤销没有参与方签署过或只有自动签署签署过的合同，才会返还合同额度。（过期，拒签，签署完成，解除完成等状态不会返还额度）
-
-        4. <font color="red">静默（自动）签署不支持合同签署方存在填写</font>
-
-        5.  <font color="red">在下一步创建签署链接前，建议等待DocumentFill </font> <a href="https://qian.tencent.com/developers/partner/callback_types_file_resources">PDF合成完成的回调</a>或者睡眠几秒，尤其是当模板中存在动态表格等复杂填写控件时，因为合成过程可能会耗费秒级别的时间。
-
-
-        <font color="red">相关视频指引</font> <br>
-        1. <a href="https://dyn.ess.tencent.cn/guide/apivideo/essbasic-CreateTemplates.mp4" target="_blank">创建模板&设置成本企业自动签署</a><br>
-        2. <a href="https://dyn.ess.tencent.cn/guide/apivideo/essbasic-CreateFlowsByTemplates.mp4" target="_blank">【用模板创建签署流程】编写示例视频教程</a><br>
+        1. <a href="https://dyn.ess.tencent.cn/guide/apivideo/essbasic-CreateTemplates.mp4" target="_blank">创建模板 & 设置成本企业自动签署</a>
+        2. <a href="https://dyn.ess.tencent.cn/guide/apivideo/essbasic-CreateFlowsByTemplates.mp4" target="_blank">【用模板创建签署流程】编写示例视频教程</a>
 
         :param request: Request instance for CreateFlowsByTemplates.
         :type request: :class:`tencentcloud.essbasic.v20210526.models.CreateFlowsByTemplatesRequest`
@@ -2522,6 +2505,148 @@ class EssbasicClient(AbstractClient):
                 raise TencentCloudSDKException(type(e).__name__, str(e))
 
 
+    def CreateRequestWithEncryption(self, request):
+        r"""该接口支持对请求内容进行加密传输。调用方需使用约定的 AES-CBC 或 SM4-CBC 算法对请求内容进行加密，并使用 HMAC-SHA256 或 HMAC-SM3 算法对 IV 和加密后的数据进行完整性校验，防止请求内容被篡改。
+
+        ![image](https://qcloudimg.tencent-cloud.cn/raw/391df0a37c2b213445c4909ba98824ac.svg)
+
+        **请求端加密流程**
+        1. 每次请求使用密码学安全的随机源生成 16 字节 的 IV。每次请求必须重新生成，严禁复用。
+        2. 使用约定的 AES-CBC 或 SM4-CBC 算法对原始请求体进行加密，使用 PKCS#7 Padding。
+        3. 将加密后的密文原始字节进行标准 Base64 编码，作为 EncryptedData 参数。
+        4. 将 IV 原始字节进行标准 Base64 编码，作为 IV 参数。
+        5. 对 IV 原始字节和密文原始字节直接拼接（不添加分隔符），计算 HMAC-SHA256 或 HMAC-SM4：HMAC(Key, IVBytes || CiphertextBytes)
+        6. 将 HMAC 的结果进行 标准 Base64 编码，作为 EncryptionSignature 参数。
+
+        **响应端解密流程**
+        1. 先判断本接口自身是否返回外层错误，此时错误为明文（标准腾讯云错误体），有则直接失败处理。
+        2. 分别对 IV、EncryptedData、EncryptionSignature 做标准 Base64 解码，得到原始字节。
+        3. 将 IV 与密文原始字节直接拼接（无分隔符），计算 HMAC-SHA256 或 HMAC-SM4：HMAC(Key, IVBytes || CiphertextBytes)。
+        4. 与响应中 EncryptionSignature 解码后的字节做恒定时间比较，不一致立即失败，不得继续解密。
+        5. 使用约定的 AES-CBC 或 SM4-CBC，以 IV 和密钥解密 EncryptedData，去除 PKCS#7 Padding 得到明文。
+        6. 先用腾讯云标准错误体反序列化明文，判断被加密业务接口是否返回 Error。
+        7. 无业务错误时，再用目标业务接口的响应结构体反序列化明文，取出实际业务参数。
+
+        **响应端错误处理**
+        1. 外层错误（本接口本身调用失败）：返回标准腾讯云错误 JSON（含 Error.Code / Error.Message），无 EncryptedData，不需要解密即可处理。
+        2. 内层错误（业务接口执行失败）：外层成功，但解密后的明文里包含 Error.Code / Error.Message，按目标业务接口的错误规范处理。
+
+        **处理过程示例**
+        ```
+        # ========== 前置约定 ==========
+        AESKey  : 加密 密钥（AES 32 字节，SM4 16 字节）
+        HMACKey : HMAC 密钥（与加密密钥需要不同）
+        ALGO    : AES-CBC 或 SM4-CBC，双方约定
+        HMAC    : ALGO == AES-CBC ? HMAC-SHA256 : HMAC-SM3
+
+        # ========== 请求端：加密并调用 ==========
+        function CallWithEncryption(bizAction, bizApplicationId, bizRequestObj):
+            # 1. 序列化业务请求
+            plaintext = JSON.stringify(bizRequestObj)
+            # 2. 生成 16 字节随机 IV（每次新生成，禁止复用）
+            iv = SecureRandom(16)
+            # 3. 对称加密（PKCS#7 Padding）
+            ciphertext = SymmetricEncrypt(ALGO, AESKey, iv, plaintext)
+            # 4. 计算完整性签名：HMAC(Key, IV || Ciphertext)
+            signature = HMAC(HMACKey, concat(iv, ciphertext))
+            # 5. 组装外层请求参数
+            encReq = {
+                RequestAction:       bizAction,
+                ApplicationId:       bizApplicationId,
+                IV:                  Base64(iv),
+                EncryptedData:       Base64(ciphertext),
+                EncryptionSignature: Base64(signature),
+            }
+            # 6. 调用 CreateRequestWithEncryption
+            #    TC3-HMAC-SHA256 鉴权由官方 SDK 自动完成
+            encResp = CloudAPI.CreateRequestWithEncryption(encReq)
+            # 7. 外层错误：明文，直接抛出
+            if encResp.Error != nil:
+                raise OuterError(encResp.Error)
+            # 8. 解密并返回业务响应
+            return DecryptResponse(encResp.Response)
+
+        # ========== 响应端：校验并解密 ==========
+        function DecryptResponse(resp):
+            # 1. Base64 解码
+            ivBytes  = Base64Decode(resp.IV)
+            ctBytes  = Base64Decode(resp.EncryptedData)
+            sigBytes = Base64Decode(resp.EncryptionSignature)
+            # 2. 重新计算 HMAC
+            expected = HMAC(HMACKey, concat(ivBytes, ctBytes))
+            # 3. 恒定时间比较，失败立即终止（不得继续解密）
+            if not ConstantTimeEqual(expected, sigBytes):
+                raise SignatureMismatch
+            # 4. 对称解密，去除 PKCS#7 Padding
+            plaintext = SymmetricDecrypt(ALGO, AESKey, ivBytes, ctBytes)
+            # 5. 先按腾讯云错误体解析，判断业务是否失败
+            bizErr = TryParseTencentCloudError(plaintext)
+            if bizErr != nil:
+                raise BusinessError(bizErr)
+            # 6. 按目标业务接口的响应结构反序列化
+            return JSON.parse(plaintext, BizResponseSchema)
+        ```
+
+        **AES-CBC 示例**
+
+        以下示例参数及结果可用于验证 AES-CBC 加密和 HMAC-SHA256 签名算法的实现是否正确。
+
+        加密密钥：AES-CBC-Key-1234
+        签名密钥：AES-HMAC-Key-123
+        IV：1234567890abcdef
+        请求内容：{"Request": "This is a test."}
+
+        最终请求参数：
+        ```
+        {
+          "RequestAction": "ChannelDescribeFlowComponents",
+          "ApplicationId: "yD******************************,
+          "IV": "MTIzNDU2Nzg5MGFiY2RlZg==",
+          "EncryptedData": "Iqp2W1jislwMNmE7bH9dKZZiMQsfkAPyvAAqDFRnWLw=",
+          "EncryptionSignature": "4TT3PUCZgZT7YmEPtXDm5PDcM6xT7FoYHfMW8xunB5I="
+        }
+        ```
+
+        **SM4-CBC 示例**
+
+        以下示例参数及结果可用于验证 SM4-CBC 加密和 HMAC-SM4 签名算法的实现是否正确。
+
+        加密密钥：SM4-CBC-Key-1234
+        签名密钥：SM4-HMAC-Key-123
+        IV：fedcba0987654321
+        请求内容：{"Request": "This is a test."}
+
+        最终请求参数：
+        ```
+        {
+          "RequestAction": "ChannelDescribeFlowComponents",
+          "ApplicationId: "yD******************************,
+          "IV": "ZmVkY2JhMDk4NzY1NDMyMQ==",
+          "EncryptedData": "GwUovQhNUPaUnVM/UDXMtPOYTpTSi2B1oyZDFbyyvns=",
+          "EncryptionSignature": "nHB/v/AvOaDCQ66esFNnp12lHKcGkwaLGid0Warl/KE="
+        }
+        ```
+
+        :param request: Request instance for CreateRequestWithEncryption.
+        :type request: :class:`tencentcloud.essbasic.v20210526.models.CreateRequestWithEncryptionRequest`
+        :rtype: :class:`tencentcloud.essbasic.v20210526.models.CreateRequestWithEncryptionResponse`
+
+        """
+        try:
+            params = request._serialize()
+            headers = request.headers
+            body = self.call("CreateRequestWithEncryption", params, headers=headers)
+            response = json.loads(body)
+            model = models.CreateRequestWithEncryptionResponse()
+            model._deserialize(response["Response"])
+            return model
+        except Exception as e:
+            if isinstance(e, TencentCloudSDKException):
+                raise
+            else:
+                raise TencentCloudSDKException(type(e).__name__, str(e))
+
+
     def CreateSealByImage(self, request):
         r"""1. 可以**通过图片**为子客企业代创建印章，图片最大5MB
 

{tencentcloud_sdk_python_essbasic-3.1.164 → tencentcloud_sdk_python_essbasic-3.1.169}/tencentcloud/essbasic/v20210526/essbasic_client_async.py

@@ -440,34 +440,33 @@ class EssbasicClient(AbstractClient):
             opts: Dict = None,
     ) -> models.ChannelCreateFlowByFilesResponse:
         """
-        接口（ChannelCreateFlowByFiles）用PDF文件创建签署流程。
+        本接口（ChannelCreateFlowByFiles）用于通过**已上传的 PDF 资源编号**创建待签署的合同流程。
 
-        适用场景：适用非制式的合同文件签署，开发者有每个签署流程的PDF，可以通过该接口传入完整的PDF文件及流程信息生成待签署的合同流程。
+        **适用场景**：适用于非制式的合同文件签署。当开发者已拥有每个签署流程完整的 PDF 文件时，可通过本接口传入完整的 PDF 文件及流程信息，生成待签署的合同流程。
 
-        **注**:
-        <ul>
-        <li>此接口静默签(企业自动签)能力为白名单功能，使用前请联系对接的客户经理沟通。</li>
-        <li>此接口需要依赖<a href="https://qian.tencent.com/developers/partnerApis/files/UploadFiles" target="_blank">文件上传接口</a>生成pdf资源编号（FileIds）进行使用。整体的逻辑如下图</li>
-        </ul>
+        ### 1.1 调用依赖
 
-        ![image](https://qcloudimg.tencent-cloud.cn/raw/bf86248a2c163228c4e894cf5926af69/ChannelCreateFlowByFiles.png)
-
-        **可以作为发起方和签署方的角色列表**
-        <table>     <thead>     <tr>         <th>场景编号</th>         <th>发起方</th>         <th>签署方</th>         <th>补充</th>     </tr>     </thead>     <tbody>     <tr>         <td>场景一</td>         <td>子企业A的员工</td>         <td>子企业A的员工</td>         <td>子企业是通过<a href="https://qian.tencent.com/developers/partnerApis/accounts/CreateConsoleLoginUrl" target="_blank">CreateConsoleLoginUrl</a>生成子客登录链接注册的企业</td>     </tr>     <tr>         <td>场景二</td>         <td>子企业A的员工</td>         <td>子企业B(不指定经办人走领取逻辑)</td>         <td>领取的逻辑可以参考文档<a href="https://qian.tencent.com/developers/partner/dynamic_signer" target="_blank">动态签署方</a> </td>     </tr>     <tr>         <td>场景三</td>         <td>子企业A的员工</td>         <td>子企业B的员工</td>         <td>-</td>     </tr>     <tr>         <td>场景四</td>         <td>子企业A的员工</td>         <td>个人</td>         <td>就是自然人，不是企业员工</td>     </tr>     <tr>         <td>场景五</td>         <td>子企业A的员工</td>         <td>SaaS平台企业员工</td>         <td>SaaS平台企业是通过<a href="https://qian.tencent.cn/console/company-register" target="_blank">https://qian.tencent.cn/console/company-register</a>链接注册的企业</td>     </tr>     </tbody> </table>
+        本接口需依赖[文件上传接口](https://qian.tencent.com/developers/partnerApis/files/UploadFiles)生成 PDF 资源编号（FileId）后使用，整体逻辑如下图：
 
+        ![image](https://qcloudimg.tencent-cloud.cn/raw/985b4bf10a40d65fe7b016bb2f82c3df.svg)
 
-        **注**:
-        `1. 发起合同时候,  作为发起方的第三方子企业A员工的企业和员工必须经过实名, 而作为签署方的第三方子企业A员工/个人/自然人/SaaS平台企业员工/第三方子企业B员工企业中的企业和个人/员工可以未实名`
+        ### 1.2  发起方和签署方
+        <table>     <thead>     <tr>         <th>场景编号</th>         <th>发起方</th>         <th>签署方</th>         <th>补充</th>     </tr>     </thead>     <tbody>     <tr>         <td>场景一</td>         <td>子企业A的员工</td>         <td>子企业A的员工</td>         <td>子企业是通过<a href="https://qian.tencent.com/developers/partnerApis/accounts/CreateConsoleLoginUrl" target="_blank">CreateConsoleLoginUrl</a>生成子客登录链接注册的企业</td>     </tr>     <tr>         <td>场景二</td>         <td>子企业A的员工</td>         <td>子企业B(不指定经办人走领取逻辑)</td>         <td>领取的逻辑可以参考文档<a href="https://qian.tencent.com/developers/partner/dynamic_signer" target="_blank">动态签署方</a> </td>     </tr>     <tr>         <td>场景三</td>         <td>子企业A的员工</td>         <td>子企业B的员工</td>         <td>-</td>     </tr>     <tr>         <td>场景四</td>         <td>子企业A的员工</td>         <td>个人</td>         <td>就是自然人，不是企业员工</td>     </tr>     <tr>         <td>场景五</td>         <td>子企业A的员工</td>         <td>SaaS平台企业员工</td>         <td>SaaS平台企业是通过<a href="https://qian.tencent.cn/console/company-register" target="_blank">https://qian.tencent.cn/console/company-register</a>链接注册的企业</td>     </tr>     </tbody> </table>
 
-        `2. 不同类型的签署方传参不同, 可以参考开发者中心的FlowApproverInfo结构体说明`
 
-        `3. 合同发起后就会扣减合同的额度, 只有撤销没有参与方签署过或只有自动签署签署过的合同，才会返还合同额度。（过期，拒签，签署完成，解除完成等状态不会返还额度）`
+         <font color="red">发起方（第三方子企业 A 的企业与员工）必须完成实名</font>；作为 **签署方** 的第三方子企业 A 员工 / 个人自然人 / SaaS 平台企业员工 / 第三方子企业 B 员工等，其企业和个人可以未实名。
 
-        `4. 静默（自动）签署不支持合同签署方存在填写功能`
+        ### 1.3 注意事项
+        -  合同<font color="red">发起后就会扣减合同的额度</font> , 只有撤销没有参与方签署过或只有自动签署签署过的合同，且<font color="red">有撤销合同额度</font>的情形下，才会返还合同额度。（**过期，拒签，签署完成，解除完成等状态不会返还额度**）。具体可以参考 [合同撤销返还额度说明](https://qian.tencent.com/developers/partner/contract_cancel_quota) 。
+        - <font color="red">支持的证件类型</font>可以参考 [支持的证件类型](https://qian.tencent.com/developers/partner/id_card_support) 。
+        - <font color="red">不同类型的签署方传参不同</font>，各类型签署方的信息传递方式详见  [签署方入参指引](https://qian.tencent.com/developers/partner/flow_approver) 。
+        - 如果合同正式发起前如需<font color="red">预览</font>效果，可参考 [使用文件发起的预览](https://qian.tencent.com/developers/partner/preview_guide#%E4%B8%80%E4%BD%BF%E7%94%A8%E6%96%87%E4%BB%B6%E5%8F%91%E8%B5%B7%E7%9A%84%E9%A2%84%E8%A7%88)
+        - 关于填写方与签署方的<font color="red">填写、签署先后顺序</font>设置，详见 [填写与签署顺序说明](https://qian.tencent.com/developers/partner/fill_sign_order)。
+        - 关于<font color="red">本企业自动签署与其他企业自动签署</font>的配置与使用，详见 [自动签署](https://qian.tencent.com/developers/partner/autosign_guide)。
 
-        <font color="red">相关视频指引</font> <br>
-        1. <a href="https://dyn.ess.tencent.cn/guide/apivideo/essbasic-UploadFiles.mp4" target="_blank">【上传文件代码】编写示例</a><br>
-        1. <a href="https://dyn.ess.tencent.cn/guide/apivideo/essbasic-ChannelCreateFlowByFiles.mp4" target="_blank">【用PDF文件创建签署流程】编写示例</a><br>
+        ### 1.4 视频教程
+        1. <a href="https://dyn.ess.tencent.cn/guide/apivideo/essbasic-UploadFiles.mp4" target="_blank">【上传文件代码】编写示例</a>
+        2. <a href="https://dyn.ess.tencent.cn/guide/apivideo/essbasic-ChannelCreateFlowByFiles.mp4" target="_blank">【用PDF文件创建签署流程】编写示例</a>
         """
         
         kwargs = {}
@@ -1958,70 +1957,54 @@ class EssbasicClient(AbstractClient):
             opts: Dict = None,
     ) -> models.CreateFlowsByTemplatesResponse:
         """
-        接口（CreateFlowsByTemplates）用于使用模板批量创建签署流程。当前可批量发起合同（签署流程）数量为1-20个。
-        如若在模板中配置了动态表格, 上传的附件必须为A4大小
-        合同发起人必须在电子签已经进行实名。
+        本接口（CreateFlowsByTemplates）用于**使用模板批量创建签署流程**，当前单次可批量发起合同（签署流程）数量为 1~20 个。
 
-        ### 一. 整体的逻辑如下
 
-        ![image](https://qcloudimg.tencent-cloud.cn/raw/e193519d4383fa74782a9e19147ef01a/CreateFlowsByTemplates.png)
+        ### 1.1 整体逻辑如下
 
-        ###  二. 可以作为发起方和签署方的角色列表
+        ![image](https://qcloudimg.tencent-cloud.cn/raw/66f74308ca92590f5d96d9c4fed25563.svg)
+
+        ### 1.2 发起方和签署方
 
         <table>     <thead>     <tr>         <th>场景编号</th>         <th>发起方</th>         <th>签署方</th>         <th>补充</th>     </tr>     </thead>     <tbody>     <tr>         <td>场景一</td>         <td>子企业A的员工</td>         <td>子企业A的员工</td>         <td>子企业是通过<a href="https://qian.tencent.com/developers/partnerApis/accounts/CreateConsoleLoginUrl" target="_blank">CreateConsoleLoginUrl</a>生成子客登录链接注册的企业</td>     </tr>     <tr>         <td>场景二</td>         <td>子企业A的员工</td>         <td>子企业B(不指定经办人走领取逻辑)</td>         <td>领取的逻辑可以参考文档<a href="https://qian.tencent.com/developers/partner/dynamic_signer" target="_blank">动态签署方</a> </td>     </tr>     <tr>         <td>场景三</td>         <td>子企业A的员工</td>         <td>子企业B的员工</td>         <td>-</td>     </tr>     <tr>         <td>场景四</td>         <td>子企业A的员工</td>         <td>个人</td>         <td>就是自然人，不是企业员工</td>     </tr>     <tr>         <td>场景五</td>         <td>子企业A的员工</td>         <td>SaaS平台企业员工</td>         <td>SaaS平台企业是通过<a href="https://qian.tencent.cn/console/company-register" target="_blank">https://qian.tencent.cn/console/company-register</a>链接注册的企业</td>     </tr>     </tbody> </table>
 
+        <font color="red">发起方（第三方子企业 A 的企业与员工）必须完成实名</font>；作为 **签署方** 的第三方子企业 A 员工 / 个人自然人 / SaaS 平台企业员工 / 第三方子企业 B 员工等，其企业和个人可以未实名。
 
 
+        ### 1.3 填充模板中定义的发起人填写控件
 
-        ### 三. 填充模板中定义的填写控件
-        模板中配置的<font color="red">发起人填充控件</font>可以通过本接口的**FormFields数组**字段填充
+        模板中配置的 **发起人填充控件** 可以通过本接口的 **FormFields 数组** 字段填充。<font color="red">只能填充分配给发起方的填写控件，不能填充分配给签署方的签署控件</font> ，分配给签署方的签署控件需要签署方在签署环节填充。
 
         ![image](https://qcloudimg.tencent-cloud.cn/raw/37457e0e450fc221effddfcb8b1bad55.png)
         填充的传参示例如下
 
         ```
-            request.FormFields = [{
-                    "ComponentName": "项目的名字",
-                    "ComponentValue": "休闲山庄"
-                }, {
-                    "ComponentName": "项目的地址",
-                    "ComponentValue": "凤凰山北侧",
-                }, {
-                    "ComponentName": "范围",
-                    "ComponentValue": "凤凰山至107国道",
-                }, {
-                    "ComponentName": "面积",
-                    "ComponentValue": "100亩",
-                }, {
-                    "ComponentName": "基本情况",
-                    "ComponentValue": "完好",
-                }, , {
-                    "ComponentName": "用途",
-                    "ComponentValue": "经营农家乐",
-                }
-            ]
+            request.FormFields = [
+            { "ComponentName": "项目的名字", "ComponentValue": "休闲山庄" },
+            { "ComponentName": "项目的地址", "ComponentValue": "凤凰山北侧" },
+            { "ComponentName": "范围", "ComponentValue": "凤凰山至107国道" },
+            { "ComponentName": "面积", "ComponentValue": "100亩" },
+            { "ComponentName": "基本情况", "ComponentValue": "完好" },
+            { "ComponentName": "用途", "ComponentValue": "经营农家乐" }
+        ]
         ```
-        合成后合同样子示例
+        合成后合同样子
 
         ![image](https://qcloudimg.tencent-cloud.cn/raw/140a2fb771ac66a185d0a000d37485f6.png)
 
+        ### 1.4 注意事项
+        -  合同<font color="red">发起后就会扣减合同的额度</font> , 只有撤销没有参与方签署过或只有自动签署签署过的合同，且<font color="red">有撤销合同额度</font>的情形下，才会返还合同额度。（**过期，拒签，签署完成，解除完成等状态不会返还额度**）。具体可以参考 [合同撤销返还额度说明](https://qian.tencent.com/developers/partner/contract_cancel_quota) 。
+        - <font color="red">支持的证件类型</font>可以参考 [支持的证件类型](https://qian.tencent.com/developers/partner/id_card_support) 。
+        - <font color="red">不同类型的签署方传参不同</font>，各类型签署方的信息传递方式详见  [签署方入参指引](https://qian.tencent.com/developers/partner/flow_approver) 。
+        - 如果合同正式发起前如需<font color="red">预览</font>效果，可参考 [使用模板发起的预览](https://qian.tencent.com/developers/partner/preview_guide/#%E4%BA%8C%E4%BD%BF%E7%94%A8%E6%A8%A1%E6%9D%BF%E5%8F%91%E8%B5%B7%E7%9A%84%E9%A2%84%E8%A7%88)
+        - 关于填写方与签署方的<font color="red">填写、签署先后顺序</font>设置，详见 [填写与签署顺序说明](https://qian.tencent.com/developers/partner/fill_sign_order)。
+        - 关于<font color="red">本企业自动签署与其他企业自动签署</font>的配置与使用，详见 [自动签署](https://qian.tencent.com/developers/partner/autosign_guide)。
+        - 如若在模板中配置了[动态表格](https://qian.tencent.com/developers/partner/dynamic_table), 如果模板中配有附件控件，上传的附件必须为A4尺寸的PDF。
 
+        ### 1.5 视频教程
 
-        ### 四. 注意
-        1. 发起合同时候,  作为<font color="red">发起方的第三方子企业A员工的企业和员工必须经过实名</font>, 而作为签署方的第三方子企业A员工/个人/自然人/SaaS平台企业员工/第三方子企业B员工企业中的企业和个人/员工可以未实名
-
-        2. 不同类型的签署方传参不同, 可以参考开发者中心的FlowApproverInfo结构体说明
-
-        3. <font color="red">调用接口发起合同成功就会扣减合同的额度</font>, 只有撤销没有参与方签署过或只有自动签署签署过的合同，才会返还合同额度。（过期，拒签，签署完成，解除完成等状态不会返还额度）
-
-        4. <font color="red">静默（自动）签署不支持合同签署方存在填写</font>
-
-        5.  <font color="red">在下一步创建签署链接前，建议等待DocumentFill </font> <a href="https://qian.tencent.com/developers/partner/callback_types_file_resources">PDF合成完成的回调</a>或者睡眠几秒，尤其是当模板中存在动态表格等复杂填写控件时，因为合成过程可能会耗费秒级别的时间。
-
-
-        <font color="red">相关视频指引</font> <br>
-        1. <a href="https://dyn.ess.tencent.cn/guide/apivideo/essbasic-CreateTemplates.mp4" target="_blank">创建模板&设置成本企业自动签署</a><br>
-        2. <a href="https://dyn.ess.tencent.cn/guide/apivideo/essbasic-CreateFlowsByTemplates.mp4" target="_blank">【用模板创建签署流程】编写示例视频教程</a><br>
+        1. <a href="https://dyn.ess.tencent.cn/guide/apivideo/essbasic-CreateTemplates.mp4" target="_blank">创建模板 & 设置成本企业自动签署</a>
+        2. <a href="https://dyn.ess.tencent.cn/guide/apivideo/essbasic-CreateFlowsByTemplates.mp4" target="_blank">【用模板创建签署流程】编写示例视频教程</a>
         """
         
         kwargs = {}
@@ -2161,6 +2144,143 @@ class EssbasicClient(AbstractClient):
         
         return await self.call_and_deserialize(**kwargs)
         
+    async def CreateRequestWithEncryption(
+            self,
+            request: models.CreateRequestWithEncryptionRequest,
+            opts: Dict = None,
+    ) -> models.CreateRequestWithEncryptionResponse:
+        """
+        该接口支持对请求内容进行加密传输。调用方需使用约定的 AES-CBC 或 SM4-CBC 算法对请求内容进行加密，并使用 HMAC-SHA256 或 HMAC-SM3 算法对 IV 和加密后的数据进行完整性校验，防止请求内容被篡改。
+
+        ![image](https://qcloudimg.tencent-cloud.cn/raw/391df0a37c2b213445c4909ba98824ac.svg)
+
+        **请求端加密流程**
+        1. 每次请求使用密码学安全的随机源生成 16 字节 的 IV。每次请求必须重新生成，严禁复用。
+        2. 使用约定的 AES-CBC 或 SM4-CBC 算法对原始请求体进行加密，使用 PKCS#7 Padding。
+        3. 将加密后的密文原始字节进行标准 Base64 编码，作为 EncryptedData 参数。
+        4. 将 IV 原始字节进行标准 Base64 编码，作为 IV 参数。
+        5. 对 IV 原始字节和密文原始字节直接拼接（不添加分隔符），计算 HMAC-SHA256 或 HMAC-SM4：HMAC(Key, IVBytes || CiphertextBytes)
+        6. 将 HMAC 的结果进行 标准 Base64 编码，作为 EncryptionSignature 参数。
+
+        **响应端解密流程**
+        1. 先判断本接口自身是否返回外层错误，此时错误为明文（标准腾讯云错误体），有则直接失败处理。
+        2. 分别对 IV、EncryptedData、EncryptionSignature 做标准 Base64 解码，得到原始字节。
+        3. 将 IV 与密文原始字节直接拼接（无分隔符），计算 HMAC-SHA256 或 HMAC-SM4：HMAC(Key, IVBytes || CiphertextBytes)。
+        4. 与响应中 EncryptionSignature 解码后的字节做恒定时间比较，不一致立即失败，不得继续解密。
+        5. 使用约定的 AES-CBC 或 SM4-CBC，以 IV 和密钥解密 EncryptedData，去除 PKCS#7 Padding 得到明文。
+        6. 先用腾讯云标准错误体反序列化明文，判断被加密业务接口是否返回 Error。
+        7. 无业务错误时，再用目标业务接口的响应结构体反序列化明文，取出实际业务参数。
+
+        **响应端错误处理**
+        1. 外层错误（本接口本身调用失败）：返回标准腾讯云错误 JSON（含 Error.Code / Error.Message），无 EncryptedData，不需要解密即可处理。
+        2. 内层错误（业务接口执行失败）：外层成功，但解密后的明文里包含 Error.Code / Error.Message，按目标业务接口的错误规范处理。
+
+        **处理过程示例**
+        ```
+        # ========== 前置约定 ==========
+        AESKey  : 加密 密钥（AES 32 字节，SM4 16 字节）
+        HMACKey : HMAC 密钥（与加密密钥需要不同）
+        ALGO    : AES-CBC 或 SM4-CBC，双方约定
+        HMAC    : ALGO == AES-CBC ? HMAC-SHA256 : HMAC-SM3
+
+        # ========== 请求端：加密并调用 ==========
+        function CallWithEncryption(bizAction, bizApplicationId, bizRequestObj):
+            # 1. 序列化业务请求
+            plaintext = JSON.stringify(bizRequestObj)
+            # 2. 生成 16 字节随机 IV（每次新生成，禁止复用）
+            iv = SecureRandom(16)
+            # 3. 对称加密（PKCS#7 Padding）
+            ciphertext = SymmetricEncrypt(ALGO, AESKey, iv, plaintext)
+            # 4. 计算完整性签名：HMAC(Key, IV || Ciphertext)
+            signature = HMAC(HMACKey, concat(iv, ciphertext))
+            # 5. 组装外层请求参数
+            encReq = {
+                RequestAction:       bizAction,
+                ApplicationId:       bizApplicationId,
+                IV:                  Base64(iv),
+                EncryptedData:       Base64(ciphertext),
+                EncryptionSignature: Base64(signature),
+            }
+            # 6. 调用 CreateRequestWithEncryption
+            #    TC3-HMAC-SHA256 鉴权由官方 SDK 自动完成
+            encResp = CloudAPI.CreateRequestWithEncryption(encReq)
+            # 7. 外层错误：明文，直接抛出
+            if encResp.Error != nil:
+                raise OuterError(encResp.Error)
+            # 8. 解密并返回业务响应
+            return DecryptResponse(encResp.Response)
+
+        # ========== 响应端：校验并解密 ==========
+        function DecryptResponse(resp):
+            # 1. Base64 解码
+            ivBytes  = Base64Decode(resp.IV)
+            ctBytes  = Base64Decode(resp.EncryptedData)
+            sigBytes = Base64Decode(resp.EncryptionSignature)
+            # 2. 重新计算 HMAC
+            expected = HMAC(HMACKey, concat(ivBytes, ctBytes))
+            # 3. 恒定时间比较，失败立即终止（不得继续解密）
+            if not ConstantTimeEqual(expected, sigBytes):
+                raise SignatureMismatch
+            # 4. 对称解密，去除 PKCS#7 Padding
+            plaintext = SymmetricDecrypt(ALGO, AESKey, ivBytes, ctBytes)
+            # 5. 先按腾讯云错误体解析，判断业务是否失败
+            bizErr = TryParseTencentCloudError(plaintext)
+            if bizErr != nil:
+                raise BusinessError(bizErr)
+            # 6. 按目标业务接口的响应结构反序列化
+            return JSON.parse(plaintext, BizResponseSchema)
+        ```
+
+        **AES-CBC 示例**
+
+        以下示例参数及结果可用于验证 AES-CBC 加密和 HMAC-SHA256 签名算法的实现是否正确。
+
+        加密密钥：AES-CBC-Key-1234
+        签名密钥：AES-HMAC-Key-123
+        IV：1234567890abcdef
+        请求内容：{"Request": "This is a test."}
+
+        最终请求参数：
+        ```
+        {
+          "RequestAction": "ChannelDescribeFlowComponents",
+          "ApplicationId: "yD******************************,
+          "IV": "MTIzNDU2Nzg5MGFiY2RlZg==",
+          "EncryptedData": "Iqp2W1jislwMNmE7bH9dKZZiMQsfkAPyvAAqDFRnWLw=",
+          "EncryptionSignature": "4TT3PUCZgZT7YmEPtXDm5PDcM6xT7FoYHfMW8xunB5I="
+        }
+        ```
+
+        **SM4-CBC 示例**
+
+        以下示例参数及结果可用于验证 SM4-CBC 加密和 HMAC-SM4 签名算法的实现是否正确。
+
+        加密密钥：SM4-CBC-Key-1234
+        签名密钥：SM4-HMAC-Key-123
+        IV：fedcba0987654321
+        请求内容：{"Request": "This is a test."}
+
+        最终请求参数：
+        ```
+        {
+          "RequestAction": "ChannelDescribeFlowComponents",
+          "ApplicationId: "yD******************************,
+          "IV": "ZmVkY2JhMDk4NzY1NDMyMQ==",
+          "EncryptedData": "GwUovQhNUPaUnVM/UDXMtPOYTpTSi2B1oyZDFbyyvns=",
+          "EncryptionSignature": "nHB/v/AvOaDCQ66esFNnp12lHKcGkwaLGid0Warl/KE="
+        }
+        ```
+        """
+        
+        kwargs = {}
+        kwargs["action"] = "CreateRequestWithEncryption"
+        kwargs["params"] = request._serialize()
+        kwargs["resp_cls"] = models.CreateRequestWithEncryptionResponse
+        kwargs["headers"] = request.headers
+        kwargs["opts"] = opts or {}
+        
+        return await self.call_and_deserialize(**kwargs)
+        
     async def CreateSealByImage(
             self,
             request: models.CreateSealByImageRequest,

{tencentcloud_sdk_python_essbasic-3.1.164 → tencentcloud_sdk_python_essbasic-3.1.169}/tencentcloud/essbasic/v20210526/models.py

@@ -430,6 +430,8 @@ class ApproverOption(AbstractModel):
         :type ForbidAddSignDate: bool
         :param _ApproverMobileMode: <p>签署人手机号传参模式</p><p>枚举值：</p><ul><li>REPLACE： 接受已有认证手机号并替换</li><li>GIVEN： 以客户入参输入手机号为主</li><li>VALIDATE： 若与认证手机号不一致则报错</li><li>&quot;&quot;： 不走手机号传参模式</li></ul><p>默认值：&quot;&quot;</p><p>会触发手机号传参模式的前提是：签署人是指定了具体身份信息的</p><ul><li>渠道方签署人不会触发</li><li>非渠道方签署人在指定签署人姓名，证件号的情况下会触发</li></ul>
         :type ApproverMobileMode: str
+        :param _AddSignComponentUseSealSize: <p>【仅 SignBeanTag=1 时有效】 签署方自行添加签署印章类控件（SIGN_SEAL、SIGN_PAGING_SEAL、SIGN_LEGAL_PERSON_SEAL）时，「盖章区适配签署方印章尺寸」开关的控制策略</p><p>枚举值：</p><ul><li>0： 默认关闭，可开启。与现网一致</li><li>1： 关闭且置灰——按控件默认的4.2cm尺寸盖章，签署方无法开启开关</li><li>2： 默认开启且可修改——默认按印章实际尺寸盖章，签署方可手动关闭</li><li>3： 开启且置灰——强制按印章实际尺寸盖章，签署方不可修改</li></ul>
+        :type AddSignComponentUseSealSize: int
         """
         self._NoRefuse = None
         self._NoTransfer = None
@@ -438,6 +440,7 @@ class ApproverOption(AbstractModel):
         self._FlowReadLimit = None
         self._ForbidAddSignDate = None
         self._ApproverMobileMode = None
+        self._AddSignComponentUseSealSize = None
 
     @property
     def NoRefuse(self):
@@ -516,6 +519,17 @@ class ApproverOption(AbstractModel):
     def ApproverMobileMode(self, ApproverMobileMode):
         self._ApproverMobileMode = ApproverMobileMode
 
+    @property
+    def AddSignComponentUseSealSize(self):
+        r"""<p>【仅 SignBeanTag=1 时有效】 签署方自行添加签署印章类控件（SIGN_SEAL、SIGN_PAGING_SEAL、SIGN_LEGAL_PERSON_SEAL）时，「盖章区适配签署方印章尺寸」开关的控制策略</p><p>枚举值：</p><ul><li>0： 默认关闭，可开启。与现网一致</li><li>1： 关闭且置灰——按控件默认的4.2cm尺寸盖章，签署方无法开启开关</li><li>2： 默认开启且可修改——默认按印章实际尺寸盖章，签署方可手动关闭</li><li>3： 开启且置灰——强制按印章实际尺寸盖章，签署方不可修改</li></ul>
+        :rtype: int
+        """
+        return self._AddSignComponentUseSealSize
+
+    @AddSignComponentUseSealSize.setter
+    def AddSignComponentUseSealSize(self, AddSignComponentUseSealSize):
+        self._AddSignComponentUseSealSize = AddSignComponentUseSealSize
+
 
     def _deserialize(self, params):
         self._NoRefuse = params.get("NoRefuse")
@@ -525,6 +539,7 @@ class ApproverOption(AbstractModel):
         self._FlowReadLimit = params.get("FlowReadLimit")
         self._ForbidAddSignDate = params.get("ForbidAddSignDate")
         self._ApproverMobileMode = params.get("ApproverMobileMode")
+        self._AddSignComponentUseSealSize = params.get("AddSignComponentUseSealSize")
         memeber_set = set(params.keys())
         for name, value in vars(self).items():
             property_name = name[1:]
@@ -967,49 +982,21 @@ class AutoSignConfig(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _UserInfo: 自动签开通个人用户信息, 包括名字,身份证等
+        :param _UserInfo: <p>自动签开通个人用户信息, 包括名字,身份证等</p>
         :type UserInfo: :class:`tencentcloud.essbasic.v20210526.models.UserThreeFactor`
-        :param _CertInfoCallback: 是否回调证书信息:
-<ul><li>**false**: 不需要(默认)</li>
-<li>**true**:需要</li></ul>
-
-
-注：`该字段已经失效，请勿设置此参数。`
+        :param _CertInfoCallback: <p>是否回调证书信息:</p><ul><li>**false**: 不需要(默认)</li><li>**true**:需要</li></ul><p>注：<code>该字段已经失效，请勿设置此参数。</code></p>
         :type CertInfoCallback: bool
-        :param _UserDefineSeal: 是否支持用户自定义签名印章:
-<ul><li>**false**: 不能自己定义(默认)</li>
-<li>**true**: 可以自己定义</li></ul>
+        :param _UserDefineSeal: <p>是否支持用户自定义签名印章:</p><ul><li>**false**: 不能自己定义(默认)</li><li>**true**: 可以自己定义</li></ul>
         :type UserDefineSeal: bool
-        :param _SealImgCallback: 回调中是否需要自动签将要使用的印章（签名）图片的 base64:
-<ul><li>**false**: 不需要(默认)</li>
-<li>**true**: 需要</li></ul>
+        :param _SealImgCallback: <p>回调中是否需要自动签将要使用的印章（签名）图片的 base64:</p><ul><li>**false**: 不需要(默认)</li><li>**true**: 需要</li></ul>
         :type SealImgCallback: bool
-        :param _CallbackUrl: 该字段已废弃，请使用【应用号配置】中的回调地址统一接口消息
+        :param _CallbackUrl: <p>该字段已废弃，请使用【应用号配置】中的回调地址统一接口消息</p>
         :type CallbackUrl: str
-        :param _VerifyChannels: 开通时候的身份验证方式, 取值为：
-<ul><li>**WEIXINAPP** : 微信人脸识别</li>
-<li>**INSIGHT** : 慧眼人脸识别</li>
-<li>**TELECOM** : 运营商三要素验证</li></ul>
-注：
-<ul><li>如果是小程序开通链接，仅支持传 WEIXINAPP。为空默认 WEIXINAPP</li>
-<li>如果是 H5 开通链接，支持传 INSIGHT / TELECOM。为空默认 INSIGHT </li></ul>
+        :param _VerifyChannels: <p>开通时候的身份验证方式, 取值为：</p><ul><li>**WEIXINAPP** : 微信人脸识别</li><li>**INSIGHT** : 慧眼人脸识别</li><li>**TELECOM** : 运营商三要素验证</li></ul>注：<ul><li>如果是小程序开通链接，仅支持传 WEIXINAPP。为空默认 WEIXINAPP</li><li>如果是 H5 开通链接，支持传 INSIGHT / TELECOM。为空默认 INSIGHT </li></ul>
         :type VerifyChannels: list of str
-        :param _LicenseType: 设置用户开通自动签时是否绑定个人自动签账号许可。
-
-<ul><li><b>1</b>: (默认)不绑定自动签账号许可开通，开通后一直有效,   后续使用合同份额进行合同发起</li></ul>
-
-注：`该字段已经失效，请勿设置此参数。`
+        :param _LicenseType: <p>设置用户开通自动签时是否绑定个人自动签账号许可。</p><ul><li><b>1</b>: (默认)不绑定自动签账号许可开通，开通后一直有效,   后续使用合同份额进行合同发起</li></ul><p>注：<code>该字段已经失效，请勿设置此参数。</code></p>
         :type LicenseType: int
-        :param _JumpUrl: 开通成功后前端页面跳转的url，此字段的用法场景请联系客户经理确认。
-
-注：`仅支持H5开通场景`, `跳转链接仅支持 https:// , qianapp:// 开头`
-
-跳转场景：
-<ul><li>**贵方H5 -> 腾讯电子签H5 -> 贵方H5** : JumpUrl格式: https://YOUR_CUSTOM_URL/xxxx，只需满足 https:// 开头的正确且合规的网址即可。</li>
-<li>**贵方原生App -> 腾讯电子签H5 -> 贵方原生App** : JumpUrl格式: qianapp://YOUR_CUSTOM_URL，只需满足 qianapp:// 开头的URL即可。`APP实现方，需要拦截Webview地址跳转，发现url是qianapp:// 开头时跳转到原生页面。`APP拦截地址跳转可参考：<a href='https://stackoverflow.com/questions/41693263/android-webview-err-unknown-url-scheme'>Android</a>，<a href='https://razorpay.com/docs/payments/payment-gateway/web-integration/standard/webview/upi-intent-ios/'>IOS</a> </li></ul>
-
-成功结果返回：
-若贵方需要在跳转回时通过链接query参数提示开通成功，JumpUrl中的query应携带如下参数：`appendResult=qian`。这样腾讯电子签H5会在跳转回的url后面会添加query参数提示贵方签署成功，例如：qianapp://YOUR_CUSTOM_URL?action=sign&result=success&from=tencent_ess
+        :param _JumpUrl: <p>开通成功后前端页面跳转的url，此字段的用法场景请联系客户经理确认。</p><p>注：<code>仅支持H5开通场景</code>, <code>跳转链接仅支持 https:// , qianapp:// 开头</code></p><p>跳转场景：</p><ul><li>**贵方H5 -&gt; 腾讯电子签H5 -&gt; 贵方H5** : JumpUrl格式: https://YOUR_CUSTOM_URL/xxxx，只需满足 https:// 开头的正确且合规的网址即可。</li><li>**贵方原生App -&gt; 腾讯电子签H5 -&gt; 贵方原生App** : JumpUrl格式: qianapp://YOUR_CUSTOM_URL，只需满足 qianapp:// 开头的URL即可。<code>APP实现方，需要拦截Webview地址跳转，发现url是qianapp:// 开头时跳转到原生页面。</code>APP拦截地址跳转可参考：<a href="https://qian.tencent.com/developers/company/openqianh5/#3-%E8%BF%94%E5%9B%9E%E5%BA%94%E7%94%A8jumpurl%E6%A0%BC%E5%BC%8F">返回应用JumpUrl格式</a> </li></ul><p>成功结果返回：<br>若贵方需要在跳转回时通过链接query参数提示开通成功，JumpUrl中的query应携带如下参数：<code>appendResult=qian</code>。这样腾讯电子签H5会在跳转回的url后面会添加query参数提示贵方签署成功，例如：qianapp://YOUR_CUSTOM_URL?action=sign&amp;result=success&amp;from=tencent_ess</p>
         :type JumpUrl: str
         """
         self._UserInfo = None
@@ -1023,7 +1010,7 @@ class AutoSignConfig(AbstractModel):
 
     @property
     def UserInfo(self):
-        r"""自动签开通个人用户信息, 包括名字,身份证等
+        r"""<p>自动签开通个人用户信息, 包括名字,身份证等</p>
         :rtype: :class:`tencentcloud.essbasic.v20210526.models.UserThreeFactor`
         """
         return self._UserInfo
@@ -1034,12 +1021,7 @@ class AutoSignConfig(AbstractModel):
 
     @property
     def CertInfoCallback(self):
-        r"""是否回调证书信息:
-<ul><li>**false**: 不需要(默认)</li>
-<li>**true**:需要</li></ul>
-
-
-注：`该字段已经失效，请勿设置此参数。`
+        r"""<p>是否回调证书信息:</p><ul><li>**false**: 不需要(默认)</li><li>**true**:需要</li></ul><p>注：<code>该字段已经失效，请勿设置此参数。</code></p>
         :rtype: bool
         """
         return self._CertInfoCallback
@@ -1050,9 +1032,7 @@ class AutoSignConfig(AbstractModel):
 
     @property
     def UserDefineSeal(self):
-        r"""是否支持用户自定义签名印章:
-<ul><li>**false**: 不能自己定义(默认)</li>
-<li>**true**: 可以自己定义</li></ul>
+        r"""<p>是否支持用户自定义签名印章:</p><ul><li>**false**: 不能自己定义(默认)</li><li>**true**: 可以自己定义</li></ul>
         :rtype: bool
         """
         return self._UserDefineSeal
@@ -1063,9 +1043,7 @@ class AutoSignConfig(AbstractModel):
 
     @property
     def SealImgCallback(self):
-        r"""回调中是否需要自动签将要使用的印章（签名）图片的 base64:
-<ul><li>**false**: 不需要(默认)</li>
-<li>**true**: 需要</li></ul>
+        r"""<p>回调中是否需要自动签将要使用的印章（签名）图片的 base64:</p><ul><li>**false**: 不需要(默认)</li><li>**true**: 需要</li></ul>
         :rtype: bool
         """
         return self._SealImgCallback
@@ -1078,7 +1056,7 @@ class AutoSignConfig(AbstractModel):
     def CallbackUrl(self):
         warnings.warn("parameter `CallbackUrl` is deprecated", DeprecationWarning) 
 
-        r"""该字段已废弃，请使用【应用号配置】中的回调地址统一接口消息
+        r"""<p>该字段已废弃，请使用【应用号配置】中的回调地址统一接口消息</p>
         :rtype: str
         """
         return self._CallbackUrl
@@ -1091,13 +1069,7 @@ class AutoSignConfig(AbstractModel):
 
     @property
     def VerifyChannels(self):
-        r"""开通时候的身份验证方式, 取值为：
-<ul><li>**WEIXINAPP** : 微信人脸识别</li>
-<li>**INSIGHT** : 慧眼人脸识别</li>
-<li>**TELECOM** : 运营商三要素验证</li></ul>
-注：
-<ul><li>如果是小程序开通链接，仅支持传 WEIXINAPP。为空默认 WEIXINAPP</li>
-<li>如果是 H5 开通链接，支持传 INSIGHT / TELECOM。为空默认 INSIGHT </li></ul>
+        r"""<p>开通时候的身份验证方式, 取值为：</p><ul><li>**WEIXINAPP** : 微信人脸识别</li><li>**INSIGHT** : 慧眼人脸识别</li><li>**TELECOM** : 运营商三要素验证</li></ul>注：<ul><li>如果是小程序开通链接，仅支持传 WEIXINAPP。为空默认 WEIXINAPP</li><li>如果是 H5 开通链接，支持传 INSIGHT / TELECOM。为空默认 INSIGHT </li></ul>
         :rtype: list of str
         """
         return self._VerifyChannels
@@ -1108,11 +1080,7 @@ class AutoSignConfig(AbstractModel):
 
     @property
     def LicenseType(self):
-        r"""设置用户开通自动签时是否绑定个人自动签账号许可。
-
-<ul><li><b>1</b>: (默认)不绑定自动签账号许可开通，开通后一直有效,   后续使用合同份额进行合同发起</li></ul>
-
-注：`该字段已经失效，请勿设置此参数。`
+        r"""<p>设置用户开通自动签时是否绑定个人自动签账号许可。</p><ul><li><b>1</b>: (默认)不绑定自动签账号许可开通，开通后一直有效,   后续使用合同份额进行合同发起</li></ul><p>注：<code>该字段已经失效，请勿设置此参数。</code></p>
         :rtype: int
         """
         return self._LicenseType
@@ -1123,16 +1091,7 @@ class AutoSignConfig(AbstractModel):
 
     @property
     def JumpUrl(self):
-        r"""开通成功后前端页面跳转的url，此字段的用法场景请联系客户经理确认。
-
-注：`仅支持H5开通场景`, `跳转链接仅支持 https:// , qianapp:// 开头`
-
-跳转场景：
-<ul><li>**贵方H5 -> 腾讯电子签H5 -> 贵方H5** : JumpUrl格式: https://YOUR_CUSTOM_URL/xxxx，只需满足 https:// 开头的正确且合规的网址即可。</li>
-<li>**贵方原生App -> 腾讯电子签H5 -> 贵方原生App** : JumpUrl格式: qianapp://YOUR_CUSTOM_URL，只需满足 qianapp:// 开头的URL即可。`APP实现方，需要拦截Webview地址跳转，发现url是qianapp:// 开头时跳转到原生页面。`APP拦截地址跳转可参考：<a href='https://stackoverflow.com/questions/41693263/android-webview-err-unknown-url-scheme'>Android</a>，<a href='https://razorpay.com/docs/payments/payment-gateway/web-integration/standard/webview/upi-intent-ios/'>IOS</a> </li></ul>
-
-成功结果返回：
-若贵方需要在跳转回时通过链接query参数提示开通成功，JumpUrl中的query应携带如下参数：`appendResult=qian`。这样腾讯电子签H5会在跳转回的url后面会添加query参数提示贵方签署成功，例如：qianapp://YOUR_CUSTOM_URL?action=sign&result=success&from=tencent_ess
+        r"""<p>开通成功后前端页面跳转的url，此字段的用法场景请联系客户经理确认。</p><p>注：<code>仅支持H5开通场景</code>, <code>跳转链接仅支持 https:// , qianapp:// 开头</code></p><p>跳转场景：</p><ul><li>**贵方H5 -&gt; 腾讯电子签H5 -&gt; 贵方H5** : JumpUrl格式: https://YOUR_CUSTOM_URL/xxxx，只需满足 https:// 开头的正确且合规的网址即可。</li><li>**贵方原生App -&gt; 腾讯电子签H5 -&gt; 贵方原生App** : JumpUrl格式: qianapp://YOUR_CUSTOM_URL，只需满足 qianapp:// 开头的URL即可。<code>APP实现方，需要拦截Webview地址跳转，发现url是qianapp:// 开头时跳转到原生页面。</code>APP拦截地址跳转可参考：<a href="https://qian.tencent.com/developers/company/openqianh5/#3-%E8%BF%94%E5%9B%9E%E5%BA%94%E7%94%A8jumpurl%E6%A0%BC%E5%BC%8F">返回应用JumpUrl格式</a> </li></ul><p>成功结果返回：<br>若贵方需要在跳转回时通过链接query参数提示开通成功，JumpUrl中的query应携带如下参数：<code>appendResult=qian</code>。这样腾讯电子签H5会在跳转回的url后面会添加query参数提示贵方签署成功，例如：qianapp://YOUR_CUSTOM_URL?action=sign&amp;result=success&amp;from=tencent_ess</p>
         :rtype: str
         """
         return self._JumpUrl
@@ -5723,7 +5682,7 @@ class ChannelCreateFlowSignUrlRequest(AbstractModel):
         :type Agent: :class:`tencentcloud.essbasic.v20210526.models.Agent`
         :param _FlowId: <p>合同流程ID，为32位字符串。<br>建议开发者妥善保存此流程ID，以便于顺利进行后续操作。<br>可登录腾讯电子签控制台，在 &quot;合同&quot;-&gt;&quot;合同中心&quot; 中查看某个合同的FlowId(在页面中展示为合同ID)。</p>
         :type FlowId: str
-        :param _FlowApproverInfos: <p>流程签署人列表，其中结构体的ApproverType必传。<br>若为个人签署方或saas企业签署方，则Name，Mobile必传。OrganizationName 传对应企业名称。<br>若为子客企业签署方则需传OpenId、OrganizationOpenId、OrganizationName， 其他可不传。（如果对应OrganizationOpenId 子客已经认证激活了，则可以省去OrganizationName）</p><p>此结构体和发起接口参与方结构体复用，除了上述参数外，可传递的参数有：</p><ol><li>RecipientId: 发起合同会返回，可以直接用于指定需要生成链接的签署方。</li><li>ApproverSignTypes: 指定签署方签署时候的认证方式，仅此链接生效。</li><li>SignTypeSelector: 可以指定签署方签署合同的认证校验方式的选择模式。</li><li>Intention: 指定H5签署视频核身的意图配置，仅视频签署需要使用。</li></ol><p>注:<br><code>1. 签署人只能有手写签名、时间类型、印章类型、签批类型的签署控件和内容填写控件，其他类型的签署控件暂时未支持。</code><br><code>2. 生成发起方预览链接时，该字段（FlowApproverInfos）传空或者不传</code></p>
+        :param _FlowApproverInfos: <p>流程签署人列表，其中结构体的ApproverType必传。<br>若为个人签署方或saas企业签署方，则Name，Mobile必传。OrganizationName 传对应企业名称。<br>若为子客企业签署方则需传OpenId、OrganizationOpenId、OrganizationName， 其他可不传。（如果对应OrganizationOpenId 子客已经认证激活了，则可以省去OrganizationName）</p><p>此结构体和发起接口参与方结构体复用，除了上述参数外，可传递的参数有：</p><ol><li>RecipientId: 发起合同会返回，可以直接用于指定需要生成链接的签署方。</li><li>ApproverSignTypes: 指定签署方签署时候的认证方式，仅此链接生效。</li><li>SignTypeSelector: 可以指定签署方签署合同的认证校验方式的选择模式。</li><li>Intention: 指定H5签署视频核身的意图配置，仅视频签署需要使用。</li></ol><p>注:</p><ol><li>签署人<b>只能使用签名类型、时间类型、印章类型、签批类型的签署控件和内容填写控件</b>，其他类型的签署控件暂时不支持。</li><li>对于签名控件类型，支持手写签名、系统签名、个人印章等类型的签名方式，取决于合同发起时的设定。另外，签署的时候不支持拉取个人签署方已有签名图片资产，且创建的签名图片为一次性使用，不会保存为签署方个人资产。</li><li>生成发起方预览链接时，该字段（FlowApproverInfos）可以传空或者不传。</li></ol>
         :type FlowApproverInfos: list of FlowApproverInfo
         :param _VideoVerifyTimesLimit: <p>用于指定进入视频签署的限制次数，次数取值范围：1 - 10，不设置则默认为5次，仅视频签署时生效。</p>
         :type VideoVerifyTimesLimit: int
@@ -5772,7 +5731,7 @@ class ChannelCreateFlowSignUrlRequest(AbstractModel):
 
     @property
     def FlowApproverInfos(self):
-        r"""<p>流程签署人列表，其中结构体的ApproverType必传。<br>若为个人签署方或saas企业签署方，则Name，Mobile必传。OrganizationName 传对应企业名称。<br>若为子客企业签署方则需传OpenId、OrganizationOpenId、OrganizationName， 其他可不传。（如果对应OrganizationOpenId 子客已经认证激活了，则可以省去OrganizationName）</p><p>此结构体和发起接口参与方结构体复用，除了上述参数外，可传递的参数有：</p><ol><li>RecipientId: 发起合同会返回，可以直接用于指定需要生成链接的签署方。</li><li>ApproverSignTypes: 指定签署方签署时候的认证方式，仅此链接生效。</li><li>SignTypeSelector: 可以指定签署方签署合同的认证校验方式的选择模式。</li><li>Intention: 指定H5签署视频核身的意图配置，仅视频签署需要使用。</li></ol><p>注:<br><code>1. 签署人只能有手写签名、时间类型、印章类型、签批类型的签署控件和内容填写控件，其他类型的签署控件暂时未支持。</code><br><code>2. 生成发起方预览链接时，该字段（FlowApproverInfos）传空或者不传</code></p>
+        r"""<p>流程签署人列表，其中结构体的ApproverType必传。<br>若为个人签署方或saas企业签署方，则Name，Mobile必传。OrganizationName 传对应企业名称。<br>若为子客企业签署方则需传OpenId、OrganizationOpenId、OrganizationName， 其他可不传。（如果对应OrganizationOpenId 子客已经认证激活了，则可以省去OrganizationName）</p><p>此结构体和发起接口参与方结构体复用，除了上述参数外，可传递的参数有：</p><ol><li>RecipientId: 发起合同会返回，可以直接用于指定需要生成链接的签署方。</li><li>ApproverSignTypes: 指定签署方签署时候的认证方式，仅此链接生效。</li><li>SignTypeSelector: 可以指定签署方签署合同的认证校验方式的选择模式。</li><li>Intention: 指定H5签署视频核身的意图配置，仅视频签署需要使用。</li></ol><p>注:</p><ol><li>签署人<b>只能使用签名类型、时间类型、印章类型、签批类型的签署控件和内容填写控件</b>，其他类型的签署控件暂时不支持。</li><li>对于签名控件类型，支持手写签名、系统签名、个人印章等类型的签名方式，取决于合同发起时的设定。另外，签署的时候不支持拉取个人签署方已有签名图片资产，且创建的签名图片为一次性使用，不会保存为签署方个人资产。</li><li>生成发起方预览链接时，该字段（FlowApproverInfos）可以传空或者不传。</li></ol>
         :rtype: list of FlowApproverInfo
         """
         return self._FlowApproverInfos
@@ -17355,6 +17314,175 @@ class CreatePersonAuthCertificateImageResponse(AbstractModel):
         self._RequestId = params.get("RequestId")
 
 
+class CreateRequestWithEncryptionRequest(AbstractModel):
+    r"""CreateRequestWithEncryption请求参数结构体
+
+    """
+
+    def __init__(self):
+        r"""
+        :param _RequestAction: <p>操作的接口名称。取值参考接口文档输入参数章节关于公共参数 Action 的说明。</p>
+        :type RequestAction: str
+        :param _ApplicationId: <p>第三方应用的唯一标识，对应通用参数 Agent.AppId。</p>
+        :type ApplicationId: str
+        :param _IV: <p>加密算法使用的初始化向量。固定为 16 字节，将 IV 原始字节使用标准 Base64 编码后传入。</p>
+        :type IV: str
+        :param _EncryptedData: <p>使用 AES-CBC 或 SM4-CBC 加密请求内容得到的密文。加密前请求内容采用 PKCS#7 Padding；将密文原始字节使用标准 Base64 编码后传入。</p>
+        :type EncryptedData: str
+        :param _EncryptionSignature: <p>用于校验请求数据完整性。对 IV 原始字节和密文原始字节直接拼接（不加拼接符）后计算 HMAC-SHA256，再将计算结果使用标准 Base64 编码后传入。</p>
+        :type EncryptionSignature: str
+        """
+        self._RequestAction = None
+        self._ApplicationId = None
+        self._IV = None
+        self._EncryptedData = None
+        self._EncryptionSignature = None
+
+    @property
+    def RequestAction(self):
+        r"""<p>操作的接口名称。取值参考接口文档输入参数章节关于公共参数 Action 的说明。</p>
+        :rtype: str
+        """
+        return self._RequestAction
+
+    @RequestAction.setter
+    def RequestAction(self, RequestAction):
+        self._RequestAction = RequestAction
+
+    @property
+    def ApplicationId(self):
+        r"""<p>第三方应用的唯一标识，对应通用参数 Agent.AppId。</p>
+        :rtype: str
+        """
+        return self._ApplicationId
+
+    @ApplicationId.setter
+    def ApplicationId(self, ApplicationId):
+        self._ApplicationId = ApplicationId
+
+    @property
+    def IV(self):
+        r"""<p>加密算法使用的初始化向量。固定为 16 字节，将 IV 原始字节使用标准 Base64 编码后传入。</p>
+        :rtype: str
+        """
+        return self._IV
+
+    @IV.setter
+    def IV(self, IV):
+        self._IV = IV
+
+    @property
+    def EncryptedData(self):
+        r"""<p>使用 AES-CBC 或 SM4-CBC 加密请求内容得到的密文。加密前请求内容采用 PKCS#7 Padding；将密文原始字节使用标准 Base64 编码后传入。</p>
+        :rtype: str
+        """
+        return self._EncryptedData
+
+    @EncryptedData.setter
+    def EncryptedData(self, EncryptedData):
+        self._EncryptedData = EncryptedData
+
+    @property
+    def EncryptionSignature(self):
+        r"""<p>用于校验请求数据完整性。对 IV 原始字节和密文原始字节直接拼接（不加拼接符）后计算 HMAC-SHA256，再将计算结果使用标准 Base64 编码后传入。</p>
+        :rtype: str
+        """
+        return self._EncryptionSignature
+
+    @EncryptionSignature.setter
+    def EncryptionSignature(self, EncryptionSignature):
+        self._EncryptionSignature = EncryptionSignature
+
+
+    def _deserialize(self, params):
+        self._RequestAction = params.get("RequestAction")
+        self._ApplicationId = params.get("ApplicationId")
+        self._IV = params.get("IV")
+        self._EncryptedData = params.get("EncryptedData")
+        self._EncryptionSignature = params.get("EncryptionSignature")
+        memeber_set = set(params.keys())
+        for name, value in vars(self).items():
+            property_name = name[1:]
+            if property_name in memeber_set:
+                memeber_set.remove(property_name)
+        if len(memeber_set) > 0:
+            warnings.warn("%s fileds are useless." % ",".join(memeber_set))
+        
+
+
+class CreateRequestWithEncryptionResponse(AbstractModel):
+    r"""CreateRequestWithEncryption返回参数结构体
+
+    """
+
+    def __init__(self):
+        r"""
+        :param _IV: <p>加密算法使用的初始化向量。固定为 16 字节，将 IV 原始字节使用标准 Base64 编码后传入。</p>
+        :type IV: str
+        :param _EncryptedData: <p>使用 AES-CBC 或 SM4-CBC 加密返回内容得到的密文。加密前返回内容采用 PKCS#7 Padding；将密文原始字节使用标准 Base64 编码后传入。</p>
+        :type EncryptedData: str
+        :param _EncryptionSignature: <p>用于校验请求数据完整性。对 IV 原始字节和密文原始字节直接拼接（不加拼接符）后计算 HMAC-SHA256，再将计算结果使用标准 Base64 编码后传入。</p>
+        :type EncryptionSignature: str
+        :param _RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
+        :type RequestId: str
+        """
+        self._IV = None
+        self._EncryptedData = None
+        self._EncryptionSignature = None
+        self._RequestId = None
+
+    @property
+    def IV(self):
+        r"""<p>加密算法使用的初始化向量。固定为 16 字节，将 IV 原始字节使用标准 Base64 编码后传入。</p>
+        :rtype: str
+        """
+        return self._IV
+
+    @IV.setter
+    def IV(self, IV):
+        self._IV = IV
+
+    @property
+    def EncryptedData(self):
+        r"""<p>使用 AES-CBC 或 SM4-CBC 加密返回内容得到的密文。加密前返回内容采用 PKCS#7 Padding；将密文原始字节使用标准 Base64 编码后传入。</p>
+        :rtype: str
+        """
+        return self._EncryptedData
+
+    @EncryptedData.setter
+    def EncryptedData(self, EncryptedData):
+        self._EncryptedData = EncryptedData
+
+    @property
+    def EncryptionSignature(self):
+        r"""<p>用于校验请求数据完整性。对 IV 原始字节和密文原始字节直接拼接（不加拼接符）后计算 HMAC-SHA256，再将计算结果使用标准 Base64 编码后传入。</p>
+        :rtype: str
+        """
+        return self._EncryptionSignature
+
+    @EncryptionSignature.setter
+    def EncryptionSignature(self, EncryptionSignature):
+        self._EncryptionSignature = EncryptionSignature
+
+    @property
+    def RequestId(self):
+        r"""唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
+        :rtype: str
+        """
+        return self._RequestId
+
+    @RequestId.setter
+    def RequestId(self, RequestId):
+        self._RequestId = RequestId
+
+
+    def _deserialize(self, params):
+        self._IV = params.get("IV")
+        self._EncryptedData = params.get("EncryptedData")
+        self._EncryptionSignature = params.get("EncryptionSignature")
+        self._RequestId = params.get("RequestId")
+
+
 class CreateResultPageConfig(AbstractModel):
     r"""发起流程的可嵌入页面操作结果页配置
 

{tencentcloud_sdk_python_essbasic-3.1.164 → tencentcloud_sdk_python_essbasic-3.1.169}/tencentcloud_sdk_python_essbasic.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: tencentcloud-sdk-python-essbasic
-Version: 3.1.164
+Version: 3.1.169
 Summary: Tencent Cloud Essbasic SDK for Python
 Home-page: https://github.com/TencentCloud/tencentcloud-sdk-python
 Author: Tencent Cloud
@@ -15,7 +15,7 @@ Classifier: Programming Language :: Python :: 2.7
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.6
 Classifier: Programming Language :: Python :: 3.7
-Requires-Dist: tencentcloud-sdk-python-common<4.0.0,>=3.1.164
+Requires-Dist: tencentcloud-sdk-python-common<4.0.0,>=3.1.169
 
 ============================
 Tencent Cloud SDK for Python

tencentcloud_sdk_python_essbasic-3.1.169/tencentcloud_sdk_python_essbasic.egg-info/requires.txt

@@ -0,0 +1 @@
+tencentcloud-sdk-python-common<4.0.0,>=3.1.169

tencentcloud_sdk_python_essbasic-3.1.164/tencentcloud_sdk_python_essbasic.egg-info/requires.txt

@@ -1 +0,0 @@
-tencentcloud-sdk-python-common<4.0.0,>=3.1.164