為 HackMD Enterprise 設定 Azure Active Directory OAuth2 登入

tags: HackMD-EE zh

此文件適用於 HackMD 企業雲端版

如要設定 HackMD 使用 Azure Active Directory 提供的 OAuth2 登入驗證方式，請依照以下方式設定

1. 登入您的 Azure Portal，並進入 Azure Active Directory 頁面
   

2. 選擇「應用程式註冊」選單
   

3. 按下「新增註冊」按鈕，註冊新的應用程式

4. 填寫「應用程式名稱」，支援的帳戶類型選擇「僅此組織目錄中的帳戶(僅 xxxx(your azure ad directory) - 單一租用戶)」
   

5. 平台設定選擇「Web API」，最後點選「註冊」按鈕註冊
   

6. 設定 「API 權限」，
   a. 選擇管理分類下的「API 權限」選單
   b. 點選「新增權限按鈕」
   c. 點選「我的組織使用的 API」頁籤
   d. 搜尋「Microsoft Graph」
   e. 選擇「Microsoft Graph」

7. 應用程式需要何種類型的權限中選擇「委派的權限」，並勾選「email」、「openid」、「profile」三種權限，最後按下「新增權限」按鈕

8. 按下「代表 xxx (your azure ad directory) 授與管理員同意」，如該按鈕無法按下，請重新整理頁面

9. 使用管理員帳號，接受應用程式授權
   

10. 選擇管理分類下的「驗證」選單，點選「新增平台」按鈕，選擇「Web 應用程式」
    

11. 重新導向 URI 填寫「https://your-company.hackmd.io/auth/azure-ad/callback」，並按下設定

URI 中 your-company 的部分，請替換為您的 HackMD 網址，如果不清楚要填寫的內容，請聯絡客服人員。

12. 選擇管理分類下的「憑證及秘密」選單，點選「新增用戶端密碼」按鈕，產生一組用戶端密碼。

13. 請將產生的密碼複製下來，與「OpenID Connect 中繼資料文件」的「端點」、「應用程式 (用戶端) 識別碼」三個資料提供給 HackMD 官方人員，會由專人協助您設定您的登入方式