UTILIZZO DI ADOBE ACROBAT CONNECT PRO 7 WEB SERVICES

Transcript

1 UTILIZZO DI ADOBE ACROBAT CONNECT PRO 7 WEB SERVICES

2 2008 Adobe Systems Incorporated. Tutti i diritti riservati. Utilizzo di Adobe Acrobat Connect Pro 7 Web Services Protetto dai brevetti degli Stati Uniti ; ; ; ; ; ; ; ; ; ; ; altri brevetti richiesti negli Stati Uniti e in altri Paesi. Se la presente guida viene distribuita con software che include un accordo di licenza per l utente finale, la guida e il software in esso descritto sono concessi in licenza e possono essere usati e copiati solo in conformità ai termini di tale licenza. Ad eccezione di quanto concesso da tale licenza, nessuna parte di questa guida può essere riprodotta, memorizzata in un sistema per il recupero dati o trasmessa in qualsiasi forma o con qualsiasi mezzo, elettronico, meccanico, di registrazione o altro, senza il previo consenso scritto da parte di Adobe Systems Incorporated. Il contenuto di questa guida è protetto dalle norme sul copyright, anche se non è distribuito con il software comprendente il contratto di licenza per l utente finale. Il contenuto della presente guida viene fornito solo a scopo informativo, è soggetto a modifica senza preavviso e non deve essere interpretato come un impegno di Adobe Systems Incorporated. Adobe Systems Incorporated non si assume alcuna responsabilità per eventuali errori o imprecisioni eventualmente presenti nella presente guida. Se in un progetto intendete inserire grafica e immagini esistenti, tenete presente che tali materiali potrebbero essere protetti dalla legge sul copyright. L inserimento non autorizzato di tali materiali nel vostro lavoro potrebbe rappresentare una violazione dei diritti del titolare del copyright. Prima di procedere, chiedete pertanto la necessaria autorizzazione al proprietario del copyright. Qualsiasi riferimento a nomi di società nei modelli di esempio è a titolo puramente dimostrativo e non intende fare riferimento a nessuna organizzazione esistente. Adobe, il logo Adobe logo, Adobe Connect, Adobe Captivate, Acrobat Connect, Authorware, Breeze e Flash sono marchi o marchi registrati di Adobe Systems Incorporated negli Stati Uniti e/o in altri Paesi. Informazioni aggiornate/ulteriori informazioni sul codice di altri produttori sono disponibili nel sito La cancellazione dell eco acustico RealDuplex è protetta dal Copyright SPIRIT. Questo prodotto include software sviluppato dalla Apache Software Foundation ( Questo prodotto contiene software BSAFE e/o TIPEM di RSA Security, Inc. La compressione e la decompressione video Flash sono basate sulla tecnologia video On2 TrueMotion On2 Technologies, Inc. Tutti i diritti riservati. Questo prodotto include software sviluppato da OpenSymphony Group ( Alcune porzioni hanno la licenza Nellymoser ( La tecnologia di compressione audio a 3 livelli MPEG ha una licenza Fraunhofer IIS e THOMSON ( Tecnologia di compressione e decompressione video Sorenson Spark su licenza Sorenson Media, Inc. Thomson: Il licenziatario non potrà utilizzare l'audio compresso MP3 all'interno del Software per la trasmissione in tempo reale (terrestre, via satellite, cavo o altro supporto), né per la trasmissione via Internet o altre reti, comprese - a titolo esemplificativo ma non esaustivo - le reti intranet, né nelle applicazioni "pay-audio" o "audio on demand" su qualsiasi dispositivo che non sia un PC (ossia, telefoni cellulari o apparecchi "set-top box"). Il licenziatario riconosce che l'utilizzo del Software per dispositivi che non siano PC, come qui descritto, potrebbe richiedere il pagamento di royalties per la licenza, o altri tipi di importi, per terze parti che potrebbero detenere i diritti di proprietà intellettuale relativi alla tecnologia MP3 e che Adobe non ha corrisposto né royalties né altre somme di denaro per diritti di proprietà intellettuale di terzi relativamente al suddetto utilizzo. Se il Licenziatario ha bisogno di un decodificatore MP3 per un utilizzo diverso da quello su PC, egli è responsabile dell'ottenimento della necessaria licenza per la tecnologia MP3. Adobe Systems Incorporated, 345 Park Avenue, San Jose, California 95110, USA. Avviso per gli utenti finali del Governo degli Stati Uniti. Il Software e la Documentazione sono Articoli commerciali, conformemente alla definizione in 48 C.F.R , che consistono in Software per computer commerciale e Documentazione di software per computer commerciale, conformemente alle espressioni utilizzate in 48 C.F.R o 48 C.F.R , a seconda del caso. In conformità alla norma 48 C.F.R o 48 C.F.R. dal al applicabile, il software commerciale per computer e la documentazione del software commerciale per computer vengono concessi in licenza agli utenti finali degli enti governativi (a) soltanto come articoli commerciali e (b) soltanto con i diritti attribuiti a tutti gli utenti finali, secondo i termini e le condizioni qui indicate. Tutti i diritti non pubblicati sono riservati, ai sensi della legge sul diritto d autore vigente negli Stati Uniti d America. Adobe Systems Incorporated, 345 Park Avenue, San Jose, CA , USA. Per gli utenti finali del Governo degli Stati Uniti, Adobe accetta di rispettare tutte le norme sulle pari opportunità applicabili comprese, se pertinenti, le norme dell Executive Order e relativi emendamenti, Sezione 402 del Vietnam Era Veterans Readjustment Assistance Act del 1974 (38 USC 4212) e la sezione 503 del Rehabilitation Act del 1973 e relativi emendamenti e le norme previste in 41 CFR Parti 60-1, 60-60, e La clausola di azione affermativa e le norme indicate nella frase precedente saranno incorporate per riferimento.

3 iii Sommario Prima di iniziare Suggerimenti e formazione Ambiente di sviluppo Risorse aggiuntive Convenzioni Capitolo 1: Architettura Flusso di dati Prima chiamata API Capitolo 2: Login e richieste Login da un applicazione Inviare una richiesta in un documento XML Analizzare una risposta con XPath Analizzare una risposta di errore Logout di un utente Capitolo 3: Concetti base Trovare un principal-id Elencare entità o ospiti Creare utenti Aggiornare utenti Creare campi personalizzati Creare gruppi Trovare gli oggetti SCO Scaricare file Controllare le autorizzazioni Capitolo 4: Riunioni Trovare riunioni Visualizzare riunioni Creare gli URL delle stanze riunioni Creare riunioni Creare riunioni personalizzate Invitare gli utenti alle riunioni Rimuovere utenti dalle riunioni Calcolare l'utilizzo della riunione Controllare le quote delle riunioni Ottenere gli archivi delle riunioni Ottenere i risultati di un sondaggio di una riunione Avviare riunioni con autenticazione esterna Configurare le impostazioni di conformità

4 iv Capitolo 5: Formazione Autorizzazioni della libreria Formazione Trovare corsi e programmi Creare un corso Visualizzare la formazione di un utente Iscrivere un utente Iscrivere un numero elevato di utenti Visualizzare le informazioni sul programma Resoconto dei punteggi Capitolo 6: Riferimento alle azioni Azioni nuove e rimosse account-expiry-info acl-field-info acl-field-info acl-field-update acl-preference-update common-info custom-fields custom-fields-delete custom-field-update expiry-settings-info expiry-settings-update group-membership-update learning-path-info learning-path-update limited-administrator-permissions info limited-administrator-permissions-update login logout meeting-disclaimer-info meeting-disclaimer-update meeting-feature-update permissions-info permissions-reset permissions-update principal-info principal-list principal-list-by-field principals-delete principal-update quota-threshold-info quota-threshold-exceeded quota-threshold-update report-active-meetings report-bulk-consolidated-transactions report-bulk-objects report-bulk-questions report-bulk-slide-views

5 v report-bulk-users report-course-status report-curriculum-taker report-meeting-attendance report-meeting-concurrent-users report-meeting-sessions report-meeting-summary report-my-courses report-my-events report-my-meetings report-my-training report-quiz-interactions report-quiz-question-answer-distribution report-quiz-question-distribution report-quiz-question-response report-quiz-summary report-quiz-takers report-quotas report-sco-slides report-sco-views report-user-trainings-taken report-user-training-transcripts sco-contents sco-delete sco-expanded-contents sco-info sco-move sco-nav sco-search sco-search-by-field sco-shortcuts sco-update sco-upload user-accounts user-transcript-update user-update-pwd Capitolo 7: Riferimento per filtri e ordinamento filter-definition sort-definition

6 vi Capitolo 8: Riferimento comune access feature-id field icon lang object-type path-type permission-id quota-id status attributo di stato time-zone-id type Capitolo 9: Applicazione di esempio Creare una classe adattatore Eseguire il login dell utente Inviare richieste XML Analizzare le risposte XML Visualizzare le informazioni sull utente Elencare le riunioni di un utente Creare e aggiornare riunioni Visualizzare i dettagli sulla riunione

7 1 Prima di iniziare Adobe Acrobat Connect Pro e Adobe Acrobat Connect Pro Server 7 forniscono servizi Web che possono essere richiamati dai client per lo scambio di dati con account Acrobat Connect Pro. Nella presente guida viene illustrato il modo in cui un applicazione invia le chiamate API XML ad Acrobat Connect Pro e interpreta la risposta XML. È rivolta agli sviluppatori che desiderano creare applicazioni personalizzate per Acrobat Connect Pro o integrarla in un altro sistema, ad esempio un sistema di gestione dell apprendimento o un servizio di directory LDAP. Prima di utilizzare questa guida è consigliabile conoscere già i concetti base del linguaggio XML e dell uso di HTTP per comunicare con un server da un applicazione client. Nella presente guida sono inclusi alcuni esempi di codice Java, ma non si presuppone l utilizzo di un linguaggio o un ambiente specifico. Suggerimenti e formazione Adobe fornisce una vasta gamma di risorse per aiutare gli utenti a conoscere e utilizzare i prodotti Adobe. Adobe Developer Center: esercitazioni, materiale di riferimento, guide alla creazione di script e altre informazioni approfondite. Altre risorse: formazione, libri, forum utenti, certificati del prodotto e altro. Extra e download: contenuti e software scaricabili. Adobe Developer Center In questa sezione di Adobe.com basata sulla comunità sono disponibili informazioni per utenti esperti, inclusi sviluppatori di software e di plug-in. Qui troveranno esercitazioni, SDK, guide alla creazione di script e codice di esempio, nonché forum, feed RSS, seminari online e altre risorse tecniche. Altre risorse Per i prodotti Adobe sono disponibili ulteriori fonti di informazioni e aiuto. Per ulteriori informazioni sulle opzioni di supporto tecnico gratuito e a pagamento, visitate la sezione Supporto del sito Web di Adobe. Le questioni principali sono elencate per prodotto, nei siti Web di Adobe U.S.A. e Adobe Giappone. Seguite il collegamento Formazione per accedere ai libri Adobe Press, alle risorse online, ai video, ai corsi di formazione guidati da un istruttore, ai programmi di certificazione software Adobe e altro ancora. Visitate la sezione Comunità del sito Web di Adobe per trovare forum, blog e altri canali attraverso i quali gli utenti condividono strumenti e informazioni, fanno domande e scoprono come altri utenti sfruttano al meglio il software. I forum utente sono disponibili in inglese, francese, spagnolo, tedesco e giapponese nella pagina Supporto principale del sito Web di Adobe locale. I blog sono pubblicati in numerose lingue. Extra e download Per i contenuti gratuiti e i componenti aggiuntivi, visitate Adobe Studio Exchange, una comunità online dove gli utenti possono scaricare e condividere migliaia di azioni gratuite, plug-in e altri contenuti utilizzabili con i prodotti Adobe. Per visitare Adobe Studio Exchange, visitate Adobe Design Center dalla pagina iniziale del sito Web di Adobe. I download disponibili nel sito Web di Adobe includono aggiornamenti gratuiti, tryout e altro software utile. Inoltre, la sezione relativa ai plug-in di Adobe Store consente di accedere a migliaia di plug-in di sviluppatori di terze parti per l automatizzazione delle attività, la personalizzazione dei flussi di lavoro, la creazione di effetti professionali specializzati ealtro ancora.

8 2 Ambiente di sviluppo Acrobat Connect Pro Web Services consente di utilizzare qualsiasi linguaggio o piattaforma in cui sia possibile inviare e ricevere XML su HTTP per sviluppare applicazioni personalizzate. Ad esempio, è possibile utilizzare Java e la piattaforma J2EE, C#.NET, PHP, un server di portali oppure qualsiasi piattaforma di sviluppo Web. La maggior parte delle applicazioni è costituita da portali o applicazioni Web. In generale, potrete trovare utili i seguenti strumenti: Una libreria di codice di analisi XML, se il linguaggio di programmazione utilizzato supporta l analisi XML. Una libreria di codice di gestione dei cookie che facilita la gestione dei cookie di sessione restituiti da Acrobat Connect Pro. Uno strumento per visualizzare le intestazioni di risposta e richiesta HTTP in un browser. Molti di questi strumenti sono disponibili su Internet. Risorse aggiuntive Su Internet è possibile trovare numerose risorse utili che forniscono informazioni su Acrobat Connect Pro, sui servizi Web e XML, nonché sulle altre tecnologie usate da Acrobat Connect Pro. Acrobat Connect Pro Centro risorse di Acrobat Connect Pro Il centro risorse, disponibile nel sito Web di Adobe, viene aggiornato regolarmente con esercitazioni, simulazioni, informazioni sulle procedure ottimali e link alle procedure. Centro per sviluppatori di Acrobat Connect Pro Gli sviluppatori troveranno utile il Developer Center (Centro per sviluppatori), aggiornato regolarmente con esercitazioni e articoli sulla creazione di applicazioni per Acrobat Connect Pro. Centro documentazione di Acrobat Connect Pro Nel Documentation Center (Centro documentazione) è disponibile tutta la documentazione dei prodotti Acrobat Connect Pro, scaricabile e consultabile. Centro di assistenza di Acrobat Connect Pro Nel Support Center (Centro di assistenza) sono disponibili informazioni aggiornate, comprese note tecniche, presentazioni di Acrobat Connect Pro e informazioni sul programma di assistenza. È inoltre possibile consultare i Forum di assistenza per discussioni tra utenti su argomenti tecnici. Centro di assistenza su licenza di Acrobat Connect Pro Nel Licensed Support Center (Centro di assistenza su licenza) sono disponibili documentazione e altre risorse per i clienti che dispongono della licenza di Adobe Acrobat Connect Pro Server 7. XML e servizi Web Web Services Primer In questa sezione del sito xml.com vengono illustrati i concetti base dei servizi Web. XML Tutorial In questa sezione del sito w3schools.com viene fornita un introduzione all uso del linguaggio XML. XPath Tutorial In questa sezione sempre del sito W3Schools viene descritto XPath che consente di analizzare un documento XML per poterlo utilizzare in un applicazione. XSLT Tutorial Questa esercitazione nel sito W3Schools illustra come utilizzare le trasformazioni XSL per convertire dati XML in altri formati. Specifica XSL Transformations (XSLT) Nel sito W3C (w3.org) si trova la definizione ufficiale della specifica XSLT elaborata dal comitato responsabile degli standard. Numeric Representation of Dates and Time Questa sezione del sito Web dell International Organization for Standardization (iso.org) fornisce informazioni su come usare il formato della data e dell ora definito dallo standard ISO Date and Time Formats Questa sezione del sito Web W3C (w3.org) contiene la definizione ufficiale del formato della data e dell ora secondo lo standard ISO 8601.

9 3 Altre tecnologie Centro per sviluppatori di Flash Player e Centro per sviluppatori di Flash Media Server, entrambi disponibili nel Adobe Developer Center (Centro per sviluppatori di Adobe) contengono articoli, esempi e suggerimenti per lo sviluppo di applicazioni che utilizzano Adobe Flash Player e Adobe Flash Media Server. SCORM Concepts In questa sezione del sito Web di Eduworks Corporation (eduworks.com) è contenuta un esercitazione sul modello SCORM (Shareable Content Object Reference Model), sugli oggetti SCO (Shareable Content Objects) e sui sistemi LMS (Learning Management Systems). LDAP Roadmap In questa sezione del sito Kings Mountain Systems ( viene presentato il protocollo LDAP (Lightweight Directory Access Protocol). Questo sito mette a disposizione buon materiale di supporto o link per gli sviluppatori che integrano una directory LDAP ad Acrobat Connect Pro. Microsoft SQL Server Acrobat Connect Pro utilizza un database Microsoft SQL Server per il recupero e la scrittura di dati da parte di applicazioni personalizzate. Potete trovare risorse utili nel Centro per sviluppatori di Microsoft SQL Server (msdn.microsoft.com), incluse informazioni, riferimenti, comunità e supporto. Convenzioni Nella presente guida vengono utilizzate le convenzioni standard del settore per la visualizzazione del codice. Tuttavia, con riferimento alle API si indica una definizione formale del contratto API tra un applicazione chiamante e il server. Di conseguenza, è necessario descrivere le definizioni della sintassi degli URL di richiesta. Per una maggiore leggibilità, sezioni distinte di un URL di richiesta sono disposte su righe diverse, come segue: &filter-definition=value &session=breezesessioncookievalue Tuttavia, quando immettete un URL di richiesta nella barra degli indirizzi di un browser o quando lo costruite in un applicazione, dovrà essere su un unica riga: Gli elementi di sintassi con codice in caratteri blu rappresentano le definizioni costruite, con un collegamento ipertestuale alla sintassi della definizione.

10 4 Capitolo 1: Architettura Benvenuti in Adobe Acrobat Connect Pro Web Services, il livello di servizi Web su Adobe Acrobat Connect Pro Server 7 e la suite di applicazioni Connect Enterprise. Web Services consente di creare portali o applicazioni Web che integrano le funzionalità di Acrobat Connect Pro e le informazioni di reporting con sistemi di altri produttori quali portali, sistemi di gestione dei rapporti con i clienti e sistemi di pianificazione delle risorse aziendali. Training Events Presenter Meeting APIs & SDKs Acrobat Connect Pro Server Tramite un API XML, Acrobat Connect Pro Web Services fornisce alle applicazioni funzionalità di riunione, formazione ed eventi. Ad esempio, se avete un sistema centrale di gestione degli utenti (come una directory LDAP, Microsoft Active Directory o un sistema di un altro produttore) che è parte integrante dei processi aziendali, con Web Services potete scrivere un applicazione in grado di sincronizzare gli utenti tra tale sistema e Acrobat Connect Pro. Utilizzando la piattaforma J2EE o un altra tecnologia, potete estrarre un elenco di utenti dalla directory, confrontarlo con un elenco di utenti di Acrobat Connect Pro, quindi eseguire gli aggiornamenti richiesti nel repository utenti di Acrobat Connect Pro, come aggiungere o eliminare utenti o gruppi. Questo è un esempio di applicazione personalizzata. Per ulteriori informazioni, visitate il Centro per sviluppatori di Acrobat Connect Pro.

11 5 Flusso di dati I flussi di dati tra le applicazioni client e Acrobat Connect Pro sono illustrati nel seguente diagramma. Le applicazioni personalizzate scritte dall utente seguono i percorsi da 1 a 2 e da A a B. Le applicazioni Acrobat Connect Pro (come Adobe Acrobat Connect Pro, Acrobat Connect Pro Training o Acrobat Connect Pro Events) possono seguire un qualsiasi percorso di flussi di dati. Applicazione client Acrobat Connect Pro Server Browser Web 1 A C RTMPS:443 Autorità di certificazione 2 B D Web Services API Server Web/ applicazione Flash Player 3 RTMP: Flash Media Server 3a RTMPT:80 4a Database SQL Flusso di dati tra Acrobat Connect Pro e applicazioni client Il flusso di dati può essere cifrato con SSL o non cifrato. Non cifrato Se il flusso di dati non è cifrato, le connessioni vengono effettuate tramite i protocolli HTTP e RTMP (Adobe Real Time Messaging Protocol) e seguono i percorsi descritti nella tabella seguente. 1 Il browser Web client richiede una riunione di Acrobat Connect Pro o un URL di contenuto sulla porta (i percorsi della connessione possono variare). 2 Il server Web risponde con un trasferimento di contenuto oppure fornisce al browser client le informazioni per accedere a Acrobat Connect Pro. 3 Adobe Flash Player richiede una connessione ad Adobe Flash Media Server su RTMP:1935 e 4 Flash Media Server risponde e viene aperta una connessione permanente per inviare al browser il traffico della riunione. 3a (alternativa) 4a (alternativa) In alcuni casi, Flash Player richiede una connessione a Flash Media Server, ma può ottenere solo una connessione tunnel su RTMPT:80. Flash Media Server risponde e viene aperta una connessione tunnel per inviare al browser il traffico della riunione.

12 6 Cifrato Se il flusso di dati è cifrato, vengono effettuate connessioni protette tramite i protocolli HTTPS e RTMPS (Real Time Messaging Protocol su SSL), come segue. A B C D Il browser Web client richiede una riunione sicura o un URL di contenuto tramite una connessione cifrata su (i percorsi della connessione possono variare). Il server dell'applicazione/web risponde con un trasferimento di contenuto cifrato oppure fornisce al client le informazioni per creare una connessione cifrata su Acrobat Connect Pro. Flash Player richiede una connessione cifrata a Flash Media Server su RTMPS:443. Flash Media Server risponde e viene aperta una connessione permanente per inviare al browser il traffico della riunione. Applicazioni personalizzate Connect Pro Web Services fornisce un API XML; l applicazione deve quindi essere in grado di comunicare con Acrobat Connect Pro Server utilizzando XML su HTTP o XML su HTTPS. L API viene chiamata dall applicazione tramite un URL di richiesta e trasmettendo uno o più parametri come coppie nome/valore o documento XML. Dalla risposta XML restituita è possibile estrarre valori. I metadati, inclusi i nomi e le ore delle riunioni o dei corsi, gli URL delle stanze riunioni, gli URL dei contenuti e le informazioni dei rapporti, vengono recuperati dalle applicazioni personalizzate dal database Adobe Connect Pro. Il flusso di dati per un applicazione personalizzata che recupera i metadati dal database va da un browser Web client al server dell applicazione Web client, all API XML, al server dell applicazione Web Acrobat Connect Pro e al database SQL, quindi torna indietro. Il flusso di dati tra un applicazione personalizzata e Acrobat Connect Pro funziona nel modo seguente: 1 Un utente accede all applicazione personalizzata da un browser Web. 2 L applicazione chiama l API XML su o 3 Il server dell applicazione Web Acrobat Connect Pro autorizza l applicazione e i suoi utenti, recupera i metadati dal database SQL e restituisce i metadati. 4 Sul lato client, il server Web o dell applicazione, l analizzatore XML e le librerie di software gestiscono la risposta e la rimandano all applicazione. 5 L utente continua a lavorare nell applicazione personalizzata e fa clic sull URL di una riunione o di un contenuto. A questo punto, l utente accede a un applicazione Acrobat Connect Pro per entrare in una stanza riunioni e il flusso di dati tipico tra un applicazione Acrobat Connect Pro e il server ha inizio. Applicazioni Acrobat Connect Pro Le applicazioni Acrobat Connect Pro chiamano il server utilizzando la stessa API XML di Web Services utilizzata da un applicazione personalizzata. In generale, il contenuto viene trasportato sulla porta HTTP 80 o HTTPS 443. Per contenuto si intende diapositive, pagine HTTP, file SWF e file trasferiti mediante il contenitore Trasferimento file. Questi sono i numeri di porta predefiniti configurabili. Per ulteriori informazioni, consultate la Guida all installazione e alla configurazione di Acrobat Connect Pro. Le comunicazioni trasmesse in streaming in tempo reale provenienti da Flash Media Server vengono trasportate sulla porta RTMP Le comunicazioni trasmesse in streaming includono audio, video (webcam e FLV), condivisione di file e chat. Lo stato della riunione viene anche mantenuto sulla porta RTMP Componenti di Acrobat Connect Pro Acrobat Connect Pro presenta due componenti server, ciascuno dei quali utilizza un database SQL.

13 7 Server Web dell applicazione Il server Web dell applicazione è il cervello di Acrobat Connect Pro. In esso è contenuta ed eseguita tutta la logica aziendale necessaria per fornire il contenuto agli utenti. Vengono inoltre gestiti il controllo dell accesso, la sicurezza, le quote e le licenze, nonché le funzioni di gestione come clustering, failover e replica. Nel server Web dell applicazione viene inoltre gestito Acrobat Connect Pro Central, applicazione attraverso la quale è possibile visualizzare e gestire il contenuto e gli utenti dell organizzazione (quando non si utilizza un applicazione personalizzata o un sistema integrato di altri produttori). I metadati che descrivono il contenuto e gli utenti possono essere memorizzati in database SQL replicati singoli o multipli. Il server Web dell applicazione è senza stato, ovvero il ridimensionamento è quasi lineare. Flash Media Server Flash Media Server è il motore di Acrobat Connect Pro e consente di trasmettere in streaming l audio, il video e il contenuto multimediale utilizzando RTMP. Quando una riunione viene registrata e riprodotta, l audio e il video vengono sincronizzati, oppure il contenuto viene convertito e impacchettato per la condivisione schermo in tempo reale, grazie a Flash Media Server. Flash Media Server riveste inoltre un ruolo fondamentale nella riduzione del carico del server in quanto consente la memorizzazione nella cache delle pagine Web aperte di frequente, dei flussi e dei dati condivisi. Database SQL Acrobat Connect Pro utilizza il database Microsoft SQL Server per la memorizzazione permanente di metadati di transazione e di applicazioni, comprese informazioni su utenti, gruppi, contenuto e rapporti. I metadati memorizzati nel database vengono recuperati dall API XML. Il database può essere implementato con Microsoft SQL Server Desktop Engine (MSDE) o la versione completa di Microsoft SQL Server Prima chiamata API Acrobat Connect Pro Web Services presenta una struttura servlet per gestire le richieste API XML. Nel diagramma del flusso di dati, la struttura servlet è rappresentata dal componente API. Il servlet API riceve le richieste XML provenienti dai client e restituisce le risposte XML provenienti dal server dell applicazione Web e dal database. Una richiesta all API XML viene formattata come URL di richiesta HTTP gestito dal servlet API. Un URL di richiesta contiene un nome di azione e parametri in coppie nome/valore, nel modo seguente: Se potete accedere a un account Acrobat Connect Pro in cui provare le chiamate API, potete fare delle prove. Adobe consiglia di provare le chiamate API nel browser durante la fase di apprendimento dell API e scrittura delle applicazioni. Prima di iniziare è utile installare uno strumento che consenta di visualizzare le intestazioni di richiesta e risposta HTTP nel browser. Chiamata common-info in un browser 1 (Facoltativo) Attivate uno strumento per visualizzare le intestazioni HTTP nel browser. 2 Aprite un browser e passate alla pagina di login di Acrobat Connect Pro. 3 Senza eseguire il login, eliminate la parte dell URL dopo il nome del dominio e aggiungete una chiamata a commoninfo: La risposta proveniente da common-info fornisce informazioni sulla sessione con il server, in particolare il cookie che identifica la sessione: <status code="ok" /> <common locale="en" time-zone-id="85"> <cookie>breezbryf9ur23mbokzs8</cookie> <date> t01:21: :00</date> <host> <local-host>abc123def789</local-host> <url>/api/xml?action=common-info</url>

14 8 <version>connect_700_r641</version> <user-agent> Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1; SV1;.NET CLR ) </user-agent> </common> Quando eseguite il login di un utente da un applicazione, dovete inviare nuovamente il valore del cookie al server per identificare la sessione dell utente (consultate Login da un applicazione ). Chiamata principal-list in un browser Il valore del cookie BREEZESESSION ricevuto da common-info viene aggiunto dal browser all intestazione della richiesta nella richiesta successiva. 1 In un browser Web, eseguite il login ad Acrobat Connect Pro. Modificate l URL del browser per chiamare principal-list: 2 Controllate l intestazione della richiesta. Il valore del cookie BREEZESESSION viene inviato nuovamente al server: GET /api/xml?action=principal-list HTTP/1.1 Accept: */* Accept-Language: en-us Accept-Encoding: gzip, deflate User-Agent: Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1; SV1;.NET CLR ) Host: example.com Connection: Keep-Alive Cookie: BREEZESESSION=breezbryf9ur23mbokzs8 3 Controllate la risposta che elenca tutti i valori principal sul server, ciascuno nel proprio elemento principal. <status code="ok" /> <principal-list> <principal principal-id="624526" account-id="624520" type="user" has-children="false" is-primary="false" is-hidden="false"> <name>joe harrison</name> <login>jharrison@example.com</login> < >jharrison@example.com</ > </principal> <principal principal-id="624526" account-id="624520" type="user" has-children="false" is-primary="false" is-hidden="false"> <name>bob jones</name> <login>bjones@example.com</login> < >bjones@example.com</ > </principal>... </principal-list> Aggiungere filtri e ordinamenti Molte azioni nell API consentono di aggiungere un filtro per restituire solo determinati elementi di risposta o un ordinamento per visualizzare gli elementi di risposta in un determinato ordine. Un filtro è un parametro speciale che inizia con la parola chiave filter, seguita da un modificatore facoltativo, quindi da un nome di campo e da un valore. Di seguito sono riportati alcuni esempi di filtri: filter-name=jazz doe (che corrisponde ai risultati con il nome esatto jazz doe) filter-like-name=jazz (che corrisponde ai risultati che contengono jazz nel nome) filter-out-type=user (che restituisce i risultati che non hanno un tipo di user)

15 9 Questi sono solo alcuni esempi di filtri. È possibile trovarne altri in filter-definition. Controllate un azione nella sezione di riferimento ( Riferimento alle azioni a pagina 53) per verificare che la relativa risposta possa essere filtrata. In generale, se un azione consente i filtri, è possibile utilizzarli su qualsiasi elemento o attributo di risposta. Un ordinamento è un altro parametro speciale che inizia con la parola chiave sort (o sort1 o sort2), seguita da un nome di campo, quindi da una delle parole chiave asc o desc, ad esempio: sort-name=asc (per ordinare in ordine crescente per name) sort-group-id=desc (per ordinare in ordine decrescente per group-id) Questi sono solo alcuni esempi di ordinamento. Potete provare gli ordinamenti nel browser. Per ulteriori informazioni, consultate sort-definition. Eseguire una chiamata con un filtro e un ordinamento 1 Chiamate di nuovo principal-list, visualizzando solo i gruppi e ordinandoli alfabeticamente per nome: &sort-name=asc 2 Per limitare la risposta, scegliete un gruppo dall elenco e filtrate in base al nome: Questa volta viene restituito solo un gruppo: <status code="ok" /> <principal-list> <principal principal-id=" " account-id="624520" type="group" has-children="true" is-primary="false" is-hidden="false"> <name>developers</name> <login>developers</login> </principal> </principal-list> Come procedere A questo punto, potete continuare a provare le chiamate nel browser e a osservarne il funzionamento. È la cosa migliore e più facile per imparare l API XML. Per ulteriori informazioni, consultate una di queste fonti: La sezione di riferimento per le API, Riferimento alle azioni a pagina 53 Login e richieste a pagina 10 per informazioni su come eseguire il login degli utenti dalle applicazioni Concetti base a pagina 18 per imparare i tre concetti base sulle API Riunioni a pagina 29 per creare e gestire riunioni da un applicazione Formazione a pagina 43 per creare un applicazione per la formazione

16 10 Capitolo 2: Login e richieste In questo capitolo viene illustrato come eseguire il login di un utente dall applicazione, effettuare richieste, gestire le risposte ed eseguire il logout. Sono disponibili vari metodi per eseguire la maggior parte di queste attività, a seconda dell ambiente di sviluppo, della configurazione del server e della progettazione dell applicazione. Login da un applicazione Qualsiasi applicazione personalizzata scritta che utilizzi la funzionalità Adobe Acrobat Connect Pro Web Services o si integri a un sistema di un altro produttore deve eseguire il login di un utente ad Adobe Acrobat Connect Pro Server 7 o a un account su host Adobe Acrobat Connect Pro. Nella sua forma più semplice, il processo di login prevede la chiamata dell azione login. Tuttavia, la tecnica di login varia a seconda che si utilizzi la gestione dei cookie, che si disponga di un server con licenza o di un account su host e che si effettui l autenticazione direttamente in Acrobat Connect Pro o si utilizzi un autenticazione esterna. A seconda dell ambiente e della configurazione del server, è possibile utilizzare combinazioni di queste opzioni. Gestione dei cookie Quando un utente effettua il login, Acrobat Connect Pro restituisce un cookie che identifica la sessione dell utente. È necessario ritrasmettere il cookie al server su tutte le chiamate effettuate al server durante la sessione dell utente, dopodiché, quando l utente si disconnette, il server fa scadere il cookie che viene quindi invalidato. Nell ambiente di sviluppo, potete utilizzare una libreria di codici che gestisca automaticamente i cookie. Il processo di login e gestione di una sessione dell utente varia a seconda che si utilizzi una libreria di gestione dei cookie o si gestisca direttamente la sessione dell utente. Server con licenza o account su host Sia che l organizzazione disponga di Acrobat Connect Pro Server con licenza all interno del firewall o di un account su host Acrobat Connect Pro presso Adobe, le richieste XML vengono inviate comunque tramite HTTP o HTTPS. I requisiti di sicurezza e il processo di login, invece, variano. I clienti su host possono utilizzare determinati parametri con l azione login per evitare di inviare ID e password degli utenti su Internet. Autenticazione diretta o esterna Tanto per i clienti su host quanto per quelli con licenza, l autenticazione dell applicazione potrebbe avvenire direttamente su Connect Pro. In alternativa, potete autenticare gli utenti sulla vostra rete, impostare un identificatore in un intestazione di richiesta HTTP e inviarla ad Acrobat Connect Pro. Il processo di login varia a seconda che si utilizzi o meno l autenticazione diretta o esterna. Login ad Acrobat Connect Pro Server La tecnica standard per eseguire il login di un utente ad Acrobat Connect Pro Server prevede l utilizzo dell azione login, con trasmissione dell ID e della password di login dell utente. Questa tecnica funziona con le richieste HTTP GET e POST. È inoltre necessario gestire il cookie BREEZESESSION restituito dal server per ciascuna sessione dell utente. Se utilizzate una libreria di gestione dei cookie lato client, è preferibile optare per la gestione automatica dei cookie, anziché quella manuale. Se non disponete di una libreria di questo tipo, effettuate la chiamata login con il parametro session, molto più facile e affidabile rispetto all impostazione dei valori delle intestazioni HTTP. Nota: se inviate le password utenti ad Acrobat Connect Pro Server, usate SSL in modo che le password vengano cifrate durante il transito, anche se avete Acrobat Connect Pro Server con licenza all interno del vostro firewall. Eseguire il login con la gestione dei cookie 1 Chiamate l azione login, trasmettete l ID e la password di login dell utente, ma non immettete il parametro session: &password=football

17 11 2 Individuate nella risposta un codice di stato ok. Se il login ha esito positivo, il cookie BREEZESESSION viene restituito nell intestazione della risposta: Set-Cookie: BREEZESESSION=breezbryf9ur23mbokzs8;domain=.macromedia.com;path=/ 3 Lasciate che la libreria di gestione dei cookie gestisca il cookie BREEZESESSION. La libreria lato client ritrasmette il cookie al server in un intestazione di richiesta nelle chiamate successive, per il resto della sessione dell utente. Non dovete quindi impostare esplicitamente il cookie nell intestazione della richiesta. Quando l utente si disconnette il cookie scade. Eseguire il login utilizzando il parametro della sessione 1 Prima di eseguire il login dell utente, chiamate common-info per ottenere il valore del cookie BREEZESESSION: 2 Estraete il valore del cookie dalla risposta: <cookie>breezxq66rt43poai3if8</cookie> 3 Eseguite il login dell utente, specificando il valore del cookie: &password=football&session=breezxq66rt43poai3if8 4 Individuate nella risposta un codice di stato ok. 5 Utilizzate il parametro session con lo stesso valore del cookie nelle chiamate successive per l utente, fino al termine della sessione: &session=breezxq66rt43poai3if8 6 Quando l utente si disconnette o termina la sessione, non riutilizzate il valore del cookie. Login a un account su host Acrobat Connect Pro Server Anche per eseguire il login direttamente a uno o più account su host Acrobat Connect Pro si utilizza l azione login, ma oltre all ID e alla password di login dell utente occorre specificare un ID account o un nome di dominio. Potete specificare un nome di dominio in modo da evitare l invio di un ID account su Internet. Con un account su host Acrobat Connect Pro non è possibile utilizzare l autenticazione sign-on singola o esterna. È necessario trasmettere le credenziali di autenticazione dell utente sull account su host Acrobat Connect Pro, non le credenziali per una rete esterna. Nota: Poiché ID utente, password e informazioni sull account vengono inviate al vostro account sull host Acrobat Connect Pro tramite Internet, è importante che SSL sia attivato sull account Acrobat Connect Pro ospitato. Login a un account su host Acrobat Connect Pro Server con ID di account 1 Prima di eseguire il login dell utente, chiamate common-info con il nome di dominio dell account su host Acrobat Connect Pro nell URL di richiesta o nel parametro domain: Individuate nella risposta i valori cookie e account-id: <cookie>sbreezzd2dfr2ua5gscogv</cookie>... <account account-id="295153" /> 3 Raccogliete l ID e la password di login dell utente nella vostra applicazione. 4 Chiamate l azione login, aggiungendo le credenziali dell utente e i parametri account-id e session: &password=happy&account-id=295153&session=sbreezzd2dfr2ua5gscogv 5 Individuate nella risposta un codice di stato ok.

18 12 6 (Facoltativo) Se preferite, potete chiamare login prima di common-info, estrarre il valore del cookie dall intestazione della risposta e gestirlo manualmente o tramite una libreria di gestione dei cookie. Per ulteriori informazioni, consultate Eseguire il login con la gestione dei cookie o Eseguire il login utilizzando il parametro della sessione. Login a un account su host Acrobat Connect Pro Server con nome di dominio 1 Prima di eseguire il login dell utente, chiamate common-info con il nome di dominio dell account su host Acrobat Connect Pro nell URL di richiesta o nel parametro domain: Individuate nella risposta i valori cookie e host: <cookie>breezxq66rt43poai3if8</cookie>... <host> 3 Estraete il nome di dominio dal valore di host: acme.adobe.com 4 Nell applicazione, raccogliete l ID e la password di login dell utente. Accertatevi che l ID di login sia quello dell account su host Acrobat Connect Pro dell utente, non uno esterno. 5 Chiamate login, aggiungendo le credenziali dell utente e i parametri domain e session: &password=smith99&domain=acme.adobe.com&session=breezxq66rt43poai3if8 domain è equivalente a account-id, ma utilizzandolo si evita di inviare un ID account su Internet, specialmente se si utilizza una connessione non cifrata. 6 Individuate nella risposta un codice di stato ok. 7 (Facoltativo) Se preferite, potete chiamare login prima di common-info, estrarre il valore del cookie dall intestazione della risposta e gestirlo manualmente o tramite una libreria di gestione dei cookie. Per ulteriori informazioni, consultate Eseguire il login con la gestione dei cookie o Eseguire il login utilizzando il parametro della sessione. Login tramite autenticazione dell intestazione HTTP Nota: Le istruzioni fornite in questa sezione sono applicabili solo ad Acrobat Connect Pro Server. L applicazione può utilizzare un server centrale affidabile per autenticare gli utenti con sign-on singolo e trasmettere l autenticazione della rete (o esterna) ad Acrobat Connect Pro Server, senza trasmettere esplicitamente un ID e una password utente di Acrobat Connect Pro Server. Per istruzioni dettagliate su come impostare e configurare l autenticazione dell intestazione HTTP, consultate la Guida all installazione e alla configurazione di Adobe Acrobat Connect Pro.

19 13 Con l autenticazione dell intestazione HTTP, un utente esegue il login al server di autenticazione. Dopo che l utente si è autenticato, è necessario aggiungere un intestazione di richiesta HTTP che identifichi l utente o configurare un server proxy per l aggiunta dell intestazione. Il filtro di autenticazione in Acrobat Connect Pro (HeaderAuthenticationFilter) converte l identificatore dell utente in un ID di login di Acrobat Connect Pro e autentica l utente. Server di autenticazione Server proxy Filtro di autenticazione Acrobat Connect Pro Server Database SQL I filtri di autenticazione convertono le credenziali di autenticazione esterna in credenziali di Acrobat Connect Pro. L autenticazione esterna viene eseguita in aggiunta all autenticazione standard di Acrobat Connect Pro. Ogni utente che deve accedere ad Acrobat Connect Pro Server deve disporre di un login e di una password validi per Acrobat Connect Pro Server. Quando inviate una richiesta di login ad Acrobat Connect Pro Server con una credenziale di autenticazione esterna: Il filtro di autenticazione intercetta la richiesta e verifica la presenza di un utente su Acrobat Connect Pro Server con un campo ext-login corrispondente alla credenziale esterna. Se esiste una corrispondenza, il filtro trasmette l autenticazione esterna ad Acrobat Connect Pro Server e il server esegue il login dell utente. Se non esiste una corrispondenza, il filtro trasmette al server la richiesta di login che visualizza la relativa pagina. L utente deve quindi eseguire il login ad Acrobat Connect Pro Server. Se il login dell utente ha esito positivo, Acrobat Connect Pro Server aggiorna il campo ext-login nel profilo dell utente con la credenziale esterna proveniente dalla richiesta. Al successivo invio di una richiesta con la credenziale esterna dell utente, Acrobat Connect Pro Server trova una corrispondenza in ext-login e l utente non deve effettuare il login ad Acrobat Connect Pro. Se il login dell utente ha esito negativo, l utente non può accedere alle applicazioni, al contenuto o alle riunioni di Acrobat Connect Pro Server. Nelle procedure seguenti viene descritto come chiamare login quando si utilizza l autenticazione dell intestazione HTTP. Login ad Acrobat Connect Pro Server tramite autenticazione dell intestazione HTTP 1 Configurate i server di rete e Acrobat Connect Pro Server per l autenticazione dell intestazione HTTP seguendo le istruzioni contenute nella Guida all installazione e alla configurazione di Acrobat Connect Pro. 2 In [directory del server]/appserv/conf/web-inf/web.xml, rimuovete i tag di commento prima e dopo l elemento filter-mapping per HeaderAuthenticationFilter e aggiungeteli prima e dopo eventuali altri elementi filter-mapping: <filter-mapping> <filter-name>headerauthenticationfilter</filter-name> <url-pattern>/*</url-pattern> </filter-mapping> <!-- <filter-mapping> <filter-name>ntlmauthenticationfilter</filter-name> <url-pattern>/*</url-pattern> </filter-mapping> -->

20 14 3 Nell elemento filter per HeaderAuthenticationFilter, attivate il pattern /api/ per le URL di richiesta. È possibile procedere in due modi. Se l applicazione usa l API XML e un applicazione Acrobat Connect Pro Nell elemento filter per HeaderAuthenticationFilter, usate tag di commento per disabilitare l elemento init-param con un valore param-name pari a /api/: <!-- <init-param> <param-name>ignore-pattern-0</param-name> <param-value>/api/</param-value> </init-param> --> Se l applicazione usa solo l API XML Modificate l elemento filter-mapping per il tipo di filtro in modo da utilizzare il pattern URL /api/* anziché /*: <filter-mapping> <filter-name>headerauthenticationfilter</filter-name> <url-pattern>/api/*</url-pattern> </filter-mapping> Quindi, nell elemento filter per il tipo di filtro, aggiungete tag di commento prima e dopo tutti gli elementi init-param con un valore param-name pari a ignore-pattern-x: <filter> <filter-name>headerauthenticationfilter</filter-name> <filter-class> com.macromedia.airspeed.servlet.filter.headerauthenticationfilter </filter-class> <!-- <init-param> <param-name>ignore-pattern-0</param-name> <param-value>/api/</param-value> </init-param>... <init-param> <param-name>ignore-pattern-4</param-name> <param-value>/servlet/testbuilder</param-value> </init-param> --> </filter> 4 Configurate Acrobat Connect Pro Server in modo che gli utenti vengano creati con il campo ext-login impostato sull ID utente esterno inviato. Per ulteriori informazioni, consultate la Guida all installazione e alla configurazione di Acrobat Connect Pro. Per impostazione predefinita, ext-login ha lo stesso valore di login, l ID di login di Acrobat Connect Pro Server. 5 Dopo l autenticazione dell utente, create una richiesta login. Aggiungete il parametro external-auth=use, ma nessun parametro login o password: 6 Aggiungete l ID utente autenticato all intestazione della richiesta HTTP. Per impostazione predefinita, utilizzate il nome dell intestazione x-user-id: x-user-id: joesmith Per specificare un nome di intestazione diverso, impostate un valore per HTTP_AUTH_HEADER nel file custom.ini. Potete anche configurare un server proxy per l impostazione del valore dell intestazione HTTP. Per ulteriori informazioni, consultate la Guida all installazione e alla configurazione di Acrobat Connect Pro. 7 Individuate nella risposta un codice di stato ok. 8 Gestite il valore del cookie BREEZESESSION restituito nell intestazione della risposta. È possibile procedere in due modi. Se i cookie sono gestiti tramite una libreria client Il valore del cookie viene estratto, memorizzato e ritrasmesso dalla libreria al server alle successive richieste per l utente.