Skonfiguruj uwierzytelnianie zarządzane przez przedsiębiorstwo w Claude

Uwierzytelnianie zarządzane przez przedsiębiorstwo (EMA) pozwala administratorom skonfigurować łącznik HubSpot dla swojej organizacji w Claude. Uprawnieni członkowie widzą wtedy w Claude, że HubSpot jest już podłączony, bez konieczności samodzielnego instalowania łącznika lub zatwierdzania osobnego połączenia.

Dzięki zarządzanej autoryzacji wydanej przez Claude administratorzy wybierają, kto otrzyma automatyczny dostęp w Claude, oraz zarządzają dostępem łącznika w HubSpot. Każdy użytkownik loguje się jako własny użytkownik HubSpot, korzystając ze swoich istniejących uprawnień w HubSpot. 

Zanim zaczniesz

Przed skonfigurowaniem uwierzytelniania sprawdź następujące role i wymagane czynności wstępne:

• Organizacja typu Claude Team lub Enterprise z zarządzaną autoryzacją wydaną przez Claude, dostępną dla łącznika HubSpot.
• Administrator, który może zarządzać łącznikami w Claude, oraz superadministrator HubSpot, który może zarządzać zatwierdzonymi aplikacjami. W razie potrzeby obie te role może pełnić jedna osoba.
• Łącznik HubSpot jest dostępny w ustawieniachłączników Twojej organizacji Claude.
• Łącznik HubSpot został zainstalowany przez administratora na koncie HubSpot, z którym chcesz się połączyć. Możesz zacząć od tego istniejącego połączenia przed skonfigurowaniem EMA dla innych członków zespołu.
• Aktywne konto użytkownika HubSpot dla każdego członka zespołu, który będzie korzystał z łącznika. Adres e-mail każdego członka w Claude musi być zgodny z jego zweryfikowanym adresem e-mail w HubSpot.

Jeśli administrator nie zainstalował łącznika na docelowym koncie HubSpot, postępuj zgodnie z tymi instrukcjami, aby skonfigurować łącznik HubSpot dla Claude i zakończyć wstępne połączenie. Następnie sprawdź ustawienia zatwierdzania i dostępu aplikacji przed kontynuowaniem.

Sprawdź, czy każdy członek zespołu ma odpowiedni zestaw uprawnień w HubSpot. W przypadku obecnie obsługiwanych narzędzi członkowie zespołu korzystają w Claude z tych samych uprawnień i uprawnień w HubSpot, z zastrzeżeniem dozwolonych zakresów i uprawnień dotyczących danych dla danego łącznika.

Dowiedz się więcej oustawieniach zarządzania autoryzacją i kontroli ról w Claude.

Ustawienia dostępu w Claude i HubSpot

Poniższa tabela przedstawia różne ustawienia dostępu w Claude i HubSpot:

Przyznanie komuś dostępu do łącznika w Claude nie powoduje utworzenia użytkownika HubSpot ani rozszerzenia jego uprawnień w HubSpot. Przed włączeniem połączenia dla swojego zespołu sprawdź uprawnienia dostępu w obu usługach.

Claude potwierdza, że administratorzy i użytkownicy łącznika są aktualnymi członkami Twojej organizacji w Claude i posiadają skonfigurowane adresy e-mail. Nie potwierdza to jednak logowania za pośrednictwem oddzielnego dostawcy tożsamości ani nie sprawdza wymagań tego dostawcy dotyczących uwierzytelniania wieloskładnikowego (MFA) ani zasad logowania HubSpot. Firma Anthropic zaleca wdrożenie logowania jednokrotnego (SSO) w Claude.

Skonfiguruj uwierzytelnianie zarządzane

Poniższe kroki pokazują, jak sprawdzić aktualne uprawnienia łącznika, znaleźć adres URL wydawcy Twojej organizacji w ustawieniach Claude, włączyć EMA, a następnie przetestować powstałe połączenie.

1. Sprawdź uprawnienia łącznika w HubSpot

Najpierw sprawdź aktualne uprawnienia łącznika HubSpot dla Claude:

1. Na koncie HubSpot kliknij ikonę ustawień w górnym pasku nawigacyjnym.
2. W menu po lewej stronie przejdź do sekcji Integracje >Połączone aplikacje.
3. Kliknij kartęZatwierdzone aplikacje.
4. Znajdź łącznik HubSpot dla Claude, a następnie kliknij opcjęZarządzaj dostępem.
5. Kliknij kartę„Zainstalowane uprawnienia ” i sprawdź, kto może połączyć się z aplikacją. Dodaj użytkowników HubSpot, którzy powinni otrzymać automatyczny dostęp w Claude. Członkowie muszą również mieć dostęp do łącznika w Claude i należeć do roli wybranej do zarządzania uprawnieniami.
6. Kliknij kartę„Uprawnienia do danych ” i sprawdź, do jakich danych i interfejsów API ma dostęp łącznik. Dodaj uprawnienia potrzebne Twojemu zespołowi, a następnie zapisz zmiany.

Uprawnienia dotyczące danych aplikacji HubSpot mają zastosowanie do wszystkich użytkowników, w tym administratorów. Wymaganych uprawnień nie można wyłączyć. Dowiedz się więcej o zarządzaniu dostępem do aplikacji.

Pozostaw tę stronę HubSpot otwartą, a następnie przejdź do swojego konta Claude w osobnej karcie.

2. Uzyskaj adres URL wydawcy swojej organizacji w Claude

Następnie znajdź i skopiuj adres URL wydawcy z ustawień Claude’a, który identyfikuje organizację Claude’a, której HubSpot będzie ufał podczas łączenia członków.

1. In Claude przejdź do sekcji Ustawienia organizacji > Łączniki i wybierz HubSpot.
2. IWznajdź opcję Zarządzane uprawnienia i otwórz jej konfigurację.
3. W sekcji Źródło tożsamości wybierz opcję „Wydane przez Claude'a”.
4. Cowpisz pełny adres URL emitenta widoczny na ekranie konfiguracji. Jeśli Claude wyświetla opcję „Skonfiguruj ręcznie”, rozwiń ją, aby wyświetlić adres URL.

Zostaw tę stronę konfiguracyjną otwartą w osobnym oknie lub zakładce przeglądarki. Wrócisz do niej po włączeniu EMA w HubSpot.

3. Włącz EMA w HubSpot

Użyj skopiowanego adresu URL wydawcy, aby skonfigurować EMA w HubSpot:

1. RUstawprzejdźdo panelu „Zarządzaj dostępem” łącznika w HubSpot.
2. Kliknij kartę „Zaawansowane ”.
3. Kliknij przełącznik „Uwierzytelnianie zarządzane przez przedsiębiorstwo (EMA)”, aby otworzyć ustawienia.
4. Sskopiuj identyfikator konta wyświetlony w panelu. Jest to konto HubSpot, z którym się łączysz, i będziesz go używać jako identyfikatora dzierżawcy w Claude.
5. Wklej pełny adres URL z Claude do pola „Adres URL wystawcy ”.
6. Kliknij opcję Włącz EMA.
7. Spotwierdź, że status wynosi „Włączone” oraz że zapisany adres URL wydawcy jest poprawny.

Jeśli brakuje ustawienia EMA, zapoznaj się z sekcją dotyczącą rozwiązywania problemów poniżej.

4. Przetestuj i włącz połączenie w Claude

Teraz, gdy EMA jest już skonfigurowane, przetestuj połączenie w Claude:

1. RWróć do konfiguracji autoryzacji zarządzanej w Claude.
2. W przypadku Tpolu„ID agenta ” wprowadź skopiowany identyfikator konta HubSpot. Chociaż Claude oznacza to pole jako opcjonalne, należy je mimo to wypełnić w celu nawiązania połączenia z HubSpot.
3. Kliknij „Uruchom test ” i sprawdź, czy każdy etap zakończył się powodzeniem.
4. CKliknij „Kontynuuj”, aby otworzyć konfigurację ról. Wybierz role, które powinny łączyć się za pomocą autoryzacji zarządzanej. Sprawdź wybór przed włączeniem tej funkcji w swojej organizacji.
5. Clkkk Włącz.
6. W panelu szczegółów łącznika, sprawdź, czy opcja Autoryzacja zarządzana jest włączona, a na liście Zastosowane role widnieją wybrane przez Ciebie role.
7. W sekcji „Autoryzacja zarządzana” kliknij przycisk „Edytuj” obok pozycji „Zakresy”, aby przejrzeć i zaktualizować uprawnienia, o które może wnioskować Claude.
8. Reprzejrzyj listę „Role z dostępem”, aby upewnić się, że wybrani członkowie mogą znaleźć i podłączyć łącznik. Kliknij „Edytuj”, jeśli chcesz zmienić te uprawnienia.

Istotne są oba ustawienia ról w Claude: członkowie muszą mieć dostęp do łącznika, a ich rola musi być uwzględniona w zarządzanej autoryzacji, aby połączenie mogło nastąpić automatycznie. Członkowie muszą również spełniać opisane powyżej wymagania dotyczące konta HubSpot, adresu e-mail oraz uprawnień instalacyjnych. Aby dowiedzieć się więcej o ustawieniach ról w Claude, zapoznaj się z tym artykułem pomocy technicznej Claude.

Sprawdź, jak działa to w praktyce

Zanim ogłosisz zmianę w swojej organizacji, poproś kilku członków zespołu o sprawdzenie połączenia:

1. Onen Claude w organizacji, w której włączono zarządzane uprawnienia.
2. Cwfirmie tktórego HubSpot wydaje się być połączony. W razie potrzeby włącz łącznik dla danej rozmowy.
3. Zacznij od zapytania, które nie powoduje zmian w danych, np.: Z jakim kontem HubSpot i jako który użytkownik jestem połączony? Nie zmieniaj żadnych danych.
4. CSprawdź, czy odpowiedź identyfikuje oczekiwane konto HubSpot oraz, jeśli są dostępne, dane użytkownika członka zespołu.
5. Try wysłać żądanie odczytu rekordu, do którego członek zespołu ma dostęp w HubSpot.

Niektóre dane użytkownika wymagają dodatkowych uprawnień. Jeśli te dane nie są dostępne, nadal możesz sprawdzić połączone konto i uprawnienia do odczytu rekordów. Sam brak opcjonalnych danych nie oznacza, że uwierzytelnianie się nie powiodło; nie przyznawaj dodatkowego dostępu tylko po to, aby zakończyć tę kontrolę.

Członkowie zespołu, którzy spełniają wymagania dotyczące dostępu, nie muszą przechodzić przez indywidualny proces logowania do HubSpot ani ekran zgody na połączenie. EMA nie usuwa monitów o zatwierdzenie skonfigurowanych dla poszczególnych działań w narzędziu, takich jak aktualizacje rekordów CRM.

Zarządzanie dostępem po konfiguracji

Aby zaktualizować uprawnienia członka zespołu po konfiguracji:

1. Na swoim koncie Claude otwórz panel szczegółów łącznika Claude.
2. W sekcji „Uwierzytelnianie zarządzane” kliknij przycisk „Edytuj” obok pozycji „Przypisane role”, aby zmienić role korzystające z uwierzytelniania zarządzanego.
3. Aby zmienić, kto może znaleźć i podłączyć łącznik, kliknij „Edytuj” obok opcji „Role z dostępem”. 
4. Kliknij„Edytuj” obok opcji „Zakresy”, aby zarządzać uprawnieniami, o które może wnioskować Claude.

W HubSpot przejrzyj kartę „Uprawnienia instalacyjne”, aby zmienić listę osób uprawnionych do łączenia się z aplikacją, oraz kartę „Uprawnienia do danych”, aby zarządzać danymi i interfejsami API, do których aplikacja ma dostęp. Każdy członek zespołu nadal korzysta z własnych uprawnień w HubSpot.

Więcej informacji na temat ogólnych możliwości łącznika i wskazówek dotyczących użytkowania znajdziesz w tym artykule.

Usunięcie uprawnień członka

Postępuj zgodnie z procesem rezygnacji obowiązującym w Twojej organizacji zarówno w Claude, jak i w HubSpot. Usunięcie osoby z organizacji Claude uniemożliwia aplikacji Claude wydawanie dla niej nowych oświadczeń tożsamości. Token dostępu, który został już wydany, może pozostać aktywny do momentu wygaśnięcia lub cofnięcia, dlatego nie należy polegać wyłącznie na zmianie statusu członkostwa w celu natychmiastowego cofnięcia dostępu.

Przed przypisaniem adresu e-mail byłego członka innej osobie usuń tego członka jako użytkownika HubSpot zgodnie z procesem rezygnacji obowiązującym w Twojej organizacji. Samo usunięcie jego dostępu do łącznika nie powoduje usunięcia starego użytkownika HubSpot powiązanego z tym adresem e-mail.

Wyłącz EMA

Aby wyłączyć EMA:

1. In Claude otwórz ustawienia zarządzanej autoryzacji łącznika HubSpot i kliknij „Wyłącz”.
2. Na koncie HubSpot kliknij ikonę ustawień w górnym pasku nawigacyjnym.
3. W menu po lewej stronie przejdź dosekcji Integracje >Połączone aplikacje >Zatwierdzone aplikacje.
4. Znajdź łącznik, kliknij opcjęZarządzaj dostępem, a następnie wybierz opcjęZaawansowane.
5. Kliknij, aby wyłączyć przełącznik„Uwierzytelnianie zarządzane przez przedsiębiorstwo (EMA) ”, a następnie kliknij„Wyłącz”, aby potwierdzić.

Wyłączenie autoryzacji zarządzanej powoduje zakończenie automatycznego połączenia. Członkowie, którzy nadal potrzebują łącznika, muszą połączyć się indywidualnie, z zastrzeżeniem ustawień organizacji i uprawnień instalacyjnych HubSpot. Istniejące tokeny dostępu mogą pozostać ważne do momentu wygaśnięcia lub cofnięcia.

Rozwiązywanie problemów

Poniższe sekcje zawierają wskazówki dotyczące typowych błędów, które mogą wystąpić podczas procesu konfiguracji.

Ustawienie EMA jest niedostępne

Upewnij się, że jesteś superadministratorem HubSpot, korzystasz z właściwego konta HubSpot i zarządzasz zatwierdzonym łącznikiem HubSpot dla Claude. Jeśli opcja Enterprise Managed Authentication (EMA) nadal nie pojawia się w sekcji „Zaawansowane”, skontaktuj się z pomocą techniczną HubSpot, aby sprawdzić dostępność tej funkcji dla Twojego konta i łącznika.

Test połączenia z Claude’em zakończył się niepowodzeniem

Zapoznaj się z poniższą tabelą, aby dowiedzieć się, co należy sprawdzić w zależności od etapu, na którym wystąpił błąd połączenia:

Sam błąd invalid_grant nie pozwala zidentyfikować pierwotnej przyczyny. Przed powtórzeniem testu sprawdź konto, adres URL wydawcy, zgodność adresu e-mail oraz ustawienia dostępu.

Członek zespołu nie może znaleźć HubSpot lub nadal widzi monit o połączenie

Najpierw sprawdź, czy członek zespołu znajduje się w odpowiedniej organizacji Claude. W ustawieniach Claude, w sekcji Szczegóły łącznika sprawdź sekcję „Role z dostępem ”, jeśli nie może znaleźć łącznika, oraz sekcję „Zastosowane role”, jeśli nie łączy się za pomocą autoryzacji zarządzanej.

W HubSpot upewnij się, że posiada aktywne konto użytkownika, że jego zweryfikowany adres e-mail jest zgodny z adresem w Claude oraz że uprawnienia do instalacji pozwalają mu na połączenie.

Członek zespołu łączy się, ale nie ma dostępu do oczekiwanych danych

Sprawdź zakresy uprawnień łącznika na swoim koncie Claude, uprawnienia dotyczące danych aplikacji w HubSpot oraz uprawnienia członka zespołu w HubSpot. Automatyczne połączenie nie zapewnia dostępu do rekordów ani działań, z których członek zespołu nie może korzystać w HubSpot.

Jeśli problem nadal występuje, skontaktuj się z pomocą techniczną, podając operację, która zakończyła się niepowodzeniem, oraz czas, w którym to nastąpiło. Nie dołączaj tokenów dostępu ani podpisanych oświadczeń tożsamości do zgłoszenia do pomocy technicznej.