Set Permissions and Password of the Generated PDF Document

EVO PDF Client for .NET Documentation

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
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

Copy

protected void convertToPdf()
{
    // Get the server IP and port
    String serverIP = textBoxServerIP.Text;
    uint serverPort = uint.Parse(textBoxServerPort.Text);

    // Create a HTML to PDF converter object
    HtmlToPdfConverter htmlToPdfConverter = null;
    if (radioButtonUseTcpService.Checked)
        htmlToPdfConverter = new HtmlToPdfConverter(serverIP, serverPort);
    else
        htmlToPdfConverter = new HtmlToPdfConverter(true, textBoxWebServiceUrl.Text);

    // Set optional service password
    if (textBoxServicePassword.Text.Length > 0)
        htmlToPdfConverter.ServicePassword = textBoxServicePassword.Text;

    // 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 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 (!bit128RadioButton.Checked || !rc4RadioButton.Checked)
    {
        // set the encryption algorithm
        htmlToPdfConverter.PdfSecurityOptions.EncryptionAlgorithm = rc4RadioButton.Checked ? EncryptionAlgorithm.RC4 : EncryptionAlgorithm.AES;

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

    // Set user and owner passwords
    if (userPasswordTextBox.Text.Length > 0)
        htmlToPdfConverter.PdfSecurityOptions.UserPassword = userPasswordTextBox.Text;

    if (ownerPasswordTextBox.Text.Length > 0)
        htmlToPdfConverter.PdfSecurityOptions.OwnerPassword = ownerPasswordTextBox.Text;

    // Set PDF document permissions
    htmlToPdfConverter.PdfSecurityOptions.CanPrint = printEnabledCheckBox.Checked;
    htmlToPdfConverter.PdfSecurityOptions.CanPrintHighResolution = highResolutionPrintEnabledCheckBox.Checked;
    htmlToPdfConverter.PdfSecurityOptions.CanCopyContent = copyContentEnabledCheckBox.Checked;
    htmlToPdfConverter.PdfSecurityOptions.CanCopyAccessibilityContent = copyAccessibilityContentEnabledCheckBox.Checked;
    htmlToPdfConverter.PdfSecurityOptions.CanEditContent = editContentEnabledCheckBox.Checked;
    htmlToPdfConverter.PdfSecurityOptions.CanEditAnnotations = editAnnotationsEnabledCheckBox.Checked;
    htmlToPdfConverter.PdfSecurityOptions.CanFillFormFields = fillFormFieldsEnabledCheckBox.Checked;

    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(urlTextBox.Text);
}