midpoint源码阅读一（midpoint简介）

柔情只为你懂 2022-05-28 11:47 344阅读 0赞

最近在研究身份管理这块儿领域，本人初涉这块儿领域，在业务上的了解不是很深入，俗话说做事需要站在巨人的肩膀上，目前在开源领域中专注做这一领域的比较好的项目是midpoint，现将对该项目的一个源码解读逐步记录下来。本篇为第一篇，主要是对midpoint的介绍和其使用到的技术的简单介绍。  
1、midpoint官方文档  
官方介绍文档：[https://wiki.evolveum.com/display/midPoint/Home][https_wiki.evolveum.com_display_midPoint_Home]  
下载地址：[https://evolveum.com/download/][https_evolveum.com_download]  
GitHub地址：[https://github.com/Evolveum/midpoint][https_github.com_Evolveum_midpoint]  
2、midpoint简介  
关于什么是midpoint，它能做什么，官网介绍地址为：[https://evolveum.com/midpoint/about-midpoint/][https_evolveum.com_midpoint_about-midpoint]  
midpoint目前还没有中文的文档，在此我做一个简单的介绍。  
midpoint是身份管理系统。 它是个综合系统，可从不同的存储库中同步身份信息，以统一的形式使用它们，包含角色管理、授权、认证、权利管理、工作流等，几乎涵盖身份管理的每个方面。 它在身份和访问管理(IAM)领域属于“管理”部分。  
3、midpoint架构  
官网介绍在此：[https://wiki.evolveum.com/display/midPoint/Architecture+and+Design][https_wiki.evolveum.com_display_midPoint_Architecture_and_Design]  
![架构][70]  
从上面的官网介绍的架构图看，我们看出midpoiont由如下子系统构成：  
1）界面子系统（GUI Subsystem）  
顾名思义，界面子系统即是用户操作的界面  
2）IDM Model子系统（IDM Model Subsystem）  
该子系统提供了IDM Model Interface（IDM Model接口），该接口用于连接用户界面和业务逻辑，同时也能被其他系统所使用。  
3）物资提供子系统（Provisioning Subsystem）  
该子系统从我的了解中，它是连接外部系统的通道，即通过Provisioning Subsystem可以获取到其他系统中的身份信息。  
该子系统使用的是[ConnId框架][ConnId]。ConnId (Connectors for Identity Management)框架是Identity Connectors Framework (ICF)的延续，即简单的说通过它可以很方便的同步到其他系统的身份信息。  
4）存储库子系统（Repository Subsystem）  
顾名思义，该系统是存储IDM对象的，比如User, Account, Resource, Role等等，它接收其他子系统使用的**XML数据对象**，并将它们转换为适合于数据存储的任何格式。  
5）基础设施子系统（Infrastructure Subsystem）  
该子系统包含了日志、跟踪等等其他类似的组件，提供了一些系统使用到的一些组件和工具包。  
上图中的橘黄色（颜色较深）的几个框在后续的代码结构中会有详细说明，在此不再介绍。  
4、midpoint子系统调用关系  
[官网图][Link 1]如下：  
![这里写图片描述][70 1]  
各个子系统是通过spring framwork连接在一起的。  
上图简化来说就是比如用户登陆，用户在GUI Subsystem输入用户名/密码后点击登陆，系统会在IDM Model Subsystem中完成密码的认证和该用户权限的获取，这些信息需要由Repository Subsystem提供，在IDM Model Subsystem中认证成功后，登陆系统，若用户查看自己的账号信息（该用户在其他业务系统中的账号），这时就需要用到Provisioning Subsystem去其他系统中抓取该用户的账号。  
5、midpoint源码结构介绍  
官网地址为：[https://wiki.evolveum.com/display/midPoint/Source+Code+Structure][https_wiki.evolveum.com_display_midPoint_Source_Code_Structure]

<table> 
 <thead> 
  <tr> 
   <th>总目录</th> 
   <th>子目录</th> 
   <th>说明</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>gui/</td> 
   <td></td> 
   <td>GUI Subsystem</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>admin-gui/</td> 
   <td>系统管理员界面</td> 
  </tr> 
  <tr> 
   <td>model/</td> 
   <td></td> 
   <td>IDM Model Subsystem</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>model-api/</td> 
   <td>IDM Model接口</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>model-impl/</td> 
   <td>Model Web Service Client，用户midpoint功能远程访问的独立库</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>model-client/</td> 
   <td>系统管理员界面</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>model-common/</td> 
   <td>模型子系统组件之间共享的公共函数库。包含更复杂的表达式、映射、函数库等</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>model-test/</td> 
   <td>model组建测试库</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>model-test/</td> 
   <td>model子系统集成测试</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>workflow-api/</td> 
   <td>工作流组件接口</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>workflow-impl/</td> 
   <td>基于Activiti BPM引擎的工作流实现</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>notifications-api/</td> 
   <td>通知组件接口</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>notifications-impl/</td> 
   <td>通知组件实现（邮件通知）</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>report-api/</td> 
   <td>报表组件接口</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>report-impl/</td> 
   <td>基于Jasper Reports报表组件实现</td> 
  </tr> 
  <tr> 
   <td>provisioning/</td> 
   <td></td> 
   <td>Provisioning Subsystem</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>provisioning-api/</td> 
   <td>Provisioning子系统接口</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>provisioning-impl/</td> 
   <td>Provisioning子系统实现</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>ucf-api</td> 
   <td>基于Jasper Reports报表组件实现</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>ucf-impl-connid</td> 
   <td>ConnId框架的统一连接框架的实现</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>ucf-impl-builtin</td> 
   <td>如手动设置连接的内建连接的统一连接框架的实现</td> 
  </tr> 
  <tr> 
   <td>repo/</td> 
   <td></td> 
   <td>Repository Subsystem</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>repo-api/</td> 
   <td>身份存储接口</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>repo-sql-impl/</td> 
   <td>基于关系型数据库的身份存储接口实现</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>audit-api/</td> 
   <td>认证接口</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>audit-impl/</td> 
   <td>认证接口实现</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>task-api/</td> 
   <td>任务管理接口</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>task-quartz-impl/</td> 
   <td>基于Quartz库的任务管理接口实现</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>security-api</td> 
   <td>安全API</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>security-impl</td> 
   <td>安全API实现</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>repo-common</td> 
   <td>在repo、provisioning、model子系统的组件中使用的公共包。包含的类用于在provisioning中所需的基本表达式</td> 
  </tr> 
  <tr> 
   <td>infra/</td> 
   <td></td> 
   <td>Infrastructure Subsystem</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>common/</td> 
   <td>普通的midpoint函数，可用于其他组件</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>prism/</td> 
   <td>Prism对象框架的实现</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>schema/</td> 
   <td>Data Model的实现</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>util/</td> 
   <td>通用实用程序</td> 
  </tr> 
  <tr> 
   <td>icf-connectors/</td> 
   <td></td> 
   <td>用于midpoint内部测试的假连接</td> 
  </tr> 
  <tr> 
   <td>tools/</td> 
   <td></td> 
   <td>如JAXB插件、NG测试支持代码、misc脚本等的Misc开发和构建工具</td> 
  </tr> 
  <tr> 
   <td>dist/</td> 
   <td></td> 
   <td>midpoint分发包</td> 
  </tr> 
  <tr> 
   <td>samples/</td> 
   <td></td> 
   <td>示例代码</td> 
  </tr> 
  <tr> 
   <td>build-system/</td> 
   <td></td> 
   <td>构建系统的基本设置</td> 
  </tr> 
  <tr> 
   <td>testing/</td> 
   <td></td> 
   <td>集成 、点到点测试</td> 
  </tr> 
  <tr> 
   <td>legal/</td> 
   <td></td> 
   <td>法律事务（如复制和分发）</td> 
  </tr> 
 </tbody> 
</table>

[https_wiki.evolveum.com_display_midPoint_Home]: https://wiki.evolveum.com/display/midPoint/Home
[https_evolveum.com_download]: https://evolveum.com/download/
[https_github.com_Evolveum_midpoint]: https://github.com/Evolveum/midpoint
[https_evolveum.com_midpoint_about-midpoint]: https://evolveum.com/midpoint/about-midpoint/
[https_wiki.evolveum.com_display_midPoint_Architecture_and_Design]: https://wiki.evolveum.com/display/midPoint/Architecture+and+Design
[70]: /images/20220528/02e901fcf58e431081d14cb1ab4c9913.png
[ConnId]: http://connid.tirasa.net/
[Link 1]: https://wiki.evolveum.com/display/midPoint/Architecture+and+Design?preview=/655364/884738/High-Level%20Architecture.png
[70 1]: /images/20220528/d4d4b6d0cff14e6d913758aaa3148c45.png
[https_wiki.evolveum.com_display_midPoint_Source_Code_Structure]: https://wiki.evolveum.com/display/midPoint/Source+Code+Structure