e-İmza PIN doğrulamasında PKCS#11 C_Login dönüş kodu CKR_PIN_LOCKED olmadan önce kalan deneme sayısını programatik olarak okuma
2 Cevap Nasıl Uygulanır?
PKCS#11 spesifikasyonunda (v2.20 ve v2.40) PIN hatalarında standart olarak CKR_PIN_INCORRECT dönüş kodu üretilir; ancak doğrudan kalan deneme sayısını (retry counter) döndüren standart bir PKCS#11 fonksiyonu bulunmamaktadır.
C_GetTokenInfo fonksiyonu ile alınan CK_TOKEN_INFO yapısında yalnızca CKF_USER_PIN_FINAL_TRY (son deneme hakkı) ve CKF_USER_PIN_LOCKED (kart bloke) bayrakları kontrol edilebilir. Kalan deneme sayısını net bir tamsayı olarak (örneğin 3, 2, 1) öğrenmek istiyorsanız, PKCS#11 katmanının arkasına geçip akıllı karta doğrudan PC/SC API'si üzerinden standart bir ISO 7816-4 APDU komutu göndermeniz gerekir.
Uygulanması Gereken Teknik Çözüm Adımları:
- 1. ISO 7816-4 Boş VERIFY Komutu (Empty PIN Verify): Akıllı karta şifre göndermeden, sadece sayaç durumunu sorgulamak için gövdesi boş (Lc=00) bir
VERIFYAPDU komutu gönderilir:CLA = 0x00, INS = 0x20, P1 = 0x00, P2 = 0x01 (veya 0x81), Lc = 0x00
(Burada P2 parametresi, kart üreticisine ve kart profilindeki PIN referansına göre0x01veya0x81olabilir). - 2. Durum Kelimesi (Status Word) Yanıtının Ayrıştırılması: Kart bu boş komuta PIN'i doğrulamadan durum koduyla cevap verir:
- SW = 0x63, 0xCX: Komut başarıyla sayacı raporlamıştır. Buradaki
Xdeğeri doğrudan kalan deneme hakkıdır! Örneğin0x63, 0xC3dönerse 3 hak,0x63, 0xC2dönerse 2 hak,0x63, 0xC1dönerse son 1 hak kalmıştır. - SW = 0x69, 0x83: Kimlik doğrulama yöntemi engellenmiştir (Authentication method blocked), yani kartın PIN hakkı tamamen tükenmiş ve kart bloke durumdadır.
- SW = 0x90, 0x00: PIN zaten mevcut oturumda başarıyla doğrulanmış durumdadır.
- SW = 0x63, 0xCX: Komut başarıyla sayacı raporlamıştır. Buradaki
- 3. PC/SC ve PKCS#11 Oturum Senkronizasyonu: C# (PCSC-Sharp), C++ (winscard) veya Java (
javax.smartcardio) ile bu APDU sorgusunu yaparken kart bağlantısınıSCARD_SHARE_SHAREDmodunda açmalısınız. KartıSCARD_RESET_CARDyapmadan sorgulamalı, yanıtı aldıktan sonra oturumu kapatıp ardından gerekirse PKCS#11C_Loginçağrısına geçmelisiniz. - 4. PKCS#11 Bayrak Kontrolü (Alternatif Yaklaşım): APDU seviyesine inmek istemiyorsanız, her
CKR_PIN_INCORRECThatasından sonraC_GetTokenInfoçağrısı yaparaktokenInfo.flags & CKF_USER_PIN_FINAL_TRYkoşulunu denetleyebilirsiniz. Eğer bu bayrak set edilmişse, arayüzde kırmızı bir uyarı çıkararak "Dikkat! Son 1 hatalı giriş hakkınız kaldı, aksi halde kartınız bloke olacaktır" uyarısı verebilirsiniz.
Bu çift katmanlı mimari, kullanıcıların akıllı kartlarını gereksiz yere kilitlemelerini önleyecek ve kurumunuzun teknik destek operasyon maliyetlerini ciddi oranda düşürecektir.
Eğer uygulamanız sadece belirli bir ESHS'nin (örneğin TÜBİTAK Kamu SM Akis kartları) kartlarıyla çalışıyorsa, doğrudan Akis'in kendi yönetim DLL'lerinde bulunan özel wrapper API'lerini (örneğin akis_get_pin_counter() benzeri vendor fonksiyonlarını) çağırabilirsiniz. Ayrıca istemci uygulamanızın arayüzünde lokal bir oturum sayacı tutarak, ardışık 2 yanlış girişte kullanıcıya şifre sıfırlama veya PUK ile bloke kaldırma kılavuzunu açan modal pencereler göstermek son derece pratik bir kullanıcı deneyimi sağlar.