1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
|
/* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
/*
* This file is part of the LibreOffice project.
*
* This Source Code Form is subject to the terms of the Mozilla Public
* License, v. 2.0. If a copy of the MPL was not distributed with this
* file, You can obtain one at http://mozilla.org/MPL/2.0/.
*/
#pragma once
#include <rtl/ustring.hxx>
#include <vector>
namespace vcl
{
struct PDFEncryptionProperties;
}
namespace com::sun::star::beans
{
class XMaterialHolder;
}
namespace com::sun::star::uno
{
template <typename> class Reference;
}
namespace vcl::pdf
{
/** Interface for encrypting the PDF content
*
* This interface makes it possible to have multiple versions and
* revisions of PDF encryption, but all using the same interface,
* so the implementation details are hidden from the outside. This
* also makes it easier to add new implementations in the future as
* we only need to write a new implementation of this interface.
*/
class IPDFEncryptor
{
private:
/* set to true if the following stream must be encrypted, used inside writeBuffer() */
bool m_bEncryptThisStream = false;
public:
virtual ~IPDFEncryptor() {}
/** PDF encryption version */
virtual sal_Int32 getVersion() = 0;
/** PDF encryption revision */
virtual sal_Int32 getRevision() = 0;
/** the numerical value of the access permissions, according to PDF spec, must be signed */
virtual sal_Int32 getAccessPermissions() = 0;
/** Encrypted access permission
*
* Depending on the encryption revision this may not be available. In that
* case we can expect empty content.
*/
virtual std::vector<sal_uInt8> getEncryptedAccessPermissions(std::vector<sal_uInt8>& /*rKey*/)
{
return std::vector<sal_uInt8>();
}
/** Length of the key in bits (i.e. 256 = 256bits) */
virtual sal_Int32 getKeyLength() = 0;
/** Prepares the encryption when the password is entered */
virtual bool prepareEncryption(
const css::uno::Reference<css::beans::XMaterialHolder>& xEncryptionMaterialHolder,
PDFEncryptionProperties& rProperties)
= 0;
/** Set up the keys and does a sanity check */
virtual void setupKeysAndCheck(PDFEncryptionProperties& rProperties) = 0;
/** Setup before we start encrypting - remembers the key */
virtual void setupEncryption(std::vector<sal_uInt8>& rEncryptionKey, sal_Int32 nObject) = 0;
/** Calculate the size of the output (by default the same as input) */
virtual sal_uInt64 calculateSizeIncludingHeader(sal_uInt64 nSize) { return nSize; }
/** Encrypts the input and stores into the output */
virtual void encrypt(const void* pInput, sal_uInt64 nInputSize, std::vector<sal_uInt8>& rOutput,
sal_uInt64 nOutputSize)
= 0;
void enableStreamEncryption() { m_bEncryptThisStream = true; }
void disableStreamEncryption() { m_bEncryptThisStream = false; }
bool isStreamEncryptionEnabled() { return m_bEncryptThisStream; }
};
}
/* vim:set shiftwidth=4 softtabstop=4 expandtab: */
|
