教學課程：針對 SchoolStream ASA 中的自動使用者佈建設定 SchoolStream ASA
此教學課程說明您在 SchoolStream ASA 與 Microsoft Entra ID 中設定自動使用者佈建所需執行的步驟。 設定時，Microsoft Entra ID 會使用 Microsoft Entra 佈建服務，對 SchoolStream ASA 自動佈建和取消佈建使用者和群組。 如需此服務的用途、運作方式和常見問題等重要詳細資料，請參閱使用 Microsoft Entra ID 對 SaaS 應用程式自動佈建和取消佈建使用者。
支援的功能
- 在 SchoolStream ASA 中建立使用者
- 當使用者不再需要存取時，將其從 SchoolStream ASA 中移除。
- 讓使用者屬性在 Microsoft Entra ID 與 SchoolStream ASA 之間保持同步。
- 在 SchoolStream ASA 中佈建群組和群組成員資格。
- SchoolStream ASA 的單一登入 (建議)。
必要條件
本教學課程中概述的案例假設您已經具有下列必要條件：
- Microsoft Entra 租用戶
- 下列其中一個角色：應用程式系統管理員、雲端應用程式管理員，或應用程式擁有者。
- SchoolStream 網站。 如果您沒有 SchoolStream 網站，請洽詢 SchoolStream 支援。
步驟 1：規劃佈建部署
- 了解佈建服務的運作方式 \(部分機器翻譯\)。
- 判斷誰會在佈建範圍 \(部分機器翻譯\) 內。
- 確定哪些資料要在 Microsoft Entra ID 與 SchoolStream ASA 之間對應。
步驟 2：設定 SchoolStream ASA 以支援使用 Microsoft Entra ID 進行佈建
請連絡 SchoolStream 支援以要求 SchoolStream ASA 整合，您必須提供 您的Microsoft Entra 租用戶識別碼 和 SchoolStream 網站 URL。
SchoolStream 已對應 SchoolStream 網站和 Microsoft Entra 租用戶識別碼之後，您將會取得秘密權杖和 SchoolStream ASA 租用戶 URL。
步驟 3：從 Microsoft Entra 應用程式庫新增 SchoolStream ASA
若要開始在 Microsoft Entra ID 中管理對 SchoolStream ASA 的佈建，您需要從 Microsoft Entra 應用程式庫新增 SchoolStream ASA。
- 以至少 雲端應用程式系統管理員 的身分登入 Microsoft Entra 系統管理中心。
- 瀏覽至 [身分識別] > [應用程式] > [企業應用程式] > [新增應用程式]。
- 在 [瀏覽 Microsoft Entra 資源庫] 區段中，於搜尋方塊中輸入 SchoolStream ASA。
- 從結果面板選取 [SchoolStream ASA]，然後註冊應用程式。 將應用程式新增至您的租用戶時，請稍候幾秒鐘。
如果您先前已針對 SSO 設定 SchoolStream ASA，則可使用相同的應用程式。 不過，建議在一開始測試整合時，建立個別的應用程式。 在此深入了解從資源庫新增應用程式。
步驟 4：定義佈建範圍內的人員
Microsoft Entra 佈建服務可讓您根據指派給應用程式，或根據使用者/群組的屬性來設定佈建的人員範圍。 如果選擇根據指派來界定將佈建至應用程式的人員，則可使用下列步驟將使用者和群組指派給應用程式。 如果選擇僅根據使用者或群組屬性來界定將要佈建的人員，即可使用如這裡所述的範圍篩選條件。
從小規模開始。 在推出給所有人之前，先使用一小部分的使用者和群組進行測試。 當佈建範圍設為已指派的使用者和群組時，您可將一或兩個使用者或群組指派給應用程式來控制這點。 當範圍設為所有使用者和群組時，您可指定以屬性為基礎的範圍篩選條件。
如果需要其他角色，您可以更新應用程式資訊清單以新增角色。
步驟 5：設定對 SchoolStream ASA 的自動使用者佈建
本章節將逐步引導您設定 Microsoft Entra 佈建服務，以根據 Microsoft Entra ID 中的使用者和/或群組指派，在 SchoolStream ASA 中建立、更新和停用使用者和/或群組。
在 Microsoft Entra ID 中設定 SchoolStream ASA 的自動使用者佈建：
以至少 雲端應用程式系統管理員 的身分登入 Microsoft Entra 系統管理中心。
瀏覽至 [身分識別]>[應用程式]>[企業應用程式]
在應用程式清單中，選取 [SchoolStream ASA]。
![[應用程式] 清單中的 SchoolStream ASA 連結](common/all-applications.png)
選取 [佈建] 索引標籤。
![[佈建] 索引標籤](common/provisioning.png)
如果您是第一次設定佈建，請選取 [開始]。
將 [佈建模式] 設定為 [自動]。
![[佈建] 索引標籤自動的螢幕擷取畫面。](common/provisioning-automatic.png)
在 [管理員認證] 區段中，輸入您的 SchoolStream ASA 租用戶 URL 和祕密權杖。 按一下 [測試連線] 以確保 Microsoft Entra ID 可以連線到 SchoolStream ASA。 如果連線失敗，請確定您的 SchoolStream ASA 帳戶具有系統管理員許可權，然後再試一次。
選取 [儲存] 以查看 [設定] 區段。
在 [設定] 區段的 [通知電子郵件] 欄位中，輸入應該收到佈建錯誤通知的個人或群組電子郵件地址，然後選取 [發生失敗時傳送電子郵件通知] 核取方塊。
在 [對應] 區段中，選取 [佈建 Microsoft Entra 使用者]。
選取底部的 [新增對應]。
在對話方塊 [編輯屬性] 中：
在 [對應類型] 欄位中，從下拉式清單中選取 [直接]，
在 [來源屬性] 欄位中，從下拉式清單中選取 [extensionAttribute1]，
在欄位 [預設值 (如果 null (選擇性))] 中輸入您的 Microsoft Entra 租用戶識別碼，
在 [目標屬性] 欄位中，從下拉式清單中選取 [urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:organization]，
在 [使用此屬性比對物件] 欄位中，從下拉式清單中選取 [否]，
在 [套用此對應] 欄位中，從下拉式清單中選取 [一律]，
選取 [確定]。
在 [屬性對應] 區段中，檢閱從 Microsoft Entra ID 同步處理到 SchoolStream ASA 的使用者屬性。 選取為 [比對] 屬性的屬性會用來比對 SchoolStream ASA 中的使用者帳戶，以進行更新作業。 如果您選擇變更 [比對目標屬性]，則必須確保 SchoolStream ASA API 支援根據該屬性來篩選使用者。
屬性 類型 支援篩選 userName String ✓ 作用中 布林值 displayName String emails[type eq "work"].value String preferredLanguage String name.givenName String name.familyName String name.formatted String phoneNumbers[type eq "mobile"].value String externalId String urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:organization String 在 [對應] 區段下方，選取 [將Microsoft Entra 群組同步至 UNIFI]。
檢閱 [屬性對應] 區段中從 Microsoft Entra ID 同步至 UNIFI 的群組屬性。 選取為 [比對] 屬性的屬性會用來比對 UNIFI 中的群組以進行更新作業。 選取 [儲存] 按鈕以認可所有變更。
屬性 類型 支援篩選 displayName String ✓ 成員 參考 externalId String 選取 [儲存] 按鈕以認可所有變更。 您可以返回 [應用程式] 索引標籤，然後選取 [編輯佈建] 以繼續。
若要設定範圍篩選，請參閱範圍篩選教學課程中提供的下列指示。
若要啟用 SchoolStream ASA 的 Microsoft Entra 佈建服務，請將 [設定] 區段中的 [佈建狀態] 變更為 [開啟]。
在 [設定] 區段的 [範圍] 中選擇所需的值，以定義要佈建至 SchoolStream ASA 的使用者和/或群組。
當您準備好要佈建時，按一下 [儲存]。
此作業會對在 [設定] 區段的 [範圍] 中所定義所有使用者和群組啟動首次同步處理週期。 初始週期的執行時間比後續迴圈要長，只要 Microsoft Entra 佈建服務仍在執行，大約每 40 分鐘就會發生一次。
步驟 6：監視您的部署
設定佈建後，請使用下列資源來監視部署：
- 使用佈建記錄來判斷哪些使用者已佈建成功或失敗
- 檢查進度列來查看佈建週期的狀態，以及其接近完成的程度
- 如果佈建設定似乎處於狀況不良的狀態，則應用程式將會進入隔離狀態。 在此 \(部分機器翻譯\) 深入了解隔離狀態。
變更記錄檔
- 09/24/2020 - 已啟用群組佈建。