Loading

Argomenti

Provisioning e deprovisioning degli utenti tramite SCIM

Chi può usare questa funzionalità?
EnterpriseEnterprise+Enterprise legacy

Visita la pagina dei prezzi per maggiori informazioni.

Nota iconNota

Tutti i dati degli attributi sincronizzati con Asana tramite SCIM sono disponibili per tutte le funzionalità Asana a valle, comprese le funzionalità di IA come Asana Intelligence (Dash). Se non vuoi che un attributo specifico venga visualizzato in queste funzionalità, rimuovilo o annulla la mappatura dalla configurazione SCIM nel tuo identity provider, come Okta o Microsoft Entra ID, prima che venga sincronizzato con Asana.

Configura un account di servizio Asana per SCIM

Ogni integrazione SCIM, indipendentemente dal provider di identità, esegue l'autenticazione utilizzando un token dell'account di servizio Asana. Esegui questa configurazione una sola volta prima di seguire uno dei passaggi specifici per l'IdP riportati di seguito.

  1. Accedi ad Asana con un account amministratore e apri la Console di amministrazione dalla tua foto profilo nella barra superiore.
  2. Vai alla scheda App, quindi seleziona Account di servizio.
  3. Seleziona Aggiungi account di servizio.
  4. In Ambiti di autorizzazione, seleziona Autorizzazioni con ambito e abilita Provisioning dell'utente (SCIM). Se non desideri che il tuo gestore di identità digitale crei, rinomini o modifichi i team di Asana, non selezionare gli ambiti relativi ai team.
  5. Salva le modifiche e copia il token API generato. Lo incollerai nella configurazione SCIM del tuo gestore di identità digitale seguendo la procedura riportata di seguito.
Nota iconNota

Conserva questo token in modo sicuro. Chiunque disponga del token può effettuare il provisioning e il deprovisioning dei membri della tua organizzazione.

 

Okta

Funzionalità

Gli amministratori avanzati possono effettuare facilmente il provisioning e il deprovisioning degli utenti su Asana da Okta. L'integrazione utilizza il protocollo SCIM e supporta:

  • Creare membri: i membri assegnati all'app di Asana su Okta vengono aggiunti automaticamente alla tua organizzazione Asana.
  • Aggiornare gli attributi del profilo: gli attributi come nome, titolo e reparto vengono sincronizzati dal profilo Okta di un membro su Asana.
  • Importare membri: i membri creati su Asana possono essere importati in Okta utilizzando account utente Okta già esistenti o creandone di nuovi.
  • Importare gruppi: i team di Asana possono essere importati come gruppi di Okta. Okta non ti consente di gestire le adesioni relative ai gruppi importati.
  • Trasferire gruppi: i gruppi di Okta e i relativi membri possono essere trasferiti su Asana come team e membri del team.
  • Collegare gruppi: i team già esistenti su Asana possono essere collegati ai gruppi presenti su Okta dopo l'importazione dei team da Asana.
  • Disattivare i membri: i membri vengono disattivati (eliminati) su Asana se non sono più assegnati all'app su Okta.

Attualmente non supportato: riattivare i membri ed eliminare i team di Asana da Okta.

Requisiti

  • Sei l'amministratore avanzato di un'organizzazione Enterprise, Enterprise+ o Enterprise legacy su Asana. [VERIFICARE prima della pubblicazione: una fonte interna indica “amministratore” solo per il “piano Enterprise”, anziché “amministratore avanzato” per tutti e tre i piani. Conferma il requisito corretto con il team di progettazione/assistenza; vedi la domanda aperta n. 5 nella proposta di riorganizzazione.]
  • Hai un piano Okta che supporta il provisioning di Lifecycle Management.
  • Hai completato la procedura Configura un account di servizio Asana per SCIM sopra indicata.

Prima di abilitare la disattivazione, leggi questo: disattivare un membro su Okta non solo sospende il suo accesso ad Asana, ma elimina il suo account su Asana, come se lo si rimuovesse dall'interfaccia utente di Asana. Non esiste uno stato separato “disattivato ma recuperabile”. Allo stesso modo, la sovrascrittura del nome utente di un membro al livello di applicazione su Okta eliminerà l'account Asana associato al suo nome utente precedente, se tale account era attivo. Tieni a mente entrambi prima di attivare Disattiva utenti nel passaggio 3 qui sotto o di applicare una sovrascrittura del nome utente.

Istruzioni

Passaggio 1: aggiungi l’app di integrazione Okta di Asana al tuo account Okta

Effettua l'accesso a Okta e aggiungi l'app di integrazione di Asana alla tua organizzazione dal Catalogo delle integrazioni delle app in Applicazioni.

asana okta integration
asana okta integration2
Per aggiungere Asana:
  1. Clicca su Collaborazione e produttività.
  2. Clicca su Asana

add asana


Passaggio 2: collega il tuo account Asana al tuo account Okta

Su Asana: genera un token dell'account di servizio come descritto sopra e copialo.

Su Okta:

  1. In Applicazioni, apri l'applicazione Asana e clicca sulla scheda Provisioning.
  2. In Settings (Impostazioni), clicca su Integration (Integrazione) e quindi su Configure API Integration (Configura integrazione API).
  3. Seleziona Attiva integrazione API, incolla il token del tuo account di servizio nel campo Token API e clicca su Verifica credenziali API per confermare il collegamento.
  4. Clicca su Salva.

Passaggio 3: configura le opzioni di provisioning per Asana in Okta

  1. Nella scheda Provisioning dell'app Asana, clicca su Per l'app e poi su Modifica.
  2. Attiva le opzioni di provisioning che desideri. Ti consigliamo di attivare Crea utenti, Aggiorna gli attributi dell'utente e Disattiva utenti.
  3. Clicca su Salva.
  4. Usa la scheda Import (Importazione) per collegare i membri rilevati su Asana con la tua directory Okta e la scheda Assignments (Assegnazioni) per gestire chi viene sottoposto a provisioning: d'ora in poi, i membri assegnati rimarranno automaticamente sincronizzati con il tuo elenco di membri di Asana.

 

okta provisioning options
Come configurare le opzioni di provisioning:
  1. Nella barra laterale Settings (Impostazioni), clicca su To App (Vai all'app).
  2. Clicca su Modifica in alto a destra.
  3. Attiva le opzioni di provisioning dell'utente per l'app di Asana e clicca su Save (Salva) per applicare le impostazioni dell'integrazione.
Nota iconNota
Ti consigliamo di attivare Crea utenti, Aggiorna gli attributi dell'utente e Disattiva utenti.
import tab


assignments tab

Passaggio 4: mappa gli utenti che hanno ricevuto il provisioning ai team su Asana.

Puoi trasferire nuovi gruppi di Okta su Asana come team o collegare gruppi di Okta a team di Asana esistenti.

  1. Nell'app di Asana su Okta, clicca su Aggiorna gruppi dell'app per importare qualsiasi modifica recente da Asana.
  2. Vai alla scheda Push Groups (Trasferisci gruppi) e cerca il gruppo per nome.
  3. Dai risultati della ricerca, scegli Collega gruppo per mappare un gruppo a un team Asana esistente o Crea gruppo per crearne uno nuovo.
  4. Clicca su Salva.

L'eliminazione di un team su Asana non è supportata da Okta. Usa invece la scheda Team nella Console di amministrazione di Asana.

 
push groups

    Passaggio 5: configura le mappature degli attributi di Asana

    Nella scheda Provisioning dell'app di Asana, in Mappature degli attributi di Asana, scegli Crea o Crea e aggiorna per ogni attributo che desideri sincronizzare. Attributi supportati:

    Attributo

    Tipo

    Note

    userName

    Stringa

    Obbligatorio. Deve essere un indirizzo email univoco che corrisponda al dominio della tua organizzazione Asana.

    name.formatted

    Stringa

    Nome e cognome del membro. Usa questo — name.givenName e name.familyName non sono supportati singolarmente. Se il campo formatted non corrisponde a quanto impostato per il nome/cognome, il campo formatted ha la precedenza e può sovrascrivere automaticamente quei campi.

    emails.value

    Stringa

    Indirizzo email del membro.

    emails.primary

    Booleano

    Contrassegna l'email principale. È possibile contrassegnare come principale un solo indirizzo e-mail.

    titolo

    Stringa

    Il titolo professionale del membro.

    reparto

    Stringa

    Il reparto del membro.

    preferredLanguage

    Stringa

    Viene applicato solo quando il membro viene creato per la prima volta. Gli aggiornamenti successivi a questo campo su Okta non verranno visualizzati per i membri già esistenti.

    attivo

    Booleano

    Se l'account del membro è attivo su Asana.

    Se vuoi interrompere la sincronizzazione di un attributo specifico, rimuovilo o annulla la sua mappatura in Okta. Asana non fornisce un controllo di esclusione separato. La rimozione di una mappatura interrompe le sincronizzazioni future; non elimina i dati già sincronizzati.

    Passaggio 6: aggiorna un'integrazione Asana–Okta esistente

    Per aggiungere nuovi attributi o funzionalità a un'integrazione già in uso:

    1. Nella pagina dell'integrazione, in Provisioning, clicca su Modifica.
    2. Deseleziona Enable API Integration e clicca su Save.
    3. Clicca di nuovo su Edit, seleziona nuovamente Enable API Integration, reinserisci il tuo token API e clicca su Save.
    4. Riattiva le funzionalità di provisioning che desideri.
    update integration

      Altre cose da sapere

      • Le emoji nei nomi interromperanno le importazioni. Okta supporta solo caratteri codificati con tre byte o meno, quindi i nomi di membri o gruppi contenenti emoji non potranno essere importati.
      • Le email dei membri di cui è stato eseguito il provisioning devono corrispondere al dominio della tua organizzazione Asana. Il provisioning e la gestione degli ospiti continueranno a essere effettuati esclusivamente tramite la scheda Membri della Console di amministrazione.
      • Se sei passato direttamente a questa Sezione, leggi l'avviso sulla disattivazione e sulla sostituzione del nome utente riportato sopra: si applica indipendentemente da quando hai abilitato queste impostazioni.

      Microsoft Entra ID

      L'integrazione di Asana con Microsoft Entra ID viene configurata principalmente tramite il tutorial di provisioning di Microsoft, poiché la configurazione avviene interamente nell'Entra admin center. Completa prima questi passaggi specifici di Asana, quindi segui la guida di Microsoft per la configurazione lato Entra.

      Requisiti

      • Un'organizzazione Asana con un piano Enterprise o superiore, con un account membro che dispone delle autorizzazioni di amministratore.
      • Un account Microsoft Entra con il ruolo di amministratore dell'applicazione, amministratore dell'applicazione cloud o proprietario dell'applicazione.
      • Hai completato la procedura Configurare un account di servizio Asana per SCIM sopra indicata e hai il tuo token a disposizione.

      Istruzioni

      1. Aggiungi Asana dalla galleria delle applicazioni di Microsoft Entra (durante la fase di test, si consiglia di utilizzare un'app separata da qualsiasi integrazione SSO esistente).
      2. Segui il tutorial di Microsoft: Configura Asana per il provisioning automatico degli utenti con Microsoft Entra ID per:
        • Inserisci l'URL del tuo tenant Asana e il token dell'account di servizio che hai generato sopra in Provisioning > URL del tenant e verifica la connessione.
        • Definisci chi è incluso nell'ambito del provisioning (per assegnazione o per filtro di ambito basato sugli attributi).
        • Verifica e conferma le mappature degli attributi per utenti e gruppi.
        • Avviare il provisioning e monitorare lo stato tramite i registri di provisioning di Microsoft.

      Poiché questa configurazione avviene nel centro di amministrazione di Entra, fai riferimento al tutorial di Microsoft per screenshot e navigazione aggiornati: la mappatura degli attributi di Asana e i requisiti dell'account di servizio di cui sopra rimangono gli stessi, indipendentemente dalle modifiche all'interfaccia utente di Microsoft.

      Google Workspace

      Se utilizzi Google Workspace come provider di identità e desideri configurare il provisioning SCIM con Asana, contatta il tuo account executive o l'assistenza di Asana per ricevere le istruzioni di configurazione aggiornate.

      OneLogin

      L'integrazione di Asana con OneLogin viene configurata direttamente in OneLogin. Segui le istruzioni dettagliate della guida alla configurazione del provisioning SCIM di OneLogin per Asana.

      Se stai configurando SCIM con un gestore di identità che non è integrato nativamente con Asana, consulta la documentazione per sviluppatori di Asana sugli attributi SCIM supportati per l'elenco completo degli attributi accettati.

      Personalizzazione del deprovisioning SCIM

      Quando un membro viene rimosso da Asana tramite SCIM o l'API utilizzando un token dell'account di servizio, Asana crea automaticamente un progetto “Attività precedentemente assegnate” contenente le sue attività pubbliche. Puoi configurare chi è il responsabile di quel progetto:

      1. Nella Console di amministrazione, vai alla scheda Sicurezza e apri le Impostazioni di rimozione dei membri.
      2. Attiva l'impostazione per assegnare un amministratore avanzato (o Tutti gli amministratori avanzati) come titolare del progetto “Attività assegnate in precedenza”.
      3. Facoltativamente, scegli se includere le attività completate.

      Questa personalizzazione si applica solo quando un membro viene rimosso tramite SCIM o l'API con un token dell'account di servizio, non quando viene rimosso manualmente tramite l'interfaccia utente di Asana. Per ulteriori informazioni su cosa succede quando un membro viene rimosso, consulta Deprovisioning degli utenti.

      Note iconNota

      Questo articolo è stato tradotto dall’IA.

      Invia feedback sulla traduzione.
      Caricamento
      SCIM di Asana: automatizza il provisioning degli utenti | Centro assistenza