本文說明您需要在 Dagster Cloud 和 Microsoft Entra ID 中執行的步驟，以設定自動使用者布建。 設定時，Microsoft Entra ID 會自動使用 Microsoft Entra 布建服務，將使用者和群組解除布建至 Dagster Cloud。 如需瞭解有關此服務的重要詳細資訊，包括其功能、運作方式和常見問題，請參閱 使用 Microsoft Entra ID 自動化使用者布建和取消布建至 SaaS 應用程式。
支援的功能
- 在 Dagster Cloud 中建立使用者。
- 當使用者不再需要存取權時，請移除 Dagster Cloud 中的使用者。
- 讓用戶屬性在 Microsoft Entra ID 與 Dagster Cloud 之間保持同步。
- 在 Dagster Cloud 中設定群組和群組成員資格。
- 單一登錄 至 Dagster Cloud（建議）。
先決條件
本文中所述的案例假設您已經具備下列必要條件：
- Microsoft Entra 租使用者
- 下列其中一個角色：應用程式管理員、雲端應用程式管理員或 應用程式擁有者。
- Dagster Cloud 中具有組織管理員許可權的用戶帳戶。
步驟 1：規劃布建部署
步驟 2：設定 Dagster Cloud 以支援使用 Microsoft Entra 標識符進行佈建
- 登入您的 Dagster 雲端帳戶。
- 選取 使用者選單 （您的圖示） > 雲端設定。
- 選取 [佈建] 索引標籤。
- 如果未啟用 SCIM 配置，請選取 [啟用 SCIM 配置] 按鈕加以啟用。
- 選取 [建立 SCIM 令牌 ] 以建立 API 令牌。 此令牌可用來驗證來自 Microsoft Entra ID 至 Dagster Cloud 的要求。 讓 API 令牌方便使用 - 您稍後會在步驟 5 中用到它。
步驟 3：從 Microsoft Entra 應用連結庫新增 Dagster Cloud
從 Microsoft Entra 應用連結庫新增 Dagster Cloud，以開始管理對 Dagster Cloud 的布建。 如果您先前已設定 Dagster Cloud for SSO，則可以使用相同的應用程式。 不過，建議您在一開始測試整合時建立個別的應用程式。 請在這裡了解更多關於從資源庫新增應用程式 。
步驟 4：定義布建範圍中的人員
Microsoft Entra 布建服務可讓您根據指派給應用程式，或根據使用者或群組的屬性來設定布建的人員範圍。 如果您選擇根據指派來設定布建至應用程式的人員範圍，您可以使用 步驟將使用者和群組指派給應用程式。 如果您選擇只根據使用者或群組的屬性來決定配置對象的範圍，您可以使用 範圍篩選。
從小開始。 在向所有人推出之前，先使用一組小型的使用者和群組進行測試。 當布建範圍設定為指派的使用者和群組時，您可以將一或兩個使用者或群組指派給應用程式來控制此設定。 當範圍設定為所有使用者和群組時，您可以指定 屬性型範圍篩選。
如果您需要額外的角色，您可以 更新應用程式指令清單 以新增角色。
步驟 5：設定對 Dagster Cloud 的自動使用者佈署
本節會引導您逐步設定 Microsoft Entra 布建服務，以根據 Entra ID Microsoft 中的使用者和/或群組指派，在 TestApp 中建立、更新和停用使用者和/或群組。
若要在 Microsoft Entra 識別中，為 Dagster Cloud 設定自動使用者佈建：
以至少 雲端應用程式管理員身分登入 Microsoft Entra 系統管理中心。
導覽至 Entra ID>企業應用程式
![[企業應用程式] 面板的螢幕快照。](common/enterprise-applications.png)
在應用程式清單中，選取 [Dagster Cloud]。
選取 [佈建] 索引標籤。
![[布建] 標籤頁的螢幕快照。](common/provisioning.png)
將 [布建模式] 設定為 [自動]。
![[配置] 索引標籤的自動截圖。](common/provisioning-automatic.png)
在 [系統管理員認證] 區段底下，輸入您的 Dagster 雲端租使用者 URL 和秘密令牌。 租使用者 URL 是
https://*your-org-name*.dagster.cloud/scim/v2，而秘密令牌是您在上述步驟 2 中建立的 SCIM 令牌。 選取 [測試連線 ]，以確保Microsoft Entra ID 可以連線到 Dagster Cloud。
在 [通知電子郵件] 字段中，輸入應收到布建錯誤通知的人員或群組的電子郵件地址，然後選取 [發生 失敗時傳送電子郵件通知] 複選框。
選取 儲存。
在 [對應] 區段底下，選取 [同步 Microsoft Entra 使用者至 Dagster Cloud]。
在 [屬性對應 ] 區段中，檢閱從 Microsoft Entra ID 同步到 Dagster Cloud 的用戶屬性。 選取為 [比對] 屬性的屬性會用於在 Dagster Cloud 中比對使用者帳戶，以執行更新作業。 如果您選擇變更 比對目標屬性，您必須確定 Dagster Cloud API 支援根據該屬性篩選使用者。 按下 儲存 按鈕來確認任何變更。
屬性 類型 支持篩選 Dagster Cloud 的必要專案 使用者名稱 字串 ✓ ✓ 積極 布爾 顯示名稱 字串 emails[type eq “work”].value 字串 名稱.名字 字串 名字.姓氏 字串 外部識別碼 字串 如果您想要將Microsoft Entra 群組同步處理至 Dagster Cloud，請在 [對應] 區段底下，選取 [同步處理Microsoft Entra 群組至 Dagster Cloud。
在 [屬性對應] 區段中，檢閱從 Microsoft Entra ID 同步至 Dagster Cloud 的群組屬性。 選取為 [比對] 屬性的屬性會用來比對 Dagster Cloud 中的群組以進行更新作業。 按下 儲存 按鈕來確認任何變更。
屬性 類型 支持篩選 Dagster Cloud 的必要專案 顯示名稱 字串 ✓ ✓ 外部識別碼 字串 成員 參考 若要設定範圍篩選，請參閱 範圍篩選一文中提供的下列指示。
若要啟用 Dagster Cloud 的 Microsoft Entra 布建服務，請在 [設定] 區段中將 [布建狀態] 更改為 [開啟]。
在 [設定] 區段中，選擇 [範圍] 中所需的值，以定義您想要布建至 Dagster Cloud 的使用者和/或群組。
當您準備好進行配置時，請選取 [ 儲存]。
此作業會啟動在 [ 設定] 區段中 範圍 中定義之所有使用者和群組的初始同步處理週期。 初始週期的執行時間比後續迴圈還要長，只要Microsoft Entra 布建服務執行，大約每 40 分鐘就會發生一次。
步驟 6：監視您的部署
設定佈建後，請使用下列資源來監視部署：
- 使用 布建記錄 來判斷哪些使用者已成功或未成功布建
- 檢查 進度列 以查看布建周期的狀態，以及布建週期的完成程度
- 如果布建組態似乎處於狀況不良狀態，則應用程式會進入隔離狀態。 深入瞭解 應用程式布建隔離狀態 一文中的隔離狀態。