共用方式為


使用 Microsoft Entra ID 設定 Tailscale 以自動布建使用者

本文說明您需要在 Tailscale 和 Microsoft Entra ID 中執行的步驟,以設定自動使用者布建。 設定時,Microsoft Entra ID 會使用 Microsoft Entra 佈建服務,對 Tailscale 自動佈建和取消佈建使用者和群組。 如需此服務的用途、運作方式和常見問題等重要詳細資訊,請參閱使用 Microsoft Entra ID 自動對 SaaS 應用程式進行使用者佈建和取消佈建

支援的功能

  • 在 Tailscale 中建立使用者。
  • 當某位使用者不再需要存取 Tailscale 時,請將其移除。
  • 讓 Microsoft Entra ID 與 Tailscale 之間的使用者屬性保持同步。
  • 在 Tailscale 中佈建群組和群組成員資格。
  • 單一登入至 Tailscale (建議)。

必要條件

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

步驟 1:規劃佈建部署

  1. 了解佈建服務的運作方式 \(部分機器翻譯\)。
  2. 決定在佈建範圍內的人員。
  3. 決定哪些資料要在 Microsoft Entra ID 與 Tailscale 之間對應

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

您必須是 Tailscale 中的擁有者、系統管理員或 IT 管理員,才能完成這些步驟。 請參閱 Tailscale 方案,以瞭解哪些方案可使用 Microsoft Entra 的使用者和群組佈建。

在 Tailscale 中產生 SCIM API 金鑰。

在管理主控台的 [使用者管理] 頁面中,

  1. 選取 啟用布建
  2. 將產生的金鑰複製到剪貼簿。

將金鑰資訊儲存在安全的位置。 這是您在 Microsoft Entra ID 中設定佈建時需要使用的密鑰令牌。

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

步驟 4:定義佈建範圍內的人員

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

  • 從小規模開始。 在推出給所有人之前,先使用一小部分的使用者和群組進行測試。 當佈建範圍設為已指派的使用者和群組時,您可將一或兩個使用者或群組指派給應用程式來控制這點。 當範圍設為所有使用者和群組時,您可指定以屬性為基礎的範圍篩選條件

  • 如果您需要額外的角色,您可以 更新應用程式指令清單 以新增角色。

步驟 5:設定將使用者自動佈建至 Tailscale

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

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

  1. 以至少 雲端應用程式系統管理員 的身分登入 Microsoft Entra 系統管理中心

  2. 導覽至 Entra ID>企業應用程式

    企業應用程式刀鋒視窗的螢幕擷取畫面。

  3. 在應用程式清單中,選取 [Tailscale]

    應用程式清單中 Tailscale 連結的螢幕擷取畫面。

  4. 選取 [佈建] 索引標籤。

    [佈建] 索引標籤的螢幕擷取畫面。

  5. 將 [佈建模式] 設定為 [自動]

    [自動佈建] 索引標籤的螢幕擷取畫面。

  6. 在 [管理員認證] 區段下,輸入您的 Tailscale 租用戶 URL 和祕密權杖。 選取 [測試連線 ],以確保Microsoft Entra ID 可以連線到 Tailscale。 如果連線失敗,請確定您的 Tailscale 帳戶具有管理員權限,然後再試一次。

    權杖的螢幕擷取畫面。

  7. 在 [通知電子郵件] 欄位中,輸入應該收到佈建錯誤通知的個人或群組電子郵件地址,然後選取 [發生失敗時傳送電子郵件通知] 核取方塊。

    通知電子郵件的螢幕擷取畫面。

  8. 選取 [儲存]。

  9. 在 [對應] 區段下,選取 [將 Microsoft Entra 使用者同步處理至 Tailscale]

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

    屬性 類型 支援篩選 Tailscale 的必要項目
    使用者名稱 繩子
    作用中 布林值
    顯示名稱 繩子
    首選語言 繩子
    名稱.名字 繩子
    姓名.姓氏 繩子
    名稱.格式化 繩子
    emails[type eq "work"].value (電子郵件[類型等於"工作"].值) 繩子
    externalId(外部識別碼) 繩子
  11. 在 [對應] 區段底下,選取 [將 Microsoft Entra 群組同步處理至 Tailscale]

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

    屬性 類型 支援篩選 Tailscale 的必要項目
    顯示名稱 繩子
    externalId(外部識別碼) 繩子
    成員 參考
  13. 若要設定範圍篩選,請參閱 範圍篩選一文中提供的下列指示。

  14. 如要啟用 Tailscale 的 Microsoft Entra 佈建服務,請在 [設定] 區段中,將 [佈建狀態] 變更為 [開啟]

    佈建狀態切換為開啟的螢幕擷取畫面。

  15. 在 [設定] 區段的 [範圍] 中選擇所需的值,以定義要佈建至 Tailscale 的使用者和/或群組。

    佈建範圍的螢幕擷取畫面。

  16. 當您準備好進行配置時,請選取 [ 儲存]。

    儲存佈建設定的螢幕擷取畫面。

此作業會對在 [設定] 區段的 [範圍] 中所定義所有使用者和群組啟動首次同步處理週期。 初始週期的執行時間比後續迴圈要長,只要 Microsoft Entra 佈建服務仍在執行,大約每 40 分鐘就會發生一次。

步驟 6:監視您的部署

設定佈建後,請使用下列資源來監視部署:

  1. 使用 布建記錄 來判斷哪些使用者已成功或未成功布建
  2. 檢查進度列來查看佈建週期的狀態,以及其接近完成的程度
  3. 如果佈建設定似乎處於狀況不良的狀態,則應用程式將會進入隔離狀態。 深入瞭解 應用程式布建隔離狀態 一文中的隔離狀態。

變更記錄檔

  • 11/21/2023 - 已新增群組佈建的支援。

更多資源