分享方式：

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

  • 文章

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

支援的功能

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

必要條件

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

步驟 1：規劃佈建部署

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

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

  1. 瀏覽至 Atlassian 管理主控台。 如果您有一個以上的組織，請選取您的組織。

  2. 選取 [安全性] > [識別提供者]

  3. 選取您的識別提供者目錄。

  4. 選取 [設定使用者佈建]。

  5. 複製 [SCIM 基底 URL] 和 [API 金鑰] 的值。 當您設定 Azure 時，您將需要用到。

  6. 儲存 [SCIM 組態]。

    注意

    請確定您將這些值儲存在安全的位置，因為我們不會再向您顯示這些值。

    使用者和群組會自動佈建到您的組織。 如需使用者和群組如何同步至組織的詳細資訊，請參閱使用者佈建頁面。

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

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

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

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

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

步驟 5：對 Atlassian Cloud 設定自動使用者佈建

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

若要在 Microsoft Entra ID 中設定自動佈建使用者至 Atlassian Cloud：

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

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

    企業應用程式刀鋒視窗

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

    應用程式清單中的 [Atlassian Cloud] 連結

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

    [管理] 選項的螢幕擷取畫面，並已指出 [佈建] 選項。

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

    [佈建模式] 下拉式清單的螢幕擷取畫面，並已指出 [自動] 選項。

  6. 在 [管理員認證] 區段底下，輸入先前從 Atlassian Cloud 的帳戶擷取的 [租用戶 URL] 和 [秘密權杖]。 按一下 [測試連線]，以確定 Microsoft Entra ID 可以連線至 Atlassian Cloud。 如果連線失敗，請確定您的 Atlassian Cloud 帳戶具有管理員權限，然後再試一次。

    租用戶 URL + 權杖

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

    通知電子郵件

  8. 按一下 [檔案] 。

  9. 在 [對應] 區段底下，選取 [將 Microsoft Entra 使用者同步處理至 Atlassian Cloud]。

  10. 在 [屬性對應] 區段中，檢閱從 Microsoft Entra ID 同步至 Atlassian Cloud 的使用者屬性。 電子郵件屬性將用來比對 Atlassian Cloud 帳戶與您的 Microsoft Entra 帳戶。 選取 [儲存] 按鈕以認可所有變更。

    屬性 類型
    userName String
    作用中 布林值
    name.familyName String
    name.givenName String
    emails[type eq "work"].value String

  11. 在 [對應] 區段底下，選取 [將 Microsoft Entra 群組同步處理至 Atlassian Cloud]。

  12. 在 [屬性對應] 區段中，檢閱從 Microsoft Entra ID 同步至 Atlassian Cloud 的群組屬性。 顯示名稱屬性將用來比對 Atlassian Cloud 群組與您的 Microsoft Entra 群組。 選取 [儲存] 按鈕以認可所有變更。

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

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

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

    佈建狀態已切換為開啟

  15. 在 [設定] 區段的 [範圍] 中選擇所需的值，以定義要佈建至 Atlassian Cloud 的使用者和/或群組。

    佈建範圍

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

    儲存雲端佈建設定

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

步驟 6：監視您的部署

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

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

連接器限制

  • Atlassian Cloud 僅支援為具有已驗證網域的使用者佈建更新。 透過未驗證網域對使用者所進行的變更不會推送至 Atlassian Cloud。 在這裡深入了解 Atlassian 驗證的網域。
  • Atlassian Cloud 目前不支援群組重新命名。 這表示在 Microsoft Entra ID 中對群組的 displayName 所做的任何變更，都不會更新並反映在 Atlassian Cloud 中。
  • 只有在使用者具有 Microsoft Exchange 信箱時，才會填入 Microsoft Entra ID 中的 mail 使用者屬性值。 如果使用者沒有該信箱，建議您將不同的所需屬性對應至 Atlassian Cloud 中的 emails 屬性。

變更記錄檔

  • 06/15/2020 - 已新增群組的 Batch PATCH 支援。
  • 04/21/2021 - 已新增結構描述探索的支援。
  • 2022/10/14 - 更新連接器限制。

其他資源

下一步