魔学院
# 魔学院插件配置手册
# 一. 单点登录配置
# 1. IDAAS配置
# 1. 添加魔学院应用
管理员登录SSO360平台，【后台管理】-->【应用管理】-->【应用中心】-->【新增应用】
找到魔学院，【添加应用】
以下信息填写完整，【授权作用域】选择【base】，【对应SSO360登陆属性】选择【email】
# 2. 应用授权
【后台管理】-->【用户服务管理】-->【用户管理】，查找用户后，点击【查看详情】
【应用信息】-->【添加应用】
勾选【魔学院】，【确定】
# 2. 魔学院配置
无需配置，获取上面配置信息的方式如下
- CorpId、CorpSecret、Token、Key：管理员账号登录管理后台，【系统设置】-->【系统集成】-->【开放平台】，即可获取
应用登录地址：
- 测试环境：http://open.test.moxueyuan.com
- 生产环境：http://open.moxueyuan.com
PC网页端域名：【系统设置】-->【企业信息】，即可获取
# 3. 单点登录验证
# 1. 验证方式
通过IDAAS用户中心点击魔学院应用
# 2. 验证结果
# 二. 数据同步配置
# 1. 新建魔学院应用
管理员登录SSO360平台，【后台管理】-->【应用管理】-->【应用中心】-->【新增应用】
魔学院的开发文档: https://open.moxueyuan.com/#/developerTools
API域名——魔学院测试或生产环境的接口域名, 测试环境: http://open.test.moxueyuan.com (opens new window), 生产环境: https://open.moxueyuan.com
CorpId——魔学院平台中添加应有的 corpid
CorpSecret——魔学院平台中添加应有的 corpsecret
填写应用对应的参数和同步参数，然后点击”测试连通“按钮，确保应用连通成功。
# 2. 添加应用属性
说明：每个插件都会自动内置部分必需属性（内置的属性请勿删除），如果您的插件没有自定义属性，则无需添加，您可以跳过此步骤。
在【应用中心＞应用详情＞属性池】模块添加更多的应用同步的映射属性
# 3. 创建同步任务
在【应用管理】＞【同步任务】模块，创建下游魔学院同步任务，任务配置信息如下：
1）用户属性映射
| 字段名称 | SSO360字段 | SSO360是否必填 | 魔学院字段 |
|---|---|---|---|
| 邮箱 | 否 | ||
| 电话 | phone | 否 | mobile |
| 姓名 | xingming (自定义属性) | 否 | name |
| 性别 | gender | 否 | gender |
| 状态 | status | 是 | disabled |
| 工号 | jobNumber (自定义属性) | 否 | jobNumber |
| 职位 | OldJobPositionText (自定义属性) | 否 | position |
注意事项：
- sso360中自定义的属性, 属性名和是否必填可以在用户分类和用户属性池中配置
2）组织属性映射
| 字段名称 | SSO360字段 | SSO360是否必填 | 魔学院字段 |
|---|---|---|---|
| 组织名称 | orgName | 是 | name |
# 4. 应用授权
给要同步的用户添加魔学院应用权限
添加方式有两种：
1）直接给用户添加魔学院应用权限，在用户列表中，搜索到该用户，进入用户详情进行授权
【后台管理】-->【用户服务管理】-->【用户管理】，查找用户后，点击【查看详情】
【应用信息】-->【添加应用】
勾选【魔学院】，【确定】
2）给用户所关联的组织添加魔学院应用权限，在【应用授权】模块批量给组织授权
说明：如果某些用户没有授权该应用，则这些应用将无法同步到下游
# 5. 进行数据同步
1）增量同步
a、新增用户或组织同步
新创建的用户（用户分类和根组织满足同步任务配置），必须关联有魔学院应用权限的组织，进行增量同步时，才能同步成功。
新创建的组织（组织分类为默认分类，根组织满足同步任务配置），不用管是否有魔学院应用权限，进行增量同步时，都能同步成功。
b、修改或删除用户或组织同步
修改或删除用户时（用户分类和根组织满足同步任务配置），用户有魔学院应用权限，进行增量同步时，才能同步成功。
修改或删除组织时（组织分类为默认分类，根组织满足同步任务配置），不用管是否有魔学院应用权限，进行增量同步时，都能同步成功。
2）全量同步
新增或修改或删除用户（用户分类和根组织满足同步任务配置），用户有魔学院应用权限，进行全量同步时，才能同步成功。
新增或修改或删除组织（组织分类为默认分类，根组织满足同步任务配置），不用管是否有魔学院应用权限，进行全量同步时，都能同步成功。
# 6. 验证同步结果
使用你的魔学院管理员账号，去魔学院后台查看并验证同步数据结果
