---
# System prepended metadata

title: 為 HackMD Enterprise 設定 Google SAML 登入
tags: [docs, HackMD-EE]

---

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

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

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

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

![](https://i.imgur.com/62UCqFf.png =650x)

2. 選擇「SAML 應用程式」

![](https://i.imgur.com/gIpJUw3.png =250x)

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

![](https://i.imgur.com/gspixAf.png =350x)


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

![](https://i.imgur.com/TjxKTd7.png =400x)


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

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

![](https://i.imgur.com/ov0PJby.png =400x)

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

![](https://i.imgur.com/3ieiiWE.png =400x)

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>
    - 已簽署的回應：打勾

![](https://i.imgur.com/xL2q6b3.png =400x)

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

![](https://i.imgur.com/su0x2iJ.png =400x)

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

![](https://i.imgur.com/MSd4q4s.png =400x)

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

![](https://i.imgur.com/bt9H5Hx.png =400x)

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

![](https://i.imgur.com/AWnFOdi.png =400x)


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

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


###### tags: `docs`
