教學課程：設定 Oracle Cloud Infrastructure Console 來自動佈建使用者

注意

不支援與 Oracle 雲端基礎結構主控台或 Oracle IDCS 與自訂/BYOA 應用程式整合。 支援使用此教學課程中所述的資源庫應用程式。 資源庫應用程式已經過自訂，可搭配 Oracle SCIM 伺服器使用。

本教學課程描述在 Oracle Cloud Infrastructure Console 與 Microsoft Entra ID 中設定自動使用者佈建所需執行的步驟。 設定時，Microsoft Entra ID 會使用 Microsoft Entra 佈建服務，對 Oracle Cloud Infrastructure Console 自動佈建和取消佈建使用者和群組。 如需此服務的用途、運作方式和常見問題等重要詳細資訊，請參閱 使用 Microsoft Entra ID 自動對 SaaS 應用程式進行使用者佈建和取消佈建。

支援的功能

• 在 Oracle Cloud Infrastructure Console 中建立使用者
• 當使用者不再需要存取權時，將其從 Oracle Cloud Infrastructure Console 中移除
• 讓 Microsoft Entra ID 與 Oracle Cloud Infrastructure Console 之間的使用者屬性保持同步
• 在 Oracle Cloud Infrastructure Console 中佈建群組和群組成員資格
• 對 Oracle Cloud Infrastructure Console 使用單一登入 (建議)

必要條件

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

• Microsoft Entra 租用戶
• 下列其中一個角色：應用程式系統管理員、雲端應用程式管理員或應用程式擁有者。
• Oracle Cloud Infrastructure Console 租用戶。
• Oracle Cloud Infrastructure Console 中具有管理員權限的使用者帳戶。

注意

此整合也可從 Microsoft Entra US Government 雲端環境使用。 您可以在 Microsoft Entra 美國政府雲端應用程式庫中找到此應用程式，並以與公用雲端相同的方式進行設定

步驟 1：規劃佈建部署

1. 了解佈建服務的運作方式 \(部分機器翻譯\)。
2. 判斷誰會在佈建範圍 \(部分機器翻譯\) 內。
3. 決定要在 Microsoft Entra ID 和 Oracle Cloud Infrastructure Console 之間對應的資料。

步驟 2：設定 Oracle Cloud Infrastructure Console 以支援使用 Microsoft Entra ID 進行佈建

1. 登入 Oracle Cloud Infrastructure Console 系統管理入口網站。 在畫面的左上角，瀏覽至 [身分識別]> [同盟]。

   

2. 按一下頁面上 Oracle Identity Cloud Service Console 旁邊顯示的 URL。

   

3. 按一下 [新增識別提供者]，以建立新的識別提供者。 儲存要作為租用戶 URL 一部分使用的 IdP 識別碼。 選取 [應用程式] 索引標籤旁邊的加號圖示以建立 OAuth 用戶端，並授與 IDCS 身分識別網域系統管理員 AppRole。

   

4. 請遵循下列螢幕擷取畫面來設定您的應用程式。 完成設定之後，請選取 [儲存]。

   

   

5. 在應用程式的 [設定] 索引標籤底下，展開 [一般資訊] 選項，以取得用戶端識別碼和用戶端密碼。

   

6. 若要產生祕密權杖，請使用格式用戶端識別碼:用戶端密碼 將用戶端識別碼和用戶端密碼編碼為 Base64。 注意 - 必須在換行停用時產生此值 (base64-w 0)。 儲存祕密權杖。 此值會輸入到 Oracle Cloud Infrastructure Console 應用程式 [佈建] 索引標籤中的 [祕密權杖] 欄位。

步驟 3：從 Microsoft Entra 應用程式資源庫新增 Oracle Cloud Infrastructure Console

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

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

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

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

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

步驟 5：對 Oracle Cloud Infrastructure Console 設定自動使用者佈建

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

若要在 Microsoft Entra ID 中對 Oracle Cloud Infrastructure Console 設定自動使用者佈建：

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

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

   

3. 在應用程式清單中，選取 [Oracle Cloud Infrastructure Console]。

   

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

   

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

   

6. 在 [管理員認證] 區段底下，以 https://<IdP ID>.identity.oraclecloud.com/admin/v1 的格式輸入租用戶 URL。 例如 https://idcs-0bfd023ff2xx4a98a760fa2c31k92b1d.identity.oraclecloud.com/admin/v1 。 輸入稍早在 [祕密權杖] 中所擷取的祕密權杖值。 按一下 [測試連線]，以確保 Microsoft Entra ID 可連線至 Oracle Cloud Infrastructure Console。 如果連線失敗，請確定您的 Oracle Cloud Infrastructure Console 帳戶具有管理員權限，然後再試一次。

   

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

   

8. 選取 [儲存]。

9. 在 [對應] 區段中，選取 [將 Microsoft Entra 使用者同步至 Oracle Cloud Infrastructure Console]。

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

    屬性	類型
    displayName	String
    userName	String
    作用中	布林值
    title	String
    emails[type eq "work"].value	String
    preferredLanguage	String
    name.givenName	String
    name.familyName	String
    addresses[type eq "work"].formatted	String
    addresses[type eq "work"].locality	String
    addresses[type eq "work"].region	String
    addresses[type eq "work"].postalCode	String
    addresses[type eq "work"].country	String
    addresses[type eq "work"].streetAddress	String
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:employeeNumber	String
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:department	String
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:costCenter	String
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:division	String
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:manager	參考
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:organization	String
    urn:ietf:params:scim:schemas:oracle:idcs:extension:user:User:bypassNotification	布林值
    urn:ietf:params:scim:schemas:oracle:idcs:extension:user:User:isFederatedUser	布林值

    注意

    Oracle Cloud Infrastructure Console 的 SCIM 端點要求 addresses[type eq "work"].country 必須採用 ISO 3166-1 "alpha-2" 程式碼格式 (例如 US、UK 等)。 開始佈建之前，請進行檢查，確定所有使用者都以期望格式設定各自的「國家或地區」欄位值，否則特定使用者佈建將會失敗。

    注意

    此格式的自訂擴充屬性中，僅支援擴充屬性 "urn:ietf:params:scim:schemas:oracle:idcs:extension:user:User:bypassNotification" 和 "urn:ietf:params:scim:schemas:oracle:idcs:extension:user:User:isFederatedUser"。 其他擴充屬性應遵循以下格式：urn:ietf:params:scim:schemas:extension:CustomExtensionName:2.0:User:CustomAttribute。

11. 在 [對應] 區段中，選取 [將 Microsoft Entra 群組同步至 Oracle Cloud Infrastructure Console]。

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

    屬性	類型
    displayName	String
    externalId	String
    成員	參考

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

14. 若要對 Oracle Cloud Infrastructure Console 啟用 Microsoft Entra 佈建服務，請在 [設定] 區段中，將 [佈建狀態] 變更為 [開啟]。

    

15. 透過在 [設定] 區段的 [範圍] 中選擇需要的值，可定義要佈建到 Oracle Cloud Infrastructure Console 的使用者和/或群組。

    

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

    

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

步驟 6：監視您的部署

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

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

變更記錄檔

2023 年 8 月 15 日 - 該應用程式已新增至 Gov Cloud。

更多資源

• 管理企業應用程式的使用者帳戶佈建
• 什麼是搭配 Microsoft Entra ID 的應用程式存取和單一登入？

下一步

• 瞭解如何針對佈建活動檢閱記錄和取得報告