rsn_information.h

/*
 * Copyright (c) 2017, Matias Fontanini
 * All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions are
 * met:
 * 
 * * Redistributions of source code must retain the above copyright
 *   notice, this list of conditions and the following disclaimer.
 * * Redistributions in binary form must reproduce the above
 *   copyright notice, this list of conditions and the following disclaimer
 *   in the documentation and/or other materials provided with the
 *   distribution.
 * 
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
 * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 *
 */

#include <tins/config.h>

#if !defined(TINS_RSN_INFORMATION) && defined(TINS_HAVE_DOT11)
#define TINS_RSN_INFORMATION

#include <stdint.h>
#include <vector>
#include <tins/macros.h>
#include <tins/endianness.h>

namespace Tins{
class Dot11;
template<typename T, typename U>
class PDUOption;
class TINS_API RSNInformation {
public:
    enum CypherSuites {
        WEP_40          = 0x01ac0f00,
        TKIP            = 0x02ac0f00,
        CCMP            = 0x04ac0f00,
        WEP_104         = 0x05ac0f00,
        BIP_CMAC_128    = 0x06ac0f00,
        GCMP_128        = 0x08ac0f00,
        GCMP_256        = 0x09ac0f00,
        CCMP_256        = 0x10ac0f00,
        BIP_GMAC_128    = 0x11ac0f00,
        BIP_GMAC_256    = 0x12ac0f00,
        BIP_CMAC_256    = 0x13ac0f00
    };

    enum AKMSuites {
        EAP                 = 0x01ac0f00,
        PSK                 = 0x02ac0f00,
        EAP_FT              = 0x03ac0f00,
        PSK_FT              = 0x04ac0f00,
        EAP_SHA256          = 0x05ac0f00,
        PSK_SHA256          = 0x06ac0f00,
        TDLS                = 0x07ac0f00,
        SAE_SHA256          = 0x08ac0f00,
        SAE_FT              = 0x09ac0f00,
        APPEERKEY           = 0x10ac0f00,
        EAP_SHA256_FIPSB    = 0x11ac0f00,
        EAP_SHA384_FIPSB    = 0x12ac0f00,
        EAP_SHA384          = 0x13ac0f00
    };

    typedef std::vector<CypherSuites> cyphers_type;
    
    typedef std::vector<AKMSuites> akm_type;
    
    typedef std::vector<uint8_t> serialization_type;

    RSNInformation();
    
    RSNInformation(const serialization_type& buffer);
    
    RSNInformation(const uint8_t* buffer, uint32_t total_sz);

    static RSNInformation wpa2_psk();

    void add_pairwise_cypher(CypherSuites cypher);

    void add_akm_cypher(AKMSuites akm);

    void group_suite(CypherSuites group);

    void version(uint16_t ver);

    void capabilities(uint16_t cap);

    /* Getters */

    CypherSuites group_suite() const { 
        return static_cast<CypherSuites>(Endian::le_to_host<uint32_t>(group_suite_)); 
    }

    uint16_t version() const {
        return Endian::le_to_host(version_);
    }
    
    uint16_t capabilities() const {
        return Endian::le_to_host(capabilities_);
    }

    const cyphers_type& pairwise_cyphers() const {
        return pairwise_cyphers_;
    }

    const akm_type& akm_cyphers() const {
        return akm_cyphers_;
    }

     serialization_type serialize() const;
     
     static RSNInformation from_option(const PDUOption<uint8_t, Dot11>& opt);
private:
    void init(const uint8_t* buffer, uint32_t total_sz);

    uint16_t version_, capabilities_;
    CypherSuites group_suite_;
    akm_type akm_cyphers_;
    cyphers_type pairwise_cyphers_;
};
} // namespace Tins

#endif // TINS_RSN_INFORMATION