PDF تستخدم الملفات على نطاق واسع لتخزين ومشاركة المعلومات الحساسة ، من البيانات المالية إلى المستندات القانونية. ومع ذلك ، يمكن أن تكون هذه الملفات عرضة للوصول والتحرير غير المصرح به ، وهذا هو السبب في أن تشفير ملفات PDF وحمايتها بكلمة مرور أمر بالغ الأهمية للحفاظ على أمانها. في منشور المدونة هذا ، سنستكشف كيفية تشفير ملفات PDF وحمايتها بكلمة مرور باستخدام واجهات برمجة تطبيقات REST المستندة إلى Python. باتباع الإرشادات خطوة بخطوة الموضحة في هذا الدليل ، ستتمكن من إضافة طبقة إضافية من الأمان إلى ملفات PDF الخاصة بك والتأكد من بقائها في مأمن من أعين المتطفلين. لذا ، سواء كنت بحاجة إلى حماية مستندات العمل السرية أو الملفات الشخصية ، تابع القراءة لتتعلم كيفية تشفير ملفات PDF الخاصة بك وحمايتها وتأمينها بسهولة.

REST API لحماية PDF

Aspose.PDF Cloud SDK for Python هي أداة قوية تسمح لك بإضافة حماية بكلمة مرور لملفات PDF الخاصة بك بسهولة. باستخدام بضعة أسطر من التعليمات البرمجية ، يمكنك تشفير ملفات PDF الخاصة بك وتقييد الوصول إلى الأفراد المصرح لهم. يوفر SDK العديد من خوارزميات التشفير للاختيار من بينها ، بما في ذلك 40 بت RC4 و 128 بت RC4 و 128 بت AES و 256 بت AES.

الآن ، لبدء استخدام Python SDK ، فإن الخطوة الأولى هي تثبيته. وهو متاح للتنزيل عبر مستودع PIP و GitHub. لذا يرجى تنفيذ الأمر التالي في موجه الأوامر / المحطة الطرفية لتثبيت أحدث إصدار من SDK على النظام.

 pip install asposepdfcloud

أوراق اعتماد العميل

بعد التثبيت ، فإن الخطوة الرئيسية التالية هي الاشتراك المجاني في خدماتنا السحابية على Aspose.Cloud dashboard. ما عليك سوى التسجيل باستخدام حساب GitHub أو Google بالنقر فوق الزر إنشاء حساب جديد وتقديم المعلومات المطلوبة. ثم قم بتسجيل الدخول بحساب مشترك حديثًا واحصل على بيانات اعتماد العميل الخاصة بك.

أوراق اعتماد العميل

الصورة 2: - بيانات اعتماد العميل على لوحة معلومات Aspose.Cloud.

تشفير PDF باستخدام Python

تمكّنك واجهة برمجة التطبيقات من تعيين نوعين من كلمات المرور ، أي كلمة مرور فتح المستند (كلمة مرور المستخدم) وكلمة مرور الإذن (كلمة مرور المالك).

فتح كلمة مرور المستند

تتطلب كلمة مرور Document Open (المعروفة أيضًا باسم كلمة مرور المستخدم) أن يقوم المستخدم بكتابة كلمة مرور لفتح ملف PDF.

كلمة مرور الأذونات

كلمة مرور الإذن (المعروفة أيضًا باسم كلمة مرور المالك / الرئيسية) مطلوبة لتغيير إعدادات الأذونات. باستخدام كلمة مرور الأذونات ، يمكنك تقييد طباعة المحتوى وتحريره ونسخه في ملف PDF. كلمة المرور هذه مطلوبة لتغيير القيود التي قمت بتطبيقها بالفعل.

إذا كان ملف PDF مؤمنًا بكلا النوعين من كلمات المرور ، فيمكن فتحه بكلمة المرور.

أيضًا ، يرجى ملاحظة أن واجهة برمجة التطبيقات تقبل كلمات مرور المالك والمستخدم بتنسيق Base64encoded. في مقتطف الكود التالي ، تم تحديد ownerPassword (b3duZXJcLy8 / ICQxMl5QYXNzd29yZCEm) و userPassword (dXNlciAkXlBhc3N3b3JkISY =). يرجى اتباع الخطوات الواردة أدناه لتشفير ملفات PDF باستخدام مقتطف كود Python.

  • قم بإنشاء مثيل لفئة ApiClient مع توفير معرف العميل وسر العميل كوسائط
  • ثانيًا ، قم بإنشاء مثيل لفئة PdfApi التي تأخذ كائن ApiClient كوسيطة إدخال
  • الآن استدعاء الأسلوب postencryptdocumentinstorage (..) طريقة فئة PdfApi أثناء تمرير اسم ملف PDF الإدخال وكلمات مرور المستخدم والمالك (في ترميز Base64) وخوارزمية التشفير كوسائط.

هذا كل شيء! من خلال بضعة أسطر من التعليمات البرمجية ، تعلمنا خطوات حماية ملفات PDF بكلمة مرور باستخدام Aspose.PDF Cloud SDK for Python.

def encrypt():
    try:
        #Client credentials
        client_secret = "d34641f4ff6bcc96e3a0ab6ac69768b2"
        client_id = "8e2b082f-1f74-4bc0-b454-5f68457d1c97"

        #initialize PdfApi client instance using client credetials
        pdf_api_client = asposepdfcloud.api_client.ApiClient(client_secret, client_id)

        # إنشاء مثيل PdfApi أثناء تمرير PdfApiClient كوسيطة
        pdf_api = PdfApi(pdf_api_client)

        #input PDF file name
        input_file = 'image-based-pdf-sample.pdf'

        # استدعاء API لتشفير المستند
        response = pdf_api.post_encrypt_document_in_storage(name=input_file,user_password='dXNlciAkXlBhc3N3b3JkISY=',owner_password='b3duZXJcLy8/ICQxMl5QYXNzd29yZCEm',crypto_algorithm='AESX128')

        # رسالة نجاح الطباعة في وحدة التحكم (اختياري)
        print('PDF encrypted successfully !')    
    except ApiException as e:
        print("Exception while calling PdfApi: {0}".format(e))
        print("Code:" + str(e.code))
        print("Message:" + e.message)

يرجى ملاحظة أنه يمكنك استخدام أي من قيمة خوارزمية التشفير أثناء عملية تشفير PDF

الاسم الوصف
RC4x40 RC4 بطول المفتاح 40.
RC4x128 RC4 بطول مفتاح 128.
AESx128 AES بطول مفتاح 128.
AESx256 AES بطول مفتاح 256.

يمكن تنزيل ملف PDF المُدخل المستخدم في المثال أعلاه من awesomeTable.pdf.

تشفير ملف PDF باستخدام أمر cURL

يمكن أيضًا الوصول إلى واجهات برمجة تطبيقات REST عبر أوامر cURL على أي نظام أساسي. يمكننا استخدام نافذة موجه الأوامر / المحطة الطرفية لتنفيذ أوامر cURL. منذ Aspose.PDF Cloud تم تطويره أيضًا وفقًا لمعمارية REST ، لذلك يمكننا أيضًا استخدام الأمر cURL لتشفير ملفات PDF. ولكن قبل المضي قدمًا ، نحتاج إلى إنشاء JSON Web Token (JWT) استنادًا إلى بيانات اعتماد العميل الفردية المحددة في Aspose.Cloud لوحة القيادة. إنه إلزامي لأن واجهات برمجة التطبيقات الخاصة بنا لا يمكن الوصول إليها إلا للمستخدمين المسجلين. يرجى تنفيذ الأمر التالي لإنشاء رمز JWT المميز.

curl -v "https://api.aspose.cloud/connect/token" \
-X POST \
-d "grant_type=client_credentials&client_id=bbf94a2c-6d7e-4020-b4d2-b9809741374e&client_secret=1c9379bb7d701c26cc87e741a29987bb" \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Accept: application/json"

الآن ، بمجرد حصولنا على رمز JWT ، نحتاج إلى تنفيذ الأمر التالي لتشفير مستند PDF.

curl -v -X POST "https://api.aspose.cloud/v3.0/pdf/awesomeTable.pdf/encrypt?userPassword=dXNlciAkXlBhc3N3b3JkISY%3D&ownerPassword=b3duZXJcLy8%2FICQxMl5QYXNzd29yZCEm&cryptoAlgorithm=AESx128&permissionsFlags=AssembleDocument&usePdf20=false" \
-H  "accept: application/json" \
-H  "authorization: Bearer <JWT Token>"

خاتمة

في الختام ، يعد استخدام واجهة برمجة تطبيقات REST لتشفير ملفات PDF طريقة سريعة وفعالة لضمان أمان وخصوصية مستنداتك المهمة. سواء أكنت بحاجة إلى قفل PDF من التحرير أو إضافة حماية بكلمة مرور ، فإن هذه الطرق توفر حلاً مناسبًا سهل الاستخدام وآمن. باتباع الخطوات الموضحة في منشور المدونة هذا ، يمكنك بسهولة تأمين ملفات PDF الخاصة بك والاطمئنان إلى حماية معلوماتك القيمة.

يُرجى ملاحظة أن حزم SDK السحابية الخاصة بنا مبنية بموجب ترخيص MIT ، لذا يمكنك تنزيل مقتطف الشفرة الكامل من GitHub. علاوة على ذلك ، نوصي بشدة باستكشاف دليل المطور لمعرفة المزيد حول الميزات المثيرة الأخرى لواجهة برمجة التطبيقات.

أخيرًا ، إذا واجهت أي مشكلة أو كان لديك أي استفسار ذي صلة أثناء استخدام واجهة برمجة التطبيقات ، فلا تتردد في الاتصال بنا عبر منتدى دعم العملاء المجاني.

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

نقترح أيضًا مراجعة المقالات التالية لمعرفة المزيد عنها