BetaConfigurare l'autenticazione gestita dall'azienda in Claude

L'autenticazione gestita dall'azienda (EMA) consente agli amministratori di configurare il connettore HubSpot per la propria organizzazione Claude. I membri idonei vedranno quindi HubSpot già collegato in Claude, senza dover installare il connettore né approvare autonomamente una connessione separata.

Con l’autorizzazione gestita emessa da Claude, gli amministratori scelgono chi riceve l’accesso automatico in Claude e gestiscono l’accesso del connettore in HubSpot. Ogni membro si connette con il proprio account HubSpot, utilizzando le autorizzazioni HubSpot già in suo possesso. 

Prima di iniziare

Prima di configurare l’autenticazione, verifica i seguenti ruoli e i passaggi preliminari:

• Un’organizzazione Claude Team o Enterprise con autorizzazione gestita rilasciata da Claude disponibile per il connettore HubSpot.
• Un amministratore in grado di gestire i connettori in Claude e un superamministratore HubSpot in grado di gestire le app approvate. Se necessario, una sola persona può ricoprire entrambi questi ruoli.
• Il connettore HubSpot è disponibile nelle impostazionidel connettore della tua organizzazione Claude.
• Il connettore HubSpot è stato installato da un amministratore nell’account HubSpot che desideri collegare. Puoi iniziare con questa connessione esistente prima di configurare EMA per gli altri membri del team.
• Un account utente HubSpot attivo per ogni membro del team che utilizzerà il connettore. L’indirizzo e-mail Claude di ciascun membro deve corrispondere al proprio indirizzo e-mail HubSpot verificato.

Se un amministratore non ha installato il connettore nell’account HubSpot di destinazione, segui queste istruzioni per configurare il connettore HubSpot per Claude e completare la connessione iniziale. Successivamente, verifica le impostazioni di approvazione e accesso dell’app prima di procedere.

Verifica che ogni membro del team disponga delle autorizzazioni corrette in HubSpot. Per gli strumenti attualmente supportati, i membri del team utilizzano le stesse autorizzazioni e i stessi diritti di HubSpot in Claude, nel rispetto degli ambiti consentiti dal connettore e delle autorizzazioni relative ai dati.

Scopri di più sulleimpostazioni di autorizzazione gestite e sui controlli dei ruoli di Claude.

Impostazioni di accesso in Claude e HubSpot

La tabella seguente illustra le diverse impostazioni di accesso in Claude e HubSpot:

Concedere a qualcuno l’accesso al connettore in Claude non crea un utente HubSpot né amplia le sue autorizzazioni HubSpot. Verifica l’accesso in entrambi i servizi prima di abilitare la connessione per il tuo team.

Claude verifica che gli amministratori e gli utenti del connettore siano membri attuali della tua organizzazione Claude con l’indirizzo e-mail che hanno configurato. Non verifica un accesso tramite un provider di identità separato né controlla i requisiti di autenticazione a più fattori (MFA) di quel provider o le regole di accesso di HubSpot. Anthropic raccomanda di applicare il Single Sign-On (SSO) in Claude.

Configurare l’autenticazione gestita

I passaggi riportati di seguito ti guidano nella verifica delle autorizzazioni attuali del connettore, nell’individuazione dell’URL dell’emittente della tua organizzazione nelle impostazioni di Claude, nell’abilitazione dell’EMA e infine nel test della connessione risultante.

1. Verifica l’accesso del connettore in HubSpot

Per prima cosa, verifica le autorizzazioni attuali del connettore HubSpot per Claude:

1. Nel tuo account HubSpot, fai clic sulle icona delle impostazioni nella barra di navigazione principale.
2. Nel menu della barra laterale sinistra, vai suIntegrazioni >App collegate.
3. Fai clic sulla schedaApp approvate.
4. Individua il connettore HubSpot per Claude, quindi fai clic suGestisci accesso.
5. Fai clic sulla schedaAutorizzazioni installate e verifica chi può connettersi all’app. Includi gli utenti HubSpot che dovrebbero ricevere l’accesso automatico in Claude. I membri devono inoltre avere accesso al connettore in Claude e appartenere a un ruolo selezionato per l’autorizzazione gestita.
6. Fai clic sulla schedaAutorizzazioni dati, verifica i dati e le API a cui il connettore può accedere. Aggiungi le autorizzazioni necessarie al tuo team, quindi salva le modifiche.

Le autorizzazioni relative ai dati delle app di HubSpot si applicano a tutti gli utenti, inclusi gli amministratori. Le autorizzazioni richieste non possono essere disattivate. Scopri di più sulla gestione dell’accesso alle app.

Tieni aperta questa pagina di HubSpot mentre accedi al tuo account Claude in una scheda separata.

2. Ottieni l’URL dell’emittente della tua organizzazione Claude

Successivamente, individua e copia l’URL dell’emittente dalle impostazioni di Claude: questo identifica l’organizzazione Claude di cui HubSpot si fiderà durante la connessione dei membri.

1. In Claude, vai su Impostazioni organizzazione > Connettori e seleziona HubSpot.
2. In le impostazioni del connettore, individua Autorizzazione gestita e apri la relativa configurazione.
3. Alla voce " Origine identità", seleziona " Emittente: Claude".
4. Cocopia l'URL completo dell'emittente visualizzato nella schermata di configurazione. Se Claude mostra "Configura manualmente", espandi la voce per visualizzare l'URL.

Tieni aperta questa pagina di configurazione in una finestra o scheda separata del browser. Ci tornerai dopo aver abilitato l’EMA in HubSpot.

3. Abilita l’EMA in HubSpot

Utilizza l’URL dell’emittente che hai copiato per configurare l’EMA in HubSpot:

1. Rinal pannello "Gestisci accesso" del connettore in HubSpot.
2. Fai clic sulla scheda " Avanzate ".
3. Fai clic sull'interruttore "Autenticazione gestita da Enterprise (EMA)" per aprire la configurazione.
4. Copia l’ID account visualizzato nel pannello. Si tratta dell’account HubSpot che stai collegando e lo utilizzerai come ID tenant in Claude.
5. Incolla l’URL completo da Claude nel campo "URL emittente ".
6. Fai clic su Attiva EMA.
7. Conferma che lo stato sia " On " e che l'URL dell'emittente salvato sia corretto.

Se l’impostazione EMA non è presente, consulta la sezione dedicata alla risoluzione dei problemi qui sotto.

4. Verifica e abilita la connessione in Claude

Ora che l’EMA è configurato, prova la connessione in Claude:

1. Ritorna alla configurazione dell’autorizzazione gestita in Claude.
2. Per il Tnel, inserisci l'ID account HubSpot che hai copiato. Sebbene Claude indichi questo campo come facoltativo, è comunque necessario inserirlo per la connessione a HubSpot.
3. Fai clic su Esegui test e verifica che ogni fase vada a buon fine.
   
4. CFai clic su "Continua" per aprire la configurazione dei ruoli. Seleziona i ruoli che devono connettersi tramite autorizzazione gestita. Verifica la selezione prima di abilitarla per la tua organizzazione.
5. Clcck Abilita.
   
6. Nel pannello Dettagli del connettore, verificare chel’opzione Autorizzazione gestita sia attiva e che la sezione Ruoli applicati elenchi i ruoli selezionati.
7. In " Autorizzazione gestita", fare clic su "Modifica" accanto a "Ambiti" per rivedere e aggiornare le autorizzazioni che Claude può richiedere.
8. Re" Ruoli con accesso " per verificare che i membri previsti possano trovare e collegare il connettore. Fare clic su "Modifica" se è necessario modificare questo accesso.

Entrambe le impostazioni relative ai ruoli in Claude sono importanti: i membri devono avere accesso al connettore e il loro ruolo deve essere incluso nell’autorizzazione gestita per potersi connettere automaticamente. I membri devono inoltre soddisfare i requisiti relativi all’account HubSpot, all’indirizzo e-mail e alle autorizzazioni di installazione descritti sopra. Per ulteriori informazioni sulle impostazioni relative ai ruoli in Claude, consulta questo articolo del supporto di Claude.

Verifica l’esperienza dei membri

Prima di comunicare la modifica alla tua organizzazione, chiedi ad alcuni membri del team di verificare la connessione:

1. Open Claude nell’organizzazione in cui è abilitata l’autorizzazione gestita.
2. Csuazienda ta cui HubSpot appare connesso. Se necessario, abilita il connettore per la conversazione.
3. Inizia con una richiesta che non modifichi i dati, ad esempio: A quale account HubSpot e a quale utente sono collegato? Non modificare alcun dato.
4. Conferma che la risposta identifichi l’account HubSpot previsto e, se disponibili, i dettagli dell’utente del membro del team.
5. Tra a inviare una richiesta di lettura di un record a cui il membro del team può accedere in HubSpot.

Alcuni dettagli dell’utente richiedono autorizzazioni aggiuntive. Se tali dettagli non sono disponibili, puoi comunque verificare l’account collegato e la lettura dei record consentita. La sola mancanza di dettagli facoltativi non implica che l’autenticazione sia fallita; non concedere accessi aggiuntivi solo per completare questa verifica.

I membri del team che soddisfano i requisiti di accesso non devono completare una procedura di accesso individuale a HubSpot né visualizzare la schermata di consenso alla connessione. EMA non rimuove le richieste di approvazione configurate per le singole azioni degli strumenti, come gli aggiornamenti ai record del CRM.

Gestire l’accesso dopo la configurazione

Per aggiornare l’accesso di un membro del team dopo la configurazione:

1. Nel tuo account Claude, apri il pannello dei dettagli del connettore Claude.
2. Nella sezione Autenticazione gestita, clicca su Modifica accanto a Ruoli applicati per modificare quali ruoli utilizzano l'autorizzazione gestita.
3. Per modificare chi può trovare e collegare il connettore, clicca su Modifica accanto a Ruoli con accesso. 
4. Fai clic suModifica accanto a Ambitiper gestire quali autorizzazioni Claude può richiedere.

In HubSpot, controlla la scheda " Autorizzazioni di installazione " per modificare chi è autorizzato a connettersi all’app e la scheda "Autorizzazioni sui dati " per gestire i dati e le API a cui può accedere. Ogni membro continua a utilizzare le proprie autorizzazioni HubSpot.

Rimuovere l’accesso di un membro

Segui la procedura di offboarding della tua organizzazione sia in Claude che in HubSpot. La rimozione di una persona dall’organizzazione di Claude impedisce a Claude di emettere nuove attestazioni di identità per tale persona. Un token di accesso già emesso può rimanere utilizzabile fino alla sua scadenza o revoca, quindi non fare affidamento esclusivamente su una modifica dell’appartenenza per la rimozione immediata dell’accesso.

Prima di assegnare l’indirizzo e-mail di un ex membro a qualcun altro, rimuovi l’ex membro come utente HubSpot seguendo la procedura di offboarding della tua organizzazione. La sola rimozione dell’accesso al connettore non comporta la rimozione del vecchio utente HubSpot associato a quell’indirizzo e-mail.

Disattiva l’EMA

Per disattivare l’EMA:

1. In Claude, apri le impostazioni di autorizzazione gestita del connettore HubSpot e clicca su Disattiva.
2. Nel tuo account HubSpot, fai clic sulle icona delle impostazioni nella barra di navigazione principale.
3. Nel menu della barra laterale sinistra, vai suIntegrazioni >App collegate >App approvate.
4. Individua il connettore, fai clic suGestisci accesso, quindi selezionaAvanzate.
5. Fai clic per disattivare l’opzioneAutenticazione gestita dall’azienda (EMA), quindi fai clic suDisattiva per confermare.

La disattivazione dell’autorizzazione gestita interrompe la connessione automatica. I membri che necessitano ancora del connettore dovranno connettersi individualmente, in base alle impostazioni della tua organizzazione e alle autorizzazioni di installazione di HubSpot. I token di accesso esistenti potrebbero rimanere validi fino alla loro scadenza o revoca.

Risoluzione dei problemi

Le sezioni seguenti forniscono indicazioni sugli errori comuni che potresti riscontrare durante il processo di configurazione.

L’impostazione EMA non è disponibile

Verifica di essere un Super Amministratore di HubSpot, di trovarti nell’account HubSpot corretto e di gestire il connettore HubSpot approvato per Claude. Se l’autenticazione gestita Enterprise (EMA) continua a non apparire nella sezione “Avanzate”, contatta l’assistenza HubSpot per verificare la disponibilità per il tuo account e il tuo connettore.

Il test di connessione di Claude non va a buon fine

Consulta la tabella sottostante per i dettagli su cosa controllare in base alla fase in cui si è verificato l’errore di connessione:

Un errore invalid_grant " da solo non identifica la causa principale. Controlla l’account, l’URL dell’emittente, la corrispondenza dell’indirizzo e-mail e le impostazioni di accesso prima di ripetere il test.

Un membro del team non riesce a trovare HubSpot o vede ancora la richiesta "Connetti"

Innanzitutto, verifica che il membro si trovi nell’organizzazione Claude prevista. Nelle impostazioni di Claude, alla voce pagina "Dettagli connettore" , controlla la sezione "Ruoli con accesso " se non riesce a trovare il connettore e la sezione" Ruoli applicati " se non si sta connettendo tramite autorizzazione gestita.

In HubSpot, verifica che disponga di un account utente attivo, che il suo indirizzo e-mail verificato corrisponda a quello di Claude e che le autorizzazioni di installazione gli consentano di connettersi.

Un membro del team si connette ma non riesce ad accedere ai dati previsti

Controlla gli ambiti del connettore nel tuo account Claude, le autorizzazioni sui dati dell’app in HubSpot e le autorizzazioni HubSpot del membro del team. La connessione automatica non garantisce l’accesso a record o azioni che il membro non può utilizzare in HubSpot.

Se il problema persiste, contatta l’assistenza indicando l’operazione che ha dato esito negativo e l’ora in cui si è verificata. Non includere token di accesso o asserzioni di identità firmate nella richiesta di assistenza.