Document quick temporary SSH access
Config Central CI Config Central passed all CI integrity checks.
Beffroi/config-central/pipeline/head This commit looks good
Details
Config Central CI Config Central passed all CI integrity checks.
Beffroi/config-central/pipeline/head This commit looks good
Details
This commit is contained in:
parent
11971ae7a7
commit
e01df5b988
|
|
@ -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
|
||||
|
|
|
|||
|
|
@ -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
|
||||
|
|
|
|||
Loading…
Reference in New Issue