Lavorando su Tomcat, avevo sempre gestito l’autenticazione (per l’accesso a contenuti protetti) nelle web application  in modo semplice e veloce tramite il meccanismo dei Realm (http://tomcat.apache.org/tomcat-7.0-doc/realm-howto.html). Passando a Glassfish e cercando qualcosa di simile, non ho trovato una documentazione chiara che spiegasse passo passo come riuscire a realizzare il mio obiettivo. Pescando qua e là mi sono comunque accorta che il meccanismo è altrettanto semplice che su Tomcat, e non molto dissimile. Il procedimento illustrato è lo stesso per Glassfish 3.0.1 e Glassfish 3.1.1. Per la memorizzazione delle credenziali degli utenti utilizzerò un database MySql.

Vediamo come fare in cinque semplici passi.

1) Creare le tabelle nel database

Dobbiamo creare due tabelle nel database (come facevamo anche con Tomcat), una per gli utenti ed una per i ruoli. Creiamo la tabella utenti:

CREATE TABLE `utenti` (
  `username` varchar(200) NOT NULL DEFAULT '',
  `nome` varchar(200) DEFAULT NULL,
  `cognome` varchar(200) DEFAULT NULL,
  `email` varchar(200) NOT NULL DEFAULT '',
  `password` varchar(200) DEFAULT NULL
) ENGINE=MyISAM DEFAULT CHARSET=latin1;

Creiamo la tabella ruoli:

CREATE TABLE `ruoli` (
  `username` varchar(200) NOT NULL DEFAULT '',
  `ruolo` varchar(200) NOT NULL DEFAULT ''
) ENGINE=MyISAM DEFAULT CHARSET=latin1;

2) Creare una risorsa JDBC

Dobbiamo creare la risorsa JDBC necessaria per collegarsi al database dove memorizziamo gli username e le password degli utenti autenticati. In questo post spiego come impostare su Glassfish una risorsa JDBC per il collegamento con un database.

3) Creare il Security Realm

Andiamo quindi a creare il Security Realm, che utilizzerà la risorsa JDBC appena creata per recuperare le credenziali degli utenti. Per fare questo apriamo l’interfaccia web di gestione di Glassfish (di default raggiungibile alla porta 4848). Nel menù di sinistra cerchiamo Security, apriamo il collegamento e quindi clicchiamo su Realm.

Clicchiamo su New e riempiamo il form inserendo un nome univoco per il realm e scegliendo com.sun.enterprise.security.auth.realm.jdbc.JDBCRealm dal menù a tendina. Dopo la scelta appariranno sotto altri campi: andiamo a riempirli:

• JAAS Context: qui dobbiamo inserire esattamente la stringa “jdbcRealm”. Questo punto è IMPORTANTE, anche perché non è indicato bene da nessuna parte…
• JNDI: l’identificativo della risorsa JDBC per il collegamento ad database. ES. jdbc/test
• User Table: la tabella nel database che contiene gli utenti. Es. utenti
• User Name Column: la colonna che contiene lo username nella tabella degli utenti. Es. username
• Password Column: la colonna che contiene la password nella tabella degli utenti. Es. password
• Group Table: la tabella che contiene i ruoli degli utenti. Es. ruoli
• Group Name Column: la colonna che contiene il ruolo dell’utente nella tabella dei ruoli (la colonna che contiene lo username deve avere lo stesso nome che ha nella tabella degli utenti). Es. ruolo
• Digest Algorithm: l’algoritmo usato per cifrare la password. ATTENZIONE, c’è una leggera differenza tra le varie versioni di Glassfish, quello che cambia è il valore di default. Inseriamo ad esempio MD5.

4) Modificare il file web.xml

Questo passo è esattamente lo stesso che facevamo per le web application su Tomcat. Dobbiamo configurare nel file web.xml il security contraint, la modalità di login, ed i ruoli utilizzati. Dobbiamo solo fare attenzione ad inserire come realm name l’identificativo che abbiamo indicato nella creazione del realm su Glassfish.

<security-constraint>
<display-name>Area Protetta</display-name>
        <web-resource-collection>
            <web-resource-name>Area Protetta</web-resource-name>
            <description/>
            <url-pattern>/faces/protected/*</url-pattern>
            <url-pattern>/protected/*</url-pattern>
        </web-resource-collection>
        <auth-constraint>
            <description/>
            <role-name>registered</role-name>
        </auth-constraint>
    </security-constraint>
    <login-config>
        <auth-method>FORM</auth-method>
        <realm-name>testRealm</realm-name>
        <form-login-config>
            <form-login-page>/login.jsp</form-login-page>
            <form-error-page>/login_error.jsp</form-error-page>
        </form-login-config>
    </login-config>
    <security-role>
        <description/>
        <role-name>registered</role-name>
    </security-role>

5) Modifichiamo il file sun-web.xml (o glassfish-web.xml)

L’ultimo passo consiste nel creare un mapping tra i ruoli della web application e i gruppi di Glassfish. Qui troviamo una piccola differenza tra le diverse versioni di Glassfish: nell’ultima versione abbiamo il file glassfish-web.xml, mentre nelle versioni precedenti troviamo il file sun-web.xml; il contenuto da aggiungere è comunque lo stesso: per ogni ruolo utilizzato aggiungiamo una definizione di security role mapping:

  <security-role-mapping>
    <role-name>registered</role-name>
    <group-name>registered</group-name>
  </security-role-mapping>

Ecco fatto! Adesso quando un utente richiede le pagine inserite nell’area protetta sarà reindirizzato sulla pagina di login e potrà visualizzare i contenuti protetti solo se possiede un ruolo autorizzato.

Nota: lavorando su NetBeans possiamo editare sia il file web.xml che il file sun-web.xml (o glassfish-web.xml) tramite interfaccia visuale e definire quindi in questo modo sia l’area protetta che il mapping tra ruoli e gruppi.