View a markdown version of this page

MediaTailor panduan pemecahan masalah parameter - AWS Elemental MediaTailor
Kesalahan pembatasan karakterKesalahan batasan panjangKesalahan alias konfigurasiMasalah aliran pemrosesan parameterPertimbangan keamanan dan praktik terbaik

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

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 di URL manifes

  • Kesalahan HTTP 400 selama inisialisasi sesi

  • Nilai parameter terpotong atau rusak

  • Permintaan ADS gagal karena URL yang salah format

Langkah-langkah resolusi

Untuk mengatasi kesalahan pembatasan karakter:

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

  2. Terapkan yang tepat URL-encoding untuk karakter khusus (lihatMediaTailor referensi parameter dan batasan)

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

  4. Pertimbangkan format parameter alternatif jika URL lengkap tidak dapat digunakan

contoh Contoh pengkodean URL

Alih-alih menggunakan: 

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

Gunakan URL-encoded format: 

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

  • URL ADS: 25.000 karakter

Strategi resolusi

Untuk menangani batasan 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 diselesaikan 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 URL penting (VideoContentSourceUrl,AdSegmentUrlPrefix,ContentSegmentUrlPrefix)

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

  5. Validasi struktur ConfigurationAliases parameter JSON

Untuk panduan pemecahan masalah terperinci, lihatMediaTailor panduan pemecahan masalah alias konfigurasi.

contoh Validasi alias konfigurasi

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 berlaku)

  3. Pemfilteran parameter (ADS vs asal vs manifes)

  4. Pengkodean dan pemformatan URL

  5. Aplikasi parameter ke URL

Aliran parameter debugging

Untuk men-debug masalah pemrosesan parameter:

  1. Verifikasi parameter ditentukan dengan benar dalam inisialisasi sesi

  2. Periksa apakah alias konfigurasi diselesaikan dengan nilai yang diharapkan

  3. Parameter konfirmasi muncul di URL yang benar (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 menerapkan langkah-langkah keamanan untuk penanganan parameter untuk mencegah masalah keamanan umum.

Langkah-langkah keamanan

MediaTailor menerapkan langkah-langkah keamanan berikut:

  1. Batasan ukuran input untuk mencegah pembengkakan database

  2. Pengkodean dan sanitasi input pengguna yang tepat

  3. URL-encoding masukan untuk mencegah korupsi respons

Praktik terbaik

Ikuti praktik terbaik berikut untuk penanganan parameter yang aman:

  • Validasi nilai parameter di sisi klien sebelum mengirim

  • Gunakan alias konfigurasi untuk membatasi kemungkinan nilai parameter

  • Hindari memasukkan informasi sensitif dalam parameter

  • Memantau penggunaan parameter untuk pola yang tidak biasa

  • Pertahankan nilai parameter dalam batas panjang yang disarankan