This package includes code examples for use with the Wowza Streaming Cloud™ service that help you incorporate token authentication into your application. The examples provided are in JavaScript, PHP, Python, and Ruby and are for Wowza CDN on Fastly stream targets only.
During token authentication, required fields and optional fields combine into a token string. They are processed through an HMAC algorithm with a shared secret to produce a token. This token is then included in a token-protected link provided for playback.
For further information on how to implement token authentication, see one of the following articles:
- Protect a Wowza CDN on Fastly stream target with token authentication using the Wowza Streaming Cloud REST API
- Protect a Wowza CDN on Fastly stream target with token authentication in Wowza Streaming Cloud
Each implementation in this package contains a command-line application. The output is a string that includes some of the options and the generated HMAC value. This string is a valid query string name/value pair and should be added to the playlist URL of the protected stream.
Note: The generated query parameters must be in the following order: IP_ADDRESS, START_TIME, VODSTREAMID, END_TIME
| Option | Description |
|---|---|
| -e, --end_time END_TIME | Determines when the token expires, in UTC seconds. --exp overrides --lifetime. Required if lifetime isn't specified. |
| -h, --help | Displays help information. |
| -i, --ip IP_ADDRESS | The IP address to restrict this token to. |
| -k, --key KEY | (required) The token_auth_shared_secret value from Wowza Streaming Cloud required to generate the token. |
| -l, --lifetime SECONDS | The length of time that the token is valid for, in seconds. Required if end_time isn't specified. |
| -s, --start_time START_TIME | The time that protected access to the stream begins, in UTC seconds. For example, 1478908800 for 12 November 2016 00:00:00 GMT. Use now for the current time. |
| -u, --stream_id STREAMID | (required) The Fastly stream ID from the stream target playback_url. The stream ID can also be found on the Setup tab of the stream target detail page in Wowza Streaming Cloud. Examples: https://[subdomain].wowza.com/1/[stream_id]/[stream_name]/hls/live/playlist.m3u8 For https://[subdomain].wowza.com/1/NUtjdHdsc3g4Z21L/00000ETFlNKkeNpL/hls/live/playlist.m3u8, the stream ID would be NUtjdHdsc3g4Z21L. |
| -v, --vod_stream_id VODSTREAMID | (optional) For use with VOD streams only. The VOD stream ID from the playback_url. Examples: https://[subdomain].wowza.com/2/[stream_id]/[stream_name]/hls/[vod_stream_id]/playlist.m3u8 For https://[subdomain].wowza.com/2/NUtjdHdsc3g4Z21L/00000ETFlNKkeNpL/hls/rqcbmfjl/playlist.m3u8, the VOD stream ID would be rqcbmfjl. |
Generate a token that starts and expires at specific times, and restrict it to a certain IP address:
$ ruby ./gen_token.rb -e 1578421449 -u NUtjdHdsc3g4Z21L -s 1578421200 -i 10.1.1.1 -k 8a123c7b730600eb92360640ce91a32dResult:
hdnts=ip=10.1.1.1~st=1578421200~exp=1578421449~hmac=073e5b930fb494728164cad5da037eb2e9429282f33f9f89df04241bd530f74dGenerate a token for a VOD stream that starts and expires at specific times:
$ ruby ./gen_token.rb -e 1578935593 -u NUtjdHdsc3g4Z21L -s 1578935505 -k 8a123c7b730600eb92360640ce91a32d -v rqcbmfjlResult:
hdnts=st=1578935505~vod=rqcbmfjl~exp=1578935593~hmac=722d989e175ac0c288603e44d552ab5d11cb1b86077657ee867adcfded7cb0f8Generate a token that is valid for a specific number of seconds:
$ ruby ./gen_token.rb -l 2000 -u NUtjdHdsc3g4Z21L -k 8a123c7b730600eb92360640ce91a32dResult:
hdnts=exp=1578424041~hmac=0428782df32a8a8b91823889756d8084997cf45c58375d526dc9852808b35721Wowza Media Systems™, LLC
Wowza Media Systems provides developers with a platform to create streaming applications and solutions. See the Wowza Developer Portal to learn more about our APIs and SDKs.
This code is distributed under the BSD 3-Clause License.