MANUALE UTENTE
INDICE 1. Descrizione servizio... 3 1.1. Informazioni sul servizio di Telecom Italia... 3 1.2. Ruoli e Autenticazione per il servizio di Telecom Italia... 3 1.3. Strumenti... 5 1.4. Documentazione... 6 2. Utilizzare il portale... 7 2.1. Il portale di servizio... 7 2.2. La componente cloud storage... 8 2.3. Gestione del servizio... 10 2.3.1. Token e Gruppi Token... 11 2.3.1.1. Creazione di Token e Gruppi Token... 12 2.3.1.2. Gruppi Token... 13 2.3.1.3. Token... 15 2.3.2. La Dashboard Attività... 17 2.3.2.1. Metriche... 17 2.3.2.2. Riepilogo... 19 2.3.2.3. Storico... 20 2.4. Gestione degli Utenti... 21 2.4.1. Aggiungere un Utente... 22 2.4.2. Modificare un Utente... 22 2.4.3. Cancellare un Utente... 23 3. Servizi di assurance... 23 2 di 23
1. Descrizione servizio Il Cloud Storage rientra nella categoria delle piattaforme IaaS per l erogazione di spazio storage come servizio. Le sue caratteristiche principali sono: Elastic: il cliente può aumentare o ridurre il proprio spazio on-demand Pay per use: si paga solamente lo spazio utilizzato Accesso via internet (o opzionalmente via MPLS): attraverso protocolli standard (Soap e Rest) 1.1. Informazioni sul servizio di Telecom Italia Il portale di di Telecom Italia è l accesso all offerta di Cloud Storage. Tramite il portale è possibile: Gestire gli utenti e assegnare i ruoli Gestire le credenziali di accesso al servizio Visualizzare l utilizzo del servizio Accedere alle risorse per sviluppatori 1.2. Ruoli e Autenticazione per il servizio di Telecom Italia La piattaforma di Cloud Storage consente una gestione dei ruoli a livello utente. Fondamentalmente sono previsti due diversi tipi di ruoli: Account Manager: E il ruolo di più alto livello assegnato al Cliente. Può creare nuovi utenti e assegnare dei ruoli. E il service administrator lato Cliente. Account User: E un utente senza particolari autorizzazioni a fornire permessi ad altri utenti, ma può utilizzare lo spazio disco a disposizione e creare token e token group. In particolare i due ruoli sono in grado di compiere le seguenti attività: Account Manager: gli utenti con questo ruolo possono o Creare nuovi utenti o Modificare utenti esistenti o Cancellare utenti esistenti o Aggiungere Gruppi Token o Modificare Gruppi Token Cambiare Nome e Descrizione Aggiungere/Rimuovere utenti al Gruppo Token Modificare la lista di accesso Cambiare il ruolo d accesso degli utenti al Gruppo Token (TokenGroup Manager, TokenGroup Reader) o Cancellare Gruppi Token o Aggiungere Token o Abilitare Token o Disabilitare Token o Resettare Token 3 di 23
Account user. Questo utente ha il ruolo di Token Group Manager ed ha a disposizione le seguenti funzionalità: o Modificare Gruppi Token Cambiare Nome e Descrizione Modificare la lista di accesso Cambiare il ruolo d accesso degli utenti al Gruppo Token o Cancellare Gruppi Token o Aggiungere Token o Abilitare Token o Disabilitare Token o Resettare Token Un token group manager non può creare altri gruppi di token (funzione utilizzabile solo dall account manager) Esistono infine utenti che possono vedere i dettagli dei Token ma non possono aggiungere o modificare Token o Gruppi Token. Questa tipologia di utenti sono denominati Token Group Reader. La tabella seguente ricapitola le operazioni consentite per ogni tipologia di utente. OPERAZIONI CONSENTITE Account Account User Manager Token Group Manager Token Group Reader OPERAZIONI SUGLI UTENTI Creare nuovi utenti Si No No Modificare utenti esistenti Si No No Cancellare utenti esistenti Si No No OPERAZIONI SUI GRUPPI TOKEN Aggiungere Gruppi Token Si No No Cambiare Nome e Descrizione Si Si No Aggiungere/Rimuovere utenti Si No No Modificare la lista d'accesso Si Si No Cambiare il ruolo d'accesso degli utenti Si Si No Cancellare Gruppi Token Si No No OPERAZIONI SUI TOKEN Aggiungere Nuovo Si Si No Abilitare Token Si Si No Disabilitare Token Si Si No Resettare Token Si Si No Utilizzare Token Si Si Si I servizi di Cloud Storage utilizzano una modalità di autenticazione basata su Token. Per ulteriori dettagli sulle autorizzazioni basate su Token fare riferimento alla sezione 2.3.1 4 di 23
Token e Gruppi Token (2.3.1). 1.3. Strumenti Il servizio di Cloud Storage fornisce i seguenti servizi: Console di Gestione: un interfaccia grafica che consente di visualizzare le attività relative al consumo di storage nonché generare e distribuire le credenziali di autenticazione (chiamate Token) alle applicazioni che devono accedere al servizio. API (Application Programming Interface): E un insieme di procedure disponibili (per un utente IT, es. programmatore) per creare, leggere, aggiornare e cancellare oggetti e gestire i metadati. Rappresentano un metodo per ottenere un'astrazione tra l'hardware e l utilizzatore evitando di scrivere tutte le funzioni dal nulla. Libreria dei Web Service: E una libreria di utilities sw per i principali linguaggi di programmazione che facilita ulteriormente l utilizzo delle API. E possibile effettuare il download dal portale delle librerie per i linguaggi Java,.NET, PHP e FLEX. 5 di 23
1.4. Documentazione Dalla pagina iniziale del portale di è possibile accedere alla seguente documentazione: Guida all utilizzo: questo manuale Risorse per gli sviluppatori: il link riporta direttamente alla pagina degli sviluppatori di ATMOS dove è possibile trovare: o Programmer's Guide: la guida per i programmatori che vogliono sviluppare una propria applicazione che sfrutti i servizi di cloud storage. Contiene tutti i dettagli formali per l utilizzo dell interfaccia webservice SOAP e REST. o Bindings: le librerie, disponibili per i principali linguaggi di programmazione (es. C,.NET, Java, Flex, ecc), che consentono un più rapido impiego delle API o Coding quick start: degli esempi per lo sviluppo di applicazioni o Sample Apps and Tools: delle applicazioni di esempio 6 di 23
2. Utilizzare il portale 2.1. Il portale di servizio Il portale di servizio consente di attivare/disattivare nuovi utenti o gruppi di token o token Monitorare l uso delle proprie risorse Creare Report per utente o gruppi di utenti Per accedere al portale del servizio di di Telecom Italia andare al seguente indirizzo: https://dataspace.nuvolaitaliana.it Si arriva alla seguente pagina: Per poter effettuare il login bisogna essere un utente registrato al servizio. Una volta che ricevute le credenziali di accesso al servizio si effettuano i seguenti passi: 1. Cliccare sul link Login presente nella pagina di benvenuto 2. Inserire Nome Utente e Password 3. Cliccare sul bottone Accedi 7 di 23
Subito dopo il login nella pagina personalizzata si avrà una vista di riepilogo relativa all uso corrente delle risorse. NOTA: Per maggiore sicurezza, al primo accesso sarà richiesto di cambiare immediatamente la password inizialmente fornita. 2.2. La componente cloud storage Per accedere alla componente cloud storage del servizio di di Telecom Italia utilizzare il seguente indirizzo https://ds-api.nuvolaitaliana.it Questo sarà l indirizzo che dovrà essere utilizzato dalle applicazioni per comunicare direttamente con le API messe a disposizione dal servizio. 8 di 23
Pertanto, una volta configurate le utenze/token all interno del portale di servizio (vedi 2.1), per poter usufruire dello spazio disco a consumo si utilizzerà il link indicato in questo paragrafo per comunicare direttamente con le API messe a disposizione dal servizio senza necessità di accedere ulteriormente al portale. 9 di 23
2.3. Gestione del servizio Per accedere alla componente di gestione del servizio, cliccare sul link Gestisci il servizio. La nuova pagina che si aprirà consentirà di gestire: Token e Gruppi Token: a seconda del profilo utente si potrà: o Aggiungere, modificare, cancellare Gruppi Token o Aggiungere, Abilitare, disabilitare, resettare Token Dashboard attività: per vedere l utilizzo delle risorse Per cambiare pagina basterà semplicemente cliccare sul link della sezione richiesta. 10 di 23
2.3.1. Token e Gruppi Token Il servizio di Cloud Storage implementa un modello di sicurezza basato su Token. Questo significa che ogni applicazione che accede al servizio Cloud Storage utilizzerà una coppia ID Token e Password Condivisa. La sezione Token e Gruppi Token è utilizzata per la generazione delle suddette coppie. Un Token di autenticazione consiste in: ID Token: identificativo univoco del Token composto da due parti separate da uno slash (/). I primi 32 caratteri sono una stringa alfanumerica che rappresenta l identificativo sul sistema (tutti i Token avranno questa prima parte in comune). La seconda parte è una stringa di 20 caratteri generata randomicamente dal sistema che garantisce l unicità del ID Token rispetto a qualsiasi altro. Un esempio di ID Token è il seguente: 432e45a0f8894be4aca5efedb27b1a34/A673606784246098c0fc Password Condivisa : una stringa codificata con il formato base64 E possibile assegnare uno o più Token ad un Gruppo Token. Un Gruppo Token è un modo per poter organizzare i Token. Supponiamo, per esempio, che un azienda abbia tre dipartimenti (IT, Finanza, Operation) che usano entrambi i servizi Cloud Storage. Ogni dipartimento ha 10 applicazioni ed ognuna di essa ha un suo specifico Token autorizzativo. Se si crea un Gruppo Token per ogni dipartimento si sarà in grado di monitorare lo spazio storage e la banda utilizzata per applicazione (a livello Token), dipartimento (a livello Gruppo Token) e complessivo. 11 di 23
2.3.1.1. Creazione di Token e Gruppi Token La sezione Token e Gruppi Token consente di effettuare diverse operazioni, sulla base del ruolo e delle autorizzazioni che sono state concesse dall Account Manager. Se si ha il ruolo di Token Group Manager è possibile: Modificare Gruppi Token o Cambiare Nome e Descrizione o Modificare la lista di accesso o Cambiare il ruolo d accesso degli utenti al Gruppo Token (TokenGroup Manager, TokenGroup Reader) Cancellare Gruppi Token Aggiungere Token Abilitare Token Disabilitare Token Resettare Token: con questa operazione, l ID del token resta invariato, ma cambia la password condivisa per l accesso allo storage. Se si ha il ruolo di Token Group Reader è possibile vedere i dettagli dei Token ma non si potrà aggiungere o modificare Token o Gruppi Token. All atto della creazione dell utenza di Account Manager verrà sempre creato un Gruppo Token chiamato default ed un Token. Successivamente il nome del Gruppo Token potrà essere cambiato. 12 di 23
2.3.1.2. Gruppi Token Per Aggiungere un Gruppo Token si devono effettuare le seguenti operazioni: 1. Andare nella sezione Token e Gruppi Token a. Dalla pagina iniziale cliccando sul link Gestisci il servizio b. Da qualunque altra pagina cliccando sul link Servizio 2. Cliccare su Aggiungi Gruppo Token 3. Riempire i campi: a. Nome del Gruppo Token (campo obbligatorio) b. Descrizione 4. Cliccare su OK Per Modificare un Gruppo Token si devono effettuare le seguenti operazioni: 1. Andare nella sezione Token e Gruppi Token a. Dalla pagina iniziale cliccando sul link Gestisci il servizio b. Da qualunque altra pagina cliccando sul link Servizio 2. Selezionare il Gruppo Token che si vuole modificare 3. Cliccare su Modifica Gruppo Token 4. Cambiare i parametri necessari e alla fine cliccare su OK Per Cancellare un Gruppo Token si devono effettuare le seguenti operazioni: 1. Andare nella sezione Token e Gruppi Token a. Dalla pagina iniziale cliccando sul link Gestisci il servizio b. Da qualunque altra pagina cliccando sul link Servizio 2. Selezionare il Gruppo Token che si vuole cancellare 3. Cliccare su Rimuovi Gruppo Token 13 di 23
Il pulsante Rimuovi Gruppo Token è presente solo se si ha il ruolo di Token Group Manager per lo specifico Gruppo Token e se non sono presenti Token al suo interno 14 di 23
2.3.1.3. Token I Token non sono altro che delle credenziali con le quali un applicativo può accedere al servizio di Cloud Storage per la creazione di oggetti (file). Ogni oggetto avrà come proprietario il Token che l ha creato, in ogni caso è possibile definire una lista di controllo per gli accessi agli oggetti (ACL: Access Control List). Per un utilizzo base, si consiglia di creare delle sottocartelle, nella directory radice (root), in cui memorizzare gli oggetti. Utilizzatori avanzati potranno impiegare le ACL al fine di controllare puntualmente gli accessi ad ogni oggetto. Per Aggiungere un Token si devono effettuare le seguenti operazioni: 1. Andare nella sezione Token e Gruppi Token a. Dalla pagina iniziale cliccando sul link Gestisci il servizio b. Da qualunque altra pagina cliccando sul link Servizio 2. Selezionare il Gruppo Token dove si vuole creare il nuovo Token 3. Nella sezione Token di autenticazione cliccare su Aggiungi Token 4. Nella nuova finestra riempire i campi relativi a: a. Descrizione 5. Cliccare su OK. Ora il token creato è anche automaticamente abilitato. Una volta creato non è possibile cancellare un Token. Per Modificare un Token si devono effettuare le seguenti operazioni: 1. Andare nella sezione Token e Gruppi Token a. Dalla pagina iniziale cliccando sul link Gestisci il servizio b. Da qualunque altra pagina cliccando sul link Servizio 2. Selezionare il Gruppo Token che possiede il Token che si vuole modificare 3. Nella sezione Token di autenticazione selezionare il Token da modificare 4. Cliccare su Disabilita Token per disabilitare il Token 15 di 23
5. Cliccare su Reset Token per resettare la Password Condivisa (i dati creati con quel token non saranno modificati) Disabilitare un Token significa inibire l accesso alla piattaforma tramite quelle specifiche credenziali. La disabilitazione di un Token non cancella i dati ad esso afferenti. 16 di 23
2.3.2. La Dashboard Attività La Dashboard attività consente di vedere l utilizzo dello spazio storage e della banda con diverse modalità. 2.3.2.1. Metriche Il portale di consente di misurare: Utilizzo di disco: il quantitativo di spazio storage utilizzato Banda in Ingresso: il quantitativo di dati che sono stati trasmessi ai sistemi durante uno specifico periodo temporale Banda in Uscita: il quantitativo di dati che sono stati trasmessi dai sistemi durante uno specifico periodo temporale Il Cloud Storage memorizza i dati in forma di oggetti, un oggetto consiste in: Object ID: un identificativo unico che viene assegnato quando l oggetto è creato. E una stringa di 44 caratteri. Dati: I dati degli applicativi, per esempio un file word, un filmato o un file mp3 Metadati: i metadati contengono le informazioni che descrivono i dati e possono essere dei seguenti tipi: o Di sistema: includono il nome del file, la dimensione, data di modifica, data di creazione, lista di accesso, e Object ID o Dell utente: comprende delle coppie arbitrarie determinate dalla tipologia di file memorizzato dall utente.. Esempio Un esempio di metadati e loro utilizzo nel contesto dei file video (contenuti cinematografici) potrebbe essere il seguente: i file video, hanno associato i metadati regia ed anno. 17 di 23
Questo consente all utente di un applicazione di poter cercare e trovare i film di uno specifico regista, oppure l anno in cui un certo film è stato prodotto, piuttosto che tutti i film prodotti in un determinato anno 18 di 23
2.3.2.2. Riepilogo In questa parte sono mostrati i dati aggregati per Gruppi Token complessivi, per un singolo Gruppo Token o per Token individuali. I dati possono inoltre essere ulteriormente rappresentati nelle seguenti modalità: Spazio disco utilizzato per Gruppo Banda utilizzata per Gruppo Griglia dati per Gruppo Spazio disco utilizzato per Policy Banda Utilizzata per Policy Griglia dati per Policy 19 di 23
2.3.2.3. Storico In questa parte viene mostrato l utilizzo storico dell utilizzo del disco e della banda utilizzata per Gruppo Token. E possibile definire l intervallo di analisi scegliendo i valori dei campi Data inizio e Data fine e cliccando sul bottone Aggiorna. Selezionando una delle righe della sezione Gruppi Token verrà filtrato il risultato mostrato nei grafici. Selezionando il radio button Mostra Descrizione oppure Mostra ID saranno rappresentati nella sezione Token di Autenticazione la descrizione o l ID dei Token relativi al Gruppo Token scelto. Selezionando una delle righe della sezione Token di Autenticazione verrà ulteriormente filtrato il risultato mostrato nei grafici. Selezionando il menu a tendina Tutte le policy verrà filtrato il risultato mostrato nel grafico Spazio Utilizzato visualizzando una delle policy assegnate. Selezionando il menu a tendina Tutte le modalità di Accesso verrà filtrato il risultato mostrato nel grafico Banda Utilizzata visualizzando il dettaglio della banda usata per le varie modalità di accesso (es. REST, NTFS, CIFS) se disponibili. 20 di 23
2.4. Gestione degli Utenti Subito dopo il login nella tua pagina personalizzata avrai una vista di riepilogo relativa all uso corrente delle risorse. Per accedere alla componente di gestione degli utenti, cliccare sul link Il Tuo Account in alto a destra. La nuova pagina che si aprirà avrà le seguenti funzionalità. Gestisci Utenti: in questa sezione è possibile: o Aggiungere utenti o Modificare utenti: assegnando o rimuovendo il ruolo di Account Manager agli utenti esistenti o Rimuovere un utente: utilizzato per rimuovere l accesso di un utente al sistema Cambia Password: per cambiare la propria password di accesso al sistema NOTA: si potrebbe essere in grado di accedere solo ad un sottoinsieme di funzionalità sulla base del ruolo che è stato assegnato. 21 di 23
2.4.1. Aggiungere un Utente Per Aggiungere un Utente bisogna autenticarsi con il ruolo di Account Manager per effettuare le seguenti operazioni: 1. Andare nella sezione Il tuo Account cliccano sul link in alto a destra da una qualunque pagina del portale 2. Cliccare sul bottone Aggiungi Utente 3. Nella nuova finestra riempire i campi relativi a: a. Nome utente b. Password c. Conferma password d. Nome e. Cognome f. Email 4. Selezionare Account Manager se si vuole o meno che l utente abbia i relativi privilegi 5. Cliccare su OK. 2.4.2. Modificare un Utente Per Modificare un Utente si devono effettuare le seguenti operazioni: 1. Andare nella sezione Il tuo Account cliccano sul link in alto a destra da una qualunque pagina del portale 2. Cliccare sul bottone Modifica Utente 3. Selezionare Account Manager se si vuole o meno che l utente abbia i relativi privilegi 4. Cliccare su OK. 22 di 23
2.4.3. Cancellare un Utente Per Cancellare un Utente si devono effettuare le seguenti operazioni: 1. Andare nella sezione Il tuo Account cliccano sul link in alto a destra da una qualunque pagina del portale 2. Cliccare sul bottone Rimuovi Utente 3. Confermare che si desidera veramente cancellare l utenza selezionata cliccando sul bottone Si Tutti i token creati espressamente dall utente saranno ora gestiti solamente dal Account Manager. 3. Servizi di assurance In caso di necessità il Cliente può aprire una service request verso la Control Room di Telecom Italia secondo una delle seguenti modalità: Tramite il portale di accesso ai servizi ICT della Nuvola Italiana di Telecom Italia accedendo al link https://ictservices.telecomitalia.it/ Tramite numero verde: 800.199.477 pin 0030 23 di 23