本文档主要介绍了如何配置泛微Ecology9.0系统以实现第三方登录的单点登录功能。单点登录允许用户在一个系统中登录后,无需再次输入凭证即可访问其他关联系统,提高了用户体验和安全性。
1. **引言**
背景:在e-cology系统中,原先的单点登录方式是通过post方式调用/login/VerifyLogin.jsp,传入loginid(账号)、userpassword(密码)和logintype=1参数,但这种方法仅限于登录到e-cology的首页。为了提供更灵活的单点登录体验,e-cology引入了基于token验证的新机制。
2. **项目概述**
功能描述:新功能允许第三方系统首先调用获取token的接口,得到token后,将&ssoToken=token值附加到OA(Office Automation,办公自动化)系统的特定URL后面。当访问这个URL时,OA会验证token,验证成功则直接进入OA的指定页面,失败则重定向到OA的登录页面。
3. **功能说明**
- **配置说明**
- **web.xml配置**
在`ecology\WEB-INF\web.xml`中,需要添加一个名为`WeaverLoginFilter`的过滤器,配置通常放置在安全补丁包的后面,以确保过滤器能够正确处理请求。
- **WeaverLoginClient.properties配置**
需要配置与第三方系统交互的相关属性,例如API的URL、认证的key等,以便进行token的获取和验证。
- **接口说明**
- **获取token接口**
提供了一个接口用于第三方系统获取token,可能需要传递包括账号信息在内的参数,获取到的token用于后续的单点登录验证。
- **验证token接口**
接受包含token的请求,验证其有效性,返回验证结果。
- **Postman调用实例**
提供了使用Postman工具模拟调用这两个接口的示例,帮助开发者理解如何实际操作。
4. **实施步骤**
- 第三方系统需要先按照接口说明实现调用获取token的逻辑。
- 获取到token后,构建包含`ssoToken`参数的OA系统URL。
- 用户访问该URL,由OA系统进行token验证并处理相应页面跳转。
通过以上配置和接口调用,第三方系统可以无缝集成到泛微Ecology9.0的单点登录框架中,提供安全便捷的登录体验。在实际部署和使用过程中,需要根据具体需求和环境调整配置,确保所有接口调用和验证流程的正确性。