BetaConfigurar la autenticación gestionada por la empresa en Claude

La autenticación gestionada por la empresa (EMA) permite a los administradores configurar el conector de HubSpot para su organización de Claude. Los miembros que cumplan los requisitos verán entonces que HubSpot ya está conectado en Claude, sin necesidad de instalar el conector ni de aprobar ellos mismos una conexión por separado.

Con la autorización gestionada de Claude, los administradores eligen quién recibe acceso automático en Claude y gestionan el acceso del conector en HubSpot. Cada miembro se conecta con su propia cuenta de HubSpot, con los permisos de HubSpot de los que ya dispone. 

Antes de empezar

Antes de configurar la autenticación, comprueba los siguientes roles y pasos previos:

• Una organización de Claude Team o Enterprise que disponga de una autorización gestionada emitida por Claude para el conector de HubSpot.
• Un administrador con permisos para gestionar conectores en Claude y un superadministrador de HubSpot con permisos para gestionar aplicaciones aprobadas. Una misma persona puede desempeñar ambas funciones si es necesario.
• El conector de HubSpot está disponible en la configuraciónde conectores de tu organización de Claude.
• Un administrador ha instalado el conector de HubSpot en la cuenta de HubSpot que deseas conectar. Puedes empezar con esta conexión ya existente antes de configurar EMA para otros miembros del equipo.
• Una cuenta de usuario activa de HubSpot para cada miembro del equipo que vaya a utilizar el conector. La dirección de correo electrónico de Claude de cada miembro debe coincidir con su dirección de correo electrónico verificada en HubSpot.

Si un administrador no ha instalado el conector en la cuenta de HubSpot objetivo, sigue estas instrucciones para configurar el conector de HubSpot en Claude y completar la conexión inicial. A continuación, revisa la configuración de autorización y acceso de la aplicación antes de continuar.

Comprueba que cada miembro del equipo tenga el conjunto de permisos adecuado en HubSpot. En el caso de las herramientas compatibles actualmente, los miembros del equipo utilizan los mismos permisos y derechos de HubSpot en Claude, siempre que se respeten los ámbitos permitidos y los permisos de datos del conector.

Obtén más información sobrela configuración de autorizaciones gestionadas y los controles de roles de Claude.

Configuración de acceso en Claude y HubSpot

En la siguiente tabla se resumen los diferentes ajustes de acceso en Claude y HubSpot:

Conceder acceso a alguien al conector en Claude no crea un usuario de HubSpot ni amplía sus permisos en HubSpot. Comprueba los permisos de acceso en ambos servicios antes de habilitar la conexión para tu equipo.

Claude confirma que los administradores y usuarios del conector son miembros actuales de tu organización de Claude y que han configurado una dirección de correo electrónico. No confirma un inicio de sesión independiente a través de un proveedor de identidad ni comprueba los requisitos de autenticación multifactorial (MFA) de dicho proveedor ni las normas de inicio de sesión de HubSpot. Anthropic recomienda aplicar el inicio de sesión único (SSO) en Claude.

Configurar la autenticación gestionada

Los pasos que se indican a continuación te guían para comprobar los permisos actuales de tu conector, encontrar la URL del emisor de tu organización en la configuración de Claude, habilitar EMA y, a continuación, probar la conexión resultante.

1. Comprueba el acceso al conector en HubSpot

En primer lugar, comprueba los permisos actuales del conector de HubSpot para Claude:

1. En tu cuenta de HubSpot, haz clic en el icono de Configuración en la barra de navegación superior.
2. En el menú lateral izquierdo, ve a« Integraciones» >«Aplicaciones conectadas».
3. Haz clic en la pestaña«Aplicaciones aprobadas ».
4. Busca el conector de HubSpot para Claude y, a continuación, haz clic en«Gestionar acceso».
5. Haz clic en la pestaña«Permisos instalados » y comprueba quién puede conectarse a la aplicación. Incluye a los usuarios de HubSpot que deben recibir acceso automático a Claude. Los miembros también deben tener acceso al conector en Claude y pertenecer a un rol seleccionado para la autorización gestionada.
6. Haz clic en la pestaña«Permisos de datos » y revisa los datos y las API a los que puede acceder el conector. Añade los permisos que necesite tu equipo y, a continuación, guarda los cambios.

Los permisos de datos de las aplicaciones de HubSpot se aplican a todos los usuarios, incluidos los administradores. Los permisos necesarios no se pueden desactivar. Más información sobre cómo gestionar el acceso a las aplicaciones.

Mantén abierta esta página de HubSpot mientras accedes a tu cuenta de Claude en una pestaña aparte.

2. Consigue la URL del emisor de tu organización Claude

A continuación, deberás buscar y copiar la URL del emisor en la configuración de Claude; esta identifica la organización de Claude en la que HubSpot confiará a la hora de conectar a los miembros.

1. EnClaude, ve a «Configuración de la organización » > «Conectores»y selecciona «HubSpot».
2. En laconfiguración del conector, busca «Autorización gestionada»y abre su configuración.
3. En «Fuente de identidad», selecciona «Emitida por Claude».
4. a la URL completa del emisor que aparece en la pantalla de configuración. Si en Claude aparece «Configurar manualmente», despliégalo para ver la URL.

Mantén abierta esta página de configuración en una ventana o pestaña separada del navegador. Volverás a ello después de activar EMA en HubSpot.

3. Activar EMA en HubSpot

Utiliza la URL del emisor que has copiado para configurar EMA en HubSpot:

1. Vuelve al panel «Gestionar acceso» del conector en HubSpot.
2. Haz clic en la pestaña «Avanzado ».
3. Haz clic en el botón «Autenticación gestionada por la empresa (EMA)» para abrir la configuración.
4. Copia el ID de cuenta que aparece en el panel. Esta es la cuenta de HubSpot que vas a conectar y que utilizarás como ID de inquilino en Claude.
5. Pega la URL completa que te ha enviado Claude en el campo «URL del emisor ».
6. Haz clic en «Activar EMA».
7. Comprueba que el estado sea «Activo» y que la URL del emisor guardada sea correcta.

Si no aparece la configuración de EMA, consulta la sección de resolución de problemas que figura a continuación.

4. Comprueba y activa la conexión en Claude

Ahora que ya has configurado EMA, comprueba la conexión en Claude:

1. Vuelve a la configuración de la autorización gestionada en Claude.
2. En el campo«ID de cuenta de Ten », introduce el ID de cuenta de HubSpot que has copiado. Aunque Claude indica que este campo es opcional, deberías introducirlo de todos modos para la conexión con HubSpot.
3. Haz clic en «Ejecutar prueba » y comprueba que todas las etapas se hayan completado con éxito.
   
4. C:. Haz clic en «Continuar » para abrir la configuración de Roles. Selecciona qué roles deben conectarse mediante la autorización gestionada. Revisa la selección antes de activarla para tu organización.
5. Haz clic en «Habilitar».
   
   
6. En elpanel«Detalles del conector», comprueba que la opción «Autorización gestionada» esté activada y que en la ficha «Roles aplicados» aparezcan los roles que has seleccionado.
7. En «Autorización gestionada», haz clic en «Editar» junto a «Ámbitos» para revisar y actualizar los permisos que Claude puede solicitar.
8. Véasepara consultar los roles con acceso , a fin de confirmar que los miembros previstos puedan encontrar y conectar el conector. Haz clic en «Editar » si necesitas modificar este acceso.

Ambas configuraciones de roles de Claude son importantes: los miembros deben tener acceso al conector y su rol debe estar incluido en la autorización gestionada para que puedan conectarse automáticamente. Los miembros también deben cumplir los requisitos relativos a la cuenta de HubSpot, el correo electrónico y los permisos de instalación descritos anteriormente. Para obtener más información sobre la configuración de roles de Claude, consulta este artículo del servicio de asistencia de Claude.

Comprueba la experiencia de los socios

Antes de anunciar el cambio a tu organización, pide a algunos miembros del equipo que comprueben la conexión:

1. Abre Claude en la organización en la que esté habilitada la autorización gestionada.
2. Comprueba enque HubSpot aparece como conectado. Activa el conector para las conversaciones si es necesario.
3. Empieza con una solicitud que no modifique los datos, como por ejemplo: ¿Con qué cuenta y qué usuario de HubSpot estoy conectado? No modifiques ningún dato.
4. Comprueba que la respuesta identifique la cuenta de HubSpot esperada y, si están disponibles, los datos de usuario del miembro del equipo.
5. Prueba a realizar una solicitud para leer un registro al que el miembro del equipo tenga acceso en HubSpot.

Algunos datos de usuario requieren permisos adicionales. Si no se dispone de esos datos, aún así puedes consultar la cuenta vinculada y realizar una lectura autorizada del registro. El hecho de que falten datos opcionales no implica por sí solo que la autenticación haya fallado; no concedas acceso adicional solo para completar esta comprobación.

Los miembros del equipo que cumplan los requisitos de acceso no tienen que completar una pantalla individual de inicio de sesión en HubSpot ni de consentimiento para la conexión. EMA no elimina los prompts de autorización que configures para acciones concretas de las herramientas, como las actualizaciones de los registros del CRM.

Gestionar el acceso tras la configuración

Para actualizar los derechos de acceso de un miembro del equipo tras la configuración:

1. En tu cuenta de Claude, abre el panel de detalles de Claude Connector.
2. En «Autenticación gestionada», haz clic en «Editar» junto a «Roles aplicados» para cambiar qué roles utilizan la autorización gestionada.
3. Para cambiar quién puede encontrar y conectarse al conector, haz clic en «Editar » junto a «Roles con acceso». 
4. Haz clic en«Editar» junto a «Ámbitos» para gestionar los permisos que Claude puede solicitar.

En HubSpot, consulta la pestaña «Permisos de instalación» para modificar quién puede conectarse a la aplicación y la pestaña «Permisos de datos » para gestionar los datos y las API a los que puede acceder. Cada miembro sigue utilizando sus propios permisos de HubSpot.

Retirar el acceso a un miembro

Sigue el proceso de baja de tu organización tanto en Claude como en HubSpot. Al eliminar a una persona de la organización Claude, se impide que Claude emita nuevas afirmaciones de identidad para ella. Un token de acceso que ya se haya emitido puede seguir siendo válido hasta que caduque o sea revocado, por lo que no debes basarte únicamente en un cambio de estado de membresía para retirar el acceso de forma inmediata.

Antes de asignar la dirección de correo electrónico de un antiguo miembro a otra persona, elimina a dicho miembro como usuario de HubSpot siguiendo el proceso de baja de tu organización. El hecho de eliminar únicamente su acceso al conector no elimina el antiguo usuario de HubSpot asociado a esa dirección de correo electrónico.

Desactivar EMA

Para desactivar EMA:

1. EnClaude, abre la configuración de autorización gestionada del conector de HubSpot y haz clic en «Desactivar».
2. En tu cuenta de HubSpot, haz clic en el icono de Configuración en la barra de navegación superior.
3. En el menú lateral izquierdo, ve a«Integraciones » >,«Aplicaciones conectadas » >y«Aplicaciones aprobadas».
4. Busca el conector, haz clic en«Gestionar acceso» y, a continuación, selecciona«Avanzado».
5. Haz clic para desactivar el interruptorde autenticación gestionada por Enterprise (EMA) y, a continuación, haz clic en«Desactivar» para confirmar.

Al desactivar la autorización gestionada, se interrumpe la conexión automática. Los miembros que aún necesiten el conector deberán conectarse de forma individual, siempre que lo permitan la configuración de tu organización y los permisos de instalación de HubSpot. Los tokens de acceso existentes pueden seguir siendo válidos hasta que caduquen o sean revocados.

Solución de problemas

En los apartados siguientes se ofrecen indicaciones sobre los errores más habituales que pueden surgir durante el proceso de configuración.

La configuración de EMA no está disponible

Comprueba que eres un superadministrador de HubSpot, que estás en la cuenta correcta de HubSpot y que gestionas el conector de HubSpot aprobado para Claude. Si la autenticación gestionada por Enterprise (EMA) sigue sin aparecer en la sección «Avanzado», ponte en contacto con el servicio de asistencia de HubSpot para comprobar su disponibilidad para tu cuenta y tu conector.

La prueba de conexión de Claude falla

Consulta la tabla siguiente para obtener más información sobre qué aspectos debes comprobar en función de la fase en la que se haya producido el fallo de conexión:

Un invalid_grant un error por sí solo no permite identificar la causa raíz. Comprueba la cuenta, la URL del emisor, la coincidencia del correo electrónico y la configuración de acceso antes de repetir la prueba.

Un miembro del equipo no encuentra HubSpot o sigue viendo un prompt de Connect

En primer lugar, comprueba que el miembro pertenezca a la organización Claude prevista. En la configuración de Claude, en la página de detalles del conector , comprueba los «Roles con acceso» si no encuentran el conector y los «Roles aplicados» si no se conectan mediante autorización gestionada.

En HubSpot, comprueba que tengan una cuenta de usuario activa, que su correo electrónico verificado coincida con el de Claude y que los permisos de instalación les permitan conectarse.

Un miembro del equipo se conecta, pero no puede acceder a los datos esperados

Revisa los ámbitos del conector en tu cuenta de Claude, los permisos de datos de la aplicación en HubSpot y los permisos de HubSpot de los miembros del equipo. La conexión automática no concede acceso a registros ni a acciones que el miembro no pueda utilizar en HubSpot.

Si el problema persiste, ponte en contacto con el servicio de asistencia indicando la operación que ha fallado y la hora en que se produjo el fallo. No incluyas tokens de acceso ni afirmaciones de identidad firmadas en una solicitud de asistencia.