Verify API - Genel Bakış

Türkiye e-imza standartlarına uygun dijital imza doğrulama servisi.

Özellikler

İmza Doğrulama

• PAdES (PDF) İmza Doğrulama

  • PDF belgelerindeki dijital imzaları doğrulama
  • CAdES tabanlı gömülü imza desteği
  • Çoklu imza desteği

• XAdES (XML) İmza Doğrulama

  • XML belgelerindeki dijital imzaları doğrulama
  • Enveloped, Enveloping ve Detached imza desteği
  • e-Fatura, e-Arşiv gibi Türkiye standartlarına uyumluluk

• Zaman Damgası Doğrulama

  • RFC 3161 uyumlu zaman damgası token doğrulama
  • Message imprint doğrulaması
  • TSA sertifikası doğrulaması

Doğrulama Özellikleri

• İki Seviyeli Doğrulama

  • SIMPLE: Hızlı, temel imza doğrulaması - temel bilgileri döndürür
  • COMPREHENSIVE: Detaylı doğrulama - sertifika, validation ve qualification detaylarını içerir

• Sertifika Zinciri Doğrulama

  • Güvenilir root sertifikalara kadar tam zincir doğrulaması
  • KamuSM, e-Tugra gibi Türk CA’ları için özel destek

• Güvenilir Kök Sertifika Resolver

  • Classpath Resolver: JAR içindeki sertifikalar
  • Folder Resolver: Dosya sisteminden sertifikalar
  • Combined Resolver: Her iki kaynağın kombinasyonu

Altyapı Özellikleri

• DSS Framework Entegrasyonu - ETSI standardlarına tam uyumluluk
• Docker Desteği - Kolay deployment ve ölçeklenebilirlik
• Prometheus Metrics - Monitoring ve performans metrikleri
• OpenAPI Dokümantasyonu - Scalar UI ile interaktif API dokümantasyonu
• Health Check Endpoint’leri - Servis sağlık kontrolü
• Detaylı Loglama - İşlem takibi ve hata ayıklama

Hızlı Başlangıç

Docker ile Çalıştırma

cd devops/docker
cp .env.example .env
docker-compose up -d

Servis http://localhost:8086 adresinde çalışmaya başlayacaktır.

Health Check

curl http://localhost:8086/api/v1/health

API Endpoints

Doğrulama Endpoint’leri

• POST /api/v1/verify/pades/simple - PAdES imza doğrulama
• POST /api/v1/verify/xades/simple - XAdES imza doğrulama
• POST /api/v1/verify/timestamp - Zaman damgası doğrulama

Yönetim Endpoint’leri

• GET /api/v1/health - Servis sağlık kontrolü
• GET /actuator/health - Spring Boot Actuator health
• GET /actuator/prometheus - Prometheus metrikleri

Konfigürasyon

Detaylı konfigürasyon bilgileri için Güvenilir Kök Sertifika Resolver sayfasına bakın.