Integration - LiveBox Cloud

2014
LBINT
http://www.liveboxcloud.com
LiveBox Srl non rilascia dichiarazioni o garanzie in merito al contenuto o uso di questa
documentazione e declina qualsiasi garanzia espressa o implicita di commerciabilità o idoneità
per uno scopo particolare. LiveBox Srl si riserva il diritto di rivedere questa pubblicazione e di
apportare modifiche al suo contenuto, in qualsiasi momento, senza alcun obbligo di notificare
qualsiasi persona o entità di tali revisioni o modifiche.
Inoltre, LiveBox Srl non rilascia dichiarazioni o garanzie in merito ad alcun software e in
particolare disconosce qualsiasi garanzia espressa o implicita di commerciabilità o idoneità per
uno scopo particolare. LiveBox Srl si riserva il diritto di apportare modifiche a qualsiasi parte del
software LiveBox in qualsiasi momento, senza alcun obbligo di notificare qualsiasi persona o
entità di tali cambiamenti.
© 2013-2014 LiveBox Srl. Tutti i diritti riservati. Nessuna parte di questa pubblicazione può
essere riprodotta, fotocopiata, memorizzata su un sistema di recupero, o trasmessa senza
l'espresso consenso scritto dell'editore.
http://www.liveboxcloud.com
1
LiveBox è un software di private cloud che permette di memorizzare, condividere e modificare i
documenti archiviati all’interno del datacenter aziendale offrendo un elevato livello di sicurezza.
È un sistema multipiattaforma accessibile da tutti i device mobili e remoti che garantisce la
continuità del business salvaguardando in ogni momento dati e documenti aziendali.
La guida che stiamo per leggere è divisa in due aree, la prima descrive il processo di
registrazione, la seconda invece spiega come eseguire il primo login a LiveBox attraverso le
applicazioni disponibili.
Per gli approfondimenti relativi alle funzionalità della piattaforma LiveBox ed all’utilizzo delle
sue applicazioni vi preghiamo di far riferimento al nostro sito web:
http://www.liveboxcloud.com ed alla documentazione tecnica in esso contenuta.
LiveBox Support Team
http://www.liveboxcloud.com
2
Sommario
1.
LIVEBOX, UN FILE SHARING PRIVATO ............................................................................................................. 4
2.
INTEGRAZIONE ..................................................................................................................................................... 5
2.1
3.
ENTEPRISE SERVICE BUS .................................................................................................................................... 6
3.1
4.
LDAP COME AUTENTICAZIONE ............................................................................................................... 5
ESTENDERE LE FUNZIONALITA’ DI LIVEBOX ......................................................................................... 7
LIVEBOX API .......................................................................................................................................................... 8
4.1
SVILUPPO DI CUSTOM CLIENT ................................................................................................................. 8
-
Login ............................................................................................................................................................... 8
-
Logout ............................................................................................................................................................ 8
-
List ................................................................................................................................................................... 8
-
Download/Upload ....................................................................................................................................... 8
-
Crud ................................................................................................................................................................ 8
-
Trash ............................................................................................................................................................... 8
-
Share ............................................................................................................................................................... 9
-
Crypt ............................................................................................................................................................... 9
-
Categories ..................................................................................................................................................... 9
-
Mail ................................................................................................................................................................. 9
-
Network Share ............................................................................................................................................. 9
-
Search ............................................................................................................................................................. 9
-
Info .................................................................................................................................................................. 9
-
Versioning ..................................................................................................................................................... 9
http://www.liveboxcloud.com
3
1.
LIVEBOX, UN FILE SHARING PRIVATO
LiveBox è una piattaforma di file sharing di tipo privato in architettura client/server. Il server risiede
all’interno dell’infrastruttura del cliente, garantendo la riservatezza e la sicurezza del dato.
Disponendo di una connettività Internet con IP pubblico (o registrato su un servizio di naming
dinamico) è altresì possibile garantire l’accessibilità da remoto. Essa può essere effettuata da
browser complaint con lo standard HTML5 (IE 10, Firefox, Chrome, Opera, Safari), da sistemi OS
Android (4.x), da sistemi iOS (da 6.x), da sistemi Windows (da XP SP3, 32 bit o 64 bit), da Mac OSX
(>= 10.7). Nel corso del 2014 si garantirà il supporto a piattaforme Windows Phone 8.
Due i paradigmi che hanno portato allo sviluppo della nostra piattaforma:
-
L’installazione e l’utilizzo all’interno della propria infrastruttura Hardware.
La condivisione dei contenuti, in modo privato, sicuro e senza movimentazione dei files.
http://www.liveboxcloud.com
4
2.
INTEGRAZIONE
2.1
LDAP COME AUTENTICAZIONE
ll protocollo LDAP definisce il metodo d'accesso ai dati sul server a livello del client.
LiveBox è integrato con sistemi di autenticazione basati su protocollo RFC 17771 LDAP.
Lo standard LDAP è ampiamente utilizzato in ambito Unix e Microsoft per gestire contenuti relativi
ad organizzazioni che possono essere rappresentate su uno schema gerarchico ad albero.
In Microsoft il protocollo LDAP è generalmente utilizzato nei servizi di Active Directory per la
gestione degli oggetti relativi ad una architettura di un dominio Microsoft (PC, Server, Stampanti,
Share, Utenti, Gruppi, Unità Organizzative, Sottodomini). Ogni oggetto LDAP può essere
caratterizzato da più elementi. Così, ad esempio, l’oggetto utente può essere associato ad una
email, ad un numero di telefono, all’insieme dei gruppi di appartenenza, etc.
LiveBox è in grado sia di offrire autenticazione ad applicazioni esterne in grado di interfacciarsi con
LDAP sia di autenticare i propri utenti provenienti da database LDAP.
1. Sicurezza
Nel caso in cui si scelga di utilizzare una sorgente esterna di autenticazione e identity management
basata su LDAP le password e le credenziali degli utenti non sono in nessun caso conservate
all’interno di LiveBox.
2. Più sistemi stesse credenziali
Utilizzare LiveBox offre molteplici vantaggi in termini di gestione delle applicazioni con esso
interconnesse. E’ possibile ad esempio utilizzare la propria username e password per accedere al
proprio PC, al proprio AGENT LiveBox ed alla propria mailbox aziendale.
3. Meglio e più in fretta
-
-
1
Semplificare la gestione delle password: maggiore è il numero delle password da gestire,
maggiore è la possibilità che vengano utilizzate password simili le une alle altre e facili da
memorizzare, abbassando così il livello di sicurezza;
Semplificare la gestione degli accessi ai vari servizi;
Semplificare la definizione e la gestione delle politiche di sicurezza.
http://www.ietf.org/rfc/rfc1777.txt
http://www.liveboxcloud.com
5
3. ENTEPRISE SERVICE BUS
Il processo che ha portato allo sviluppo di LiveBox è da sempre orientato alla realizzazione di
applicazioni che siano innovative, sicure e scalabili. In questo percorso i nostri partner hanno svolto
un ruolo importante in questo processo evolutivo.
Nell’ottica di rendere sempre più efficiente e collaborativo lo sviluppo di LiveBox il nostro team ha
avviato un processo che consentirà la piena compatibilità con MuleESB.
MuleESB è un Enterprise Service Bus, SOA oriented, in grado di gestire la comunicazione e
l’integrazione di servizi esterni con la nostra piattaforma. Lo sviluppo del Framework di MuleESB
consente in modo semplice ed immediato la distribuzione di applicazioni specifiche per LiveBox e
l’estensione di moduli preesistenti nella nostra architettura.
L’immagine seguente descrive i layer applicativi e loro interconnessioni.
Mule ESB
Come rappresentato nell’immagine, MuleESB (l’ESB che LiveBox utilizza) è rappresentabile come
una dorsale attraverso la quale viaggiano servizi software e componenti applicativi. Esso è connesso
con il backend di LiveBox e, attraverso un sistema di message routing, permette all’infrastruttura di
rimanere in ascolto su implementazioni installabili in seguito.
http://www.liveboxcloud.com
6
Le caratteristiche principali di MuleESB sono:
1. Service creation and hosting – Espone e ospita servizi riutilizzabili, usando MuleESB come
contenitore di servizi
2. Service mediation – Protegge i servizi da messaggi formattati e protocolli, separando la
business logic dalla messaging, e abilita la location-independent service calls
3. Message routing – distribuisce, filtra, aggrega e ri-sequenza messaggi basati su contenuti e
regole
4. Data transformation – scambia dati attraverso diversi formati e protocolli di trasporto
3.1
ESTENDERE LE FUNZIONALITA’ DI LIVEBOX
MuleESB può essere utilizzato come strumento di estensione di LiveBox. In tal senso, è possibile
sviluppare plugin, strumenti di monitoraggio, e/o ulteriori applicazioni da collegare al bus per
comunicare con l’infrastruttura.
Lo sviluppo delle componenti di integrazione può avvenire attraverso gli strumenti forniti dal
MuleESB SDK2
L’IDE consigliato è Eclipse.
2
http://www.mulesoft.org/documentation/display/current/Mule+Fundamentals
http://www.liveboxcloud.com
7
4.
LIVEBOX API
LiveBox espone una grande quantità di servizi REST utilizzabili come API attraverso HTTP POST. Il
formato da essi utilizzati è JSON, sia in request che response.
4.1
SVILUPPO DI CUSTOM CLIENT
Attraverso l’utilizzo delle LiveBox API è possibile sviluppare client non ufficiali. Lo scopo di una
realizzazione di questo tipo può essere quella di creare un client ad-hoc in base all’esigenza del
cliente, o quella di scrivere un’applicazione semplificata e/o limitata rispetto a quella ufficiale.
La lista di una parte delle API disponibili ed utilizzabili è la seguente:
-
Login
1.
2.
3.
4.
services/Login.php
services/LoginAuthPin.php
services/RefreshToken.php
services/GetDomainList.php
-
Logout
1. services/Logout.php
-
List
1. services/List.php
-
Download/Upload
1. services/FileDownload.php
2. services/FileUpload.php
-
Crud
1.
2.
3.
4.
5.
6.
-
services/CreateFolder.php
services/Delete.php
services/Rename.php
services/Move.php
services/Copy.php
services/UnDeleteFile.php
Trash
1. services/GetDeleted.php
2. services/PermanentlyRemove.php
http://www.liveboxcloud.com
8
-
Share
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
services/Share.php
services/GetUserGroups.php
services/GetUsersInGroup.php
services/GetExternalShared.php
services/GetMyShared.php
services/GetShared.php
services/Unshare.php
services/GetSharedUsers.php
services/RemoveShare.php
services/GetLink.php
-
Crypt
1. services/FileCrypt.php
2. services/FileDecrypt.php
-
Categories
1. services/GetStandardCategories.php
-
Mail
1. services/imap/GetAccountList.php
2. services/imap/ImapAttachmentDownload.php
3. services/imap/DeleteAccount.php
-
Network Share
1. services/samba/GetAllSambaShare.php
2. services/samba/ImportFromSambaShare.php
3. services/samba/ExportToSambaShare.php
-
Search
1. services/SearchUserAndGroup.php
2. services/SearchFile.php
-
Info
1. services/GetFileInfo.php
2. services/GetApplicationInfo.php
-
Versioning
1. services/GetVersioning.php
2. services/RestoreVersioning.php
Per l’utilizzo e la lista completa delle API si rimanda al documento tecnico di riferimento.
http://www.liveboxcloud.com
9