Truedoc

[[TracNav(TOC)]]

== Installare e configurare Postfixadmin ==

[http://postfixadmin.sourceforge.net/ PostfixAdmin] è una potente interfaccia di gestione per la posta elettronica che consente di mantenere su un database e gestire tramite interfaccia web gli utenti di un numero arbitrario di domini di posta elettronica. Il programma è pensato per essere usato in combinazione con {{{postfix}}}, supporta inoltre l'uso di MySQL, PostgresSQL e SQLite come database, a cui poi si dovrà appoggiare un server IMAP per l'accesso alle caselle di posta. In questo caso faremo riferimento ad una installazione basata su MySQL per il database e Dovecot per il server IMAP su Debian Lenny.

=== Installazione di Postfixadmin ===

Il software viene distribuito direttamente in un pacchetto Debian dal mantainer, ma non tramite un repository, pertanto sarà necessario scaricare il {{{.deb}}} a partire da [http://sourceforge.net/project/showfiles.php?group_id=191583&package_id=225300 questo indirizzo]. Una volta ottenuto il pacchetto sarà opportuno installare preventivamente le dipendenze, queste si ottengono con il comando:

{{{

dpkg -f postfixadmin_*.deb Depends

}}}

che presenta però anche le alternative per quanto riguarda il server web ed il database di supporto da usare, e non prevede esplicitamente l'installazione di un database sulla stessa macchina. Nel nostro caso sarà allora occorrerà installare:

{{{

aptitude install dbconfig-common wwwconfig-common  \

      libapache2-mod-php5 php5 php5-imap php5-mysql \

      mysql-client mysql-server

}}}

A questo punto sarà necessario creare un database ad uso di [http://postfixadmin.sourceforge.net/ PostfixAdmin], ed un utente dotato di adeguati privilegi per poterlo utilizzare, questo può essere fatto manualmente con le seguenti istruzioni:

{{{

mysqladmin -u root -p create postfixadmin

mysql -u root -p

mysql> grant create, select, insert, update, delete, lock, index, alter, drop on postfixadmin.* to 

             'postfixadmin'@'localhost' identified by 'passsegretaedifficile';

mysql> flush privileges;

mysql> \q

}}}

dopo di che si potrà installare il pacchetto con:

{{{

dpkg -i postfixadmin_*.deb 

}}}

ma si tenga presente che dalla versione 2.3 (ancora non rilasciata come stabile), con l'installazione di {{{dbconfig-common}}} e {{{wwwconfig-common}}}, l'installazione del pacchetto consente di creare configurare automaticamente anche il database di appoggio ed il relativo utente (ed il passo precedente non serve più).

A seconda della versione che si installa si dovrà modificare a mano il file {{{/etc/postfixadmin/config.inc.php}}} per inserire le credenziali di accesso al database, modificando le righe:

{{{

$CONF['configured'] = true;

...

$CONF['database_type'] = 'mysql';

$CONF['database_host'] = 'localhost';

$CONF['database_user'] = 'postfixadmin';

$CONF['database_password'] = 'passsegretaedifficile';

$CONF['database_name'] = 'postfixadmin';

}}}

ma questo, con la 2.3, viene fatto da ''debconf'' in maniera automatica con la richiesta della password di amministrazione di MySQL (quella impostata per root alla sua installazione) e di una altra password per l'utente usato da [http://postfixadmin.sourceforge.net/ PostfixAdmin], si ricordi però di rispondere, quando verrà richiesto, di installare la configurazione fornita dal pacchetto. 

Si tenga infine presente che se si vuole evitare di rendere leggibili ad Apache le credenziali di accesso al database questo può essere fatto aggiungendo creando un VirtualHost specifico per Postfixadmin (leggibile solo da root) in cui si impostano delle variabili di ambiente con le direttive:

{{{

SetEnv DB_USER "postfixadmin"

SetEnv DB_PASS "passsegretaedifficile"

}}}

che poi si riusano nel file di configurazione con:

{{{

$CONF['database_user'] = $_SERVER['DB_USER'];

$CONF['database_password'] = $_SERVER['DB_PASS'];

}}}

Fatto questo la creazione della struttura del database e delle relative informazioni (o l'aggiornamento di eventuali modifiche della struttura del database in caso di installazioni di versioni successive del software) si fa puntando il browser all'indirizzo:

{{{

http://IP.DEL.MIO.SERVER/postfixadmin/setup.php

}}}

che esegue lo script di setup che crea e popola le tabelle del database; anche qui le cose cambiano a seconda della versione, fino alla 2.2 questo script consente di modificare l'amministratore e deve essere rimosso dopo l'uso, con la 2.3 è previsto la generazione di una password per il setup, e se questa non è impostata lo script la richiede e poi scrive in output l'hash crittografico che corrisponde da inserire nella configurazione (il file precedente) alla linea:

{{{

$CONF['setup_password'] = 'changeme';

}}}

una volta fatta la modifica si potrà usare con successo il setup per la creazione di un utente di amministrazione, associato ad un indirizzo di posta, anch'esso installato nel database.  Si potrà verificare il funzionamento della configurazione collegandosi direttamente all'indirizzo {{{http://IP.DEL.MIO.SERVER/postfixadmin}}} controllando che l'utente di amministrazione impostato funzioni.

=== Configurare Postfix per Postfixadmin ===

Il passo successivo è configurare Postfix per fare uso degli utenti e delle mailbox definite su PostfixAdmin, installando il pacchetto {{{postfix}}} si abbia cura di rispondere alla configurazione automatica di utilizzare il profilo per il sito internet, specificando il proprio dominio principale. Per lo stoccaggio della posta si dovrà usare una directory apposita, la cui proprietà sarà di un utente dedicato; una volta che si sia scelto un filesystem con adeguato spazio, la si potrà creare con i comandi:

{{{

mkdir /home/vmail

adduser -r vmail

chown vmail /home/vmail/

chmod o-xr /home/vmail/

}}}

Poi si dovrà indicare a Postfix di usare i dati mantenuti su MySQL per le mailbox virtuali, per questo anzitutto si deve installare il pacchetto {{{postfix-mysql}}}, dopo di che si dovranno aggiungere le seguenti linee di configurazione al {{{main.cf}}}:

{{{

virtual_alias_maps = proxy:mysql:/etc/postfix/mysql_virtual_alias_maps.cf

virtual_mailbox_domains = proxy:mysql:/etc/postfix/mysql_virtual_domains_maps.cf

virtual_mailbox_maps = proxy:mysql:/etc/postfix/mysql_virtual_mailbox_maps.cf

virtual_mailbox_base = /home/vmail

virtual_minimum_uid = vmail

virtual_transport = virtual

virtual_uid_maps = static:vmail

virtual_gid_maps = static:vmail

}}}

e si dovranno creare il vari file {{{mysql_*}}} con le configurazioni per l'uso del database, il primo file è quello che consente di utilizzare gli alias definiti nel database, e deve essere qualcosa del tipo:

{{{

user = postfixadmin

password = passsegretaedifficile

hosts = localhost

dbname = postfixadmin

query = SELECT goto FROM alias WHERE address='%s' AND active = 1

}}}

il secondo consente di ottenere l'elenco dei domini mantenuti nel database, e deve essere qualcosa del tipo:

{{{

user = postfixadmin

password = passsegretaedifficile

hosts = localhost

dbname = postfixadmin

query = SELECT domain FROM domain WHERE domain='%s' and backupmx = '0' and active = '1'

}}}

il terzo consente di ottenere le directory con le mailbox che saranno create a partire dalla directory di base, e deve essere qualcosa del tipo:

{{{

user = postfixadmin

password = passsegretaedifficile

hosts = localhost

dbname = postfixadmin

query = SELECT maildir FROM mailbox WHERE username='%s' AND active = 1

}}}

Se poi si vogliono gestire con [http://postfixadmin.sourceforge.net/ PostfixAdmin] anche eventuali secondari di posta, si potrà aggiungere al {{{main.cf}}} di Postfix la riga:

{{{

relay_domains = $mydestination, proxy:mysql:/etc/postfix/mysql_relay_domains_maps.cf

}}}

dove in {{{mysql_relay_domains_maps.cf}}} dovrà essere qualcosa del tipo:

{{{

user = postfixadmin

password = passsegretaedifficile

hosts = localhost

dbname = postfixadmin

query = SELECT domain FROM domain WHERE domain='%s' and backupmx = '1' and active = '1'

}}}