QuickSign

Hızlı başlangıç

Bu kılavuz QuickSign'ı kurup çalıştırmayı, ilk zaman damgasını almayı ve ilk e-imzayı atmayı adım adım anlatır. Ayrıntılı kurulum (servis, sürücüler, systemd) için Kurulum kılavuzuna bakın.

QuickSign nedir?

QuickSign tek bir çalıştırılabilir dosyadır ve iki şekilde çalışır:

  • Argümansız çalıştırılırsa bir REST API (web sunucusu) açar. Uygulamalarınız bu API'ye belge gönderip imza ve zaman damgası alır.
  • İlk argüman bir komutsa (timestamp, sign, help) komut satırı aracı olarak tek bir işi yapar ve çıkar.

E-imza için USB e-imza token'ınız ve sürücüsü gerekir. Yalnız zaman damgası almak için token gerekmez.

1. Paketi açın

İşletim sisteminize uygun paketi ([email protected] adresinden isteyebilirsiniz) bir klasöre açın.

Windows (PowerShell):

powershell
Expand-Archive QuickSign-<sürüm>-win-x64.zip -DestinationPath C:\QuickSign
cd C:\QuickSign

Linux:

bash
sudo mkdir -p /opt/quicksign
sudo unzip QuickSign-<sürüm>-linux-x64.zip -d /opt/quicksign
sudo chmod +x /opt/quicksign/QuickSign /opt/quicksign/scripts/*
cd /opt/quicksign

Paketin içinde şunlar bulunur:

Dosya / klasörAçıklama
QuickSign / QuickSign.exeUygulamanın kendisi (.NET kurulumu gerektirmez)
appsettings.jsonYapılandırma (Yapılandırma)
brand.jsonUygulama adı ve iletişim bilgileri
KULLANIM.mdPakete özel kısa kullanım kılavuzu
scripts/Servis kurulumu, CLI kurulumu, test ve tanılama araçları
logs/Günlük log dosyaları

2. İlk zaman damgası (token gerekmez)

Herhangi bir dosyayı RFC 3161 zaman damgasıyla damgalayın:

bash
./QuickSign timestamp -f rapor.pdf

Windows'ta .\QuickSign.exe timestamp -f rapor.pdf yazın. Komut rapor.pdf.tst dosyasını üretir; bu dosya rapor.pdf'in o anda var olduğunun ve sonradan değişmediğinin kanıtıdır.

3. API'yi başlatın

bash
./QuickSign

API varsayılan olarak http://localhost:5000 adresinde açılır. Tarayıcıda bu adrese gittiğinizde uygulama adı, sürüm ve sayaçları içeren durum bilgisini görürsünüz. Tüm uçların şeması http://localhost:5000/openapi/v1.json adresindedir.

4. Token'ı kontrol edin

E-imza token'ınızı takın ve QuickSign'ın onu gördüğünü doğrulayın:

bash
curl http://localhost:5000/api/sign/check

Yanıtta bulunan PKCS#11 kütüphaneleri, takılı token'lar ve üzerlerindeki sertifikalar listelenir. Token görünmüyorsa Sorun giderme kılavuzuna bakın.

5. İlk e-imza

Bir dosyayı token ile imzalayın (TCKN, sertifikanın sahibinin kimlik numarasıdır):

bash
curl -F "[email protected]" -F "tckn=12345678901" -F "pin=1234" \
  http://localhost:5000/api/sign/file

Yanıttaki Signature alanı Base64 kodlu CMS (PKCS#7) imzadır. Aynı işi komut satırından yapmak için:

bash
./QuickSign sign -f belge.pdf --tckn 12345678901 --pin 1234

Bu komut belge.pdf.p7s imza dosyasını üretir.

Sonraki adımlar

Sorunuzun cevabını bulamadınız mı? [email protected]