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 solució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 un comportamiento inesperado.
**Síntomas frecuentes**
Los siguientes síntomas pueden indicar problemas de restricción de caracteres:
+ Los parámetros no aparecen en el manifiesto URLs
+ 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 un formato incorrecto URLs
**Pasos de resolución**
Para resolver errores de restricción de caracteres:
1. Revise los valores de los parámetros de los caracteres no admitidos: `:``?`,`&`,,`=`, `%` `/`
1. Aplique la codificación URL adecuada a los caracteres especiales (consulte) [MediaTailor referencia y limitaciones de los parámetros](parameter-comprehensive-reference.md)
1. Evite los caracteres dobles como o `%%%` `==`
1. Considere la posibilidad de utilizar formatos de parámetros alternativos si URLs no se puede utilizar el formato completo
**Example Ejemplo de codificación de URL**
En lugar de usar:
```
manifest.redirect_url=https://example.com/path?param=value
```
Utilice un formato codificado en URL:
```
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](parameter-comprehensive-reference.md) para obtener detalles completos):
+ 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
+ ADS URLs: 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
1. Divida los valores de los parámetros grandes en varios parámetros más pequeños
1. Utilice los alias de configuración para asignar los alias cortos a valores más largos (consulte) [MediaTailor descripción general de los alias de configuración](configuration-aliases-overview.md)
1. Considere la posibilidad de utilizar almacenamiento externo para datos de gran tamaño con referencias de parámetros
## Errores de alias de configuración
Los problemas con los alias de configuración pueden provocar errores 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 reproductor no se sustituyen por valores de alias
**Lista de verificación de resolución**
Para resolver los errores de alias de configuración:
1. Compruebe que todas las variables de dominio estén definidas como `ConfigurationAliases`
1. Asegúrese de que las variables de los parámetros del reproductor usen el `player_params.` prefijo
1. Confirme que la lista de valores con alias sea exhaustiva para las variables de dominio en estado crítico URLs (`VideoContentSourceUrl`,,`AdSegmentUrlPrefix`) `ContentSegmentUrlPrefix`
1. Compruebe que las solicitudes de inicialización de sesión especifican valores de alias válidos
1. Valide la estructura JSON del parámetro ConfigurationAliases
Para obtener una guía detallada de solución de problemas, consulte[MediaTailor guía de solución de problemas de alias de configuración](configuration-aliases-troubleshooting.md).
**Example Validación del alias de configuración**
Asegúrese de que la 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 con el 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
1. Resolución de alias de configuración (si corresponde)
1. Filtrado de parámetros (ADS frente a origen frente a manifiesto)
1. Codificación y formato de URL
1. Aplicación de parámetros a URLs
**Depuración del flujo de parámetros**
Para depurar problemas de procesamiento de parámetros:
1. Compruebe que los parámetros estén correctamente especificados en la inicialización de la sesión
1. Compruebe que los alias de configuración se resuelven según los valores esperados
1. Confirme que los parámetros aparecen correctamente URLs (manifiesto, ADS, origen)
1. Valide que la codificación de la URL se haya aplicado correctamente
**Example 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 que la base de datos se sobrecargue
1. Codificación y desinfección adecuadas de las entradas de los usuarios
1. Codificación URL de la entrada para evitar que la respuesta se dañe
**Prácticas recomendadas**
Siga estas prácticas recomendadas para una gestión segura de los parámetros:
+ Valide los valores de los parámetros en el lado del cliente antes de enviarlos
+ Utilice 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