在 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 取得存取 Token，並透過 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 Token，並透過 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
|
應用程式 (用戶端) 識別碼不正確，或該應用程式在指定的租用戶中不存在。 | 驗證應用程式 (用戶端) 識別碼和目錄 (租用戶) 識別碼。 |
Graph sendMail failed: ErrorAccessDenied
|
應用程式沒有 Mail.Send 權限，或尚未授予管理員同意。 |
新增 Mail.Send 應用程式權限，並在 Microsoft Entra ID 中授與管理員同意。 |
Graph sendMail failed: ErrorItemNotFound
|
寄件者地址未對應至租用戶中的有效信箱。 | 請確認寄件者地址與現有的 Microsoft 365 信箱相符。 |
Attachment too large
|
檔案附件超過 3 MB 的內嵌限制。 | 縮小檔案大小或使用其他傳送方式。 |
