Technical Specification Template · Web viewLa protezione è ottenuta attraverso misure Hardware e...

Al mio Dio, perché tutto faccio per la sua Gloria!Snam Rete Gas – Logistica Gas

Technical Specification

Author: [Gruppo di Lavoro Nuova Logistica Gas]Date: [2014.07.17]Version: [0.6]

[Logistica Gas – Technical Specification]

Sommario

1 INTRODUZIONE................................................................................................................................................ 31.1 Obiettivi............................................................................................................................................................31.2 Scopo...............................................................................................................................................................3

2 ARCHITETTURA APPLICATIVA DI RIFERIMENTO.................................................................................................42.1 Modello Logico e Concettuale..........................................................................................................................42.2 Ambienti e Piano di Indirizzamento.................................................................................................................5

3 SPECIFICHE DI SICUREZZA................................................................................................................................. 63.1 Abilitazioni.......................................................................................................................................................63.2 Certificati Digitali..............................................................................................................................................6

4 INTEGRAZIONE BUSINESS TO BUSINESS (X12, EDIG@S, ETC.).............................................................................84.1 Integration Layer Logistica Gas........................................................................................................................84.2 Messaggistica X12............................................................................................................................................94.3 Use Case e Sequence Diagram.......................................................................................................................104.4 Struttura dei Messaggi...................................................................................................................................11

4.4.1 Messaggio G850NMST – Nomination 114.4.2 Messaggio G850NMQR – Quick Response 154.4.3 Messaggio 997 – Acknoledgement 15

4.5 Trace Messaggi...............................................................................................................................................164.6 Logiche di Aggregazione, Validazioni Sintattiche e Semantiche.....................................................................164.7 Messaggi di Errore.........................................................................................................................................17

5 APPENDICE A: TECHNICAL REQUIREMENT.......................................................................................................185.1 Connection Parameters..................................................................................................................................185.2 Digital Certificates Parameters.......................................................................................................................205.3 Test Book Basic Connectivity..........................................................................................................................205.4 Test Book Integration Test.............................................................................................................................20

6 APPENDICE B: FREQUENTLY ASKED QUESTIONS..............................................................................................21

of 23


1 Introduzione

1.1 Obiettivi

Con riferimento ai lavori inerenti la nuova soluzione informatica per la gestione dei processi commerciali di Programmazione e Bilanciamento gas, Snam Rete Gas rende disponibile nel presente documento il dettaglio delle attività funzionali alle evoluzioni tecnologiche nelle integrazioni B2B introdotte dalla nuova piattaforma commerciale.L’obiettivo del presente documento è quello di fornire una panoramica dell’architettura complessiva del sistema di logistica Snam Rete Gas, nonché di rappresentare i diversi aspetti e/o funzionalità che il sistema fornisce ai vari interlocutori/utilizzatori, in maniera da chiarirne il funzionamento e presentare i dettagli necessari per l’utilizzo e l’integrazione.

1.2 Scopo

Il presente documento è una specifica tecnica, creato ed aggiornato al fine di garantire che tutte le specifiche tecniche relative al sistema siano sufficienti a consentire l’utilizzo da parte dei partner Snam Rete Gas (Utenti del Trasporto, altri TSO, etc.).Nel dettaglio, si procederà nel dettagliare l’architettura applicativa ed i vari moduli che compongono il sistema, gli standard e requisiti di sicurezza a cui è soggetto, le specifiche tecniche relative all’integrazione Business-to-Business e le specifiche relative alla messaggistica X12/Edig@s supportata.Snam Rete Gas comunicherà progressivamente tutti i dettagli in versioni successive del presente documento al fine di mettere tutti gli utenti del servizio di trasporto nella condizione di comprendere le novità e le specifiche tecniche connesse all’introduzione del nuovo sistema informativo ed illustrarne le relative funzionalità.

of 23


2 Architettura Applicativa di Riferimento

2.1 Modello Logico e Concettuale

Il sistema informativo di Snam Rete Gas consiste in un’applicazione custom caratterizzata da un’architettura applicativa basata su stack Oracle SOA che, rispecchiando i dettami e le specifiche JEEE, rende l’applicazione conforme al modello “a componenti distribuite” e garantisce l’interoperabilità con i sistemi eterogenei (Aziendali ed Esterni).

Figura 1: Modello Concettuale

Schematicamente, l’architettura logico-applicativa del software può essere rappresentata come segue:

Figura 2: Architettura Logica

L’architettura è composta dai seguenti livelli logici:

Presentation Layer : è il livello di presentazione; contiene le componenti che permettono di trasformare gli input dell’utente in una chiamata ai servizi di business logic e/o a componenti dello stesso presentation layer.

of 23


Business Logic Layer : gestisce la logica di business: è composto da una collezione di moduli, servizi, entità, oggetti e interfacce che gli permettono di dialogare sia con il livello di presentation che con i livello di gestione dei dati.

Data Layer : è il livello di gestione dei dati: contiene tutti gli oggetti che servono al Business Logic Layer per reperire le informazioni sulle quali effettuare le elaborazioni richieste.

Integration Layer : è il componente di integrazione tra i layer applicativi e gli altri moduli e/o sistemi della mappa applicativa SNAM, nonché gestore delle comunicazioni X12/Edig@s in Business-to-Business.

L’architettura del nuovo sistema non prevede la necessità di installazione di componenti eseguiti lato client sulle postazioni di lavoro degli utenti. L’accessibilità al sistema deve essere garantita, attraverso web browser, da una qualsiasi postazione informatica connessa ad internet ad eccezione dei dispositivi di tipo mobile.

2.2 Ambienti e Piano di Indirizzamento

Allo stato attuale, il sistema di logistica Snam Rete Gas è composto da cinque ambienti distinti i quali prevedono l’accesso sia per la componente B2B (Messaggistica X12 o Edig@s) sia per al componente Front End (accesso utenti, partner, etc.).Nella seguente tabella si riportano le URL e le indicazioni sull’accessibilità del sistema dall’esterno degli uffici/sedi Snam Rete Gas.

Accesso al Front End Logistica Gas Accesso B2B a Logistica Gas

Ambiente URL Front End Accessibile URL B2B Accessibile

Sviluppo Non Disponibile Non Disponibile Non Disponibile Non

Disponibile

Test Non Disponibile Non Disponibile https://logisticagas-tib-is-gt.snam.it Accessibile

Formazione / Certificazione Shipper Non Disponibile Non

Disponibile https://logisticagas-tib-is-gf.snam.it Accessibile

PreProduzione https://logisticagas-gc.snam.it Accessibile https://logisticagas-tib-is-gc.snam.it Accessibile

Produzione https://logisticagas.snam.it Accessibile https://logisticagas-tib-is.snam.it Accessibile

of 23

https://logisticagas-tib-is.snam.it/

https://logisticagas.snam.it/

https://logisticagas-tib-is-gc.snam.it/

https://logisticagas-gc.snam.it/

https://logisticagas-tib-is-gf.snam.it/

https://logisticagas-tib-is-gt.snam.it/


3 Specifiche di Sicurezza

Nel rispetto degli standard e delle leggi in materia di sicurezza, il sistema di Logistica Snam Rete Gas è in grado di garantire la sicurezza dei propri dati proteggendo i singoli moduli dall'integrità fisica (hardware) e logico-funzionale (software).

La protezione è ottenuta attraverso misure Hardware e Software tese ad assicurae: l'accesso fisico e/o logico solo ad utenti autorizzati (autenticazione); la fruizione di tutti e soli i servizi previsti per quell'utente nei tempi e nelle modalità previste dal sistema

(disponibilità); la correttezza dei dati (integrità); l'oscuramento dei dati (cifratura); la protezione del sistema da attacchi di software malevoli per garantire i precedenti requisiti.

La comunicazione da/verso il sistema di Logistica Snam Rete Gas può avvenire solamente mediante connessioni sicure.

3.1 Abilitazioni

Al fine di abilitare i componente passivi di difesa perimetrale è necessario che i vari Partner Snam Rete Gas comunichino i dettagli relativi al network (URL provenienza, IP, Hostname, Porte, etc.) compilando le informazioni riportate nella tabella in “Appendice A – Connection Parameters”.

3.2 Certificati Digitali

Gli aspetti legati alla sicurezza applicativa sono implementati utilizzando il “Transport Layer Security” (SSL) i quali permettono una comunicazione crittografata e sicura dal sorgente al destinatario (end-to-end) su reti TCP/IP (come ad esempio Internet) fornendo autenticazione, integrità dei dati e cifratura operando al di sopra del livello di trasporto.

Il protocollo SSL consente alle applicazioni client/server di comunicare in maniera sicura, in quanto: nell'utilizzo tipico via cliente (es. browser da parte di utente finale che ha accesso al Front End), l'autenticazione

SSL è unilaterale in quanto è il solo server ad autenticarsi presso il client. Il Client valida il certificato del server controllando che la firma digitale dei certificati del server sia valida e riconosciuta da una Certificate Authority conosciuta utilizzando una cifratura a chiave pubblica.

il protocollo SSL permette anche un'autenticazione bilaterale in cui entrambe le parti si autenticano in modo sicuro scambiandosi i relativi certificati. Questa autenticazione (definita Mutual authentication) richiede che anche il client possieda un proprio certificato digitale. Pertanto, nelle comunicazioni in uscita dal sistema di Logistica Gas, viene richiesto al Partner di munirsi di certificato digitale avente Certificate Authority Ufficiale (preferibilmente “Pubblica”).

Nel contesto delle transazione B2B verso il sistema di Logistica Snam viene introdotta una “Basic Access Authentication”, mediante il quale viene garantito l’accesso al Partner mediante determinate credenziali di accesso; ad ogni Partner Snam Rete Gas che comunicherà con Logistica Gas verrà inviato il necessario per instaurare la connessione.

In definitiva, nel caso di: accesso al Sistema di Logistica mediante Front End, il certificato digitale sarà scaricato dal browser web sul client; accesso al Sistema di Logistica via Business-to-Business in modalità “One-Way” (ovvero solo l’invio delle nomine

e nessuna ricezione degli esiti) allora Snam Rete Gas invierà al Partner il certificato digitale e le credenziali di accesso (HTTPS Basic Authentication);

accesso al Sistema di Logistica via Business-to-Business in modalità “Two-Way” (ovvero l’invio delle nomine e ricezione degli esiti da parte di Logistica Gas) allora:

of 23


o Snam Rete Gas invierà al Partner il certificato digitale e le credenziali di accesso (HTTPS Basic Authentication);

o Il partner invierà il proprio certificato digitale avente CA Ufficiale e Pubblica nonché la URL applicativa su cui è in ascolto.

Le informazioni relative ai certificati digitali Snam sono riportate nella tabella in “Appendice A – Digital Certificates Parameters”.

of 23


4 Integrazione Business to Business (X12, Edig@s, etc.)

4.1 Integration Layer Logistica Gas

L’Integration Layer Logistica Gas rispetta gli standard SOA (Service Oriented Architecture) e supporta i maggiori protocolli di comunicazione ad oggi presenti, ovvero:

SOAP (over HTTPS) Java Message Services Application Statement 2

Limitatamente allo scambio dati via protocolli B2B (formati X12 ed Edig@s), l’integrazione tra il sistema di Logistica ed il sistema del partner avverrà mediante l’Integration Layer utilizzando esclusivamente il protocollo di comunicazione HTTP Sicuro secondo le seguenti modalità:

Dal Sistema Partner vs il Sistema Logistica Gas: Comunicazione HTTP Sicura con Basic Authentication Dal Sistema Logistica Gas vs Sistema Partner: Comunicazione HTTP Sicura.

Figura 3: Integration Layer per le Comunicazioni B2B

Nella Figura 3 sono mostrati i dettagli sui componenti del sistema di logistica e la loro interazione con gli Utenti del Trasporto, ovvero:

Partner/Utenti del Trasporto con i rispettivi sistemi informativi Le comunicazioni di Nomina (obbligatorie – linea continua) e risposte del sistema di Logistica (facoltative – linea

tratteggiata) Il certificato digitale Snam Rete Gas Il certificato digitale del Partner/Utente del Trasporto da utilizzare per i messaggi di ritorno I messaggi X12 scambiati (Nomination, Response, Formal Validation)

Come anticipato nel precedente paragrafo, nel sistema di trasporto nomine di Logistica Gas è previsto che i messaggi X12 siano gestiti esclusivamente su canale HTTPS in entrambe le direzioni, con autenticazione del sistema mittente tramite

of 23


HTTPS Basic Auth; questo significa che gli impatti verso gli Utenti del Trasporto si distinguono in base al tipo di messaggi/flussi scambiati con Snam Rete Gas.In particolare sono così classificabili:

Flussi B2B con UdT che implementano solo il messaggio X12 G850NMST – Nomination (Nomina):o In questo caso l’UdT dovrà gestire la comunicazione verso Snam Rete Gas mediante l’utilizzo del

protocollo HTTPS con l’autenticazione nelle chiamate. Snam Rete Gas fornirà sia il certificato digitale necessario per la connessione verso il sistema di Logistica sia le credenziali di accesso per la parte di autenticazione.

Flussi B2B con UdT che implementano anche i messaggi X12 997 – Functional Acknowledgement e/o G855NMQR – Nomination Quick Response

o In questo caso il partner/Utente del Trasporto oltre a gestire la comunicazione verso Snam Rete Gas mediante l’utilizzo del protocollo HTTPS con l’autenticazione nelle chiamate, dovrà fornire a Snam Rete Gas una URL applicativa che il sistema di Logistica Gas dovrà richiamare per la comunicazione ed un certificato digitale per consentire la comunicazione HTTPS.

o Il certificato digitale fornito dal Partner deve essere un certificato SSL Server, creato con CA pubblica e chiave a 2048 bit.

Con le informazioni in possesso, il Gruppo di Lavoro del Sistema Logistica Gas ed il Gruppo di Lavoro del sistema Partner si accorderanno per eseguire dei test di connettività volti a certificare:

La raggiungibilità del sistema di logistica Snam da parte del sistema informativo Partner/Utente del Trasporto e viceversa mediante prove di network reachability test

Validità del certificato digitale di Snam Rete Gas e del Partner/Utente del Trasporto L’autenticazione del Partner/Utente del Trasporto sul sistema di Logistica Gas

Il Test Book è riportato in “Appendice A – Test Book Basic Connectivity”; per la modalità e la pianificazione del test si farà riferimento alle pubblicazioni ufficiali Snam rete Gas.

4.2 Messaggistica X12

La comunicazione tra il trasportatore e gli utenti/partner prevede la predisposizione e lo scambio di alcuni Messaggi Standard ANSI X12 aventi dei dataset standard e tracciati/formati definiti dal GISB (Gas International Standard Board). I dataset interessati sono:

G850NMST – Nomination: messaggio obbligatorio inviato dal Partner a Snam Rete Gas G855NMQR – Nomination Quick Response: messaggio facoltativo inviato da Snam Rete Gas al Partner 997 – Acknoledgement: messaggio facoltativo inviato da Snam Rete Gas al Partner.

In continuità rispetto all’As Is, gli Utenti/Partner hanno la possibilità di inviare le nomination a Snam Rete Gas utilizzando lo standard ANSI X12 dove, la ricezione e gestione dei messaggi X12, coinvolge due componenti fondamentali:

L’integration Layer, che si occupa della verifica sintattica e formale dei messaggi ricevuti; L’Engine “Logistica Gas”, il quale esegue delle verifiche “di Business” sul contenuto dei messaggi (validità

contratti, punti, etc.). A seguito della verifica dei messaggi da parte dell’Engine Logistica Gas il sistema invia al Partner il Quick

Response, un messaggio ANSI X12 che contiene il risultato delle verifiche effettuate (nomination accettate oppure rifiutate, con l’indicazione dei motivi dello scarto).

In continuità rispetto all’As Is, le nomination dovranno essere effettuate inviando: Un solo file per la rete nazionale “N” files per le “N” Reti Regionali interessate

of 23


4.3 Use Case e Sequence Diagram

Al fine di chiarire le modalità con il quale avviene la comunicazione tra Partner ed il sistema di Logistica Snam Rete Gas, si riportano rispettivamente il diagramma dei casi d’uso e la sequenza informativa delle singole elaborazioni.

Figura 4: Gestione Messaggi X12 - Use Case

UdT Snam Rete Gas

G850NMST – Nomination HTTPS Request

G850NMST – Nomination HTTPS Reply

G855NMQR – Nomination Quick ResponseHTTPS Request

G855NMQR – Nomination Quick ResponseHTTPS Reply

Optional CommunicationSnam Rete Gas Logistica Gas System send Syntax Validation Result vs UdT

Mandatory CommunicationUdT send Nomination Messages to

Snam Rete Gas Logistica Gas System

997 – Functional AcknowledgementHTTPS Request

997 – Functional AcknowledgementHTTPS Reply

Optional CommunicationSnam Rete Gas Logistica Gas System send a

Functional Acknowledege / Formal Validation vs UdT

1

2

3

Figura 5: Gestione Messaggi X12 - Sequence Diagram

of 23


4.4 Struttura dei Messaggi

4.4.1 Messaggio G850NMST – Nomination

Di seguito si riporta il branching diagram in merito al messaggio G850NMST – Nomination:

Figura 6: Gestione Messaggi X12 – Branching Diagram G850NMST

4.4.1.1 Segmento ISA

Il primo segmento di testata rappresenta la busta del messaggio, riportante mittente, destinatario ed altri dati necessari.Questo segmento è comune a tutti i messaggi X12 ed in quanto tale è obbligatorio e deve essere unico all’interno della nomina. I campi degni di nota sono: 06 e 08 che identificano mittente e destinatario attraverso un codice preventivamente condiviso, il 13 che identifica il segmento con un numero di sequenza unico per il mittente. Al segmento ISA corrisponde un segmento di chiusura IEA con il quale condivide l’ID (ISA13 deve essere uguale ad IEA02).

Esempio di segmento ISA valido:ISA~00~ ~00~ ~01~99999 ~01~00001 ~131010~1334~U~00304~000002001~0~P~|

4.4.1.2 Segmento GS

Il segmento GS identifica un gruppo di funzioni del protocollo X12. Il gruppo è identificato dal campo 08 che deve essere obbligatoriamente valorizzato con “003040”, stessa cosa per il campo 01 con il valore PO. Al segmento GS corrisponde un segmento di chiusura GE, pertanto il campo GS06 riportante un identificativo numerico unico per il mittente va valorizzato allo stesso modo del campo GE02. I campi 04 e 05 riportano i riferimenti temporali di invio della nomina, già inseriti nell’ISA. Il segmento deve essere presente ed unico all’interno della nomina.

Esempio di segmento GS valido:GS~PO~G850NMST~G850NMST~130930~1334~000002001~X~003040

4.4.1.3 Segmento ST

Il segmento ST fa parte dei segmenti di testata ed identifica la transazione in corso. Il campo ST01 identifica il messaggio 850, che quindi è un valore obbligatorio. L’ST02 svolge la stessa funzione identificativa del ISA13 per il proprio segmento, quindi sarà un numero di sequenza univoco per il mittente. Anche al segmento ST corrisponde un segmento di chiusura, GE, con il quale condivideranno l’ID (ST02 = SE02). Il segmento deve essere presente con una sola occorrenza.

of 23


Esempio di segmento ST valido: ST~850~000000102

4.4.1.4 Segmento BEG

Il BEG è il primo segmento del corpo del messaggio ed indica lo scopo della transazione. Il campo 02 deve essere valorizzato con un valore custom “G1” non appartenente allo standard X12. Il segmento deve essere presente con una sola occorrenza.

Esempio di segmento BEG valido: BEG~00~G1~0001~~130930

4.4.1.5 Segmento DTM

Il segmento DTM, presente in questo livello, identifica i parametri temporali di invio della nomina. Questo segmento è atteso ma non obbligatorio. In questo livello va valorizzato obbligatoriamente come indicato nella tabella. Il valore “DT” [Data] del campo 06, indica che il campo 07 andrà valorizzato nel formato data CCYYMMDDHHMM, ad esempio “201309301334” [AnnoMeseGiornoOreMinuti].

Esempio di segmento DTM valido:DTM~102~~~~~DT~201309301334

4.4.1.6 Segmento N1

Questo segmento identifica il business partner, a questo scopo si attendono due segmenti N1 riportanti il richiedente ed il provider del servizio. Per identificare il richiedente il campo 01 deve essere valorizzato con “78”, al contrario per identificare il provider si utilizza il valore “SJ”. Il campo 04 deve contenere il codice del partner, lo stesso riportato nella testata ISA [06,08].

Esempio di segmento N1 valido:N1~SJ~~1~00001

4.4.1.7 Segmento PO1

Il segmento PO1 riporta i dati relativi al contratto ed al numero di modello del line item. Un item riporta un insieme di richieste per una data specifica. In una nomina ci attendiamo un segmento PO1 per nomine nazionali e due segmenti PO1 per nomine regionali. I campi da evidenziare sono lo 07 riportante il nome dello shipper richiedente legato all’utenza assegnata ed il campo 09 che va valorizzato con “N” per il segmento PO1 di una nomina nazionale e con “T” o “U” nei segmenti PO1 della nomina regionale. La T indica un Threaded-Path, ossia che in questo item andremo a definire per ciascun segmento SLN (sub-line item) un percorso indicando due punti, receipt e delivery (ricezione e riconsegna). Insieme a questo segmento definiremo un secondo PO1 con un campo 09 valorizzato con U indicante un UnThreadedPath, che avrà il compito di riassumere il totale di energia (gas) richiesta per ciascun punto nominato nella parte T.

Esempio di segmento PO1 valido:PO1~1~~~~~CR~CC-ACNTEST-RN~MN~N

4.4.1.8 Segmento DTM

Il segmento DTM, incluso nel PO1, identifica il periodo per il quale viene effettuata la richiesta indicata dall’item. Si possono usare due formati diversi per indicare il periodo di richiesta:

1. Utilizziamo 2 segmenti DTM indicando nel primo la data di inizio con DTM01 = ”007”, nel secondo DTM01 = “197” ed in entrambi inseriremo DTM06 = “DT” ed in DTM07 le date nel formato, CCYYMMDDHHMM [Es: 201310010600]

of 23


2. Altrimenti possiamo utilizza un solo segmento DTM riportante un range di date. I campi saranno valorizzati nel seguente modo, DTM01 = “007”, DTM06 = “RDT”, DTM07 con il formato data seguente,

CCYYMMDDHHMM-CCYYMMDDHHMM [Es: 201310010600-201310020600]

Esempio di segmento DTM valido:DTM~007~~~~~RDT~201310010600-201310020600

4.4.1.9 Segmento SLN

Il segmento SLN identifica la singola richiesta o sub-line item ed è incluso nel segmento PO1. Ci si aspetta uno o più segmenti SLN per ciascun item, dove ognuno riporta la quantità richiesta di gas al campo 04 e l’unità di misura nello 05.

Esempio di segmento SLN valido:SLN~1~000001~I~656640~GV

4.4.1.10 Segmento SI

A ciascun segmento SLN corrisponde un segmento SI che va incluso al suo interno. Questo rappresenta il dettaglio della richiesta. I campi di questo segmento vanno valorizzati come descritto nella tabella, salvo per le nomine nazionali dove possiamo valorizzare solo i primi quattro campi, come da esempio. I valori R e D nel campo 03 indicano rispettivamente Receipt e Delivery.

Esempio di segmento SI valido:SI~AP~QT~R~TT~01

4.4.1.11 Segmento N1

Il campo N1, a questo livello, si trova incluso nel segmento SLN. Come già descritto nei segmenti precedenti, ci troviamo nel dettaglio del sub-line item ed andiamo ad indicare con questo segmento, il punto di ricezione o di riconsegna del gas. Nelle nomine di tipo nazionale, indichiamo un punto singolo quindi un singolo segmento N1 per ciascun sub-line item, così anche per la parte UnThreaded delle nomine regionali. Nella parte Threaded, invece, le richieste dovranno includere due segmenti N1 per identificare i punti di Ricezione e Riconsegna. Il campo 01 indica con M2 ricezione e con MQ riconsegna, il campo 04 riporta il codice del punto che dovrà essere presente in anagrafica e sarà soggetto a controllo semantico.

Esempio di segmento N1 valido:N1~M2~~29~35718200

4.4.1.12 Segmento CTT

Segmento di controllo costituito da un solo campo. Identifica il numero dei segmenti contenuti nel line-item, PO1.

Esempio di segmento N1 valido:CTT~1

4.4.1.13 Segmento SE

Segmento di chiusura del segmento ST. Il campo 01 riporta il numero di segmenti inclusi nel Transaction Segment (ST - SE), il campo 02 riporta l’ID del campo ST02

Esempio di segmento SE valido:SE~000000012~000000102

of 23


4.4.1.14 Segmento GE

Segmento di chiusura del segmento GS. Il campo 01 riporta il numero di transazioni contenute, il campo 02 il numero di controllo uguale al GS06. Esempio di segmento GE valido:GE~1~000002001

4.4.1.15 Segmento IEA

Segmento di chiusura del segmento IEA. Il campo 01 riporta il numero di gruppi contenuti, il campo 02 il numero di controllo uguale al valore contenuto nel campo ISA13.

Esempio di segmento IEA valido:IEA~1~000002001

Esempio completo per nomina X12 Nazionale:ISA~00~ ~00~ ~01~99999 ~01~00001 ~131010~1334~U~00304~000002001~0~P~|GS~PO~G850NMST~G850NMST~130930~1334~000002001~X~003040ST~850~000000102BEG~00~G1~0001~~130930DTM~102~~~~~DT~201309301334N1~78~~1~99999N1~SJ~~1~00001PO1~1~~~~~CR~CC-ACNTEST-RN~MN~NDTM~007~~~~~RDT~201310010600~201310020600SLN~1~000001~I~656640~GVSI~AP~QT~R~TT~01N1~M2~~29~35718200CTT~1SE~000000012~000000102GE~1~000002001IEA~1~000002001

Esempio completo per nomina X12 Regionale:ISA~00~ ~00~ ~01~99999 ~01~00003 ~130930~1334~U~00304~000002002~0~P~|GS~PO~G850NMST~G850NMST~130930~1334~000002002~X~003040ST~850~000000001BEG~00~G1~0001~~130930DTM~102~~~~~DT~201309301334N1~78~~1~99999N1~SJ~~1~00003PO1~1~~~~~CR~CC-ACNTEST-A~MN~TDTM~007~~~~~RDT~201310010600-201310020600SLN~1~000001~I~201~GVSI~AP~QT~R~TT~01~R1~1~R2~1~R3~1~R4~1N1~M2~~29~10000001N1~MQ~~29~30161001PO1~2~~~~~CR~CC-ACNTEST-A~MN~UDTM~007~~~~~RDT~201310010600-201310020600SLN~1~000002~I~201~GVSI~AP~QT~D~TT~01~R3~1~R4~1N1~MQ~~29~30161001SLN~2~000003~I~201~GVSI~AP~QT~R~TT~01~R1~1~R2~1N1~M2~~29~10000001CTT~2SE~000000021~000000001GE~1~000002002IEA~1~000002002

of 23


4.4.2 Messaggio G850NMQR – Quick Response

Di seguito si riporta il branching diagram in merito al messaggio 850 – Nomination:

Figura 7: Gestione Messaggi X12 – Branching Diagram G855NMQR

Questo messaggio viene inviato in risposta ad un messaggio 850, successivamente ad un 997, per notificare l’avvenuta validazione semantica ed elaborazione sulla piattaforma di Logistica Gas. Questo controllo verifica la qualità dei dati immessi con controlli in database ed anagrafica. L’esito sarà fornito nel campo BAK02 con:

AT per Accepted RD per Rejected.

Di seguito esempio completo di 855 in OK:

ISA~00~ ~00~ ~01~00001 ~01~99999 ~130925~1526~U~00304~000011555~0~P~|GS~PR~G855NMQR~G855NMQR~130925~1526~000011555~X~003040ST~855~000000001BAK~27~AT~0001~130925N1~78~~1~99999N1~SJ~~1~00001CTT~0SE~000000006~000000001GE~1~000011555IEA~1~000011555

4.4.3 Messaggio 997 – Acknoledgement

Di seguito si riporta il branching diagram in merito al messaggio 997 – Acknoledgement:

of 23


Figura 6: Gestione Messaggi X12 – Branching Diagram 997

Il messaggio “997 – Acknoledgement” è un messaggio inviato dal sistema di Logistica Snam verso gli Shipper che ne fanno richiesta; è un messaggio opzionale (ovvero non è obbligatorio per il processo di nomina via X12), ed inviato in risposta al messaggio G850NMST per indicare l’esito della validazione sintattica:

Rispetto dei controlli sul formato dei campi Rispetto dei valori ammessi (ammissibilità)

In caso di errore l’intera messaggio G850NMST (quindi l’intera nomina) viene rigettata.Nel dettaglio, l’esito della validazione generica viene riportato nel campo AK901 dove:

“A” indica lo stato “Accepted”, ovvero che il messaggio G850NMST inviato dallo Shipper è stato accettato; “R” indica lo stato “Rejected”, ovvero che il messaggio G850NMST inviato dallo Shipper è stato rifiutato.

I rimanenti segmenti (AK1 – AK2 – AK3 – AK4 – AK9) possono essere usati, in caso di errore, per visualizzare/riportare il dettaglio delle eccezioni.

Di seguito esempio completo di 997 in OK:ISA~00~ ~00~ ~01~00001 ~01~99999 ~130925~1525~U~00304~000011554~0~P~|GS~FA~997~997~130925~1525~000011554~X~003040ST~997~000011554AK1~PO~000001000AK9~A~1~1~1SE~000000004~000011554GE~1~000011554IEA~1~000011554

Di seguito esempio completo di 997 in KO:ISA~00~ ~00~ ~01~00001 ~01~00999 ~140624~1318~U~00304~000000038~0~P~|GS~FA~G850NMST~G850NMST~140624~131817~19~X~003040ST~997~0001AK1~PO~000002001AK2~850~000000102AK3~DTM~3~~8AK4~8~1251~3AK5~R~5AK9~R~1~1~0SE~8~0001GE~1~19IEA~1~000000038

4.5 Trace Messaggi

La sezione è in completamento.

4.6 Logiche di Aggregazione, Validazioni Sintattiche e Semantiche

La sezione è in completamento.

of 23


4.7 Messaggi di Errore

In merito al messaggio G855NMQR Quick Response si riportano le codifiche di errore relative ai controlli semantici che saranno implementati sul sistema Logistica Gas.

Descrizione errore Codifica messaggio 855Il codice dell'utente che ha effettuato la nomina non esiste in anagrafica del sistema Logistica Gas

ENMQR520 - Invalid identificationcode qualifier (N103)No definition necessary

Il ciclo di nomina non è aperto per l'intero periodo temporale per il quale è stata fatta la nomina.

ENMQR315 - Time Stamp is outside ofacceptable range.(DTM07)Time Stamp for nominateddate range is not within anyvalid nomination cycle.

E' stata effettuata una nomina su un'area di prelievo che non esiste in anagrafica del sistema Logistica Gas

ENMQR109 - Invalid TransportationService Provider (N104)No definition necessary

E' stata effettuata una nomina su almeno un misuratore che non esiste in anagrafica del sistema Logistica Gas

ENMQR525 - Invalid Receipt Location (N104) No definition necessary

Nomina minore di zero ENMQR505 - Other Quantity error

L'unità di misura della nomina non corrisponde all'unità di misura che il sistema LG si aspetta

ENMQR506 - Invalid unit or basis for measurement code (SLN05, PO307)

Nomina non accettabile in quanto si è verificata almeno una delle seguenti condizioni:- Il ciclo di nomina è chiuso- l'utente non è abilitato alla nomina per quel determinato ciclo- è stato nominato almeno un misuratore non nominabile

EQRLG003 - Time Stamp for nominated date range is not within any valid nomination cycle or the user is not abilitate to nominate for this cycle or the location is not nominable for the user.

La nomina è stata effettuata su uno o più misuratori inattivi

ENMQR528 - Receipt Location is locked (N104) This receipt location is unavailable for nominations.

Non si ha capacità conferita su uno o più misuratori nominati ENMQR539 - Path invalid for contract

Si è verificato un errore generico, si prega di riprovare l'invio

EQRLG001 - generic error. Please re-try to send nominations

La nomina inviata contiene delle informazioni duplicate EQRLG002 - nominations sent contain duplicate data

La data di inizio o fine nomina non è valida ENMQR308 - Invalid date/timequalifier (DTM01)No definition necessary

Tabella 1: Elenco codici di errore relativi al messaggio G855NMQR

of 23


5 Appendice A: Technical Requirement

5.1 Connection Parameters

Di seguito si riportano le informazioni che il Sistema Partner dovrà comunicare a Snam Rete Gas per consentire la corretta configurazione del canale di comunicazione.

Area Category Information Description Value / Example Snam Rete Gas Parameters Partner Parameters

Cross

Identification

Partner Name (es. NBA International) Name of Partner NBA Trading Snam Retr Gas

Partner Code (EIC, etc.) Partner Code 21X-IT-A-NBATR-A 21X-IT-A-A0A0A-7

Partner Location (es. Milan, etc.) Location Milan Milan

Role (TSO, Shipper, etc.) Partner Role Shipper TSO

General project information

Contact informations (Phone, Email, …)

Contact 1Daniele Gianni

Support @Provider.net0039…

LogisticaGas.Support @ snamretegas.it

… … …

Application Requirement

Documents formats Supported Document Types

XML No No

X12 Yes Yes

EDIFACT / Edig@s No No

Binary No No

Communication Protocol

Supported Document Protocol

HTTP No No

HTTPS Yes Yes

AS2 No No

AS4 No No

SFTP / FTPS No NoTech Spec – Test

Enviroment

Security

Certificate Delivered by Certification Authority Certificate File / Expiration Date … Scaricabile dal Portale

Durata: 3 anniList of Certificate files used to

Verify CA Certificate files … GlobalSign

Username for Basic Auth Username (Only for Partner) … Comunicata Privatamente Non Prevista

Password for Basic Auth Password (Only for Partner) … Comunicata Privatamente Non PrevistaReception URL URL Address used by Partner to receive

inbound flow N/A Non Prevista

URL SSL Address used by Partner to receive inbound HTTPS flow

https://test.secure.partner.com https://logisticagas-tib-is-gt.snam.it

of 23

https://test.secure.partner.com/


IP AddressesInbound TCP IP Address Receiver IP Address & Port 127.0.0.1 ; 443 213.217.190.17 ; 443

Outbound TCP IP Address Sender IP Address 1.0.0.127 In Definizione

Tech Spec – Acceptance Enviroment

Security

Certificate Delivered by Certification Authority Certificate File / Expiration Date … In Definizione

List of Certificate files used to Verify CA Certificate files … In Definizione

Username for Basic Auth Username … In Definizione Non Prevista

Password for Basic Auth Password … In Definizione Non Prevista

Reception URLURL Address used by Partner to receive

inbound flow N/A In Definizione

URL SSL Address used by Partner to receive inbound HTTPS flow https://acp.secure.partner.com In Definizione

IP AddressesInbound TCP IP Address Receiver IP Address 127.0.0.1 In Definizione


Tech Spec – Production Enviroment

Security

Certificate Delivered by Certification Authority Certificate File / Expiration Date QuoVadis

(2014-04-15) In Definizione

List of Certificate files used to Verify CA Certificate files … In Definizione

Username for Basic Auth Username ShipperUsername In Definizione Non Prevista

Password for Basic Auth Password ShipperPassword In Definizione Non Prevista

Reception URLURL Address used by Partner to receive

inbound flow N/A In Definizione

URL SSL Address used by Partner to receive inbound HTTPS flow https://prod.secure.partner.com In Definizione

IP AddressesInbound TCP IP Address Receiver IP Address 127.0.0.1 In Definizione


Tabella 2: Connection Parameters

of 23

https://prod.secure.partner.com/

https://acp.secure.partner.com/


5.2 Digital Certificates Parameters

Di seguito si riportano le informazioni relative ai certificati digitali Snam Rete Gas.

Test Acceptance ProductionCertificate Authority(Certificate valid to yyyy-mm-dd) GlobalSign … …

Key Size 2048 … …Signature Algorithm SHA-1 … …

Tabella 3: Impostazioni Certificato Snam Rete Gas

5.3 Test Book Basic Connectivity

Di seguito si riportano i casi di test relativi alle prove di connessione tra il sistema Logistica Gas ed il sistema Partner; qualora tra i gruppi di lavoro sorga l’esigenza di integrare/aggiungere altri casi di test si provvederà ad aggiornare l’elenco corrente.

ID Area Precondition Configuration Required Description Expected Resultt

1.1 Network /Application

I soggetti partner sono configurati per supportare le specifiche

descritte in “Appendice A – Digital Certificate Parameter” ed

Autenticazione Partner

HTTPS Message Exchange

Il Client HTTPS del Sistema Partner tenta di accedeere

al Sistema di logistica usando il certificato.

Instaurazione della connessione sicura

tra i due sistemi informative.

1.2 Network /Application

Il sistema di Logistica Gas Snam Rete Gas è configurato per supportare le specifiche di sicurezza del sistema

del trasporto

HTTPS Message Exchange

Il Client HTTPS del Sistema logistica accede al Sistema

partner usando il certificato del partner

Instaurazione della connessione sicura

tra i due sistemi informative

1.3 ApplicationI soggetti partner sono configurati

per l’invio di un file e/o X12 di prova verso il sistema di Logistica

HTTPS Message Exchange + Document Generation

Invio di un file e/o X12 di prova dal sistema Partner

verso Snam

Ricezione su sistema di logistica del

documento inviato dal Partner

1.4 ApplicationIl sistema di Logistica è configurato

per l’invio di un file e/o X12 di prova verso Partner

HTTPS Message Exchange + Document Generation

Invio di un file e/o X12 di prova dal sistema Snam verso il sistema Partner

Ricezione sul sistema partner del

documento inviato dal sistema Logistica

SnamTabella 4: Prove di Connettività - Test Book

5.4 Test Book Integration Test

L’obiettivo dell’Integration Test è quello di verificare che sia che i sistemi dei partner ed il sistema di LG dialoghino correttamente sia che tutte le casistiche di errore vengano intercettate e gestite correttamente.

I test cases sono suddivisi in due macro aree: Invio delle Nomine X12

o Trasmissione Nomine X12 con capacitào Trasmissione Nomine X12 su Misuratore Fittizioo Trasmissione Nomine X12 over capacitào Trasmissione Nomine X12 inferiore al limite minimoo Trasmissione Nomine X12 over capacità Intraday

Gestione delle Eccezionio Invio set duplicatio Dato obbligatorio mancanteo Controlli semantico falliti

of 23


Il file completo è in allegato al presente documento

Allegato 1: Integration Test - Test Book

6 Appendice B: Frequently Asked Questions

1) Quanti e quali messaggi X12 saranno gestiti dal nuovo sistema informativo Snam Rete Gas? In continuità rispetto alle funzionalità As Is, il sistema informativo di Snam Rete Gas gestirà i seguenti tre

messaggi:o G850NMST – Nomination: messaggio obbligatorio inviato dal Partner a Snam Rete Gaso G855NMQR – Nomination Quick Response: messaggio facoltativo inviato da Snam Rete Gas al Partnero 997 – Acknoledgement: messaggio facoltativo inviato da Snam Rete Gas al Partner.

2) Quale è il protocollo di trasporto utilizzato dal nuovo sistema informativo Snam Rete Gas per il trasferimento delle informazioni/messaggi?

Per le comunicazioni Business-to-Business il sistema di Logistica di Snam Rete Gas utilizzerà esclusivamente il protocollo HTTPS (HyperText Transfer Protocol over Secure Socket Layer) dove, nel contesto della transazione HTTP, viene implementata una basic access authentication. L'autenticazione BA non prevede protezione per le credenziali trasmesse, in quanto vengono solamente codificate con base64 ma non criptate o crittografate con hash.

3) Da chi è rilasciato il Certificato Digitale di Snam Rete Gas? Il certificato digitale utilizzato da Snam Rete Gas è rilasciato da una Certificate Authority pubblica ed autorizzata, i

dettagli sono riportati nell'apposita Appendice.

4) È possibile utilizzare il protocollo HTTPS solo per alcuni messaggi (es. 850) e HTTP Standard per i messaggi 997 e G855NMQR?

La comunicazione da/verso il sistema di Logistica Snam Rete Gas avviene esclusivamente mediante protocollo HTTPS.

5) Quando sarà disponibile il certificato digitale Snam ed in che modalità verrà fornito? La disponibilità e la distribuzione del Certificato Digitale Snam sarà comunicata da Snam Rete Gas sul proprio

portale ai Partner che si accrediteranno.

6) Username e Password di autenticazione hanno una scadenza? Esiste un solo Username per Partner? Ogni Utente/Partner accederà al sistema con la proprie credenziali. Attualmente non è previsto nessun

meccanismo di validità delle credenziali necessarie per la Basic Authentication.

7) È prevista la cifratura del contenuto informativo del messaggio o solo del canale trasmissivo? Nelle comunicazioni non è prevista la cifratura del messaggio, ma solo del canale di trasmissione mediante HTTP

Sicuro (HTTPS).

8) Cosa dovrà comunicare Snam Rete Gas al Partner/UdT? Per consentire l’integrazione con il Sistema di Logistica, Snam Rete Gas fornirà ai partner:

of 23


o Il certificato digitale Snam Rete Gas utilizzato per il canale HTTPS, rilasciato da una Certificate Authority Ufficiale e Pubblica;

o Una URL applicativa, che sarà richiamata dal sistema Partnero Le credenziali di accesso (Username, Password)o Qualora fosse necessario, anche gli IP/Host del sistema Snam

9) Cosa dovrà comunicare il Partner/UdT a Snam Rete Gas? Per consentire al Sistema di Logistica Snam Rete Gas di integrarsi, il sistema Partner dovrà comunicare a Snam

Rete Gas:o Il proprio IP/Host per abilitare i dispositivi di sicurezza passiva;o Se il partner implementa i messaggi G855NMQR e 997:

Il proprio certificato digitale SSL Server, creato con Certificate Authority pubblica e chiave a 2048 bit .

Una URL applicativa che sarà richiamata dal Sistema Snam Rete Gas

10) Per le comunicazioni tra Snam Rete Gas ed i sistemi Partner è richiesto l'utilizzo dell'HTTPS con Basic Authentication?

Per le comunicazioni tra Snam Rete Gas ed i sistemi Partner non è richiesta la Basic Authentication, ma solo l’utilizzo del canale trasmissivo HTTPS.

11) Quando saranno eseguiti i Test Connettività tra i Partners ed il sistema di Logistica Snam Rete Gas? I Test di Connettività avverranno nei tempi e modalità pubblicate da Snam Rete Gas sul proprio portale ai Partner

che si accrediteranno.

12) Contestualmente all’utilizzo dell’HTTS, sono previste modifiche ai files X12? Cambierà anche la modalità di invio?

Non sono previste modifiche al tracciato dei messaggi X12, né alla modalità di invio verso.

13) Nel caso in cui un UdT non implementi i messaggi 997 e 855 è confermato l’invio dell’eMail di notifica degli eventuali scarti? Qual è il corpo dell’eMail?

Non sono previste modifiche ai comportamenti e/o dinamiche del sistema As Is, pertanto saranno mantenute tutte le features relative alle notifiche ed alert.

14) Da chi devono essere prodotti/rilasciati i certificati digitali per la comunicazione verso il Sistema di Logistica Snam?

I certificati richiesti per l’autenticazione devono essere prodotti da un’Autorità Certificatrice Ufficiale e Pubblica, pertanto non è possibile generarli autonomamente.

15) Sono un UdT che non utilizza la comunicazione B2B: cosa devo fare? Devo adeguare i miei sistemi? Gli shipper che oggi nominano accedendo ai tool web Snam Rete Gas (Altraweb, etc.) non dovranno adeguare i

propri sistemi. In continuità rispetto all’As Is, nel To Be il nuovo sistema di logistica sarà dotato di una interfaccia utente che permetterà di inserire le nomine ed effettuare le medesime operazioni.

16) Sono un UdT per il quale la pianificazione dei test pubblicata Snam Rete Gas non è sostenibile: cosa devo fare? Gli UdT che ritengono la pianificazione proposta da Snam Rete Gas non è sostenibile potranno utilizzare le

apposite sessioni di backup; qualora fossero ancora insufficienti allora l’UdT concorderà con Snam Rete Gas una sessione di recupero.

17) Dopo i test di connettività sono previsti ulteriori test? Con quali tempistiche?

of 23


A valle dei test di connettività le attività proseguiranno come da pianificazione ufficiale Snam Rete Gas pubblicata sul portale.

18) Sono previsti test per verificare la correttezza dei dati inviati? La correttezza formale del dato sarà oggetto di verifica durante l’apposita fase di Integration Test.

19) Per quanto tempo resterà attivo il servizio plain http per l’invio di nomine? L’attuale canale di comunicazione X12 rimarrà attivo fino al Go Live del nuovo sistema di Logistica Gas.

20) I certificati lato Shipper, devono essere diversi per ogni ambiente (Test, prod, etc.) o possono essere lo stesso certificato installato su ognuno di essi?

Poiché si tratta di configurazioni di sicurezza relativi allo shipper è compito dello shipper comunicare la configurazione/setup più congeniale.

21) Ci sono altri adempimenti che lo Shipper deve effettuare che sono necessari per l’operatività attuale? Lo shipper che ha intenzione di usare altri messaggi X12 oltre al G850NMST deve effettuare opportuna

comunicazione a Snam Rete Gas.

22) Gli shipper che non aderiranno/supereranno il test di connettività potranno usufruire del canale di comunicazione X12?

Poiché il passaggio ad HTTPS è obbligatorio gli shipper che non aderiranno/supereranno il test di connettività non potranno usufruire del canale di comunicazione X12, pertanto potranno effettuare le operazioni manualmente accedendo al sistema di Logistica Gas.

of 23

Technical Specification Template · Web viewLa protezione è ottenuta attraverso misure Hardware e...

Documents

Transcript of Technical Specification Template · Web viewLa protezione è ottenuta attraverso misure Hardware e...