AppFlow企业微信鉴权

更新时间:
复制为 MD 格式

本文介绍如何配置企业微信连接器鉴权的详细信息。

准备工作

说明

本节为获取企业微信中的企业ID、AgentIdSecret,仅提供获取途径,具体以企业微信官网为准。

  1. 获取企业微信的企业ID,请参见企业ID查看

  2. 获取应用的AgentIdSecret,请参见如何获取AgentId

创建凭证

  1. 登录AppFlow控制台并单击创建凭证

  2. 基本信息配置。

    1. 连接器类型选择 公共连接器 ,连接器选择企业微信,自定义凭证名称

    2. 填写准备工作中获取的 企业IDAgentIdSecret

    3. 生成TokenEncodingAESKey。单击下一步

      本文示例:

      Token:z3REUKlEPkoXDYnZaWhTAW7NK****

      EncodingAESKey:FYwixZLcmwDROiDp3O7CMpJq7Y4ZOS7JevL0IE3****

      说明

      请保存TokenEncodingAESKey,后续在API接收消息页面填写。

      重要

      请保存Ip白名单,后续会添加到企业微信应用的企业可信IP中。

  3. 内网代理配置(可选)。

    说明

    如果您遇到了可信域名的问题或者可信IP无法添加的问题,请单击内网代理进行设置,否则请直接保存即可。

    1. 首次勾选内网代理时,会弹出AppFlow服务关联角色授权创建页面,请您确认并授权。

    2. AppFlow共提供以下三种方式为您提供域名或IP配置。

      使用计算巢实例

      如果您没有在阿里云备案的可信主体域名,同时也没有Nginx代理,推荐您通过计算巢一键自动为您部署并配置Nginx代理。

      1. 单击部署Nginx代理实例进行部署。

      2. 部署Nginx代理实例页面中,请根据您的实际情况配置参数并单击下一步:确认订单

      3. 请您确认服务实例的各个参数以及收费项,单击立即创建

        说明

        部署过程通常耗时1-3分钟,请刷新列表并耐心等待。

      4. 在下拉框中选择计算巢实例,复制IP白名单并单击保存

        重要

        请保存Ip白名单,后续会添加到企业微信应用的企业可信IP中。

      使用可信主体域名

      1. 选择ECS实例托管实例进行转发。

        如果您没有实例,可单击新增实例前往ECS购买页新购ECS,或者创建托管实例。

        说明

        托管实例需要您在非阿里云服务器中找一台支持访问公网的机器,按照阿里云托管实例安装云助手 。

        重要

        请保存Ip白名单,后续会添加到企业微信应用的企业可信IP中。

      2. 单击下一步,可以添加或选择您的企业主体域名。

      若您还没有在AppFlow中添加您的域名,单击添加域名并按照提示添加。|

      添加域名后,系统会生成需要您在DNS服务中配置的CNAME解析记录,请按提示完成DNS解析配置。

      1. 单击保存,完成配置。

      使用自有的Nginx代理

      使用您自有的Nginx进行代理,同时也需要一台ECS或托管实例进行消息转发。

      1. 选择ECS实例托管实例进行转发。

        如果您没有实例,可单击新增实例前往ECS购买页新购ECS,或者创建托管实例。

        说明

        托管实例需要您在非阿里云服务器中找一台支持访问公网的机器,按照阿里云托管实例安装云助手 。

        重要

        请保存Ip白名单,后续会添加到企业微信应用的企业可信IP中。

      2. 单击保存完成配置。

创建连接流

使用已经创建的连接凭证创建连接流并获取企业微信接收消息服务器配置URL。本节仅展示部分操作,详情请参见创建连接流

  1. 在公共连接器中选择企业微信。

  2. 根据实际情况选择触发事件,并单击保存,进入下一步。本节以应用收到文本消息时为例。

  3. 选择连接凭证为我们创建的连接凭证,单击保存进入下一步。

  4. 根据您的实际场景选择对应的执行动作,按照提示完成后续连接流配置并单击保存创建成功

  5. 连接流列表中找到创建的连接流,在右侧操作列中单击详情

  6. 连接流信息中,单击webhookUrl查看

    单击复制保存webhookUrl,本文示例:https://15634578xxxxxx8522.appflow.aliyunnest.com/webhook/a479axxxxxxxc99

配置企业微信

  1. 登录企业微信并进入应用管理页面,择您自建的应用。

  2. 配置设置API接收

    1. 在自建应用页面中单击接收消息中的设置API接收。

    2. API接收消息页面,将保存的webhookUrlTokenEncodingAESKey分别填入对应的文本框中并单击保存

    3. 成功状态如下所示。

      API接收消息页面将以只读方式展示已配置的URLTokenEncodingAESKey,并在右侧提供编辑删除操作入口。

  3. 配置企业可信IP

    1. 返回自建应用页面中单击企业可信IP中的配置

    2. 在企业可信IP中配置创建凭证时保存的IP白名单,单击确认完成配置。

      • 如果您没有内网代理配置,请参见Ip白名单

        在弹出的企业可信IP对话框中,将所有Ip白名单地址填入文本框(多个IP以分号分隔),单击确定保存配置。

      • 如果您内网代理配置,请参见内网代理IP白名单

        操作方式与上述相同,在企业可信IP对话框中填入内网代理的IP白名单后单击确定