Mengendalikan permintaan asal usul

Saat permintaan penampil CloudFront menghasilkan cache yang hilang (objek yang diminta tidak di-cache di lokasi tepi), CloudFront mengirimkan permintaan ke asal untuk mengambil objek. Ini disebut permintaan asal perjalanan. Permintaan asal usul selalu menyertakan informasi berikut dari permintaan penampil:

• Jalur URL (jalur saja, tanpa string kueri URL atau nama domain)

• Isi permohonan (jika ada)

• Header HTTP yang CloudFront secara otomatis menyertakan dalam setiap permintaan asal, termasukHost,User-Agent, dan X-Amz-Cf-Id

Informasi lain dari permintaan penampil, seperti string kueri URL, header HTTP, dan cookie, tidak disertakan dalam permintaan asal secara default. (Pengecualian: Dengan pengaturan cache lama, CloudFront teruskan header ke asal Anda secara default.) Namun, Anda mungkin ingin menerima beberapa informasi lain ini di tempat asal, misalnya untuk mengumpulkan data untuk analitik atau telemetri. Anda dapat menggunakan kebijakan permintaan asal untuk mengontrol informasi yang disertakan dalam permintaan asal.

Kebijakan permintaan asal terpisah dari kebijakan cache, yang mengontrol kunci cache. Pemisahan ini memungkinkan Anda untuk menerima informasi tambahan di tempat asal dan juga mempertahankan rasio tembolok (proporsi permintaan penampil yang menghasilkan ketukan cache). Anda melakukannya dengan secara terpisah mengontrol informasi mana saja yang termasuk dalam permintaan asal (menggunakan kebijakan permintaan asal) dan yang disertakan dalam kunci cache (menggunakan kebijakan cache).

Meskipun dua jenis kebijakan terpisah, kebijakan tersebut berkaitan. Semua string kueri URL, header HTTP, dan cookie yang Anda sertakan dalam kunci cache (menggunakan kebijakan cache) secara otomatis disertakan dalam permintaan asal. Gunakan kebijakan permintaan asal usul untuk menentukan informasi yang ingin Anda masukkan ke permintaan asal keberangkatan, tetapi tidak di dalam kunci cache. Sama seperti kebijakan cache, Anda melampirkan kebijakan permintaan asal ke satu atau beberapa perilaku cache dalam CloudFront distribusi.

Anda juga dapat menggunakan kebijakan permintaan asal untuk menambahkan header HTTP tambahan ke permintaan asal yang tidak disertakan dalam permintaan penampil. Header tambahan ini ditambahkan oleh CloudFront sebelum mengirim permintaan asal, dengan nilai header yang ditentukan secara otomatis berdasarkan permintaan penampil. Untuk informasi selengkapnya, lihat Menambahkan header CloudFront permintaan.

Topik

• Membuat kebijakan permintaan asal
• Memahami kebijakan permintaan asal usul
• Menggunakan kebijakan permintaan asal terkelola
• Menambahkan header CloudFront permintaan
• Memahami cara kerja kebijakan permintaan asal dan kebijakan cache

Membuat kebijakan permintaan asal

Anda dapat menggunakan kebijakan permintaan asal untuk mengontrol nilai (string kueri URL, header HTTP, dan cookie) yang disertakan dalam permintaan yang CloudFront dikirim ke asal Anda. Anda dapat membuat kebijakan permintaan asal di CloudFront konsol, dengan AWS Command Line Interface (AWS CLI), atau dengan CloudFront API.

Setelah membuat kebijakan permintaan asal, Anda melampirkannya ke satu atau beberapa perilaku cache dalam CloudFront distribusi.

Kebijakan permintaan asal tidak diperlukan. Saat perilaku cache tidak memiliki kebijakan permintaan asal yang dilampirkan, permintaan asal mencakup semua nilai yang ditentukan dalam kebijakan cache, tetapi tidak lebih.

catatan

Untuk menggunakan kebijakan permintaan asal, perilaku cache juga harus menggunakan kebijakan cache. Anda tidak dapat menggunakan kebijakan permintaan asal dalam perilaku cache tanpa kebijakan cache.

Console

Untuk membuat kebijakan permintaan asal (konsol)

1. Masuk ke AWS Management Console dan buka halaman Kebijakan di CloudFront konsol dihttps://console.aws.amazon.com/cloudfront/v4/home?#/policies.

2. Pilih Permintaan asal, lalu pilih Buat kebijakan permintaan asal.

3. Pilih pengaturan yang diinginkan untuk kebijakan permintaan asal ini. Untuk informasi selengkapnya, lihat Memahami kebijakan permintaan asal usul.

4. Setelah selesai, pilih Buat.

Setelah membuat kebijakan permintaan asal, Anda dapat melampirkannya ke perilaku cache.

Untuk melampirkan kebijakan permintaan asal ke distribusi yang ada (konsol)

1. Buka halaman Distribusi di CloudFront konsol dihttps://console.aws.amazon.com/cloudfront/v4/home#/distributions.

2. Pilih distribusi untuk diperbarui, lalu pilih Perilaku tab.

3. Pilih perilaku cache untuk diperbarui, lalu pilih Edit.

   Atau, untuk membuat perilaku cache baru, pilih Buat perilaku.

4. Di bagian Kunci cache dan permintaan asal, pastikan kebijakan Cache dan kebijakan permintaan asal dipilih.

5. Untuk kebijakan permintaan Origin, pilih kebijakan permintaan asal untuk dilampirkan ke perilaku cache ini.

6. Di bagian bawah halaman, pilih Simpan perubahan.

Untuk melampirkan kebijakan permintaan asal usul ke distribusi baru (konsol)

1. Buka CloudFront konsol dihttps://console.aws.amazon.com/cloudfront/v4/home.

2. Pilih Buat Distribusi.

3. Di bagian Kunci cache dan permintaan asal, pastikan kebijakan Cache dan kebijakan permintaan asal dipilih.

4. Untuk kebijakan permintaan Origin, pilih kebijakan permintaan asal untuk dilampirkan ke perilaku cache default distribusi ini.

5. Pilih pengaturan yang diinginkan untuk asal, perilaku cache default, dan pengaturan distribusi lainnya. Untuk informasi selengkapnya, lihat Nilai yang Anda tentukan saat membuat atau memperbarui distribusi.

6. Setelah selesai, pilih Buat distribusi.

CLI

Untuk membuat kebijakan permintaan asal dengan AWS Command Line Interface (AWS CLI), gunakan perintah aws cloudfront create-origin-request-policy. Anda dapat menggunakan file input untuk memberikan parameter input perintah, daripada menentukan setiap parameter individu sebagai input baris perintah.

Untuk membuat kebijakan permintaan asal (CLI dengan file input)

1. Gunakan perintah berikut untuk membuat file dengan nama origin-request-policy.yaml yang berisi semua parameter input untuk create-origin-request-policy perintah.

   
   aws cloudfront create-origin-request-policy --generate-cli-skeleton yaml-input > origin-request-policy.yaml

2. Buka file dengan nama origin-request-policy.yaml yang baru Anda buat. Edit file untuk menentukan pengaturan kebijakan permintaan asal yang diinginkan, lalu simpan file. Anda dapat menghapus bidang opsional dari file, tetapi jangan menghapus bidang yang diperlukan.

   Untuk informasi selengkapnya tentang pengaturan kebijakan permintaan asal, lihat Memahami kebijakan permintaan asal usul.

3. Gunakan perintah berikut untuk membuat kebijakan permintaan asal dengan menggunakan parameter input dari origin-request-policy.yaml file.

   
   aws cloudfront create-origin-request-policy --cli-input-yaml file://origin-request-policy.yaml

   Catat Id nilai dalam output perintah. Ini adalah ID kebijakan permintaan asal, dan Anda memerlukannya untuk melampirkan kebijakan permintaan asal ke perilaku cache CloudFront distribusi.

Untuk melampirkan kebijakan permintaan asal ke distribusi yang ada (CLI dengan file masukan)

1. Gunakan perintah berikut untuk menyimpan konfigurasi distribusi untuk CloudFront distribusi yang ingin Anda perbarui. Ganti Distribution_ID dengan ID distribusi.

   
   aws cloudfront get-distribution-config --id distribution_ID --output yaml > dist-config.yaml

2. Buka file dengan nama dist-config.yaml yang baru Anda buat. Edit file, membuat perubahan berikut pada setiap perilaku cache yang Anda perbarui untuk menggunakan kebijakan permintaan asal usul.

   • Dalam perilaku cache, tambahkan bidang bernama OriginRequestPolicyId. Untuk nilai bidang, gunakan ID kebijakan permintaan asal yang Anda catat setelah membuat kebijakan.

   • Ubah nama ETag bidang menjadiIfMatch, tetapi jangan ubah nilai bidang.

   Simpan file setelah selesai.

3. Gunakan perintah berikut untuk memperbarui distribusi untuk menggunakan kebijakan permintaan asal usul. Ganti Distribution_ID dengan ID distribusi.

   
   aws cloudfront update-distribution --id distribution_ID --cli-input-yaml file://dist-config.yaml

Untuk melampirkan kebijakan permintaan asal ke distribusi baru (CLI dengan file input)

1. Gunakan perintah berikut untuk membuat file dengan nama distribution.yaml yang berisi semua parameter input untuk create-distribution perintah.

   
   aws cloudfront create-distribution --generate-cli-skeleton yaml-input > distribution.yaml

2. Buka file dengan nama distribution.yaml yang baru Anda buat. Dalam perilaku cache default, di OriginRequestPolicyId , masukkan ID kebijakan permintaan asal yang Anda catat setelah membuat kebijakan. Lanjutkan mengedit file untuk menentukan pengaturan distribusi yang Anda inginkan, kemudian simpan file setelah selesai.

   Untuk informasi lebih lanjut tentang pengaturan distribusi, lihat Nilai yang Anda tentukan saat membuat atau memperbarui distribusi.

3. Gunakan perintah berikut untuk membuat distribusi menggunakan parameter input dari distribution.yaml file Anda.

   
   aws cloudfront create-distribution --cli-input-yaml file://distribution.yaml

API

Untuk membuat kebijakan permintaan asal dengan CloudFront API, gunakan CreateOriginRequestPolicy. Untuk informasi lebih lanjut tentang bidang lain yang Anda tentukan dalam panggilan API ini, lihat Memahami kebijakan permintaan asal usul dan dokumentasi referensi API untuk AWS SDK Anda atau klien API lainnya.

Setelah Anda membuat kebijakan permintaan asal, Anda dapat melampirkannya ke perilaku cache, menggunakan salah satu panggilan API berikut:

• Untuk memasangnya ke perilaku cache dalam distribusi yang ada, gunakan UpdateDistribution.

• Untuk memasangnya ke perilaku cache dalam distribusi baru, gunakan CreateDistribution.

Untuk kedua panggilan API ini, berikan ID kebijakan permintaan asal di OriginRequestPolicyId bidang, di dalam perilaku cache. Untuk informasi lebih lanjut tentang bidang lain yang Anda tentukan dalam panggilan API ini, lihat Nilai yang Anda tentukan saat membuat atau memperbarui distribusi dan dokumentasi referensi API untuk AWS SDK Anda atau klien API lainnya.

Memahami kebijakan permintaan asal usul

CloudFront menyediakan beberapa kebijakan permintaan asal yang telah ditentukan sebelumnya, yang dikenal sebagai kebijakan terkelola, untuk kasus penggunaan umum. Anda dapat menggunakan kebijakan terkelola ini, atau Anda dapat membuat kebijakan permintaan asal Anda sendiri yang khusus untuk kebutuhan Anda. Untuk informasi lebih lanjut tentang kebijakan terkelola, lihat Menggunakan kebijakan permintaan asal terkelola.

Kebijakan permohonan asal memuat pengaturan berikut, yang dikategorikan menjadi informasi kebijakan dan pengaturan permintaan asal.

Informasi kebijakan

Nama

Nama untuk mengidentifikasi kebijakan permintaan asal usul. Pada konsol, Anda menggunakan nama untuk melampirkan kebijakan permintaan asal untuk perilaku cache.

Deskripsi

Komentar untuk menguraikan kebijakan permintaan asal. Ini opsional.

Pengaturan permintaan asal

Pengaturan permintaan asal menentukan nilai dalam permintaan penampil yang disertakan dalam permintaan yang CloudFront dikirim ke asal (dikenal sebagai permintaan asal). Nilai dapat mencakup string kueri URL, header HTTP, dan cookie. Nilai yang Anda tetapkan termasuk dalam permintaan asal, tetapi tidak termasuk dalam kunci cache. Untuk informasi tentang pengontrolan kunci cache, lihat Mengontrol kunci cache.

Header

Header HTTP dalam permintaan penampil yang CloudFront menyertakan permintaan asal. Untuk header, Anda dapat memilih salah satu pengaturan berikut:

• Tidak ada – Header HTTP dalam permintaan penampil adalah tidak yang termasuk dalam permintaan asal usul.

• Semua header penampil – Semua header HTTP di permintaan penampil disertakan dalam permintaan asal.

• Semua header penampil dan CloudFront header berikut - Semua header HTTP dalam permintaan penampil disertakan dalam permintaan asal. Selain itu, Anda menentukan CloudFront header mana yang ingin Anda tambahkan ke permintaan asal. Untuk informasi selengkapnya tentang CloudFront header, lihatMenambahkan header CloudFront permintaan.

• Sertakan header berikut - Anda menentukan header HTTP mana yang disertakan dalam permintaan asal.

  catatan

  Jangan tentukan header yang sudah disertakan dalam pengaturan Origin Custom Header Anda. Untuk informasi selengkapnya, lihat Mengkonfigurasi CloudFront untuk menambahkan header khusus ke permintaan asal.

• Semua header penampil kecuali - Anda menentukan header HTTP mana yang tidak termasuk dalam permintaan asal. Semua header HTTP lainnya dalam permintaan penampil, kecuali yang ditentukan, disertakan.

Saat Anda menggunakan header Semua penampil dan header berikut, Sertakan CloudFront header berikut, atau Semua header penampil kecuali setelan, Anda menentukan header HTTP hanya dengan nama header. CloudFront termasuk header lengkap, termasuk nilainya, dalam permintaan asal.

catatan

Saat Anda menggunakan header Semua penampil kecuali setelan untuk menghapus Host header penampil, CloudFront tambahkan Host header baru dengan nama domain asal ke permintaan asal.

Cookie

Cookie dalam permintaan penampil yang CloudFront mencakup permintaan asal. Untuk cookie, Anda dapat memilih salah satu pengaturan berikut:

• Tidak ada – Cookie di permintaan penampil adalah tidak yang termasuk dalam permintaan asal usul.

• Semua – Semua cookie di permintaan pemirsa disertakan dalam permintaan asal.

• Sertakan cookie berikut - Anda menentukan cookie mana dalam permintaan penampil yang disertakan dalam permintaan asal.

• Semua cookie kecuali — Anda menentukan cookie mana dalam permintaan penampil yang tidak termasuk dalam permintaan asal. Semua cookie lain dalam permintaan pemirsa disertakan.

Ketika Anda menggunakan Sertakan cookie berikut atau Semua cookie kecuali pengaturan, Anda menentukan cookie dengan nama mereka saja. CloudFront termasuk cookie lengkap, termasuk nilainya, dalam permintaan asal.

String kueri

String kueri URL dalam permintaan penampil yang CloudFront menyertakan permintaan asal. Untuk string kueri, Anda dapat memilih salah satu pengaturan berikut:

• Tidak ada – String kueri pada permintaan pemirsa adalah tidak yang termasuk dalam permintaan asal usul.

• Semua – Semua string kueri dalam permintaan penampil akan disertakan dalam permintaan asal.

• Sertakan string kueri berikut - Anda menentukan string kueri mana dalam permintaan penampil yang disertakan dalam permintaan asal.

• Semua string kueri kecuali - Anda menentukan string kueri mana dalam permintaan penampil yang tidak termasuk dalam permintaan asal. Semua string kueri lainnya disertakan.

Bila Anda menggunakan Sertakan string kueri berikut atau Semua string kueri kecuali pengaturan, Anda menentukan string kueri dengan nama mereka saja. CloudFront termasuk string kueri lengkap, termasuk nilainya, dalam permintaan asal.