Secure Playback & Secure Token
Secure Playback Tokens are a valuable tool that enhances the security of your streams by providing controlled access. With these tokens, you have the ability to decide who can play back your stream, ensuring that only authorized viewers can access your content. The regular playout URL alone will not grant playback privileges.
To make use of the secure feature, it must be explicitly enabled for your organization. Activation may be subject to additional pricing or service terms.
You can verify whether this feature is available by navigating to dashboard.nanostream.cloud/organisation in your dashboard.
In the Enabled Packages section, locate the entry for secure. If it shows Upgrade needed, please contact us.
To activate this feature or learn more about available plans, feel free to reach out via nanocosmos.de/contact. We're happy to assist you in finding the best setup for your use case.
To get started with the nanoStream Dashboard, sign in with your existing nanoStream account.
If you don’t have an account yet, you can sign up, or get in touch with our sales team via nanocosmos.de/contact or by email at sales(at)nanocosmos.net.
Need help accessing an existing organization or unsure how to proceed?
👉 Check the Authentication section for step-by-step guidance on creating an account, logging in, and requesting access from your system administrator.
Token Configuration
One way to create a secure token for your stream(s) or organisation is to navigate to the left-hand menu and select the lock icon. This will take you to dashboard.nanostream.cloud/secure/token where you can provide necessary information to generate the token. You can also find this dialog in different sections of the nanoStream Cloud dashboard (e.g., Code Snippets, Stream Overview).
Screenshot: Create Secure Token
Required Information
- Target: Choose the target of the token.
- Entire Streamgroup The entire stream group by providing the stream ID
- Streamname(s) specify multiple stream names or
- Entire Organization select the entire organization
- Token Lifetime: The default expiration date is set to 2 weeks, but you can choose any duration you prefer.
Optional Settings
- Not Before Date (optional): Set the "not before" date to ensure that the token is not valid before a specific date.
- Client IP (optional): Restrict access to streams to a specific client IP address.
- Domain (optional): Restrict the stream to a specific domain.
- UserID (optional): Add a user ID to your token for identification purposes.
- Tag (optional): Add a single tag to track your token.
By providing the required information and optionally configuring specific options, you can generate a token that meets your security requirements by clicking on Create new token. It is important to manage and safeguard your tokens to ensure the secure playback of your streams.
Secure Token Overview
Once you clicked on the Create new token button, you will be redirected to an overview page displaying the decoded details of the token you just created. This overview will include all the specifications you set up, such as the token target, expiration date, and any optional configurations you specified.
Screenshot: Secure Token Overview
Additionally, you will receive a security config object that you can copy. This object can be pasted into either the group object or the entries element of your player configuration.
security: {
jwtoken: "YOUR_TOKEN_FOR_YOUR_STREAM"
}
Token Creation Dialog
In addition to the Secure Toke creation page, you can also find the decoded token information and create new tokens within specific sections of the nanoStream dashboard.
You can find the inline token creation dialog in multiple locations within the dashboard:
- dashboard.nanostream.cloud/playout/YOUR-STREAM-ID
- dashboard.nanostream.cloud/stream/YOUR-STREAM-ID
- dashboard.nanostream.cloud/stream/YOUR-STREAM-ID/code-snippets
- dashboard.nanostream.cloud/stream/new/YOUR-STREAM-ID
- dashboard.nanostream.cloud/webcaster/YOUR-STREAM-ID