Connector & API Management

Connector & API Management è l'hub di integrazione di Nashua 360, l'unico piano di controllo attraverso cui la suite dialoga con ogni sistema circostante. Governa l'intero ciclo di vita di un'integrazione, dalle credenziali e dagli endpoint, passando per le regole di trasformazione che riconciliano i dati esterni con il modello della suite, fino alla schedulazione, al monitoraggio e alla gestione degli errori che mantengono i dati in movimento. Ogni punto di contatto esterno viene qui registrato, dotato di credenziali e osservato, offrendo agli amministratori un inventario completo e verificabile della superficie di integrazione dell'organizzazione anziché una dispersione di connessioni punto a punto.

Cosa fa il modulo

Il modulo gestisce l'insieme completo delle connessioni esterne da cui dipende un'impresa moderna. Fornisce il controllo dell'intero ciclo di vita dei connettori API che coprono REST, SOAP e GraphQL, ciascuno con il proprio schema di autenticazione, endpoint di base, header, politica di ripetizione e limiti di frequenza. Configura i server Model Context Protocol che espongono strumenti e risorse al livello di AI della suite e detiene la configurazione della posta in uscita e in entrata, sia SMTP per l'invio sia IMAP per il recupero, che veicola notifiche, report e traffico delle campagne.

Oltre ai singoli connettori, gestisce la movimentazione dei dati su larga scala. Le pipeline ETL ed ELT estraggono dai sistemi di origine, applicano regole di trasformazione dichiarative e caricano nella suite, oppure depositano prima i dati grezzi e li trasformano in loco laddove l'archivio di destinazione è più adatto a tale lavoro. Esegue lo scambio elettronico di dati con i partner commerciali, mantiene connettori verso piattaforme di contenuti tra cui WordPress, Sitecore, Adobe AEM, Drupal e Umbraco e integra i sistemi di gestione clienti e di identità. La sincronizzazione pianificata, il rilevamento delle variazioni, le code di errore dead-letter e la ripetizione completano il quadro, affinché le connessioni non siano semplicemente definite ma operate in modo continuo e osservabile.

Il dominio e il modello dei dati

Al centro del dominio si colloca il concetto di connessione: una relazione durevole e denominata con un sistema esterno. Una connessione contiene tutto ciò che serve per raggiungere quel sistema e fidarsi di esso: i suoi endpoint, il suo materiale di autenticazione e le sue impostazioni di comportamento, conservati come configurazione strutturata e tipizzati in base al tipo di sistema che rappresenta, che si tratti di un'API, di una piattaforma di contenuti, di un provider di identità, di un server di posta o di un canale bancario. I segreti appartenenti a una connessione sono conservati separatamente dalla configurazione ordinaria e cifrati a riposo, così che le credenziali non viaggino mai insieme ai campi descrittivi che gli amministratori modificano abitualmente.

Una connessione acquista significato grazie a una pipeline, ovvero la definizione di come i dati si muovono attraverso di essa: quale risorsa viene letta o scritta, in quale direzione, secondo quale pianificazione e con quale mappatura. Una pipeline fa riferimento a una o più regole di trasformazione, la logica dichiarativa che rimodella i record esterni nel vocabolario proprio della suite e viceversa, risolvendo nomi dei campi, formati, elenchi di codici e unità di misura. Ogni volta che una pipeline viene eseguita produce un record di esecuzione che registra ciò che è stato tentato, ciò che è riuscito e ciò che non è riuscito, e qualsiasi record che non può essere elaborato viene accantonato in una coda di errore con l'intero contesto conservato per l'ispezione, la correzione e la ripetizione. Insieme, questi concetti consentono a un amministratore di ragionare sulle integrazioni in termini aziendali: che cosa è connesso, che cosa fluisce, come viene tradotto e che cosa è accaduto nell'ultima esecuzione.

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

Flussi di lavoro principali

La registrazione di una connessione è il primo workflow. Un amministratore seleziona il tipo di sistema, ne fornisce gli endpoint e le credenziali, sceglie uno schema di autenticazione e convalida la connessione con un test dal vivo che conferma la raggiungibilità e l'autorizzazione prima che la connessione venga salvata. Da qui, la costruzione di una pipeline vincola tale connessione a un concreto spostamento di dati: la scelta della risorsa, della direzione, della mappatura e della pianificazione, per poi eseguirla a vuoto su un campione al fine di confermare che la trasformazione produca la forma attesa.

Una volta attive, le pipeline vengono eseguite secondo le loro pianificazioni oppure su richiesta. Ogni esecuzione viene monitorata in tempo reale, con throughput, latenza e tassi di successo mostrati sull'hub. Quando i record non superano la convalida o un sistema a valle li rifiuta, si accumulano nella coda di errore, dove un operatore può esaminare il payload problematico, modificare una mappatura o i dati di origine e ripetere i record interessati senza rieseguire l'intero lotto. La rotazione di una credenziale, la revisione di una regola di trasformazione o la sospensione dell'alimentazione di un partner sono tutte operazioni di prima classe, e ognuna di esse viene registrata affinché lo stato di qualsiasi integrazione in qualsiasi momento passato possa essere ricostruito.

Profondità funzionale che conta

La copertura di autenticazione del modulo è deliberatamente ampia, perché l'integrazione fallisce più spesso al confine di fiducia. Gestisce chiavi API, token bearer, credenziali HTTP basic e l'intero insieme di grant OAuth 2.0, inclusi i client credentials per le chiamate da servizio a servizio e i flussi authorization code per l'accesso delegato, con aggiornamento automatico del token e gestione della scadenza. Per la federazione delle identità configura SAML 2.0 con identificatori di entità, endpoint di sign-on e single logout, formati di identificatore del nome e certificati di firma X.509; OpenID Connect e OAuth 2.0 generico con discovery, scope e gestione del redirect; e il binding a directory su LDAP e Active Directory con nomi distinti di base, filtri per utenti e gruppi e TLS. Il provisioning just-in-time e il collegamento degli account traducono un login federato in un utente governato all'interno della suite, e il logout federato chiude in modo pulito la sessione presso il provider.

La profondità nella movimentazione dei dati è altrettanto curata. I connettori di contenuti parlano il contratto nativo di ciascuna piattaforma: la REST API di WordPress, i servizi item e GraphQL di Sitecore, la content fragment API di Adobe AEM, JSON:API di Drupal e la delivery API di Umbraco, ciascuno con il proprio corretto idioma di autenticazione. La connettività bancaria copre i canali PSD2, EBICS e SWIFT, recuperando gli estratti conto e pilotando l'analisi verso lo standard CAMT.053, così che la riconciliazione a monte riceva transazioni pulite e strutturate. Lo scambio elettronico di dati applica formati di documento standard e buste specifiche per partner. In ogni fase, le regole di trasformazione impongono la coercizione dei tipi di dati, la traduzione degli elenchi di codici, la normalizzazione di valute e unità di misura e la convalida referenziale, e i controlli di ripetizione, back-off e dead-letter garantiscono che un'interruzione transitoria degradi in modo graduale anziché perdere dati.

Come si inserisce nella suite Nashua 360

Connector & API Management è la frontiera dell'intera piattaforma, e quasi ogni altro modulo raggiunge il mondo esterno attraverso di esso. Collabora più strettamente con l'Amministrazione di Sistema, di cui fa parte, attingendo al modello di ruoli e permessi della suite affinché solo gli amministratori autorizzati possano visualizzare o modificare una connessione e i suoi segreti. Consegna le definizioni dei server Model Context Protocol all'AI Management, che governa il modo in cui gli AI Worker della suite scoprono e utilizzano gli strumenti esterni. Fornisce al Content Management i connettori attivi che pubblicano verso e prelevano da piattaforme di contenuti esterne e consegna dati strutturati degli estratti conto all'Accounting & Control, dove il parser CAMT.053 e le routine di riconciliazione consumano le alimentazioni bancarie che questo modulo pianifica.

Le integrazioni di clienti e identità alimentano i livelli di CRM e di accesso della suite, affinché contatti, account e utenti autenticati provengano dai sistemi di riferimento e restino allineati con essi. La configurazione della posta è alla base dei servizi di notifica e reportistica su cui molti moduli fanno affidamento per raggiungere le persone. Poiché ogni connessione è registrata centralmente, il resto della suite consuma le integrazioni per riferimento anziché incorporare credenziali proprie, il che mantiene l'intera superficie esterna dell'organizzazione inventariata, dotata di permessi e osservabile da un unico luogo.

Come operano al suo interno gli AI Worker

Gli AI Worker sono operatori di prima classe in questo modulo, non semplici spettatori. Un amministratore può chiedere, in linguaggio naturale, quali connettori sono falliti durante la notte, come è andato l'andamento di una determinata pipeline o quale alimentazione di un partner è in ritardo, e il Worker risponde direttamente dai record di esecuzione e dallo stato delle code. I Worker eseguono azioni nell'ambito dei permessi loro concessi: avviare una sincronizzazione, ripetere un lotto di record falliti dopo la correzione di una mappatura, ruotare una credenziale secondo una pianificazione o sospendere una connessione che si comporta in modo anomalo.

Vigilano di continuo su anomalie ed eccezioni, segnalando un picco nella profondità della coda di errore, un calo improvviso del throughput, un token di autenticazione prossimo alla scadenza o un partner la cui cadenza di consegna è slittata, e sollevano questi elementi come avvisi prima che un essere umano se ne accorga. Quando un payload esterno arriva in una forma non familiare, un Worker ne estrae e struttura i campi e propone una mappatura di trasformazione, trasformando un'attività di ispezione in una revisione. I Worker offrono supporto decisionale spiegando perché i record sono stati rifiutati e raccomandando la modifica correttiva della regola. Laddove la governance lo richieda, un Worker partecipa come nodo di approvazione o revisione nei workflow del modulo stesso, approvando una nuova connessione a un sistema sensibile o una modifica a una pipeline di produzione prima che abbia effetto, con il suo giudizio registrato nella stessa pista di audit di qualsiasi azione umana.