QuickSign

Yapılandırma

QuickSign ayarlarını uygulama klasöründeki appsettings.json dosyasından okur. Her ayar ortam değişkeniyle de verilebilir: bölümler iki alt çizgiyle ayrılır (Sign:DbPath → Sign__DbPath). Ortam değişkeni dosyadaki değerin önüne geçer.

Varsayılan dosya

json
{
  "Urls": "http://0.0.0.0:5000",
  "Logging": {
    "LogPath": "",
    "LogLevel": { "Default": "Information" },
    "RequestLogging": { "Enabled": true, "MaskTckn": true }
  },
  "Sign": {
    "Pkcs11LibraryPath": "",
    "HardwareTimeoutSeconds": 120,
    "DbPath": "quicksign.db"
  },
  "Watchdog": {
    "Enabled": true,
    "IntervalSeconds": 60,
    "TimeoutSeconds": 15
  }
}

Ayarlar

AnahtarAçıklamaVarsayılan
UrlsDinlenecek adres(ler); virgülle birden çok verilebilirhttp://0.0.0.0:5000
Logging:LogPathLog klasörü<uygulama klasörü>/logs
Logging:LogLevel:DefaultDebug, Information, Warning, ErrorInformation
Logging:RequestLogging:EnabledHer HTTP isteğini özetle loglatrue
Logging:RequestLogging:MaskTcknİmza loglarında TCKN'yi maskele (123*****901)true
Sign:Pkcs11LibraryPathToken sürücüsünün .dll / .so yolu; boşsa otomatik bulunurboş
Sign:HardwareTimeoutSecondsToken bu sürede yanıt vermezse bağlantı sıfırlanır120
Sign:DbPathSQLite veritabanı (token kayıtları, şablonlar, iş geçmişi)quicksign.db
Sign:PinEncryptionKeyKayıtlı PIN'leri şifreleyen 32 baytlık anahtar (base64)paketteki değer
Sign:Tsa:*Zaman damgası sağlayıcısı — Zaman damgasıTurkTrust
Watchdog:EnabledUygulama kendi sağlığını yoklar, yanıt yoksa yeniden başlatılmak üzere kapanırtrue
Watchdog:IntervalSecondsYoklama aralığı60
Watchdog:TimeoutSecondsYanıt bekleme süresi15

Göreceli yollar (DbPath, LogPath) her zaman uygulama klasörüne göre çözülür; servis olarak çalışırken de değişmez.

Dinleme adresi

Yalnız aynı makineden erişim için:

json
{ "Urls": "http://127.0.0.1:5000" }

Farklı port:

bash
./QuickSign --Urls=http://127.0.0.1:8080

Kayıtlı PIN'lerin şifrelenmesi

Token kaydına PIN eklediğinizde PIN veritabanına Sign:PinEncryptionKey anahtarıyla AES-GCM kullanılarak şifrelenip yazılır; API yanıtlarında hiçbir zaman dönmez. Kendi anahtarınızı üretmek için:

bash
openssl rand -base64 32

Anahtar boş bırakılırsa makine adı ve uygulama klasöründen türetilir (tek sunucu için yeterli). Anahtarı değiştirirseniz daha önce kaydedilmiş PIN'ler çözülemez; token'ların PIN'lerini yeniden kaydedin.

Loglar

Loglar günlük dosyalara yazılır (logs/quicksign-YYYYMMDD.log), 50 MB'ı aşan dosya bölünür ve son 30 gün tutulur. İmza loglarında TCKN varsayılan olarak maskelenir (123*****901); PIN ve anahtar materyali loglara yazılmaz.

Marka bilgileri

brand.json, GET /, GET /api/info ve OpenAPI şemasında görünen uygulama adı ile iletişim bilgilerini taşır:

json
{
  "Brand": {
    "AppName": "QuickSign",
    "CompanyName": "EarthQuick",
    "Website": "https://quick-sign.earthquick.dev",
    "Email": "",
    "Phone": "",
    "Address": "",
    "LogoUrl": ""
  }
}

Windows servisi de AppName ile kaydedilir. Kendi markanızla paketlenmiş bir sürüm için bize yazın.

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