Integration - LiveBox Cloud
Transcript
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