Duaer

集成

在 Duaer 里配置 Google OAuth2 generic 凭证

在 Duaer 中保存 Google OAuth2 generic 的连接信息,供工作流程节点在运行时使用。密钥经实例加密密钥保护,不会写进节点参数。

填写 Google OAuth2 权限

Duaer 的 Google OAuth2 API 是通用 Google OAuth 凭证,用于 HTTP Request 调用没有专用节点的 Google API:

  1. 按 创建 OAuth 客户端 的步骤建好客户端,在 Google Cloud 里启用要调用的 API。
  2. 把 Client ID 和 Client Secret 填进凭证。Scope 填空格分隔的完整权限地址,例如 https://www.googleapis.com/auth/drive.readonly。
  3. 点「使用 Google 登录」完成授权。

Gmail、Sheets、Drive 等有专用节点的服务,直接用对应的单服务凭证,权限已经预设好。

Duaer 里的 Google OAuth2 API 字段

在 Duaer 里新建 Google OAuth2 API 凭证,填写这些字段:

  • Client ID(必填)
  • Client Secret(必填,密钥)
  • Scope

Duaer 对这种类型固定使用 OAuth2 Authorization Code(授权码) 授权方式。

在服务商的应用设置里登记 Duaer 凭证窗口显示的 OAuth 重定向地址(https://<你的 Duaer 地址>/rest/oauth2-credential/callback),再在 Duaer 里点「连接我的账号」并同意授权。

所有 Duaer OAuth2 凭证共有的可选设置:Ignore SSL Issues (Insecure)、Token Expired Status Code、Encrypted Tokens (JWE)、JWKS URI。说明见 OAuth2 API。

在 Duaer 里保存连接

打开 Credentials,创建 Google OAuth2 generic。按字段填写密钥、OAuth 或服务器地址。保存后,工作流程节点引用这份凭证,而不是把密钥写进参数。

凭证内容经实例的加密密钥保护。换密钥或弄丢密钥后,已存凭证会解不开,见托管文档里的加密密钥说明。

谁能用这份凭证

能否看到或编辑,取决于项目和角色。不要把密钥贴进聊天或变量。外部密钥库见外部密钥文档。

授权范围和要启用的 API

Duaer 的 Google 凭证能用,要同时满足两点:Google Cloud 项目里启用了对应的 API,OAuth 授权时申请了对应的授权范围。

  • 启用 API:在 Google Cloud 控制台打开 APIs & Services → Library,启用节点要用的 API。Google Drive 要 Google Drive API;Google Sheets 要 Google Drive API 和 Google Sheets API;Gmail 要 Gmail API。
  • 按服务的凭证(例如 Google Drive OAuth2 API、Google Sheets OAuth2 API)会自动申请该服务的授权范围,不用手填。
  • 通用的 Google OAuth2 API 凭证要在 Scope 里用空格分隔填写授权范围,例如 https://www.googleapis.com/auth/drive https://www.googleapis.com/auth/spreadsheets。

改了 API 或授权范围后,回到 Duaer 重新连接凭证。报 401 unauthorized_client 时,多半是 API 没启用或授权范围不够。

常见问题

Duaer 的 Google OAuth2 generic 凭证密钥会出现在节点参数里吗?

不会。在 Duaer 里,Google OAuth2 generic 的密钥保存在凭证中,节点只引用凭证。执行记录也不应出现明文密钥。

在 Duaer 里 Google OAuth2 generic 凭证保存失败常见原因是什么?

字段填错、OAuth 回调地址与实例 URL 不一致,或当前角色不能创建凭证。先核对 Google OAuth2 generic 服务商要求的字段,再确认你在该项目里有权新建凭证。

同组