Buat 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.

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 Referensi pengaturan distribusi.

6. Setelah selesai, pilih Buat distribusi.

CLI

Untuk membuat kebijakan permintaan asal dengan AWS Command Line Interface (AWS CLI), gunakan aws cloudfront create-origin-request-policy perintah. 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.

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 Referensi pengaturan 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 selengkapnya tentang bidang yang Anda tentukan dalam panggilan API ini, lihat Memahami kebijakan permintaan asal dan dokumentasi referensi API untuk AWS SDK atau klien API lainnya.

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

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

• Untuk melampirkannya 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 selengkapnya tentang bidang lain yang Anda tentukan dalam panggilan API ini, lihat Referensi pengaturan distribusi dan dokumentasi referensi API untuk AWS SDK atau klien API lainnya.