@yadsh/dsh-qa-integrations 0.5.0 → 0.6.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +431 -18
- package/compatibility.json +1 -1
- package/lib/broker.js +456 -9
- package/lib/broker.js.map +1 -1
- package/lib/client/bitrix24.js +2 -1
- package/lib/client/bitrix24.js.map +1 -1
- package/lib/client/card.js +8 -1
- package/lib/client/card.js.map +1 -1
- package/lib/client/confluence.js +3 -2
- package/lib/client/confluence.js.map +1 -1
- package/lib/client/gitlab.js +40 -4
- package/lib/client/gitlab.js.map +1 -1
- package/lib/client/index.js +13 -11
- package/lib/client/index.js.map +1 -1
- package/lib/client/integrations.js +39 -2
- package/lib/client/integrations.js.map +1 -1
- package/lib/client/jira.js +3 -2
- package/lib/client/jira.js.map +1 -1
- package/lib/client/provider-card.js +138 -4
- package/lib/client/provider-card.js.map +1 -1
- package/lib/client/styles.js +8 -5
- package/lib/client/styles.js.map +1 -1
- package/lib/client/teamcity.js +31 -4
- package/lib/client/teamcity.js.map +1 -1
- package/lib/client/testit.js +65 -0
- package/lib/client/testit.js.map +1 -0
- package/lib/client/weblate.js +70 -0
- package/lib/client/weblate.js.map +1 -0
- package/lib/client.js +2600 -480
- package/lib/client.js.map +1 -1
- package/lib/coerce.js +16 -7
- package/lib/coerce.js.map +1 -1
- package/lib/config.js +12 -0
- package/lib/config.js.map +1 -1
- package/lib/errors.js.map +1 -1
- package/lib/index.js +274 -28
- package/lib/index.js.map +1 -1
- package/lib/providers/bitrix24/catalog.js +13 -0
- package/lib/providers/bitrix24/catalog.js.map +1 -1
- package/lib/providers/bitrix24/config.js +3 -0
- package/lib/providers/bitrix24/config.js.map +1 -1
- package/lib/providers/bitrix24/credential-help.js +24 -0
- package/lib/providers/bitrix24/credential-help.js.map +1 -0
- package/lib/providers/bitrix24/index.js +9 -0
- package/lib/providers/bitrix24/index.js.map +1 -1
- package/lib/providers/bitrix24/operations.js +60 -1
- package/lib/providers/bitrix24/operations.js.map +1 -1
- package/lib/providers/bitrix24/tools.js +95 -3
- package/lib/providers/bitrix24/tools.js.map +1 -1
- package/lib/providers/confluence/credential-help.js +29 -0
- package/lib/providers/confluence/credential-help.js.map +1 -0
- package/lib/providers/confluence/index.js +9 -0
- package/lib/providers/confluence/index.js.map +1 -1
- package/lib/providers/gitlab/catalog.js +108 -15
- package/lib/providers/gitlab/catalog.js.map +1 -1
- package/lib/providers/gitlab/config.js +11 -3
- package/lib/providers/gitlab/config.js.map +1 -1
- package/lib/providers/gitlab/credential-help.js +33 -0
- package/lib/providers/gitlab/credential-help.js.map +1 -0
- package/lib/providers/gitlab/index.js +337 -6
- package/lib/providers/gitlab/index.js.map +1 -1
- package/lib/providers/jira/credential-help.js +31 -0
- package/lib/providers/jira/credential-help.js.map +1 -0
- package/lib/providers/jira/index.js +9 -0
- package/lib/providers/jira/index.js.map +1 -1
- package/lib/providers/registry.js +4 -0
- package/lib/providers/registry.js.map +1 -1
- package/lib/providers/shared/credential-help.js +29 -0
- package/lib/providers/shared/credential-help.js.map +1 -0
- package/lib/providers/shared/service-boundary.js +44 -0
- package/lib/providers/shared/service-boundary.js.map +1 -0
- package/lib/providers/teamcity/catalog.js +56 -2
- package/lib/providers/teamcity/catalog.js.map +1 -1
- package/lib/providers/teamcity/credential-help.js +25 -0
- package/lib/providers/teamcity/credential-help.js.map +1 -0
- package/lib/providers/teamcity/index.js +254 -2
- package/lib/providers/teamcity/index.js.map +1 -1
- package/lib/providers/testit/attachments.js +131 -0
- package/lib/providers/testit/attachments.js.map +1 -0
- package/lib/providers/testit/catalog.js +225 -0
- package/lib/providers/testit/catalog.js.map +1 -0
- package/lib/providers/testit/config.js +175 -0
- package/lib/providers/testit/config.js.map +1 -0
- package/lib/providers/testit/credential-help.js +29 -0
- package/lib/providers/testit/credential-help.js.map +1 -0
- package/lib/providers/testit/index.js +184 -0
- package/lib/providers/testit/index.js.map +1 -0
- package/lib/providers/testit/operations.js +1070 -0
- package/lib/providers/testit/operations.js.map +1 -0
- package/lib/providers/testit/tools.js +717 -0
- package/lib/providers/testit/tools.js.map +1 -0
- package/lib/providers/testit/transport.js +158 -0
- package/lib/providers/testit/transport.js.map +1 -0
- package/lib/providers/weblate/catalog.js +185 -0
- package/lib/providers/weblate/catalog.js.map +1 -0
- package/lib/providers/weblate/config.js +147 -0
- package/lib/providers/weblate/config.js.map +1 -0
- package/lib/providers/weblate/credential-help.js +26 -0
- package/lib/providers/weblate/credential-help.js.map +1 -0
- package/lib/providers/weblate/index.js +181 -0
- package/lib/providers/weblate/index.js.map +1 -0
- package/lib/providers/weblate/operations.js +703 -0
- package/lib/providers/weblate/operations.js.map +1 -0
- package/lib/providers/weblate/query.js +80 -0
- package/lib/providers/weblate/query.js.map +1 -0
- package/lib/providers/weblate/tools.js +408 -0
- package/lib/providers/weblate/tools.js.map +1 -0
- package/lib/providers/weblate/transport.js +179 -0
- package/lib/providers/weblate/transport.js.map +1 -0
- package/lib/repository.js +197 -13
- package/lib/repository.js.map +1 -1
- package/lib/service-credentials/config.js +179 -0
- package/lib/service-credentials/config.js.map +1 -0
- package/lib/service-credentials/policy.js +92 -0
- package/lib/service-credentials/policy.js.map +1 -0
- package/lib/service-credentials/registry.js +142 -0
- package/lib/service-credentials/registry.js.map +1 -0
- package/lib/service-credentials/state.js +30 -0
- package/lib/service-credentials/state.js.map +1 -0
- package/lib/service-credentials/types.js +20 -0
- package/lib/service-credentials/types.js.map +1 -0
- package/lib/tools.js +27 -2
- package/lib/tools.js.map +1 -1
- package/lib/typert.host.js +1187 -39
- package/lib/typert.remote-client.d.ts +37 -5
- package/lib/typert.remote-client.js +1057 -33
- package/lib/types/broker.d.ts +70 -4
- package/lib/types/client/bitrix24.d.ts +1 -1
- package/lib/types/client/card.d.ts +3 -1
- package/lib/types/client/confluence.d.ts +2 -2
- package/lib/types/client/gitlab.d.ts +15 -2
- package/lib/types/client/index.d.ts +3 -2
- package/lib/types/client/integrations.d.ts +11 -2
- package/lib/types/client/jira.d.ts +2 -2
- package/lib/types/client/provider-card.d.ts +50 -8
- package/lib/types/client/styles.d.ts +4 -3
- package/lib/types/client/teamcity.d.ts +15 -2
- package/lib/types/client/testit.d.ts +15 -0
- package/lib/types/client/weblate.d.ts +15 -0
- package/lib/types/coerce.d.ts +2 -2
- package/lib/types/config.d.ts +21 -0
- package/lib/types/errors.d.ts +9 -1
- package/lib/types/index.d.ts +108 -11
- package/lib/types/providers/bitrix24/catalog.d.ts +1 -1
- package/lib/types/providers/bitrix24/config.d.ts +11 -1
- package/lib/types/providers/bitrix24/credential-help.d.ts +8 -0
- package/lib/types/providers/bitrix24/index.d.ts +5 -0
- package/lib/types/providers/bitrix24/tools.d.ts +4 -0
- package/lib/types/providers/confluence/credential-help.d.ts +9 -0
- package/lib/types/providers/confluence/index.d.ts +5 -0
- package/lib/types/providers/contract.d.ts +62 -1
- package/lib/types/providers/gitlab/catalog.d.ts +20 -5
- package/lib/types/providers/gitlab/config.d.ts +14 -3
- package/lib/types/providers/gitlab/credential-help.d.ts +9 -0
- package/lib/types/providers/gitlab/index.d.ts +51 -1
- package/lib/types/providers/jira/credential-help.d.ts +8 -0
- package/lib/types/providers/jira/index.d.ts +5 -0
- package/lib/types/providers/registry.d.ts +2 -0
- package/lib/types/providers/shared/credential-help.d.ts +17 -0
- package/lib/types/providers/shared/service-boundary.d.ts +25 -0
- package/lib/types/providers/teamcity/catalog.d.ts +18 -2
- package/lib/types/providers/teamcity/credential-help.d.ts +8 -0
- package/lib/types/providers/teamcity/index.d.ts +53 -2
- package/lib/types/providers/testit/attachments.d.ts +20 -0
- package/lib/types/providers/testit/catalog.d.ts +75 -0
- package/lib/types/providers/testit/config.d.ts +61 -0
- package/lib/types/providers/testit/credential-help.d.ts +8 -0
- package/lib/types/providers/testit/index.d.ts +60 -0
- package/lib/types/providers/testit/operations.d.ts +95 -0
- package/lib/types/providers/testit/tools.d.ts +15 -0
- package/lib/types/providers/testit/transport.d.ts +67 -0
- package/lib/types/providers/weblate/catalog.d.ts +43 -0
- package/lib/types/providers/weblate/config.d.ts +57 -0
- package/lib/types/providers/weblate/credential-help.d.ts +9 -0
- package/lib/types/providers/weblate/index.d.ts +50 -0
- package/lib/types/providers/weblate/operations.d.ts +77 -0
- package/lib/types/providers/weblate/query.d.ts +37 -0
- package/lib/types/providers/weblate/tools.d.ts +15 -0
- package/lib/types/providers/weblate/transport.d.ts +60 -0
- package/lib/types/repository.d.ts +38 -3
- package/lib/types/service-credentials/config.d.ts +73 -0
- package/lib/types/service-credentials/policy.d.ts +44 -0
- package/lib/types/service-credentials/registry.d.ts +43 -0
- package/lib/types/service-credentials/state.d.ts +14 -0
- package/lib/types/service-credentials/types.d.ts +97 -0
- package/lib/types/tools.d.ts +10 -1
- package/lib/types/types.d.ts +114 -10
- package/package.json +7 -7
- package/lib/shared/settings.js +0 -19
- package/lib/shared/settings.js.map +0 -1
- package/lib/types/shared/settings.d.ts +0 -19
package/README.md
CHANGED
|
@@ -1,12 +1,12 @@
|
|
|
1
1
|
# dsh-qa-integrations
|
|
2
2
|
|
|
3
|
-
Персональные интеграции для `@yadsh/dsh-qa-surface`. Плагин подключает Bitrix24 через URL входящего вебхука, GitLab через personal access token, TeamCity через access token,
|
|
3
|
+
Персональные интеграции для `@yadsh/dsh-qa-surface`. Плагин подключает Bitrix24 через URL входящего вебхука, GitLab через personal access token, TeamCity через access token, Jira и Confluence — через API-токен Atlassian, Test IT — через API-токен системы управления тестированием, а Weblate — через API-токен платформы локализации, после чего даёт агенту набор read-only инструментов, ограниченный и правами подключения, и персональной политикой пользователя; единственное исключение — комментарий в таймлайн Bitrix24, который монтируется только явным флагом оператора. У GitLab и TeamCity подключение может работать не только от личного токена, но и от сервисного токена развёртывания — общего read-only аккаунта с жёстким потолком режима (раздел «Сервисные токены»).
|
|
4
4
|
|
|
5
|
-
Плагин показывает подключения двумя монтированиями одного и того же набора карточек: отдельным разделом **«Интеграции»** в пользовательских настройках QA и
|
|
5
|
+
Плагин показывает подключения двумя монтированиями одного и того же набора карточек: отдельным разделом **«Интеграции»** в пользовательских настройках QA и отдельной вкладкой **«Настройки → Плагины → Интеграции»** оригинального DSH. Вкладка регистрируется напрямую как `settings.plugins.tab`, поэтому доступна и в LAN-браузере, где loopback-only каталог Host settings намеренно отключён. Она читает аккаунт через клиентский сервис `qaUserSession` плагина `@yadsh/dsh-qa-surface`: без входа в QA ничего не показывает и не делает запросов, пока карточку не раскрыли. Токен вводится один раз, шифруется на Host и никогда не возвращается браузеру. Выбор пользователя, integration id, secret id или токена отсутствует в model-visible схемах: principal берётся из DSH-сессии, а Bitrix user id — из сохранённой записи интеграции.
|
|
6
6
|
|
|
7
7
|
## Структура
|
|
8
8
|
|
|
9
|
-
Один каталог — одна интеграция. Всё, что знает про Bitrix24, GitLab, TeamCity, Jira и
|
|
9
|
+
Один каталог — одна интеграция. Всё, что знает про Bitrix24, GitLab, TeamCity, Jira, Confluence, Test IT и Weblate, лежит в своём каталоге `src/providers/<id>/`: каталог возможностей и операций, построение запросов, HTTP-граница, срез конфига и тулы. У TeamCity отдельно лежат locator-синтаксис, обработка логов, политика артефактов и сеть; у Jira — JQL и ADF; у Confluence — CQL и ADF; у Test IT — политика видов вложений и бюджет их чтения; у Weblate — сборка поискового синтаксиса `q`. Общий слой — брокер, репозиторий, секреты, реестр сервисных токенов (`src/service-credentials/`), обвязка тулов — не знает ни одной интеграции по имени: capability это свободная строка, а `providers/contract.ts` описывает, что должен уметь провайдер. Порядок добавления следующей интеграции и правила гейта пакета — в [src/providers/README.md](https://github.com/xarleyn/dsh-plugins/blob/main/plugins/dsh-qa-integrations/src/providers/README.md).
|
|
10
10
|
|
|
11
11
|
## Инструменты
|
|
12
12
|
|
|
@@ -14,7 +14,7 @@ CRM:
|
|
|
14
14
|
|
|
15
15
|
| Tool | Что делает |
|
|
16
16
|
| --- | --- |
|
|
17
|
-
| `bitrix_search_crm` | Поиск лидов, сделок, контактов, компаний, счетов и
|
|
17
|
+
| `bitrix_search_crm` | Поиск лидов, сделок, контактов, компаний, счетов и смарт-процессов: по названию, стадии, воронке, свежести, открытости (только сделки), ответственный; порядок сортировки зафиксирован, чтобы страницы не дублировались |
|
|
18
18
|
| `bitrix_get_crm_item` | Полная карточка элемента CRM, включая пользовательские поля и коммуникации |
|
|
19
19
|
| `bitrix_get_crm_fields` | Схема полей типа сущности, включая `UF_CRM_*` портала |
|
|
20
20
|
| `bitrix_get_crm_funnels` | Воронки (категории) типа сущности |
|
|
@@ -69,6 +69,12 @@ CRM:
|
|
|
69
69
|
| `bitrix_get_storage_items` | Содержимое корня диска |
|
|
70
70
|
| `bitrix_get_folder_items` | Содержимое папки Диска |
|
|
71
71
|
|
|
72
|
+
Запись (по умолчанию выключена оператором `bitrix24.crmCommentWrite`):
|
|
73
|
+
|
|
74
|
+
| Tool | Что делает |
|
|
75
|
+
| --- | --- |
|
|
76
|
+
| `bitrix_add_crm_timeline_comment` | Один комментарий в таймлайн лида, сделки, контакта или компании; единственная операция записи во всём плагине |
|
|
77
|
+
|
|
72
78
|
Списочные инструменты отвечают единым конвертом `{ items, pagination }`: у модели одна форма ответа вместо шести разных у REST, а курсор следующей страницы не теряется. Методы, возвращающие словари по id (история открытой линии, занятость), спроецированы в упорядоченные массивы.
|
|
73
79
|
|
|
74
80
|
## Инструменты GitLab
|
|
@@ -165,6 +171,38 @@ CRM:
|
|
|
165
171
|
|
|
166
172
|
Поиск идёт через CQL, но CQL собирает провайдер: модель передаёт типизированные фильтры (текст, пространства, типы, метки, автор, дата), а `cql.ts` экранирует литералы и подставляет `space in (…)`, `currentUser()` и `ORDER BY`. Инструмента с произвольным CQL в surface нет. Текст страницы и комментариев приходит не сырым payload, а markdown-подобной разметкой в поле `untrustedContent`: `adf.ts` разбирает Atlassian Document Format в заголовки, списки, таблицы, блоки кода, ссылки, упоминания, панели и статусы, а макросы, медиа и встроенные представления заменяет плейсхолдерами (`[Confluence macro: jira]`, `[media: chart]`) — провайдер ничего не отрисовывает и никуда не ходит по ссылкам из страницы. Тело режется бюджетом (`maxChars` в аргументе, потолок — `maxBodyChars` стенда) и при обрезке отвечает `truncated: true` и `totalChars`. Подсветка совпадений в выдержках поиска снимается вместе с разметкой.
|
|
167
173
|
|
|
174
|
+
## Инструменты Weblate
|
|
175
|
+
|
|
176
|
+
| Tool | Что делает |
|
|
177
|
+
| --- | --- |
|
|
178
|
+
| `weblate_connection_get` | К какому инстансу Weblate и каким аккаунтом подключён токен и личный он или проектный; сам токен не возвращается |
|
|
179
|
+
| `weblate_projects_list` | Проекты, видимые аккаунту, постранично |
|
|
180
|
+
| `weblate_project_get` | Один проект: слаг, имя, ссылка |
|
|
181
|
+
| `weblate_project_statistics_get` | Готовность проекта: строки и слова переведены, требуют правки, не проходят проверки |
|
|
182
|
+
| `weblate_components_list` | Компоненты проекта постранично |
|
|
183
|
+
| `weblate_component_get` | Один компонент: слаг, имя, система контроля версий, ветка, формат файлов, исходный язык |
|
|
184
|
+
| `weblate_component_statistics_get` | Готовность компонента по языкам |
|
|
185
|
+
| `weblate_translations_list` | Языки компонента с их состоянием перевода |
|
|
186
|
+
| `weblate_translation_get` | Один язык одного компонента целиком: переведено, требует правки, проверки, комментарии, предложения, автор последней правки |
|
|
187
|
+
| `weblate_translation_statistics_get` | Статистика одного языка одного компонента |
|
|
188
|
+
| `weblate_units_search` | Строки одного языка одного компонента с типизированными фильтрами |
|
|
189
|
+
| `weblate_units_find` | Строка по всему, что видит аккаунт, с сужением по проекту, компоненту и языку |
|
|
190
|
+
| `weblate_unit_get` | Одна строка целиком: все формы множественного числа исходника и перевода, состояние, контекст, заметка, метки, флаги, проверки |
|
|
191
|
+
| `weblate_unit_comments_list` | Комментарии к строке: автор, время, текст |
|
|
192
|
+
| `weblate_unit_suggestions_list` | Предложенные переводы строки: автор, голоса, время |
|
|
193
|
+
| `weblate_failing_units_list` | Строки, у которых не проходит хотя бы одна проверка, с сужением по проекту, компоненту, языку, тексту и состоянию |
|
|
194
|
+
| `weblate_changes_list` | Последние изменения проекта: какая строка, какой язык, что сделано, кем и когда |
|
|
195
|
+
| `weblate_screenshots_list` | Скриншоты Weblate и строки, к которым они привязаны |
|
|
196
|
+
| `weblate_screenshot_get` | Метаданные одного скриншота: имя, файл в репозитории, язык, id связанных строк |
|
|
197
|
+
|
|
198
|
+
Списочные инструменты Weblate отвечают конвертом `{ items, pagination }`: `pagination.nextPage` — номер следующей страницы, а не подписанный курсор. По ссылке `next` провайдер не ходит сам: Weblate кладёт в тело абсолютный адрес, из которого читается только номер страницы, и только когда он ведёт на настроенный инстанс — ссылка с чужого адреса отбрасывается, а список честно считается законченным. Страница — 20 строк по умолчанию, а `perPage` сверх потолка стенда (`maxPageSize`, по умолчанию 100) обрезается, а не отвергается: «дай больше строк» — это запрос, на который стенд отвечает своим потолком, а не ошибка, которую модель выясняет перебором. Состояние между вызовами не хранится, principal и права перепроверяются на каждом вызове.
|
|
199
|
+
|
|
200
|
+
Модель не получает `q`: фильтры типизированные (`source`, `target`, `context`, `state`, `failingChecks`, `suggestions`, `comments`, а у поиска по всему инстансу ещё `project`, `component` и `language`), а строку запроса собирает `query.ts` — значения всегда в двойных кавычках с экранированием `\` и `"`, поэтому кавычка или обратный слэш внутри запроса остаются значением и не становятся условием. Словарь состояний — собственный словарь Weblate `is:`: `untranslated` (по определению самого Weblate — всё, что ниже translated, то есть вместе со строками, помеченными needs-editing), `needs-editing`, `translated`, `approved`, `read-only`. Поиск без единого фильтра уходит без параметра `q`, а не с пустым. `weblate_failing_units_list` — тот же `/units/`, что и `weblate_units_find`, с жёсткой клаузой `has:check`; Weblate сообщает, что строка не проходит проверку, но не то, какая именно проверка упала, поэтому ответ несёт `hasFailingCheck`, а не список имён проверок.
|
|
201
|
+
|
|
202
|
+
Строки нормализованы: числовые состояния Weblate (0/10/20/30/100) отображаются в `untranslated`/`needs-editing`/`translated`/`approved`/`read-only`, формы множественного числа остаются массивом (перевод, молча короче настоящего, был бы прочитан как правда), текст режется — 200 символов в списке, `maxChars` у отдельной строки, потолок — `maxTextChars` стенда — и помечается `textTruncated`, метки приходят именами, а проект, компонент и язык читаются из вложенной ссылки `translation`, и только когда она ведёт на настроенный инстанс. Каждый ответ с текстом, написанным на стороне Weblate, помечен `untrustedExternalContent: true`: это данные, а не инструкция. Скриншоты — только метаданные (имя, файл в репозитории, язык, id строк, адрес картинки на настроенном инстансе): байты провайдер не скачивает. История изменений у Weblate есть у проекта, компонента и перевода, но не у строки, поэтому инструмент проектный, а строка в каждой записи ищется по её id.
|
|
203
|
+
|
|
204
|
+
`weblate_connection_get` называет инстанс, аккаунт и вид токена: у Weblate нет эндпоинта «кто я», и подключённый аккаунт определяется по `GET /api/users/`, который непривилегированный токен видит одной своей строкой. Токен, который умеет перечислять пользователей, отвечает полным списком — тогда аккаунт честно не определяется (пустой внешний id, в карточке адрес инстанса и вид токена), а не угадывается по первой строке.
|
|
205
|
+
|
|
168
206
|
## Возможности и скопы Confluence
|
|
169
207
|
|
|
170
208
|
Подключение — Atlassian API token вместе с почтой аккаунта Atlassian (Basic-пара). Возможность появляется у пользователя, если её включил оператор (`confluence.*Read`).
|
|
@@ -188,13 +226,41 @@ Confluence, как и TeamCity, не сообщает через API, какие
|
|
|
188
226
|
Запись в surface отсутствует: создание и правка страниц, комментарии, резолв inline-комментариев, вложения, перемещение и администрирование пространств ждут confirmation-фреймворка. Произвольного REST (`confluence_rest_call`), произвольного CQL и скачивания вложений тоже нет — только метаданные и ссылки, которые отдал сам Confluence.
|
|
189
227
|
|
|
190
228
|
|
|
229
|
+
## Возможности и скопы Weblate
|
|
230
|
+
|
|
231
|
+
Подключение — API-токен Weblate вместе с выбором инстанса: адреса задаёт только оператор (`weblate.instances`), пользователь выбирает инстанс из списка и вставляет токен. Возможность появляется у пользователя, если её включил оператор (`weblate.*Read`).
|
|
232
|
+
|
|
233
|
+
| Возможность | Что открывает |
|
|
234
|
+
| --- | --- |
|
|
235
|
+
| `identity.read` | Инстанс Weblate, подключённый аккаунт и вид токена |
|
|
236
|
+
| `projects.read` | Список проектов и карточка проекта |
|
|
237
|
+
| `components.read` | Компоненты проекта и карточка компонента |
|
|
238
|
+
| `translations.read` | Языки компонента и один язык целиком |
|
|
239
|
+
| `units.read` | Поиск строк по тексту, контексту и состоянию, чтение одной строки |
|
|
240
|
+
| `checks.read` | Строки, у которых не проходит хотя бы одна проверка |
|
|
241
|
+
| `comments.read` | Комментарии к строке |
|
|
242
|
+
| `suggestions.read` | Предложенные переводы строки |
|
|
243
|
+
| `changes.read` | История изменений проекта |
|
|
244
|
+
| `statistics.read` | Готовность проекта, компонента и языка |
|
|
245
|
+
| `screenshots.read` | Метаданные скриншотов |
|
|
246
|
+
|
|
247
|
+
Weblate, как и TeamCity с Confluence, не сообщает через API, какие права выданы конкретному токену: токен действует от имени своего пользователя или своего проекта, а «проверить» чтением чужой области провайдер не имеет права. Поэтому сужение идёт только по деплой-флагам оператора (`weblate.*Read`), а права применяет сам Weblate — отказ приходит как `ProviderPermissionDenied`, и провайдер никогда не пробует другой credential. Каждая возможность при этом достижима хотя бы одной операцией, поэтому карточка не может показать переключатель, который ничего не делает.
|
|
248
|
+
|
|
249
|
+
Префиксы токенов Weblate (`wlu_` — личный, `wlp_` — проектный) доходят до пользователя подписью в карточке (`· личный токен`, `· токен проекта`, `· токен`) и никогда не являются проверкой прав: токен с незнакомым префиксом принимается наравне с остальными, а его права определяет сам Weblate. Проектный токен карточка рекомендует как меньший радиус поражения — это подсказка, а не запрет.
|
|
250
|
+
|
|
251
|
+
Оператор стенда дополнительно решает, какие из инструментов видит модель: имена `weblate_*` нужно добавить в tool allow-list пресета QA. Инструменты не принимают ни пользователя, ни credential, ни инстанс, поэтому допуск к ним — решение оператора, а не модели.
|
|
252
|
+
|
|
253
|
+
Запись в surface отсутствует: предложения перевода, комментарии, правка и утверждение перевода, файлы перевода, autotranslate и операции с репозиторием ждут confirmation-фреймворка. Инструмента с произвольным `q` и произвольным REST тоже нет: поиск принимает только типизированные фильтры.
|
|
254
|
+
|
|
255
|
+
|
|
191
256
|
## Возможности и скопы
|
|
192
257
|
|
|
193
|
-
Одна возможность = один scope Bitrix24. Возможность появляется у пользователя только если её включил оператор (`bitrix24.*Read`) **и** подключённый вебхук реально получил соответствующий scope — плагин спрашивает это у портала методом `scope` при подключении и при нажатии «Проверить».
|
|
258
|
+
Одна возможность = один scope Bitrix24. Возможность появляется у пользователя только если её включил оператор (`bitrix24.*Read`, у записи — `bitrix24.crmCommentWrite`) **и** подключённый вебхук реально получил соответствующий scope — плагин спрашивает это у портала методом `scope` при подключении и при нажатии «Проверить».
|
|
194
259
|
|
|
195
260
|
| Возможность | Scope вебхука | Что открывает |
|
|
196
261
|
| --- | --- | --- |
|
|
197
262
|
| `crm.read` | `crm` | CRM, дела, таймлайн, товарные строки, дубли |
|
|
263
|
+
| `crm.comment.write` | `crm` | Единственная операция записи: комментарий в таймлайн лида, сделки, контакта или компании |
|
|
198
264
|
| `chat.read` | `im` | Чаты, сообщения, поиск по переписке |
|
|
199
265
|
| `openlines.read` | `imopenlines` | Диалоги открытых линий и их история |
|
|
200
266
|
| `user.read` | `user_brief` / `user_basic` / `user` | Свой профиль и поиск сотрудников |
|
|
@@ -203,7 +269,9 @@ Confluence, как и TeamCity, не сообщает через API, какие
|
|
|
203
269
|
| `calendar.read` | `calendar` | Календарь и занятость |
|
|
204
270
|
| `disk.read` | `disk` | Файлы Диска |
|
|
205
271
|
|
|
206
|
-
|
|
272
|
+
У Bitrix24 нет read-only scope вебхука: `crm` покрывает и чтение, и запись, поэтому гранулярность «запись отдельно» даёт только конфиг-флаг. `crm.comment.write` выключен по умолчанию; даже после включения флага операция стартует с политикой `deny`, пока пользователь (или оператор) явно её не разрешит, — проба scope сама по себе запись не открывает. Остальная запись (`*.add`, `*.update`, `*.delete`), бизнес-процессы, управление пользователями и generic REST/MCP в surface отсутствуют.
|
|
273
|
+
|
|
274
|
+
Выданные в Bitrix24 права не отменяются: портал всё равно применяет права того пользователя, чей вебхук используется. Возможность, обнаруженная после выдачи нового scope, появляется в карточке выключенной — пользователь включает её сам.
|
|
207
275
|
|
|
208
276
|
## Возможности и скопы GitLab
|
|
209
277
|
|
|
@@ -217,9 +285,12 @@ Confluence, как и TeamCity, не сообщает через API, какие
|
|
|
217
285
|
| `search.read` | `read_api` / `api` | Поиск по проектам, задачам, MR, коммитам, коду |
|
|
218
286
|
| `issues.read` | `read_api` / `api` | Задачи и комментарии к ним |
|
|
219
287
|
| `merge_requests.read` | `read_api` / `api` | MR, диффы, обсуждения, одобрения, пайплайны MR |
|
|
220
|
-
| `ci.read` | `read_api` / `api` | Пайплайны, джобы,
|
|
288
|
+
| `ci.metadata.read` | `read_api` / `api` | Пайплайны, джобы, их статусы и метаданные |
|
|
289
|
+
| `ci.logs.read` | `read_api` / `api` | Содержимое лога джоба |
|
|
290
|
+
|
|
291
|
+
CI разделён надвое намеренно: лог джоба — это другая утечка, чем список джоб, а раньше обе половины закрывала одна возможность `ci.read`. Оператор стенда задаёт половины отдельно (`ciMetadataRead` и `ciLogsRead`), а старый флаг `ciRead` продолжает работать и теперь управляет обеими; сохранённая политика `ci.read` при первом запуске переносится на оба новых id, поэтому выключенный CI не включается сам. Под сервисным токеном доступна только первая половина: `ci.metadata.read` отвечает, какие джобы были и чем кончились, а `ci.logs.read` показывает, что они напечатали, и остаётся личным чтением. Любая операция, читающая проект, в сервисном режиме обязана назвать проект или группу внутри границы профиля, а листинг без проекта (`gitlab_issues_list`, `gitlab_merge_requests_list`) отказывается — вместо ответа всей картиной, доступной общему аккаунту.
|
|
221
292
|
|
|
222
|
-
У GitLab нет отдельного read-scope на каждую область, поэтому `read_api` покрывает почти всё, а `read_repository` и `read_user` дают узкие наборы. Права токена не отменяются: GitLab всё равно применяет права своего пользователя. Возможность, появившаяся после выдачи нового scope, приходит в карточку выключенной. Запись (`POST`/`PUT`/`DELETE`), GraphQL, произвольный REST, admin-API, управление токенами, участниками и CI-переменными в surface отсутствуют; merge и запись в репозиторий — тоже.
|
|
293
|
+
У GitLab нет отдельного read-scope на каждую область, поэтому `read_api` покрывает почти всё, а `read_repository` и `read_user` дают узкие наборы. Права токена не отменяются: GitLab всё равно применяет права своего пользователя. Возможность, появившаяся после выдачи нового scope, приходит в карточку выключенной. Запись (`POST`/`PUT`/`DELETE`), GraphQL, произвольный REST, admin-API, управление токенами, участниками и CI-переменными в surface отсутствуют; merge и запись в репозиторий — тоже. Сервисный токен не превращает эти запреты в разрешения: он только сужает — и дополнительно прячет от общего аккаунта лог джоба.
|
|
223
294
|
|
|
224
295
|
Оператор стенда дополнительно решает, какие из инструментов видит модель: имена нужно добавить в tool allow-list пресета QA. Инструменты не принимают ни пользователя, ни credential, поэтому допуск к ним — решение оператора, а не модели.
|
|
225
296
|
|
|
@@ -240,6 +311,8 @@ Confluence, как и TeamCity, не сообщает через API, какие
|
|
|
240
311
|
| `agents.read` | Агенты сборки |
|
|
241
312
|
| `artifacts.read` | Список артефактов и текст небольших текстовых файлов |
|
|
242
313
|
|
|
314
|
+
Лог сборки и текст артефакта остаются личными под сервисным токеном: это текст, который напечатала сборка, и общий read-only аккаунт его не читает. Список артефактов — обычное чтение метаданных, но возможность у него одна с текстом, поэтому в сервисном режиме `artifacts.read` целиком помечена «Требуется личный аккаунт», как и `logs.read`. В сервисном режиме листинг обязан назвать проект или конфигурацию: `teamcity_builds`, `teamcity_build_configs`, `teamcity_queue` и `teamcity_investigations` без `projectId` или `buildTypeId` отказываются, потому что иначе ответили бы всей картиной сервера, а `teamcity_projects` собирается из allowlist профиля. Сборка, названная по id, сначала разрешается в свой проект, поэтому прямой `teamcity_build` проходит ту же проверку, что и листинг. Причины падений (`teamcity_build_failures`) остаются сервисными: инструмент отвечает упавшими тестами и проблемами сборки, а не логом.
|
|
315
|
+
|
|
243
316
|
TeamCity, в отличие от GitLab и Bitrix24, не сообщает через API, какие именно права выданы конкретному токену: админ-скоупы невидимы снаружи, а «проверить» записью провайдер не имеет права. Поэтому сужение идёт только по деплой-флагам оператора, а права токена применяет сам TeamCity — отказ приходит как `ProviderPermissionDenied`, и провайдер никогда не пробует другой credential. Рекомендация пользователю в карточке прямая: создать токен с «Limit per project» и только теми правами чтения, которые нужны.
|
|
244
317
|
|
|
245
318
|
Запись в surface отсутствует: запуск, перезапуск, отмена сборки, комментарии и теги ждут confirmation-фреймворка; редактирование конфигураций, управление агентами, расследованиями и mute-ами — тоже. Параметры сборки (`/parameters`, `resulting-properties`) провайдер не запрашивает вообще, поэтому секретных значений в ответах нет по построению.
|
|
@@ -293,6 +366,8 @@ teamcity:
|
|
|
293
366
|
|
|
294
367
|
Пустая политика (`allowedHosts` и `allowedCidrs` пусты) — это не ошибка загрузки, а «ничего не подключить»: плагин пишет об этом предупреждение в лог при старте, а карточка отвечает пользователю отказом. Опечатки в самой политике — наоборот, падение на старте: молча выброшенный шаблон хоста оставил бы стенд без объяснения.
|
|
295
368
|
|
|
369
|
+
Если для этого сервера заведён сервисный токен, форма вместо поля с токеном показывает чекбокс «Использовать сервисный токен»: при `defaultForNewConnections: true` он отмечен, кнопка называется «Подключить сервисный токен», а адрес сервера остаётся той же справочной строкой — его по-прежнему задаёт оператор. Подключённая карточка называет псевдоним сервисного профиля вместо аккаунта, кнопками «Использовать личный аккаунт» и «Использовать сервисный токен» переключает режимы, а «Изменить доступ» сужает список проектов, с которыми работает подключение.
|
|
370
|
+
|
|
296
371
|
## Конфигурация TeamCity
|
|
297
372
|
|
|
298
373
|
```yaml
|
|
@@ -388,12 +463,69 @@ API token выпускается в профиле Atlassian (`Manage profile
|
|
|
388
463
|
- **Rate limiting** (раздел «Rate limiting»): лимиты по principal, ресурсу и глобальные не считаются; вместо них — ограниченные размеры ответов и повторы с backoff для 429/5xx.
|
|
389
464
|
- **Семантический индекс** (раздел «Optional semantic index»), **webhooks** и **Confluence Data Center** (раздел «Compatibility») — не подключены: провайдер работает только с Confluence Cloud.
|
|
390
465
|
|
|
466
|
+
## Как подключается Weblate
|
|
467
|
+
|
|
468
|
+
Инстансы Weblate задаёт только оператор: пользователь выбирает инстанс из списка и вставляет API-токен, произвольный хост ввести нельзя. Если инстанс один, выбор не показывается; если инстансов нет, карточка честно сообщает, что подключать нечего, и формы не показывает.
|
|
469
|
+
|
|
470
|
+
Правила адреса инстанса — те же, что у GitLab (то, что защищает брокер от SSRF): только `http`/`https`, HTTPS обязателен вне явного `allowInsecureHttp` для стенда; без credentials и query в URL; путь допустим (Weblate за обратным прокси в подкаталоге), хвостовой слэш срезается; id инстанса — стабильный ключ, который и хранит секрет. Адрес не сохраняется в credential: он перечитывается из конфига на каждом вызове, поэтому удаление или переезд инстанса немедленно закрывает доступ к сохранённому токену (`CredentialRevoked`), и подмены на другой инстанс не происходит. Redirect не отслеживается (`redirect: "error"`), а токен уходит только в заголовке `Authorization: Token …` — в URL и теле его нет.
|
|
471
|
+
|
|
472
|
+
Токен выпускается в профиле Weblate (настройки профиля → API tokens), вводится один раз в карточке, шифруется тем же конвертным хранилищем, что и остальные секреты, и после сохранения не показывается и не копируется. Рядом карточка подсказывает, что для минимума прав лучше подходит токен проекта (`wlp_…`), ограниченный одним проектом.
|
|
473
|
+
|
|
474
|
+
## Конфигурация Weblate
|
|
475
|
+
|
|
476
|
+
```yaml
|
|
477
|
+
weblate:
|
|
478
|
+
enabled: true
|
|
479
|
+
allowInsecureHttp: false # только для dev-стенда
|
|
480
|
+
instances:
|
|
481
|
+
- id: corp
|
|
482
|
+
label: Corporate Weblate
|
|
483
|
+
baseUrl: https://weblate.example.com
|
|
484
|
+
# Weblate в подкаталоге сохраняет путь:
|
|
485
|
+
# - id: corp-weblate
|
|
486
|
+
# label: Corp Weblate
|
|
487
|
+
# baseUrl: https://example.com/weblate
|
|
488
|
+
identityRead: true
|
|
489
|
+
projectsRead: true
|
|
490
|
+
componentsRead: true
|
|
491
|
+
translationsRead: true
|
|
492
|
+
unitsRead: true
|
|
493
|
+
checksRead: true
|
|
494
|
+
commentsRead: true
|
|
495
|
+
suggestionsRead: true
|
|
496
|
+
changesRead: true
|
|
497
|
+
statisticsRead: true
|
|
498
|
+
screenshotsRead: true
|
|
499
|
+
maxTextChars: 4000 # символов одной строки, которую видит модель
|
|
500
|
+
maxPageSize: 100 # потолок страницы; по умолчанию провайдер просит 20
|
|
501
|
+
retries: 2 # повторы для 429/5xx и сетевых сбоев
|
|
502
|
+
```
|
|
503
|
+
|
|
504
|
+
Список инстансов принимает не больше 16 записей; id — строчные латинские буквы, цифры и дефисы (до 32 символов), без повторов; подпись по умолчанию — имя хоста. Опечатка в инстансе роняет загрузку конфига, а не выбрасывает инстанс молча: пользователь иначе получил бы провайдер, к которому нельзя подключиться, и никакого объяснения. Пустой список — это состояние, а не падение: провайдер зарегистрирован и бездействует, а отказывает форма подключения.
|
|
505
|
+
|
|
506
|
+
## Чего в Weblate-провайдере ещё нет
|
|
507
|
+
|
|
508
|
+
Спецификация `docs/SPEC-providers-weblate.md` описывает целевую архитектуру; в этой версии реализована read-only фаза, как и у остальных провайдеров:
|
|
509
|
+
|
|
510
|
+
- **Запись** (раздел «Write operations»): предложения перевода, комментарии, правка и утверждение перевода, файлы перевода, autotranslate и операции с репозиторием — вместе с ними отложены pending actions и карточка подтверждения. Пока в каталоге нет ни одной операции, которая может изменить Weblate.
|
|
511
|
+
- **Скачивание скриншотов** (раздел «Screenshots and binary data»): сейчас только метаданные, id связанных строк и адрес картинки на настроенном инстансе; ни байты, ни лимит размера, ни проверка MIME, ни временное хранилище на пользователя не реализованы.
|
|
512
|
+
- **История изменений по строке** (раздел «Change history»): Weblate отдаёт историю по проекту, компоненту и переводу, но не по строке, поэтому инструмент проектный, а нужная строка ищется по id в каждой записи; отдельного чтения истории одной строки нет и появиться не может, пока такого эндпоинта нет у самого Weblate.
|
|
513
|
+
- **Произвольный `q`** (раздел «Search and filters»): поиск принимает только типизированные фильтры. Грамматика объявляет четыре текстовых поля строки (`source`, `target`, `context`, `note`), но `note` ни один инструмент не передаёт, так что для модели он недостижим.
|
|
514
|
+
- **Определение возможностей и код `CAPABILITY_UNAVAILABLE`** (разделы «Permissions», «Compatibility»): Weblate не сообщает, что разрешено конкретному токену, а выводить права из одного удачного чтения провайдер отказывается, поэтому никакого discovery нет; чтение, которого нет в этой версии Weblate, отвечает `405` и приходит как `ResourceNotFound` с пояснением, что операцию не поддерживает сама версия.
|
|
515
|
+
- **Кэш** (раздел «Caching») отсутствует полностью, поэтому и межпользовательской утечки через кэш быть не может; пагинация stateless, подписанных continuation-токенов нет.
|
|
516
|
+
- **Rate limiting** (раздел «Rate limiting»): лимитов на аккаунт и на инстанс нет; вместо них ограниченные страницы и текст, повторы с backoff (включая `Retry-After`, если он числовой) и полный отказ от повторов на 4xx.
|
|
517
|
+
- **Продолжение большого ответа** (раздел «Response size controls»): тело больше `maxResponseBytes` отвечает `ResultTooLarge`, а сегментного чтения нет.
|
|
518
|
+
- **SSRF-политика по CIDR и DNS** (раздел «API base»): правило провайдера — список инстансов оператора и HTTPS по умолчанию, потому что Weblate обычно self-hosted; «адрес объявлен оператором» заменяет «адрес публичный».
|
|
519
|
+
- **Аудит и OTel-инструменты** (раздел «Observability»): провайдер не публикует ни метрик, ни спанов, а слой интеграций пишет в audit только provider, operation, result и source session id — текст локализации в журнал не попадает.
|
|
520
|
+
|
|
391
521
|
## Как подключается GitLab
|
|
392
522
|
|
|
393
523
|
Инстансы GitLab задаёт только оператор: пользователь выбирает из списка и вставляет токен, произвольный хост ввести нельзя. Если инстанс один, выбор не показывается; если инстансов нет, карточка честно сообщает, что подключать нечего.
|
|
394
524
|
|
|
395
525
|
Правила адреса инстанса (то, что защищает брокер от SSRF): только `http`/`https`, HTTPS обязателен вне явного `allowInsecureHttp` для стенда; без credentials, query и fragment в URL; путь допустим (GitLab, смонтированный в подкаталог), хвостовой слэш срезается; id инстанса — стабильный ключ, который и хранит секрет. Адрес не сохраняется в credential: он перечитывается из конфига на каждом вызове, поэтому удаление или переезд инстанса немедленно закрывает доступ к сохранённому токену (`CredentialRevoked`), и подмены на другой инстанс не происходит. Redirect не отслеживается (`redirect: "error"`), токен уходит только в заголовке `PRIVATE-TOKEN`, в URL и теле его нет.
|
|
396
526
|
|
|
527
|
+
Если для выбранного инстанса развёртывание завело сервисный токен, форма подключения получает чекбокс «Использовать сервисный токен». При `defaultForNewConnections: true` он уже отмечен, и поле токена не показывается: подключается общий read-only аккаунт, а кнопка называется «Подключить сервисный токен»; снятая галочка возвращает форму с personal access token. Подключённая карточка говорит, на каком аккаунте работает подключение, переключает режимы кнопками «Использовать личный аккаунт» и «Использовать сервисный токен», а сузить границу доступа предлагает кнопкой «Изменить доступ».
|
|
528
|
+
|
|
397
529
|
## Конфигурация GitLab
|
|
398
530
|
|
|
399
531
|
```yaml
|
|
@@ -413,7 +545,8 @@ gitlab:
|
|
|
413
545
|
searchRead: true
|
|
414
546
|
issuesRead: true
|
|
415
547
|
mergeRequestsRead: true
|
|
416
|
-
|
|
548
|
+
ciMetadataRead: true # пайплайны, джобы, их статусы; прежний ciRead задаёт обе половины
|
|
549
|
+
ciLogsRead: true # содержимое лога джоба: только личный аккаунт
|
|
417
550
|
maxFileBytes: 131072 # сколько тела файла отдаём модели
|
|
418
551
|
maxJobLogBytes: 262144 # сколько лога джобы отдаём модели
|
|
419
552
|
maxSearchResults: 50 # потолок per page у поиска
|
|
@@ -427,7 +560,7 @@ OAuth-приложение для GitLab не нужно: подключение
|
|
|
427
560
|
Спецификация `docs/SPEC-providers-gitlab.md` описывает целевую архитектуру; в этой версии сознательно реализована только read-only фаза, как и у Bitrix24:
|
|
428
561
|
|
|
429
562
|
- **OAuth Authorization Code + PKCE** (§8.1) — вместо него PAT (§8.2). Для OAuth нужны callback-маршрут на хосте, одноразовый state и refresh-цикл; это отдельная фаза.
|
|
430
|
-
- **Пользовательская граница ресурсов** (§12):
|
|
563
|
+
- **Пользовательская граница ресурсов** (§12): в личном режиме доступ ограничен правами токена и персональной политикой возможностей, но не выбранным набором проектов/групп. Выбранный набор есть только в сервисном режиме: там границу задаёт администратор в профиле, а пользователь может её сузить, но не расширить.
|
|
431
564
|
- **Pending actions и подтверждения** (§15) — вместе с ними отложены все записи: комментарии, создание задач и MR, запуск и отмена пайплайнов.
|
|
432
565
|
- **Кэш** (§21) отсутствует полностью, поэтому и межпользовательской утечки через кэш быть не может; пагинация stateless, подписанных continuation-токенов нет.
|
|
433
566
|
- **Webhooks** (§23) и **официальный GitLab MCP** (§24) — не подключены; REST API v4 остаётся единственным бэкендом.
|
|
@@ -485,6 +618,203 @@ OAuth-приложение для Jira не нужно: подключение
|
|
|
485
618
|
- **Кэш** (§Caching) отсутствует полностью, поэтому и межпользовательской утечки через кэш быть не может: схема полей перечитывается на каждый такой вызов, а курсор поиска — это continuation-токен Jira, а не наше состояние.
|
|
486
619
|
- **Rate limiting** (§Rate limiting): лимитов на пользователя и на сайт нет; вместо них — ограниченные страницы, таймаут стенда (`timeoutMs`) и повторы с `Retry-After` для 429/5xx. Инвалидация по webhooks (§Future work) — тоже не подключена.
|
|
487
620
|
|
|
621
|
+
## Инструменты Test IT
|
|
622
|
+
|
|
623
|
+
Test IT — система управления тестированием: тест-библиотека, тест-планы, прогоны
|
|
624
|
+
и результаты. Все 22 инструмента только читают; каждый называет capability, и
|
|
625
|
+
выключенную оператором возможность агент не получает вовсе.
|
|
626
|
+
|
|
627
|
+
| Tool | Что делает |
|
|
628
|
+
|---|---|
|
|
629
|
+
| `testit_connection_get` | К какой инсталляции подключено и видит ли токен проекты |
|
|
630
|
+
| `testit_projects` | Проекты с числом тест-кейсов, чек-листов и автотестов |
|
|
631
|
+
| `testit_project_get` | Карточка проекта: описание, счётчики, схема атрибутов |
|
|
632
|
+
| `testit_sections` | Разделы (папки) тест-библиотеки проекта |
|
|
633
|
+
| `testit_work_items` | Тест-кейсы, чек-листы и общие шаги проекта по фильтрам |
|
|
634
|
+
| `testit_work_item_get` | Тест-кейс целиком: шаги, предусловия, атрибуты, теги, вложения |
|
|
635
|
+
| `testit_work_item_history` | История изменений: кто что поменял, из чего в что |
|
|
636
|
+
| `testit_work_item_comments` | Комментарии к тест-кейсу |
|
|
637
|
+
| `testit_work_item_test_results` | История результатов тест-кейса по прогонам и конфигурациям |
|
|
638
|
+
| `testit_test_plans` | Тест-планы проекта со статусом и сроками |
|
|
639
|
+
| `testit_test_plan_get` | Карточка тест-плана |
|
|
640
|
+
| `testit_test_plan_summary` | Прогресс плана: тест-поинты, автоматизация, дефекты |
|
|
641
|
+
| `testit_test_runs` | Прогоны проекта по состояниям, датам и тест-плану |
|
|
642
|
+
| `testit_test_run_get` | Карточка прогона |
|
|
643
|
+
| `testit_test_run_results` | Что было в прогоне: тест-поинты с итогом и результатами |
|
|
644
|
+
| `testit_test_result_get` | Результат теста: шаги, длительность, сообщение, трейсы |
|
|
645
|
+
| `testit_test_result_attachments` | Метаданные вложений результата |
|
|
646
|
+
| `testit_attachment_metadata` | Метаданные вложения |
|
|
647
|
+
| `testit_attachment_text` | Текст небольшого текстового вложения (бинарные и архивы отбиваются) |
|
|
648
|
+
| `testit_auto_tests` | Автотесты проекта: класс, пространство имён, стабильность |
|
|
649
|
+
| `testit_auto_test_get` | Карточка автотеста: шаги, setup, teardown, последний результат |
|
|
650
|
+
| `testit_configurations` | Конфигурации проекта, в разрезе которых считаются результаты |
|
|
651
|
+
|
|
652
|
+
## Возможности и скопы Test IT
|
|
653
|
+
|
|
654
|
+
| Возможность | Что открывает |
|
|
655
|
+
|---|---|
|
|
656
|
+
| `projects.read` | Проекты и карточка проекта, проба подключения |
|
|
657
|
+
| `sections.read` | Разделы тест-библиотеки |
|
|
658
|
+
| `workItems.read` | Тест-кейсы, чек-листы, общие шаги |
|
|
659
|
+
| `history.read` | История изменений тест-кейса |
|
|
660
|
+
| `comments.read` | Комментарии тест-кейса |
|
|
661
|
+
| `testPlans.read` | Тест-планы, карточка и сводка |
|
|
662
|
+
| `testRuns.read` | Прогоны и карточка прогона |
|
|
663
|
+
| `testResults.read` | Результаты прогона, отдельный результат, история результатов |
|
|
664
|
+
| `autoTests.read` | Автотесты |
|
|
665
|
+
| `attachments.read` | Метаданные вложений и текст текстовых файлов |
|
|
666
|
+
| `configurations.read` | Конфигурации проекта |
|
|
667
|
+
|
|
668
|
+
Сужения по «выданным правам» здесь нет: API v2 не сообщает, какие права у
|
|
669
|
+
токена (в отличие от вебхука Bitrix24 с его scope и GitLab с
|
|
670
|
+
`personal_access_tokens/self`). Поэтому список возможностей — ровно то, что
|
|
671
|
+
разрешил оператор стенда, а дальше отказывает сам Test IT: `403` приходит
|
|
672
|
+
модели как `ProviderPermissionDenied`, а не превращается в пустой ответ.
|
|
673
|
+
|
|
674
|
+
Три читающих списка Test IT помечает устаревшими (`GET /projects`,
|
|
675
|
+
`GET /projects/{projectId}/workItems`, `GET /autoTests`). Они оставлены: это
|
|
676
|
+
единственные GET-чтения этих коллекций, а поиск (`POST /workItems/search`),
|
|
677
|
+
статистика прогона и глобальный поиск — POST-эндпоинты, которых в каталоге нет
|
|
678
|
+
по правилу «каждая операция каталога — GET». Что из-за этого недоступно и чем
|
|
679
|
+
заменено — в [SPEC-providers-testit.md](https://github.com/xarleyn/dsh-plugins/blob/main/plugins/dsh-qa-integrations/docs/SPEC-providers-testit.md).
|
|
680
|
+
|
|
681
|
+
## Как подключается Test IT
|
|
682
|
+
|
|
683
|
+
Test IT бывает облачный и self-hosted, поэтому адрес задаёт оператор стенда
|
|
684
|
+
списком инсталляций (`testit.instances`) — пользователь выбирает инсталляцию из
|
|
685
|
+
списка и вводит только свой API-токен:
|
|
686
|
+
|
|
687
|
+
```yaml
|
|
688
|
+
testit:
|
|
689
|
+
instances:
|
|
690
|
+
- id: cloud
|
|
691
|
+
label: Test IT Cloud
|
|
692
|
+
baseUrl: https://team.example.testit.software
|
|
693
|
+
```
|
|
694
|
+
|
|
695
|
+
Правила те же, что у GitLab и Jira: только `https://` (кроме осознанной
|
|
696
|
+
лазейки `allowInsecureHttp` для внутреннего стенда), никаких credentials в URL,
|
|
697
|
+
query и фрагмента, а хвостовой слэш снимается. Опечатка оператора падает при
|
|
698
|
+
загрузке конфига. Адрес не хранится в подключении: он перечитывается из
|
|
699
|
+
конфига на каждом вызове, поэтому удаление или переадресация инсталляции
|
|
700
|
+
закрывает и уже созданные подключения. Если инсталляций нет, карточка говорит
|
|
701
|
+
об этом и формы не показывает.
|
|
702
|
+
|
|
703
|
+
Токен Test IT едет только заголовком `Authorization: PrivateToken …`. Владельца
|
|
704
|
+
токена API v2 не сообщает (эндпоинта вида `/me` в спецификации нет), поэтому
|
|
705
|
+
после проверки карточка показывает инсталляцию и число видимых проектов, а не
|
|
706
|
+
имя аккаунта.
|
|
707
|
+
|
|
708
|
+
## Конфигурация Test IT
|
|
709
|
+
|
|
710
|
+
```yaml
|
|
711
|
+
testit:
|
|
712
|
+
enabled: true
|
|
713
|
+
allowInsecureHttp: false # лазейка для внутреннего стенда; в проде HTTPS
|
|
714
|
+
instances:
|
|
715
|
+
- id: cloud
|
|
716
|
+
label: Test IT Cloud
|
|
717
|
+
baseUrl: https://team.example.testit.software
|
|
718
|
+
projectsRead: true # флаги возможностей: выключенная не доходит до агента
|
|
719
|
+
sectionsRead: true
|
|
720
|
+
workItemsRead: true
|
|
721
|
+
historyRead: true
|
|
722
|
+
commentsRead: true
|
|
723
|
+
testPlansRead: true
|
|
724
|
+
testRunsRead: true
|
|
725
|
+
testResultsRead: true
|
|
726
|
+
autoTestsRead: true
|
|
727
|
+
attachmentsRead: true
|
|
728
|
+
configurationsRead: true
|
|
729
|
+
defaultResults: 20 # размер списка, когда модель не назвала лимит
|
|
730
|
+
maxResults: 100 # жёсткий потолок одного ответа-списка
|
|
731
|
+
defaultAttachmentBytes: 262144 # бюджет чтения вложения по умолчанию
|
|
732
|
+
maxAttachmentBytes: 10485760 # жёсткий потолок чтения вложения (10 MiB)
|
|
733
|
+
attachmentTimeoutMs: 30000 # таймаут скачивания вложения
|
|
734
|
+
retries: 2 # повторы для 429/5xx и сетевых сбоев
|
|
735
|
+
```
|
|
736
|
+
|
|
737
|
+
## Чего в Test IT-провайдере ещё нет
|
|
738
|
+
|
|
739
|
+
Спецификация `docs/SPEC-providers-testit.md` описывает целевую архитектуру; в
|
|
740
|
+
этой версии реализована read-only фаза, как и у остальных пяти провайдеров:
|
|
741
|
+
|
|
742
|
+
- **Поиск и статистика через POST**: `POST /workItems/search`,
|
|
743
|
+
`POST /testRuns/{id}/statistics/filter`, `POST /testResults/statistics/filter`
|
|
744
|
+
и глобальный поиск не используются — в каталоге нет ни одной не-GET операции.
|
|
745
|
+
Фильтр по имени применяется к возвращённой странице, статистика прогона
|
|
746
|
+
заменена чтением тест-поинтов прогона и сводкой тест-плана.
|
|
747
|
+
- **Скачивание вложений**: доступен только текст небольших текстовых файлов;
|
|
748
|
+
архивы, изображения и документы отбиваются по имени из метаданных, а не
|
|
749
|
+
инлайнятся.
|
|
750
|
+
- **Запись** (комментарии, правка тест-кейсов, создание и жизненный цикл
|
|
751
|
+
прогона, загрузка вложений): требует confirmation-фреймворка
|
|
752
|
+
(`prepare → confirm → execute`), которого пока нет ни у одного провайдера.
|
|
753
|
+
В каталоге нет ни одной операции со словом `prepare`.
|
|
754
|
+
- **Проверка CIDR для приватных адресов**: границей исходящих направлений
|
|
755
|
+
служит список инсталляций оператора, а не проверка диапазонов RFC1918 — у
|
|
756
|
+
on-prem TMS внутренний адрес штатный, а ограничение egress остаётся задачей
|
|
757
|
+
сетевой политики стенда.
|
|
758
|
+
- **Контрактные тесты**: утверждения о поведении устаревших GET-списков, о
|
|
759
|
+
содержимом ответа списка прогонов и о регистре query-параметров — выводы из
|
|
760
|
+
OpenAPI-спеки официального клиента, а не измерения живой инсталляции
|
|
761
|
+
(Cloud и on-prem). Список вопросов — в спецификации.
|
|
762
|
+
- **Кэш, circuit breaker, семантический индекс и webhooks**: не реализованы;
|
|
763
|
+
кэша нет вовсе, поэтому и межпользовательской утечки через него быть не
|
|
764
|
+
может.
|
|
765
|
+
|
|
766
|
+
## Сервисные токены (managed service credentials)
|
|
767
|
+
|
|
768
|
+
Развёртывание может завести один read-only сервисный токен и разрешить подключениям работать от его имени: выпустить personal access token может не каждый — у подрядчика нет своей учётной записи в корпоративном GitLab, стажёру не выдали прав на токен, — а один централизованно сменяемый аккаунт снимает с пользователей и ротацию, и вопрос «чей это был доступ». Владелец токена — развёртывание: пользователь не может ни создать профиль, ни сменить секрет, ни выбрать профиль по id. Возможность реализована у GitLab и TeamCity; остальные интеграции сервисного режима не предлагают, и в их карточках о нём ничего не появляется.
|
|
769
|
+
|
|
770
|
+
```yaml
|
|
771
|
+
managedServiceCredentials:
|
|
772
|
+
enabled: true
|
|
773
|
+
defaultForNewConnections: true
|
|
774
|
+
profiles:
|
|
775
|
+
- id: gitlab-corp-readonly
|
|
776
|
+
provider: gitlab
|
|
777
|
+
instance: corp # id из gitlab.instances
|
|
778
|
+
label: QA GitLab Read-only # псевдоним, который видит пользователь
|
|
779
|
+
credential:
|
|
780
|
+
type: pat
|
|
781
|
+
secretFile: /run/secrets/qa_gitlab_service_token
|
|
782
|
+
resources:
|
|
783
|
+
projects:
|
|
784
|
+
- "1208"
|
|
785
|
+
- group/product
|
|
786
|
+
groups:
|
|
787
|
+
- group/platform
|
|
788
|
+
policy:
|
|
789
|
+
gitlab.issues.read: deny # только сужение; "allow" отвергается при загрузке
|
|
790
|
+
- id: teamcity-readonly
|
|
791
|
+
provider: teamcity
|
|
792
|
+
instance: teamcity # сервер TeamCity один, id фиксирован
|
|
793
|
+
label: QA TeamCity Read-only
|
|
794
|
+
credential:
|
|
795
|
+
type: personal_access_token
|
|
796
|
+
secretEnv: QA_TEAMCITY_SERVICE_TOKEN
|
|
797
|
+
resources:
|
|
798
|
+
projects:
|
|
799
|
+
- PLATFORM
|
|
800
|
+
```
|
|
801
|
+
|
|
802
|
+
`enabled` по умолчанию `false`: пока развёртывание не включило срез, о сервисном токене нет ни строчки — ни чекбокса в форме подключения, ни профилей, ни нового поведения. `defaultForNewConnections` решает, с какого режима начинается новое подключение. `resources` обязателен и проверяется при загрузке: профиль без границы — это общий аккаунт, который видит всё, что видит его владелец, и ровно этого возможность не допускает. Записи `resources` — те идентификаторы, которые принимает сам провайдер: id проекта GitLab или полный путь, путь группы, id проекта TeamCity. Секрет берётся из смонтированного файла (`secretFile`) или из переменной окружения (`secretEnv`) — ровно один из двух, в YAML он не лежит. Опечатка в профиле роняет загрузку конфига, а не выбрасывает профиль молча: сообщение называет профиль или инстанс и говорит, что именно не так, — неизвестный провайдер, неизвестный инстанс, инстанс, занятый двумя профилями, или `resources`, не назвавший ни одного вида ресурсов.
|
|
803
|
+
|
|
804
|
+
Новое подключение начинается на сервисном токене, когда профиль для выбранного инстанса есть и `defaultForNewConnections` включён (по умолчанию так): чекбокс «Использовать сервисный токен» в форме уже отмечен, поля токена нет вовсе, а кнопка называется «Подключить сервисный токен». Снятая галочка возвращает обычную форму с personal access token. У уже существующих подключений режим не меняется: он хранится в самом подключении, поэтому обновление стенда не переводит пользователя на общий аккаунт само. В подключённой карточке режим виден строкой «Сервисный аккаунт · управляется администратором», а рядом — «Изменить доступ» и «Использовать личный аккаунт».
|
|
805
|
+
|
|
806
|
+
Сервисный режим — не «read-only вообще», а жёсткий потолок: только `read`, только обычная чувствительность и только операции, которые провайдер пометил service-safe намеренно. Запись, админ-действия, управление правами и токенами и произвольный REST недостижимы, даже если сервисный токен наверху это умеет: классификация операции — свойство каталога провайдера, а не прав токена. Чувствительные чтения остаются личными: через общий аккаунт не читаются лог CI-джоба GitLab (`ci.logs.read`), лог сборки TeamCity (`logs.read`) и текст артефакта (`artifacts.read`), а конфиденциальная задача GitLab не возвращается вовсе — прямое чтение отвечает `ResourceNotFound`, из выдачи и из поиска она выпадает, а поиск по комментариям (`scope: notes`) отказывается целиком: у комментария нет признака конфиденциальности, и проверить его родителя одним запросом нельзя. Операция, которую провайдер не классифицировал, отклоняется по умолчанию: инструмент, добавленный обновлением провайдера, недостижим через общий аккаунт, пока кто-то не классифицирует его намеренно. Администраторская `policy` может только выключить: `allow` в профиле отвергается при загрузке, потому что оператор, написавший `allow`, считает, что расширил потолок.
|
|
807
|
+
|
|
808
|
+
Граница ресурсов нужна потому, что сервисный аккаунт видит больше, чем один пользователь. В сервисном режиме провайдер сверяет с allowlist каждый вызов: проект, названный по id или по пути, должен быть в списке или под перечисленной группой; сборка TeamCity, названная по id, сначала разрешается в свой проект; листинг, не называющий проект, отказывается, а не отвечает всей картиной, доступной общему аккаунту. Список проектов (`gitlab_projects_list`, `teamcity_projects`) собирается из allowlist, а не из того, что видит сервисный токен: проект, которого токен не видит, приходит в `unavailableResources`, а не исчезает молча, — это и есть ответ оператору, что граница и токен разошлись. Разворачивая группу GitLab, провайдер просит только её собственные проекты (`with_shared=false`) и дополнительно сверяет каждый вернувшийся проект с границей: чужой проект, расшаренный в группу, в выдачу не попадает. Пользователь может сузить список в карточке кнопкой «Изменить доступ», но не расширить: выбор вне администраторского списка отбрасывается и не сохраняется.
|
|
809
|
+
|
|
810
|
+
Режим — одно из двух явных значений, `personal` или `service`; `auto` не существует. Отказ в личном режиме (`403` от GitLab или TeamCity) — это отказ: его не повторяют сервисным токеном, и наоборот тоже. Если личный токен был сохранён раньше, он остаётся зашифрованным в хранилище, но не тратится, пока подключение работает на сервисном; «Использовать личный аккаунт» возвращает его, а если личного токена не сохраняли, переключение отвечает `PersonalCredentialRequired` вместо подключения без личности. Переключение в любую сторону поднимает binding revision, поэтому всё, что было выведено из прежней личности, с этого момента недействительно.
|
|
811
|
+
|
|
812
|
+
Секрет читается лениво, из файла или из переменной окружения, и кэшируется по отпечатку: ротация смонтированного секрета действует со следующего вызова — никому не нужно переподключаться и хост не нужно перезапускать, а содержимое секрета хешируется в ревизию credential. Сам секрет не пишется в лог, не возвращается в браузер и не рендерится: карточка показывает администраторский псевдоним профиля. Пропавший или пустой секрет — `ServiceCredentialUnavailable` (профиль не обслуживает ничего, пока файл не появится), не подходящий провайдеру — `ServiceCredentialInvalid`, выключенный профиль — `ServiceCredentialDisabled`. Проверка подключения читает вердикт пробы: истёкший или отозванный токен переводит подключение в «нужна проверка» и отвечает отказом, а слишком широкий токен (`ServiceCredentialUnsafeScope`) подключение не ломает — потолок режима уже ограничивает доступ, — но карточка о нём говорит, потому что сузить токен может только оператор. Остальные отказы карточка переводит на человеческий: `ServiceResourceNotAllowed` — «сузьте доступ в списке или подключите личный аккаунт», `SensitiveReadRequiresPersonalCredential` — «нужен личный аккаунт», `OperationNotAllowedWithServiceCredential` — «сервисный режим только для безопасного чтения».
|
|
813
|
+
|
|
814
|
+
Аудит в сервисном режиме — единственная запись о том, кто на самом деле спросил: наверху виден только сервисный аккаунт, поэтому каждая строка журнала хранит аутентифицированного пользователя QA, провайдера, операцию, `credential_source` и id профиля. Пишутся и отказы — по потолку и по границе, — иначе запрос, который upstream не может отличить от чужого, не оставил бы следа. Секрет не попадает ни в журнал, ни в результат инструмента.
|
|
815
|
+
|
|
816
|
+
Rate limiting по principal и по credential не реализован; межвызовных кэшей результатов в плагине нет ни у одного провайдера, поэтому переключение режимов не может отдать устаревшие данные.
|
|
817
|
+
|
|
488
818
|
## Граница доверия
|
|
489
819
|
|
|
490
820
|
Интеграционный principal получается только из QA Surface:
|
|
@@ -494,11 +824,40 @@ OAuth-приложение для Jira не нужно: подключение
|
|
|
494
824
|
3. интеграционный principal закрепляется только если текущий пользователь и владелец совпадают;
|
|
495
825
|
4. администраторский просмотр чужого чата, неаттестованная сессия и subagent не получают principal;
|
|
496
826
|
5. broker находит подключение по паре `ownerUserId + provider` и только внутри себя расшифровывает credential;
|
|
497
|
-
6. адрес внешнего сервиса приходит только из конфига оператора: у GitLab, Jira и
|
|
498
|
-
7. у Jira модели не достаётся и язык запросов: JQL собирается из типизированных аргументов внутри провайдера, а значения экранируются как строковые литералы;
|
|
499
|
-
8. справочник пользователей Jira читается только для того, чтобы превратить имя из фильтра в accountId: ответ справочника не попадает ни в результат тула, ни в лог, а неоднозначное имя — отказ, а не выбор человека за
|
|
827
|
+
6. адрес внешнего сервиса приходит только из конфига оператора: у GitLab, Jira, Confluence, Test IT и Weblate это выбранная инсталляция из списка оператора, у Bitrix24 — проверенный по доменному allowlist URL вебхука, у TeamCity — адрес, проверенный по политике стенда (и при сохранении, и на каждом вызове);
|
|
828
|
+
7. у Jira модели не достаётся и язык запросов: JQL собирается из типизированных аргументов внутри провайдера, а значения экранируются как строковые литералы; у Weblate так же собирается `q`, и `next`-ссылка разбирается на номер страницы, а не берётся как адрес следующего запроса;
|
|
829
|
+
8. справочник пользователей Jira читается только для того, чтобы превратить имя из фильтра в accountId: ответ справочника не попадает ни в результат тула, ни в лог, а неоднозначное имя — отказ, а не выбор человека за пользователя;
|
|
830
|
+
9. в сервисном режиме личность на стороне провайдера принадлежит развёртыванию, а не пользователю: подключение тратит один общий read-only аккаунт, и ни один запрос не уходит от имени вошедшего;
|
|
831
|
+
10. локальный audit — единственная запись о том, кто спросил на самом деле: upstream видит только сервисный аккаунт, поэтому строка журнала хранит владельца подключения, provider, operation, `credential_source` и id сервисного профиля;
|
|
832
|
+
11. неявного отката нет ни в одну сторону: сервисный режим не подменяет личный после отказа и наоборот, а переключение режима поднимает binding revision и обесценивает всё, что было выведено из прежней личности.
|
|
500
833
|
|
|
501
|
-
В логах и audit сохраняются
|
|
834
|
+
В логах и audit сохраняются provider, operation, result и source session id; в audit к этому добавлены владелец подключения, `credential_source` и id сервисного профиля — у личного подключения это `personal` и `null`. Тела CRM/чатов, HTTP-заголовки и секреты не журналируются. Постоянный cache данных провайдера отсутствует, поэтому и смена режима не может отдать данные, прочитанные под прежней личностью.
|
|
835
|
+
|
|
836
|
+
## Подсказки к credential
|
|
837
|
+
|
|
838
|
+
Рядом с полем секрета карточка показывает, откуда этот секрет берётся: где его выпускают, какая документация описывает авторизацию, какие права нужны и что именно вставлять в поле. Текст раскрывается по клику в панель, а не занимает карточку целиком; формулировка зависит от механизма — «Создать API-ключ», «Создать токен», «Войти и авторизовать», «Как это настроить» для подключения без страницы выдачи (вебхук Bitrix24).
|
|
839
|
+
|
|
840
|
+
Подсказка — это метаданные, а не секрет. В ней нет ни значения credential, ни его снимка, ни результата авторизации; браузер получает её тем же RPC `qaIntegrations/providers`, что и список провайдеров, уже после входа в QA-аккаунт. Она не является зависимостью подключения: если метаданных нет, карточка показывает обычное поле секрета, а сломавшаяся ссылка не мешает ни сохранить, ни проверить credential.
|
|
841
|
+
|
|
842
|
+
Метаданные объявлены рядом с провайдером — `src/providers/<id>/credential-help.ts` — и не хранятся центральным списком, поэтому новая интеграция приносит свою подсказку вместе с собой. Ссылки проверяются по форме, без обращения к сети: допускаются только `https:` и — для локальных, приватных и self-hosted адресов — `http:`; `javascript:`, `data:`, `file:` и адрес с credential внутри отклоняются, а внешние ссылки открываются с `noopener noreferrer`.
|
|
843
|
+
|
|
844
|
+
Развёртывание может заменить подсказку целиком или по полям: корпоративный GitLab, Jira Data Center, внутренняя вики и прокси-шлюзы попадают в тот же UI, что и облачные сервисы.
|
|
845
|
+
|
|
846
|
+
```yaml
|
|
847
|
+
credentialHelp:
|
|
848
|
+
gitlab:
|
|
849
|
+
obtainUrl: https://gitlab.example.internal/-/user_settings/personal_access_tokens
|
|
850
|
+
obtainLabel: Выпустить токен
|
|
851
|
+
docsUrl: https://wiki.example.internal/dsh/gitlab
|
|
852
|
+
instructions: Откройте внутреннюю страницу токенов.
|
|
853
|
+
selfHosted: true
|
|
854
|
+
jira:
|
|
855
|
+
enabled: false # спрятать подсказку; поле секрета остаётся
|
|
856
|
+
weblate:
|
|
857
|
+
docsLabel: Наша вики
|
|
858
|
+
```
|
|
859
|
+
|
|
860
|
+
Оверрайд действует на всю инсталляцию и не меняет сам механизм подключения: невалидный адрес скрывает только свою ссылку, а в лог при старте попадает предупреждение `credential-help.override` с именем провайдера и поля. Неизвестный `kind` деградирует до `custom`, а не ломает провайдера. Значения по умолчанию для каждого провайдера и порядок добавления новой подсказки — в [src/providers/README.md](https://github.com/xarleyn/dsh-plugins/blob/main/plugins/dsh-qa-integrations/src/providers/README.md).
|
|
502
861
|
|
|
503
862
|
## Подготовка master key
|
|
504
863
|
|
|
@@ -543,6 +902,40 @@ $keyBytes = [Security.Cryptography.RandomNumberGenerator]::GetBytes(32)
|
|
|
543
902
|
- .bitrix24.ru
|
|
544
903
|
- .bitrix24.com
|
|
545
904
|
- .bitrix24.eu
|
|
905
|
+
credentialHelp:
|
|
906
|
+
gitlab:
|
|
907
|
+
obtainUrl: https://gitlab.example.internal/-/user_settings/personal_access_tokens
|
|
908
|
+
docsUrl: https://wiki.example.internal/dsh/gitlab
|
|
909
|
+
selfHosted: true
|
|
910
|
+
managedServiceCredentials:
|
|
911
|
+
enabled: true
|
|
912
|
+
defaultForNewConnections: true
|
|
913
|
+
profiles:
|
|
914
|
+
- id: gitlab-corp-readonly
|
|
915
|
+
provider: gitlab
|
|
916
|
+
instance: corp
|
|
917
|
+
label: QA GitLab Read-only
|
|
918
|
+
credential:
|
|
919
|
+
type: pat
|
|
920
|
+
secretFile: /run/secrets/qa_gitlab_service_token
|
|
921
|
+
resources:
|
|
922
|
+
projects:
|
|
923
|
+
- "1208"
|
|
924
|
+
- group/product
|
|
925
|
+
groups:
|
|
926
|
+
- group/platform
|
|
927
|
+
policy:
|
|
928
|
+
gitlab.issues.read: deny
|
|
929
|
+
- id: teamcity-readonly
|
|
930
|
+
provider: teamcity
|
|
931
|
+
instance: teamcity
|
|
932
|
+
label: QA TeamCity Read-only
|
|
933
|
+
credential:
|
|
934
|
+
type: personal_access_token
|
|
935
|
+
secretEnv: QA_TEAMCITY_SERVICE_TOKEN
|
|
936
|
+
resources:
|
|
937
|
+
projects:
|
|
938
|
+
- PLATFORM
|
|
546
939
|
bitrix24:
|
|
547
940
|
enabled: true
|
|
548
941
|
crmRead: true
|
|
@@ -559,6 +952,9 @@ $keyBytes = [Security.Cryptography.RandomNumberGenerator]::GetBytes(32)
|
|
|
559
952
|
- id: gitlab-com
|
|
560
953
|
label: GitLab.com
|
|
561
954
|
baseUrl: https://gitlab.com
|
|
955
|
+
- id: corp
|
|
956
|
+
label: Corporate GitLab
|
|
957
|
+
baseUrl: https://gitlab.example.internal
|
|
562
958
|
confluence:
|
|
563
959
|
enabled: true
|
|
564
960
|
instances:
|
|
@@ -583,9 +979,23 @@ $keyBytes = [Security.Cryptography.RandomNumberGenerator]::GetBytes(32)
|
|
|
583
979
|
- id: company
|
|
584
980
|
label: company.atlassian.net
|
|
585
981
|
baseUrl: https://company.atlassian.net
|
|
982
|
+
testit:
|
|
983
|
+
enabled: true
|
|
984
|
+
instances:
|
|
985
|
+
- id: cloud
|
|
986
|
+
label: Test IT Cloud
|
|
987
|
+
baseUrl: https://team.example.testit.software
|
|
988
|
+
weblate:
|
|
989
|
+
enabled: true
|
|
990
|
+
instances:
|
|
991
|
+
- id: corp
|
|
992
|
+
label: Corporate Weblate
|
|
993
|
+
baseUrl: https://weblate.example.com
|
|
586
994
|
```
|
|
587
995
|
|
|
588
|
-
`dataPath` по умолчанию — `$DSH_HOME/qa-integrations.db` (база SQLite). Прежний файл `qa-integrations.json`, оставшийся от релиза до 0.5.0, переносится при первом запуске и переименовывается в `qa-integrations.json.migrated-<ISO>`. На Unix новый файл создаётся с mode `0600`. Журнал обращений к сервисам хранится `auditRetentionDays` дней (по умолчанию 90; `0` — не ограничивать по возрасту) и в любом случае не длиннее 5000 записей. Разрешён только HTTPS URL вида `https://company.bitrix24.ru/rest/<user>/<secret>` без query, fragment, custom port или credentials в authority. Список доменных суффиксов задаётся оператором, а не пользователем.
|
|
996
|
+
`dataPath` по умолчанию — `$DSH_HOME/qa-integrations.db` (база SQLite). Прежний файл `qa-integrations.json`, оставшийся от релиза до 0.5.0, переносится при первом запуске и переименовывается в `qa-integrations.json.migrated-<ISO>`. На Unix новый файл создаётся с mode `0600`. Журнал обращений к сервисам хранится `auditRetentionDays` дней (по умолчанию 90; `0` — не ограничивать по возрасту) и в любом случае не длиннее 5000 записей. Разрешён только HTTPS URL вида `https://company.bitrix24.ru/rest/<user>/<secret>` без query, fragment, custom port или credentials в authority. Список доменных суффиксов задаётся оператором, а не пользователем. `credentialHelp.<provider>` заменяет подсказки к полю секрета — адреса выдачи, ссылки на документацию, инструкции и список прав; на хранение, шифрование и проверку credential он не влияет.
|
|
997
|
+
|
|
998
|
+
`managedServiceCredentials` — срез, которого нет, пока `enabled: false` (значение по умолчанию): `defaultForNewConnections` решает, начинается ли новое подключение на сервисном токене, а каждый профиль связывает провайдера и его инстанс с секретом общего аккаунта (`secretFile` или `secretEnv`, ровно один из двух) и обязательной границей `resources`, внутри которой `policy` может только выключать операции. Провайдер и инстанс в профиле должны существовать в этом же конфиге, иначе загрузка падает, а сообщение называет профиль или инстанс. Правила и границы режима — в разделе «Сервисные токены (managed service credentials)».
|
|
589
999
|
|
|
590
1000
|
## Пользовательский сценарий
|
|
591
1001
|
|
|
@@ -604,7 +1014,11 @@ $keyBytes = [Security.Cryptography.RandomNumberGenerator]::GetBytes(32)
|
|
|
604
1014
|
|
|
605
1015
|
Для Confluence: оператор задаёт сайты (`confluence.instances`) и, если нужно, список разрешённых пространств, пользователь выпускает API token в своём профиле Atlassian и вводит его вместе с почтой аккаунта. Если сайт один, выбор не показывается; если сайтов нет, карточка говорит об этом и формы не показывает. Плагин прочитает `/wiki/rest/api/user/current`, покажет подключённый аккаунт, а список возможностей останется в границах, которые разрешил оператор: сам Confluence не сообщает, какие права выданы API token.
|
|
606
1016
|
|
|
607
|
-
|
|
1017
|
+
Для Test IT: оператор перечисляет инсталляции (`testit.instances`), пользователь создаёт API-токен в своём профиле Test IT, выбирает инсталляцию (если их несколько) и вставляет токен. Плагин читает `GET /api/v2/projects` — документированный первый проверочный запрос: успешный ответ доказывает и адрес, и токен, а пустой список проектов остаётся валидным результатом. Имени аккаунта карточка не показывает: API v2 не сообщает владельца токена, поэтому подключение подписано инсталляцией и числом видимых проектов, а список возможностей остаётся в границах, которые разрешил оператор.
|
|
1018
|
+
|
|
1019
|
+
Для Weblate: оператор задаёт инстансы (`weblate.instances`), пользователь выпускает API-токен в своём профиле Weblate и выбирает инстанс, если их несколько. Если инстансов нет, карточка говорит об этом и формы не показывает. Аккаунт и вид токена плагин покажет по `GET /api/users/`: личный токен виден там одной своей строкой, а токен, который умеет перечислять пользователей, приносит полный список — тогда карточка называет инстанс и вид токена вместо угаданного имени. Список возможностей останется в границах, которые разрешил оператор: сам Weblate не сообщает, какие права выданы токену.
|
|
1020
|
+
|
|
1021
|
+
Отключение атомарно удаляет локальный encrypted secret; дальнейшие tool calls получают `IntegrationNotConnected`. Generic REST/MCP вызовы отсутствуют; запись — только единственный таймлайн-комментарий Bitrix24 за явным флагом, возможностью и политикой. OAuth и confirmation-based writes намеренно остаются следующими фазами спецификации для всех провайдеров.
|
|
608
1022
|
|
|
609
1023
|
## Проверка пакета
|
|
610
1024
|
|
|
@@ -612,6 +1026,5 @@ $keyBytes = [Security.Cryptography.RandomNumberGenerator]::GetBytes(32)
|
|
|
612
1026
|
pnpm --filter @yadsh/dsh-qa-integrations check
|
|
613
1027
|
```
|
|
614
1028
|
|
|
615
|
-
Unit/integration набор проверяет AEAD, неверный ключ, rewrap, SSRF-ограничение webhook URL, адресов инстансов, политики адресов TeamCity
|
|
1029
|
+
Unit/integration набор проверяет AEAD, неверный ключ, rewrap, SSRF-ограничение webhook URL, адресов инстансов, политики адресов TeamCity, списка сайтов Jira, инсталляций Test IT и инстансов Weblate, redaction (включая форму gitlab-токена и секреты, напечатанные в логе), escape locator-значений, нарезку и чистку логов, отказ по бинарным и архивным артефактам, отсутствие model-visible identity/secret selectors, отказ unowned/subagent-сессии, соответствие каждого tool операции каталога, read-only характер всех семи каталогов за исключением единственного флагуемого таймлайн-комментария Bitrix24, привязка любой write-методы к `crm.comment.write`, сужение возможностей по scopes вебхука и токена, потолок и границу сервисного токена (включая конфигурацию профилей, отсутствие неявного отката между режимами, ротацию секрета под работающим подключением и аудит реального пользователя), отображение ошибок провайдеров в доменные коды, обрезку больших ответов и параллельную изоляцию Alice/Bob. Для Jira отдельно проверяются экранирование JQL, отказ поиска без фильтров, allow-list читающих путей, рендер ADF и то, что токен не попадает ни в URL, ни в результат тула. Для Confluence — сборка CQL, разбор Atlassian Document Format, политика пространств и отказ токену, чей сайт убрали из конфига. Для Test IT — канонизация списка инсталляций, проба подключения документированным запросом, только-GET каталог, лимиты страниц и вложений, redaction текстовых вложений и отсутствие токена в URL и теле. Для Weblate — сборка `q` с экранированием значений, отказ неподдерживаемым фильтрам и операциям, проверка origin у `next`, нормализация состояний и форм множественного числа, untrusted-маркер и отказ credential, чей инстанс убрали из конфига. Отдельный гейт следит за границей провайдеров: `verify:package` падает, если в общем слое появится имя конкретной интеграции, а тест `provider boundary` — если брокер начнёт зависеть от конкретного провайдера. Собранный клиентский бандл проверяется отдельным тестом: он поднимается в песочнице как в браузере — через `window.__ModuleLoader__` с таблицей модулей, в которой есть только React, — регистрируется под полным именем пакета и монтирует карточку Confluence из секции, которую сам зарегистрировал.
|
|
616
1030
|
|
|
617
|
-
Unit/integration набор проверяет AEAD, неверный ключ, rewrap, SSRF-ограничение webhook URL, адресов инстансов и политики адресов TeamCity, redaction (включая форму gitlab-токена и секреты, напечатанные в логе), escape locator-значений, нарезку и чистку логов, отказ по бинарным и архивным артефактам, отсутствие model-visible identity/secret selectors, отказ unowned/subagent-сессии, соответствие каждого tool операции каталога, read-only характер всех четырёх каталогов, сужение возможностей по scopes вебхука и токена, отображение ошибок GitLab, TeamCity и Confluence в доменные коды, обрезку больших ответов и параллельную изоляцию Alice/Bob. Для Confluence отдельно проверяются сборка CQL с экранированием литералов, разбор Atlassian Document Format с плейсхолдерами для макросов и медиа, отказ в пространстве вне allowlist и на поиске, и на прямом чтении, вложение `untrustedContent` в ответы со страницами и комментариями, а также отказ токену, чей сайт убрали из конфига. Отдельный гейт следит за границей провайдеров: `verify:package` падает, если в общем слое появится имя конкретной интеграции, а тест `provider boundary` — если брокер начнёт зависеть от Bitrix24. Собранный клиентский бандл проверяется отдельным тестом: он поднимается в песочнице как в браузере — через `window.__ModuleLoader__` с таблицей модулей, в которой есть только React, — регистрируется под полным именем пакета и монтирует карточку Confluence из секции, которую сам зарегистрировал.
|