TrinityCore
Loading...
Searching...
No Matches
SRP6.cpp
Go to the documentation of this file.
1/*
2 * This file is part of the TrinityCore Project. See AUTHORS file for Copyright information
3 *
4 * This program is free software; you can redistribute it and/or modify it
5 * under the terms of the GNU General Public License as published by the
6 * Free Software Foundation; either version 2 of the License, or (at your
7 * option) any later version.
8 *
9 * This program is distributed in the hope that it will be useful, but WITHOUT
10 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
11 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
12 * more details.
13 *
14 * You should have received a copy of the GNU General Public License along
15 * with this program. If not, see <http://www.gnu.org/licenses/>.
16 */
17
18#include "SRP6.h"
19#include "Common.h"
20#include "CryptoRandom.h"
21#include <algorithm>
22#include <functional>
23
25{
26BigNumber const GruntSRP6::N = "894B645E89E1535BBDAD5B8B290650530801B18EBFBF5E8FAB3C82872A3E9BB7"s;
27BigNumber const GruntSRP6::g = 7;
28
29BigNumber const BnetSRP6v1Base::N = "86A7F6DEEB306CE519770FE37D556F29944132554DED0BD68205E27F3231FEF5A10108238A3150C59CAF7B0B6478691C13A6ACF5E1B5ADAFD4A943D4A21A142B800E8A55F8BFBAC700EB77A7235EE5A609E350EA9FC19F10D921C2FA832E4461B7125D38D254A0BE873DFC27858ACB3F8B9F258461E4373BC3A6C2A9634324AB"s;
31
32BigNumber const BnetSRP6v2Base::N = "AC6BDB41324A9A9BF166DE5E1389582FAF72B6651987EE07FC3192943DB56050A37329CBB4A099ED8193E0757767A13DD52312AB4B03310DCD7F48A9DA04FD50E8083969EDB767B0CF6095179A163AB3661A05FBD5FAAAE82918A9962F0B93B855F97993EC975EEAA80D740ADBF4FF747359D041D5C33EA71D281E446B14773BCA97B43A23FB801676BD207A436C6481F1D2B9078717461A5B9D32E688F87748544523B524B0D57D5EA77A2775D2ECFA032CFBDBF52FB3786160279004E57AE6AF874E7303CE53299CCC041C7BC308D82A5698F3A8D0C38271AE35F8E9DBFBB694B5C803D89F7AE435DE236D525F54759B65E372FCD68EF20FA7111F9E4AFF73"s;
34
35SRP6::SRP6(BigNumber const& i, Salt const& salt, Verifier const& verifier, BigNumber const& N, BigNumber const& g, BigNumber const& k)
36 : s(salt), I(i), b(CalculatePrivateB(N)), v(verifier), B(CalculatePublicB(N, g, k))
37{
38}
39
44
46{
47 ASSERT(!_used, "A single SRP6 object must only ever be used to verify ONCE!");
48 _used = true;
49
50 return DoVerifyClientEvidence(A, clientM1);
51}
52
53bool SRP6::CheckCredentials(std::string const& username, std::string const& password) const
54{
55 return v == CalculateVerifier(username, password, s);
56}
57
59{
61 b.SetRand(N.GetNumBits());
62 b %= N - 1;
63 return b;
64}
65
67{
68 return (g.ModExp(b, N) + (v * k)) % N;
69}
70
71Verifier SRP6::CalculateVerifier(std::string const& username, std::string const& password, Salt const& salt) const
72{
73 // v = g ^ H(s || H(u || ':' || p)) mod N
74 return Getg().ModExp(
75 CalculateX(username, password, salt),
76 GetN()
77 ).ToByteVector();
78}
79
80GruntSRP6::GruntSRP6(std::string const& username, Salt const& salt, Verifier const& verifier)
81 : SRP6(SHA1::GetDigestOf(username), salt, verifier, N, g, 3)
82{
83}
84
89
90BigNumber GruntSRP6::CalculateX(std::string const& username, std::string const& password, Salt const& salt) const
91{
92 return SHA1::GetDigestOf(
93 salt,
94 SHA1::GetDigestOf(username, ":", password)
95 );
96}
97
99{
100 if ((A % N).IsZero())
101 return {};
102
104 EphemeralKey const S = (A * (v.ModExp(u, N))).ModExp(b, N).ToByteArray<EPHEMERAL_KEY_LENGTH>();
105
107
108 // NgHash = H(N) xor H(g)
109 SHA1::Digest const NHash = SHA1::GetDigestOf(N.ToByteArray<32>());
110 SHA1::Digest const gHash = SHA1::GetDigestOf(g.ToByteArray<1>());
111 SHA1::Digest NgHash;
112 std::transform(NHash.begin(), NHash.end(), gHash.begin(), NgHash.begin(), std::bit_xor<>());
113
115 if (ourM == clientM1)
116 return K;
117
118 return {};
119}
120
122{
123 // split S into two buffers
124 std::array<uint8, EPHEMERAL_KEY_LENGTH / 2> buf0, buf1;
125 for (size_t i = 0; i < S.size() / 2; ++i)
126 {
127 buf0[i] = S[2 * i + 0];
128 buf1[i] = S[2 * i + 1];
129 }
130
131 // find position of first nonzero byte
132 size_t p = 0;
133 while (p < S.size() && !S[p]) ++p;
134 if (p & 1) ++p; // skip one extra byte if p is odd
135 p /= 2; // offset into buffers
136
137 // hash each of the halves, starting at the first nonzero byte
138 SHA1::Digest const hash0 = SHA1::GetDigestOf(buf0.data() + p, S.size() / 2 - p);
139 SHA1::Digest const hash1 = SHA1::GetDigestOf(buf1.data() + p, S.size() / 2 - p);
140
141 // stick the two hashes back together
142 SessionKey K;
143 for (size_t i = 0; i < SHA1::DIGEST_LENGTH; ++i)
144 {
145 K[2 * i + 0] = hash0[i];
146 K[2 * i + 1] = hash1[i];
147 }
148 return K;
149}
150
151BnetSRP6Base::BnetSRP6Base(BigNumber const& i, Salt const& salt, Verifier const& verifier, BigNumber const& N, BigNumber const& g, BigNumber const& k)
152 : SRP6(i, salt, verifier, N, g, k)
153{
154}
155
157{
158 std::array evidenceBns{ &A, &clientM1, &K };
159 return DoCalculateEvidence(evidenceBns);
160}
161
163{
164 BigNumber N = GetN();
165 if ((A % N).IsZero())
166 return {};
167
168 BigNumber const u = CalculateU(A);
169 if ((u % N).IsZero())
170 return {};
171
172 BigNumber const S = (A * v.ModExp(u, N)).ModExp(b, N);
173
174 std::array evidenceBns{ &A, &B, &S };
175 BigNumber const ourM = DoCalculateEvidence(evidenceBns);
176 if (ourM != clientM1)
177 return {};
178
179 return S;
180}
181
183{
184 int32 bytes = (bn.GetNumBits() + 8) >> 3;
185 return bn.ToByteVector(bytes, false);
186}
187
188BnetSRP6v1Base::BnetSRP6v1Base(std::string const& username, Salt const& salt, Verifier const& verifier, BigNumber const& k)
189 : BnetSRP6Base(SHA256::GetDigestOf(username), salt, verifier, N, g, k)
190{
191}
192
193BigNumber BnetSRP6v1Base::CalculateX(std::string const& username, std::string const& password, Salt const& salt) const
194{
195 return SHA256::GetDigestOf(
196 salt,
197 SHA256::GetDigestOf(username, ":", password)
198 );
199}
200
201BnetSRP6v2Base::BnetSRP6v2Base(std::string const& username, Salt const& salt, Verifier const& verifier, BigNumber const& k)
202 : BnetSRP6Base(SHA256::GetDigestOf(username), salt, verifier, N, g, k)
203{
204}
205
206BigNumber BnetSRP6v2Base::CalculateX(std::string const& username, std::string const& password, Salt const& salt) const
207{
208 SHA512::Digest xBytes = {};
209 std::string tmp = username + ":" + password;
210 PKCS5_PBKDF2_HMAC(tmp.c_str(), tmp.length(), salt.data(), salt.size(), GetXIterations(), EVP_sha512(), xBytes.size(), xBytes.data());
211 BigNumber x(xBytes, false);
212 if (xBytes[0] & 0x80)
213 {
214 std::array<uint8, 65> fix = {};
215 fix[64] = 1;
216 x -= fix;
217 }
218
219 return x % (N - 1);
220}
221}
uint8_t uint8
Definition Define.h:156
int32_t int32
Definition Define.h:150
#define ASSERT
Definition Errors.h:80
std::optional< T > Optional
Optional helper class to wrap optional values within.
Definition Optional.h:25
BigNumber ModExp(BigNumber const &bn1, BigNumber const &bn2) const
std::vector< uint8 > ToByteVector(int32 minSize=0, bool littleEndian=true) const
std::array< uint8, Size > ToByteArray(bool littleEndian=true) const
Definition BigNumber.h:134
void SetRand(int32 numbits)
Definition BigNumber.cpp:76
int32 GetNumBits() const
static std::vector< uint8 > GetBrokenEvidenceVector(BigNumber const &bn)
Definition SRP6.cpp:182
BigNumber CalculateServerEvidence(BigNumber const &A, BigNumber const &clientM1, BigNumber const &K) const final
Definition SRP6.cpp:156
Optional< BigNumber > DoVerifyClientEvidence(BigNumber const &A, BigNumber const &clientM1) final
Definition SRP6.cpp:162
BnetSRP6Base(BigNumber const &i, Salt const &salt, Verifier const &verifier, BigNumber const &N, BigNumber const &g, BigNumber const &k)
Definition SRP6.cpp:151
virtual BigNumber CalculateU(BigNumber const &A) const =0
virtual BigNumber DoCalculateEvidence(std::span< BigNumber const * > bns) const =0
static BigNumber const g
Definition SRP6.h:157
BigNumber CalculateX(std::string const &username, std::string const &password, Salt const &salt) const final
Definition SRP6.cpp:193
BnetSRP6v1Base(std::string const &username, Salt const &salt, Verifier const &verifier, BigNumber const &k)
Definition SRP6.cpp:188
static BigNumber const N
Definition SRP6.h:156
BigNumber CalculateX(std::string const &username, std::string const &password, Salt const &salt) const final
Definition SRP6.cpp:206
static BigNumber const N
Definition SRP6.h:175
BnetSRP6v2Base(std::string const &username, Salt const &salt, Verifier const &verifier, BigNumber const &k)
Definition SRP6.cpp:201
static BigNumber const g
Definition SRP6.h:176
uint32 GetXIterations() const final
Definition SRP6.h:185
Optional< BigNumber > DoVerifyClientEvidence(BigNumber const &A, BigNumber const &clientM1) override
Definition SRP6.cpp:98
static BigNumber const g
Definition SRP6.h:103
std::array< uint8, EPHEMERAL_KEY_LENGTH > EphemeralKey
Definition SRP6.h:98
BigNumber CalculateServerEvidence(BigNumber const &A, BigNumber const &clientM1, BigNumber const &K) const override
Definition SRP6.cpp:85
static SessionKey SHA1Interleave(EphemeralKey const &S)
Definition SRP6.cpp:121
static BigNumber const N
Definition SRP6.h:102
BigNumber CalculateX(std::string const &username, std::string const &password, Salt const &salt) const override
Definition SRP6.cpp:90
static constexpr size_t EPHEMERAL_KEY_LENGTH
Definition SRP6.h:96
GruntSRP6(std::string const &username, Salt const &salt, Verifier const &verifier)
Definition SRP6.cpp:80
std::array< uint8, SHA1::DIGEST_LENGTH *2 > SessionKey
Definition SRP6.h:100
BigNumber const I
Definition SRP6.h:82
static BigNumber CalculatePrivateB(BigNumber const &N)
Definition SRP6.cpp:58
Optional< BigNumber > VerifyClientEvidence(BigNumber const &A, BigNumber const &clientM1)
Definition SRP6.cpp:45
SRP6(BigNumber const &i, Salt const &salt, Verifier const &verifier, BigNumber const &N, BigNumber const &g, BigNumber const &k)
Definition SRP6.cpp:35
virtual BigNumber const & Getg() const =0
virtual Optional< BigNumber > DoVerifyClientEvidence(BigNumber const &A, BigNumber const &clientM1)=0
virtual BigNumber CalculateX(std::string const &username, std::string const &password, Salt const &salt) const =0
virtual BigNumber const & GetN() const =0
BigNumber const v
Definition SRP6.h:84
BigNumber CalculatePublicB(BigNumber const &N, BigNumber const &g, BigNumber const &k) const
Definition SRP6.cpp:66
Verifier CalculateVerifier(std::string const &username, std::string const &password, Salt const &salt) const
Definition SRP6.cpp:71
bool CheckCredentials(std::string const &username, std::string const &password) const
Definition SRP6.cpp:53
BigNumber const b
Definition SRP6.h:83
BigNumber const B
Definition SRP6.h:87
std::array< uint8, DIGEST_LENGTH > Digest
Definition CryptoHash.h:47
static constexpr size_t DIGEST_LENGTH
Definition CryptoHash.h:46
static Digest GetDigestOf(uint8 const *data, size_t len)
Definition CryptoHash.h:49
std::array< uint8, SALT_LENGTH > Salt
Definition SRP6.h:33
std::vector< uint8 > Verifier
Definition SRP6.h:35
static constexpr size_t SALT_LENGTH
Definition SRP6.h:32
std::array< uint8, S > GetRandomBytes()