Fornire agli utenti HubSpot l'accesso SCIM tramite Okta

La gestione degli utenti tramite SCIM (System for Cross-domain Identity Management) offre un metodo sicuro e automatizzato per creare e gestire gli utenti HubSpot tramite Okta.

Se il tuo provider di identità non è Okta o Google, puoi configurare un'integrazione SCIM personalizzata. Ciò ti consente di configurare SCIM per il provisioning degli utenti da provider quali Microsoft Entra ID, PingFederate, OneLogin e JumpCloud. Scopri di più su come configurare SCIM per il tuo provider di identità.

Di seguito, scopri come configurare la gestione degli utenti tramite Okta.

Prima di iniziare

Prima di iniziare a utilizzare questa funzionalità, assicurati di aver compreso appieno quali passaggi devono essere eseguiti in anticipo, nonché le limitazioni della funzionalità e le potenziali conseguenze del suo utilizzo.

Comprendere i requisiti

• Il Single Sign-On (SSO) deve essere attivato nel tuo account HubSpot.
• Si consiglia di configurare i set di autorizzazioni utente in HubSpot in base ai ruoli Okta del proprio team prima di configurare SCIM.
• Per impostare le autorizzazioni degli utenti, è necessario creare set di autorizzazioni in HubSpot. Okta potrà quindi assegnare le autorizzazioni a un utente se i suoi ruoli in Okta corrispondono al nome del set di autorizzazioni di HubSpot.
• Per verificare il proprio dominio, sarà necessario aggiornare i record DNS. Assicurarsi di disporre delle credenziali di accesso del proprio provider DNS e di avere accesso ai record TXT.

Comprendere le limitazioni e le considerazioni

• L’assegnazione delle licenze varia a seconda che si utilizzi o meno il modello di tariffazione basato sulle licenze:
  • Se non si utilizza un modello di tariffazione basato sui posti: per assegnare i posti agli utenti configurati con SCIM, acquistare i posti in HubSpot e creare un set di autorizzazioni con un posto a pagamento. Tornare su Okta e impostare i ruoli dell’utente in modo che corrispondano al set di autorizzazioni.
  • Se utilizzi il modello di tariffazione basato sui posti: quando un set di autorizzazioni viene assegnato tramite SCIM/API, HubSpot assegna automaticamente all’utente il miglior posto disponibile che supporti tutte le autorizzazioni di quel set.

Configurazione del provisioning SCIM

Per configurare il provisioning degli utenti SCIM tramite Okta, dovrai prima aggiungere l’app HubSpot in Okta, quindi assegnare gli utenti all’app:

1. Accedi a Okta.
2. Nel menu della barra laterale sinistra, seleziona Applicazioni > Applicazioni, quindi cerca e aggiungi l’applicazione HubSpot al tuo account Okta.
3. Nella schermata dell’applicazione HubSpot, fai clic sulla scheda Provisioning, quindi su Configura integrazione API.
   
   
   
4. Seleziona la casella di controllo Abilita integrazione API, quindi fai clic su Autentica con HubSpot. Si aprirà una nuova finestra in cui potrai concedere a Okta l’accesso al tuo account HubSpot.
5. Nella finestra di HubSpot, seleziona l’account con cui desideri integrare Okta, quindi fai clic su Scegli account.
6. Fai clic su "Connetti app". La finestra si chiuderà e verrai reindirizzato alla console di amministrazione di Okta.
7. Fai clic su Salva.
8. Nella scheda "Provisioning ", seleziona come desideri che Okta effettui il provisioning degli utenti su HubSpot facendo clic su "Modifica".
   
   
9. Seleziona le caselle di controllo "Abilita" accanto a "Crea utenti", "Aggiorna attributi utente" e "Disattiva utenti " per configurare l'integrazione.
10. Fai clic su Salva.
11. Quindi, assegna gli utenti all’app HubSpot.

Verifica il tuo dominio

Dopo aver aggiunto l’app HubSpot tramite Okta, dovrai verificare il tuo dominio in HubSpot aggiornando i tuoi record DNS.

1. Nel tuo account HubSpot, fai clic sulle icona delle impostazioni nella barra di navigazione principale.
2. Nel menu della barra laterale sinistra, vai su Integrazioni > App collegate.
3. Fai clic su Okta SCIM.
4. Accedi alla scheda Impostazioni generali.
5. Nel campo Dominio, inserisci il dominio di invio delle e-mail dei tuoi utenti.
6. Fai clic su Salva.
7. Fare clic su Verifica ora.
   
   
   
8. Nella finestra di dialogo, seleziona Avanti.
9. Copia il valore presente nella colonna "Valore". Utilizzerai questo valore per creare un nuovo record TXT presso il tuo provider DNS
10. Accedi al tuo account del provider DNS, quindi crea un nuovo record TXT per il dominio che stai verificando. Incolla il valore copiato da HubSpot nel campo "Valore", "Punta a" o "Destinazione".
11. Dopo aver creato il record TXT, torna su HubSpot, quindi clicca su Avanti. Una volta che le modifiche al DNS saranno state propagate, il dominio sarà verificato.

Nota: la propagazione delle modifiche DNS e la loro visualizzazione in HubSpot possono richiedere fino a 48 ore.

Sincronizza i ruoli di Okta con i set di autorizzazioni di HubSpot

Per impostare le autorizzazioni degli utenti, devi creare dei set di autorizzazioni in HubSpot. Okta potrà quindi assegnare le autorizzazioni a un utente se i suoi ruoli in Okta corrispondono esattamente al nome del set di autorizzazioni di HubSpot, inclusi spazi e maiuscole.

Per consentire a Okta di assegnare i set di autorizzazioni agli utenti:

1. Nel tuo account HubSpot, fai clic sulle icona delle impostazioni nella barra di navigazione principale.
2. Nel menu della barra laterale sinistra, fare clic su Integrazioni > App collegate.
3. In " Tutte le app", clicca su Okta SCIM.
4. Attiva Gestione set di autorizzazioni.

Disattiva il provisioning SCIM

Per disabilitare il provisioning SCIM in HubSpot, devi disinstallare Okta SCIM da HubSpot prima di apportare qualsiasi modifica al tuo account Okta.

1. Nel tuo account HubSpot, fai clic sulle icona delle impostazioni nella barra di navigazione principale.
2. Nel menu della barra laterale sinistra, vai su Integrazioni > App collegate.
3. Sotto l’app Okta SCIM, clicca sul menu a tendina Azioni, quindi clicca su Disinstalla.
4. Nel tuo account Okta, gli utenti diventeranno modificabili e non saranno più sincronizzati con SCIM.

Domande frequenti

È possibile modificare in HubSpot gli utenti creati tramite SCIM?

In HubSpot è possibile modificare solo le autorizzazioni degli utenti, e solo se la gestione dei set di autorizzazioni non è configurata. Tutte le altre informazioni relative agli utenti, inclusi il nome utente e l’indirizzo e-mail, possono essere aggiornate solo tramite il tuo provider di identità.

Perché i ruoli Okta che mi sono stati assegnati non vengono visualizzati nel mio set di autorizzazioni utente in HubSpot?

È necessario attivare la gestione dei set di autorizzazioni in HubSpot affinché i ruoli Okta si sincronizzino con i set di autorizzazioni di HubSpot. Il nome del set di autorizzazioni in HubSpot deve corrispondere esattamente ai nomi dei ruoli in Okta, inclusi tutti gli spazi e le maiuscole.

Okta può assegnare gli utenti ai team?

No. Tuttavia, dopo che l’utente è stato aggiunto a HubSpot, è possibile aggiornare manualmente il suo team in HubSpot.

Cosa succede se elimino un utente SCIM in HubSpot o in Okta?

L’eliminazione di un utente in HubSpot non comporta l’eliminazione dell’utente in Okta. Tuttavia, se si rimuove l’accesso di un utente a HubSpot da Okta o si disattiva il suo account in Okta, l’utente verrà disattivato anche in HubSpot. L’aggiunta di un utente a HubSpot non comporta l’aggiunta dell’utente a Okta.

Cosa succede agli utenti esistenti nel mio account HubSpot quando collego Okta?

Dopo aver configurato SCIM tramite Okta, tutti gli utenti HubSpot esistenti che corrispondono a quelli presenti in Okta verranno automaticamente convertiti in utenti SCIM. HubSpot tenterà di assegnare all’utente un set di autorizzazioni in base ai suoi ruoli in Okta. Se l’utente non dispone in Okta di ruoli che corrispondono alle autorizzazioni impostate in HubSpot, avrà solo autorizzazioni minime in HubSpot.

Vedo l’errore “Impossibile verificare questo dominio”, come posso risolvere il problema?

Se visualizzi questo errore, assicurati che il tuo dominio sia stato inserito correttamente, senza errori di ortografia. Verifica inoltre di aver copiato il valore corretto del record TXT dalla fase di configurazione in HubSpot nel tuo provider DNS.