PDF fajls jintużaw ħafna biex jaħżnu u jaqsmu informazzjoni sensittiva, minn dikjarazzjonijiet finanzjarji sa dokumenti legali. Madankollu, dawn il-fajls jistgħu jkunu vulnerabbli għal aċċess u editjar mhux awtorizzat, u huwa għalhekk li l-encrypting u l-protezzjoni tal-passwords PDFs huma kruċjali biex tinżamm is-sigurtà tagħhom. F’din il-post tal-blog, se nesploraw kif nikkriptaw u nipproteġu b’password il-fajls PDF bl-użu ta’ REST APIs ibbażati fuq Python. Billi ssegwi l-istruzzjonijiet pass pass deskritti f’din il-gwida, inti tkun tista ‘żżid saff addizzjonali ta’ sigurtà mal-fajls PDF tiegħek u tiżgura li jibqgħu siguri minn għajnejhom. Allura jekk għandekx bżonn tipproteġi d-dokumenti tan-negozju kunfidenzjali jew fajls personali, kompli aqra biex titgħallem kif tikkodifika, tipproteġi u tiżgura l-fajls PDF tiegħek bil-faċilità.

REST API biex Jipproteġi PDF

Aspose.PDF Cloud SDK għal Python hija għodda qawwija li tippermettilek iżżid il-protezzjoni bil-password mal-fajls PDF tiegħek faċilment. Bi ftit linji ta’ kodiċi biss, tista’ tikkriptja l-fajls PDF tiegħek u tirrestrinġi l-aċċess għal individwi awtorizzati. L-SDK jipprovdi diversi algoritmi ta’ encryption minn fejn jagħżlu, inklużi 40-bit RC4, 128-bit RC4, 128-bit AES, u 256-bit AES.

Issa, sabiex tibda b’Python SDK, l-ewwel pass huwa l-installazzjoni tiegħu. Huwa disponibbli biex jitniżżel fuq PIP u GitHub repożitorju. Allura jekk jogħġbok eżegwixxi l-kmand li ġej fuq il-pront tat-terminal/kmand biex tinstalla l-aħħar verżjoni tal-SDK fis-sistema.

 pip install asposepdfcloud

Kredenzjali tal-Klijent

Wara l-installazzjoni, il-pass ewlieni li jmiss huwa abbonament b’xejn għas-servizzi tal-cloud tagħna fuq Aspose.Cloud dashboard. Sempliċement Irreġistra billi tuża GitHub jew kont Google billi tikklikkja l-buttuna Oħloq Kont ġdid u ipprovdi l-informazzjoni meħtieġa. Imbagħad idħol mal-kont li għadu kif ġie abbonat u akkwista l-Kredenzjali tal-Klijent tiegħek.

Kredenzjali tal-Klijent

Image 2:- Kredenzjali tal-klijenti fuq Aspose.Cloud dashboard.

Kriptaġġ PDF bl-użu ta ‘Python

L-API jippermettilek li tissettja żewġ tipi ta’ passwords jiġifieri password miftuħa tad-Dokument (password tal-utent) u password tal-Permess (password tas-sid).

Password miftuħa tad-dokument

Password Open tad-Dokument (magħrufa wkoll bħala password tal-utent) teħtieġ li utent jittajpja password biex jiftaħ il-PDF.

Password tal-permessi

Password ta’ permess (magħrufa wkoll bħala password kaptan/sid) hija meħtieġa biex tbiddel is-settings tal-permess. Billi tuża password tal-permessi, tista’ tirrestrinġi l-istampar, l-editjar u l-ikkupjar tal-kontenut fil-PDF. Din il-password hija meħtieġa biex tbiddel ir-restrizzjonijiet li diġà applikajt.

Jekk il-PDF huwa assigurat biż-żewġ tipi ta ‘passwords, jista’ jinfetaħ bi kwalunkwe password.

Ukoll, jekk jogħġbok innota li l-API jaċċetta l-passwords tas-sid u tal-utent fil-format Base64encoded. Fis-snippet tal-kodiċi li ġej, huma speċifikati s-sidPassword (b3duZXJcLy8/ICQxMl5QYXNzd29yZCEm) u userPassword (dXNlciAkXlBhc3N3b3JkISY=). Jekk jogħġbok segwi l-passi mogħtija hawn taħt biex tikkodifika fajls PDF billi tuża snippet tal-kodiċi Python.

  • Oħloq eżempju tal-klassi ApiClient filwaqt li tipprovdi ID tal-Klijent u Sigriet tal-Klijent bħala argumenti
  • It-tieni, oħloq eżempju ta ‘klassi PdfApi li tieħu oġġett ApiClient bħala argument ta’ input
  • Issa sejjaħ il-metodu postencryptdocumentinstorage(..) metodu tal-klassi PdfApi filwaqt li tgħaddi l-isem tal-fajl PDF input, passwords tal-utent u tas-sid (f’kodifikazzjoni Base64) u algoritmu Kriptografiku bħala argumenti.

Dak hu! Bi ftit linji ta ‘kodiċi biss, tgħallimna l-passi biex tipproteġi l-fajls PDF b’password billi tuża Aspose.PDF Cloud SDK għal 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)

        # toħloq istanza PdfApi filwaqt li tgħaddi PdfApiClient bħala argument
        pdf_api = PdfApi(pdf_api_client)

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

        # ċempel l-API biex tikkodifika d-dokument
        response = pdf_api.post_encrypt_document_in_storage(name=input_file,user_password='dXNlciAkXlBhc3N3b3JkISY=',owner_password='b3duZXJcLy8/ICQxMl5QYXNzd29yZCEm',crypto_algorithm='AESX128')

        # ipprintja messaġġ ta' suċċess fil-console (mhux obbligatorju)
        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)

Jekk jogħġbok innota li tista’ tuża xi wieħed mill-valur tal-algoritmu kriptografiku matul il-proċess ta’ encryption PDF

Isem Deskrizzjoni
RC4x40 RC4 b’tul taċ-ċavetta 40.
RC4x128 RC4 b’tul taċ-ċavetta 128.
AESx128 AES b’tul taċ-ċavetta 128.
AESx256 AES b’tul taċ-ċavetta 256.

Il-fajl PDF tal-input użat fl-eżempju ta’ hawn fuq jista’ jitniżżel minn awesomeTable.pdf.

Kriptaġġ PDF bl-użu ta ‘cURL Command

L-APIs REST huma aċċessibbli wkoll permezz ta ‘kmandi tal-cURL fuq kwalunkwe pjattaforma. Nistgħu nużaw it-tieqa tal-kmand fil-pront/terminal biex tesegwixxi l-kmandi tal-cURL. Peress li Aspose.PDF Cloud huwa żviluppat ukoll skont l-arkitettura REST, għalhekk nistgħu nużaw ukoll il-kmand cURL għall-encrypting tal-fajls PDF. Iżda qabel ma nipproċedu aktar, irridu niġġeneraw JSON Web Token (JWT) ibbażat fuq il-kredenzjali tal-klijent individwali tiegħek speċifikati fuq Aspose.Cloud dashboard. Huwa obbligatorju għaliex l-APIs tagħna huma aċċessibbli biss għall-utenti reġistrati. Jekk jogħġbok wettaq il-kmand li ġej biex tiġġenera t-token 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"

Issa, ladarba jkollna t-token JWT, irridu nwettqu l-kmand li ġej biex nikkriptaw id-dokument 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>"

Konklużjoni

Bħala konklużjoni, l-użu ta’ REST API biex tikkodifika fajls PDF huwa mod rapidu u effettiv biex tiżgura s-sigurtà u l-privatezza tad-dokumenti importanti tiegħek. Kemm jekk għandek bżonn tissakkar PDF mill-editjar jew iżżid protezzjoni bil-password, dawn il-metodi jipprovdu soluzzjoni konvenjenti li hija kemm faċli għall-utent kif ukoll sigura. Billi ssegwi l-passi deskritti f’din il-post tal-blog, tista ‘faċilment tiżgura l-fajls PDF tiegħek u tkun ċert li l-informazzjoni siewja tiegħek hija protetta.

Jekk jogħġbok innota li l-SDKs tal-cloud tagħna huma mibnija taħt liċenzja tal-MIT, għalhekk tista’ tniżżel is-snippet tal-kodiċi komplut minn GitHub. Barra minn hekk, nirrakkomandaw ħafna li tesplora l-Gwida għall-Iżviluppatur biex titgħallem aktar dwar karatteristiċi eċċitanti oħra tal-API.

Fl-aħħar nett, jekk tiltaqa’ ma’ xi kwistjoni jew għandek xi mistoqsija relatata waqt li tuża l-API, jekk jogħġbok tħossok liberu li tikkuntattjana permezz tal-forum ta’ appoġġ għall-klijenti b’xejn.

Artikoli Relatati

Nissuġġerixxu wkoll li tgħaddi mill-artikoli li ġejjin biex titgħallem aktar dwarhom