SAML SSO Azure AD / Entra ID: Provisioning di utenti e gruppi
Wrike supporta SCIM con Azure AD / Microsoft Entra ID per eseguire automaticamente il provisioning, l'aggiornamento e la disattivazione degli utenti. Per configurarlo, aggiungi i domini approvati in Wrike, copia l’URL SCIM, crea e salva un token API, quindi inserisci entrambi nelle impostazioni di Provisioning di Azure e attiva il provisioning. Gli utenti forniti tramite SCIM sono immediatamente fatturabili.
| Disponibilità: Legacy Enterprise.; Non disponibilità: Legacy Free, Legacy Professional, Legacy Business.; |
| Disponibilità: Pinnacle, Apex. Non disponibili: Free, Team, Business; |
Con il protocollo SCIM, gli amministratori possono configurare il provisioning e il deprovisioning automatico degli utenti per Wrike con Azure Active Directory (Azure AD) / Microsoft Entra ID (Entra ID).
Configura Wrike con lo standard System for Cross-domain Identity Management (SCIM) per eseguire automaticamente il provisioning o il deprovisioning degli utenti, sincronizzare gli attributi utente supportati, eseguire il provisioning dei gruppi utente e gestire le modifiche di appartenenza ai gruppi in base al loro stato in Azure AD / Entra ID.
Attualmente Wrike supporta le seguenti funzionalità di provisioning SCIM con Entra ID:
- Provisioning automatico: gli utenti Entra ID vengono forniti automaticamente in Wrike.
- Attributi utente sincronizzati: gli attributi utente supportati vengono aggiornati automaticamente in Wrike quando vengono aggiornati in Entra ID.
- Provisioning di attributi utente personalizzati: gli attributi utente personalizzati supportati possono essere mappati da Entra ID ai campi personalizzati utente di Wrike.
- Disattivazione automatica: gli utenti Wrike vengono disattivati automaticamente in Wrike quando vengono disattivati in Entra ID.
- Provisioning di gruppi: i gruppi Entra ID possono essere forniti in Wrike come gruppi di utenti Wrike, incluse le modifiche di appartenenza.
Note
Per aggiornare correttamente gli attributi utente degli amministratori dell'account, l'amministratore che ha emesso il token API deve avere abilitato il diritto di concedere/revocare i diritti di amministratore.
Questa pagina riguarda l'integrazione di Wrike con Azure AD / Entra ID tramite SCIM. Abbiamo una pagina separata sulla configurazione di SAML SSO a Wrike tramite Azure AD / Entra ID.
Note
I membri aggiunti tramite SCIM diventano fatturabili non appena viene eseguito il provisioning.
Per configurare Wrike con Azure AD / Entra ID SCIM devi disporre dell'autorizzazione Configura impostazioni di sicurezza avanzate in Wrike ed essere un amministratore di Azure AD / Entra ID. Ti consigliamo innanzitutto di configurare SAML SSO con Azure AD / Entra ID.
Solo gli utenti provenienti da domini approvati verranno automaticamente sottoposti a provisioning in Wrike.
- Apri il tuo spazio di lavoro Wrike.
- Fai clic sulla tua immagine del profilo, situata nell'angolo superiore destro.
- Seleziona App e integrazioni.
- Fai clic su Azure AD / Entra ID nell'elenco delle app e apri la scheda SCIM.
- Scorri fino in fondo al popup e copia l'URL SCIM. Lo userai tra pochi passaggi.
- Chiudi il popup di Azure AD / Entra ID (ma rimani in Wrike) e passa al Passaggio 3.
- Fai clic su API nel lato sinistro della pagina App e integrazioni.
- Inserisci un nome nel campo Nome app (consigliamo Azure AD / Entra ID SCIM).
- Fai clic su Crea nuovo.
- (Opzionale) Aggiungi una descrizione.
- Scorri fino in fondo alla pagina e fai clic su Crea token.
- Inserisci la tua password e fai clic su Ottieni token.
-
Copia il token e conservalo in un luogo sicuro. Dovrai inserire queste informazioni in Azure AD / Entra ID.
Importante
Il token viene mostrato solo una volta, quindi assicurati di salvarlo prima di passare ai passaggi successivi.
- Fai clic su Salva
- Accedi al tuo dominio Azure AD / Entra ID su <yourorganization>.Azure AD / Entra ID.com.
- Fai clic su Enterprise applications a sinistra.
- Trova e seleziona Wrike.
- Seleziona Provisioning dal pannello di menu a sinistra.
- Nel menu Provisioning Mode, seleziona Automatic.
- Scorri fino alla sezione Admin Credentials.
- Nel campo accanto a Tenant URL, incolla l'URL di base copiato nel Passaggio 2.
- Nel campo accanto a Secret Token, incolla il token copiato nel Passaggio 3.
- Fai clic sul pulsante Test connection per confermare che tutte le impostazioni siano corrette.
- Se il test ha esito positivo, fai clic sul pulsante Salva nella parte superiore della finestra. In caso contrario, verifica di nuovo le impostazioni o contatta il Team di assistenza Wrike per ottenere aiuto.
- Vai alla scheda Edit provisioning e fai clic sul pulsante Edit provisioning.
- Scorri fino alla sezione Impostazioni.
-
Nel menu a discesa Scope, seleziona quali eventi vuoi sincronizzare tra Wrike e Azure: Sincronizza solo utenti e gruppi assegnati oppure Sincronizza tutti gli utenti e i gruppi.
Note
Assicurati che tutti gli utenti e i gruppi pertinenti siano assegnati all'app Wrike.
La selezione di Sincronizza tutti gli utenti e i gruppi non è consigliata nella maggior parte dei casi, poiché sincronizzerà tutti gli utenti della directory in Wrike, indipendentemente dal fatto che siano stati assegnati all'app enterprise o a un gruppo a essa assegnato.
- Imposta lo stato del provisioning su On.
- Fai clic su Salva nella parte superiore della finestra per avviare il servizio di provisioning.
I seguenti attributi vengono sincronizzati da Azure AD / Entra ID a Wrike:
- Nome utente
- Nome
- Cognome
- Email principale
- Qualifica
- Numero di telefono principale
- Nome organizzazione
- Reparto
-
Tipo di utente di Wrike
Note
Specificare il tipo di utente di Wrike (Regular, External, Collaborator, Contributor e Viewer) è un attributo personalizzato. Per impostazione predefinita vengono creati utenti Regular.
Se alcuni attributi utente (es., numero di telefono, reparto o e-mail secondarie) sono compilati in Wrike ma mancanti in Azure AD / Entra ID, le informazioni rimangono in Wrike anche dopo il provisioning dell'utente.
Provisioning/Deprovisioning utente
Se un utente non viene fornito o rimosso:
-
Controlla il System Log nel portale di amministrazione di Azure AD / Entra ID per verificare se è presente un tentativo di provisioning SCIM.
- Se non è elencato alcun tentativo di provisioning, assicurati che gli utenti siano assegnati correttamente all'applicazione Wrike in Azure AD / Entra ID.
- Se è elencato un errore, contatta il nostro Team di assistenza e fornisci i dettagli dell'errore.
Wrike UserType in una nuova app personalizzata su Entra ID
Se stai configurando una nuova Applicazione Enterprise personalizzata, aggiungi e mappa il seguente attributo SCIM nelle mappature degli attributi di provisioning per garantire che gli utenti siano forniti con il corretto tipo di utente Wrike.
urn:ietf:params:scim:schemas:extension:wrike:2.0:User:wrikeUserType
Passaggio 1: Crea un campo personalizzato utente in Wrike
- Vai a: https://www.wrike.com/accounts.htm#account/groups
- Fai clic su + per creare un nuovo campo personalizzato utente.
- Salva il campo.
Passaggio 2: Ottieni l'ID del campo personalizzato
curl --location --globoff \ 'https://www.wrike.com/api/v4/customfields?applicableEntityTypes=[User]' \ --header 'Authorization: Bearer YOUR_TOKEN'
Esempio di risposta:
{
"data": [
{
"id": "IEAGWMBBJUAK4G7J",
"title": "Completed Induction",
...
}
]
}
Nota:
- id
- titolo
Normalizza il titolo:
- Sostituisci gli spazi con _
- Rimuovi i caratteri speciali
Passaggio 3: Abilita la modifica dello schema in Entra
-
Assicurati di fare clic sul link sottostante:
https://portal.azure.com/?Microsoft_AAD_Connect_Provisioning_forceSchemaEditorEnabled=true
- Questo consente di modificare l'elenco degli attributi.
Passaggio 4: Aggiungi attributo personalizzato
- Vai a: Enterprise Applications → Wrike → Provisioning
- Fai clic su Attribute Mapping
- Mostra opzioni avanzate
- Modifica l'elenco di attributi per Wrike
- Aggiungi un nuovo attributo (consulta la sezione 1.1 Mappatura attributo personalizzato utente per formattare correttamente l'attributo):
urn:ietf:params:scim:schemas:extension:wrike:2.0:User:IEAGWMBBJUAK4G7J_Completed_Induction
Tipo:
- Stringa (o corrispondi al tipo di campo Wrike)
Salva.
Passaggio 5: Mappa attributo
- Vai a Add New Mapping
- Attributo di origine → scegli il campo Entra (es., extensionAttribute1)
- Attributo di destinazione → seleziona il nuovo attributo SCIM aggiunto
- Salva
Il provisioning invierà i valori automaticamente.
Importante
- L'applicazione ufficiale di galleria Microsoft Entra ID per Wrike attualmente non supporta il provisioning dei gruppi.
- Al momento, per fornire gruppi in Wrike è necessario creare un'Applicazione Enterprise personalizzata invece di usare l'app Wrike della galleria.
- Accedi al portale Azure: https://portal.azure.com
- Vai a: Microsoft Entra ID → Enterprise Applications
- Fai clic su New Application
- Si apre la Microsoft Entra App Gallery.
- Invece di cercare Wrike, fai clic su: Create your own application (angolo in alto a sinistra)
-
Inserisci un nome per l'applicazione
Esempio: Wrike SCIM Provisioning with Group
- Seleziona: Integrazione con qualsiasi altra applicazione che non trovi nella galleria (Non-gallery)
- Fai clic su Crea
Questo crea un'applicazione enterprise personalizzata che supporta il provisioning SCIM inclusi i gruppi.
- Apri l'applicazione appena creata.
- Vai a: Provisioning
- Imposta Provisioning Mode su: Automatic
- Configura la connessione SCIM come descritto nella guida ufficiale: https://help.wrike.com/hc/en-us/articles/360046791773-SAML-SSO-Azure-AD-Entra-ID-User-Provisioning
Ciò stabilisce la connessione di provisioning tra Entra ID e Wrike.
Il provisioning dei gruppi avviene solo per i gruppi assegnati all'applicazione.
- Vai a: Enterprise Application → Users and Groups
- Fai clic su: Aggiungi assegnazione
- Seleziona i gruppi che desideri fornire a Wrike.
- Fai clic su Assegna
- Torna a: Provisioning
- Attiva/disattiva: Provisioning Status → On
- Fai clic su Salva
Il servizio di provisioning inizierà a sincronizzare utenti e gruppi.
Comportamento tipico:
| Azione in Entra | Risultato in Wrike |
| Gruppo assegnato | Gruppo creato in Wrike |
| Utente aggiunto al gruppo | Appartenenza aggiunta |
| Utente rimosso | Appartenenza rimossa |
| Gruppo rimosso | Gruppo rimosso o disabilitato |
I cicli di provisioning vengono eseguiti solitamente ogni 20–40 minuti.