Kontrol Paneli

Genel entegrasyon durumları ve hızlı istatistikler

E-İmza USB Dongle & Kart Bağlantısı

E-İmza Modu

Aktif İmza Sertifikası Seçin

Bağlı Sertifika Bilgileri:

Entegrasyon ve Bağlantı Yapılandırması

Hafıza İçi Simülasyon Modu (In-Memory Mock Database)

MSSQL veritabanı bağlantısı kurmadan, uygulama belleğinde oluşturulan test verileriyle e-reçete ve e-imza gönderme süreçlerini anında test etmenizi sağlar.

Medula Web Servis Simülasyon Modu (Mock Medula Services)

Aktif olduğunda e-reçete ve rapor isteklerini gerçek Medula test sunucusuna (sgkt.sgk.gov.tr) göndermek yerine yerel simülatör üzerinden başarılı takip numaraları üreterek yanıtlar.

MSSQL Sunucu Adresi

MSSQL Port

Veritabanı Adı (Database)

Kullanıcı Adı (User)

Kullanıcı Şifresi (Password)

Medula GSS Tesis Kodu

Medula Web Servis Kullanıcı Adı

Medula Web Servis Şifresi

E-İmza Sertifika Dosya Adı (PFX)

E-İmza Sertifika Şifresi

0

Bekleyen E-Reçete

0

Bekleyen Raporlar

0

Başarıyla Gönderilen

0

Hatalı Gönderimler

Entegrasyon İşlem Geçmişi

İşlem Tipi	ID / No	Doktor Adı Soyadı	Gönderim Tarihi	Durum	Takip No / Hata Mesajı

Gönderilmeyi Bekleyen E-Reçeteler

ID	Hasta Adı Soyadı	Protokol No	Reçete Tarihi	Doktor Adı Soyadı	İlaç Sayısı	Durum	İşlemler

Gönderilmeyi Bekleyen İlaç Raporları

ID	Rapor No	Hasta Adı Soyadı	Doktor Adı Soyadı	Rapor Dönemi	Etken Madde	Durum	İşlemler

Gönderilmeyi Bekleyen Tıbbi Malzeme Raporları

ID	Rapor No	Hasta Adı Soyadı	Malzeme SUT Kodu	Miktar	Durum	İşlemler

Başhekim Yetkilendirme Bilgileri

Başhekim T.C. Kimlik Numarası:

Başhekim e-imzası ile onay gönderimleri için gereklidir (Test ortamında varsayılan hekim kullanılabilir).

Başhekim Onayı Bekleyen İlaç & Malzeme Raporları

Tip	Rapor ID / No	Hasta Adı Soyadı	Medula Takip No	Gönderim Durumu	İşlem

Sağlık Kurulu (3 Hekim) Onayı Bekleyen İlaç & Malzeme Raporları

Tip	Rapor ID / No	Hasta Adı Soyadı	Gönderen Hekim	Kurul Görevi	İşlemler

İmzalanan Orijinal XML

Gönderilen bir reçete veya raporun ham XML verisi burada görüntülenecektir...

XAdES-BES Enveloping İmzalı Paket

Orijinal XML'in XAdES-BES standardında RSA-SHA256 ile imzalanmış ve base64 kodlanmış hali burada görüntülenecektir...

Son Medula SOAP İstek ve Cevap Zarfı (SOAP Envelope)

Medula web servisine atılan SOAP zarfı ve gelen SOAP yanıt zarfı burada görüntülenecektir...

Web Tabanlı Uygulamalarda E-İmza Entegrasyonu Nasıl Yapılır?

1. Web Tarayıcı Sınırlandırmaları

Web tarayıcıları (Chrome, Edge, Firefox vb.) güvenlik nedeniyle istemci bilgisayarına takılı olan **Akıllı Kart Okuyucularına (PKCS#11)** doğrudan erişemez. Bu nedenle, web tabanlı HBYS uygulamalarında e-imza atmak için yerel bir yardımcı yazılıma ihtiyaç duyulur.

2. Localhost WebSocket / HTTP API İstemcisi Yaklaşımı

Günümüzdeki en yaygın ve başarılı e-imza entegrasyon yöntemi, kullanıcının bilgisayarında arka planda çalışan ufak bir **e-imza istemci servisidir** (C# .NET veya Java ile yazılmış localhost servisi).

Tipik İmzalama Akışı:

Web sayfası (Javascript), tarayıcı üzerinden http://localhost:9999/imzala veya ws://localhost:9999 adresindeki yerel servise bir imzalama isteği atar.
İstek içeriğinde imzalanacak orijinal verinin özeti (Digest) veya XML verisi yer alır.
Yerel servis, akıllı kartı (PKCS#11) okur, kullanıcıdan PIN (Şifre) ekranı vasıtasıyla e-imza şifresini alır.
Karttaki Nitelikli Elektronik Sertifika ile veriyi imzalar ve elde ettiği imzayı tarayıcıya (JS) geri döner.
Tarayıcı, imzalı veriyi sunucumuza iletir ve sunucu bunu Medula SOAP web servisine gönderir.

3. XAdES-BES Enveloping İmza Yapısı

Medula'nın e-reçete ve e-raporlarda zorunlu tuttuğu imza türü XAdES_BES Enveloping imzadır. Bu imza türünde orijinal XML verisi base64 formatında imzalı XML belgesinin içerisindeki <ds:Object> alanında saklanır. Bu yapıyı uygulamamızın medula_signature.py modülünde test sertifikaları için başarıyla kodladık.

E-İmza Ajan Bağlantı Durumu ve Testi

Tarayıcınızın yerel bilgisayardaki imzalama ajanlarına erişebilmesi için ajanın arka planda çalışıyor olması gerekmektedir. Aşağıdaki alandan bağlantıyı sorgulayabilirsiniz.

Durum Bilinmiyor

Lütfen "Bağlantıyı Test Et" butonuna tıklayarak testi başlatın.

E-İmza Yardımcı Programları (Ajanlar)

E-İmza atabilmek için bilgisayarınızın işletim sistemine uygun olan yerel ajan uygulamasını indirip arka planda çalıştırmanız gerekmektedir:

Java E-İmza Ajanı (Platform Bağımsız)

Mac, Windows ve Linux sistemlerle uyumlu. Çalışmak için bilgisayarda Java (JRE) yüklü olmasını gerektirir.

Ajanı İndir (.ZIP) .JAR Dosyası

Windows C# E-İmza Ajanı (Kurulumsuz)

Sadece Windows uyumlu. Java kurulumu gerektirmez. Windows Sertifika Deposu PIN ekranını otomatik kullanır.

Ajanı İndir (.ZIP)

Ajanları Nasıl Çalıştırırım?

Java Ajanı Kurulum Adımları:

Yukarıdaki Java E-İmza Ajanı ZIP dosyasını indirin ve bir klasöre çıkarın.
Klasörün içindeki istek_imza.jar dosyasını çalıştırın.
Ajan ilk çalıştığında yerel HTTPS SSL sertifikasını oluşturacak ve 8081 portunda dinlemeye başlayacaktır.

Windows C# Ajanı Kurulum Adımları:

Yukarıdaki Windows C# E-İmza Ajanı ZIP dosyasını indirin.
İçerisindeki compile.bat dosyasını çalıştırarak ajanı derleyin (veya derlenmiş MedulaEimzaAgent.exe dosyasını doğrudan çalıştırın).
Ajan HTTP protokolü üzerinden 8081 portunda dinleyerek Windows Sertifika Deposu üzerinden e-imza kartınızı otomatik algılayacaktır.

Medula Köprüsü