View a markdown version of this page

MediaTailor guía de resolución de problemas de parámetros - AWS Elemental MediaTailor
Errores de restricción de caracteresErrores de limitación de longitudErrores de alias de configuraciónProblemas de flujo de procesamiento de parámetrosConsideraciones y prácticas recomendadas de seguridad

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

MediaTailor guía de resolución de problemas de parámetros

AWS Elemental MediaTailor proporciona orientación para solucionar problemas comunes relacionados con los parámetros MediaTailor, como las restricciones de caracteres, los problemas de codificación de URL y los errores de alias de configuración.

Errores de restricción de caracteres

Los valores de los parámetros que contienen caracteres no admitidos pueden provocar errores o comportamientos inesperados.

Síntomas comunes

Los siguientes síntomas pueden indicar problemas de restricción de caracteres:

  • Los parámetros no aparecen en las URL del manifiesto

  • Errores de HTTP 400 durante la inicialización de la sesión

  • Valores de parámetros truncados o dañados

  • Las solicitudes de ADS fallan debido a que las URL están mal formadas

Pasos de resolución

Para resolver los errores de restricción de caracteres:

  1. Revise los valores de los parámetros para los caracteres no admitidos: :?,&,,=, % /

  2. Aplique correctamente URL-encoding los caracteres especiales (consulteMediaTailor referencia y limitaciones de los parámetros)

  3. Evite los caracteres dobles, como %%% o ==

  4. Considere la posibilidad de utilizar formatos de parámetros alternativos si no se pueden utilizar direcciones URL completas

ejemplo Ejemplo de codificación de URL

En lugar de usar: 

manifest.redirect_url=https://example.com/path?param=value

URL-encoded Formato de uso: 

manifest.redirect_url=https%3A%2F%2Fexample.com%2Fpath%3Fparam%3Dvalue

Errores de limitación de longitud

Los parámetros que superan los límites de longitud pueden truncarse o provocar errores.

Límites de longitud

Se aplican los siguientes límites de longitud (consulte MediaTailor referencia y limitaciones de los parámetros para obtener más información):

  • Parámetros de consulta del manifiesto (total): 2000 caracteres

  • Nombres de parámetros de ADS: 10 000 caracteres

  • Valores de los parámetros ADS: 25 000 caracteres

  • URL de ADS: 25 000 caracteres

Estrategias de resolución

Para gestionar las limitaciones de longitud:

  1. Utilice nombres y valores de parámetros más cortos siempre que sea posible

  2. Divida los valores de parámetros grandes en varios parámetros más pequeños

  3. Utilice los alias de configuración para asignar alias cortos a valores más largos (consulte) MediaTailor descripción general de los alias de configuración

  4. Considere la posibilidad de usar almacenamiento externo para datos de gran tamaño con referencias a parámetros

Errores de alias de configuración

Los problemas con los alias de configuración pueden provocar errores de HTTP 400 o valores de parámetros inesperados.

Errores comunes de alias de configuración

Los siguientes errores suelen producirse con los alias de configuración:

  • Error HTTP 400: falta un valor de alias o no es válido

  • Las variables de dominio no se resuelven correctamente

  • Los parámetros del jugador no se reemplazan por valores de alias

Lista de verificación de resoluciones

Para resolver los errores de alias de configuración:

  1. Verifique que todas las variables de dominio estén definidas como ConfigurationAliases

  2. Asegúrese de que las variables de los parámetros del jugador usen el player_params. prefijo

  3. Confirme que la lista de valores con alias es exhaustiva para las variables de dominio de las URL críticas (VideoContentSourceUrl,,) AdSegmentUrlPrefix ContentSegmentUrlPrefix

  4. Compruebe que las solicitudes de inicialización de sesión especifican valores de alias válidos

  5. Valide la estructura JSON del parámetro ConfigurationAliases

Para obtener una guía detallada de solución de problemas, consulteMediaTailor guía de solución de problemas de alias de configuración.

ejemplo Validación del alias de configuración

Asegúrese de que su configuración incluya todos los alias necesarios: 

"ConfigurationAliases": {
    "player_params.origin_domain": {
        "pdx": "abc.mediapackage.us-west-2.amazonaws.com",
        "iad": "xyz.mediapackage.us-east-1.amazonaws.com"
        // Must include all possible values used in session initialization
    }
}

Problemas de flujo de procesamiento de parámetros

Comprender el flujo de procesamiento de parámetros ayuda a solucionar problemas relacionados con el reenvío y la transformación de los parámetros.

Orden de procesamiento de los parámetros

MediaTailor procesa los parámetros en el siguiente orden:

  1. validación de los parámetros de inicialización de la sesión

  2. Resolución de alias de configuración (si procede)

  3. Filtrado de parámetros (ADS frente a origin frente a manifest)

  4. Codificación y formato de URL

  5. Aplicación de parámetros a las URL

Depuración del flujo de parámetros

Para depurar problemas de procesamiento de parámetros:

  1. Compruebe que los parámetros se especificaron correctamente al inicializar la sesión

  2. Compruebe que los alias de configuración se resuelven según los valores esperados

  3. Confirme que los parámetros aparecen en las URL correctas (manifest, ADS, origin)

  4. Valide que la codificación de la URL se haya aplicado correctamente

ejemplo Ejemplo de flujo de parámetros

Inicialización de sesión: 

POST master.m3u8
{
    "playerParams": {"origin_domain": "pdx"},
    "manifestParams": {"test": "123"}
}

Tras la resolución y el procesamiento del alias:

  • Solicitud de origen: https://abc.mediapackage.us-west-2.amazonaws.com/out/v1/abcd

  • URL del manifiesto: /v1/master/.../index.m3u8?aws.sessionId=session&test=123

Consideraciones y prácticas recomendadas de seguridad

MediaTailor implementa medidas de seguridad para el manejo de parámetros a fin de evitar problemas de seguridad comunes.

Medidas de seguridad

MediaTailor implementa las siguientes medidas de seguridad:

  1. Limitaciones de tamaño de entrada para evitar la sobrecarga de la base de datos

  2. Codificación y desinfección adecuadas de las entradas del usuario

  3. URL-encoding de la entrada para evitar la corrupción de la respuesta

Prácticas recomendadas

Siga estas prácticas recomendadas para gestionar los parámetros de forma segura:

  • Valide los valores de los parámetros en el lado del cliente antes de enviarlos

  • Utilice los alias de configuración para limitar los posibles valores de los parámetros

  • Evite incluir información confidencial en los parámetros

  • Supervise el uso de los parámetros para detectar patrones inusuales

  • Mantenga los valores de los parámetros dentro de los límites de longitud recomendados