HubSpot-gebruikers voorzien van SCIM via Okta

Provisioning 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 lees je hoe je user provisioning via Okta instelt.

Voorwaarden

• Single sign-on (SSO) moet zijn ingeschakeld in uw HubSpot-account.
• Het wordt aanbevolen om gebruikersrechten in HubSpot in te stellen op basis van de Okta Rollen van uw team voordat u SCIM instelt.
• Om gebruikersmachtigingen in te stellen, moet u machtigingssets aanmaken in HubSpot. Okta kan vervolgens machtigingen aan een gebruiker toewijzen als hun Rol in Okta overeenkomt met de naam van de HubSpot-machtigingsset.
• Om betaalde seats toe te wijzen voor gebruikers die zijn ingesteld met SCIM, moet u eerst de seats aanschaffen in HubSpot en een permission set maken met een betaalde seat. Stel vervolgens in Okta de rol van de gebruiker in op dezelfde rol als de machtigingsset.
• Om uw domein te verifiëren, moet u uw DNS-records bijwerken. Zorg ervoor dat u de inloggegevens heeft voor uw DNS-provider en toegang heeft tot de TXT-records.

SCIM-provisioning instellen

Om SCIM user provisioning in te stellen via Okta, moet je eerst de HubSpot app toevoegen in Okta en vervolgens gebruikers toewijzen aan de app:

• Log in op Okta.
• Selecteer in het linker zijbalkmenu Toepassingen > Toepassingen en blader vervolgens 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 vervolgens op Configure API Integration.
  
  
• 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 u Okta wilt integreren en klik vervolgens op Kies account.
• Klik op Connect app. Het venster wordt gesloten en u wordt doorgestuurd naar de Okta admin console.
• Klik op Opslaan.
• Selecteer op het tabblad Provisioning hoe je Okta gebruikers wilt provisioneren in HubSpot door op Edit 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 je domein

Nadat u de HubSpot app via Okta hebt toegevoegd, moet u uw domein in HubSpot verifiëren door uw DNS-records bij te werken.

• Klik in uw HubSpot-account op de settingsinstellingenpictogram in de hoofdnavigatiebalk.
• Navigeer in het linker zijbalkmenu naar Integraties > Aangesloten Apps.
• Klik op Okta SCIM.

• Voer in het veld Domein het verzenddomein voor e-mail van uw gebruikers in.

• Klik op Opslaan.
• Klik op Nu verifiëren.

• Selecteer in het dialoogvenster Volgende.

• Kopieer de waarde in de kolom Waarde. U gebruikt deze waarde dan bij het maken van een nieuw TXT-record in uw DNS-provider
• Log in op je DNS provider account, maak dan een nieuw TXT record aan voor het domein dat je verifieert. Plak de van HubSpot gekopieerde waarde in het veld Value/Points To/Target.
• 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 en in HubSpot worden weergegeven.

SCIM provisioning uitschakelen

Om SCIM provisioning in HubSpot uit te schakelen, moet u Okta SCIM in HubSpot verwijderen voordat u wijzigingen aanbrengt in uw Okta-account.

• Klik in uw HubSpot-account op de settingsinstellingenpictogram in de hoofdnavigatiebalk.
• Navigeer in het linker zijbalkmenu naar Integraties > Verbonden Apps.
• Klik onder de Okta SCIM-app op het vervolgkeuzemenu Acties en vervolgens op Verwijderen.
• In uw Okta-account worden de gebruikers bewerkbaar en niet langer gesynchroniseerd met SCIM.

FAQ

Kunnen gebruikers die via SCIM zijn aangemaakt in HubSpot worden bewerkt?

Nee. Een gebruiker aangemaakt via SCIM kan alleen worden bijgewerkt via uw identity provider. Dit geldt ook voor gebruikersmachtigingen, gebruikersnaam en e-mailadres.

Kan Okta gebruikers toewijzen aan teams?

Nee. Echter, nadat de gebruiker is toegevoegd aan HubSpot, kunt u hun team handmatig bijwerken in HubSpot.

Wat gebeurt er als ik een SCIM-gebruiker in HubSpot of Okta verwijder?

Het verwijderen van een gebruiker in HubSpot zal de gebruiker niet verwijderen in Okta. Als u echter de toegang van een gebruiker tot HubSpot uit Okta verwijdert, of hun account in Okta deactiveert, wordt de gebruiker in HubSpot verwijderd. Het toevoegen van een gebruiker aan HubSpot zal de gebruiker niet toevoegen aan Okta.

Wat gebeurt er met bestaande gebruikers in mijn HubSpot account als ik Okta koppel?

Na het instellen van SCIM via Okta, zullen alle bestaande HubSpot-gebruikers die overeenkomen met gebruikers in Okta automatisch worden omgezet naar SCIM-gebruikers. HubSpot zal proberen de gebruiker een permissie set toe te wijzen op basis van hun Rol in Okta. Als de gebruiker geen rol heeft in Okta die overeenkomt met een toestemmingsset in HubSpot, zal de gebruiker slechts minimale toestemmingen hebben in HubSpot.

Ik zie de foutmelding "This domain couldn't be verified", hoe los ik dit op?

Als je deze foutmelding ziet, controleer dan of je domein correct is ingevoerd zonder spelfouten. Controleer ook of je de juiste waarde voor het TXT record van de Configuratie stap in HubSpot hebt gekopieerd naar je DNS provider.