https://github.com/countzero/repair_ssh_permissions
A PowerShell script that automatically repairs the permissions of the .ssh directory and files.
https://github.com/countzero/repair_ssh_permissions
openssh powershell repair-ssh-permissions ssh windows
Last synced: 4 months ago
JSON representation
A PowerShell script that automatically repairs the permissions of the .ssh directory and files.
- Host: GitHub
- URL: https://github.com/countzero/repair_ssh_permissions
- Owner: countzero
- License: mit
- Created: 2021-03-15T19:24:35.000Z (about 4 years ago)
- Default Branch: main
- Last Pushed: 2024-02-12T07:39:50.000Z (about 1 year ago)
- Last Synced: 2024-08-14T07:06:54.909Z (8 months ago)
- Topics: openssh, powershell, repair-ssh-permissions, ssh, windows
- Language: PowerShell
- Homepage:
- Size: 15.6 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- jimsghstars - countzero/repair_ssh_permissions - A PowerShell script that automatically repairs the permissions of the .ssh directory and files. (PowerShell)
README
# Repair the permissions of the .ssh directory and files
The best practice configuration for the personal .ssh directory is to restrict all access to the corresponding local user. This will be enforced by [OpenSSH](https://www.openssh.com/) and any misconfiguration will result in OpenSSH ignoring the .ssh directory contents with a warning.
This PowerShell script automatically repairs the permissions of the `.ssh` directory and files. It does the following for all items within and including the given `.ssh` directory:
* Disables inheritance
* Sets ownership to one user
* Removes all permissions
* Grants one user full control
## Installation
Download and unpack the [latest release](https://github.com/countzero/repair_ssh_permissions/releases/latest) to your machine.
## Usage
Open a PowerShell console at the location of the unpacked release and execute the [./repair_ssh_permissions.ps1](https://github.com/countzero/repair_ssh_permissions/blob/main/repair_ssh_permissions.ps1).
**Hint:** If you are running into an `SeSecurityPrivilege` error execute the command with administrator privileges.
## Examples
### Repair the current users default .ssh directory
Execute the following command to repair the '%USERPROFILE%/.ssh' directory (and all items within) for the current Windows user.
```PowerShell
.\repair_ssh_permissions.ps1
```
> [!NOTE]
> The script will automatically elevate itself to administrator privileges.
### Repair a specific .ssh directory for a specific user
Execute the following command with to repair a specific directory for a specific local Windows user.
```PowerShell
.\repair_ssh_permissions.ps1 -path "X:\unsual\path\to\.ssh" -user "John Doe"
```
### Get detailed help
Execute the following command to get detailed help.
```PowerShell
Get-Help .\repair_ssh_permissions.ps1 -detailed
```