# WPA supplicant (Italiano)

Articoli correlati

- Network configuration (Italiano)
- Wireless Setup (Italiano)

wpa_supplicant è un Supplicant WPA multipiattaforma con supporto a WEP, WPA e WPA2 (IEEE 802.11i / RSN (Robust Secure Network)) adatto all'uso con PC desktop, portatili e sistemi embedded. `wpa_supplicant` è il componente IEEE 802.1X/WPA utilizzato dai client, implementa la negoziazione della chiave con un WPA Authenticator, controlla il roaming e l'associazione / autenticazione del driver wireless.

## Installazione

Si installi il pacchetto wpa_supplicant.

È inoltre possibile installare wpa_supplicant_gui che fornisce wpa_gui, un frontend grafico per wpa_supplicant.

## Panoramica

Affinchè wpa_supplicant possa connettersi ad una rete wireless, dovrà prima essere autenticato da un WPA authenticator attraverso l'inserimento delle credenziali corrette.

Una volta che l'associazione con l'access point è completa è possibile collegarsi alla rete ottenendo un indirizzo IP, manualmente tramite la suite iproute2 o tramite programmi appositi, come systemd-networkd o dhcpcd, per l'assegnazione automatica di un indirizzo IP tramite DHCP. Si vedano anche gli articoli relativi ad interfacce wireless[broken link: invalid section] o via cavo.

## Connessione tramite wpa_cli

Questo metodo consente di effettuare una scansione delle reti disponibili utilizzando wpa_cli, un tool a riga di comando che è in grado di configurare wpa_supplicant a runtime. Si veda wpa_cli(8) per ulteriori informazioni.

Per utilizzare wpa_cli, sarà necessario specificare un'interfaccia di controllo per wpa_supplicant e dotarla dei permessi per modificare il relativo file di configurazione.

Si crei quindi un file di configurazione minimale:

    /etc/wpa_supplicant/esempio.conf

    ctrl_interface=/run/wpa_supplicant
    update_config=1

Si avvii wpa_supplicant come segue:

    # wpa_supplicant -B -i interface -c /etc/wpa_supplicant/esempio.conf

Suggerimento: Per scoprire il nome della propria interfaccia di rete wireless, si esegua il comando `ip link`.

Si esegua:

    # wpa_cli

Verrà visualizzato un prompt interattivo (`>`) che dispone di tab completion e descrizione dei comandi completati.

Suggerimento: Il percorso predefinito del socket di controllo è `/var/run/wpa_supplicant/`. È possibile impostare un percorso personalizzato tramite il parametro `-p`, in modo che corrisponda a quanto contenuto nel file di configurazione. Si può altresì specificare l'interfaccia da configurare con l'opzione `-i`. Se non specificata, wpa_supplicant sceglierà la prima interfaccia disponibile.

Si utilizzino i comandi `scan` e `scan_results` per vedere le reti disponibili:

    > scan
    OK
    <3>CTRL-EVENT-SCAN-RESULTS
    > scan_results
    bssid / frequency / signal level / flags / ssid
    00:00:00:00:00:00 2462 -49 [WPA2-PSK-CCMP][ESS] MIOSSID
    11:11:11:11:11:11 2437 -64 [WPA2-PSK-CCMP][ESS] ALTROSSID

Per associarsi con `MIOSSID` si aggiunga la rete, si specifichino le credenziali e la si abiliti:

    > add_network
    0
    > set_network 0 ssid "MIOSSID"
    > set_network 0 psk "passphrase"
    > enable_network 0
    <2>CTRL-EVENT-CONNECTED - Connection to 00:00:00:00:00:00 completed (reauth) [id=0 id_str=]

Se il SSID a cui ci si connette non utilizza l'autenticazione tramite password sarà necessario configurare la rete come aperta, sostituendo il comando `set_network 0 psk "passphrase"` con `set_network 0 key_mgmt NONE`.

Nota:

- Ogni rete viene identificata da un numero crescente: la prima avrà pertanto indice 0.
- La PSK viene ottenuta dalla stringa "passphrase" immessa sopra e compresa tra doppi apici, come mostrato dal comando wpa_passphrase. In ogni caso è possibile immettere la PSK direttamente passandola al comando `psk` senza raccoglierla tra doppi apici.

Si salvi infine la rete nel file di configurazione:

    >save_config
    OK

Una volta che l'assiociazione è stata effettuata, non resta che ottenere un indirizzo IP, come indicato nella sezione #Panoramica; ad esempio:

    # dhcpcd interfaccia

## Connessione tramite wpa_passphrase

Questo metodo consente di collegarsi rapidamente ad una rete di cui si conosce già il SSID tramite wpa_passphrase, un tool a riga di comando che genera un file di configurazione minimale per wpa_supplicant.

Ad esempio:

    $ wpa_passphrase MIOSSID passphrase

    network={
        ssid="MIOSSID"
        #psk="passphrase"
        psk=59e0d07fa4c7741797a4e394f38a5c321e3bed51d54ad5fcbd3f84bc7415d73d
    }

È quindi possibile associarsi alla rete tramite wpa_passphrase e wpa_supplicant in questo modo:

    # wpa_supplicant -B -i interfaccia -c <(wpa_passphrase SSID passphrase)

Nota: A causa della sostituzione di processo, non è possibile eseguire il comando di cui sopra tramite sudo, bensì è necessario usare una shell di root. Si veda anche Help:Reading#Regular user or root.
Suggerimento:

- Utilizzare i doppi apici se l'input contiene spazi. Ad esempio: `"secret passphrase"`.
- Per scoprire il nome della propria interfaccia di rete wireless, si esegua il comando `ip link`.
- Alcune passphrase particolarmente complesse potrebbero dover venire immesse scrivendole prima in un file: `wpa_passphrase MIOSSID < passphrase.txt`, o passando la stringa: `wpa_passphrase MIOSSID <<< "passphrase"`.

Infine, non resta che ottenere un indirizzo IP, come indicato nella sezione #Panoramica; ad esempio:

    # dhcpcd interfaccia

## Utilizzo avanzato

Per reti di varia complessità, che utilizzino EAP o altro, è consigliabile utilizzare un file di configurazione personalizzato. Per una panoramica del file di configurazione completa di esempi, si veda wpa_supplicant.conf(5); per dettagli su tutte le opzioni di configurazione supportate si veda il file di configurazione d'esempio `/etc/wpa_supplicant/wpa_supplicant.conf`.

### Configurazione

Come già evidenziato nel paragrafo #Connessione tramite wpa_passphrase, è possibile generare un file di configurazione di base con:

    # wpa_passphrase MIOSSID passphrase > /etc/wpa_supplicant/esempio.conf

Quanto sopra creerà un solo blocco `network`. Un file di configurazione con le opzioni più comuni potrebbe essere simile a questo:

    /etc/wpa_supplicant/esempio.conf

    ctrl_interface=DIR=/run/wpa_supplicant GROUP=wheel
    update_config=1
    fast_reauth=1
    ap_scan=1
    network={
        ssid="MIOSSID"
        #psk="passphrase"
        psk=59e0d07fa4c7741797a4e394f38a5c321e3bed51d54ad5fcbd3f84bc7415d73d
    }

È possibile aggiungere ulteriori blocchi `network` manualmente o utilizzando wpa_cli, come mostrato al paragrafo #Connessione tramite wpa_cli. Per utilizzare quest'ultimo, sarà necessario impostare una interfaccia di controllo tramite l'opzione `ctrl_interface`. Specificare `GROUP=wheel` consente a tutti gli utenti membri di quel gruppo di utilizzare wpa_cli. Si aggiunga inoltre `update_config=1`, per consentire al programma di salvare eventuali modifiche in `esempio.conf`. Le opzioni `fast_reauth=1` e `ap_scan=1` vengono attivate globalmente: se servano o meno dipende dal tipo di rete alla quale ci si connette. Se invece si ha la necessità di specificare ulteriori opzioni globali, copiarle semplicemente da `/etc/wpa_supplicant/wpa_supplicant.conf`.

È anche possibile utilizzare `wpa_cli set` per visualizzare il contenuto delle opzioni o modificarlo. Possono essere inseriti più blocchi `network` nel file di configurazione: il supplicant gestirà autonomamente l'associazione e il roaming tra di essi, connettendosi di default al blocco con il segnale più forte, benchè sia possibile utilizzare l'opzione `priority=` per influenzarne il comportamento.

Uno dei vantaggi dell'utilizzare un file di configurazione personalizzato in `/etc/wpa_supplicant/wpa_supplicant.conf` è che quest'ultimo viene letto di default da dhcpcd. Nel caso si scelga di utilizzarlo, è consigliabile fare un backup dell'originale ed eliminare i blocchi `network` d'esempio presenti. In caso contrario non ci si sorprenda se la propria interfaccia wireless tenta di collegarsi ai blocchi contenuti nel file di configurazione. Si noti inoltre che eventuali modifiche al file di configurazione dovranno essere aggregate.

Suggerimento: Per configurare un blocco `network` per una rete con SSID nascosto, che quindi non verrà rilevato durante una scansione, si utilizzi l'opzione `scan_ssid=1`.

### Connessione

#### Manuale

Si esegua il comando wpa_supplicant, i cui argomenti più comuni sono elencati di seguito:

- `-B` - Esegue in background.
- `-c nomefile` - Percorso al file di configurazione.
- `-i interfaccia` - Interfaccia da configurare.
- `-D driver` - Opzionale, specifica il driver da utilizzare. Per un elenco di quelli supportati si veda `wpa_supplicant -h`.
  - `nl80211` è lo standard corrente, ma non è supportato da tutti i chip wireless.
  - `wext` è deprecato, ma più supportato.

Si veda wpa_supplicant(8) per un elenco completo dei parametri.

Esempio:

    # wpa_supplicant -B -i interface -c /etc/wpa_supplicant/example.conf

È ora possibile ottenere un indirizzo IP, come indicato nella sezione #Panoramica; ad esempio:

    # dhcpcd interfaccia

Suggerimento: dhcpcd dispone di un hook per il lancio automatico di wpa_supplicant. Si veda a tal proposito dhcpcd#10-wpa_supplicant.

#### All'avvio (systemd)

wpa_supplicant fornisce diversi servizi per l'avvio:

- `wpa_supplicant.service` - utilizza D-Bus, raccomandato per gli utilizzatori di NetworkManager.
- `wpa_supplicant@.service` - accetta il nome dell'interfaccia come parametro ed avvia il demone wpa_supplicant su quest'ultima. Legge il file di configurazione `/etc/wpa_supplicant/wpa_supplicant-interfaccia.conf`.
- `wpa_supplicant-nl80211@.service` - anche questo servizio è specifico per interfaccia, ma forza l'utlilizzo del driver `nl80211`. Il percorso del file di configurazione è `/etc/wpa_supplicant/wpa_supplicant-nl80211-interfaccia.conf`.
- `wpa_supplicant-wired@.service` - specifico per interfaccia, utilizza il driver `wired`. Il file di configurazione si trova in `/etc/wpa_supplicant/wpa_supplicant-wired-interface.conf`

Per abilitare l'interfaccia wireless al boot, si abiliti uno dei servizi di cui sopra.

Ad esempio:

    # systemctl enable wpa_supplicant@interfaccia

È ora possibile abilitare un servizio per ottenere un indirizzo IP per una particolare interfaccia, come indicato nella sezione #Panoramica. Ad esempio:

    # systemctl enable dhcpcd@interfaccia

Suggerimento: dhcpcd dispone di un hook per il lancio automatico di wpa_supplicant. Si veda a tal proposito dhcpcd#10-wpa_supplicant.

### Action script per wpa_cli

È possibile lanciare wpa_cli come demone e fargli eseguire degli script basati su eventi provenienti da wpa_supplicant. Sono supportate due tipologie di eventi: `CONNECTED` e `DISCONNECTED`. Alcune variabili d'ambiente possono essere utilizzate negli script; si consulti wpa_cli(8) per ulteriori informazioni.

L'esempio che segue utilizza le notifiche del desktop per informare l'utente sull'attivazione degli eventi.

    #!/bin/bash

    case "$2" in
        CONNECTED)
            notify-send "WPA supplicant: connection established";
            ;;
        DISCONNECTED)
            notify-send "WPA supplicant: connection lost";
            ;;
    esac
    </nowiki>

Ricordarsi di rendere eseguibile lo script, quindi utilizzare lo switch `-a` per passare lo script a wpa_cli.

    $ wpa_cli -a percorso allo script

## Risoluzione dei problemi

### Driver nl80211 non supportato su alcuni modelli

Alcune schede particolarmente vecchie potrebbero non funzionare con il driver `nl80211` e wpa_supplicant potrebbe mostare il seguente messaggio:

    Successfully initialized wpa_supplicant
    nl80211: Driver does not support authentication/association or connect commands
    wlan0: Failed to initialize driver interface

che indica il mancato supporto al driver `nl80211`. In questo caso è possibile provare ad utilizzare il driver obsoleto `wext`:

    # wpa_supplicant -B -i wlan0 -D wext -c /etc/wpa_supplicant/example.conf

Se il comando di cui sopra funziona e si desidera utilizzare systemd per gestire la connessione wireless, è necessario modificare il servizio `wpa_supplicant@.service` e modificare di conseguenza il parametro `ExecStart`:

    /etc/systemd/system/wpa_supplicant@.service.d/wext.conf

    [Service]
    ExecStart=
    ExecStart=/usr/bin/wpa_supplicant -c/etc/wpa_supplicant/wpa_supplicant-%I.conf -i%I -Dwext

## Link utili

- Homepage di WPA Supplicant
- Esempi per l'utilizzo di wpa_cli
- wpa_supplicant(8)
- wpa_supplicant.conf(5)
- wpa_cli(8)
- Documentazione di wpa_supplicant

Category:

- Wireless networking (Italiano)

Hidden category:

- Pages with broken section links