Chaindoc'a Giriş Chaindoc, elektronik imzalar ve belge yönetimi için blok zinciri tabanlı bir platformdur. Modern işletmeler için güvenli, uyumlu ve geliştirici dostu bir çözümdür. Chaindoc nedir? Chaindoc, belgeleri, elektronik imzaları ve ekip işbirliğini yönetmek için kapsamlı bir çözümdür. Blockchain teknolojisi ile oluşturulmuş olan bu çözüm, değiştirilemez belge doğrulama, yasal olarak bağlayıcı e-imzalar ve kurumsal düzeyde güvenlik sağlar. Belgenin gerçekliğini doğrulamak için blok zinciri doğrulaması Yasal olarak bağlayıcı elektronik imzalar ve uyumluluk Geliştirici dostu API'ler ve SDK'lar Kurumsal düzeyde güvenlik ve şifreleme Webhook'lar aracılığıyla gerçek zamanlı bildirimler Temel Özellikler Blockchain Doğrulama Chaindoc'ta yayınlanan her belge, blok zinciri ağlarında (Ethereum, Polygon, BSC, Arbitrum) otomatik olarak doğrulanır. Bu, belgenin gerçekliğini kanıtlayan ve tahrifatı önleyen değiştirilemez bir kayıt oluşturur. Elektronik İmzalar eIDAS, ESIGN Act ve UETA ile uyumlu, yasal olarak bağlayıcı e-imzalar Birden fazla imza türü: basit, gelişmiş ve nitelikli Çok taraflı imza iş akışları Sıralı veya paralel imza sıraları Son tarih yönetimi ve otomatik hatırlatıcılar Belge Yönetimi Tam denetim izi ile sürüm kontrolü PDF, Office belgeleri, resimler ve videolar için destek Ayrıntılı erişim kontrolü (özel, genel, ekip, kısıtlı) Meta veriler ve hashtag düzenlemesi Tam metin arama özellikleri Geliştirici Araçları Kapsamlı belgelere sahip RESTful API Node.js arka ucu ve web ön ucu için TypeScript SDK'ları Sorunsuz entegrasyon için gömülü imza arayüzü Gerçek zamanlı olay bildirimleri için webhook'lar Test için sanal ortam Takım İşbirliği Rol tabanlı erişim kontrolü (Sahip, Yönetici, Üye, Görüntüleyen) Takım çalışma alanları ve paylaşılan belgeler Etkinlik günlükleri ve denetim izleri Sumsub ile KYC/Kimlik doğrulama entegrasyonu Nasıl Çalışır Belgeyi Yükle Belgenizi web arayüzü veya API aracılığıyla yükleyin. PDF, Office dosyaları, resimler ve videoları destekler. İmza İsteği Oluştur Alıcıları ekleyin ve imza iş akışını yapılandırın. Son tarihleri ve özel mesajları ayarlayın. İmzalayanlar Bildirim Alır Alıcılar, güvenli imza bağlantısı veya gömülü arayüz içeren e-posta bildirimi alırlar. Belge İmzalama İmzalayanlar OTP ile kimlik doğrulaması yapar, belgeyi inceler ve elektronik imza uygular. Blockchain Doğrulama İmzalanmış belge, değiştirilemez kanıt için blok zincirinde otomatik olarak doğrulanır. Tamamlama Tüm taraflar, blok zinciri sertifikası ile imzalanmış belgeyi alır. Kullanım Örnekleri Yasal ve Uyum Sözleşmeler, gizlilik anlaşmaları, iş sözleşmeleri ve blockchain ile doğrulanmış gerçekliği olan yasal belgeler. Gayrimenkul Değiştirilemez kayıtları olan mülkiyet sözleşmeleri, kira sözleşmeleri ve işlem belgeleri. Finansal Hizmetler Kredi sözleşmeleri, yatırım belgeleri ve yasal düzenlemelere uygunluk formları. Sağlık Hasta onay formları, tıbbi kayıtlar ve HIPAA uyumlu belge yönetimi. Kurumsal Dahili onaylar, İK belgeleri, tedarikçi sözleşmeleri ve API aracılığıyla otomatikleştirilmiş iş akışları. Mimarlık Chaindoc, geleneksel bulut altyapısını blok zinciri teknolojisiyle birleştiren çok katmanlı bir mimari kullanır: Web Uygulaması - Next.js ile React tabanlı SPA REST API - Hız sınırlama ve kimlik doğrulama özellikli Node.js arka ucu Veritabanı - Yapılandırılmış veriler için PostgreSQL, dosya depolama için S3 Blockchain Katmanı - Ethereum, Polygon, BSC, Arbitrum üzerinde akıllı sözleşmeler Mesaj Kuyruğu - Webhook'lar ve bildirimler için olay odaklı mimari CDN - Hızlı belge erişimi için global içerik dağıtımı Güvenlik ve Uyumluluk Uçtan uca şifreleme (AES-256) SOC 2 Tip II sertifikalı altyapı GDPR, eIDAS, ESIGN Act, UETA uyumlu Düzenli güvenlik denetimleri ve sızma testleri İki faktörlü kimlik doğrulama (2FA) API anahtarları için IP beyaz listesi Başlangıç Başlamaya hazır mısınız? Yolunuzu seçin: Hızlı Başlangıç - İlk belgenizi 5 dakika içinde imzalatın Kurulum - Geliştirme ortamınız için SDK'ları kurun API Belgeleri - REST API referansına dalın SDK'lar - Web uygulamaları için Node.js Sunucu SDK'sını ve Gömülü SDK'yı keşfedin Uygulamalı bir kılavuz için Hızlı Başlangıç kılavuzuyla başlayın. Entegrasyon ayrıntıları için API Belgelerini inceleyin. GitHub'daki geliştirici topluluğumuza katılın Kurumsal sorularınız için [support@chaindoc.io](mailto:support@chaindoc.io) ile iletişime geçin.

Introduction

Hızlı Başlangıç Kılavuzu 10 dakikadan kısa bir sürede Chaindoc'u kullanmaya başlayın. Bu kılavuz, geliştiriciler için hem web arayüzünü hem de API entegrasyonunu kapsamaktadır. Son Kullanıcılar İçin Bir Chaindoc hesabı (chaindoc.io adresinden ücretsiz olarak kaydolun) İmzaya hazır bir belge (PDF, DOC veya görüntü) İmzalayanların e-posta adresleri Adım Adım: İlk İmzanız Kaydol [app.chaindoc.io](https://app.chaindoc.io) adresinde ücretsiz hesabınızı oluşturun. E-posta adresinizi doğrulayın. Belgeyi Yükle "Yeni Belge"yi tıklayın ve dosyanızı yükleyin. PDF, Office belgeleri, resimler (50 MB'a kadar) desteklenir. Belge Ayrıntılarını Ekle Belge adı, açıklaması ve düzenleme için etiketleri girin. Erişim düzeyini seçin (özel, ekip veya genel). İmza İsteği Oluştur "İmza İste"yi tıklayın, alıcı e-postalarını ekleyin, son tarihi belirleyin ve mesajı özelleştirin. İmza Akışını Yapılandırın İmza sırasını seçin (paralel veya sıralı), gerekirse KYC'yi etkinleştirin, bildirim tercihlerini seçin. İstek Gönder İnceleme ve gönderme. Alıcılar, güvenli imza bağlantısı içeren bir e-posta alırlar. İlerlemeyi Takip Edin İmza durumunu gerçek zamanlı olarak izleyin. İmzalar toplandığında bildirim alın. İmzalı Belgeyi İndir İşlem tamamlandığında, blok zinciri sertifikası ile imzalanmış belgeyi indirin. Belgenin gerçekliği blok zinciri ile doğrulanmıştır. Tüm taraflar imzalı belgenin kopyalarına sahiptir. Değiştirilemez denetim izi oluşturulur Yasal olarak bağlayıcı imza ve uyumluluk Geliştiriciler için REST API ve SDK'larımızı kullanarak Chaindoc'u uygulamanıza entegre edin. 1. API Anahtarlarını Alın API erişimi için Business plan aboneliği gerekir Kontrol panelinizde Ayarlar → API Erişimi'ne gidin. Ön uç için Açık Anahtar (pk_) ve arka uç için Gizli Anahtar (sk_) oluşturun. 2. SDK'yı yükleyin Kullanım durumunuza göre SDK'yı seçin: 3. API aracılığıyla İlk Belgenizi Oluşturun 4. İmza İsteği Oluşturun 5. İmza Arayüzünü (Ön Uç) Entegre Edin Web uygulamanızda gömülü imza için: 6. Durumu Takip Edin ve Olayları Yönet 7. Webhook'ları Ayarlama (İsteğe Bağlı) Etkinlikler için gerçek zamanlı bildirimler alın: Tam İş Akışı Örneği İşte tüm adımları birleştiren eksiksiz bir uçtan uca örnek: Sonraki Adımlar Ayrıntılı SDK kurulumu için Kurulum kılavuzunu okuyun. Tam uç nokta referansı için API Belgelerini inceleyin. Çerçeveye özgü örnekler için SDK belgelerini kontrol edin (React, Vue, Angular) Gerçek zamanlı olay bildirimleri için Webhooks'ları ayarlayın Üretim dağıtımı için Güvenlik En İyi Uygulamalarını inceleyin. Geliştirme için sandbox ortamı (pk_test_/sk_test_) kullanın. API anahtarlarını ortam değişkenlerinde saklayın, asla kodda saklamayın Geliştirme sırasında ayrıntılı günlükler için hata ayıklama modunu etkinleştirin İş akışını anlamak için önce küçük dosyalarla test edin Kod örnekleri ve destek için GitHub topluluğumuza katılın Sık Sorulan Sorular Blockchain doğrulaması ne kadar sürer? Blockchain doğrulaması, ağa bağlı olarak genellikle 1-5 dakika içinde tamamlanır. Belgeler hemen kullanılabilir, doğrulama eşzamansız olarak gerçekleşir. Ücretli bir plan olmadan test edebilir miyim? Evet! Ücretsiz plan web arayüzü erişimini içerir. API erişimi için İş planı gerekir, ancak test için sandbox ortamını kullanabilirsiniz. İmzalar yasal olarak bağlayıcı mıdır? Evet, Chaindoc imzaları eIDAS, ESIGN Act ve UETA düzenlemelerine uygundur. Blockchain doğrulama, ek yasal kanıt sağlar. Hangi dosya formatları desteklenir? PDF, DOC, DOCX, XLS, XLSX, PPT, PPTX, TXT, JPG, PNG, GIF, WEBP, SVG, MP4, AVI, MOV, WMV. Maksimum dosya boyutu: 50 MB.

Quick Start

Kurulum Chaindoc SDK'ları için eksiksiz kurulum kılavuzu. Arka uç entegrasyonu için Sunucu SDK'sını ve ön uç imza arayüzü için Gömülü SDK'yı kurun. Önkoşullar API erişimine sahip Chaindoc hesabı (İş planı gereklidir) Sunucu SDK için Node.js 18+ Embed SDK için modern tarayıcı desteği (Chrome, Firefox, Safari, Edge) Kontrol panelinden API anahtarları (Genel ve Gizli) Sunucu SDK Kurulumu Sunucu SDK'sı, arka uç entegrasyonu için kullanılır - belge yönetimi, imza talepleri ve blok zinciri doğrulama. Adım 1: Paketi Yükleyin Adım 2: Ortam Değişkenlerini Yapılandırın Proje kök dizininde bir .env dosyası oluşturun: .env dosyalarını asla sürüm kontrolüne göndermeyin. .gitignore dosyasına .env ekleyin. Geliştirme, hazırlık ve üretim için farklı anahtarlar kullanın. Güvenlik için anahtarları düzenli olarak değiştirin Adım 3: SDK'yı başlatın Adım 4: Bağlantıyı Doğrulayın SDK Yüklemeyi Yerleştir Embed SDK, web uygulamaları için bir imza arayüzü sağlar. Herhangi bir JavaScript çerçevesiyle çalışır. Adım 1: Paketi Yükleyin Adım 2: Ortam Değişkenlerini Yapılandırın Adım 3: Uygulamanızda Başlatın Çerçeveye Özgü Kurulum Next.js (Uygulama Yönlendiricisi) Next.js (Sayfa Yönlendirici) Nuxt 3 Angular TypeScript Yapılandırması Her iki SDK da tam TypeScript tanımlarını içerir. Ek @types paketlerine gerek yoktur. Ortam Yapılandırması Geliştirme Ortamı Üretim Ortamı Doğrulama Yüklemenizi şu doğrulama adımlarıyla test edin: SDK Sürümünü Kontrol Edin console.log(ChaindocEmbed.version); // Sürüm numarasını göstermelidir API Bağlantısını Doğrulayın API anahtarlarının geçerli olduğunu doğrulamak için sağlık kontrolü uç noktasını test edin Test Dosyası Yükleme Medya uç noktalarının çalıştığını doğrulamak için küçük bir test dosyası yükleyin. Embed SDK'yı başlatın SDK'yı başlatın ve tarayıcı konsolunda herhangi bir hata olup olmadığını kontrol edin. Sorun Giderme Modül Bulunamadı Hatası TypeScript Hataları TypeScript hataları görürseniz, tsconfig.json dosyanızda doğru modül çözümleme ayarlarının yapıldığından ve Node.js türlerinin yüklü olduğundan emin olun. API Anahtarı Sorunları 401 Yetkisiz - Geçersiz veya süresi dolmuş API anahtarı 403 Yasak - API erişimi için iş planı gereklidir Anahtarlar ortama uygun olmalıdır (test anahtarları hazırlık aşaması için, canlı anahtarlar üretim aşaması için) Ön uç için açık anahtarlar (pk_), yalnızca arka uç için gizli anahtarlar (sk_) Sonraki Adımlar İlk entegrasyonunuz için Hızlı Başlangıç kılavuzunu inceleyin. Uç nokta referansı için API Belgelerini kontrol edin. Gelişmiş özellikler için SDK belgelerini inceleyin. Gerçek zamanlı bildirimler için Webhooks'u ayarlayın Destek için GitHub'daki geliştirici topluluğuna katılın Her ortam için ayrı API anahtarları kullanın. Geliştirme sırasında ayrıntılı günlükler için hata ayıklama modunu etkinleştirin SDK sürümünü izleyin ve düzenli olarak güncelleyin Üretim dağıtımından önce sahneleme aşamasında kapsamlı bir şekilde test edin.

Installation

Elektronik İmzalar Yasal olarak bağlayıcı elektronik imzaları kolaylıkla oluşturun. Chaindoc, belgelerinize elektronik imza eklemek için basit ve güvenli bir yol sunar. İmzalarımız uluslararası standartlara uygundur ve maksimum yasal geçerlilik ve denetim izi bütünlüğü için blok zinciri doğrulaması ile desteklenir. İmza Türleri Chaindoc, farklı yasal ve ticari gereklilikleri karşılamak için birden fazla imza türünü destekler: Basit Elektronik İmza (SES) Düşük riskli belgeler ve iç anlaşmalar için temel dijital imza: Tıkla ve imzala işlevi E-posta doğrulaması gereklidir Gizlilik anlaşmaları, iç onaylar ve gayri resmi anlaşmalar için uygundur. Kimlik doğrulama gecikmeleri olmadan hızlı imza süreci Zaman damgası ve IP adresi içeren temel denetim izi Gelişmiş Elektronik İmza (AES) (2026'da kullanıma sunulacak) İş açısından kritik belgeler için gelişmiş güvenlik: Çok faktörlü kimlik doğrulama (SMS, kimlik doğrulama uygulaması veya e-posta) İmzalamadan önce kimlik doğrulaması Sözleşmeler, iş sözleşmeleri ve tedarikçi sözleşmeleri için uygundur. İmzalayan kimlik doğrulama ayrıntılarını içeren kapsamlı denetim izi Blockchain ile doğrulanmış tamamlama sertifikası Nitelikli Elektronik İmza (QES) (2026'da yürürlüğe girecek) El yazısı imzalarla eşdeğer yasal statüye sahip en üst düzey imza: Güvenilir sertifika yetkilileri tarafından onaylanmıştır Resmi belgelerle kimlik doğrulama eIDAS, ESIGN Yasası ve UETA ile uyumludur Yüksek düzeyde düzenlemeye tabi sektörler (hukuk, finans, sağlık) için gereklidir. Donanım güvenlik modülü (HSM) korumalı sertifikalar Değiştirilemez blok zinciri imza kanıtı Yasal Uygunluk Chaindoc imzaları, dünya çapındaki başlıca elektronik imza düzenlemelerine uygundur: Uluslararası Standartlar eIDAS (Elektronik Kimlik ve Güven Hizmetleri) - Avrupa Birliği ESIGN Yasası (Küresel ve Ulusal Ticarette Elektronik İmzalar Yasası) - Amerika Birleşik Devletleri UETA (Tekdüzen Elektronik İşlemler Yasası) - Amerika Birleşik Devletleri PIPEDA (Kişisel Bilgilerin Korunması ve Elektronik Belgeler Yasası) - Kanada Elektronik İşlemler Yasası - Avustralya Bilgi Teknolojisi Yasası - Hindistan Uyum Gereklilikleri Yasal geçerliliği sağlamak için Chaindoc şunları uygular: İmza niyetini açıkça belirtin (açık rıza gereklidir) Elektronik olarak iş yapmayı kabul edin İmza ile kaydın ilişkilendirilmesi Kayıtların saklanması ve tahrif edilemez depolama İmzalayan kimlik doğrulaması Zaman damgaları ve IP adresleri ile denetim izi Blockchain destekli bütünlük kanıtı İmza İş Akışı İmza İsteği Oluşturma İmza talebinde bulunmak için şu adımları izleyin: Belgenizi yükleyin (PDF, Word veya görüntü formatları) İmzalayanları e-posta adresleri ve isimleriyle ekleyin. İmza sırasını belirleyin (sıralı veya paralel imza) Belgeye imza alanları yerleştirin İmza türü ve kimlik doğrulama gereksinimlerini yapılandırın Özel mesaj ve son tarih ekleyin (isteğe bağlı) İmza isteği gönderin İmza Alanı Türleri Çeşitli alan türleriyle belgelerinizi özelleştirin: İmza - Elektronik imza alanı İsimlerin baş harfleri - Sayfaları veya maddeleri baş harfleriyle imzalamak için İmza Tarihi - İmza tarihi otomatik olarak doldurulur Metin Alanı - İsimler, unvanlar veya özel bilgiler için Onay kutusu - Onay veya kabul için Açılır menü - Önceden tanımlanmış seçeneklerden seçim yapmak için Radyo Düğmeleri - Tek bir seçenek seçimi için İmza Sırası Seçenekleri Sıralı - İmzalayanlar belgeyi belirtilen sırayla alırlar Paralel - Tüm imzalayanlar belgeyi aynı anda alır Hibrit - Sıralı ve paralel imza gruplarını birleştirin Koşullu - Bir sonraki imzalayan, önceki imzalayanın eylemine bağlıdır İmzalayan Deneyimi İmza İsteği Alma İmza için davet edildiğinde, alıcılar: Güvenli bağlantı içeren e-posta bildirimi alın Belgeye erişmek için bağlantıya tıklayın (temel imzalar için oturum açmanız gerekmez) Gerekirse kimliğinizi doğrulayın (MFA, SMS kodu vb.). Vurgulanan imza alanları ile belgeyi inceleyin İmza, baş harfler ve gerekli alanları doldurun. Bilgileri doğrulayın ve imzayı onaylayın. İmzalı kopyayı e-posta ile anında alın İmza Oluşturma Seçenekleri İmzalayanlar aşağıdakileri kullanarak imza oluşturabilirler: Birden fazla yazı tipi stiline sahip yazılmış imza Fare veya dokunmatik ekranla imza çizin El yazısı imzanın görüntüsünü yükleyin Parmak veya stylus ile mobil imza Kaydedilmiş imza (geri dönen kullanıcılar için) Blockchain Doğrulama Her imza blok zinciri teknolojisi ile güvence altına alınmıştır: Değiştirilemez Kanıt İmza sırasında blok zincirine kaydedilen belge hash'i Her imza olayı için benzersiz işlem kimliği Tahrifat önleyici doğrulama sertifikası Tüm taraflar için bağımsız doğrulama imkanı Organizasyonel değişikliklerden etkilenmeyen kalıcı kayıt Doğrulama Süreci İmzalanmış bir belgeyi herkes doğrulayabilir: Doğrulama portalına verify.chaindoc.com adresinden erişin. İmzalı belgeyi yükleyin veya doğrulama kodunu girin Sistem belge hash'ini hesaplar Blockchain kaydıyla karşılaştırılan hash Doğrulama sonucu şunları gösterir: belge bütünlüğü, imza tarihleri, imzalayanın ayrıntıları Doğrulama sertifikasını indirin (isteğe bağlı) Denetim İzi ve Sertifika Kapsamlı Denetim İzi Her imza ayrıntılı denetim bilgilerini içerir: Belgenin gönderilme zaman damgası ve gönderen bilgileri Her alıcı için e-posta teslimatı ve açılma zaman damgaları Belge görüntüleme zaman damgalarını (imzalayanların belgeye eriştiği zaman) Kimlik doğrulama yöntemi ve başarı/başarısızlık günlükleri Milisaniye hassasiyetinde imza zaman damgaları IP adresleri ve cihaz bilgileri Coğrafi konum verileri (etkinleştirilmişse) Belge tamamlanma zaman damgası Blockchain işlem kimliği ve blok numarası Bitirme Sertifikası Otomatik olarak oluşturulan sertifika şunları içerir: Belge başlığı ve benzersiz belge kimliği Rolü olan tüm taraflar (gönderen, imzalayanlar, görüntüleyenler) Tüm olayların tam zaman çizelgesi İmza resimleri ve yazılmış isimler Uygulanan güvenlik önlemleri (kimlik doğrulama yöntemleri) Blockchain doğrulama bilgileri Yasal sorumluluk reddi ve hizmet şartları referansı Anında doğrulama için QR kodu Gelişmiş Özellikler Yüz Yüze İmza Tek bir cihazla şahsen imza toplayın: Birden fazla imza toplamak için ana bilgisayar modu Her imza sahibi aynı cihazda imza atar İmzalayan başına bireysel e-posta doğrulaması Etkinlikler, konferanslar veya ofis imzalamaları için idealdir. Tüm imzalar ayrı denetim izleri ile kaydedilir Toplu Gönderim Aynı belgeyi birden fazla alıcıya gönderin: Alıcı bilgilerini içeren CSV dosyasını yükleyin Kişiselleştirme için alanları birleştirin (ad, şirket vb.) Yüzlerce imzacıya aynı anda gönderin Her belge için ayrı ayrı takip Toplu durum raporlama ve hatırlatıcılar Hatırlatmalar ve Bildirimler 3 günde bir otomatik hatırlatıcılar (yapılandırılabilir) Özel hatırlatma mesajları Son tarih öncesi son kullanma uyarıları Belge olayları için gerçek zamanlı bildirimler E-posta ve uygulama içi bildirim seçenekleri İmza Reddi ve Geçersizlik İmza reddi ve belge iptali durumlarını ele alın: İmzalayanlar gerekçe göstererek reddedebilirler. Gönderen anında bildirim alır Gönderen, tamamlanmadan önce belgeleri geçersiz kılabilir Denetim izinde iptal edildi olarak işaretlenen geçersiz belgeler Reddedilen veya geçersiz kılınan işlemler tüm taraflara bildirilir. En İyi Uygulamalar Belge Hazırlama Kolay tanımlama için açık belge başlıkları kullanın. PDF'leri optimize edin (büyük dosyaları sıkıştırın, güvenliği kaldırın) İmza alanlarını mantıklı konumlara yerleştirin Alanları açıkça etiketleyin (ör. "Müşteri İmzası", "Yönetici Onayı") Karmaşık alanlar için talimatlar veya açıklamalar ekleyin. Önemli alıcılara göndermeden önce imza akışını test edin Güvenlik Önerileri Yasal belgeler için Gelişmiş veya Nitelikli imzalar kullanın. Hassas anlaşmalar için MFA'yı etkinleştirin Uygun son kullanma tarihleri belirleyin (genellikle 7-30 gün). Yüksek değerli sözleşmeler için kimlik doğrulama gerektirin İmzalanmış belgeleri güvenli bir yerde saklayın. İmzalanmış belgeleri ve sertifikaları düzenli olarak yedekleyin. Önemli belgeler için blok zinciri kayıtlarını doğrulayın İletişim İpuçları İmza taleplerine açık konu satırları ekleyin. Belgeyi açıklayan kişiselleştirilmiş mesajlar ekleyin. Bağlam ve son tarih bilgilerini sağlayın. Sorular için iletişim bilgilerini ekleyin. Tüm iletişimlerde profesyonel bir üslup kullanın. Acil belgeler için telefonla takip edin. Sorun Giderme Sık Karşılaşılan Sorunlar Sık karşılaşılan imza sorunlarına çözümler: **İmzalayan e-postayı almadı**: Spam/önemsiz klasörünü kontrol edin, e-posta adresini doğrulayın, isteği yeniden gönderin **Bağlantı süresi doldu**: Gönderen son tarihi uzatabilir ve yeniden gönderebilir **Kimlik doğrulama başarısız**: İletişim bilgilerinin istekle eşleştiğini doğrulayın, alternatif kimlik doğrulama yöntemini deneyin **Mobil cihazlarda imza çizilemez**: Cihazın dokunmatik girişe izin verdiğinden emin olun, yazılmış imzayı deneyin **Belge yüklenmiyor**: İnternet bağlantısını kontrol edin, farklı bir tarayıcı deneyin, önbelleği temizleyin **İmza alanı eksik**: Gerekli alanları eklemek için gönderenle iletişime geçin. Destek Kaynakları E-posta desteği: [support@chaindoc.io](mailto:support@chaindoc.io) Geliştiriciler için API belgeleri

Electronic Signatures

Belge Yönetimi Belgelerinizi verimli bir şekilde düzenleyin ve yönetin. Tüm belgelerinizi tek bir güvenli yerde saklayın. Ayrıntılı izinler, blok zinciri ile doğrulanmış depolama ve kapsamlı denetim izleri kullanarak belgeleri yükleyin, düzenleyin ve ekibinizle paylaşın. Belge Yaşam Döngüsü Chaindoc, belgeleri oluşturulmasından arşivlenmesine kadar tüm yaşam döngüsü boyunca yönetir: Belge Durumları Taslak - Hazırlanmakta olan, henüz gönderilmemiş belge Beklemede - İmza için gönderildi, tamamlanmasını bekliyor Devam ediyor - Kısmen imzalandı, bazı imzalar kaldı Tamamlandı - Tüm imzalar toplandı, belge son haline getirildi Reddedildi - İmzalayan belgeyi reddetti Geçersiz - Gönderen tamamlanmadan önce iptal etti Süresi doldu - Son tarih geçildi, tamamlanmadı Arşivlendi - Tamamlanan belge uzun vadeli depolamaya taşındı Otomatik Durum Geçişleri Belgeler, eylemlere göre otomatik olarak aşamalardan geçer: Taslak → Beklemede (imzalayanlara gönderildiğinde) Beklemede → Devam ediyor (ilk imza alındı) Devam ediyor → Tamamlandı (tüm imzalar toplandı) Herhangi biri → İptal edildi (gönderen iptal etti) Herhangi biri → Reddedildi (imzalayan reddediyor) Beklemede/Devam Ediyor → Süresi Doldu (son tarih doldu) Belge Düzenleme Klasör Yapısı Belgeleri esnek klasör hiyerarşileriyle düzenleyin: Sınırsız sayıda klasör ve alt klasör oluşturun Departman, proje, müşteri veya özel kriterlere göre düzenleyin Sürükle ve bırak yöntemiyle belgeleri klasörler arasında taşıyın Ekip işbirliği için paylaşılan klasörler Bireysel kullanıcılar için kişisel klasörler Yeniden kullanılabilir belgeler için şablon klasörleri Tamamlanan belgeler için arşiv klasörleri oluşturun. Akıllı Filtreler ve Görünümler Güçlü filtreleme özelliği ile belgeleri hızlıca bulun: Duruma göre filtreleyin (beklemede, tamamlandı, süresi doldu) Tarih aralığına göre filtreleyin (oluşturulma, değiştirilme, imzalanma tarihi) İmzalayan veya gönderenlere göre filtreleyin Belge türüne veya şablona göre filtreleyin Etiketler ve özel meta verilerle filtreleyin Özel filtre kombinasyonlarını görünümler olarak kaydedin Son görüntülenen belgelere hızlı erişim Arama Özellikleri Tüm belgelerde gelişmiş arama: Belge içeriğinde tam metin arama Belge başlığı, açıklaması veya meta verilerine göre arama yapın İmzalayanın adı veya e-posta adresiyle arama yapın Özel alanlara ve etiketlere göre arama yapın Blockchain işlem kimliği arama Karmaşık sorgular için Boole operatörleri Vurgulama ve önizlemeli arama sonuçları Belge Yükleme ve İçe Aktarma Desteklenen Dosya Biçimleri PDF (.pdf) - Önerilen format Microsoft Word (.doc, .docx) Microsoft Excel (.xls, .xlsx) Microsoft PowerPoint (.ppt, .pptx) Görüntüler (.jpg, .png, .gif, .tiff) Metin dosyaları (.txt, .rtf) OpenDocument biçimleri (.odt, .ods, .odp) Yükleme Yöntemleri Dosyaları tarayıcıya sürükleyip bırakın Bilgisayardan dosya seçin Bulut depolama alanından içe aktarın (Google Drive, Dropbox, OneDrive) Hareket halindeyken tarama için mobil kamera yakalama Programatik entegrasyon için API yükleme Birden fazla belgenin toplu olarak yüklenmesi E-posta ekleri için Email-to-Chaindoc Otomatik Dönüştürme Tutarlılık için otomatik olarak PDF'ye dönüştürülen belgeler: Word, Excel, PowerPoint PDF'ye dönüştürüldü OCR (metin tanıma) ile PDF'ye dönüştürülen görüntüler Biçimlendirme, yazı tipleri ve düzeni koruyun Orijinal dosya indirilebilir Dönüştürme, yükleme sırasında anında gerçekleşir. Belge Depolama ve Güvenlik Güvenli Depolama AES-256 şifreleme Aktarım sırasında TLS 1.3 şifreleme Coğrafi olarak dağıtılmış depolama (çok bölgeli) 6 saatte bir otomatik yedekleme %99,99 çalışma süresi SLA GDPR, HIPAA ve SOC 2 uyumlu depolama Veri yerleşim seçenekleri (AB, ABD, Asya) Blockchain Sabitleme Her belge, tahrifat önleyici doğrulama için blok zincirine bağlanır: Yükleme sırasında blok zincirine kaydedilen belge hash'i Her durum değişikliğinde ek hash'ler ekleyin. Belgenin varlığı ve bütünlüğünün değiştirilemez kanıtı Tüm taraflar için bağımsız doğrulama imkanı Chaindoc hizmeti sonlandırılsa bile geçerliliğini korur Sürüm Kontrolü Otomatik sürümleme ile belge değişikliklerini takip edin: Aynı belgenin yüklenmesi üzerine otomatik sürüm oluşturma Zaman damgalı sürüm geçmişini görüntüleyin Sürümleri yan yana karşılaştırın Gerekirse önceki sürümleri geri yükleyin. Her sürümün benzersiz bir blok zinciri hash'i vardır Denetim izi, her sürümü kimin yüklediğini gösterir Erişim Kontrolü ve İzinler İzin Düzeyleri Belgeler ve klasörler için ayrıntılı izinler: Sahip - Tam kontrol, izinleri silebilir ve yönetebilir Editör - Belgeyi düzenleyebilir, imzaya gönderebilir ve yönetebilir Görüntüleyici - Salt okunur erişim, görüntüleyebilir ve indirebilir İmzalayan - Atanan belgeleri görüntüleyebilir ve imzalayabilir Yorumcu - Yorumları görüntüleyebilir ve ekleyebilir (düzenleme yapamaz) Erişim Yok - Görüntüleme açıkça engellenmiştir Paylaşım Seçenekleri Belirli kullanıcılarla e-posta yoluyla paylaşın Tüm ekip veya departmanla paylaşın Dış taraflarla (müşteriler, satıcılar) paylaşın. Sınırlı süreli erişim (belirlenen süre sonunda geçerliliğini yitirir) Parola korumalı paylaşım bağlantıları Genel paylaşım için salt görüntüleme bağlantıları Geçici erişim için süresi dolan bağlantılar Erişim Denetim İzi Belge erişimine tam görünürlük: Belgeye kimler ve ne zaman erişti? Hangi işlemler yapıldı (görüntüleme, indirme, düzenleme) IP adresi ve cihaz bilgileri Coğrafi konum verileri (etkinleştirilmişse) İzin değişiklikleri geçmişi Başarısız erişim girişimleri Uyumluluk için denetim günlüklerini dışa aktarın Belge Meta Verileri ve Etiketleri Standart Meta Veriler Otomatik olarak yakalanan meta veriler: Belge başlığı ve açıklaması Oluşturulma tarihi ve oluşturucu Değiştirilme tarihi ve son değiştiren kişi Dosya boyutu ve sayfa sayısı Belge durumu ve durumu İmzalayanlar ve alıcılar Tamamlanma tarihi (varsa) Blockchain işlem kimlikleri Özel Meta Veriler İşletmenizin ihtiyaçlarına göre özel alanlar ekleyin: Özel alan türleri oluşturun (metin, sayı, tarih, açılır menü) Zorunlu veya isteğe bağlı alanlar Departman, proje veya müşteri tanımlayıcıları Sözleşme değeri, son kullanma tarihleri Özel kategoriler ve sınıflandırmalar Harici sistemlerle entegrasyon (CRM, ERP) Birden fazla belgede meta verileri toplu olarak düzenleyin Etiketler ve Etiketler Belgelere sınırsız sayıda etiket ekleyin Görsel düzenleme için renk kodlu etiketler Mevcut etiketlerden otomatik tamamlama Etiketler ile filtreleyin ve arayın Birden fazla belge için toplu etiketleme Belge içeriğine göre etiket önerileri Takım genelinde etiket kitaplıkları Belge Saklama ve Arşivleme Saklama Politikaları Saklama kuralları ile belge yaşam döngüsünü otomatikleştirin: Belge türüne göre saklama sürelerini belirleyin (örneğin, vergi belgeleri için 7 yıl). Saklama süresinden sonra otomatik arşivleme Dava sırasında silinmeyi önlemek için yasal saklama Sektör düzenlemelerine (GDPR, HIPAA, SOX) uygunluk Arşivleme süresinden sonra otomatik silme (isteğe bağlı) Yaygın senaryolar için saklama politikası şablonları Belirli belgeler için politikaları geçersiz kılma Arşiv Depolama Tamamlanan belgelerin uzun süreli saklanması Erişim sıklığının azaltılması (soğuk depolama) Aktif depolamaya göre daha düşük maliyet İhtiyaç duyulduğunda anında erişim Blockchain doğrulaması korunur Harici yedekleme için arşivleri dışa aktarın Arşivlenmiş belgelerden uyumluluk raporlaması Belge Dışa Aktarma ve İndirme Dışa Aktarma Seçenekleri Tek tek belgeleri PDF olarak indirin ZIP arşivi olarak toplu indirme Denetim izi ve sertifika ile dışa aktarın Meta verileri CSV veya JSON formatında dışa aktarın Bulut depolama alanına aktarın (Google Drive, Dropbox) Yedekleme için planlanmış dışa aktarmalar Sistem entegrasyonu için API dışa aktarımı İndirme Denetimleri Belgeleri kimlerin indirebileceğini kontrol edin: Hassas belgeler için indirmeyi devre dışı bırakın İndirilen dosyalara kullanıcı bilgilerini içeren filigran ekleyin. Denetim izinde tüm indirme olaylarını takip edin Kullanıcı başına indirme sayısını sınırlayın Kullanımdan sonra indirme bağlantılarının süresini doldu İndirmeler için ek kimlik doğrulama gerektirin Belge Analizi Kullanım İstatistikleri Belge ve sistem kullanımını takip edin: Duruma göre toplam belge sayısı Ortalama tamamlanma süresi En aktif kullanıcılar ve ekipler Zaman içindeki hacim eğilimlerini belgelendirin. Popüler belge türleri ve şablonlar Depolama kullanımı ve büyümesi API kullanım istatistikleri Uyum Raporları İmza bekleyen belgeler Süresi dolmuş veya reddedilmiş belgeler Denetim raporlarına erişin Kullanıcı etkinlik raporları Saklama politikasına uygunluk Blockchain doğrulama raporları Özel rapor oluşturucu Entegrasyon ve Otomasyon Bulut Depolama Entegrasyonu Google Drive ile iki yönlü senkronizasyon Dosya erişimi için Dropbox entegrasyonu OneDrive ve SharePoint bağlantısı Box kurumsal depolama İmzaladıktan sonra otomatik olarak buluta yükleme Sistemler arası klasör eşlemesi İş Sistemi Entegrasyonu Salesforce - Fırsatlara ve hesaplara ekleyin HubSpot - Anlaşmalara ve kişilere bağlantı Microsoft Dynamics - CRM entegrasyonu SAP - ERP belge yönetimi NetSuite - Finansal belge iş akışı Zapier - 5000'den fazla uygulamaya bağlanın Özel API entegrasyonları En İyi Uygulamalar Belge Düzenleme Toplu yüklemelerden önce net bir klasör yapısı oluşturun. Tutarlı adlandırma kuralları kullanın. Etiketler ve meta verileri hemen uygulayın Tekrarlayan belge türleri için şablonlar oluşturun Eski belgeleri düzenli olarak arşivleyin. Saklama politikalarını erken oluşturun Klasörleri üç ayda bir gözden geçirin ve temizleyin. Güvenlik ve Uyumluluk Erişim izinlerini aylık olarak gözden geçirin. Ayrılan çalışanların erişim haklarını derhal iptal edin. Dış taraflar için zaman sınırlı paylaşım kullanın Hassas belgeler için indirme filigranını etkinleştirin Olağandışı etkinlikler için denetim izlerini izleyin Önemli belgelerin düzenli olarak yedeklenmesi Önemli belgeler için blok zinciri hash'lerini doğrulayın. Performans Optimizasyonu Büyük dosyaları yüklemeden önce sıkıştırın. Birden fazla belge için toplu işlemleri kullanın Dağınıklığı azaltmak için tamamlanan belgeleri arşivleyin Tekrarlanan aramalar yerine kaydedilmiş filtreleri kullanın Dışarıda yoğun olmayan saatlerde dışa aktarımları planlayın Taslakları ve iptal edilen belgeleri temizleyin. Sorun Giderme Sık Karşılaşılan Sorunlar **Yükleme başarısız**: Dosya boyutunu kontrol edin (maks. 100 MB), internet bağlantısını doğrulayın, farklı bir tarayıcı deneyin **Belge bulunamıyor**: Göz atmak yerine arama kullanın, filtreleri ve klasör erişimini kontrol edin **İzin reddedildi**: Erişim için belge sahibine veya yöneticiye başvurun **Yavaş performans**: Tarayıcı önbelleğini temizleyin, görüntülenen belge sayısını azaltın, eski dosyaları arşivleyin **İndirme çalışmıyor**: Pop-up engelleyicileri kontrol edin, indirme izinlerini doğrulayın, farklı bir tarayıcı deneyin **Sürüm çakışması**: Birden fazla kullanıcı aynı anda düzenleme yapıyor - ekiple koordinasyon sağlayın

Document Management

Takım Yönetimi Ekibinizle etkili bir şekilde işbirliği yapın. Ekip üyelerini davet edin, roller atayın ve izinleri yönetin, böylece kuruluşunuz genelinde sorunsuz bir işbirliği sağlayın. Chaindoc'un ekip yönetimi özellikleri, uyumluluk ve denetim izlerini korurken güvenli işbirliğini mümkün kılar. Ekip Yapısı Organizasyon Hiyerarşisi Chaindoc'ta organizasyon yapınızı oluşturun: Organizasyon - Şirketiniz için en üst düzey varlık Departmanlar - Ekipleri işlevlerine göre düzenleyin (Hukuk, İK, Satış vb.) Takımlar - Departmanlar içindeki daha küçük gruplar Projeler - Belirli girişimler için geçici gruplar İç içe geçmiş yapılar - Departmanlar alt departmanlar içerebilir Çoklu kuruluş desteği - Tek bir hesaptan birden fazla kuruluşu yönetin Takım Türleri Özel Takımlar - Yalnızca üyeler tarafından görülebilir Genel Takımlar - Tüm kuruluş tarafından görülebilir Çapraz işlevsel ekipler - Birden fazla departmandan üyeler Müşteri Ekipleri - Harici işbirlikçileri dahil edin Geçici Ekipler - Proje tamamlandıktan sonra otomatik olarak arşivleyin Kullanıcı Rolleri ve İzinleri Küresel Roller Farklı izin düzeylerine sahip kuruluş genelindeki roller: **Sahip** - Tam yönetim kontrolü, faturalandırma ve kullanıcı yönetimi **Yönetici** - Kullanıcı yönetimi, ekip oluşturma ve sistem ayarları **Yönetici** - Atanan alanlarda ekip ve belge yönetimi **Üye** - Belge oluşturma ve imzalama haklarına sahip standart kullanıcı **Misafir** - Harici işbirlikçileri için sınırlı erişim **Denetçi** - Denetim izi görünürlüğü ile salt okunur erişim İzin Matrisi Her rolün yapabilecekleri: Sahip: Hesap silme dahil tüm izinler Yönetici: Kullanıcıları, ekipleri, faturaları, entegrasyonları ve güvenlik ayarlarını yönetin. Yönetici: Ekipler oluşturun, ekip üyelerini yönetin, belgeleri onaylayın Üye: Belge oluşturma/gönderme, imzalama, ekip belgelerini görüntüleme Misafir: Yalnızca atanan belgeleri görüntüleyin ve imzalayın Denetçi: Tüm belgeleri ve denetim izlerini görüntüleyin, raporlar oluşturun Özel Roller Özel ihtiyaçlar için özel roller oluşturun: Ayrıntılı izinler tanımlayın (görüntüleme, oluşturma, düzenleme, silme, onaylama) Belirli departmanlara veya ekiplere atayın Belge türüne özgü izinler (örneğin, yalnızca İK departmanı çalışan sözleşmelerine erişebilir) Son kullanma tarihi olan geçici rol atamaları Yaygın senaryolar için rol şablonları Kısıtlı erişime sahip uyumluluk rolleri Kullanıcı Yönetimi Kullanıcı Ekleme Ekip üyelerini eklemenin çeşitli yolları: Özel karşılama mesajı içeren e-posta daveti CSV dosyası aracılığıyla toplu içe aktarma Tek Oturum Açma (SSO) otomatik provizyon Etki alanı tabanlı otomatik katılım (@company.com ile başlayan kullanıcılar) API tabanlı kullanıcı oluşturma Yönetici onayı ile self servis kayıt Kullanıcı Profilleri Her kullanıcı kapsamlı bir profile sahiptir: İsim, e-posta ve iletişim bilgileri Profil fotoğrafı ve biyografi İş unvanı ve departman Takım üyelikleri Atanan roller ve izinler Belge etkinlik istatistikleri Son oturum açma ve etkinlik durumu İki faktörlü kimlik doğrulama durumu Kullanıcı Yaşam Döngüsü Yönetimi Onboarding - Otomatik hoş geldiniz e-postaları ve eğitim materyalleri Aktif - Atanan kaynaklara tam erişim Askıya alınmış - Geçici erişim kaldırma (tatil, soruşturma) Devre dışı bırakıldı - Kalıcı erişim kaldırma (ayrılan çalışanlar) Sahipliği aktarın - Belgeleri başka bir kullanıcıya yeniden atayın Kullanıcı verilerini arşivleyin - Ayrıldıktan sonra denetim izini koruyun Takım İşbirliği Paylaşılan Çalışma Alanları Takım alanları içinde belgeler üzerinde işbirliği yapın: Üyeler için otomatik erişime sahip takım klasörleri Paylaşılan belge şablonları Takım genelinde kullanılan etiketler ve meta veriler Ortak düzenleme ve yorumlama Takım etkinliği panosu Paylaşılan imza iş akışları Takım analitiği ve raporları İletişim Özellikleri Belge yorumlarını ve bahsetmeleri (@kullanıcıadı) Dahili notlar (imzalayanlar tarafından görülemez) Takım duyuruları ve bildirimleri Takım eylemleri için etkinlik akışı Belge olayları için e-posta bildirimleri Acil durumlar için uygulama içi mesajlaşma Slack, Microsoft Teams ile entegrasyon Onay İş Akışları Belgeleri onay zincirlerinden geçirin: Çok adımlı onay süreçlerini tanımlayın Sıralı veya paralel onaylar Belge değerlerine dayalı koşullu yönlendirme Zaman dilimi içinde onaylanmazsa otomatik olarak üst düzeye aktarılır Onay yetkisini devredin Onay geçmişi ve denetim izi Yaygın senaryolar için şablon tabanlı iş akışları Dış İşbirliği Misafir Erişimi Dış taraflarla güvenli bir şekilde işbirliği yapın: Müşterileri, satıcıları veya ortakları konuk olarak davet edin Belirli belgelere veya klasörlere sınırlı erişim İç ekip belgelerine erişim yok Süre sınırlı misafir hesapları Denetim günlüklerinde izlenen konuk etkinliği Ek kullanıcı lisansı gerekmez Gerekirse tam üyeye kolayca dönüştürme Müşteri Portalları Dış işbirliği için markalı portallar oluşturun: Müşteriler için özel markalı arayüz Müşteri belgeleri için ayrılmış alan Müşteri dosya yükleyebilir ve indirebilir Müşteri ekibi ile güvenli mesajlaşma Müşteriye özel raporlama ve analizler Beyaz etiket seçeneği (Chaindoc markasını kaldırın) Farklı müşteriler için birden fazla portal Erişim Kontrolü ve Güvenlik Takım Düzeyinde İzinler Takım belgelerini kimlerin görüntüleyebileceğini kontrol edin Belge oluşturmayı belirli rollere sınırlandırın Hassas belgeler için onay gereklilikleri İndirmeyi veya yazdırmayı engelleyin Takım erişimi için IP adresi kısıtlamaları Cihaz kısıtlamaları (yalnızca kurumsal cihazlar) Coğrafi kısıtlamalar (belirli ülkeleri engelleme) Kimlik Doğrulama Seçenekleri Birden fazla kimlik doğrulama yöntemiyle ekip erişimini güvenli hale getirin: Güçlü şifre politikalarına sahip e-posta/şifre Çok faktörlü kimlik doğrulama (MFA) gereklidir SAML 2.0 aracılığıyla Tek Oturum Açma (SSO) Google Workspace / Microsoft 365 entegrasyonu LDAP/Active Directory entegrasyonu Mobil cihazlarda biyometrik kimlik doğrulama Donanım güvenlik anahtarları (FIDO2) Oturum Yönetimi Etkinlik yokluğunda otomatik oturum kapatma Şifre değişikliğinde zorla çıkış yapın Cihazlar arasında etkin oturumları görüntüleyin Uzaktan oturum sonlandırma Rol bazında oturum zaman aşımı politikaları Eşzamanlı oturum sınırları Şüpheli etkinlikler için oturum açma uyarıları Takım Analizi ve Raporlama Takım Performans Metrikleri Ekip üretkenliğini ve belge faaliyetlerini takip edin: Takım/kullanıcı başına oluşturulan belgeler İmza tamamlanma süresinin ortalaması En aktif kullanıcılar ve ekipler Belge onayındaki darboğazlar Kullanıcı giriş sıklığı Ekip başına depolama kullanımı İmza taleplerine yanıt süresi Faaliyet Raporları Kullanıcı etkinlik günlükleri (giriş, belge erişimi) Takım işbirliği istatistikleri Belge durum raporları (beklemede, tamamlandı) Başarısız kimlik doğrulama girişimleri İzin değişiklikleri denetimi Harici kullanıcı erişim günlükleri E-posta yoluyla planlanmış raporlar Uyum Raporlaması Düzenleyiciler için erişim denetim izlerine erişin Kullanıcı sertifika raporları Belge saklama uyumluluğu Güvenlik olayı raporları Rol atama geçmişi Veri yerleşim yeri doğrulaması Dış denetimler için raporları dışa aktarın Faturalandırma ve Lisanslama Kullanıcı Lisansları Esnek lisanslama seçenekleri: Kullanıcı başına lisanslama (aylık veya yıllık) Ekstra ücret ödemeden sınırsız sayıda misafir kullanıcı İstediğiniz zaman kullanıcı ekleyin veya kaldırın Otomatik fatura düzeltmeleri Büyük ekipler için hacim indirimleri Kurumsal sınırsız kullanıcı planları Yeni kullanıcılar için ücretsiz deneme süresi Kullanım Takibi Aktif ve pasif kullanıcı izleme Kullanıcı başına belge hacmi Ekip başına depolama kullanımı API çağrısı kullanımı Özellik kullanım istatistikleri Kullanıma göre lisansları optimize edin Sınırlara yaklaşıldığında uyarılar Entegrasyon ve Otomasyon Dizin Entegrasyonu Azure Active Directory senkronizasyonu Google Workspace dizin senkronizasyonu Okta kimlik sağlayıcısı OneLogin SSO entegrasyonu LDAP dizini içe aktarma Otomatik kullanıcı sağlama/kaldırma Dizinden grup eşlemesi Takım İş Akışı Otomasyonu Belgeleri ekip üyelerine otomatik olarak atayın Rol bazlı otomatik klasör erişimi Takım liderlerine planlanmış raporlar Bekleyen belgelerin otomatik olarak üst düzeye taşınması Belge olaylarına dayalı iş akışı tetikleyicileri Proje yönetimi araçlarıyla entegrasyon Takım etkinlikleri için özel webhook'lar En İyi Uygulamalar Takım Kurulumu Net bir organizasyon yapısı ile başlayın Kullanıcı eklemeden önce roller ve izinleri tanımlayın Takım isimlendirme kuralları oluşturun Onay iş akışı şablonları oluşturun Kullanıcıları davet etmeden önce SSO'yu ayarlayın Ekip yapınızı ve politikalarınızı belgelendirin. Tüm ekibe uygulamaya geçmeden önce ekip liderlerini eğitin. Güvenlikle İlgili En İyi Uygulamalar Tüm kullanıcılar için MFA'yı uygulayın Düzenli erişim incelemeleri (üç ayda bir) Ayrılan kullanıcıların hesaplarının derhal devre dışı bırakılması En az ayrıcalık ilkesini kullanın Misafir kullanıcı erişimini yakından izleyin Düzenli güvenlik farkındalık eğitimi Felaket kurtarma prosedürlerini test edin İşbirliği Verimliliği Ortak ekip belgeleri için şablonlar kullanın Net onay zincirleri oluşturun Belge incelemeleri için SLA'lar belirleyin Belirli kullanıcıları bilgilendirmek için @mentions kullanın. Devam eden projeler için paylaşılan klasörler oluşturun. Etkin olmayan takımların düzenli olarak temizlenmesi Analitiği kullanarak darboğazları belirleyin Yeni Ekip Üyelerini İşe Almak Başlangıç kılavuzu ile birlikte hoş geldiniz e-postası gönderin İlk hafta için mentor veya arkadaş atayın. Belge iş akışları hakkında eğitim verin. Erişimi aşamalı olarak verin (sınırlı olarak başlayın) İlk haftadan sonra kontrol randevusu alın Ekip kurallarını ve en iyi uygulamaları paylaşın İlgili ekiplere ve kanallara ekleyin. Sorun Giderme Sık Karşılaşılan Sorunlar **Kullanıcı ekip belgelerine erişemiyor**: Ekip üyeliğini ve rol izinlerini kontrol edin. **Davet alınmadı**: Spam klasörünü kontrol edin, e-posta adresini doğrulayın, daveti yeniden gönderin **SSO oturum açma başarısız**: SSO yapılandırmasını doğrulayın, BT yöneticisine danışın **İzin reddedildi hatası**: Kullanıcının daha yüksek bir rol veya belirli belge izinlerine ihtiyacı olabilir. **Daha fazla kullanıcı ekleyemiyorum**: Lisans sınırlarını kontrol edin, gerekirse planınızı yükseltin **Kullanıcı iki kez görünüyor**: Yönetici paneli aracılığıyla yinelenen hesapları birleştirin. Yardım Alma Yönetici panosu yardım merkezi Yöneticiler için 7/24 sohbet desteği Özel hesap yöneticisi (Kurumsal planlar) Takım yönetimi video eğitimleri En iyi uygulamalar için topluluk forumu E-posta: admin-support@chaindoc.com Olaylar için acil güvenlik hattı

Team Management

API Entegrasyonu Güçlü REST API ve SDK'larımızla Chaindoc'u uygulamalarınıza entegre edin. Belge iş akışlarını otomatikleştirin, imzaları toplayın ve olayları gerçek zamanlı olarak senkronize edin. Genel Bakış Chaindoc, özel belge imzalama iş akışları oluşturmanıza, süreçleri otomatikleştirmenize ve mevcut sistemlerinizle entegre etmenize olanak tanıyan kapsamlı bir REST API sağlar. API, tam TypeScript desteği ve otomatik yeniden deneme özelliği ile geliştiriciler için tasarlanmıştır. Blockchain doğrulamalı belge yükleme ve yönetimi İmza talebi oluşturma ve takip etme Etkinlik bildirimleri için gerçek zamanlı webhook'lar Sorunsuz kullanıcı deneyimi için gömülü imza arayüzü KYC/Kimlik doğrulama entegrasyonu Ekip ve rol yönetimi Başlangıç 1. API Erişimi Alın API erişimi yalnızca İşletme planında mevcuttur Kontrol panelinde Ayarlar → API Erişimi'ne gidin. Genel Anahtar (pk_) ve Gizli Anahtar (sk_) oluşturun Anahtarları güvenli bir şekilde saklayın ve asla sürüm kontrolüne göndermeyin 2. Entegrasyon Yöntemini Seçin Chaindoc üç entegrasyon yaklaşımı sunar: REST API - Maksimum esneklik için doğrudan HTTP istekleri Sunucu SDK - Otomatik yeniden deneme özelliğine sahip, tür güvenli Node.js SDK (@chaindoc_io/server-sdk) Embed SDK - Web uygulamaları için ön uç imza arayüzü (@chaindoc_io/embed-sdk) 3. Hızlı Örnek Temel API Kavramları Kimlik Doğrulama Tüm API istekleri, Yetkilendirme başlığında API anahtarları kullanılarak kimlik doğrulaması gerektirir: Genel Anahtarlar (pk_) - Ön uç uygulamaları için salt okunur erişim Gizli Anahtarlar (sk_) - Arka uç sunucuları için tam okuma/yazma erişimi Test Anahtarları (pk_test_, sk_test_) - Hazırlık/geliştirme için Canlı Anahtarlar (pk_live_, sk_live_) - Üretim için Hız Sınırları API uç noktaları, adil kullanımı sağlamak için hız sınırlarına sahiptir: Genel uç noktalar: 10 saniyede 3 istek Medya yükleme: 10 saniyede 3 istek Okuma işlemleri: 60 saniyede 10 istek İmza oluşturma: 3 saniyede 20 istek Hata İşleme API, ayrıntılı hata mesajları içeren standart HTTP durum kodlarını döndürür: Yaygın Entegrasyon Modelleri Belge Yükleme ve İmzalama Akışı Dosya Yükle POST /media/upload - PDF, Office belgesi veya resim yükleyin Belge Oluştur POST /documents - Blockchain doğrulaması için status='published' ile belge kaydı oluşturun İmza İsteği Oluştur POST /signatures/requests - Alıcıları ekleyin ve iş akışını yapılandırın Gömülü Oturum Oluştur POST /embedded/sessions - Her imzalayan için oturum oluşturun Açık İmza Arayüzü Ön uçta imza akışını açmak için sessionId ile Embed SDK'yı kullanın. İlerlemeyi Takip Edin GET /signatures/requests/:id/status - İmzalama sürecini izleyin Webhook Alın signature.request.completed olayı, tüm imzalar toplandığında Yalnızca Arka Uç İş Akışı İmzalayanların arayüzünüzü kullanmadığı durumlar için: Toplu Belge İşleme Gelişmiş Özellikler Webhook'lar Belge olayları için gerçek zamanlı bildirimler alın: KYC Entegrasyonu Yüksek güvenlikli iş akışları için kimlik doğrulamayı entegre edin: Erişim Kontrolü Ayrıntılı erişim kontrolü ile belge izinlerini yönetin: En İyi Uygulamalar API anahtarlarını ortam değişkenlerinde saklayın, asla kodda saklamayın Geliştirme için test anahtarlarını, üretim için canlı anahtarları kullanın. Hız sınırı yönetimi için üstel geri çekilme uygulayın Tekrar saldırılarını önlemek için webhook imzalarını doğrulayın Uygun olduğunda API yanıtlarını önbelleğe alın Daha iyi performans için belgeleri oluşturmadan önce dosyaları yükleyin Büyük veri kümeleri için sayfa numaralandırma kullanın. Hız sınırı başlıklarını izleyin ve istek sıklığını ayarlayın Örnek Entegrasyonlar E-ticaret Platformu Yüksek değerli siparişler için satın alma sözleşmelerini otomatik olarak oluşturun ve imzalayın. İK Sistemi Onboarding sırasında otomatik istihdam sözleşmesi imzalamak için HRIS ile entegre edin. CRM Entegrasyonu Salesforce, HubSpot veya özel CRM'deki müşteri kayıtlarından doğrudan imza talepleri oluşturun. Belge Yönetim Sistemi Tahrifat önleyici denetim izleri için mevcut DMS'ye blok zinciri doğrulaması ekleyin. Kaynaklar API Belgeleri - Tüm uç noktalarla birlikte eksiksiz REST API referansı SDK'lar - Çerçeve örnekleri içeren Sunucu SDK ve Yerleşik SDK belgeleri Webhooks - Gerçek zamanlı olay bildirimleri kurulum kılavuzu Hızlı Başlangıç - İlk entegrasyonunuzu 10 dakika içinde çalıştırın GitHub Örnekleri - Örnek entegrasyonlar ve kod parçacıkları Ayrıntılı uç nokta referansı için API Belgelerini kontrol edin. Tip güvenli entegrasyon için SDK belgelerini inceleyin. Kod örnekleri için GitHub topluluğuna katılın Kurumsal destek için [support@chaindoc.io](mailto:support@chaindoc.io) ile iletişime geçin.

API Integration

İlk İmzanız Chaindoc ile ilk belgenizi imzaya göndermek için eksiksiz kılavuz. Sadece 5 dakikada imza iş akışına aşina olun. Belgeleri yükleme ve hazırlama Alıcı ve imza alanları ekleme İmzalama iş akışı seçeneklerini yapılandırma İmza sürecini takip etme Blockchain sertifikalı imzalı belgeleri indirme Başlamadan Önce Şunlara sahip olduğunuzdan emin olun: Bir Chaindoc hesabı (chaindoc.io adresinden ücretsiz olarak kaydolun) İmzalanacak belge (PDF, Word veya görüntü formatında) İmza atması gereken kişilerin e-posta adresleri Dijital imzalar hakkında temel bilgi Adım Adım Kılavuz Adım 1: Belgenizi Yükleyin Belgelere gidin Kenar çubuğundaki veya kontrol panelindeki "Belgeler" menüsünü tıklayın. "Yeni Belge"yi tıklayın. Sağ üst köşedeki "Yeni Belge" veya "Yükle" düğmesini bulun. Dosya Seç Belgenizi seçin (PDF önerilir, maksimum 50 MB) Ayrıntılar Ekle Kolay düzenleme için belge adı, açıklama ve etiketleri girin "İş Sözleşmesi - John Doe - 2024" gibi açıklayıcı isimler kullanın. Daha iyi arama yapılabilmesi için #contract, #2024 gibi hashtag'ler ekleyin. Belge hassas bilgiler içeriyorsa 'Özel' erişimi seçin Adım 2: Belge Ayarlarını Yapılandırın İmza talep etmeden önce belgenizi yapılandırın: Belge Adı - Açık, açıklayıcı başlık Açıklama - İmzalanması gerekenlerin kısa özeti Erişim Düzeyi - Özel (sadece siz), Ekip (ekiple paylaşılır) veya Genel Hashtag'ler - Düzenleme için #sözleşme, #acil gibi etiketler ekleyin. Meta veriler - Müşteri adı, sözleşme değeri vb. gibi özel alanlar ekleyin. Adım 3: İmza İsteği Oluşturun Belgeniz yüklendiğine göre, bir imza talebi oluşturun: "İmza İste"yi tıklayın. Belge ayrıntıları sayfasında düğmeyi bulun Alıcıları Ekle İmzalayanların e-posta adreslerini girin (her satıra bir tane veya virgülle ayrılmış olarak) İmza Sırasını Ayarlama "Paralel" (hepsi aynı anda) veya "Sıralı" (birbiri ardına) seçeneğini seçin. Son Tarih Belirleyin İmzaların ne zaman tamamlanması gerektiğini seçin Mesaj Ekle İmzalayanlara, neyi imzaladıklarını açıklayan kişiselleştirilmiş bir mesaj yazın. Paralel - Tüm alıcılar aynı anda imzalayabilir (daha hızlı) Sıralı - Alıcılar belirli bir sırayla oturum açar (onay zincirleri için kullanışlıdır) Karışık - Karmaşık iş akışları için her iki yaklaşımı birleştirin Adım 4: Gelişmiş Seçenekleri Yapılandırın İmza deneyimini özelleştirin: KYC Doğrulama - Yüksek güvenlikli belgeler için kimlik doğrulaması gerektirir Hatırlatmalar - Son teslim tarihinden önce otomatik e-posta hatırlatmaları İmzaladıktan Sonra Erişim - İmzalayanların tamamladıktan sonra indirmelerine izin verin Bildirimler - İmza etkinlikleri için e-posta/SMS bildirimleri Süre dolumu - Son tarihten sonra isteği otomatik olarak süresi dolmuş olarak işaretleyin Adım 5: Gözden Geçirin ve Gönderin Göndermeden önce tüm ayrıntıları gözden geçirin: Alıcılar, güvenli imza bağlantısı içeren bir e-posta alırlar. Belgeyi inceler ve elektronik imza uygularlar. Her kişi imzaladığında bildirim alırsınız. Belge tamamlandığında blok zinciri ile doğrulanır. Tüm taraflar, orijinallik sertifikası ile birlikte bir kopyasını alırlar. Adım 6: İlerlemeyi Takip Edin İmza talebinizi gerçek zamanlı olarak izleyin: Durum Panosu - Kimlerin imzaladığını ve kimlerin beklemede olduğunu görün Etkinlik Zaman Çizelgesi - Zaman damgalı tüm etkinlikleri görüntüleyin E-posta Bildirimleri - Her imzada bildirim alın Hatırlatmalar - Sistem, bekleyen imzalayanlara otomatik hatırlatmalar gönderir. İptal/Değiştir - İsteği iptal edin veya belirli alıcılara yeniden gönderin 7. Adım: İmzalı Belgeyi İndirin Tüm imzalar toplandıktan sonra: Tamamlanma Bildirimi Tüm imzalar tamamlandığında e-posta ile bildirim alacaksınız. Belgeyi İndir Tüm imzaların bulunduğu imzalı PDF'yi almak için "İndir" düğmesine tıklayın. Blockchain Sertifikası Orijinallik kanıtı olarak blok zinciri doğrulama sertifikasını indirin. Denetim İzi Zaman damgaları ve IP adresleri ile birlikte tüm imza geçmişini dışa aktarın İlk imza iş akışınızı tamamladınız! Belge yasal olarak bağlayıcıdır ve blok zinciri ile doğrulanmıştır. Tüm tarafların sertifikalı kopyaları vardır. Tam denetim izi sonsuza kadar korunur Alıcılar Ne Görür? Alıcılar imza isteğinizi aldıklarında: E-posta Bildirimi "İncele ve İmzala" düğmesi bulunan bir e-posta alırlar. Kimlik Doğrulama Güvenlik amacıyla e-postalarına tek kullanımlık şifre (OTP) gönderilir. Belge İnceleme Yakınlaştırma ve gezinme özelliğine sahip tam belge önizlemesi Belgeyi İmzalayın Çizim yaparak, yazarak veya resim yükleyerek imza ekleyin. Onay İmzalanmış belgenin kopyasını içeren onay e-postası alın Sık Sorulan Sorular İmzalayan kişi e-postayı almazsa ne olur? Önce spam klasörünü kontrol edin. Orada yoksa, imza isteği durum sayfasından daveti yeniden gönderebilirsiniz. Alıcının adının yanındaki "Yeniden Gönder" düğmesine tıklayın. İmza talebini iptal edebilir miyim? Evet! İmza isteğine gidin ve "İsteği İptal Et" seçeneğine tıklayın. Bu, bekleyen tüm imzalayanlara isteğin iptal edildiğini bildirir. Son başvuru tarihinden sonra ne olacak? Talep otomatik olarak sona erer ve başka imza toplanamaz. Bir bildirim alırsınız ve gerekirse yeni bir son tarihle yeni bir talep oluşturabilirsiniz. İmzalar yasal olarak bağlayıcı mıdır? Evet! Chaindoc imzaları eIDAS (AB), ESIGN Yasası (ABD) ve UETA düzenlemelerine uygundur. Blockchain doğrulaması, belgenin gerçekliği konusunda ek yasal kanıt sağlar. İmzalayanlar imzalamadan önce belgeyi indirebilir mi? Varsayılan olarak, imzalayanlar belgeleri yalnızca çevrimiçi olarak görüntüleyebilir. Gerekirse, gelişmiş ayarlarda "İmzalamadan Önce İndir" seçeneğini etkinleştirebilirsiniz. Sonraki Adımlar Ekip Kurma - Meslektaşlarınızı belgeler üzerinde işbirliği yapmaya davet edin İş Akışları Oluşturun - Tekrarlayan imza süreçlerini otomatikleştirin Şablonları Keşfedin - Yeniden kullanılabilir belge şablonlarıyla zaman kazanın API Entegrasyonu - Chaindoc'u uygulamalarınıza entegre edin Güvenlikle İlgili En İyi Uygulamalar - Uyumluluk ve veri koruması hakkında bilgi edinin Açık ve belirgin belge adları kullanın. Mesaja imzalayanlara bağlam ekleyin Gerçekçi son tarihler belirleyin (en az 7 gün). İş akışını önce kendiniz test edin İmzalayanlar e-postaları almazsa spam klasörlerini kontrol edin Onay iş akışları için sıralı imza kullanın. Daha iyi tamamlama oranları için hatırlatıcıları etkinleştirin

Your First Signature

Güvenlikle İlgili En İyi Uygulamalar Hassas belgeler ve blok zinciri işlemlerini ele alırken güvenlik çok önemlidir. Bu kılavuz, üretim ortamlarında Chaindoc'u dağıtmak ve sürdürmek için gerekli temel güvenlik uygulamalarını özetlemektedir. Kimlik Doğrulama ve Yetkilendirme Çok Faktörlü Kimlik Doğrulama (MFA) Tüm kullanıcı hesapları için, özellikle yöneticiler ve yükseltilmiş ayrıcalıklara sahip kullanıcılar için MFA'yı her zaman etkinleştirin. Chaindoc şunları destekler: Doğrulayıcı uygulamalar aracılığıyla zaman tabanlı tek kullanımlık şifreler (TOTP) SMS tabanlı doğrulama (daha az güvenli, yalnızca gerekli olduğunda kullanın) Donanım güvenlik anahtarları (FIDO2/WebAuthn) Desteklenen cihazlarda biyometrik kimlik doğrulama Güçlü Şifre Politikaları Güçlü şifre gereksinimlerini uygulayın: Karmaşıklık gereksinimleri ile en az 12 karakter Hassas hesaplar için şifrelerin 90 günde bir sona ermesi Şifrelerin tekrar kullanılmasının önlenmesi (son 10 şifre) 5 başarısız giriş denemesinden sonra kilitleme Oluşturma sırasında şifre gücü ölçer Rol Tabanlı Erişim Kontrolü (RBAC) Kullanıcılara yalnızca ihtiyaç duydukları izinleri atayarak en az ayrıcalık ilkesini uygulayın: Net roller tanımlayın: Görüntüleyen, Düzenleyen, Yönetici, Denetçi Belge erişimi için ayrıntılı izinler kullanın Kullanıcı rollerini düzenli olarak denetleyin ve gereksiz erişimleri kaldırın Geçici sözleşmeli çalışanlar için zamana dayalı erişim uygulayın. Kritik işlemler için ayrı görevler (ör. onay iş akışları) Veri Şifreleme Dinlenme Halinde Şifreleme Tüm hassas veriler depolandığında şifrelenmelidir: Belge depolama için AES-256 şifreleme kullanın Veritabanı yedeklemelerini ayrı anahtarlarla şifreleyin Şifreleme anahtarlarını özel bir anahtar yönetim hizmetinde (KMS) saklayın. Şifreleme anahtarlarını üç ayda bir değiştirin. Tüm sunucularda ve iş istasyonlarında tam disk şifrelemesini etkinleştirin. Aktarım Sırasında Şifreleme İletim sırasında verileri koruyun: Tüm bağlantılar için TLS 1.3'ü uygulayın Güçlü şifreleme paketleri kullanın (zayıf şifrelemeleri devre dışı bırakın) Mobil uygulamalar için sertifika sabitleme uygulayın HSTS'yi (HTTP Strict Transport Security) etkinleştirin. Blockchain işlemleri için şifreli kanallar kullanın. Blockchain Güvenliği Özel Anahtar Yönetimi Blockchain özel anahtarları en kritik güvenlik varlıklarıdır: Özel anahtarları asla düz metin veya kod depolarında saklamayın. Üretim anahtarları için donanım güvenlik modülleri (HSM'ler) kullanın. Yüksek değerli işlemler için çoklu imza cüzdanları uygulayın Güvenli çevrimdışı depolama ile önemli yedekleme prosedürleri oluşturun Farklı ortamlar için ayrı anahtarlar kullanın (dev, staging, prod) Akıllı Sözleşme Güvenliği Özel akıllı sözleşmeler kullanıyorsanız: Dağıtımdan önce kapsamlı güvenlik denetimleri gerçekleştirin. Yerleşik kalıpları kullanın ve deneysel kodlardan kaçının Acil durum durdurmaları için devre kesiciler uygulayın Ana ağa dağıtımdan önce test ağlarında kapsamlı testler yapın. Olağandışı işlem modellerini izleyin Blockchain Denetim İzleri Değiştirilemez denetim günlüğü için blok zincirinden yararlanın: Tüm belge durum değişikliklerini zincir üzerinde kaydedin Doğrulama için hassas işlemleri hashleyin Uyumluluk için zaman damgası kanıtları uygulayın Zincir üzerindeki veri bütünlüğünü düzenli olarak kontrol edin. Blockchain işlem makbuzlarını arşivleyin API Güvenliği API Kimlik Doğrulama Tüm API uç noktalarını güvenli hale getirin: Kimlik doğrulama için OAuth 2.0 veya JWT belirteçlerini kullanın Token süresinin dolmasını uygulayın (erişim tokenleri için 15-60 dakika) API anahtarlarını düzenli olarak değiştirin (en az 90 günde bir). Farklı hizmetler için ayrı API anahtarları kullanın. API anahtarlarını asla istemci tarafı kodunda ifşa etmeyin. Hız Sınırlama ve DDoS Koruması Kötüye kullanımı ve hizmet kesintilerini önleyin: API anahtarı ve IP adresi başına hız sınırlaması uygulayın Başarısız istekler için üstel geri çekilme kullanın Web Uygulaması Güvenlik Duvarı (WAF) dağıtın CDN/bulut sağlayıcı düzeyinde DDoS korumasını etkinleştirin Anormal trafik modellerini izleyin Giriş Doğrulama ve Temizleme Enjeksiyon saldırılarına karşı koruma sağlayın: Tüm giriş verilerini katı şemalara göre doğrulayın Kullanıcı tarafından sağlanan içeriği depolamadan/görüntülemeden önce temizleyin. SQL enjeksiyonunu önlemek için parametreli sorgular kullanın. İçerik Güvenliği Politikası (CSP) başlıklarını uygulayın Tüm bağlamlarda (HTML, JavaScript, URL'ler) çıktıyı kaçırın. Altyapı Güvenliği Ağ Segmentasyonu Önemli bileşenleri ayırın: Üretim, hazırlık ve geliştirme ortamlarını ayırın. Hassas hizmetler için VPC'leri ve özel alt ağları kullanın. Veritabanı erişimini yalnızca uygulama sunucularıyla sınırlandırın Varsayılan olarak reddetme ilkeleriyle güvenlik duvarı kuralları uygulayın Yönetimsel erişim için atlama ana bilgisayarları/bastion sunucuları kullanın. Yama Yönetimi Sistemleri güncel tutun: Güvenlik yamalarını yayınlandıktan sonra 48 saat içinde uygulayın. Kırılmayan değişiklikler için bağımlılık güncellemelerini otomatikleştirin Konteyner görüntülerini ve temel işletim sistemini düzenli olarak güncelleyin. Kullanılan tüm teknolojiler için güvenlik uyarılarına abone olun. Üretim dağıtımından önce test yamalarını hazırlık aşamasında test edin Konteyner ve Orkestrasyon Güvenliği Konteynerize dağıtımlar kullanılıyorsa: Minimum temel görüntü kullanın (Alpine, Distroless) Dağıtımdan önce görüntüleri güvenlik açıkları açısından tarayın Konteynerleri root olmayan kullanıcılar olarak çalıştırın Pod güvenlik politikaları/standartlarını uygulayın Gizli bilgi yönetimini kullanın (ortam değişkenlerini değil) Podlar arası trafiği kısıtlamak için ağ ilkelerini etkinleştirin Uyum ve Denetim Yasal Uygunluk İlgili düzenlemelere uyulduğundan emin olun: GDPR: Silme ve veri taşınabilirliği hakkını uygulayın HIPAA: Sağlık verileri için denetim günlüğü ve erişim denetimlerini etkinleştirin. SOC 2: Güvenlik kontrollerini belgelendirin ve yıllık denetimler gerçekleştirin ISO 27001: Bilgi güvenliği yönetim sistemini uygulayın Sektöre özgü düzenlemeler (ör. finansal hizmetler, hukuk) Denetim Günlüğü Güvenlik ve uyumluluk için kapsamlı günlükler tutun: Tüm kimlik doğrulama girişimlerini (başarılı ve başarısız) günlüğe kaydedin. Belge erişimlerini, değişiklikleri ve silme işlemlerini kaydedin. Yönetimsel işlemleri ve yapılandırma değişikliklerini takip edin Günlükleri, kurcalanmaya karşı korumalı, merkezi bir sistemde saklayın. Günlükleri en az 1 yıl (veya yasal gerekliliklere göre) saklayın. Şüpheli etkinlikler için günlük izleme ve uyarı sistemi uygulayın. Düzenli Güvenlik Denetimleri Periyodik güvenlik değerlendirmeleri yapın: Üç ayda bir güvenlik açığı taraması yapın. Üçüncü taraflarca yıllık sızma testleri gerçekleştirin. Erişim denetimlerini ve kullanıcı izinlerini aylık olarak gözden geçirin. Blockchain işlemlerini anormallikler açısından denetleyin Yedekleme ve felaket kurtarma prosedürlerini üç ayda bir test edin. İzleme ve Olaylara Müdahale Güvenlik İzleme Gerçek zamanlı güvenlik izleme uygulayın: SIEM (Güvenlik Bilgisi ve Olay Yönetimi) sistemini devreye alın Başarısız oturum açma girişimleri ve ayrıcalık yükseltme için uyarılar ayarlayın. Olağandışı veri erişim modellerini izleyin API kullanımındaki anormallikleri takip edin Saldırı tespit/önleme sistemleri (IDS/IPS) kullanın. Olay Müdahale Planı Güvenlik olaylarına hazırlıklı olun: Olay müdahale prosedürlerini belgelendirin Eskalasyon yollarını ve iletişim bilgilerini tanımlayın. Yaygın güvenlik senaryoları için çalışma kitapları oluşturun Üç ayda bir masaüstü tatbikatları yapın. İhlaller için iletişim protokolleri oluşturun Adli analiz yeteneklerini koruyun Yedekleme ve Felaket Kurtarma İş sürekliliğini sağlayın: Otomatik günlük yedeklemeler uygulayın Yedeklemeleri coğrafi olarak dağıtılmış konumlarda saklayın Tüm yedekleme verilerini şifreleyin Geri yükleme prosedürlerini aylık olarak test edin. Fidye yazılımlarına karşı koruma için çevrimdışı yedeklemeler yapın. Belge Kurtarma Süresi Hedefi (RTO) ve Kurtarma Noktası Hedefi (RPO) Geliştirme Güvenliği Güvenli Geliştirme Yaşam Döngüsü Güvenliği geliştirmeye entegre edin: Güvenlik odaklı kod incelemeleri gerçekleştirin Statik uygulama güvenliği testi (SAST) araçlarını kullanın. CI/CD boru hattında bağımlılık taraması uygulayın Tüm geliştiriciler için güvenlik eğitimi zorunlu kılın Asla gizli bilgileri sürüm kontrolüne kaydetmeyin. Hassas veri sızıntılarını önlemek için önceden taahhüt kancaları kullanın Üçüncü Taraf Bağımlılıkları Harici kütüphane risklerini yönetin: Bağımlılıkları düzenli olarak en son güvenli sürümlerine güncelleyin Dependabot, Snyk veya npm audit gibi araçları kullanın. Kullanılan paketler için güvenlik uyarılarını inceleyin. Bağımlılık sayısını en aza indirin Paketin bütünlüğünü ve bakımcının itibarını doğrulayın. Kritik bağımlılıkları satıcıya devretmeyi düşünün Kullanıcı Eğitimi ve Bilinçlendirme Güvenlik herkesin sorumluluğundadır: Tüm kullanıcılar için güvenlik bilinci eğitimi düzenleyin. Kimlik avı ve sosyal mühendislik eğitimi verin. Açık güvenlik politikaları ve yönergeleri oluşturun Güvenlik endişeleri için raporlama mekanizmaları oluşturun. Güvenlik açıklarının sorumlu bir şekilde ifşa edilmesini ödüllendirin Güvenlik belgelerini güncel tutun Güvenlik Kontrol Listesi Üretime geçmeden önce bu kontrol listesini kullanın: ✓ Tüm kullanıcı hesapları için MFA etkinleştirildi ✓ Güçlü şifre politikaları uygulanır ✓ En az ayrıcalık ile RBAC uygulandı ✓ Tüm veriler depolandığı ve aktarıldığı sırada şifrelenir ✓ Tüm uç noktalarda TLS 1.3 uygulanır ✓ Özel anahtarlar HSM veya güvenli kasada saklanır ✓ API hız sınırlaması yapılandırıldı ✓ WAF ve DDoS koruması etkinleştirildi ✓ Giriş doğrulama ve temizleme uygulandı ✓ Ağ segmentasyonu doğru şekilde yapılandırılmış ✓ Tüm sistemler yamalı ve güncel ✓ Kapsamlı denetim günlüğü etkinleştirildi ✓ Güvenlik izleme ve uyarı sistemi aktif ✓ Olay müdahale planı belgelenmiş ve test edilmiştir ✓ Otomatik yedeklemeler yapılandırıldı ve test edildi ✓ CI/CD boru hattında güvenlik taraması ✓ Uyumluluk gereklilikleri belgelenmiş ve karşılanmış Ek Kaynaklar Chaindoc güvenliği hakkında daha fazla bilgi için: OWASP En Önemli 10 Web Uygulaması Güvenlik Riski NIST Siber Güvenlik Çerçevesi CIS Güvenlik Ölçütleri Blockchain Güvenliği En İyi Uygulamaları (Consensys) Bulut Güvenliği Birliği Yönergeleri Güvenlik sorunları veya sorularınız için security@chaindoc.com adresinden güvenlik ekibimizle iletişime geçin veya sorumlu açıklama programımız aracılığıyla güvenlik açıklarını bildirin.

Security Best Practices

Chaindoc REST API Referansı Chaindoc'un REST API'sini uygulamalarınıza entegre etmek için eksiksiz referans. Belgeleri, imzaları, blok zinciri doğrulamayı ve gömülü imza iş akışlarını yönetin. Sürüm: 1.0.0 Temel URL: https://api.chaindoc.io/api/v1 Kimlik Doğrulama: API Anahtarı (Taşıyıcı Jetonu) Genel Bakış Chaindoc REST API, belge yönetimi, blok zinciri doğrulama ve dijital imza işlevlerine programlı erişim sağlar. API, sunucu-sunucu entegrasyonu için tasarlanmıştır ve hem genel hem de gizli API anahtarlarını destekler. Temel Özellikler Belge Yönetimi - Blockchain doğrulaması ile belgeleri oluşturun, güncelleyin ve yönetin Dijital İmzalar - Birden fazla taraftan dijital imza isteyin ve toplayın Blockchain Doğrulama - Blockchain ağlarında belgenin gerçekliğini doğrulayın Gömülü Oturumlar - Ön uç imza iş akışları için güvenli oturumlar oluşturun Medya Yükleme - Belge oluşturmak için dosyaları (PDF, resimler, videolar) yükleyin KYC Entegrasyonu - Sumsub ile kimlik verilerini paylaşın ve doğrulayın Kimlik Doğrulama Chaindoc API, kimlik doğrulama için API anahtarları kullanır. Farklı erişim düzeylerine sahip iki tür anahtar vardır. API Anahtar Türleri Genel Anahtar (pk_) - Ön uç uygulamaları ve doğrulama için salt okunur erişim Gizli Anahtar (sk_) - Arka uç sunucuları için tam okuma ve yazma erişimi Müşteri tarafındaki kodda gizli anahtarları asla ifşa etmeyin. Tarayıcılarda salt okunur işlemler için genel anahtarları kullanın Güvenlik için anahtarları düzenli olarak değiştirin Anahtarları ortam değişkenlerinde saklayın API Anahtarlarını Alma İş Planına Abone Olun Yalnızca İş planı kullanıcıları API anahtarları oluşturabilir. API Erişimi'ne gidin Kontrol panelinizde Ayarlar → API Erişimi'ne gidin. API Anahtarı Oluştur API Anahtarı Oluştur düğmesine tıklayın. Güvenli Bir Şekilde Saklayın Gizli anahtarı güvenli bir şekilde saklayın (sadece bir kez gösterilir) API Anahtarlarını Kullanma API anahtarınızı Bearer kimlik doğrulaması ile Yetkilendirme başlığına ekleyin: Hız Sınırlama API uç noktaları, kötüye kullanımı önlemek için hız sınırlamasına tabidir. Hız sınırlamaları, uç nokta türüne göre değişir. Genel uç noktalar: 10 saniyede 3 istek Medya yükleme: 10 saniyede 3 istek OTP doğrulama: 60 saniyede 5 istek Okuma işlemleri: 60 saniyede 10 istek İmza oluşturma: 3 saniyede 20 istek Hız sınırı aşıldığında, 429 Çok Fazla İstek yanıtı alırsınız. Hız sınırı başlıkları yanıtlara dahil edilir: Hata İşleme HTTP Durum Kodları 200 - Başarılı 201 - Kaynak başarıyla oluşturuldu 400 - Hatalı istek (doğrulama hatası) 401 - Yetkisiz (geçersiz veya eksik API anahtarı) 403 - Yasak (yetersiz izinler) 404 - Kaynak bulunamadı 429 - Çok fazla istek (hız sınırı aşıldı) 500 - Dahili sunucu hatası Hata Yanıtı Biçimi Genel API API Anahtar Bilgilerini Alın Mevcut API anahtarı hakkında bilgi alın. Sağlık Kontrolü API bağlantısını ve anahtar geçerliliğini doğrulayın. Belgeler API Belge Oluştur Blockchain doğrulamalı yeni bir belge oluşturun. Durum "yayınlandı" olarak ayarlandığında, belge otomatik olarak blockchain üzerinde doğrulanır. Belgeyi Güncelle Yeni bir sürüm oluşturarak belgeyi güncelleyin. Önceki sürümler denetim izi için saklanır. Belge Erişim Haklarını Güncelle Belge erişim kontrol ayarlarını güncelleyin. Belgeyi Doğrulayın Blockchain kullanarak belgenin gerçekliğini doğrulayın. İşlem hash ve zincir kimliği ile doğrulama durumunu döndürür. Doğrulama Durumunu Alın Bir belge sürümü için blok zinciri doğrulama durumunu alın. İmza API'si İmza İsteği Oluştur Bir veya daha fazla alıcı için imza isteği oluşturun. Ön uç entegrasyonu için gömülü akışı etkinleştirin. İmza Talep Durumunu Al İmza talebinin durumunu kontrol edin ve hangi imzalayanların imzalamayı tamamladığını görün. Belgeyi İmzalayın Belgeyi imzalayın (API anahtarı sahibi imza yetkilisi ise). Kullanıcı İmzalarını Alın Doğrulanmış kullanıcı için tüm imzaları alın. İmza İstekleri Alın Sayfa numaralandırma desteği ile doğrulanmış kullanıcı için tüm imza taleplerini alın. Medya Yükleme API'si Belge oluşturmada kullanmak üzere dosyaları yükleyin. PDF, resim ve videoları destekler. Her istek için en fazla 10 dosya. Belgeler: PDF, DOC, DOCX, XLS, XLSX, PPT, PPTX, TXT Görüntüler: JPG, JPEG, PNG, GIF, WEBP, SVG Videolar: MP4, AVI, MOV, WMV KYC API KYC Verilerini Paylaşın Kimlik doğrulama için KYC (Müşterini Tanı) verilerini alıcılarla paylaşın. Gömülü Oturumlar API'si Ön uç uygulamanızda belge imzalamak için gömülü oturumlar oluşturun. Oturumlar 10 dakika boyunca geçerlidir. 1. Gömülü oturum oluşturun (OTP e-postaya gönderilir) 2. Kullanıcı ön uçta OTP'yi doğrular 3. Ön uç JWT belirtecini alır 4. Gömülü uç noktaları çağırmak için token kullanın

API Documentation

Chaindoc SDK'ları Chaindoc entegrasyonu için resmi SDK'lar. Tam TypeScript desteği, sıfır bağımlılık ve hem arka uç hem de ön uç uygulamaları için çerçeve bağımsız tasarım. Kullanılabilir SDK'lar Sunucu SDK (@chaindoc_io/server-sdk) - Node.js 18+ için arka uç entegrasyonu Embed SDK (@chaindoc_io/embed-sdk) - Web uygulamaları için ön uç imza arayüzü Python SDK - Yakında PHP SDK - Yakında Sunucu SDK Sunucu SDK, Chaindoc API için tür güvenli bir Node.js arayüzü sağlar. Belgeleri yönetmek, imza istekleri oluşturmak, dosya yüklemelerini işlemek ve blok zinciri doğrulamasını arka ucunuza entegre etmek için kullanın. Kurulum Node.js 18 veya üstü (yerel fetch API kullanır) Gizli API anahtarı (sk_live_* veya sk_test_*) Hızlı Başlangıç Express.js Entegrasyonu Next.js API Rotaları Hata İşleme API çağrılarını her zaman try-catch blokları içine alın ve ChaindocError'u özel olarak işleyin: SDK'yı gömün Embed SDK, belge imzalama işlevinin web uygulamalarına sorunsuz bir şekilde entegre edilmesini sağlar. Uygulamanız ve Chaindoc arasında güvenli iletişim ile iframe tabanlı bir imzalama akışını yönetir. Kurulum Sıfır çalışma zamanı bağımlılığı Tam TypeScript desteği Çerçeve bağımsız (React, Vue, Angular, Svelte) Hafif: < 10 KB gzipli Güvenli: kaynak doğrulama ve iframe sanal alanı Temel Kullanım React Entegrasyonu Vue 3 Entegrasyonu Satır İçi Modu Modal yerine, imza arayüzünü doğrudan sayfanıza yerleştirin: Tema Açık veya koyu temalarla görünümü özelleştirin: Tam İş Akışı Örneği İşte Server SDK ve Embed SDK'yı birleştiren eksiksiz bir uçtan uca örnek: Arka Uç: Belge Yükle Sunucu SDK'sını kullanarak dosyayı yükleyin ve belgeyi oluşturun Arka uç: İmza İsteği Oluştur Gömülü akış etkinleştirilmiş imza isteği oluşturun Arka Uç: Oturum Oluşturma Her imzalayan için gömülü oturum oluşturun Ön uç: Embed SDK'yı başlatın SDK'yı genel anahtarla başlatın Ön Uç: Açık İmza Akışı Oturum kimliği ile imza arayüzünü açın Ön Uç: Başarıyı İşleme İmzalanmış belgeyi işleyin ve kullanıcı arayüzünü güncelleyin En İyi Uygulamalar SDK'yı sayfa/bileşen yaşam döngüsü başına bir kez başlatın Bileşen bağlantısı kesildiğinde SDK örneğini her zaman yok edin Tüm geri arama olaylarını (onSuccess, onError, onCancel) işleyin. API anahtarlarını ortam değişkenlerinde saklayın Daha iyi tip güvenliği için TypeScript kullanın ChaindocError ile uygun hata işlemeyi uygulayın. Üretim ortamına dağıtmadan önce sandbox anahtarlarıyla test edin Ortam Yapılandırması Gerçek zamanlı bildirimler için Webhooks belgelerini kontrol edin. Tam uç nokta belgeleri için REST API referansını okuyun. GitHub deposunda çerçeveye özgü örnekleri inceleyin.

SDKs

Chaindoc Webhooks Chaindoc hesabınızda olaylar meydana geldiğinde gerçek zamanlı bildirimler alın. Webhooks, olay verilerini anında sunucunuza aktarır ve böylece yoklama ihtiyacını ortadan kaldırır. İş Planı aboneliği (yalnızca İş Planı kullanıcıları webhook'ları yapılandırabilir) Sunucunuzdaki HTTPS uç noktası Halka açık URL (webhook'lar localhost'a gönderilemez) Genel Bakış Chaindoc Webhooks, hesabınızda bir olay meydana geldiğinde uygulamanızın gerçek zamanlı bildirimler almasını sağlar. API'yi sorgulamak yerine, webhooks bir eylem gerçekleştiğinde olay verilerini sunucunuza aktarır. Temel Özellikler Gerçek Zamanlı Bildirimler - Sunucunuza anında olay teslimi Otomatik Yeniden Denemeler - Üstel geri çekilme ile en fazla 3 yeniden deneme İmza Doğrulama - Yükün gerçekliği için HMAC SHA256 Etkinlik Filtreleme - Yalnızca ilgilendiğiniz etkinlikleri alın Hata Takibi - Webhook teslimat durumunu ve hatalarını izleyin Kullanım Örnekleri Belgeler imzalandığında e-posta bildirimleri gönderin Belgeler blok zincirinde doğrulandığında iş akışlarını tetikleyin İmza talepleri oluşturulduğunda veritabanınızı güncelleyin Belge durumunu harici sistemlerle senkronize edin Denetim izi ve uyumluluk günlüğü Kurulum Adım 1: API Anahtarı Oluşturun Chaindoc kontrol panelinizde Ayarlar → API Erişimi'ne gidin ve webhook yapılandırması etkinleştirilmiş bir API anahtarı oluşturun. Adım 2: Webhook URL'sini yapılandırın API'yi kullanarak webhook uç noktanızı yapılandırın: Adım 3: Webhook Uç Noktasını Uygulayın Webhook olaylarını almak için sunucunuzda bir uç nokta oluşturun. İşte farklı dillerde örnekler: Etkinlik Türleri Chaindoc, aşağıdaki olaylar için webhook'lar gönderir: document.created API aracılığıyla yeni bir belge oluşturulduğunda tetiklenir. document.verified Bir belge blok zincirinde başarıyla doğrulandığında tetiklenir. belge.imzalı Gerekli tüm imzalar toplandığında tetiklenir. signature.request.created Yeni imza isteği oluşturulduğunda tetiklenir. signature.request.completed Tüm imzalayanlar imzalarını tamamladığında tetiklenir. signature.request.rejected İmzalayan kişi imza talebini reddettiğinde tetiklenir. Güvenlik İmza Doğrulama Chaindoc, HMAC SHA256 kullanarak tüm webhook yüklerini imzalar. Orijinalliği sağlamak ve tekrar saldırılarını önlemek için imzaları her zaman doğrulayın. Her zaman zamanlama açısından güvenli karşılaştırma işlevleri kullanın. Üretimde imza doğrulamasını asla atlamayın. Webhook gizliliğinizi güvende tutun Gizli bilgileri periyodik olarak değiştirin Yalnızca HTTPS uç noktalarını kullanın İmza Doğrulama Nasıl Çalışır? Chaindoc İmza Oluşturur Chaindoc, webhook gizli anahtarınızı kullanarak HMAC imzası oluşturur. Başlıkta Gönderilen İmza İmza, X-Webhook-Signature başlığında gönderilir. Sunucunuz Doğrular Sunucunuz imzayı yeniden hesaplar ve zamanlama güvenli işlev kullanarak karşılaştırır. Yeniden Deneme Mantığı Chaindoc, başarısız webhook teslimatlarını üstel geri çekilme ile otomatik olarak yeniden dener. 1. yeniden deneme: 1 dakika sonra 2. deneme: 5 dakika sonra (toplam: 6 dakika) 3. deneme: 15 dakika sonra (toplam: 21 dakika) Uç noktanız HTTP durum kodu 200-299 döndürüyor Uç noktanız 30 saniye içinde yanıt verir Teslimat sırasında ağ hatası oluşmaz Webhook'ları Test Etme Yerel Geliştirme Webhook testi için yerel sunucunuzu açığa çıkarmak için ngrok gibi araçlar kullanın: Manuel Test Webhook uç noktanızı örnek bir yük ile test edin: En İyi Uygulamalar İşleme başlamadan önce her zaman webhook imzalarını doğrulayın. Zaman aşımını önlemek için hızlı yanıt verin (30 saniye içinde). Webhook'ları bir kuyrukta eşzamansız olarak işleyin Yinelenen olayları işlemek için idempotensi uygulayın Hata ayıklama ve denetim için tüm webhook olaylarını kaydedin Kontrol panelinizde webhook teslimat hatalarını izleyin Güvenlik için HTTPS uç noktaları kullanın Tüm olay türlerini nazikçe işleyin (bilinmeyen olayları yok sayın) Tam Örnek İşte veritabanı entegrasyonuna sahip, üretime hazır bir webhook işleyicisi: Chaindoc kontrol panelinde webhook URL'nizi yapılandırın Geliştirme sırasında ngrok ile test edin Günlüklerinizde webhook teslimatını izleyin Başarısız teslimatlar için uyarılar ayarlayın

Webhooks

Değişiklik günlüğü Chaindoc platformundaki güncellemeler, yeni özellikler, iyileştirmeler ve hata düzeltmeleri hakkında bilgi sahibi olun. Entegrasyonunuzu güncel tutmak için her sürümü takip edin. Önemli sürümler: Çeyrek yılda bir, önemli değişiklikler ve yeni özellikler ile Küçük sürümler: Geriye dönük uyumlu iyileştirmelerle aylık olarak yayınlanır. Yama sürümleri: Hata düzeltmeleri ve performans iyileştirmeleri ile haftalık olarak yayınlanır. Güvenlik güncellemeleri: Gerektiğinde derhal dağıtım Sürüm 1.0.0 - Aralık 2025 Kararlı API ile resmi v1.0.0 sürümü Tam TypeScript desteğine sahip, üretime hazır SDK'lar Belgeleri ve geliştirici kılavuzlarını tamamlayın. Kurumsal düzeyde güvenlik ve uyumluluk Yeni Özellikler 🎉 Sunucu SDK (@chaindoc_io/server-sdk) - Otomatik yeniden deneme özelliğine sahip resmi Node.js SDK 🎉 Embed SDK (@chaindoc_io/embed-sdk) - React, Vue, Angular için ön uç imza arayüzü 🎉 Webhooks - HMAC imza doğrulamalı gerçek zamanlı olay bildirimleri 🎉 Gömülü İmzalama Akışı - Uygulamanızda sorunsuz imzalama deneyimi 🎉 KYC Entegrasyonu - Sumsub ile kimlik doğrulama 🎉 Erişim Kontrolü - Rol tabanlı ve e-posta tabanlı erişim ile ayrıntılı izinler ✨ Çoklu zincir desteği - Ethereum, Polygon, BSC, Arbitrum blok zinciri doğrulama ✨ Toplu İşlemler - Birden fazla belgeyi verimli bir şekilde yükleyin ve işleyin ✨ Gelişmiş Arama - Hashtag'ler ve meta veri filtreleme ile tam metin arama API İyileştirmeleri Ayrıntılı başlıklarla hız sınırlama (X-RateLimit-*) Alan düzeyinde doğrulama ayrıntılarıyla iyileştirilmiş hata yanıtları Tüm liste uç noktaları için sayfa numaralandırma desteği İzleme için sağlık kontrolü uç noktası Kullanım istatistikleri ile API anahtar yönetimi SDK Özellikleri IntelliSense desteği ile tam TypeScript tanımları Üstel geri çekilme ile otomatik yeniden deneme mantığı Embed SDK için sıfır çalışma zamanı bağımlılığı Çerçeve bağımsız tasarım (React, Vue, Angular, Svelte) Geliştirme sorunlarını gidermek için hata ayıklama modu Güvenlik İyileştirmeleri HMAC SHA256 webhook imza doğrulaması Sıfır kesinti süresi ile API anahtarı rotasyonu API erişimi için IP beyaz listeye alma Kontrol paneli için iki faktörlü kimlik doğrulama (2FA) SOC 2 Tip II uyumluluk sertifikası Belgeler Tüm uç noktalarla birlikte eksiksiz REST API referansı Çerçeve örnekleri içeren SDK belgeleri Kod örnekleri içeren webhooks kurulum kılavuzu Entegrasyon modelleri ve en iyi uygulamalar Sorun giderme kılavuzları ve SSS Yakında Eklenecek Özellikler Arka uç entegrasyonu için Python SDK Eski sistem entegrasyonu için PHP SDK Mobil SDK'lar (iOS ve Android) Gelişmiş şablon sistemi Toplu imza talepleri İmza arayüzü için özel markalama Gelişmiş analiz panosu Sürümler için GitHub depomuzu takip edin. Geliştirici bültenine abone olun Duyurular için Discord topluluğuna katılın

Changelog

Chaindoc platformundaki güncellemeler, yeni özellikler, iyileştirmeler ve hata düzeltmeleri hakkında bilgi sahibi olun. Entegrasyonunuzu güncel tutmak için her sürümü takip edin.