1. REST API to develop application for mobile devices Mario Torrisi (mario.torrisi@ct.infn.it) Dipartimento di Fisica e Astronomia – Università degli Studi di Cataniamario.torrisi@ct.infn.it CHAIN REDS & ReCaS school for application porting to Science Gateway

2. Outline School for Application Porting to Science Gateways 2  Introductory considerations  Catania Science Gateway Framework  Mobile Access  RESTful API for Science Gateway  Methods  Security aspects  Key features  Examples:  REST API Documentation  API for Job Management  gLibrary  Mobile Science Gateway applications  Summary & conclusions Catania - 10 June 2014

3. Introductory considerations School for Application Porting to Science Gateways 3  Some barriers in the adoption of e-Infrastructures:  Complex security procedures  Execution scripts  JDL  Command line user interfaces  … Catania - 10 June 2014 Source: http://www.eresearch2020.eu/eResearch%20Brochure%20EN.pdf Keep non IT-experts away

4. Science Gateway School for Application Porting to Science Gateways 4 Catania - 10 June 2014 “A Science Gateway is a community-developed set of tools, applications, and data that is integrated via a portal or a suite of applications, usually in a graphical user interface, that is further customized to meet the needs of a specific community.” Teragrid/XSEDE

5. Science Gateway Science Gateway Catania Science Gateway Framework School for Application Porting to Science Gateways 5 Catania - 10 June 2014....... App. 1 App. 2 App. N Embedded Applications Administrator Power User Basic User Users from different organisations having different roles and privileges Standard-based (SAGA) middleware-independent Grid Engine Standard-based (SAGA) middleware-independent Grid Engine

6. Catania Grid & Cloud Engine School for Application Porting to Science Gateways 6 Catania - 10 June 2014 Grid/Cloud Engine Users Tracking DB Science GW Interface SAGA/JSAGA API Job Engine Data Engine Users Track & Monit. Science GW 1 Science GW 2 Science GW 3 Grid/Cloud/Local MWs Liferay Portlets eToken Server New ModifiedNewModified New

7.  People are increasingly using mobile devices as their default gateway to the Internet  So, mobile access to “everything” is not any more an option Mobile access School for Application Porting to Science Gateways 7 Catania - 10 June 2014

8. RESTful API for Science Gateway School for Application Porting to Science Gateways 8  Main goal  Allow easy access to the e-Infrastructures not only from web browsers, but also from other kind of clients such as:  mobile devices  native desktop applications  other portal framework  Ensure standard-based interoperability  To reach these aims we developed a set of RESTful API for the Catania Grid & Cloud Engine Catania - 10 June 2014

9. Science Gateway Architecture School for Application Porting to Science Gateways 9 Catania - 10 June 2014 Science Gateway Local cluster Catania Grid & Cloud Engine Cloud Grid

10. New Model School for Application Porting to Science Gateways 10 Catania - 10 June 2014 Science Gateway Local cluster Catania Grid & Cloud Engine Cloud Grid RESTful API Mobile Apps Desktop Apps Other portals

11. Methods School for Application Porting to Science Gateways 11  The developed service  Adopts Jersey framework  The JAX-RS (JSR 311 & JSR 339) Reference Implementation  API that extend the JAX-RS toolkit with additional features  Exposes  Catania Grid & Cloud Engine API through RESTful interface  Inherits  The support to the OGF SAGA standard Catania - 10 June 2014

12. Key features School for Application Porting to Science Gateways 12  Interoperability  Devices and middleware independence  Lightweight  Less communication overhead than in SOAP protocol  Security  All security mechanisms applied to HTTP can be used Catania - 10 June 2014

13. Security aspects Other portals Native client applications Catania - 10 June 2014 School for Application Porting to Science Gateways 13  Mutual SSL Authentication  OAuth2 based authorization

14. Examples School for Application Porting to Science Gateways 14  Grid Engine REST API  http://docs.gridenginerest.apiary.io/ http://docs.gridenginerest.apiary.io/  API for job management  Submit Job POST jobs/submit https://api.ct.infn.it/api/jobs/submit  Monitor job status GET jobs/status/{commonName} https://api.ct.infn.it/api/jobs/status/test  Download job output GET jobs/download/{commonName}/{id} https://api.ct.infn.it/api/jobs/download/test/125 Catania - 10 June 2014

15. School for Application Porting to Science Gateways 15 digital assets  gLibrary is a framework developed by INFN that provides a simple system to store, organize, search and retrieve “digital assets” in repositories built on local, grid or cloud storage  Digital assets:  Digital object + its metadata Hides the underlying technologies to end users

16. eToken service architecture Catania - 10 June 2014 School for Application Porting to Science Gateways 16 Front ends glibrary.ct.infn.it REST API AuthN / AuthZ Science Gateway User Tracking DB Call gLibrary REST API through API Server Gateway Metadata Service Local storage Grid storage Cloud Storage Authorization service Authentication service

17. REST APIs (some examples) Catania - 10 June 2014 School for Application Porting to Science Gateways 17  Retrieve the tree of types:  https:// /glibrary/mountTree/ /?node=  ex.: https://earthserver-sg.consorzio-cometa.it/glibrary/mountTree/ESArep/?node=0https://earthserver-sg.consorzio-cometa.it/glibrary/mountTree/ESArep/?node=0  Retrieve the schema of a given type:  https:// /glibrary/metadata/ / /  ex.: https://earthserver-sg.consorzio-cometa.it/glibrary/metadata/ESArep/Entries/Productshttps://earthserver-sg.consorzio-cometa.it/glibrary/metadata/ESArep/Entries/Products  Retrieve an asset’s metadata of a given type:  https:// /glibrary/glib/ / /  ex.: https://earthserver-sg.consorzio-cometa.it/glibrary/glib/ESArep/Entries/Productshttps://earthserver-sg.consorzio-cometa.it/glibrary/glib/ESArep/Entries/Products

18. Mobile Science Gateway Apps School for Application Porting to Science Gateways 18  EarthServer SG Mobile Catania - 10 June 2014

19. Mobile Science Gateway Apps School for Application Porting to Science Gateways 19  DCH-RP eCSG Mobile Catania - 10 June 2014

20. Summary & Conclusions School for Application Porting to Science Gateways 20  Main aim  Allow easy access to the e-Infrastructures not only from web browsers, but also from other kind of clients  Users can  Target their effort on their domain specific applications  Ignore the underneath technological details  Run their application not only from web browsers Catania - 10 June 2014

21. Thank you ! Catania - 10 June 2014 School for Application Porting to Science Gateways 21 For more information on Catania Science Gateway framework please visit: http://www.catania-science-gateways.it/