Terapkan perlindungan lintas akun dengan penegakan Amazon Bedrock Guardrails

Rencanakan konfigurasi pagar pembatas

1. Tentukan perlindungan Anda:

   • Tinjau filter pagar pembatas yang tersedia dalam dokumentasi Amazon Bedrock Guardrails

   • Identifikasi filter mana yang Anda butuhkan. Saat ini, filter konten, topik yang ditolak, filter kata, filter informasi sensitif, pemeriksaan pentanahan kontekstual didukung.

   • penting

     Jangan sertakan kebijakan penalaran otomatis, karena tidak didukung untuk penegakan pagar pembatas dan akan menyebabkan kegagalan runtime.

2. Identifikasi akun target:

   • Tentukan mana OUs, akun, atau seluruh organisasi Anda yang akan memberlakukan pagar pembatas ini

Buat pagar pembatas Anda di akun manajemen

Buat pagar pembatas di setiap wilayah tempat Anda ingin menegakkannya dengan salah satu metode berikut:

• Menggunakan Konsol Manajemen AWS:

  1. Masuk ke Konsol Manajemen AWS dengan identitas IAM yang memiliki izin untuk menggunakan konsol Amazon Bedrock. Kemudian, buka konsol Amazon Bedrock di https://console.aws.amazon.com/bedrock.

  2. Di panel navigasi kiri, pilih Guardrails

  3. Pilih Buat pagar pembatas

  4. Ikuti panduan untuk mengonfigurasi filter atau perlindungan yang Anda inginkan (filter konten, topik yang ditolak, filter kata, filter informasi sensitif, pemeriksaan pentanahan kontekstual)

  5. Jangan aktifkan kebijakan penalaran otomatis

  6. Lengkapi wizard untuk membuat pagar pembatas Anda

• Menggunakan API: Gunakan CreateGuardrailAPI

Verifikasi

Setelah dibuat, Anda akan melihatnya di daftar pagar pembatas di halaman arahan Guardrails atau mencarinya di daftar pagar pembatas menggunakan nama pagar pembatas

Buat versi pagar pembatas

Buat versi numerik untuk memastikan konfigurasi pagar pembatas tetap tidak berubah dan tidak dapat dimodifikasi oleh akun anggota.

• Menggunakan Konsol Manajemen AWS:

  1. Pilih pagar pembatas yang dibuat pada langkah sebelumnya di halaman Guardrails di konsol Amazon Bedrock

  2. Pilih Buat versi

  3. Perhatikan pagar pembatas ARN dan nomor versi (misalnya, “1", “2")

• Menggunakan API: Gunakan CreateGuardrailVersionAPI

Verifikasi

Konfirmasikan bahwa versi telah berhasil dibuat dengan memeriksa daftar versi pada halaman detail Guardrail.

Lampirkan kebijakan berbasis sumber daya

Aktifkan akses lintas akun dengan melampirkan kebijakan berbasis sumber daya ke pagar pembatas Anda.

• Menggunakan Konsol Manajemen AWS — Untuk melampirkan kebijakan berbasis sumber daya menggunakan konsol:

  1. Di konsol Amazon Bedrock Guardrails, pilih pagar pembatas Anda

  2. Pilih Tambah untuk menambahkan kebijakan berbasis sumber daya

  3. Tambahkan kebijakan yang memberikan bedrock:ApplyGuardrail izin ke semua akun atau organisasi anggota. Lihat Bagikan pagar pembatas dengan organisasi Anda diMenggunakan kebijakan berbasis sumber daya untuk pagar pembatas.

  4. Simpan kebijakan

Verifikasi

Uji akses dari akun anggota menggunakan ApplyGuardrailAPI untuk memastikan otorisasi dikonfigurasi dengan benar.

Konfigurasikan izin IAM di akun anggota

Pastikan semua peran di akun anggota memiliki izin IAM untuk mengakses pagar pembatas yang diberlakukan.

Izin yang diperlukan

Peran akun anggota memerlukan bedrock:ApplyGuardrail izin untuk pagar pembatas akun manajemen. Lihat Siapkan izin untuk menggunakan Amazon Bedrock Guardrails contoh kebijakan IAM yang terperinci

Verifikasi

Konfirmasikan bahwa peran dengan izin cakupan bawah di akun anggota dapat berhasil memanggil ApplyGuardrail API dengan pagar pembatas.

Aktifkan Jenis Kebijakan Batuan Dasar Amazon di AWS Organizations

• Menggunakan Konsol Manajemen AWS — Untuk mengaktifkan jenis kebijakan Amazon Bedrock menggunakan konsol:

  1. Arahkan ke AWS Organizations konsol

  2. Pilih Kebijakan

  3. Pilih kebijakan Amazon Bedrock

  4. Pilih Aktifkan kebijakan Amazon Bedrock untuk mengaktifkan jenis kebijakan Amazon Bedrock untuk organisasi Anda

• Menggunakan API — Gunakan AWS Organizations EnablePolicyTypeAPI dengan tipe kebijakan BEDROCK_POLICY

Verifikasi

Konfirmasikan jenis kebijakan Amazon Bedrock ditampilkan sebagai diaktifkan di AWS Organizations konsol.

Membuat dan melampirkan AWS Organizations kebijakan

Buat kebijakan manajemen yang menentukan pagar pembatas Anda dan lampirkan ke akun target Anda atau. OUs

• Menggunakan Konsol Manajemen AWS — Untuk membuat dan melampirkan AWS Organizations kebijakan menggunakan konsol:

  1. Di AWS Organizations konsol, navigasikan ke Kebijakan > Kebijakan Amazon Bedrock

  2. Pilih Buat kebijakan.

  3. Tentukan ARN dan versi pagar pembatas Anda

     penting

     Pastikan Anda menentukan ARN pagar pembatas yang akurat dalam polis. Menentukan ARN yang salah atau tidak valid akan mengakibatkan pelanggaran kebijakan, non-penegakan perlindungan, dan ketidakmampuan untuk menggunakan model di Amazon Bedrock untuk inferensi.

  4. Konfigurasikan kontrol pelindung konten selektif (opsional).

     • Amazon Bedrock APIs memungkinkan penelepon untuk menandai konten tertentu dalam permintaan input mereka untuk evaluasi pagar pembatas.

     • Kontrol penjagaan konten selektif memungkinkan administrator memutuskan apakah akan menghormati keputusan penandaan yang dibuat oleh pemanggil API.

     • messagesKontrol system dan menentukan bagaimana permintaan sistem dan konten pesan diproses oleh pagar pembatas. Masing-masing menerima salah satu dari nilai berikut:

       • Selektif: Hanya mengevaluasi konten dalam tag konten penjaga. Ketika tidak ada tag yang ditentukan, perilaku tergantung pada kontrol. Karenasystem, tidak ada konten yang dievaluasi, dan untukmessages, semua konten dievaluasi.

       • Komprehensif: Evaluasi semua konten, terlepas dari tag konten penjaga.

     • Jika tidak dikonfigurasi, keduanya mengontrol default ke Comprehensive.

     {
         "bedrock": {
             "guardrail_inference": {
                 "us-east-1": {
                     "config_1": {
                         "identifier": {
                             "@@assign": "arn:aws:bedrock:us-east-1:123456789012:guardrail/guardrail-id:1"
                         },
                         "selective_content_guarding": {
                             "system": {
                                 "@@assign": "selective"
                             },
                             "messages": {
                                 "@@assign": "comprehensive"
                             }
                         },
                         "model_enforcement": {
                             "included_models": {
                                 "@@assign": ["ALL"]
                             },
                             "excluded_models": {
                                 "@@assign": ["amazon.titan-embed-text-v2:0", "cohere.embed-english-v3"]
                             }
                         }
                     }
                 }
             }
         }
     }

  5. Simpan kebijakan

  6. Lampirkan kebijakan ke target yang Anda inginkan (root organisasi OUs, atau akun individual) dengan menavigasi ke tab Target dan memilih Lampirkan

• Menggunakan API — Gunakan AWS Organizations CreatePolicyAPI dengan tipe kebijakanBEDROCK_POLICY. Gunakan AttachPolicyuntuk melampirkan ke target

Pelajari lebih lanjut: Kebijakan Amazon Bedrock di AWS Organizations

Verifikasi

Periksa apakah kebijakan dilampirkan ke target yang benar di AWS Organizations konsol.

Uji dan verifikasi penegakan

Uji bahwa pagar pembatas diberlakukan pada akun anggota.

Rencanakan konfigurasi pagar pembatas

Tentukan perlindungan Anda

Untuk menentukan perlindungan Anda:

Buat pagar pembatas Anda

Buat pagar pembatas di setiap wilayah tempat Anda ingin menegakkannya.

Melalui Konsol Manajemen AWS

Untuk membuat pagar pembatas menggunakan konsol:

1. Masuk ke Konsol Manajemen AWS dengan identitas IAM yang memiliki izin untuk menggunakan konsol Amazon Bedrock. Kemudian, buka konsol Amazon Bedrock di https://console.aws.amazon.com/bedrock.

2. Di panel navigasi kiri, pilih Guardrails

3. Pilih Buat pagar pembatas

4. Ikuti panduan untuk mengonfigurasi kebijakan yang Anda inginkan (filter konten, topik yang ditolak, filter kata, filter informasi sensitif)

5. Jangan aktifkan kebijakan penalaran otomatis

6. Lengkapi wizard untuk membuat pagar pembatas Anda

Melalui API

Gunakan CreateGuardrail API

Verifikasi

Setelah dibuat, Anda akan melihatnya di daftar pagar pembatas di halaman arahan Guardrails atau mencarinya di daftar pagar pembatas menggunakan nama pagar pembatas

Buat versi pagar pembatas

Buat versi numerik untuk memastikan konfigurasi pagar pembatas tetap tidak berubah dan tidak dapat dimodifikasi oleh akun anggota.

Melalui Konsol Manajemen AWS

Untuk membuat versi pagar pembatas menggunakan konsol:

1. Pilih pagar pembatas yang dibuat pada langkah sebelumnya di halaman Guardrails di konsol Amazon Bedrock

2. Pilih Buat versi

3. Perhatikan pagar pembatas ARN dan nomor versi (misalnya, “1", “2")

Melalui API

Gunakan CreateGuardrailVersion API

Verifikasi

Konfirmasikan bahwa versi telah berhasil dibuat dengan memeriksa daftar versi pada halaman detail Guardrail.

Lampirkan kebijakan berbasis sumber daya (opsional)

Jika Anda ingin berbagi pagar pembatas dengan peran tertentu di akun Anda, lampirkan kebijakan berbasis sumber daya.

Melalui Konsol Manajemen AWS

Untuk melampirkan kebijakan berbasis sumber daya menggunakan konsol:

1. Di konsol Amazon Bedrock Guardrails, pilih pagar pembatas Anda

2. Pilih Tambah untuk menambahkan kebijakan berbasis sumber daya

3. Menambahkan kebijakan yang memberikan bedrock:ApplyGuardrail izin ke peran yang diinginkan

4. Simpan kebijakan

Aktifkan penegakan tingkat akun

Konfigurasikan akun untuk menggunakan pagar pembatas untuk semua pemanggilan Amazon Bedrock. Ini harus dilakukan di setiap wilayah di mana Anda ingin penegakan hukum.

Melalui Konsol Manajemen AWS

Untuk mengaktifkan penegakan tingkat akun menggunakan konsol:

1. Arahkan ke konsol Amazon Bedrock

2. Pilih Guardrails di panel navigasi kiri

3. Di bagian Konfigurasi penegakan tingkat akun, pilih Tambah

4. Pilih pagar pembatas dan versi

5. Konfigurasikan kontrol pelindung konten selektif (opsional).

   • Amazon Bedrock APIs memungkinkan penelepon untuk menandai konten tertentu dalam permintaan input mereka untuk evaluasi pagar pembatas.

   • Kontrol penjagaan konten selektif memungkinkan administrator memutuskan apakah akan menghormati keputusan penandaan yang dibuat oleh pemanggil API.

   • messagesKontrol system dan menentukan bagaimana permintaan sistem dan konten pesan diproses oleh pagar pembatas. Masing-masing menerima salah satu dari nilai berikut:

     • Selektif: Hanya mengevaluasi konten dalam tag konten penjaga.

     • Komprehensif: Evaluasi semua konten, terlepas dari tag konten penjaga.

   • Jika tidak dikonfigurasi, keduanya mengontrol default ke Comprehensive.

6. Kirim konfigurasi

7. Ulangi untuk setiap wilayah di mana Anda ingin penegakan hukum

Melalui API

Gunakan PutEnforcedGuardrailConfiguration API di setiap wilayah tempat Anda ingin menerapkan pagar pembatas

Verifikasi

Anda akan melihat pagar pembatas yang diberlakukan akun di bawah bagian Konfigurasi pagar pembatas yang diberlakukan akun di halaman Guardrails. Anda dapat memanggil ListEnforcedGuardrailsConfigurationAPI untuk memastikan bahwa pagar pembatas yang diberlakukan terdaftar

Uji dan verifikasi penegakan

Uji menggunakan peran di akun Anda

Untuk menguji penegakan hukum dari akun Anda:

1. Membuat panggilan inferensi Amazon Bedrock menggunakanInvokeModel,,Converse, InvokeModelWithResponseStream atau ConverseStream

2. Pagar pembatas yang diberlakukan akun harus secara otomatis berlaku untuk input dan output

3. Periksa respons untuk informasi penilaian pagar pembatas. Respons pagar pembatas akan mencakup informasi pagar pembatas yang diberlakukan.