API v2 Multi Smart Card ( ) 4- VERİİMZA API ile bir web uygulaması nasıl haberleşir?

Ebat: px

Şu sayfadan göstermeyi başlat:

Download "API v2 Multi Smart Card ( ) 4- VERİİMZA API ile bir web uygulaması nasıl haberleşir?"

Gözde İnönü
5 yıl önce
İzleme sayısı:

API v2 Multi Smart Card (24.11.2018) İÇİNDEKİLER : 1- VERİİMZA API nedir? 2- Neden VERİİMZA API? 3- VERİİMZA API nasıl çalışır? 4- VERİİMZA API ile bir web uygulaması nasıl haberleşir?

1 API v2 Multi Smart Card ( ) İÇİNDEKİLER : 1- VERİİMZA API nedir? 2- Neden VERİİMZA API? 3- VERİİMZA API nasıl çalışır? 4- VERİİMZA API ile bir web uygulaması nasıl haberleşir? 5- VERİİMZA API ne için kullanılır? 6- VERİİMZA API ile ereçete nasıl imzalanır? 7- VERİİMZA API ile İSG Eğitimi nasıl imzalanır? 8- VERİİMZA API örnek javascript kodları a) Ereçete Kayıt ve Silmek için, b) İSG Eğitimi veri imzalamak için, c) VeriİmzaApi çalışıyor mu? PC ye kart takılı mı? kontrol için 9- VERİİMZA API ekran görüntüsü 10- İletişim 11- Ücretlendirme

2 1- VERİİMZA API nedir? VERİİMZA API, tüm web projelerinizi JAVA ile geliştirme yapmadan akıllı kartlar ile haberleştiren bir yardımcı uygulamadır. 2- Neden VERİİMZA API? Web uygulamaları direk olarak bir donanıma erişemez. Akıllı kartlar bir tür donanım olduğundan web uygulamanız bu haberleşmeyi ancak klasik bir yöntem olan JAVA ortamında geliştirme yaparak akıllı kartlar ile haberleşebilir. VERİİMZA API ile JAVA ortamında geliştirme yapmadan tüm web uygulamaları ile akıllı kartlar ile haberleşebilir. 3- VERİİMZA API ne için kullanılır? VERİİMZA API, ereçete veya İSG Eğitimlerini imzalamak için kullanılır. 4- VERİİMZA API nasıl çalışır? VERİİMZA API, akıllı kartlar ile haberleşmek için herhangi bir sürücü kurulumu ihtiyacı duymaz. TÜBİTAK ın belirlediği standartlardaki (PKCS#11) tüm USB Akıllı kartları otomatik olarak tanır ve imzalama işlemini gerçekleştirir. İmzalanan veri bir EReçete ise ; Bilgileri MEDULA ya gönderir. MEDULA dan gelen sonuçları web uygulamasında istenen herhangi bir javascript fonksiyonuna geri gönderir. İSG Eğitimi ise, imzalanan veriyi web uygulalamızda ki herhangi bir javascript fonksiyonuna geri gönderir. Birden fazla Eİmza cihazını destekler. VERİİMZA API çalışır durumda iken akıllı kartları sökülüp takılabilir. Takılan akıllı kartı otomatik olarak tanır ve kullanıma hazırlar. VERİİMZA API Windows uygulaması olarak çalışır. 5- VERİİMZA API ile bir web uygulaması nasıl haberleşir? Bir web uygulaması, basit javascript metotları ile (JQUERY kullanarak) imzalanacak içeriği VERİİMZA API ye iletir. VERİİMZA API web uygulaması tarafından gönderilen içeriği alır, akıllı kartı kullanarak imzalar.

3 6- VERİİMZA API ile ereçete nasıl imzalanır? Sırası ile adımlar: Ereçete formatına uygun xml oluşturulur (dr, hasta, ilaç, tanı bilgileri vs.). Oluşturulan xml verisi base64string 'e dönüştürülür. base64string 'e dönüştürülen ereçete verisi ile işlemi yapan doktor bilgileri (DR.TC kimlik no, akıllı kart pin kodu vs.) Javascript fonksiyonu ile VERİİMZA API'e iletilir. VERİİMZA API, javascript ile gönderilen bilgiler ile imzalanması istenen ereçete verisini imzalar ve MEDULA ya iletir. MEDULA dan gelen yanıtı base64string verisine dönüştürerek web uygulamasındaki ilgili javascript fonksiyonuna iletir. Javascript fonksiyonuna gelen veri base64decode ile çözülerek yanıta ait içeriğe erişilir. 7- VERİİMZA API ile İSG Eğitimleri nasıl imzalanır? Sırası ile adımlar: İmzalanacak veri base64string e dönüştürülür. base64string 'e dönüştürülen veri, akıllı kart sahibi olan kişiye ait bilgiler (TC kimlik no, akıllı kart pin kodu vs.) tanımlanarak Javascript fonksiyonu ile VERİİMZA API'e iletilir. VERİİMZA API, javascript ile gönderilen bilgiler ile imzalanması istenen İSG Eğitim verisini imzalar ve imzalanan veriyi base64string verisine dönüştürerek web uygulamasındaki ilgili javascript fonksiyonuna iletir. Javascript fonksiyonuna gelen veri base64decode ile çözülerek şifrelenmiş veri kullanılabilir hale getirilir.

4 8 - VERİİMZA API ile haberleşme örnek kodları Önemli: <meta name="referrer" content="always" /> satırının <Head>.</Head> içine eklenmesi zorunludur. a) Ereçete Kayıt ve Silmek için, /* Parametre açıklamaları: API LISANS_KODU REÇETE tanımı ile ilk parametre olarak gönderilmeli. API_ISLEM API nin yapacağı işlem (*) IMZALANACAK_XML DR_ADI Doktor adı (*) DR_SOYADI Doktor soyadı (*) API lisans kodu (girilmediğinde sadece medula test servisi ile işlem yapılacaktır) API nin imzalayıp, medulaya göndereceği xml verisi (base64 string olarak) (*) DR_KULLANICISIFRE Doktorun medula kullanıcı adı (*) DR_KULLANICIADI Doktorun medula kullanıcı şifresi (*) DR_TCKNO Doktor TC kimlik numarası (*) DR_SERTIFIKAKODU Doktor sertifika kodu (*) DR_BRANSKODU Doktor branş kodu (*) KURUM_TESISKODU Kurum tesis kodu (*) API_YANIT_DONUS_FONKSIYONU Meduladan gelen yanıtın iletileceği javascript fonksiyonu (*) API_HATA_DONUS_FONKSIYONU API tarafında oluşan hataların iletileceği javascript fonksiyonu (*) TEST_ORTAMI EIMZA_PINKODU İmza cihazınızın pin kodu (*) EIMZA_TCKNO İşlemleri MEDULA test sunucuları üzerinde gerçekleştirmek için (evet yada hayır tanımlanabilir) İmza cihazınızda tanımlı olan TC Kimlik no.(*) (*) : Zorunlu. Değer içermeli. Not : Parametreler her işlemde API 'ye gönderilmelidir. */

5 İmzalı Ereçete Kayıt işlemi için örnek javascript kodu: function erecetekayit() { $.ajax({ datatype: "jsonp", data: { API: 'REÇETE', IMZALANACAK_XML: '..., API_ISLEM: 'imzalierecetekayit', DR_KULLANICIADI:' ', DR_KULLANICISIFRE:' ', DR_ADI:'DrAdı', DR_SOYADI:'DrSoyadı', DR_TCKNO: ' ', DR_SERTIFIKAKODU:'0', DR_BRANSKODU:'9999', KURUM_TESISKODU:' ', EIMZA_PINKODU:'123456', EIMZA_TCKNO: ' ', TEST_ORTAMI:'evet', API_YANIT_DONUS_FONKSIYONU: 'imzalierecetekayitsonuc', API_HATA_DONUS_FONKSIYONU : 'gelenhata', LISANS_KODU :'XXXXX', url: " ); function erecetekayitsonuc(sonucxml){ function erecetekayithata(hata) {

6 İmzalı Ereçete Sil işlemi için örnek javascript kodu: function erecetesil() { $.ajax({ datatype: "jsonp", data: { API: 'REÇETE', IMZALANACAK_XML: '..., API_ISLEM: 'imzalierecetesil', DR_KULLANICIADI:' ', DR_KULLANICISIFRE:' ', DR_ADI:'DrAdı', DR_SOYADI:'DrSoyadı', DR_TCKNO: ' ', DR_SERTIFIKAKODU:'0', DR_BRANSKODU:'9999', KURUM_TESISKODU:' ', EIMZA_PINKODU:'123456', EIMZA_TCKNO: ' ', TEST_ORTAMI:'evet', API_YANIT_DONUS_FONKSIYONU: 'erecetesilsonuc', API_HATA_DONUS_FONKSIYONU : 'erecetesilhata', LISANS_KODU :'XXXXX', url: " ); function erecetesilsonuc(sonucxml) { alert(atob(sonucxml)); function erecetesilhata(hata) { alert(atob(hata));

7 b) İSG Eğitimi imzalamak için, /* Parametre açıklamaları: API LISANS_KODU IMZALANACAK_VERI API_YANIT_DONUS_FONKSIYONU EĞİTİM tanımı ile ilk parametre olarak gönderilmeli. API lisans kodunuz API nin imzalayıp, geri göndereceği veri (Hash gerekiyorsa veriyi hash leyip sonra base64 encode ederek göndermelisiniz.) (*) İmzalanan verinin web sitenize iletileceği javascript fonksiyonu (*) API_HATA_DONUS_FONKSIYONU API tarafında oluşan hataların iletileceği javascript fonksiyonu (*) EIMZA_PINKODU İmza cihazınızın pin kodu (*) EIMZA_TCKNO */ İmza cihazınızda tanımlı olan TC Kimlik no.(*) $.ajax({ datatype: "jsonp", data: { API: 'EĞİTİM', IMZALANACAK_VERI: ' ', EIMZA_PINKODU:'123456', EIMZA_TCKNO: ' ', API_YANIT_DONUS_FONKSIYONU: egitimimzalasonuc, API_HATA_DONUS_FONKSIYONU : egitimimzalahata, LISANS_KODU :'..',, url: " ); function egitimimzalasonuc (sonucveri) { alert(atob(sonucveri)); function egitimimzalahata (hata) { alert(atob(hata));

8 c) VeriİmzaApi çalışıyor mu? PC ye kart takılı mı? kontrol için $.ajax({ timeout: 1000, // = 1sn. Bu değeri değiştirebilirsiniz. datatype: "jsonp", data: { API_KONTROL: '', EIMZA_TCKNO: ' ', //Eİmza cihaz sahibinin TC Kimlik No. API_YANIT_DONUS_FONKSIYONU: 'apikontrolsonuc',, url: " error: function(xmlhttprequest, textstatus, message) { if(textstatus==="timeout") { alert("veriimzaapi çalışmıyor!!!"); ); function apikontrolsonuc(sonuc) { alert(sonuc); // true ise eimza cihazı takılı // false ise eimza cihazı yok

9 9 - VERİİMZA API ekran görüntüsü 10 Ücretlendirme Ücretlendirme domain başına yapılmaktadır. Tek bir uygulamanın farklı domainlerde çalıştırılması durumunda 2nci domain dahil her domain için %20 indirim uygulanır. 1 yıllık lisans.sorunuz Tam kaynak kodu.. Sorunuz (Visual Studio 2017, c#, Windows form uygulaması) 11 İletişim VERİİMZA API ile ilgili her türlü bilgi için, VERİİMZA API kullanım lisansı almak için, VERİİMZA APİ kaynak kodlarını satın almak için,

Benzer belgeler

PTTKEP HESABINA ELEKTRONİK İMZA İLE GİRİŞ

PTTKEP HESABINA ELEKTRONİK İMZA İLE GİRİŞ KEP hesabı olan kullanıcıların sisteme giriş yapabilmesi için giriş seçenekleri ve gerekli işlemler aşağıdaki gibidir. ELEKTRONİK İMZA KULLANIMI İÇİN için yapılması