教學課程︰設定 Ardoq 來自動佈建使用者

發行項
06/24/2024

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

支援的功能

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

必要條件

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

Microsoft Entra 租用戶
下列其中一個角色：應用程式系統管理員、雲端應用程式管理員或應用程式擁有者。
Ardoq 的系統管理員帳戶。

步驟 1：規劃佈建部署

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

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

佈建是由 Ardoq 中的功能切換負責控制。如果您想要設定 SSO 或已經設定，Ardoq 會自動辨識使用中的 Microsoft Entra ID，且佈建功能會自動啟用。
如果您不想使用 Microsoft Entra ID 搭配 SSO 的佈建功能，請連絡 Ardoq 客戶支援，他們會手動啟用佈建支援。

在繼續之前，我們需要取得租用戶 URL 和祕密權杖，以設定 Microsoft Entra ID 與 Ardoq 之間的安全通訊。

登入 Ardoq 管理員主控台。
在左側功能表中按下設定檔標誌，然後瀏覽至 [組織設定] - [管理組織] - [管理 SCIM 權杖]>>。
按一下 [產生新的]。
複製並儲存 [權杖]。此值會輸入到 Ardoq 應用程式 [佈建] 索引標籤中的 [祕密權杖]。
若要建立您的租用戶 URL，請取代預留位置文字 <YOUR-SUBDOMAIN> 以使用此範本：https://<YOUR-SUBDOMAIN>.ardoq.com/api/scim/v2。此值將會輸入至 Ardoq 應用程式 [佈建] 索引標籤的 [租用戶 URL] 欄位。

注意

<YOUR-SUBDOMAIN> 是貴組織選擇用於存取 Ardoq 的子網域。這是您存取 Ardoq 應用程式時所使用的相同 URL 區段。例如若貴組織在 https://acme.ardoq.com 存取 Ardoq，就會填入 acme。如果您位於美國並在 https://piedpiper.us.ardoq.com 存取 Ardoq，則會填入 piedpiper.us。

步驟 3：從 Microsoft Entra 應用程式資源庫新增 Ardoq

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

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

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

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

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

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

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

以至少雲端應用程式系統管理員的身分登入 Microsoft Entra 系統管理中心。
瀏覽至 [身分識別]>[應用程式]>[企業應用程式]
在應用程式清單中，選取 [Ardoq]。
選取 [佈建] 索引標籤。
將 [佈建模式] 設定為 [自動]。
在 [管理員認證] 區段底下，輸入您的 Ardoq 租用戶 URL 和祕密權杖。按一下 [測試連線]，以確定 Microsoft Entra ID 可以連線至 Ardoq。如果連線失敗，請確定您的 Ardoq 帳戶具有管理員權限並再試一次。
在 [通知電子郵件] 欄位中，輸入應該收到佈建錯誤通知的個人或群組電子郵件地址，然後選取 [發生失敗時傳送電子郵件通知] 核取方塊。
選取 [儲存]。
在 [對應] 區段底下，選取 [將 Microsoft Entra 使用者同步處理至 Ardoq]。
在 [屬性對應] 區段中，檢閱從 Microsoft Entra ID 同步處理至 Ardoq 的使用者屬性。選取為 [比對] 屬性的屬性，會用來比對 Ardoq 中的使用者帳戶以進行更新作業。如果您選擇變更 [比對目標屬性]，則必須確保 Ardoq API 支援根據該屬性來篩選使用者。選取 [儲存] 按鈕以認可所有變更。

屬性類型支援篩選 Ardoq 的必要項目

userName String ✓ ✓

作用中布林值 ✓

displayName String ✓

roles[primary eq "True"].value String ✓
若要設定範圍篩選，請參閱範圍篩選教學課程中提供的下列指示。
若要啟用適用於 Ardoq 的 Microsoft Entra 佈建服務，請在 [設定] 區段中，將 [佈建狀態] 變更為 [開啟]。
在 [設定] 區段的 [範圍] 中選擇需要的值，可定義要佈建到 Ardoq 的使用者。
當您準備好要佈建時，按一下 [儲存]。