Handleiding voor het instellen van Microsoft Entra - HubSpot SCIM-integratie

HubSpot SCIM Provisioning via Microsoft Entra ID (Azure AD)

Deze gids beschrijft stap voor stap hoe je SCIM-provisioning configureert tussen Microsoft Entra ID (Azure AD) en HubSpot via het Joinly (KoppelHet) platform.

Met deze koppeling automatiseer je het volledige gebruikersbeheer in HubSpot op basis van HR- of IAM-processen in Entra ID.

📋 Vereisten

Zorg dat je beschikt over:

Microsoft Entra ID

• Minimaal Application Administrator rechten

• Toegang tot Enterprise Applications

• Provisioning toegestaan binnen tenant

HubSpot

• Super Admin account

• API-toegang toegestaan

• Actieve HubSpot licentie met gebruikersbeheer

Joinly

• Joinly account (gratis aan te maken)

🎯 Wat doet deze integratie?

Met deze configuratie kun je:

✅ Automatisch gebruikers aanmaken in HubSpot
✅ Gebruikers realtime synchroniseren
✅ Rollen automatisch toewijzen
✅ Gebruikers deactiveren of verwijderen
✅ Identity lifecycle volledig automatiseren

Stap 1 — Joinly account aanmaken

1. Ga naar:

https://platform.joinly.app

1. Klik op:

Nog geen account? Registreer hier

1. Maak je Joinly tenant aan

2. Log in op het platform

Stap 2 — HubSpot koppelen via Marketplace

2.1 Open de integratiepagina

Ga direct naar:

https://platform.joinly.app/integrations/marketplace/entra-hubspot

2.2 Start HubSpot autorisatie

Klik op:

Connect HubSpot

Je wordt automatisch doorgestuurd naar HubSpot OAuth.

2.3 Autoriseer Joinly in HubSpot

1. Log in met je HubSpot Super Admin account

2. Controleer de gevraagde permissies

3. Klik:

Authorize access

Na succesvolle autorisatie word je teruggestuurd naar Joinly.

✅ HubSpot is nu gekoppeld
✅ API tokens worden automatisch beheerd door Joinly

3.1 Standaardrol instellen

In de HubSpot integratie:

Selecteer:

Default HubSpot Role

Dit is de rol die nieuwe gebruikers krijgen als er geen expliciete mapping is.

3.2 Rolmapping instellen (optioneel)

Je kunt Entra ID App Roles koppelen aan HubSpot rollen.

Voorbeeld:

Zo stuur je autorisatie volledig vanuit Entra.

3.3 Integratie activeren

Klik:

Activate integration

Na activatie toont Joinly automatisch:

✅ SCIM Endpoint URL
✅ SCIM Secret Token

👉 Deze heb je nodig voor Entra ID.

Stap 4 — Microsoft Entra ID SCIM configureren

4.1 Enterprise Application aanmaken

1. Ga naar:

https://entra.microsoft.com

1. Navigeer naar:

Identity → Applications → Enterprise applications

1. Klik:

+ New application
→ Create your own application

1. Vul in:

Name: Joinly HubSpot SCIM

1. Selecteer:

Non-gallery application

1. Klik:

Create

4.2 Provisioning instellen

1. Open de app

2. Ga naar:

Provisioning

1. Kies:

Automatic

Vul in:

Tenant URL

➡ Plak SCIM Endpoint URL uit Joinly

Secret Token

➡ Plak SCIM Secret Token uit Joinly

1. Klik:

Test Connection

Bij succes:

✅ HTTP 200 OK

1. Klik:

Save

Stap 5 — Users & Groups toewijzen

1. Ga naar:

Users and groups

1. Klik:

Add user/group

1. Voeg toe:

• Testgebruiker
  OF

• Entra groep (recommended)

1. Controleer:

➡ Rollen matchen met Joinly mapping

Stap 6 — Provisioning configureren

6.1 Mapping controleren

Ga naar:

Provisioning → Mappings

Controleer:

✔ Create users
✔ Update users
✔ Disable users

Joinly gebruikt standaard SCIM schema mapping.

6.2 On-demand test uitvoeren

1. Ga naar:

Provision on-demand

1. Selecteer testgebruiker

2. Klik:

Provision

Controleer logs:

✅ Success
❌ Geen errors

6.3 Provisioning starten

Ga terug naar:

Provisioning

Klik:

Start provisioning

⏱ Eerste sync: ±20–40 minuten

Stap 7 — Validatie

Nieuwe gebruiker

1. Maak gebruiker aan in Entra

2. Wijs toe aan Joinly SCIM app

3. Controleer HubSpot:

✅ Account aangemaakt
✅ Rol correct
✅ Actief

Update test

Wijzig bijv:

• Naam

• Afdeling

• Rol

Controleer dat wijziging zichtbaar wordt in HubSpot.

Deactivering test

Disable gebruiker in Entra.

Controleer:

✅ Gebruiker gedeactiveerd in HubSpot
✅ Toegang ingetrokken

Klaar ✅

Je HubSpot provisioning draait nu volledig automatisch via Joinly + Entra ID.

HR of IAM is voortaan je single source of truth.