يعد التوقيع الرقمي مخططًا جديرًا بالثقة للتحقق من صحة مستنداتك. غالبًا ما تستخدم التوقيعات الرقمية لتنفيذ التوقيعات الإلكترونية. في هذه المقالة ، ستتعلم كيفية توقيع مستندات PDF و Word إلكترونيًا باستخدام الشهادات الرقمية باستخدام C #.
.NET API للتوقيعات الرقمية والشهادات
لتوقيع المستندات بالشهادة الرقمية ، سأستخدم GroupDocs.Signature for .NET API في أمثلة C # من هذه المقالة. بالإضافة إلى توقيع مستندات PDF ، تدعم واجهة برمجة التطبيقات هذه التوقيعات الرقمية لوثائق معالجة الكلمات وتنسيقات جداول البيانات.
قم بتنزيل مثبت DLL أو MSI من قسم التنزيلات أو قم بتثبيت API في تطبيق .NET عبر NuGet.
PM> Install-Package GroupDocs.Signature
توقيع PDF بشهادة رقمية في C
بعد إعداد البيئة ، أنت على بعد أسطر قليلة من التوقيع الناجح لمستنداتك. اتبع الخطوات التالية لتوقيع المستند الخاص بك بالشهادة الرقمية المتاحة باستخدام C #.
- قم بتهيئة كائن التوقيع بالمستند المراد توقيعه.
- قم بتهيئة كائن DigitalSignOptions بملف الشهادة.
- قم بتعيين خيارات التوقيع المطلوبة مثل كلمة المرور والموقع.
- استدعاء تسجيل طريقة لتوقيع الوثيقة مع الشهادة الرقمية.
يوقع مثال الكود التالي على مستندات PDF بالشهادة الموجودة في C #.
// توقيع PDF بشهادة رقمية في C #
using (Signature signature = new Signature("document.pdf"))
{
DigitalSignOptions options = new DigitalSignOptions("certificate.pfx");
{
ImageFilePath = "sampleImage.jpg", // Optional - Set image file path
Left = 50, // Set signature position
Top = 50,
Password = "GroupDocs" // Set Password
};
signature.Sign("signedDocument.pdf", options);
}
قم بالتوقيع باستخدام التوقيع الرقمي باستخدام المظهر المخصص في C
يمكن تخصيص التوقيع الرقمي للحصول على عروض تقديمية مختلفة. للحصول على المظهر المخصص ، يمكن تخصيص الخيارات التالية باستخدام فئة PdfDigitalSignatureAppearance.
- خلفية
- معلومات الاتصال
- تاريخ التوقيع في
- التوقيع الرقمي
- موقع
- سبب
- خط العائلة
- حجم الخط
علاوة على ذلك ، يمكنك تغيير الخصائص التالية:
- ارتفاع
- عرض
- نمط الحدود
- إظهار في كل الصفحات أم لا
في المثال التالي ، أستخدم جميع الخصائص المذكورة أعلاه تقريبًا. يخصص هذا المثال مظهر التوقيع الرقمي في مستند PDF باستخدام C #.
// قم بتوقيع ملف PDF بشهادة رقمية في C # بمظهر وإعداد مخصصين
using (Signature signature = new Signature("document.pdf"))
{
DigitalSignOptions options = new DigitalSignOptions("certificate.pfx")
{
Password = "GroupDocs",
// تفاصيل الشهادة الرقمية
Reason = "Approved",
Location = "New York",
// مظهر توقيع PDF مخصص
Appearance = new PdfDigitalSignatureAppearance()
{
// لا تظهر تفاصيل الاتصال
ContactInfoLabel = string.Empty,
// تبسيط تسمية السبب
ReasonLabel = "?",
// تغيير تسمية الموقع
LocationLabel = "From",
DigitalSignedLabel = "By",
DateSignedAtLabel = "On",
Background = Color.Red
},
AllPages = true,
Width = 160,
Height = 80,
// تعيين حدود التوقيع
Border = new Border()
{
Visible = true,
Color = Color.Red,
DashStyle = DashStyle.DashDot,
Weight = 2
}
};
SignResult signResult = signature.Sign("signedDocument.pdf", options);
}
توقيع Word Docs بشهادة رقمية في C
وبالمثل ، يمكنك توقيع مستندات Word باستخدام الشهادة. ما عليك سوى توفير المستند الصحيح عند البدء في تهيئة كائن التوقيع.
- قم بتهيئة الكائن التوقيع باستخدام مستند Word للتوقيع.
- قم بتهيئة كائن DigitalSignOptions بملف الشهادة.
- اضبط خيارات التوقيع مثل كلمة المرور والموقع.
- قم بتوقيع المستند بالشهادة الرقمية باستخدام طريقة Sign.
يوقع المثال على مستندات Word باستخدام الشهادة الموجودة في C #.
// قم بتوقيع مستند Word بشهادة رقمية في C #
using (Signature signature = new Signature("document.docx"))
{
DigitalSignOptions options = new DigitalSignOptions("certificate.pfx");
{
ImageFilePath = "sampleImage.jpg", // Optional - Set image file path
Left = 50, // Set signature position
Top = 50,
Password = "GroupDocs" // Set Password
};
signature.Sign("signedDocument.docx", options);
}
استنتاج
في هذه المقالة ، تعلمت التوقيع إلكترونيًا على مستندات PDF و Word باستخدام الشهادة الرقمية باستخدام C #. علاوة على ذلك ، يمكنك بسهولة تخصيص مظهر التوقيع. يمكنك الآن محاولة إنشاء تطبيق .NET الخاص بك لتوقيع مستندات PDF و Word بشهادات رقمية لها مظهر مخصص في C #.
روابط سريعة لمزيد من المعلومات حول Signature API
- أمثلة على GitHub
- دليل المطور والوثائق
- المنتدى for Quick Support