

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Menerapkan ekstensi browser Connect Customer
<a name="deploy-browser-extension"></a>

Ekstensi browser Connect Customer melaporkan URL setiap jendela browser ke Aplikasi Connect Customer Klien sehingga aturan URL yang dikonfigurasi di blok aliran Anda dapat dievaluasi. Tanpa ekstensi, URL tidak dilaporkan dan aturan URL tidak dapat cocok, sehingga halaman browser yang harus disunting oleh URL dapat muncul dalam rekaman. Aturan judul jendela tidak bergantung pada ekstensi; mereka cocok dengan judul jendela asli dan bekerja tanpa ekstensi diinstal.

Jika salah satu blok aliran Anda menggunakan aturan URL, instal ekstensi di setiap browser yang digunakan agen selama kontak yang direkam. Ekstensi didistribusikan oleh AWS dan diinstal pada workstation agen melalui kebijakan ekstensi perusahaan browser Anda. Itu tidak dipublikasikan ke Toko Web Chrome atau Firefox Add-ons.

Untuk ikhtisar redaksi berbasis aturan, lihat. [Rule-based redaksi untuk rekaman layar](rule-based-redaction-screen-recording.md)

**Topics**
+ [Peramban yang didukung](#extension-supported-browsers)
+ [Prasyarat](#extension-prerequisites)
+ [Pengidentifikasi ekstensi dan URL pembaruan](#extension-identifiers)
+ [Menyebarkan ekstensi melalui kebijakan perusahaan](#extension-deploy-policy)
+ [Contoh: Menyebarkan ekstensi ke daftar pengguna dengan menggunakan GPO](#extension-gpo-example)
+ [Verifikasi ekstensi diinstal](#extension-verify)
+ [Hapus ekstensi](#extension-remove)
+ [Apa yang terjadi jika ekstensi dinonaktifkan selama kontak](#extension-disabled-during-contact)

## Peramban yang didukung
<a name="extension-supported-browsers"></a>

Rule-based redaksi mendukung browser berikut. Gunakan kombinasi browser ini di workstation agen.


| Peramban | Versi minimum | 
| --- | --- | 
| Google Chrome | 120 | 
| Microsoft Edge (Chromium-based) | 120 | 
| Mozilla Firefox | 120 | 

Browser selain Chrome, Edge, dan Firefox tidak melaporkan URL ke Aplikasi Connect Customer Klien, sehingga aturan URL tidak dapat cocok dengan halaman di browser tersebut. Anda masih dapat menutupi jendela di browser tersebut dengan menambahkan aturan judul jendela ke blok aliran Anda.

## Prasyarat
<a name="extension-prerequisites"></a>
+ Browser dan versi yang didukung dari tabel sebelumnya.
+ Connect Customer Aplikasi Klien versi 3.0.2 atau yang lebih baru. Lihat [Connect Customer Aplikasi Klien](amazon-connect-client-app.md).
+ (Opsional) Alat penyebaran perusahaan yang dapat mendorong kebijakan ekstensi browser ke pengguna tertentu, seperti Microsoft Group Policy Preferences (User Configuration), Microsoft Intune, Jamf Pro, atau Google Chrome Browser Cloud Management. Ekstensi ini digunakan di lingkup pengguna.
+ Akses HTTPS keluar dari setiap stasiun kerja agen ke URL pembaruan ekstensi yang tercantum di bagian berikutnya.

## Pengidentifikasi ekstensi dan URL pembaruan
<a name="extension-identifiers"></a>

Gunakan nilai berikut saat mengonfigurasi kebijakan ekstensi browser perusahaan.

**catatan**  
Sebagai prasyarat, tambahkan URL hosting ekstensi yang sesuai ke daftar izin firewall Anda, tergantung pada browser mana yang digunakan agen Anda. Untuk daftar izin firewall, lihat[Persyaratan jaringan](sr-system-req.md#network-requirements).


| Peramban | ID Ekstensi | Perbarui URL | 
| --- | --- | --- | 
| Google Chrome dan Microsoft Edge | cjmichfmnimgeoadokmeaiclklkdccod | https://screenrecording.connect.aws/chromeos/amazon-connect-extension/releases/updates.xml | 
| Mozilla Firefox | amazon\_connect\_extension@amazon.com | https://screenrecording.connect.aws/firefox/amazon-connect-extension/releases/amazon-connect-extension.xpi | 

## Menyebarkan ekstensi melalui kebijakan perusahaan
<a name="extension-deploy-policy"></a>

Ekstensi browser Connect Customer digunakan di lingkup pengguna. Ini memungkinkan Anda menargetkan ekstensi ke pengguna atau grup tertentu yang menangani kontak yang direkam, tanpa mengubah pengaturan per mesin pada workstation agen.

Gunakan alat kebijakan perusahaan apa pun yang dapat mendorong pengaturan ekstensi browser per pengguna. Opsi umum meliputi:
+ Preferensi Kebijakan Grup Microsoft, dicakup ke **Konfigurasi Pengguna** dan disaring ke grup keamanan pengguna agen.
+ Microsoft Intune, ditargetkan ke grup Entra ID pengguna agen melalui profil konfigurasi yang ditetapkan pengguna.
+ Jamf Pro atau MDM lain yang mendukung profil konfigurasi per pengguna.
+ Google Chrome Browser Cloud Management, mencakup unit organisasi pengguna agen.

Untuk informasi umum tentang kebijakan browser, lihat:
+ [Daftar kebijakan Chrome Enterprise](https://chromeenterprise.google/policies/)
+ [Dokumentasi kebijakan perusahaan Microsoft Edge](https://learn.microsoft.com/deployedge/)
+ [Kebijakan Enterprise untuk Firefox](https://support.mozilla.org/kb/customizing-firefox-using-policiesjson)

### Payload kebijakan
<a name="extension-policy-payload"></a>

Konfigurasikan **ExtensionSettings**kebijakan untuk setiap browser dengan properti berikut.

**Google Chrome dan Microsoft Edge**

```
{
  "cjmichfmnimgeoadokmeaiclklkdccod": {
    "installation_mode": "force_installed",
    "update_url": "https://screenrecording.connect.aws/chromeos/amazon-connect-extension/releases/updates.xml"
  }
}
```

**Mozilla Firefox**

```
{
  "amazon_connect_extension@amazon.com": {
    "installation_mode": "force_installed",
    "install_url": "https://screenrecording.connect.aws/firefox/amazon-connect-extension/releases/amazon-connect-extension.xpi"
  }
}
```

### Contoh registri lingkup pengguna Windows
<a name="extension-registry-example"></a>

Jika Anda menerapkan kebijakan melalui registri Windows di bawah **Konfigurasi Pengguna**, buat nilai string di bawah jalur kebijakan per pengguna untuk setiap browser. Pola yang sama berlaku untuk Chrome, Edge, dan Firefox.


| Peramban | Jalur registri (di bawah HKEY\_CURRENT\_USER) | 
| --- | --- | 
| Google Chrome | HKCU\\SOFTWARE\\Policies\\Google\\Chrome\\ExtensionSettings\\cjmichfmnimgeoadokmeaiclklkdccod | 
| Microsoft Edge | HKCU\\SOFTWARE\\Policies\\Microsoft\\Edge\\ExtensionSettings\\cjmichfmnimgeoadokmeaiclklkdccod | 
| Mozilla Firefox | HKCU\\SOFTWARE\\Policies\\Mozilla\\Firefox\\ExtensionSettings\\amazon\_connect\_extension@amazon.com | 

Buat nilai string berikut di bawah setiap tombol.


| Peramban | Nama nilai | Data nilai | 
| --- | --- | --- | 
| Chrome atau Edge | installation\_mode | force\_installed | 
| Chrome atau Edge | update\_url | https://screenrecording.connect.aws/chromeos/amazon-connect-extension/releases/updates.xml | 
| Firefox | installation\_mode | force\_installed | 
| Firefox | install\_url | https://screenrecording.connect.aws/firefox/amazon-connect-extension/releases/amazon-connect-extension.xpi | 

Semua nilai menggunakan `REG_SZ` tipe.

## Contoh: Menyebarkan ekstensi ke daftar pengguna dengan menggunakan GPO
<a name="extension-gpo-example"></a>

### Langkah 1: Buat kebijakan khusus
<a name="extension-gpo-step1"></a>

**catatan**  
Kami menyarankan Anda membuat GPO baru yang terpisah daripada mengedit kebijakan domain utama Anda. Ini memungkinkan Anda untuk menautkan atau memutuskan tautan ekstensi Connect Customer dengan aman.
+ **Manajemen Kebijakan Grup** Terbuka (`gpmc.msc`).
+ Right-click **Objek Kebijakan Grup** dan pilih **Baru**. Untuk nama, masukkan `PII-AmazonConnect` (atau serupa).  
![Membuat Objek Kebijakan Grup baru.](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/deploy-browser-extension-gpo-new.png)
+ Tetapkan penargetan (cakupan):
  + Pilih GPO baru.
  + Di tab **Lingkup**, di bawah **Penyaringan Keamanan**, hapus Pengguna yang **Diautentikasi.**
  + Pilih **Tambah** dan pilih grup keamanan yang berisi komputer agen target Anda.  
![Pemfilteran keamanan pada tab Lingkup.](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/deploy-browser-extension-gpo-scope.png)
+ Verifikasi bahwa pemfilteran keamanan hanya berisi mesin yang ingin Anda instal ekstensi.  
![Memverifikasi pemfilteran keamanan.](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/deploy-browser-extension-gpo-verify.png)

### Langkah 2: Konfigurasikan injeksi registri
<a name="extension-gpo-step2"></a>

Langkah ini membuat kunci registri spesifik yang dibaca browser untuk menginstal ekstensi.
+ Right-click GPO baru Anda dan pilih **Edit**.
+ Arahkan ke jalur berikut: **Konfigurasi Pengguna**, **Preferensi**, **Pengaturan Windows**, **Registri**.
+ Right-click di ruang kosong di sebelah kanan dan pilih **New**, **Registry Item**.  
![Membuat item registri baru.](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/deploy-browser-extension-gpo-new-registry-item.png)
+ Konfigurasikan properti seperti yang ditunjukkan pada tabel berikut.

Nilai-nilai berikut ini umum untuk ketiga browser.


| Properti | Nilai | 
| --- | --- | 
| Tindakan | Perbarui | 
| Hive | HKEY\_CURRENT\_USER | 
| Tipe nilai | REG\_SZ | 

Untuk setiap browser, gunakan jalur kunci berikut dan dua nilai yang dibutuhkannya.

**Google Chrome** - jalur utama `SOFTWARE\Policies\Google\Chrome\ExtensionSettings\cjmichfmnimgeoadokmeaiclklkdccod`


| Nama nilai | Data nilai | 
| --- | --- | 
| installation\_mode | force\_installed | 
| update\_url | https://screenrecording.connect.aws/chromeos/amazon-connect-extension/releases/updates.xml | 

**Microsoft Edge** — jalur kunci `SOFTWARE\Policies\Microsoft\Edge\ExtensionSettings\cjmichfmnimgeoadokmeaiclklkdccod`


| Nama nilai | Data nilai | 
| --- | --- | 
| installation\_mode | force\_installed | 
| update\_url | https://screenrecording.connect.aws/chromeos/amazon-connect-extension/releases/updates.xml | 

**Mozilla Firefox** — jalur kunci `SOFTWARE\Policies\Mozilla\Firefox\ExtensionSettings\amazon_connect_extension@amazon.com`


| Nama nilai | Data nilai | 
| --- | --- | 
| installation\_mode | force\_installed | 
| install\_url | https://screenrecording.connect.aws/firefox/amazon-connect-extension/releases/amazon-connect-extension.xpi | 

![Properti item registri.](http://docs.aws.amazon.com/id_id/connect/latest/adminguide/images/deploy-browser-extension-gpo-registry-properties.png)


## Verifikasi ekstensi diinstal
<a name="extension-verify"></a>

Setelah Anda menerapkan ekstensi, verifikasi pada workstation pengujian bahwa ekstensi diinstal, diaktifkan, dan menjalankan versi yang diharapkan sebelum Anda meluncurkannya secara luas.

**Chrome atau Microsoft Edge**
+ Buka `chrome://extensions` (Chrome) atau `edge://extensions` (Edge).
+ Konfirmasikan bahwa **Amazon Connect Client** muncul dalam daftar dan diaktifkan.
+ Konfirmasikan bahwa versinya 2.1.0 atau yang lebih baru.
+ Buka `chrome://policy` atau`edge://policy`, pilih **Muat ulang kebijakan**, dan konfirmasikan yang `ExtensionSettings` berisi ID ekstensi Connect Customer dengan status **OK**.

**Firefox**
+ Buka `about:addons`. Konfirmasikan bahwa **Klien Amazon Connect** muncul di bawah **Ekstensi** dan diaktifkan.
+ Konfirmasikan bahwa versinya 2.1.0 atau yang lebih baru.
+ Buka `about:policies`. Pada tab **Aktif**, konfirmasikan yang `ExtensionSettings` berisi ID ekstensi Connect Customer.

Jika salah satu dari pemeriksaan ini gagal, lihat[Unduh file log untuk aplikasi perekaman layar](troubleshoot-sr.md).

## Hapus ekstensi
<a name="extension-remove"></a>

Untuk berhenti menggunakan ekstensi browser Connect Customer di workstation agen, misalnya di akhir pilot atau saat pengguna mengubah peran, hapus ekstensi dengan membalikkan kebijakan penerapan. Anda memiliki dua opsi.

### Opsi 1: Hapus pengguna dari grup target
<a name="extension-remove-option1"></a>

Hapus pengguna agen dari grup keamanan atau grup ID Entra yang menjadi target kebijakan ekstensi Anda. Saat penyegaran kebijakan berikutnya berjalan, ekstensi akan dihapus dari browser pengguna tersebut. Pengguna yang tetap berada di grup terus menerima ekstensi.

Ini adalah pendekatan yang direkomendasikan untuk perubahan siklus hidup rutin seperti penggantian peran.

### Opsi 2: Blokir ekstensi
<a name="extension-remove-option2"></a>

Untuk mencegah ekstensi dipasang atau digunakan secara aktif, ubah payload kebijakan `installation_mode` dari `force_installed` ke`blocked`. Browser mencopot pemasangan ekstensi pada penyegaran kebijakan berikutnya dan mencegah penginstalan di masa mendatang.

**Google Chrome dan Microsoft Edge**

```
{
  "cjmichfmnimgeoadokmeaiclklkdccod": {
    "installation_mode": "blocked"
  }
}
```

**Mozilla Firefox**

```
{
  "amazon_connect_extension@amazon.com": {
    "installation_mode": "blocked"
  }
}
```

Jika Anda menyebarkan melalui registri Windows, ubah `installation_mode` nilai dari `force_installed` ke `blocked` di bawah jalur registri lingkup pengguna yang tercantum di. [Contoh registri lingkup pengguna Windows](#extension-registry-example) Anda dapat meninggalkan nilai-nilai lain di tempat; `blocked` diutamakan.

### Efek pada rekaman setelah dihapus
<a name="extension-remove-effect"></a>

Setelah ekstensi dihapus atau diblokir, kontak yang ditangani oleh agen tersebut direkam tanpa redaksi diterapkan. Catatan kontak menandai rekaman ini sebagai tidak disunting. Jika redaksi berbasis aturan diperlukan untuk kepatuhan, rute kontak hanya ke agen yang profil keamanan dan browsernya masih memiliki ekstensi yang digunakan.

## Apa yang terjadi jika ekstensi dinonaktifkan selama kontak
<a name="extension-disabled-during-contact"></a>

Jika ekstensi dihapus atau dinonaktifkan saat kontak yang direkam aktif, URL browser berhenti dilaporkan ke Aplikasi Connect Customer Klien selama sisa kontak. Aturan URL tidak dapat lagi cocok, dan halaman browser yang harus disunting oleh URL dapat muncul dalam rekaman. Aturan judul jendela terus cocok seperti biasa.

Untuk memulihkan redaksi untuk kontak baru, instal ulang atau aktifkan kembali ekstensi sebelum kontak berikutnya dimulai.