qingquan6 / wisedu-unified-login-api

模拟登陆 金智教务统一登陆系统 的API

wisedu-unified-login-api

模拟登陆金智教务统一登陆系统的API，可集成但不限于校园小程序，查成绩，课表，校园卡，二手市场等应用中

点个star支持一下吧

声明

1. 本项目仅供学习交流使用，如作他用所承受的任何直接、间接法律责任一概与作者无关
2. 如果此项目侵犯了您或者您公司的权益，请联系作者删除

项目结构

1. 源代码基于springboot构建
2. ide是IntelliJ IDEA 2019.3.3
3. 相关源文件说明

   \wisedu-unified-login-api
   │  .gitignore # git版本管理配置
   │  pom.xml # maven依赖包管理
   │  README.md # 说明文件
   │  tree.txt # 项目树形结构，使用tree命令生成
   │  
   ├─src # 源代码文件夹
   │  ├─main # main
   │  │  ├─java # java代码
   │  │  │  └─wiki
   │  │  │      └─zimo
   │  │  │          └─wiseduunifiedloginapi # basePackage
   │  │  │              │  WiseduUnifiedLoginApiApplication.java # springboot启动类
   │  │  │              │  
   │  │  │              ├─configuration # 配置
   │  │  │              │      SwaggerConfiguration.java # 注入swagger到spring容器
   │  │  │              │      
   │  │  │              ├─controller # controller
   │  │  │              │      ApiController.java # api
   │  │  │              │      
   │  │  │              ├─helper # 一些工具
   │  │  │              │      AESHelper.java # aes加密解密
   │  │  │              │      ImageHelper.java # 图片保存和二值化处理
   │  │  │              │      TesseractOCRHelper.java # ocr识别验证码
   │  │  │              │      
   │  │  │              └─service # service
   │  │  │                  │  LoginService.java # 模拟登陆
   │  │  │                  │  
   │  │  │                  └─impl
   │  │  │                          LoginServiceImpl.java # 模拟登陆实现
   │  │  │                          
   │  │  └─resources
   │  │      │  application.yml # springboot配置
   │  │      │  
   │  │      ├─static
   │  │      └─templates
   │  │              describe.html # 一个帮助生成功能描述的html
   │  │              
   │  └─test # test
   │      └─java
   │          └─wiki
   │              └─zimo
   │                  └─wiseduunifiedloginapi
   │                          WiseduUnifiedLoginApiApplicationTests.java
   │
   ├─screenshots # 截图
   └─tessdata # tess4j 训练集
       │  eng.traineddata
       │  osd.traineddata
       │  pdf.ttf
       │  pdf.ttx
       │  
       └─configs
               api_config
               digits
               hocr
               
   

api文档

1. 部署系统后访问http://host:port/wisedu-unified-login-api-v1.0/swagger-ui.html#/api-controller可查看文档(点击本章标题也可以查看文档)
2. host：为你的服务器地址，如果是本地，默认是localhost
3. port：为你的服务器端口，如果未修改，默认是8080
4. 此文档为swagger生成，可点击Try it out测试接口
5. 模拟登陆成功后的返回

   {
       "msg": "login success!",
       "code": 0,
       "cookies": "route=c02e1c52cb44ccedc7a00ac44a74ab3c;JSESSIONID=sKnaX6W3z7rN5AB9cQJ4An3OX3aOwq3aziPc4FIVW641bc_ihwXK!-173725045;CASTGC=TGT-1394-3FaIbOEbJ4RVrhgVrtVPRNzNNcODy6V3RMXRblvJdAfL5H3qMc1588506634030-QUpr-cas;CASPRIVACY=;iPlanetDirectoryPro=QCMaHbaG7vdSgN1QuSldJ0;asessionid=5ad7f5b4-eb74-4c3c-a694-76d24ea97b3f;MOD_AUTH_CAS=MOD_AUTH_ST-96230-7W9q97JkbbFzRLhj7hRr1588506634075-YBLG-cas"
   }

6. 模拟登陆失败后的返回

   {
       "msg": "login failed! 用户名或者密码错误",
       "code": 1,
       "cookies": null
   }

7. 默认配置针对宜宾学院，其他学校如果想设置为默认设置可以更改配置文件

依赖

1. tess4j：用于ocr识别验证码
2. fastjson：用于处理json数据
3. swagger：用于生成api文档
4. jsoup：用于解析html代码

其他

1. 理论上支持几乎所有的金智教务系统，iap或者cas，加密或者没加密均支持
2. 电子科技大学的金智教务系统由于加密和混淆过于变态，暂时没有时间分析，所以不支持

部署

1. 请先在服务器配置好tessreact，非常重要
2. 打包此项目为：war或者jar
3. war包放入tomcat等容器中，jar包使用java -jar xxx.jar命令执行
4. enjoy it !!!

更新

• 2020-06-03 支持更新后的CLOUD方式认证接口 v1.0.1
• 2020-05-08 开源模拟登陆API接口 v1.0

捐赠

1. 如果觉得作者做得不错，想捐赠我的话，请扫描下面的二维码