Özellikler

Bu belge Teydex KYC sisteminde bulunan isteğe bağlı özellikleri ve yapılandırma seçeneklerini açıklar.

---

Parçalı Yükleme (Chunking)

Parçalı yükleme, büyük dosyaların daha küçük parçalar halinde yüklenmesine olanak tanıyan isteğe bağlı bir özelliktir. Bu özellik, kararsız bağlantılar üzerinden yapılan yüklemeler için güvenilirliği ve kullanıcı deneyimini iyileştirir.

Parçalı Yükleme Ne Zaman Kullanılır

• Büyük dosya yüklemeleri (genellikle > 5MB)
• Kararsız ağ bağlantıları
• Bant genişliği kısıtlamaları olan mobil ortamlar
• Yükleme sürdürme özelliği gerektiren ortamlar

Yapılandırma

Parçalı yükleme, yapılandırma ayarları aracılığıyla etkinleştirilebilir. Etkinleştirildiğinde, sistem dosya yüklemelerini tek büyük istek yerine otomatik olarak parçalar halinde işler.

Nasıl Çalışır

Parçalı yükleme işlemi belirli bir API sırası takip eder:

1. Yüklemeyi Başlatma: Sunucuyu parçalı yükleme için hazırlamak üzere POST /transaction/upload-chunk-init/ çağrısı yapın
2. Parçaları Yükleme: Her dosya parçası için POST /transaction/upload-chunk/ çağrısını tekrarlı olarak yapın
3. Durumu Kontrol Etme: Parça yükleme ilerlemesini doğrulamak için GET /transaction/upload-chunk-status/ kullanın
4. Yüklemeyi Sonlandırma: Yüklemeyi tamamlamak ve dosyayı yeniden birleştirmek için POST /transaction/upload-chunk-finalize/ çağrısı yapın

---

API Uç Noktaları

1. Parçalı Yüklemeyi Başlatma

Uç Nokta: POST /transaction/upload-chunk-init/ Amaç: Sunucuyu dosya parçalarını almaya hazırlar ve yükleme oturumu detaylarını döndürür.

İstek Gövdesi

{
  "filename": "document.jpg",
  "file_size": 2048576,
  "chunk_size": 1024,
  "total_chunks": 2000
}

Yanıt Gövdesi

{
  "upload_id": "abc123-def456-ghi789",
  "chunk_size": 1024,
  "expires_at": "2024-01-15T10:30:00Z"
}

2. Dosya Parçası Yükleme

Uç Nokta: POST /transaction/upload-chunk/ Amaç: Tekil dosya parçalarını meta verilerle birlikte yükler.

İstek Gövdesi (multipart/form-data)

upload_id: abc123-def456-ghi789
chunk_number: 1
chunk_data: [ikili veri]
chunk_hash: sha256_hash_of_chunk

Yanıt Gövdesi

{
  "upload_id": "abc123-def456-ghi789",
  "chunk_number": 1,
  "status": "received",
  "next_chunk": 2
}

3. Yükleme Durumunu Kontrol Etme

Uç Nokta: GET /transaction/upload-chunk-status/ Amaç: Parçalı yükleme ilerlemesinin mevcut durumunu döndürür.

Sorgu Parametreleri

• upload_id: Yükleme oturumu kimliği

Yanıt Gövdesi

{
  "upload_id": "abc123-def456-ghi789",
  "total_chunks": 2000,
  "uploaded_chunks": 1500,
  "missing_chunks": [1501, 1502, 1505],
  "status": "in_progress"
}

4. Yüklemeyi Sonlandırma

Uç Nokta: POST /transaction/upload-chunk-finalize/ Amaç: Yükleme işlemini tamamlar ve parçaları nihai dosyada birleştirir.

İstek Gövdesi

{
  "upload_id": "abc123-def456-ghi789",
  "file_hash": "sha256_hash_of_complete_file"
}

Yanıt Gövdesi

{
  "upload_id": "abc123-def456-ghi789",
  "status": "completed",
  "file_url": "/media/uploads/document.jpg",
  "file_size": 2048576
}

Faydalar

• Güvenilirlik: Başarısız yüklemeler son başarılı parçadan sürdürülebilir
• Performans: Mobil ağlarda büyük dosyaların daha iyi işlenmesi
• Kullanıcı Deneyimi: Büyük yüklemeler için ilerleme göstergesi
• Bant Genişliği Verimliliği: Başarısız yüklemeler baştan başlamayı gerektirmez

---

LDAP Kimlik Doğrulama

LDAP (Lightweight Directory Access Protocol) entegrasyonu, kurumların mevcut dizin hizmetlerini Teydex sisteminde kullanıcı kimlik doğrulama ve yetkilendirme için kullanmalarına olanak tanır.

LDAP Ne Zaman Kullanılır

• Mevcut Active Directory veya LDAP altyapısına sahip kurumsal ortamlar
• Merkezi kullanıcı yönetimi gereksinimleri
• Tek oturum açma (SSO) entegrasyon ihtiyaçları
• Dizin gruplarından eşlenen rol tabanlı erişim kontrolü gerektiren organizasyonlar

Nasıl Çalışır

1. Kullanıcı Kimlik Doğrulama: Kullanıcılar LDAP kimlik bilgileriyle giriş yapar
2. Dizin Arama: Sistem yapılandırılmış LDAP dizininde kullanıcıyı arar
3. Öznitelik Eşleme: Kullanıcı öznitelikleri (ad, e-posta, vb.) LDAP'tan uygulama alanlarına eşlenir
4. Grup Yetkilendirme: LDAP grupları erişim kontrolü için uygulama rollerine eşlenir
5. Oturum Oluşturma: Uygun izinlerle yerel oturum oluşturulur

Desteklenen Özellikler

• Kullanıcı Kimlik Doğrulama: Kimlik bilgilerini LDAP dizinine karşı doğrulama
• Öznitelik Eşleme: LDAP özniteliklerini uygulama kullanıcı alanlarına eşleme
• Grup Tabanlı Yetkilendirme: LDAP gruplarını uygulama rollerine eşleme
• Esnek Yapılandırma: Yapılandırılabilir arama tabanları, filtreler ve bağlama kimlik bilgileri

Yapılandırma

LDAP kimlik doğrulama ortam değişkenleri aracılığıyla yapılandırılır. Detaylı yapılandırma seçenekleri ve örnekler için setup.md dosyasındaki LDAP Entegrasyon bölümüne bakın.

LDAP gruplarından eşlenebilecek kullanılabilir uygulama rolleri:

• api_user: API Kullanıcısı
• read_only: Salt Okunur (varsayılan rol)
• administrator: Yönetici
• customer_representative: Müşteri Temsilcisi
• customer_representative_manager: Müşteri Temsilcisi Müdürü

---