在 QlikView 中使用 OAuth 2.0 发送电子邮件
上次更新日期：2026/10/7QlikView 可以结合 Microsoft 365 使用 OAuth 2.0，通过 Microsoft Graph 发送电子邮件。OAuth 2.0 是一种附加的邮件连接方式；现有的 SMTP 配置仍然可用。
当选择 OAuth 2.0 时，QlikView 不会直接连接到 SMTP 服务器。它从 login.microsoftonline.com 获取访问令牌，并通过位于 graph.microsoft.com/v1.0/users/{sender}/sendMail 的 Microsoft Graph REST API 发送电子邮件。
先决条件
在配置 QlikView 之前，请在 Microsoft Entra ID 中注册应用程序：
- 登录 Azure 门户并转到 Microsoft Entra ID > 应用注册 > 新注册。
- 注册应用程序。
- 在 证书和密码 下，创建客户端密码并复制其值。该值仅显示一次。
- 在 API 权限下，添加 Microsoft Graph Mail.Send 应用程序权限。
- 为该权限授予管理员同意。
- 记录应用程序 (客户端) ID 和目录 (租户) ID。
应用程序必须对用作发件人的邮箱具有 Mail.Send 权限。
安全性
QlikView 在存储租户 ID、客户端 ID 和客户端密文之前对其进行加密。凭据不以明文形式存储。
测试 OAuth 2.0 邮件
使用配置页面中的测试邮件控件：
- 在 QlikView Desktop 中，单击用户首选项 > 邮件页面上的测试。
- 在 QlikView 管理控制台中，在发送测试电子邮件至中输入地址并单击发送。
QlikView 获取 OAuth 2.0 令牌并通过 Microsoft Graph 发送测试电子邮件。如果步骤失败，请查看错误消息。
文件附件
当 QlikView 发送带有附件的电子邮件时，它会将附件作为 Base64 编码内容内联包含在 Microsoft Graph 请求中。每个附件的大小限制为 3 MB。对于较大的文件，请使用其他交付方式。
故障排除
| 错误 | 原因 | 解析 |
|---|---|---|
OAuth 2.0 Client ID, Tenant ID, and Client Secret are required.
|
一个或多个 OAuth 字段为空。 | 验证邮件设置页面上的所有三个字段均已填写。 |
OAuth token request failed: AADSTS7000215
|
客户端密钥无效。 | 在 Microsoft Entra ID 中生成新的客户端密码并更新 QlikView。 |
OAuth token request failed: AADSTS700016
|
应用程序(客户端) ID 不正确，或者该应用程序在指定的租户中不存在。 | 验证应用程序 (客户端) ID 和目录 (租户) ID。 |
Graph sendMail failed: ErrorAccessDenied
|
该应用程序没有 Mail.Send 权限，或者未授予管理员同意。 |
在 Microsoft Entra ID 中添加 Mail.Send 应用程序权限并授予管理员同意。 |
Graph sendMail failed: ErrorItemNotFound
|
发件人地址与租户中的有效邮箱不对应。 | 请确保发件人地址与现有的 Microsoft 365 邮箱相匹配。 |
Attachment too large
|
文件附件超过 3 MB 的内联限制。 | 减小文件大小或使用其他传递方式。 |
