MediaTailor Fehlerbehebung bei Parametern

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

Fehler bei der Zeichenbeschränkung

Parameterwerte, die Zeichen enthalten, die nicht unterstützt werden, 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 nicht im Manifest vorkommen URLs

• HTTP 400-Fehler bei der Sitzungsinitialisierung

• Verkürzte oder beschädigte Parameterwerte

• ADS-Anfragen schlagen aufgrund eines fehlerhaften Formats fehl URLs

Schritte zur Lösung

So beheben Sie Fehler bei der Zeichenbeschränkung:

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

2. Wenden Sie die richtige URL-Kodierung für Sonderzeichen an (siehe) MediaTailor Parameterreferenz und Einschränkungen

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

4. Ziehen Sie alternative Parameterformate in Betracht, wenn full URLs nicht verwendet werden kann

Beispiel für die URL-Codierung

Anstatt zu verwenden:

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

Verwenden Sie das URL-kodierte Format:

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

Fehler bei der Längenbegrenzung

Parameter, die Längenbeschränkungen ü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 Längenbeschränkungen zu handhaben:

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 Konfigurationsaliase und dynamische Variablenersetzung

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

Alias-Fehler bei der Konfiguration

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

Häufige Fehler bei Konfigurations-Alias

Die folgenden Fehler treten häufig bei Konfigurationsaliasnamen auf:

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

• Domänenvariablen werden nicht korrekt aufgelöst

• Player-Parameter werden nicht durch Aliaswerte ersetzt

Checkliste zur Lösung

So beheben Sie Fehler bei Konfigurations-Alias:

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 jeden Spielerparameter vollständig ist

4. Vergewissern Sie sich, dass Anfragen zur Sitzungsinitialisierung gültige Aliaswerte angeben

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

Eine ausführliche Anleitung zur Fehlerbehebung finden Sie unterMediaTailor Fehlerbehebung bei Konfigurationsaliasnamen.

Beispiel Validierung von 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 mit dem Ablauf der Parameterverarbeitung

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

Reihenfolge der Parameterverarbeitung

MediaTailor verarbeitet Parameter in der folgenden Reihenfolge:

1. Überprüfung der Parameter für die Initialisierung der Sitzung

2. Auflösung des Konfigurationsalias (falls zutreffend)

3. Parameterfilterung (ADS im Vergleich zu Origin und Manifest)

4. URL-Kodierung und -Formatierung

5. Parameteranwendung auf URLs

Debuggen des Parameterflusses

So debuggen Sie Probleme mit der Parameterverarbeitung:

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

2. Stellen Sie sicher, dass die Konfigurationsaliase zu den erwarteten Werten aufgelöst werden

3. Vergewissern Sie sich, dass die Parameter korrekt angezeigt werden URLs (Manifest, ADS, Origin)

4. Stellen Sie sicher, dass die URL-Codierung korrekt angewendet wurde

Beispiel für einen Parameterfluss

Initialisierung der Sitzung:

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

Nach der Auflösung und Verarbeitung des Alias:

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

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

Sicherheitsüberlegungen und bewährte Methoden

MediaTailor implementiert Sicherheitsmaßnahmen für den Umgang mit Parametern, um allgemeine Sicherheitsprobleme zu vermeiden.

Sicherheitsmaßnahmen

MediaTailor implementiert die folgenden Sicherheitsmaßnahmen:

1. Beschränkungen der Eingabegröße, um eine Überlastung der Datenbank zu verhindern

2. Richtige Kodierung und Bereinigung von Benutzereingaben

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

Bewährte Methoden

Folgen Sie diesen bewährten Methoden für die sichere Handhabung von Parametern:

• Überprüfen Sie die Parameterwerte auf der Clientseite, bevor Sie sie 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