> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devin.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Enterprise

> Gerencie centralmente as configurações do Devin Desktop com Enterprise. Configure listas de permissões para extensões, modos de atualização e outras configurações no Windows, macOS e Linux usando políticas de grupo, perfis de configuração e arquivos de política JSON.

<div id="enterprise-policies-for-extension-management">
  # Políticas Enterprise para gerenciamento de extensões
</div>

As políticas Enterprise no Devin Desktop permitem que as organizações gerenciem centralmente as configurações do editor para suas equipes de desenvolvimento, garantindo consistência e segurança em toda a organização. Quando um valor de política é definido, ele faz override de uma configuração do Devin Desktop definida em qualquer nível (padrão, usuário e workspace).

Admins de TI podem implantar e aplicar configurações específicas do Devin Desktop nos dispositivos dos usuários por meio de diferentes soluções de gerenciamento de dispositivos. O Devin Desktop oferece suporte à aplicação de políticas no **Windows**, **macOS** e **Linux**.

<Note>
  O Devin Desktop usa seus próprios caminhos de política, separados dos do VS Code. As políticas configuradas para o VS Code não se aplicam ao Devin Desktop, e vice-versa.
</Note>

***

<div id="windows-group-policies">
  ## Políticas de Grupo do Windows
</div>

O Devin Desktop oferece suporte à [Política de Grupo baseada no Registro do Windows](https://learn.microsoft.com/en-us/windows/client-management/group-policies-overview). As políticas podem ser implantadas com soluções de Mobile Device Management (MDM) ou configuradas manualmente em dispositivos individuais.

<Note>
  O Devin Desktop lê as políticas no caminho do registro `Software\Policies\Windsurf\{ProductName}` (por exemplo, `Software\Policies\Windsurf\Windsurf` ou `Software\Policies\Windsurf\WindsurfInsiders`). Isso é diferente do VS Code, que lê em `Software\Policies\Microsoft\{ProductName}`.
</Note>

<div id="step-1-obtain-the-admx-and-adml-files">
  ### Etapa 1: Obtenha os arquivos ADMX e ADML
</div>

Cada versão do Devin Desktop vem com um diretório `policies` que contém arquivos de template ADMX que definem as políticas disponíveis.

Você pode obter os arquivos ADMX e ADML de uma instalação existente do Devin Desktop:

1. Navegue até o diretório de instalação do Devin Desktop.
2. Procure a pasta `policies`. Essa pasta contém os arquivos de template ADMX (e.g. `windsurf.admx`) e uma subpasta `locales` com arquivos ADML para diferentes idiomas.

Como alternativa, baixe e extraia o arquivo ZIP do Devin Desktop e localize a pasta `policies` nos arquivos extraídos.

<div id="step-2-install-the-policy-definition-files">
  ### Etapa 2: Instale os arquivos de definição de política
</div>

1. Copie o arquivo `windsurf.admx` para `C:\Windows\PolicyDefinitions`.
2. Copie o arquivo ADML apropriado da subpasta `locales` (por exemplo, `en-US\windsurf.adml`) para `C:\Windows\PolicyDefinitions\<your-locale>` (por exemplo, `C:\Windows\PolicyDefinitions\en-US`).

<Note>
  Você precisa de privilégios de administrador para copiar arquivos para o diretório `PolicyDefinitions`.
</Note>

Em ambientes com Active Directory, copie os arquivos ADMX e ADML para o [Central Store](https://learn.microsoft.com/en-us/troubleshoot/windows-client/group-policy/create-and-manage-central-store) para disponibilizar as políticas em todo o domínio.

<div id="step-3-deploy-the-policies">
  ### Etapa 3: Implantar as políticas
</div>

Você pode implantar as políticas configuradas em larga escala usando uma solução de MDM ou testá-las manualmente em uma máquina local com o Editor de Política de Grupo Local.

#### Implantar em escala

Produtos como [Microsoft Intune](https://www.microsoft.com/en-us/security/business/microsoft-intune) ou a Política de Grupo do Active Directory podem ser usados para gerenciar centralmente políticas de dispositivos em grande escala. Essas soluções permitem que administradores implantem os arquivos ADMX/ADML e as configurações de política em vários dispositivos a partir de um ponto central.

#### Testar políticas manualmente em uma máquina local

Siga estas etapas para configurar políticas do Devin Desktop em uma máquina Windows local usando o Editor de Política de Grupo Local:

1. **Abra o Editor de Política de Grupo Local:**
   * Pressione `Windows+R` para abrir a caixa de diálogo Executar.
   * Digite `gpedit.msc` e pressione Enter.
   * Se for exibido um prompt do Controle de Conta de Usuário, selecione **Sim**.

2. **Navegue até as políticas do Windsurf:**
   * **Configuração do Computador** > **Modelos Administrativos** > **Windsurf**
   * **Configuração do Usuário** > **Modelos Administrativos** > **Windsurf**

<Tip>
  As políticas no nível do computador têm precedência sobre as políticas no nível do usuário quando ambas estão configuradas.
</Tip>

3. **Configure uma política:**
   * Clique duas vezes na política que você deseja configurar (por exemplo, **AllowedExtensions**).
   * Selecione **Ativado** para impor a política.
   * Para políticas de string (por exemplo, `AllowedExtensions`), insira o valor no campo de texto. Por exemplo: `{"publisher1": true, "publisher2": true}`.
   * Para políticas booleanas (por exemplo, **EnableTelemetry**), selecionar **Ativado** ou **Desativado** define o valor.
   * Selecione **OK** para salvar as alterações.

<Warning>
  Se houver um erro de sintaxe em um valor de política de string (por exemplo, JSON malformado), a configuração não será aplicada. Você pode verificar os erros no log da janela no Devin Desktop (abra a Paleta de Comandos com `Ctrl+Shift+P` e digite **Show Window Log**).
</Warning>

A política entrará em vigor na próxima vez que o Devin Desktop for iniciado.

***

<div id="macos-configuration-profiles">
  ## Perfis de configuração do macOS
</div>

Os perfis de configuração gerenciam as configurações em dispositivos macOS. Um perfil é um arquivo XML (`.mobileconfig`) com pares de chave-valor que correspondem às políticas disponíveis.

Esses perfis podem ser distribuídos usando soluções de gerenciamento de dispositivos móveis (MDM) ou instalados manualmente em dispositivos individuais.

<div id="step-1-obtain-the-sample-configuration-profile">
  ### Etapa 1: Obtenha o perfil de configuração de exemplo
</div>

Cada versão do Devin Desktop inclui um arquivo `.mobileconfig` de exemplo. Para localizar esse arquivo em um dispositivo macOS com o Devin Desktop instalado:

1. Abra o Finder e navegue até `/Applications`.
2. Clique com o botão direito em **Devin.app** e selecione **Mostrar Conteúdo do Pacote**.
3. Navegue até `Contents/Resources/app/policies`.
4. Localize o arquivo `.mobileconfig` de exemplo.

<div id="step-2-configure-policy-values">
  ### Etapa 2: Configurar os valores da política
</div>

1. Copie o arquivo `.mobileconfig` de exemplo para um local de trabalho (por exemplo, a pasta Área de Trabalho ou Documentos).
2. Abra o arquivo copiado em um editor de texto.
3. Edite os valores da política de acordo com seus requisitos:

**Políticas de string** — políticas que aceitam valores de texto ou strings JSON:

```xml theme={null}
<!-- Exemplo: Permitir extensões de editores específicos -->
<key>AllowedExtensions</key>
<string>{"publisher1": true, "publisher2": true}</string>
```

**Políticas booleanas** — políticas que aceitam valores true/false:

```xml theme={null}
<!-- Exemplo: Ativar feedback do usuário -->
<key>EnableFeedback</key>
<true/>

<!-- Exemplo: Desativar telemetria -->
<key>EnableTelemetry</key>
<false/>
```

**Remova as políticas desnecessárias** — exclua a chave e o valor de qualquer política que você não queira aplicar.

<Warning>
  Se houver um erro de sintaxe no valor da política, a configuração não será aplicada. Você pode consultar o log da janela no Devin Desktop para verificar erros (abra a Paleta de Comandos com `⌘+Shift+P` e digite **Show Window Log**).
</Warning>

### Etapa 3: Aplicar as políticas

<div id="deploy-at-scale">
  #### Faça a implantação em escala
</div>

Para implantações Enterprise em vários dispositivos, use soluções de Mobile Device Management (MDM), como o Apple Business Manager com MDM.

Para mais informações sobre perfis de configuração, consulte a [documentação da Apple sobre perfis de configuração](https://support.apple.com/guide/deployment/intro-to-mdm-profiles-depc0aadd3fe/web).

#### Testar políticas manualmente em uma máquina local

1. **Instale o perfil de configuração:**
   * Salve o arquivo `.mobileconfig` editado.
   * Clique duas vezes no arquivo `.mobileconfig` no Finder.
   * **Configurações do Sistema** será aberto. Revise os detalhes do perfil e selecione **Instalar**.
   * Se solicitado, autentique-se com suas credenciais de administrador.

2. **Verifique a instalação do perfil:**
   * Abra **Configurações do Sistema**.
   * Vá para **Privacidade e Segurança** > **Perfis** (ou **Geral** > **Gerenciamento de Dispositivos** em versões mais antigas).
   * Verifique se o perfil de configuração do Devin Desktop aparece na lista.
   * Abra o Devin Desktop para ver as políticas em vigor.

<Note>
  As políticas entram em vigor imediatamente para novas instâncias do Devin Desktop. Talvez seja necessário reiniciar o Devin Desktop se ele já estiver em execução.
</Note>

<div id="remove-a-configuration-profile">
  #### Remover um Perfil de Configuração
</div>

Para remover políticas e restaurar as configurações padrão:

1. Abra **Configuração do Sistema** > **Privacidade e Segurança** > **Perfis**.
2. Selecione o perfil de configuração do Devin Desktop.
3. Selecione o botão **Remover** (ou **-**).
4. Autentique-se com suas credenciais de administrador para confirmar a remoção.

***

<div id="linux-json-policies">
  ## Políticas JSON no Linux
</div>

Você pode configurar as políticas de definições do Devin Desktop em dispositivos Linux colocando um arquivo de política JSON em `/etc/windsurf/policies/policy.json`. Essa abordagem usa um formato JSON simples para definir os valores das políticas.

<Note>
  O Devin Desktop lê as políticas de `/etc/windsurf/policies/policy.json`, enquanto o VS Code usa `/etc/vscode/policy.json`. Certifique-se de colocar o arquivo no local correto para o Devin Desktop.
</Note>

<div id="step-1-obtain-the-sample-policy-file">
  ### Etapa 1: Obtenha o arquivo de política de exemplo
</div>

Cada versão do Devin Desktop vem com um arquivo `policy.json` de exemplo. Você pode obtê-lo em uma instalação existente — ele fica no diretório `resources/app/policies` dentro do caminho de instalação do Devin Desktop.

<div id="step-2-configure-policy-values">
  ### Etapa 2: Configurar os valores da política
</div>

1. Copie o arquivo de exemplo `policy.json` para um local de sua preferência:

```bash theme={null}
sudo cp /path/to/windsurf/resources/app/policies/policy.json /tmp/policy.json
```

2. Edite o arquivo com o editor de texto de sua preferência:

```bash theme={null}
sudo nano /tmp/policy.json
```

3. Defina os valores da política. Por exemplo, para permitir apenas publicadores específicos de extensões:

```json theme={null}
{
  "AllowedExtensions": "{\"publisher1\": true, \"publisher2\": true}",
  "UpdateMode": "manual"
}
```

### Etapa 3: Aplicar as políticas

#### Implantação em larga escala

Para implantações do Linux Enterprise em vários dispositivos, use ferramentas de gerenciamento de configuração, como **Ansible**, **Puppet**, **Chef** ou **Salt**, para implantar o arquivo `policy.json`. Essas ferramentas permitem que os administradores implantem, atualizem e removam políticas remotamente em todos os dispositivos Linux gerenciados.

<div id="manually-test-policies-on-a-local-machine">
  #### Teste manualmente as políticas em uma máquina local
</div>

1. **Crie o diretório de políticas e copie o arquivo:**

```bash theme={null}
sudo mkdir -p /etc/windsurf/policies
sudo cp /tmp/policy.json /etc/windsurf/policies/policy.json
sudo chmod 644 /etc/windsurf/policies/policy.json
sudo chown root:root /etc/windsurf/policies/policy.json
```

<Note>
  Você precisa de privilégios de root ou sudo para criar o diretório e gerenciar arquivos de política em `/etc/windsurf/policies`.
</Note>

2. **Verifique a instalação das políticas:**
   * Abra o Devin Desktop (ou reinicie-o, se ele já estiver em execução).
   * Abra **File** > **Preferences** > **Settings** (ou pressione `Ctrl+,`).
   * Procure configurações que correspondam às políticas configuradas — elas devem aparecer como gerenciadas pela sua organização ou com um ícone de cadeado.

<div id="remove-policies">
  #### Remover políticas
</div>

Para remover todas as políticas e restaurar as configurações padrão, exclua o arquivo `/etc/windsurf/policies/policy.json` e reinicie o Devin Desktop.

***

<div id="extension-management-policies">
  ## Políticas de gerenciamento de extensões
</div>

Um dos usos mais comuns das políticas do Enterprise é controlar quais extensões os usuários podem instalar. A política `AllowedExtensions` permite que os administradores definam uma lista de permissões com os publicadores de extensões autorizados.

<div id="allowedextensions">
  ### AllowedExtensions
</div>

A política `AllowedExtensions` aceita uma string JSON que especifica quais editores de extensões são permitidos. Quando essa política está ativa, os usuários só podem instalar extensões dos editores listados.

**Valor de exemplo:**

```json theme={null}
{"windsurf": true, "github": true, "ms-python": true}
```

Isso pode ser configurado por qualquer um dos mecanismos específicos de cada plataforma descritos acima:

* **Windows:** Defina por meio de modelos ADMX de Política de Grupo ou diretamente no registro em `Software\Policies\Windsurf\{ProductName}`.
* **macOS:** Defina em um perfil de configuração `.mobileconfig`.
* **Linux:** Defina em `/etc/windsurf/policies/policy.json`.

Quando a política `AllowedExtensions` é aplicada, a seção de extensões no Devin Desktop indica que a configuração é gerenciada pela sua organização, e os usuários não podem alterá-la.

***

<div id="additional-resources">
  ## Recursos adicionais
</div>

* [Guia do Devin Desktop para admins do Enterprise](/pt-BR/desktop/guide-for-admins)