🇹🇷 TÜBİTAK ESYA Entegrasyonu

TÜBİTAK ESYA zaman damgası sunucusu entegrasyonu.

Genel Bakış

TÜBİTAK ESYA, RFC 3161 protokolüne ek olarak özel kimlik doğrulama mekanizması kullanır.

🔐 Kimlik Doğrulama

Adımlar

RFC 3161 TimeStampReq oluşturulur
Hash değeri çıkarılır
Authentication token oluşturulur:
- PBKDF2WithHmacSHA256 ile anahtar türetme
- AES-256-CBC şifreleme
- ASN.1 DER encoding
- Hexadecimal formata dönüşüm
HTTP Header eklenir (identity)

⚙️ Yapılandırma

# TÜBİTAK zaman damgası sunucusu
TS_SERVER_HOST=http://zd.kamusm.gov.tr/
 
# TÜBİTAK müşteri bilgileri
TS_USER_ID=123456
TS_USER_PASSWORD=your_password
 
# TÜBİTAK modunu aktif et
IS_TUBITAK_TSP=true

📊 Kontör Sorgulama

curl http://localhost:8085/api/tubitak/credit

Response:

{
  "remainingCredit": 5432,
  "customerId": 123456,
  "message": "5432"
}

🔧 Implementasyon Bileşenleri

TubitakAuthenticationHelper

Kriptografik işlemler ve authentication token oluşturma.

TubitakTimestampDataLoader

DSS TimestampDataLoader’ı extend eder, identity header’ı ekler.

TimestampConfigurationService

Yapılandırmaya göre doğru DataLoader’ı seçer.

🐛 Sorun Giderme

”Identity header invalid”

Müşteri ID ve password doğruluğunu kontrol edin
TS_USER_ID sayısal olmalı

HTTP 401/403

Kullanıcı kimlik bilgilerini kontrol edin
TÜBİTAK hesabı aktif mi kontrol edin

📚 Referanslar

Zaman Damgası DSS Override