與Microsoft® Office 365郵件伺服器通訊協定整合

為了讓組織遵守安全電子郵件要求,AEM Forms提供OAuth 2.0支援,以便與Microsoft® Office 365郵件伺服器通訊協定整合。 您可以使用Azure Active Directory (Azure AD) OAuth 2.0驗證服務來連線各種通訊協定,例如IMAP、POP或SMTP,並存取Office 365使用者的電子郵件資料。 以下是設定Microsoft® Office 365郵件伺服器通訊協定以透過OAuth 2.0服務驗證的逐步指示:

  1. 登入 https://portal.azure.com/ 並搜尋 Azure Active Directory ,然後按一下結果。
    或者,您可以直接瀏覽到 https://portal.azure.com/#blade/Microsoft_AAD_IAM/ActiveDirectoryMenuBlade/Overview

  2. 按一下 新增 > 應用程式註冊 > 新註冊

    應用程式註冊

  3. 根據您的要求填寫資訊,然後按一下 註冊.
    支援的帳戶
    在上述案例中,
    任何組織目錄(任何Azure AD目錄 — 多租使用者)中的帳戶和個人Microsoft®帳戶(例如,Skype、Xbox) 選項時才會選擇此選項。

    注意
    • 對象 任何組織目錄(任何Azure AD目錄 — 多租使用者)中的帳戶 應用程式,建議使用工作帳戶,而非個人電子郵件帳戶。
    • 僅限個人Microsoft®帳戶 應用程式不受支援。
    • 建議使用 多租使用者和個人Microsoft®帳戶 應用程式。
  4. 接下來,前往 憑證和密碼,按一下 新使用者端密碼 並依照熒幕上的步驟建立密碼。 請務必記下此secret值以供稍後使用。

    機密金鑰

  5. 若要新增許可權,請前往新建立的應用程式,然後選取 API許可權 > 新增許可權 > Microsoft® Graph > 已委派許可權

  6. 選取以下應用程式許可權的核取方塊,然後按一下 新增許可權

    • IMAP.AccessUser.All
    • Mail.Read
    • offline_access
    • POP.AccessAsUser.All
    • SMTP.Send
    • User.Read

    API許可權

  7. 選取 驗證 > 新增平台 > Web,以及 重新導向Url 區段,將下列任一URI (通用資源識別碼)新增為:

    • https://login.microsoftonline.com/common/oauth2/nativeclient
    • http://localhost

    在這種情況下, https://login.microsoftonline.com/common/oauth2/nativeclient 會作為重新導向URI使用。

  8. 按一下 設定 新增每個URL並根據您的要求進行設定後。
    重新導向 URI

    注意

    必須選取 存取權杖ID權杖 核取方塊。

  9. 按一下 概觀 並複製下列專案的值: 應用程式(使用者端) ID目錄(租使用者) ID、和 使用者端密碼 供日後使用。

    概觀

產生授權代碼

接下來,您需要產生授權代碼,如以下步驟所述:

  1. 取代後,在瀏覽器中開啟下列URL clientID 使用 <client_id>redirect_uri 使用應用程式的重新導向URI:

    https://login.microsoftonline.com/common/oauth2/v2.0/authorize?client_id=[clientid]&scope=IMAP.AccessAsUser.All%20POP.AccessAsUser.All%20SMTP.Send%20User.Read%20Mail.Read%20offline_access&response_type=code&redirect_uri=[redirect_uri]&prompt=login

    注意

    若是單一租使用者應用程式,請將 common 搭配您的 [tenantid] 在以下URL中用於產生授權代碼: https://login.microsoftonline.com/[tenantid]/oauth2/v2.0/authorize?client_id=[[clientid]]&scope=IMAP.AccessAsUser.All%20POP.AccessAsUser.All%20SMTP.Send%20User.Read%20Mail.Read%20openid%20offline_access&response_type=code&redirect_uri=[redirect_uri]&prompt=login

  2. 當您輸入上述URL時,系統會將您重新導向至登入畫面:
    登入畫面

  3. 輸入電子郵件,按一下 下一個 和應用程式許可權畫面隨即顯示:

    允許許可權

  4. 在您允許許可權後,系統會將您重新導向至新的URL,如下所示: https://login.microsoftonline.com/common/oauth2/nativeclient?code=<code>&session_state=[session_id]

  5. 複製值 <code> 從上述URL從 0.ASY...&session_state 在上述URL中。

產生重新整理權杖

接下來,您需要產生重新整理權杖,如下列步驟所述:

  1. 開啟命令提示字元並使用下列cURL命令取得refreshToken。

  2. 取代 clientIDclient_secretredirect_uri ,連同應用程式的值以及 <code>

    curl -H “ContentType application/x-www-form-urlencoded” -d “client_id=[client-id]&scope=https%3A%2F%2Foutlook.office.com%2FIMAP.AccessAsUser.All%20https%3A%2F%2Foutlook.office.com%2FPOP.AccessAsUser.All%20https%3A%2F%2Foutlook.office.com%2FSMTP.Send%20https%3A%2F%2Foutlook.office.com%2FUser.Read%20https%3A%2F%2Foutlook.office.com%2FMail.Read%20offline_access&code=[code]&grant_type=authorization_code&redirect_uri=[redirect_uri]&client_secret=[secretkey_value]” -X POST https://login.microsoftonline.com/common/oauth2/v2.0/token

    注意

    在單一租使用者應用程式中,若要產生重新整理權杖,請使用以下cURL命令並取代 common 使用 [tenantid] 在:
    curl -H “ContentType application/x-www-form-urlencoded” -d “client_id=[client-id]&scope=https%3A%2F%2Foutlook.office.com%2FIMAP.AccessAsUser.All%20https%3A%2F%2Foutlook.office.com%2FPOP.AccessAsUser.All%20https%3A%2F%2Foutlook.office.com%2FSMTP.Send%20https%3A%2F%2Foutlook.office.com%2FUser.Read%20https%3A%2F%2Foutlook.office.com%2FMail.Read%20offline_access&code=[code]&grant_type=authorization_code&redirect_uri=[redirect_uri]&client_secret=[secretkey_value]” -X POST https://login.microsoftonline.com/[tenantid]/oauth2/v2.0/token

  3. 記下重新整理權杖。

使用OAuth 2.0支援設定電子郵件服務

現在,您必須登入管理員UI,在最新的JEE伺服器上設定電子郵件服務:

  1. 前往 首頁 > 服務 > 應用程式和服務 > 服務管理 > 電子郵件服務,則 設定電子郵件服務 視窗隨即出現,並設定為基本驗證。

    注意

    若要啟用oAuth 2.0驗證服務,必須選取 SMTP伺服器是否需要驗證(SMTP驗證) 核取方塊。

  2. 設定 oAuth 2.0驗證設定 作為 True.

  3. 複製下列專案的值: 使用者端ID使用者端密碼 從Azure入口網站。

  4. 複製產生的值 重新整理Token.

  5. 登入 Workbench 和搜尋 電子郵件1.0活動選取器.

  6. 電子郵件1.0下提供三個選項:

    • 隨檔案傳送:傳送包含單一附件的電子郵件。
    • 隨附件地圖傳送:傳送包含多個附件的電子郵件。
    • 接收:從IMAP接收電子郵件。
    注意
    • 傳輸安全性通訊協定的有效值為: 'blank'、'SSL'或'TLS'。 您必須將值設定為 SMTP傳輸安全性接收傳輸安全性TLS 以啟用oAuth驗證服務。
    • pop3通訊協定 使用電子郵件端點時,不支援OAuth。

    連線設定

  7. 選取以測試應用程式 隨檔案傳送.

  8. 提供 結束日期 位址。

  9. 叫用應用程式,並使用0Auth 2.0驗證傳送電子郵件。

    注意

    如果您想要將維護作業中特定程式的Auth 2.0驗證設定變更為基本驗證,您可以設定 OAuth 2.0驗證 值設為'False',位於 使用全域設定連線設定 標籤。

啟用oAuth任務通知的方式

  1. 前往 首頁 > 服務 > 表單工作流程 > 伺服器設定 > 電子郵件設定

  2. 若要啟用oAuth任務通知,請選取 啟用oAuth 核取方塊。

  3. 複製下列專案的值: 使用者端ID使用者端密碼 從Azure入口網站。

  4. 複製產生的值 重新整理Token.

  5. 按一下 儲存 以儲存詳細資訊。

    任務通知

    注意

    若要瞭解更多與任務通知相關的資訊, 按一下這裡.

設定電子郵件端點的方式

  1. 前往 首頁 > 服務 > 應用程式和服務 > 端點管理

  2. 若要設定電子郵件端點,請設定 oAuth 2.0驗證設定 作為 True.

  3. 複製下列專案的值: 使用者端ID使用者端密碼 從Azure入口網站。

  4. 複製產生的值 重新整理Token.

  5. 按一下 儲存 以儲存詳細資訊。

    連線設定

    注意

    若要瞭解有關設定電子郵件端點的詳細資訊,請按一下 設定電子郵件端點.

疑難排解

  • 如果電子郵件服務無法正常運作。 嘗試重新產生 Refresh Token 如上所述。 部署新值需要幾分鐘的時間。

  • 使用Workbench在電子郵件端點中設定電子郵件伺服器詳細資料時發生錯誤。請嘗試透過Admin UI而不是Workbench設定端點。

本頁內容