Connector & API Management

Connector & API Management is de integratiehub van Nashua 360: het centrale control plane waarmee de suite communiceert met elk systeem eromheen. De module beheert de volledige levenscyclus van een integratie, van de credentials en endpoints die een verbinding definiëren, via de transformatieregels die externe gegevens verzoenen met het eigen model van de suite, tot de planning, monitoring en foutafhandeling die de gegevens betrouwbaar laten stromen. Waar andere modules bedrijfsgegevens produceren en consumeren, bepaalt deze module hoe die gegevens de grens tussen Nashua 360 en de buitenwereld passeren.

De module bevindt zich binnen System Administration als de naar buiten gerichte rand van de suite. Elk extern raakvlak wordt hier geregistreerd, voorzien van credentials en bewaakt: REST-, SOAP- en GraphQL-API's, Model Context Protocol-servers, uitgaande en inkomende mail, contentplatforms, klant- en identiteitssystemen, partners voor electronic data interchange en bankkanalen. Door deze verantwoordelijkheid op één plek te bundelen geeft de module beheerders een volledige, controleerbare inventaris van het integratieoppervlak van de organisatie, in plaats van een verspreiding van point-to-point-verbindingen die verstopt zitten in afzonderlijke functies.

Wat de module doet

De module beheert het complete geheel aan externe verbindingen waarvan een moderne onderneming afhankelijk is. Zij biedt volledige levenscyclusbesturing over API-connectoren die REST, SOAP en GraphQL omvatten, elk met een eigen authenticatieschema, base-endpoints, headers, retry-beleid en rate limits. Zij configureert Model Context Protocol-servers die tools en resources beschikbaar stellen aan de AI-laag van de suite, en zij bevat de configuratie voor uitgaande en inkomende mail, zowel SMTP voor verzending als IMAP voor het ophalen, die notificaties, rapporten en campagneverkeer verzorgt.

Naast individuele connectoren beheert zij het verplaatsen van gegevens op grote schaal. ETL- en ELT-pipelines extraheren uit bronsystemen, passen declaratieve transformatieregels toe en laden in de suite, of landen eerst ruwe gegevens en transformeren die ter plekke waar de doelopslag beter geschikt is voor dat werk. Zij verzorgt electronic data interchange met handelspartners, onderhoudt connectoren naar contentplatforms waaronder WordPress, Sitecore, Adobe AEM, Drupal en Umbraco, en integreert klant- en identiteitssystemen. Geplande synchronisatie, deltadetectie, dead-letter-foutwachtrijen en replay maken het beeld compleet, zodat verbindingen niet slechts gedefinieerd zijn maar continu en waarneembaar worden beheerd.

Het domein en het datamodel

In het hart van het domein staat het idee van een verbinding: een duurzame, benoemde relatie met één extern systeem. Een verbinding draagt alles wat nodig is om dat systeem te bereiken en te vertrouwen, de endpoints, het authenticatiemateriaal en de gedragsinstellingen, ondergebracht als gestructureerde configuratie en getypeerd naar de soort systeem die zij vertegenwoordigt, of dat nu een API, een contentplatform, een identity provider, een mailserver of een bankkanaal is. Geheimen die bij een verbinding horen worden apart van de gewone configuratie bewaard en encrypted at rest, zodat credentials nooit meereizen met de beschrijvende velden die beheerders routinematig bewerken.

Een verbinding krijgt betekenis door een pipeline, de definitie van hoe gegevens erover bewegen: welke resource wordt gelezen of geschreven, in welke richting, op welke planning en volgens welke mapping. Een pipeline verwijst naar een of meer transformatieregels, de declaratieve logica die externe records omvormt naar het eigen vocabulaire van de suite en weer terug, waarbij veldnamen, formaten, codelijsten en eenheden worden opgelost. Elke keer dat een pipeline draait, produceert deze een run-record dat vastlegt wat werd geprobeerd, wat is gelukt en wat niet, en elk record dat niet kan worden verwerkt wordt apart gezet in een foutwachtrij met de volledige context bewaard voor inspectie, correctie en replay. Samen laten deze concepten een beheerder redeneren over integraties in bedrijfstermen: wat is verbonden, wat stroomt er, hoe wordt het vertaald en wat is er gebeurd tijdens de laatste run.

Connector & APIManagementAPI connectorsMCP serversCMS platformsIdentity providersEmail serverEDI & banking
Connector & API Management is the single control plane through which Nashua 360 reaches every external system.

Belangrijkste workflows

Het registreren van een verbinding is de eerste workflow. Een beheerder selecteert het type systeem, levert de endpoints en credentials aan, kiest een authenticatieschema en valideert de verbinding met een live test die de bereikbaarheid en autorisatie bevestigt voordat de verbinding wordt opgeslagen. Van daaruit koppelt het bouwen van een pipeline die verbinding aan een concrete gegevensbeweging: het kiezen van de resource, de richting, de mapping en de planning, waarna een dry-run tegen een steekproef bevestigt dat de transformatie de verwachte vorm oplevert.

Eenmaal live draaien pipelines op hun planning of op verzoek. Elke uitvoering wordt in realtime gemonitord, waarbij doorvoer, latency en slagingspercentages op de hub zichtbaar worden gemaakt. Wanneer records de validatie niet doorstaan of een downstream-systeem ze afwijst, stapelen ze zich op in de foutwachtrij, waar een operator de aanstootgevende payload kan onderzoeken, een mapping of de brongegevens kan aanpassen en de getroffen records opnieuw kan afspelen zonder de hele batch te herdraaien. Het roteren van een credential, het herzien van een transformatieregel of het pauzeren van een partnerfeed zijn allemaal volwaardige bewerkingen, en elk daarvan wordt vastgelegd zodat de toestand van elke integratie op elk moment in het verleden kan worden gereconstrueerd.

Functionele diepgang die telt

De authenticatiedekking van de module is bewust breed, omdat integratie het vaakst faalt op de vertrouwensgrens. Zij verwerkt API-keys, bearer tokens, HTTP basic-credentials en de volledige set OAuth 2.0-grants, waaronder client credentials voor service-to-service-aanroepen en authorization code-flows voor gedelegeerde toegang, met automatische token-refresh en afhandeling van verloop. Voor identiteitsfederatie configureert zij SAML 2.0 met entity-identifiers, sign-on- en single-logout-endpoints, name identifier-formaten en X.509-ondertekeningscertificaten; OpenID Connect en generiek OAuth 2.0 met discovery, scopes en redirect-afhandeling; en directory binding via LDAP en Active Directory met base distinguished names, gebruikers- en groepsfilters en TLS. Just-in-time provisioning en account linking vertalen een gefedereerde login naar een beheerde gebruiker binnen de suite, en gefedereerde logout sluit de sessie netjes af bij de provider.

De diepgang op het gebied van gegevensbeweging is even doordacht. Contentconnectoren spreken het native contract van elk platform: de WordPress REST API, de item- en GraphQL-services van Sitecore, de Adobe AEM content fragment-API, Drupal JSON:API en de Umbraco delivery-API, elk met het correcte authenticatie-idioom. Bankconnectiviteit dekt PSD2-, EBICS- en SWIFT-kanalen, haalt afschriften op en stuurt de parsing aan volgens de CAMT.053-standaard, zodat reconciliatie stroomopwaarts schone, gestructureerde transacties ontvangt. Electronic data interchange past standaard documentformaten en partnerspecifieke enveloppen toe. Overal dwingen transformatieregels datatypeconversie, codelijstvertaling, valuta- en eenheidsnormalisatie en referentiële validatie af, en de retry-, back-off- en dead-letter-mechanismen zorgen ervoor dat een tijdelijke storing soepel degradeert in plaats van gegevens te verliezen.

Hoe het past binnen de Nashua 360-suite

Connector & API Management is de rand van het hele platform, en vrijwel elke andere module bereikt de buitenwereld erdoorheen. Zij werkt het nauwst samen met System Administration, waarvan zij deel uitmaakt, en steunt op het rol- en rechtenmodel van de suite zodat alleen geautoriseerde beheerders een verbinding en de bijbehorende geheimen kunnen inzien of wijzigen. Zij overhandigt Model Context Protocol-serverdefinities aan AI Management, dat bepaalt hoe de AI Workers van de suite externe tools ontdekken en gebruiken. Zij voorziet Content Management van de live connectoren die publiceren naar en ophalen van externe contentplatforms, en zij levert gestructureerde afschriftgegevens aan Accounting & Control, waar de CAMT.053-parser en reconciliatieroutines de bankfeeds consumeren die deze module inplant.

Klant- en identiteitsintegraties voeden de CRM- en toegangslagen van de suite, zodat contactpersonen, accounts en geauthenticeerde gebruikers hun oorsprong hebben in systems of record en daarmee in de pas blijven lopen. De mailconfiguratie vormt de basis onder de notificatie- en rapportageservices waarop veel modules vertrouwen om mensen te bereiken. Doordat elke verbinding centraal is geregistreerd, consumeert de rest van de suite integraties via verwijzing in plaats van eigen credentials in te bedden, waardoor het volledige externe oppervlak van de organisatie vanuit één plek geïnventariseerd, van rechten voorzien en waarneembaar blijft.

Hoe AI Workers erbinnen opereren

AI Workers zijn volwaardige operators in deze module, geen toeschouwers. Een beheerder kan in gewone taal vragen welke connectoren 's nachts zijn gefaald, hoe een bepaalde pipeline zich heeft ontwikkeld of welke partnerfeed achterloopt op schema, en de Worker antwoordt rechtstreeks vanuit run-records en wachtrijstatus. Workers voeren acties uit binnen de hun verleende rechten: het triggeren van een synchronisatie, het opnieuw afspelen van een batch gefaalde records na een mapping-fix, het roteren van een credential volgens planning of het pauzeren van een zich misdragende verbinding.

Zij letten voortdurend op afwijkingen en uitzonderingen, signaleren een piek in de diepte van de foutwachtrij, een plotselinge daling in doorvoer, een authenticatietoken dat het verloop nadert of een partner van wie het leveringsritme is verslapt, en zij brengen deze als waarschuwingen naar voren voordat een mens ze zou opmerken. Wanneer een externe payload in een onbekende vorm binnenkomt, extraheert en structureert een Worker de velden ervan en stelt een transformatiemapping voor, waarmee een inspectietaak verandert in een beoordeling. Workers bieden beslissingsondersteuning door uit te leggen waarom records zijn afgewezen en de corrigerende regelwijziging aan te bevelen. Waar governance het vereist, neemt een Worker deel als goedkeurings- of beoordelingsknooppunt in de eigen workflows van de module, en tekent zij een nieuwe verbinding naar een gevoelig systeem of een wijziging aan een productiepipeline af voordat die van kracht wordt, met haar oordeel vastgelegd in dezelfde audit trail als elke menselijke handeling.