Zapewnienie użytkownikom HubSpot dostępu do SCIM za pośrednictwem Okta

Konfiguracja użytkowników za pomocą SCIM (System for Cross-domain Identity Management) stanowi bezpieczny i zautomatyzowany sposób tworzenia użytkowników HubSpot oraz zarządzania nimi za pośrednictwem Okta.

Jeśli Twoim dostawcą tożsamości nie jest Okta ani Google, możesz skonfigurować niestandardową integrację SCIM. Umożliwia to skonfigurowanie SCIM w celu dodawania użytkowników z dostawców takich jak Microsoft Entra ID, PingFederate, OneLogin i JumpCloud. Dowiedz się więcej o konfiguracji SCIM dla swojego dostawcy tożsamości.

Poniżej dowiesz się, jak skonfigurować dodawanie użytkowników za pośrednictwem Okta.

Zanim zaczniesz

Zanim zaczniesz korzystać z tej funkcji, upewnij się, że w pełni rozumiesz, jakie kroki należy podjąć z wyprzedzeniem, a także jakie są ograniczenia tej funkcji i potencjalne konsekwencje jej użycia.

Zapoznaj się z wymaganiami

• W Twoim koncie HubSpotmusi być włączone logowanie jednokrotne (SSO).
• Przed skonfigurowaniem SCIM zaleca się skonfigurowanie zestawów uprawnień użytkowników w HubSpot na podstawie ról Okta w Twoim zespole.
• Aby ustawić uprawnienia użytkowników, musisz utworzyć zestawy uprawnień w HubSpot. Okta może następnie przypisać uprawnienia do użytkownika, jeśli jego role w Okta odpowiadają nazwie zestawu uprawnień w HubSpot.
• Aby zweryfikować swoją domenę, musisz zaktualizować rekordy DNS. Upewnij się, że masz dane logowania do dostawcy usług DNS oraz dostęp do rekordów TXT.

Zapoznaj się z ograniczeniami i kwestiami, które należy wziąć pod uwagę

• Przydzielanie licencji będzie się różnić w zależności od tego, czy korzystasz z modelu cenowego opartego na licencjach:
  • Jeśli nie korzystasz z modelu cenowego opartego na licencji: aby przypisać licencje użytkownikom skonfigurowanym za pomocą SCIM, zakup licencje w HubSpot i utwórz zestaw uprawnień z płatną licencją. Wróć do Okta i ustaw role użytkownika tak, aby były zgodne z zestawem uprawnień.
  • Jeśli korzystasz z modelu cenowego opartego na licencjach: gdy zestaw uprawnień jest przypisywany za pośrednictwem SCIM/API, HubSpot automatycznie przypisuje użytkownikowi najlepszą dostępną licencję, która obsługuje wszystkie uprawnienia w tym zestawie.

Skonfiguruj przydzielanie użytkowników za pomocą SCIM

Aby skonfigurować przydzielanie użytkowników za pomocą SCIM w Okta, musisz najpierw dodać aplikację HubSpot w Okta, a następnie przypisać użytkowników do tej aplikacji:

1. Zaloguj się do Okta.
2. W menu po lewej stronie wybierz Aplikacje > Aplikacje, a następnie znajdź i dodaj aplikację HubSpot do swojego konta Okta.
3. Na ekranie aplikacji HubSpot kliknij kartę „Provisioning ”, a następnie kliknij „Configure API Integration”.
   
   
4. Zaznacz pole wyboru Włącz integrację API, a następnie kliknij Uwierzytelnij w HubSpot. Otworzy się nowe okno, w którym możesz przyznać Okta dostęp do swojego konta HubSpot.
5. W oknie HubSpot wybierz konto, z którym chcesz zintegrować Okta, a następnie kliknij Wybierz konto.
6. Kliknij „Połącz aplikację”. Okno się zamknie, a zostaniesz przekierowany do konsoli administracyjnej Okta.
7. Kliknij „Zapisz”.
8. W zakładce „Provisioning ” wybierz, w jaki sposób Okta ma przydzielać użytkowników do HubSpot, klikając „Edytuj”.
   
9. Zaznacz pola wyboru „Włącz” obok opcji „Utwórz użytkowników”, „Aktualizuj atrybuty użytkowników” i „Dezaktywuj użytkowników”, aby skonfigurować integrację.
10. Kliknij „Zapisz”.
11. Następnie przypisz użytkowników do aplikacji HubSpot.

Zweryfikuj swoją domenę

Po dodaniu aplikacji HubSpot za pośrednictwem Okta konieczne będzie zweryfikowanie domeny w HubSpot poprzez aktualizację rekordów DNS.

1. Na koncie HubSpot kliknij ikonę ustawień w górnym pasku nawigacyjnym.
2. W menu po lewej stronie przejdź do sek cji Integracje > Połączone aplikacje.
3. Kliknij Okta SCIM.
4. Przejdź do zakładki „Ustawienia ogólne ”.
5. W polu „Domena” wprowadź domenę, z której wysyłane są wiadomości e-mail Twoich użytkowników.
6. Kliknij „Zapisz”.
7. Kliknij opcję „Zweryfikuj teraz”.
   
   
8. W oknie dialogowym wybierz opcję Dalej.
9. Skopiuj wartość z kolumny „Wartość ”. Będziesz jej potrzebować podczas tworzenia nowego rekordu TXT u dostawcy usług DNS.
10. Zaloguj się na swoje konto u dostawcy usług DNS, a następnie utwórz nowy rekord TXT dla domeny, którą weryfikujesz. Wklej wartość skopiowaną z HubSpot do pola „Wartość”/„Wskazuje na”/„Cel”.
11. Po utworzeniu rekordu TXT wróć do HubSpot, a następnie kliknij „Dalej”. Gdy zmiany w DNS się rozprzestrzenią, domena zostanie zweryfikowana.

Uwaga: propagacja zmian DNS i ich odzwierciedlenie w HubSpot może potrwać do 48 godzin.

Synchronizacja ról Okta z zestawami uprawnień HubSpot

Aby ustawić uprawnienia użytkowników, musisz utworzyć zestawy uprawnień w HubSpot. Okta może następnie przypisać uprawnienia do użytkownika, jeśli jego role w Okta dokładnie odpowiadają nazwie zestawu uprawnień w HubSpot, łącznie ze spacjami i wielkimi literami.

Aby umożliwić Okta przypisywanie zestawów uprawnień użytkownikom:

1. Na koncie HubSpot kliknij ikonę ustawień w górnym pasku nawigacyjnym.
2. W menu po lewej stronie kliknij Integracje > Połączone aplikacje.
3. W sekcji Wszystkie aplikacje kliknij Okta SCIM.
4. Włącz opcję Zarządzanie zestawami uprawnień.

Wyłącz provisioning SCIM

Aby wyłączyć provisioning SCIM w HubSpot, musisz odinstalować Okta SCIM w HubSpot przed wprowadzeniem jakichkolwiek zmian na swoim koncie Okta.

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. W aplikacji Okta SCIM kliknij menu rozwijane „Działania ”, a następnie kliknij „Odinstaluj”.
4. Na koncie Okta użytkownicy staną się edytowalni i nie będą już synchronizowani z SCIM.

Często zadawane pytania

Czy użytkowników utworzonych za pośrednictwem SCIM można edytować w HubSpot?

W HubSpot można edytować wyłącznie uprawnienia użytkowników i to tylko wtedy, gdy nie skonfigurowano zarządzania zestawami uprawnień. Wszystkie pozostałe informacje o użytkownikach, w tym nazwa użytkownika i adres e-mail, można aktualizować wyłącznie za pośrednictwem dostawcy tożsamości.

Dlaczego przypisane mi role w Okta nie pojawiają się w moim zestawie uprawnień użytkownika w HubSpot?

Aby role Okta były synchronizowane z zestawami uprawnień w HubSpot, należy włączyć zarządzanie zestawami uprawnień w HubSpot. Nazwa zestawu uprawnień w HubSpot musi dokładnie odpowiadać nazwom ról w Okta, łącznie ze wszystkimi spacjami i wielkimi literami.

Czy Okta może przypisywać użytkowników do zespołów?

Nie. Jednak po dodaniu użytkownika do HubSpot można ręcznie zaktualizować jego przynależność do zespołu w HubSpot.

Co się stanie, jeśli usunę użytkownika SCIM w HubSpot lub Okta?

Usunięcie użytkownika w HubSpot nie spowoduje usunięcia go z Okta. Jeśli jednak w Okta cofniesz użytkownikowi dostęp do HubSpot lub dezaktywujesz jego konto, użytkownik zostanie dezaktywowany również w HubSpot. Dodanie użytkownika do HubSpot nie spowoduje dodania go do Okta.

Co stanie się z istniejącymi użytkownikami na moim koncie HubSpot po połączeniu z Okta?

Po skonfigurowaniu SCIM za pośrednictwem Okta wszyscy istniejący użytkownicy HubSpot, którzy pasują do użytkowników w Okta, zostaną automatycznie przekształceni w użytkowników SCIM. HubSpot spróbuje przypisać użytkownikowi zestaw uprawnień na podstawie jego ról w Okta. Jeśli użytkownik nie ma w Okta ról odpowiadających uprawnieniom ustawionym w HubSpot, będzie miał w HubSpot tylko minimalne uprawnienia.

Pojawia się błąd „Nie można zweryfikować tej domeny” – jak to naprawić?

Jeśli pojawia się ten błąd, upewnij się, że domena została wpisana poprawnie, bez błędów ortograficznych. Sprawdź również, czy skopiowałeś prawidłową wartość rekordu TXT z etapu konfiguracji w HubSpot do swojego dostawcy DNS.