共用方式為

教學課程：設定 Jostle 來自動佈建使用者

  • 發行項

此教學課程說明您在 Jostle 與 Microsoft Entra ID 中設定自動使用者佈建所需的步驟。 設定時，Microsoft Entra ID 會使用 Microsoft Entra 佈建服務，自動佈建和取消佈建使用者和群組至 Jostle。 如需此服務的用途、運作方式和常見問題等重要詳細資料，請參閱使用 Microsoft Entra ID 對 SaaS 應用程式自動佈建和取消佈建使用者。

支援的功能

  • 在 Jostle 中建立使用者
  • 當使用者不再需要存取時，將其從 Jostle 中移除
  • 讓 Microsoft Entra ID 與 Jostle 之間的使用者屬性保持同步
  • 單一登入至 Jostle (建議)

必要條件

本教學課程中概述的案例假設您已經具有下列必要條件：

步驟 1：規劃佈建部署

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

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

自動化帳戶

在開始之前，您需要在 Jostle 內部網路中建立自動化使用者。 這將是用於設定 Azure 的帳戶。 可以在管理設定>使用者帳戶和資料>管理自動化使用者中建立自動化使用者。

如需自動化使用者以及如何建立自動化使用者的詳細資訊，請參閱這篇文章。

建立後，必須啟動自動化使用者帳戶 (即至少登入一次內部網路)，才能使用其來設定 Azure。

管理使用者佈建

開始之前，請確保您的帳戶訂用帳戶包含 SSO/使用者佈建功能。 如果沒有，您可以聯繫您的客戶成功經理 success@jostle.me，他們可以協助您將其新增到您的帳戶中。

下一步是從 Jostle 取得 API URL 和 API 金鑰：

  1. 移至 [主要導覽]，然後按一下 [管理員設定]。

  2. 在 [與其他系統之間的使用者資料] 下，按一下 [管理使用者佈建]。如果您在此處未看到「管理使用者佈建」，並且已驗證您的帳戶包含 SSO/使用者佈建，請連絡支援人員 support@jostle.me，以在您的管理員設定中啟用此頁面設定。

  3. 在 [使用者佈建 API 詳細資訊] 區段中，移至 [您的基本 URL 欄位]，按一下 [複製] 按鈕並將 URL 儲存在您以後可以輕鬆存取的位置。

    佈建

  4. 接著，按一下 [新增新的金鑰...] 按鈕

  5. 在下列畫面上，移至 [自動化使用者] 欄位並使用下拉式功能表選取您的自動化使用者帳戶。

    整合帳戶

  6. 在 [佈建 API 金鑰描述] 欄位中，為金鑰指定名稱 (例如，Azure)，然後按一下 [新增] 按鈕。

  7. 一旦產生金鑰後，請確保立即將其複製並將其儲存在您儲存 URL 的位置 (因為這將是金鑰唯一出現的時間)。

  8. 接下來，您將使用 API URL 和 API 金鑰在 Azure 中設定整合。

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

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

Microsoft Entra 佈建服務可讓您根據指派給應用程式，或根據使用者/群組的屬性來設定佈建的人員範圍。 如果選擇根據指派來界定將佈建至應用程式的人員，則可使用下列步驟將使用者和群組指派給應用程式。 如果選擇僅根據使用者或群組屬性來界定將要佈建的人員，即可使用如這裡所述的範圍篩選條件。

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

  • 如果需要其他角色，您可以更新應用程式資訊清單以新增角色。

步驟 5：設定使用者自動佈建至 Jostle

本節會引導您逐步設定 Microsoft Entra 佈建服務，以根據 Microsoft Entra ID 中的使用者和群組指派，在 Jostle 應用程式中建立、更新和停用使用者和群組。

注意

如需有關自動將使用者佈建到 Jostle 的詳細資訊，請參閱 User-Provisioning-Azure-Integration。

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

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

  2. 瀏覽至 [身分識別]>[應用程式]>[企業應用程式]

    企業應用程式刀鋒視窗

  3. 在應用程式清單中，選取 [Jostle] 。

    應用程式清單中的 Jostle 連結

  4. 選取 [佈建] 索引標籤並按一下 [開始使用]。

    [佈建] 索引標籤

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

    佈建索引標籤 [自動]

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

    Token

  7. 在 [通知電子郵件] 欄位中，輸入應收到佈建錯誤通知的個人或群組電子郵件地址。 選取 [發生失敗時傳送電子郵件通知] 核取方塊。 但要注意的是，Jostle 也會傳送佈建失敗通知，因此這是可選的。

    通知電子郵件

  8. 選取 [儲存]。

  9. 在 [對應] 區段中，選取 [佈建 Microsoft Entra 使用者至 Jostle]。

  10. 在 [屬性對應] 區段中，檢閱從 Microsoft Entra ID 同步處理至 Jostle 的使用者屬性。 選取為 [比對] 屬性的屬性會用來比對 Jostle 中的使用者帳戶，以進行更新作業。 如果您變更了比對目標屬性，則必須確保 Jostle API 支援根據該屬性來篩選使用者。 選取 [儲存] 認可任何變更。

    屬性 類型 支援篩選
    userName String
    作用中 布林值
    name.givenName String
    name.familyName String
    emails[type eq "work"].value String
    emails[type eq "personal"].value String
    emails[type eq "alternate1"].value String
    emails[type eq "alternate2"].value String
    urn:ietf:params:scim:schemas:extension:jostle:2.0:User:alternateEmail1Label String
    urn:ietf:params:scim:schemas:extension:jostle:2.0:User:alternateEmail2Label String

  11. 若要設定範圍篩選條件，請參閱範圍篩選教學課程中提供的指示。

  12. 若要啟用 Jostle 的 Microsoft Entra 佈建服務，請在 [設定] 區段中，將 [佈建狀態] 變更為 [開啟]。

    佈建狀態已切換為開啟

  13. 透過在 [設定] 區段的 [範圍] 中選取所需的值，定義要設定為 Jostle 的使用者或群組。對於 Jostle，[範圍] 應設定為「僅同步指派的使用者和群組」。

    佈建範圍

  14. 準備好要佈建時，請選取 [儲存]。

    儲存雲端佈建設定

此作業會對在 [設定] 區段的 [範圍] 中所定義所有使用者和群組啟動首次同步處理週期。 初始週期會比後續週期花費更多時間執行，而後續週期會在 Microsoft Entra 佈建服務執行期間，大約每 40 分鐘執行一次。

步驟 6：監視您的部署

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

  • 使用佈建記錄可以判斷使用者是否已順利完成佈建。
  • 檢查進度列來查看佈建週期的狀態，以及其接近完成的程度。
  • 如果佈建設定似乎處於狀況不良的狀態，則應用程式將會進入隔離狀態。 若要深入了解隔離狀態，請參閱隔離的應用程式佈建狀態。

更多資源

下一步