enumerazione DOT11_CIPHER_ALGORITHM (wlantypes.h)

Articolo
08/08/2023

Importante L'interfaccia LAN wireless nativa 802.11 è deprecata in Windows 10 e versioni successive. Usare invece l'interfaccia WDI (WLAN Device Driver Interface). Per altre informazioni su WDI, vedere Modello di driver windows universale WLAN.

L'enumerazione DOT11_CIPHER_ALGORITHM definisce un algoritmo di crittografia per la crittografia dei dati e la decrittografia.

Sintassi

typedef enum _DOT11_CIPHER_ALGORITHM {
  DOT11_CIPHER_ALGO_NONE = 0x00,
  DOT11_CIPHER_ALGO_WEP40 = 0x01,
  DOT11_CIPHER_ALGO_TKIP = 0x02,
  DOT11_CIPHER_ALGO_CCMP = 0x04,
  DOT11_CIPHER_ALGO_WEP104 = 0x05,
  DOT11_CIPHER_ALGO_BIP = 0x06,
  DOT11_CIPHER_ALGO_GCMP = 0x08,
  DOT11_CIPHER_ALGO_GCMP_256 = 0x09,
  DOT11_CIPHER_ALGO_CCMP_256 = 0x0a,
  DOT11_CIPHER_ALGO_BIP_GMAC_128 = 0x0b,
  DOT11_CIPHER_ALGO_BIP_GMAC_256 = 0x0c,
  DOT11_CIPHER_ALGO_BIP_CMAC_256 = 0x0d,
  DOT11_CIPHER_ALGO_WPA_USE_GROUP = 0x100,
  DOT11_CIPHER_ALGO_RSN_USE_GROUP = 0x100,
  DOT11_CIPHER_ALGO_WEP = 0x101,
  DOT11_CIPHER_ALGO_IHV_START = 0x80000000,
  DOT11_CIPHER_ALGO_IHV_END = 0xffffffff
} DOT11_CIPHER_ALGORITHM, *PDOT11_CIPHER_ALGORITHM;

Costanti


`DOT11_CIPHER_ALGO_NONE` Valore: 0x00 Specifica che nessun algoritmo di crittografia è abilitato o supportato.
`DOT11_CIPHER_ALGO_WEP40` Valore: 0x01 Specifica un algoritmo WEP (Wired Equivalent Privacy), ovvero l'algoritmo basato su RC4 specificato nello standard IEEE 802.11-2012. Questo enumeratore specifica l'algoritmo di crittografia WEP con un Chiave di crittografia a 40 bit.
`DOT11_CIPHER_ALGO_TKIP` Valore: 0x02 Specifica un algoritmo TKIP (Temporal Key Integrity Protocol), ovvero la suite di crittografia basata su RC4 basato sugli algoritmi definiti nella specifica WPA e IEEE 802.11i-2004 Standard. Questa crittografia usa anche l'algoritmo Michael Message Integrity Code (MIC) per la falsificazione Protezione.
`DOT11_CIPHER_ALGO_CCMP` Valore: 0x04 Specifica un algoritmo AES-CCMP, come specificato nello standard IEEE 802.11i-2004 e RFC 3610. Advanced Encryption Standard (AES) è l'algoritmo di crittografia definito in FIPS PUB 197.
`DOT11_CIPHER_ALGO_WEP104` Valore: 0x05 Specifica un algoritmo di crittografia WEP con una chiave di crittografia a 104 bit.
`DOT11_CIPHER_ALGO_BIP` Valore: 0x06 Specifica un algoritmo di crittografia BIP.
`DOT11_CIPHER_ALGO_GCMP` Valore: 0x08
`DOT11_CIPHER_ALGO_GCMP_256` Valore: 0x09 Specifica un algoritmo di crittografia GCMP con una chiave di crittografia a 256 bit.
`DOT11_CIPHER_ALGO_CCMP_256` Valore: 0x0a Specifica un algoritmo AES-CCMP con una chiave di crittografia a 256 bit.
`DOT11_CIPHER_ALGO_BIP_GMAC_128` Valore: 0x0b Specifica un algoritmo di crittografia BIP-GMAC (Broadcast Integrity Protocol Galois Message Authentication Code) con una chiave di crittografia a 128 bit.
`DOT11_CIPHER_ALGO_BIP_GMAC_256` Valore: 0x0c Specifica un algoritmo di crittografia BIP-GMAC con una chiave di crittografia a 256 bit.
`DOT11_CIPHER_ALGO_BIP_CMAC_256` Valore: 0x0d Specifica un algoritmo di crittografia del protocollo di crittografia basato su crittografia (BIP-CMAC) con una chiave di crittografia a 256 bit.
`DOT11_CIPHER_ALGO_WPA_USE_GROUP` Valore: 0x100 Specifica una suite di crittografia chiave gruppo (Wifi Protected Access) (WPA). Per altre informazioni sulla suite di crittografia Use Group Key (Usa crittografia chiave gruppo) fare riferimento alla clausola 7.3.2.25.1 dell'IEEE Standard 802.11i-2004.
`DOT11_CIPHER_ALGO_RSN_USE_GROUP` Valore: 0x100 Specifica una suite di crittografia della chiave di gruppo affidabile (RSN). Per altre informazioni sulla suite di crittografia Use Group Key (Usa crittografia chiave gruppo) fare riferimento alla clausola 7.3.2.25.1 dell'IEEE Standard 802.11i-2004.
`DOT11_CIPHER_ALGO_WEP` Valore: 0x101 Specifica un algoritmo di crittografia WEP con una chiave di crittografia di qualsiasi lunghezza. Un driver miniport che opera in modalità Extensible Station (ExtSTA) specifica la crittografia WEP massima lunghezza chiave tramite una query di OID_DOT11_EXTSTA_CAPABILITY. Nota Il sistema operativo abilita questo algoritmo di crittografia solo se l'autenticazione algoritmi di DOT11_AUTH_ALGO_80211_OPEN o DOT11_AUTH_ALGO_80211_SHARED_KEY sono stati abilitati. Per altre informazioni su queste informazioni algoritmi di autenticazione, vedere DOT11_AUTH_ALGORITHM.
`DOT11_CIPHER_ALGO_IHV_START` Valore: 0x80000000 Specifica l'inizio dell'intervallo usato per definire algoritmi di crittografia proprietari che sono sviluppato da un fornitore hardware indipendente (IHV). The DOT11_CIPHER_ALGO_IHV_START enumeratore è valido solo quando il driver miniport è operativo in Modalità ExtSTA.
`DOT11_CIPHER_ALGO_IHV_END` Valore: 0xffffffff Specifica la fine dell'intervallo usato per definire algoritmi di autenticazione proprietari che vengono sviluppati da un IHV. The DOT11_CIPHER_ALGO_IHV_END enumeratore è valido solo quando il driver miniport è operativo in ExtSTA .

Commenti

Un IHV può assegnare un valore per i relativi algoritmi di crittografia proprietari da DOT11_CIPHER_ALGO_IHV_START tramite DOT11_CIPHER_ALGO_IHV_END. L'IHV deve assegnare un numero univoco in questo intervallo a ognuno degli algoritmi di crittografia proprietari.

Se l'IHV sviluppa il proprio supporto per un algoritmo di crittografia supportato dal sistema operativo, l'IHV deve anche assegnare un numero univoco da questo intervallo. Ad esempio, se l'IHV sviluppa la propria versione di TKIP, deve assegnare un valore per questa versione da DOT11_CIPHER_ALGO_IHV_START tramite DOT11_CIPHER_ALGO_IHV_END.

Un driver miniport deve abilitare o selezionare algoritmi di crittografia in base all'ordine di preferenza seguente (elencato dal più alto al più basso):

DOT11_CIPHER_ALGO_CCMP

DOT11_CIPHER_ALGO_TKIP

DOT11_CIPHER_ALGO_WEP

DOT11_CIPHER_ALGO_WEP104

DOT11_CIPHER_ALGO_WEP40

DOT11_CIPHER_ALGO_NONE

Se il driver miniport supporta algoritmi di crittografia definiti da IHV, il driver miniport può determinare l'ordine di preferenza per questi algoritmi rispetto agli algoritmi di crittografia standard 802.11.

A partire da Windows 7, un driver miniport 802.11 può segnalare qualsiasi combinazione di coppie di algoritmi di autenticazione e crittografia supportate nell'oggetto DOT11_AUTH_CIPHER_PAIR_LIST struttura. Tuttavia, se il sistema operativo avvia l'API temporanea, abilita solo l'algoritmo di autenticazione DOT11_AUTH_ALGO_RSNA_PSK e l'algoritmo di crittografia DOT11_CIPHER_ALGO_CCMP . Per supportare l'API temporanea, il driver miniport deve supportare questa coppia di autenticazione/crittografia.

Se WPS è abilitato in una scheda di interfaccia di rete che opera in modalità API estendibile, il driver miniport deve consentire alle stazioni peer di associare l'API Estendibile usando algoritmi Open System Authentication o Wired Equivalent Privacy (WEP), indipendentemente dagli algoritmi di autorizzazione e crittografia abilitati. Per altre informazioni su WPS ed Estendibile AP, vedere OID_DOT11_WPS_ENABLED.