Tutorial de Debian 13 / Configurar repositorios deb822 y verificar firmas con Signed-By

Debian 13 almacena las definiciones del repositorio de Advanced Package Tool (APT) en /etc/apt/sources.list y en archivos bajo /etc/apt/sources.list.d. Un archivo .sources en formato deb822 agrupa cada definición de repositorio en campos con nombre. Al convertir una configuración existente, conserve sus direcciones, ramas de la distribución, componentes y claves autorizadas para verificar firmas; desactive las entradas antiguas duplicadas y después actualice los índices y compare las versiones candidatas.

Inspeccionar el formato actual de los repositorios

Utilice la VM Debian 13 del laboratorio de instalación y eliminación de paquetes APT . Las definiciones de repositorio controlan tanto las fuentes de paquetes como la confianza. No copie repositorios de Ubuntu ni la configuración de otra versión de Debian.

cat /etc/os-release
ls -l /etc/apt/sources.list
find /etc/apt/sources.list.d -maxdepth 1 -type f -print
cat /etc/apt/sources.list
apt-cache policy bash

Si ya existe un archivo .sources, lea el archivo para verificar repositorios válidos. En entornos donde las direcciones de repositorios privados incluyen información de autenticación, no comparta todo el archivo externamente. Es posible tener una configuración sin /etc/apt/sources.list, por lo que no se debe asumir que no hay repositorios solo porque el archivo falte.

El registro original del curso corresponde a Debian 13.7 con APT 3.0.3. El instalador creó entradas de una sola línea deb y deb-src en sources.list, y sources.list.d estaba vacío. El procedimiento de conversión descrito aquí se dirige a ese estado. Si ya existe una configuración deb822 adecuada, no cree un nuevo archivo duplicado y, en su lugar, revise los campos del archivo actual.

Leer los campos deb822 y los componentes del repositorio

deb822 es un formato que escribe un repositorio como un conjunto de nombres de campos y valores. Un conjunto está separado por una línea en blanco. Dado que no es ni YAML ni un script de shell, no se ejecuta un archivo .sources con bash. manual de sources.list explica tanto el formato de una sola línea de .list como el formato deb822 de .sources.

Campos Roles Selección de Ejemplo
Types Tipos de Listas de Paquetes Binarios y de Fuente deb solicita índices de paquetes binarios; deb-src solicita índices de paquetes de fuente.
URIs Dirección Base del Repositorio Distingue entre archivos generales y repositorios de seguridad.
Suites Rama de lanzamiento/actualización Usa trixie, trixie-updates, trixie-security.
Components Área de archivo a consultar Conserva los componentes existentes main y non-free-firmware.
Signed-By Conjunto de claves (keyring) utilizado para verificar este repositorio Ruta absoluta del conjunto instalado de claves del archivo Debian.

Separe múltiples valores de campo con espacios en blanco, no con comas. Por ejemplo, los dos valores de Suites comparten un único campo separado por espacios. La directiva Enabled: no deshabilita todo el bloque en un archivo .sources, incluyendo cada suite que define. Elimine ese campo o cámbielo a yes para volver a habilitar el bloque. Revise todas las definiciones activas para que el repositorio de seguridad no quede deshabilitado por error.

Para mantener Debian 13, una configuración que especifique el nombre en clave trixie deja clara la intención en lugar de usar un nombre en movimiento como stable. Incluso después de que una nueva Debian se vuelva estable, trixie sigue refiriéndose a la misma versión. trixie-updates es la rama de actualizaciones de la versión estable, y trixie-security es la rama de actualizaciones de seguridad. Cambiar el nombre en clave está vinculado al plan de actualización de la distribución, por lo que no debe cambiarse arbitrariamente para evitar errores en los repositorios.

Área Criterios de Clasificación Confirmar cuando se selecciona
main El área de esta distribución que cumple con las directrices de software libre de Debian (Debian Free Software Guidelines, DFSG) El núcleo de la configuración del paquete por defecto.
contrib Un área donde el software en sí cumple con las directrices de software libre pero puede depender de componentes fuera de main Verificar los programas y dependencias necesarios.
non-free Software que no cumple con las directrices de software libre Verificar la licencia y las políticas organizacionales.
non-free-firmware Área de firmware no libre aislada por separado Verificar el firmware requerido para el dispositivo y las condiciones de distribución.

La distinción entre estas áreas se puede encontrar en descripción de las áreas del archivo en la política Debian. Que se necesite firmware no significa que todas las áreas no libres deban ser añadidas automáticamente. Este ejemplo conserva la selección existente del instalador tal como está.

Respaldar definiciones y registrar un candidato a paquete

El directorio de respaldo no debe existir ya. Si existe, elija un nombre nuevo y ajuste cada ruta de recuperación de manera consistente. Ejecute la primera línea por separado y continúe solo si tiene éxito; también deténgase si la copia o cualquier verificación de archivo de destino falla. No proceda a la edición sin un respaldo utilizable.

sudo test ! -e /var/backups/lf-debian13-10 && sudo install -d -m 700 /var/backups/lf-debian13-10
sudo cp -a /etc/apt/sources.list /etc/apt/sources.list.d /var/backups/lf-debian13-10/
apt-cache policy bash | sudo tee /var/backups/lf-debian13-10/bash-policy-before.txt
sudo test ! -e /etc/apt/sources.list.d/debian.sources
ls -l /usr/share/keyrings/debian-archive-keyring.gpg
sudo -u _apt test -r /usr/share/keyrings/debian-archive-keyring.gpg && printf 'APT account can read the keyring\n'

Si debian.sources ya existe, no lo sobrescriba. El anillo de claves lo proporciona el paquete debian-archive-keyring, y en esta VM la ruta .gpg era un enlace que apuntaba a un archivo .pgp. Lo importante es si la cuenta _apt puede leer realmente el anillo de claves público especificado. Si el archivo de claves falta o está dañado, no eluda el problema importando una clave no verificada; en su lugar, verifique los paquetes y materiales de recuperación adecuados.

El registro de la versión candidata del paquete bash permite detectar cambios involuntarios en la selección provocados por la conversión. Incluso si un paquete es el mismo, no prueba que todas las políticas de paquetes sean idénticas, así que también compare la dirección del repositorio, la rama y los componentes.

Escribir el archivo deb822 completo y desactivar las entradas antiguas

Abra un nuevo archivo con el siguiente comando. Continúe solo tras confirmar que el archivo de destino no existe y que la copia de seguridad ha finalizado correctamente.

sudo nano /etc/apt/sources.list.d/debian.sources

Introduzca todo el contenido siguiente, guarde con Ctrl+O y Enter y salga con Ctrl+X. Los repositorios general y de actualizaciones comparten dirección; el de seguridad forma un bloque separado. Mantenga una línea vacía entre ambos bloques.

Types: deb deb-src
URIs: http://deb.debian.org/debian
Suites: trixie trixie-updates
Components: main non-free-firmware
Signed-By: /usr/share/keyrings/debian-archive-keyring.gpg

Types: deb deb-src
URIs: http://security.debian.org/debian-security
Suites: trixie-security
Components: main non-free-firmware
Signed-By: /usr/share/keyrings/debian-archive-keyring.gpg

La razón para incluir deb-src en Types es preservar la funcionalidad existente de la lista de fuentes. Los servidores que no descargan ni construyen fuentes pueden usar solo deb según sea necesario, pero esa elección es independiente de la conversión de formato. Coloque las direcciones de los repositorios en URIs y la ruta del llavero correspondiente en Signed-By; no utilice el conjunto de claves de otra distribución.

sudo chmod 644 /etc/apt/sources.list.d/debian.sources
sudo nano /etc/apt/sources.list

Comente las líneas deb y deb-src de Debian que se trasladaron del sources.list existente al nuevo archivo para desactivarlas. No elimine las entradas para otros propósitos sin una revisión separada. Por ejemplo, cambie el existente deb http://deb.debian.org/debian trixie main non-free-firmware a un comentario. Si la entrada del cdrom existente ya está comentada, déjela como está.

Si el mismo repositorio está activado simultáneamente en los archivos .list y .sources, pueden ocurrir advertencias de duplicados o conflictos de valores Signed-By. Si guarda el nombre del archivo como .sources.txt, APT no lo leerá como el formato que espera, así que también verifique la extensión.

Actualizar listas y comparar la selección de paquetes

La siguiente operación no actualiza los paquetes instalados. Primero se comprueba si las definiciones del repositorio y la verificación de la firma se procesan correctamente.

sudo apt update
apt-cache policy bash | sudo tee /var/backups/lf-debian13-10/bash-policy-after.txt
sudo diff -u /var/backups/lf-debian13-10/bash-policy-before.txt /var/backups/lf-debian13-10/bash-policy-after.txt
sudo apt-get -s install tree

En el ensayo original, el procesamiento de InRelease para trixie, trixie-updates y trixie-security pasó correctamente. La comparación de candidato y prioridad para bash pasó sin diferencias, y una instalación simulada de tree también creó un plan normalmente. Si se publican versiones durante la operación, los valores pueden diferir. Examine las fuentes y versiones para distinguir un cambio del repositorio de un efecto de la conversión.

Una actualización puede fallar parcialmente mientras los comandos posteriores continúan usando listas de paquetes más antiguas. No se limite a mirar la última línea; revise errores de firma, fallos de descarga y advertencias de duplicados. Si un repositorio fallido es un repositorio de seguridad, la operación no se marca como completa solo porque se puedan encontrar paquetes existentes.

Entender Signed-By y la confianza del repositorio

Signed-By limita el rango de claves públicas utilizadas para verificar los metadatos del repositorio. El hecho de que exista un archivo de clave y que la firma del repositorio se verifique correctamente son cosas diferentes. El manual de apt-secure explica el sistema de verificación usando información Release firmada y hashes de paquetes. La confianza en el repositorio también es distinta de una garantía de que todas las operaciones de paquetes sean inofensivas.

Este ejemplo mantiene la dirección HTTP oficial del instalador y utiliza la verificación de firmas. HTTPS proporciona protección separada para el segmento de transmisión, pero no reemplaza la verificación de firmas. Las organizaciones que usan HTTPS deberían aplicarlo de manera consistente verificando la confianza del certificado y las políticas de proxy.

Al agregar repositorios de proveedores externos, verifique si Debian 13 es compatible, la URL oficial de publicación de paquetes, la huella digital de la clave y la ruta de la distribución. Las claves almacenadas por el administrador pueden estar separadas en /etc/apt/keyrings, y las claves administradas por paquetes pueden estar en /usr/share/keyrings. No conceda confianza global a claves externas arbitrarias ni desactive la verificación de firmas, por ejemplo con Trusted: yes, para eludir un problema. Tampoco es necesario copiar el antiguo procedimiento apt-key add para obtener las claves del repositorio predeterminado para Debian 13.

Para errores de clave de firma, verifique la ruta Signed-By, los permisos de lectura, la clave exacta y el repositorio; para errores de período de validez del Release, verifique el reloj del servidor y el estado del repositorio. El método para verificar la hora puede seguir los criterios explicados en Distinguir zonas horarias y sincronización real. No desactive las comprobaciones de fecha o validez sin determinar la causa.

Restaurar las definiciones originales de los repositorios

La restauración siguiente se aplica únicamente al estado inicial de este ejemplo: las definiciones estaban en sources.list y debian.sources se añadió durante el ejercicio. Antes de restaurar, compare con una copia de seguridad para verificar que no haya habido otros cambios legítimos. Si un archivo .sources que ya estaba en funcionamiento fue modificado, debe restaurar individualmente la copia de seguridad de ese archivo.

sudo cp -a /var/backups/lf-debian13-10/sources.list /etc/apt/sources.list
sudo rm -- /etc/apt/sources.list.d/debian.sources
sudo apt update
apt-cache policy bash

Elimine solo el nuevo archivo debian.sources; conserve el resto de sources.list.d. En el ensayo original, el sources.list restaurado coincidió byte a byte con el original y la posterior actualización de la lista fue exitosa. Convertir el formato del repositorio no revierte los paquetes instalados a versiones anteriores. Cualquier actualización de paquetes realizada posteriormente requiere su propio plan de recuperación.