Truedoc

h1. Descrizione Generale

Slashorg downloader è una applicazione che permette di condividere in maniera sicura files tra utenti. 

Scambiare/Condividere files è una attività comune che molto spesso viene effettuata tramite l'utilizzo della posta elettronica. Questo utilizzo dell'email però non garantisce che il file raggiunga la destinazione; di frequente infatti capita che nel percorso che il messaggio percorre questo possa essere bloccato a causa della dimensione o del tipo di file (ex: file troppo grandi o con estensione pericolosa).

Slashorg Downloader permette di superare questi problemi ed in più aggiunge politiche di sicurezza allo scambio di files tra utenti del web. 

Un utente di Slashorg può condividere file in due modi:

* Facendo UPLOAD di file e creando un link di accesso per questo:

*** Per ogni file/cartella che si condivide Slashorg crea un 'link di accesso' che può essere inviato a tutti gli utenti con cui si vuole condividere la risorsa. Il link di accesso può essere utilizzato incollando il link sul browser e scaricando direttamente la risorsa condivisa.

* Creando nuovi account che hanno il permesso di autenticarsi al sistema:

*** I nuovi utenti possono loggarsi nel sistema Slashorg e scaricare i file/cartelle. Se un amministratore concede anche il permesso di fare UPLOAD di file questi nuovi utenti potranno aggiugere al sistema file da condividere a loro volta con l'amministratore.

All'interno di Slashorg si possono quindi distinguere tre tipologie di utenti:

* Amministratore: tutti i privilegi, ovvero LETTURA, SCRITTURA, DOWNLOAD, CREAZIONE CARTELLE, GESTIONE UTENTI

* Utente Loggato: un utente riconosciuto dal sistema che può avere privilegi di LETTURA, SCRITTURA, DOWNLOAD, CREAZIONE CARTELLE nella sua home directory

* Utente Anonimo: può eseguire il DONWLOAD di file attraverso il 'link di accesso'

Slashorg diventa quindi lo strumento ideale in quelle situazioni in cui si devono scambiare file tra gli utenti in modo bidirezionale, ovvero quando entrambe le parti coinvolte devono poter mettere a disposizione dell'altra parte documenti/immagini/dati, il tutto in sicurezza grazie al controllo degli accessi sui dati ed alla possibilità di limitare nel numero e nel tempo le condivisione:

* Limite di tempo: un link di accesso può restare valido per un tempo scelto dall'utente che lo crea (minuti, ore, giorni, ecc...)

* Limite numero: un link di accesso può restare valido per un certo numero di download; ad esempio impostando questo numero ad '1' il file non sarà più accessibile dopo un singolo download.

h2. Installazione e Configurazione di Slashorg Downloader

Prerequisiti: installare apache, php, mysql.

Scaricare l'applicazione dal sito http://www.slashorg.net. 

Estrarre l'applicazione in una directory nella quale apache abbia accesso.

<pre>

ex: /var/www/sorg-dir/

</pre>

Assegnare correttamente i permessi alla directory dell'applicativo 

<pre>

chown -R www-data:www-data /var/www/sorg-dir

</pre>

Creare un database per l'applicazione, con un utente ed una password di connessione come nel seguente esempio:

<pre>

mysqladmin create dbname

mysql> grant all privileges on dbname.* to 'username'@'localhost' identified by 'password';

mysql> flush privileges;

</pre>

Procedere con l'installazione accedendo alla pagina @http://localhost/sorg/setup@ e seguire i passi dell'installazione.

h2. Configurazione upload file size

Per poter uploadare file di grandi dimensioni impostare le seguenti variabili nel file @php.ini@ ad un valore appropriato:

<pre>

post_max_size = 100M

upload_max_filesize = 100M

</pre>

h2. Personalizzazione

Il programma permette di condividere file nella rete, e accesso ai files è reso possibile grazie ad una access key.

La accesse key è un URL che ha come prefisso il contenuto della variabile @$_SERVER['PHP_SELF']@, ovvero l'indirizzo con il quale si accede al server. Per poter generare url customizzati basta inserire nel file di configurazione @conf.php@ (@sorg.dir/conf.php@) la variabile

<pre>

$extern_url = 'prefisso access key'

</pre>

Questo è il codice che genera l'access key con l'url customizzato (@sorg-dir/index.php@, linea 140):

<pre>

$url = 'http://' . $_SERVER['HTTP_HOST'];

if (dirname($_SERVER['PHP_SELF']) != '/')

	$url .= dirname($_SERVER['PHP_SELF']);

	$url .= "/?key=$hash";

	$new_url = $extern_url."/?key=$hash";

	$html = $lang['hash_key_success']."<a href=\"$url\">$url</a><br><br>Extern url:<br><a href=\"$new_url\">$new_url</a>";

</pre>

h2. CPersonalizzazione Logo

Per inserire un logo nell'applicazione si deve aggiungere il seguente codice prima della riga 20 del file @include/inc_header.php@:

<pre>

<div><img src="logo.jpg"/></div>

</pre>

e inserire nella directory radice dell'applicazione l'immagine @logo.jpg@.

h2. Modifica Lingua Default

La lingua di default può essere selezionata all'interno del file @conf.php@ editando il valore della seguente variabile:

<pre>

$SetDisplayLang = 'it_IT';

// Supported charsets: 'fr_FR', 'en_GB', 'en_US', 'de_DE', 'it_IT', 'pt_PT', 'nl_NL'.

</pre>

h2. Guida utilizzo  Slashorg Downloader

h3. Introduzione

Il programma Slashorg Downloader permette di condividere files tra utenti. L'installazione crea l'utente amministratore che inizialmente è l'unico in grado di condividere file e creare nuovi utenti.

Dopo essersi loggati nell'applicazione con credenziali di amministratore è possibile accedere al “pannello di controllo” che permette di:

* Gestire gli utenti

* Modificare le cartelle (folders) condivise

* Creare nuovi account

h3. Creazione nuovo utente

L'utente amministratore può creare nuovi utenti in grado di accedere all'applicazione inserendo un “username” univoco, un indirizzo email ed una password.

Dopo avere creato un nuovo utente l'amministratore può editare il suo profilo aggiungendo ad esempio una directory “base” per l'utente, o assegnare maggiori permessi come “accesso con scrittura e/o cancellazione” o “condivisione file”.

Se non si assegna una directory base ad un utente come default questo avrà  la directory radice degli upload dell'applicazione, riuscendo a leggere i file al suo interno. Se invece l'utente amministratore crea una cartella e la assegna al nuovo utente le operazioni rimangono vincolate alla nuova directory.

h3. Condivisione Files

La condivisione dei file può avvenire in due modalità differenti:

* Tramite upload ed utente in grado di leggere

 Un utente in grado di scrivere su una cartella può fare l'upload di file che verranno visti da tutti coloro in grado di leggere sulla cartella sulla quale è stato fatto l'upload.

* Tramite link di condivisione

 Un utente con i permessi di amministratore può rendere condivisibile un file anche per coloro che non sono utenti dell'applicazione. Cliccando su “condividi” file viene generato un link che permette di accedere in maniera diretta al file; infatti il link contiene un chiave di accesso (stringa alfanumerica) che identifica il file all'interno  dell'applicazione.