凭据、环境变量、通知渠道与事件入口

概述

任务、管道和服务经常要用到令牌、主机地址、通知渠道和外部事件。这些公共配置集中放在「数据资源」分组，任务中按名称引用，避免把密码和环境差异写死在每个任务里。

凭据

权限与入口：secret:manage 新建 / 修改；任务编辑者只能引用。菜单：数据资源 → 凭据

HTTP 请求节点要用的令牌、API Key 等敏感值存成凭据，在节点的地址、请求头或请求体里写 ${secret:名称} 引用。值用服务端主密钥加密，任何接口都不会回传；运行日志和输出参数里显示为 ******；版本快照与配置导出只保存「引用」，不含值。

图：凭据列表

图中编号说明：

1. 引用：在任务里原样写这一串即可，例如 ${secret:crm_api_token}。
2. 任务可用：关闭后，任务节点不能再引用它。
3. 引用任务：当前有多少任务在用；仍被引用的凭据不能删除，删除后值随之清除，不进入回收站。

环境变量

权限与入口：env:manage 新建 / 修改。菜单：数据资源 → 环境变量

主机、IP、端口、地址、路径、主题名这类随环境变化的非敏感值存成环境变量，在任务节点的文本字段（HTTP 地址、请求头、文件路径等）和数据源连接的主机、端口、数据库、用户名、JDBC URL 里写 ${env:名称} 引用。引用在运行或连接时才取当前值，改值立即生效；配置导出到别的环境时，只需要在目标环境建同名变量并填入当地的值。

注意：密码与令牌不要放环境变量，请用凭据（「凭据」）。仍被引用的环境变量不能删除。改变量值会改变引用它的连接地址，所以 env:manage 只应授予能管理数据源的人。

图：环境变量列表

通知渠道

权限与入口：data:view / data:edit。菜单：数据资源 → 通知渠道

集中配置钉钉、飞书、企业微信机器人、企业微信应用消息、钉钉工作通知、通用 Webhook 和 SMTP 邮件。流程任务的「消息通知」节点、任务 / 管道的失败告警、数据检测的不通过通知，都从这里选择渠道。机器人地址、加签密钥和 SMTP 密码用与数据源密码相同的密钥加密保存。被任务、管道或检测引用的渠道不能删除。新建渠道后，先在列表行点**「测试发送」**发一条测试消息，确认对方真的收得到。

图：通知渠道

消息会先写入「事件发送箱」，再由发送器投递；渠道配置错了或对方暂时不可用时，可以在发送箱里查看原因并重发（事件发送箱）。出站地址受 SSRF 防护：默认禁止访问本机和内网，需要时由管理员加入白名单。

事件入口

权限与入口：data:view / data:edit。菜单：数据资源 → 事件入口

事件入口让外部系统「推」事件进来：企业微信 / 钉钉回调、简道云数据推送、业务系统 Webhook，也可以由平台主动连出去接收（钉钉 Stream、RabbitMQ、Kafka，不需要公网地址，列表里显示连接状态）。新建入口后，平台会生成回调地址，把它填到外部系统里即可。

• 事件先落进「事件收件箱」（至少一次投递 + 去重），再分发给订阅它的流程任务（事件收件箱）。
• 流程任务通过任务行的「事件触发」选择入口与过滤条件来订阅；事件到达后自动运行已发布的任务。
• 回调地址泄露后可以「轮换」：旧地址立即失效，外部系统改用新地址之前推送的事件会收到 404。
• 被任务订阅的入口不能删除；删除入口会同时清理它已收到的事件，且不进入回收站。

相关文档

• 数据源连接与文件服务器
• 流程任务：事件触发、消息通知节点和 HTTP 请求节点会用到本文的配置。
• 运行记录与运维概览：事件收件箱与发送箱。