Guida dettagliata alla configurazione delle estensioni tramite i criteri ExtensionSettings

Microsoft Edge offre diverse modalità di gestione delle estensioni. Una modalità comune consiste nell'impostare più criteri in un unico posto con una stringa JSON nell'Editor Criteri di gruppo di Windows o nel Registro di sistema di Windows tramite il criterio ExtensionSettings.

Prima di iniziare

Decidere se si desidera impostare tutte le impostazioni di gestione delle estensioni nei criteri ExtensionSettings o impostare questi controlli tramite altri criteri.

Il criterio ExtensionSettings può sovrascrivere altri criteri impostati altrove nei Criteri di gruppo, inclusi i criteri seguenti:

• ExtensionAllowedTypes
• ExtensionInstallBlocklist
• ExtensionInstallForcelist
• ExtensionInstallSources
• ExtensionInstallAllowlist

Campi del criterio ExtensionSettings

Questo criterio può controllare le impostazioni, ad esempio l'URL di aggiornamento, da cui viene scaricata l'estensione per l'installazione iniziale e le autorizzazioni bloccate. È anche possibile usare questo criterio per identificare quali autorizzazioni non sono consentite per l'esecuzione. I campi dei criteri disponibili sono descritti nella tabella seguente.

Le chiavi seguenti sono consentite nell'ambito globale (*):

• blocked_permissions
• installation_mode: solo "blocked", "allowed"o "removed" sono i valori validi in questo ambito.
• runtime_blocked_hosts
• blocked_install_message
• allowed_types
• runtime_allowed_hosts
• install_sources

Le chiavi seguenti sono consentite in un singolo ambito di estensione:

• blocked_permissions
• minimum_version_required
• blocked_install_message
• installation_mode - "blocked", "allowed", "removed", "force_installed"e "normal_installed" sono i valori possibili.
• runtime_allowed_hosts
• update_url
• override_update_url
• runtime_blocked_hosts
• toolbar_state
• sidebar_auto_open_blocked

Le chiavi seguenti sono consentite in un ambito url di aggiornamento:

• blocked_permissions
• installation_mode: solo "blocked", "allowed"o "removed" sono i valori validi in questo ambito.

Configurazione con una stringa JSON nell'Editor dei Criteri di gruppo di Windows

La procedura per usare i criteri delle impostazioni delle estensioni con l'oggetto Criteri di gruppo presuppone che si sia già importato ADM/ADMX per i criteri di Microsoft Edge.

1. Aprire l'editor criteri di gruppo e passare a Microsoft Edge > Extensions Configure extension management setting policy (Configurare i criteri di impostazione di gestione delle estensioni>).
2. Abilitare il criterio e immettere i dati JSON (JavaScript Object Notation) compatti nella casella di testo come riga singola senza interruzioni di riga.
3. Per convalidare i criteri e compattarli in una singola riga, usa uno strumento di compressione JSON.

Formatta correttamente JSON per i criteri delle impostazioni delle estensioni

È necessario comprendere le due parti di questo criterio, ovvero l'ambito predefinito e il singolo ambito. L'ambito predefinito è un catch-all per le estensioni senza un proprio ambito. L'ambito individuale viene applicato solo a tale estensione.

L'ambito predefinito è identificato da un asterisco (*). L'esempio seguente definisce un ambito predefinito e un ambito individuale dell'estensione.

{ 
   "*": {}, 
   "nckgahadagoaajjgafhacjanaoiihapd": {} 
} 

Un'estensione ottiene le impostazioni da un solo ambito. Se è presente un singolo ambito di estensione per tale estensione, queste saranno le impostazioni che si applicano a tale estensione. Se non è disponibile alcun ambito individuale, l'estensione utilizzerà l'ambito predefinito.

L'esempio JSON successivo blocca l'esecuzione di qualsiasi estensione in .example.com e qualsiasi estensione che richieda l'autorizzazione "USB".

{ 
  "*": { 
    "runtime_blocked_hosts": ["*://*.example.com"], 
    "blocked_permissions": ["usb"] 
  } 
} 

JSON compatto

{"*":{"runtime_blocked_hosts":["*://*.example.com"],"blocked_permissions":["usb"]}} 

Altri esempi di JSON per le impostazioni delle estensioni

Utilizzo della proprietà installation_mode per consentire e bloccare le estensioni

• L'utente può installare tutte le estensioni: l'impostazione predefinita

  { "*": {"installation_mode": "allowed" }}

• L'utente non può installare estensioni.

  { "*": {"installation_mode": "blocked" }}

• Specifica un messaggio personalizzato da visualizzare quando l'installazione è bloccata.

  {"*": {"blocked_install_message": ["Call IT(408 - 555 - 1234) for an exception"]}}

Utilizzo della proprietà installation_mode per forzare l'installazione delle estensioni

Quando si usa installation_mode come "force_installed", l'estensione viene installata automaticamente senza interazione dell'utente. Un utente non può disabilitare o rimuovere l'estensione. Se l'installazione di un'estensione è "normal" o "forced", è necessario definire anche il campo update_url. Il campo punta alla posizione da cui è possibile installare l'estensione. Utilizza le posizioni seguenti per il campo update_url:

• Se l'estensione che si sta scaricando è ospitata nell'archivio componenti aggiuntivi di Microsoft Edge, usare il percorso nell'esempio JSON seguente:

  {"nckgahadaanghapdoaajjgafhacjaoii": {"installation_mode": "force_installed","update_url": "https://edge.microsoft.com/extensionwebstorebase/v1/crx"}}

• Se l'estensione che stai scaricando è ospitata in Chrome Web Store, usa la posizione nell'esempio JSON seguente:

  {"nckgiihapdoaajjgafhacjgahadaanao": {"installation_mode": "force_installed","update_url": "https://clients2.google.com/service/update2/crx"}}

• Se si ospita l'estensione nel proprio server, usare l'URL in cui Microsoft Edge può scaricare l'estensione compressa (.crx file). Esempio JSON:

  {"nckgahadagoaajjgafhacjanaoiihapd": {"installation_mode": "force_installed","update_url": "https://edge.microsoft.com/extensionwebstorebase/v1/crx"}}

Nell'esempio precedente, se si usa "normal_installed" anziché "force_installed", l'estensione viene installata automaticamente senza l'interazione dell'utente, ma può disabilitare l'estensione.

Configurazione utilizzando il Registro di sistema di Windows

Il criterio ExtensionSettings deve essere scritto nel Registro di sistema della chiave seguente:

HKLM\Software\Policies\Microsoft\Edge\

Per Microsoft Edge, tutte le impostazioni verranno avviate in questa chiave:

HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Microsoft\Edge\

La chiave successiva che verrà creata è l'ID estensione per il singolo ambito o un asterisco (*) per l'ambito predefinito. Ad esempio, si userebbe il percorso seguente nel Registro di sistema per le impostazioni che si applicano a Google Hangouts:

HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Microsoft\Edge\ExtensionSettings\nckgahadagoaajjgafhacjanaoiihapd

Per le impostazioni che si applicano all'ambito predefinito (asterisco), usare il percorso seguente nel Registro di sistema:

HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Microsoft\Edge\ExtensionSettings\*

Impostazioni diverse richiedono formati diversi, a seconda che si tratti di una stringa o di una matrice di stringhe. I valori della matrice richiedono [＂value＂]. I valori stringa possono essere immessi così come sono. L'elenco seguente mostra quali impostazioni sono matrici o stringhe:

• Installation_mode = Stringa
• update_url = Stringa
• blocked_permissions = Matrice di stringhe
• allowed_permissions = Matrice di stringhe
• minimum_version_required = Stringa
• runtime_blocked_hosts = Matrice di stringhe
• runtime_allowed_hosts = Matrice di stringhe
• blocked_install_message = Stringa

Vedi anche

• Gestire le estensioni di Microsoft Edge nella grande impresa
• Usare i criteri di gruppo per gestire le impostazioni di Microsoft Edge
• Domande frequenti sulle estensioni di Microsoft Edge
• Pagina di destinazione di Microsoft Edge in modalità Enterprise