致远协创协同办公系统-A8-M平台API登录验证指南

"该文档是致远协创协同办公系统A8-M平台的API参考手册，主要涵盖服务参考、验证服务和组织模型管理等方面。" 在【标题】"验证服务-latex algorithms伪代码规范"中提到的验证服务是协同办公系统中的一个重要部分，用于确保只有合法的用户能够访问和调用系统服务。服务名称为`authorityService`，其WSDL（Web Service Description Language）定义了服务的接口和绑定，使得其他应用能够发现并使用该服务。 1. **身份验证令牌实体(UserToken)**: - `id` 是令牌的唯一标识，长度为36个字符。当用户名和密码验证失败时，`id`会被设置为-1。每次服务调用都需要一个有效的令牌ID。 2. **身份验证过程**: - 使用`authenticate`方法进行身份验证，需要传递`username`（服务用户名）和`password`（服务用户密码）作为参数。 - 默认的用户名是`service-admin`，初始密码是`123456`。密码可以通过修改系统参数`a8.plugin.webservice.password`来改变。默认情况下，密码以明文形式存储，但为了安全，可以设置`a8.plugin.webservice.password.encode`为1，然后在`a8.plugin.webservice.password`中存储密码的MD5值。 3. **返回值**: - 成功验证后，服务返回一个`UserToken`对象，该令牌可以在15分钟内多次使用。每次成功请求都会延长令牌有效期10分钟，但最长有效期不超过15分钟。这意味着不必在每次请求前都重新登录。 4. **示例代码**: - 提供了Java和C#两种语言的示例代码，展示了如何调用`authenticate`方法进行身份验证，并处理返回的`UserToken`。 5. **开发指南**: - 对于启用Web服务、配置开发环境以及开始编码（Java和C#）的步骤有详细说明，包括生成ADBClientStub（Java）和添加服务引用（C#）。 6. **服务列表和服务公共实体**: - 文档还列出了其他的服务，如组织模型管理，包括单位管理、人员管理和部门管理，每个部分都有相应的实体和方法，用于创建、获取、修改和删除组织结构的相关信息。 7. **服务异常处理**: - 提到了`ServiceException`，这是服务调用过程中可能出现的异常情况，开发人员需要适当地捕获和处理这类异常。 这份参考手册对开发者来说是宝贵的资源，提供了实现与致远OA系统交互所需的详细信息，涵盖了从认证到数据操作的整个流程。