Autenticazione via token con PAM USB

Attenzione: questo articolo è ancora incompleto e in fase di scrittura da parte del suo autore. Sentitevi liberi di contribuire, proponendo modifiche alla guida tramite l'apposita pagina di discussione, in modo da non interferire con il lavoro portato avanti sulla voce. Per altre informazioni si rimanda al template.

Attenzione. Questa guida è da considerarsi abbandonata, per via del tempo trascorso dall'ultima verifica. Potrà essere resa obsoleta, previa segnalazione sul forum, se nessuno si propone per l'adozione.

Versioni Compatibili Debian 6 "squeeze"

Introduzione

L'autenticazione a un servizio del sistema, che si tratti del login a una console o un display manager oppure di una qualunque operazione per cui siano necessari determinati privilegi (su, sudo, ecc... ), è gestita in maniera centralizzata dalla libreria PAM e solitamente effettuata mediante la richiesta di una parola chiave segreta (password) associata all'utente.

PAM presenta tuttavia un'architettura molto flessibile, che può essere estesa da altri moduli software. In particolare libpam-usb consente l'autenticazione via token grazie a una pendrive su porta USB, sulla quale verrà conservata una one-time password aggiornata a ogni nuova autenticazione. Il modulo una volta installato può essere configurato in modo sia da rappresentare un ulteriore requisito per l'autenticazione, sia da sostituire la richiesta di password per una maggiore comodità.

L'uso combinato di due diverse forme di autenticazione è molto diffuso in ambienti professionali dove la sicurezza ricopre un'importanza critica, e l'uso di libpam-usb e di una comune chiavetta USB possono rappresentare una soluzione molto economica e alla portata di tutti.

Per maggiori dettagli riguardo PAM e libpam-usb rimando all'articolo di pmate e Aki uscito nel numero 4 dell'e-zine. In questa guida vedremo solo come cambiare il comportamento di tutto ciò che si appoggia a tale libreria, in modo consistente anche in presenza di aggiornamenti del sistema o uso di altri moduli, senza mai modificare direttamente i file nella directory /etc/pam.d, anche se così si rinuncia a una maggiore possibilità di personalizzazione.

Installazione

Al momento in cui questa guida è scritta è possibile installare PAM USB per mezzo di APT soltanto in Debian Squeeze. Per via della sua dipendenza da HAL i pacchetti non sono infatti presenti nelle altre versioni.

Dal sito ufficiale è tuttavia possibile procurarsi la nuova versione (al momento corrente la 0.5), che utilizza UDisks e risolve i problemi di dipendenza. Vediamo quindi separatamente le due modalità di installazione, la seconda attualmente necessaria per Wheezy e Sid.

L'unico altro requisito è la disponibilità di una penna USB, nella quale verranno salvate le password richieste per l'autenticazione nella sessione successiva. Si può utilizzare la stessa per più utenti, anche se la cosa ha senso unicamente se a tali utenti del sistema corrisponde un unico utente fisico, e anche per più utenti di più sistemi, purché con hostname diverso (e per cui ancor più vale la stessa considerazione).

Suggerimento Non è necessario riservarla a tale utilizzo e può essere impiegata anche per altro, date le limitate esigenze di memoria di libpam-usb, ma non è una buona idea per la sicurezza inserire il token quando non richiesto per l'autenticazione, in particolar modo se si prevede che la sua presenza sia sufficiente per l'esecuzione di comandi con privilegi di amministrazione.

Usando APT

È sufficiente installare due pacchetti:

# apt-get install libpam-usb pamusb-tools

Finito!

Usando il tarball

Prima di tutto ci procuriamo l'ultima versione dei sorgenti dal sito ufficiale (al momento della stesura di questa guida si tratta del file pam_usb-0.5.0.tar.gz).

Una volta scaricato il pacchetto, lo estraiamo con:

$ tar xvzf pam_usb-*.tar.gz

Poi installiamo o ci assicuriamo siano già presenti i pacchetti base per la compilazione con make (build-essential e pkg-config), i pacchetti dev richiesti per la compilazione del modulo pamusb e quelli necessari per avviare l'eseguibile pamusb-conf. È sufficiente il seguente comando:

# apt-get install build-essential pkg-config libxml2-dev libdbus-1-dev libpam-dev libxml2 udisks pmount python python-gobject python-dbus

Infine ci posizioniamo nella cartella in cui abbiamo estratto il tarball, compiliamo il modulo con make e (con privilegi di amministrazione) lo installiamo; il tutto con:

$ cd pam_usb-*/  &&  make  &&  sudo -c 'make install'

A questo punto - e se tutto si è concluso con successo - è possibile rimuovere sia il tarball sia la cartella estratta, in quanto non più necessarie. Per semplificare la procedura di rimozione, e non dover riscaricare l'archivio nuovamente, è però consigliabile conservare almeno il file Makefile.

Configurazione di pamusb

Inserire la pendrive nella porta USB e darle un nome che ci consenta di identificarla, inserendolo al posto di NOME:

# pamusb-conf --add-device="NOME"

Verrà richiesta una conferma e si potrà scegliere una qualunque tra le memorie USB collegate, che sarà aggiunta al file /etc/pamusb.conf.

Aggiungere gli utenti del sistema che si desidera autenticare tramite il dispositivo, ripetendo il seguente comando per ciascuno di loro (con il relativo nome utente al posto di NOME_UTENTE):

# pamusb-conf --add-user="NOME_UTENTE"

Nuovamente verrà richiesta una conferma, e in caso si siano aggiunte più chiavette si potrà scegliere quale associare all'utente scelto. Per una guida passo-passo alla configurazione si veda al solito l'e-zine.

Se si desidera disabilitare l'output, che in caso di autenticazione via console o terminale rende chiaro se il modulo USB è stato autenticato o meno, modificare con privilegi di amministrazione i defaults nel file /etc/pamusb.conf, aggiungendoci la riga con quiet:

<defaults>
    <quiet>true</quiet>
</defaults>

È possibile anche disabilitarlo solo per alcuni utenti e solo per alcuni servizi.

Ora pamusb è configurato, resta da modificare soltanto il comportamento dei file di configurazione di PAM affinché il modulo sia richiamato.

Creazione di un profilo

Scelta la policy da adottare tra quelle presentate nelle sottosezioni successive, si tratta di creare con privilegi di amministrazione e il proprio editor preferito il file /usr/share/pam-configs/usb con il contenuto corrispondente.

ATTENZIONE Tutti gli utenti per cui è richiesta - e non solo sufficiente - questa forma di autenticazione devono essere aggiunti a una pendrive USB, oppure non potranno più autenticarsi al sistema. Lo stesso root, se abilitato, non fa eccezione. In caso di problemi per bypassare il modulo l'unico modo sarà durante l'avvio, scegliendo la modalità singolo utente messa a disposizione da grub.

Il file creato costituisce il profilo utilizzato per la generazione automatica dei file di configurazione di default di PAM (/etc/pam.d/common-*), che non modificheremo manualmente. Per una veloce introduzione sul suo funzionamento, si consideri a titolo esemplificativo quanto segue:

Name: USB authentication
Default: yes
Priority: 257
Auth-Type: Primary
Auth:
    sufficient/required     pam_usb.so

dove:

• la prima riga serve per l'identificazione;
• Default indica se il modulo di default è abilitato (l'impostazione manuale effettuata con pam-auth-update ha priorità su quella di default, ma se non si cambia nulla verrà mantenuta questa) e lo imposteremo sempre su yes;
• Priority determina l'ordine in cui verrà caricato il modulo, seguendo un ordinamento decrescente. Considerando che pam_unix.so che si occupa dell'autenticazione locale mediante richiesta di password ha priorità 256, 257 andrà bene se si vuole che venga richiamato prima il modulo pamusb mentre 255 altrimenti. In questa guida verrà usato quasi sempre 257;
• Auth-Type può essere Primary o Additional. Nel primo caso viene eseguito solo se l'autenticazione non è già stata provvista da un altro modulo (purché sufficiente), nel secondo a prescindere ma non contribuirà all'esito dell'autenticazione. Le priorità tra i due tipi sono risolte separatamente e per i nostri usi andrà sempre bene Primary;
• infine Auth indica se considerare l'autenticazione del modulo sufficiente (con sufficient) se tutti quelle con priorità maggiore non falliscono, oppure se considerarla un requisito necessario (con required) e richiama il modulo pam_usb.so (eventualmente passandoci anche dei parametri). È la parte più importante e quella che siamo interessati a modificare.

Alternative mode

Modalità di autenticazione che prevede la richiesta di password soltanto se il token USB non è inserito. È possibile permetterla soltanto a un insieme limitato di utenti, visto che il fallimento dell'autenticazione via USB non compromette l'autenticazione, ma porta solo alla richiesta della password.

Questo il profilo da creare:

Name: USB authentication
Default: yes
Priority: 257
Auth-Type: Primary
Auth:
    sufficient      pam_usb.so

Additional mode

Modalità che prevede la richiesta contemporanea di password e l'inserimento della penna USB.

Il profilo sarà:

Name: USB authentication
Default: yes
Priority: 257
Auth:
    required      pam_usb.so

Utilizzare requisite in luogo di required per non chiedere la password in caso di fallimento. Con required tuttavia non si riuscirà a capire quale modulo ha fallito ed è l'impostazione più sicura.

Unique mode

Modalità che prevede soltanto l'autenticazione via token USB.

Il profilo:

Name: USB authentication
Default: yes
Priority: 511
Auth-Type: Primary
Auth:
    [success=done default=die]    pam_usb.so

Si è impostata una priorità molto maggiore, visto che deve sostituire ogni altra forma di autenticazione locale (che devono avere priorità inferiore a 512).

In luogo di sufficient e requisite per le due modalità già viste si è utilizzata una forma intermedia, che salta l'esecuzione delle regole rimanenti tanto in caso di successo (success=done) che di fallimento (default=die), in modo che l'autenticazione dipenda soltanto da questo modulo. Per maggiori dettagli si veda il manuale (man pam.d).

Custom mode

Modalità personalizzata, che consente l'uso di una modalità Alternative o Additional a seconda dell'utente. Quella qui presentata richiede entrambe le forme di autenticazione per root, mentre una qualsiasi per gli altri utenti.

Profilo risultante:

Name: USB authentication
Default: yes
Priority: 257
Auth-Type: Primary
Auth:
    [success=1 default=ignore]  pam_succeed_if.so  uid > 0
    [success=1 default=bad   ]  pam_usb.so
    sufficient    pam_usb.so

pam_succeed_if.so è un modulo che ha successo unicamente se la condizione è soddisfatta, e chiaramente uid è uguale a zero soltanto per l'utente root, mentre è maggiore per tutti gli altri. Al posto di sufficient e required si è impostata una policy più complessa, e per un'analisi più dettagliata si rimanda alla pagina di manuale (man pam.d), nella quale in caso di fallimento del modulo non succede niente (default=ignore) ma se la condizione è soddisfatta vengono saltate un certo numero di righe (success=N).

Quindi un utente normale soddisferà la prima condizione (uid > 0) e salterà una riga (success=1), eseguendo direttamente l'ultima che coincide con la Alternative mode. Al contrario root leggerà la seconda riga, corrispondente alla policy per la Additional mode; infatti in caso di successo salterà la terza riga e passerà ai moduli di priorità inferiore (la richiesta di password) mentre in tutti gli altri casi l'autenticazione fallirà (default=bad). Impostare default=die in luogo di default=bad se si vuole far capire all'utente che il fallimento è dovuto alla mancata autenticazione USB.

Sudo È da notare che con sudo verrà usata la policy dipendente dalla password richiesta, di default quella dell'utente e quindi si utilizzerebbe una modalità Alternative. Si può però cambiare questo comportamento, sempre che si sia abilitato sudo, aggiungendo targetpw ai Defaults per mezzo di visudo, in modo che venga richiesta la password dell'amministratore anziché quella dell'utente. Al solito la cosa ha senso solo se a loro corrisponde la stessa persona fisica, altrimenti è meglio dirigersi verso la modalità Additional. Infine i comandi permessi con il tag NOPASSWD: saranno eseguibili come sempre senza alcuna forma di autenticazione.

Salvare la configurazione

Per rendere effettive le modifiche, una volta scelta la policy più adatta per le nostre esigenze o creata una personalizzata, sarà sufficiente eseguire il seguente comando:

# pam-auth-update

Se è deselezionata, spuntare la casella di "USB authentication", lasciare le altre come sono e confermare su "Ok". Verranno rigenerati i file con prefisso "common-" nella directory /etc/pam.d, richiamati da (quasi) tutti gli altri file di configurazione.

Test di funzionamento

Per controllare se abbiamo fatto giusto, usiamo pamusb-check e il nome utente da verificare al posto di NOME_UTENTE:

# pamusb-check NOME_UTENTE

Se abbiamo disabilitato l'output non restituirà niente a schermo, controlliamo allora il suo valore di uscita (0 significa tutto ok, qualunque altro valore che il testo è fallito) eseguendo questo comando subito dopo il precedente, dato che restituisce il valore di ritorno dell'ultimo comando eseguito:

echo $?

Proviamo tutti gli utenti, e in particolare root se utilizziamo una modalità diversa dall'Alternative.

Disattivazione

È sufficiente eseguire pam-auth-update:

# pam-auth-update

Deselezionare il modulo "USB authentication" e dare l'Ok.

Disinstallazione

Per eliminare i pacchetti installati dal sistema è prima necessario rimuovere il file /usr/share/pam-configs/usb che è stato creato in fase di configurazione e aggiornare PAM, in modo che pamusb non sia più richiamato nelle prossime autenticazioni:

# rm /usr/share/pam-configs/usb && pam-auth-update

Soltanto poi sarà possibile disinstallarlo dal sistema. La procedura da seguire per la disinstallazione varia a seconda del metodo utilizzato in fase di installazione.

Con APT

# apt-get remove pamlib-usb pamusb-tools

Per eliminare tutte le configurazioni:

# apt-get purge pamlib-usb pamusb-tools

Con tarball

In caso di installazione via tarball, basterà riposizionarsi nella cartella in cui abbiamo estratto l'archivio (e in particolare il file Makefile), e impartire il seguente comando:

# make deinstall

Pulizia del sistema

Per completare l'opera di pulizia del sistema si possono eliminare manualmente anche la directory .pamusb nella home di tutti gli utenti aggiunti a questo modulo.

Fonti e link aggiuntivi

• Sito ufficiale del modulo pamusb
• Articolo sull'e-zine n. 4 di debianizzati
• Blog di Muflone
• Wiki di configurazione di un modulo PAM

---

HAL 9000