今天我们来实现一个使用个人订阅号实现网站的功能,后端使用的是 express
。其它框架原理基本一致,只是定义路由或返回响应数据部分代码跟 express
有所出入。先来一波效果图:
1. 前言
20 年 3 月在掘金写过一篇文章,介绍了使用 express
开发微信公众号的案例: 原文地址。当时使用的 nodejs
版本还是 v8.x
,现如今,nodejs
的最新长期稳定版已经来到了 v18.16.0
, 新特性尝鲜版更是已经到了 v20.1.0
。
不得不感慨时间之飞逝,nodejs 的版本升级之路见证了技术的飞速进步,也见证了我发际线的飞速退后。
…
2. 为何要用订阅号去登录
看了看掘金,发现掘金的登录注册分为两种:
- 手机号验证码注册
- 第三方登录(支持微信扫码、微博、Github)
企业站来说,这种方式固然好,给了用户提供了更多的选择。
但是对于个人站点,这种方式就不太友好了,因为:
手机号接收验证码注册:1 条短信 1 毛钱,10 条就是 1 块,100 条就能吃个豪华早餐了
接入微信开放平台是需要企业资质的。我一个打工人,上哪儿去搞企业资质?这就是一道坎,更别说后续接入的繁琐流程了。
Github 倒是不需要,不过接入也麻烦,弃之!
微博?用户没有微博账号是不是还得去注册个微博账号?弃!
那就普通的注册吧?填写用户名、密码、确认密码、输入邮箱,邮箱验证码确认?弃!
那么,它来了!订阅号注册免费,花极少的时间去接入
用户只需关注公众号,反手输入个登录,回车!Ctrl + CV。欸,很快啊,登录成功!
相对于传统的注册填一大堆资料 + 确认密码 + 验证码,孰好孰坏,熟快熟慢,一试便知。
而且,且看下图,它对于保护用户隐私来说,是极好的
,因为开发者只能拿到用户的 OpenID
,头像和昵称都不给你!
不过, 有 OpenID
就足够了,毕竟它对于当前公众号来说,是 唯一的
3. 公众号后台配置
完整的接入指南详见: https://developers.weixin.qq.com/doc/offiaccount/Basic_Information/Access_Overview.html
进入微信公众平台
设置与开发 -> 基本配置 -> 公众号开发信息 -> IP 白名单中配置你的服务器 IP
设置与开发 -> 基本配置 -> 服务器配置(未开启的需要先开启)
-
URL
是你的后端服务对应验证授权
的接口地址,也就是你后端服务部署后绑定了域名的接口地址。举例:https://www.xxx.com/wechat
-
Token
这块的Token
按照平台提示的规则自定义即可,注意,需要和上面代码中的Token
相对应,不然会验证不成功。 -
EncodingAESKey
是消息加解密密钥,这个可以随机生成,也可以自定义 -
消息加解密方式
选择明文模式即可
填写好上面这些内容之后,我们先不必急着点击提交
,因为这个时候服务还没部署,服务器是无法正常响应微信服务器的验证请求,必然会提交失败。
且看下文
4. 登录流程梳理
我们简单的梳理一下登录流程:
-
首先是需要在网站需要登录的地方,放置一个公众号的二维码,并用醒目的文字给用户提示:关注公众号后发送 “登录” ,获取登录所需要的验证码
-
后台接收到用户请求,判断用户发送的内容的确是 “登录” 关键字,返回一个验证码给用户,并将当前验证码存起来
-
用户输入验证码,后台根据存起来的验证码进行验证,验证成功,返回登录成功,否则,登录失败
5. 定义服务端路由,处理验证逻辑及服务端部署
5.1 定义授权验证接口
主要是验证消息的确来自微信服务器
import express from "express";
import jsSHA from "jssha";
const router = express.Router();
router.get("/wechat_mp", (req, res, next) => {const token = "这里是自定义Token,可自定义,内容规则详见下文";//1.获取微信服务器Get请求的参数 signature、timestamp、nonce、echostrconst { signature, timestamp, nonce, echostr } = req.query;//2.将token、timestamp、nonce三个参数进行字典序排序const array = [token, timestamp, nonce].sort();//3.将三个参数字符串拼接成一个字符串进行sha1加密const tempStr = array.join("");const shaObj = new jsSHA("SHA-1", "TEXT");shaObj.update(tempStr);const scyptoString = shaObj.getHash("HEX");//4.开发者获得加密后的字符串可与signature对比,标识该请求来源于微信if (signature === scyptoString) {console.log("验证成功");res.send(echostr);} else {console.log("验证失败");res.send("验证失败");}
});
5.2 处理用户 “登录” 消息
接下来我们定义用户发送消息的逻辑:
当用户发送文本消息给公众号的时候,微信服务器会将用户发送的消息以 XML格式
的参数去请求这个接口,只不过这个时候,我们需要通过 POST
请求来接收参数。
先上代码:
定义POST接口
import { parseString } from "xml2js";
import myCache from "../store";
/*** 随机6位验证码*/
function randomCode() {return Math.random().toString().slice(-6);
}
/*** 回复文字消息封装*/
function sendTextMsg(toUser, fromUser, content) {let resultXml = "<xml><ToUserName><![CDATA[" + fromUser + "]]></ToUserName>";resultXml += "<FromUserName><![CDATA[" + toUser + "]]></FromUserName>";resultXml += "<CreateTime>" + new Date().getTime() + "</CreateTime>";resultXml += "<MsgType><![CDATA[text]]></MsgType>";resultXml += "<Content><![CDATA[" + content + "]]></Content></xml>";return resultXml;
}
router.post("/wechat_mp", function (req, res) {var buffer = [];req.on("data", function (data) {buffer.push(data);});// 内容接收完毕req.on("end", function () {var msgXml = Buffer.concat(buffer).toString("utf-8");parseString(msgXml, { explicitArray: false }, function (err, result) {if (err) throw err;result = result.xml;const { ToUserName, FromUserName, MsgType, Content } = result;if (MsgType === "text" && Content === "登录") {const code = randomCode();// 这里的FromUserName就是用户的OpenIDmyCache.set(code, FromUserName, 1 * 60 * 5);const sendXml = sendTextMsg(ToUserName,FromUserName,`您的登录验证码是:${code} , 有效期为5分钟`);res.send(sendXml);}});});
});
store/index.js
import NodeCache from "node-cache";
const myCache = new NodeCache();
export default myCache;
代码解释:
-
XML 解析:可以通过安装
xml2js
这个库来解析XML
格式的参数 -
接化发:检测到用户发送
消息类型
为text
且内容为登录
关键字的时候,我们去生成一个6位随机验证码
,再将验证码和用户的OpenID
以key(code)、value(OpenId)
的格式存入 存入node-cache
中,并设置有效期为5分钟
,同时将随机验证码发送给用户。
5.3 处理网站登录逻辑
上一步,用户已经在微信公众号上获取到了随机验证码,现在只需要在网站需要登录的地方输入验证码,调用验证码校验接口即可进行校验。
定义验证码校验接口
import myCache from "../store";
router.get("/verify", async function (req, res) {const { code } = req.query;const OpenID = myCache.get(code);if (OpenID) {const token = "使用OpenID进行jwt鉴权颁发Token";res.json({code: 200,data: { token },});} else {res.json({code: 400,msg: "您输入的验证码有误或已过期,请重新输入!-_-",});}
});
代码解释:
根据用户输入的验证码,去 node-cache
中获取 OpenID
,如果存在,则说明验证码正确,jwt
鉴权颁发 Token
。反之,校验失败。
验证码校验成功后,通过唯一的 OpenID
和自定义的 secret
给用户颁发 Token
,用户再次访问网站的时候,只需要携带 Token
即可进行鉴权。
关于 jwt
鉴权概念、流程及使用,大家可以参考这条 AI 问答分享:
我在ChatGPTer(https://ai.iiter.cn)网站上创建了一个AI对话分享,快来看看吧!「jwt鉴权概念、流程」链接:https://ai.iiter.cn/#/share/6465c5a2e82a696c417bbfa9
同时,也欢迎大家自己进行 AI 问答: https://ai.iiter.cn
5.4 部署服务
服务部署这块大家可以参考我之前写的一篇傻瓜式部署文章:宝塔面板结合 pm2 进程管理工具部署前端项目
当然,您也可以使用自己顺手的部署方式
5.5 提交公众号配置
服务部署成功后,回到我们的 公众号后台配置
部分,点击提交即可
结语
至此,我们的个人订阅号登录功能就已经完成了,相信基于以上,大家都可以很快的去做出一个网站登录功能出来
而且在给用户提供服务的同时,可以直接将用户引导至自己的公众号上。不管是后面对网站的更新记录,还是一些重要的通知,都可以通过公众号进行消息推送,一举两得
好了,今天的文章分享就到这里了,如果对大家有所帮助的话,希望您不要吝啬手中的赞呦~
正式给大家介绍一下:
基于 OpenAI
的 API
开发的一款 ChatGPT
网站,模型是gpt-3.5-turbo
,使用的是本篇文章的同款登录方式,欢迎大家体验
免费!免费!免费!https://ai.iiter.cn