Java企业微信开发_09_身份验证之移动端网页授权(有完整项目源码)

注： 源码已上传github： https://github.com/shirayner/WeiXin_QiYe_Demo

一、本节要点

1.1 授权回调域（可信域名）

在开始使用网页授权之前，需要先设置一下授权回调域。这里瞬间想到之前做JSSDK的时候，也设置过一个域名。二者本质上都是设置可信域名。

当用户授权完毕之后，请求将重定向到此域名（或者子域名）下的执行者（jsp页面或者servlet等）。如何设置授权回调域，请见第二节。

1.2 获取Code

https://open.weixin.qq.com/connect/oauth2/authorize?appid=CORPID&redirect_uri=REDIRECT_URI&response_type=code&scope=SCOPE&agentid=AGENTID&state=STATE#wechat_redirect

可将根据此链接生成一个view菜单按钮，用户点击此按钮时，将跳转到授权页面，授权成功后，页面重定向到指定的REDIRECT_URI页面，同时带上code和state请求参数，即页面将跳转至 redirect_uri?code=CODE&state=STATE页面。

1.3 移动端网页授权流程

（1）用户点击1.2中菜单按钮，跳转至授权页面

（2）用户授权成功，页面重定向到 redirect_uri?code=CODE&state=STATE 页面

（3）接收code，根据code获取成员信息（UserId，user_ticket）

（4）拿到UserId后可选择去根据UserId获取成员详细信息， 参见Java企业微信开发_02_通讯录同步 中的 Contacts_UserService类

（5） 拿到 user_ticket后可选择去使用user_ticket获取成员详情（其中包括用户头像）

在此我们只关注于打通 企业微信官方文档中 移动端网页授权 相关的接口，这是基础，至于实际工作中企业是如何去具体实现他们自己的授权业务，暂时不在我们讨论的范围内。

二、代码实现

2.1设置可信域名（授权回调域）

登录企业微信后台—>企业应用—>自建应用中的你的具体应用—>企业微信授权登录—>Web网页

2.2 生成菜单按钮

添加一个用于网页授权的菜单按钮，运行MenuTest.testCreateMenu（）方法生成按钮。

在已经成功生成菜单按钮时，有时可能出现菜单没有及时更新的情况，这时可以通过取消关注企业号，再重新关注企业号来解决这个问题。

（1）MenuService.java

package com.ray.service;

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

import com.google.gson.Gson;
import com.ray.pojo.menu.Button;
import com.ray.pojo.menu.CommonButton;
import com.ray.pojo.menu.ComplexButton;
import com.ray.pojo.menu.Menu;
import com.ray.pojo.menu.ViewButton;
import com.ray.util.WeiXinUtil;

import net.sf.json.JSONObject;

public class MenuService {
    private static Logger log = LoggerFactory.getLogger(MenuService.class);
    // 菜单创建（POST） 限100（次/天）
    public static String create_menu_url = "https://qyapi.weixin.qq.com/cgi-bin/menu/create?access_token=ACCESS_TOKEN&agentid=AGENTID";  

    /**
     * 1.创建菜单
     *
     * @param menu 菜单实例
     * @param accessToken 有效的access_token
     * @return 0表示成功，其他值表示失败
     */
    public void createMenu(String accessToken,Menu menu,int agentId) {  

        //1.获取json字符串：将Menu对象转换为json字符串
        Gson gson = new Gson();
        String jsonMenu =gson.toJson(menu);      //使用gson.toJson(user)即可将user对象顺序转成json
        System.out.println("jsonMenu:"+jsonMenu);

        //2.获取请求的url
        create_menu_url = create_menu_url.replace("ACCESS_TOKEN", accessToken)
                .replace("AGENTID", String.valueOf(agentId));  

        //3.调用接口,发送请求，创建菜单
        JSONObject jsonObject = WeiXinUtil.httpRequest(create_menu_url, "POST", jsonMenu);
        System.out.println("jsonObject:"+jsonObject.toString());

        //4.错误消息处理
        if (null != jsonObject) {
            if (0 != jsonObject.getInt("errcode")) {
                log.error("创建菜单失败 errcode:{} errmsg:{}", jsonObject.getInt("errcode"), jsonObject.getString("errmsg"));
            }
        }  

    }  

    /**
     * 2.组装菜单数据
     *
     * @return
     */
    public  Menu getMenu() {
    /*    ViewButton btn11 = new ViewButton();
        btn11.setName("添加报销单");
        btn11.setType("view");
        btn11.setUrl("http://5nffqn.natappfree.cc/WeiXin_QiYe_Demo/uploadExpenseAccaout.jsp");
*/
        ViewButton btn11 = new ViewButton();
        btn11.setName("JSSDK多图上传");
        btn11.setType("view");
        btn11.setUrl("http://zvuntx.natappfree.cc/WeiXin_QiYe_Demo/JSSDKUploadPics.jsp");  

        ViewButton btn21 = new ViewButton();
        btn21.setName("JSSDK测试（全）");
        btn21.setType("view");
        btn21.setUrl("http://zvuntx.natappfree.cc/WeiXin_QiYe_Demo/jsapiTicktAll.jsp");  

        ViewButton btn22 = new ViewButton();
        btn22.setName("PC端网页授权");
        btn22.setType("view");
        btn22.setUrl("https://open.work.weixin.qq.com/wwopen/sso/qrConnect?appid=ww92f5da92bb24696e&agentid=1000002&redirect_uri=http%3A%2F%2Fzvuntx.natappfree.cc%2FWeiXin_QiYe_Demo%2FPCAuthorization.jsp&state=state");  

        ViewButton btn23 = new ViewButton();
        btn23.setName("移动端网页授权");
        btn23.setType("view");
        btn23.setUrl("https://open.weixin.qq.com/connect/oauth2/authorize?appid=ww92f5da92bb24696e&redirect_uri=http%3A%2F%2Fzvuntx.natappfree.cc%2FWeiXin_QiYe_Demo%2FMTAuthorization.jsp&response_type=code&scope=snsapi_privateinfo&agentid=1000002&state=hec#wechat_redirect");  

        CommonButton btn12 = new CommonButton();
        btn12.setName("扫一扫");
        btn12.setType("click");
        btn12.setKey("12");  

        CommonButton btn13 = new CommonButton();
        btn13.setName("翻译功能");
        btn13.setType("click");
        btn13.setKey("13");  

        ViewButton btn14 = new ViewButton();
        btn14.setName("上传图片");
        btn14.setType("view");
        btn14.setUrl("http://5nffqn.natappfree.cc/WeiXin_SanFenBaiXue/uploadimg.jsp");  

        ViewButton btn15 = new ViewButton();
        btn15.setName("上传图片2");
        btn15.setType("view");
        btn15.setUrl("http://5nffqn.natappfree.cc/WeiXin_SanFenBaiXue/index2.jsp");  

        CommonButton btn24 = new CommonButton();
        btn24.setName("人脸识别");
        btn24.setType("click");
        btn24.setKey("24");  

        CommonButton btn25 = new CommonButton();
        btn25.setName("聊天唠嗑");
        btn25.setType("click");
        btn25.setKey("25");  

        CommonButton btn31 = new CommonButton();
        btn31.setName("Q友圈");
        btn31.setType("click");
        btn31.setKey("31");  

        CommonButton btn33 = new CommonButton();
        btn33.setName("幽默笑话");
        btn33.setType("click");
        btn33.setKey("33");  

        CommonButton btn34 = new CommonButton();
        btn34.setName("用户反馈");
        btn34.setType("click");
        btn34.setKey("34");  

        CommonButton btn35 = new CommonButton();
        btn35.setName("关于我们");
        btn35.setType("click");
        btn35.setKey("35");  

        ViewButton btn32 = new ViewButton();
        btn32.setName("周边搜索");
        btn32.setType("view");
        btn32.setUrl("http://liufeng.gotoip2.com/xiaoqrobot/help.jsp");  

        ComplexButton mainBtn1 = new ComplexButton();
        mainBtn1.setName("正在做功能");
        mainBtn1.setSub_button(new Button[] { btn11, btn12, btn13, btn14, btn15 });  

        ComplexButton mainBtn2 = new ComplexButton();
        mainBtn2.setName("测试");
        mainBtn2.setSub_button(new Button[] { btn21, btn22, btn23, btn24, btn25 });  

        ComplexButton mainBtn3 = new ComplexButton();
        mainBtn3.setName("更多");
        mainBtn3.setSub_button(new Button[] { btn31, btn33, btn34, btn35, btn32 });  

        /**
         * 这是企业号目前的菜单结构，每个一级菜单都有二级菜单项<br>
         *
         * 在某个一级菜单下没有二级菜单的情况，menu该如何定义呢？<br>
         * 比如，第三个一级菜单项不是“更多体验”，而直接是“幽默笑话”，那么menu应该这样定义：<br>
         * menu.setButton(new Button[] { mainBtn1, mainBtn2, btn33 });
         */
        Menu menu = new Menu();
        menu.setButton(new Button[] { mainBtn1, mainBtn2, mainBtn3 });  

        return menu;
    }  

}

（2）MenuTest.java

package com.ray.test;

import org.junit.Test;

import com.ray.pojo.menu.Menu;
import com.ray.service.MenuService;
import com.ray.util.WeiXinParamesUtil;
import com.ray.util.WeiXinUtil;

public class MenuTest {

  @Test
  public void testCreateMenu(){
      //1.组装菜单
      MenuService ms=new MenuService();
      Menu menu=ms.getMenu();

      //2.获取access_token:根据企业id和应用密钥获取access_token
      String accessToken=WeiXinUtil.getAccessToken(WeiXinParamesUtil.corpId, WeiXinParamesUtil.agentSecret).getToken();
      System.out.println("accessToken:"+accessToken);

      //3.创建菜单
      ms.createMenu( accessToken, menu, WeiXinParamesUtil.agentId);

  }

}

2.3 移动端网页授权业务类——MTAuthorizationService.java

包括两个方法：

（1）根据code获取成员信息

（2）使用userTicket获取成员详情

package com.ray.service;

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

import com.google.gson.Gson;
import com.ray.pojo.UserTicket;
import com.ray.util.WeiXinUtil;

import net.sf.json.JSONObject;

/**
 * @desc  : 移动端网页授权Service
 *
 * @author: shirayner
 * @date  : 2017年9月14日 下午12:18:38
 */
public class MTAuthorizationService {
    private static Logger log = LoggerFactory.getLogger(MenuService.class);  

    public static final String GET_USERINFO_URL = "https://qyapi.weixin.qq.com/cgi-bin/user/getuserinfo?access_token=ACCESS_TOKEN&code=CODE";  

    public static final String GET_USERDETAIL_URL = "https://qyapi.weixin.qq.com/cgi-bin/user/getuserdetail?access_token=ACCESS_TOKEN";  

    /** 1.根据code获取成员信息
     * @desc ：GET请求、
     * 成员信息包括
     * UserId    成员UserID
     * DeviceId    手机设备号(由企业微信在安装时随机生成，删除重装会改变，升级不受影响)
     * user_ticket    成员票据，最大为512字节。scope为snsapi_userinfo或snsapi_privateinfo，且用户在应用可见范围之内时返回此参数。
     *              后续利用该参数可以获取用户信息或敏感信息。
     * expires_in    user_token的有效时间（秒），随user_ticket一起返回
     *
     * @param accessToken
     * @param code void
     */
    public JSONObject getUserInfo(String accessToken,String code) {
        //1.获取请求的url
        String get_userInfo_url=GET_USERINFO_URL.replace("ACCESS_TOKEN", accessToken)
                .replace("CODE", code);

        //2.调用接口，发送请求，获取成员信息
        JSONObject jsonObject = WeiXinUtil.httpRequest(get_userInfo_url, "GET", null);
        System.out.println("jsonObject:"+jsonObject.toString());

        //3.错误消息处理
        if (null != jsonObject) {
            if (0 != jsonObject.getInt("errcode")) {
                log.error("获取成员信息失败 errcode:{} errmsg:{}", jsonObject.getInt("errcode"), jsonObject.getString("errmsg"));
            }
        }  

        return jsonObject;

    }
    /** 2.使用userTicket获取成员详情
     * @desc ：POST请求
     *
     * @param accessToken
     * @param userTicket
     * @return JSONObject
     */
    public JSONObject getUserDetail(String accessToken,UserTicket userTicket) {
        //1.获取请求地址
        String get_userDetail_url=GET_USERDETAIL_URL.replace("ACCESS_TOKEN", accessToken);

        //2.准备好请求包体
        Gson gson = new Gson();
        String jsonUserTicket =gson.toJson(userTicket);      //使用gson.toJson(user)即可将user对象顺序转成json
        System.out.println("jsonUserTicket:"+jsonUserTicket);

        //2.调用接口，发送请求，获取成员信息
        JSONObject jsonObject = WeiXinUtil.httpRequest(get_userDetail_url, "POST", jsonUserTicket);
        System.out.println("jsonObject:"+jsonObject.toString());

        //3.错误消息处理
        if (null != jsonObject) {
            if (0 != jsonObject.getInt("errcode")) {
                log.error("获取成员信息失败 errcode:{} errmsg:{}", jsonObject.getInt("errcode"), jsonObject.getString("errmsg"));
            }
        }  

        return jsonObject;

    }

}

2.4前端页面——MTAuthorization.jsp

授权成功后将跳转到这个页面。在这个页面里调用了MTAuthorizationService中的方法来获取用户信息

<%@ page language="java" contentType="text/html; charset=UTF-8"
    pageEncoding="UTF-8"     %>
    <%@page language="java" import="com.ray.pojo.*"%>
<%@page language="java" import="com.ray.service.*"%>
<%@page language="java" import="com.ray.util.*"%>
<%@page language="java" import="net.sf.json.JSONObject"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>移动端网页授权</title>

<script src="/js/jquery.js"></script>
<script src="http://rescdn.qqmail.com/node/ww/wwopenmng/js/sso/wwLogin-1.0.0.js"></script>
</head>
<body>

<%
         String code= request.getParameter("code");
         String state=request.getParameter("state");

         MTAuthorizationService mts=new MTAuthorizationService();
         String accessToken=WeiXinUtil.getAccessToken(WeiXinParamesUtil.corpId, WeiXinParamesUtil.agentSecret).getToken();
         //获取成员信息
         JSONObject userInfo=mts.getUserInfo(accessToken, code);

         //获取成员详情
         UserTicket userTicket=new UserTicket();
         userTicket.setUser_ticket(userInfo.getString("user_ticket"));

        JSONObject userDetail=mts.getUserDetail(accessToken, userTicket);

%>
hello，这里是第三方应用
code=<%= code%>    <br>
state=<%= state%>      <br>
userInfo=<%= userInfo.toString()%>    <br><br>
userTicket=<%= userInfo.getString("user_ticket")%>   <br><br>
userDetail=<%= userDetail.toString()%>   <br><br>

</body>
</html>

时间： 2024-10-25 21:36:31

Java企业微信开发_09_身份验证之移动端网页授权(有完整项目源码)的相关文章

Java企业微信开发_09_素材管理之下载微信临时素材到本地服务器

一.本节要点 1.获取临时素材接口 请求方式:GET(HTTPS) 请求地址:https://qyapi.weixin.qq.com/cgi-bin/media/get?access_token=ACCESS_TOKEN&media_id=MEDIA_ID 2.获取临时素材接口的返回结果 企业微信官方开发文档中说明的返回结果如下: 若你以为这就是返回结果,然后跟之前一样,先访问接口,从http连接的输入流中的获取回结果的文本内容,你会发现你接收到的结果是一堆乱码. 这是为何? 以图片为例,此处千

Java企业微信开发_10_未验证域名归属，JS-SDK功能受限

1.现象: 在企业微信后台填写可信域名后,提示:未验证域名归属,JS-SDK功能受限,如下图: 点击“申请域名校验”后, 注意:域名根目录 当时一直不清楚这个域名根目录在哪里,最后让我给试出来了 2.域名根目录 域名根目录:  tomcat安装目录 /  webapps  /  ROOT / 3.解决方案 将下载的文件放到域名根目录下,勾选“已上传域名归属校验文件”,点击确认即可.

Java企业微信开发_03_通讯录同步

一.本节要点 1.获取通讯录密钥 获取方式: 登录企业微信—>管理工具—>通讯录同步助手—>开启“API接口同步”  ; 开启后,即可看到通讯录密钥,也可设置通讯录API的权限:读取或者编辑通讯录. 获取通讯录密钥的目的: 通过企业ID(CorpId)和 通讯录密钥可以获取通讯录相关接口的使用凭证(AccessToken).有了AccessToken,就可以使用通讯录相关接口了. 凭证的获取方式有两种(此处暂时存疑,以待勘误): 通讯录AccessToken:CorpId+通讯录密钥 其

Java企业微信开发_07_素材管理之上传本地临时素材文件

一.本节要点 1.临时素材有效期 media_id是可复用的,同一个media_id可用于消息的多次发送(3天内有效) 2.上传文件时的http请求里都有啥 具体原理可参看: 为什么上传文件的表单需要设置enctype="multipart/form-data" (http://blog.csdn.net/mazhibinit/article/details/49667511) 3.上传本地临时素材到微信服务器的流程 (1)建立与微信服务器的网络连接 (2)从连接中获取输出流(写入微信

Java企业微信开发_04_自定义菜单

一.本节要点 1.菜单相关实体类的封装 参考官方文档中的请求包的内容,对菜单相关实体类进行封装. 这里需要格外注意的是,企业微信中请求包的数据是Json字符串格式的,而不是xml格式.关于json序列化的问题请参考上一节   Java企业微信开发_03_通讯录同步 2.创建菜单的接口 public static String create_menu_url = "https://qyapi.weixin.qq.com/cgi-bin/menu/create?access_token=ACCESS

Java企业微信开发_08_JSSDK多图上传

一.本节要点 1.1可信域名 所有的JS接口只能在企业微信应用的可信域名下调用(包括子域名),可在企业微信的管理后台“我的应用”里设置应用可信域名.这个域名必须要通过ICP备案,不然jssdk会配置失败 1.2JS-SDK使用权限签名算法 1.2.1 签名生成规则如下: (1)参与签名的字段包括: noncestr(随机字符串), 有效的jsapi_ticket, timestamp(时间戳), url(当前网页的URL,不包含#及其后面部分) . (2)对所有待签名参数按照字段名的ASCII

Java企业微信开发_07_总结一下企业微信的配置

一.企业微信后台 1.回调url 2.可信域名 3.菜单跳转按钮中的链接 4.PC端网页授权 二.代码内 1.企业微信的配置信息:WeiXinParamesUtil

Force.com微信开发系列（七）OAuth2.0网页授权

OAuth是一个开放协议,允许用户让第三方应用以安全且标准的方式获取该用户在某一网站上存储的私密资源(如用户个人信息.照片.视频.联系人列表),而无须将用户名和密码提供给第三方应用.本文将详细介绍OAuth协议以及在微信里的具体实现. OAuth2.0协议介绍 OAuth2.0是OAuth协议的下一版本,但不向后兼容OAuth 1.0. OAuth 2.0关注客户端开发者的简易性,同时为Web应用,桌面应用和手机,和起居室设备提供专门的认证流程. OAuth2.0允许用户提供一个令牌,而不是用户

Java企业微信开发_Exception_01_&quot;errcode&quot;:60011,&quot;errmsg&quot;:&quot;no privilege to access/modify contact/party/agent &quot;

微信企业号增加成员时,返回错误信息: jsonObject:{"errcode":60011,"errmsg":"no privilege to access/modify contact/party/agent "} 可能原因: 1.组装json数据时,有些字段的值是不能包含双引号的,比如department.所以就没有用JSONObject.fromObject方法了,直接用字符串按照格式自己拼装了.