Kurulum

QuickSign bağımsız (self-contained) tek dosya olarak dağıtılır: .NET veya başka bir çalışma ortamı kurmanız gerekmez. Kurulum; paketi açmak, e-imza sürücüsünü kurmak ve isterseniz uygulamayı servis olarak çalıştırmaktan ibarettir.

#Sistem gereksinimleri

#E-imza sürücüsü (PKCS#11)

QuickSign token'a PKCS#11 kütüphanesi üzerinden erişir. Kütüphane yolu appsettings.json içindeki Sign:Pkcs11LibraryPath ile verilir; boş bırakılırsa bilinen konumlar taranıp token takılı olan kütüphane otomatik seçilir.

Windows'ta akıllı kart servisi yerleşiktir. Linux'ta USB okuyucular için pcscd çalışıyor olmalıdır:

sudo apt-get install -y pcscd
sudo systemctl enable --now pcscd

Kurulumdan sonra GET /api/sign/check ucu veya paketteki scripts/test-sign aracı bulunan kütüphaneleri ve token'ları listeler.

#Windows

#Paketi açın

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

Uygulamayı denemek için C:\QuickSign\QuickSign.exe dosyasını çalıştırın; API http://localhost:5000 adresinde açılır.

#Windows servisi olarak kurun

Yönetici olarak açılmış bir PowerShell penceresinde:

cd C:\QuickSign
powershell -ExecutionPolicy Bypass -File .\scripts\install-service.ps1

Betik uygulamayı brand.json'daki adla bir Windows servisi olarak kaydeder. Servis bilgisayar açılınca otomatik başlar; hata verirse veya yanıt vermez hale gelirse Windows tarafından yeniden başlatılır. Uygulamanın içindeki gözetleyici (watchdog) kendi sağlık adresini düzenli yoklar ve yanıt alamazsa süreci sonlandırarak yeniden başlatmayı tetikler.

Servisi kaldırmak için:

powershell -ExecutionPolicy Bypass -File .\scripts\uninstall-service.ps1

#Linux

#Paketi açın

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/*

#Komutu PATH'e ekleyin

quicksign komutunu her dizinden kullanmak için:

sudo bash /opt/quicksign/scripts/install-cli.sh

Betik /usr/local/bin/quicksign bağlantısını oluşturur. Kopya değil bağlantı kullanıldığı için paket güncellendiğinde komut da güncellenir.

sudo bash scripts/install-cli.sh --name imza       # komut adını değiştir
sudo bash scripts/install-cli.sh --prefix /usr/bin # kurulum dizinini değiştir
sudo bash scripts/install-cli.sh --uninstall       # kaldır

#systemd servisi

REST API'yi sürekli çalıştırmak için /etc/systemd/system/quicksign.service dosyasını oluşturun:

[Unit]
Description=QuickSign e-imza ve zaman damgası servisi
After=network-online.target pcscd.service
Wants=network-online.target

[Service]
WorkingDirectory=/opt/quicksign
ExecStart=/opt/quicksign/QuickSign
Restart=always
RestartSec=5
Environment=Urls=http://127.0.0.1:5000

[Install]
WantedBy=multi-user.target

sudo systemctl daemon-reload
sudo systemctl enable --now quicksign
sudo systemctl status quicksign

#Kurulumu doğrulama

Paketteki tanılama aracı API'ye bağlanır, kütüphaneleri ve token'ları listeler ve isterseniz deneme imzası atar:

./scripts/test-sign            # Linux
.\scripts\test-sign.exe        # Windows

Komut satırı tarafını token gerektirmeden doğrulamak için:

bash scripts/test-cli.sh            # canlı TSA testleri dahil
bash scripts/test-cli.sh --offline  # ağ gerektirmeyen kontroller

#Güncelleme

1. Servisi durdurun (Stop-Service veya systemctl stop quicksign).
2. Yeni paketi aynı klasörün üzerine açın. appsettings.json dosyasında değişiklik yaptıysanız önce yedekleyin ve sonra geri koyun.
3. Servisi başlatın.

quicksign.db (kayıtlı token'lar, şablonlar, iş geçmişi) ve logs/ klasörü pakette bulunmaz; güncellemede korunur.

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