Integrazione API e sicurezza

Trascrizione completa

Il sistema produttivo o di assistenza sa già quando accade qualcosa a un prodotto. L’integrazione deve portare il fatto corretto in OriginSpan senza perdere identità, permessi o risultato. Questo episodio descrive un flusso API di riferimento, dal record sorgente all’esito confermato. Endpoint, credenziali e ambito del connettore vanno concordati per il deployment. Definisci il contratto prima di sviluppare il connettore. Quale sistema governa ogni campo? A quale prodotto, lotto o articolo si fa riferimento? Quali unità, fusi orari e significati sono previsti? Mappa un esempio reale

e uno non valido. Una richiesta riuscita non dimostra che i sistemi abbiano compreso lo stesso fatto. Usa l’autenticazione supportata e concedi solo i permessi necessari. Conserva i segreti in archivi protetti lato server, fuori da pagine pubbliche, repository e log. Pianifica rotazione e revoca. Una credenziale valida identifica il chiamante; il servizio deve comunque autorizzare organizzazione, record e azione. Un identificatore di organizzazione fornito non è di per sé un permesso.

Valida dati e relazioni in ingresso. Rifiuta campi non supportati e valori non validi secondo il contratto. Verifica che l’articolo appartenga al prodotto e all’organizzazione attesi. Separa la risoluzione del codice dai comandi che modificano dati. Leggere il QR della giacca trova informazioni; registrarne l’ispezione è un’operazione autorizzata distinta. Gestisci i timeout senza duplicare eventi. Se la risposta si perde, il mittente può ignorare se il comando sia stato accettato. Per operazioni con chiave di idempotenza, ripeti la stessa richiesta con la stessa chiave e

contenuto invariato. Una richiesta modificata è un’operazione diversa. Conserva i riferimenti accettati e risolvi i conflitti prima di proseguire. Per notifiche asincrone, verifica le regole documentate di firma e validità temporale dove supportate. Prevedi duplicati e ordine di arrivo variabile. Una notifica non autorizza a fidarsi di qualsiasi dato esterno. Registra ciò che è stato elaborato, sorveglia i fallimenti e riconcilia con lo stato autorevole. Prova credenziali scadute, accessi negati, duplicati e dipendenze indisponibili.

Parti da un sistema sorgente e un flusso circoscritto. Concorda volumi, limiti, responsabili, gestione errori ed evidenza di accettazione. Le integrazioni OriginSpan dipendono dai sistemi e dal deployment del cliente; l’esempio non implica che ogni connettore sia attivo. Porta un payload di esempio a una dimostrazione tramite il link di prenotazione.