Ana içeriğe geç

PDKS ayarlarını yapılandırma (genel, güvenlik, QR, bildirim, entegrasyon)

PDKS Ayarları sayfasındaki genel kuralları, konum ve cihaz güvenliğini, QR yapılandırmasını, bildirim matrisini, API anahtarı ve webhook entegrasyonunu ve değişiklik geçmişini anlatır.

Bu makale, Yapılandırma > PDKS > Ayarlar sayfasındaki şirket geneli kuralları anlatır. Bu sayfayı yalnız PDKS Admin Yetkisi olan kullanıcılar açar. Ayarlar tüm şubeler ve tüm çalışanlar için aynı anda geçerlidir.

Başlamadan önce

  • PDKS Admin Yetkisi sahibisiniz.

  • Değişiklikler Ayarları Kaydet'e basılana kadar uygulanmaz; sayfanın üstünde Kaydedilmemiş değişiklikler uyarısı görünür, Geri al ile vazgeçebilirsiniz. Entegrasyon & API sekmesindeki işlemler ise kaydetme beklemeden hemen uygulanır.

Adım adım

  1. Sol menüden Yapılandırma > PDKS > Ayarlar'a gidin. Sayfa altı sekmeden oluşur: Genel Ayarlar, Konum & Güvenlik, QR Yapılandırması, Bildirimler, Geç Kalma Politikası, Entegrasyon & API.

  2. İlgili sekmede değişikliği yapın ve Ayarları Kaydet'e tıklayın.

Genel Ayarlar

Genel Ayarlar sekmesi

Ayar

Açıklama

Varsayılan

PDKS modülü aktif

Kapatılırsa kimse QR okutamaz, bu modülde manuel kayıt girilemez; devamsızlık, otomatik çıkış ve günlük özet taramaları durur. Yeniden açılınca kapalı kalınan süre devamsızlık sayılmaz.

Açık

Zaman dilimi

Okutma saati, geç kalma, devamsızlık, otomatik çıkış ve 19:00 günlük özeti bu saate göre çalışır.

Europe/Istanbul

Erken çıkış toleransı

Planlanan bitişten bu kadar dakika önceki çıkış erken çıkış sayılmaz (0–120).

15 dk

Erken giriş engelleme

Vardiya başlangıcından en fazla bu kadar önce giriş okutulabilir (0–240).

30 dk

Otomatik çıkış (unutma önleme)

Açıksa planlanan bitişten 2 saat sonra hâlâ çıkış yoksa planlanan bitiş saati çıkış olarak yazılır. Kapalıysa eksik çıkış yöneticiye uyuşmazlık olarak düşer.

Kapalı

Otomatik girişte alandan çıkınca çıkış

Mobil uygulamada otomatik girişi açık çalışanlar konum alanından çıkınca çıkış kaydı alır. Girişten sonraki ilk 10 dk içindeki çıkış, süre dolunca çalışan hâlâ dışarıdaysa ayrıldığı saatle yazılır; giriş yapılan konum dışındaki alandan ve mola sırasındaki çıkış yok sayılır. Kapalıysa çıkışı çalışan yapar (Konumla giriş ve otomatik giriş).

Açık

Çift okuma engelleme

Bu süre içinde tekrarlanan aynı hareket yok sayılır; 0 kapalıdır (0–600 sn).

60 sn

Mola takibi zorunlu

Mola okutmaları sıraya bağlanır; mola açıkken çıkış yapılamaz.

Kapalı

Uzun mola filtreleme eşiği

Bu süreden uzun mola, mola bitişinde uzun mola uyuşmazlığı açar. 0 ise planlı mola + mola toleransı kullanılır.

90 dk

Mola toleransı

Yalnız uzun mola eşiği 0 olduğunda kullanılır.

10 dk

Planlı Mola Süresi

Haftalık planda her vardiyadan düşülen ücretsiz mola.

60 dk

Konum & Güvenlik

Konum & Güvenlik sekmesi

Ayar

Açıklama

Varsayılan

Sahte konum (Fake GPS) tespiti

Sahte konum bildiren cihazın okutması reddedilir (aşağıdaki nota bakın).

Açık

Root / Jailbreak tespiti

Root'lu veya jailbreak'li cihazdan okutma reddedilir (aşağıdaki nota bakın).

Açık

Konum alanı ek payı

Her konumun yarıçapına eklenen ek mesafe (0–200 m).

0 m

Okutma deneme sınırı

Bir çalışanın dakikada yapabileceği en fazla deneme (1–60). Konum uzak retleri sayılmaz.

6 /dk

Otomatik Karantina

Sahte konum veya root bildirilen cihaz hemen karantinaya alınır.

Açık

Cihaz Eşleştirme

Çalışan ilk başarılı okuttuğu cihaza bağlanır; başka cihaz için yönetici onayı gerekir. Tarayıcıda cihaz kimliği tarayıcıya özeldir.

Kapalı

Fotoğraf Doğrulaması

Her okutmada ön kameradan fotoğraf zorunludur. Açıkken çevrimdışı kuyruk kullanılamaz. Fotoğraflar şifreli saklanır.

Kapalı

Fotoğraf Saklama Süresi

Süresi dolan fotoğraflar her gece silinir, okutma kaydı kalır (1–730 gün).

90 gün

Hibrit Wi-Fi Doğrulaması / Şirket Wi-Fi Adı

GPS zayıfken şirket Wi-Fi'ına bağlı cihazda konum alanı sınırlı ölçüde genişletilir. Yalnız ağ adını bildiren istemcilerde çalışır (aşağıdaki nota bakın).

Kapalı

BLE Beacon Desteği

Bluetooth beacon yakınlığı, GPS zayıfken alanı sınırlı ölçüde genişletir. Yalnız beacon bildiren istemcilerde çalışır (aşağıdaki nota bakın).

Kapalı

IP Kısıtlaması / İzinli IP Adresleri

Yalnız izinli IP adreslerinden okutma. Tam adres (88.245.10.4), CIDR (10.0.0.0/24) ya da yıldızlı aralık (88.245.11.*). Mobil veriyle bağlanan çalışan okutamaz.

Kapalı

Not: Sahte konum, root/jailbreak, Wi-Fi ağ adı ve beacon kontrolleri yalnızca okutmayı yapan istemci bu bilgileri bildirdiğinde çalışır (ör. yerel bir uygulama veya API entegrasyonu). Teamso web QR Okut ekranı ve bu ekranı web görünümüyle açan mevcut mobil uygulama bu bilgileri bildirmez; ekrandaki açıklamalar da bunu söyler. Bu yüzden Sahte konum (Fake GPS) tespiti, Root / Jailbreak tespiti, Hibrit Wi-Fi Doğrulaması, BLE Beacon Desteği ve konumdaki WiFi SSID (Hibrit) alanı şu an okutmaların kabul ya da reddini etkilemez. Okutmaların güvenliğini konum alanı, dinamik QR, Cihaz Eşleştirme, Fotoğraf Doğrulaması ve IP Kısıtlaması sağlar.

QR Yapılandırması

Ayar

Açıklama

Varsayılan

Varsayılan QR tipi

Yeni QR kodlarda ön seçili tip (Dinamik ya da Statik). Mevcut kodları değiştirmez.

Dinamik

Dinamik QR yenilenme sıklığı

Yeni dinamik kodların ön değeri. Kod geçerlilik süresi'ni aşamaz.

60 sn

Ekran görüntüsü önlemleri

Sekme arka plana alınınca kod gizlenir, sağ tık kapanır, dinamik kodlar indirilemez ve yazdırılamaz.

Açık

İmza Algoritması

HMAC-SHA256 ya da HMAC-SHA512. Değiştirmek mevcut kodları bozmaz.

HMAC-SHA256

Kod geçerlilik süresi

Dönen kodun üretildiği andan itibaren okunabileceği süre (30–600 sn). Statik kodlara uygulanmaz.

90 sn

QR Ekranı Okunabilirlik Modu

Kod beyaz zeminde, yüksek kontrastla gösterilir; destekleyen tarayıcıda ekranın kararması engellenir.

Açık

Bildirimler

Bildirim Matrisi'nde her satır bir olaydır (ör. Geç kalma, Devamsızlık, Mazeret gönderildi, Günlük özet, Webhook iletilemedi). Soldaki sütunlar kanalı (Push, SMS, E-posta), sağdakiler alıcıyı (Admin, Yönetici, Çalışan) seçer. Sütun başlığına tıklamak o sütunu tüm olaylarda açar veya kapatır. Kanalı veya alıcısı seçilmemiş satırda "kimseye gitmiyor" yazar.

Bildirim Matrisi
  • Admin: şirket yöneticileri ve PDKS yönetici yetkisi olanlar. Yönetici: çalışanın bağlı olduğu yönetici ve çalışanın şubesinden sorumlu PDKS yöneticileri. Çalışan: olayın ait olduğu çalışan.

  • Günlük özet, onay bekleyen mazeret ve webhook uyarısı tek bir çalışana ait olmadığından bu satırlarda Yönetici tüm yöneticiler, Çalışan tüm aktif çalışanlar demektir.

  • Günlük özet ve Onay bekleyen mazeret her gün 19:00'da (şirket saatiyle) gider.

  • Mazereti gönderen çalışan, Çalışan sütunu işaretli olmasa da onay ve ret kararından her zaman haberdar edilir.

  • SMS yalnız sistemde cep telefonu kayıtlı kişiye gider.

Entegrasyon & API

Bu sekme, muhasebe, bordro veya raporlama sistemi gibi dış yazılımların PDKS verisine erişmesi içindir.

  1. API Ayarları'nda Anahtar Üret'e tıklayın (henüz anahtar yoksa tablodaki Anahtar Üret de olur), Anahtar Adı'nı yazın ve geçerlilik süresini seçin (30, 90, 365 gün ya da süresiz ∞). Anahtar yalnız bir kez gösterilir; güvenli bir yerde saklayın. Sızdığını düşünürseniz Yenile ya da İptal Et kullanın.

  2. Anahtar yalnız okuma yapar (kayıtlar, konumlar, uyuşmazlıklar, haftalık plan, özet); kayıt ekleyemez, ayar değiştiremez, QR okutamaz. İsteklerde X-Teamso-Api-Key başlığıyla gönderilir. Endpoint Listesi ve Postman Koleksiyonu İndir entegrasyonu yapan kişiye yöneliktir. Anahtar yalnız şirket aktifken ve PDKS paketi tanımlıyken çalışır.

  3. Webhook Ayarları'nda Yeni Webhook Ekle ile Hedef URL (https:// ile başlamalı) ve Abone olunan olaylar'ı seçin. Secret Key yalnız bir kez gösterilir; Secret Yenile ile değiştirebilirsiniz. Test Gönder ile deneme mesajı yollayın, Gönderim Geçmişi'nden sonuçları izleyin.

  4. Başarısız gönderimler 1 dk, 5 dk, 30 dk, 2 sa ve 6 sa sonra yeniden denenir; hepsi başarısız olursa Webhook iletilemedi bildirimi gider.

Entegrasyon & API sekmesi

Değişiklik Geçmişi

Sağ üstteki Değişiklik Geçmişi, kimin neyi ne zaman değiştirdiğini gösterir. Pencerenin üstündeki Ayar değişiklikleri ve Tüm işlemler sekmeleri kapsamı seçer; sekmelerde kayıt sayısı yazar. Kişi, işlem ya da ayrıntı ara kutusuyla arayabilir, Kişi, İşlem türü ve Tarih çipleriyle süzebilirsiniz; Tümünü temizle süzgeçleri kaldırır. Sistemin otomatik yaptığı işlemler Sistem olarak görünür. Detay sütununda kayda konu olan kişi adıyla yazar (ör. "Kişi: Ayşe Yılmaz"); kişi artık listede yoksa "Bilinmeyen kişi" görünür. Sayfalar listenin altındadır; dar ekranda kayıtlar kart olarak görünür.

Sonuç

Kaydedilen ayarlar bundan sonraki okutmalara uygulanır; geçmiş okutmalar yeniden değerlendirilmez. Kod geçerlilik süresi dönen tüm kodlara hemen uygulanır; varsayılan tip ve yenilenme sıklığı yalnız yeni kodlara ön değer olarak gelir.

Sık karşılaşılan sorunlar

Belirti: Ayarları Kaydet çalışmıyor, "Kaydetmeden önce işaretli alanları düzeltin" yazıyor.
​Neden: Bir alan geçersiz (ör. sırasız geç kalma eşikleri, IP kısıtlaması açıkken boş liste, kod geçerlilik süresinden uzun yenilenme).
​Çözüm: İşaretli alanı düzeltin.

Belirti: Sahte GPS, root, Wi-Fi veya beacon ayarını açtınız ama okutmalarda bir değişiklik olmadı.
​Neden: Okutma yapan uygulama bu bilgileri göndermiyor (Konum & Güvenlik bölümündeki nota bakın).
​Çözüm: Güvenlik için Cihaz Eşleştirme, Fotoğraf Doğrulaması, IP Kısıtlaması ve dinamik QR kullanın.

Belirti: Dış sistem API anahtarıyla 403 alıyor.
​Neden: Anahtar yalnız okuma (GET) yapabilir ya da şirkette PDKS paketi yok.
​Çözüm: Okuma dışındaki işlemler için çalışan oturumu gerekir; paket durumunu kontrol edin.

İlgili makaleler

Bu cevap sorunuzu yanıtladı mı?