Session Manager

After pre-processing of watermark embedding, the ‘0’ and ‘1’ versions of content (DASH or HLS) are mixed in real time and delivered to the client on the user’s playback request. PallyCon Forensic Watermarking service provides the session manager which generates the mixed content URL with the information of the playback session.

The service site streams the mixed content to the client according to the mixed URL through the CDN’s watermark mixer integration. For a description of the CDN mixer module, please refer to the Mixer Guide.

sequenceDiagram participant B as Service site participant D as PallyCon service B ->> D: Content URL, Session data Note right of D: Session manager D -->> D: Generate session key(payload) and store session data D ->> B: Send Session URL

The session manager can be integrated through the following HTTP API.

Request data

  • Called by PallyCon Cloud HTTP API spec.
  • URL : https://api.pallycon.com/a/v1/urlconverter/<site_id>
  • Method: GET

JSON Data Format

{
  "url":<string>,
  "forensic_mark":<255 byte String>
}
  • Request data spec

    Name Value Required Description
    url String Y Content stream URL(.mpd or .m3u8 URL), supports signed url
    forensic_mark String Y Session data for watermarking (e.g. user ID), maximum 255 bytes, alphanumeric characters

Response data

JSON Data Format

{
  "url":<Watermark Playback URL>,
  "error_code":<error code>,
  "error_message":<error massage>
}
  • Response data spec

    Name Value Required Description
    url String N If succeeded, returns the Session URL

    Please see below for detailed Session URL format

    error_code String Y “0000” if succeeded, alphanumeric error code if failed
    error_message String Y Error message
  • Session URL format: <content CDN domain>/dldzkdpsxmdnjrtm/encrypt payload/<output_path>/<cid>/stream.mpd(or master.m3u8)

  • Session URL spec

    Item Description
    content CDN domain Domain name of content’s CDN. Set based on the content URL of the request data
    dldzkdpsxmdnjrtm Pre-defined keyword
    encrypted payload Encrypted session key (payload)
    output_path Path of the content on the storage. Set based on the content URL of the request data
    cid Unique ID of the content (ContentID)