Il primo passo per poter far funzionare il meccanismo è la definizione di una Secure Store Target Application, ovvero di un elemento che memorizza le credenziali di accesso al sistema esterno, al quale Sharepoint farà riferimento per evitare che vengano chieste all’utente che in quel momento visualizza i dati. E’ tuttavia possibile evitare questo passo, se si desidera che per l’accesso al database esterno vengano utilizzate le credenziali dell’utente connesso anzichè credenziali comuni.
La Secure Store Target Application si crea dalla Central Administration. Navigando nella sezione Application Management, e cliccando su Manage Service Applications sotto a Service Applications. Apparirà una schermata con la lista delle service applications, clicchiamo su Secure Store Service. A questo punto clicchiamo su Generate New Key nel ribbon, si apre una finestra che chiede di impostare una pass phrase, servirà per poter modificare la target application, va quindi appuntata da qualche parte (ma questo appunto è superfluo, no?).

A questo punto si può creare una nuova target application e compilare tutti i campi necessari, come da figura sotto. Come email mettiamo quella di un amministratore di sistema, mentre come Target Application Type in genere si mette Group, perchè in questo modo è possibile associare la target application a un gruppo di utenti.

Nel passaggio successivo è possibile quali campi associare alla target application, in genere sono sufficienti username e password: saranno poi valorizzati con le credenziali che dovranno impersonificare l’utente che si collega al database.

Ora bisogna specificare per quali utenti sarà disponibile questa target application, e quali sono gli utenti amministratori.

Ora che la target application è creata, non resta che settare le credenziali che utilizzerà per gli accessi al database esterno. Selezioniamo la target application dalla lista e premiamo il tasto set credential nel ribbon.

Si aprirà una finestra dove inserire username e password, questo utente deve ovviamente avere accesso ai dati sul database esterno al quale vorremo collegare le liste di Sharepoint.

Ora l’attività si sposta su Sharepoint Designer 2010, per impostare i contenuti esterni e creare le liste che puntano ad essi. La prima cosa da fare è definire un External Content Type: ovvero un contenuto esterno dal quale attingere. Dopo aver aperto un sito, bisogna andare sul menù External Content Type e tramite il comando ribbon crearne uno nuovo.

Diamo un nome al contenuto esterno e clicchiamo sul link per impostare la connessione verso il sistema esterno.

Ora bisogna cliccare sul tasto Add Connection per aggiungere una connessione.

Apparirà una serie di schermate dove compilare i dati per l’accesso al database esterno.

Selezionare come opzione di connessione Connect with Impersonated Custom Identity e mettere il nome della secure store application definita prima sulla Central Administration.

Premendo OK il sistema chiederà le credenziali, inserire quelle dell’utente definito come amministratore della secure store application ai passi precedenti. Una volta validata la connessione, nell’Operation Designer apparirà tra le connessioni disponibili anche quella appena impostata: si espande l’albero per trovare la tabella o la vista contenente i dati che dovranno popolare la lista esterna di Sharepoint.

Una volta individuata, cliccando col tasto destro sulla tabella o sulla lista, è possibile generare le operazioni che servono (lettura, modifica, cancellazione, ecc..). E’ possibile crearle tutte assieme, cliccando su Create All Operation. Nelle finestre successive dovremo dare un nome alle operazioni, si potranno settare filtri e sarà necessario marcare almeno un campo come identifier (ID di lista).

I filtri sono necessari per limitare il numero di record restituiti: di default è 2000 e a volte questo valore potrebbe non essere sufficiente, causando errore nella visualizzazione della lista tramite il browser sul sito Sharepoint.

Per l’operazione Read List, conviene settare qualche campo per la visualizzazione nel picker, altrimenti di default saranno visualizzati tutti e lato utente questa cosa risulta scomoda.

andando su List and Libraries, nei ribbon appare il comando Elenco Esterno.

Per chi volesse approfondire:

http://blog.concurrency.com/sharepoint/accessing-external-data-using-business-connectivity-services-in-sharepoint-2010/

In questo piccolo tutorial vengono realizzate cinque semplici pagine:

1. registrazione.html
2. registra.jsp
3. login.html
4. login.jsp
5. logout.jsp

Tutte le operazioni di inserimento e le interrogazioni al database vengono effettuate dal bean UtentiBean.java. Potete scaricare il file con gli esempi direttamente qui.

La prima operazione da fare è il caricamento dei files nella cartella webapps di Tomcat. Per funzionare correttamente il nome della cartella che contiene tutti i files deve essere “diplod”, se vuoi cambiare il nome alla tua cartella ricordati di farlo anche nelle pagine jsp che si connettono al database, ovvero “registra.jsp” e “login.jsp”. Puoi cambiare nome pure al database, purchè lo modifichi anche nella stringa che si connette ad esso. Queste semplici pagine sono state testate su Tomcat versione 5.5, per funzionare sulla versione 4 bisogna cambiare la stringa di collegamento al database e impostare i permessi di accesso ad esso dal pannello di controllo di windows (strumenti di amministrazione, origine dati ODBC). In amministrazione dati scegliere “Database di Microsoft Access” e cliccare su Aggiungi.

Selezionare “Driver do Microsoft Access (*.mdb)”

Selezionare il database nella sua posizione e assegnarli un nome univoco, che sarà poi quello utilizzato nella stringa di collegamento.

Vediamo ora nel dettaglio il contenuto delle pagine:

La pagina “registrazione.html” contiene un semplice form di inserimento dati, per il quale evito di riportare il codice.

La pagina “registra.jsp” contiene invece il codice per processare i parametri ricevuti e invocare il metodo di salvataggio del bean. Se infatti l’utente ha inviato i dati, questi vengono salvati in stringhe e successivamente impostati sul bean tramite i metodi setNomeVar(). Successivamente viene invocato il metodo salvaUtente(), che restituisce valore vero nel caso l’inserimento dei dati sul database vada a buon fine.

NB: in grassetto è evidenziata la stringa di connessione al database, se non avete modificato i nomi della cartella e del database e state utilizzando Tomcat 5.5 si può lasciare invariata, altrimenti va modificata opportunamente con il giusto percorso. Se invece state utilizzando Tomcat 4 va sostituito tutto il blocco di bean.setDbUrl(…..); con questo blocco: bean.setDbUrl(“jdbc:odbc:nomeDelTuoDatabase”); dove al posto di nomeDelTuoDatabase bisogna riportare il nome univoco dato al database dal pannello di controllo di windows.

Questo il codice della pagina:
<%@page language="java"%>
<jsp:useBean id="bean" scope="page"
class="beans.UtentiBean"/>
<% if (request.getParameter("invio")!=null) {
bean.setDbUrl("jdbc:odbc:Driver={Microsoft Access Driver (*.mdb)};
DBQ=C:/Programmi/Apache Software Foundation/Tomcat 5.5/webapps/diplod/diplod.mdb");
bean.connect();
String nome = request.getParameter("nome");
String cognome = request.getParameter("cognome");
String username = request.getParameter("username");
String password = request.getParameter("password");
String email = request.getParameter("email");
String hobby = request.getParameter("hobby");
bean.setNome(nome);
bean.setCognome(cognome);
bean.setUsername(username);
bean.setPassword(password);
bean.setEmail(email);
bean.setHobby(hobby);
} %>
<% //salvataggio utente
boolean salvataggio = false;
salvataggio = bean.salvaUtente();
if (salvataggio==true) { %>
<h1>Conferma registrazione</h1>
<p>La tua registrazione è avvenuta correttamente.</p>
<p>Questi sono i tuoi dati: <br/>
Il tuo nome:<%=bean.getNome()%><br/>
Il tuo cognome:<%=bean.getCognome()%><br/>
La tua email:<%=bean.getEmail()%><br/>
Il tuo username:<%=bean.getUsername()%><br/>
La tua password:<%=bean.getPassword()%><br/>
Il tuo hobby:<%=bean.getHobby()%><br/>
</p>
<% } else { %>
<h1>Errore!</h1>
<p>La tua registrazioneb non è avvenuta correttamente.</p>
<p>Forse hai scelto un nome utente già presente o non hai compilato correttamente alcuni campi! Torna a <a
xhref="registrazione.html" mce_href="registrazione.html" >registrazione</a>.</p>
Motivo dell'errore: <br/>
<%=bean.getMsgErrore()%>
<% }
bean.disconnect(); %>

La pagina login.html è un’altra semplice pagina statica che contiene il form per il login.

La pagina login.jsp gestisce il primo login e la sessione dell’utente. A differenza della pagina jsp per la registrazione, lo scope del bean è infatti settato a “session”, ovvero i dati relativi all’utente vengono tenuti in memoria dal server per tutta la durata del collegamento, fino al logout. Anche in questo caso è necessario tenere presente degli accorgimenti sulla stringa di connessione al database illustrati precedentemente.

Come si vede dal codice, la pagina imposta i dati dati solo se sono stati effettivamente inviati dal form, per poi invocare il metodo loginUtente() del bean. Questo metodo, nel caso l’utente sia presente nel database, imposta a true una variabile booleana. Il suo valore viene recuperato poi dalla jsp tramite il metodo getAuth(), per controllare se l’utente ha effettuato positivamente il login. Questo metodo potrebbe essere invocato da tutte le pagine sicure del nostro sito, quelle alle quali si può accedere solo dopo il login.

Se il login non è andato a buon fine, al posto del menù di navigazione viene restituito un messaggio di cortesia all’utente.

Ecco il codice della pagina:

<%@page language="java"%>
<jsp:useBean id="bean" scope="session"
class="beans.UtentiBean"/>
<%
//se l'utente ha compilato il form per il login
if (request.getParameter("invio")!=null) {
bean.setDbUrl("jdbc:odbc:Driver={Microsoft Access Driver (*.mdb)};
DBQ=C:/Programmi/Apache Software Foundation/Tomcat
5.5/webapps/diplod/diplod.mdb");
bean.connect();
String username = request.getParameter("username");
String password = request.getParameter("password");
bean.setUsername(username);
bean.setPassword(password);
bean.loginUtente();
}
//controllo l'esito del login
if (bean.getAuth()) { %>
<h1>Benvenuto nel sito <%=bean.getNome()%> <%=bean.getCognome()%></h1>
<p>Questo è il menù di navigazione.</p>
<ul>
<li><a xhref=http://www.diplod.it/#">voce di navigazione 1</a></li>
<li><a xhref=http://www.diplod.it/#">voce di navigazione 2</a></li>
<li><a xhref=http://www.diplod.it/#">voce di navigazione 3</a></li>
<li><a xhref=http://www.diplod.it/#">voce di navigazione 4</a></li>
<li><a xhref=http://www.diplod.it/#">voce di navigazione 5</a></li>
<li><a xhref=http://www.diplod.it/#">voce di navigazione 6</a></li>
</ul>
<a xhref="logout.jsp" mce_href="logout.jsp" >Logout</a>
<% } else { %>
<h1>Errore!</h1>
<p>Nome utente o password non corretti.</p>
<p>se ancora non sei registrato vai a <a xhref="registrazione.html" mce_href="registrazione.html" >registrazione</a> altrimenti <a xhref="login.html" mce_href="login.html" >ritenta il login</a>.</p>
Motivo dell'errore: <br/>
<%=bean.getMsgErrore()%>
<% }
bean.disconnect(); %>

La pagina logout.jsp non fa altro che invocare il metodo logout() del bean. Tale metodo torna a settare a false la variabile auth, in questo modo l’accesso alle pagine protette non sarà più possibile.

Per il codice del bean, si faccia riferimento direttamente al file UtentiBean.java, il codice è commentato per una più facile comprensione. La composizione delle stringhe per le query sql, così come la gestione delle statement sono volutamente semplificate per risultare di più facile comprensione, ma probabilmente non sono il modo migliore per interrogare un database ed eseguire operazioni sql.

Giusto a titolo informativo, si riporta un metodo più professionale per interrogare un database (in questo caso MySql).

PreparedStatement stmt = null;
ResultSet rs = null;
Connection cn=null;
try{
Class.forName("com.mysql.jdbc.Driver");
cn = DriverManager.getConnection("jdbc:mysql://localhost/database?user=XXXX&password=XXXXX");
String sql="SELECT * FROM tabella WHERE user=? AND password=?";
stmt = cn.prepareStatement(sql);
stmt.setString(1,user);
stmt.setString(2,password);
rs = stmt.executeQuery();
if (rs.next()) { ..........

Spero che questo piccolo tutorial possa essere utile. Quando ho iniziato a studiare la tecnologia server-side di java ero un po’ spaesato, e nonostante diverse ricerche tra forum e manuali non sono mai riuscito a trovare una semplice guida per la gestione degli utenti con un database access. Certo non è il miglior database da utilizzare se vogliamo creare un sito web, ma cambiando solo pochissime righe di codice si può utilizzare questa applicazione ugualmente con MySQL.

Se avete suggerimenti, se trovate qualcosa di incorretto, lasciate un commento a questo post.