Mediastream permite agregar una capa de seguridad en tus Live Streaming a través del uso de Token, a continuación se explicará cómo generar los token y como estos tienen que ser incluidos en el iframe de Mediastream que posteriormente puede ser agregado a la web que se desee.
La documentación respecto del proceso de generar un token mediante API se encuentra en el siguiente link: https://platform.mediastre.am/developer/docs/api
Configuración en Platform:
Primero se debe hacer check en el modulo "Access Restrictions" opción "Closed Access". De esta manera ya estaría configurado desde Platform para recibir el access token generado.
Al checkear la opción de "Closed Access" cambiaran los puntos de publicación, por lo que se deberá cambiar desde el encoder.
Creación del token:
Para generar el token de acceso se deberá llamar a la API y posteriormente se deberá incluir el token de acceso en el iframe o embed tal como se describe a continuación:
1. Se debe generar un llamado con el método POST a la API con la siguiente estructura:
Endpoint:
https://platform.mediastre.am/api/access/issueid=5f6b6dc7xxxxxxxx&type=live&token=6b8722ce599xxx
Descripción parámetros de querystring que son mandatorios:
id: corresponde a el id del live.
type: corresponde a si es un media o live.
token: corresponde al token generado desde Platform con permisos de escritura y lectura.
También puedes ingresar los siguientes parámetros que son opcionales:
ip: la reproducción se producirá sólo si la dirección IP pública del usuario coincide con este valor.
user_agent: se reproducirá solo si el user_agent del usuario coincide con este valor.
time_limit: la reproducción se permitirá sólo durante los segundos indicados en este campo, después de emitido el token.
Es importante que los llamados a la API para generar token sean hechos por backend y no por front end. Si Mediastream encuentra código de generación de tokens en los front de sus clientes desactivara los API token correspondientes por motivos de seguridad.
2. Al ejecutar esta querystring retorna lo siguiente:
status: Ok en caso de que la query sea exitosa.
message: informando que se generó el access token.
access_token: contiene el token generado para ser utilizado.
Uso del Token:
El access token generado se utiliza de la siguiente manera:
Para el caso de iframe (html5):
Para el caso de ocupar solo el Playlist:
Para el caso de ocupar solo el embed:
Si tienes alguna pregunta relacionada por favor no dudes en escribirnos a través del chat.
Atte. El Equipo de Mediastream
