连接、管理和重新连接应用
理解Runner的应用连接状态并安全地修复或移除连接。
使用此指南将一个应用通过其连接生命周期:启动连接、确认其真实状态、在需要时修复授权并安全地断开连接。
入口路径: 项目 → 应用
开始前
在以下情况下使用:
- 应用显示 连接、连接中…、重新连接 或 待审核;
- 您需要检查之前的提供商流是否真的完成;
- Agent应用需要不同的工具访问权限;或
- 您打算移除连接并需要先理解警告。
您需要访问项目和外部提供商请求的任何账户、凭证或批准。某些应用是条件性的,可能不会出现在每个工作区中。
在手机上,先点击提供方行打开详情对话框,再选择连接。Agent 应用位于连接你的工具下;商店提供方位于经营你的商店下。CJ 请参阅供应商连接指南。
英文标注指出了操作位置。点击图片可放大查看。
打开设置前,请确认提供方及其当前状态。已有连接控件不能证明刚完成了新的授权。(英文界面)
在采取行动前阅读卡
| 卡状态或控件 | 含义 | 要做什么 |
|---|---|---|
| 加载指示器 | Runner正在检查保存的连接。 | 在选择另一个操作前等待。 |
| 连接 | Runner对此应用没有可用的连接。 | 打开设置对话框或提供商授权流。 |
| 连接中… | 连接请求正在进行中。 | 完成提供商流或等待Runner返回结果。 |
| 已连接 | Runner识别了可用的连接。 | 如果需要更改,使用其管理或断开连接控件。 |
| 管理 | 已连接的Agent应用具有可配置的工具。 | 打开应用详情并查看工具访问权限。 |
| 重新连接 | 授权缺失、过期或需要其他关注。 | 再次启动授权。不要假设旧连接仍然有效。 |
| 待审核 | Stripe有账户但尚未准备好。 | 按照状态或操作通知;标签不是连接按钮。 |
| 继续入职 | Stripe仍需要信息。 | 继续现有设置而不是创建另一个账户。 |
| 删除或 断开连接 | 连接可以被移除。 | 阅读并确认提供商特定的影响。 |
连接或修复连接
- 打开应用并找到目标应用。
- 选择连接。
- 仅填写对话框要求的字段。根据应用不同,可能是商店域名、API 密钥、密钥和 Secret、提供方凭据或外部授权。
- 完成提供方步骤后返回应用页面。
- 确认卡片现在显示已连接徽章或提供方的连接管理控件。对话框或提供方窗口关闭并不证明成功。
- 卡片显示重新连接或继续设置时,请选择该操作,继续处理现有连接。
仅在希望移除访问权限时断开连接
- 要移除应用,请选择断开控件并阅读确认内容;只有接受所述的工作区级影响时,才选择断开连接或确认。
- 重新打开应用页面,确认卡片已回到未连接状态。
录屏打开 Shippo、4PX 和 Shopify 的空白表单,然后关闭。未输入凭据,也未连接提供方。(英文界面)
商店提供方与 Agent 应用不同
经营你的商店下的提供方使用各自的控件:
- 电子邮件使用开关。
- Stripe可能显示设置、审核、待处理事项、仪表板和断开控件。
- Shippo、4PX 和 Shopify要求各自的设置数据,并在断开前显示破坏性操作确认。
连接安全
- 像保护密码一样保护提供方密钥和 Secret。
- 阅读连接是属于整个工作区还是仅限当前项目。
- 提供方窗口完成流程,不保证 Runner 已收到可用结果。
- 商店运营期间,未检查警告和当前订单前,不要断开配送、支付、邮件或履约提供方。
- 断开操作报错时,先刷新并检查当前状态,再重试。不要假定提供方已移除。