小编推荐

随着电子合同需求的增长，客户对电子合同的要求愈发多元。为满足个性化需求，苍穹开放平台提供了基本认证等四种认证方式，其中基本认证无需与苍穹进行二次交互，备受青睐。与签章平台等应用进行安全对接时，基本认证是理想选择。具体如何，请看本文分解~

作者：白源。

1 业务背景

随着信息化的蓬勃发展，电子合同需求如涌泉般迅速增长。从合同的起草、审批、签署、存储到后续的分析、履行、管理、归档等诸多环节，客户对电子合同的要求愈发多元。这种多元化的需求不仅包括符合行业标准的要求，更涉及到能够灵活适应公司运营个性化场景的定制需求。

这种个性化需求在标准产品项目孵化中带来了额外的工作负担，特别是对于开发团队而言。在外部系统对接过程中，除了需要解决协议问题外，还需要处理不同系统采用的安全模式，因此背靠OpenAPI的安全策略成为不可或缺的支撑环节。

2 解决方案

对于大多数业务平台而言，它们已经存在且运行稳定，拥有既定的业务协议。然而，满足新需求的二次开发难度较大，可行性有限，而且大部分接口的授权认证方式受到限制。在苍穹5.0.011版本中，苍穹开放平台提供了基本认证、摘要认证、JWT认证和签名认证四种方式。其中，基本认证是唯一无需与苍穹进行二次交互的方式。因此，在安全的内部系统对接方案中，基本认证备受青睐。

所以，在和签章平台等需要通知消息对接到苍穹平台的应用，由于只进行一次交互，所以我们选择了基本认证。

2.1 启用基本认证

首先，创建一个专用的接口代理用户，并根据系统需求在第三方应用中创建相应的应用。在第三方应用中启用基本认证，并将创建好的接口用户添加到授权用户中即可轻松完成对接。这一流程简单而高效，为业务平台与苍穹的顺畅协作提供了可靠保障。

上传图片

2.2 维护回调地址

此外，如果需要动态向外部系统暴露已授权的接口，可以方便地通过“回调请求”来实现。苍穹提供了一种直接获取回调URL的方式。在完成前述步骤后，用户可以在API管理界面轻松配置回调地址。接下来，通过SQL或插件代码查询，即可获取到完整的已授权回调地址。

对于签章平台等系统，只需将获取到的回调地址嵌入接口数据中，便可实现回调通知的功能。这一过程简便而高效，为实现动态接口暴露和回调通知提供了便捷的解决方案。

上传图片

2.3 匿名接口

尽管基本认证在大多数场景中表现优异，但也存在一些例外情况。以某物业公司的对接为例，由于客户对API地址长度有一定要求，同时无法支持二次请求的认证模式，因此只能选择相对安全性较低的匿名访问。虽然苍穹并不推荐这种做法，但考虑到企业个性化需求，系统灵活地提供了满足这些情况的解决方案。

在这种情况下，首先通过MC配置启用匿名访问参数并进行发布：

上传图片

在API中新增自定义API（服务流程转API等也是Java插件的自定义API，同样可以使用），并开启匿名API的配置。

上传图片

上传图片

开启API中逻辑涉及到的单据的匿名访问权限控制，如某单据的保存、基础资料的查询等，都需要在属性的权限控制中进行配置。

上传图片

对于服务流程转API，也需要开启服务流程单据的相关匿名权限配置（致谢开放平台的刘毅老师和集成平台的张天越老师）。

上传图片

上传图片

对于其他二开性较高的业务系统，可以选择AccessToken认证，这种认证方式更安全。但需要注意的是请求中的请求头参数access_token，最好写为驼峰形式accessToken，原因是nginx默认下划线不合法，需要额外进行设置（致谢开放平台的胡海明老师）。

3 方案的可推广价值

本方案主要使用基本认证和匿名访问相结合的功能，在项目内和多个异构系统进行快速对接。这一方案极大地降低了对接的复杂性，开发人员能够更轻松地实现系统之间的互通，提高了整个项目的推进效率。具体价值体现在以下两个方面：

1. 灵活鉴权：利用苍穹的多种授权方式，开发者可以根据不同系统的特性和需求，选择最适合的授权模式。这不仅节省了二次开发的时间，同时提供了更加灵活的授权管控，满足了企业对于个性化授权需求的迅速变化。

2. 系统安全保护：即便在特殊情况下需要使用匿名访问，也可以根据苍穹提供的相应配置，并在保证个性需求的同时，最大限度地维护了整体系统的安全性。

#往期推荐#

# 实践案例 | 自定义API，无惧异构系统七十二变

# 实践案例 | WebService服务，解决多系统集成问题

# 实践案例 | OpenAPI助力企业业财一体化

# 实践案例 | 零代码配置API接口，打破信息孤岛

更多精彩内容，“码”上了解！↓

实践案例 | 把控安全，不挑业务系统的授权方式

实践案例 | 把控安全，不挑业务系统的授权方式

恭喜您！