Demo:  Ge(ng  started  with  WSO2    

API  Manager    

   

(outline  for  demo)    

 Sumedha  Rubasinghe  

September,  2012  

   

WSO2  API  Manager  Webinar  Series

• Introducing  WSO2  API  Manager  for  Mobile  Applica9ons  and  Rapid  Integra9on  -­‐  September  11    • Ge(ng  Started  with  API  Manager  -­‐  September  18  

• API  Facade  Pa*ern    -­‐  September  25  

• Promo0ng  Service  Re-­‐use  with  API  Management  -­‐  October  2  

• API  Management  Building  Blocks  and  Business  Value  -­‐  October  9  

WSO2  API  Manager  -­‐  Overview

• v1.0.0  –  August  2012  • Not  really  a  1.0.0  product  

• Built  using,  • WSO2  Enterprise  Service  Bus  • WSO2  Iden0ty  Server  • WSO2  Governance  Registry  • WSO2  Jaggery  

• Only  open  source  API  Management  PlaNorm  • PlaNorm  covers  all  aspects  of  API  Management  

• API  Provider  • API  Store  &  Consumer  • Gateway  • Monitoring  &  Sta0s0cs  

Production deployments with various

clients around the globe

API  Manager  –  FuncKonal  Overview

Concept:  Service/Resource  vs  API • Service/Resource  

• Implementa0on  • Represent  Provider  

• API  • Represent  Consumer/Subscriber  • Service/Resource’s  interface  to  external  world  • “API  Management”  –  Process  of  crea0ng  &  managing  APIs  

CreaKng  &  Publishing  an  API • Demo  • Summary  

• Select  implemented  Service/Resource  endpoint  • Create  API  

• API  Context  • API  Version  • Tier,  Tags  

• Documenta0on  • Change  Status

DEMO

API  Store  &  SubscripKons

• Demo  • Summary  

• Publisher  APIs  appear  on  Store  • Tags  • Sorted  (recently  added,  popular)  

• Sign  up  • Logged  in  users  (consumers)  can  subscribe  

DEMO

Concept  :  ApplicaKon

• Applica0on  • Logical  grouping  of  all  APIs  being  used  for  a  purpose  • Subscrip0on  =  API  +  Version  +  Applica0on  • Access  token  -­‐>  applica0on  scope  

DEMO

(Quick)  API  TesKng  Clients

• Demo  • cURL  • soapUI  • JMeter  • Chrome  Plugins  

• Advance  REST  Client  • REST  Console  

• Firefox  Plugins  • Mozilla  Poster  

• Apache  Bench

DEMO

Concept  :  Developer  ApplicaKon    Token

• OAuth  Token  (Valet  Key)  • To  be  used  during  development  tes0ng  ONLY  • Generated  using  API  Store  UI

DEMO

Concept  :  End  User  Access  Token

• Per  end  user  key  • Generated  by  the  applica0on  instance  running  on  behalf  of  user  • Generated  using  consumer_key  +  consumer_secret  • Special  URL  to  submit  token  genera0on  requests  • Helps  to  uniquely  iden0fy  end  users  • Management  &  stat  gathering

Developing  Apps  using  APIs

• Select  correct  thro*le  policy  • Developer  token  can  be  used  for  development  • Every  new  installa0on  of  app  should  obtain  a  new  token  • Do not include include developer key • Set global expiration time on tokens

API  StaKsKcs

DEMO

Event  Stream  DefiniKon

Service  Lifecycle  vs  API  Lifecycle

API  Versioning  Support

• Demo  • Summary  

• Current  API  version  -­‐>  copy  to  new  version  • Copies  all  documenta0on  • Version  as  part  of  URL  • Access  Token  -­‐>  version  • Stats  -­‐>  version

DEMO

Passing  End  User  to  Backend

• JWT(  JSON  Web  Token)

WSO2  API  Manager  Webinar  Series

• Introducing  WSO2  API  Manager  for  Mobile  Applica9ons  and  Rapid  Integra9on  -­‐  September  11    • Ge>ng  Started  with  API  Manager  -­‐  September  18  

• API  Facade  Pa[ern    -­‐  September  25  

• Promo0ng  Service  Re-­‐use  with  API  Management  -­‐  October  2  

• API  Management  Building  Blocks  and  Business  Value  -­‐  October  9  

WSO2  Conference  Call  For  Papers

• Visit  wso2con.com  –  Submission  Deadline  7th  Oct  2012    

 

QuesKons?

References  :  • h*p://wso2.com/products/api-­‐manager/    • Ge(ng  Started  Guide  -­‐  h[p://d.content.wso2.com/files/WSO2APIManager-­‐v1.0.0-­‐Ge(ngStarted.pdf  

• h*p://sanjiva.weerawarana.org/2012/08/api-­‐management-­‐missing-­‐link-­‐for-­‐soa.html  

• h*p://techfeast-­‐hiranya.blogspot.com/search/label/api%20management  

• h*p://sumedha.blogspot.com/search/label/API