Token Signing Key Secret

Overview

The Token Signing Key Secret is a crucial component for signing playback tokens within the Fastevo Media Protection Platform (Fastevo MP2). Playback tokens are used to authenticate and authorize access to media content, as described in the Playback Tokens section. This page explains how to generate and manage the key that will be used to sign these tokens.

Generating a Token Signing Key Secret

To generate a new Token Signing Key Secret, you need to perform a POST request to the following endpoint:

POST https://api.fastevo.net/api/v1/projects/mediaProtection/configurations/general/rotateTokenSigningKeySecret

This endpoint will generate a new key that will be used to sign playback tokens.

Example Request

POST https://api.fastevo.net/api/v1/projects/mediaProtection/configurations/general/rotateTokenSigningKeySecret

API Response

After successfully generating a new Token Signing Key Secret, the API will return a response with a status code of 200 and a JSON body containing the new key.

Example Success Response

{
  "tokenSigningKeySecret": "newlyGeneratedKeySecret"
}

Retrieving the Current Token Signing Key Secret

To retrieve the current Token Signing Key Secret, you need to perform a GET request to the following endpoint:

GET https://api.fastevo.net/api/v1/projects/mediaProtection/configurations/general/tokenSigningKeySecret

This endpoint will return the current key that is being used to sign playback tokens.

Example Request

GET https://api.fastevo.net/api/v1/projects/mediaProtection/configurations/general/tokenSigningKeySecret

API Response

After successfully retrieving the current Token Signing Key Secret, the API will return a response with a status code of 200 and a JSON body containing the current key.

Example Success Response

{
  "tokenSigningKeySecret": "currentKeySecret"
}