Progetto

Generale

Profilo

SlashorgDownloader » Cronologia » Versione 8

Amministratore Truelite, 09-04-2008 12:59

1 1 Amministratore Truelite
[[TracNav(TOC)]]
2 8 Amministratore Truelite
== Descrizione Generale ==
3
Slashorg downloader è una applicazione che permette di condividere in maniera sicura files tra utenti. 
4 1 Amministratore Truelite
5 8 Amministratore Truelite
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 può essere bloccato a causa  della dimensione ed il tipo del file.
6
7
Slashorg Downloader permette di superare questi problemi ed in più aggiunge politiche di sicurezza allo scambio di files tra utenti del web. 
8
9
Un utente di SlashOrg può condividere file in due modi:
10
 * 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 il quale 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 leggere:
13
   * I nuovi utenti possono loggarsi nel sistema SlashOrg e scaricare i file/cartelle. Se un amministratore concede il permesso di fare UPLOAD di nuovi file questi potranno aggiugere al sistema file da condividere a loro volta con l'amministratore.
14
15
16
All'interno di SlashOrg si possono quindi distinguere tre tipologie di utenti:
17
 * 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 CARTELL nella sua home directory
19
 * Utente Anonimo: può eseguire il DONWLOAD di file attraverso il 'link di accesso'
20
21
22
23
24
25
Sicuro - Non temporaneo
26
27
28
SlashOrg Downloader is a totally free of charge file management solution written in the PHP script language. I wrote it initially to stop people snooping through the files on my Web server whilst allowing me to offer controlled downloads to friends. It uses special "access links" generated by the administrator that allow access to a shared folder until they expire or have exceeded the maximum usage limit authorized by the administrator.
29
30
The latest version of SlashOrg Downloader has many more features, as you can see in the feature list below. Check it out!
31 6 Amministratore Truelite
== Installazione e Configurazione di Slashorg Downloader ==
32 1 Amministratore Truelite
33
Prerequisiti: installare apache, php, mysql.
34
35
Scaricare l'applicazione dal sito http://www.slashorg.net. 
36
37
Estrarre l'applicazione in una directory nella quale apache abbia accesso.
38
{{{
39 2 Amministratore Truelite
ex: /var/www/sorg-dir/
40 1 Amministratore Truelite
}}}
41
42
Assegnare correttamente i permessi alla directory dell'applicativo 
43
{{{
44
ex: chown -R www-data:www-data /var/www/sorg-dir
45
}}}
46
47
48
Creare un database per l'applicazione, con un utente ed una password di connessione come nel seguente esempio:
49
{{{
50
mysqladmin create dbname
51
52
mysql> grant all privileges on dbname.* to 'username'@'localhost' identified by 'password';
53
mysql> flush privileges;
54 2 Amministratore Truelite
}}}
55
56
Procedere con l'installazione accedendo alla pagina http://localhost/sorg/setup e seguire i passi dell'installazione.
57
58
== Configurazione upload file size ==
59
60
Per poter uploadare file di grandi dimensioni impostare le seguenti variabili nel file php.ini ad un valore appropriato:
61
62
{{{
63
64
post_max_size = 100M
65
upload_max_filesize = 100M
66
}}}
67
68
== Customizzazione ==
69
70
Il programma permette di condividere file nella rete, e accesso ai files è reso possibile grazie ad una access key.
71
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
72
{{{
73
$extern_url = 'prefisso access key'
74
}}}
75
76
Questo è il codice che genera l'access key con l'url customizzato (sorg-dir/index.php, line 140):
77
{{{
78
$url = 'http://' . $_SERVER['HTTP_HOST'];
79
if (dirname($_SERVER['PHP_SELF']) != '/')
80
	$url .= dirname($_SERVER['PHP_SELF']);
81
	$url .= "/?key=$hash";
82
	$new_url = $extern_url."/?key=$hash";
83
	$html = $lang['hash_key_success']."<a href=\"$url\">$url</a><br><br>Extern url:<br><a href=\"$new_url\">$new_url</a>";
84 1 Amministratore Truelite
}}}
85 4 Amministratore Truelite
86
== Customizzazione Logo ==
87
Per inserire un logo nell'applicazione si deve aggiungere il seguente codice prima della riga 20 del file include/inc_header.php 
88
{{{
89
<div><img src="logo.jpg"/></div>
90
}}}
91
e inserire nella directory radice dell'applicazione il l'immagine logo.jpg
92 5 Amministratore Truelite
93
== Modifica Lingua Default ==
94
95
La lingua di default può essere selezionata all'interno del file conf.php editando il valore della seguente variabile:
96
{{{
97
$SetDisplayLang = 'it_IT';
98
// Supported charsets: 'fr_FR', 'en_GB', 'en_US', 'de_DE', 'it_IT', 'pt_PT', 'nl_NL'.
99
}}}
100
101
102
= Guida utilizzo  Slashorg Downloader =
103
104
=== Introduzione ===
105
106
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.
107
108
Dopo essersi loggati nell'applicazione con credenziali di amministratore è possibile accedere al “pannello di controllo” che permette di:
109
110
 * Gestire gli utenti
111
 * Modificare le cartelle (folders) condivise
112
 * Creare nuovi account
113
114
=== Creazione nuovo utente ===
115
116
L'utente amministratore può creare nuovi utenti in grado di accedere all'applicazione inserendo un “username” univoco, un indirizzo email ed una password.
117
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”.
118
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.
119
120
=== Condivisione Files ===
121
La condivisione dei file può avvenire in due modalità differenti:
122
 * Tramite upload ed utente in grado di leggere
123
 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.
124
 * Tramite link di condivisione
125
 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.