Configurare un JDBCRealm per Tomcat

01Apr08

Fonte: tomcat.apache.org 

In un precedente tutorial abbiamo visto come usufruire degli strumenti che Tomcat ci mette a disposizione per gestire l’autenticazione degli utenti del nostro sistema.

In questa breve guida, invece, vedremo come “istruire” Tomcat a leggere i dati degli utenti (user name, password e ruoli) da un database.

I prerequisiti necessari sono essenzialmente due:

1. Apache Tomcat 5.x
2. MySQL 5.0 (anche se la configurazione per altri DBMS è molto simile)

Poiché sia Tomcat e MySQL sono multi-piattaforma, le istruzioni riportate di seguito saranno valide per diversi sistemi operativi (Linux, Windows, Mac, … ).

Per prima cosa dobbiamo scaricare i driver JDBC che MySQL ci mette a disposizione qui, scompattare l’archivio e copiare il file mysql-connector-java-x.x.x.x-ga-bin.jar nella directory $CATALINA_HOME/common/lib , dove per $CATALINA_HOME si intende il path della vostra installazione di Tomcat .

Dopo di che dobbiamo inserire nel database le tabelle che conterranno rispettivamente gli utenti e i ruoli delgi utenti del nostro sistema:

create table users (
  user_name         varchar(15) not null primary key,
  user_pass         varchar(15) not null
);

create table user_roles (
  user_name         varchar(15) not null,
  role_name         varchar(15) not null,
  primary key (user_name, role_name)
);

Ovviamente questo è solo un esempio, possiamo rinominare a piacimento tabelle e attributi, o aggiungerne altri.
Vi faccio notare inoltre che le password degli utenti verranno memorizzate in chiaro; sarebbe meglio fare un digest delle password (md5, etc …), ma questo esula gli scopi di questa guida.Fatto ciò, ci basta modificare il file $CATALINA_HOME/conf/server.xml nel seguente modo:

...

<!--
<Realm className="org.apache.catalina.realm.UserDatabaseRealm"
             resourceName="UserDatabase"/>
 -->

<Realm  className="org.apache.catalina.realm.JDBCRealm"
    driverName="org.gjt.mm.mysql.Driver"
    connectionURL="jdbc:mysql://localhost/nome_db"
    connectionName="test" connectionPassword="test"
    userTable="users" userNameCol="user_name" userCredCol="user_pass"
    userRoleTable="user_roles" roleNameCol="role_name" />

...

Non abbiamo fatto altro che commentare il Realm di default (righe 3-6) e inserire un nuovo Realm (righe 8-13) , lasciando inalterato il resto del file.Per ulteriore chiarezza descriverò i principali attributi del nuovo Realm:

• connectionURL indica il percorso del nostro database; al posto di nome_db dovete inserire il nome del vostro database dove avete creato le due tabelle
• in connectionName e connectionPassword dovrete inserire le credenziali per l’accesso al suddetto db
• in userTable e userRoleTable inserire rispettivamente il nome della tabella degli utenti e della tabella dei ruoli
• intuitivamente in userNameCol, userCredCol e roleNameCol è necessario inserire i nomi delle rispettive colonne

Ora non ci resta che riavviare Tomcat e verificare se tutto è andato per il verso giusto.

Filed under: Apache Tomcat, Java   |  19 Comments
Tags: Apache Tomcat, Autenticazione, DBMS, Java, JDBC, JSP, MySQL, Realm, Web