حماية وإلغاء حماية باستخدام Node.js عبر C++

غالبًا ما تخزن مصنفات Excel معلومات مالية أو تجارية أو شخصية حساسة يجب حمايتها من الوصول غير المصرح به. يوفر Aspose.Cells for Node.js via C++ مجموعة شاملة من ميزات الحماية التي تعكس إمكانيات Microsoft Excel، مما يتيح لك تأمين بياناتك على مستوى الملف، ومستوى المصنف، ومستوى ورقة العمل.

تشفير وفك تشفير ملفات Excel

تمنع كلمة المرور المعيّنة على ملف Excel المستخدمين غير المصرح لهم من فتح محتوى المصنف أو عرضه. لتشفير مصنف، قم بتعيين سلسلة نصية لكلمة المرور في workbook.getSettings().setPassword() ثم احفظ المصنف. يكتب Aspose.Cells الملف في شكل مشفر. لفتح مصنف مشفر لفك التشفير، قم بإنشاء كائن LoadOptions، وعيّن loadOptions.setPassword() على نفس كلمة المرور المستخدمة أثناء التشفير، ومرّرها إلى مُنشئ Workbook. يطبّق Aspose.Cells كلمة المرور المقدمة بشفافية بحيث يمكن لبقية الكود الخاص بك التفاعل مع المحتوى الذي تم فك تشفيره كما لو كان الملف مصنفًا عاديًا.

const AsposeCells = require("aspose.cells.node");
let workbook = new AsposeCells.Workbook();
let sheet = workbook.getWorksheets().get(0);
let cell = sheet.getCells().get("A1");
cell.putValue("Confidential Data");
workbook.getSettings().setPassword("OpenPassword123");
workbook.save("encrypted.xlsx");
let loadOptions = new AsposeCells.LoadOptions();
loadOptions.setPassword("OpenPassword123");
let decryptedWorkbook = new AsposeCells.Workbook("encrypted.xlsx", loadOptions);
console.log("Decrypted cell A1 value: " + decryptedWorkbook.getWorksheets().get(0).getCells().get("A1").getStringValue());

حماية القراءة فقط (كلمة مرور للتعديل)

يدعم Excel طبقيتين متميزتين من كلمات المرور. الأولى هي كلمة مرور الفتح، التي تُشفّر الملف نفسه ومشروحة في القسم السابق. الثانية هي كلمة مرور التعديل، التي لا تمنع المستخدمين من فتح المصنف؛ وبدلاً من ذلك، يوصي Excel بفتح الملف في وضع القراءة فقط ما لم يتم توفير كلمة مرور التعديل. يمكنك تكوين هذا السلوك في Aspose.Cells من خلال workbook.getSettings().getWriteProtection(). عيّن خاصية password على كلمة مرور التعديل وخاصية author لتحديد من قام بتطبيق الحماية. استخدم الطريقة writeProtection.validatePassword(string) للتحقق مما إذا كانت كلمة مرور التعديل المقدمة صحيحة، حيث تُرجع true عند التطابق وfalse خلاف ذلك.

const AsposeCells = require("aspose.cells.node");
let workbook = new AsposeCells.Workbook();
// كتابة قيمة تجريبية في الخلية A1 من ورقة العمل الأولى
workbook.getWorksheets().get(0).getCells().get("A1").putValue("Sample Data");
// تكوين حماية الكتابة: تعيين كلمة مرور التعديل واسم المؤلف
workbook.getSettings().getWriteProtection().setPassword("ModifyPwd");
workbook.getSettings().getWriteProtection().setAuthor("AuthorName");
// حفظ المصنف بحيث يتم الاحتفاظ بحماية الكتابة
workbook.save("WriteProtectedWorkbook.xlsx");
// التحقق من صحة كلمة مرور التعديل باستخدام كلمة المرور الصحيحة
let isCorrectValid = workbook.getSettings().getWriteProtection().validatePassword("ModifyPwd");
console.log("ValidatePassword(\"ModifyPwd\") returned: " + isCorrectValid);
// التحقق من صحة كلمة مرور التعديل باستخدام كلمة مرور خاطئة لتوضيح الفرع الآخر
let isWrongValid = workbook.getSettings().getWriteProtection().validatePassword("WrongPwd");
console.log("ValidatePassword(\"WrongPwd\") returned: " + isWrongValid);

حماية وإلغاء حماية بنية المصنف

تمنع حماية بنية المصنف المستخدمين الآخرين من عرض أوراق العمل المخفية، أو إضافة أوراق عمل جديدة، أو نقل أوراق العمل، أو حذف أوراق العمل، أو إخفاء أوراق العمل، أو إعادة تسمية أوراق العمل. تنطبق حالة الحماية على بنية الورقة بدلاً من محتويات الخلايا داخل أي ورقة. لتطبيق حماية البنية، استدعِ workbook.protect(ProtectionType.Structure, "password"). لإلغاء الحماية، استدعِ workbook.unprotect("password") وقم بتوفير كلمة المرور الصحيحة. تُستخدم قيمة التعداد ProtectionType.Structure هنا وتختلف عن أنواع الحماية الأخرى مثل ProtectionType.Windows.

const AsposeCells = require("aspose.cells.node");
let workbook = new AsposeCells.Workbook();
// إضافة ورقة عمل ثانية
workbook.getWorksheets().add();
// كتابة قيمة عينة في الخلية A1 من ورقة العمل الأولى
workbook.getWorksheets().get(0).getCells().get(0, 0).putValue("Sample Data");
// حماية بنية المصنف
workbook.protect(AsposeCells.ProtectionType.Structure, "StructPwd");
// حفظ المصنف باسم structure_protected.xlsx
let filePath = "structure_protected.xlsx";
workbook.save(filePath);
// إعادة تحميل الملف في نسخة Workbook جديدة
let loadedWorkbook = new AsposeCells.Workbook(filePath);
// إلغاء حماية البنية
loadedWorkbook.unprotect("StructPwd");
// طباعة رسالة التأكيد
console.log("Structure protection has been successfully removed from the workbook.");

حماية وإلغاء حماية أوراق العمل

تقفل حماية ورقة العمل خلايا ورقة العمل ضد التغييرات العرضية أو المتعمدة. لا يمكن للمستخدمين تحرير الخلايا المقفلة دون توفير كلمة المرور. هذه هي الحماية النموذجية المستخدمة لحماية الصيغ، أو العناوين، أو مناطق إدخال البيانات المحددة في جداول البيانات المشتركة. لحماية ورقة عمل، استدعِ worksheet.protect(ProtectionType.All, "password", null). يتيح استخدام ProtectionType.All كل خيار حماية متاح مثل تحديد الخلايا المقفلة، وتنسيق الخلايا، وإدراج الصفوف والأعمدة، وحذف الصفوف والأعمدة. لإلغاء الحماية، استدعِ worksheet.unprotect("password") بكلمة المرور الصحيحة. يتوفر تحكم أكثر دقة من خلال دمج أنواع حماية أخرى مثل Contents وObjects وScenarios باستخدام OR على مستوى البت.

const AsposeCells = require("aspose.cells.node");
let workbook = new AsposeCells.Workbook();
let sheet = workbook.getWorksheets().get(0);
sheet.getCells().get("A1").putValue("Sample Data");
sheet.protect(AsposeCells.ProtectionType.All, "SheetPwd", null);
workbook.save("sheet_protected.xlsx");
let workbookReloaded = new AsposeCells.Workbook("sheet_protected.xlsx");
let sheetReloaded = workbookReloaded.getWorksheets().get(0);
sheetReloaded.unprotect("SheetPwd");
console.log("Worksheet protection removed successfully.");

إضافة والتحقق من صحة التوقيعات الرقمية

يضمن التوقيع الرقمي للمستلمين أن محتوى المصنف أصلي ولم يتم تغييره منذ توقيعه. يوفر Aspose.Cells دعم التوقيع الرقمي من خلال مساحة الاسم Aspose.Cells.DigitalSignatures. يقوم سير العمل النموذجي بتحميل ملف شهادة .pfx باستخدام أدوات Node.js crypto، ويلفه في Aspose.Cells.DigitalSignatures.DigitalSignature، ويضيف التوقيع إلى DigitalSignatureCollection، ويطبّق المجموعة على المصنف من خلال workbook.addDigitalSignature(digitalSignatureCollection). يمكن لخاصية digitalSignature.comments تسجيل سياق التوقيع مثل وقت التوقيع والغرض منه. أي تعديل يتم إجراؤه على المصنف بعد التوقيع يُبطل التوقيع، لذا يمكن لخطوة التحقق من جانب المتلقي اكتشاف التلاعب.

const AsposeCells = require("aspose.cells.node");
let signature = new AsposeCells.DigitalSignature("signature.pfx", "pfx-password", "Signed by Aspose.Cells", new Date());
let signatures = new AsposeCells.DigitalSignatureCollection();
signatures.add(signature);
let workbook = new AsposeCells.Workbook();
workbook.getWorksheets().get(0).getCells().get("A1").putValue("Sample Value");
workbook.addDigitalSignature(signatures);
workbook.save("signed_workbook.xlsx");
console.log("The workbook has been digitally signed.");

المقالات ذات الصلة