# WPA supplicant (Italiano)

Articoli correlati

- Configuring Network (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 wpa_supplicant dai repository ufficiali.

È 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'autenticazione ha avuto successo, sarà possibile connettersi alla rete ottenendo un indirizzo IP.

## 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: È possibile impostare manualmente il percorso al socket utilizzando l'opzione `-p`. 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=]

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

Ora che l'associazione con l'access point è completa, si ottenga un indirizzo IP impostandolo manualmente tramite la suite iproute2 o tramite programmi appositi, come systemd-networkd o dhcpcd. Si veda anche ottenendo un indirizzo IP.

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 interface -c <(wpa_passphrase MIOSSID passphrase)

Suggerimento:

- 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`.

Ora che l'associazione con l'access point è completa, si ottenga un indirizzo IP impostandolo manualmente tramite la suite iproute2 o tramite programmi appositi, come systemd-networkd o dhcpcd. Si veda anche ottenendo un indirizzo IP.

Ad esempio:

    # dhcpcd interfaccia

Attenzione: Se dhcpcd viene invocato senza specificare un'interfaccia, cercherà di ottenere un indirizzo IP su tutte le interfacce disponibili. Questo comportamento potrebbe causare l'impossibilità da parte di udev a rinominare le interfacce di rete.

## 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 #Configurazione 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

Si ottenga quindi un indirizzo IP impostandolo manualmente tramite la suite iproute2 o tramite programmi appositi, come systemd-networkd o dhcpcd. Si veda anche ottenendo un indirizzo IP.

Ad esempio:

    # dhcpcd interfaccia

Nota: dhcpcd dispone di un hok che avvia wpa_supplicant implicitamente; si veda 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

Si abiliti inoltre dhcpcd:

    # systemctl enable dhcpcd@interface

Nota: dhcpcd dispone di un hok che avvia wpa_supplicant implicitamente; si veda 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

## 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)