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

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

支援的功能

必要條件

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

• Microsoft Entra 租用戶
• 已啟用 Enterprise 方案或更好方案的 Asana 租用戶
• Asana 中具有管理員權限的使用者帳戶

步驟 1：規劃佈建部署

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

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

在 Asana 中產生服務帳戶權杖

1. 使用系統管理員帳戶登入 Asana。

2. 從頂端列選取設定檔相片，然後選取 [管理主控台]。

3. 從管理主控台選取 [應用程式] 索引標籤。

4. 選取服務帳戶。

5. 選取 [新增服務帳戶]，然後執行下列步驟。

   

   1. 視需要更新 [名稱] 和 [描述]。
   2. 在 [權限範圍] 區段下，選取 [Scoped permissions] \(有限範圍權限\) 和 [使用者佈建 (SCIM)]。 請確認已選取下列權限範圍：
      • 使用者：讀取
      • 使用者：建立及修改
      • 小組：讀取
      • 小組：建立及修改
   3. 選取儲存變更。

6. 複製權杖。

步驟 3：從 Microsoft Entra 應用程式庫新增 Asana

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

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

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

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

• 如果需要其他角色，您可以更新應用程式資訊清單 (部分機器翻譯) 以新增角色。

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

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

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

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

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

   

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

   

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

   

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

   

6. 在 [管理員認證] 區段下，輸入您的 Asana 租用戶 URL 和 Asana 所提供的祕密權杖。 按一下 [測試連線]，確定 Microsoft Entra ID 可以連線至 Asana。 如果連線失敗，請連絡 Asana 來檢查您的帳戶設定。

   

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

   

8. 選取 [儲存]。

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

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

    屬性	類型	支援篩選	Asana 所需條件
    userName	String	✓	✓
    作用中	布林值
    name.formatted	String
    title	String
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:department	String
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:manager	參考
    addresses[type eq "work"].country	String
    addresses[type eq "work"].region	String
    addresses[type eq "work"].locality	String
    phoneNumbers[type eq "work"].value	String
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:employeeNumber	String
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:costCenter	String
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:organization	String
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:division	String

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

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

    屬性	類型	支援篩選	Asana 所需條件
    displayName	String	✓	✓
    成員	參考

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

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

    

15. 藉由在 [設定] 區段的 [範圍] 中選擇適當的值，即可定義要佈建到 Asana 的使用者及群組。

    

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

    

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

步驟 6：監視您的部署

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

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

變更記錄檔

• 11/06/2021-已捨棄對 externalId、name.givenName 和 name.familyName 的支援。 新增對 preferredLanguage、title 和 urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:departmen 的支援。 啟用群組佈建。
• 05/23/2023 - 已停止對 preferredLanguage 的支援。已新增對 urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:manager 的支援。
• 09/07/2023 - 已新增對 addresses[type eq "work"].locality、addresses[type eq "work"].region、addresses[type eq "work"].country、phoneNumbers[type eq "work"].value、urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:employeeNumber、urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:costCenter、urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:organization 和 urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:division 的支援。

更多資源

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

下一步

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