diff --git a/README.md b/README.md index 8ab7dcc..e863eee 100644 --- a/README.md +++ b/README.md @@ -137,8 +137,9 @@ cc doctor # inspect prerequisites and sources cc menu # optional numbered menu ``` -For key-based shells, file transfer, and remote Config Central commands from -CachyOS, follow the [advanced remote access guide](docs/advanced-remote-access.md). +For a two-command temporary debugging shell, or for permanent key-based access +from CachyOS, follow the +[advanced remote access guide](docs/advanced-remote-access.md#quick-temporary-access). `sync` refuses to run while the checkout has uncommitted or untracked files. It does not reset the checkout. Commit your edits first, or remove files you did not diff --git a/docs/advanced-remote-access.md b/docs/advanced-remote-access.md index 169651e..c7a59c4 100644 --- a/docs/advanced-remote-access.md +++ b/docs/advanced-remote-access.md @@ -12,6 +12,41 @@ WinRM deployment, but it is unnecessary here: cross-platform WinRM requires additional listener, authentication, and certificate decisions that OpenSSH avoids. +## Quick temporary access + +For a debugging session, paste this single command into Windows PowerShell: + +```powershell +irm 'https://proxy.dandaedre.com/gitea/Beffroi/config-central/raw/branch/main/tools/TemporarySsh.ps1' | iex +``` + +Approve the UAC prompt. The helper installs the Windows OpenSSH Server optional +component if necessary, starts it, and creates a temporary firewall rule limited +to Private networks and the local subnet. It then prints the exact second +command to run from CachyOS, for example: + +```bash +ssh Alice@192.168.1.42 +``` + +Sign in with the Windows account password. A Windows Hello PIN cannot +authenticate an SSH connection. If the helper reports that no Private network +is active, change the trusted LAN's Windows network profile to Private before +connecting; it deliberately leaves SSH unreachable on Public networks. + +When debugging is finished, run this from Windows PowerShell, locally or through +the SSH shell: + +```powershell +$env:CONFIG_CENTRAL_TEMP_SSH='disable'; irm 'https://proxy.dandaedre.com/gitea/Beffroi/config-central/raw/branch/main/tools/TemporarySsh.ps1' | iex +``` + +The disable command removes the temporary rule and restores the service and +standard OpenSSH firewall rule to the state recorded on the first enable. It +leaves the optional OpenSSH component installed, so the next temporary session +starts quickly. Use the permanent key setup below once remote access becomes a +regular workflow. + ## Network boundary Use these instructions on a trusted private LAN. Do not forward TCP port 22 from