التوقيع في Excel

أضف توقيعًا رقميًا في Excel (XLS ، XLSX) باستخدام C# .NET

في العصر الرقمي اليوم ، أصبح أمان المستندات أولوية قصوى للأفراد والمؤسسات على حدٍ سواء. مع الاعتماد المتزايد على المستندات الإلكترونية ، من المهم التأكد من أن الملفات التي نشاركها أصلية ولم يتم العبث بها. يعد Excel أحد هذه الأدوات التي تُستخدم على نطاق واسع لتخزين البيانات المهمة ومشاركتها ، مما يجعل وجود طريقة موثوقة للتحقق من سلامة الملف أمرًا بالغ الأهمية. هذا هو المكان الذي تأتي فيه التوقيعات الرقمية - فهي توفر طريقة آمنة للتوقيع والتحقق من صحة المستندات الإلكترونية ، مما يضمن عدم تغيير الملف منذ توقيعه. في هذه المقالة ، سوف نستكشف كيفية توقيع ملفات Excel رقميًا باستخدام C# .NET.

API لتوقيع Excel رقميا

Aspose.Cells Cloud SDK for .NET هي واجهة برمجة تطبيقات قوية توفر مجموعة من الميزات للعمل مع ملفات Excel في السحابة. تتمثل إحدى إمكانياته الرئيسية في القدرة على توقيع ملفات Excel رقميًا ، مما يوفر طريقة آمنة للمصادقة والتحقق من المستندات الإلكترونية. باستخدام Aspose.Cells Cloud SDK ، يمكن للمستخدمين بسهولة توقيع ملفات Excel الخاصة بهم باستخدام مجموعة من أنواع التوقيع بما في ذلك الشهادات الرقمية). دعنا نستكشف إمكانيات واجهة برمجة التطبيقات ونضمن سلامة وصحة المستندات الإلكترونية.

للبدء ، ابحث عن Aspose.Cells-Cloud في مدير حزم NuGet وانقر على زر “إضافة حزمة”. أيضًا ، إذا لم يكن لديك حساب في Dashboard ، فالرجاء إنشاء حساب مجاني باستخدام عنوان بريد إلكتروني صالح.

إضافة التوقيع الإلكتروني باستخدام C#

الرجاء استخدام مقتطف الشفرة التالي لتوقيع ملفات Excel رقميًا.

// للحصول على أمثلة كاملة وملفات البيانات ، يرجى الانتقال إلى 
https://github.com/aspose-cells-cloud/aspose-cells-cloud-dotnet/

// احصل على بيانات اعتماد العميل من https://dashboard.aspose.cloud/
string clientSecret = "4d84d5f6584160cbd91dba1fe145db14";
string clientID = "bb959721-5780-4be6-be35-ff5c3a6aa4a2";
        
// إنشاء مثيل CellsApi أثناء تمرير ClientID و ClientSecret
CellsApi cellsInstance = new CellsApi(clientID, clientSecret);

// أول مصنف Excel على محرك الأقراص
string input_Excel = "source.xlsx";
// اسم الشهادة الرقمية
string signature_File = "test1234.pfx";

try
{
    // قراءة ملف Excel وتحميله إلى التخزين السحابي
    cellsInstance.UploadFile(input_Excel, File.OpenRead(input_Excel));
    
    // قراءة الشهادة الرقمية وتحميلها إلى التخزين السحابي
    cellsInstance.UploadFile(signature_File, File.OpenRead(signature_File));

    // تهيئة عملية التوقيع الرقمي
    var response = cellsInstance.CellsWorkbookPostDigitalSignature(input_Excel, signature_File, "test1234");

    // اطبع رسالة نجاح إذا نجح التسلسل
    if (response != null && response.Equals("OK"))
    {
        Console.WriteLine("Digital Signature added successfully !");
        Console.ReadKey();
    }
}
catch (Exception ex)
{
    Console.WriteLine("error:" + ex.Message + "\n" + ex.StackTrace);
}

فيما يلي تفاصيل حول مقتطف الشفرة:

CellsApi cellsInstance = new CellsApi(clientID, clientSecret);

قم بإنشاء كائن CellsApi أثناء تمرير بيانات اعتماد العميل كوسائط.

cellsInstance.UploadFile(input_Excel, File.OpenRead(input_Excel));    
cellsInstance.UploadFile(signature_File, File.OpenRead(signature_File));

اقرأ محتوى إدخال Excel والتوقيع الرقمي من محرك الأقراص المحلي وقم بتحميله على التخزين السحابي.

var response = cellsInstance.CellsWorkbookPostDigitalSignature(input_Excel, signature_File, "test1234");

اتصل بواجهة برمجة التطبيقات للتوقيع رقميًا على Excel وحفظ المخرجات في التخزين السحابي. يرجى ملاحظة أن الوسيطة الأخيرة هي كلمة مرور ملف الشهادة.

يمكن تنزيل ملف Excel المستخدم في المثال أعلاه من [myDocument.xlsx] (https://github.com/aspose-cells-cloud/aspose-cells-cloud-dotnet/blob/master/TestData/myDocument.xlsx).

أضف توقيع Excel الرقمي باستخدام أوامر cURL

هناك العديد من الفوائد لاستخدام الأمر cURL و Aspose.Cells Cloud API للتوقيع الرقمي في Excel. هذا الأسلوب فعال وسهل الاستخدام ، مما يسمح لك بتوقيع ملفات Excel الخاصة بك مع عدد قليل من طلبات API. يوفر هذا الوقت والجهد عند مقارنته بالتوقيع اليدوي لكل مستند. ثانيًا ، نظرًا لأن هذا النهج يعتمد على السحابة ، فيمكنك الوصول إليه من أي مكان ودمجه في مهام سير العمل الحالية بسهولة. بشكل عام ، يعد استخدام الأمر cURL و Aspose.Cells Cloud API للتوقيع الرقمي في Excel حلاً قويًا ومرنًا. إنه يبسط عملية التوقيع ويعزز أمان وموثوقية ملفات Excel الخاصة بك.

الآن ، ستحتاج إلى تثبيت cURL على نظامك ثم إنشاء accessToken بناءً على بيانات اعتماد العميل:

curl -v "https://api.aspose.cloud/connect/token" \
-X POST \
-d "grant_type=client_credentials&client_id=bb959721-5780-4be6-be35-ff5c3a6aa4a2&client_secret=4d84d5f6584160cbd91dba1fe145db14" \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Accept: application/json"

استخدم الأمر التالي لتحميل Excel والإدخال الرقمي للتخزين السحابي (تحتاج إلى استدعاء هذا الأمر مرتين لتحميل ملف فردي):

curl -v "https://api.aspose.cloud/v3.0/cells/storage/file/{filePath}" \
-X PUT \
-F file=@{localFilePath} \
-H "Content-Type: multipart/form-data" \
-H "Authorization: Bearer {accessToken}"

استبدل “{filePath}” بالمسار الذي تريد تخزين الملف فيه في التخزين السحابي ، و “{localFilePath}” بمسار Excel على نظامك المحلي ، و “{accessToken}” برمز الوصول إلى Aspose Cloud (تم إنشاؤه أعلاه).

أخيرًا ، قم بتنفيذ الأمر التالي لإضافة توقيع رقمي إلى ملف Excel:

curl -v "https://api.aspose.cloud/v3.0/cells/{excelName}/digitalsignature?digitalsignaturefile={DigitalSignature}&password=test1234" \
-X POST \
-H  "accept: application/json" \
-H  "authorization: Bearer {accessToken}"

استبدل “{excelName}” باسم ملف Excel في التخزين السحابي ، و “{DigitalSignature}” باسم الشهادة الرقمية من التخزين السحابي ، و “{accessToken}” برمز الوصول الذي تم إنشاؤه أعلاه. بعد التنفيذ الناجح ، سيتم تخزين Excel المحدث في نفس التخزين السحابي.

ملاحظات ختامية

في الختام ، يعد التوقيع الرقمي في Excel جانبًا مهمًا لضمان مصداقية جداول البيانات الخاصة بك وسلامتها. لذلك يوفر الأمر cURL و Aspose.Cells Cloud API طريقة آمنة وموثوقة لتوقيع ملفات Excel الخاصة بك برمجيًا ، مما يوفر لك الوقت والجهد مع تعزيز أمان وموثوقية بياناتك. باستخدام Aspose.Cells Cloud ، يمكنك تخصيص عملية التوقيع وفقًا لمتطلباتك المحددة ، سواء كان ذلك تحديد الموقع أو إعداد الحماية بكلمة مرور أو خيارات أخرى. بشكل عام ، يعد هذا الأسلوب لإضافة توقيع رقمي في Excel حلاً فعالاً ومرنًا وآمنًا يبسط سير عملك ويمنحك راحة البال مع العلم أن ملفات Excel الخاصة بك جديرة بالثقة ودقيقة.

روابط مفيدة

مقالات مقترحة

يرجى زيارة الروابط التالية لمعرفة المزيد حول: