OpenVPN 3 Core Library
Loading...
Searching...
No Matches
korekey.hpp
Go to the documentation of this file.
1// OpenVPN -- An application to securely tunnel IP networks
2// over a single port, with support for SSL/TLS-based
3// session authentication and key exchange,
4// packet encryption, packet authentication, and
5// packet compression.
6//
7// Copyright (C) 2012- OpenVPN Inc.
8//
9// SPDX-License-Identifier: MPL-2.0 OR AGPL-3.0-only WITH openvpn3-openssl-exception
10//
11
12// OpenVPN 3 wrapper for kovpn crypto
13
14#ifndef OPENVPN_KOVPN_KOREKEY_H
15#define OPENVPN_KOVPN_KOREKEY_H
16
18
19namespace openvpn::KoRekey {
20
21class Receiver : public virtual RC<thread_unsafe_refcount>
22{
23 public:
25
26 virtual void rekey(const CryptoDCInstance::RekeyType type,
27 const Info &info) = 0;
28
29 virtual void explicit_exit_notify()
30 {
31 }
32};
33
35{
36 public:
37 Instance(const Receiver::Ptr &rcv_arg,
38 const CryptoDCContext::Ptr &dc_context_delegate,
39 const unsigned int key_id,
40 const Frame::Ptr &frame)
41 : rcv(rcv_arg),
42 info(dc_context_delegate, key_id, frame)
43 {
44 }
45
46 // Initialization
47
48 unsigned int defined() const override
49 {
51 }
52
53 void init_cipher(StaticKey &&encrypt_key,
54 StaticKey &&decrypt_key) override
55 {
56 info.encrypt_cipher = std::move(encrypt_key);
57 info.decrypt_cipher = std::move(decrypt_key);
58 }
59
60 void init_hmac(StaticKey &&encrypt_key,
61 StaticKey &&decrypt_key) override
62 {
63 info.encrypt_hmac = std::move(encrypt_key);
64 info.decrypt_hmac = std::move(decrypt_key);
65 }
66
67 void init_pid(const char *recv_name,
68 const int recv_unit,
69 const SessionStats::Ptr &recv_stats_arg) override
70 {
71 }
72
73 void init_remote_peer_id(const int remote_peer_id) override
74 {
75 info.remote_peer_id = remote_peer_id;
76 }
77
78 bool consider_compression(const CompressContext &comp_ctx) override
79 {
80 info.comp_ctx = comp_ctx;
81 return false;
82 }
83
84 // Rekeying
85
86 void rekey(const RekeyType type) override
87 {
88 rcv->rekey(type, info);
89 }
90
91 void explicit_exit_notify() override
92 {
93 rcv->explicit_exit_notify();
94 }
95
96 // Encrypt/Decrypt -- data channel handled by kernel, so these methods
97 // should never be reached.
98
99 // returns true if packet ID is close to wrapping
100 bool encrypt(BufferAllocated &buf, const unsigned char *op32) override
101 {
102 throw korekey_error("encrypt");
103 }
104
105 Error::Type decrypt(BufferAllocated &buf, const std::time_t now, const unsigned char *op32) override
106 {
107 throw korekey_error("decrypt");
108 }
109
110
111 private:
114};
115
117{
118 public:
120 CryptoDCFactory &dc_factory_delegate,
121 const Receiver::Ptr &rcv_arg,
122 const Frame::Ptr &frame_arg)
123 : CryptoDCContext(dc_settings_data.key_derivation()),
124 rcv(rcv_arg),
125 dc_context_delegate(dc_factory_delegate.new_obj(dc_settings_data)),
126 frame(frame_arg)
127 {
128 Key::validate(dc_settings_data.cipher(), dc_settings_data.digest());
129 }
130
131 CryptoDCInstance::Ptr new_obj(const unsigned int key_id) override
132 {
133 return new Instance(rcv, dc_context_delegate, key_id, frame);
134 }
135
136 // Info for ProtoContext::options_string
141
142 // Info for ProtoContext::link_mtu_adjust
143
144 size_t encap_overhead() const override
145 {
147 }
148
149 private:
153};
154
156{
157 public:
158 Factory(const CryptoDCFactory::Ptr &dc_factory_delegate_arg,
159 const Receiver::Ptr &rcv_arg,
160 const Frame::Ptr &frame_arg)
161 : dc_factory_delegate(dc_factory_delegate_arg),
162 rcv(rcv_arg),
163 frame(frame_arg)
164 {
165 }
166
167 CryptoDCContext::Ptr new_obj(const CryptoDCSettingsData dc_settings_data) override
168 {
169 return new Context(dc_settings_data, *dc_factory_delegate, rcv, frame);
170 }
171
172 private:
176};
177
178} // namespace openvpn::KoRekey
179
180#endif
virtual CryptoDCSettingsData crypto_info()=0
CryptoAlgs::KeyDerivation key_derivation
Definition cryptodc.hpp:179
virtual size_t encap_overhead() const =0
CryptoAlgs::Type cipher() const
Definition cryptodc.hpp:120
CryptoAlgs::Type digest() const
Definition cryptodc.hpp:132
CryptoDCContext::Ptr dc_context_delegate
Definition korekey.hpp:151
Context(CryptoDCSettingsData dc_settings_data, CryptoDCFactory &dc_factory_delegate, const Receiver::Ptr &rcv_arg, const Frame::Ptr &frame_arg)
Definition korekey.hpp:119
CryptoDCSettingsData crypto_info() override
Definition korekey.hpp:137
CryptoDCInstance::Ptr new_obj(const unsigned int key_id) override
Definition korekey.hpp:131
size_t encap_overhead() const override
Definition korekey.hpp:144
CryptoDCContext::Ptr new_obj(const CryptoDCSettingsData dc_settings_data) override
Definition korekey.hpp:167
CryptoDCFactory::Ptr dc_factory_delegate
Definition korekey.hpp:173
Factory(const CryptoDCFactory::Ptr &dc_factory_delegate_arg, const Receiver::Ptr &rcv_arg, const Frame::Ptr &frame_arg)
Definition korekey.hpp:158
void rekey(const RekeyType type) override
Definition korekey.hpp:86
void init_remote_peer_id(const int remote_peer_id) override
Definition korekey.hpp:73
Error::Type decrypt(BufferAllocated &buf, const std::time_t now, const unsigned char *op32) override
Definition korekey.hpp:105
Instance(const Receiver::Ptr &rcv_arg, const CryptoDCContext::Ptr &dc_context_delegate, const unsigned int key_id, const Frame::Ptr &frame)
Definition korekey.hpp:37
unsigned int defined() const override
Definition korekey.hpp:48
bool encrypt(BufferAllocated &buf, const unsigned char *op32) override
Definition korekey.hpp:100
void init_pid(const char *recv_name, const int recv_unit, const SessionStats::Ptr &recv_stats_arg) override
Definition korekey.hpp:67
bool consider_compression(const CompressContext &comp_ctx) override
Definition korekey.hpp:78
void init_cipher(StaticKey &&encrypt_key, StaticKey &&decrypt_key) override
Definition korekey.hpp:53
void explicit_exit_notify() override
Definition korekey.hpp:91
void init_hmac(StaticKey &&encrypt_key, StaticKey &&decrypt_key) override
Definition korekey.hpp:60
static void validate(const CryptoAlgs::Type cipher, const CryptoAlgs::Type digest)
Definition kocrypto.hpp:63
virtual void explicit_exit_notify()
Definition korekey.hpp:29
virtual void rekey(const CryptoDCInstance::RekeyType type, const Info &info)=0
RCPtr< Receiver > Ptr
Definition korekey.hpp:24
The smart pointer class.
Definition rc.hpp:119
Reference count base class for objects tracked by RCPtr. Disallows copying and assignment.
Definition rc.hpp:912
CompressContext comp_ctx
Definition kocrypto.hpp:46