dot11decrypt_user.h

Go to the documentation of this file.

 
#ifndef _DOT11DECRYPT_USER_H
#define _DOT11DECRYPT_USER_H
 
/******************************************************************************/
/*  File includes                                                                                   */
/*                                                                                                      */
#include <glib.h>
 
#include "ws_symbol_export.h"
 
/*                                                                                                      */
/*                                                                                                      */
/******************************************************************************/
 
/******************************************************************************/
/*  Constant definitions                                                                            */
/*                                                                                                      */
/*  Decryption key types                                                                            */
#define DOT11DECRYPT_KEY_TYPE_WEP       0
#define DOT11DECRYPT_KEY_TYPE_WEP_40    1
#define DOT11DECRYPT_KEY_TYPE_WEP_104   2
#define DOT11DECRYPT_KEY_TYPE_WPA_PWD   3
#define DOT11DECRYPT_KEY_TYPE_WPA_PSK   4
#define DOT11DECRYPT_KEY_TYPE_WPA_PMK   5
#define DOT11DECRYPT_KEY_TYPE_TK        6
#define DOT11DECRYPT_KEY_TYPE_MSK       7
 
#define DOT11DECRYPT_KEY_TYPE_TKIP      100
#define DOT11DECRYPT_KEY_TYPE_CCMP      101
#define DOT11DECRYPT_KEY_TYPE_CCMP_256  102
#define DOT11DECRYPT_KEY_TYPE_GCMP      103
#define DOT11DECRYPT_KEY_TYPE_GCMP_256  104
#define DOT11DECRYPT_KEY_TYPE_UNKNOWN   -1
 
/*  Decryption algorithms fields size definition (bytes)                                */
#define DOT11DECRYPT_WEP_KEY_MINLEN     1
#define DOT11DECRYPT_WEP_KEY_MAXLEN     32
#define DOT11DECRYPT_WEP_40_KEY_LEN     5
#define DOT11DECRYPT_WEP_104_KEY_LEN    13
 
#define DOT11DECRYPT_WPA_PASSPHRASE_MIN_LEN 8
#define DOT11DECRYPT_WPA_PASSPHRASE_MAX_LEN 63  /* null-terminated string, the actual length of the storage is 64   */
#define DOT11DECRYPT_WPA_SSID_MIN_LEN           0
#define DOT11DECRYPT_WPA_SSID_MAX_LEN           32
#define DOT11DECRYPT_WPA_PMK_MAX_LEN                64
#define DOT11DECRYPT_WPA_PWD_PSK_LEN                32
#define DOT11DECRYPT_TK_MAX_LEN                 32
#define DOT11DECRYPT_MSK_MIN_LEN                64
#define DOT11DECRYPT_MSK_MAX_LEN                128
/*                                                                                                      */
/*                                                                                                      */
/******************************************************************************/
 
/******************************************************************************/
/*  Macro definitions                                                                               */
/*                                                                                                      */
/*                                                                                                      */
/******************************************************************************/
 
/******************************************************************************/
/*  Type definitions                                                                                */
/*                                                                                                      */
typedef struct {
    GByteArray *key;
    GByteArray *ssid;
    bool        tk_mld;
    uint8_t     ap_mld_mac[6];
    uint8_t     sta_mld_mac[6];
    unsigned    bits;
    unsigned    type;
} decryption_key_t;
 
typedef struct _DOT11DECRYPT_KEY_ITEM {
    uint8_t KeyType;
 
    union DOT11DECRYPT_KEY_ITEMDATA {
        struct DOT11DECRYPT_KEY_ITEMDATA_WEP {
            unsigned char WepKey[DOT11DECRYPT_WEP_KEY_MAXLEN];
            size_t WepKeyLen;
        } Wep;
 
        struct DOT11DECRYPT_KEY_ITEMDATA_WPA {
            unsigned char Psk[DOT11DECRYPT_WPA_PMK_MAX_LEN];
            unsigned char Ptk[DOT11DECRYPT_WPA_PTK_MAX_LEN];
            uint8_t PskLen;
            uint8_t PtkLen;
            uint8_t Akm;
            uint8_t Cipher;
        } Wpa;
 
    } KeyData;
 
    struct DOT11DECRYPT_KEY_ITEMDATA_TK {
        uint8_t Tk[DOT11DECRYPT_TK_MAX_LEN]; 
        uint8_t Len;                          
        bool    mld;                          
        uint8_t ap_mld_mac[6];               
        uint8_t sta_mld_mac[6];              
    } Tk;
 
    struct DOT11DECRYPT_KEY_ITEMDATA_MSK {
        uint8_t Msk[DOT11DECRYPT_MSK_MAX_LEN]; 
        uint8_t Len;                            
    } Msk;
 
    struct DOT11DECRYPT_KEY_ITEMDATA_PWD {
            char Passphrase[DOT11DECRYPT_WPA_PASSPHRASE_MAX_LEN];
            size_t PassphraseLen;
            char Ssid[DOT11DECRYPT_WPA_SSID_MAX_LEN];
            size_t SsidLen;
    } UserPwd;
} DOT11DECRYPT_KEY_ITEM, *PDOT11DECRYPT_KEY_ITEM;
 
typedef struct _DOT11DECRYPT_KEYS_COLLECTION {
    size_t nKeys;
 
    DOT11DECRYPT_KEY_ITEM Keys[256];
} DOT11DECRYPT_KEYS_COLLECTION, *PDOT11DECRYPT_KEYS_COLLECTION;
/*                                                                                                      */
/******************************************************************************/
 
/******************************************************************************/
/*  Function prototype declarations                                                         */
 
WS_DLL_PUBLIC
decryption_key_t*
parse_key_string(char* key_string, uint8_t key_type, char **error);
 
WS_DLL_PUBLIC
void
free_key_string(decryption_key_t *dk);
 
/******************************************************************************/
 
#endif /* _DOT11DECRYPT_USER_H */