共用方式為

教學課程：設定 O'Reilly 學習平台來自動佈建使用者

  • 發行項

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

支援的功能

  • 在 O'Reilly 學習平台建立使用者。
  • 將再也不需要存取權的使用者從 O'Reilly 學習平台中移除。
  • 讓使用者屬性在 Microsoft Entra ID 與 O'Reilly 學習平台之間保持同步。
  • 單一登入至 O'Reilly 學習平台 (建議)。

必要條件

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

步驟 1：規劃佈建部署

步驟 2：設定 O'Reilly 學習平台以支援使用 Microsoft Entra ID 進行佈建

在開始設定 O'Reilly 學習平台以支援使用 Microsoft Entra ID 進行佈建之前，您必須在 O'Reilly 學習平台管理員主控台內產生 SCIM API 權杖。

  1. 登入您的 O'Reilly 帳戶，以瀏覽至 [O’Reilly 管理員主控台]。
  2. 登入之後請按下瀏覽版面配置頂端的 [系統管理員]，然後選擇 [整合]。
  3. 向下捲動至 [API 權杖] 區段。 在 [API 權杖] 之下按一下 [建立權杖]，然後選擇 [SCIM API]。 然後為您的權杖提供名稱和到期日並按下 [繼續]。 您會在快顯訊息中收到 API 金鑰，提示您將其複本儲存在安全的地方。 儲存金鑰複本之後，請按下核取方塊並按下 [繼續]。
  4. 您將使用步驟 5 中的 O’Reilly SCIM API 權杖。

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

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

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

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

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

步驟 5：設定自動將使用者佈建到 O'Reilly 學習平台

本節將引導您逐步設定 Microsoft Entra 佈建服務，以根據 Microsoft Entra ID 中的使用者指派，在 O'Reilly 學習平台中建立、更新和停用使用者。

在 Microsoft Entra ID 中為 O'Reilly 學習平台設定自動使用者佈建：

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

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

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

  3. 在應用程式清單中，選取 [O'Reilly 學習平台]。

    應用程式清單中 O'Reilly 學習平台連結的螢幕擷取畫面。

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

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

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

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

  6. 在 [系統管理員認證] 區段下方輸入 O'Reilly 學習平台租用戶 URL (也就是 https://api.oreilly.com/api/scim/v2)，以及在步驟 2 產生的秘密權杖。 按一下 [測試連線] 以確保 Microsoft Entra ID 可以連線到 O'Reilly 學習平台。 如果連線失敗，請再次檢查您的權杖是否正確，或連絡 O'Reilly 平台整合小組尋求協助。

    權杖的螢幕擷取畫面。

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

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

  8. 選取 [儲存]。

  9. 在 [對應] 區段底下，選取 [將 Microsoft Entra 使用者同步至 O'Reilly 學習平台]。

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

    屬性 類型 支援篩選 O'Reilly 學習平台必要項目
    userName String ✓ ✓
    作用中 布林值
    emails[type eq "work"].value String ✓
    name.givenName String ✓
    name.familyName String ✓
    externalId String ✓

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

  12. 如要啟用 O'Reilly 學習平台的 Microsoft Entra 佈建服務，請在 [設定] 區段中，將 [佈建狀態] 變更為 [開啟]。

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

  13. 在 [設定] 區段的 [範圍] 中選擇需要的值，來定義要佈建至 O'Reilly 學習平台的使用者。

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

  14. 當您準備好要佈建時，按一下 [儲存]。

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

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

步驟 6：監視您的部署

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

  • 使用佈建記錄來判斷哪些使用者已佈建成功或失敗
  • 檢查進度列來查看佈建週期的狀態，以及其接近完成的程度
  • 如果佈建設定似乎處於狀況不良的狀態，則應用程式將會進入隔離狀態。 在此 \(部分機器翻譯\) 深入了解隔離狀態。

更多資源

下一步