MediaTailor panduan pemecahan masalah parameter

AWS Elemental MediaTailor memberikan panduan untuk memecahkan masalah umum terkait parameter di MediaTailor, termasuk pembatasan karakter, masalah pengkodean URL, dan kesalahan alias konfigurasi.

Kesalahan pembatasan karakter

Nilai parameter yang berisi karakter yang tidak didukung dapat menyebabkan kesalahan atau perilaku tak terduga.

Gejala umum

Gejala-gejala berikut mungkin menunjukkan masalah pembatasan karakter:

• Parameter tidak muncul dalam manifes URLs

• Kesalahan HTTP 400 selama inisialisasi sesi

• Nilai parameter terpotong atau rusak

• Permintaan ADS gagal karena cacat URLs

Langkah resolusi

Untuk mengatasi kesalahan pembatasan karakter:

1. Tinjau nilai parameter untuk karakter yang tidak didukung::,?,&,=, % /

2. Terapkan pengkodean URL yang tepat untuk karakter khusus (lihat) MediaTailor referensi parameter dan batasan

3. Hindari karakter ganda seperti %%% atau ==

4. Pertimbangkan format parameter alternatif jika penuh URLs tidak dapat digunakan

contoh Contoh pengkodean URL

Alih-alih menggunakan:

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

Gunakan format yang dikodekan URL:

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

Kesalahan batasan panjang

Parameter yang melebihi batas panjang dapat terpotong atau menyebabkan kesalahan.

Batas panjang

Batas panjang berikut berlaku (lihat MediaTailor referensi parameter dan batasan untuk detail lengkapnya):

• Parameter kueri manifes (total): 2000 karakter

• Nama parameter ADS: 10.000 karakter

• Nilai parameter ADS: 25.000 karakter

• ADS URLs: 25.000 karakter

Strategi resolusi

Untuk menangani keterbatasan panjang:

1. Gunakan nama dan nilai parameter yang lebih pendek jika memungkinkan

2. Pisahkan nilai parameter besar menjadi beberapa parameter yang lebih kecil

3. Gunakan alias konfigurasi untuk memetakan alias pendek ke nilai yang lebih panjang (lihat) MediaTailor ikhtisar alias konfigurasi

4. Pertimbangkan untuk menggunakan penyimpanan eksternal untuk data besar dengan referensi parameter

Kesalahan alias konfigurasi

Masalah alias konfigurasi dapat mengakibatkan kesalahan HTTP 400 atau nilai parameter yang tidak terduga.

Kesalahan alias konfigurasi umum

Kesalahan berikut biasanya terjadi dengan alias konfigurasi:

• Kesalahan HTTP 400: Nilai alias hilang atau tidak valid

• Variabel domain tidak menyelesaikan dengan benar

• Parameter pemain tidak diganti dengan nilai alias

Daftar periksa resolusi

Untuk mengatasi kesalahan alias konfigurasi:

1. Verifikasi semua variabel domain didefinisikan sebagai ConfigurationAliases

2. Pastikan variabel parameter pemain menggunakan player_params. awalan

3. Konfirmasikan daftar nilai alias lengkap untuk variabel domain di critical URLs (VideoContentSourceUrl,,) AdSegmentUrlPrefix ContentSegmentUrlPrefix

4. Periksa apakah permintaan inisialisasi sesi menentukan nilai alias yang valid

5. Validasi struktur parameter JSON ConfigurationAliases

Untuk panduan pemecahan masalah terperinci, lihat. MediaTailor panduan pemecahan masalah alias konfigurasi

contoh Konfigurasi alias validasi

Pastikan konfigurasi Anda mencakup semua alias yang diperlukan:

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

Masalah aliran pemrosesan parameter

Memahami alur pemrosesan parameter membantu memecahkan masalah dengan penerusan dan transformasi parameter.

Urutan pemrosesan parameter

MediaTailor memproses parameter dalam urutan sebagai berikut:

1. Validasi parameter inisialisasi sesi

2. Resolusi alias konfigurasi (jika ada)

3. Pemfilteran parameter (ADS vs asal vs manifes)

4. Pengkodean dan pemformatan URL

5. Parameter aplikasi untuk URLs

Aliran parameter debugging

Untuk men-debug masalah pemrosesan parameter:

1. Verifikasi parameter ditentukan dengan benar dalam inisialisasi sesi

2. Periksa apakah alias konfigurasi diselesaikan ke nilai yang diharapkan

3. Konfirmasi parameter muncul di benar URLs (manifes, ADS, asal)

4. Validasi pengkodean URL diterapkan dengan benar

contoh Contoh aliran parameter

Inisialisasi sesi:

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

Setelah resolusi dan pemrosesan alias:

• Permintaan asal: https://abc.mediapackage.us-west-2.amazonaws.com/out/v1/abcd

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

Pertimbangan keamanan dan praktik terbaik

MediaTailor mengimplementasikan langkah-langkah keamanan untuk penanganan parameter untuk mencegah masalah keamanan umum.

Langkah-langkah keamanan

MediaTailor menerapkan langkah-langkah keamanan berikut:

1. Keterbatasan ukuran input untuk mencegah bongkahan basis data

2. Pengkodean dan sanitasi input pengguna yang tepat

3. Pengkodean URL input untuk mencegah korupsi respons

Praktik terbaik

Ikuti praktik terbaik ini untuk penanganan parameter yang aman:

• Validasi nilai parameter di sisi klien sebelum mengirim

• Gunakan alias konfigurasi untuk membatasi nilai parameter yang mungkin

• Hindari memasukkan informasi sensitif dalam parameter

• Memantau penggunaan parameter untuk pola yang tidak biasa

• Simpan nilai parameter dalam batas panjang yang disarankan