使用 Microsoft Entra 識別碼設定 Twingate 來自動布建使用者

2025-05-20

本文說明您需要在 Twingate 和 Microsoft Entra ID 中執行的步驟，以設定自動化使用者配置。在設定時，Microsoft Entra ID 會自動使用 Microsoft Entra 布建服務，對 Twingate 進行使用者和群組的布建及取消布建。如需了解此服務的功能、操作方式及常見問題的重要資訊，請參閱使用 Microsoft Entra ID 將使用者布建和取消布建至 SaaS 應用程式。

支援的功能

在 Twingate 中建立使用者
當使用者不再需要存取權時，請移除 Twingate 中的使用者
讓使用者屬性在 Microsoft Entra ID 與 Twingate 之間保持同步
在 Twingate 中配置群組和群組成員關係
單一登入至 Twingate (建議)

必要條件

本文中所述的案例假設您已經具備下列必要條件：

Microsoft Entra 租戶
下列其中一個角色：應用程式管理員、雲端應用程式管理員或應用程式擁有者。
支援識別提供者整合的產品等級中的 Twingate 租戶。如需不同產品層的詳細數據，請參閱 Twingate 定價。
Twingate 中具有管理員權限的使用者帳戶。

步驟 1：規劃佈建部署

瞭解布建服務的運作方式。
確定誰在配置範圍內。
決定要將哪些資料在 Microsoft Entra ID 與 Twingate 之間進行映射。

步驟 2：設定 Twingate 以支援使用 Microsoft Entra ID 進行佈建

登入您的 Twingate 管理控制台。
瀏覽至 [設定] > [識別提供者]
...選取按鈕以開啟動作功能表。選取 [重新產生 SCIM 令牌]。如果有的話，請注意，這會使現有的令牌失效。
從對話框中複製SCIM 端點和SCIM 令牌。這些值會分別在 Twingate 應用程式的 [布建] 索引標籤的 [ 租使用者 URL ] 和 [ 秘密令牌 ] 字段中輸入。

步驟 3：從 Microsoft Entra 應用程式資源庫新增 Twingate

從 Microsoft Entra 應用程式資源庫新增 Twingate，以開始管理對 Twingate 的佈建。如果您先前已針對 SSO 設定 Twingate，則可使用相同的應用程式。不過，建議您在一開始測試整合時建立個別的應用程式。了解更多關於從應用程式庫新增應用程式的資訊。

步驟 4：定義布建範圍中的人員

Microsoft Entra 布建服務可讓您根據指派給應用程式，或根據使用者或群組的屬性來設定布建的人員範圍。如果您選擇根據指派來設定布建至應用程式的人員範圍，您可以使用步驟將使用者和群組指派給應用程式。如果您選擇只根據使用者或群組的屬性來配置人員的範圍，您可以使用範圍過濾器。

從小規模開始。在推出給所有人之前，先使用一小部分的使用者和群組進行測試。當佈建範圍設為已指派的使用者和群組時，您可將一或兩個使用者或群組指派給應用程式來控制這點。當範圍設定為所有使用者和群組時，您可以指定以屬性為基礎的範圍篩選。
如果您需要額外的角色，您可以更新應用程式指令清單以新增角色。

步驟 5：設定對 Twingate 的自動使用者配置

本節將引導您逐步設定 Microsoft Entra 佈建服務，以根據 Entra ID Microsoft 中的使用者及/或群組指派，在 Twingate 中建立、更新和停用使用者及/或群組。

若要在 Microsoft Entra ID 中為 Twingate 設定自動使用者佈建：

以至少雲端應用程式管理員身分登入 Microsoft Entra 系統管理中心。
導航到 Entra ID>Enterprise 應用程式
在應用程式清單中，選取 Twingate。
選取 [佈建] 索引標籤。
將 [佈建模式] 設定為 [自動]。
在 [管理員認證] 區段下，輸入您的 Twingate 租用戶 URL 和祕密權杖。選取 [測試連線 ] 以確保Microsoft Entra ID 可以連線到 Twingate。如果連線失敗，請確定您的 Twingate 帳戶具有管理員權限，然後再試一次。
在 [通知電子郵件] 欄位中，輸入應該收到佈建錯誤通知的個人或群組電子郵件地址，然後選取 [發生失敗時傳送電子郵件通知] 核取方塊。
選取 [ 儲存]。
在 [對應] 部分下，選取 [將 Microsoft Entra 使用者同步到 Twingate]。

在 [ 屬性對應 ] 區段中，檢閱從 Microsoft Entra ID 同步處理到 Twingate 的用戶屬性。選取為 [比對] 屬性的屬性會用來比對 Twingate 中的使用者帳戶，以進行更新作業。如果您選擇變更比對目標屬性，您必須確定 Twingate API 支援根據該屬性篩選使用者。選取 [儲存] 按鈕以認可所有變更。

屬性	類型	支援篩選
externalId（外部識別碼）	字串	✓
使用者名稱	字串
活動中	布林值
emails[type eq "work"].value (電子郵件[類型等於"工作"].值)	字串
名稱.名字	字串
名.姓氏	字串

在 [對應] 區段底下，選取 [同步 Microsoft Entra 群組至 Twingate]。
在 [屬性對應 ] 區段中，檢閱從 Microsoft Entra ID 同步至 Twingate 的群組屬性。選取為 [比對] 屬性 (Property) 的屬性 (Attribute) 會用來比對 Twingate 中的群組，以進行更新作業。選取 [儲存] 按鈕以認可所有變更。

屬性類型支援篩選

externalId（外部識別碼）字串 ✓

顯示名稱字串

成員參考
若要設定範圍篩選，請參閱範圍篩選一文中提供的下列指示。
若要啟用 Twingate 的 Microsoft Entra 布建服務，請將 [設定] 區段中的 [布建狀態] 變更為 [開啟]。
在 [設定] 區段的 [範圍] 中選擇所需的值，以定義要佈建至 Twingate 的使用者和/或群組。
當您準備好布建時，請選取 [ 儲存]。