SRP6.h

Go to the documentation of this file.

#ifndef _SRP6_H
#define _SRP6_H
 
#include "AuthDefines.h"
#include "BigNumber.h"
#include "Define.h"
#include "Common.h"
#include "CryptoHash.h"
#include <array>
#include <optional>
 
namespace SkyFire::Crypto
{
    class SRP6
    {
        public:
            static constexpr size_t SALT_LENGTH = 32;
            using Salt = std::array<uint8, SALT_LENGTH>;
            static constexpr size_t VERIFIER_LENGTH = 32;
            using Verifier = std::array<uint8, VERIFIER_LENGTH>;
            static constexpr size_t EPHEMERAL_KEY_LENGTH = 32;
            using EphemeralKey = std::array<uint8, EPHEMERAL_KEY_LENGTH>;
 
            static std::array<uint8, 1> const g;
            static std::array<uint8, 32> const N;
 
            // username + password must be passed through Utf8ToUpperOnlyLatin FIRST!
            static std::pair<Salt, Verifier> MakeRegistrationData(std::string const& username, std::string const& password);
            // username + password must be passed through Utf8ToUpperOnlyLatin FIRST!
            static bool CheckLogin(std::string const& username, std::string const& password, Salt const& salt, Verifier const& verifier)
            {
                return (verifier == CalculateVerifier(username, password, salt));
            }
 
            static SHA1::Digest GetSessionVerifier(EphemeralKey const& A, SHA1::Digest const& clientM, SessionKey const& K)
            {
                return SHA1::GetDigestOf(A, clientM, K);
            }
 
            SRP6(std::string const& username, Salt const& salt, Verifier const& verifier);
            std::optional<SessionKey> VerifyChallengeResponse(EphemeralKey const& A, SHA1::Digest const& clientM);
 
        private:
            bool _used = false; // a single instance can only be used to verify once
 
            static Verifier CalculateVerifier(std::string const& username, std::string const& password, Salt const& salt);
            static SessionKey SHA1Interleave(EphemeralKey const& S);
 
            /* global algorithm parameters */
            static BigNumber const _g; // a [g]enerator for the ring of integers mod N, algorithm parameter
            static BigNumber const _N; // the modulus, an algorithm parameter; all operations are mod this
 
            static EphemeralKey _B(BigNumber const& b, BigNumber const& v) { return ((_g.ModExp(b,_N) + (v * 3)) % N).ToByteArray<EPHEMERAL_KEY_LENGTH>(); }
 
            /* per-instantiation parameters, set on construction */
            SHA1::Digest const _I; // H(I) - the username, all uppercase
            BigNumber const _b; // b - randomly chosen by the server, 19 bytes, never given out
            BigNumber const _v; // v - the user's password verifier, derived from s + H(USERNAME || ":" || PASSWORD)
 
        public:
            Salt const s; // s - the user's password salt, random, used to calculate v on registration
            EphemeralKey const B; // B = 3v + g^b
    };
}
 
#endif