DONANIM & SÜRÜCÜ LABORATUVARI: AKİS • SAFENET • GEMALTO • PALADIN
E-İmza Rehberi SMARTCARD // TOKEN LAB

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

Geliştirdiğimiz kurumsal masaüstü ve web e-imza istemcisinde kullanıcılar şifrelerini (PIN) üst üste yanlış girerek akıllı kartlarını bloke etmekte ve PUK kodu arayışına girmektedir. Kullanıcı hatalı PIN girdiğinde sistem sadece genel 'CKR_PIN_INCORRECT' hatası dönüyor; fakat kullanıcıya 'Son 1 hakkınız kaldı' gibi proaktif bir uyarı veremiyoruz. PKCS#11 API veya doğrudan PC/SC APDU komutları üzerinden akıllı kart bloke olmadan önce kalan PIN deneme hakkı sayısını programatik olarak nasıl sorgulayabiliriz?
Durum: Çözüldü Kategori: Soru-Cevap

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 VERIFY APDU 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öre 0x01 veya 0x81 olabilir).
  • 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 X değeri doğrudan kalan deneme hakkıdır! Örneğin 0x63, 0xC3 dönerse 3 hak, 0x63, 0xC2 dönerse 2 hak, 0x63, 0xC1 dö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.
  • 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_SHARED modunda açmalısınız. Kartı SCARD_RESET_CARD yapmadan sorgulamalı, yanıtı aldıktan sonra oturumu kapatıp ardından gerekirse PKCS#11 C_Login çağrısına geçmelisiniz.
  • 4. PKCS#11 Bayrak Kontrolü (Alternatif Yaklaşım): APDU seviyesine inmek istemiyorsanız, her CKR_PIN_INCORRECT hatasından sonra C_GetTokenInfo çağrısı yaparak tokenInfo.flags & CKF_USER_PIN_FINAL_TRY koş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.

Kabul Edilen Yanıt 15 faydalı
Gömülü Sistem Uzmanı Caner V.
Yakın zamanda

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.

Topluluk Katkısı 15 faydalı
Yazılım Geliştirici Sinan E.
Yakın zamanda