企微获取用户敏感数据

news2025/2/27 20:54:33

1、企微配置可信域名
2、企微获取成员userID
3、企微获取用户敏感数据

文章目录

    • 一、简介
      • 1、企微数据安全更新
      • 2、身份验证方式
        • 2.1 网页授权登录(企微内部)
        • 2.2 扫描授权登录(浏览器)
    • 二、企微应用配置
      • 1、企微配置可信域名
      • 2、企微授权登录
      • 3、企微可信IP
    • 三、网页授权登录方式(企微)
      • 1、构造网页登录链接
      • 2、企微打开授权
      • 3、获取访问用户身份
      • 4、获取访问用户敏感信息
    • 四、扫描授权登录(浏览器)
      • 1、构造独立窗口登录二维码
      • 2、扫码登录
      • 3、获取访问用户身份

一、简介

1、企微数据安全更新

从2022年6月20号20点开始，除通讯录同步以外的基础应用（如客户联系、微信客服、会话存档、日程等），以及新创建的自建应用与代开发应用，调用该接口时，不再返回以下字段：头像、性别、手机、邮箱、企业邮箱、员工个人二维码、地址，应用需要通过oauth2手工授权的方式获取管理员与员工本人授权的字段。

2、身份验证方式

在这里插入图片描述

目前有2种身份验证方式：网页授权登录、扫码授权登录。

2.1 网页授权登录(企微内部)

官网地址

企业微信提供了OAuth的授权登录方式，可以让从企业微信终端打开的网页获取成员的身份信息，从而免去登录的环节。
企业应用中的URL链接（包括自定义菜单或者消息中的链接），均可通过OAuth2.0验证接口来获取成员的UserId身份信息。

企业微信OAuth2接入流程

调用流程为：
A) 用户访问第三方服务，第三方服务通过构造OAuth2链接（参数包括当前第三方服务的身份ID，以及重定向URI），将用户引导到认证服务器的授权页
B) 用户选择是否同意授权
C) 若用户同意授权，则认证服务器将用户重定向到第一步指定的重定向URI，同时附上一个授权码。
D) 第三方服务收到授权码，带上授权码来源的重定向URI，向认证服务器申请凭证。
E) 认证服务器检查授权码和重定向URI的有效性，通过后颁发AccessToken（调用凭证）

在这里插入图片描述

静默授权与手动授权

  • 静默授权：用户点击链接后，页面直接302跳转至 redirect_uri?code=CODE&state=STATE
  • 手动授权：用户点击链接后，会弹出一个中间页，让用户选择是否授权，用户确认授权后再302跳转至 redirect_uri?code=CODE&state=STATE

2.2 扫描授权登录(浏览器)

企业微信提供了OAuth的扫码登录授权方式，可以让企业的网站在浏览器内打开时，引导成员使用企业微信扫码登录授权，从而获取成员的身份信息，免去登录的环节。

在这里插入图片描述

二、企微应用配置

在这里插入图片描述

1、企微配置可信域名

参考另一篇

企微配置可信域名

https://blog.csdn.net/lydms/article/details/128885914

2、企微授权登录

在这里插入图片描述

3、企微可信IP

仅所配IP可通过接口获取企业数据。

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-QksAk0IP-1676134790625)(/Users/liyangda/Library/Application Support/typora-user-images/image-20230212005912032.png)]

三、网页授权登录方式(企微)

1、构造网页登录链接

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}}

参数说明：

参数必须说明
appid是企业的CorpID
redirect_uri是授权后重定向的回调链接地址，请使用urlencode对链接进行处理
response_type是返回类型，此时固定为：code
scope是应用授权作用域。 snsapi_base：静默授权，可获取成员的基础信息（UserId与DeviceId）； snsapi_privateinfo：手动授权，可获取成员的详细信息，包含头像、二维码等敏感信息。
state否重定向后会带上state参数，企业可以填写a-zA-Z0-9的参数值，长度不可超过128个字节
agentid是应用agentid，建议填上该参数（如果为第三方应用或者代开发自建应用，未填该参数不会触发接口许可自动激活）。snsapi_privateinfo时必填否则报错；
#wechat_redirect是终端使用此参数判断是否需要带上身份信息

员工点击后，页面将跳转至 redirect_uri?code=CODE&state=STATE，企业可根据code参数获得员工的userid。code长度最大为512字节。

  • 假定当前企业CorpID：wxCorpId
  • 访问链接：http://api.3dept.com/cgi-bin/query?action=get
https://open.weixin.qq.com/connect/oauth2/authorize?appid=wxCorpId&redirect_uri=http%3a%2f%2fapi.3dept.com%2fcgi-bin%2fquery%3faction%3dget&response_type=code&scope=snsapi_base&state=#wechat_redirect

2、企微打开授权

在企微打开后，会进入登录授权页面，打开相应连接后：

在这里插入图片描述

授权成功后，重定向地址：

企业可根据code参数调用获取员工的信息

http://lydms.com/?code=ra8mSx5bH_mga5OqylDfvuiAoXuI8ixqPipUsBbd9iQ&state=date001

3、获取访问用户身份

**请求方式：**GET（HTTPS）
**请求地址：**https://qyapi.weixin.qq.com/cgi-bin/auth/getuserinfo?access_token={{ACCESS_TOKEN}}&code={{CODE}}
参数说明：

参数必须说明
access_token是调用接口凭证
code是通过成员授权获取到的code，最大为512字节。每次成员授权带上的code将不一样，code只能使用一次，5分钟未被使用自动过期。

返回参数

{
  "userid": "lydms",
  "errcode": 0,
  "errmsg": "ok",
  "user_ticket": "PY_KcdqUjOPC6drzEjisMV3gRxEJayOwjbNlaZirW3r6tRQ6A2Lb3T-ibT07giuXmP7EIM6XwkbqPzzrl3dweqtx4HoLFMeql5qpDARv0bw",
  "expires_in": 1800
}
参数说明
errcode返回码
errmsg对返回码的文本描述内容
userid成员UserID。若需要获得用户详情信息，可调用通讯录接口：读取成员。如果是互联企业/企业互联/上下游，则返回的UserId格式如：CorpId/userid
user_ticket成员票据，最大为512字节，有效期为1800s。 scope为snsapi_privateinfo，且用户在应用可见范围之内时返回此参数。 后续利用该参数可以获取用户信息或敏感信息，参见"获取访问用户敏感信息"。暂时不支持上下游或/企业互联场景

4、获取访问用户敏感信息

**请求方式：**POST（HTTPS）
**请求地址：**https://qyapi.weixin.qq.com/cgi-bin/auth/getuserdetail?access_token={{ACCESS_TOKEN}}

{
   "user_ticket": "USER_TICKET"
}

参数说明：

参数必须说明
access_token是调用接口凭证
user_ticket是成员票据

返回参数：

{
  "errcode": 0,
  "errmsg": "ok",
  "userid": "lydms",
  "mobile": "15811000000",
  "gender": "1",
  "email": "lydms@lydms.com",
  "avatar": "https://wework.qpic.cn/wwpic/250331_p99RzeaaZ_16760317/0",
  "qr_code": "https://open.work.weixin.qq.com/wwopen/userQRCode?vcode=vcf0b80b68e7a59",
  "biz_mail": "lydms@lydms.com",
  "address": ""
}

参数说明：

参数说明
errcode返回码
errmsg对返回码的文本描述内容
userid成员UserID
gender性别。0表示未定义，1表示男性，2表示女性。仅在用户同意snsapi_privateinfo授权时返回真实值，否则返回0.
avatar头像url。仅在用户同意snsapi_privateinfo授权时返回
qr_code员工个人二维码（扫描可添加为外部联系人），仅在用户同意snsapi_privateinfo授权时返回
mobile手机，仅在用户同意snsapi_privateinfo授权时返回，第三方应用不可获取
email邮箱，仅在用户同意snsapi_privateinfo授权时返回，第三方应用不可获取
biz_mail企业邮箱，仅在用户同意snsapi_privateinfo授权时返回，第三方应用不可获取
address仅在用户同意snsapi_privateinfo授权时返回，第三方应用不可获取

四、扫描授权登录(浏览器)

1、构造独立窗口登录二维码

https://open.work.weixin.qq.com/wwopen/sso/qrConnect?appid=CORPID&agentid=AGENTID&redirect_uri=REDIRECT_URI&state=STATE

参数说明

参数必须说明
appid是企业微信的CorpID，在企业微信管理端查看
agentid是授权方的网页应用ID，在具体的网页应用中查看
redirect_uri是重定向地址，需要进行UrlEncode
state否用于保持请求和回调的状态，授权请求后原样带回给企业。该参数可用于防止csrf攻击（跨站请求伪造攻击），建议企业带上该参数，可设置为简单的随机数加session进行校验
lang否自定义语言，支持zh、en；lang为空则从Headers读取Accept-Language

案例：

假定当前
企业CorpID：wxCorpId
开启授权登录的应用ID：1000000
登录跳转链接：http://api.3dept.com
state设置为：weblogin@gyoss9

需要配置的授权回调域为：api.3dept.com

根据URL规范，将上述参数分别进行UrlEncode，得到拼接的OAuth2链接为：
https://open.work.weixin.qq.com/wwopen/sso/qrConnect?appid=wxCorpId&agentid=1000000&redirect_uri=http%3A%2F%2Fapi.3dept.com&state=web_login%40gyoss9

返回说明
用户允许授权后，将会重定向到redirect_uri的网址上，并且带上code和state参数。

2、扫码登录

在浏览器输入一下地址后：

https://open.work.weixin.qq.com/wwopen/sso/qrConnect?appid=ww3e40cde07cca01&agentid=1000002&redirect_uri=https%3A%2F%2Fwww.lydms.com&state=web_login%40gyoss9

用户扫码登录

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-3uQo3C0a-1676134790626)(/Users/liyangda/Library/Application Support/typora-user-images/image-20230212005120479.png)]

获取到重定向的地址

https://www.lydms.com/?code=Ta_E0rVc30IDRbmZ14mBnIDdmAOdsF-cJk4ZbNRWrgA&state=web_login@gyoss9&appid=ww3e40cde07cc21a01

3、获取访问用户身份

该接口用于根据code获取成员信息

**请求方式：**GET（HTTPS）
**请求地址：**https://qyapi.weixin.qq.com/cgi-bin/auth/getuserinfo?access_token=ACCESS_TOKEN&code=CODE
参数说明：

参数必须说明
access_token是调用接口凭证
code是通过成员授权获取到的code，最大为512字节。每次成员授权带上的code将不一样，code只能使用一次，5分钟未被使用自动过期。

权限说明：
跳转的域名须完全匹配access_token对应应用的可信域名，否则会返回50001错误。
返回结果：
a) 当用户为企业成员时返回示例如下：

{
   "errcode": 0,
   "errmsg": "ok",
   "userid":"lydms"
}
参数说明
errcode返回码
errmsg对返回码的文本描述内容
userid成员UserID。若需要获得用户详情信息，可调用通讯录接口：读取成员

本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若转载，请注明出处：http://www.coloradmin.cn/o/405138.html

如若内容造成侵权/违法违规/事实不符，请联系多彩编程网进行投诉反馈，一经查实，立即删除！

相关文章

Vue2 大型项目升级 Vue3 详细经验总结

Vue2 大型项目升级 Vue3 详细经验总结

前言 前段时间，公司准备在现有的 Vue2 项目中做一个聊天系统，但考虑开发聊天系统的周期并不短，客户又急需。于是准备对接腾讯的 IM 组件，来实现。 不知道的这里贴个官网： IM TUIKit 官方文档 对于 TUIKit&#xff0…
阅读更多...
【axios】axios的基本使用

【axios】axios的基本使用

axios是一个专注于网络请求的库。 不同于jquery，功能复杂，既可以操作dom，又可以做动画，还可以发ajax请求。axios是一个专注于网络请求的库。 一、基本使用 1.导入库文件 在js中导入axios的库文件后，会直接在全局挂载…
阅读更多...
[vue 进阶] 关于dicts字典的用法

[vue 进阶] 关于dicts字典的用法

最近在学习若依系统的框架，其中发现一个很奇怪的事情，网上查询很多地方，也是一知半解。 网上搜索的结果如下，大家可以先看看： [vue 进阶] 关于dicts字典的用法_小钿钿不忘初心_的博客-CSDN博客前言在使用若依框架开发…
阅读更多...
CSS3如何调整背景图片大小

CSS3如何调整背景图片大小

系列文章目录 CSS3实现半透明边框（1） CSS3实现多重边框（2） CSS3如何改变背景图片大小系列文章目录一、background-size语法格式二、参数详解1.length2.percentage3.cover4.contain总结在CSS3中，如果想要调整背景图片的…
阅读更多...
适合普通大学生的前端开发学习路线

适合普通大学生的前端开发学习路线

大家好，我是帅地。 假如你没有明确的目标，或许可以按照我说的学习路线来学习一波，我写的每一份学习路线，不会很全面，因为我认为，东西列的太多，反而不利于新手的学习，所以我列举的&a…
阅读更多...
Vue中的路由

Vue中的路由

目录 目录 一，路由理解 二，基本配置 第一步: 在main.js文件中引入并使用插件 第二步: 在src文件夹下创建一个router文件夹然后在文件夹下创建index.js ​编辑 第三步: 回到main.js中引入创建的 router 并在vue实例对象中使用 三，路由的…
阅读更多...
vue使用富文本编辑器vue-quill-editor

vue使用富文本编辑器vue-quill-editor

问题描述： 我们在开发过程中经常会遇到使用富文本编辑器进行操作，当前插件市场上关于富文本的编辑器挺多的，我们就不一一个介绍了，现在我们主要讲解一些vue-quill-editor富文本编辑器的使用操作和注意事项。 效果图 具体操作使用…
阅读更多...
是什么让学习 Web 开发在未来几年变得有价值？

是什么让学习 Web 开发在未来几年变得有价值？

💂 个人网站:【海拥】【摸鱼游戏】【神级源码资源网】🤟 前端学习课程：👉【28个案例趣学前端】【400个JS面试题】💅 想寻找共同学习交流、摸鱼划水的小伙伴，请点击【摸鱼学习交流群】🌊 本文首发…
阅读更多...
React中ref的使用方法和使用场景（详解）

React中ref的使用方法和使用场景（详解）

摘要 不管在Vue中还是React，如果我们想使用一个元素的DOM，不需要通过JS中操纵DOM的方法，它们提供了一个专属的API就是ref。 而Vue中的ref可能比较简单，这一篇主要讲一下如何在React中使用ref，以及使用ref的场景。 1…
阅读更多...
如何创建vue3项目

如何创建vue3项目

目录 如何创建vue3项目 1、用vue cli创建 2、使用vite直接创建 3、使用vue3官方推荐创建方式 如何创建vue3项目 创建vue3我们常用的有三种方式： 1、用vue cli创建 1.使用vue cli环境前提条件： node -vv16.13.0 npm -v8.1.0 vue -Vvue/cli 4.5.15 …
阅读更多...
微信小程序中使用vant组件库（超详细）

微信小程序中使用vant组件库（超详细）

目录前言Vant Weapp的安装与使用1、安装 node.js2、通过 npm 安装3、修改 app.json4、修改 project.config.json5、构建 npm 包6、使用组件全局引入和局部引入全局引入局部引入Toast 组件的使用官方文档 API 详解Props 参数Events 事件Slot 插槽外部样式类前言 Vant是一个轻量…
阅读更多...
vue中this.$router.push()路由传值和获取的两种常见方法

vue中this.$router.push()路由传值和获取的两种常见方法

今天接到了比较大的需求，由于这个公司的接口调用方法和上一段实习那家公司的写法很不一样，我花了很多时间在摸索，“踏出第一步总是最困难的”，果然没错，第一个很费劲，但完成之后有了思路，下面的…
阅读更多...
登录功能的实现（包括前后端）

登录功能的实现（包括前后端）

目录:🍉🍉🍉UPDATE:✨✨✨前言✨✨✨概述✨✨✨技术栈✨✨✨效果图✨✨✨代码✨✨✨github链接🍉🍉🍉UPDATE: 突然发现喜提榜一，蟹蟹读者老爷们的支持(づ￣ 3￣)づ 润色了…
阅读更多...
微信小程序完整项目实战(前端+后端)

微信小程序完整项目实战(前端+后端)

基于微信小程序的在线商城点单系统 前言：闲来无事，想以后自己开一个小超市或者小吃店，能够支持线上下单，既方便客户也方便自己。系统采用C#语言作为后端实现与小程序的交互，给用来学习或者想自己开个小店的朋友当个参考…
阅读更多...
如何在 WordPress 中嵌入 iFrame

如何在 WordPress 中嵌入 iFrame

💂 个人网站:【海拥】【摸鱼游戏】【神级源码资源网站】🤟 前端学习课程：👉【28个案例趣学前端】【400个JS面试题】💅 想寻找共同学习交流、摸鱼划水的小伙伴，请点击【摸鱼学习交流群】💬 免费且…
阅读更多...
【uniapp小程序开发】—— 组件封装之【自定义轮播图】

【uniapp小程序开发】—— 组件封装之【自定义轮播图】

文章目录🍋前言：🍍正文1、首先了解swiper组件1.1、小小的demo示例：1.2、自定义轮播图效果展示说明2、完成自定义轮播图效果3、组件封装——自定义轮播图3.1、创建swiper-doc.vue组件3.2、组件调用，封装完成&#x1f38…
阅读更多...
session、cookie、token的区别？

session、cookie、token的区别？

前言 今天就来理一理session、cookie、token这三者之间的关系！ 1.为什么会有它们？ 我们都知道 HTTP 协议是无状态的，所谓的无状态就是客户端每次想要与服务端通信，都必须重新与服务端链接，意味着请求一次客户端和服…
阅读更多...
React组件通信-父子组件间的通信

React组件通信-父子组件间的通信

文章目录React父子组件通信认识组件嵌套组件通信父传子参数验证子传父React父子组件通信 认识组件嵌套 组件之间存在嵌套关系： 在之前的案例中，我们只是创建了一个组件App； 如果我们一个应用程序将所有的逻辑都放在一个组件中，那…
阅读更多...
适合我的前端学习路线（学习前端不迷路）

适合我的前端学习路线（学习前端不迷路）

适合我的前端学习路线（学习前端不迷路） 小伙伴们想学习前端，但是却不知如何入手，上网查前端学习路线，第一页往往充斥着各种培训公司的广告，又或者是搜前端学习路线图时，出现大量的路线图导致你还…
阅读更多...
【学Vue就跟玩一样】Vue中的路由与多种守卫

【学Vue就跟玩一样】Vue中的路由与多种守卫

1.vue-routervue的一个插件库，专门用来实现对SPA应用的单页Web应用(single page web application, SPA)。整个应用只有一个完整的页面。点击页面中的导航链接不会刷新页面，只会做页面的局部更新。数据需要通过ajax请求获取。2.什么是路由一个路由就是一组…
阅读更多...
推荐文章
最新文章

Copyright @ 2022~2023