為 HackMD Enterprise 設定 Azure Active Directory 單一登入 (SAML)

tags: `HackMD-EE` `zh`

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

如要設定 Azure Active Directory 登入，可能需要 Azure AD Premium P1 以上的訂閱

本文件參考以下 Azure 文件操作，如操作介面與下方截圖不符，以 Azure 官方文件為準

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

登入您的 Azure Portal，並進入 Azure Active Directory 頁面
選擇「企業應用程式」選單
點選新增應用程式，新增一個第三方的驗證程式
選擇「不在資源庫的應用程式」，並輸入「應用程式名稱」，例如「HackMD-EE」，最後點選「加入」按鈕

新增好企業應用程式後，需要設定該應用程式所允許的使用者與登入方式，首先，我們先設定有哪些使用者被允許使用此應用程式

點選應用程式左方的「管理」->「使用者和群組」，選擇「加入使用者」
選擇使用者和群組，新增一些使用者或群組
選擇要新增的使用者或群組後，按下「選取」按鈕，當所有使用者接選取完成後，按下左下方的「指派按鈕」
即可在視窗中看到已經新增的使用者或群組

接下來我們需要設定此應用程式的登入方式

點選左側選單的「管理」->「單一登入」，並選取「SAML」做為登入方式
點選「基本 SAML 設定」右方的「鉛筆」按鈕，編輯基本 SAML 設定
參考以下資料填寫「識別碼 (實體識別碼)」與「回覆 URL (判斷提示取用者服務 URL)」，並將 my-company 置換為您的企業雲端版網址，如您所使用的是企業單機版，請將網址更改為您自訂的網址。填寫完畢後，按下左上方的儲存按鈕，即完成設定。
- 識別碼 (實體識別碼)：
```
https://my-company.hackmd.io/
```
- 回覆 URL (判斷提示取用者服務 URL)：
```
https://my-company.hackmd.io/auth/saml/callback
```
最後請下載或複製以下資訊，提供給 HackMD 官方人員，會由專人協助您設定您的登入方式
- 憑證(Base64)
- 同盟中繼資料 XML
- 登入 URL
- Azure AD 識別碼
- 登出 URL