Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Mengkonfigurasi firewall, server proxy, atau perimeter data untuk Pengembang Amazon Q
Jika Anda menggunakan firewall, server proxy, atau [perimeter data](https://aws.amazon.com/identity/data-perimeters-on-aws/), pastikan untuk mengizinkan lalu lintas ke yang berikut URLs dan Nama Sumber Daya Amazon (ARNs) sehingga Amazon Q berfungsi seperti yang diharapkan.
## Umum URLs ke daftar yang diizinkan
Berikut ini URLs, ganti:
+ *idc-directory-id-or-alias*dengan ID direktori atau alias instans IAM Identity Center Anda. Untuk informasi selengkapnya tentang Pusat Identitas IAM, lihat [Apa itu Pusat Identitas IAM?](https://docs.aws.amazon.com/singlesignon/latest/userguide/what-is.html) dalam *AWS IAM Identity Center User Guide*.
+ *sso-region*dengan AWS Wilayah tempat instans Pusat Identitas IAM Anda diaktifkan. Untuk informasi selengkapnya, lihat [Wilayah Pusat Identitas IAM didukung oleh Pengembang Amazon Q](q-admin-setup-subscribe-regions.md#pro-subscription-regions).
+ *profile-region*dengan AWS Wilayah tempat profil Pengembang Amazon Q Anda diinstal. Untuk informasi selengkapnya tentang profil Pengembang Amazon Q, lihat [Apa profil Pengembang Amazon Q?](subscribe-understanding-profile.md) dan[Wilayah yang Didukung untuk konsol Q Developer dan profil Pengembang Q](q-admin-setup-subscribe-regions.md#qdev-console-and-profile-regions).
| URL | Tujuan |
| --- | --- |
| `idc-directory-id-or-alias.awsapps.com ` | Autentikasi |
| `oidc.sso-region.amazonaws.com` | Autentikasi |
| `*.sso.sso-region.amazonaws.com` | Autentikasi |
| `*.sso-portal.sso-region.amazonaws.com` | Autentikasi |
| `*.aws.dev` | Autentikasi |
| `*.awsstatic.com` | Autentikasi |
| `*.console.aws.a2z.com` | Autentikasi |
| `*.sso.amazonaws.com` | Autentikasi |
| `https://codewhisperer.us-east-1.amazonaws.com` | Fitur Pengembang Amazon Q |
| `https://q.profile-region.amazonaws.com` | Fitur Pengembang Amazon Q |
| `https://idetoolkits-hostedfiles.amazonaws.com/*` | Pengembang Amazon Q di IDE, konfigurasi |
| `https://idetoolkits.amazonwebservices.com/*` | Pengembang Amazon Q di IDE, titik akhir |
| `q-developer-integration.us-east-1.api.aws` | Pengembang Amazon Q di IDE, titik akhir |
| `https://aws-toolkit-language-servers.amazonaws.com/*` | Pengembang Amazon Q di IDE, pemrosesan bahasa |
| `https://aws-language-servers.us-east-1.amazonaws.com/*` | Pengembang Amazon Q di IDE, pemrosesan bahasa |
| `https://client-telemetry.us-east-1.amazonaws.com` | Pengembang Amazon Q di IDE, telemetri |
| `cognito-identity.us-east-1.amazonaws.com` | Pengembang Amazon Q di IDE, telemetri |
## Bucket Amazon S3 URLs dan ARNs daftar yang diizinkan
Untuk beberapa fitur, Amazon Q mengunggah artefak ke bucket AWS Amazon S3 milik layanan. Jika Anda menggunakan perimeter data untuk mengontrol akses ke Amazon S3 di lingkungan Anda, Anda mungkin perlu secara eksplisit mengizinkan akses ke bucket ini untuk menggunakan fitur Amazon Q yang sesuai.
Tabel berikut mencantumkan URL dan ARN dari masing-masing bucket Amazon S3 yang memerlukan akses Amazon Q, dan fitur yang menggunakan setiap bucket. Anda dapat menggunakan URL bucket atau bucket ARN untuk mengizinkan daftar bucket ini, tergantung pada cara Anda mengontrol akses ke Amazon S3.
Anda hanya perlu mengizinkan daftar bucket di AWS Wilayah tempat profil Pengembang Amazon Q diinstal. Untuk informasi selengkapnya tentang profil Pengembang Amazon Q, lihat[Apa profil Pengembang Amazon Q?](subscribe-understanding-profile.md).
| URL bucket Amazon S3 dan ARN | Tujuan |
| --- | --- |
| AS Timur (Virginia N.): [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/amazonq/latest/qdeveloper-ug/firewall.html) Eropa (Frankfurt): [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/amazonq/latest/qdeveloper-ug/firewall.html) | Bucket Amazon S3 yang digunakan untuk mengunggah artefak untuk ulasan kode Q [Amazon](code-reviews.md) |
| AS Timur (Virginia N.): [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/amazonq/latest/qdeveloper-ug/firewall.html) Eropa (Frankfurt): [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/amazonq/latest/qdeveloper-ug/firewall.html) | Bucket Amazon S3 digunakan untuk mengunggah artefak untuk transformasi kode Q [Amazon](code-transformation.md) |
## Mengkonfigurasi proxy perusahaan di Amazon Q
Jika pengguna akhir Anda bekerja di belakang proxy perusahaan, minta mereka menyelesaikan langkah-langkah berikut agar berhasil terhubung ke Amazon Q.
### Langkah 1: Mengkonfigurasi pengaturan proxy di IDE Anda
Tentukan URL server proxy Anda di IDE Anda.
**catatan**
Proksi SOCKS dan file Konfigurasi Otomatis Proksi (PAC) tidak didukung. Anda harus mengonfigurasi proxy HTTP atau HTTPS secara manual menggunakan instruksi yang mengikuti.
------
#### [ Gerhana ]
1. DiEclipse, buka **Preferensi** sebagai berikut:
+ Di Windows atau Ubuntu:
+ Dari bilah Eclipse menu, pilih **Jendela**, lalu pilih **Preferensi**.
+ Di macOS:
+ Dari bilah menu, pilih **Eclipse**, lalu pilih **Pengaturan** atau **Preferensi** tergantung pada versi macOS Anda.
1. Di bilah pencarian, masukkan **Amazon Q** dan buka Amazon Q.
1. Di bawah **Pengaturan Proxy**, setel **URL Proxy HTTPS** ke URL proxy perusahaan Anda.
Contoh:`http://proxy.company.com:8080`, `https://proxy.company.com:8443`
1. Biarkan pengaturan Amazon Q terbuka dan lanjutkan ke langkah berikutnya.
------
#### [ JetBrains ]
Di JetBrains, konfigurasikan nama host dan port server proxy Anda secara manual mengikuti panduan dalam topik [Proxy HTTP](https://www.jetbrains.com/help/idea/settings-http-proxy.html) dari dokumentasi IntelliJ IDEA.
------
#### [ Visual Studio ]
1. Dari menu utama Visual Studio, pilih **Tools**, lalu pilih **Options**.
1. Dari menu **Opsi**, perluas **AWS Toolkit**, lalu pilih **Proxy**.
1. Dari menu **Proxy**, atur **Host** dan **Port** ke host dan port proxy perusahaan Anda.
Contoh:`http://proxy.company.com:8080`, `https://proxy.company.com:8443`
------
#### [ Kode Studio Visual ]
1. Dari VS Code, buka **Pengaturan** Kode VS dengan menekan **CMD \$1 ,** (Mac) atau **Ctrl \$1 ,** (Windows/Linux).
1. Dari bilah pencarian **Pengaturan**, masukkan**Http: Proxy**, lalu temukan di hasil pencarian.
1. Masukkan URL proxy perusahaan Anda.
Contoh:`http://proxy.company.com:8080`, `https://proxy.company.com:8443`
1. (Opsional) di bilah pencarian **Pengaturan****HTTP: No Proxy**, masukkan, lalu temukan di hasil.
1. Pilih tombol **Tambah Item**, lalu tambahkan domain yang melewati proxy, dipisahkan dengan koma.
------
### Langkah 2: Mengkonfigurasi penanganan sertifikat SSL
Amazon Q secara otomatis mendeteksi dan menggunakan sertifikat tepercaya yang diinstal pada sistem Anda. Jika Anda mengalami kesalahan sertifikat, Anda harus menentukan bundel sertifikat secara manual dengan menyelesaikan prosedur berikut.
**catatan**
Berikut ini adalah situasi di mana konfigurasi manual diperlukan.
Anda mengalami kesalahan terkait sertifikat setelah mengonfigurasi proxy.
Proxy perusahaan Anda menggunakan sertifikat yang tidak ada di toko kepercayaan sistem Anda.
Amazon Q gagal mendeteksi sertifikat perusahaan Anda secara otomatis.
------
#### [ Gerhana ]
+ Di setelan Amazon Q diEclipse, di bawah **Pengaturan Proxy**, setel **PEM Sertifikat CA** ke jalur file sertifikat perusahaan Anda. File harus memiliki ekstensi file `.pem`. (Anda tidak dapat menggunakan `.crt` file.)
Contoh jalur menyerupai berikut ini:
`/path/to/corporate-ca-bundle.pem`
Untuk petunjuk cara mendapatkan file ini, lihat [Mendapatkan sertifikat perusahaan Anda](#proxy-get-corp-ca-cert).
------
#### [ JetBrains ]
Di JetBrains, instal sertifikat perusahaan Anda secara manual mengikuti panduan dalam topik [sertifikat akar tepercaya](https://www.jetbrains.com/help/idea/ssl-certificates.html#manual_configuration) dari dokumentasi IntelliJ IDEA.
Untuk petunjuk tentang mendapatkan sertifikat, lihat [Mendapatkan sertifikat perusahaan Anda](#proxy-get-corp-ca-cert).
------
#### [ Visual Studio ]
+ Konfigurasikan Variabel Lingkungan Windows berikut:
+ `NODE_OPTIONS = --use-openssl-ca`
+ `NODE_EXTRA_CA_CERTS = cert-path`
Ganti *cert-path* dengan jalur file sertifikat perusahaan Anda. File harus memiliki ekstensi file `.pem`. (Anda tidak dapat menggunakan `.crt` file.)
Contoh jalur menyerupai berikut ini:
`/path/to/corporate-ca-bundle.pem`
Untuk petunjuk tentang mendapatkan file sertifikat perusahaan, lihat[Mendapatkan sertifikat perusahaan Anda](#proxy-get-corp-ca-cert). Untuk informasi rinci tentang Variabel Lingkungan Windows, lihat [dokumentasi Node.js](https://nodejs.org/api/cli.html#cli_node_extra_ca_certs_file).
------
#### [ Kode Studio Visual ]
1. Dari VS Code, buka **Pengaturan** Kode VS dengan menekan **CMD \$1 ,** (Mac) atau **Ctrl \$1 ,** (Windows/Linux).
1. Dari bilah pencarian **Pengaturan**, masukkan**Amazon Q › Proxy: Certificate Authority**, lalu temukan di hasil pencarian.
1. Masukkan jalur file sertifikat perusahaan Anda. Ini akan memiliki ekstensi `.crt` file `.pem` atau.
Contoh jalur menyerupai berikut ini:
`/path/to/corporate-ca-bundle.pem`
Untuk petunjuk tentang mendapatkan file ini, lihat[Mendapatkan sertifikat perusahaan Anda](#proxy-get-corp-ca-cert).
------
### Langkah 3: Mulai ulang IDE Anda
Anda harus memulai ulang IDE Anda untuk memperbarui Amazon Q dengan perubahan Anda.
### Pemecahan masalah
Jika Anda menyelesaikan prosedur di bagian sebelumnya dan Anda masih mengalami masalah, gunakan instruksi berikut untuk memecahkan masalah.
------
#### [ Gerhana ]
1. Pastikan format URL proxy Anda menyertakan `http://` atau`https://`.
1. Pastikan jalur file sertifikat Anda benar dan dapat diakses.
1. Tinjau log Amazon Q Anda di Log Eclipse Kesalahan. Untuk menavigasi ke Log Kesalahan, lakukan salah satu hal berikut:
+ **Masuk ke Amazon Q inEclipse, pilih panah bawah di sebelah ikon Q di kanan atas, lalu pilih **Bantuan**, Lihat Log.**
+ Dari Eclipse menu, pilih **Window**, **Show View**, **Error Log**.
**catatan**
Jika Anda menemukan pesan galat berikut:
`unable to verify the first certificate`, pastikan Anda mengikuti instruksi [Langkah 2: Mengkonfigurasi penanganan sertifikat SSL](#proxy-configure-ssl-cert) untuk menentukan sertifikat secara manual.
`self signed certificate`, pastikan Anda mengikuti instruksi [Langkah 2: Mengkonfigurasi penanganan sertifikat SSL](#proxy-configure-ssl-cert) untuk menentukan sertifikat secara manual.
`ECONNREFUSED`, periksa koneksi internet dan informasi proxy Anda.
------
#### [ JetBrains ]
1. Pastikan format URL proxy Anda menyertakan `http://` atau`https://`.
1. Pastikan jalur file sertifikat Anda benar dan dapat diakses.
1. Tinjau log Amazon Q Anda di file JetBrains log. Untuk bantuan dalam menemukan file log, lihat [Menemukan file log IDE](https://intellij-support.jetbrains.com/hc/en-us/articles/207241085-Locating-IDE-log-files) di halaman JetBrains IDEs Support.
**catatan**
Jika Anda menemukan pesan galat berikut:
`unable to verify the first certificate`, pastikan Anda mengikuti instruksi [Langkah 2: Mengkonfigurasi penanganan sertifikat SSL](#proxy-configure-ssl-cert) untuk menentukan sertifikat secara manual.
`self signed certificate`, pastikan Anda mengikuti instruksi [Langkah 2: Mengkonfigurasi penanganan sertifikat SSL](#proxy-configure-ssl-cert) untuk menentukan sertifikat secara manual.
`ECONNREFUSED`, periksa koneksi internet dan informasi proxy Anda.
------
#### [ Visual Studio ]
1. Pastikan format URL proxy Anda menyertakan `http://` atau`https://`.
1. Pastikan jalur file sertifikat Anda benar dan dapat diakses.
1. Tinjau log ekstensi AWS Toolkit sebagai berikut:
+ Dari menu utama Visual Studio, perluas **Ekstensi**.
+ Pilih **AWS Toolkit** untuk memperluas menu AWS Toolkit, lalu pilih **View Toolkit** Logs.
+ Saat folder log AWS Toolkit terbuka di Sistem Operasi Anda, urutkan file berdasarkan tanggal dan temukan file log apa pun yang berisi informasi yang relevan dengan masalah Anda saat ini.
1. Tinjau log Amazon Q Anda di Log Aktivitas Visual Studio. Untuk informasi selengkapnya, lihat [Mengatasi Masalah Ekstensi dengan Log Aktivitas](https://devblogs.microsoft.com/visualstudio/troubleshooting-extensions-with-the-activity-log/).
**catatan**
Jika Anda menemukan pesan galat berikut:
`unable to verify the first certificate`, pastikan Anda mengikuti instruksi [Langkah 2: Mengkonfigurasi penanganan sertifikat SSL](#proxy-configure-ssl-cert) untuk menentukan sertifikat secara manual.
`self signed certificate`, pastikan Anda mengikuti instruksi [Langkah 2: Mengkonfigurasi penanganan sertifikat SSL](#proxy-configure-ssl-cert) untuk menentukan sertifikat secara manual.
`ECONNREFUSED`, periksa koneksi internet dan informasi proxy Anda.
------
#### [ Kode Studio Visual ]
1. Pastikan format URL proxy Anda menyertakan `http://` atau`https://`.
1. Pastikan jalur file sertifikat Anda benar dan dapat diakses.
1. Tinjau log Amazon Q Anda di **panel Output** VS Code.
**catatan**
Jika Anda menemukan pesan galat berikut:
`unable to verify the first certificate`, pastikan Anda mengikuti instruksi [Langkah 2: Mengkonfigurasi penanganan sertifikat SSL](#proxy-configure-ssl-cert) untuk menentukan sertifikat secara manual.
`self signed certificate`, pastikan Anda mengikuti instruksi [Langkah 2: Mengkonfigurasi penanganan sertifikat SSL](#proxy-configure-ssl-cert) untuk menentukan sertifikat secara manual.
`ECONNREFUSED`, periksa koneksi internet dan informasi proxy Anda.
------
#### Mendapatkan sertifikat perusahaan Anda
Untuk mendapatkan sertifikat perusahaan Anda, tanyakan kepada tim TI Anda untuk informasi berikut:
+ Bundel sertifikat perusahaan Anda, yang biasanya berupa `.crt` file `.pem` atau.
+ Detail server proxy Anda, termasuk nama host, port, dan metode otentikasi Anda.
Atau, ekspor sertifikat dari browser Anda:
1. Kunjungi situs HTTPS apa pun di domain perusahaan Anda.
1. Di dekat bilah alamat, pilih ikon kunci atau ikon serupa. (Ikon berbeda tergantung vendor browser Anda.)
1. Ekspor sertifikat root ke file. Pastikan Anda menyertakan seluruh rantai sertifikat. Langkah-langkah untuk mengekspor sertifikat root akan sedikit berbeda tergantung pada browser yang Anda gunakan. Konsultasikan dokumentasi browser Anda untuk langkah-langkah terperinci.