iPXE
Functions | Variables
wpa_psk.c File Reference

Frontend for WPA using a pre-shared key. More...

#include <string.h>
#include <ipxe/net80211.h>
#include <ipxe/sha1.h>
#include <ipxe/wpa.h>
#include <errno.h>

Go to the source code of this file.

Functions

 FILE_LICENCE (GPL2_OR_LATER)
 
 FILE_SECBOOT (FORBIDDEN)
 
static int wpa_psk_init (struct net80211_device *dev)
 Initialise WPA-PSK state. More...
 
static int wpa_psk_start (struct net80211_device *dev)
 Start WPA-PSK authentication. More...
 
static int wpa_psk_step (struct net80211_device *dev)
 Step WPA-PSK authentication. More...
 
static int wpa_psk_no_change_key (struct net80211_device *dev __unused)
 Do-nothing function; you can't change a WPA key post-authentication. More...
 
static void wpa_psk_stop (struct net80211_device *dev)
 Disable handling of received WPA authentication frames. More...
 

Variables

struct net80211_handshaker wpa_psk_handshaker __net80211_handshaker
 WPA-PSK security handshaker. More...
 

Detailed Description

Frontend for WPA using a pre-shared key.

Definition in file wpa_psk.c.

Function Documentation

◆ FILE_LICENCE()

FILE_LICENCE ( GPL2_OR_LATER  )

◆ FILE_SECBOOT()

FILE_SECBOOT ( FORBIDDEN  )

◆ wpa_psk_init()

static int wpa_psk_init ( struct net80211_device *  dev)
static

Initialise WPA-PSK state.

Parameters
dev802.11 device
Return values
rcReturn status code

Definition at line 40 of file wpa_psk.c.

41 {
42  return wpa_make_rsn_ie ( dev, &dev->rsn_ie );
43 }
net80211_device::rsn_ie
union ieee80211_ie * rsn_ie
RSN or WPA information element to include with association.
Definition: net80211.h:932
wpa_make_rsn_ie
int wpa_make_rsn_ie(struct net80211_device *dev, union ieee80211_ie **ie_ret)
Construct RSN or WPA information element.
Definition: wpa.c:125

References net80211_device::rsn_ie, and wpa_make_rsn_ie().

◆ wpa_psk_start()

static int wpa_psk_start ( struct net80211_device *  dev)
static

Start WPA-PSK authentication.

Parameters
dev802.11 device
Return values
rcReturn status code

Definition at line 51 of file wpa_psk.c.

52 {
53  char passphrase[64+1];
54  u8 pmk[WPA_PMK_LEN];
55  int len;
56  struct wpa_common_ctx *ctx = dev->handshaker->priv;
57 
58  len = fetch_string_setting ( netdev_settings ( dev->netdev ),
59  &net80211_key_setting, passphrase,
60  64 + 1 );
61 
62  if ( len <= 0 ) {
63  DBGC ( ctx, "WPA-PSK %p: no passphrase provided!\n", ctx );
64  net80211_deauthenticate ( dev, -EACCES );
65  return -EACCES;
66  }
67 
68  pbkdf2_sha1 ( passphrase, len, dev->essid, strlen ( dev->essid ),
69  4096, pmk, WPA_PMK_LEN );
70 
71  DBGC ( ctx, "WPA-PSK %p: derived PMK from passphrase `%s':\n", ctx,
72  passphrase );
73  DBGC_HD ( ctx, pmk, WPA_PMK_LEN );
74 
75  return wpa_start ( dev, ctx, pmk, WPA_PMK_LEN );
76 }
wpa_common_ctx::dev
struct net80211_device * dev
802.11 device we are authenticating for
Definition: wpa.h:294
DBGC
#define DBGC(...)
Definition: compiler.h:505
EACCES
#define EACCES
Permission denied.
Definition: errno.h:299
ctx
struct golan_eq_context ctx
Definition: CIB_PRM.h:28
net80211_deauthenticate
void net80211_deauthenticate(struct net80211_device *dev, int rc)
Deauthenticate from current network and try again.
Definition: net80211.c:2391
netdev_settings
static struct settings * netdev_settings(struct net_device *netdev)
Get per-netdevice configuration settings block.
Definition: netdevice.h:587
wpa_common_ctx::pmk
u8 pmk[WPA_PMK_LEN]
The Pairwise Master Key to use in handshaking.
Definition: wpa.h:303
net80211_device::essid
char essid[IEEE80211_MAX_SSID_LEN+1]
SSID of the access point we are or will be associated with.
Definition: net80211.h:962
WPA_PMK_LEN
#define WPA_PMK_LEN
Usual length of a Pairwise Master Key.
Definition: wpa.h:222
net80211_handshaker::priv
void * priv
Pointer to private data.
Definition: net80211.h:672
len
ring len
Length.
Definition: dwmac.h:231
wpa_common_ctx
Common context for WPA security handshaking.
Definition: wpa.h:291
fetch_string_setting
int fetch_string_setting(struct settings *settings, const struct setting *setting, char *data, size_t len)
Fetch value of string setting.
Definition: settings.c:842
pbkdf2_sha1
void pbkdf2_sha1(const void *passphrase, size_t pass_len, const void *salt, size_t salt_len, int iterations, void *key, size_t key_len)
PBKDF2 key derivation function using SHA1.
Definition: sha1extra.c:148
DBGC_HD
#define DBGC_HD(...)
Definition: compiler.h:507
strlen
size_t strlen(const char *src)
Get length of string.
Definition: string.c:244
net80211_device::handshaker
struct net80211_handshaker * handshaker
Security handshaker being used.
Definition: net80211.h:879
wpa_start
int wpa_start(struct net80211_device *dev, struct wpa_common_ctx *ctx, const void *pmk, size_t pmk_len)
Set up generic WPA support to handle 4-Way Handshake.
Definition: wpa.c:217
net80211_device::netdev
struct net_device * netdev
The net_device that wraps us.
Definition: net80211.h:789
u8
uint8_t u8
Definition: stdint.h:20

References ctx, DBGC, DBGC_HD, wpa_common_ctx::dev, EACCES, net80211_device::essid, fetch_string_setting(), net80211_device::handshaker, len, net80211_deauthenticate(), net80211_device::netdev, netdev_settings(), pbkdf2_sha1(), wpa_common_ctx::pmk, net80211_handshaker::priv, strlen(), WPA_PMK_LEN, and wpa_start().

◆ wpa_psk_step()

static int wpa_psk_step ( struct net80211_device *  dev)
static

Step WPA-PSK authentication.

Parameters
dev802.11 device
Return values
rcReturn status code

Definition at line 84 of file wpa_psk.c.

85 {
86  struct wpa_common_ctx *ctx = dev->handshaker->priv;
87 
88  switch ( ctx->state ) {
89  case WPA_SUCCESS:
90  return 1;
91  case WPA_FAILURE:
92  return -EACCES;
93  default:
94  return 0;
95  }
96 }
wpa_common_ctx::dev
struct net80211_device * dev
802.11 device we are authenticating for
Definition: wpa.h:294
EACCES
#define EACCES
Permission denied.
Definition: errno.h:299
ctx
struct golan_eq_context ctx
Definition: CIB_PRM.h:28
net80211_handshaker::priv
void * priv
Pointer to private data.
Definition: net80211.h:672
WPA_SUCCESS
4-Way Handshake succeeded
Definition: wpa.h:187
wpa_common_ctx
Common context for WPA security handshaking.
Definition: wpa.h:291
net80211_device::handshaker
struct net80211_handshaker * handshaker
Security handshaker being used.
Definition: net80211.h:879
WPA_FAILURE
4-Way Handshake failed
Definition: wpa.h:190

References ctx, wpa_common_ctx::dev, EACCES, net80211_device::handshaker, net80211_handshaker::priv, WPA_FAILURE, and WPA_SUCCESS.

◆ wpa_psk_no_change_key()

static int wpa_psk_no_change_key ( struct net80211_device *dev  __unused)
static

Do-nothing function; you can't change a WPA key post-authentication.

Parameters
dev802.11 device
Return values
rcReturn status code

Definition at line 104 of file wpa_psk.c.

105 {
106  return 0;
107 }

◆ wpa_psk_stop()

static void wpa_psk_stop ( struct net80211_device *  dev)
static

Disable handling of received WPA authentication frames.

Parameters
dev802.11 device

Definition at line 114 of file wpa_psk.c.

115 {
116  wpa_stop ( dev );
117 }
wpa_common_ctx::dev
struct net80211_device * dev
802.11 device we are authenticating for
Definition: wpa.h:294
wpa_stop
void wpa_stop(struct net80211_device *dev)
Disable handling of received WPA handshake frames.
Definition: wpa.c:261

References wpa_common_ctx::dev, and wpa_stop().

Variable Documentation

◆ __net80211_handshaker

struct net80211_handshaker wpa_psk_handshaker __net80211_handshaker
Initial value:
= {
.protocol = NET80211_SECPROT_PSK,
.init = wpa_psk_init,
.start = wpa_psk_start,
.step = wpa_psk_step,
.change_key = wpa_psk_no_change_key,
.stop = wpa_psk_stop,
.priv_len = sizeof ( struct wpa_common_ctx ),
}
wpa_psk_step
static int wpa_psk_step(struct net80211_device *dev)
Step WPA-PSK authentication.
Definition: wpa_psk.c:84
wpa_psk_start
static int wpa_psk_start(struct net80211_device *dev)
Start WPA-PSK authentication.
Definition: wpa_psk.c:51
NET80211_SECPROT_PSK
Pre-shared key handshaking.
Definition: net80211.h:112
wpa_psk_stop
static void wpa_psk_stop(struct net80211_device *dev)
Disable handling of received WPA authentication frames.
Definition: wpa_psk.c:114
wpa_psk_init
static int wpa_psk_init(struct net80211_device *dev)
Initialise WPA-PSK state.
Definition: wpa_psk.c:40
wpa_common_ctx
Common context for WPA security handshaking.
Definition: wpa.h:291
wpa_psk_no_change_key
static int wpa_psk_no_change_key(struct net80211_device *dev __unused)
Do-nothing function; you can't change a WPA key post-authentication.
Definition: wpa_psk.c:104

WPA-PSK security handshaker.

Definition at line 120 of file wpa_psk.c.

Generated by   doxygen 1.8.15