Handleiding voor het instellen van ActiveCampaign SCIM-integratie

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

📋 Voorwaarden

Zorg dat je beschikt over:

• Microsoft Entra ID-beheerderstoegang (minimaal Application Administrator)

• ActiveCampaign-beheerdersaccount met API-toegang

• KoppelHet-platformtoegang met integratiebeheerrechten

🎯 Overzicht

Met deze integratie kun je:

• ✅ Automatisch gebruikers provisionen van Entra ID naar ActiveCampaign

• ✅ Gebruikers realtime synchroniseren

• ✅ Rolgebaseerde toegangscontrole toepassen

• ✅ Gebruikers deactiveren of verwijderen

🔑 Benodigde gegevens

Microsoft Entra ID

• SCIM-endpoint-URL van je KoppelHet-instantie

• SCIM-endpoint-geheime token

ActiveCampaign

• Accountdomein/ID: je ActiveCampaign-accountidentificatie

• API-sleutel: voor authenticatie met de ActiveCampaign-API

1️⃣ ActiveCampaign API-toegang instellen

1.1 API-sleutel ophalen

1. Log in op je ActiveCampaign-beheerdersaccount

2. Ga naar Instellingen → Developer

3. Kopieer je API-sleutel en bewaar deze veilig

1.2 Accountdomein/ID vinden

Het domein heeft het formaat:

https://[jouw-domein].api-us1.com

2️⃣ KoppelHet-platform configureren

2.1 Integratie aanmaken

1. Log in op het KoppelHet-platform

2. Ga naar Integraties

3. Kies “Entra – ActiveCampaign”

4. Klik Integratie toevoegen

2.2 ActiveCampaign-instellingen invullen

Accountdomein

[jouw domein] Domein uit stap 1.2

API-sleutel[jouw API-sleutel] Sleutel uit stap 1.1

Standaardrol[selecteer rol]Rol voor nieuw geprovisioneerde gebruikers

2.3 Rolkoppelingen

Entra-rolActiveCampaign-rolToegangAdminAdminVolledige toegangUser AdministratorManagerGebruikersbeheerUserUserBasisrechten

2.4 Integratie activeren

1. Controleer de instellingen

2. Klik Integratie activeren

3. Kopieer de SCIM-endpoint-URL en het geheime token voor stap 3

3️⃣ Microsoft Entra ID configureren

3.1 SCIM-applicatie aanmaken

1. Meld je aan op entra.microsoft.com

2. Ga naar Identity → Applications → Enterprise applications

3. Klik + New application → + Create your own application

4. Naam: Joinly ActiveCampaign SCIM Provisioning

5. Kies Non-gallery en klik Create

3.2 SCIM-provisioning instellen

Tenant URL [SCIM-endpoint-URL uit stap 2.4]

Secret Token[SCIM-secret-token uit stap 2.4]

• Klik Test Connection (HTTP 200 OK = geslaagd)

• Klik Create

3.3 Gebruikers- en groeps­toewijzing

1. Ga naar Users and groups

2. Wijs testgebruikers of -groepen toe

3. Zorg dat toegewezen rollen overeenkomen met de roolkoppelingen

3.4 Attributenmapping

Activeer Create, Update en Delete acties en sla op.

3.5 Testprovisioning

1. Ga naar Provision on-demand

2. Zoek een testgebruiker

3. Klik Provision en controleer de logs

3.6 Provisioning-instellingen

• Schakel meldingen bij fouten in

• Stel een drempel voor onbedoelde verwijdering in

• Zet Provisioning status aan

3.7 Service starten

Klik Start provisioning en controleer de synchronisatielogs.

4️⃣ Verificatie en testen

• Nieuwe gebruiker testen: maak een testgebruiker in Entra ID en controleer na ±40 minuten in ActiveCampaign.

• Updates testen: wijzig een attribuut in Entra ID en controleer of het doorgevoerd wordt.

• Deactivering testen: deactiveer een gebruiker en controleer de status in ActiveCampaign.

📊 Monitoring & probleemoplossing

• Controleer Provisioning logs, Audit logs en Foutrapporten in Entra ID.

• Veelvoorkomende problemen:

  • ❌ Verbinding mislukt → controleer SCIM-URL en token

  • ❌ Geen synchronisatie → controleer toewijzingen en attributen

  • ❌ Rolproblemen → verifieer rolnamen en rechten

  • ❌ API-limieten → controleer ActiveCampaign-API-gebruik