对接企业微信API自建应用配置企业可信IP

news2024/12/23 10:06:35

前言

为了实现系统调用团队会议功能，组织发起企业微信会议，于是需要和企业微信做API对接。对接过程很难受，文档不清晰、没有SDK、没有技术支持甚至文档报文和实际接口报文都不匹配，只能说企业微信的API是从业以来见过的最难用的API，仅个人观点。

在配置自建应用后，访问API接口竟然需要设置可信IP，不论是出于安全还是别的商业目的，该手段都太古老，怎奈人在屋檐下不得不低头。可是在配置时又需要域名验证等杂七杂八的问题，特此记录解决过程分享给大家。

正文

1、自信满满配置IP

本以为打开这个页面直接输入外网IP即可，未曾想是个只读框，需要处理蓝色背景的提示信息，设置可信域名或解析加密URL

可信域名自然没有，申请证书申请域名费时费力，测试阶段根本没必要

于是选择第二个选项，文字描述很抽象，笔者也是查阅各方资料才总结出来。

大体意思就是要在能外网访问的机器上部署一个服务，当企业微信的测试请求访问过去时，按照一定的加解密规则以及入参，返回对应的响应信息。这样企业微信才认为你这台机器是“自己人”，允许你继续配置可信IP，简直就是！@#*￥&（）@！！。

2、骂骂咧咧获取信任

一回头看自己还在屋檐下，继续低头想办法呗。首先把后两项全部选择随机获取，记录好生成的字符串，一会发布服务需要使用。接下来表演开始：

2.1、准备外网服务器

找一台可以外网访问的机器，当然还需要一个打通的端口，在这台机器上安装Python3

2.2、获取Python项目

按照这个GitHub地址，下载一个python项目，解压后重命名为 weworkapi_python

https://github.com/sbzhu/weworkapi_python/archive/refs/heads/master.zip

也可以使用指令处理：

wget https://github.com/sbzhu/weworkapi_python/archive/refs/heads/master.zip
unzip master.zip
mv weworkapi_python-master weworkapi_python

2.3、执行监听服务脚本

与上述项目同级开启命令窗，使用下述脚本触发执行，其中执行前需要替换三个参数，前两个为刚刚随机生成的，最后一个在企业信息中可以看到的企业ID。

qy_api = [
    WXBizMsgCrypt("XXXXXXX", "XXXXXXX", "XXXXXXX"), 
] #对应接受消息回调模式中的token，EncodingAESKey 和 企业信息中的企业id

#-*- encoding:utf-8 -*-
from flask import abort, request
from flask import Flask
from xml.dom.minidom import parseString
import _thread
import time
import os
import sys
sys.path.append("weworkapi_python/callback")  # 正确的模块导入路径
from WXBizMsgCrypt3 import WXBizMsgCrypt   # https://github.com/sbzhu/weworkapi_python 项目地址
app = Flask(__name__)
 
# 对应步骤4中接受消息回调模式中的URL，如域名是'www.example.com' 那么在步骤4中填入的url就为"http://www.example.com/hook_path"
@app.route('/hook_path', methods=['GET','POST']) 
def douban():
    if request.method == 'GET':
        echo_str = signature(request, 0)
        return(echo_str)
    elif request.method == 'POST':
        echo_str = signature2(request, 0)
        return(echo_str)
 
qy_api = [
    WXBizMsgCrypt("qCV0ro7W4CJQtn3RHbVwgYU5GAZ29AK", "PQzmYlT4vGP3ItW9OmvreGkkLpDS3A9jH2GsyfDtP3q", "ww7b1bc3d6d"), 
] #对应接受消息回调模式中的token，EncodingAESKey 和 企业信息中的企业id
 
# 开启消息接受模式时验证接口连通性
def signature(request, i): 
    msg_signature = request.args.get('msg_signature', '')
    timestamp = request.args.get('timestamp', '')
    nonce = request.args.get('nonce', '')
    echo_str = request.args.get('echostr', '')
    ret,sEchoStr=qy_api[i].VerifyURL(msg_signature, timestamp,nonce,echo_str)
    if (ret != 0):
        print("ERR: VerifyURL ret: " + str(ret))
        return("failed")
    else:
        return(sEchoStr)
 
# 实际接受消息
def signature2(request, i):
    msg_signature = request.args.get('msg_signature', '')
    timestamp = request.args.get('timestamp', '')
    nonce = request.args.get('nonce', '')
    data = request.data.decode('utf-8')
    ret,sMsg=qy_api[i].DecryptMsg(data,msg_signature, timestamp,nonce)
    if (ret != 0):
        print("ERR: DecryptMsg ret: " + str(ret))
        return("failed")
    else:
        with open ("/var/log/qywx.log", 'a+') as f: # 消息接收日志
            doc = parseString(sMsg)
            collection = doc.documentElement
            name_xml = collection.getElementsByTagName("FromUserName")
            msg_xml = collection.getElementsByTagName("Content")
            type_xml = collection.getElementsByTagName("MsgType")
            pic_xml = collection.getElementsByTagName("PicUrl")
            msg = ""
            name = ""
            msg_type = type_xml[0].childNodes[0].data
            if msg_type == "text": #文本消息
                name = name_xml[0].childNodes[0].data        #发送者id
                msg = msg_xml[0].childNodes[0].data          #发送的消息内容
                f.write(time.strftime('[%Y-%m-%d %H:%M:%S]') + "[ch%d] %s:%s\n" % (i, name, msg))
                _thread.start_new_thread(os.system, ("python3 command.py '%s' '%s' '%d' '%d'" % (name, msg, i, 0), )) #此处将消息进行外部业务处理
                
            elif msg_type == "image": #图片消息
                name = name_xml[0].childNodes[0].data
                pic_url = pic_xml[0].childNodes[0].data
                f.write(time.strftime('[%Y-%m-%d %H:%M:%S]') + "[ch%d] %s:图片消息\n" % (i, name))
                _thread.start_new_thread(os.system, ("python3 command.py '%s' '%s' '%d' '%d'" % (name, pic_url, i, 1), ))  #此处将消息进行外部业务处理
 
            f.close()
 
        return("ok")
 
if __name__=='__main__':
    app.run("0.0.0.0", 8066)  #本地监听端口,可自定义