Saltar al contenido principal

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.

Políticas de Enterprise para la gestión de extensiones

Las políticas de Enterprise en Devin Desktop permiten a las organizaciones gestionar de forma centralizada la configuración del editor para sus equipos de desarrollo, a fin de garantizar la coherencia y la seguridad en toda la organización. Cuando se establece un valor de política, este anula la configuración de Devin Desktop definida en cualquier nivel (predeterminado, de usuario y del espacio de trabajo). Los Admin de TI pueden implementar y aplicar configuraciones específicas de Devin Desktop en los dispositivos de los usuarios mediante distintas soluciones de gestión de dispositivos. Devin Desktop admite la aplicación de políticas en Windows, macOS y Linux.
Devin Desktop usa sus propias rutas de políticas, independientes de las de VS Code. Las políticas configuradas para VS Code no se aplican a Devin Desktop, y viceversa.

Directivas de grupo de Windows

Devin Desktop es compatible con la Directiva de grupo basada en el Registro de Windows. Las directivas pueden implementarse mediante soluciones de administración de dispositivos móviles (MDM) o configurarse manualmente en dispositivos individuales.
Devin Desktop lee las directivas en la ruta de registro Software\Policies\Windsurf\{ProductName} (p. ej., Software\Policies\Windsurf\Windsurf o Software\Policies\Windsurf\WindsurfInsiders). Esto difiere de VS Code, que lee desde Software\Policies\Microsoft\{ProductName}.

Paso 1: Obtener los archivos ADMX y ADML

Cada versión de Devin Desktop se distribuye con un directorio policies que contiene archivos de plantilla ADMX que definen las políticas disponibles. Puedes obtener los archivos ADMX y ADML de una instalación existente de Devin Desktop:
  1. Ve al directorio de instalación de Devin Desktop.
  2. Busca la carpeta policies. Esta carpeta contiene los archivos de plantilla ADMX (p. ej., windsurf.admx) y una subcarpeta locales con archivos ADML para distintos idiomas.
Como alternativa, descarga y extrae el archivo ZIP de Devin Desktop, y localiza la carpeta policies en los archivos extraídos.

Paso 2: Instala los archivos de definición de directivas

  1. Copia el archivo windsurf.admx a C:\Windows\PolicyDefinitions.
  2. Copia el archivo ADML correspondiente de la subcarpeta locales (p. ej., en-US\windsurf.adml) a C:\Windows\PolicyDefinitions\<your-locale> (p. ej., C:\Windows\PolicyDefinitions\en-US).
Necesitas privilegios de administrador para copiar archivos al directorio PolicyDefinitions.
En entornos de Active Directory, copia los archivos ADMX y ADML al almacén central para que las directivas estén disponibles en todo el dominio.

Paso 3: Implementar las políticas

Puedes implementar las políticas configuradas a gran escala con una solución de MDM o probarlas manualmente en un equipo local con el Editor de directivas de grupo local.

Implementación a gran escala

Productos como Microsoft Intune o la Directiva de grupo de Active Directory pueden utilizarse para gestionar de forma centralizada las políticas de los dispositivos a gran escala. Estas soluciones permiten a los administradores desplegar los archivos ADMX/ADML y la configuración de las políticas en múltiples dispositivos desde una ubicación central.

Probar manualmente las políticas en una máquina local

Sigue estos pasos para configurar las políticas de Devin Desktop en una máquina Windows local con el Editor de directivas de grupo local:
  1. Abre el Editor de directivas de grupo local:
    • Presiona Windows+R para abrir el cuadro de diálogo Ejecutar.
    • Escribe gpedit.msc y presiona Intro.
    • Si aparece una solicitud del Control de cuentas de usuario, selecciona .
  2. Ve a las políticas de Windsurf:
    • Computer Configuration > Administrative Templates > Windsurf
    • User Configuration > Administrative Templates > Windsurf
Las políticas a nivel de equipo tienen precedencia sobre las políticas a nivel de usuario cuando ambas están configuradas.
  1. Configura una política:
    • Haz doble clic en la política que quieras configurar (p. ej., AllowedExtensions).
    • Selecciona Enabled para aplicar la política.
    • En las políticas de cadena (p. ej., AllowedExtensions), introduce el valor en el campo de texto. Por ejemplo: {"publisher1": true, "publisher2": true}.
    • En las políticas booleanas (p. ej., EnableTelemetry), al seleccionar Enabled o Disabled se establece el valor.
    • Selecciona OK para guardar los cambios.
Si hay un error de sintaxis en el valor de una política de cadena (p. ej., JSON con formato incorrecto), la configuración no se aplicará. Puedes revisar el registro de la ventana en Devin Desktop para ver los errores (abre la Paleta de comandos con Ctrl+Shift+P e introduce Show Window Log).
La política entrará en vigor la próxima vez que se inicie Devin Desktop.

Perfiles de configuración de macOS

Los perfiles de configuración gestionan la configuración en dispositivos macOS. Un perfil es un archivo XML (.mobileconfig) con pares clave/valor que corresponden a las políticas disponibles. Estos perfiles se pueden implementar mediante soluciones de gestión de dispositivos móviles (MDM) o instalar manualmente en dispositivos individuales.

Paso 1: Obtener el perfil de configuración de ejemplo

Cada versión de Devin Desktop incluye un archivo .mobileconfig de ejemplo. Para localizar el archivo de ejemplo en un dispositivo macOS con Devin Desktop instalado:
  1. Abre Finder y ve a /Applications.
  2. Haz clic con el botón derecho en Windsurf.app y selecciona Mostrar contenido del paquete.
  3. Ve a Contents/Resources/app/policies.
  4. Localiza el archivo .mobileconfig de ejemplo.

Paso 2: Configurar los valores de las políticas

  1. Copia el archivo .mobileconfig de ejemplo en una ubicación de trabajo (p. ej., tu carpeta Escritorio o Documentos).
  2. Abre el archivo copiado en un editor de texto.
  3. Edita los valores de las políticas según tus necesidades:
Políticas de cadena — políticas que aceptan valores de texto o cadenas JSON:
<!-- Ejemplo: Permitir extensiones de publicadores específicos -->
<key>AllowedExtensions</key>
<string>{"publisher1": true, "publisher2": true}</string>
Políticas de tipo booleano — políticas que aceptan valores verdadero/falso:
<!-- Ejemplo: Habilitar feedback del usuario -->
<key>EnableFeedback</key>
<true/>

<!-- Ejemplo: Deshabilitar telemetría -->
<key>EnableTelemetry</key>
<false/>
Elimina las políticas que no quieras — borra tanto la clave como el valor de cualquier política que no quieras aplicar.
Si hay un error de sintaxis en el valor de la política, la configuración no se aplicará. Puedes consultar el registro de la ventana en Devin Desktop para ver los errores (abre la Paleta de comandos con ⌘+Shift+P y escribe Show Window Log).

Paso 3: Desplegar las políticas

Despliegue a gran escala

Para despliegues empresariales en múltiples dispositivos, utilice soluciones de gestión de dispositivos móviles (MDM), como Apple Business Manager con MDM. Para obtener más información sobre los perfiles de configuración, consulte la documentación de Apple sobre perfiles de configuración.

Probar manualmente las políticas en una máquina local

  1. Instala el perfil de configuración:
    • Guarda el archivo .mobileconfig editado.
    • Haz doble clic en el archivo .mobileconfig en Finder.
    • Se abrirá Configuración del Sistema. Revisa los detalles del perfil y selecciona Instalar.
    • Si se te solicita, autentícate con tus credenciales de administrador.
  2. Verifica la instalación del perfil:
    • Abre Configuración del Sistema.
    • Ve a Privacidad y seguridad > Perfiles (o General > Gestión de dispositivos en versiones anteriores).
    • Verifica que el perfil de configuración de Devin Desktop aparezca en la lista.
    • Abre Devin Desktop para ver las políticas aplicadas.
Las políticas se aplican de inmediato a las nuevas instancias de Devin Desktop. Es posible que debas reiniciar Devin Desktop si ya está en ejecución.

Eliminar un perfil de configuración

Para eliminar las políticas y volver a la configuración predeterminada:
  1. Abre System Settings > Privacy & Security > Profiles.
  2. Selecciona el perfil de configuración de Devin Desktop.
  3. Selecciona el botón Remove (o -).
  4. Autentícate con tus credenciales de administrador para confirmar la eliminación.

Políticas JSON en Linux

Puede configurar las políticas de ajustes de Devin Desktop en dispositivos Linux colocando un archivo de políticas JSON en /etc/windsurf/policies/policy.json. Este método utiliza un formato JSON simple para definir los valores de las políticas.
Devin Desktop lee las políticas desde /etc/windsurf/policies/policy.json, mientras que VS Code usa /etc/vscode/policy.json. Asegúrese de colocar el archivo en la ubicación correcta para Devin Desktop.

Paso 1: Obtener el archivo de políticas de ejemplo

Cada versión de Devin Desktop incluye un archivo policy.json de ejemplo. Puedes obtenerlo de una instalación existente; se encuentra en el directorio resources/app/policies dentro de la ruta de instalación de Devin Desktop.

Paso 2: Configurar los valores de la política

  1. Copie el archivo de ejemplo policy.json en una ubicación de trabajo:
sudo cp /path/to/windsurf/resources/app/policies/policy.json /tmp/policy.json
  1. Edita el archivo con tu editor de texto preferido:
sudo nano /tmp/policy.json
  1. Configure los valores de la política. Por ejemplo, para permitir solo determinados publicadores de extensiones:
{
  "AllowedExtensions": "{\"publisher1\": true, \"publisher2\": true}",
  "UpdateMode": "manual"
}

Paso 3: Implementa las políticas

Despliegue a escala

Para despliegues de Linux en entornos empresariales en múltiples dispositivos, usa herramientas de gestión de configuración como Ansible, Puppet, Chef o Salt para implementar el archivo policy.json. Estas herramientas permiten a los administradores implementar, actualizar y eliminar políticas de forma remota en todos los dispositivos Linux gestionados.

Probar manualmente las políticas en una máquina local

  1. Cree el directorio de políticas y copie el archivo:
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
Necesitas privilegios de root o sudo para crear el directorio y gestionar los archivos de políticas en /etc/windsurf/policies.
  1. Verifica la instalación de las políticas:
    • Inicia Devin Desktop (o reinícialo si ya se está ejecutando).
    • Abre File > Preferences > Settings (o pulsa Ctrl+,).
    • Busca ajustes que correspondan a las políticas que has configurado; deberían aparecer como gestionados por tu organización o mostrar un icono de candado.

Eliminar políticas

Para eliminar todas las políticas y restaurar la configuración predeterminada, elimina el archivo /etc/windsurf/policies/policy.json y reinicia Devin Desktop.

Políticas de gestión de extensiones

Uno de los usos más comunes de las políticas de Enterprise es controlar qué extensiones pueden instalar los usuarios. La política AllowedExtensions permite a los administradores definir una lista de publicadores de extensiones permitidos.

AllowedExtensions

La política AllowedExtensions acepta una cadena JSON que especifica qué publicadores de extensiones están permitidos. Cuando esta política está activa, los usuarios solo pueden instalar extensiones de los publicadores indicados en la lista. Valor de ejemplo:
{"windsurf": true, "github": true, "ms-python": true}
Esto se puede configurar mediante cualquiera de los mecanismos específicos de cada plataforma descritos anteriormente:
  • Windows: Se configura mediante plantillas ADMX de Directiva de grupo o directamente en el registro, en Software\Policies\Windsurf\{ProductName}.
  • macOS: Se configura en un perfil de configuración .mobileconfig.
  • Linux: Se configura en /etc/windsurf/policies/policy.json.
Cuando se aplica la política AllowedExtensions, la vista Extensiones de Devin Desktop indica que la configuración está gestionada por tu organización y que los usuarios no pueden anularla.

Recursos adicionales