streem-sdk-ruby

Server-side ruby library for interacting with the Streem API, and generation of Streem Tokens for use in client SDKs or Embedded SSO.

Add this line to your application's Gemfile:

gem 'streem'

And then execute:

$ bundle install

Or install it yourself as:

$ gem install streem

First, import the library:

require "streem"

Then initialize the library with your API Key ID and Secret:

Streem.init(api_key_id, api_key_secret)

To create a Streem Token, first create a TokenBuilder:

builder = Streem::TokenBuilder.new

Then specify the details for the currently logged-in user:

user = # your logged in user

# required
builder.user_id = user.id

# recommended
builder.name = user.name
builder.email = user.email
builder.avatar_url = user.avatar

# optional
builder.token_expiration_ms = ... # Determines how long this token is valid for starting a session (default 5 minutes)
builder.session_expiration_ms = ... # Once the session has started, how long can the user remain logged in (default 4 hours)

# If using the Group Reservation feature, set the reservation sid from the API response
builder.reservation_sid = ...

Finally, call token to generate the token string:

token = builder.token

Embedded SSO allows you to create Streem Tokens server-side, and automatically log your users into the Streem web application.

First, provide the token created above to your front-end browser client. Next, place the token in the hash portion of any Streem web application URL, by appending #token=... with your token.

For example, to create an iframe to the root page in streem, you might have:

<iframe src="https://{company-code}.streempro.app/embed#token={token}"/>

Be sure to substitute {company-code} and {token} for the correct values.

If using the iOS or Android SDKs, you will provide the Streem Token to the client, and pass to the SDK via Streem.identify(). More details can be found in documentation of the individual SDKs

The gem is available as open source under the terms of the MIT License.