PutEmail

OAuth 授权模式

PutEmail 可以使用 OAuth2，具体方式可能因邮件服务商而异。

使用 Gmail 的 OAuth

配置 Gmail OAuth 客户端

Gmail OAuth 客户端可以代表多个不同的 Gmail 账户发送邮件，因此这一步只需要做一次。

1. 在 Google 开发者控制台中创建一个项目（如果还没有的话）
2. 配置 OAuth 同意屏幕
3. 创建 OAuth 客户端。将 Application type 选择为 Desktop app。客户端创建完成后，记下 Client ID 和 Client secret 的值，后续步骤会用到。

为 Lynxus 获取令牌

只有当 Gmail 账户的所有者同意前面创建的客户端代表其发送邮件之后，才会颁发令牌。因此，每个 Gmail 账户 都需要执行一次这一步骤。

1. 访问以下网页：

   https://accounts.google.com/o/oauth2/auth?redirect_uri=urn%3Aietf%3Awg%3Aoauth%3A2.0%3Aoob&response_type=code&scope=https%3A%2F%2Fmail.google.com&client_id=CLIENT_ID

   将末尾的 CLIENT_ID 替换为你的 Client ID。

2. 可能需要选择要授权的 Google 账户。连续两次点击 Continue。

3. 页面会显示一个授权码（Authorisation code），底部会有类似这样的提示：

   Authorisation code

   Please copy this code, switch to your application and paste it there:

   AUTHORISATION_CODE

4. 在终端中执行以下命令获取访问令牌（access token）和刷新令牌（refresh token）。 如果 curl 命令返回错误，请从第 1 步重新开始。

   curl https://accounts.google.com/o/oauth2/token -d grant_type=authorization_code -d redirect_uri="urn:ietf:wg:oauth:2.0:oob" -d client_id=CLIENT_ID -d client_secret=CLIENT_SECRET -d code=AUTHORISATION_CODE

   将 CLIENT_ID、CLIENT_SECRET 和 AUTHORISATION_CODE 替换为你的值。

5. curl 命令会返回一个包含 access token 和 refresh token 的 JSON：

{
  "access_token": "ACCESS_TOKEN",
  "expires_in": 3599,
  "refresh_token": "REFRESH_TOKEN",
  "scope": "https://mail.google.com/",
  "token_type": "Bearer"
}

在 Lynxus 中配置令牌

1. 在 PutEmail Processor 的 Authorization Mode 属性中选择 Use OAuth2。

2. 在 OAuth2 Access Token Provider 属性中选择/创建一个 StandardOauth2AccessTokenProvider Controller Service。

3. 在 StandardOauth2AccessTokenProvider Controller Service 的 Grant Type 属性中选择 Refresh Token。

4. 在 Refresh Token 属性中填入 curl 命令返回的 REFRESH_TOKEN。

5. 在 Authorization Server URL 中填入：

   https://accounts.google.com/o/oauth2/token

6. 同时填写 Client ID 和 Client secret 属性。