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 di HubSpot con SCIM attraverso Okta

Ultimo aggiornamento: settembre 24, 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 di HubSpot attraverso Okta.

Di seguito, scopriremo come impostare il provisioning degli utenti attraverso Okta.

Prerequisiti

  • Il Single Sign-On (SSO) deve essere abilitato nell'account HubSpot.
  • Si consiglia di impostare i set di permessi utente in HubSpot in base ai ruoli Okta del team prima di configurare SCIM.
  • Per impostare i permessi degli utenti, è necessario creare set di permessi in HubSpot. Okta può quindi assegnare i permessi a un utente se il suo Ruolo in Okta corrisponde al nome del set di permessi 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 dei posti varia a seconda che si utilizzi o meno il modello di prezzo basato sui posti:
    • Se non si utilizza un modello di tariffazione basato sui posti: per assegnare posti a pagamento agli utenti configurati con SCIM, acquistare i posti in HubSpot e creare un set di permessi con un posto a pagamento. Tornare a Okta e impostare il ruolo dell'utente in modo che corrisponda al set di permessi.
    • Se si utilizza il modello di prezzo basato sui posti: non è possibile assegnare posti come i posti core, i posti Sales o Service Hub o i posti di sola visualizzazione, in base ai set di permessi assegnati in Okta. Prima di assegnare i permessi tramite Okta, è necessario aggiornare il posto dell'utente in HubSpot.

Impostare il provisioning SCIM

Per impostare il provisioning degli utenti SCIM 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 account Okta.
  • 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 di 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 il modo in cui Okta deve fornire gli utenti a HubSpot facendo clic su Edit.
    okta-scim-provisioning-options0
  • Selezionare le caselle di controllo Abilita accanto a Crea utenti, Aggiorna attributi 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, andare su Integrazioni > App connesse.
  • Fare clic su Okta SCIM.

Okta

  • Nel campo Dominio, inserire il dominio di invio delle e-mail 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à utilizzato per la creazione di un nuovo record TXT nel provider DNS.
  • Accedere all'account del provider DNS, quindi creare un nuovo record TXT per il dominio da verificare. Incollare il valore copiato da HubSpot nel campo Valore/Punti a/Target.
  • Dopo aver creato il record TXT, tornare a HubSpot e fare clic su Avanti. Una volta che le modifiche DNS si saranno propagate, il dominio sarà verificato.

SCIM_Verify3

Nota bene: 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 permessi di HubSpot

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

Per dare a Okta l'accesso all'assegnazione dei set di permessi 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 collegate.
  • In Tutte le applicazioni, fare clic su Okta SCIM.
  • Attivare la gestione dei set di permessi.

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 > App 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.

DOMANDE PIÙ FREQUENTI

Gli utenti creati tramite SCIM possono essere modificati in HubSpot?

Un utente creato tramite SCIM può essere aggiornato solo tramite il vostro identity provider. Questo include i permessi dell'utente, il nome utente e l'indirizzo e-mail. Tuttavia, è possibile gestire il posto di un utente in HubSpot.

Perché il ruolo Okta assegnato non compare nel set di permessi dell'utente in HubSpot?

Per sincronizzare i ruoli di Okta con i set di permessi di HubSpot è necessario attivare la gestione dei set di permessi in HubSpot. Il nome del permission set in HubSpot deve corrispondere esattamente al nome del ruolo 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 permessi in base al suo ruolo in Okta. Se l'utente non ha un ruolo in Okta che corrisponde a un set di permessi in HubSpot, avrà solo permessi minimi in HubSpot.

Ho riscontrato l'errore "This domain couldn't be verified", come posso risolvere il problema?

Se viene visualizzato questo errore, assicuratevi 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.