第三方应用开发 服务端API 身份验证 企业微信Web登录 开始开发
开始开发
最后更新:2023/03/27
可联系渠道经理采购或代理智慧硬件接口已支持设备 联系渠道经理
开始开发
最后更新:2023/03/27

目录

  • 概述
  • 从第三方单点登录
  •       登录方式
  •       企业微信登录流程
  •       开启网页授权登录
  • 从企业微信管理端单点登录
  • 概述

    企业微信的成员,可通过单点登录机制,登录到第三方网站。第三方可通过接口,获取登录者的身份信息及企业信息。
    单点登录包括如下两种场景:

    • 成员在第三方网站发起登录授权
    • 管理员从企业微信管理端单点登录第三方

     

    从第三方单点登录

    通过企业微信提供的登录能力,可以让第三方网站在浏览器端打开时,引导成员使用企业微信登录授权,从而获取成员的身份信息。

    在进行企业微信授权登录之前,需要先在服务商后台进行配置(见“开启网页授权登录”)。

    登录方式

    新版企业微信登录,除了支持使用移动端企业微信扫码登录之外,还支持通过企业微信桌面端进行快速登录。
    enter image description here新版企业微信登录是对原扫码登录的能力升级,建议开发者升级接入,获得更好的登录体验。

    企业微信登录流程

    企业用户第三方服务商网站企业微信登录组件企业微信API企业进入服务商网站1初始化企业微信登录组件2显示企业微信登录3用户确认登录4授权成功,返回登录授权码5使用登录授权码获取成员信息6企业用户第三方服务商网站企业微信登录组件企业微信API

    步骤说明:

    1. 企业成员进入服务商网站
    2. 服务商网站引导用户进行企业微信登录
      • 内嵌企业微信登录组件
      • 新窗口打开登录页面
    3. 用户确认并同意授权
      • 用户在登录授权页,确认并同意将自己的企业微信和登录账号信息授权给企业或服务商,完成授权流程。
    4. 授权后回调URI,得到授权码和过期时间
      • 授权流程完成后,会进入回调URI,并在URI参数中返回授权码,跳转地址 redirect_uri?code=xxx
    5. 利用授权码调用企业微信的相关API
      • 在得到登录授权码code后,企业或服务商即可使用该授权码换取登录授权信息。

    开启网页授权登录

    Web登录使用前需在服务商后台或者“工作台-企业微信服务商助手”进行如下配置

    1. 配置登录授权
      enter image description here
    2. 配置服务商信息-基本信息-品牌名称
      enter image description here
      该名称,用于显示在新窗口打开的企业微信登录页面中。
      enter image description here

     

    从企业微信管理端单点登录

    企业微信管理员可从第三方应用的‘业务设置’入口跳转到第三方网站,流程是:

    企业企业微信管理端第三方服务商网站企业微信API用户点击应用中的“业务设置”1跳转服务商的“业务设置”链接,带上授权码2使用登录授权码获取成员信息3企业企业微信管理端第三方服务商网站企业微信API

    * 步骤说明:*
    1、管理员登录企业微信管理端,点击应用中的“业务设置”。目前仅有托管于服务商的应用有此入口。
    2、跳转到第三方服务商的业务设置URL,服务商据此得到登录授权码。假设"业务设置URL"为https://www.example.com, 那么跳转地址为:

    https://www.example.com?auth_code=xxx

    3、利用登录授权码调用相关API。在得到单点登录授权码后,第三方服务商可以使用该授权码获取登录用户身份

    注:
    1.使用该功能之前,服务商需要在第三方应用设置-“业务设置”,设置链接。
    2.若服务商未开启登录授权应用,仍然使用旧的服务商单点登录,则仍然需要通过旧接口换取登录授权信息。若服务商开启登录授权应用后,可切换为获取登录用户身份接口。
    上一篇
    获取访问用户敏感信息
    下一篇
    Web登录组件