The Kaltura Session is an authorization string that identifies the user watching the video. This guide will demonstrate how to create a Kaltura Session on the client side using the Application Token API. An Application Token is used in cases where different applications with varying permissions need access to your Kaltura account, without using your Admin Secret. The appToken is created and customized by the account administrator, and then used by the developers to generate Kaltura Sessions for their respective applications.
You can create an appToken with the appToken.add action. Once you’ve created it, hold on to its token and ID as you’ll need those to create the session. You can also see a list of all available appTokens by using appToken.list.
There are a few steps to creating a KS with an appToken.
- Generate a basic kaltura session: because all calls to the API must include a Kaltura Session, we first use the session API to create what is called a widget session, which has limited functionality and is used in the following steps
- Create a Token Hash of the appToken token and the widget session, combined.
- Call the appToken.startSession API with the widget session, the appToken ID, and the hash string.
You can see all these steps interactively with this workflow, or read the guide here, but examples below are written for client-side swift code.
Let’s get started. If you’re already creating a Kaltura Session on the server side, you can skip these steps.
Step 1: Generate a widget session
To get a basic KS, we need to construct a URL request to the session.startWidgetSession service. It needs your widget ID, which is basically just your partnerID with an underscore prefix.
So let’s create a function called
generateWidgetSession() and form that URL.
Call the endpoint and extract the
ks string from the response. Your code should obviously include more error handling than this example. The complete function looks something like this:
We will call this function from another new function called
generateSession() where you should call the create new variables for the widgetSession, appToken, the appToken ID, and the userId - which can be any string that identifies the user creating the session.
Step 2: Create the token hash
You’ll need to install and import a library of your choice for creating the hash string. We chose a library called Arcane which is like the Obj-C CommonCrypto library. Concatenate the widget session with the appToken token, and create the hash string. Note that you must use the same Hash Type that you used to create the appToken.
Step 3: Get the Kaltura Session
Once you have that hash string, you can now form the URL, make the call to appToken.startSession, and extract the KS from the response. Again, a proper application should include error handling when making calls to the API.
Lastly, set the application’s
ks to the newly generated KS:
generateSession() function looks like this:
Note that if an appToken is deleted, it can no longer be used for session creation.