Version 2021
Create a single sign-on (SSO) session
Creates a session for server-side driven OAuth single sign-on (SSO) integration with Badge. Returns a cookie that contains session information and a Badge QR code that can be used for an end user to associate with the Badge session.
Request format
HTTP method
POST
Resource URL
/sso/create_session?client_id=client_id&type=type
Parameters
| Parameter | Required? | Description |
|---|---|---|
client_id
|
Required | The Badge Application ID associated with this mobile app. This value is provided in Identity Manager when you register the third-party mobile app. |
type
|
Optional | By default, Identity Server returns information even when the server is not ready. This is a non-blocking (asynchronous) single sign-on session, with a type value of nonblock.
|
Response format
Response header
Set-Cookie: SSO_SESSION="..."; Path=/; Secure; HttpOnly
Response body
{"code":"..."}
Example
Example request
curl -i "https://uvs-v2.usher.com/sso/create_session?client_id=26&type=nonblock" -X POST -F 'session_data
Example response
Set-Cookie: SSO_SESSION=EOCcWpbhRGhe37dxbe4k2oAONnosodo5hMK1ygwVi7wRbohLcuCI_uLd6CMOZpEOiu8; Path=/; Secure; HttpOnly
{"code":"TpYsSXRkUZRs-Z_3fl--amZ7ycx0kLm:853449:_3436"}