Файлы PDF шырока выкарыстоўваюцца для захоўвання і абмену канфідэнцыяльнай інфармацыяй, ад фінансавых справаздач да юрыдычных дакументаў. Аднак гэтыя файлы могуць быць уразлівымі для несанкцыянаванага доступу і рэдагавання, таму шыфраванне і абарона паролем PDF-файлаў мае вырашальнае значэнне для падтрымання іх бяспекі. У гэтым паведамленні ў блогу мы вывучым, як зашыфраваць і абараніць PDF-файлы паролем з дапамогай REST API на аснове 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. Проста зарэгіструйцеся з дапамогай уліковага запісу 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

API REST таксама даступны з дапамогай каманд cURL на любой платформе. Мы можам выкарыстоўваць акно каманднага радка/тэрмінала для выканання каманд cURL. Паколькі Aspose.PDF Cloud таксама распрацаваны ў адпаведнасці з архітэктурай REST, мы таксама можам выкарыстоўваць каманду cURL для шыфравання файлаў PDF. Але перш чым працягваць далей, нам трэба згенераваць вэб-токен JSON (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 створаны ў адпаведнасці з ліцэнзіяй Масачусецкага тэхналагічнага інстытута, таму вы можаце спампаваць поўны фрагмент кода з GitHub. Акрамя таго, мы настойліва рэкамендуем вывучыць Кіраўніцтва распрацоўшчыка, каб даведацца больш пра іншыя цікавыя магчымасці API.

Нарэшце, калі вы сутыкнуліся з якой-небудзь праблемай або звязаным з гэтым запытам пры выкарыстанні API, не саромейцеся звязацца з намі праз бясплатны форум падтрымкі кліентаў.

Звязаныя артыкулы

Мы таксама прапануем прачытаць наступныя артыкулы, каб даведацца больш пра