توقيع
مكون Documentize PDF Security for .NET يتيح للمستخدمين التوقيع الرقمي على مستندات PDF. يوفر عملية مبسطة لإضافة التوقيعات، وضمان الأصالة، وتأمين محتوى PDF. يدعم المكون كلًا من التوقيعات المرئية وغير المرئية ويقدم خيارات لتخصيص موضع التوقيع، السبب، معلومات الاتصال، وأكثر من ذلك.
كيفية توقيع مستندات PDF
لتوقيع مستند PDF باستخدام ملف PFX، اتبع الخطوات التالية:
- أنشئ كائن من الفئة
SignOptionsمع مسار ملف PFX وكلمة المرور. - أضف ملف PDF الإدخال وملف الإخراج إلى الخيارات.
- نفّذ طريقة
Signلتطبيق التوقيع.
1// Create SignOptions object to set instructions
2var options = new SignOptions("path_to_your_pfx_file.pfx", "password_of_your_pfx_file");
3// Add input file path
4options.AddInput(new FileData("path_to_your_pdf_file.pdf"));
5// Set output file path
6options.AddOutput(new FileData("path_to_result_pdf_file.pdf"));
7// Perform the process
8PdfSecurity.Sign(options);كيفية استخدام Stream لملف PFX
يمكنك أيضًا توقيع PDF باستخدام شهادة PFX مقدمة كـ stream بدلاً من مسار ملف. يتيح ذلك مرونة أكبر في التعامل مع تخزين الشهادة.
1using var pfxStream = File.OpenRead(@"path_to_your_pfx_file.pfx");
2var options = new SignOptions(pfxStream, "password_of_your_pfx_file");
3options.AddInput(new FileData("path_to_your_pdf_file.pdf"));
4options.AddOutput(new FileData("path_to_result_pdf_file.pdf"));
5// Perform the process
6PdfSecurity.Sign(options);كيفية تطبيق التوقيعات غير المرئية
لإضافة توقيع غير مرئي (يؤمّن المستند دون عرض التوقيع على المستند)، ببساطة عيّن الخاصية Visible إلى false.
- أنشئ مثيلًا من
SignOptions. - عيّن
Visibleإلىfalse. - أضف ملفات الإدخال والإخراج.
- استدعِ
Signلتطبيق التوقيع غير المرئي.
1var options = new SignOptions("path_to_your_pfx_file.pfx", "password_of_your_pfx_file");
2options.AddInput(new FileData("path_to_your_pdf_file.pdf"));
3options.AddOutput(new FileData("path_to_result_pdf_file.pdf"));
4// Configure invisible signature
5signOptions.Visible = false;
6// Perform the process
7PdfSecurity.Sign(options);كيفية استخدام خيارات إضافية لتوقيع مستندات PDF
يمكنك استخدام خيارات إضافية عند إضافة توقيع إلى ملف PFX مثل السبب، جهة الاتصال، الموقع، رقم الصفحة.
- أنشئ كائنًا من الفئة
SignOptionsمع مسار ملف PFX وكلمة المرور. - أضف ملف PDF الإدخال وملف الإخراج إلى الخيارات.
- عيّن القيم للخيارات التي تريدها.
- نفّذ طريقة
Signلتطبيق التوقيع.
1// Create SignOptions object to set instructions
2var options = new SignOptions("path_to_your_pfx_file.pfx", "password_of_your_pfx_file");
3// Add input file path
4options.AddInput(new FileData("path_to_your_pdf_file.pdf"));
5// Set output file path
6options.AddOutput(new FileData("path_to_result_pdf_file.pdf"));
7// Optional parameters
8options.Reason = "my Reason";
9options.Contact = "my Contact";
10options.Location = "my Location";
11options.PageNumber = 3;
12// Perform the process
13PdfSecurity.Sign(options);كيفية إضافة طابع زمني إلى PDF
لإضافة طابع زمني آمن إلى مستند PDF، اتبع الخطوات التالية:
- أنشئ مثيلًا من
AddTimestampOptionsلتهيئة عملية الطابع الزمني. - أضف ملف PDF الإدخال باستخدام طريقة
AddInput. - عيّن مسار ملف الإخراج باستخدام
AddOutput. - نفّذ عملية الطابع الزمني باستخدام طريقة
Sign.
1// Create SignOptions object to set instructions
2var options = new SignOptions("path_to_your_pfx_file.pfx", "password_for_your_pfx_file");
3options.TimestampOptions = new TimestampOptions("server_url");
4// Add input file path
5options.AddInput(new FileData("path_to_your_pdf_file.pdf"));
6// Set output file path
7options.AddOutput(new FileData("path_to_result_pdf_file.pdf"));
8// Perform the process
9PdfSecurity.Sign(options);كيفية استخدام مصادقة مخصصة مع خادم الطابع الزمني
يمكنك توفير بيانات اعتماد المصادقة الأساسية عند الاتصال بخادم الطابع الزمني. يتيح لك ذلك المصادقة مع الخوادم التي تتطلب اسم مستخدم وكلمة مرور.
1// Configure the timestamping options with authentication
2options.TimestampOptions = new TimestampOptions("timestamp_server_url", "username:password");الميزات الرئيسية:
- التوقيع الرقمي على مستندات PDF: أمّن مستنداتك بتوقيعات رقمية مرئية أو غير مرئية.
- دعم PFX: وقّع ملفات PDF باستخدام شهادة PFX.
- خيارات قابلة للتخصيص: اضبط إعدادات التوقيع مثل السبب، الموقع، وتفاصيل الاتصال.
- توقيعات مرئية وغير مرئية: اختر ما إذا كان التوقيع يظهر على المستند.
- خوادم طابع زمني مخصصة: استخدم عناوين URL لخوادم الطابع الزمني ومعلومات المصادقة.