קבצי PDF נמצאים בשימוש נרחב לאחסון ושיתוף מידע רגיש, מדוחות כספיים ועד למסמכים משפטיים. עם זאת, קבצים אלה עלולים להיות פגיעים לגישה ועריכה בלתי מורשית, וזו הסיבה שהצפנה והגנה על קובצי PDF חיוניים לשמירה על אבטחתם. בפוסט זה בבלוג, נחקור כיצד להצפין ולהגן באמצעות סיסמה על קובצי PDF באמצעות ממשקי API של REST מבוססי Python. על ידי ביצוע ההוראות המפורטות במדריך זה, תוכל להוסיף שכבת אבטחה נוספת לקובצי ה-PDF שלך ולהבטיח שהם יישארו בטוחים מעיניים סקרניות. אז בין אם אתה צריך להגן על מסמכים עסקיים סודיים או קבצים אישיים, המשך לקרוא כדי ללמוד כיצד להצפין, להגן ולאבטח את קבצי ה-PDF שלך בקלות.

REST API להגנה על PDF

Aspose.PDF Cloud SDK עבור 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

ה-API מאפשר לך להגדיר שני סוגים של סיסמאות, כלומר סיסמת פתיחת מסמך (סיסמת משתמש) וסיסמת הרשאה (סיסמת בעלים).

סיסמת פתיחת מסמך

סיסמת פתיחת מסמך (הידועה גם כסיסמת משתמש) דורשת מהמשתמש להקליד סיסמה כדי לפתוח את ה-PDF.

סיסמת הרשאות

סיסמת הרשאה (הידועה גם כסיסמת אב/בעלים) נדרשת כדי לשנות את הגדרות ההרשאה. באמצעות סיסמת הרשאות, תוכל להגביל הדפסה, עריכה והעתקה של תוכן ב-PDF. סיסמה זו נדרשת כדי לשנות את ההגבלות שכבר החלת.

אם ה-PDF מאובטח בשני סוגי הסיסמאות, ניתן לפתוח אותו עם כל אחת מהסיסמאות.

כמו כן, שים לב שה-API מקבל את סיסמאות הבעלים והמשתמש בפורמט מקודד Base64. בקטע הקוד הבא, צוינו ה-ownerPassword (b3duZXJcLy8/ICQxMl5QYXNzd29yZCEm) ו-userPassword (dXNlciAkXlBhc3N3b3JkISY=). אנא בצע את השלבים המפורטים להלן כדי להצפין קבצי PDF באמצעות קטע קוד של Python.

  • צור מופע של מחלקה ApiClient תוך מתן זיהוי לקוח וסוד לקוח כארגומנטים
  • שנית, צור מופע של מחלקה PdfApi שלוקח את אובייקט ApiClient כארגומנט קלט
  • כעת קרא את השיטה postencryptdocumentinstorage(..) לשיטת PdfApi תוך העברת שם קובץ PDF הקלט, סיסמאות משתמש ובעלים (בקידוד Base64) ואלגוריתם קריפטוגרפי כארגומנטים.

זהו! עם כמה שורות קוד בלבד, למדנו את השלבים להגנה על קובצי PDF באמצעות Aspose.PDF Cloud SDK עבור 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 API נגישים גם באמצעות פקודות cURL בכל פלטפורמה. נוכל להשתמש בשורת הפקודה/חלון הטרמינל כדי לבצע את פקודות cURL. מכיוון שגם Aspose.PDF Cloud פותח לפי ארכיטקטורת REST, אז נוכל להשתמש גם בפקודה cURL להצפנת קבצי ה-PDF. אבל לפני שנמשיך הלאה, עלינו ליצור JSON Web Token (JWT) על סמך אישורי הלקוח האישיים שלך שצוינו בלוח המחוונים של Aspose.Cloud. זה חובה מכיוון שממשקי ה-API שלנו נגישים רק למשתמשים רשומים. אנא בצע את הפקודה הבאה כדי ליצור את אסימון 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>"

סיכום

לסיכום, שימוש בממשק API של REST להצפנת קבצי PDF היא דרך מהירה ויעילה להבטיח את האבטחה והפרטיות של המסמכים החשובים שלך. בין אם אתה צריך לנעול את PDF לעריכה או להוסיף הגנת סיסמה, שיטות אלה מספקות פתרון נוח שהוא גם ידידותי למשתמש וגם מאובטח. על ידי ביצוע השלבים המתוארים בפוסט זה בבלוג, תוכל לאבטח בקלות את קבצי ה-PDF שלך ולהיות סמוך ובטוח שהמידע היקר שלך מוגן.

לידיעתך, ערכות SDK הענן שלנו בנויות תחת רישיון MIT, כך שתוכל להוריד את קטע הקוד המלא מ-GitHub. יתר על כן, אנו ממליצים מאוד לחקור את מדריך למפתחים כדי ללמוד עוד על תכונות מרגשות אחרות של ה-API.

לבסוף, אם אתה נתקל בבעיה כלשהי או שיש לך שאילתה קשורה בזמן השימוש ב-API, אל תהסס לפנות אלינו דרך פורום תמיכת הלקוחות החינמי.

מאמרים קשורים

אנו מציעים גם לעבור על המאמרים הבאים כדי ללמוד עוד עליהם