Bireysel abonelik — kurulum ve kullanım

Başlamadan önce

1. İmzaOnay hesabı. Yoksa kayıt olun; varsa giriş yapın.
2. Profilde 11 haneli TC Kimlik Numarası. Bireysel başvuru bu numara olmadan gönderilmez, onay da bu numara olmadan tamamlanmaz.
3. Size ait nitelikli e-imza kartı veya USB token ve PIN kodu. PIN’i kimseyle paylaşmayın.
4. Windows 10 veya üzeri (64 bit), macOS 11 veya üzeri, ya da Ubuntu 20.04 veya üzeri.
5. Kartın takılacağı bilgisayarda yönetici yetkisi.

TC Kimlik Numarasını Profil sayfasına yazıp kaydedin, sonra başvuruya dönün. Karttaki sertifikanın numarası, profildeki ve abonelik anahtarındaki numara ile aynı olmalıdır.

1. Aboneliği başlatın

1. Giriş yapın.
2. Üyelik başvurusu formunu açın.
3. Üyelik tipi olarak Bireysel seçin. Aylık veya yıllık dönemi işaretleyin.
4. Başvuruyu gönderin.
5. Onayı Üyelik Başvuruları menüsünden izleyin.

Onaylanınca üyelik aktif olur ve API anahtarı sizin için üretilir. Bireysel planda API Key Üret düğmesine basılmaz; o düğme yalnızca deneme üyeliğindedir.

2. API anahtarını kopyalayın

1. Üyelik Bilgileri sayfasını açın.
2. Bu PC’de agent çalışıyorsa Bu PC’deki agent’a yaz düğmesine basın. Anahtar appsettings.json içindeki License → ApiKey alanına yazılır.
3. Agent yoksa appsettings.json için kopyala ile License → ApiKey bloğunu kopyalayıp elle yapıştırın.

Aynı pencere Üyelik Başvuruları listesinde de açılır. Anahtar uzun, tek satırlık bir metindir; ortasında bir nokta vardır. Başında veya sonunda boşluk kalmamalı, satır kırılmamalıdır. Anahtarı üçüncü kişilerle paylaşmayın.

appsettings.json için kopyala görünmüyorsa üyelik henüz onaylanmamıştır ya da profilde geçerli TC Kimlik Numarası yoktur.

3. İmzaOnay Agent’ı kurun

Agent, tarayıcı ile kartınız arasında köprüdür. Kartın takılı olduğu bilgisayara kurulur. İndirme sayfası

Kurulumdan sonra tarayıcı http://localhost:12171/ adresindeki yerel servise bağlanır. Bu adresi değiştirmeniz gerekmez.

Windows

1. EXE İndir ile kurulum dosyasını alın.
2. Dosyaya sağ tıklayıp Yönetici olarak çalıştır deyin.
3. Kurulum sihirbazını bitirin. Dosyalar C:\Program Files\EImza\ klasörüne kopyalanır.
4. EImza Signature Service adlı Windows hizmeti otomatik başlar.

Hizmetin çalıştığını görmek için Başlat menüsünde hizmetler yazın ve EImza Signature Service satırının Çalışıyor olduğunu kontrol edin.

Linux (Ubuntu / Debian)

sudo dpkg -i eimza-agent-linux.deb
sudo apt-get install -f

Servis adı eimza-signature, kurulum klasörü /opt/eimza-signature olur.

macOS

macOS 11 veya üzeri. Yönetici parolası gerekmez. Servis, oturum açmış kullanıcıda çalışır. Arşivin içinde kurulum betiği yoktur.

1. Terminal’de uname -m çalıştırın. arm64 (Apple Silicon) için eimza-agent-mac-arm64.tar.gz, x86_64 (Intel) için eimza-agent-mac-x64.tar.gz indirin. Varsayılan eimza-agent-mac.tar.gz Apple Silicon paketidir.
2. Arşivi ~/Applications/eimza-signature altına açın. Çalıştırılacak dosya EImza.WindowsService adındadır; Finder’dan çift tıklamayın.
3. Karantina bayrağını kaldırın, çalıştırma izni verin ve geçici imza atın.
4. ~/Library/LaunchAgents/com.eimza.signature.plist kaydını yükleyin. Servis oturum açılınca başlar.

uname -m
mkdir -p "$HOME/Applications/eimza-signature"
tar -xzf eimza-agent-mac-arm64.tar.gz -C "$HOME/Applications/eimza-signature"
xattr -dr com.apple.quarantine "$HOME/Applications/eimza-signature"
chmod +x "$HOME/Applications/eimza-signature/EImza.WindowsService"
codesign --force --sign - "$HOME/Applications/eimza-signature/EImza.WindowsService"

Intel Mac’te arşiv adı eimza-agent-mac-x64.tar.gz olur. Oturum açılınca başlaması için kayıt adı com.eimza.signature olan plist’i oluşturup yükleyin. Dinleme adresi localhost:12171 olur.

mkdir -p "$HOME/Applications/eimza-signature/logs" "$HOME/Library/LaunchAgents"
cat > "$HOME/Library/LaunchAgents/com.eimza.signature.plist" <<EOF
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
  <key>Label</key>
  <string>com.eimza.signature</string>
  <key>ProgramArguments</key>
  <array>
    <string>$HOME/Applications/eimza-signature/EImza.WindowsService</string>
  </array>
  <key>WorkingDirectory</key>
  <string>$HOME/Applications/eimza-signature</string>
  <key>RunAtLoad</key>
  <true/>
  <key>KeepAlive</key>
  <true/>
  <key>StandardOutPath</key>
  <string>$HOME/Applications/eimza-signature/logs/stdout.log</string>
  <key>StandardErrorPath</key>
  <string>$HOME/Applications/eimza-signature/logs/stderr.log</string>
</dict>
</plist>
EOF
launchctl bootout "gui/$(id -u)/com.eimza.signature" 2>/dev/null || true
launchctl bootstrap "gui/$(id -u)" "$HOME/Library/LaunchAgents/com.eimza.signature.plist"
launchctl kickstart -k "gui/$(id -u)/com.eimza.signature"

Android

imzaonay.apk kartın yerine geçmez. Kart ve imza bilgisayardaki agent’ta kalır. Telefon yalnızca imza onay ekranıdır.

4. API anahtarını agent ayarına yapıştırın

Kopyaladığınız anahtar, agent klasöründeki appsettings.json dosyasında License bölümünün ApiKey alanına yazılır. Kurulumla gelen hazır değeri silip kendi anahtarınızı yapıştırın. Başka satırları değiştirmeyin. ValidationApi adresi kurulumda https://api.imzaonay.com.tr olarak gelir.

"License": {
  "ApiKey": "BURAYA_KENDI_ANAHTARINIZI_YAPISTIRIN"
}

Tırnak işaretlerini koruyun. Anahtarın tamamı tek satırda kalsın.

Windows’ta dosyayı açmak

C:\Program Files\EImza\ korumalı bir klasördür. Normal Not Defteri kaydı reddeder.

1. Başlat menüsünde Not Defteri yazın ve Yönetici olarak çalıştır deyin.
2. Dosya → Aç yolunu kullanın. Adres çubuğuna C:\Program Files\EImza yazın.
3. Dosya türünü Tüm dosyalar yapın ve appsettings.json dosyasını açın.
4. License içindeki ApiKey değerini kendi anahtarınızla değiştirip kaydedin.

Linux

sudo nano /opt/eimza-signature/appsettings.json

macOS

~/Applications/eimza-signature/appsettings.json dosyasını bir metin editörüyle açın ve ApiKey değerini değiştirin.

5. Hizmeti yeniden başlatın

Anahtar, hizmet açılırken okunur. Dosyayı kaydettikten sonra hizmeti yeniden başlatmadan imza yeni anahtarla çalışmaz.

Windows

1. Hizmetler uygulamasını açın.
2. EImza Signature Service satırına sağ tıklayıp Yeniden Başlat deyin.

Restart-Service EImzaSignatureService

Linux

sudo systemctl restart eimza-signature
sudo systemctl status eimza-signature

macOS

launchctl kickstart -k "gui/$(id -u)/com.eimza.signature"

Oturumu kapatıp açmak da servisi yeniden başlatır. Süreç hemen kapanıp logda Killed: 9 yazıyorsa karantina kaldırma, chmod +x ve codesign adımlarını yeniden çalıştırın.

Hizmet hiç başlamıyorsa anahtar eksik, tırnak bozulmuş veya fazladan boşluk kalmış olabilir. Geçerli ama süresi dolmuş anahtarda hizmet açılır; imza yine de durur. Süreyi Üyelik Bilgileri sayfasındaki bitiş tarihinden kontrol edin. Agent güncellemesi bu dosyayı silmez; yine de güncellemeden önce anahtarın bir kopyasını saklayın.

6. Belge imzalayın

1. E-imza kartını bu bilgisayara takın.
2. Hesabınıza girin ve sayfayı bir kez yenileyin.
3. İmzala sayfasından belgeyi yükleyin. PDF için PAdES, CMS için CAdES, XML için XAdES kullanılır.
4. Üyeliğe kayıtlı TC Kimlik Numarası ile aynı kişiye ait sertifikayı seçin ve PIN’i girin.
5. İmzalı dosya Belgelerim sayfasında durur.

Kart takılı değilse veya hizmet durmuşsa sitede E-imza Bağlantısı Yok uyarısı çıkar. Hizmeti başlatın, kartı takın, sayfayı yenileyin.

Toplu imza, e-yazışma ve doğrulama

• Belgelerim sayfasında bekleyen belgeleri işaretleyip Seçilenleri imzala deyin. PIN bir kez sorulur. PDF üzerinde görsel imza konumu için belgeyi tek tek imzalayın.
• Hızlı EYP ve gelişmiş e-yazışma formu bireysel üyelikle kullanılabilir.
• İmzalı dosyayı E-İmza Doğrula sayfasına yükleyin. Doğrulama için agent şart değildir.

7. Kart ofiste kalsın

Nitelikli imza, kartın takılı olduğu bilgisayarda üretilir. O bilgisayar açık, agent çalışır ve internete çıkabilir durumdaysa imzayı başka bir cihazdan başlatabilirsiniz.

1. Kartın takılı olduğu bilgisayarda siteye girin.
2. Profil sayfasında Uzak imza (bu bilgisayar) anahtarını açın. Bu anahtar yalnızca agent’ın çalıştığı makinede görünür.
3. Ofis bilgisayarı açık kalsın. Diğer cihazdan belgeyi imzaya gönderin.

Profilde lisans anahtarı eksik uyarısı görürseniz yukarıdaki ApiKey alanını kontrol edip hizmeti yeniden başlatın. Mobil onayda PIN telefonda girilir; imza yine bilgisayardaki kartla tamamlanır.

Sık karşılaşılan durumlar

Güvenlik duvarı localhost üzerindeki 12171 portunu engelliyorsa tarayıcı agent’ı göremez. Bu portu internete açmayın.

Kısa kontrol listesi

1. Profilde TC Kimlik Numarası kayıtlı.
2. Bireysel başvuru onaylandı.
3. Üyelik Bilgileri sayfasından API anahtarı kopyalandı.
4. Agent kuruldu ve hizmet çalışıyor.
5. appsettings.json içindeki License → ApiKey kendi anahtarınız.
6. Hizmet bu değişiklikten sonra yeniden başlatıldı.
7. Kart takılı, tarayıcı yenilendi, İmzala sayfasından belge imzalandı.

Destek: [email protected]. İletişim. Pazartesi – Cuma: 09:00 – 18:00 · Cumartesi: 10:00 – 14:00.