Managing Your Subscriber Tokens

To get started, log into your Dolby.io Real-time Streaming account and select Subscribe Tokens from the left menu. Here you can create and manage your subscribe tokens.

Your Dolby.io Real-time Streaming subscriber tokens are used for authenticating when you want to watch a "Token Required" broadcast.

Creating a Subscriber Token

Begin by creating a token using the Add (+) button. This will open a popup window on your screen containing various options for your new Token.

Let's go over each section in a bit more detail.

The Token Label gives you a simple labeling system you can use to keep track of your tokens. You can use it to label what the tokens are for, or identify testing tokens from your production ones, it's entirely up to you.

In the Add Stream Names list you have to select the Stream names from your current Stream Tokens you want to give access through the token you are creating.
You can also create a global Subscriber Token marking the Use ANY name option.

The Tracking ID lets you create a alphanumeric tracking ID that can be used for syndication to associate streaming statistics, such as bandwidth consumption, to various viewers on a stream. For more information, see Syndication.

The next section allows you to make your token temporary by giving the token an expiration date.

NOTE: While setting the date and time, be sure that it is set for the future or it will display an error.

The last tab corresponds to the advanced options and here you can optionally configure:
Allowed origins: Only the domains in the list will be allowed in request to the Director API with token.

Allowed IP Addresses: You can specify multiple IPv4 addresses or CIDR notated network blocks. The token will only be usable by those addresses.

After you have successfully created your token it will be displayed in a scrollable list.

Management Screen

Each token item has a quick action menu that provides you with options for enabling, deleting and configure each token.

Even though the quick action menu provides you with certain management control, the real control lies within the manage UI for each token.

To open the manage view simply click the settings button from the item’s action menu.

The manage screen allows you to edit and view details attached to your token including stream names, labels, status, renew token, geo-blocking and delete.

Stream Names

As mentioned earlier, your Subscribe Token allows to watch different Streams that are secured. The Stream Names list contains the different stream names your Subscribe Token has access to.

To add a new name simply click on the (+) ADD button above the list which will initiate a popup similar to the add token interface.

To delete a stream name simply select it from the list and click the remove button.

Token Settings

The token settings, like Token Label and Status, can be managed easily through the user interface. Below is a simple breakdown.

Label

In the settings section you can change the label just by selecting the field with the current label, editing the text and hitting the enter/return button to accept the change.

Token ID

The renew token feature lets you generate a new serial number for your token. You can use this if you think the original token was compromised, or simply to ensure that any previous users will no longer be able to use the original token.

Tracking ID

The tracking ID that can be used for syndication. For more information, see Syndication.

NOTE: This cannot be undone. Once you have renewed the token’s serial number, the old one is gone. Please be sure you want to renew the token before proceeding.

Status

The token status shows us that the token is active or disabled. Although a temporary token changes this automatically, you can manually change it yourself by clicking the status button on the screen. This acts as a toggle function that switches the token’s status from enabled to disabled respectively.

Advanced

This option opens a modal where you can configure the Allowed Origins, Allowed IP Addresses and Geo-blocking settings.

Delete Token

You can delete the token by clicking on the delete button, on the Management screen:

Or directly from the item itself on the tokens list: