Progetto

Generale

Profilo

SlashorgDownloader » Cronologia » Versione 15

Simone Piccardi, 22-12-2010 19:25

1 15 Simone Piccardi
h1. Descrizione Generale
2 1 Amministratore Truelite
3 14 Amministratore Truelite
Slashorg downloader è una applicazione che permette di condividere in maniera sicura files tra utenti. 
4 1 Amministratore Truelite
5 15 Simone Piccardi
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).
6 8 Amministratore Truelite
7 1 Amministratore Truelite
Slashorg Downloader permette di superare questi problemi ed in più aggiunge politiche di sicurezza allo scambio di files tra utenti del web. 
8
9 11 Amministratore Truelite
Un utente di Slashorg può condividere file in due modi:
10 14 Amministratore Truelite
* Facendo UPLOAD di file e creando un link di accesso per questo:
11
*** 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.
12
* Creando nuovi account che hanno il permesso di autenticarsi al sistema:
13
*** 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.
14 1 Amministratore Truelite
15 8 Amministratore Truelite
16
All'interno di Slashorg si possono quindi distinguere tre tipologie di utenti:
17 14 Amministratore Truelite
* Amministratore: tutti i privilegi, ovvero LETTURA, SCRITTURA, DOWNLOAD, CREAZIONE CARTELLE, GESTIONE UTENTI
18
* Utente Loggato: un utente riconosciuto dal sistema che può avere privilegi di LETTURA, SCRITTURA, DOWNLOAD, CREAZIONE CARTELLE nella sua home directory
19
* Utente Anonimo: può eseguire il DONWLOAD di file attraverso il 'link di accesso'
20 1 Amministratore Truelite
21 8 Amministratore Truelite
22 1 Amministratore Truelite
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:
23 14 Amministratore Truelite
* Limite di tempo: un link di accesso può restare valido per un tempo scelto dall'utente che lo crea (minuti, ore, giorni, ecc...)
24 8 Amministratore Truelite
* 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.
25 1 Amministratore Truelite
26 14 Amministratore Truelite
h2. Installazione e Configurazione di Slashorg Downloader
27
28
Prerequisiti: installare apache, php, mysql.
29 1 Amministratore Truelite
30
Scaricare l'applicazione dal sito http://www.slashorg.net. 
31
32
Estrarre l'applicazione in una directory nella quale apache abbia accesso.
33 15 Simone Piccardi
34 1 Amministratore Truelite
<pre>
35
ex: /var/www/sorg-dir/
36 14 Amministratore Truelite
</pre>
37 1 Amministratore Truelite
38 14 Amministratore Truelite
Assegnare correttamente i permessi alla directory dell'applicativo 
39 15 Simone Piccardi
40 1 Amministratore Truelite
<pre>
41 15 Simone Piccardi
chown -R www-data:www-data /var/www/sorg-dir
42 1 Amministratore Truelite
</pre>
43 14 Amministratore Truelite
44 1 Amministratore Truelite
45
Creare un database per l'applicazione, con un utente ed una password di connessione come nel seguente esempio:
46 15 Simone Piccardi
47 1 Amministratore Truelite
<pre>
48
mysqladmin create dbname
49
50
mysql> grant all privileges on dbname.* to 'username'@'localhost' identified by 'password';
51
mysql> flush privileges;
52
</pre>
53 2 Amministratore Truelite
54 15 Simone Piccardi
Procedere con l'installazione accedendo alla pagina @http://localhost/sorg/setup@ e seguire i passi dell'installazione.
55 2 Amministratore Truelite
56 14 Amministratore Truelite
57 1 Amministratore Truelite
h2. Configurazione upload file size
58
59 15 Simone Piccardi
Per poter uploadare file di grandi dimensioni impostare le seguenti variabili nel file @php.ini@ ad un valore appropriato:
60 1 Amministratore Truelite
61
<pre>
62 14 Amministratore Truelite
post_max_size = 100M
63 1 Amministratore Truelite
upload_max_filesize = 100M
64
</pre>
65 14 Amministratore Truelite
66 2 Amministratore Truelite
67 15 Simone Piccardi
h2. Personalizzazione
68 14 Amministratore Truelite
69
Il programma permette di condividere file nella rete, e accesso ai files è reso possibile grazie ad una access key.
70 15 Simone Piccardi
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
71
72 1 Amministratore Truelite
<pre>
73
$extern_url = 'prefisso access key'
74
</pre>
75 14 Amministratore Truelite
76 15 Simone Piccardi
Questo è il codice che genera l'access key con l'url customizzato (@sorg-dir/index.php@, linea 140):
77
78 2 Amministratore Truelite
<pre>
79 1 Amministratore Truelite
$url = 'http://' . $_SERVER['HTTP_HOST'];
80 14 Amministratore Truelite
if (dirname($_SERVER['PHP_SELF']) != '/')
81 1 Amministratore Truelite
	$url .= dirname($_SERVER['PHP_SELF']);
82
	$url .= "/?key=$hash";
83
	$new_url = $extern_url."/?key=$hash";
84 2 Amministratore Truelite
	$html = $lang['hash_key_success']."<a href=\"$url\">$url</a><br><br>Extern url:<br><a href=\"$new_url\">$new_url</a>";
85 1 Amministratore Truelite
</pre>
86
87 14 Amministratore Truelite
88 15 Simone Piccardi
h2. CPersonalizzazione Logo
89 2 Amministratore Truelite
90 15 Simone Piccardi
Per inserire un logo nell'applicazione si deve aggiungere il seguente codice prima della riga 20 del file @include/inc_header.php@:
91
92 14 Amministratore Truelite
<pre>
93 1 Amministratore Truelite
<div><img src="logo.jpg"/></div>
94
</pre>
95 14 Amministratore Truelite
96 15 Simone Piccardi
e inserire nella directory radice dell'applicazione l'immagine @logo.jpg@.
97 14 Amministratore Truelite
98 15 Simone Piccardi
99 14 Amministratore Truelite
h2. Modifica Lingua Default
100 4 Amministratore Truelite
101 15 Simone Piccardi
La lingua di default può essere selezionata all'interno del file @conf.php@ editando il valore della seguente variabile:
102 14 Amministratore Truelite
103 5 Amministratore Truelite
<pre>
104
$SetDisplayLang = 'it_IT';
105 14 Amministratore Truelite
// Supported charsets: 'fr_FR', 'en_GB', 'en_US', 'de_DE', 'it_IT', 'pt_PT', 'nl_NL'.
106 5 Amministratore Truelite
</pre>
107 14 Amministratore Truelite
108
109 15 Simone Piccardi
h2. Guida utilizzo  Slashorg Downloader
110 14 Amministratore Truelite
111 5 Amministratore Truelite
h3. Introduzione
112
113
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.
114
115 14 Amministratore Truelite
Dopo essersi loggati nell'applicazione con credenziali di amministratore è possibile accedere al “pannello di controllo” che permette di:
116
117
* Gestire gli utenti
118 5 Amministratore Truelite
* Modificare le cartelle (folders) condivise
119
* Creare nuovi account
120 14 Amministratore Truelite
121
122
h3. Creazione nuovo utente
123 5 Amministratore Truelite
124
L'utente amministratore può creare nuovi utenti in grado di accedere all'applicazione inserendo un “username” univoco, un indirizzo email ed una password.
125
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”.
126
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.
127 14 Amministratore Truelite
128
h3. Condivisione Files
129
130 5 Amministratore Truelite
La condivisione dei file può avvenire in due modalità differenti:
131 14 Amministratore Truelite
* Tramite upload ed utente in grado di leggere
132 5 Amministratore Truelite
 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.
133 14 Amministratore Truelite
* Tramite link di condivisione
134 5 Amministratore Truelite
 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.