源码中包括了微信SDK + 企业微信SDK,与微信相关技术贴:
Universal Links填坑
微信授权登录
微信分享
与微信开发平台注册应用不同,这里需要登录“企业微信”后台进行设置:
- 使用管理员账号,登录企业微信管理后台,选择企业应用;
- 添加应用,进入应用详情页面;
- 选择“企业微信授权登录”,在设置界面填写iOS App的Bundle Id,设置完成后系统自动生成应用程序scheme。
注意:不允许跨企业使用,仅支持在企业自己的移动应用内使用
下载开发工具包并将其中的文件导入工程,包括:
libWXWorkApi.a
WWKApi.h
WWKApiObject.h
与微信授权登录功能一样,企业微信登录同样遵循OAuth 2.0协议
第一步:请求Authorization Code
原生应用使用微信SDK授权登录
WWKSSOReq *req = [[WWKSSOReq alloc] init];
req.state = @"ww_oauth_authorization_state";
[WWKApi sendReq:req];
在回调函数中获取code
- (void)onResp:(id)resp{
if([resp isKindOfClass:[WWKSSOResp class]]){//判断是否为授权登录类
WWKSSOResp *req = (WWKSSOResp *)resp;
if([req.state isEqualToString:@"ww_oauth_authorization_state"]){//微信授权成功
req.code //获得code
}
}
}
由于企业微信的业务API接口都需要依赖于access_token(登录凭证)来鉴权调用者身份
所以,下面的步骤都需要由服务端来实现
第二步:获取Access Token
登录企业微信管理后台,并准备以下入参:
- corpid 每个企业唯一的企业ID,获取此信息可在管理后台“我的企业”-“企业信息”下查看“企业ID”(需要有管理员账号)
- corpsecret 自建应用secret。在管理后台->“应用与小程序”->“应用”->“自建”,点进某个应用,即可看到(注意,每个应拥有独立的secret,因此不同应用需要分开获取)
发送GET请求到URL:
https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid=ID&corpsecret=SECRET
返回说明:
{
"errcode": 0,
"errmsg": "ok",
"access_token": "accesstoken000001",
"expires_in": 7200
}
access_token(登录凭证),用于调用其他企业微信业务API
注意:开放平台不建议将access_token返回给前端,需要由开发者保存在后台,并且所有访问企业微信业务API的请求由后台发起,理由当然是为了安全考虑
第三步:通过Authorization Code获取用户信息
前面两个步骤分别获取到了code和access_token,将他们作为入参,发送GET请求到URL:
https://qyapi.weixin.qq.com/cgi-bin/user/getuserinfo?access_token=ACCESS_TOKEN&code=CODE
返回说明:
{
"errcode": 0,
"errmsg": "ok",
"UserId":"USERID",
}
UserId(成员UserID)同属一个企业的同一个用户的UserId是唯一的,用于应用授权登录业务功能绑定
如果本文对你有所帮助记得点个赞哈:)