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
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
|
/*
Copyright (c) 2017, 2025, Oracle and/or its affiliates.
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License, version 2.0,
as published by the Free Software Foundation.
This program is designed to work with certain software (including
but not limited to OpenSSL) that is licensed under separate terms,
as designated in a particular file or component or in included license
documentation. The authors of MySQL hereby grant you an additional
permission to link the program and your derivative works with the
separately licensed software that they have either included with
the program or referenced in the documentation.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License, version 2.0, for more details.
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA */
#ifndef I_SHA2_PASSWORD_COMMON_INCLUDED
#define I_SHA2_PASSWORD_COMMON_INCLUDED
#include <openssl/evp.h>
#include "openssl/ossl_typ.h"
#include "sha2.h" /* SHA256_DIGEST_LENGTH */
#include <string>
/**
@file sql/auth/i_sha2_password_common.h
Classes for caching_sha2_authentication plugin
*/
/**
@defgroup auth_caching_sha2_auth caching_sha2_authentication information
@{
*/
namespace sha2_password {
/* Digest length for caching_sha2_authentication plugin */
const unsigned int CACHING_SHA2_DIGEST_LENGTH = SHA256_DIGEST_LENGTH;
/**
Supported digest information
*/
enum class Digest_info { SHA256_DIGEST = 0, DIGEST_LAST };
/**
Interface for cryptographic digest generation
*/
class Generate_digest {
public:
virtual bool update_digest(const void *src, unsigned int length) = 0;
virtual bool retrieve_digest(unsigned char *digest, unsigned int length) = 0;
virtual void scrub() = 0;
virtual ~Generate_digest() = default;
};
/**
SHA256 digest generator
@sa Generate_digest
@sa Digest_info
*/
class SHA256_digest : public Generate_digest {
public:
SHA256_digest();
~SHA256_digest() override;
bool update_digest(const void *src, unsigned int length) override;
bool retrieve_digest(unsigned char *digest, unsigned int length) override;
void scrub() override;
bool all_ok() { return m_ok; }
private:
void init();
void deinit();
private:
/** Digest output buffer */
unsigned char m_digest[CACHING_SHA2_DIGEST_LENGTH];
/** Digest context */
EVP_MD_CTX *md_context;
/** Status */
bool m_ok;
};
/**
Scramble generator
Responsible for generating scramble of following format:
XOR(SHA2(m_src), SHA2(SHA2(SHA2(m_src)), m_rnd))
@sa SHA256_digest
@sa Digest_info
*/
class Generate_scramble {
public:
Generate_scramble(const std::string source, const std::string rnd,
Digest_info digest_type = Digest_info::SHA256_DIGEST);
~Generate_scramble();
bool scramble(unsigned char *scramble, unsigned int scramble_length);
private:
/** plaintext source string */
std::string m_src;
/** random string */
std::string m_rnd;
/** Type of digest */
Digest_info m_digest_type;
/** Digest generator class */
Generate_digest *m_digest_generator;
/** length of the digest */
unsigned int m_digest_length;
};
/**
Scramble validator
Expects scramble to be:
XOR(SHA2(m_src), SHA2(SHA2(SHA2(m_src)), m_rnd))
Validates it against:
SHA2(SHA2(m_src)) and random string
@sa Generate_scramble
@sa SHA256_digest
@sa Digest_info
*/
class Validate_scramble {
public:
Validate_scramble(const unsigned char *scramble, const unsigned char *known,
const unsigned char *rnd, unsigned int rnd_length,
Digest_info digest_type = Digest_info::SHA256_DIGEST);
~Validate_scramble();
bool validate();
private:
/** scramble to be validated */
const unsigned char *m_scramble;
/** SHA2(SHA2(plaintext_password)) */
const unsigned char *m_known;
/** random string */
const unsigned char *m_rnd;
/** random string length*/
unsigned int m_rnd_length;
/** Type of digest */
Digest_info m_digest_type;
/** Digest generator class */
Generate_digest *m_digest_generator;
/** length of the digest */
unsigned int m_digest_length;
};
} // namespace sha2_password
/** @} (end of auth_caching_sha2_auth) */
#endif // !I_SHA2_PASSWORD_INCLUDED
|
