Loading
Producten
AI Platform
MOGELIJKHEDEN
Type bedrijf
Teams
Sectoren
Use cases
LEREN
ONDERSTEUNING
DIENSTEN
Helpcentrum
search-icon

Onderwerpen

Geen artikelen gevonden voor dit onderwerp.

Gebruikers instellen en verwijderen met SCIM

In dit artikel

Wie kan deze functie gebruiken?
EnterpriseEnterprise+legacy Enterprise

Ga naar onze pagina met prijzen voor meer informatie.

Opmerking iconOpmerking

Alle attribuutgegevens die via SCIM naar Asana zijn gesynchroniseerd, zijn beschikbaar voor alle downstream Asana-functies, inclusief AI-functies zoals Asana-intelligentie (Dash). Als je niet wilt dat een specifiek attribuut in deze functies wordt weergegeven, verwijder of ontkoppel het dan uit je SCIM-configuratie in je identiteitsprovider, zoals Okta of Microsoft Entra ID, voordat het met Asana wordt gesynchroniseerd.

Een Asana-serviceaccount instellen voor SCIM

Elke SCIM-integratie — ongeacht de identiteitsprovider — authenticeert met behulp van een Asana Service Account-token. Stel dit één keer in voordat je één van de onderstaande IdP-specifieke stappen volgt.

  1. Log in op Asana met een beheerdersaccount en open de Beheerdersconsole via je profielfoto in de bovenste balk.
  2. Ga naar het tabblad Apps en selecteer vervolgens Serviceaccounts.
  3. Selecteer Serviceaccount toevoegen.
  4. Selecteer onder Toestemmingsbereiken de optie Bereiktoestemmingen en schakel Gebruikers instellen (SCIM) in. Als je niet wilt dat je identiteitsprovider Asana-teams maakt, hernoemt of wijzigt, laat je de teamgerelateerde scopes uitgeschakeld.
  5. Sla je wijzigingen op en kopieer het gegenereerde API-token. Je plakt dit in de SCIM-configuratie van je identiteitsprovider in de onderstaande stappen.
Opmerking iconOpmerking

Houd dit token veilig. Iedereen met het token kan leden in je organisatie toevoegen en verwijderen.

 

Okta

Functies

Superbeheerders kunnen gemakkelijk gebruikers in Asana instellen en verwijderen vanuit Okta. De integratie is gebaseerd op het SCIM-protocol en ondersteunt:

  • Leden aanmaken: leden die in Okta aan de Asana-app zijn toegewezen, worden automatisch aan je Asana-organisatie toegevoegd.
  • Profielattributen bijwerken: attributen zoals naam, titel en afdeling worden gesynchroniseerd van het Okta-profiel van een lid naar Asana.
  • Leden importeren: leden die in Asana zijn aangemaakt, kunnen in Okta worden geïmporteerd, hetzij gematcht tegen bestaande Okta-gebruikers, hetzij aangemaakt als nieuwe gebruikers.
  • Groepen importeren: Asana-teams kunnen als Okta-groepen geïmporteerd worden. Met Okta kun je het lidmaatschap van geïmporteerde groepen niet beheren.
  • Groepen pushen: Okta-groepen en hun leden kunnen als teams en teamleden naar Asana gepusht worden.
  • Groepen koppelen: Bestaande Asana-teams kunnen gekoppeld worden aan Okta-groepen, nadat de teams uit Asana geïmporteerd zijn.
  • Leden deactiveren: leden worden in Asana gedeactiveerd (verwijderd) als ze niet meer aan de Okta-app zijn toegewezen.

Momenteel niet ondersteund: leden opnieuw activeren en Asana-teams verwijderen uit Okta.

Vereisten

  • Je bent een superbeheerder voor een organisatie in Asana op het Enterprise-, Enterprise+- of Legacy Enterprise-niveau. [VERIFIËER vóór publicatie — één interne bron vermeldt dit als 'beheerder' alleen op het 'Enterprise-niveau', in plaats van superbeheerder op alle drie de niveaus. Bevestig de juiste vereiste bij engineering/ondersteuning; zie Open vraag #5 in het reorganisatievoorstel.]
  • Je hebt een Okta-abonnement dat het instellen van Lifecycle Management ondersteunt.
  • Je hebt hierboven 'Een Asana-serviceaccount voor SCIM instellen' voltooid.

Lees dit voordat je deactivering inschakelt: het deactiveren van een lid in Okta pauzeert niet alleen hun toegang tot Asana, maar verwijdert ook hun account in Asana, net zoals het verwijderen van hen uit de Asana-gebruikersinterface. Er is geen aparte status 'gedeactiveerd maar herstelbaar'. Evenzo zal het overschrijven van de gebruikersnaam van een lid op het niveau van de applicatie in Okta het Asana-account dat gekoppeld is aan hun vorige gebruikersnaam verwijderen, als dat account actief was. Houd beide in gedachten voordat je Gebruikers uitschakelen inschakelt in stap 3 hieronder of een overschrijving van de gebruikersnaam toepast.

Stappen

Stap 1: Voeg de Okta-integratieapp van Asana toe aan je Okta-account

Log in op Okta en voeg de integratieapp van Asana toe aan je organisatie vanuit de app-integratiecatalogus onder Applicaties.

asana okta integration
asana okta integration2
Asana toevoegen:
  1. Klik op Samenwerking en productiviteit
  2. Klik op Asana

add asana


Stap 2: Verbind je Asana-account met je Okta-account

In Asana: genereer een Service Account-token zoals hierboven beschreven en kopieer het.

In Okta:

  1. Open onder Applicaties de Asana-applicatie en klik op het tabblad Instellen.
  2. Klik onder Instellingen op Integratie en vervolgens op API-integratie configureren.
  3. Vink API-integratie inschakelen aan, plak je serviceaccount-token in het veld API-token en klik op API-inloggegevens testen om de verbinding te bevestigen.
  4. Klik op Opslaan.

Stap 3: Stel instelopties in voor Asana in Okta

  1. Klik op het tabblad Instellen van de Asana-app op Naar app en vervolgens op Bewerken.
  2. Schakel de instelopties in die je wilt. We raden je aan Gebruikers aanmaken, Gebruikersattributen bijwerken en Gebruikers uitschakelen in te schakelen.
  3. Klik op Opslaan.
  4. Gebruik het tabblad Importeren om de in Asana gedetecteerde leden in overeenstemming te brengen met je Okta-directory, en het tabblad Toewijzingen om te beheren wie er is ingericht — toegewezen leden blijven voortaan automatisch gesynchroniseerd met je Asana-ledenlijst.

 

okta provisioning options
Om instelopties in te stellen:
  1. Klik in de Zijbalk Instellingen op Naar app
  2. Klik op Bewerken rechts bovenaan
  3. Schakel de opties voor gebruikers in te stellen voor de Asana-app in en klik op Opslaan om de integratie-instellingen toe te passen
Opmerking iconOpmerking
We raden je aan Gebruikers aanmaken, Gebruikersattributen bijwerken en Gebruikers uitschakelen in te schakelen.
import tab


assignments tab

Stap 4: Wijs ingestelde gebruikers toe aan teams in Asana

Je kunt nieuwe Okta-groepen als teams naar Asana pushen of Okta-groepen koppelen aan bestaande Asana-teams.

  1. Klik in de Asana-app in Okta op App-groepen verversen om recente wijzigingen uit Asana op te halen.
  2. Ga naar het tabblad Groepen pushen en zoek de groep op naam.
  3. Kies in de overeenkomende resultaten Groep koppelen om toe te wijzen aan een bestaand Asana-team, of Groep maken om een nieuw team te maken.
  4. Klik op Opslaan.

Het verwijderen van een team in Asana wordt niet ondersteund vanuit Okta. Gebruik in plaats daarvan het tabblad Teams in de Asana-beheerdersconsole.

 
push groups

    Stap 5: Attribuuttoewijzingen voor Asana configureren

    Kies op het tabblad Instellen van de Asana-app, onder Asana-attribuuttoewijzingen, Maken of Maken en bijwerken voor elk attribuut dat je wilt synchroniseren. Ondersteunde attributen:

    Attribuut

    Type

    Opmerkingen

    Gebruikersnaam

    Tekenreeks

    Vereist. Moet een uniek e-mailadres zijn dat overeenkomt met het domein van je Asana-organisatie.

    name.formatted

    Tekenreeks

    De volledige naam van het lid. Gebruik dit — name.givenName en name.familyName worden niet afzonderlijk ondersteund. Als formatted niet overeenkomt met wat is ingesteld voor voor-/achternaam, heeft formatted voorrang en kan het die velden zonder melding overschrijven.

    emails.value

    String

    E-mailadres van het lid.

    emails.primary

    Boolean

    Markeert het primaire e-mailadres. Er mag slechts één e-mail als primair worden gemarkeerd.

    titel

    Tekenreeks

    De functietitel van het lid.

    afdeling

    Tekenreeks

    De afdeling van het lid.

    preferredLanguage

    Tekenreeks

    Alleen toegepast wanneer het lid voor het eerst wordt aangemaakt. Latere updates van dit veld in Okta worden niet gereflecteerd voor bestaande leden.

    actief

    Boolean

    Of het account van het lid actief is in Asana.

    Als je wilt stoppen met het synchroniseren van een specifiek attribuut, verwijder het dan of maak de toewijzing ervan ongedaan in Okta — Asana biedt geen aparte optie om het uit te sluiten. Als je een toewijzing verwijdert, worden toekomstige synchronisaties gestopt; gegevens die al zijn gesynchroniseerd, worden niet verwijderd.

    Stap 6: Een bestaande Asana-Okta-integratie bijwerken

    Om nieuwe attributen of mogelijkheden op te nemen in een integratie die je al hebt draaien:

    1. Klik op de Integratie-pagina onder Instellen op Bewerken.
    2. Schakel API-integratie inschakelen uit en klik op opslaan.
    3. Klik opnieuw op Bewerken, vink opnieuw API-integratie inschakelen aan, voer uw API-token opnieuw in en klik op Opslaan.
    4. Schakel de instelfuncties die je wenst opnieuw in.
    update integration

      Andere dingen om te weten

      • Emoji's in namen zullen imports verstoren. Okta ondersteunt alleen tekens die gecodeerd zijn met 3 bytes of minder, dus leden- of groepsnamen die emoji bevatten, kunnen niet worden geïmporteerd.
      • De e-mailadressen van ingerichte leden moeten overeenkomen met het domein van je Asana-organisatie. Gasten worden nog steeds alleen ingesteld en beheerd via het tabblad Leden van de Beheerdersconsole.
      • Bekijk de waarschuwing over deactivering en overschrijving van gebruikersnamen hierboven als je deze sectie hebt overgeslagen — deze is van toepassing, ongeacht wanneer je die instellingen hebt ingeschakeld.

      Microsoft Entra ID

      Asana's Microsoft Entra ID-integratie wordt voornamelijk geconfigureerd via Microsofts eigen insteltutorial, omdat de installatie volledig in het Entra-beheercentrum plaatsvindt. Voltooi eerst deze Asana-specifieke stappen en volg vervolgens de stapsgewijze instructies van Microsoft voor de configuratie aan de Entra-kant.

      Vereisten

      • Een Asana-organisatie met een Enterprise-abonnement of beter, met een ledenaccount met beheerderstoestemmingen.
      • Een Microsoft Entra-account met de rol van applicatiebeheerder, cloudapplicatiebeheerder of applicatie-eigenaar.
      • Je hebt hierboven Een Asana-serviceaccount instellen voor SCIM voltooid en je token klaar.

      Stappen

      1. Voeg Asana toe uit de Microsoft Entra-applicatiegalerij (een aparte app van elke bestaande SSO-integratie wordt aanbevolen tijdens het testen).
      2. Volg de tutorial van Microsoft: Asana configureren voor automatisch instellen van gebruikers met Microsoft Entra ID om:
        • Voer je Asana-tenant-URL en het Serviceaccount-token dat je hierboven hebt gegenereerd in onder Instellen > Tenant-URL en test de verbinding.
        • Definieer wie binnen de scope valt voor het instellen (op basis van toewijzing of op basis van een attribuutgebaseerd scopefilter).
        • Attribuuttoewijzingen voor gebruikers en groepen te herzien en te bevestigen.
        • Begin met het instellen en monitor de status via de instellingslogboeken van Microsoft.

      Omdat deze configuratie plaatsvindt in het Entra-beheercentrum, raadpleeg je de tutorial van Microsoft voor actuele schermafbeeldingen en navigatie. De bovenstaande vereisten van Asana voor attribuuttoewijzing en serviceaccounts blijven hetzelfde, ongeacht de wijzigingen in de gebruikersinterface van Microsoft.

      Google Werkruimte

      Als je Google Workspace als je identiteitsprovider gebruikt en SCIM met Asana wilt instellen, neem dan contact op met je accountmanager of Asana-ondersteuning voor de huidige instructies voor het instellen.

      OneLogin

      De OneLogin-integratie van Asana wordt rechtstreeks in OneLogin geconfigureerd. Volg de installatiehandleiding van OneLogin voor SCIM-instelling voor Asana voor stapsgewijze instructies.

      Als je SCIM configureert met een identiteitsprovider die niet native geïntegreerd is met Asana, raadpleeg dan de ontwikkelaarsdocumentatie van Asana over ondersteunde SCIM-attributen voor de volledige lijst met geaccepteerde attributen.

      Aanpassing SCIM-verwijdering

      Wanneer een lid uit Asana wordt verwijderd via SCIM of de API met behulp van een Service Account-token, maakt Asana automatisch een project 'Eerder toegewezen taken' aan met hun openbare taken. Je kunt configureren wie de eigenaar is van dat project:

      1. Ga in de Beheerdersconsole naar het tabblad Beveiliging en open Instellingen voor het verwijderen van leden.
      2. Schakel de instelling in om een superbeheerder (of alle superbeheerders) toe te wijzen als de eigenaar van het project 'Eerder toegewezen taken'.
      3. Kies optioneel of je voltooide taken wilt opnemen.

      Deze aanpassing is alleen van toepassing wanneer een lid wordt verwijderd via SCIM of de API met een Service Account-token — niet wanneer het handmatig wordt verwijderd via de Asana-UI. Ga voor meer informatie over wat er gebeurt wanneer een lid wordt verwijderd naar Gebruikers verwijderen.

      Note iconOpmerking

      Dit artikel is vertaald met AI.

      Feedback over de vertaling versturen.

      Gerelateerde artikelen

      Wordt geladen
      Asana SCIM: gebruikers instellen automatiseren | Helpcentrum