HubSpot gebruikers voorzien van SCIM via Okta
Laatst bijgewerkt: januari 17, 2025
Beschikbaar met elk van de volgende abonnementen, behalve waar vermeld:
|
|
|
|
Het leveren van gebruikers via SCIM (het System for Cross-domain Identity Management) biedt een veilige en geautomatiseerde manier om HubSpot gebruikers aan te maken en te beheren via Okta.
Hieronder leest u hoe u de provisioning van gebruikers instelt via Okta.
Vereisten
- Single sign-on (SSO) moet ingeschakeld zijn in uw HubSpot account.
- Het wordt aanbevolen om machtigingensets voor gebruikers in HubSpot in te stellen op basis van de Okta Rollen van je team voordat je SCIM instelt.
- Om gebruikersmachtigingen in te stellen, moet u machtigingensets maken in HubSpot. Okta kan vervolgens machtigingen toewijzen aan een gebruiker als hun rollen in Okta overeenkomen met de naam van de machtigingenset van Hubspot.
- Om uw domein te verifiëren, moet u uw DNS records bijwerken. Zorg ervoor dat je de inloggegevens hebt voor je DNS-provider en toegang hebt tot de TXT records.
- Het toewijzen van seats is afhankelijk van of je wel of niet het seats-gebaseerde prijsmodel gebruikt:
- Als u geen seats-based prijsmodel gebruikt: om betaalde seats toe te wijzen voor gebruikers die zijn ingesteld met SCIM, koopt u de seats in HubSpot en maakt u een machtigingenset met een betaalde seat. Navigeer terug naar Okta en stel de Rollen van de gebruiker in zodat deze gelijk zijn aan de machtigingenset.
- Als je het prijsmodel op basis van seats gebruikt: je kunt geen seats zoals kernseats, Sales of Service Hub seats of Alleen bekijken-seats toewijzen op basis van machtigingensets die zijn toegewezen in Okta. Voordat je machtigingen toewijst via Okta, moet je de seat van een gebruiker bijwerken in HubSpot.
SCIM-provisioning instellen
Om SCIM user provisioning via Okta in te stellen, moet u eerst de HubSpot app toevoegen in Okta en vervolgens gebruikers toewijzen aan de app:
- Log in bij Okta.
- Selecteer in het linker zijbalkmenu Toepassingen > Toepassingen en blader naar de HubSpot-applicatie in uw Okta-account en voeg deze toe.
- Klik in het scherm van de HubSpot-applicatie op het tabblad Provisioning en klik vervolgens op Configureer API-integratie.
- Schakel het selectievakje API-integratie inschakelen in en klik vervolgens op Authenticeren met HubSpot. Er wordt een nieuw venster geopend waarin u Okta toegang kunt geven tot uw HubSpot-account.
- Selecteer in het HubSpot-venster met welk account je Okta wilt integreren en klik vervolgens op Kies account.
- Klik op App verbinden. Het venster wordt gesloten en je wordt doorgestuurd naar de Okta beheerconsole.
- Klik op Opslaan.
- Selecteer op het tabblad Provisioning hoe je Okta gebruikers wilt laten providen bij HubSpot door op Bewerken te klikken.
- Schakel de selectievakjes Enable naast Create Users, Update User Attributes en Deactivate Users in om de integratie te configureren.
- Klik op Opslaan.
- Wijs vervolgens gebruikers toe aan de HubSpot app.
Controleer uw domein
Nadat je de HubSpot app via Okta hebt toegevoegd, moet je je domein in Hubspot verifiëren door je DNS records bij te werken.
- Klik in je HubSpot-account op het settings instellingen-pictogram in de bovenste navigatiebalk.
- Navigeer in het linker zijbalkmenu naar Integraties > Aangesloten apps.
- Klik op Okta SCIM.
- Voer in het veld Domein het e-maildomein van uw gebruikers in.
- Klik op Opslaan.
- Klik op Nu verifiëren.
- Selecteer Volgende in het dialoogvenster.
- Kopieer de waarde in de kolom Waarde. Je zult deze waarde dan gebruiken bij het maken van een nieuw TXT record in je DNS provider
- Log in op je DNS provider account en maak een nieuw TXT record voor het domein dat je wilt verifiëren. Plak de waarde die je hebt gekopieerd van HubSpot in het veld Waarde/Punten voor doel.
- Nadat je het TXT record hebt gemaakt, navigeer je terug naar HubSpot en klik je op Volgende. Zodra de DNS-wijzigingen zijn doorgevoerd, wordt het domein geverifieerd.
Let op: het kan tot 48 uur duren voordat de DNS wijzigingen zijn doorgevoerd in HubSpot.
Synchroniseer Okta rollen met HubSpot machtigingensets
Om gebruikersmachtigingen in te stellen, moet je machtigingensets maken in Hubspot. Okta kan vervolgens machtigingen toewijzen aan een gebruiker als hun rollen in Okta overeenkomen met de exacte naam van de machtigingenset van HubSpot, inclusief spaties en hoofdletters.
Om Okta toegang te geven tot het toewijzen van machtigingensets aan gebruikers:
- Klik in je HubSpot-account op het settings instellingen-pictogram in de bovenste navigatiebalk.
- Klik in het linker zijbalkmenu op Integraties > Aangesloten apps.
- Klik onder Alle apps op Okta SCIM.
- Schakel Machtigingenset Beheer in.
SCIM-provisioning uitschakelen
Als u SCIM provisioning in HubSpot wilt uitschakelen, moet u Okta SCIM in HubSpot verwijderen voordat u wijzigingen aanbrengt in uw Okta-account.
- Klik in je HubSpot-account op het settings instellingen-pictogram in de bovenste navigatiebalk.
- Navigeer in het linker zijbalkmenu naar Integraties > Aangesloten apps.
- Klik onder de Okta SCIM-app op het vervolgkeuzemenu Acties en klik vervolgens op Verwijderen.
- In uw Okta-account kunnen gebruikers worden bewerkt en worden ze niet langer gesynchroniseerd met SCIM.
FAQ
Kunnen gebruikers die via SCIM zijn aangemaakt in HubSpot worden bewerkt?
Alleen gebruikersmachtigingen kunnen worden bewerkt in HubSpot, en alleen als het beheer van machtigingensets niet is geconfigureerd. Alle andere gebruikersgegevens, inclusief gebruikersnaam en e-mailadres, kunnen alleen worden bijgewerkt via je identity provider.
Waarom worden mijn toegewezen Okta-rollen niet weergegeven in mijn Machtigingenset in Hubspot?
Je moet Machtigingenset beheer in Hubspot inschakelen om Okta rollen te laten synchroniseren met HubSpot machtigingensets. De naam van de machtigingenset in HubSpot moet overeenkomen met de exacte namen van de rollen in Okta, inclusief alle spaties en hoofdletters.
Kan Okta gebruikers aan teams toewijzen?
Nee. Maar nadat de gebruiker is toegevoegd aan HubSpot, kun je zijn team handmatig bijwerken in HubSpot.
Wat gebeurt er als ik een SCIM-gebruiker verwijder in HubSpot of Okta?
Het verwijderen van een gebruiker in HubSpot verwijdert de gebruiker niet in Okta. Als u echter de toegang van een gebruiker tot HubSpot uit Okta verwijdert of hun account in Okta deactiveert, wordt de gebruiker ook in Hubspot gedeactiveerd. Het toevoegen van een gebruiker aan HubSpot voegt de gebruiker niet toe aan Okta.
Wat gebeurt er met bestaande gebruikers in mijn HubSpot account als ik Okta aansluit?
Na het instellen van SCIM via Okta, zullen bestaande HubSpot gebruikers die overeenkomen met gebruikers in Okta automatisch worden geconverteerd naar SCIM gebruikers. HubSpot zal proberen de gebruiker een machtigingenset toe te wijzen op basis van hun rollen in Okta. Als de gebruiker geen rollen in Okta heeft die overeenkomen met de machtigingenset in HubSpot, heeft de gebruiker slechts minimale machtigingen in HubSpot.
Ik zie de foutmelding "Dit domein kon niet worden geverifieerd", hoe los ik dit op?
Als je deze foutmelding ziet, controleer dan of je domein correct en zonder spelfouten is ingevoerd. Controleer ook of je de juiste waarde voor het TXT record van de configuratiestap in HubSpot hebt gekopieerd naar je DNS provider.