Sıkça Sorulan Sorular (SSS) EBT III Yazılımı Web Service Hakkında v2.0 BOTAŞ Doğalgaz İşletmeleri Bölge Müdürlüğü tarafından Krizma Yazılım a ürettirilen EBT III Yazılım Projesine Web Service üzerinden Akış verilerini göndermek isteyen Dağıtım Şirketlerinden gelen ve değerlendirilen soruların yer aldığı destek kitapçığıdır. 03.10.2013
İçindekiler 1. KONU : SSL HTTPS... 2... 2... 2 2. KONU: ŞİFRELERİN DEĞİŞTİRİLEBİLMESİ... 2... 2... 2 3. KONU: SERTİFİKA İHTİYACI... 2... 2... 2 4. KONU: E-İMZA... 3... 3... 3 5. KONU: AUTHENTICATION... 3... 3... 3 6. KONU: TEST SÜREÇLERİ - ZAMANLAR... 4... 4... 4 7. KONU: ŞİFRE KOD DEĞİŞİKLİKLERİ... 4... 4... 4 8. KONU: WEB ADRESİ (SERVICE-REFERENCE)... 5... 5... 5 9. KONU: ZAMANLAR (PERIOD)... 5... 5... 6 10. KONU: ZAMANLAR (PERIOD) 2... 6... 6... 6 Versiyon Yayın Tarihi Sayfa No : 1
1. KONU : SSL HTTPS Web servisi şu an için http üzerinde çalışıyor, dolayısı ile aradaki iletişim son derece güvensiz. Bunun geçici bir durum olduğunu ve canlı sistemin SSL / https ile çalışacağını varsayabilir miyiz? Sistem Pilot Test çalışmaları sürecindeyken http üzerinden yayın yapmaktadır. Sistemin canlı uygulamaları https (SSL Certificated) ile çalışacaktır. 2. KONU: ŞİFRELERİN DEĞİŞTİRİLEBİLMESİ Canlı sisteme geçiş öncesinde (güvenlik nedeni ile) şifrelerimizi değiştirme şansımız olacak mı? Gerçek Sistemde Dağıtım Şirketlerine verilecek Kullanıcı adı ve Parola Yetkili İmzalarını ibraz eden şirket temsilcilerine Gizlilik ve Güvenlik ile ilgili gereken belgelerin/sözleşmelerin imzalanmasına müteakiben teslim edilecek olup, bu şifre ve kullanıcı adlarının değişimi sadece botaş tarafından yapılabilecektir. Bu sebeple BOTAŞ tarafından ihtiyaç duyulana kadar Kullanıcı adı ve Parola değişiklikleri (Web Service için) söz konusu olmayacaktır. 3. KONU: SERTİFİKA İHTİYACI İstemci tarafında da sertifika gerekecek mi? Gerekecek ise sertifikayı siz mi çıkarıp yollayacaksınız yoksa biz mi bir certificate request gönderip sonuç bekleyeceğiz? Her iki durumda da bir adrese ihtiyacımız olacak. Ya da alternatif olarak belirli bir trust authority üzerinden mi hizmet alınacak? (Turkturst vb?) Sistemin E-İmza altyapısı mevcut olmakla beraber devreye alınan unsurlarından olmaması sebebi ile şu an için İstemci tarafında Sertifika ihtiyacı yoktur.. Versiyon Yayın Tarihi Sayfa No : 2
4. KONU: E-İMZA Sistemin e-imza ile çalışacağını düşünüyoruz. Mesajlar nasıl ve hangi sertifika ile imzalanacak? Sistemin E-İmza altyapısı mevcut olmakla beraber devreye alınan unsurlarından olmaması sebebi ile şu an için İstemci tarafında Sertifika ihtiyacı yoktur.. 5. KONU: AUTHENTICATION Web servisini her hangi bir authentication olmadan çağırdığımızda aşağıdaki gibi bir response alıyoruz. Bunun authentication dan olduğunu varsayarsak, Authentication için dokümantasyonda X509 sertifikası kullanılacağı belirtilmiş, sunucu sertifikasını rica edebilir miyiz? (Public kısmını doğal olarak) Aşağıda kod örneği verilmiştir. //Servis endpoint address= "http://ebtws.botas.gov.tr/krizma.botas.ebt.akis.svc" EBTSERVICE.AKISSERVICEClient c= new EBTSERVICE.AKISSERVICEClient(); c.clientcredentials.username.username = "KURUMKODUNUZ"; c.clientcredentials.username.password = "KURUMPAROLANIZ"; c.clientcredentials.servicecertificate.authentication.certificatevalidationmode = System.ServiceModel.Security.X509CertificateValidationMode.None; EBTSERVICE.EBTANLIKAKISDVO akis = new EBTSERVICE.EBTANLIKAKISDVO(); akis.noktakodu = "VERİSİ GÖNDERİLECEK NOKTA KODU"; akis.kurumkodu = "KURUMKODUNUZ "; Versiyon Yayın Tarihi Sayfa No : 3
6. KONU: TEST SÜREÇLERİ - ZAMANLAR Göndereceğimiz veriler SADECE test sistemine geçip hiçbir şekilde gerçek veri olarak kabul edilmeyecek değil mi? Test Süreci Ön Test (Pilot Dağıtım Şirketleri ile yapılacaktır.) Gerekli Test (Gerçek Veriler ve değerler ile tüm Şirketler için yapılacaktır) Son Test (Tüm Şirketler ile gerçek değer ve verilerin kullanılması ve gerçek ortamda) Olmak üzere 3 aşamalı tasarlanmıştır. Bu adımlar için öngörülen zaman aralığı idarece alınacak feedbackler değerlendirilmek suretiyle değiştirilebilir olsa da Ön Test 04.10.2013 e kadar Gerekli Test 14.10.2013 e kadar Son Test 31.10.2013 e kadar öngörülmektedir. 7. KONU: ŞİFRE KOD DEĞİŞİKLİKLERİ Şu an elimizde olan (Esgaz a gönderilmiş) kurum kodu, parola, nokta kodu ve benzeri bilgiler güvensiz bir ortam üzerinden internete açılacağı için, tekrar teyit etmek zorunda hissediyorum. Canlı sisteme geçiş öncesinde bir şifre/kod değişikliği olacak mı? Test Sürecinin ilke evresinde şifre / parola ve nokta kodları verilen tester firmalara 2. Ve 3. Evrelerde gereken değiştirilmiş bildirimleri yapılmış olarak duyurulacaktır. Versiyon Yayın Tarihi Sayfa No : 4
8. KONU: WEB ADRESİ (SERVICE-REFERENCE) BOTAŞ EBT Web servislerini test etmek istiyoruz ancak sabah saat 09 civarından bu yana ne yazık ki servisler kullanım dışı gözüküyor. Sanıyorum ki uygulama ile ilgili bir sıkıntı var. Geçici olduğunu düşünerek bayağı bir bekledik ancak her halde fark edilmedi, ya da sorunun giderilmesi uzun sürüyor. http://ebtws.botas.gov.tr/krizma.botas.ebt.akis.svc ve http://ebtws.botas.gov.tr/krizma.botas.ebt.akis.svc?wsdl adresleri; hata veriyor (bu sonuncusu sabah çalışıyordu, sonrada hata vermeye başladı) Vermiş olduğumuz zaman aşımlarını geçirmemek için bir an önce testlerimizi başlatmak istiyoruz. Konu ile ilgilenip haber verebilir misiniz rica etsek? Teşekkürler. Bahse konu web service adresi tarayıcılardan aşağıdaki adresten görüntülenebilir. http://ebtws.botas.gov.tr/krizma.botas.ebt.akis.svc/mex?wsdl Ancak; uygulamanıza Web Reference olarak http://ebtws.botas.gov.tr/krizma.botas.ebt.akis.svc adresini eklemeniz gerekmektedir. 9. KONU: ZAMANLAR (PERIOD) EBT sisteminde istenen saatlik ve günlük veriler için zaman etiketi "Top of Period" mudur yoksa "Bottom of Period" mudur? Yani saat 13:00 ile 14:00 arası olan ölçümlerin/çekişlerin, zaman etiketi 13:00 müdür yoksa 14:00 müdür? Gönderilen yazılardan 14:00 anlaşılıyor ancak genelde çoğu sistem 13:00 kullanır. Aynı şekilde günlük zaman etiketleri nasıldır? (ki tutarlılık için aynı şekilde olması mantıklıdır) Ayrıca GMT zamanı veya GMT offseti bilgisi gönderilmediğinden, DST (Daylight Saving) değişikliği zamanın da zaman etiketleri çift kayıt veya 1 saat boşluk ile olacaktır. Bilginize. Versiyon Yayın Tarihi Sayfa No : 5
Anlık Akış ve Saatlik Akış verileri sistemin fatura vb hesaplamalarında kullanılmayacak olup, ilgili sistem oyuncularının karar vermelerinde yardımcı olmak adına sistem tarafından gösterilecek verilerdir. Bu sebeple Anlık ve saatlik ölçümlerin verileri gönderilirken; Ölçüm Zamanı olarak ZAMAN ETİKETİ ölçümün yapıldığı zaman olmalıdır. Örneğin 13:00 14:00 aralığındaki saatlik akış verisi için 14:00 veya 14:03 gibi ölçülen bir değer gönderilirken 14:00 veya 14:03 Zaman etiketi ile gönderilebilir. Yukarıdaki durum anlık akış içinde geçerlidir. GMT +02:00, ISTANBUL olmalıdır. DST (Daylight Saving) değişikliği zamanında zaman etiketleri çift kayıt veya 1 saat boşluk ile olacaktır. Bu konuda sistemin saatlik veri ile ilgili hesap yapmayacağı öngörüsü ile şu an için İlgili İdare tarafından bir farklı uygulama öngörülmemiştir. 10. KONU: ZAMANLAR (PERIOD) 2 Sorumun tam cevabını halen alamadım ancak "Top of Period" kullanacağız. Örnek olarak basınç için 13:00-14:00 saat, içinde 10 tane değer alıyorsunuz. Saat sonunda 10 tane değerden bir saatlik ortalama çıkıyor. Bu çıkan tek değerin zaman etiketi ya 13:00 olarak yara 14:00 olarak saatlik tabloya kayıt edilir. Biz size 13:00 etiketi ile gönderiyor olucağız. 13:00-14:00 arası veriler zaman etiketi 14:00 olarak saatlik tabloya kayıt edilir. Versiyon Yayın Tarihi Sayfa No : 6