🏠 NH Home › 🔌 Integration Hub

🔌 Integration Hub

Centro unificato per canali di integrazione in/out, certificazione dati, audit trail, ITSM bridge.
Canali totali
—
Attivi
—
Events 7gg
—
Today
—
Caricamento canali…
Ingestions oggi
—
Success
—
Errors
—
Avg latency ms
—
RicevutaCanaleSenderSubjectIntentTicketHashAzioni
Caricamento…
Total blocks
—
Active block leaves
—
Max leaves/block
—
Window (min)
—
Verifica integrità ingestion: inserisci ingestion_id per verificare hash chain + merkle proof.
💡 Come funziona: ogni ingestion è hashata (SHA-256) e aggiunta a un blocco della chain (merkle tree). Ogni 15 min o 100 leaves il blocco si chiude: block_hash = SHA-256(prev_hash || timestamp || merkle_root). Immutabile: qualsiasi tampering è rilevato.
Visual editor per trasformare payload esterno → NH ticket. 20 transform ops, condizionali, preview server-side, AI-suggest via Claude.
💡 Feature attive
  • Auto-detect path JSONPath dal sample payload
  • Suggerimenti automatici (subject, priority, status, …)
  • Pipeline transform: lower/upper/map/regex_replace/truncate/coerce/concat/split/strip_html/code
  • Conditional rules when: {path, eq/neq/in/exists/regex}
  • Preview server-side con mapping-engine (single source of truth)
  • Import/export JSON
  • AI-suggest via Claude (endpoint /api/integration-hub/mapping/ai-suggest)
Utilizzabile anche direttamente dentro ogni canale/bridge nella tab 🔌 Integrations Hub di ciascun cliente.
Sincronizzazione bidirezionale con ITSM clienti. 11 adapter disponibili: ServiceNow · exoCortex DB1 · Zendesk · BMC Helix · Freshservice · ManageEngine · HaloITSM · ConnectWise · TOPdesk (via Generic REST) · Autotask · FTP Gateway · Generic REST configurabile.
➕ Aggiungi/configura da Anagrafica Clienti →
Caricamento bridge…
API key per customer che vogliono creare/aggiornare ticket via REST v1.
NomeTenantEmailCompanyCreatedAzioni
Caricamento…
📖 Documentazione per customer:
POST /api/v1/tickets — crea ticket
POST /api/v1/tickets/:key/comment — aggiungi commento
GET /api/v1/tickets/:key — status lookup
Header: X-NH-API-Key: nh_xxxxxxxx
Webhook in uscita: NH invia gli eventi (firmati HMAC) ai tuoi sistemi.
URLEventiFormatoFirmaStatoAzioni
Inserisci un tenant e carica.
🔐 Ogni consegna include X-NH-Signature: sha256=<hmac> se imposti un secret. Topic disponibili in GET /api/webhooks/:tenant/event-types (usa * per tutti).

📖 API Reference (OpenAPI 3.0)

Documentazione REST completa auto-generata dal registry delle route. Autenticazione: JWT Bearer, oppure API-key scoped (Authorization: Bearer nhk.<key>).

Apri Swagger UI ↗ openapi.json ↗
🪪 Identity & Access provisioning — provisioning utenti NH da IdP esterno (Entra/Okta/Google/…) via SCIM 2.0. Genera il token, configuralo sull'IdP insieme all'endpoint SCIM NH. AD/LDAP on-prem arrivano via connettore SCIM dell'IdP (es. Azure AD Connect): il Worker non apre TCP LDAP.
Tenant
Provider
Seleziona un tenant e premi «Stato».
📥 Pull utenti via Graph (Microsoft Entra)
Provisioning pull: NH legge gli utenti da Entra via Microsoft Graph (client-credentials). Richiede un'app registrata su Entra con permesso User.Read.All (application).
Directory (Tenant) ID
Client ID
Client Secret