Configurar a autenticação gerenciada pela empresa no Claude

A autenticação gerida pela empresa (EMA) permite que os administradores configurem o conector da HubSpot para a sua organização Claude. Os membros elegíveis veem o HubSpot já conectado no Claude, sem instalar o conector ou aprovar uma conexão separada.

Com a autorização gerenciada emitida pelo Claude, os administradores escolhem quem recebe acesso automático no Claude e gerenciam o acesso do conector no HubSpot. Cada membro se conecta como seu próprio usuário do HubSpot, com suas permissões existentes do HubSpot. 

Antes de começar

Antes de configurar a autenticação, confirme as seguintes funções e etapas de pré-requisito:

• Uma organização Claude Team ou Enterprise com autorização gerenciada emitida por Claude disponível para o conector da HubSpot.
• Um administrador que pode gerenciar conectores no Claude e um Superadministrador do HubSpot que pode gerenciar aplicativos aprovados. Uma pessoa pode desempenhar essas duas funções, se necessário.
• O conector da HubSpot está disponível nas configurações do Conector da organização Claude.
• O conector da HubSpot foi instalado por um administrador na conta da HubSpot que você deseja conectar. Você pode começar com essa conexão existente antes de configurar a EMA para outros membros da equipe.
• Uma conta de usuário ativa da HubSpot para cada membro da equipe que usará o conector. O endereço de e-mail Claude de cada membro deve corresponder ao endereço de e-mail verificado do HubSpot.

Se um administrador não tiver instalado o conector na conta de destino da HubSpot, siga estas instruções para configurar o conector da HubSpot para que Claude conclua a conexão inicial. Em seguida, revise as configurações de aprovação e acesso do aplicativo antes de continuar.

Verifique se cada membro da equipe tem o conjunto de permissões correto no HubSpot. Para as ferramentas atualmente compatíveis, os membros da equipe usam as mesmas permissões e direitos do HubSpot em Claude, sujeitos aos escopos e permissões de dados permitidos do conector.

Saiba mais sobre as configurações de autorização gerenciada e os controles de função de Claude.

Configurações de acesso no Claude e no HubSpot

A tabela abaixo descreve as diferentes configurações de acesso no Claude e no HubSpot:

Conceder a alguém acesso ao conector em Claude não cria um usuário do HubSpot nem expande suas permissões do HubSpot. Revise o acesso em ambos os serviços antes de habilitar a conexão para sua equipe.

Claude confirma que os administradores e usuários do conector são membros atuais da sua organização Claude com o endereço de email que eles configuraram. Ele não confirma um login com provedor de identidade separado nem verifica os requisitos de autenticação multifator (MFA) desse provedor ou as regras de login do HubSpot. A Anthropic recomenda impor o logon único (SSO) no Claude.

Configurar autenticação gerenciada

As etapas abaixo orientam você sobre como confirmar suas permissões de conector atuais, localizar o URL do emissor da sua organização nas configurações do Claude, habilitar a EMA e testar a conexão resultante.

1. Revisar o acesso do conector no HubSpot

Primeiro, confirme as permissões atuais para o conector da HubSpot para Claude:

1. Na sua conta HubSpot, clique no ícone de settings icon na barra de navegação superior.
2. No menu da barra lateral esquerda, acesse Integrações > Aplicativos conectados.
3. Clique na guia Aplicativos aprovados .
4. Encontre o conector HubSpot para Claude e clique em Gerenciar acesso.
5. Clique na guia Permissões instaladas e revise quem pode se conectar ao aplicativo. Inclua os usuários do HubSpot que devem receber acesso automático no Claude. Os membros também devem ter acesso ao conector em Claude e pertencer a uma função selecionada para autorização gerenciada.
6. Clique na guia Permissões de dados , revise os dados e as APIs que o conector pode acessar. Adicione as permissões de que sua equipe precisa e salve as alterações.

As permissões de dados do aplicativo da HubSpot se aplicam a todos os usuários, incluindo administradores. As permissões necessárias não podem ser desativadas. Saiba mais sobre como gerenciar o acesso aos aplicativos.

Mantenha esta página do HubSpot aberta enquanto você acessa sua conta Claude em uma guia separada.

2. Obtenha a URL do emissor da sua organização Claude

Em seguida, você encontrará e copiará o URL do emissor de suas configurações do Claude, que identifica a organização do Claude na qual a HubSpot confiará ao conectar membros.

1. No laude, navegue até Conectores de configurações > da organização e selecione HubSpot.
2. Nasconfigurações do navegador, localize Autorização gerenciada e abra sua configuração.
3. Em Fonte de identidade, selecione Claude-emitido.
4. Copy o URL completo do emissor mostrado na tela de configuração. Se Claude mostrar Configurar manualmente, expanda-o para visualizar o URL.

Mantenha esta página de configuração aberta em uma janela ou guia separada do navegador. Você retornará a ela depois de ativar a EMA no HubSpot.

3. Ativar EMA no HubSpot

Use a URL do emissor que você copiou para configurar a EMA no HubSpot:

1. Return para o painel Gerenciar acesso do conector no HubSpot.
2. Clique na guia Avançado .
3. Clique na opção EMA (Autenticação gerenciada pela empresa) para abrir a configuração.
4. Oopy o ID da conta mostrado no painel. Esta é a conta da HubSpot que você está conectando e você a usará como ID de locatário em Claude.
5. Cole o URL completo de Claude no campo URL do emissor .
6. Clique em Ativar EMA.
7. Confirmese o status está Ativado e se o URL do emissor salvo está correto.

Se a configuração EMA estiver ausente, confira a seção de solução de problemas abaixo.

4. Testar e habilitar a conexão no Claude

Agora que a EMA está configurada, teste a conexão no Claude:

1. Voltepara a configuração de autorização gerenciada em Claude.
2. Para o campo ID daequipe , insira a ID da conta da HubSpot que você copiou. Embora Claude rotule esse campo como opcional, você ainda deve inseri-lo para a conexão do HubSpot.
3. Clique em Executar teste e verifique se todas as fases foram bem-sucedidas.
4. Olamber Continue para abrir a configuração de funções. Selecione quais funções devem se conectar por meio de autorização gerenciada. Revise a seleção antes de habilitá-la para sua organização.
5. Click Habilitar.
6. No painel Detalhes do conector , confirme se a Autorização gerenciada está ativada e Funções aplicadas lista as funções selecionadas.
7. Em Autorização gerenciada, clique em Editar ao lado de Escopos para revisar e atualizar as permissões que Claude pode solicitar.
8. Exibir Funções com acesso para confirmar se os membros pretendidos podem localizar e conectar o conector. Clique em Editar se precisar alterar esse acesso.

Ambas as configurações de função Claude são importantes: os membros precisam acessar o conector e sua função deve ser incluída na autorização gerenciada para se conectar automaticamente. Os membros também devem atender aos requisitos de conta, e-mail e permissão de instalação da HubSpot descritos acima. Para saber mais sobre as configurações de função de Claude, confira este artigo de Suporte da Claude.

Confira a experiência do membro

Antes de anunciar a alteração para sua organização, peça a alguns membros da equipe para verificar a conexão:

1. Open Claude na organização em que a autorização gerenciada está habilitada.
2. Confirm that HubSpot parece conectado. Habilite o conector para a conversa, se necessário.
3. Start com uma solicitação que não altera os dados, como: Com qual conta e usuário da HubSpot estou conectado? Não altere nenhum dado.
4. Confirmarque a resposta identifica a conta da HubSpot esperada e, se disponível, os detalhes do usuário do membro da equipe.
5. Try uma solicitação para ler um registro que o membro da equipe pode acessar no HubSpot.

Alguns detalhes do usuário exigem permissões adicionais. Se esses detalhes não estiverem disponíveis, você ainda poderá verificar a conta conectada e uma leitura de registro permitido. A falta de detalhes opcionais por si só não significa falha na autenticação; Não conceda acesso extra apenas para concluir esta verificação.

Os membros da equipe que atendem aos requisitos de acesso não precisam preencher uma tela individual de login ou consentimento de conexão do HubSpot. A EMA não remove os prompts de aprovação configurados para ações individuais da ferramenta, como atualizações de registros do CRM.

Gerenciar o acesso após a configuração

Para atualizar o acesso de um membro da equipe após a configuração:

1. Na sua conta Claude, abra o painel de detalhes do Conector Claude.
2. Em Autenticação gerenciada, clique em Editar ao lado de Funções aplicadas para alterar quais funções usam autorização gerenciada.
3. Para alterar quem pode encontrar e conectar o conector, clique em Editar ao lado de Funções com acesso.
4. Clique em Editar ao lado de Escopos para gerenciar quais permissões Claude pode solicitar.

No HubSpot, revise a guia Permissões de instalação para alterar quem tem permissão para se conectar ao aplicativo e a guia Permissões de dados para gerenciar os dados e as APIs que ele pode acessar. Cada membro continua a usar suas próprias permissões do HubSpot.

Saiba mais sobre os recursos gerais do conector e as diretrizes de uso neste artigo.

Remover o acesso de um membro

Siga o processo de desligamento da sua organização no Claude e no HubSpot. Remover uma pessoa da organização Claude impede que Claude emita novas declarações de identidade para ela. Um token de acesso que já foi emitido pode permanecer utilizável até expirar ou ser revogado, portanto, não confie apenas em uma alteração de participação para remoção imediata do acesso.

Antes de atribuir o endereço de e-mail de um ex-membro a outra pessoa, remova o ex-membro como usuário do HubSpot através do processo de remoção da sua organização. Remover apenas o acesso ao conector não remove o antigo usuário da HubSpot associado a esse endereço de e-mail.

Desligue a EMA

Para desativar a EMA:

1. Em Claude, abra as configurações de Autorização gerenciada do conector do HubSpot e clique em Desativar.
2. Na sua conta HubSpot, clique no ícone de settings icon na barra de navegação superior.
3. No menu da barra lateral esquerda, acesse Integrações >Aplicativos > conectados Aplicativos aprovados.  
4. Encontre o conector, clique em Gerenciar acesso e selecione Avançado.
5. Clique para desativar a opção Autenticação gerenciada (EMA) empresarial e, em seguida, clique em Desativar para confirmar.

Desativar a autorização gerenciada encerra a conexão automática. Os membros que ainda precisam do conector devem se conectar individualmente, sujeito às configurações da sua organização e às permissões de instalação do HubSpot. Os tokens de acesso existentes podem permanecer válidos até expirarem ou serem revogados.

Solução de problemas

As seções abaixo fornecem orientação sobre erros comuns que você pode encontrar durante o processo de configuração.

A configuração da EMA não está disponível

Confirme que você é um Superadministrador do HubSpot, que está na conta correta da HubSpot e que está gerenciando o conector HubSpot aprovado para Claude. Se a autenticação gerenciada Enterprise (EMA) ainda não aparecer em Avançado, contato o suporte da HubSpot para verificar a disponibilidade da sua conta e conector.

O teste de conexão de Claude falha

Consulte a tabela abaixo para obter detalhes sobre o que verificar com base no estágio em que a conexão falhou:

Um erro de invalid_grant sozinho não identifica a causa raiz. Verifique as configurações de conta, URL do emissor, correspondência de e-mail e acesso antes de repetir o teste.

Um membro da equipe não consegue encontrar o HubSpot ou ainda vê um prompt de conexão

Primeiro, verifique se o membro está na organização Claude pretendida. Nas configurações do Claude, na página de detalhes do conector, examine Funções com acesso, se não conseguirem encontrar o conector, e Funções aplicadas, se não estiverem se conectando por meio de autorização gerenciada.

No HubSpot, confirme se eles têm uma conta de usuário ativa, se o e-mail verificado corresponde ao e-mail Claude e se as permissões de instalação permitem que eles se conectem.

Um membro da equipe se conecta, mas não pode acessar os dados esperados

Revise os escopos do conector na sua conta Claude, as permissões de dados do aplicativo no HubSpot e as permissões do HubSpot do membro da equipe. A conexão automática não concede acesso a registros ou ações que o membro não pode usar no HubSpot.

Se o problema persistir, entre em contato com o suporte com a operação que falhou e a hora em que ela ocorreu. Não inclua tokens de acesso ou declarações de identidade assinadas em uma solicitação de suporte.