Add some clarifications about how to set up athentication.

diff --git a/BUILD.txt b/BUILD.txt
index 9f39078..7a7674c 100644 (file)
--- a/BUILD.txt
+++ b/BUILD.txt
@@ -84,3 +84,17 @@ For Debian:
 # cp solr/bin/solr /etc/init.d/solr\r
 # chmod +x /etc/init.d/solr\r
 # update-rc.d solr defaults\r
+\r
+\r
+Authentication\r
+--------------\r
+\r
+You need to have Shibboleth authentication set up in order to authenticate. The first step in the Shibboleth authentication process is a redirection to a WAYF (Where Are You From) server, for selecting the Identity Provider that has your credentials. You can read more about Shibboleth here: \r
+\r
+http://en.wikipedia.org/wiki/Shibboleth\r
+\r
+Then point a browser to http://127.0.0.1:8080/pithos/ in order to connect to the service.\r
+\r
+Alternatively, for development purposes, you can use a shortcut in the server to authenticate without Shibboleth. You have to manually initialize a user entry in the database first (using SQL insert) and then set its username in the testUsername property of the jboss\conf\gss.properties configuration file. You can find it deployed in JBOSS_HOME\server\default\conf\gss.properties. The proper URL for using in this scenario is the following, which can be also found in the GWT hosted mode launch configuration:\r
+\r
+http://127.0.0.1:8080/pithos/login?next=http://127.0.0.1:8080/pithos/\r