Получить доступ к репозиторию в SourceCraft с помощью SSH-ключа

Для аутентификации в SourceCraft и доступа к репозиториям вы можете использовать SSH-ключ.

Чтобы получить доступ к репозиторию в SourceCraft с помощью SSH-ключа:

1. Подготовьте окружение.
2. Добавьте SSH-ключ в SourceCraft.
3. Клонируйте репозиторий.

Если доступ по SSH-ключу вам больше не нужен, удалите его.

Подготовьте окружение

1. Установите Git.

2. Создайте пару из открытого и закрытого SSH-ключей для учетной записи в SourceCraft:

   Linux/macOS

   Windows 10/11

   Windows 7/8

   1. Откройте терминал.

   2. Создайте новый ключ с помощью команды ssh-keygen:

      ssh-keygen -t ed25519 -C "<опциональный_комментарий>"
      

      Вы можете передать в параметре -C пустую строку, чтобы не добавлять комментарий, или не указывать параметр -C вообще — в таком случае будет добавлен комментарий по умолчанию.

      После выполнения команды вам будет предложено указать имя и путь к файлам с ключами, а также ввести пароль для закрытого ключа. Если задать только имя, пара ключей будет создана в текущей директории. Открытый ключ будет сохранен в файле с расширением .pub, закрытый ключ — в файле без расширения.

      По умолчанию команда предлагает сохранить ключ под именем id_ed25519 в директории /home/<имя_пользователя>/.ssh. Если в этой директории уже есть SSH-ключ с именем id_ed25519, вы можете случайно перезаписать его и потерять доступ к ресурсам, в которых он используется. Поэтому рекомендуется использовать уникальные имена для всех SSH-ключей.

   Если у вас еще не установлен OpenSSH, установите его по инструкции.

   1. Запустите cmd.exe или powershell.exe (предварительно обновите PowerShell).

   2. Создайте новый ключ с помощью команды ssh-keygen:

      ssh-keygen -t ed25519 -C "<опциональный_комментарий>"
      

      Вы можете передать в параметре -C пустую строку, чтобы не добавлять комментарий, или не указывать параметр -C вообще — в таком случае будет добавлен комментарий по умолчанию.

      После выполнения команды вам будет предложено указать имя и путь к файлам с ключами, а также ввести пароль для закрытого ключа. Если задать только имя, пара ключей будет создана в текущей директории. Открытый ключ будет сохранен в файле с расширением .pub, закрытый ключ — в файле без расширения.

      По умолчанию команда предлагает сохранить ключ под именем id_ed25519 в папку C:\Users\<имя_пользователя>/.ssh. Если в этой директории уже есть SSH-ключ с именем id_ed25519, вы можете случайно перезаписать его и потерять доступ к ресурсам, в которых он используется. Поэтому рекомендуется использовать уникальные имена для всех SSH-ключей.

   Создайте ключи с помощью приложения PuTTY:

   1. Скачайте и установите PuTTY.

   2. Добавьте папку с PuTTY в переменную PATH:

      1. Нажмите кнопку Пуск и в строке поиска Windows введите Изменение системных переменных среды.
      2. Справа снизу нажмите кнопку Переменные среды....
      3. В открывшемся окне найдите параметр PATH и нажмите Изменить.
      4. Добавьте путь к папке в список.
      5. Нажмите кнопку ОК.

   3. Запустите приложение PuTTYgen.

   4. В качестве типа генерируемой пары выберите EdDSA. Нажмите Generate и поводите курсором в поле выше до тех пор, пока не закончится создание ключа.

      

   5. В поле Key passphrase введите надежный пароль. Повторно введите его в поле ниже.

   6. Нажмите кнопку Save private key и сохраните закрытый ключ. Никому не сообщайте ключевую фразу от него.

   7. Нажмите кнопку Save public key и сохраните открытый ключ в файле <имя_ключа>.pub.

3. Запустите SSH-агент:

   Linux/MacOS

   Windows

   1. Выполните команду:

      ssh-agent -s
      

   2. Чтобы SSH-агент запускался при входе в систему, в файл ~/.profile добавьте команду запуска:

      ssh-agent -s
      

   1. Откройте контекстное меню кнопки Пуск.
   2. Выберите пункт Управление компьютером.
   3. Перейдите в раздел Службы и приложения → Службы.
   4. Откройте контекстное меню службы SSH agent и выберите пункт Свойства.
   5. На вкладке Главное измените тип запуска с Выключена на Автоматически.
   6. Нажмите кнопку OK и запустите службу.

4. Добавьте ключ в агент SSH:

   ssh-add <путь_к_закрытому_ключу>
   

Добавьте SSH-ключ в SourceCraft

1. Откройте главную страницу сервиса.
2. На панели слева нажмите Settings и выберите раздел SSH Keys.
3. Нажмите Add.
4. В открывшемся окне:
   • В поле Key name укажите произвольное название ключа.
   • В поле Content вставьте содержимое файла с открытым SSH-ключом.
5. Нажмите Add.

Вы можете добавить несколько SSH-ключей, для этого повторно нажмите Add и добавьте данные еще одного SSH-ключа.

Клонируйте репозиторий

1. На странице репозитория в правом верхнем углу нажмите кнопку Clone.

2. Скопируйте ссылку для клонирования репозитория из поля SSH.

3. В терминале выполните команду:

   git clone <ссылка_для_клонирования_репозитория>
   

4. Перейдите в склонированный репозиторий:

   cd <имя_репозитория>
   

Удалить SSH-ключ из SourceCraft

1. Откройте главную страницу сервиса.
2. На панели слева нажмите Settings и выберите раздел SSH Keys.
3. Напротив SSH-ключа, который хотите удалить, нажмите .

См. также

• Управление доступом в SourceCraft
• Как начать работать с SourceCraft
• Получить доступ к репозиторию в SourceCraft с помощью персонального токена (PAT)