Instrukcja obsługi TelCOMM
Instrukcja obsługi GS2TelCOMM 

Oprogramowanie TelCOMM to narządzie umożliwiające wymianę dokumentów typu B2B za pomocą protokołu AS4, którego wdrożenie na rynku kontrahentów gazu wynika z Rozporządzenia Komisji Europejskiej (UE) 2015/703 z dnia 30 kwietnia 2015 ustanawiającego kodeks sieci czyli zasady interoperacyjności i wymiany danych.
Wprowadzenie
Protokół AS4 (Applicability Statement 4) to standard opisujący bezpieczne i niezawodne przesyłanie komunikatów przez publiczną sieć Internet. Protokół ten bazuje na powszechnie znanych i sprawdzonych rozwiązaniach, takich jak protokoły HTTP, TLS, SOAP oraz usługach sieciowych (web service). Reprezentuje otwarty standard wymiany danych typu B2B opisany w specyfikacji OASIS ebMS 3.0. Elementami odpowiedzialnymi za bezpieczeństwo i wiarygodność przesyłanych danych są podpisy cyfrowe oraz mechanizmy szyfrujące (WS-security).
Architektura
Oprogramowanie TelCOMM jest rozwiązaniem adresowanym dla środowiska MS Windows Server, bazującym na podsystemie IIS oraz .NET Framework w wersji co najmniej 4.8. Aplikacja może być udostępniana jedynie w oparciu o protokół HTTPS, a wersja używanego protokołu TLS podczas wysyłania komunikatów to 1.2 lub 1.3. TelCOMM posiada wbudowaną bazę danych SQLite lub ma możliwość korzystania z bazy danych Oracle. Program składa się z trzech komponentów:
- interfejsu webowego dostępnego przez przeglądarkę internetową, umożliwiającego konfigurację i interaktywną wymianę dokumentów,
- usługi sieciowej /WebServices/Gateway.asmx, umożliwiającej wymianę dokumentów z poziomu programu zewnętrznego,
- usługi sieciowej /MSH.asmx/Receive, umożliwiającej odbiór dokumentów od partnerów.
Interfejs webowy
Główny ekran aplikacji umożliwia wysyłanie dokumentów z użyciem protokołu AS4 i wzorca komunikacji One-Way/Push za pomocą zdefiniowanego P-Mode (Processing Mode).

Rysunek 1. Ekran „Wyślij” – po analizie odpowiedzi
Drugi widok programu służy do pobierania danych od partnera za pomocą wzorców AS4 Two-Way/Push-Pull, Two-Way/Sync lub One-Way/Pull.

Rysunek 2. Ekran „Pobierz” – po analizie odpowiedzi
Interfejs webowy posiada ekrany wiadomości odebranych i wysłanych, umożliwiające przeglądanie i zarządzanie każdą odebraną i wysłaną wiadomością.
Z poziomu administratora dostępne są ponadto ekrany:
- Logi – błędy komunikacji AS4 oraz informacje na temat działań użytkowników,
- Partnerzy – określenie przyjaznej nazwy dla partnera,
- Processing Modes (P-Modes) – konfiguracja komunikacji AS4 między partnerami,
- Użytkownicy,
- Baza danych – wybór SQLite lub Oracle,
- Opcje.
Interfejs użytkownika dostępny jest w języku polskim i angielskim.
Interfejs do współpracy z programem zewnętrznym
Program TelCOMM może spełniać zadanie bramki do komunikacji B2B, przez którą inny program może automatycznie wysyłać i odbierać wiadomości za pomocą protokołu AS4, ponieważ udostępnia dedykowane metody w usłudze sieciowej /WebServices/Gateway.asmx.
Przykładowe metody z Gateway.asmx:
- SendByPModeName,
- GetUnreadPushMessagesIds,
- GetMessages,
- MarkAsRead.
Usługa umożliwiająca odbiór dokumentów od partnera
Integralną częścią aplikacji TelCOMM jest usługa do odbierania komunikatów AS4. Służy do tego metoda Receive w usłudze sieciowej (web service) MSH.asmx. Adres względny odbierania to:
/MSH.asmx/Receive.
Konfiguracja komunikacji
Konfiguracja komunikacji AS4 między partnerami polega na zdefiniowaniu P-Mode (Processing Mode).

Rysunek 3. Ekran szczegółów [P-Mode]
Automatyczna aktualizacja certyfikatów
Automatyczna aktualizacja certyfikatów jest wymaganym składnikiem oprogramowania AS4 działającego na europejskim rynku gazowym. Ma ona na celu zautomatyzowanie procesu zmiany używanych przez partnerów certyfikatów na nowsze, przeważnie w sytuacji, gdy certyfikat jest bliski utraty ważności.
Specyfikacja
- Profile AS4: ENTSOG 3.6, ENTSOG 4.0, BDEW
- Wzorce komunikacji (MEP):
- Algorytmy:
- Funkcje skrótu dla podpisu (hash): sha256, sha384, sha512
- Podpis cyfrowy:
- certyfikat RSA: rsa-sha256, rsa-sha384, rsa-sha512
- certyfikat ECC: ecdsa-sha256, ecdsa-sha384, ecdsa-sha512
- certyfikat Ed25519: eddsa-ed25519
- Szyfrowanie danych:
- aes128-cbc, aes192-cbc, aes256-cbc
- aes128-gcm, aes192-gcm, aes256-gcm
- Szyfrowanie klucza:
- [transport klucza] certyfikat RSA: rsa-oaep-mgf1p, rsa-oaep
- MGF: mgf1sha1, mgf1sha256, mgf1sha384, mgf1sha512
- Funkcje skrótu (hash): sha1, sha256, sha384, sha512
- [uzgadnianie klucza] certyfikat ECC: ECDH-ES, certyfikat X25519: x25519
- KDF: ConcatKDF, hkdf
- KW: kw-aes128, kw-aes192, kw-aes256
- HMAC: sha1, sha256, sha384, sha512
- [transport klucza] certyfikat RSA: rsa-oaep-mgf1p, rsa-oaep
- Kompresja: gzip
- [ReplyPattern]: Response (synchroniczność), Callback (asynchroniczność, dla AS4)
- [SecurityTokenReference]: BinarySecurityToken X509v3, BinarySecurityToken X509PKIPathv1, IssuerAndSerialNumber, SubjectKeyIdentifier
- [ebCore Agreement Update]: tak, dla certyfikatów
- Wiele załączników w komunikacie: tak
- Jeden [P-Mode] dla obu kierunków (gdy obaj partnerzy używają tego samego certyfikatu do podpisu i szyfrowania): tak
- Walidacja certyfikatów: OCSP/CRL (opcjonalnie)
- Certyfikat TLS serwera i klienta: tak (opcjonalnie)
- Architektura: Microsoft Windows Server, IIS, .NET Framework 4.8, HTTPS, TLS 1.2 i 1.3
- Baza danych: SQLite, Oracle
- Interakcja z programem: przeglądarka internetowa dla użytkowników, usługa internetowa (web service) dla programów zewnętrznych
- Integracja z Microsoft Defender: tak (opcjonalnie)
- Język interfejsu użytkownika: polski, angielski
Rozszerzenie GS2TelCOMM
GS2TelCOMM jest opcjonalnym rozszerzeniem dla programu TelCOMM wspomagającym proces pobierania danych pomiarowych i zagregowanych, udostępnianych przez Gaz-System za pomocą protokołu AS4 przy użyciu wzorca komunikacji Two-Way/Push-Pull lub alternatywnie Two-Way/Sync.
Architektura GS2TelCOMM jest taka sama jak dla oprogramowania TelCOMM, również posiada wbudowaną bazę danych SQLite lub może korzystać z Oracle. Rozszerzenie wspomaga w obszarach generowania zapytań o dane i analizowania odpowiedzi od partnera Gaz-System oraz w automatycznym, cyklicznym pobieraniu danych poprzez definiowanie harmonogramów pobierania. Uzyskane dane możliwe są do podglądu na jednym z ekranów lub do pobrania przez usługę sieciową. W przypadku wgrania rozszerzenia, na pasku nawigacyjnym oprogramowania TelCOMM pojawi się pozycja „Gaz-System”.
Materiały źródłowe
- [ENTSOG] AS4 Profile version 3.6
- [ENTSOG] AS4 Profile version 4.0
- [BDEW] AS4 Profil
- [BDEW] Regelungen zum Übertragungsweg für AS4
- [OASIS] AS4 Profile of ebMS 3.0 Version 1.0
- [OASIS] ebCore Agreement Update Specification Version 1.0
- [GAZ-SYSTEM] Instrukcja w zakresie wymiany danych protokołem AS4
- [GAZ-SYSTEM] Techniczny opis rozwiązania dla wymiany komunikatów Edig@s z wykorzystaniem standardu AS4
- [GAZ-SYSTEM] Techniczny opis rozwiązania dla udostępniania danych pomiarowych i zagregowanych z wykorzystaniem standardu AS4