Configurer l’authentification gérée par l’entreprise dans Claude

L'authentification gérée par l'entreprise (EMA) permet aux administrateurs de configurer le connecteur HubSpot pour leur organisation Claude. Les membres éligibles voient alors HubSpot déjà connecté dans Claude, sans installer le connecteur ni approuver eux-mêmes une connexion séparée.

Avec l’autorisation de gestion émise par Claude, les administrateurs choisissent qui reçoit l’accès automatique dans Claude et gèrent l’accès du connecteur dans HubSpot. Chaque membre connecte en tant qu’utilisateur HubSpot disposant de ses autorisations HubSpot existantes. 

Avant de commencer

Avant de configurer l’authentification, vérifiez les rôles et les étapes prérequises suivants :

• Une organisation Claude Team ou Entreprise avec une autorisation de gestion émise par Claude disponible pour le connecteur HubSpot.
• Un administrateur capable de gérer les connecteurs dans Claude et un super administrateur HubSpot chargé de gérer les applications approuvées. Une personne peut remplir ces deux rôles si nécessaire.
• Le connecteur HubSpot est disponible dans les paramètres Connecteur de votre organisation Claude.
• Le connecteur HubSpot a été installé par un administrateur dans le compte HubSpot que vous souhaitez connecter. Vous pouvez commencer par cette connexion existante avant de configurer EMA pour les autres membres de l’équipe.
• Un compte utilisateur HubSpot actif pour chaque membre de l’équipe qui utilisera le connecteur. L’adresse e-mail Claude de chaque membre doit correspondre à son adresse e-mail HubSpot vérifiée.

Si un administrateur n’a pas installé le connecteur dans le compte HubSpot cible, suivez ces instructions pour configurer le connecteur HubSpot pour que Claude puisse effectuer la connexion initiale. Ensuite, vérifiez les paramètres d’approbation et d’accès de l’application avant de continuer.

Vérifiez que chaque membre de l’équipe dispose des autorisations appropriées définies dans HubSpot. Pour les outils actuellement pris en charge, les membres de l’équipe utilisent les mêmes autorisations et droits HubSpot dans Claude, sous réserve des domaines autorisés et des autorisations de données du connecteur.

Découvrez-en davantage sur les paramètres d’autorisation gérée et les contrôles de rôle de Claude.

Paramètres d’accès dans Claude et HubSpot

Le tableau ci-dessous présente les différents paramètres d’accès dans Claude et HubSpot :

Donner accès au connecteur dans Claude ne crée pas d’utilisateur HubSpot et n’étend pas ses autorisations HubSpot. Vérifiez l’accès dans les deux services avant d’activer la connexion pour votre équipe.

Claude confirme que les administrateurs et les utilisateurs du connecteur sont des membres actuels de votre organisation Claude et disposent de l’adresse e-mail qu’ils ont configurée. Il ne confirme pas une connexion distincte entre le fournisseur d’identité, ni ne vérifie les exigences d’authentification à plusieurs facteurs (MFA) de ce fournisseur ou les règles de connexion de HubSpot. Anthropic recommande d’appliquer l’authentification unique ( authentification unique ) dans Claude.

Configurer l’authentification gérée

Les étapes ci-dessous vous expliquent comment confirmer vos autorisations de connecteur actuelles, trouver l’URL d’émetteur de votre organisation dans vos paramètres Claude, activer EMA, puis tester la connexion résultante.

1. Vérifier l’accès du connecteur dans HubSpot

Tout d’abord, confirmez les autorisations actuelles du connecteur HubSpot pour Claude :

1. Dans votre compte HubSpot, cliquez sur l'icône Paramètres dans la barre de navigation principale.
2. Dans le menu latéral de gauche, accédez à Applications connectées à Intégrations >. 
3. Cliquez sur l’onglet Applications approuvées .
4. Recherchez le connecteur HubSpot pour Claude, puis cliquez sur Gérer l’accès.
5. Cliquez sur l’onglet Autorisations installées , puis sur qui peut se connecter à l’application. Incluez les utilisateurs HubSpot qui devraient recevoir un accès automatique dans Claude. Les membres doivent également avoir accès au connecteur dans Claude et appartenir à un rôle sélectionné pour l’autorisation gérée.
6. Cliquez sur l’onglet Autorisations des données , vérifiez les données et les API auxquelles le connecteur peut accéder. Ajoutez les autorisations dont votre équipe a besoin, puis enregistrez vos modifications.

Les autorisations de données d’application de HubSpot s’appliquent à tous les utilisateurs, y compris les administrateurs. Les autorisations requises ne peuvent pas être désactivées. Découvrez-en davantage sur la gestion des accès aux applications.

Gardez cette page HubSpot ouverte pendant que vous accédez à votre compte Claude dans un onglet séparé.

2. Obtenez l’URL de l’émetteur de votre organisation Claude

Ensuite, vous trouverez et copierez l’URL de l’émetteur dans vos paramètres Claude, qui identifie l’organisation Claude à laquelle HubSpot fera confiance pour connecter les membres.

1. Enfin, accédez à Connecteurs des paramètres de > l’organisation et sélectionnez HubSpot.
2. Danslesparamètres du lecteur, recherchez l’autorisation gérée et ouvrez sa configuration.
3. Sous Source d’identité, sélectionnez Émis par Claude.
4. Copy l’URL complète de l’émetteur affichée dans l’écran de configuration. Si Claude affiche Configurer manuellement, développez-le pour afficher l’URL.

Gardez cette page de configuration ouverte dans une fenêtre ou un onglet de navigateur séparé. Vous y reviendrez après avoir activé EMA dans HubSpot.

3. Activer l’EMA dans HubSpot

Utilisez l’URL de l’émetteur que vous avez copiée pour configurer EMA dans HubSpot :

1. Retvotren au panneau Gérer l’accès du connecteur dans HubSpot.
2. Cliquez sur l’onglet Avancé .
3. Cliquez sur le bouton d’authentification gérée par l’Entreprise (EMA) pour ouvrir la configuration.
4. Lopy l’ID de compte affiché dans le panneau. Il s’agit du compte HubSpot que vous connectez et vous l’utiliserez comme ID de locataire dans Claude.
5. Collez l’URL complète de Claude dans le champ URL de l’émetteur .
6. Cliquez sur Activer EMA.
7. S’assurer que le statut est Activé et que l’URL de l’émetteur enregistré est correcte.

Si le paramètre EMA est manquant, consultez la section de dépannage ci-dessous.

4. Tester et activer la connexion dans Claude

Maintenant que l’EMA est configuré, testez la connexion dans Claude :

1. Retournezà la configuration de l’autorisation gérée dans Claude.
2. Dans le champ ID de Tenant , saisissez l’ID de compte HubSpot que vous avez copié. Bien que Claude dise ce champ comme facultatif, vous devez toujours le saisir pour la connexion HubSpot.
3. Cliquez sur Exécuter le test et vérifiez la réussite de chaque phase.
4. Lcliquez sur Poursuivez pour ouvrir la configuration des rôles. Sélectionnez les rôles qui doivent se connecter par le biais d’autorisations gérées. Vérifiez la sélection avant de l’activer pour votre organisation.
5. Click Activer.
6. Dans le panneau Détail du connecteur , confirmez que l’autorisation gérée est activée et que Rôles appliqués répertorie les rôles que vous avez sélectionnés.
7. Sous Autorisations gérées, cliquez sur Modifier à côté de Domaines pour vérifier et mettre à jour les autorisations que Claude peut demander.
8. Review Rôles avec accès pour confirmer que les membres prévus peuvent trouver et connecter le connecteur. Cliquez sur Modifier si vous devez modifier cet accès.

Les deux paramètres de rôle Claude sont importants : les membres doivent avoir accès au connecteur et leur rôle doit être inclus dans l’autorisation gérée pour se connecter automatiquement. Les membres doivent également satisfaire aux exigences en matière d’autorisation d’utilisation d’un compte, d’une adresse e-mail et d’installation décrites ci-dessus. Pour en savoir plus sur les paramètres du rôle de Claude, consultez cet article de support Claude.

Vérifiez l’expérience des membres

Avant d’annoncer le changement à votre organisation, demandez à quelques membres de l’équipe de vérifier le lien :

1. Open Claude dans l’organisation où l’autorisation de gestion est activée.
2. HubSpot semble résolument connecté. Activez le connecteur pour la conversation si nécessaire.
3. S’adresse à une demande qui ne modifie pas les données, comme : En tant que quel compte HubSpot et quel utilisateur suis-je connecté ? Ne modifiez aucune donnée.
4. Confirmationque la réponse identifie le compte HubSpot attendu et, si elles sont disponibles, les coordonnées utilisateur du membre de l’équipe.
5. Encas de demande de lecture d’une fiche d’informations à laquelle le membre de l’équipe peut accéder dans HubSpot.

Certains détails de l’utilisateur nécessitent des autorisations supplémentaires. Si ces détails ne sont pas disponibles, vous pouvez toujours vérifier le compte connecté et une lecture de fiche d’informations autorisée. L’absence de détails facultatifs ne signifie pas à elle seule que l’authentification a échoué ; N’accordez pas d’accès supplémentaire juste pour terminer cette vérification.

Les membres de l’équipe qui répondent aux exigences d’accès n’ont pas besoin de remplir un écran individuel de consentement de connexion ou de connexion à HubSpot. EMA ne supprime pas les prompts d’approbation que vous configurez pour des actions d’outils individuelles, telles que les mises à jour des fiches d’informations du CRM.

Gérer l’accès après la configuration

Pour mettre à jour l’accès d’un membre de l’équipe après la configuration :

1. Dans votre compte Claude, ouvrez le panneau de détails du connecteur Claude.
2. Sous Authentification gérée, cliquez sur Modifier à côté de Rôles appliqués pour modifier les rôles qui utilisent l’autorisation gérée.
3. Pour modifier qui peut trouver et connecter le connecteur, cliquez sur Modifier à côté de Rôles avec accès.
4. Cliquez sur Modifier à côté de Domaines pour gérer les autorisations que Claude peut demander.

Dans HubSpot, passez en revue l’onglet Autorisations d’installation pour modifier les personnes autorisées à se connecter à l’application et l’onglet Autorisations de données pour gérer les données et les API auxquelles elle peut accéder. Chaque membre continue d’utiliser ses propres autorisations HubSpot.

Pour en savoir plus sur les capacités générales du connecteur et les conseils d’utilisation, consultez cet article.

Supprimer l’accès d’un membre

Suivez le processus d’offboarding de votre entreprise à la fois dans Claude et dans HubSpot. La suppression d’une personne de l’organisation Claude empêche Claude d’émettre de nouvelles affirmations d’identité pour elle. Un jeton d’accès déjà émis peut rester utilisable jusqu’à son expiration ou sa révocation. Par conséquent, ne comptez pas uniquement sur une modification du contrôle d’accès pour supprimer immédiatement l’accès.

Avant d’attribuer l’adresse e-mail d’un ancien membre à quelqu’un d’autre, supprimez-le en tant qu’utilisateur HubSpot par le biais du processus d’offboarding de votre organisation. Supprimer uniquement son accès au connecteur ne supprime pas l’ancien utilisateur HubSpot associé à cette adresse e-mail.

Désactiver EMA

Pour désactiver EMA :

1. Enfin, ouvrez les paramètres d’autorisation gérée du connecteur HubSpot et cliquez sur Désactiver.
2. Dans votre compte HubSpot, cliquez sur l'icône Paramètres dans la barre de navigation principale.
3. Dans le menu latéral de gauche, accédez à Intégrations >, Applications connectées >, Applications approuvées.  
4. Recherchez le connecteur, cliquez sur Gérer l’accès, puis sélectionnez Options avancées.
5. Cliquez pour désactiver l’option Entreprise managed authentication (EMA), puis cliquez sur Désactiver pour confirmer.

La désactivation des autorisations gérées met fin à la connexion automatique. Les membres qui ont toujours besoin du connecteur doivent se connecter individuellement, en fonction des paramètres de votre organisation et des autorisations d’installation de HubSpot. Les jetons d’accès existants peuvent rester valides jusqu’à leur expiration ou leur révocation.

Dépannage

Les sections ci-dessous fournissent des conseils sur les erreurs courantes que vous pouvez rencontrer lors du processus de configuration.

Le paramètre EMA n’est pas disponible

Vérifiez que vous êtes un super administrateur HubSpot, que vous disposez du compte HubSpot approprié et que vous gérez le connecteur HubSpot approuvé pour Claude. Si l’authentification gérée par l’Entreprise (EMA) n’apparaît toujours pas sous Avancé, contactez le support HubSpot pour vérifier la disponibilité de votre compte et de votre connecteur.

Le test de connexion de Claude échoue

Consultez le tableau ci-dessous pour plus de détails sur ce qu’il faut vérifier en fonction de la phase où la connexion a échoué :

Une erreur invalid_grant seule ne suffit pas à identifier la cause première. Vérifiez le compte, l’URL de l’émetteur, la correspondance d’e-mail et les paramètres d’accès avant de repasser l’examen.

Un membre de l’équipe ne trouve pas HubSpot ou voit toujours une prompt de connexion

Tout d’abord, vérifiez que le membre fait partie de l’organisation prévue par Claude. Dans vos paramètres Claude, sur la page Détails du connecteur, consultez Rôles avec accès s’ils ne trouvent pas le connecteur et Rôles appliqués s’ils ne se connectent pas via une autorisation gérée.

Dans HubSpot, vérifiez qu’il dispose d’un compte utilisateur actif, que son e-mail vérifié correspond à son e-mail Claude et que les autorisations d’installation lui permettent de se connecter.

Un membre de l’équipe entre en contact mais ne peut pas accéder aux données attendues

Vérifiez les périmètres d’accès du connecteur dans votre compte Claude, les autorisations de données de l’application dans HubSpot et les autorisations HubSpot du membre de l’équipe. La connexion automatique ne donne pas accès aux fiches d’informations ou actions que le membre ne peut pas utiliser dans HubSpot.

Si le problème persiste, contactez l’équipe de support avec l’opération qui a échoué et l’heure à laquelle elle s’est produite. N’incluez pas de jetons d’accès ou d’assertions d’identité signée dans une demande de support.