move files under src folder

src/SSH-key-auth-win.md

@@ -0,0 +1,141 @@
+# SSH авторизация по ключам
+
+В интернете можно найти множество иснтрукций о том как настроить *ssh авторизацию по ключам* для использования с репозиториями, удаленным администрированием, различными программами контроля версий и т.д.
+Встречаются даже такие извращения как использование Putty агента в связке с Tortoise Git на основе Putty сессий. Варианты с генерацией ключа с помощью Putty, конвертирование из одного формата в другой и подсовывание в Tortoise Git я, изрядно измучившись, тоже выкинул. Даже на самом GitHub лежит мануал с использованием агента ключей.
+
+Перелопатив кучу мануалов я решил что мне нужен универсальный способ. И похоже мне удалось такой найти. 
+
+Итак, мне нужно чтобы работало:
+* из любых терминалов (cmd, PowerShell, Git-bash, Git-cmd)
+* с любыми shell (cmd, sh, bash, zsh т.д.)
+* c любыми встроенными в терминалы или shell утилитами (ssh, scp, sftp и т.д.)
+* со всеми репозиториями (GitHub, GitLab, Gitea)
+* с различными GUI (TortoiseGit, VSCode, Altium Designer и пр.)
+* без использования агентов ключей (ssh-agent или Putty)
+* одинаково настраивалось как в Windows, так и в Linux.
+* на одну машину должен приходиться один ключ, чтобы не настраивать отдельно для каждой утилиты/приложения/IDE
+* один ключ для работы с репозиториями и доступом к удаленным серверам
+
+Как оказалось чтобы все это реализовать нужно было не гуглить мануалы, а читать **man ssh**. 
+
+---
+
+Для работы с SSH в windows будем использовать OpenSSH. Ставить отдельно его не надо т.к. OpenSSH идет в комплекте с Git. Ставим его в первую очередь.
+
+Если же Git уже установлен, то идем дальше...
+
+---
+
+### 1. Открываем терминал и создаем ключ нашей локальной системы.
+
+```
+$ ssh-keygen -t rsa
+```
+На все вопросы нажимаем "Enter", отказываясь от ключевой фразы.
+
+Как результат в домашней папке пользователя будет создана ключевая пара:
+- .ssh/id_rsa (закрытый ключ)
+- .ssh/id_rsa.pub (открытый ключ)
+
+Закрытый ключ мы не трогаем. Он секретный и остается только на этой машние.
+Открытый ключ мы используем для помещения в репозитории и удаленные сервера.
+
+---
+
+### 2. Добавляем ключ в ~/.ssh/config
+
+Поскольку мы не будем пользоваться никакими агентами ключей, то для пользования репозиториями, нужно прописать данный ключ в ~/.ssh/config в качестве ипользуемого по умолчанию глобально.
+
+Если этого файла нет, то создаем его и добавляем в него строчку:
+```
+IdentityFile ~/.ssh/id_rsa
+```
+~/.ssh/config вообще очень полезный файл. Рекомендую почитать что он еще умеет. Например туда можно прописать хосты типа:
+```
+Host site
+  HostName www.my-site.dyndns.org
+  Port 2222
+  User user
+```
+Тогда вместо такого:
+```
+$ ssh user@www.my-site.dyndns.org -p 2222
+```
+Можно писать так:
+```
+$ ssh site
+```
+
+---
+### 3. Добавляем ключ на удаленные сервера Linux
+
+Если ключ нужен только для работы с репозиториями, то переходим к следующему пункту.
+
+Если есть программа ssh-copy-id (в Linux и Git-bash она есть), прописываем публичный ключ на удаленный сервер.
+```
+$ ssh-copy-id -i ~/.ssh/id_rsa.pub user@server_ip
+```
+Eсли ssh-copy-id нет, то можно сделать это вручную.
+
+Вот последовательность действий:
+- логинимся на удаленной машине
+- добавляем свой ключ в файл authorized_keys
+```
+remote$ echo "содержимое файла открытого ключа" >> ~/.ssh/authorized_keys
+```
+- делаем правильные права (если файл только что был создан)
+```
+remote$ chmod 600 ~/.ssh/authorized_keys
+```
+- проверяем, что все работает, запускаем на локальном компьютере.
+```
+$ ssh user@server_ip
+```
+
+---
+### 4. Добавляем ключ в репозитории
+
+Для работы с репозиториями необходимо прописать туда публичный ключ.
+Для этого копируем содержимое файла ~/.ssh/id_rsa.pub во все необходимые репозитории.
+
+- GitHub: Settings -> SSH and GPG keys -> Nes SSH key
+- GitLab: Preferences -> SSH Keys -> Add key
+- Gitea: Settings -> SSH / GPG keys -> Add Key
+
+В качестве имени ключа удобно указывать пользователя и имя машины.
+
+**user@host**
+
+Для тестирования авторизации можно запустить:
+```
+$ ssh -T git@github.com
+```
+Аналогично и для других репозиториев:
+```
+$ ssh -T git@repo_url
+```
+Что проверяю я:
+```
+$ ssh -T git@git.arnik.ru
+$ ssh -T git@gitlab.srv.mf-t.ru -p 2222
+```
+---
+### 5. Настройка TortoiseGit
+Чтобы TortiseGit переключился на использование OpenSSH надо в настройках
+``` 
+Settings -> Network -> SSH client
+```
+поменять клиент на
+```
+C:\Program Files\Git\usr\bin\ssh.exe
+```
+---
+### PS (Linux)
+
+Если все настроено но все равно спрашивает пароль, то надо проверить права:
+```
+chmod 755 ~
+chmod 700 ~/.ssh
+chmod 600 ~/.ssh/*
+```
+Удачной работы!