wpa_cred Struct Reference

Data Fields
struct wpa_cred *	next
	Next credential in the list.
int	id
	Unique id for the credential.
int	priority
	Priority group.
int	pcsc
	Use PC/SC and SIM/USIM card.
char *	realm
	Home Realm for Interworking.
char *	username
	Username for Interworking network selection.
char *	password
	Password for Interworking network selection.
char *	ca_cert
	CA certificate for Interworking network selection.
char *	client_cert
	File path to client certificate file (PEM/DER)
char *	private_key
	File path to client private key file (PEM/DER/PFX)
char *	private_key_passwd
	Password for private key file.
char *	imsi
	IMSI in <MCC> | <MNC> | '-' | <MSIN> format.
char *	milenage
	Milenage parameters for SIM/USIM simulator in.
char *	domain
	Home service provider FQDN.

---

Field Documentation

char* wpa_cred::client_cert

File path to client certificate file (PEM/DER)

This field is used with Interworking networking selection for a case where client certificate/private key is used for authentication (EAP-TLS). Full path to the file should be used since working directory may change when wpa_supplicant is run in the background.

Alternatively, a named configuration blob can be used by setting this to blob://blob_name.

char* wpa_cred::domain

Home service provider FQDN.

This is used to compare against the Domain Name List to figure out whether the AP is operated by the Home SP.

int wpa_cred::id

Unique id for the credential.

This identifier is used as a unique identifier for each credential block when using the control interface. Each credential is allocated an id when it is being created, either when reading the configuration file or when a new credential is added through the control interface.

char* wpa_cred::milenage

Milenage parameters for SIM/USIM simulator in.

<Ki>:<OPc>:<SQN> format

struct wpa_cred* wpa_cred::next

Next credential in the list.

This pointer can be used to iterate over all credentials. The head of this list is stored in the cred field of struct wpa_config.

int wpa_cred::priority

Priority group.

By default, all networks and credentials get the same priority group (0). This field can be used to give higher priority for credentials (and similarly in struct wpa_ssid for network blocks) to change the Interworking automatic networking selection behavior. The matching network (based on either an enabled network block or a credential) with the highest priority value will be selected.

char* wpa_cred::private_key

File path to client private key file (PEM/DER/PFX)

When PKCS#12/PFX file (.p12/.pfx) is used, client_cert should be commented out. Both the private key and certificate will be read from the PKCS#12 file in this case. Full path to the file should be used since working directory may change when wpa_supplicant is run in the background.

Windows certificate store can be used by leaving client_cert out and configuring private_key in one of the following formats:

cert://substring_to_match

hash://certificate_thumbprint_in_hex

For example: private_key="hash://63093aa9c47f56ae88334c7b65a4"

Note that when running wpa_supplicant as an application, the user certificate store (My user account) is used, whereas computer store (Computer account) is used when running wpasvc as a service.

Alternatively, a named configuration blob can be used by setting this to blob://blob_name.

---

The documentation for this struct was generated from the following file:

• wpa_supplicant/config.h