微信授权移动端登录以及确定唯一用户问题。

我会带着你远行 2024-04-23 12:56 57阅读 0赞

>  *  ?**作** **者**：[是江迪呀][Link 1]
>  *  ✒️**本文关键词**：`移动端`、`微信登录`
>  *  ☀️**每日 一言**：`知行合一！`

## 一、移动端使用微信登录流程 ##

### 1.1 实际业务流程图： ###

![在这里插入图片描述][e6e3d8b20d404800b253feb755aae5cb.png]

### 1.2 微信授权登录流程图： ###

![在这里插入图片描述][5b709ac23908442d8734467f6bf9a1ff.png]

#### 图中名词解释： ####

#### （1）什么是OAuth2.0? ####

OAuth 2.0（Open Authorization 2.0）是一种用于**授权**的开放标准，旨在允许**第三方应用程序**访问**用户**在**另一个服务提供者上的资源**，而无需共享用户的凭证。该协议广泛用于身份验证和授权的领域，特别是在互联网服务和应用程序中。

#### （2）角色 ####

*  **资源所有者（Resource Owner）：** 拥有资源的用户，这是指 —— **用户**。
 *  **客户端（Client）：** 试图访问资源的应用程序或服务，这里指 —— **第三方应用**。
 *  **授权服务器（Authorization Server）：** 负责验证资源所有者的身份并授予客户端访问资源的权限，这里指——**微信服务器**。
 *  **资源服务器（Resource Server）：** 存储和管理受保护的用户资源，仅在得到授权后提供这些资源，这里指——**微信服务器**。

## 二、步骤 ##

### 2.1 注册微信开放平台账号 ###

[官网地址入口][Link 2]

![在这里插入图片描述][6c40413494914c2baead75f31835434a.png]  
![在这里插入图片描述][27d5b9818e4946d2adbefc8a3416d72b.png]  
![在这里插入图片描述][de596fd776c94fdcb66c6b11a3099953.png]

注册后获取`AppId`和`secret`

### 2.2 对接SDK（前端需要做） ###

#### （1）IOS对接SDK ####

-(void)sendAuthRequest
    {
        
    	//构造SendAuthReq结构体
    	SendAuthReq* req =[[[SendAuthReq alloc]init]autorelease];
    	req.scope = @"snsapi_userinfo"; // 只能填 snsapi_userinfo
    	req.state = @"123";
    	//第三方向微信终端发送一个SendAuthReq消息结构
    	[WXApi sendReq:req];
    }

#### （2） Android对接SDK ####

{
        
    	// send oauth request
    	Final SendAuth.Req req = new SendAuth.Req();
    	req.scope = "snsapi_userinfo"; // 只能填 snsapi_userinfo
    	req.state = "wechat_sdk_demo_test";
    	api.sendReq(req);
    }

### 2.3 触发微信授权登录 ###

**我们以大众点评APP为例：**

#### (1) 拉起微信客户端 ####

有了步骤【2.2】后，用户在APP中点击**微信登陆**，微信客户端被拉起。

# 请求参数：
    appid: 步骤【2.1】注册后可以获取
    scope: 应用授权作用域，获取用户个人信息则填写 snsapi_userinfo

![在这里插入图片描述][07fde58e7ecf4ac0bccb0c3cd471ec2c.png]

#### (2) 用户点击【同意】【拒绝】【取消】返回值 ####

{
        
     	 "ErrCode": {
        
        "ERR_OK": 0,(用户同意) 
        "ERR_AUTH_DENIED": -4,（用户拒绝授权）
        "ERR_USER_CANCEL": -2（用户取消）
      },
      "code": "用户换取 access_token 的 code，仅在 ErrCode 为 0 时有效",
      "state": "第三方程序发送时用来标识其请求的唯一性的标志，由第三方程序调用 sendReq 时传入，由微信终端回传，state 字符串长度不能超过 1K",
      "lang": "微信客户端当前语言",
      "country": "微信用户当前国家信息"
    }

![在这里插入图片描述][87b5adb16a8e4c77a0561c10c770b82c.png]

在用户同意授权后，我们获得了一个很重要的参数：`code`

### 2.3 通过通过 code 获取 access\_token（后端需要做） ###

**接口：**

> GET: https://api.weixin.qq.com/sns/oauth2/access\_token?appid=APPID&secret=SECRET&code=CODE&grant\_type=authorization\_code

**参数：**

<table> 
 <thead> 
  <tr> 
   <th>参数</th> 
   <th>是否必须</th> 
   <th>说明</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>appid</td> 
   <td>是</td> 
   <td>应用唯一标识，在微信开放平台提交应用审核通过后获得</td> 
  </tr> 
  <tr> 
   <td>secret</td> 
   <td>是</td> 
   <td>应用密钥 AppSecret，在微信开放平台提交应用审核通过后获得</td> 
  </tr> 
  <tr> 
   <td>code</td> 
   <td>是</td> 
   <td>填写第一步获取的 code 参数</td> 
  </tr> 
  <tr> 
   <td>grant_type</td> 
   <td>是</td> 
   <td>固定填 authorization_code</td> 
  </tr> 
 </tbody> 
</table>

**返回：**

{
        
      "access_token": "ACCESS_TOKEN",
      "expires_in": 7200,
      "refresh_token": "REFRESH_TOKEN",
      "openid": "OPENID",
      "scope": "snsapi_userinfo",
      "unionid": "o6_bmasdasdsad6_2sgVt7hMZOPfL"
    }

**返回参数说明：**

<table> 
 <thead> 
  <tr> 
   <th>参数</th> 
   <th>说明</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>access_token</td> 
   <td>接口调用凭证</td> 
  </tr> 
  <tr> 
   <td>expires_in</td> 
   <td>access_token 接口调用凭证超时时间，单位（秒）</td> 
  </tr> 
  <tr> 
   <td>refresh_token</td> 
   <td>用户刷新 access_token</td> 
  </tr> 
  <tr> 
   <td>openid</td> 
   <td>接口调用凭证</td> 
  </tr> 
  <tr> 
   <td>scope</td> 
   <td>接口调用凭证</td> 
  </tr> 
  <tr> 
   <td>unionid</td> 
   <td>接口调用凭证</td> 
  </tr> 
 </tbody> 
</table>

### 2.4 获取用户信息（用户需要做） ###

**接口：**

> GET https://api.weixin.qq.com/sns/userinfo?access\_token=ACCESS\_TOKEN&openid=OPENID

**入参：**

<table> 
 <thead> 
  <tr> 
   <th>参数</th> 
   <th>是否必须</th> 
   <th>说明</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>access_token</td> 
   <td>是</td> 
   <td>调用凭证</td> 
  </tr> 
  <tr> 
   <td>openid</td> 
   <td>是</td> 
   <td>普通用户的标识，对当前开发者账号唯一</td> 
  </tr> 
  <tr> 
   <td>lang</td> 
   <td>否</td> 
   <td>国家地区语言版本，zh_CN 简体，zh_TW 繁体，en 英语，默认为 en</td> 
  </tr> 
 </tbody> 
</table>

**出参：**

{
        
      "openid": "OPENID", //普通用户的标识，对当前开发者账号唯一
      "nickname": "NICKNAME", //普通用户昵称
      "sex": 1, //普通用户性别，1 为男性，2 为女性
      "province": "PROVINCE", //普通用户个人资料填写的省份
      "city": "CITY", //	普通用户个人资料填写的城市
      "country": "COUNTRY", // 国家，如中国为 CN
      "headimgurl": "https://thirdwx.qlogo.cn/mmopen/g3MonUZtNHkdmzicIlibx6iaFqAc56vxLSUfpb6n5WKSYVY0ChQKkiaJSgQ1dZuTOgvLLrhJbERQQ4eMsv84eavHiaiceqxibJxCfHe/0",
      "privilege": ["PRIVILEGE1", "PRIVILEGE2"],
      "unionid": " o6_bmasdasdsad6_2sgVt7hMZOPfL"
    }

**出参说明：**

<table> 
 <thead> 
  <tr> 
   <th>参数</th> 
   <th>说明</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>openid</td> 
   <td>普通用户的标识，对当前开发者账号唯一</td> 
  </tr> 
  <tr> 
   <td>nickname</td> 
   <td>普通用户昵称</td> 
  </tr> 
  <tr> 
   <td>sex</td> 
   <td>普通用户性别，1 为男性，2 为女性</td> 
  </tr> 
  <tr> 
   <td>province</td> 
   <td>普通用户个人资料填写的省份</td> 
  </tr> 
  <tr> 
   <td>city</td> 
   <td>普通用户个人资料填写的城市</td> 
  </tr> 
  <tr> 
   <td>country</td> 
   <td>国家，如中国为 CN</td> 
  </tr> 
  <tr> 
   <td>headimgurl</td> 
   <td>用户头像，最后一个数值代表正方形头像大小（有 0、46、64、96、132 数值可选，0 代表 640*640 正方形头像），用户没有头像时该项为空</td> 
  </tr> 
  <tr> 
   <td>privilege</td> 
   <td>用户特权信息，json 数组，如微信沃卡用户为（chinaunicom）</td> 
  </tr> 
  <tr> 
   <td>unionid</td> 
   <td>用户统一标识。针对一个微信开放平台账号下的应用，同一用户的 unionid 是唯一的。</td> 
  </tr> 
 </tbody> 
</table>

### 2.5 刷新access\_token ###

#### (1) 刷新token ####

在步骤【2.4】中我们需要获取**微信用户的信息**，需要使用到`access_token`。这个令牌有效期是2小时。`refresh_token` 拥有较长的有效期（30 天）且无法续期，当 refresh\_token 失效的后，需要用户重新授权后才可以继续获取用户头像昵称。

**接口：**

> GET https://api.weixin.qq.com/sns/oauth2/refresh\_token?appid=APPID&grant\_type=refresh\_token&refresh\_token=REFRESH\_TOKEN

**入参：**

<table> 
 <thead> 
  <tr> 
   <th>参数</th> 
   <th>是否必须</th> 
   <th>说明</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>appid</td> 
   <td>是</td> 
   <td>应用唯一标识</td> 
  </tr> 
  <tr> 
   <td>grant_type</td> 
   <td>是</td> 
   <td>填 refresh_token</td> 
  </tr> 
  <tr> 
   <td>refresh_token</td> 
   <td>是</td> 
   <td>填写通过 access_token 获取到的 refresh_token 参数</td> 
  </tr> 
 </tbody> 
</table>

**出参：**

{
        
      "access_token": "ACCESS_TOKEN",
      "expires_in": 7200,
      "refresh_token": "REFRESH_TOKEN",
      "openid": "OPENID",
      "scope": "SCOPE"
    }

#### (2)验证token是否有效 ####

**接口：**

> GET https://api.weixin.qq.com/sns/auth?access\_token=ACCESS\_TOKEN&openid=OPENID

**入参：**

<table> 
 <thead> 
  <tr> 
   <th>参数</th> 
   <th>是否必须</th> 
   <th>说明</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>access_token</td> 
   <td>是</td> 
   <td>调用接口凭证</td> 
  </tr> 
  <tr> 
   <td>openid</td> 
   <td>是</td> 
   <td>普通用户标识，对该公众账号唯一证</td> 
  </tr> 
 </tbody> 
</table>

**出参：**

token有效返回：

{
        
      "errcode": 0,
      "errmsg": "ok"
    }

如果`access_token`失效了，那么需要重新让**用户授权登录**。

## 三、如何确定唯一用户 ##

### 3.1 使用UnionId确定唯一用户 ###

如果我们的产品拥有**移动端（IOS/Andriod）**、**网页端**、**微信小程序**，都是用微信登录，同一个用户使用在上述的客户端登陆，那么我们如果在自己的后端**服务器**中确定是同一个用户呢？  
答案是：通过`UnionId`

![在这里插入图片描述][263ef8be55554e6aab171365ab9e9dec.png]

**这里我举个微信小程序和移动端关联确定唯一用户的实例：**

**微信小程序登录接口**在**微信开放平台**绑定了小程序后，会返回`UnionId`：  
![在这里插入图片描述][cbfbf6fd2d4f4eae8b8f227cbb523409.png]

### 3.2 绑定微信小程序： ###

![在这里插入图片描述][bcedfaa093aa4656b9ff9a0e099954c2.png]  
测试返回值：

![在这里插入图片描述][15e6d09b51cf46729975dba4e82d6cd9.png]  
返回了`UnionId`。

[Link 1]: https://blog.csdn.net/qq_42785250?spm=1011.2124.3001.5343
[e6e3d8b20d404800b253feb755aae5cb.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/23/f1695582fb53466da59c04deda2a4aa1.png
[5b709ac23908442d8734467f6bf9a1ff.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/23/997421c7d6ad497f955c8db2967872da.png
[Link 2]: https://open.weixin.qq.com/
[6c40413494914c2baead75f31835434a.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/23/6438f04df16642c9ae4f9e850bb11e44.png
[27d5b9818e4946d2adbefc8a3416d72b.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/23/d5534875b6534479b48dcf2c76ab49e6.png
[de596fd776c94fdcb66c6b11a3099953.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/23/7c986f8f6aa64d36a439a5acfb463168.png
[07fde58e7ecf4ac0bccb0c3cd471ec2c.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/23/3a248a6dbde041dba150d3b61b356d3d.png
[87b5adb16a8e4c77a0561c10c770b82c.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/23/590389b4ba944da399c0d91b1fcac6c3.png
[263ef8be55554e6aab171365ab9e9dec.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/23/9721e25588584e6494be6aa16ba8c79e.png
[cbfbf6fd2d4f4eae8b8f227cbb523409.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/23/f14bbcf418b7495fa9b6d36000c4bda4.png
[bcedfaa093aa4656b9ff9a0e099954c2.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/23/37ab4608a8694b32bd16cb4ba082696a.png
[15e6d09b51cf46729975dba4e82d6cd9.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/23/ff420f0fb39c4d4fada29f446da3c1c6.png