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