pyssh-client/app/openssh/config.py

"""Lecture de ~/.ssh/config (format OpenSSH), via paramiko.SSHConfig.

Support minimum couvert : Host, HostName, User, Port, IdentityFile, ProxyJump,
ForwardAgent, ServerAliveInterval, ServerAliveCountMax.

Le ProxyJump detecte ici est seulement affiche/reporte pour l'instant : la
connexion via un jump host est prise en charge par le module dedie (bastion),
pas par ce module qui ne fait que lire la configuration.
"""
from __future__ import annotations

from dataclasses import dataclass, field
from pathlib import Path

import paramiko

from app.session_manager import AUTH_AUTO, AUTH_KEY, BASTION_OPENSSH, BastionConfig, Session


@dataclass
class OpenSSHHost:
    alias: str
    hostname: str = ""
    user: str = ""
    port: int = 22
    identity_files: list[str] = field(default_factory=list)
    proxy_jump: str = ""
    forward_agent: bool = False
    server_alive_interval: int | None = None
    server_alive_count_max: int | None = None

    @property
    def display_target(self) -> str:
        target = self.hostname or self.alias
        return f"{target}:{self.port}" if self.port != 22 else target


def default_config_path() -> Path:
    return Path.home() / ".ssh" / "config"


def _as_int(value: str | None) -> int | None:
    try:
        return int(value) if value is not None else None
    except (TypeError, ValueError):
        return None


def load_openssh_hosts(path: Path | None = None) -> list[OpenSSHHost]:
    """Renvoie les Host detectes dans le fichier, tries par alias.

    Un fichier absent (tres courant : rien ne force un utilisateur Windows a en
    avoir un) n'est pas une erreur : la liste est simplement vide."""
    path = path or default_config_path()
    if not path.exists():
        return []

    parser = paramiko.SSHConfig()
    try:
        with open(path, encoding="utf-8", errors="replace") as f:
            parser.parse(f)
    except OSError:
        return []

    hosts: list[OpenSSHHost] = []
    for alias in parser.get_hostnames():
        # "*" et les motifs (glob) ne designent pas un hote precis auquel se
        # connecter, seulement des valeurs par defaut a fusionner dans les autres.
        if alias == "*" or "*" in alias or "?" in alias:
            continue
        looked_up = parser.lookup(alias)
        hosts.append(OpenSSHHost(
            alias=alias,
            hostname=looked_up.get("hostname", alias),
            user=looked_up.get("user", ""),
            port=_as_int(looked_up.get("port")) or 22,
            identity_files=list(looked_up.get("identityfile", []) or []),
            proxy_jump=looked_up.get("proxyjump", ""),
            forward_agent=str(looked_up.get("forwardagent", "")).lower() == "yes",
            server_alive_interval=_as_int(looked_up.get("serveraliveinterval")),
            server_alive_count_max=_as_int(looked_up.get("serveralivecountmax")),
        ))
    hosts.sort(key=lambda h: h.alias.lower())
    return hosts


def session_from_openssh_host(host: OpenSSHHost) -> Session:
    """Convertit un Host OpenSSH en Session PySSH (utilisation directe ou import).

    Si ProxyJump est present, le bastion resultant reference l'alias OpenSSH
    correspondant (mode BASTION_OPENSSH) : il sera resolu et applique a la
    connexion par app.bastion, tant que cet alias reste present dans
    ~/.ssh/config (voir app.bastion.resolve_bastion_target)."""
    session = Session(
        name=host.alias,
        group="OpenSSH",
        host=host.hostname or host.alias,
        port=host.port,
        username=host.user,
    )
    if host.identity_files:
        session.auth_type = AUTH_KEY
        session.key_path = str(Path(host.identity_files[0]).expanduser())
    else:
        session.auth_type = AUTH_AUTO

    notes = [f"Importe depuis ~/.ssh/config (Host {host.alias})."]
    if host.proxy_jump:
        session.bastion = BastionConfig(mode=BASTION_OPENSSH, openssh_alias=host.proxy_jump)
        notes.append(f"ProxyJump vers « {host.proxy_jump} » (voir section Bastion / Jump Host).")
    session.notes = "\n".join(notes)
    return session