Sdílet prostřednictvím


Kurz: Konfigurace Asana pro automatické zřizování uživatelů

Tento kurz popisuje kroky, které potřebujete udělat v Asana i v Microsoft Entra ID ke konfiguraci automatického zřizování uživatelů. Při konfiguraci microsoft Entra ID automaticky zřídí a zruší zřízení uživatelů a skupin do Asana pomocí služby Microsoft Entra provisioning. Důležité podrobnosti o tom, co tato služba dělá, jak funguje, a nejčastější dotazy najdete v tématu Automatizace zřizování a rušení zřizování uživatelů pro aplikace SaaS pomocí Microsoft Entra ID.

Podporované funkce

  • Vytvářejte uživatele v Asaně.
  • Odeberte uživatele v Asaně, pokud už nevyžadují přístup.
  • Udržovat atributy uživatele synchronizované mezi Microsoft Entra ID a Asana.
  • Zřiďte skupiny a členství ve skupinách v Asana.
  • Jednotné přihlašování k Asana (doporučeno).

Požadavky

Scénář popsaný v tomto kurzu předpokládá, že už máte následující požadavky:

  • Tenant Microsoft Entra
  • Tenant Asana s plánem Enterprise nebo s lepším povolením
  • Uživatelský účet v Asana s oprávněními správce

Poznámka:

Integrace zřizování Microsoft Entra spoléhá na rozhraní API Asana, které je dostupné pro Asana.

Krok 1: Plánování nasazení zřizování

  1. Seznamte se s fungováním služby zřizování.
  2. Zjistěte, kdo bude v rozsahu zřizování.
  3. Určete, jaká data se mají mapovat mezi ID Microsoft Entra a Asana.

Krok 2: Konfigurace Asana pro podporu zřizování pomocí Microsoft Entra ID

Tip

Pokud chcete pro Asana povolit jednotné přihlašování založené na SAML, postupujte podle uvedených pokynů. Jednotné přihlašování je možné nakonfigurovat nezávisle na automatickém zřizování, i když se tyto dvě funkce vzájemně doplňují.

Generování tokenu účtu služby v Asaně

  1. Přihlaste se k Asana pomocí svého účtu správce.

  2. V horním panelu vyberte profilovou fotku a vyberte Správa Konzola.

  3. V konzole pro správu vyberte kartu Aplikace.

  4. Vyberte Účty služeb.

  5. Vyberte Přidat účet služby a proveďte následující kroky.

    Screenshot of Service Account Token.

    1. Podle potřeby aktualizujte název a popis .
    2. V části Obory oprávnění vyberte Vymezená oprávnění a Zřizování uživatelů (SCIM). Ujistěte se, že jsou vybrané následující obory oprávnění:
      • Uživatelé: Číst
      • Uživatelé: Vytvoření a úprava
      • Teams: Čtení
      • Teams: Vytvoření a úprava
    3. Vyberte volbu Uložit změny.
  6. Zkopírujte token.

Přidejte Asana z galerie aplikací Microsoft Entra a začněte spravovat zřizování pro Asana. Pokud jste dříve nastavili Asana pro jednotné přihlašování, můžete použít stejnou aplikaci. Při počátečním testování integrace se ale doporučuje vytvořit samostatnou aplikaci. Další informace o přidání aplikace z galerie najdete tady.

Krok 4: Definujte, kdo bude v oboru zřizování

Služba zřizování Microsoft Entra umožňuje určit rozsah, který bude zřízen na základě přiřazení k aplikaci nebo na základě atributů uživatele nebo skupiny. Pokud se rozhodnete nastavit rozsah uživatelů, kteří se zřídí pro vaši aplikaci, na základě přiřazení, můžete k aplikaci přiřadit uživatele a skupiny pomocí následujících kroků. Pokud se rozhodnete nastavit rozsah uživatelů, kteří se zřídí, pouze na základě atributů jednotlivých uživatelů nebo skupin, můžete použít filtr rozsahu, jak je popsáno tady.

  • Začněte v malém. Než se pustíte do zavádění pro všechny, proveďte testování s malou skupinou uživatelů a skupin. Pokud je rozsah zřizování nastavený na přiřazené uživatele a skupiny, můžete testování provést tak, že k aplikaci přiřadíte jednoho nebo dva uživatele nebo skupiny. Pokud je rozsah nastavený na všechny uživatele a skupiny, můžete určit filtr rozsahu na základě atributů.

  • Pokud potřebujete další role, můžete aktualizovat manifest aplikace a přidat nové role.

Krok 5: Konfigurace automatického zřizování uživatelů pro Asana

Tato část vás provede postupem konfigurace služby zřizování Microsoft Entra tak, aby vytvářela, aktualizovala a zakázala uživatele a skupiny v Asana na základě přiřazení uživatelů a skupin v Microsoft Entra ID.

Konfigurace automatického zřizování uživatelů pro Asana v Microsoft Entra ID:

  1. Přihlaste se do Centra pro správu Microsoft Entra jako alespoň cloudová aplikace Správa istrator.

  2. Přejděte k podnikovým aplikacím identit>>

    Screenshot of Enterprise applications blade.

  3. V seznamu aplikací vyberte Asana.

    Screenshot of the Asana link in the Applications list.

  4. Vyberte kartu Zřizování.

    Screenshot of Provisioning tab.

  5. Nastavte Režim zřizování na hodnotu Automaticky.

    Screenshot of Provisioning tab automatic.

  6. V části Správa Přihlašovací údaje zadejte adresu URL tenanta Asana a token tajného klíče, které poskytuje Asana. Klikněte na test Připojení ion a ujistěte se, že se Microsoft Entra ID může připojit k Asana. Pokud připojení selže, obraťte se na Asana a zkontrolujte nastavení účtu.

    Screenshot of token.

  7. Do pole Oznamovací e-mail zadejte e-mailovou adresu osoby nebo skupiny, na kterou by se měla odesílat oznámení o chybách zřizování, a zaškrtněte políčko Když dojde k selhání, poslat oznámení e-mailem.

    Screenshot of notification email.

  8. Zvolte Uložit.

  9. V části Mapování vyberte Synchronizovat uživatele Microsoft Entra do Asana.

  10. Zkontrolujte atributy uživatele, které jsou synchronizovány z Microsoft Entra ID do Asana v části Mapování atributů. Atributy vybrané jako odpovídající vlastnosti se používají ke shodě uživatelských účtů v Asana pro operace aktualizace. Pokud se rozhodnete změnit odpovídající cílový atribut, musíte zajistit, aby rozhraní API Asana podporovalo filtrování uživatelů na základě daného atributu. Výběrem tlačítka Uložit potvrďte všechny změny.

    Atribut Typ Podporováno pro filtrování Vyžaduje asana
    userName String
    active Logická hodnota
    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 Reference
    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. V části Mapování vyberte Synchronizovat skupiny Microsoft Entra do Asana.

  12. V části Mapování atributů zkontrolujte atributy skupiny, které jsou synchronizovány z ID Microsoft Entra do Asana. Atributy vybrané jako odpovídající vlastnosti slouží ke shodě skupin v Asana pro operace aktualizace. Výběrem tlačítka Uložit potvrďte všechny změny.

    Atribut Typ Podporováno pro filtrování Vyžaduje asana
    displayName String
    členové Reference
  13. Pokud chcete nakonfigurovat filtry rozsahu, postupujte podle pokynů uvedených v kurzu k filtrům rozsahu.

  14. Pokud chcete povolit službu zřizování Microsoft Entra pro Asana, změňte stav zřizování na Zapnuto v části Nastavení.

    Screenshot of Provisioning status toggled on.

  15. Definujte uživatele a skupiny, které chcete zřídit pro Asana, výběrem odpovídajících hodnot v oboru v části Nastavení.

    Screenshot of Provisioning scope.

  16. Až budete připravení zřídit, klikněte na Uložit.

    Screenshot of Saving provisioning configuration.

Tato operace zahájí cyklus počáteční synchronizace všech uživatelů a skupin definovaných v nabídce Rozsah v části Nastavení. Počáteční cyklus trvá déle než další cykly, ke kterým dochází přibližně každých 40 minut, pokud je spuštěná služba zřizování Microsoft Entra.

Krok 6: Monitorování nasazení

Po dokončení konfigurace zřizování můžete své nasazení monitorovat pomocí následujících prostředků:

  • S využitím protokolů zřizování můžete zjistit, kteří uživatelé se zřídili úspěšně a kteří neúspěšně.
  • Zkontrolujte indikátor průběhu a podívejte se na stav cyklu zřizování a jeho zavření.
  • Pokud se zdá, že konfigurace zřizování je v pořádku, aplikace přejde do karantény. Další informace o stavech karantény najdete tady.

Protokol změn

  • 11/06/2021 - Vyřazená podpora pro externalId, name.givenName a name.familyName. Přidání podpory pro preferredLanguage , title a urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:department. Povolené zřizování skupin
  • 05/23/2023 - Vyřazená podpora pro preferredLanguage Added podpora pro urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:manager.
  • 09/07/2023 - Přidání podpory pro adresy[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 and urn: ietf:params:scim:schemas:extension:enterprise:2.0:User:division.

Další materiály

Další kroky