一、创建自建应用
打开企微后台管理页面 选择应用管理 点击创建自建应用
填写应用名称 介绍 logo ,选择应用可见范围
创建好之后进入应用,能看见可见范围、管理员、应用主页(注:应用主页即项目页面部署的线上地址,如果需要单点登录就需要配置和后端联调对接oauth2的地址)、可信域名等相关配置
二、配置开发者接口(网页授权及JS-SDK、企业微信授权登录、企业可信IP)
1.配置可信域名
网页授权及JS-SDK,这个域名需和当前企业主体有关系的:
在配置可信域名时候,可能会标红报错,让你在此处下载个文件,然后将此文件给后端,让后台放在服务器上。然后再配置可信域名即可确认成功
文件放到域名服务器能访问到的目录,如:/usr/local/nginx/html/WW_verify_9ngwgcgXXXXXXXX.txt
2.配置企业可信IP
可信IP:把服务器的IP配进入,使用企业微信的相关接口有时候会报错,报错提示里也有IP,那就把那个提示的IP也配置进入。
3.配置授权登录回调页面
如果需要企业微信用户信息,配置这个,企业微信授权登录:
要求配置的授权回调域,必须与访问链接的域名完全一致。与配置可信域名的地址一致
三、网页接入企微自建应用
项目部署好之后,配置前端页面地址。
需要将网页授权登录拼接好的重定向链接放进去:
https://open.weixin.qq.com/connect/oauth2/authorize?appid=CORPID&redirect_uri=REDIRECT_URI&response_type=code&scope=snsapi_base&state=STATE&agentid=AGENTID#wechat_redirect
链接中粗体是需要替换的,参数说明如下
REDIRECT_URI 即为申请的外网可以访问的域名,与授权登录,配置可信域名的地址保持一致
四、部署服务
如果服务在内网,需要申请外网域名,并将内网代理至外网,将申请的外网域名配置到企微应用中。如果在外网直接部署即可。
需要准备:
-
外网可访问的、本企业认证的域名
-
部署前后端服务的内网端口、地址。
-
将内网部署好的服务代理至外网
-
在企微创建自建应用并配置