IdP512: 4-1 企业微信接口对接准备

        企业微信提供CARSI身份认证功能，CARSI IdP与企业微信通讯录进行对接。

        注：本文档由北大CARSI团队和腾讯企业微信团队共同整理。

对接准备：

1. CARSI以“自建应用”的方式加入学校的企业微信工作台，以“自建应用”通过企业微信通讯录进行身份认证的方式实现CARSI IdP功能。
2. 为使CARSI IdP能够准确获取使用者身份信息从而授予相应的CARSI SP使用权限，学校企业微信通讯录需配置以下用户属性
   1. 学工号。如果学校已经采用企业微信“userid”存放“学工号”，无需其他配置。如果“userid”已经存放非“学工号”的其他信息，需增加自定义属性“carsi_id”存放“学工号”供CARSI IdP使用。
   2. 用户身份。需增加自定义属性“carsi_af”存放，依据人员的具体身份，可赋值为CARSI标准取值中的几种：faculty（教师），student（学生），staff（教工），employee（雇员），member（各类人员，包括faculty、student、staff、employee），alum（校友），affiliate（附属人员或临聘，常用）。该取值将影响CARSI SP对用户访问的授权，需依据真实情况进行设置。
   3. 姓名（可选）。采用企业微信通讯录“name”字段。
   4. 邮箱（可选）。采用企业微信通讯录“email”字段。

一.  添加成员自定义信息（添加carsi_id、carsi_af两个字段）

操作路径：

管理后台->我的企业->通讯录管理->成员资料显示->全体成员信息显示->添加自定义信息

我的企业：

通讯录管理：

成员资料显示：

全体成员信息显示：

添加自定义信息：

二. 在学校通讯录中完善信息

• 按学校实际情况在“userid”或“carsi_id”字段完善学工号；
• 按学校实际情况完善姓名和电子邮箱信息，邮箱格式如 xxx@pku.edu.cn
• 按学校实际情况完善自定义字段“carsi_af”信息，取值不能为空。

备注：

为使CARSI IdP能够准确获取使用者身份信息从而授予相应的CARSI SP使用权限，学校企业微信通讯录务必配置完整以下用户属性：学工号、用户身份、姓名、邮箱。

1.     导入新成员信息

在导入新成员时，可对身份信息进行完善。

如：管理后台->通讯录->添加成员

2.     现有成员信息完善

2.1 批量导出后再导入

操作路径：

管理后台->通讯录->批量导入/导出->导出通讯录->（补充完善成员信息）->批量导入/导出->文件导入->上传文件（补充完善后的文件）

2.2 API接口管理通信录

API接口文档：更新成员 - 企业微信API

操作路径：

管理后台->管理工具->通讯录同步->权限（已开启API编辑通讯录）

2.3 批量设置成员信息

对已有成员的身份信息进行批量补充完善（相同身份的成员）

操作路径：

管理后台->通讯录->批量设置成员信息