# Installer StackX OpenSSH sur Debian 11 Bullseye

> Révision de cette livraison : `1:8.4p1-5+deb11u7+sx8`. Avant de modifier un serveur, vérifier la disponibilité du canal, sa signature et la simulation APT de cette révision exacte.

Le canal `https://mirrors.scalarx.net/stackx-openssh/bullseye/` concerne uniquement Debian 11 amd64. Lire [README.md](README.md), notamment les conditions GSSAPI/PAM, les tunnels, les restrictions certificat/clé et le rekey client.

Le script d'ajout du dépôt exige les commandes `gpg`, `gpgv` et `apt-get`, l'exécutable `/usr/lib/apt/apt-helper`, la méthode APT HTTPS et un magasin de certificats TLS dans `/etc/ssl/certs/ca-certificates.crt`. Vérifier ces prérequis sur les installations minimales et, s'ils manquent, les obtenir d'un dépôt Debian de confiance avant d'exécuter le script. Celui-ci s'arrête avant d'ajouter le canal si un prérequis est absent.

`+sx8` conserve par défaut le fichier `/etc/ssh/sshd_config` lorsqu'il existe et qu'aucune politique UCF n'est définie. Relever avant l'installation son empreinte et les paramètres effectifs, notamment le port d'écoute. Une variable UCF explicite ou toute ligne active dans `/etc/ucf.conf` laisse `ucf` appliquer sa politique habituelle, avec question ou remplacement possible ; contrôler cette politique avant la simulation. Après l'installation, vérifier à nouveau le contenu du fichier. Si `ucf` a conservé l’ancien fichier malgré un changement de modèle fournisseur, vérifier la présence de `/etc/ssh/sshd_config.ucf-dist` et comparer les nouveaux réglages si cette copie existe. Si `sshd_config` est un lien symbolique valide, vérifier aussi une éventuelle copie `.ucf-dist` à côté de sa cible réelle ; c’est le chemin observé dans les trois essais VM. Exécuter `sshd -t`, vérifier le port effectivement configuré et ouvrir une nouvelle connexion avant de fermer la session conservée.

Dans le banc de qualification actuel, le redémarrage automatique d'OpenSSH pendant la mise à niveau sous systemd a été testé sur Buster seulement. Il n'a pas été testé sous systemd sur Stretch ni Bullseye, faute de base adaptée dans ce banc. Avant un déploiement général, ces parcours restent à qualifier sur les futures VM StackX représentatives de chaque génération, avec une confirmation sur Buster.

## Avant la mise à jour

Conserver une session d'administration déjà ouverte et un accès de secours hors SSH. Sauvegarder les clés hôtes, `/etc/ssh/`, les versions exactes et les anciens DEB utilisables pour revenir en arrière. Sur une copie de la configuration réelle, qualifier les blocs `Match`, les restrictions de clés/certificats, les forwards, SFTP, PAM, GSSAPI et les clients qui renouvellent fréquemment leurs clés. L'installation d'`openssh-server` peut redémarrer `sshd` par ses scripts de paquet.

La garde seccomp fail-closed fait partie de cette livraison. Qualifier chaque type de noyau ou conteneur avec accès console : `sshd -t` seul ne prouve pas que le filtre pré-authentification peut s'installer.

Contrôles en lecture seule sur la machine cible :

```sh
cat /etc/debian_version
dpkg --print-architecture
dpkg-query -W -f='${Package} ${Version}\n' openssh-client openssh-server openssh-sftp-server ssh
/usr/sbin/sshd -t
/usr/sbin/sshd -T
ssh -V
```

Le script `add-stackx-openssh-repo.sh` vérifie Debian 11 amd64, TLS, l'empreinte de la clé APT historique, `InRelease` et l'index `Packages`, puis ajoute uniquement ce canal avec `signed-by`. Il n'installe aucun paquet OpenSSH et ne relance pas SSH. Lire le script avant de l'exécuter. Depuis le répertoire contenant les trois fichiers de ce canal, l'ajouter puis vérifier les versions complètes proposées et simuler les quatre paquets ensemble :

```sh
sudo ./add-stackx-openssh-repo.sh
```

```sh
apt-cache policy openssh-client openssh-server openssh-sftp-server ssh openssh-tests
sudo apt-get --simulate --no-remove install \
  'openssh-client=1:8.4p1-5+deb11u7+sx8' 'openssh-server=1:8.4p1-5+deb11u7+sx8' \
  'openssh-sftp-server=1:8.4p1-5+deb11u7+sx8' 'ssh=1:8.4p1-5+deb11u7+sx8'
```

Si la simulation retire un paquet, mélange des révisions ou exige un autre dépôt inattendu, arrêter. `openssh-tests` est aussi indexé ; s'il est installé, simuler son passage à la même révision et vérifier ses dépendances avant l'installation. Le script de dépôt n'installe aucun paquet. Une fois la configuration et la simulation qualifiées en VM puis sur un hôte pilote, installer pendant une fenêtre prévue avec accès de secours. Vérifier `sshd -t`, ouvrir **une nouvelle connexion** et tester les usages locaux avant de fermer la session conservée. Vérifier les révisions installées par `dpkg-query` ; elles ne prouvent pas à elles seules quelle instance de `sshd` traite les connexions.

Pour un retour arrière, utiliser les anciennes révisions exactes de la même distribution et simuler les quatre paquets ensemble depuis une source de confiance. Restaurer la configuration sauvegardée si nécessaire, puis tester une nouvelle connexion. Ne jamais mélanger arbitrairement les binaires client, serveur et SFTP de deux révisions.
