# 為 HackMD Enterprise 設定 Google SAML 登入
###### tags: `HackMD-EE`

> 此文件適用於 `HackMD 企業雲端版`、`HackMD 企業單機版`

如要設定 HackMD 使用 Google SAML 提供的 SSO 登入驗證方式，請依照以下方式進行

1. 登入您的[Google 管理主控台](https://admin.google.com)，並點選「應用程式」


2. 選擇「SAML 應用程式」


3. 點選右下角的「為 SAML 應用程式啟用 SSO」按鈕，新增一個 SAML 應用程式


4. 點選下方的 「設定我的自訂應用程式」


5-1. 如果是雲端企業版的用戶，請點選「方法 2」中的「下載 IDP 中繼資料」，並將該檔案提供給客服人員，客服人員會協助您設定 SAML 登入。

5-2. 如果是企業單機版的用戶，請使用「方法 1」的方式，將「SSO 網址」與「憑證」儲存到電腦，SAML 登入僅需要此兩種資訊


6. 「您的自訂應用程式基本資訊」欄位可以填寫一個您所能識別的名稱，此欄位僅供您管理使用


7. 「服務供應商詳細資訊」的資料，請參考以下資料填寫，並將 ==my-company== 置換為您的企業雲端版網址，如您所使用的是企業單機版，請將網址更改為您自訂的網址。
- ACS 網址：<pre>https://==my-company==.hackmd.io/auth/saml/callback</pre>
- 實體 ID：<pre>https://==my-company==.hackmd.io/</pre>
- 起始網址：<pre>https://==my-company==.hackmd.io/</pre>
- 已簽署的回應：打勾


8. HackMD 不需要設定任何屬性對應，直接按下右下角的完成即可


9. 接著按下「確定」即完成 SAML 應用程式的設定，按該應用程式還尚未啟用，因此請再根據以下步驟啟用 SAML 應用程式


10. 點選應用程式右上角的「編輯服務」按鈕


11. 接著將服務狀態切換至「為所有人啟用」，並點選右下角的儲存即可


12. 如果您所使用的版本為企業單機版，請在您的服務上增加以下設定

HMD_SAML_IDPSSOURL=第 5-2 步驟的 SSO 網址
HMD_SAML_IDPCERT=第 5-2 步驟所下載的憑證檔案路徑
HMD_SAML_ISSUER=您的服務網址 (例如 https://my-company.hackmd.io/)

###### tags: `docs`