I file PDF sono ampiamente utilizzati per archiviare e condividere informazioni riservate, dai rendiconti finanziari ai documenti legali. Tuttavia, questi file possono essere vulnerabili all’accesso e alla modifica non autorizzati, motivo per cui la crittografia e la protezione tramite password dei PDF è fondamentale per mantenerne la sicurezza. In questo post del blog, esploreremo come crittografare e proteggere con password i file PDF utilizzando le API REST basate su Python. Seguendo le istruzioni dettagliate descritte in questa guida, sarai in grado di aggiungere un ulteriore livello di sicurezza ai tuoi file PDF e assicurarti che rimangano al sicuro da occhi indiscreti. Quindi, se hai bisogno di proteggere documenti aziendali riservati o file personali, continua a leggere per scoprire come crittografare, proteggere e proteggere facilmente i tuoi file PDF.

API REST per proteggere PDF

Aspose.PDF Cloud SDK for Python è un potente strumento che ti consente di aggiungere facilmente la protezione tramite password ai tuoi file PDF. Con poche righe di codice, puoi crittografare i tuoi file PDF e limitare l’accesso alle persone autorizzate. L’SDK offre diversi algoritmi di crittografia tra cui scegliere, inclusi RC4 a 40 bit, RC4 a 128 bit, AES a 128 bit e AES a 256 bit.

Ora, per iniziare con Python SDK, il primo passo è la sua installazione. È disponibile per il download sul repository PIP e GitHub. Quindi, esegui il seguente comando sul terminale/prompt dei comandi per installare l’ultima versione di SDK sul sistema.

 pip install asposepdfcloud

Credenziali del cliente

Dopo l’installazione, il prossimo passo importante è un abbonamento gratuito ai nostri servizi cloud su Aspose.Cloud dashboard. Basta registrarsi utilizzando GitHub o un account Google facendo clic sul pulsante Crea un nuovo account e fornire le informazioni richieste. Quindi accedi con l’account appena sottoscritto e ottieni le tue credenziali cliente.

Credenziali del cliente

Immagine 2:- Credenziali del cliente sulla dashboard di Aspose.Cloud.

Crittografa PDF usando Python

L’API consente di impostare due tipi di password, ovvero la password di apertura documento (password utente) e la password di autorizzazione (password proprietario).

Password di apertura del documento

Una password di apertura documento (nota anche come password utente) richiede all’utente di digitare una password per aprire il PDF.

Password di autorizzazioni

Per modificare le impostazioni di autorizzazione è necessaria una password di autorizzazione (nota anche come password master/proprietario). Utilizzando una password di autorizzazione, puoi limitare la stampa, la modifica e la copia del contenuto nel PDF. Questa password è necessaria per modificare le restrizioni che hai già applicato.

Se il PDF è protetto con entrambi i tipi di password, può essere aperto con entrambe le password.

Inoltre, tieni presente che l’API accetta le password del proprietario e dell’utente nel formato con codifica Base64. Nel seguente frammento di codice vengono specificate ownerPassword (b3duZXJcLy8/ICQxMl5QYXNzd29yZCEm) e userPassword (dXNlciAkXlBhc3N3b3JkISY=). Si prega di seguire i passaggi indicati di seguito per crittografare i file PDF utilizzando lo snippet di codice Python.

  • Crea un’istanza della classe ApiClient fornendo ID client e segreto client come argomenti
  • In secondo luogo, crea un’istanza della classe PdfApi che accetta l’oggetto ApiClient come argomento di input
  • Ora chiama il metodo postencryptdocumentinstorage(..) della classe PdfApi passando il nome del file PDF di input, le password dell’utente e del proprietario (nella codifica Base64) e un algoritmo crittografico come argomenti.

Ecco! Con poche righe di codice, abbiamo appreso i passaggi per proteggere con password i file PDF utilizzando Aspose.PDF Cloud SDK per 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)

        # creare un'istanza PdfApi passando PdfApiClient come argomento
        pdf_api = PdfApi(pdf_api_client)

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

        # chiama l'API per crittografare il documento
        response = pdf_api.post_encrypt_document_in_storage(name=input_file,user_password='dXNlciAkXlBhc3N3b3JkISY=',owner_password='b3duZXJcLy8/ICQxMl5QYXNzd29yZCEm',crypto_algorithm='AESX128')

        # stampa il messaggio di successo nella console (facoltativo)
        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)

Si prega di notare che è possibile utilizzare uno dei valori dell’algoritmo crittografico durante il processo di crittografia PDF

Nome Descrizione
RC4x40 RC4 con lunghezza chiave 40.
RC4x128 RC4 con lunghezza chiave 128.
AESx128 AES con lunghezza chiave 128.
AESx256 AES con lunghezza chiave 256.

Il file PDF di input utilizzato nell’esempio precedente può essere scaricato da awesomeTable.pdf.

Crittografa PDF utilizzando il comando cURL

Le API REST sono accessibili anche tramite i comandi cURL su qualsiasi piattaforma. Possiamo usare la finestra del prompt dei comandi/terminale per eseguire i comandi cURL. Poiché anche Aspose.PDF Cloud è sviluppato secondo l’architettura REST, possiamo anche utilizzare il comando cURL per crittografare i file PDF. Ma prima di procedere oltre, dobbiamo generare un JSON Web Token (JWT) basato sulle credenziali del tuo singolo cliente specificate sulla dashboard di Aspose.Cloud. È obbligatorio perché le nostre API sono accessibili solo agli utenti registrati. Eseguire il seguente comando per generare il 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"

Ora, una volta che abbiamo il token JWT, dobbiamo eseguire il seguente comando per crittografare il documento 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>"

Conclusione

In conclusione, utilizzare un’API REST per crittografare i file PDF è un modo rapido ed efficace per garantire la sicurezza e la privacy dei tuoi documenti importanti. Sia che tu abbia bisogno di bloccare la modifica del PDF o di aggiungere la protezione con password, questi metodi forniscono una soluzione conveniente, facile da usare e sicura. Seguendo i passaggi descritti in questo post del blog, puoi facilmente proteggere i tuoi file PDF e stare certo che le tue preziose informazioni sono protette.

Tieni presente che i nostri SDK cloud sono creati con una licenza MIT, quindi puoi scaricare lo snippet di codice completo da GitHub. Inoltre, consigliamo vivamente di esplorare la Guida per gli sviluppatori per saperne di più su altre interessanti funzionalità dell’API.

Infine, se riscontri problemi o hai domande correlate durante l’utilizzo dell’API, non esitare a contattarci tramite il forum di assistenza clienti gratuito.

articoli Correlati

Suggeriamo inoltre di consultare i seguenti articoli per saperne di più