Использование алиасов

Алиасы (псевдонимы домена) используются для задания двух или более доменных имен одному и тому же сайту. В системе можно задать для инструмента от одного до четырех алиасов, а для инструмента JFrog Artifactory существует еще один дополнительный алиас. Каждый инструмент имеет свой URL. Для доступа к инструменту могут применяться разные протоколы, такие как HTTP, HTTPS, SSH, GIT. При работе с инструментами в окне Create tool или в окне Update tool в разделе Aliases можно выбрать соответствующие протоколы и при необходимости отредактировать предложенные системой доменные имена.

Создание алиасов позволяет получить ссылки (доменные имена) для доступа к инструменту с использованием разных протоколов. Можно задать алиасы таким образом, что система будет работать с ними так, что все приходящие ссылки будут интерпретироваться как один и тот же инструмент с одними и теми же аутентификационными данными. В примере ниже инструмент, настроенный через SSH, будет также готов к работе через HTTPS при запуске через CLI или интеграционный API.

AppSec.Hub опрашивает алиасы, являющиеся в системе взаимозаменяемыми, и продолжает работу с нужным значением. Вариативность алиасов для инструмента поддерживается в рамках всей функциональности системы.

Примечание

Алиасы поддерживаются для всех типов инструментов, кроме инструментов оркестрации (Jenkins, TeamCity, GitLab CI), инструментов отслеживания дефектов (Jira, YouTrack) и инструментов Wiki (Confluence). Для этих инструментов в случае необходимости работы с ними с использованием разных протоколов в системе необходимо создавать отдельные экземпляры инструментов с соответствующими настройками.

Примечание

Как было сказано выше, у инструмента JFrog Artifactory существует еще один дополнительный алиас — SUBDOMAIN. Он позволяет этому инструменту работать с docker-артефактом без указания протокола. Для этого достаточно указать subdomain в соответствующем алиасе. Такой тип ссылок (subdomain для работы с docker-артефактом) поддерживается самим инструментом JFrog Artifactory.

Пример использования

Рассмотрим использование алиасов на конкретном примере.

Допустим, при настройке инструмента GitHub для него были заданы URL https:/github.com/toolpath, включающий в себя протокол https, хост github.com и путь toolpath, а также SSH-алиас ssh:/git@github.com:7999/aliaspath, включающий в себя протокол ssh, пользователя git, хост github.com, порт 7999 и путь aliaspath.

При этом путь aliaspath, указанный в алиасе, отличается от пути toolpath, заданного в URL.

Далее, при использовании URL некоторой кодовой базы, соответствующего заданному алиасу, такого как ssh://git@github.com:7999/aliaspath/service/sub-service/codebase.git, например, при онбординге, произойдет следующее: будет создана кодовая база, у которой часть URL, соответствующая полному алиасу ssh://git@github.com:7999/aliaspath, будет заменена на полный URL основного инструмента https:/github.com/toolpath.

Таким образом, в результате применения заданных настроек алиасов, кодовая база в итоге будет иметь следующий URL: https://github.com/toolpath/service/sub-service/codebase.git.

В других процессах онбординга и при работе с CLI преобразование будет работать точно так же.

Таким же образом будут производиться преобразование и при работе через пользовательский интерфейс.

При создании кодовой базы с помощью кнопки +Add new и пункта выпадающего меню Add new codebase в поле Enter absolute codebase URL окна Create codebase, как и в примере с онбордингом, можно указать URL, соответствующий заданному алиасу — ssh://git@github.com:7999/aliaspath/service/sub-service/codebase.git.

Перейдите на вкладку Edit manually. В поле Codebase checkout URL будет указан автоматически преобразованный из алиаса URL кодовой базы.

Нажмите кнопку Create, чтобы завершить процесс создания кодовой базы.