Guía detallada de la directiva ExtensionSettings

Microsoft Edge ofrece varias formas de administrar extensiones. Una manera común es establecer varias directivas en un solo lugar con una cadena JSON en el Editor de directiva de grupo de Windows o en el Registro de Windows mediante la directiva ExtensionSettings.

Antes de empezar

Decide si quiere establecer aquí toda la configuración de administración de extensiones o establecer estos controles a través de otras directivas.

La directiva ExtensionSettings puede sobrescribir otras directivas que haya establecido en otra parte de la directiva de grupo, incluidas las siguientes:

• ExtensionAllowedTypes
• ExtensionInstallBlocklist
• ExtensionInstallForcelist
• ExtensionInstallSources
• ExtensionInstallAllowlist

Campos de directiva ExtensionSettings

Esta directiva puede controlar configuraciones, como la dirección URL de actualización, desde donde se descargará la extensión para la instalación inicial, y los permisos bloqueados, o qué permisos no se pueden ejecutar. Los campos de directiva disponibles se describen en la tabla siguiente.

Estas son las claves que se permiten en el ámbito global (*):

• blocked_permissions
• installation_mode: solo "blocked" , "allowed" o son los "removed" valores válidos en este ámbito.
• runtime_blocked_hosts
• blocked_install_message
• allowed_types
• runtime_allowed_hosts
• install_sources

Estas son las claves que se permiten en un ámbito de extensión individual:

• blocked_permissions
• minimum_version_required
• blocked_install_message
• installation_mode - "blocked" , "allowed" , , y son los "removed" "force_installed" valores "normal_installed" posibles.
• runtime_allowed_hosts
• update_url
• override_update_url
• runtime_blocked_hosts
• toolbar_state

Estas son las claves que se permiten en un ámbito de dirección URL de actualización:

• blocked_permissions
• installation_mode: solo "blocked" , "allowed" o son los "removed" valores válidos en este ámbito.

Configuración mediante una cadena JSON en el Editor de directivas de grupo de Windows

En los pasos para usar la directiva de configuración de extensiones mediante GPO se supone que ya ha importado ADM/ADMX para las directivas de Microsoft Edge.

1. Abra el editor de directivas de grupo y vaya a Microsoft Edge > Extensiones > Configurar la directiva de configuración de administración de extensiones.
2. Habilite la directiva y escriba sus datos de notación de objetos JavaScript (JSON) compacta en el cuadro de texto como una sola línea sin saltos de línea.
3. Para validar la directiva y compactarla en una sola línea, use una herramienta de compresión JSON.

JSON de formato correcto para la directiva de configuración de extensiones

Debe comprender las dos partes de esta directiva: el ámbito predeterminado y el ámbito individual. El ámbito predeterminado es uno genérico para las extensiones sin su propio ámbito. El ámbito individual solo se aplica solo a esa extensión.

El ámbito predeterminado se identifica mediante el asterisco (*). En el ejemplo siguiente se define un ámbito predeterminado y un ámbito de extensión individual.

{ 
   “*”: {}, 
   “nckgahadagoaajjgafhacjanaoiihapd”: {} 
} 

Una extensión solo obtendrá su configuración de un ámbito. Si hay un ámbito de extensión individual para esa extensión, será la configuración que se aplique a esa extensión. Si no existe ningún ámbito de extensión individual, la extensión usará el ámbito predeterminado.

En el siguiente ejemplo de JSON se impide que cualquier extensión se ejecute en .example.com y se bloquea cualquier extensión que requiera el permiso "USB".

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

JSON compacta

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

Algunos ejemplos más de JSON para la configuración de extensiones

Uso de la propiedad installation_mode para permitir y bloquear extensiones

• El usuario puede instalar todas las extensiones; esta es la configuración predeterminada

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

• El usuario no puede instalar ninguna extensión.

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

• Especifique un mensaje personalizado para mostrar cuando se bloquee la instalación.

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

Uso de la propiedad installation_mode para forzar la instalación de extensiones

Cuando se usa installation_mode como "force_installed", la extensión se instala automáticamente sin la interacción del usuario. Un usuario no puede deshabilitar ni quitar la extensión. Si se instala una extensión "normal" o "force", también se debe definir el campo update_url. Este campo indica la ubicación desde la que se puede instalar la extensión. Use las siguientes ubicaciones para el campo update_url:

• Si la extensión que está descargando está hospedada en la tienda de complementos de Microsoft Edge, use https://edge.microsoft.com/extensionwebstorebase/v1/crx.

• Si la extensión que va a descargar está hospedada en Chrome Web Store, use https://clients2.google.com/service/update2/crx.

• Si hospeda la extensión en su propio servidor, use la dirección URL donde Microsoft Edge puede descargar la extensión empaquetada (archivo .crx). Ejemplo de JSON:

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

En el ejemplo anterior, en lugar de "force_installed", si usa "normal_installed", la extensión se instala automáticamente sin interacción del usuario, pero pueden deshabilitar la extensión.

Configurar mediante el registro de Windows

La directiva ExtensionSettings debe escribirse en el registro con esta clave:

HKLM\Software\Policies\Microsoft\Edge\

Para Microsoft Edge, toda la configuración se iniciará con esta clave:

HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Microsoft\Edge\

La siguiente clave que creará es el identificador de extensión para el ámbito individual o un asterisco (*) para el ámbito predeterminado. Por ejemplo, usaría la siguiente ubicación para la configuración que se aplica a Google Hangouts:

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

Para la configuración que se aplica al ámbito predeterminado, use esta ubicación:

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

Una configuración diferente requerirá formatos diferentes, en función de si son una cadena o una matriz de cadenas. Los valores de matriz requieren ["value"]. Los valores de cadena se pueden escribir tal cual. En la lista siguiente se muestra qué valores son matrices o cadenas:

• Installation_mode = String
• update_url = String
• blocked_permissions = Array of strings
• allowed_permissions = Array of Strings
• minimum_version_required = String
• runtime_blocked_hosts = Array of strings
• runtime_allowed_hosts = Array of Strings
• blocked_install_message = String

Vea también

• Administrar extensiones de Microsoft Edge en la empresa
• Usar directivas de grupo para administrar extensiones de Microsoft Edge
• Preguntas más frecuentes sobre extensiones de Microsoft Edge
• Página de aterrizaje de Microsoft Edge Enterprise