LIEF: Library to Instrument Executable Formats Version 2.0.0
Loading...
Searching...
No Matches
SignatureParser.hpp
Go to the documentation of this file.
1/* Copyright 2017 - 2026 R. Thomas
2 *
3 * Licensed under the Apache License, Version 2.0 (the "License");
4 * you may not use this file except in compliance with the License.
5 * You may obtain a copy of the License at
6 *
7 * http://www.apache.org/licenses/LICENSE-2.0
8 *
9 * Unless required by applicable law or agreed to in writing, software
10 * distributed under the License is distributed on an "AS IS" BASIS,
11 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12 * See the License for the specific language governing permissions and
13 * limitations under the License.
14 */
15#ifndef LIEF_PE_SIGNATURE_PARSER_H
16#define LIEF_PE_SIGNATURE_PARSER_H
17#include <string_view>
18#include <array>
19#include <memory>
20#include <string>
21
22#include "LIEF/errors.hpp"
23#include "LIEF/path.hpp"
24
26
27namespace LIEF {
28class BinaryStream;
29class VectorStream;
30
31namespace PE {
32class Parser;
33class Attribute;
34class SpcIndirectData;
35class PKCS9TSTInfo;
36
38 friend class Parser;
39 struct SpcPeImageData {
40 uint32_t flags;
41 std::string file;
42 };
43
44 struct SpcSpOpusInfo {
45 std::string program_name;
46 std::string more_info;
47 };
48 struct range_t {
49 uint64_t start = 0;
50 uint64_t end = 0;
51 };
52
53 public:
54 using attributes_t = std::vector<std::unique_ptr<Attribute>>;
55 using signer_infos_t = std::vector<SignerInfo>;
56 using x509_certificates_t = std::vector<x509>;
57 using time_t = std::array<int32_t, 6>;
58
60 static result<Signature> parse(std::vector<uint8_t> data,
61 bool skip_header = false);
62
64 static result<Signature> parse(BinaryStream& stream, bool skip_header = false);
65
67 static result<Signature> parse(std::string_view path);
68
71 template<class PathT, enable_if_path_t<PathT> = 0>
72 static result<Signature> parse(const PathT& path) {
73 return parse(path.string());
74 }
77
78 private:
79 ~SignatureParser() = default;
80 SignatureParser() = default;
81
82 static result<Signature> parse_signature(BinaryStream& stream);
83
84 static result<ContentInfo> parse_content_info(BinaryStream& stream,
85 range_t& range);
86 static result<x509_certificates_t> parse_certificates(BinaryStream& stream);
87 static result<signer_infos_t> parse_signer_infos(BinaryStream& stream);
88 static result<attributes_t> parse_attributes(BinaryStream& stream);
90 parse_content_type(BinaryStream& stream);
91
92 static result<signer_infos_t> parse_pkcs9_counter_sign(BinaryStream& stream);
94 parse_pkcs9_message_digest(BinaryStream& stream);
95 static result<int32_t> parse_pkcs9_at_sequence_number(BinaryStream& stream);
96 static result<time_t> parse_pkcs9_signing_time(BinaryStream& stream);
98 parse_pkcs9_tstinfo(BinaryStream& stream);
99
101 parse_ms_counter_sign(BinaryStream& stream);
102 static result<Signature> parse_ms_spc_nested_signature(BinaryStream& stream);
103 static result<oid_t> parse_ms_spc_statement_type(BinaryStream& stream);
104 static result<SpcSpOpusInfo> parse_spc_sp_opus_info(BinaryStream& stream);
105 static result<std::string> parse_spc_string(BinaryStream& stream);
106 static result<std::string> parse_spc_link(BinaryStream& stream);
108 parse_spc_relaxed_pe_marker_check(BinaryStream& stream);
109 static result<SpcPeImageData> parse_spc_pe_image_data(BinaryStream& stream);
111 parse_spc_indirect_data(BinaryStream& stream, range_t& range);
113 parse_ms_platform_manifest_binary_id(BinaryStream& stream);
114
116 parse_signing_certificate_v2(BinaryStream& stream);
117};
118
119}
120}
121
122#endif
Class that is used to a read stream of data from different sources.
Definition BinaryStream.hpp:34
Interface over PKCS #7 attribute.
Definition PE/signature/Attribute.hpp:28
Interface over the structure described by the OID 1.2.840.113549.1.9.16.1.4 (PKCS #9).
Definition PKCS9TSTInfo.hpp:59
Main interface to parse PE binaries. In particular, the static Parser::parse functions should be used...
Definition PE/Parser.hpp:53
static result< Signature > parse(std::vector< uint8_t > data, bool skip_header=false)
Parse a PKCS #7 signature given a raw blob.
std::vector< x509 > x509_certificates_t
Definition SignatureParser.hpp:56
static result< Signature > parse(const PathT &path)
Same as parse(std::string_view) but the file is given as a std::filesystem::path.
Definition SignatureParser.hpp:72
static result< Signature > parse(BinaryStream &stream, bool skip_header=false)
Parse a PKCS #7 signature given a BinaryStream.
std::vector< SignerInfo > signer_infos_t
Definition SignatureParser.hpp:55
std::vector< std::unique_ptr< Attribute > > attributes_t
Definition SignatureParser.hpp:54
std::array< int32_t, 6 > time_t
Definition SignatureParser.hpp:57
SignatureParser & operator=(const SignatureParser &)=delete
SignatureParser(const SignatureParser &)=delete
static result< Signature > parse(std::string_view path)
Parse a PKCS #7 signature from a file path.
friend class Parser
Definition SignatureParser.hpp:38
Definition SpcIndirectData.hpp:31
Interface over the structure described by the OID 1.3.6.1.4.1.311.2.1.12.
Definition SpcSpOpusInfo.hpp:40
Definition VectorStream.hpp:28
Wrapper that contains an Object (T) or an error.
Definition errors.hpp:78
Namespace related to the LIEF's PE module.
Definition Abstract/Header.hpp:31
LIEF namespace.
Definition Abstract/Binary.hpp:41
Definition range.hpp:23
#define LIEF_API
Definition visibility.h:44