Asana configureren voor automatische inrichting van gebruikers met Microsoft Entra-id

In dit artikel worden de stappen beschreven die u moet uitvoeren in zowel Asana als Microsoft Entra ID om automatische gebruikersprovisioning te configureren. Wanneer Microsoft Entra ID is ingesteld, worden gebruikers en groepen automatisch ingericht en verwijderd voor Asana- met behulp van de Microsoft Entra-inrichtingsservice. Voor meer informatie over wat deze service doet, hoe deze werkt en veelgestelde vragen, zie Gebruikersprovisionering en -deprovisioning voor SaaS-toepassingen automatiseren met Microsoft Entra ID.

Ondersteunde mogelijkheden

  • Gebruikers maken in Asana.
  • Verwijder gebruikers in Asana wanneer ze geen toegang meer nodig hebben.
  • Gebruikerskenmerken gesynchroniseerd houden tussen Microsoft Entra ID en Asana.
  • Groepen en groepslidmaatschappen inrichten in Asana.
  • eenmalige aanmelding bij Asana (aanbevolen).

Benodigdheden

In het scenario dat in dit artikel wordt beschreven, wordt ervan uitgegaan dat u al beschikt over de volgende vereisten:

  • Een Asana-tenant met een Enterprise-abonnement of hoger.
  • Een gebruikersaccount in Asana met beheerdersmachtigingen

Notitie

Microsoft Entra-inrichtingsintegratie is afhankelijk van de Asana-API-, die beschikbaar is voor Asana.

Stap 1: Plan uw implementatie van voorzieningen

  1. Leer meer over hoe de provisioningdienst werkt.
  2. Bepaal wie binnen de reikwijdte voor voorziening valt.
  3. Bepaal welke gegevens u wilt afstemmen tussen Microsoft Entra ID en Asana.

Stap 2: Asana configureren ter ondersteuning van inrichting met Microsoft Entra-id

Hint

Volg de opgegeven instructies om eenmalige aanmelding op basis van SAML in te schakelen voor Asana. Eenmalige aanmelding kan onafhankelijk van automatische gebruikersinrichting worden geconfigureerd, hoewel deze twee functies elkaar aanvullen.

Serviceaccounttoken genereren in Asana

  1. Meld u aan bij Asana- met behulp van uw beheerdersaccount.

  2. Selecteer de profielfoto in de bovenste balk en selecteer Beheerconsole.

  3. Selecteer het tabblad Apps in de beheerconsole.

  4. Selecteer Serviceaccounts.

  5. Selecteer Serviceaccount toevoegen en voer de volgende stappen uit.

    schermopname van het token voor het serviceaccount.

    1. Werk naam en beschrijving indien nodig bij.
    2. Selecteer in de sectie Machtigingsbereiken de opties Machtigingen met bereik en Gebruikersvoorziening (SCIM). Zorg ervoor dat de volgende machtigingsbereiken zijn geselecteerd:
      • Gebruikers: lezen
      • Gebruikers: Maken en wijzigen
      • Teams: lezen
      • Teams: Maken en wijzigen
    3. Selecteer Wijzigingen opslaan.

  6. Kopieer het token.

Voeg Asana toe vanuit de Microsoft Entra-toepassingsgalerie om te beginnen met het beheren van inrichting voor Asana. Als u Asana eerder hebt ingesteld voor SSO (single sign-on), kunt u dezelfde toepassing gebruiken. Het is echter raadzaam om een afzonderlijke app te maken bij het testen van de integratie in eerste instantie. Klik hier voor meer informatie over het toevoegen van een toepassing uit de galerie.

Stap 4: Bepaal wie binnen de scope van voorzieningen valt.

Met de Microsoft Entra-inrichtingsservice kunt u bepalen wie is ingericht op basis van toewijzing aan de toepassing of op basis van kenmerken van de gebruiker of groep. Als u ervoor kiest om te bepalen wie voor uw app is ingericht op basis van toewijzing, kunt u de stappen gebruiken om gebruikers en groepen toe te wijzen aan de toepassing. Als u ervoor kiest om te bepalen wie alleen is ingericht op basis van kenmerken van de gebruiker of groep, kunt u een bereikfiltergebruiken.

  • Begin klein. Test de toepassing met een kleine set gebruikers en groepen voordat u de toepassing naar iedereen uitrolt. Wanneer het bereik voor inrichting is ingesteld op toegewezen gebruikers en groepen, kunt u dit beheren door een of twee gebruikers of groepen toe te wijzen aan de app. Wanneer het bereik is ingesteld op alle gebruikers en groepen, kunt u een bereikfilter op basis van kenmerken opgeven.

  • Als u extra rollen nodig hebt, kunt u het toepassingsmanifest bijwerken om nieuwe rollen toe te voegen.

Stap 5: Automatische inrichting van gebruikers configureren voor Asana

In deze sectie wordt u begeleid bij de stappen voor het configureren van de Microsoft Entra-inrichtingsservice om gebruikers en groepen in Asana te maken, bij te werken en uit te schakelen op basis van gebruikers- en/of groepstoewijzingen in Microsoft Entra-id.

De automatische gebruikersinrichting configureren voor Asana in Microsoft Entra ID:

  1. Meld u aan bij het Microsoft Entra-beheercentrum als u ten minste een Cloudtoepassingsbeheerder bent.

  2. Navigeer naar Entra ID>Enterprise apps

    Schermopname van het paneel Bedrijfstoepassingen.

  3. Selecteer Asanain de lijst met toepassingen.

    Schermopname van de Asana-koppeling in de lijst met toepassingen.

  4. Selecteer het tabblad Inrichten.

    Schermopname van het tabblad Inrichten.

  5. Selecteer + Nieuwe configuratie.

    Schermopname van het tabblad Inrichten (automatisch).

  6. Voer in het veld Tenant-URL uw Asana-tenant-URL en geheimtoken in dat is opgegeven door Asana. Selecteer Verbinding testen om te controleren of de Microsoft Entra-id verbinding kan maken met Asana. Als de verbinding mislukt, neemt u contact op met Asana om de configuratie van uw account te controleren.

    Schermopname van de voorzieningstestverbinding.

  7. Selecteer Maken om uw configuratie te maken.

  8. Selecteer Eigenschappen op de pagina Overzicht .

  9. Selecteer het potlood om de eigenschappen te bewerken. Schakel e-mailberichten voor meldingen in en geef een e-mailbericht op om quarantaine-e-mailberichten te ontvangen. Preventie van onbedoelde verwijderingen inschakelen. Selecteer Toepassen om de wijzigingen op te slaan.

Schermopname van provisioning-instellingen.

  1. Selecteer Kenmerktoewijzing in het linkerdeelvenster en selecteer gebruikers.

  2. Controleer in de sectie Kenmerktoewijzingen de gebruikerskenmerken die vanuit Microsoft Entra-id met Asana worden gesynchroniseerd. De kenmerken die zijn geselecteerd als overeenkomende eigenschappen, worden gebruikt om de gebruikersaccounts in Asana af te stemmen voor updatebewerkingen. Als u ervoor kiest om het overeenkomende doelkenmerk te wijzigen in, moet u ervoor zorgen dat de Asana-API het filteren van gebruikers op basis van dat kenmerk ondersteunt. Selecteer de knop Opslaan om eventuele wijzigingen door te voeren.

    Kenmerk Typ Ondersteund voor filteren Vereist door Asana
    gebruikersnaam Draad ✓ ✓
    actief Booleaan
    naam.geformatteerd Draad
    titel Draad
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:afdeling Draad
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:beheerder Referentie
    adressen[type eq "werk"].land Draad
    addresses[type eq "werk"].region Draad
    addresses[type eq "werk"].plaats Draad
    telefoonNummers[type gelijk aan "werk"].waarde Draad
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:employeeNumber (werknemernummer) Draad
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:kostenplaats Draad
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:Organization Draad
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:afdeling Draad

  3. Selecteer Groepen.

  4. Controleer in de sectie Kenmerktoewijzingen de groepskenmerken die vanuit Microsoft Entra-id met Asana worden gesynchroniseerd. De kenmerken die als overeenkomende eigenschappen zijn geselecteerd, worden gebruikt om de groepen in Asana af te stemmen voor het uitvoeren van updates. Selecteer de knop Opslaan om eventuele wijzigingen door te voeren.

    Kenmerk Typ Ondersteund voor filteren Vereist door Asana
    weergavenaam Draad ✓ ✓
    leden Referentie

  5. Als u bereikfilters wilt configureren, raadpleegt u de volgende instructies in het artikel over het bereikfilter .

  6. Gebruik inrichting op aanvraag om synchronisatie te valideren met een klein aantal gebruikers voordat u een grotere implementatie in uw organisatie implementeert.

  7. Wanneer u klaar bent om in te richten, selecteert u Inrichten starten op de pagina Overzicht .

Stap 6: Uw implementatie bewaken

Zodra u de inrichting hebt geconfigureerd, gebruikt u de volgende resources om uw implementatie te bewaken:

  1. Gebruik de inrichtingslogboeken om te bepalen welke gebruikers succesvol of onsuccesvol zijn ingericht.
  2. Controleer de voortgangsbalk om de status van de provisioningcyclus te zien en hoe dicht het bij voltooiing is.
  3. Als de inrichtingsconfiguratie een slechte status lijkt te hebben, wordt de toepassing in quarantaine geplaatst. Vind meer informatie over de quarantainestatussen in het artikel over de quarantainestatus van de toepassing.

Wijzigingslogboek

  • 11/06/2021 - Verwijderde ondersteuning voor externalId, name.givenName en name.familyName. Er is ondersteuning toegevoegd voor preferredLanguage, title en urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:department. Groepsvoorziening ingeschakeld.
  • 23-05-2023 - De ondersteuning voor preferredLanguage is vervallen en de ondersteuning voor urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:manageris toegevoegd.
  • 09/07/2023 - Ondersteuning toegevoegd voor 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 en urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:division.

Meer middelen

Verwante inhoud

  • Last updated on