org.apache.pdfbox.pdmodel.encryption.PublicKeyProtectionPolicy Maven / Gradle / Ivy

Show more of this group Show more artifacts with this name
Show all versions of pdfbox Show documentation
The Apache PDFBox library is an open source Java tool for working with PDF documents.
There is a newer version: 3.0.2
/*
 * Licensed to the Apache Software Foundation (ASF) under one or more
 * contributor license agreements.  See the NOTICE file distributed with
 * this work for additional information regarding copyright ownership.
 * The ASF licenses this file to You under the Apache License, Version 2.0
 * (the "License"); you may not use this file except in compliance with
 * the License.  You may obtain a copy of the License at
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package org.apache.pdfbox.pdmodel.encryption;

import java.security.cert.X509Certificate;
import java.util.ArrayList;
import java.util.Iterator;

/**
 * This class represents the protection policy to use to protect
 * a document with the public key security handler as described
 * in the PDF specification 1.6 p104.
 *
 * PDF documents are encrypted so that they can be decrypted by
 * one or more recipients. Each recipient have its own access permission.
 *
 * The following code sample shows how to protect a document using
 * the public key security handler. In this code sample, doc is
 * a PDDocument object.
 *
 *  * PublicKeyProtectionPolicy policy = new PublicKeyProtectionPolicy();
 * PublicKeyRecipient recip = new PublicKeyRecipient();
 * AccessPermission ap = new AccessPermission();
 * ap.setCanModify(false);
 * recip.setPermission(ap);
 *
 * // load the recipient's certificate
 * InputStream inStream = new FileInputStream(certificate_path);
 * CertificateFactory cf = CertificateFactory.getInstance("X.509");
 * X509Certificate certificate = (X509Certificate)cf.generateCertificate(inStream);
 * inStream.close();
 *
 * recip.setX509(certificate); // set the recipient's certificate
 * policy.addRecipient(recip);
 * policy.setEncryptionKeyLength(128); // the document will be encrypted with 128 bits secret key
 * doc.protect(policy);
 * doc.save(out);
 * 
 *
 *
 * @see org.apache.pdfbox.pdmodel.PDDocument#protect(ProtectionPolicy)
 * @see AccessPermission
 * @see PublicKeyRecipient
 *
 * @author Benoit Guillon ([email protected])
 *
 * @version $Revision: 1.2 $
 */
public class PublicKeyProtectionPolicy extends ProtectionPolicy
{

    /**
     * The list of recipients.
     */
    private ArrayList recipients = null;

    /**
     * The X509 certificate used to decrypt the current document.
     */
    private X509Certificate decryptionCertificate;

    /**
     * Constructor for encryption. Just creates an empty recipients list.
     */
    public PublicKeyProtectionPolicy()
    {
        recipients = new ArrayList();
    }

    /**
     * Adds a new recipient to the recipients list.
     *
     * @param r A new recipient.
     */
    public void addRecipient(PublicKeyRecipient r)
    {
        recipients.add(r);
    }

    /**
     * Removes a recipient from the recipients list.
     *
     * @param r The recipient to remove.
     *
     * @return true If a recipient was found and removed.
     */
    public boolean removeRecipient(PublicKeyRecipient r)
    {
        return recipients.remove(r);
    }

    /**
     * Returns an iterator to browse the list of recipients. Object
     * found in this iterator are PublicKeyRecipient.
     *
     * @return The recipients list iterator.
     */
    public Iterator getRecipientsIterator()
    {
        return recipients.iterator();
    }

    /**
     * Getter of the property decryptionCertificate.
     *
     * @return  Returns the decryptionCertificate.
     */
    public X509Certificate getDecryptionCertificate()
    {
        return decryptionCertificate;
    }

    /**
     * Setter of the property decryptionCertificate.
     *
     * @param aDecryptionCertificate The decryption certificate to set.
     */
    public void setDecryptionCertificate(X509Certificate aDecryptionCertificate)
    {
        this.decryptionCertificate = aDecryptionCertificate;
    }

    /**
     * Returns the number of recipients.
     *
     * @return The number of recipients.
     */
    public int getRecipientsNumber()
    {
        return recipients.size();
    }
}