Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
MediaTailor 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-langkah resolusi
Untuk mengatasi kesalahan pembatasan karakter:
-
Tinjau nilai parameter untuk karakter yang tidak didukung:
:
,?
,&
,=
,%
/
-
Terapkan pengkodean URL yang tepat untuk karakter khusus (lihat) MediaTailor referensi parameter dan batasan
-
Hindari karakter ganda seperti
%%%
atau==
-
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:
-
Gunakan nama dan nilai parameter yang lebih pendek jika memungkinkan
-
Pisahkan nilai parameter besar menjadi beberapa parameter yang lebih kecil
-
Gunakan alias konfigurasi untuk memetakan alias pendek ke nilai yang lebih panjang (lihat) MediaTailor alias konfigurasi dan penggantian variabel dinamis
-
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:
-
Verifikasi semua variabel domain didefinisikan sebagai
ConfigurationAliases
-
Pastikan variabel parameter pemain menggunakan
player_params.
awalan -
Konfirmasikan daftar nilai alias lengkap untuk setiap parameter pemain
-
Periksa apakah permintaan inisialisasi sesi menentukan nilai alias yang valid
-
Validasi struktur parameter JSON ConfigurationAliases
Untuk panduan pemecahan masalah terperinci, lihat. MediaTailor konfigurasi alias pemecahan masalah
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:
-
Validasi parameter inisialisasi sesi
-
Resolusi alias konfigurasi (jika ada)
-
Pemfilteran parameter (ADS vs asal vs manifes)
-
Pengkodean dan pemformatan URL
-
Parameter aplikasi untuk URLs
Aliran parameter debugging
Untuk men-debug masalah pemrosesan parameter:
-
Verifikasi parameter ditentukan dengan benar dalam inisialisasi sesi
-
Periksa apakah alias konfigurasi diselesaikan ke nilai yang diharapkan
-
Konfirmasi parameter muncul di benar URLs (manifes, ADS, asal)
-
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:
-
Keterbatasan ukuran input untuk mencegah pembengkakan basis data
-
Pengkodean dan sanitasi input pengguna yang tepat
-
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