View a markdown version of this page

MediaTailor Leitfaden zur Fehlerbehebung bei Parametern - AWS Elemental MediaTailor
Fehler bei der ZeichenbeschränkungFehler bei der LängenbegrenzungFehler beim Konfigurations-AliasProbleme beim Ablauf der ParameterverarbeitungSicherheitsüberlegungen und bewährte Methoden

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

MediaTailor Leitfaden zur Fehlerbehebung bei Parametern

AWS Elemental MediaTailor bietet Anleitungen zur Behebung häufig auftretender parameterbezogener Probleme MediaTailor, einschließlich Zeicheneinschränkungen, URL-Codierungsproblemen und Konfigurationsaliasfehlern.

Fehler bei der Zeichenbeschränkung

Parameterwerte, die nicht unterstützte Zeichen enthalten, können zu Fehlern oder unerwartetem Verhalten führen.

Häufige Symptome

Die folgenden Symptome können auf Probleme mit der Zeichenbeschränkung hinweisen:

  • Parameter, die in Manifest-URLs nicht vorkommen

  • HTTP 400-Fehler bei der Sitzungsinitialisierung

  • Abgeschnittene oder beschädigte Parameterwerte

  • ADS-Anfragen schlagen aufgrund falsch formatierter URLs fehl

Lösungsschritte

Um Fehler bei der Zeichenbeschränkung zu beheben:

  1. Überprüfen Sie die Parameterwerte auf nicht unterstützte Zeichen: :?,,&,=, % /

  2. URL-encoding Bei Sonderzeichen richtig anwenden (sieheMediaTailor Parameterreferenz und Einschränkungen)

  3. Vermeiden Sie Doppelzeichen wie %%% oder ==

  4. Ziehen Sie alternative Parameterformate in Betracht, wenn vollständige URLs nicht verwendet werden können

Beispiel Beispiel für eine URL-Codierung

Anstatt zu verwenden: 

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

Verwenden Sie URL-encoded das Format: 

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

Fehler bei der Längenbegrenzung

Parameter, die die Längenbegrenzungen überschreiten, können gekürzt werden oder Fehler verursachen.

Längenbeschränkungen

Es gelten die folgenden Längenbeschränkungen (vollständige MediaTailor Parameterreferenz und Einschränkungen Informationen finden Sie unter):

  • Manifest-Abfrageparameter (insgesamt): 2000 Zeichen

  • ADS-Parameternamen: 10.000 Zeichen

  • ADS-Parameterwerte: 25.000 Zeichen

  • ADS-URLs: 25.000 Zeichen

Lösungsstrategien

Um mit Längenbeschränkungen umzugehen:

  1. Verwenden Sie nach Möglichkeit kürzere Parameternamen und Werte

  2. Teilen Sie große Parameterwerte in mehrere kleinere Parameter auf

  3. Verwenden Sie Konfigurationsaliase, um kurze Aliase längeren Werten zuzuordnen (siehe) MediaTailor Übersicht über Konfigurationsaliase

  4. Erwägen Sie die Verwendung eines externen Speichers für große Daten mit Parameterreferenzen

Fehler beim Konfigurations-Alias

Probleme mit dem Konfigurationsalias können zu HTTP 400-Fehlern oder unerwarteten Parameterwerten führen.

Häufige Fehler beim Konfigurations-Alias

Die folgenden Fehler treten häufig bei Konfigurationsaliasen auf:

  • HTTP 400-Fehler: Fehlender oder ungültiger Aliaswert

  • Domänenvariablen werden nicht richtig aufgelöst

  • Player-Parameter werden nicht durch Aliaswerte ersetzt

Checkliste zur Lösung

So beheben Sie Konfigurationsaliasfehler:

  1. Stellen Sie sicher, dass alle Domänenvariablen definiert sind als ConfigurationAliases

  2. Stellen Sie sicher, dass Player-Parametervariablen ein player_params. Präfix

  3. Vergewissern Sie sich, dass die Liste der Aliaswerte für Domain-Variablen in kritischen URLs vollständig ist (VideoContentSourceUrl,,AdSegmentUrlPrefix) ContentSegmentUrlPrefix

  4. Vergewissern Sie sich, dass bei Anfragen zur Sitzungsinitialisierung gültige Aliaswerte angegeben sind

  5. Überprüfen Sie die JSON-Struktur des Parameters ConfigurationAliases

Eine ausführliche Anleitung zur Problembehandlung finden Sie unterMediaTailor Leitfaden zur Fehlerbehebung bei Konfigurationsaliasen.

Beispiel Validierung des Konfigurations-Alias

Stellen Sie sicher, dass Ihre Konfiguration alle erforderlichen Aliase enthält: 

"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
    }
}

Probleme beim Ablauf der Parameterverarbeitung

Wenn Sie den Ablauf der Parameterverarbeitung verstehen, können Sie Probleme mit der Parameterweiterleitung und -transformation beheben.

Reihenfolge der Parameterverarbeitung

MediaTailor verarbeitet Parameter in der folgenden Reihenfolge:

  1. Validierung der Parameter für die Sitzungsinitialisierung

  2. Auflösung des Konfigurationsalias (falls zutreffend)

  3. Parameterfilterung (ADS im Vergleich zum Ursprung im Vergleich zum Manifest)

  4. URL-Kodierung und -Formatierung

  5. Anwendung von Parametern auf URLs

Parameterfluss debuggen

So debuggen Sie Probleme bei der Parameterverarbeitung:

  1. Stellen Sie sicher, dass die Parameter bei der Sitzungsinitialisierung korrekt angegeben wurden

  2. Stellen Sie sicher, dass die Konfigurationsaliase die erwarteten Werte annehmen

  3. Bestätigen Sie, dass die Parameter in den richtigen URLs (Manifest, ADS, Herkunft) angezeigt werden

  4. Überprüfen Sie, ob die URL-Codierung korrekt angewendet wurde

Beispiel Beispiel für einen Parameterfluss

Initialisierung der Sitzung: 

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

Nach der Aliasauflösung und -verarbeitung:

  • Herkunft der Anfrage: https://abc.mediapackage.us-west-2.amazonaws.com/out/v1/abcd

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

Sicherheitsüberlegungen und bewährte Methoden

MediaTailor implementiert Sicherheitsmaßnahmen für die Parameterbehandlung, um häufig auftretende Sicherheitsprobleme zu vermeiden.

Sicherheitsmaßnahmen

MediaTailor implementiert die folgenden Sicherheitsmaßnahmen:

  1. Beschränkungen der Eingabegröße, um ein Aufblähen der Datenbank zu verhindern

  2. Richtige Kodierung und Bereinigung von Benutzereingaben

  3. URL-encoding der Eingabe, um eine Beschädigung der Antwort zu verhindern

Bewährte Methoden

Folgen Sie diesen bewährten Methoden für die sichere Parameterverarbeitung:

  • Überprüfen Sie die Parameterwerte auf der Clientseite vor dem Senden

  • Verwenden Sie Konfigurationsaliase, um mögliche Parameterwerte einzuschränken

  • Vermeiden Sie es, vertrauliche Informationen in Parameter aufzunehmen

  • Überwachen Sie die Verwendung von Parametern auf ungewöhnliche Muster

  • Halten Sie die Parameterwerte innerhalb der empfohlenen Längengrenzen ein