Set Permissions and Password of the Generated PDF Document

Winnovative HTML to PDF Converter allows you set the permissions of generated PDF document like printing and editing and to password protect the generated PDF document with separate user and owner passwords.

The PDF security options can be set in HtmlToPdfConverterPdfSecurityOptions object. The possible options are detailed below.

PDF Security Options

  • User Password. You can use this option to set an user password to be required when the PDF document is opened in a PDF viewer. The property you can set in your code for this option is PdfSecurityOptionsUserPassword

  • Owner Password. You can use this option to set an owner password. If the PDF document is password protected you can use the owner password to open the document and change its permissions . The property you can set in your code for this option is PdfSecurityOptionsOwnerPassword

  • Encryption Type. Use this option to set the encryption algorithm used to encrypt the generated PDF document. The converter supports RC4 and AES encryption algorithms. The property you can set in your code for this option is PdfSecurityOptionsEncryptionAlgorithm

  • Encryption Key. Use this option to set the encryption key size used to encrypt the generated PDF document. The converter supports 40-bit, 128-bit and 256-bit encryption keys, function of encryption algorithm. The property you can set in your code for this option is PdfSecurityOptionsKeySize

  • Print Enabled. Use this option to enable or disable the document printing option when the PDF document is opened in a PDF viewer. The property you can set in your code for this option is PdfSecurityOptionsCanPrint

  • High Resolution Print Enabled. Use this option to enable or disable the document printing in high resolution. The property you can set in your code for this option is PdfSecurityOptionsCanPrintHighResolution

  • Copy Content Enabled. Use this option to enable or disable the content copying when the PDF document is opened in a PDF viewer. The property you can set in your code for this option is PdfSecurityOptionsCanCopyContent

  • Copy Accessibility Content Enabled. Use this option to enable or disable the accessibility content copying when the PDF document is opened in a PDF viewer. The property you can set in your code for this option is PdfSecurityOptionsCanCopyAccessibilityContent

  • Edit Content Enabled. Use this option to enable or disable the content editing when the PDF document is opened in a PDF editor. The property you can set in your code for this option is PdfSecurityOptionsCanEditContent

  • Edit Annotations Enabled. Use this option to enable or disable the annotations editing when the PDF document is opened in a PDF editor. The property you can set in your code for this option is PdfSecurityOptionsCanEditAnnotations

  • Fill Form Fields Enabled. Use this option to enable or disable the form fields filling. The property you can set in your code for this option is PdfSecurityOptionsCanFillFormFields. In order to disable the form fields filling you have to disable the Edit Annotations Enabled and Edit Content Enabled options too.

Code Sample - Set Permissions and Password of the Generated PDF Document

C#
using System;
using System.Collections.Generic;
using System.Linq;
using System.Threading.Tasks;
using Microsoft.AspNetCore.Mvc;
using Microsoft.AspNetCore.Http;

// Use Winnovative Namespace
using Winnovative;

namespace WnvHtmlToPdfDemo.Controllers.HTML_to_PDF.PDF_Security
{
    public class PDF_Permissions_and_PasswordController : Controller
    {
        [HttpPost]
        public ActionResult ConvertHtmlToPdf(IFormCollection collection)
        {
            // Create a HTML to PDF converter object with default settings
            HtmlToPdfConverter htmlToPdfConverter = new HtmlToPdfConverter();

            // Set license key received after purchase to use the converter in licensed mode
            // Leave it not set to use the converter in demo mode
            htmlToPdfConverter.LicenseKey = "fvDh8eDx4fHg4P/h8eLg/+Dj/+jo6Og=";

            // Set an adddional delay in seconds to wait for JavaScript or AJAX calls after page load completed
            // Set this property to 0 if you don't need to wait for such asynchcronous operations to finish
            htmlToPdfConverter.ConversionDelay = 2;

            // Set the encryption algorithm and the encryption key size if they are not the default ones
            if (collection["EncryptionKey"] != "bit128RadioButton" || collection["EncryptionType"] != "rc4RadioButton")
            {
                // set the encryption algorithm
                htmlToPdfConverter.PdfSecurityOptions.EncryptionAlgorithm = collection["EncryptionType"] == "rc4RadioButton" ? EncryptionAlgorithm.RC4 : EncryptionAlgorithm.AES;

                // set the encryption key size
                if (collection["EncryptionKey"] == "bit40RadioButton")
                    htmlToPdfConverter.PdfSecurityOptions.KeySize = EncryptionKeySize.EncryptKey40Bit;
                else if (collection["EncryptionKey"] == "bit128RadioButton")
                    htmlToPdfConverter.PdfSecurityOptions.KeySize = EncryptionKeySize.EncryptKey128Bit;
                else if (collection["EncryptionKey"] == "bit256RadioButton")
                    htmlToPdfConverter.PdfSecurityOptions.KeySize = EncryptionKeySize.EncryptKey256Bit;
            }

            // Set user and owner passwords
            if (collection["userPasswordTextBox"][0].Length > 0)
                htmlToPdfConverter.PdfSecurityOptions.UserPassword = collection["userPasswordTextBox"];

            if (collection["ownerPasswordTextBox"][0].Length > 0)
                htmlToPdfConverter.PdfSecurityOptions.OwnerPassword = collection["ownerPasswordTextBox"];

            // Set PDF document permissions
            htmlToPdfConverter.PdfSecurityOptions.CanPrint = collection["printEnabledCheckBox"].Count > 0;
            htmlToPdfConverter.PdfSecurityOptions.CanPrintHighResolution = collection["highResolutionPrintEnabledCheckBox"].Count > 0;
            htmlToPdfConverter.PdfSecurityOptions.CanCopyContent = collection["copyContentEnabledCheckBox"].Count > 0;
            htmlToPdfConverter.PdfSecurityOptions.CanCopyAccessibilityContent = collection["copyAccessibilityContentEnabledCheckBox"].Count > 0;
            htmlToPdfConverter.PdfSecurityOptions.CanEditContent = collection["editContentEnabledCheckBox"].Count > 0;
            htmlToPdfConverter.PdfSecurityOptions.CanEditAnnotations = collection["editAnnotationsEnabledCheckBox"].Count > 0;
            htmlToPdfConverter.PdfSecurityOptions.CanFillFormFields = collection["fillFormFieldsEnabledCheckBox"].Count > 0;

            if ((PermissionsChanged(htmlToPdfConverter) || htmlToPdfConverter.PdfSecurityOptions.UserPassword.Length > 0) &&
                htmlToPdfConverter.PdfSecurityOptions.OwnerPassword.Length == 0)
            {
                // A user password is set but the owner password is not set or the permissions are not the default ones
                // Set a default owner password
                htmlToPdfConverter.PdfSecurityOptions.OwnerPassword = "owner";
            }

            // Convert the HTML page to a PDF document in a memory buffer
            byte[] outPdfBuffer = htmlToPdfConverter.ConvertUrl(collection["urlTextBox"]);

            // Send the PDF file to browser
            FileResult fileResult = new FileContentResult(outPdfBuffer, "application/pdf");
            fileResult.FileDownloadName = "Set_Permissions_Password.pdf";

            return fileResult;
        }

        private bool PermissionsChanged(HtmlToPdfConverter htmlToPdfConverter)
        {
            return !htmlToPdfConverter.PdfSecurityOptions.CanPrint || !htmlToPdfConverter.PdfSecurityOptions.CanPrintHighResolution ||
                    !htmlToPdfConverter.PdfSecurityOptions.CanCopyContent || !htmlToPdfConverter.PdfSecurityOptions.CanCopyAccessibilityContent ||
                    !htmlToPdfConverter.PdfSecurityOptions.CanEditContent || !htmlToPdfConverter.PdfSecurityOptions.CanEditAnnotations ||
                    !htmlToPdfConverter.PdfSecurityOptions.CanFillFormFields;
        }
    }
}