美文网首页
iOS企业微信授权登录

iOS企业微信授权登录

作者: Geniune | 来源:发表于2021-02-26 13:39 被阅读0次

    企业微信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企业微信授权登录

          本文链接:https://www.haomeiwen.com/subject/qormfltx.html