View a markdown version of this page

MediaTailor guia de solução de problemas de parâmetros - AWS Elemental MediaTailor
Erros de restrição de caracteresErros de limitação de comprimentoErros de alias de configuraçãoProblemas de fluxo de processamento de parâmetrosConsiderações de segurança e práticas recomendadas

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

MediaTailor guia de solução de problemas de parâmetros

AWS Elemental MediaTailor fornece orientação para solucionar problemas comuns relacionados a parâmetros em MediaTailor, incluindo restrições de caracteres, problemas de codificação de URL e erros de alias de configuração.

Erros de restrição de caracteres

Valores de parâmetros que contêm caracteres não suportados podem causar erros ou comportamento inesperado.

Sintomas comuns

Os seguintes sintomas podem indicar problemas de restrição de caracteres:

  • Parâmetros que não aparecem nos URLs do manifesto

  • Erros de HTTP 400 durante a inicialização da sessão

  • Valores de parâmetros truncados ou corrompidos

  • Falha nas solicitações do ADS devido a URLs malformados

Etapas de resolução

Para resolver erros de restrição de caracteres:

  1. Revise os valores dos parâmetros para caracteres não suportados: :?,,&,=, % /

  2. Aplique corretamente URL-encoding para caracteres especiais (consulteMediaTailor referência e limitações de parâmetros)

  3. Evite caracteres duplos, como %%% ou ==

  4. Considere formatos de parâmetros alternativos se URLs completos não puderem ser usados

exemplo Exemplo de codificação de URL

Em vez 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

Erros de limitação de comprimento

Os parâmetros que excedem os limites de comprimento podem ser truncados ou causar erros.

Limites de comprimento

Os seguintes limites de comprimento se aplicam (consulte MediaTailor referência e limitações de parâmetros para obter detalhes completos):

  • Parâmetros de consulta do manifesto (total): 2000 caracteres

  • Nomes de parâmetros do ADS: 10.000 caracteres

  • Valores dos parâmetros do ADS: 25.000 caracteres

  • URLs do ADS: 25.000 caracteres

Estratégias de resolução

Para lidar com limitações de comprimento:

  1. Use nomes e valores de parâmetros mais curtos sempre que possível

  2. Divida valores de parâmetros grandes em vários parâmetros menores

  3. Use aliases de configuração para mapear aliases curtos para valores mais longos (consulte) MediaTailor visão geral dos aliases de configuração

  4. Considere usar armazenamento externo para dados grandes com referências de parâmetros

Erros de alias de configuração

Problemas de alias de configuração podem resultar em erros de HTTP 400 ou valores de parâmetros inesperados.

Erros comuns de alias de configuração

Os seguintes erros geralmente ocorrem com aliases de configuração:

  • Erro HTTP 400: valor de alias ausente ou inválido

  • Variáveis de domínio não estão sendo resolvidas corretamente

  • Os parâmetros do jogador não estão sendo substituídos por valores de alias

Lista de verificação de resolução

Para resolver erros de alias de configuração:

  1. Verifique se todas as variáveis de domínio estão definidas como ConfigurationAliases

  2. Certifique-se de que as variáveis de parâmetros do jogador usem o player_params. prefixo

  3. Confirme se a lista de valores com alias é exaustiva para variáveis de domínio em URLs críticos (,,) VideoContentSourceUrl AdSegmentUrlPrefix ContentSegmentUrlPrefix

  4. Verifique se as solicitações de inicialização da sessão especificam valores de aliases válidos

  5. Validar a estrutura JSON do parâmetro ConfigurationAliases

Para obter orientações detalhadas sobre solução de problemas, consulteMediaTailor guia de solução de problemas de aliases de configuração.

exemplo Validação de alias de configuração

Certifique-se de que sua configuração inclua todos os aliases necessários: 

"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 fluxo de processamento de parâmetros

Compreender o fluxo de processamento de parâmetros ajuda a solucionar problemas com o encaminhamento e a transformação de parâmetros.

Ordem de processamento de parâmetros

MediaTailor processa parâmetros na seguinte ordem:

  1. Validação do parâmetro de inicialização da sessão

  2. Resolução de aliases de configuração (se aplicável)

  3. Filtragem de parâmetros (ADS versus origem versus manifesto)

  4. Codificação e formatação de URL

  5. Aplicação de parâmetros para URLs

Fluxo de parâmetros de depuração

Para depurar problemas de processamento de parâmetros:

  1. Verifique se os parâmetros estão corretamente especificados na inicialização da sessão

  2. Verifique se os aliases de configuração correspondem aos valores esperados

  3. Confirme se os parâmetros aparecem nos URLs corretos (manifesto, ADS, origem)

  4. Validar se a codificação de URL foi aplicada corretamente

exemplo Exemplo de fluxo de parâmetros

Inicialização da sessão: 

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

Após a resolução e o processamento do alias:

  • Solicitação de origem: https://abc.mediapackage.us-west-2.amazonaws.com/out/v1/abcd

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

Considerações de segurança e práticas recomendadas

MediaTailor implementa medidas de segurança para tratamento de parâmetros para evitar problemas comuns de segurança.

Medidas de segurança

MediaTailor implementa as seguintes medidas de segurança:

  1. Limitações de tamanho de entrada para evitar o inchaço do banco de dados

  2. Codificação e higienização adequadas da entrada do usuário

  3. URL-encoding de entrada para evitar corrupção de resposta

Práticas recomendadas

Siga estas práticas recomendadas para o tratamento seguro de parâmetros:

  • Valide os valores dos parâmetros no lado do cliente antes de enviar

  • Use aliases de configuração para limitar possíveis valores de parâmetros

  • Evite incluir informações confidenciais nos parâmetros

  • Monitore o uso de parâmetros para padrões incomuns

  • Mantenha os valores dos parâmetros dentro dos limites de comprimento recomendados