Questa collezione dimostrativa contiene lo stesso materiale della collezione demo originale di Greenstone, ma include alcuni commandi di autenticazione di base. Due documenti sono disponibili pubblicamente (Farming snails 1 & 2), mentre per gli altri è necessario fare login per visualizzarli.
Il file di configurazione della collezione è esattamente lo stesso della collezione demo originale, a parte le direttive di autenticazione, un'opzione del plugin (e questa descrizione).
description3=Lo schema di autenticazione controlla l'accesso alla collezione. Funziona in due fasi. In primo luogo determina se limitare l'accesso alla collezione nel suo complesso o a singoli documenti, e in quest'ultimo caso quali documenti sono (fornendo un elenco di documenti privati per i quali l'accesso deve essere autenticato, oppure specificando che tutti i documenti sono privati, tranne un determinato elenco di documenti pubblici). Poi, per i documenti ad accesso limitato, determina quali gruppi di utenti devono avere accesso.
description4=L'autenticazione viene attivata utilizzando l'elemento XML <security> nel file collectionConfig.xml. Nell'esempio della collezione authen-e, tutti i documenti sono impostati come privati per impostazione predefinita, con l'eccezione che sono accessibili ai membri registrati di un gruppo denominato “demo”. L'elemento security definisce inoltre un insieme di documenti (documentSet) denominato “always-public” che contiene 2 documenti indicati dai loro identificatori/OID (fb33fe e fb34fe). Questo documentSet specifica un caso eccezionale: i documenti nel documentSet non sono di accesso privato come gli altri documenti nella collezione per impostazione predefinita, ma possono invece essere accessibili a chiunque in qualsiasi gruppo, poiché non è specificato alcun gruppo per il loro accesso. \n\
<security default_access="private" scope="document"> \n\ \t<exception> \n\ \t\t<group name="demo"/> \n\ \t</exception> \n\ \t<exception> \n\ \t\t<documentSet name="always-public"/> \n\ \t\t\t<gruppo nome=""/> \n\ \t</eccezione> \n\ \t<documentSet nome="always-public"> \n\ \t\t<corrispondenza>fb33fe</corrispondenza> \n\ \t\t<match>fb34fe</match> \n\ \t</documentSet> \n\ </security>\n\ description5=
In questo caso, abbiamo utilizzato l'opzione -OIDtype dirname per HTMLPlugin, che specifica che i nomi delle directory devono essere utilizzati come identificatori. Questo funziona per le collezioni in cui ogni documento si trova in una directory separata. Abbiamo utilizzato questa opzione per garantire che gli identificatori rimangano gli stessi su piattaforme diverse (cosa che potrebbe non verificarsi per gli identificatori HASH), poiché in questo caso è necessario specificare gli identificatori per i documentSet che controllano le eccezioni all'accesso predefinito concesso (o negato) dall'elemento security. description6=
L'elemento security specifica i gruppi Greenstone a cui sarà consentito l'accesso, se il documento (o la collezione) è uno di quelli che richiedono l'autenticazione. L'elemento security deve contenere gli elementi exception e documentSet per definire uno o più nomi di gruppi che sovrascriveranno il default_access impostato sull'elemento security (ad esempio, se tutti i documenti sono privati per impostazione predefinita, nel qual caso gli elementi exception definiscono quali gruppi hanno accesso ai materiali della collezione). Le pagine Greenstone admin consentono di definire gruppi e aggiungere membri ad essi. description7=
Per ulteriori informazioni sull'autenticazione in GS3, sulle diverse possibilità offerte dall'elemento security in un file collectionConfig di GS3 e sulla creazione di nuovi utenti e la loro aggiunta a gruppi, consultare le seguenti pagine del wiki Greenstone \n\
\n\