Documenti di Didattica
Documenti di Professioni
Documenti di Cultura
Presentation_ID
Cisco Confidential
Presentation_ID 2011 Cisco Systems, Inc Source: TeleGeography Research, PriMetrica,Inc. All rights reserved.
Presentation_ID
Cisco Confidential
Presentation_ID
Cisco Confidential
Presentation_ID
Cisco Confidential
XML API
Partner applications HTTP Post XSD compliant requests to XML API servers Pre and Post meeting functionality
Telephony API
In-Meeting interface between partners telephony bridge and WebEx service XML DTD interface
Developer Resources
Visit http://developer.webex.com/meetingservices
Docs, Tech Notes, White Papers, Forums, etc.
Free
Presentation_ID
Cisco Confidential
10
Presentation_ID
Cisco Confidential
11
Presentation_ID
Cisco Confidential
12
XML API
Technical Deep-Dive
- What is the XML API? - Basic Command Structure - Service Break-Down - User Provisioning - Billing / Usage Collection
Presentation_ID
Cisco Confidential
13
Developer Resources
Documentation and Schema available at http://developers.webex.com
Presentation_ID
Cisco Confidential
14
- Site Specification
- SiteID: WebEx Site unique identifier - SiteName: Site domain name - PartnerID: Site-level password for using the APIs
Body Content
- Specifies the XML API request name
- Child nodes provide command-specific data
Presentation_ID
Cisco Confidential
15
Presentation_ID
Cisco Confidential
16
Presentation_ID
Cisco Confidential
17
User Service:
User account management
History Service:
Retrieves usage data
Site Service:
Retrieves Site Configurations
18
Important Requests
Create/Set/Lst/Get/DelUser, LstSummaryUser, Getloginurl/GetlogouturlUser Create/Set/Lst/Get/DelMeeting, LstSummaryMeeting, Gethosturl/GetjoinurlMeeting Create/Set/Lst/Get/DelTrainingSession, GetLabInfo, CheckLabAvailability, GetLabSchedule, LstScheduledTests, GetTestInformation, GetIMStestResult Create/Set/Lst/Get/DelEvent CreateSupportSession Create/Lst/DelMeetingAttendee LsttrainingsessionHistory, LsttrainingattendeeHistory, LstmeetingusageHistory, LstmeetingattendeeHistory, LsteventsessionHistory, LsteventsessionHistory, LstsupportsessionHistory, LstsupportsessionHistory, GetSite LstSummarySession, Lst/Set/DelRecording, LstContact, CreateContacts
Site General
Presentation_ID
Cisco Confidential
19
Presentation_ID
Cisco Confidential
20
Usage Reporting
Each WebEx Center provides a set of two commands that return usage data
Attendee History
Detailed information on each attendee that joined the session Provides minute totals for how long each participant spent on the web conference
Examples
LstmeetingusageHistory: Will return a list of meetings that occurred during the time-span you specified LstmeetingattendeeHistory: Will return a list of attendees that attended the session of the meetingKey specified.
Presentation_ID 2011 Cisco Systems, Inc. All rights reserved. Cisco Confidential
21
Beta
After engineering has fully tested a new XML API version it is deployed to our beta servers for a couple of weeks.
Preview
After Beta testing, the new version is deployed to all production servers at the following preview URL. Customers can test the new version against their production data in preview for a minimum of three weeks:
https://sitename.webex.com/WBXService/preview/XMLService
General Availability
If no major bugs have been found during the preview testing period, the new version will be promoted to general availability at the production URL: https://sitename.webex.com/WBXService/XMLService
Presentation_ID
Cisco Confidential
22
URL API
Technical Deep-Dive
Presentation_ID
Cisco Confidential
23
Presentation_ID
Cisco Confidential
24
Presentation_ID
Cisco Confidential
25
Presentation_ID
Cisco Confidential
26
Join Meeting
Presentation_ID
Cisco Confidential
27
Presentation_ID
Cisco Confidential
28
User Authentication
Login Command (AT=LI)
WID WebEx Username PW Password MU URL to be directed to if login is successful BU URL to be directed to if login fails This parameter only behaves this way for the Login Command
Presentation_ID
Cisco Confidential
29
Presentation_ID
Cisco Confidential
30
Presentation_ID
Cisco Confidential
31
Presentation_ID
Cisco Confidential
32
What is SAML?
Security Assertion Markup Language Standard for passing credentials between different Internet domains that have their own authentication systems. OASIS
SAML 1.0, Approved Nov. 2002 1.1, Sep. 2003 2.0, Mar. 2005
Presentation_ID
Cisco Confidential
33
<Subject> <NameIdentifier NameQualifier=customer.webex.com">uid=johnd</NameIdentifier> <SubjectConfirmation> <ConfirmationMethod>urn:oasis:names:tc:SAML:1.0:cm:bearer </ConfirmationMethod> </SubjectConfirmation> </Subject> <SubjectLocality IPAddress="127.0.0.1"></SubjectLocality>
</AuthenticationStatement>
</Assertion>
Presentation_ID
Cisco Confidential
34
API Authentication
Integration sends a signed SAML assertion in an XML API request. XML API calls SAML Auth Service to authenticate user and returns a WebEx session ticket. If WebEx user account doesnt exist, XML API CreateUser can be used create account. WebEx session ticket is used in subsequent XML API requests that require user authentication.
Presentation_ID
Cisco Confidential
35
3) Send Credential
1) Send to WebEx
Intranet
2) User Logs in
7) Return Assertion
SAML Assertion
8) POST Assertion
Customer Network
Presentation_ID 2011 Cisco Systems, Inc. All rights reserved. Cisco Confidential
WebEx Network
36
Presentation_ID
Cisco Confidential
37
Presentation_ID
Cisco Confidential
38
Usage Reporting
Presentation_ID
Cisco Confidential
39
Presentation_ID
Cisco Confidential
40
End Customer
Bill Presentment
CSV PRN PDF
Request
Invoice Generation
Rating Engine
Response
WebEx Service Usage DB
WebEx Service
Presentation_ID
Cisco Confidential
41
Presentation_ID
Cisco Confidential
42
Notes
Generally use the Site Admin creds in requests to obtain information across the entire site / set of hosts. Host creds only can provide information related to that hosts activities
Presentation_ID 2011 Cisco Systems, Inc. All rights reserved. Cisco Confidential
43
Presentation_ID
Cisco Confidential
44
Presentation_ID
Cisco Confidential
45
Presentation_ID
Cisco Confidential
46