Redigere file PDF
I file PDF sono comunemente usati per condividere documenti, come contratti legali, rendiconti finanziari o cartelle cliniche, grazie al loro formato sicuro e affidabile. Tuttavia, questi file possono anche contenere informazioni sensibili che devono essere mantenute riservate. Se devi condividere un file PDF che contiene dati sensibili, la redazione è il modo migliore per proteggerlo. La redazione è un processo di rimozione o oscuramento delle informazioni sensibili dal documento mantenendo intatto il resto del contenuto. In questo post del blog, ti mostreremo come redigere file PDF usando Python.

API di elaborazione PDF

Aspose.PDF Cloud SDK per Python è uno strumento eccellente per la redazione di file PDF online. È una REST API basata su cloud che offre varie funzionalità per lavorare con documenti PDF, come la creazione, la conversione e la manipolazione di file PDF. Utilizzando questo SDK, puoi facilmente redigere informazioni sensibili dai tuoi file PDF online senza dover installare alcun software aggiuntivo sul tuo computer.

Offre diversi vantaggi rispetto ai metodi di redazione tradizionali. Ad esempio, la funzionalità di redazione dell’API è più rapida e accurata della redazione manuale. Garantisce inoltre che le informazioni sensibili vengano rimosse in modo permanente dal documento, impedendo l’accesso non autorizzato alle informazioni.

Ora il primo passo è installare l’SDK, che è disponibile per il download tramite il repository PIP e GitHub. Esegui il seguente comando nel terminale per completare l’installazione.

pip install asposepdfcloud

IDE PyCharm

Se utilizzi PyCharm IDE, puoi aggiungere direttamente l’SDK come dipendenza nel tuo progetto.

File ->Impostazioni ->Progetto ->Interprete Python ->asposepdfcloud

didascalia

Image 1:- PyCharm settings option.

Pacchetto Python Aspose.PDF

Immagine 2: Pacchetto Python Cloud Aspose.Pdf.

Dopo l’installazione, il passo successivo più importante è ottenere le credenziali del cliente da Dashboard. Nel caso in cui non si disponga di un account, è sufficiente registrarsi utilizzando l’opzione crea un nuovo account.

Redigere PDF usando Python

Per censurare il contenuto del PDF utilizzando un frammento di codice Python, seguire le istruzioni riportate di seguito:

  • Creare un’istanza di ApiClient passando le credenziali del client come argomenti.
  • Ora inizializza PdfApi passando l’oggetto ApiClient come argomento.
  • Creiamo un oggetto di RedactionAnnotation e chiamiamo il metodo postpageredactionannotations(..) di PdfApi per soddisfare i nostri requisiti.
def redactPDF():
    try:
        #Client credentials
        client_secret = "1c9379bb7d701c26cc87e741a29987bb"
        client_id = "bbf94a2c-6d7e-4020-b4d2-b9809741374e"

        #initialize PdfApi client instance using client credetials
        pdf_api_client = asposepdfcloud.api_client.ApiClient(client_secret, client_id)

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

        # file PDF di input
        input_file = 'marketing.pdf'

        # creare un'istanza della classe RedactAnnotation
        redactAnnotation = asposepdfcloud.models.RedactionAnnotation() 
        redactAnnotation.contents = 'Confidential'

        # imposta i dettagli del colore per l'oggetto Annotazione
        redactAnnotation.color = asposepdfcloud.Color(a = 0, r = 66, g = 111, b = 245)

        # imposta la data di modifica per l'annotazione
        redactAnnotation.modified = '01/01/2018 12:00:00.000 AM'
        redactAnnotation.id = 1

        # imposta il flag di annotazione come predefinito
        redactAnnotation.flags = [asposepdfcloud.models.AnnotationFlags.DEFAULT]
        redactAnnotation.name = 'redactName'

        # specificare la regione rettangolare per l'annotazione sulla pagina
        redactAnnotation.rect = asposepdfcloud.models.Rectangle(llx = 20, lly = 700, urx = 220, ury = 650 )
        redactAnnotation.page_index = 1

        # Fattore ZIndex per annotazione
        redactAnnotation.z_index = 1

        # imposta l'allineamento verticale e orizzontale come Centro
        redactAnnotation.horizontal_alignment = asposepdfcloud.models.HorizontalAlignment.CENTER
        redactAnnotation.vertical_alignment = asposepdfcloud.models.HorizontalAlignment.CENTER
        
        # dettagli del punto per l'annotazione di redazione
        redactAnnotation.quad_point =  [
            asposepdfcloud.models.Point(5, 40),
            asposepdfcloud.models.Point(10, 60)
            ]

        # Dettagli del colore di riempimento dell'annotazione
        redactAnnotation.fill_color = asposepdfcloud.Color(a = 10, r = 50, g = 168, b = 182)

        # Testo sovrapposto da stampare sull'annotazione di redazione
        redactAnnotation.overlay_text = 'Confidential Data'

        # ripetere l'occorrenza dell'annotazione
        redactAnnotation.repeat = True

        # imposta le informazioni di allineamento del testo come allineato a sinistra
        redactAnnotation.text_alignment = asposepdfcloud.models.HorizontalAlignment.LEFT 

        # chiama l'API per aggiungere l'annotazione di redazione alla prima pagina del documento
        response = pdf_api.post_page_redaction_annotations(name = input_file, page_number= 1, annotations= [redactAnnotation])
        
        # stampa il codice di risposta nella console
        print(response)

        # stampa messaggio nella console (facoltativo)
        print('Redaction Annotation successfully added to PDF document !')    
    except ApiException as e:
        print("Exception while calling PdfApi: {0}".format(e))
        print("Code:" + str(e.code))
        print("Message:" + e.message)

Oscurare il contenuto PDF utilizzando i comandi cURL

Con il comando cURL e Aspose.PDF Cloud, oscurare i file PDF è diventato più facile che mai. Aspose.PDF Cloud è un’API RESTful che può essere utilizzata con più linguaggi di programmazione, incluso il comando cURL. Puoi facilmente oscurare informazioni sensibili dai file PDF oscurando il testo o rimuovendolo del tutto. L’API è sicura, affidabile e scalabile, il che la rende una scelta ideale per aziende di tutte le dimensioni.

Ora il primo passo è eseguire il seguente comando per generare l’accessToken.

curl -v "https://api.aspose.cloud/connect/token" \
-X POST \
-d "grant_type=client_credentials&client_id=88d1cda8-b12c-4a80-b1ad-c85ac483c5c5&client_secret=406b404b2df649611e508bbcfcd2a77f" \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Accept: application/json"

Una volta ottenuto accessToken, esegui il seguente comando per oscurare le informazioni nel documento PDF nella regione rettangolare specificata (“LLX”: 20, “LLY”: 700, “URX”: 220, “URY”: 650).Dopo l’operazione riuscita, il file risultante viene salvato nell’archivio cloud.

curl -v -X POST "https://api.aspose.cloud/v3.0/pdf/{inputPDF}/pages/1/annotations/redaction?apply=true" \
-H  "accept: application/json" \
-H  "authorization: Bearer {accessToken}" \
-H  "Content-Type: application/json" \
-d "[  {    \"Color\": {      \"A\": 0,      \"R\": 158,      \"G\": 50,      \"B\": 168    },    \"Contents\": \"Confidential\",    \"Modified\": \"01/18/2022 12:00:00.000 AM\",    \"Id\": \"1\",    \"Flags\": [      \"Default\"    ],    \"Name\": \"Name\",    \"Rect\": {      \"LLX\": 20,      \"LLY\": 700,      \"URX\": 220,      \"URY\": 650    },    \"PageIndex\": 1,    \"ZIndex\": 1,    \"HorizontalAlignment\": \"CENTER\",    \"VerticalAlignment\": \"CENTER\",    \"QuadPoint\": [      {        \"X\": 5,        \"Y\": 10      }    ],    \"FillColor\": {      \"A\": 10,      \"R\": 50,      \"G\": 168,      \"B\": 182    },    \"BorderColor\": {      \"A\": 10,      \"R\": 168,      \"G\": 50,      \"B\": 141    },    \"OverlayText\": \"Sensitive data\",    \"Repeat\": true,    \"TextAlignment\": \"Left\"  }]"

Sostituisci {inputPDF} con il nome del file PDF disponibile nell’archiviazione cloud e {accessToken} con il token di accesso generato sopra.

Conclusione

In conclusione, la redazione dei file PDF è un’attività critica per proteggere le informazioni sensibili dalla divulgazione. Sia che tu scelga di usare Python o il comando cURL con Aspose.PDF Cloud, il processo è diventato più semplice ed efficiente con la disponibilità. Quindi, che tu sia un professionista legale, un medico o un analista finanziario, imparare a redigere i file PDF usando Python può aiutarti a proteggere le tue informazioni riservate e a rispettare le normative sulla protezione dei dati.

Articoli consigliati

Ti consigliamo vivamente di leggere i seguenti articoli per saperne di più: