> ## Documentation Index
> Fetch the complete documentation index at: https://manual.voiceping.net/llms.txt
> Use this file to discover all available pages before exploring further.
# SSO設定指南（Microsoft Entra ID）
> 使用Microsoft Entra ID（原Azure AD）配置單點登入的指南
export const ContactZhTW = () => <>
如有任何問題，請透過此表單與我們聯繫。
## 官方連結
造訪官方網站
在X上追蹤我們
在Facebook上按讚
在LinkedIn上連結
;
## 單點登入功能
企業版客戶可以在工作區中啟用單點登入（SSO），允許使用者使用Microsoft Entra ID登入VoicePing。
本指南將說明如何在工作區中啟用SSO，以及如何將Microsoft Entra ID配置為身分提供者（IdP）。
## 前提條件
擁有VoicePing企業版使用者帳號
擁有Microsoft Azure帳號
***
## 註冊身分提供者
### Microsoft Entra ID配置
從Azure入口網站開啟Microsoft Entra ID，進入企業應用程式頁面。
點選「新建應用程式」，新增VoicePing。
為IdP上的VoicePing應用程式配置使用SAML 2.0協定進行SSO。
您可以在VoicePing應用程式中工作區管理儀錶板的「團隊管理 > SSO設定」標籤頁中找到所需欄位。
只有啟用了SSO的工作區的擁有者或管理員才能存取。
| 專案 | 值 |
| --------- | ------------------------------------------ |
| ACS URL | `https://api.voiceping.io/api/v1/user/acs` |
| Entity ID | `voice-ping` |
在SAML宣告中包含使用者的電子郵件地址。這是在VoicePing平臺中進行身分驗證所必需的。
IdP中定義的電子郵件地址必須與在VoicePing中註冊使用者時使用的電子郵件地址相同。
Microsoft Entra ID預設應該已配置，如果未配置，請新增。
將使用者新增到建立的VoicePing應用程式。
1. 從Microsoft Entra ID的VoicePing應用程式開啟「使用者和群組」頁面
2. 點選「新增使用者/群組」
3. 選擇要授予存取許可權的使用者或群組
4. 點選「選擇」和「分配」
請確認新增的使用者已在Microsoft Azure上設定了電子郵件地址。
從IdP（Microsoft Entra ID）下載中繼資料檔案。此檔案稍後將在VoicePing端使用。
***
## VoicePing配置
進入工作區管理儀錶板，開啟「團隊管理 > SSO設定」標籤頁，啟用SSO。
切換到身分提供者標籤頁。選擇Microsoft Entra ID作為IdP，上傳IdP中繼資料檔案並提交變更。
中繼資料檔案可從Microsoft Entra ID取得。
定義組織ID。這必須是一個至少3個字元、最多20個字元的唯一字串。
組織ID將在SSO登入時向使用者請求。
將使用者新增到工作區。使用者的電子郵件地址必須與Microsoft Entra ID配置中選擇的使用者電子郵件地址相符。
使用者可以透過邀請或直接建立的方式新增。
***
## SSO登入
工作區配置SSO後：
* **擁有者和管理員**：可以透過其他方式登入VoicePing
* **普通成員**：需要透過SSO進行身分驗證
當邀請新的VoicePing使用者加入SSO工作區時，使用者透過SSO註冊後將取得VoicePing使用者帳號。
### 登入步驟
1. 進入VoicePing登入頁面
2. 點選「SSO登入」按鈕
3. 輸入組織ID
4. 在Microsoft Entra ID認證頁面進行認證
***