CRAM.hpp

Go to the documentation of this file.

/************************************************************************

 Copyright (C) 2011 - 2014 Project Wolframe.
 All rights reserved.

 This file is part of Project Wolframe.

 Commercial Usage
    Licensees holding valid Project Wolframe Commercial licenses may
    use this file in accordance with the Project Wolframe
    Commercial License Agreement provided with the Software or,
    alternatively, in accordance with the terms contained
    in a written agreement between the licensee and Project Wolframe.

 GNU General Public License Usage
    Alternatively, you can redistribute this file and/or modify it
    under the terms of the GNU General Public License as published by
    the Free Software Foundation, either version 3 of the License, or
    (at your option) any later version.

    Wolframe 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 for more details.

    You should have received a copy of the GNU General Public License
    along with Wolframe.  If not, see <http://www.gnu.org/licenses/>.

 If you have questions regarding the use of this file, please contact
 Project Wolframe.

************************************************************************/
//
//

#ifndef _CRAM_HPP_INCLUDED
#define _CRAM_HPP_INCLUDED

#include <string>
#include <system/randomGenerator.hpp>
#include <AAAA/passwordHash.hpp>

namespace _Wolframe {
namespace AAAA {

static const size_t CRAM_BLOCK_SIZE = 512 / 8;
static const size_t CRAM_DIGEST_SIZE = 256 / 8;
static const size_t CRAM_CHALLENGE_SIZE = CRAM_BLOCK_SIZE;
static const size_t CRAM_RESPONSE_SIZE = CRAM_DIGEST_SIZE;
static const size_t CRAM_SALT_SIZE = PASSWORD_SALT_SIZE;

class CRAMchallenge
{
public:
        CRAMchallenge( const crypto::RandomGenerator& rndGen );

        ~CRAMchallenge();

        const unsigned char* challenge() const          { return m_challenge; }
        std::size_t size() const                        { return CRAM_CHALLENGE_SIZE; }

        std::string toBCD() const;
        std::string toString() const;

        std::string toString( const PasswordHash::Salt& salt ) const;

        std::string toString( const PasswordHash& password ) const      {
                return toString( password.salt() );
        }
private:
        unsigned char   m_challenge[ CRAM_CHALLENGE_SIZE ];
};


class CRAMresponse
{
public:
        CRAMresponse( const CRAMchallenge& challenge, const PasswordHash& pwdHash );

        CRAMresponse( const std::string& challenge, const std::string& password );

        ~CRAMresponse();

        const unsigned char* response() const           { return m_response; }
        std::size_t size() const                        { return CRAM_RESPONSE_SIZE; }

        std::string toBCD() const;
        std::string toString() const;

        bool operator == ( const CRAMresponse& rhs );
        bool operator != ( const CRAMresponse& rhs )    { return !( *this == rhs ); }

        bool operator == ( const std::string& rhs );
        bool operator != ( const std::string& rhs )     { return !( *this == rhs ); }
private:
        unsigned char   m_response[ CRAM_RESPONSE_SIZE ];
};

class CRAMsalt
{
public:
        CRAMsalt( const std::string& challenge );

        ~CRAMsalt();

        const unsigned char* salt() const               { return m_salt; }
        std::size_t size() const                        { return CRAM_SALT_SIZE; }

        std::string toBCD() const;
        std::string toString() const;

private:
        unsigned char   m_salt[ CRAM_SALT_SIZE ];
};

}} // namespace _Wolframe::AAAA

#endif  // _CRAM_HPP_INCLUDED