Protect PDF
Secure a PDF file with a password encrypt the document. Set an owner password and restrictions on certain features like printing, editing and copying in the PDF document to prevent end users from modifying it.
Support for AES-128 and AES-256 encryption on PDF files, with granular permissions for high and low quality printing and fill and sign form field restrictions.
REST API
See our public API Reference for Protect PDF
Protect PDFs with user password
You can password protect PDFs so that only users with a document open password can open the file.
Please refer the API usage guide to understand how to use our APIs.
Copied to your clipboard// Get the samples from https://www.adobe.com/go/pdftoolsapi_java_samples// Run the sample:// mvn -f pom.xml exec:java -Dexec.mainClass=com.adobe.pdfservices.operation.samples.protectpdf.ProtectPDFpublic class ProtectPDF {// Initialize the logger.private static final Logger LOGGER = LoggerFactory.getLogger(ProtectPDF.class);public static void main(String[] args) {try (InputStream inputStream = Files.newInputStream(new File("src/main/resources/protectPDFInput.pdf").toPath())) {// Initial setup, create credentials instanceCredentials credentials = new ServicePrincipalCredentials(System.getenv("PDF_SERVICES_CLIENT_ID"),System.getenv("PDF_SERVICES_CLIENT_SECRET"));// Creates a PDF Services instancePDFServices pdfServices = new PDFServices(credentials);// Creates an asset(s) from source file(s) and uploadAsset asset = pdfServices.upload(inputStream, PDFServicesMediaType.PDF.getMediaType());// Create parameters for the jobProtectPDFParams protectPDFParams = ProtectPDFParams.passwordProtectOptionsBuilder().setUserPassword("password").setEncryptionAlgorithm(EncryptionAlgorithm.AES_256).build();// Creates a new job instanceProtectPDFJob protectPDFJob = new ProtectPDFJob(asset, protectPDFParams);// Submit the job and gets the job resultString location = pdfServices.submit(protectPDFJob);PDFServicesResponse<ProtectPDFResult> pdfServicesResponse = pdfServices.getJobResult(location, ProtectPDFResult.class);// Get content from the resulting asset(s)Asset resultAsset = pdfServicesResponse.getResult().getAsset();StreamAsset streamAsset = pdfServices.getContent(resultAsset);// Creates an output stream and copy stream asset's content to itFiles.createDirectories(Paths.get("output/"));OutputStream outputStream = Files.newOutputStream(new File("output/protectPDFOutput.pdf").toPath());LOGGER.info("Saving asset at output/protectPDFOutput.pdf");IOUtils.copy(streamAsset.getInputStream(), outputStream);outputStream.close();} catch (ServiceApiException | IOException | SDKException | ServiceUsageException ex) {LOGGER.error("Exception encountered while executing operation", ex);}}}
Copied to your clipboard// Get the samples from https://www.adobe.com/go/pdftoolsapi_net_samples// Run the sample:// cd ProtectPDF/// dotnet run ProtectPDF.csprojnamespace ProtectPDF{class Program{private static readonly ILog log = LogManager.GetLogger(typeof(Program));static void Main(){//Configure the loggingConfigureLogging();try{// Initial setup, create credentials instanceICredentials credentials = new ServicePrincipalCredentials(Environment.GetEnvironmentVariable("PDF_SERVICES_CLIENT_ID"),Environment.GetEnvironmentVariable("PDF_SERVICES_CLIENT_SECRET"));// Creates a PDF Services instancePDFServices pdfServices = new PDFServices(credentials);// Creates an asset(s) from source file(s) and uploadusing Stream inputStream = File.OpenRead(@"protectPDFInput.pdf");IAsset asset = pdfServices.Upload(inputStream, PDFServicesMediaType.PDF.GetMIMETypeValue());// Create parameters for the jobProtectPDFParams protectPDFParams = ProtectPDFParams.PasswordProtectParamsBuilder().SetUserPassword("password").SetEncryptionAlgorithm(EncryptionAlgorithm.AES_256).Build();// Creates a new job instanceProtectPDFJob protectPDFJob = new ProtectPDFJob(asset, protectPDFParams);// Submits the job and gets the job resultString location = pdfServices.Submit(protectPDFJob);PDFServicesResponse<ProtectPDFResult> pdfServicesResponse =pdfServices.GetJobResult<ProtectPDFResult>(location, typeof(ProtectPDFResult));// Get content from the resulting asset(s)IAsset resultAsset = pdfServicesResponse.Result.Asset;StreamAsset streamAsset = pdfServices.GetContent(resultAsset);// Creating output streams and copying stream asset's content to itString outputFilePath = "/output/protectPDFOutput.pdf";new FileInfo(Directory.GetCurrentDirectory() + outputFilePath).Directory.Create();Stream outputStream = File.OpenWrite(Directory.GetCurrentDirectory() + outputFilePath);streamAsset.Stream.CopyTo(outputStream);outputStream.Close();}catch (ServiceUsageException ex){log.Error("Exception encountered while executing operation", ex);}catch (ServiceApiException ex){log.Error("Exception encountered while executing operation", ex);}catch (SDKException ex){log.Error("Exception encountered while executing operation", ex);}catch (IOException ex){log.Error("Exception encountered while executing operation", ex);}catch (Exception ex){log.Error("Exception encountered while executing operation", ex);}}static void ConfigureLogging(){ILoggerRepository logRepository = LogManager.GetRepository(Assembly.GetEntryAssembly());XmlConfigurator.Configure(logRepository, new FileInfo("log4net.config"));}// Generates a string containing a directory structure and file name for the output file.private static String CreateOutputFilePath(){String timeStamp = DateTime.Now.ToString("yyyy'-'MM'-'dd'T'HH'-'mm'-'ss");return ("/output/protect" + timeStamp + ".pdf");}}}
Copied to your clipboard// Get the samples from http://www.adobe.com/go/pdftoolsapi_node_sample// Run the sample:// node src/protectpdf/protect-pdf.jsconst {ServicePrincipalCredentials,PDFServices,MimeType,ProtectPDFParams,EncryptionAlgorithm,ProtectPDFJob,ProtectPDFResult,SDKError,ServiceUsageError,ServiceApiError} = require("@adobe/pdfservices-node-sdk");const fs = require("fs");(async () => {let readStream;try {// Initial setup, create credentials instanceconst credentials = new ServicePrincipalCredentials({clientId: process.env.PDF_SERVICES_CLIENT_ID,clientSecret: process.env.PDF_SERVICES_CLIENT_SECRET});// Creates a PDF Services instanceconst pdfServices = new PDFServices({credentials});// Creates an asset(s) from source file(s) and uploadreadStream = fs.createReadStream("./protectPDFInput.pdf")const inputAsset = await pdfServices.upload({readStream,mimeType: MimeType.PDF});// Create parameters for the jobconst params = new ProtectPDFParams({userPassword: "password",encryptionAlgorithm: EncryptionAlgorithm.AES_256});// Create a new job instanceconst job = new ProtectPDFJob({inputAsset, params});// Submit the job and get the job resultconst pollingURL = await pdfServices.submit({job});const pdfServicesResponse = await pdfServices.getJobResult({pollingURL,resultType: ProtectPDFResult});// Get content from the resulting asset(s)const resultAsset = pdfServicesResponse.result.asset;const streamAsset = await pdfServices.getContent({asset: resultAsset});// Creates an output stream and copy stream asset's content to itconst outputFilePath = "./protectPDFOutput.pdf";console.log(`Saving asset at ${outputFilePath}`);const outputStream = fs.createWriteStream(outputFilePath);streamAsset.readStream.pipe(outputStream);} catch (err) {if (err instanceof SDKError || err instanceof ServiceUsageError || err instanceof ServiceApiError) {console.log("Exception encountered while executing operation", err);} else {console.log("Exception encountered while executing operation", err);}} finally {readStream?.destroy();}})();
Copied to your clipboard# Get the samples https://github.com/adobe/pdfservices-python-sdk-samples# Run the sample:# python src/protectpdf/protect_pdf.py# Initialize the loggerlogging.basicConfig(level=logging.INFO)class ProtectPDF:def __init__(self):try:file = open('./protectPDFInput.pdf', 'rb')input_stream = file.read()file.close()# Initial setup, create credentials instancecredentials = ServicePrincipalCredentials(client_id=os.getenv('PDF_SERVICES_CLIENT_ID'),client_secret=os.getenv('PDF_SERVICES_CLIENT_SECRET'))# Creates a PDF Services instancepdf_services = PDFServices(credentials=credentials)# Creates an asset(s) from source file(s) and uploadinput_asset = pdf_services.upload(input_stream=input_stream, mime_type=PDFServicesMediaType.PDF)# Create parameters for the jobprotect_pdf_params = PasswordProtectParams(user_password='password',encryption_algorithm=EncryptionAlgorithm.AES_256,content_encryption=ContentEncryption.ALL_CONTENT,)# Creates a new job instanceprotect_pdf_job = ProtectPDFJob(input_asset=input_asset, protect_pdf_params=protect_pdf_params)# Submit the job and gets the job resultlocation = pdf_services.submit(protect_pdf_job)pdf_services_response = pdf_services.get_job_result(location, ProtectPDFResult)# Get content from the resulting asset(s)result_asset: CloudAsset = pdf_services_response.get_result().get_asset()stream_asset: StreamAsset = pdf_services.get_content(result_asset)# Creates an output stream and copy stream asset's content to itoutput_file_path = 'output/ProtectPDF.pdf'with open(output_file_path, "wb") as file:file.write(stream_asset.get_input_stream())except (ServiceApiException, ServiceUsageException, SdkException) as e:logging.exception(f'Exception encountered while executing operation: {e}')if __name__ == "__main__":ProtectPDF()
Copied to your clipboard// Please refer our REST API docs for more information// https://developer.adobe.com/document-services/docs/apis/#tag/Protect-PDFcurl --location --request POST 'https://pdf-services.adobe.io/operation/protectpdf' \--header 'x-api-key: {{Placeholder for client_id}}' \--header 'Content-Type: application/json' \--header 'Authorization: Bearer {{Placeholder for token}}' \--data-raw '{"passwordProtection": {"userPassword": "user_password"},"encryptionAlgorithm": "AES_128","assetID": "urn:aaid:AS:UE1:23c30ee0-2e4d-46d6-87f2-087832fca718"}'
Protect PDFs with owner password
You can secure a PDF file with owner/permissions password and set the
restriction on certain features like printing, editing and copying in
the PDF document. Refer to ContentEncryption
and Permission
in the
API docs for a list of supported types of content to encrypt and types
of document permissions.
Please refer the API usage guide to understand how to use our APIs.
Copied to your clipboard// Get the samples from https://www.adobe.com/go/pdftoolsapi_java_samples// Run the sample:// mvn -f pom.xml exec:java -Dexec.mainClass=com.adobe.pdfservices.operation.samples.protectpdf.ProtectPDFWithOwnerPasswordpublic class ProtectPDFWithOwnerPassword {// Initialize the logger.private static final Logger LOGGER = LoggerFactory.getLogger(ProtectPDFWithOwnerPassword.class);public static void main(String[] args) {try (InputStream inputStream = Files.newInputStream(new File("src/main/resources/protectPDFInput.pdf").toPath())) {// Initial setup, create credentials instanceCredentials credentials = new ServicePrincipalCredentials(System.getenv("PDF_SERVICES_CLIENT_ID"),System.getenv("PDF_SERVICES_CLIENT_SECRET"));// Creates a PDF Services instancePDFServices pdfServices = new PDFServices(credentials);// Creates an asset(s) from source file(s) and uploadAsset asset = pdfServices.upload(inputStream, PDFServicesMediaType.PDF.getMediaType());// Create new permissions instance and add the required permissionsPermissions permissions = Permissions.createNew();permissions.addPermission(Permission.PRINT_LOW_QUALITY);permissions.addPermission(Permission.EDIT_DOCUMENT_ASSEMBLY);permissions.addPermission(Permission.COPY_CONTENT);// Create parameters for the jobProtectPDFParams protectPDFParams = ProtectPDFParams.passwordProtectOptionsBuilder().setOwnerPassword("password").setPermissions(permissions).setEncryptionAlgorithm(EncryptionAlgorithm.AES_256).setContentEncryption(ContentEncryption.ALL_CONTENT_EXCEPT_METADATA).build();// Creates a new job instanceProtectPDFJob protectPDFJob = new ProtectPDFJob(asset, protectPDFParams);// Submit the job and gets the job resultString location = pdfServices.submit(protectPDFJob);PDFServicesResponse<ProtectPDFResult> pdfServicesResponse = pdfServices.getJobResult(location, ProtectPDFResult.class);// Get content from the resulting asset(s)Asset resultAsset = pdfServicesResponse.getResult().getAsset();StreamAsset streamAsset = pdfServices.getContent(resultAsset);// Creates an output stream and copy stream asset's content to itFiles.createDirectories(Paths.get("output/"));OutputStream outputStream = Files.newOutputStream(new File("output/protectPDFWithOwnerPasswordOutput.pdf").toPath());LOGGER.info("Saving asset at output/protectPDFWithOwnerPasswordOutput.pdf");IOUtils.copy(streamAsset.getInputStream(), outputStream);outputStream.close();} catch (ServiceApiException | IOException | SDKException | ServiceUsageException ex) {LOGGER.error("Exception encountered while executing operation", ex);}}}
Copied to your clipboard// Get the samples from https://www.adobe.com/go/pdftoolsapi_net_samples// Run the sample:// cd ProtectPDFWithOwnerPassword/// dotnet run ProtectPDFWithOwnerPassword.csprojnamespace ProtectPDFWithOwnerPassword{class Program{private static readonly ILog log = LogManager.GetLogger(typeof(Program));static void Main(){//Configure the loggingConfigureLogging();try{// Initial setup, create credentials instanceICredentials credentials = new ServicePrincipalCredentials(Environment.GetEnvironmentVariable("PDF_SERVICES_CLIENT_ID"),Environment.GetEnvironmentVariable("PDF_SERVICES_CLIENT_SECRET"));// Creates a PDF Services instancePDFServices pdfServices = new PDFServices(credentials);// Creates an asset(s) from source file(s) and uploadusing Stream inputStream = File.OpenRead(@"protectPDFInput.pdf");IAsset asset = pdfServices.Upload(inputStream, PDFServicesMediaType.PDF.GetMIMETypeValue());// Create new permissions instance and add the required permissionsPermissions permissions = new Permissions();permissions.AddPermission(Permission.PRINT_LOW_QUALITY);permissions.AddPermission(Permission.EDIT_DOCUMENT_ASSEMBLY);permissions.AddPermission(Permission.COPY_CONTENT);// Create parameters for the jobProtectPDFParams protectPDFParams = ProtectPDFParams.PasswordProtectParamsBuilder().SetOwnerPassword("password").SetPermissions(permissions).SetEncryptionAlgorithm(EncryptionAlgorithm.AES_256).SetContentEncryption(ContentEncryption.ALL_CONTENT_EXCEPT_METADATA).Build();// Creates a new job instanceProtectPDFJob protectPDFJob = new ProtectPDFJob(asset, protectPDFParams);// Submits the job and gets the job resultString location = pdfServices.Submit(protectPDFJob);PDFServicesResponse<ProtectPDFResult> pdfServicesResponse =pdfServices.GetJobResult<ProtectPDFResult>(location, typeof(ProtectPDFResult));// Get content from the resulting asset(s)IAsset resultAsset = pdfServicesResponse.Result.Asset;StreamAsset streamAsset = pdfServices.GetContent(resultAsset);// Creating output streams and copying stream asset's content to itString outputFilePath = "/output/protectPDFWithOwnerPasswordOutput.pdf";new FileInfo(Directory.GetCurrentDirectory() + outputFilePath).Directory.Create();Stream outputStream = File.OpenWrite(Directory.GetCurrentDirectory() + outputFilePath);streamAsset.Stream.CopyTo(outputStream);outputStream.Close();}catch (ServiceUsageException ex){log.Error("Exception encountered while executing operation", ex);}catch (ServiceApiException ex){log.Error("Exception encountered while executing operation", ex);}catch (SDKException ex){log.Error("Exception encountered while executing operation", ex);}catch (IOException ex){log.Error("Exception encountered while executing operation", ex);}catch (Exception ex){log.Error("Exception encountered while executing operation", ex);}}static void ConfigureLogging(){ILoggerRepository logRepository = LogManager.GetRepository(Assembly.GetEntryAssembly());XmlConfigurator.Configure(logRepository, new FileInfo("log4net.config"));}}}
Copied to your clipboard// Get the samples from http://www.adobe.com/go/pdftoolsapi_node_sample// Run the sample:// node src/protectpdf/protect-pdf-with-owner-password.jsconst {ServicePrincipalCredentials,PDFServices,MimeType,ProtectPDFParams,EncryptionAlgorithm,ProtectPDFJob,ProtectPDFResult,ContentEncryption,Permissions,Permission,SDKError,ServiceUsageError,ServiceApiError} = require("@adobe/pdfservices-node-sdk");const fs = require("fs");(async () => {let readStream;try {// Initial setup, create credentials instanceconst credentials = new ServicePrincipalCredentials({clientId: process.env.PDF_SERVICES_CLIENT_ID,clientSecret: process.env.PDF_SERVICES_CLIENT_SECRET});// Creates a PDF Services instanceconst pdfServices = new PDFServices({credentials});// Creates an asset(s) from source file(s) and uploadreadStream = fs.createReadStream("./protectPDFInput.pdf")const inputAsset = await pdfServices.upload({readStream,mimeType: MimeType.PDF});// Create new permissions instance and add the required permissionsconst permissions = new Permissions({permissions: [Permission.PRINT_LOW_QUALITY,Permission.EDIT_DOCUMENT_ASSEMBLY,Permission.COPY_CONTENT]});// Create parameters for the jobconst params = new ProtectPDFParams({ownerPassword: "password",permissions: permissions,encryptionAlgorithm: EncryptionAlgorithm.AES_256,contentEncryption: ContentEncryption.ALL_CONTENT_EXCEPT_METADATA,});// Create a new job instanceconst job = new ProtectPDFJob({inputAsset, params});// Submit the job and get the job resultconst pollingURL = await pdfServices.submit({job});const pdfServicesResponse = await pdfServices.getJobResult({pollingURL,resultType: ProtectPDFResult});// Get content from the resulting asset(s)const resultAsset = pdfServicesResponse.result.asset;const streamAsset = await pdfServices.getContent({asset: resultAsset});// Creates an output stream and copy stream asset's content to itconst outputFilePath = "./protectPDFWithOwnerPasswordOutput.pdf";console.log(`Saving asset at ${outputFilePath}`);const outputStream = fs.createWriteStream(outputFilePath);streamAsset.readStream.pipe(outputStream);} catch (err) {if (err instanceof SDKError || err instanceof ServiceUsageError || err instanceof ServiceApiError) {console.log("Exception encountered while executing operation", err);} else {console.log("Exception encountered while executing operation", err);}} finally {readStream?.destroy();}})();
Copied to your clipboard# Get the samples https://github.com/adobe/pdfservices-python-sdk-samples# Run the sample:# python src/protectpdf/protect_pdf_with_owner_password.py# Initialize the loggerlogging.basicConfig(level=logging.INFO)class ProtectPDFWithOwnerPassword:def __init__(self):try:file = open('./protectPDFInput.pdf', 'rb')input_stream = file.read()file.close()# Initial setup, create credentials instancecredentials = ServicePrincipalCredentials(client_id=os.getenv('PDF_SERVICES_CLIENT_ID'),client_secret=os.getenv('PDF_SERVICES_CLIENT_SECRET'))# Creates a PDF Services instancepdf_services = PDFServices(credentials=credentials)# Creates an asset(s) from source file(s) and uploadinput_asset = pdf_services.upload(input_stream=input_stream, mime_type=PDFServicesMediaType.PDF)# Create new permissions instance and add the required permissionspermissions = Permissions()permissions.add_permission(Permission.PRINT_LOW_QUALITY)permissions.add_permission(Permission.EDIT_DOCUMENT_ASSEMBLY)permissions.add_permission(Permission.COPY_CONTENT)# Create parameters for the jobprotect_pdf_params = PasswordProtectParams(owner_password='password',encryption_algorithm=EncryptionAlgorithm.AES_256,permissions=permissions,content_encryption=ContentEncryption.ALL_CONTENT_EXCEPT_METADATA,)# Creates a new job instanceprotect_pdf_job = ProtectPDFJob(input_asset=input_asset, protect_pdf_params=protect_pdf_params)# Submit the job and gets the job resultlocation = pdf_services.submit(protect_pdf_job)pdf_services_response = pdf_services.get_job_result(location, ProtectPDFResult)# Get content from the resulting asset(s)result_asset: CloudAsset = pdf_services_response.get_result().get_asset()stream_asset: StreamAsset = pdf_services.get_content(result_asset)# Creates an output stream and copy stream asset's content to itoutput_file_path = 'output/ProtectPDFWithOwnerPassword.pdf'with open(output_file_path, "wb") as file:file.write(stream_asset.get_input_stream())except (ServiceApiException, ServiceUsageException, SdkException) as e:logging.exception(f'Exception encountered while executing operation: {e}')if __name__ == "__main__":ProtectPDFWithOwnerPassword()
Copied to your clipboard// Please refer our REST API docs for more information// https://developer.adobe.com/document-services/docs/apis/#tag/Protect-PDFcurl --location --request POST 'https://pdf-services.adobe.io/operation/protectpdf' \--header 'x-api-key: {{Placeholder for client_id}}' \--header 'Content-Type: application/json' \--header 'Authorization: Bearer {{Placeholder for token}}' \--data-raw '{"passwordProtection": {"ownerPassword": "owner_password"},"encryptionAlgorithm": "AES_256","assetID": "urn:aaid:AS:UE1:23c30ee0-2e4d-46d6-87f2-087832fca718"}'