iOS企业微信授权登录

企业微信API文档
Demo源码 (记得给个star哦)

源码中包括了微信SDK + 企业微信SDK,与微信相关技术贴:
Universal Links填坑
微信授权登录
微信分享


与微信开发平台注册应用不同,这里需要登录“企业微信”后台进行设置:

  1. 使用管理员账号,登录企业微信管理后台,选择企业应用;
  2. 添加应用,进入应用详情页面;
  3. 选择“企业微信授权登录”,在设置界面填写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

如何获取登录凭证

登录企业微信管理后台,并准备以下入参:

  1. corpid 每个企业唯一的企业ID,获取此信息可在管理后台“我的企业”-“企业信息”下查看“企业ID”(需要有管理员账号)
  2. 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是唯一的,用于应用授权登录业务功能绑定

如果本文对你有所帮助记得点个赞哈:)

你可能感兴趣的:(iOS企业微信授权登录)