PDF ֆայլերը լայնորեն օգտագործվում են գաղտնի տեղեկատվության պահպանման և փոխանակման համար՝ ֆինանսական հաշվետվություններից մինչև իրավական փաստաթղթեր: Այնուամենայնիվ, այս ֆայլերը կարող են խոցելի լինել չարտոնված մուտքի և խմբագրման համար, այդ իսկ պատճառով PDF-ների կոդավորումը և գաղտնաբառով պաշտպանելը կարևոր է դրանց անվտանգությունը պահպանելու համար: Այս բլոգային գրառման մեջ մենք կուսումնասիրենք, թե ինչպես գաղտնագրել և պաշտպանել PDF ֆայլերը՝ օգտագործելով Python-ի վրա հիմնված REST API-ները: Այս ուղեցույցում նկարագրված քայլ առ քայլ հրահանգներին հետևելով՝ դուք կկարողանաք անվտանգության լրացուցիչ շերտ ավելացնել ձեր 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-ի միջոցով

API-ն հնարավորություն է տալիս սահմանել երկու տեսակի գաղտնաբառեր, այսինքն՝ Փաստաթղթի բաց գաղտնաբառ (օգտագործողի գաղտնաբառ) և թույլտվության գաղտնաբառ (սեփականատիրոջ գաղտնաբառը):

Փաստաթղթի բաց գաղտնաբառը

Փաստաթղթի բաց գաղտնաբառ (նաև հայտնի է որպես օգտվողի գաղտնաբառ) օգտվողից պահանջում է մուտքագրել գաղտնաբառ PDF-ը բացելու համար:

Թույլտվությունների գաղտնաբառը

Թույլտվության գաղտնաբառ (նաև հայտնի է որպես հիմնական/սեփականատիրոջ գաղտնաբառ) պահանջվում է թույլտվության կարգավորումները փոխելու համար: Օգտագործելով թույլտվությունների գաղտնաբառը՝ դուք կարող եք սահմանափակել PDF-ում բովանդակության տպումը, խմբագրումը և պատճենումը: Այս գաղտնաբառը պահանջվում է ձեր կողմից արդեն կիրառված սահմանափակումները փոխելու համար:

Եթե PDF-ն ապահովված է երկու տեսակի գաղտնաբառերով, այն կարող է բացվել ցանկացած գաղտնաբառով:

Նաև, խնդրում ենք նկատի ունենալ, որ API-ն ընդունում է սեփականատիրոջ և օգտագործողի գաղտնաբառերը Base64 կոդավորված ձևաչափով: Հետևյալ կոդի հատվածում նշված են սեփականատիրոջ գաղտնաբառը (b3duZXJcLy8/ICQxMl5QYXNzd29yZCEm) և օգտվողի գաղտնաբառը (dXNlciAkXlBhc3N3b3JkISY=): Խնդրում ենք հետևել ստորև տրված քայլերին PDF ֆայլերը գաղտնագրելու համար՝ օգտագործելով Python կոդի հատվածը:

  • Ստեղծեք ApiClient դասի օրինակ՝ որպես փաստարկներ տրամադրելով Client ID և Client Secret
  • Երկրորդ, ստեղծեք PdfApi դասի օրինակ, որն ընդունում է ApiClient օբյեկտը որպես մուտքային արգումենտ
  • Այժմ կանչեք PdfApi դասի postencryptdocumentinstorage(..) մեթոդը՝ որպես փաստարկներ փոխանցելով մուտքագրված 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>"

Եզրակացություն

Եզրափակելով, REST API-ի օգտագործումը PDF ֆայլերը կոդավորելու համար արագ և արդյունավետ միջոց է ձեր կարևոր փաստաթղթերի անվտանգությունն ու գաղտնիությունն ապահովելու համար: Անկախ նրանից, թե անհրաժեշտ է կողպել PDF-ը խմբագրումից կամ ավելացնել գաղտնաբառով պաշտպանություն, այս մեթոդները ապահովում են հարմար լուծում, որը և՛ օգտագործողի համար հարմար է, և՛ անվտանգ: Հետևելով այս բլոգի գրառման մեջ նշված քայլերին, դուք կարող եք հեշտությամբ ապահովել ձեր PDF ֆայլերը և վստահ լինել, որ ձեր արժեքավոր տեղեկատվությունը պաշտպանված է:

Խնդրում ենք նկատի ունենալ, որ մեր ամպային SDK-ները ստեղծվել են MIT լիցենզիայի ներքո, այնպես որ կարող եք ներբեռնել կոդի ամբողջական հատվածը GitHub-ից: Ավելին, խորհուրդ ենք տալիս ուսումնասիրել Developer Guide՝ API-ի այլ հետաքրքիր առանձնահատկությունների մասին ավելին իմանալու համար:

Ի վերջո, եթե API-ն օգտագործելիս որևէ խնդրի կամ որևէ առնչվող հարցում ունեք, խնդրում ենք ազատ զգալ կապվել մեզ հետ [անվճար հաճախորդների աջակցության ֆորումի] միջոցով 18:

Առնչվող հոդվածներ

Մենք նաև առաջարկում ենք անցնել հետևյալ հոդվածները՝ ավելին իմանալու համար