Blog

Connector Hub: de integratielaag die ik zelf bouw voor Drupal

Ik bouw Connector Hub om niet telkens hetzelfde probleem opnieuw op te lossen.

Hier lees je wat het is, waarom ik eraan begon en waar het naartoe gaat.


Header met pictogram van verbonden knooppunten

Ik hou van structuur en overzicht.
Connector Hub is wat er gebeurt als je dat loslaat op de manier waarop Drupal met externe systemen praat.

Het is een module die ik zelf bouw, naast mijn vaste job, als een degelijke basis waar andere developers op kunnen verderbouwen.
Hier leg ik uit wat het is, waarom ik eraan begon en waar het naartoe gaat.

Hetzelfde probleem, telkens opnieuw opgelost

Een betaalprovider koppelen, een CRM aanspreken, een webhook van Slack verwerken: telkens een andere API, maar telkens dezelfde onderliggende vragen.

Hoe bewaar je een geheime sleutel veilig en wat doe je als een verzoek mislukt?
Hoe voorkom je dat eenzelfde webhook twee keer verwerkt wordt?

Op projecten zag ik die vragen keer op keer opduiken, telkens opnieuw beantwoord, soms goed, soms half.
Connector Hub is mijn antwoord daarop: een laag die dat eenmalig goed regelt, zodat een specifieke koppeling nog enkel het protocol van dat ene systeem moet kennen.

Wat Connector Hub precies doet

De kern is een ConnectorEndpoint: een configuratie-entiteit per externe verbinding, met een plugin voor het protocol en een geheime sleutel die via de Key-module loopt, nooit rechtstreeks in de configuratie.

Uitgaand werk verloopt via een wachtrij, zodat een trage of tijdelijk onbereikbare externe dienst de rest van de site niet vertraagt.
Inkomend staat er een beveiligde, generieke webhook-route, met snelheidslimieten en verificatie via HMAC of een bearer-token.

Persoon verbindt meerdere knooppunten met een centraal punt

Een gezondheidsdashboard toont per verbinding de laatste succesvolle en mislukte poging en verschijnt vanzelf op basis van wat je effectief geïnstalleerd hebt.

Ik bouw dit bewust als een degelijke basis voor andere developers: een eigen koppeling toevoegen vraagt enkel een kleine plugin voor dat specifieke protocol, niet een herhaling van alles wat Connector Hub al regelt.

Van kern naar familie van modules

Toen Google dezelfde OAuth2-mechaniek nodig had als de betaalproviders, werd authenticatie een aparte module.
Toen zowel Slack als een AI-tekstgenerator een manier nodig hadden om iets aan een mens te melden, werd dat een eigen notificatielaag.

Pas bij een tweede, echt geval trek ik iets los als aparte module, nooit op voorhand.

Een recentere uitbreiding: AI-agents die niet zomaar mogen handelen

De nieuwste toevoeging, half november, is een laag die connector-functionaliteit blootstelt aan AI-agents.
Elke actie valt in een van drie categorieën, van vrij toegankelijk tot verplicht gecontroleerd.

Lezen

Mag altijd vanzelf: statussen opvragen of gegevens ophalen, zonder iets te wijzigen.

Schrijven

Mag ook automatisch, maar wordt gelogd: een record aanmaken of een status aanpassen.

Goedkeuring nodig

Gaat nooit automatisch: een refund via een betaalprovider is het duidelijkste voorbeeld.

Waar dit naartoe gaat

Connector Hub staat sinds 26 oktober 2026 als versie 1.0.0-alpha1 op drupal.org, te installeren via Composer voor Drupal 10.3 of hoger.
Het is alpha, valt nog niet onder het beveiligingsadvies van Drupal zelf en ik zeg dat er zelf ook bij: gebruik het op eigen risico.

De roadmap kijkt verder dan betalingen en Google, richting CRM, ERP en PEPPOL, de Europese standaard voor elektronisch factureren die in overheids- en bedrijfscontext steeds vaker verplicht wordt.

Dit artikel is het eerste in een reeks: latere afleveringen gaan dieper in op specifieke integraties en technische keuzes uit deze familie van modules.
Samen met Smart 404 vind je Connector Hub ook terug op mijn bijdragen.

Ik zoek daarnaast actief mee-onderhouders: wie mee issues wil beoordelen of een stuk van de roadmap wil oppakken, mag zich melden via de projectpagina op drupal.org.
De volledige documentatie en achtergrond staan op connector-hub.porschmann.be.

Datzelfde architecturale denken, een systeem overzichtelijk opbouwen in plaats van laag op laag stapelen, zet ik ook in voor klanten bij technisch beheer en consultancy.

Nieuwsgierig naar hoe dit achter de schermen in elkaar zit, of werk je zelf aan iets gelijkaardigs?
Stuur je vraag via het contactformulier, dan reageer ik binnen de 24 uur.

Veelgestelde vragen

Wat is Connector Hub precies?

Een Drupal-module die een herbruikbare basis biedt om met externe systemen te praten: betaalproviders, Slack, Google en meer.
In plaats van voor elke koppeling opnieuw dezelfde onderliggende problemen op te lossen, regelt Connector Hub dat eenmalig, met per systeem enkel een kleine plugin voor het specifieke protocol.

Is Connector Hub al stabiel genoeg om te gebruiken?

Het staat als alpha op drupal.org, dus nog niet onder het beveiligingsadvies van Drupal zelf.
De kernmodule en de eerste integraties zijn wel getest en in gebruik, maar ik raad aan dit nog niet blind in een kritieke productieomgeving te zetten zonder het zelf na te kijken.

Welke systemen kan ik er vandaag mee koppelen?

Betalingen via Mollie, Stripe, MultiSafepay of Buckaroo, Slack-notificaties en slash-commands, Google-aanmelding en -agenda en AI-tekstgeneratie via OpenAI of Anthropic.
Adyen, extra Google-diensten en koppelingen buiten betalingen staan op de roadmap.

Kan ik meehelpen aan Connector Hub?

Ja, ik zoek actief mee-onderhouders.
Wie wil meehelpen met het beoordelen van issues of een onderdeel van de roadmap wil oppakken, kan zich melden via de projectpagina op drupal.org.

Vraag over Connector Hub of een gelijkaardig project?

Beschrijf kort waar je mee bezig bent, dan denk ik mee.

Privacybeleid
Hoe ik met je gegevens omga, lees je in de privacyverklaring.

Verder lezen