If you are implementing a gadget to run on a third-party OpenSocial platform, you must create a security token and pass along the value as a parameter in your request. For more information on creating a security token, see the "Security Token" section.
If you are implementing a gadget to run on the Cisco Pulse platform, you do not need to explicitly create a security token. The OpenSocial server automatically appends a security token to your request.
Authentication requests are in HTTPS format.
These topics includes additional information about authentication:
Cisco Pulse gadget users must be authenticated by the OpenSocial server. These users must be Cisco Pulse users with a privilege level of user, business administrator, or system administrator. If they are not currently Cisco Pulse users, they can contact the Cisco Pulse system administrator.
These guidelines exist for a session with the Cisco Pulse server:
•A session is valid for a period of 24 hours.
•During this period, you can log out, and if you log back in within the period, the session is renewed for another 24 hours.
•If you send a request after the session has expired, the server returns an error.
•If a session expires, you must send another request to log into the OpenSocial server.
If you are implementing a gadget on a third-party platform, you must create a security token, which is comprised of seven attributes. Each attribute must be followed by a colon (:) as shown:
owner-id and viewer-id = Your Cisco Pulse login username.
app-id = The default value of 1111.
domain = The default value of CISCOPULSE.
app-url = The service URL, for example, http://host-name:port-number/gadgets/path-to-gadget.xml.
module-id = The default value of 0.
container-id = The default value of default.
You must encode (UTF-8) all attributes except the app-url attribute once, and the app-url attribute twice to ensure the entire token is a valid URL format.
A sample security token is as follows:
This token should remain valid indefinitely.
This API enables you to log into the OpenSocial server with your Cisco Pulse username and password.
Specifies your Cisco Pulse password.
–If you are implementing a gadget on the Cisco Pulse platform, a unique session ID is returned.
–HTTP error 401: User does not have privileges.
–HTTP error 401: User Authentication Failed. Check Password
XML Format Example