Configurar la imposición del inicio de sesión

Puedes imponer el inicio de sesión para Docker Desktop utilizando varios métodos. Elige el método que mejor se adapte a la infraestructura y los requisitos de seguridad de tu organización.

Elige tu método

Tip

Para Mac, los perfiles de configuración ofrecen la mayor seguridad porque están protegidos por la Protección de Integridad del Sistema (System Integrity Protection - SIP) de Apple.

Windows: Método de clave de registro

Mac: Método de perfiles de configuración (recomendado)

Los perfiles de configuración proporcionan el método de imposición más seguro para Mac, ya que están protegidos por la Protección de Integridad del Sistema de Apple.

La carga útil (payload) es un diccionario de valores clave. Docker Desktop admite las siguientes claves:

• allowedOrgs: Establece una lista de organizaciones en una sola cadena, donde cada organización está en minúsculas y separada por un punto y coma.
• overrideProxyHTTP: Establece la URL del proxy HTTP que debe usarse para las solicitudes HTTP salientes.
• overrideProxyHTTPS: Establece la URL del proxy HTTP que debe usarse para las solicitudes HTTPS salientes.
• overrideProxyExclude: Omite la configuración del proxy para los hosts y dominios especificados. Utiliza una lista separada por comas.
• overrideProxyPAC: Establece la ruta del archivo donde se encuentra el archivo PAC. Tiene precedencia sobre el archivo PAC remoto en el proxy seleccionado.
• overrideProxyEmbeddedPAC: Establece el contenido de un archivo PAC en memoria. Tiene precedencia sobre overrideProxyPAC.

Anular al menos uno de los ajustes de proxy a través de los perfiles de configuración bloqueará automáticamente los ajustes, ya que serán gestionados por Mac.

1. Crea un archivo llamado docker.mobileconfig e incluye el siguiente contenido:

   <?xml version="1.0" encoding="UTF-8"?>
   <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
   <plist version="1.0">
   <dict>
      <key>PayloadContent</key>
      <array>
         <dict>
            <key>PayloadType</key>
            <string>com.docker.config</string>
            <key>PayloadVersion</key>
            <integer>1</integer>
            <key>PayloadIdentifier</key>
            <string>com.docker.config</string>
            <key>PayloadUUID</key>
            <string>eed295b0-a650-40b0-9dda-90efb12be3c7</string>
            <key>PayloadDisplayName</key>
            <string>Docker Desktop Configuration</string>
            <key>PayloadDescription</key>
            <string>Configuration profile to manage Docker Desktop settings.</string>
            <key>PayloadOrganization</key>
            <string>Your company name</string>
            <key>allowedOrgs</key>
            <string>first_org;second_org</string>
            <key>overrideProxyHTTP</key>
            <string>http://company.proxy:port</string>
            <key>overrideProxyHTTPS</key>
            <string>https://company.proxy:port</string>
         </dict>
      </array>
      <key>PayloadType</key>
      <string>Configuration</string>
      <key>PayloadVersion</key>
      <integer>1</integer>
      <key>PayloadIdentifier</key>
      <string>com.yourcompany.docker.config</string>
      <key>PayloadUUID</key>
      <string>0deedb64-7dc9-46e5-b6bf-69d64a9561ce</string>
      <key>PayloadDisplayName</key>
      <string>Docker Desktop Config Profile</string>
      <key>PayloadDescription</key>
      <string>Config profile to enforce Docker Desktop settings for allowed organizations.</string>
      <key>PayloadOrganization</key>
      <string>Your company name</string>
   </dict>
   </plist>

2. Reemplaza los marcadores de posición:
   • Cambia com.yourcompany.docker.config por el identificador de tu empresa
   • Reemplaza Your company name por el nombre de tu organización, asegurándote de que esté todo en minúsculas
   • Reemplaza PayloadUUID por un UUID generado aleatoriamente
   • Actualiza el valor allowedOrgs con los nombres de tus organizaciones (separados por punto y coma)
   • Reemplaza company.proxy:port con el host (o dirección IP) y puerto del servidor proxy http/https
3. Despliega el perfil utilizando tu solución de MDM.
4. Verifica que el perfil aparezca en Ajustes del Sistema > General > Gestión de dispositivos en Dispositivo (gestionado). Asegúrate de que el perfil aparezca con el nombre y los ajustes correctos.

Algunas soluciones de MDM te permiten especificar la carga útil como un diccionario simple de ajustes de clave-valor sin el contenedor .mobileconfig completo:

<dict>
   <key>allowedOrgs</key>
   <string>first_org;second_org</string>
   <key>overrideProxyHTTP</key>
   <string>http://company.proxy:port</string>
   <key>overrideProxyHTTPS</key>
   <string>https://company.proxy:port</string>
</dict>

Mac: Método de archivo plist

#!/bin/bash

# Crear el directorio si no existe
sudo mkdir -p "/Library/Application Support/com.docker.docker"

# Escribir el archivo plist
sudo defaults write "/Library/Application Support/com.docker.docker/desktop.plist" allowedOrgs -array "myorg1" "myorg2"

# Establecer los permisos adecuados
sudo chmod 644 "/Library/Application Support/com.docker.docker/desktop.plist"
sudo chown root:admin "/Library/Application Support/com.docker.docker/desktop.plist"

Todas las plataformas: Método registry.json

El método registry.json funciona en todas las plataformas y ofrece opciones de despliegue flexibles.

Ubicaciones de los archivos

Crea el archivo registry.json (UTF-8 sin BOM) en la ubicación correspondiente:

Configuración básica

Set-Content /ProgramData/DockerDesktop/registry.json '{"allowedOrgs":["myorg1","myorg2"]}'

sudo mkdir -p "/Library/Application Support/com.docker.docker"
echo '{"allowedOrgs":["myorg1","myorg2"]}' | sudo tee "/Library/Application Support/com.docker.docker/registry.json"

sudo mkdir -p /usr/share/docker-desktop/registry
echo '{"allowedOrgs":["myorg1","myorg2"]}' | sudo tee /usr/share/docker-desktop/registry/registry.json

# PowerShell
Start-Process '.\Docker Desktop Installer.exe' -Wait 'install --allowed-org=myorg'

# Símbolo del sistema (Command Prompt)
"Docker Desktop Installer.exe" install --allowed-org=myorg1

sudo hdiutil attach Docker.dmg
sudo /Volumes/Docker/Docker.app/Contents/MacOS/install --allowed-org=myorg
sudo hdiutil detach /Volumes/Docker

Precedencia de los métodos

Cuando existen múltiples métodos de configuración en el mismo sistema, Docker Desktop utiliza este orden de precedencia:

1. Clave de registro (solo Windows)
2. Perfiles de configuración (solo Mac)
3. Archivo plist (solo Mac)
4. Archivo registry.json

Solución de problemas de la imposición del inicio de sesión

Si la imposición del inicio de sesión no funciona:

• Verifica las ubicaciones y los permisos de los archivos
• Comprueba que los nombres de las organizaciones utilicen letras minúsculas
• Reinicia Docker Desktop o reinicia el sistema
• Confirma que los usuarios sean miembros de las organizaciones especificadas
• Actualiza Docker Desktop a la versión más reciente