

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Implementa l'estensione del browser Connect Customer
<a name="deploy-browser-extension"></a>

L'estensione del browser Connect Customer riporta l'URL di ogni finestra del browser all'applicazione Connect Customer client in modo che le regole URL configurate nel blocco di flusso possano essere valutate. Senza l'estensione, gli URL non vengono segnalati e le regole URL non possono corrispondere, pertanto nella registrazione potrebbero apparire pagine del browser che dovrebbero essere oscurate dall'URL. Le regole relative ai titoli delle finestre non dipendono dall'estensione; corrispondono ai titoli delle finestre native e funzionano senza l'estensione installata.

Se uno dei tuoi blocchi di flusso utilizza le regole URL, installa l'estensione su tutti i browser utilizzati dagli agenti durante i contatti registrati. L'estensione viene distribuita AWS e installata sulle workstation degli agenti tramite la politica di estensione aziendale del browser. Non è pubblicata su Chrome Web Store o Firefox Add-ons.

Per una panoramica della redazione basata su regole, vedi. [Rule-based redazione per le registrazioni delle schermate](rule-based-redaction-screen-recording.md)

**Topics**
+ [Browser supportati](#extension-supported-browsers)
+ [Prerequisiti](#extension-prerequisites)
+ [Identificatori di estensione e URL di aggiornamento](#extension-identifiers)
+ [Implementa l'estensione tramite policy aziendali](#extension-deploy-policy)
+ [Esempio: distribuzione delle estensioni a un elenco di utenti utilizzando GPO](#extension-gpo-example)
+ [Verifica che l'estensione sia installata](#extension-verify)
+ [Rimuovi l'estensione](#extension-remove)
+ [Cosa succede se l'estensione viene disabilitata durante un contatto](#extension-disabled-during-contact)

## Browser supportati
<a name="extension-supported-browsers"></a>

Rule-based redaction supporta i seguenti browser. Utilizza qualsiasi combinazione di questi browser sulle workstation degli agenti.


| Browser | Versione minima | 
| --- | --- | 
| Google Chrome | 120 | 
| Microsoft Edge (Chromium-based) | 120 | 
| Mozilla Firefox | 120 | 

I browser diversi da Chrome, Edge e Firefox non segnalano gli URL all'applicazione Connect Customer client, pertanto le regole degli URL non possono corrispondere alle pagine di tali browser. Puoi comunque nascondere le finestre in questi browser aggiungendo le regole del titolo delle finestre al tuo blocco di flusso.

## Prerequisiti
<a name="extension-prerequisites"></a>
+ Browser e versione supportati dalla tabella precedente.
+ Connect Customer Applicazione client versione 3.0.2 o successiva. Per informazioni, consulta [Connect Customer Applicazione client](amazon-connect-client-app.md).
+ (Facoltativo) Uno strumento di distribuzione aziendale in grado di inviare i criteri di estensione del browser a utenti specifici, come Microsoft Group Policy Preferences (configurazione utente), Microsoft Intune, Jamf Pro o Google Chrome Browser Cloud Management. L'estensione viene distribuita a livello di utente.
+ Accesso HTTPS in uscita da ogni workstation agente all'URL di aggiornamento dell'estensione elencato nella sezione successiva.

## Identificatori di estensione e URL di aggiornamento
<a name="extension-identifiers"></a>

Utilizza i seguenti valori quando configuri la politica di estensione del browser aziendale.

**Nota**  
Come prerequisito, aggiungete gli URL che ospitano le estensioni appropriate all'elenco degli indirizzi consentiti dal firewall, a seconda dei browser utilizzati dagli agenti. Per l'elenco dei firewall consentiti, vedere. [Requisiti di rete](sr-system-req.md#network-requirements)


| Browser | ID dell'estensione | Aggiorna URL | 
| --- | --- | --- | 
| Google Chrome e 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 | 

## Implementa l'estensione tramite policy aziendali
<a name="extension-deploy-policy"></a>

L'estensione del browser Connect Customer viene distribuita nell'ambito dell'utente. Ciò consente di indirizzare l'estensione a utenti o gruppi specifici che gestiscono i contatti registrati, senza modificare le impostazioni per computer sulle workstation degli agenti.

Utilizza qualsiasi strumento di policy aziendale in grado di inviare le impostazioni delle estensioni del browser per utente. Le opzioni più comuni includono:
+ Preferenze dei criteri di gruppo Microsoft, limitate alla **configurazione utente** e filtrate in base a un gruppo di sicurezza di utenti agente.
+ Microsoft Intune, destinato a un gruppo Entra ID di utenti agente tramite un profilo di configurazione assegnato dall'utente.
+ Jamf Pro o un altro MDM che supporta i profili di configurazione per utente.
+ Google Chrome Browser Cloud Management, destinato a un'unità organizzativa di utenti agenti.

Per informazioni generali sulle politiche del browser, consulta:
+ [Elenco delle politiche di Chrome Enterprise](https://chromeenterprise.google/policies/)
+ [Documentazione sulla politica aziendale di Microsoft Edge](https://learn.microsoft.com/deployedge/)
+ [Politiche aziendali per Firefox](https://support.mozilla.org/kb/customizing-firefox-using-policiesjson)

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

Configura la **ExtensionSettings**politica per ogni browser con le seguenti proprietà.

**Google Chrome e 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"
  }
}
```

### Esempio di registro con ambito utente di Windows
<a name="extension-registry-example"></a>

Se distribuisci i criteri tramite il registro di Windows in **Configurazione utente**, crea valori di stringa nel percorso dei criteri per utente per ogni browser. Lo stesso schema si applica a Chrome, Edge e Firefox.


| Browser | Percorso del registro (in 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 | 

Crea i seguenti valori di stringa sotto ogni chiave.


| Browser | Value name (Nome valore) | Value data (Dati valore) | 
| --- | --- | --- | 
| Chrome o Edge | installation\_mode | force\_installed | 
| Chrome o 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 | 

Tutti i valori utilizzano il `REG_SZ` tipo.

## Esempio: distribuzione delle estensioni a un elenco di utenti utilizzando GPO
<a name="extension-gpo-example"></a>

### Fase 1: Creare la policy dedicata
<a name="extension-gpo-step1"></a>

**Nota**  
Ti consigliamo di creare un nuovo GPO separato anziché modificare la politica del dominio principale. Ciò consente di collegare o scollegare l'estensione Connect Customer in modo sicuro.
+ Open **Group Policy Management** (`gpmc.msc`).
+ Right-click **Raggruppa gli oggetti delle politiche** e seleziona **Nuovo**. Per il nome, inserisci `PII-AmazonConnect` (o simile).  
![Creazione di un nuovo oggetto della politica di gruppo.](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/deploy-browser-extension-gpo-new.png)
+ Imposta il targeting (ambito):
  + Seleziona il nuovo GPO.
  + Nella scheda **Ambito**, in **Security Filtering**, rimuovi gli utenti **autenticati**.
  + Scegli **Aggiungi** e seleziona il gruppo di sicurezza contenente i computer dell'agente di destinazione.  
![Filtraggio di sicurezza nella scheda Ambito.](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/deploy-browser-extension-gpo-scope.png)
+ Verifica che il filtro di sicurezza contenga solo i computer su cui intendi installare le estensioni.  
![Verifica del filtro di sicurezza.](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/deploy-browser-extension-gpo-verify.png)

### Fase 2: Configurare l'iniezione del registro
<a name="extension-gpo-step2"></a>

Questo passaggio crea la chiave di registro specifica che il browser legge per installare l'estensione.
+ Right-click **inserisci il tuo nuovo GPO e seleziona Modifica.**
+ Passa al seguente percorso: **Configurazione utente**, **Preferenze**, **Impostazioni di Windows**, **Registro**.
+ Right-click nello spazio vuoto a destra e seleziona **Nuovo**, **Elemento del registro**.  
![Creazione di un nuovo elemento del registro.](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/deploy-browser-extension-gpo-new-registry-item.png)
+ Configurare le proprietà come illustrato nelle tabelle seguenti.

I seguenti valori sono comuni a tutti e tre i browser.


| Proprietà | Valore | 
| --- | --- | 
| Azione | Aggiorna | 
| Hive | HKEY\_CURRENT\_USER | 
| Value type (Tipo di valore) | REG\_SZ | 

Per ogni browser, utilizzate il seguente percorso chiave e i due valori necessari.

**Google Chrome**: percorso chiave `SOFTWARE\Policies\Google\Chrome\ExtensionSettings\cjmichfmnimgeoadokmeaiclklkdccod`


| Value name (Nome valore) | Value data (Dati valore) | 
| --- | --- | 
| installation\_mode | force\_installed | 
| update\_url | https://screenrecording.connect.aws/chromeos/amazon-connect-extension/releases/updates.xml | 

**Microsoft Edge**: percorso chiave `SOFTWARE\Policies\Microsoft\Edge\ExtensionSettings\cjmichfmnimgeoadokmeaiclklkdccod`


| Value name (Nome valore) | Value data (Dati valore) | 
| --- | --- | 
| installation\_mode | force\_installed | 
| update\_url | https://screenrecording.connect.aws/chromeos/amazon-connect-extension/releases/updates.xml | 

**Mozilla Firefox**: percorso chiave `SOFTWARE\Policies\Mozilla\Firefox\ExtensionSettings\amazon_connect_extension@amazon.com`


| Value name (Nome valore) | Value data (Dati valore) | 
| --- | --- | 
| installation\_mode | force\_installed | 
| install\_url | https://screenrecording.connect.aws/firefox/amazon-connect-extension/releases/amazon-connect-extension.xpi | 

![Le proprietà degli elementi del registro.](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/deploy-browser-extension-gpo-registry-properties.png)


## Verifica che l'estensione sia installata
<a name="extension-verify"></a>

Dopo aver distribuito l'estensione, verifica su una workstation di prova che l'estensione sia installata, abilitata e che stia eseguendo la versione prevista prima di distribuirla su larga scala.

**Chrome o Microsoft Edge**
+ Apri `chrome://extensions` (Chrome) o `edge://extensions` (Edge).
+ Verifica che il **client Amazon Connect** compaia nell'elenco e sia abilitato.
+ Verifica che la versione sia 2.1.0 o successiva.
+ Apri `chrome://policy` o `edge://policy` scegli **Reload policies** e conferma che `ExtensionSettings` contenga l'ID dell'estensione Connect Customer con lo stato **OK**.

**Firefox**
+ Aprire `about:addons`. Verifica che **Amazon Connect Client** sia visualizzato in **Estensioni** e sia abilitato.
+ Verifica che la versione sia 2.1.0 o successiva.
+ Aprire `about:policies`. Nella scheda **Attivo**, verifica che `ExtensionSettings` contenga l'ID dell'estensione Connect Customer.

Se uno di questi controlli fallisce, vedi[Download dei file di log per l'app client di registrazione dello schermo](troubleshoot-sr.md).

## Rimuovi l'estensione
<a name="extension-remove"></a>

Per interrompere l'utilizzo dell'estensione del browser Connect Customer sulle workstation degli agenti, ad esempio al termine di un progetto pilota o quando gli utenti cambiano ruolo, rimuovi l'estensione invertendo la politica di distribuzione. Sono disponibili due opzioni.

### Opzione 1: rimuovere gli utenti dal gruppo target
<a name="extension-remove-option1"></a>

Rimuovi gli utenti agente dal gruppo di sicurezza o dal gruppo Entra ID a cui si rivolge la politica di estensione. Al successivo aggiornamento della policy, l'estensione viene disinstallata dai browser di tali utenti. Gli utenti che rimangono nel gruppo continuano a ricevere l'estensione.

Questo è l'approccio consigliato per le modifiche di routine del ciclo di vita, come le riassegnazioni dei ruoli.

### Opzione 2: bloccare l'estensione
<a name="extension-remove-option2"></a>

Per impedire attivamente l'installazione o l'utilizzo dell'estensione, modifica il payload della policy `installation_mode` da `force_installed` a`blocked`. Il browser disinstalla l'estensione al successivo aggiornamento delle policy e impedisce installazioni future.

**Google Chrome e Microsoft Edge**

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

**Mozilla Firefox**

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

Se esegui la distribuzione tramite il registro di Windows, modifica il `installation_mode` valore da 0 `force_installed` a inferiore ai percorsi di registro dell'`blocked`ambito utente elencati in. [Esempio di registro con ambito utente di Windows](#extension-registry-example) È possibile lasciare invariati gli altri valori; ha la `blocked` precedenza.

### Effetto sulle registrazioni dopo la rimozione
<a name="extension-remove-effect"></a>

Dopo la rimozione o il blocco dell'estensione, i contatti gestiti da tali agenti vengono registrati senza l'applicazione di oscure. I record di contatto contrassegnano queste registrazioni come non redatte. Se per garantire la conformità è necessaria una redazione basata su regole, indirizza i contatti solo agli agenti il cui profilo di sicurezza e il cui browser hanno ancora l'estensione implementata.

## Cosa succede se l'estensione viene disabilitata durante un contatto
<a name="extension-disabled-during-contact"></a>

Se l'estensione viene disinstallata o disabilitata mentre un contatto registrato è attivo, gli URL del browser smettono di essere segnalati all'applicazione Connect Customer client per il resto del contatto. Le regole URL non possono più corrispondere e nella registrazione potrebbero essere visualizzate pagine del browser che devono essere oscurate dall'URL. Le regole del titolo della finestra continuano a corrispondere normalmente.

Per ripristinare la redazione dei nuovi contatti, reinstalla o riattiva l'estensione prima dell'inizio del contatto successivo.