Set Permissions and Password of the Generated PDF Document

EVO 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

  • 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 Microsoft.AspNetCore.Mvc;
using Microsoft.AspNetCore.Http;

// Use EVO PDF Namespace
using EvoPdf.Chromium;

namespace EvoPdf_Chromium_AspNetDemo.Controllers.HTML_to_PDF
{
    public class PDF_SecurityController : Controller
    {
        public ActionResult Index()
        {
            return View();
        }

        [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 = "4W9+bn19bn5ue2B+bn1/YH98YHd3d3c=";

            // 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.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.CanCopyContent || !htmlToPdfConverter.PdfSecurityOptions.CanCopyAccessibilityContent ||
                    !htmlToPdfConverter.PdfSecurityOptions.CanEditContent || !htmlToPdfConverter.PdfSecurityOptions.CanEditAnnotations ||
                    !htmlToPdfConverter.PdfSecurityOptions.CanFillFormFields;
        }
    }
}

See Also