Um guia detalhado para configurar extensões com a política ExtensionSettings

Microsoft Edge oferece várias maneiras de gerenciar extensões. Uma maneira comum é definir várias políticas em um só lugar com uma cadeia de caracteres JSON no Editor de Política de Grupo do Windows ou no Registro do Windows usando a política ExtensionSettings.

Antes de começar

Decida se pretende definir todas as definições de gestão de extensões na política ExtensionSettings ou definir estes controlos através de outras políticas.

A política ExtensionSettings pode substituir outras políticas que você definiu em outro lugar na política de grupo, incluindo as seguintes políticas:

• ExtensionAllowedTypes
• ExtensionInstallBlocklist
• ExtensionInstallForcelist
• ExtensionInstallSources
• ExtensionInstallAllowlist

Campos de política de ExtensionSettings

Esta política pode controlar definições como UrL de Atualização, de onde a extensão é transferida para instalação inicial e Permissões bloqueadas. Também pode utilizar esta política para identificar que permissões não podem ser executadas. Os campos de política disponíveis são descritos na tabela a seguir.

As seguintes chaves são permitidas no âmbito global (*):

• blocked_permissions
• installation_mode - apenas "blocked", "allowed"ou "removed" são os valores válidos neste âmbito.
• runtime_blocked_hosts
• blocked_install_message
• allowed_types
• runtime_allowed_hosts
• install_sources

As seguintes chaves são permitidas num âmbito de extensão individual:

• blocked_permissions
• minimum_version_required
• blocked_install_message
• installation_mode - "blocked", , "allowed""removed", "force_installed"e "normal_installed" são os valores possíveis.
• runtime_allowed_hosts
• update_url
• override_update_url
• runtime_blocked_hosts
• toolbar_state
• sidebar_auto_open_blocked

As chaves seguintes são permitidas num âmbito de URL de atualização:

• blocked_permissions
• installation_mode - apenas "blocked", "allowed"ou "removed" são os valores válidos neste âmbito.

Configurar usando uma cadeia de caracteres JSON no Editor de Política de Grupo do Windows

As etapas para usar a política de configurações de extensão usando GPO pressupõem que você já importou o ADM/ADMX para Políticas do Microsoft Edge.

1. Abra o editor de políticas de grupo e aceda a Extensões > do Microsoft Edge > Configurar política de definição de gestão de extensões.
2. Ative a política e introduza os dados compactos de JavaScript Object Notation (JSON) na caixa de texto como uma única linha sem quebras de linha.
3. Para validar a política e compactá-la em uma única linha, use uma ferramenta de compactação JSON.

Formatar corretamente o JSON para a política de configurações de extensão

Tem de compreender as duas partes desta política: o âmbito predefinido e o âmbito individual. O escopo padrão é genérico para extensões sem seu próprio escopo. O escopo individual é aplicado somente a essa extensão.

O escopo padrão é identificado pelo asterisco (*). O exemplo a seguir define um escopo padrão e um escopo de extensão individual.

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

Uma extensão só obterá suas configurações de um escopo. Se existir um âmbito de extensão individual para essa extensão, essas serão as definições que se aplicam a essa extensão. Se nenhum escopo de extensão individual existir, a extensão usará o escopo padrão.

O próximo exemplo de JSON impede que qualquer extensão seja executada em .example.com e bloqueia qualquer extensão que exija a permissão "USB".

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

JSON compacto

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

Mais alguns exemplos de JSON para configurações de extensão

Usando installation_mode para permitir e bloquear extensões

• O utilizador pode instalar todas as extensões – a predefinição

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

• O utilizador não pode instalar extensões.

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

• Especifique uma mensagem personalizada a ser exibida quando a instalação for bloqueada.

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

Usando a propriedade installation_mode para forçar a instalação de extensões

Ao usar installation_mode como "force_installed", a extensão é instalada automaticamente sem interação do usuário. Um utilizador não pode desativar ou remover a extensão. Se uma extensão for instalada "normal" ou "force", o campo update_url também deverá ser definido. Esse campo aponta para o local do qual a extensão pode ser instalada. Use os seguintes locais para o campo update_url:

• Se a extensão que está a transferir estiver alojada na loja de Suplementos do Microsoft Edge, utilize a localização no seguinte exemplo JSON:

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

• Se a extensão que está a transferir estiver alojada na Chrome Web Store, utilize a localização no seguinte exemplo JSON:

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

• Se estiver a alojar a extensão no seu próprio servidor, utilize o URL onde o Microsoft Edge pode transferir a extensão embalada (.crx ficheiro). Exemplo de JSON:

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

No exemplo anterior, se utilizar "normal_installed" em vez de "force_installed", a extensão é instalada automaticamente sem interação do utilizador, mas pode desativar a extensão.

Configurar usando o Registro do Windows

A política ExtensionSettings deve ser gravada no Registro sob esta chave:

HKLM\Software\Policies\Microsoft\Edge\

Para o Microsoft Edge, todas as configurações serão iniciadas sob esta chave:

HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Microsoft\Edge\

A chave seguinte que irá criar é o ID da Extensão para o âmbito individual ou um asterisco (*) para o Âmbito Predefinido. Por exemplo, utilizaria a seguinte localização no registo para definições que se aplicam ao Google Hangouts:

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

Para definições que se aplicam ao Âmbito Predefinido (asterisco), utilize a seguinte localização no registo:

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

As diferentes definições exigirão formatos diferentes, consoante sejam uma cadeia ou uma matriz de cadeias. Valores de matriz exigem [＂value＂]. Valores de cadeia de caracteres podem ser inseridos como estão. A lista a seguir mostra quais configurações são matrizes ou cadeias de caracteres:

• Installation_mode = Cadeia de caracteres
• update_url = Cadeia de caracteres
• blocked_permissions = Matriz de cadeias de caracteres
• allowed_permissions = Matriz de cadeias de caracteres
• minimum_version_required = Cadeia de caracteres
• runtime_blocked_hosts = Matriz de cadeias de caracteres
• runtime_allowed_hosts = Matriz de cadeias de caracteres
• blocked_install_message = Cadeia de caracteres

Veja também

• Gerenciar extensões do Microsoft Edge na empresa
• Usar políticas de grupo para gerenciar extensões do Microsoft Edge
• Perguntas frequentes sobre extensões do Microsoft Edge
• Página de aterrissagem do Microsoft Edge Enterprise