Guide

Create an MSL5 stream

Suggest Edits

Add a stream

  1. Log in to your MSL5 account and select ☰> Streams.

  2. Click on the Add Stream button.

  3. In the Details & Publishing section, configure the following.

    Fields in the Details & Publishing page.

  4. From the Contract drop-down, select the contract.
    The stream will be charged against that contract.

  5. From the Group drop-down, select a group.
    The group manages user access and visibility to the stream (e.g., read/write permissions). The Group drop-down menu displays the Group IDs imported from Akamai via SAML login.

📘

The next release will provide an option to enable auto-sync for “Group Name” and “Group ID”, so that the group options listed here will be displayed as “Group Name”.

  1. From the CP tag drop-down, select the CP tag.
    The stream will be charged against that CP tag for the selected contract.
    If you have not created a CP tag, refer to CP tags for more information.

  2. Select one of the input formats.

    • HLS for Apple HTTP Live Streaming
    • DASH for Dynamic Adaptive Streaming over HTTP
    • CMAF for Common Media Application Format

  3. Select one of the Encoder Verification options.

    • Fixed. Allows only fixed encoder IPs. Specify the encoder IP addresses in the Enter Allowed IP addresses field. Enter IP addresses in the following format xxx.xxx.xxx.xxx or xxx.xxx.xxx.xxx/xx.
      For example, 192.51.100.100 or 192.51.100.100/20. You can enter up to 50 comma-separated IP addresses.
    • All (not recommended). Enables all encoder IP addresses to broadcast the stream.

  4. From the Ingest Location drop-down menu, select a region. You can specify the geographical entry point for content. If needed, enable the Backup toggle to select the backup location for the ingestion. Ensure that the backup ingest location is different from the primary ingest location.

  5. Select one of the Ingest Authentication options if needed.

    • Digest
    • Header

"Digest" option for Ingest Authentication

Selecting this option will use HTTP digest authentication to publish ingest streams securely. It enhances the availability of the Media Services Live origin and prevents unauthorized users from tampering with published media or executing replay attacks.

  1. From the Ingest Authentication, click on the Digest button.

  2. Select one of the Hash algorithm options from the menu.

    • SHA512. A cryptographic hash function that when applied to the provided input results in a 128-digit hexadecimal number that is highly unlikely to match the value produced for a different input.
    • SHA256. The Secure Hash Algorithm SHA256 is a type of cryptographic hash function that generates a 256-bit (32-byte) hash. A cryptographic hash is like a signature for a text or a data file.
    • SHA512_256. SHA-512/256 is derived from SHA-512, but it produces a truncated output of 256 bits, making it more suitable for certain applications where a shorter hash is preferred.
    • MD5. The MD5 message-digest algorithm is a widely used hash function producing a 128-bit hash value.

  3. In the Username field, enter a username between 4 and 50 characters long.

  4. In the Password field, enter a password between 4 and 50 characters long, and contains an uppercase letter, a number, and a special character. You can set a password for the stream only when it is not active on production.

  5. In the Confirm password field, enter the password again.

  6. (Optional) Add more credentials by clicking Add credential.

  7. Click Next step.

"Header" option for Ingest Authentication

Selecting this option will use an HTTP header to validate ingest source streams at the entry point. It requires a configured key string to authenticate incoming streams.

  1. From the Ingest Authentication, click on the Header button.

  2. Configure the following:

    • HTTP Header: The header must contain a maximum of 40 alphanumeric characters, is case insensitive, and allow “-” and “_”. The default value is X-MSL-Ingest-Key.
    • Key #1 (Optional): The key value must be 16-64 alphanumeric characters and is case sensitive.
    • Key #2 (Optional): The key value must be 16-64 alphanumeric characters and is case sensitive.

    📘

    Up to two keys can be configured for the HTTP header for Ingest Authentication.

  3. Click Next step.

Set the Archiving and Hostname details

  1. In the Archiving and Hostname window, complete the required fields.

    Fields for the Achiving and Hostname window.

  2. In the Retention period (days), specify the number of days to store the archive for Live Clips (up to 62 days). For example, setting this to 10 days means the system will delete archived content after 10 days.

  3. To configure the Playlist Duration, adjust the “Follow Source” toggle as follows:

    • On. When this toggle is turned “on”, the Playlist Duration length will follow the source automatically, requiring no additional configuration. “Follow Source” is the default option for Playlist Duration.
    • Off. When this toggle is turned “off”, you can specify a value between 1 and 720 minutes for the Playlist Duration length.

  4. From the Origin menu, select an Origin. If you have not created an Origin, see Set up the MSL5 origin for more information.

  5. Click Next step.

Review and complete the stream

  1. In the Summary & Create window, review the parameters for your stream.

    Sample of stream parameters.

  2. If you need to modify the parameters, return to the previous window by clicking the Previous button.

  3. Click Create stream to configure the stream with the specified settings.
    Your stream is now on the list of streams on the MSL5 main page.

📘

MSL5 imposes a service quota/soft limit on number of streams that can be created by a single account. Refer to the Stream Creation Limits page for more information.

Updated 3 days ago