Stel door de onderneming beheerde authenticatie in Claude in

Met Enterprise-managed authentication (EMA) kunnen beheerders de HubSpot-connector voor hun Claude-organisatie instellen. In aanmerking komende leden zien HubSpot dan al als verbonden in Claude, zonder dat ze zelf de connector hoeven te installeren of een aparte verbinding hoeven goed te keuren.

Met door Claude verstrekte beheerde autorisatie kiezen beheerders wie automatische toegang krijgt in Claude en beheren ze de toegang van de connector in HubSpot. Elk lid maakt verbinding als zijn of haar eigen HubSpot-gebruiker, met zijn of haar bestaande HubSpot-machtigingen. 

Voordat je aan de slag gaat

Controleer voordat je de authenticatie instelt de volgende rollen en vereiste stappen:

• Een Claude Team- of Enterprise-organisatie met door Claude verstrekte beheerde autorisatie die beschikbaar is voor de HubSpot-connector.
• Een beheerder die connectoren in Claude kan beheren en een HubSpot-superbeheerder die goedgekeurde apps kan beheren. Indien nodig kan één persoon beide rollen vervullen.
• De HubSpot-connector is beschikbaar in deconnectorinstellingen van je Claude-organisatie.
• De HubSpot-connector is geïnstalleerd door een beheerder in het HubSpot-account waarmee je verbinding wilt maken. Je kunt met deze bestaande verbinding aan de slag voordat je EMA voor andere teamleden configureert.
• Een actief HubSpot-gebruikersaccount voor elk teamlid dat de connector gaat gebruiken. Het Claude-e-mailadres van elk lid moet overeenkomen met zijn of haar geverifieerde HubSpot-e-mailadres.

Als een beheerder de connector nog niet heeft geïnstalleerd in het doel-HubSpot-account, volg dan deze instructies om de HubSpot-connector voor Claude in te stellen en de eerste verbinding tot stand te brengen. Controleer vervolgens de goedkeurings- en toegangsinstellingen van de app voordat je verdergaat.

Controleer of elk teamlid de juiste machtigingen heeft ingesteld in HubSpot. Voor momenteel ondersteunde tools gebruiken teamleden dezelfde HubSpot-machtigingen en -rechten in Claude, afhankelijk van de toegestane reikwijdtes en gegevensmachtigingen van de connector.

Lees meer overde instellingen voor beheerde autorisatie en rolbeheer in Claude.

Toegangsinstellingen in Claude en HubSpot

In de onderstaande tabel worden de verschillende toegangsinstellingen in Claude en HubSpot weergegeven:

Als je iemand toegang geeft tot de connector in Claude, wordt er geen HubSpot-gebruiker aangemaakt en worden diens HubSpot-machtigingen niet uitgebreid. Controleer de toegang in beide diensten voordat je de verbinding voor je team inschakelt.

Claude controleert of beheerders en gebruikers van de connector huidige leden zijn van je Claude-organisatie met het e-mailadres dat ze hebben geconfigureerd. Het controleert niet of er is ingelogd via een afzonderlijke identiteitsprovider, noch de vereisten voor meervoudige authenticatie (MFA) van die provider of de inlogregels van HubSpot. Anthropic raadt aan om single sign-on (SSO) in Claude af te dwingen.

Beheerde authenticatie instellen

De onderstaande stappen laten zien hoe je de huidige machtigingen van de connector kunt controleren, de issuer-URL van je organisatie kunt vinden in je Claude-instellingen, EMA kunt inschakelen en vervolgens de resulterende verbinding kunt testen.

1. Controleer de toegang van de connector in HubSpot

Controleer eerst de huidige machtigingen voor de HubSpot-connector voor Claude:

1. Klik in je HubSpot-account op het instellingen-pictogram in de bovenste navigatiebalk.
2. Ga in het menu aan de linkerkant naarIntegraties >Gekoppelde apps.
3. Klik op het tabbladGoedgekeurde apps.
4. Zoek de HubSpot-connector voor Claude en klik vervolgens opToegang beheren.
5. Klik op het tabblad'Geïnstalleerde machtigingen' en controleer wie verbinding kan maken met de app. Voeg de HubSpot-gebruikers toe die automatisch toegang moeten krijgen in Claude. Leden moeten ook toegang hebben tot de connector in Claude en behoren tot een rol die is geselecteerd voor beheerde autorisatie.
6. Klik op het tabblad'Gegevensmachtigingen' en bekijk welke gegevens en API's de connector kan benaderen. Voeg de machtigingen toe die je team nodig heeft en sla vervolgens je wijzigingen op.

De app-toegangsrechten van HubSpot gelden voor alle gebruikers, inclusief beheerders. Vereiste rechten kunnen niet worden uitgeschakeld. Lees meer over het beheren van toegang tot apps.

Houd deze HubSpot-pagina open terwijl je in een apart tabblad je Claude-account opent.

2. Zoek de issuer-URL van je Claude-organisatie op

Vervolgens zoek en kopieer je de issuer-URL uit je Claude-instellingen. Deze URL identificeert de Claude-organisatie die HubSpot vertrouwt bij het koppelen van leden.

1. In Claude ga je naar Organisatie-instellingen > Connectors en selecteer je HubSpot.
2. In de instellingen van de, zoek je 'Beheerde autorisatie' en open je de instellingen daarvan.
3. Selecteer onder Identiteitsbron de optie 'Door Claude uitgegeven'.
4. Cokopieer de volledige URL van de uitgever die in het instellingsscherm wordt weergegeven. Als Claude 'Handmatig instellen' weergeeft , vouw dit dan uit om de URL te bekijken.

Houd deze configuratiepagina open in een apart browservenster of tabblad. Je keert hiernaar terug nadat je EMA in HubSpot hebt ingeschakeld.

3. Schakel EMA in HubSpot in

Gebruik de uitgevers-URL die je hebt gekopieerd om EMA in HubSpot te configureren:

1. Rstnnaar het paneel 'Toegang beheren' van de connector in HubSpot.
2. Klik op het tabblad 'Geavanceerd '.
3. Klik op de schakelaar ‘Enterprise Managed Authentication (EMA)’ om de instellingen te openen.
4. KKopieer de account-ID die in het paneel wordt weergegeven. Dit is het HubSpot-account dat je koppelt, en je gebruikt deze als tenant-ID in Claude.
5. Plak de volledige URL uit Claude in het veld 'Issuer URL '.
6. Klik op 'EMA inschakelen'.
7. CControleer of de status op ‘Aan’ staat en of de opgeslagen issuer-URL correct is.

Als de EMA-instelling ontbreekt, raadpleeg dan het gedeelte over probleemoplossing hieronder.

4. Test en schakel de verbinding in Claude in

Nu EMA is geconfigureerd, kun je de verbinding in Claude testen:

1. Reer terug naar de instellingen voor beheerde autorisatie in Claude.
2. Voor de Tvelant-ID-veld de HubSpot-account-ID in die je hebt gekopieerd. Hoewel Claude dit veld als optioneel aanduidt, moet je het toch invullen voor de HubSpot-verbinding.
3. Klik op ‘Test uitvoeren ’ en controleer of elke fase is geslaagd.
4. KKlik op ‘Doorgaan’ om de instellingen voor rollen te openen. Selecteer welke rollen verbinding moeten maken via beheerde autorisatie. Controleer de selectie voordat je deze voor je organisatie inschakelt.
5. Clkkk Inschakelen.
6. Controleer in het Connector-d, controleertu of 'Beheerde autorisatie' is ingeschakeld en of onder 'Toegepaste rollen' de door u geselecteerde rollen worden weergegeven.
7. Klik onder 'Beheerde autorisatie' op 'Bewerken' naast 'Toepassingsgebieden' om de machtigingen die Claude kan aanvragen te bekijken en bij te werken.
8. ReBekijk de rollen met toegang om te controleren of de beoogde leden de connector kunnen vinden en er verbinding mee kunnen maken. Klik op Bewerken als u deze toegang moet wijzigen.

Beide rol-instellingen in Claude zijn van belang: leden moeten toegang hebben tot de connector en hun rol moet zijn opgenomen in de beheerde autorisatie om automatisch verbinding te kunnen maken. Leden moeten ook voldoen aan de hierboven beschreven vereisten voor het HubSpot-account, e-mailadres en installatietoestemming. Raadpleeg dit ondersteuningsartikel van Claude voor meer informatie over de rol-instellingen in Claude.

Controleer de gebruikerservaring

Vraag, voordat je de wijziging aan je organisatie aankondigt, een paar teamleden om de verbinding te controleren:

1. Open Claude in de organisatie waar beheerde autorisatie is ingeschakeld.
2. Copbedrijf tat HubSpot lijkt te zijn verbonden. Schakel indien nodig de connector voor het gesprek in.
3. Begin met een verzoek dat geen gegevens wijzigt, zoals: Met welk HubSpot-account en welke gebruiker ben ik verbonden? Wijzig geen gegevens.
4. Controof of het antwoord het verwachte HubSpot-account identificeert en, indien beschikbaar, de gebruikersgegevens van het teamlid.
5. Trd een verzoek om een record te lezen waartoe het teamlid toegang heeft in HubSpot.

Voor sommige gebruikersgegevens zijn aanvullende machtigingen vereist. Als die gegevens niet beschikbaar zijn, kun je nog steeds het gekoppelde account en het lezen van toegestane records controleren. Het ontbreken van optionele gegevens betekent op zichzelf niet dat de authenticatie is mislukt; verleen geen extra toegang alleen om deze controle te voltooien.

Teamleden die aan de toegangsvereisten voldoen, hoeven geen individueel HubSpot-inlogscherm of toestemmingsscherm voor de verbinding te doorlopen. EMA verwijdert geen goedkeuringsverzoeken die je configureert voor individuele toolacties, zoals updates van CRM-records.

Toegang beheren na de installatie

Om de toegang van een teamlid na de installatie bij te werken:

1. Open in je Claude-account het detailvenster van de Claude Connector.
2. Klik onder 'Beheerde authenticatie' op 'Bewerken' naast 'Toegepaste rollen' om te wijzigen welke rollen gebruikmaken van beheerde autorisatie.
3. Om te wijzigen wie de connector kan vinden en koppelen, klik je op 'Bewerken ' naast 'Rollen met toegang'. 
4. Klik op'Bewerken' naast 'Toepassingsgebieden'om te beheren welke machtigingen Claude kan aanvragen.

Bekijk in HubSpot het tabblad ‘Installatierechten’ om te wijzigen wie verbinding mag maken met de app, en het tabblad ‘Gegevensrechten’ om de gegevens en API’s te beheren waartoe de app toegang heeft. Elk lid blijft zijn of haar eigen HubSpot-rechten gebruiken.

Lees meer over de algemene mogelijkheden van de connector en gebruiksrichtlijnen in dit artikel.

De toegang van een lid verwijderen

Volg het offboardingproces van je organisatie in zowel Claude als HubSpot. Als je iemand uit de Claude-organisatie verwijdert, zorgt dit ervoor dat Claude geen nieuwe identiteitsverklaringen meer voor deze persoon uitgeeft. Een toegangstoken dat al is uitgegeven, blijft bruikbaar totdat het verloopt of wordt ingetrokken. Vertrouw dus niet alleen op een wijziging in het lidmaatschap voor het onmiddellijk intrekken van de toegang.

Voordat je het e-mailadres van een voormalig lid aan iemand anders toewijst, moet je het voormalige lid via het offboardingproces van je organisatie als HubSpot-gebruiker verwijderen. Als je alleen de toegang via de connector intrekt, wordt de oude HubSpot-gebruiker die aan dat e-mailadres is gekoppeld niet verwijderd.

Schakel EMA uit

Om EMA uit te schakelen:

1. In Claude open je de instellingen voor 'Beheerde autorisatie ' van de HubSpot-connector en klik je op 'Uitschakelen'.
2. Klik in je HubSpot-account op het instellingen-pictogram in de bovenste navigatiebalk.
3. Ga in het menu aan de linkerkant naarIntegraties >Gekoppelde apps >Goedgekeurde apps.
4. Zoek de connector, klik opToegang beheren en selecteer vervolgensGeavanceerd.
5. Klik om de schakelaar'Enterprise Managed Authentication (EMA) ' uit te schakelen en klik vervolgens op'Uitschakelen' om te bevestigen.

Het uitschakelen van beheerde autorisatie beëindigt de automatische verbinding. Leden die de connector nog nodig hebben, moeten individueel verbinding maken, afhankelijk van de instellingen van je organisatie en de installatierechten van HubSpot. Bestaande toegangstokens blijven mogelijk geldig totdat ze verlopen of worden ingetrokken.

Problemen oplossen

De onderstaande secties bieden hulp bij veelvoorkomende fouten die je tijdens het installatieproces kunt tegenkomen.

De EMA-instelling is niet beschikbaar

Controleer of u een HubSpot-superbeheerder bent, of u zich in het juiste HubSpot-account bevindt en of u de goedgekeurde HubSpot-connector voor Claude beheert. Als Enterprise Managed Authentication (EMA) nog steeds niet wordt weergegeven onder 'Geavanceerd', neem dan contact op met de HubSpot-ondersteuning om de beschikbaarheid voor uw account en connector te controleren.

De verbindingstest van Claude mislukt

Raadpleeg de onderstaande tabel voor meer informatie over wat u moet controleren, afhankelijk van de fase waarin de verbinding is mislukt:

Een invalid_grant fout op zich geeft niet de hoofdoorzaak aan. Controleer het account, de URL van de uitgever, of het e-mailadres overeenkomt en de toegangsinstellingen voordat je de test herhaalt.

Een teamlid kan HubSpot niet vinden of ziet nog steeds een 'Connect'-prompt

Controleer eerst of het teamlid zich in de juiste Claude-organisatie bevindt. Ga in je Claude-instellingen naar pagina 'Connector details'pagina de 'Rollen met toegang ' als de connector niet kan worden gevonden, en de 'Toegepaste rollen' als de verbinding niet via beheerde autorisatie tot stand komt.

Controleer in HubSpot of het teamlid een actief gebruikersaccount heeft, of het geverifieerde e-mailadres overeenkomt met het e-mailadres in Claude en of de installatierechten het toestaan om verbinding te maken.

Een teamlid maakt verbinding, maar heeft geen toegang tot de verwachte gegevens

Controleer de scopes van de connector in je Claude-account, de 'Gegevensmachtigingen' van de app in HubSpot en de HubSpot-machtigingen van het teamlid. Een automatische verbinding verleent geen toegang tot records of acties die het lid niet in HubSpot kan gebruiken.

Als het probleem zich blijft voordoen, neem dan contact op met de ondersteuning en vermeld welke bewerking is mislukt en wanneer dit is gebeurd. Vermeld geen toegangstokens of ondertekende identiteitsverklaringen in een ondersteuningsverzoek.