Salta al contenuto
Nota bene: la traduzione in italiano di questo articolo è fornita solo per comodità. La traduzione viene creata automaticamente tramite un software di traduzione e potrebbe non essere stata revisionata. Pertanto, la versione inglese di questo articolo deve essere considerata come la versione di governo contenente le informazioni più recenti. È possibile accedervi qui.

Provisionare gli utenti HubSpot con SCIM attraverso Okta

Ultimo aggiornamento: dicembre 20, 2024

Disponibile con uno qualsiasi dei seguenti abbonamenti, tranne dove indicato:

Marketing Hub   Enterprise
Sales Hub   Enterprise
Service Hub   Enterprise
Content Hub   Enterprise

Il provisioning degli utenti tramite SCIM (System for Cross-domain Identity Management) fornisce un modo sicuro e automatizzato per creare e gestire gli utenti HubSpot attraverso Okta.

Di seguito, scoprirete come impostare il provisioning degli utenti tramite Okta.

Prerequisiti

  • Il Single Sign-On (SSO) deve essere abilitato nell'account HubSpot.
  • Si consiglia di impostare i set di autorizzazioni degli utenti in HubSpot in base ai ruoli Okta del team prima di configurare SCIM.
  • Per impostare le autorizzazioni degli utenti, è necessario creare set di autorizzazioni in HubSpot. Okta può quindi assegnare i permessi a un utente se il suo Ruolo in Okta corrisponde al nome del set di autorizzazioni di HubSpot.
  • Per verificare il dominio, è necessario aggiornare i record DNS. Assicuratevi di avere i dati di accesso al vostro provider DNS e di avere accesso ai record TXT.
  • L'assegnazione delle postazioni varia a seconda che si utilizzi o meno il modello di prezzo basato sulle postazioni:
    • Se non avete un modello di prezzo basato sui posti: per assegnare posti a pagamento agli utenti configurati con SCIM, acquistate i posti in HubSpot e create un set di autorizzazioni con un posto a pagamento. Tornare a Okta e impostare i ruoli dell'utente in modo che corrispondano al set di autorizzazioni.
    • Se si utilizza il modello di prezzo basato sulle postazioni: non è possibile assegnare postazioni di base, postazioni Sales o Service Hub o postazioni in sola visualizzazione, in base ai set di autorizzazioni assegnati in Okta. Prima di assegnare i permessi tramite Okta, è necessario aggiornare la postazione dell'utente in HubSpot.

Impostazione del provisioning SCIM

Per impostare il provisioning degli utenti di HubSpot attraverso Okta, è necessario prima aggiungere l'app HubSpot in Okta e poi assegnare gli utenti all'app:

  • Accedere a Okta.
  • Nel menu della barra laterale sinistra, selezionare Applicazioni > Applicazioni, quindi cercare e aggiungere l'applicazione HubSpot nel proprio menu account.
  • Nella schermata dell'applicazione HubSpot, fare clic sulla scheda Provisioning, quindi su Configura integrazione API.

    okta-configure-api-integration
  • Selezionare la casella di controllo Abilita integrazione API, quindi fare clic su Autentica con HubSpot. Si aprirà una nuova finestra in cui si potrà dare accesso a Okta al proprio account HubSpot.
  • Nella finestra HubSpot, selezionare l'account con cui si desidera integrare Okta, quindi fare clic su Scegli account.
  • Fare clic su Connetti app. La finestra si chiude e si viene indirizzati alla console di amministrazione di Okta.
  • Fare clic su Salva.
  • Nella scheda Provisioning , selezionare la modalità di provisioning degli utenti di HubSpot da parte di Okta facendo clic su Edit.
    okta-scim-provisioning-options0
  • Selezionare le caselle di controllo Abilita accanto a Crea utenti, Aggiorna attribuzioni utente e Disattiva utenti per configurare l'integrazione.
  • Fare clic su Salva.
  • Quindi, assegnare gli utenti all'applicazione HubSpot.

Verifica del dominio

Dopo aver aggiunto l'app HubSpot tramite Okta, è necessario verificare il dominio in HubSpot aggiornando i record DNS.

  • Nel tuo account HubSpot, fai clic sulle settings icona delle impostazioni nella barra di navigazione principale.
  • Nel menu della barra laterale sinistra, spostarsi su Integrazioni > App connesse.
  • Fare clic su Okta SCIM.

Okta

  • Nel campo Dominio, inserire il dominio e-mail di invio degli utenti.

SCIM_Domain

  • Fare clic su Salva.
  • Fare clic su Verifica ora.

SCIM_Verify

  • Nella finestra di dialogo, selezionare Avanti.
  • Copiare il valore nella colonna Valore. Questo valore verrà poi utilizzato per la creazione di un nuovo record TXT nel provider DNS
  • Accedere all'account del provider DNS e creare un nuovo record TXT per il dominio da verificare. Incollate il valore copiato da HubSpot nel campo Valore/Punti a/Target.
  • Dopo aver creato il record TXT, tornate a HubSpot e fate clic su Avanti. Una volta che le modifiche DNS si saranno propagate, il dominio sarà verificato.

SCIM_Verify3

Attenzione: possono essere necessarie fino a 48 ore perché le modifiche DNS si propaghino e si riflettano in HubSpot.

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

Per impostare le autorizzazioni degli utenti, è necessario creare set di autorizzazioni in HubSpot. Okta può quindi assegnare i permessi a un utente se il suo Ruolo in Okta corrisponde al nome esatto del set di autorizzazioni di HubSpot, compresi spazi e maiuscole.

Per dare a Okta l'accesso all'assegnazione di set di autorizzazioni agli utenti:

  • Nel tuo account HubSpot, fai clic sulle settings icona delle impostazioni nella barra di navigazione principale.
  • Nel menu della barra laterale sinistra, fare clic su Integrazioni > App connesse.
  • In Tutte le applicazioni, fare clic su Okta SCIM.
  • Attivare la gestione dei set di autorizzazioni.

Disattivare il provisioning SCIM

Per disabilitare il provisioning SCIM in HubSpot, è necessario disinstallare Okta SCIM in HubSpot prima di apportare qualsiasi modifica al proprio account Okta.

  • Nel tuo account HubSpot, fai clic sulle settings icona delle impostazioni nella barra di navigazione principale.
  • Nel menu della barra laterale sinistra, spostarsi su Integrazioni > Applicazioni connesse.
  • Sotto l'app Okta SCIM, fare clic sul menu a discesa Azioni, quindi su Disinstalla.
  • Nel vostro account Okta, gli utenti diventeranno modificabili e non saranno più sincronizzati con SCIM.

FAQ

Gli utenti creati tramite SCIM possono essere modificati in HubSpot?

Solo le autorizzazioni degli utenti possono essere modificate in HubSpot, e solo se la gestione dei set di autorizzazioni non è configurata. Tutte le altre informazioni sull'utente, compresi il nome e l'indirizzo e-mail, possono essere aggiornate solo attraverso il vostro identity provider.

Perché i ruoli Okta assegnati non compaiono nel set di autorizzazioni dell'utente in HubSpot?

È necessario attivare la gestione dei set di autorizzazioni in HubSpot per far sì che i ruoli di 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, compresi 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 cancello un utente SCIM in HubSpot o 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 sarà disattivato anche in HubSpot. L'aggiunta di un utente a HubSpot non lo aggiungerà a Okta.

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

Dopo aver configurato SCIM attraverso Okta, tutti gli utenti HubSpot esistenti che corrispondono agli utenti di Okta saranno automaticamente convertiti in utenti SCIM. HubSpot cercherà di assegnare all'utente un set di autorizzazioni basato sui suoi ruoli in Okta. Se l'utente non ha ruoli in Okta che corrispondono alle autorizzazioni impostate in HubSpot, avrà solo autorizzazioni minime in HubSpot.

Vedo l'errore "Non è stato possibile verificare questo dominio", come posso risolvere il problema?

Se si verifica questo errore, assicurarsi che il dominio sia stato inserito correttamente, senza errori di ortografia. Inoltre, verificate di aver copiato il valore corretto del record TXT dalla fase di configurazione di HubSpot al vostro provider DNS.

L'articolo è stato utile?
Questo modulo viene utilizzato solo per il feedback della documentazione. Scopri come ottenere assistenza con HubSpot.