@yadsh/dsh-qa-integrations 0.6.0 → 0.8.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 +341 -303
- package/lib/broker.js +12 -0
- package/lib/broker.js.map +1 -1
- package/lib/client/bitrix24.js +66 -5
- package/lib/client/bitrix24.js.map +1 -1
- package/lib/client/confluence.js +117 -128
- package/lib/client/confluence.js.map +1 -1
- package/lib/client/gitlab.js +1 -1
- package/lib/client/gitlab.js.map +1 -1
- package/lib/client/index.js +25 -5
- package/lib/client/index.js.map +1 -1
- package/lib/client/integrations.js +1 -1
- package/lib/client/integrations.js.map +1 -1
- package/lib/client/jira.js +115 -126
- package/lib/client/jira.js.map +1 -1
- package/lib/client/operator-card.js +537 -0
- package/lib/client/operator-card.js.map +1 -0
- package/lib/client/operator-controls.js +232 -0
- package/lib/client/operator-controls.js.map +1 -0
- package/lib/client/styles.js +60 -0
- package/lib/client/styles.js.map +1 -1
- package/lib/client/testit.js +39 -3
- package/lib/client/testit.js.map +1 -1
- package/lib/client/weblate.js +38 -3
- package/lib/client/weblate.js.map +1 -1
- package/lib/client.js +2966 -871
- package/lib/client.js.map +1 -1
- package/lib/coerce.js +17 -1
- package/lib/coerce.js.map +1 -1
- package/lib/config.js.map +1 -1
- package/lib/errors.js +22 -0
- package/lib/errors.js.map +1 -1
- package/lib/index.js +211 -52
- package/lib/index.js.map +1 -1
- package/lib/providers/bitrix24/catalog.js +138 -8
- package/lib/providers/bitrix24/catalog.js.map +1 -1
- package/lib/providers/bitrix24/config.js +84 -14
- package/lib/providers/bitrix24/config.js.map +1 -1
- package/lib/providers/bitrix24/index.js +100 -0
- package/lib/providers/bitrix24/index.js.map +1 -1
- package/lib/providers/bitrix24/operations.js +5 -9
- package/lib/providers/bitrix24/operations.js.map +1 -1
- package/lib/providers/bitrix24/transport.js +11 -31
- package/lib/providers/bitrix24/transport.js.map +1 -1
- package/lib/providers/confluence/adf.js +28 -23
- package/lib/providers/confluence/adf.js.map +1 -1
- package/lib/providers/confluence/catalog.js +91 -7
- package/lib/providers/confluence/catalog.js.map +1 -1
- package/lib/providers/confluence/config.js +27 -2
- package/lib/providers/confluence/config.js.map +1 -1
- package/lib/providers/confluence/credential-help.js +14 -8
- package/lib/providers/confluence/credential-help.js.map +1 -1
- package/lib/providers/confluence/dialect.js +215 -0
- package/lib/providers/confluence/dialect.js.map +1 -0
- package/lib/providers/confluence/index.js +393 -79
- package/lib/providers/confluence/index.js.map +1 -1
- package/lib/providers/confluence/operations.js +208 -153
- package/lib/providers/confluence/operations.js.map +1 -1
- package/lib/providers/confluence/storage.js +690 -0
- package/lib/providers/confluence/storage.js.map +1 -0
- package/lib/providers/confluence/transport.js +26 -89
- package/lib/providers/confluence/transport.js.map +1 -1
- package/lib/providers/gitlab/config.js +2 -3
- package/lib/providers/gitlab/config.js.map +1 -1
- package/lib/providers/gitlab/index.js +2 -20
- package/lib/providers/gitlab/index.js.map +1 -1
- package/lib/providers/gitlab/operations.js +7 -45
- package/lib/providers/gitlab/operations.js.map +1 -1
- package/lib/providers/gitlab/transport.js +2 -18
- package/lib/providers/gitlab/transport.js.map +1 -1
- package/lib/providers/jira/adf.js +19 -14
- package/lib/providers/jira/adf.js.map +1 -1
- package/lib/providers/jira/catalog.js +125 -4
- package/lib/providers/jira/catalog.js.map +1 -1
- package/lib/providers/jira/config.js +27 -2
- package/lib/providers/jira/config.js.map +1 -1
- package/lib/providers/jira/credential-help.js +16 -7
- package/lib/providers/jira/credential-help.js.map +1 -1
- package/lib/providers/jira/dialect.js +94 -0
- package/lib/providers/jira/dialect.js.map +1 -0
- package/lib/providers/jira/index.js +327 -67
- package/lib/providers/jira/index.js.map +1 -1
- package/lib/providers/jira/jql.js +54 -21
- package/lib/providers/jira/jql.js.map +1 -1
- package/lib/providers/jira/operations.js +77 -55
- package/lib/providers/jira/operations.js.map +1 -1
- package/lib/providers/jira/tools.js +1 -1
- package/lib/providers/jira/tools.js.map +1 -1
- package/lib/providers/jira/transport.js +12 -83
- package/lib/providers/jira/transport.js.map +1 -1
- package/lib/providers/shared/health.js +31 -0
- package/lib/providers/shared/health.js.map +1 -0
- package/lib/providers/shared/http.js +20 -0
- package/lib/providers/shared/http.js.map +1 -1
- package/lib/providers/shared/paths.js +14 -0
- package/lib/providers/shared/paths.js.map +1 -0
- package/lib/providers/shared/payload.js +46 -0
- package/lib/providers/shared/payload.js.map +1 -0
- package/lib/providers/teamcity/artifacts.js +0 -8
- package/lib/providers/teamcity/artifacts.js.map +1 -1
- package/lib/providers/teamcity/config.js +2 -3
- package/lib/providers/teamcity/config.js.map +1 -1
- package/lib/providers/teamcity/index.js +2 -20
- package/lib/providers/teamcity/index.js.map +1 -1
- package/lib/providers/teamcity/operations.js +5 -39
- package/lib/providers/teamcity/operations.js.map +1 -1
- package/lib/providers/teamcity/transport.js +2 -11
- package/lib/providers/teamcity/transport.js.map +1 -1
- package/lib/providers/testit/catalog.js +77 -0
- package/lib/providers/testit/catalog.js.map +1 -1
- package/lib/providers/testit/config.js +2 -3
- package/lib/providers/testit/config.js.map +1 -1
- package/lib/providers/testit/index.js +260 -4
- package/lib/providers/testit/index.js.map +1 -1
- package/lib/providers/testit/operations.js +34 -63
- package/lib/providers/testit/operations.js.map +1 -1
- package/lib/providers/testit/transport.js +2 -18
- package/lib/providers/testit/transport.js.map +1 -1
- package/lib/providers/weblate/catalog.js +103 -9
- package/lib/providers/weblate/catalog.js.map +1 -1
- package/lib/providers/weblate/config.js +2 -3
- package/lib/providers/weblate/config.js.map +1 -1
- package/lib/providers/weblate/index.js +227 -6
- package/lib/providers/weblate/index.js.map +1 -1
- package/lib/providers/weblate/operations.js +3 -33
- package/lib/providers/weblate/operations.js.map +1 -1
- package/lib/providers/weblate/query.js +3 -6
- package/lib/providers/weblate/query.js.map +1 -1
- package/lib/providers/weblate/transport.js +2 -12
- package/lib/providers/weblate/transport.js.map +1 -1
- package/lib/service-credentials/config.js +2 -3
- package/lib/service-credentials/config.js.map +1 -1
- package/lib/shared/settings.js +14 -0
- package/lib/shared/settings.js.map +1 -0
- package/lib/typert.host.js +159 -60
- package/lib/typert.remote-client.d.ts +13 -11
- package/lib/typert.remote-client.js +98 -52
- package/lib/types/broker.d.ts +11 -3
- package/lib/types/client/bitrix24.d.ts +24 -2
- package/lib/types/client/confluence.d.ts +24 -4
- package/lib/types/client/index.d.ts +7 -6
- package/lib/types/client/integrations.d.ts +2 -2
- package/lib/types/client/jira.d.ts +25 -4
- package/lib/types/client/operator-card.d.ts +22 -0
- package/lib/types/client/operator-controls.d.ts +135 -0
- package/lib/types/client/testit.d.ts +14 -1
- package/lib/types/client/weblate.d.ts +14 -1
- package/lib/types/coerce.d.ts +14 -0
- package/lib/types/config.d.ts +4 -4
- package/lib/types/errors.d.ts +16 -0
- package/lib/types/index.d.ts +91 -15
- package/lib/types/providers/bitrix24/catalog.d.ts +8 -0
- package/lib/types/providers/bitrix24/config.d.ts +14 -23
- package/lib/types/providers/bitrix24/index.d.ts +37 -1
- package/lib/types/providers/confluence/catalog.d.ts +44 -8
- package/lib/types/providers/confluence/config.d.ts +39 -7
- package/lib/types/providers/confluence/credential-help.d.ts +9 -4
- package/lib/types/providers/confluence/dialect.d.ts +113 -0
- package/lib/types/providers/confluence/index.d.ts +82 -8
- package/lib/types/providers/confluence/operations.d.ts +14 -4
- package/lib/types/providers/confluence/storage.d.ts +28 -0
- package/lib/types/providers/confluence/transport.d.ts +10 -21
- package/lib/types/providers/jira/catalog.d.ts +49 -2
- package/lib/types/providers/jira/config.d.ts +37 -6
- package/lib/types/providers/jira/credential-help.d.ts +11 -3
- package/lib/types/providers/jira/dialect.d.ts +79 -0
- package/lib/types/providers/jira/index.d.ts +76 -19
- package/lib/types/providers/jira/jql.d.ts +14 -4
- package/lib/types/providers/jira/operations.d.ts +3 -0
- package/lib/types/providers/jira/transport.d.ts +6 -13
- package/lib/types/providers/shared/health.d.ts +18 -0
- package/lib/types/providers/shared/http.d.ts +9 -0
- package/lib/types/providers/shared/paths.d.ts +10 -0
- package/lib/types/providers/shared/payload.d.ts +26 -0
- package/lib/types/providers/teamcity/artifacts.d.ts +0 -2
- package/lib/types/providers/teamcity/index.d.ts +2 -0
- package/lib/types/providers/testit/catalog.d.ts +12 -0
- package/lib/types/providers/testit/index.d.ts +63 -2
- package/lib/types/providers/weblate/catalog.d.ts +19 -2
- package/lib/types/providers/weblate/index.d.ts +43 -1
- package/lib/types/shared/settings.d.ts +14 -0
- package/lib/types/types.d.ts +8 -0
- package/package.json +3 -3
package/README.md
CHANGED
|
@@ -1,9 +1,19 @@
|
|
|
1
1
|
# dsh-qa-integrations
|
|
2
2
|
|
|
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, который монтируется только явным флагом оператора. У
|
|
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, который монтируется только явным флагом оператора. У всех семи интеграций подключение может работать не только от личного токена, но и от сервисного токена развёртывания — общего read-only аккаунта с жёстким потолком режима (раздел «Сервисные токены»).
|
|
4
4
|
|
|
5
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
|
+
## Операторская карточка настроек
|
|
8
|
+
|
|
9
|
+
Кроме двух пользовательских монтирований, плагин ставит свою конфигурацию как настоящий settings namespace (`qa-integrations`) и рисует по нему операторскую карточку в **«Настройки → Плагины → Конфигурация плагинов»** — по тому же контракту `settings.plugin.item`, что и карточки первых плагинов. Это третья поверхность того же бандла, и она не требует ни входа в QA, ни Remote-описания развёртывания: оператор включается и настраивает плагин из этой карточки, даже когда плагин ещё выключен.
|
|
10
|
+
|
|
11
|
+
Карточка читается сверху вниз: у каждой секции в свёрнутом виде строка состояния (включён ли провайдер, сколько подключений настроено, сколько возможностей открыто), а внутри — четыре подписанных блока: «Провайдер» (выключатели провайдера), «Подключение» (инстансы, сайты, адреса и сетевые политики во всю ширину), «Что доступно агенту» (чек-лист возможностей, флажок перед подписью) и свёрнутые «Ограничения и повторы» (потолки, таймауты, повторы при ошибках). Подпись поля связана с самим полем: клик по названию ставит курсор в него.
|
|
12
|
+
|
|
13
|
+
Карточка покрывает всю разрешённую резолверами конфигурацию: общие ручки (`enabled`, таймаут, потолки ответа и аудита, пути хранилища и мастер-ключа, суффиксы порталов Bitrix24), у каждого провайдера — выключатель, возможности, инстансы/сайты (строки id/название/адрес) и лимиты, у TeamCity — адрес сервера и сетевую политику, у Jira — псевдонимы полей, плюс сервисные доступы (профили с ресурсными границами и deny-политикой) и замены встроенных подсказок получения токена (`credentialHelp`). Каждое поле помечает, что пользовательский слой namespace переопределяет композиционную строку профиля, одна кнопка очищает слой целиком, а отклонённое резолверами значение показывается ошибкой на карточке, а не сохраняется.
|
|
14
|
+
|
|
15
|
+
Правка применяется к запущенному сервису сразу: брокер перепривязывается к свежему набору провайдеров, монтирование инструментов следует за выключателем плагина и единственным флагом записи. Хранилище подключений и мастер-ключ — сознательное исключение: подключения и зашифрованные секреты живут по путям загрузки, поэтому их правка предупреждает в логе и вступает в силу при следующем рестарте Host. Без settings-провайдера плагин ведёт себя как раньше и грузится от композиционной строки.
|
|
16
|
+
|
|
7
17
|
## Структура
|
|
8
18
|
|
|
9
19
|
Один каталог — одна интеграция. Всё, что знает про 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).
|
|
@@ -12,98 +22,98 @@
|
|
|
12
22
|
|
|
13
23
|
CRM:
|
|
14
24
|
|
|
15
|
-
| Tool
|
|
16
|
-
|
|
|
17
|
-
| `bitrix_search_crm`
|
|
18
|
-
| `bitrix_get_crm_item`
|
|
19
|
-
| `bitrix_get_crm_fields`
|
|
20
|
-
| `bitrix_get_crm_funnels`
|
|
21
|
-
| `bitrix_get_crm_statuses`
|
|
22
|
-
| `bitrix_get_crm_activities`
|
|
23
|
-
| `bitrix_get_crm_activity`
|
|
24
|
-
| `bitrix_get_crm_timeline`
|
|
25
|
-
| `bitrix_get_crm_stage_history` | История движения по стадиям: сколько висело, куда возвращали
|
|
26
|
-
| `bitrix_get_crm_product_rows`
|
|
27
|
-
| `bitrix_find_crm_duplicates`
|
|
28
|
-
| `bitrix_get_crm_requisites`
|
|
29
|
-
| `bitrix_get_call_transcript`
|
|
25
|
+
| Tool | Что делает |
|
|
26
|
+
| ------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
27
|
+
| `bitrix_search_crm` | Поиск лидов, сделок, контактов, компаний, счетов и смарт-процессов: по названию, стадии, воронке, свежести, открытости (только сделки), ответственный; порядок сортировки зафиксирован, чтобы страницы не дублировались |
|
|
28
|
+
| `bitrix_get_crm_item` | Полная карточка элемента CRM, включая пользовательские поля и коммуникации |
|
|
29
|
+
| `bitrix_get_crm_fields` | Схема полей типа сущности, включая `UF_CRM_*` портала |
|
|
30
|
+
| `bitrix_get_crm_funnels` | Воронки (категории) типа сущности |
|
|
31
|
+
| `bitrix_get_crm_statuses` | Расшифровка стадий и справочников (`STATUS`, `DEAL_STAGE`, `DEAL_STAGE_<id>`, `SOURCE`, …) |
|
|
32
|
+
| `bitrix_get_crm_activities` | Дела CRM: звонки, встречи, письма, задачи; просрочки и незавершённые |
|
|
33
|
+
| `bitrix_get_crm_activity` | Одно дело целиком, включая описание |
|
|
34
|
+
| `bitrix_get_crm_timeline` | Комментарии таймлайна лида, сделки, контакта, компании |
|
|
35
|
+
| `bitrix_get_crm_stage_history` | История движения по стадиям: сколько висело, куда возвращали |
|
|
36
|
+
| `bitrix_get_crm_product_rows` | Товарные позиции: что продаём, количество, цена, скидки |
|
|
37
|
+
| `bitrix_find_crm_duplicates` | Поиск дублей клиента по телефону или e-mail |
|
|
38
|
+
| `bitrix_get_crm_requisites` | Реквизиты контакта или компании: ИНН, КПП, адрес, банк |
|
|
39
|
+
| `bitrix_get_call_transcript` | Готовая AI-расшифровка звонка по делу CRM |
|
|
30
40
|
|
|
31
41
|
Сотрудники и структура:
|
|
32
42
|
|
|
33
|
-
| Tool
|
|
34
|
-
|
|
|
35
|
-
| `bitrix_get_current_user` | Чей вебхук подключён
|
|
36
|
-
| `bitrix_search_users`
|
|
37
|
-
| `bitrix_get_departments`
|
|
38
|
-
| `bitrix_get_user_fields`
|
|
43
|
+
| Tool | Что делает |
|
|
44
|
+
| ------------------------- | ------------------------------------------------- |
|
|
45
|
+
| `bitrix_get_current_user` | Чей вебхук подключён |
|
|
46
|
+
| `bitrix_search_users` | Поиск сотрудников по имени, e-mail, подразделению |
|
|
47
|
+
| `bitrix_get_departments` | Подразделения, родительский отдел, руководитель |
|
|
48
|
+
| `bitrix_get_user_fields` | Какие поля сотрудника доступны с этим вебхуком |
|
|
39
49
|
|
|
40
50
|
Чаты и открытые линии:
|
|
41
51
|
|
|
42
|
-
| Tool
|
|
43
|
-
|
|
|
44
|
-
| `bitrix_search_chats`
|
|
45
|
-
| `bitrix_get_chat_messages`
|
|
46
|
-
| `bitrix_search_chat_messages`
|
|
47
|
-
| `bitrix_get_recent_chats`
|
|
48
|
-
| `bitrix_search_chat_users`
|
|
49
|
-
| `bitrix_find_chat`
|
|
50
|
-
| `bitrix_get_chat_participants` | Кто участвует в чате
|
|
51
|
-
| `bitrix_get_chat_user_data`
|
|
52
|
-
| `bitrix_get_openline_dialog`
|
|
53
|
-
| `bitrix_get_openline_history`
|
|
52
|
+
| Tool | Что делает |
|
|
53
|
+
| ------------------------------ | ---------------------------------------------------------------------------------------- |
|
|
54
|
+
| `bitrix_search_chats` | Поиск чатов по названию и участникам |
|
|
55
|
+
| `bitrix_get_chat_messages` | Последние сообщения чата |
|
|
56
|
+
| `bitrix_search_chat_messages` | Поиск по тексту и датам внутри одного чата |
|
|
57
|
+
| `bitrix_get_recent_chats` | Последние диалоги пользователя, счётчики непрочитанного |
|
|
58
|
+
| `bitrix_search_chat_users` | Поиск сотрудника как контакта чата: статус, телефоны |
|
|
59
|
+
| `bitrix_find_chat` | Чат, привязанный к объекту: обсуждение сделки, чат задачи, событие календаря, чат группы |
|
|
60
|
+
| `bitrix_get_chat_participants` | Кто участвует в чате |
|
|
61
|
+
| `bitrix_get_chat_user_data` | Профили участников: имя, должность, телефоны, присутствие |
|
|
62
|
+
| `bitrix_get_openline_dialog` | Диалог открытой линии: участники, связь с CRM |
|
|
63
|
+
| `bitrix_get_openline_history` | История переписки с клиентом в открытой линии |
|
|
54
64
|
|
|
55
65
|
Задачи, календарь, Диск:
|
|
56
66
|
|
|
57
|
-
| Tool
|
|
58
|
-
|
|
|
59
|
-
| `bitrix_search_tasks`
|
|
60
|
-
| `bitrix_get_task`
|
|
61
|
-
| `bitrix_get_task_history`
|
|
62
|
-
| `bitrix_get_task_results`
|
|
63
|
-
| `bitrix_get_task_elapsed_time`
|
|
64
|
-
| `bitrix_get_calendar_events`
|
|
67
|
+
| Tool | Что делает |
|
|
68
|
+
| ----------------------------------- | ----------------------------------------------------- |
|
|
69
|
+
| `bitrix_search_tasks` | Задачи по названию, ответственному, группе, дедлайну |
|
|
70
|
+
| `bitrix_get_task` | Карточка задачи целиком, включая `ufCrmTask` |
|
|
71
|
+
| `bitrix_get_task_history` | История изменений задачи: что, когда и кем |
|
|
72
|
+
| `bitrix_get_task_results` | Результаты работы по задаче |
|
|
73
|
+
| `bitrix_get_task_elapsed_time` | Затраченное время: кто сколько залогировал |
|
|
74
|
+
| `bitrix_get_calendar_events` | События календаря сотрудника, группы или компании |
|
|
65
75
|
| `bitrix_get_calendar_accessibility` | Занятость сотрудников, чтобы предложить время встречи |
|
|
66
|
-
| `bitrix_search_files`
|
|
67
|
-
| `bitrix_get_file`
|
|
68
|
-
| `bitrix_get_drives`
|
|
69
|
-
| `bitrix_get_storage_items`
|
|
70
|
-
| `bitrix_get_folder_items`
|
|
76
|
+
| `bitrix_search_files` | Поиск по Диску, включая текст внутри документов |
|
|
77
|
+
| `bitrix_get_file` | Метаданные и ссылка на файл Диска |
|
|
78
|
+
| `bitrix_get_drives` | Доступные диски и их id |
|
|
79
|
+
| `bitrix_get_storage_items` | Содержимое корня диска |
|
|
80
|
+
| `bitrix_get_folder_items` | Содержимое папки Диска |
|
|
71
81
|
|
|
72
82
|
Запись (по умолчанию выключена оператором `bitrix24.crmCommentWrite`):
|
|
73
83
|
|
|
74
|
-
| Tool
|
|
75
|
-
|
|
|
84
|
+
| Tool | Что делает |
|
|
85
|
+
| --------------------------------- | ------------------------------------------------------------------------------------------------------------- |
|
|
76
86
|
| `bitrix_add_crm_timeline_comment` | Один комментарий в таймлайн лида, сделки, контакта или компании; единственная операция записи во всём плагине |
|
|
77
87
|
|
|
78
88
|
Списочные инструменты отвечают единым конвертом `{ items, pagination }`: у модели одна форма ответа вместо шести разных у REST, а курсор следующей страницы не теряется. Методы, возвращающие словари по id (история открытой линии, занятость), спроецированы в упорядоченные массивы.
|
|
79
89
|
|
|
80
90
|
## Инструменты GitLab
|
|
81
91
|
|
|
82
|
-
| Tool
|
|
83
|
-
|
|
|
84
|
-
| `gitlab_connection_get`
|
|
85
|
-
| `gitlab_projects_list`
|
|
86
|
-
| `gitlab_project_get`
|
|
87
|
-
| `gitlab_repository_tree`
|
|
88
|
-
| `gitlab_repository_file_get`
|
|
89
|
-
| `gitlab_commits_list`
|
|
90
|
-
| `gitlab_commit_get`
|
|
91
|
-
| `gitlab_compare`
|
|
92
|
-
| `gitlab_search`
|
|
93
|
-
| `gitlab_issues_list`
|
|
94
|
-
| `gitlab_issue_get`
|
|
95
|
-
| `gitlab_issue_notes_list`
|
|
96
|
-
| `gitlab_merge_requests_list`
|
|
97
|
-
| `gitlab_merge_request_get`
|
|
98
|
-
| `gitlab_merge_request_changes_get`
|
|
99
|
-
| `gitlab_merge_request_discussions_list` | Обсуждения ревью и их разрешение
|
|
100
|
-
| `gitlab_merge_request_approvals_get`
|
|
101
|
-
| `gitlab_merge_request_pipelines_list`
|
|
102
|
-
| `gitlab_pipelines_list`
|
|
103
|
-
| `gitlab_pipeline_get`
|
|
104
|
-
| `gitlab_pipeline_jobs_list`
|
|
105
|
-
| `gitlab_job_get`
|
|
106
|
-
| `gitlab_job_log_get`
|
|
92
|
+
| Tool | Что делает |
|
|
93
|
+
| --------------------------------------- | ------------------------------------------------------------------------- |
|
|
94
|
+
| `gitlab_connection_get` | К какому инстансу и каким пользователем подключён аккаунт |
|
|
95
|
+
| `gitlab_projects_list` | Поиск проектов: путь, ветка по умолчанию, видимость |
|
|
96
|
+
| `gitlab_project_get` | Карточка проекта: описание, namespace, даты |
|
|
97
|
+
| `gitlab_repository_tree` | Содержимое каталогов на выбранном ref, постранично |
|
|
98
|
+
| `gitlab_repository_file_get` | Текст файла с метаданными; бинарное и слишком большое — только метаданные |
|
|
99
|
+
| `gitlab_commits_list` | Коммиты проекта, ветки или одного файла |
|
|
100
|
+
| `gitlab_commit_get` | Один коммит: сообщение, автор, родители, объём изменений |
|
|
101
|
+
| `gitlab_compare` | Сравнение двух refs: коммиты и изменённые файлы |
|
|
102
|
+
| `gitlab_search` | Поиск по проектам, задачам, MR, коммитам, коду и комментариям |
|
|
103
|
+
| `gitlab_issues_list` | Задачи по проекту, состоянию, автору, исполнителю, меткам, датам |
|
|
104
|
+
| `gitlab_issue_get` | Карточка задачи: описание, веха, срок |
|
|
105
|
+
| `gitlab_issue_notes_list` | Комментарии задачи, системные помечены |
|
|
106
|
+
| `gitlab_merge_requests_list` | Merge requests по проекту, веткам, автору, ревьюеру, черновику |
|
|
107
|
+
| `gitlab_merge_request_get` | Карточка MR: описание, ветки, статус слияния, конфликты |
|
|
108
|
+
| `gitlab_merge_request_changes_get` | Изменённые файлы MR с диффами |
|
|
109
|
+
| `gitlab_merge_request_discussions_list` | Обсуждения ревью и их разрешение |
|
|
110
|
+
| `gitlab_merge_request_approvals_get` | Сколько одобрений нужно, сколько есть, кто одобрил |
|
|
111
|
+
| `gitlab_merge_request_pipelines_list` | Пайплайны, привязанные к MR |
|
|
112
|
+
| `gitlab_pipelines_list` | Пайплайны проекта по ветке, статусу, источнику, автору |
|
|
113
|
+
| `gitlab_pipeline_get` | Один пайплайн: статус, длительности, покрытие |
|
|
114
|
+
| `gitlab_pipeline_jobs_list` | Джобы пайплайна: стадия, статус, длительность |
|
|
115
|
+
| `gitlab_job_get` | Одна джоба: причина падения, теги, список артефактов |
|
|
116
|
+
| `gitlab_job_log_get` | Лог джобы: ограничен по размеру и очищен от токенов |
|
|
107
117
|
|
|
108
118
|
Списочные инструменты GitLab отвечают тем же конвертом `{ items, pagination }`; `pagination.nextPage` — это номер следующей страницы, а не подписанный курсор: состояние между вызовами не хранится, principal и права перепроверяются на каждом вызове.
|
|
109
119
|
|
|
@@ -111,59 +121,59 @@ CRM:
|
|
|
111
121
|
|
|
112
122
|
## Инструменты TeamCity
|
|
113
123
|
|
|
114
|
-
| Tool
|
|
115
|
-
|
|
|
124
|
+
| Tool | Что делает |
|
|
125
|
+
| ------------------------- | --------------------------------------------------------------------------------- |
|
|
116
126
|
| `teamcity_connection_get` | К какому серверу TeamCity и каким пользователем подключён аккаунт, версия сервера |
|
|
117
|
-
| `teamcity_projects`
|
|
118
|
-
| `teamcity_build_configs`
|
|
119
|
-
| `teamcity_builds`
|
|
120
|
-
| `teamcity_build`
|
|
121
|
-
| `teamcity_build_changes`
|
|
122
|
-
| `teamcity_build_failures` | Почему упало: упавшие тесты и проблемы сборки одним ответом
|
|
123
|
-
| `teamcity_build_log`
|
|
124
|
-
| `teamcity_queue`
|
|
125
|
-
| `teamcity_investigations` | Расследования падений: состояние, ответственный, разрешение
|
|
126
|
-
| `teamcity_agents`
|
|
127
|
-
| `teamcity_artifacts`
|
|
128
|
-
| `teamcity_artifact_text`
|
|
127
|
+
| `teamcity_projects` | Проекты: поиск по id и названию, дочерние проекты, архивные |
|
|
128
|
+
| `teamcity_build_configs` | Конфигурации сборки: id, название, проект, пауза |
|
|
129
|
+
| `teamcity_builds` | Поиск сборок по проекту, конфигурации, ветке, статусу, состоянию и датам |
|
|
130
|
+
| `teamcity_build` | Одна сборка: состояние, статус и его текст, агент, кто запустил, времена |
|
|
131
|
+
| `teamcity_build_changes` | Изменения в VCS, попавшие в сборку: ревизия, автор, дата, комментарий |
|
|
132
|
+
| `teamcity_build_failures` | Почему упало: упавшие тесты и проблемы сборки одним ответом |
|
|
133
|
+
| `teamcity_build_log` | Фрагмент лога сборки: конец, начало или строки по поиску |
|
|
134
|
+
| `teamcity_queue` | Очередь сборки: что ждёт агента и на какой ветке |
|
|
135
|
+
| `teamcity_investigations` | Расследования падений: состояние, ответственный, разрешение |
|
|
136
|
+
| `teamcity_agents` | Агенты сборки: подключён, включён, авторизован |
|
|
137
|
+
| `teamcity_artifacts` | Артефакты сборки: имя, путь, размер, время изменения |
|
|
138
|
+
| `teamcity_artifact_text` | Текст небольшого артефакта: отчёты тестов, лог-файлы |
|
|
129
139
|
|
|
130
140
|
Списочные инструменты TeamCity отвечают конвертом `{ items, pagination }`, где `pagination.returned` — сколько строк вернулось, а `pagination.hasMore` — что сервер отдал не всё: инструмент никогда не ходит по `nextHref` сам, поэтому продолжение получается сужением фильтра, а не вторым запросом за спиной у модели. Лимит каждого списка задан спецификацией (сборки и очередь — 50, проекты, конфигурации, изменения, тесты, проблемы, расследования и агенты — 100, артефакты — 200) и не поднимается выше, сколько бы модель ни попросила.
|
|
131
141
|
|
|
132
142
|
Лог сборки скачивается не больше, чем разрешает стенд (`maxLogBytes`, по умолчанию 256 КиБ), чистится от управляющих последовательностей терминала, проходит через редакцию секретов и режется до запрошенного числа строк (`maxLines`, максимум 1000). Ответ различает два случая: `truncated` — окно не покрыло запрошенные строки, `logTruncated` — сам лог длиннее скачанного куска, и тогда в режиме `tail` это конец скачанного, а не конец сборки. Артефакты читаются только текстовые: архивы, образы, бинарники, документы и ключи (`zip`, `jar`, `png`, `pdf`, `pem`, …) отказываются по имени до запроса, а бинарное тело отвечает метаданными с `binary: true` вместо содержимого. Логи и артефакты описаны модели как недоверенные данные: это текст из внешней системы, а не инструкция.
|
|
133
143
|
|
|
134
|
-
|
|
135
144
|
## Инструменты Jira
|
|
136
145
|
|
|
137
|
-
| Tool
|
|
138
|
-
|
|
|
139
|
-
| `jira_get_current_user`
|
|
140
|
-
| `jira_search_issues`
|
|
141
|
-
| `jira_get_issue`
|
|
142
|
-
| `jira_get_issue_comments`
|
|
143
|
-
| `jira_get_issue_attachments`
|
|
144
|
-
| `jira_get_available_transitions` | Доступные переходы статуса и их обязательные поля; переход не выполняется
|
|
145
|
-
| `jira_get_project`
|
|
146
|
-
| `jira_get_fields`
|
|
146
|
+
| Tool | Что делает |
|
|
147
|
+
| -------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
148
|
+
| `jira_get_current_user` | К какому сайту Jira и каким пользователем Atlassian подключён аккаунт |
|
|
149
|
+
| `jira_search_issues` | Поиск задач: текст, проекты, типы, статусы и их категория, приоритеты, резолюции, компоненты, метки, версии (fix и affected), люди, даты, кастомные поля |
|
|
150
|
+
| `jira_get_issue` | Карточка задачи: ключ, ссылка, проект, тип, статус, приоритет, люди, метки, компоненты, версии, резолюция, даты и описание |
|
|
151
|
+
| `jira_get_issue_comments` | Комментарии задачи, от новых к старым; ограниченный комментарий помечен видимостью |
|
|
152
|
+
| `jira_get_issue_attachments` | Метаданные вложений: имя файла, тип, размер, автор; файлы не скачиваются |
|
|
153
|
+
| `jira_get_available_transitions` | Доступные переходы статуса и их обязательные поля; переход не выполняется |
|
|
154
|
+
| `jira_get_project` | Карточка проекта: ключ, название, тип, руководитель, описание, ссылка |
|
|
155
|
+
| `jira_get_fields` | Поля сайта: id, имя, признак кастомного поля, тип и JQL-имена |
|
|
147
156
|
|
|
148
157
|
Модель не получает JQL: фильтры в `jira_search_issues` типизированные, а строку запроса собирает и экранирует провайдер — значение с кавычкой или обратным слэшем остаётся значением и не может добавить условие. Поиск без единого фильтра отказывается: «все задачи сайта» — не вопрос, на который этот инструмент отвечает. Ответы идут по последнему обновлению (сначала свежие) и несут `pagination.nextCursor` — это continuation-токен самого Jira, состояние между вызовами не хранится, а страница не выходит за потолок стенда (`defaultSearchLimit`, `maxSearchLimit`) и за 100 строк, которые Jira отдаёт с полями. Комментарии Jira по-прежнему листаются позицией, поэтому их `pagination` — `{ startAt, returned, total, hasMore }`.
|
|
149
158
|
|
|
150
159
|
Словарь фильтров покрывает то, что спрашивают у корпоративной Jira, и каждый фильтр — это клауза, которую собирает `jql.ts`: проект, тип задачи, статус и **категория статуса** (`To Do` / `In Progress` / `Done` — «закрытые» одним фильтром, чем бы ни называл их workflow), приоритет, резолюция, компонент, метки (все перечисленные, а не «любая из»), версии — `fixVersions` и `affectedVersions`, включая «не проставлена» (`fixVersionEmpty: true`) и «проставлена» (`false`), исполнитель и автор, даты создания и обновления в обе стороны, и кастомные поля. Даты принимают и абсолютное значение (`2026-08-01`, ISO-таймстемп), и родной относительный токен Jira (`-3w`, `-2d`, `-4h`, `-30m`), а пара «с/по» — это `createdAfter`/`createdBefore` (границы включительные). Текст ищется двумя способами: `match: "all"` (по умолчанию) требует все слова, `match: "phrase"` — точную фразу; оба варианта бьются на отдельные клаузы `text ~ "…"`, поэтому `OR` из фразы остаётся словом, а не оператором.
|
|
151
160
|
|
|
152
|
-
Кастомные поля фильтруются **по id**, который вернул `jira_get_fields`, или **по алиасу**, который объявил оператор стенда: `customFields: [{ field: "product", value: "…" }]`, с `match: "contains"` для текстовых полей и `empty: true`/`false` для пустого/заполненного. Имя поля Jira не принимается намеренно — на одном сайте легко живут несколько полей с одинаковым именем, а какой из них «продукт», знает только развёртывание: соответствие «алиас → `customfield_…`» задаётся в конфиге оператора (`jira.fieldAliases`), поэтому в репозитории нет ни одного id конкретного инстанса, а каталог полей (`jira_get_fields`) отдаёт объявленные алиасы вместе со схемой. Неизвестное имя — отказ со списком алиасов, а не пустая страница. Люди принимаются как `me`, как accountId или как имя: имя провайдер разрешает через справочник сайта (`/rest/api/3/user/search`, не больше десяти совпадений) и подставляет
|
|
161
|
+
Кастомные поля фильтруются **по id**, который вернул `jira_get_fields`, или **по алиасу**, который объявил оператор стенда: `customFields: [{ field: "product", value: "…" }]`, с `match: "contains"` для текстовых полей и `empty: true`/`false` для пустого/заполненного. Имя поля Jira не принимается намеренно — на одном сайте легко живут несколько полей с одинаковым именем, а какой из них «продукт», знает только развёртывание: соответствие «алиас → `customfield_…`» задаётся в конфиге оператора (`jira.fieldAliases`), поэтому в репозитории нет ни одного id конкретного инстанса, а каталог полей (`jira_get_fields`) отдаёт объявленные алиасы вместе со схемой. Неизвестное имя — отказ со списком алиасов, а не пустая страница. Люди принимаются как `me`, как идентификатор, по которому фильтрует эта Jira (accountId у Cloud, логин у Server / Data Center), или как имя: имя провайдер разрешает через справочник сайта (`/rest/api/3/user/search` или `/rest/api/2/user/search`, не больше десяти совпадений) и подставляет этот идентификатор в запрос. Имя, которое никого не нашло, и имя, которое нашли несколько человек, — это отказ с подсказкой, а не пустая страница: «нет задач» и «фильтр не понят» — разные ответы. Ответ справочника модели не показывается, он только определяет id, по которому построен запрос.
|
|
153
162
|
|
|
154
163
|
Описания и комментарии приходят в Atlassian Document Format и рендерятся в текст с сохранением структуры: заголовки, списки, код, ссылки, упоминания, таблицы и вложения-маркеры. Сырой JSON документа модели не отдаётся, а встроенные ссылки и медиа-узлы не загружаются. История изменений задачи читается отдельной группой `include: ["changelog_summary"]` (Jira отдаёт её только через `expand=changelog`): ответ несёт до 20 изменённых полей с автором и значениями «было/стало» и честно различает две обрезки — свою (`truncated`, упёрлись в 20 записей) и джировскую (`groupsTruncated`, Jira посчитала групп изменений больше, чем прислала). Кастомные поля называются по схеме сайта (`jira_get_fields` показывает её модель целиком): схема читается только после того, как задача ответила, и **не кэшируется** — один и тот же сайт отдаёт разный список полей двум пользователям с разными правами, а кэш на двоих был бы утечкой ради одного запроса. Тело задачи, комментария или кастомного поля ограничено `maxTextChars` (по умолчанию 20 000 символов); при обрезке ответ помечается `descriptionTruncated` или `bodyTruncated`. Текст из Jira — данные, а не инструкция.
|
|
164
|
+
|
|
155
165
|
## Инструменты Confluence
|
|
156
166
|
|
|
157
|
-
| Tool
|
|
158
|
-
|
|
|
159
|
-
| `confluence_connection_get`
|
|
160
|
-
| `confluence_search`
|
|
161
|
-
| `confluence_get_page`
|
|
162
|
-
| `confluence_get_page_comments`
|
|
163
|
-
| `confluence_get_page_attachments` | Метаданные вложений: имя, тип, размер, версия, автор, ссылки
|
|
164
|
-
| `confluence_get_page_versions`
|
|
165
|
-
| `confluence_get_space`
|
|
166
|
-
| `confluence_list_spaces`
|
|
167
|
+
| Tool | Что делает |
|
|
168
|
+
| --------------------------------- | ---------------------------------------------------------------------------- |
|
|
169
|
+
| `confluence_connection_get` | К какому сайту Confluence и каким аккаунтом Atlassian подключён пользователь |
|
|
170
|
+
| `confluence_search` | Поиск страниц по тексту, пространствам, меткам, автору и дате изменения |
|
|
171
|
+
| `confluence_get_page` | Страница целиком: заголовок, пространство, родитель, версия, метки и текст |
|
|
172
|
+
| `confluence_get_page_comments` | Комментарии страницы: подвал, inline или оба, с ответами и статусом резолва |
|
|
173
|
+
| `confluence_get_page_attachments` | Метаданные вложений: имя, тип, размер, версия, автор, ссылки |
|
|
174
|
+
| `confluence_get_page_versions` | История версий: номер, автор, дата и комментарий к версии |
|
|
175
|
+
| `confluence_get_space` | Пространство: ключ, имя, тип, статус, описание |
|
|
176
|
+
| `confluence_list_spaces` | Пространства, доступные аккаунту, с ключами для поиска и чтения |
|
|
167
177
|
|
|
168
178
|
Списочные инструменты Confluence отвечают конвертом `{ items, nextCursor }`: `nextCursor` — это значение, которое нужно вернуть в аргументе `cursor`, а не URL и не подписанный токен. У поиска это смещение строк (эндпоинт считает строки), у остальных чтений — курсор самого Confluence, из которого провайдер берёт только сам токен: путь и параметры следующего запроса он собирает сам, поэтому курсор не может увести запрос на чужой адрес. Комментарии с `kind: "all"` отвечают двумя курсорами (`cursors.footer` и `cursors.inline`), потому что продолжать их придётся по отдельности. `totalSize` у поиска говорит, сколько всего совпадений нашлось, — по нему модель понимает, стоит ли листать дальше.
|
|
169
179
|
|
|
@@ -173,27 +183,27 @@ CRM:
|
|
|
173
183
|
|
|
174
184
|
## Инструменты Weblate
|
|
175
185
|
|
|
176
|
-
| Tool
|
|
177
|
-
|
|
|
178
|
-
| `weblate_connection_get`
|
|
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`
|
|
196
|
-
| `weblate_screenshot_get`
|
|
186
|
+
| Tool | Что делает |
|
|
187
|
+
| ------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------ |
|
|
188
|
+
| `weblate_connection_get` | К какому инстансу Weblate и каким аккаунтом подключён токен и личный он или проектный; сам токен не возвращается |
|
|
189
|
+
| `weblate_projects_list` | Проекты, видимые аккаунту, постранично |
|
|
190
|
+
| `weblate_project_get` | Один проект: слаг, имя, ссылка |
|
|
191
|
+
| `weblate_project_statistics_get` | Готовность проекта: строки и слова переведены, требуют правки, не проходят проверки |
|
|
192
|
+
| `weblate_components_list` | Компоненты проекта постранично |
|
|
193
|
+
| `weblate_component_get` | Один компонент: слаг, имя, система контроля версий, ветка, формат файлов, исходный язык |
|
|
194
|
+
| `weblate_component_statistics_get` | Готовность компонента по языкам |
|
|
195
|
+
| `weblate_translations_list` | Языки компонента с их состоянием перевода |
|
|
196
|
+
| `weblate_translation_get` | Один язык одного компонента целиком: переведено, требует правки, проверки, комментарии, предложения, автор последней правки |
|
|
197
|
+
| `weblate_translation_statistics_get` | Статистика одного языка одного компонента |
|
|
198
|
+
| `weblate_units_search` | Строки одного языка одного компонента с типизированными фильтрами |
|
|
199
|
+
| `weblate_units_find` | Строка по всему, что видит аккаунт, с сужением по проекту, компоненту и языку |
|
|
200
|
+
| `weblate_unit_get` | Одна строка целиком: все формы множественного числа исходника и перевода, состояние, контекст, заметка, метки, флаги, проверки |
|
|
201
|
+
| `weblate_unit_comments_list` | Комментарии к строке: автор, время, текст |
|
|
202
|
+
| `weblate_unit_suggestions_list` | Предложенные переводы строки: автор, голоса, время |
|
|
203
|
+
| `weblate_failing_units_list` | Строки, у которых не проходит хотя бы одна проверка, с сужением по проекту, компоненту, языку, тексту и состоянию |
|
|
204
|
+
| `weblate_changes_list` | Последние изменения проекта: какая строка, какой язык, что сделано, кем и когда |
|
|
205
|
+
| `weblate_screenshots_list` | Скриншоты Weblate и строки, к которым они привязаны |
|
|
206
|
+
| `weblate_screenshot_get` | Метаданные одного скриншота: имя, файл в репозитории, язык, id связанных строк |
|
|
197
207
|
|
|
198
208
|
Списочные инструменты Weblate отвечают конвертом `{ items, pagination }`: `pagination.nextPage` — номер следующей страницы, а не подписанный курсор. По ссылке `next` провайдер не ходит сам: Weblate кладёт в тело абсолютный адрес, из которого читается только номер страницы, и только когда он ведёт на настроенный инстанс — ссылка с чужого адреса отбрасывается, а список честно считается законченным. Страница — 20 строк по умолчанию, а `perPage` сверх потолка стенда (`maxPageSize`, по умолчанию 100) обрезается, а не отвергается: «дай больше строк» — это запрос, на который стенд отвечает своим потолком, а не ошибка, которую модель выясняет перебором. Состояние между вызовами не хранится, principal и права перепроверяются на каждом вызове.
|
|
199
209
|
|
|
@@ -207,42 +217,45 @@ CRM:
|
|
|
207
217
|
|
|
208
218
|
Подключение — Atlassian API token вместе с почтой аккаунта Atlassian (Basic-пара). Возможность появляется у пользователя, если её включил оператор (`confluence.*Read`).
|
|
209
219
|
|
|
210
|
-
| Возможность
|
|
211
|
-
|
|
|
212
|
-
| `identity.read`
|
|
213
|
-
| `spaces.read`
|
|
214
|
-
| `search.read`
|
|
215
|
-
| `content.read`
|
|
216
|
-
| `comments.read`
|
|
217
|
-
| `attachments.read` | Метаданные вложений страницы
|
|
218
|
-
| `versions.read`
|
|
220
|
+
| Возможность | Что открывает |
|
|
221
|
+
| ------------------ | ------------------------------------------------------------- |
|
|
222
|
+
| `identity.read` | Сайт Confluence и подключённый аккаунт Atlassian |
|
|
223
|
+
| `spaces.read` | Список пространств и карточка пространства |
|
|
224
|
+
| `search.read` | Поиск страниц по тексту, пространствам, меткам, автору и дате |
|
|
225
|
+
| `content.read` | Страница целиком с текстом, метками и версией |
|
|
226
|
+
| `comments.read` | Комментарии страницы: подвал, inline и ответы |
|
|
227
|
+
| `attachments.read` | Метаданные вложений страницы |
|
|
228
|
+
| `versions.read` | История версий страницы |
|
|
219
229
|
|
|
220
230
|
Confluence, как и TeamCity, не сообщает через API, какие права выданы конкретному токену: у OAuth-приложений для этого есть `/oauth/token/accessible-resources`, а у API token аналога нет. Поэтому сужение идёт только по деплой-флагам оператора, а права аккаунта применяет сам Confluence — отказ приходит как `ProviderPermissionDenied`, и провайдер никогда не пробует другой credential.
|
|
221
231
|
|
|
222
232
|
Оператор дополнительно может сузить **пространства**: `confluence.allowedSpaces` — это список ключей, и он применяется одинаково к поиску, к списку пространств и к прямому чтению страницы, комментариев, вложений и версий. Страница в пространстве вне списка отвечает отказом `OperationDeniedByPolicy`, а не тихо исчезает из выдачи; в поиск добавляется `space in (…)`, и строки, пространство которых по ответу не подтверждается, отбрасываются. Страница не несёт ключ пространства, только `spaceId`, поэтому каждое чтение страницы делает дополнительный запрос самого пространства — он же и наполняет ответ ключом и именем, и по нему принимается решение политики; чтения комментариев, вложений и версий с включённой политикой стоят ещё одного чтения страницы, чтобы узнать её пространство.
|
|
223
233
|
|
|
224
|
-
Скопы, которые нужны токену: классические `read:confluence-content.all`, `read:confluence-space.summary`, `search:confluence`, `read:confluence-user` (или гранулярные `read:page:confluence`, `read:comment:confluence`, `read:attachment:confluence`, `read:space:confluence`, `read:content.metadata:confluence`, `read:user:confluence`). Классический токен работает по адресу сайта (`https://company.atlassian.net`); токен со скоупами Atlassian принимает только через шлюз `https://api.atlassian.com/ex/confluence/{cloudId}` — такой адрес оператор может задать как `instances[].baseUrl`, и провайдер будет ходить по тому же относительному пути `/wiki/...`. Сам cloudId провайдер не ищет.
|
|
234
|
+
Скопы, которые нужны токену: классические `read:confluence-content.all`, `read:confluence-space.summary`, `search:confluence`, `read:confluence-user` (или гранулярные `read:page:confluence`, `read:comment:confluence`, `read:attachment:confluence`, `read:space:confluence`, `read:content.metadata:confluence`, `read:user:confluence`). Классический токен работает по адресу сайта (`https://company.atlassian.net`); токен со скоупами Atlassian принимает только через шлюз `https://api.atlassian.com/ex/confluence/{cloudId}` — такой адрес оператор может задать как `instances[].baseUrl`, и провайдер будет ходить по тому же относительному пути `/wiki/...`. Сам cloudId провайдер не ищет. Для Server / Data Center скоупов и почты нет: там нужен личный токен доступа, а адрес инстанса задаётся вместе с его контекстным путём (`https://wiki.example.corp/confluence`).
|
|
225
235
|
|
|
226
236
|
Запись в surface отсутствует: создание и правка страниц, комментарии, резолв inline-комментариев, вложения, перемещение и администрирование пространств ждут confirmation-фреймворка. Произвольного REST (`confluence_rest_call`), произвольного CQL и скачивания вложений тоже нет — только метаданные и ссылки, которые отдал сам Confluence.
|
|
227
237
|
|
|
238
|
+
### Сервисный токен Confluence
|
|
239
|
+
|
|
240
|
+
Подключение может работать от сервисного токена развёртывания: профиль называет сайт, секрет — та же Basic-пара `email:token`, а граница ресурсов — `spaces` (ключи пространств). Чувствительных чтений в каталоге нет: поиск, пространства, страницы, комментарии, метаданные вложений и версии остаются сервисно-безопасными, но каталог не умеет отдавать байты вложений, и такая операция, когда появится, обязана прийти с классификацией не ниже чувствительной. Страница, названная по id, сначала раскрывается в своё пространство, поиск сужается до `space in (…)` по границе ещё на входе, а строки, пространство которых по ответу не подтверждается, отбрасываются вторым замком. Граница сервиса и операторский `confluence.allowedSpaces` — два независимых сужения: сервисный вызов живёт в их пересечении.
|
|
228
241
|
|
|
229
242
|
## Возможности и скопы Weblate
|
|
230
243
|
|
|
231
244
|
Подключение — API-токен Weblate вместе с выбором инстанса: адреса задаёт только оператор (`weblate.instances`), пользователь выбирает инстанс из списка и вставляет токен. Возможность появляется у пользователя, если её включил оператор (`weblate.*Read`).
|
|
232
245
|
|
|
233
|
-
| Возможность
|
|
234
|
-
|
|
|
235
|
-
| `identity.read`
|
|
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
|
+
| ------------------- | ----------------------------------------------------------------- |
|
|
248
|
+
| `identity.read` | Инстанс Weblate, подключённый аккаунт и вид токена |
|
|
249
|
+
| `projects.read` | Список проектов и карточка проекта |
|
|
250
|
+
| `components.read` | Компоненты проекта и карточка компонента |
|
|
251
|
+
| `translations.read` | Языки компонента и один язык целиком |
|
|
252
|
+
| `units.read` | Поиск строк по тексту, контексту и состоянию, чтение одной строки |
|
|
253
|
+
| `checks.read` | Строки, у которых не проходит хотя бы одна проверка |
|
|
254
|
+
| `comments.read` | Комментарии к строке |
|
|
255
|
+
| `suggestions.read` | Предложенные переводы строки |
|
|
256
|
+
| `changes.read` | История изменений проекта |
|
|
257
|
+
| `statistics.read` | Готовность проекта, компонента и языка |
|
|
258
|
+
| `screenshots.read` | Метаданные скриншотов |
|
|
246
259
|
|
|
247
260
|
Weblate, как и TeamCity с Confluence, не сообщает через API, какие права выданы конкретному токену: токен действует от имени своего пользователя или своего проекта, а «проверить» чтением чужой области провайдер не имеет права. Поэтому сужение идёт только по деплой-флагам оператора (`weblate.*Read`), а права применяет сам Weblate — отказ приходит как `ProviderPermissionDenied`, и провайдер никогда не пробует другой credential. Каждая возможность при этом достижима хотя бы одной операцией, поэтому карточка не может показать переключатель, который ничего не делает.
|
|
248
261
|
|
|
@@ -252,41 +265,44 @@ Weblate, как и TeamCity с Confluence, не сообщает через API,
|
|
|
252
265
|
|
|
253
266
|
Запись в surface отсутствует: предложения перевода, комментарии, правка и утверждение перевода, файлы перевода, autotranslate и операции с репозиторием ждут confirmation-фреймворка. Инструмента с произвольным `q` и произвольным REST тоже нет: поиск принимает только типизированные фильтры.
|
|
254
267
|
|
|
255
|
-
|
|
256
268
|
## Возможности и скопы
|
|
257
269
|
|
|
258
270
|
Одна возможность = один scope Bitrix24. Возможность появляется у пользователя только если её включил оператор (`bitrix24.*Read`, у записи — `bitrix24.crmCommentWrite`) **и** подключённый вебхук реально получил соответствующий scope — плагин спрашивает это у портала методом `scope` при подключении и при нажатии «Проверить».
|
|
259
271
|
|
|
260
|
-
| Возможность
|
|
261
|
-
|
|
|
262
|
-
| `crm.read`
|
|
263
|
-
| `crm.comment.write` | `crm`
|
|
264
|
-
| `chat.read`
|
|
265
|
-
| `openlines.read`
|
|
266
|
-
| `user.read`
|
|
267
|
-
| `department.read`
|
|
268
|
-
| `tasks.read`
|
|
269
|
-
| `calendar.read`
|
|
270
|
-
| `disk.read`
|
|
272
|
+
| Возможность | Scope вебхука | Что открывает |
|
|
273
|
+
| ------------------- | ------------------------------------ | ---------------------------------------------------------------------------------------- |
|
|
274
|
+
| `crm.read` | `crm` | CRM, дела, таймлайн, товарные строки, дубли |
|
|
275
|
+
| `crm.comment.write` | `crm` | Единственная операция записи: комментарий в таймлайн лида, сделки, контакта или компании |
|
|
276
|
+
| `chat.read` | `im` | Чаты, сообщения, поиск по переписке |
|
|
277
|
+
| `openlines.read` | `imopenlines` | Диалоги открытых линий и их история |
|
|
278
|
+
| `user.read` | `user_brief` / `user_basic` / `user` | Свой профиль и поиск сотрудников |
|
|
279
|
+
| `department.read` | `department` | Структура компании |
|
|
280
|
+
| `tasks.read` | `task` | Задачи |
|
|
281
|
+
| `calendar.read` | `calendar` | Календарь и занятость |
|
|
282
|
+
| `disk.read` | `disk` | Файлы Диска |
|
|
271
283
|
|
|
272
284
|
У Bitrix24 нет read-only scope вебхука: `crm` покрывает и чтение, и запись, поэтому гранулярность «запись отдельно» даёт только конфиг-флаг. `crm.comment.write` выключен по умолчанию; даже после включения флага операция стартует с политикой `deny`, пока пользователь (или оператор) явно её не разрешит, — проба scope сама по себе запись не открывает. Остальная запись (`*.add`, `*.update`, `*.delete`), бизнес-процессы, управление пользователями и generic REST/MCP в surface отсутствуют.
|
|
273
285
|
|
|
274
286
|
Выданные в Bitrix24 права не отменяются: портал всё равно применяет права того пользователя, чей вебхук используется. Возможность, обнаруженная после выдачи нового scope, появляется в карточке выключенной — пользователь включает её сам.
|
|
275
287
|
|
|
288
|
+
## Сервисный токен Bitrix24
|
|
289
|
+
|
|
290
|
+
Подключение может работать от сервисного вебхука развёртывания: профиль `managedServiceCredentials` называет портал (хост, в любом регистре — он сравнивается с хостом, который брокер выводит из URL вебхука), секретом служит полный URL сервисного входящего вебхука, а граница ресурсов — единственный вид `portals`: сервисный вызов обязан отвечать на портале из списка, других идентификаторов у границы нет. Проба (`validateServiceCredential`) читает только `profile` и `scope`; подтвердить read-only она не может — scope `crm` и читает, и пишет одним битом, — поэтому вердикт всегда «здоров» с предупреждением, а потолок режима обеспечивают классификация операций и граница. Сервисному токену недоступны по классификации: запись в таймлайн, справочник сотрудников (телефоны и почта), дубликаты по телефону и почте, расшифровки звонков, все чтения чатов и открытых линий, календарь занятости и Диск — это чтения, ответы которых принадлежат конкретным людям, а не порталу; CRM-записи, задачи и структура отделов остаются сервисно-безопасными.
|
|
291
|
+
|
|
276
292
|
## Возможности и скопы GitLab
|
|
277
293
|
|
|
278
294
|
Подключение — personal access token. Возможность появляется у пользователя только если её включил оператор (`gitlab.*Read`) **и** токен при подключении реально предъявил соответствующий scope: плагин спрашивает scopes у самого токена (`GET /api/v4/personal_access_tokens/self`) при сохранении и при нажатии «Проверить». Токен, который не может прочитать себя (старый GitLab, group/project access token), только снижает точность — срез остаётся на деплой-флагах оператора.
|
|
279
295
|
|
|
280
|
-
| Возможность
|
|
281
|
-
|
|
|
282
|
-
| `identity.read`
|
|
283
|
-
| `projects.read`
|
|
284
|
-
| `repository.read`
|
|
285
|
-
| `search.read`
|
|
286
|
-
| `issues.read`
|
|
287
|
-
| `merge_requests.read` | `read_api` / `api`
|
|
288
|
-
| `ci.metadata.read`
|
|
289
|
-
| `ci.logs.read`
|
|
296
|
+
| Возможность | Scope токена | Что открывает |
|
|
297
|
+
| --------------------- | -------------------------------------- | ---------------------------------------------- |
|
|
298
|
+
| `identity.read` | `read_user` / `read_api` / `api` | Свой профиль: логин, имя, инстанс |
|
|
299
|
+
| `projects.read` | `read_api` / `api` | Проекты, видимость, ветка по умолчанию |
|
|
300
|
+
| `repository.read` | `read_repository` / `read_api` / `api` | Дерево, файлы, коммиты, сравнение веток |
|
|
301
|
+
| `search.read` | `read_api` / `api` | Поиск по проектам, задачам, MR, коммитам, коду |
|
|
302
|
+
| `issues.read` | `read_api` / `api` | Задачи и комментарии к ним |
|
|
303
|
+
| `merge_requests.read` | `read_api` / `api` | MR, диффы, обсуждения, одобрения, пайплайны MR |
|
|
304
|
+
| `ci.metadata.read` | `read_api` / `api` | Пайплайны, джобы, их статусы и метаданные |
|
|
305
|
+
| `ci.logs.read` | `read_api` / `api` | Содержимое лога джоба |
|
|
290
306
|
|
|
291
307
|
CI разделён надвое намеренно: лог джоба — это другая утечка, чем список джоб, а раньше обе половины закрывала одна возможность `ci.read`. Оператор стенда задаёт половины отдельно (`ciMetadataRead` и `ciLogsRead`), а старый флаг `ciRead` продолжает работать и теперь управляет обеими; сохранённая политика `ci.read` при первом запуске переносится на оба новых id, поэтому выключенный CI не включается сам. Под сервисным токеном доступна только первая половина: `ci.metadata.read` отвечает, какие джобы были и чем кончились, а `ci.logs.read` показывает, что они напечатали, и остаётся личным чтением. Любая операция, читающая проект, в сервисном режиме обязана назвать проект или группу внутри границы профиля, а листинг без проекта (`gitlab_issues_list`, `gitlab_merge_requests_list`) отказывается — вместо ответа всей картиной, доступной общему аккаунту.
|
|
292
308
|
|
|
@@ -298,18 +314,18 @@ CI разделён надвое намеренно: лог джоба — эт
|
|
|
298
314
|
|
|
299
315
|
Подключение — персональный access token TeamCity. Адрес сервера задаёт оператор в конфигурации развёртывания (`teamcity.serverUrl`) — он один на всех, поэтому форма подключения спрашивает только токен, а карточка показывает адрес как справочную строку. Если адрес не задан, карточка говорит об этом вместо формы, которая всё равно не сохранится. Возможность появляется у пользователя, если её включил оператор (`teamcity.*Read`).
|
|
300
316
|
|
|
301
|
-
| Возможность
|
|
302
|
-
|
|
|
303
|
-
| `identity.read`
|
|
304
|
-
| `projects.read`
|
|
305
|
-
| `buildConfigs.read`
|
|
306
|
-
| `builds.read`
|
|
307
|
-
| `failures.read`
|
|
308
|
-
| `logs.read`
|
|
309
|
-
| `queue.read`
|
|
310
|
-
| `investigations.read` | Расследования падений
|
|
311
|
-
| `agents.read`
|
|
312
|
-
| `artifacts.read`
|
|
317
|
+
| Возможность | Что открывает |
|
|
318
|
+
| --------------------- | ------------------------------------------------------- |
|
|
319
|
+
| `identity.read` | Сервер TeamCity, его версия и подключённый пользователь |
|
|
320
|
+
| `projects.read` | Проекты |
|
|
321
|
+
| `buildConfigs.read` | Конфигурации сборки |
|
|
322
|
+
| `builds.read` | Сборки, карточка сборки, изменения в VCS |
|
|
323
|
+
| `failures.read` | Упавшие тесты и проблемы сборки |
|
|
324
|
+
| `logs.read` | Фрагмент лога сборки |
|
|
325
|
+
| `queue.read` | Очередь сборки |
|
|
326
|
+
| `investigations.read` | Расследования падений |
|
|
327
|
+
| `agents.read` | Агенты сборки |
|
|
328
|
+
| `artifacts.read` | Список артефактов и текст небольших текстовых файлов |
|
|
313
329
|
|
|
314
330
|
Лог сборки и текст артефакта остаются личными под сервисным токеном: это текст, который напечатала сборка, и общий 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
331
|
|
|
@@ -319,23 +335,27 @@ TeamCity, в отличие от GitLab и Bitrix24, не сообщает че
|
|
|
319
335
|
|
|
320
336
|
## Возможности и скопы Jira
|
|
321
337
|
|
|
322
|
-
Подключение
|
|
338
|
+
Подключение зависит от того, где живёт Jira, и это объявляет оператор в конфигурации развёртывания (`jira.sites[].deploymentType`). Atlassian Cloud аутентифицирует **API-токен Atlassian** вместе с e-mail аккаунта через HTTP Basic (`email:token`); Jira Server / Data Center — **личный токен доступа** (Personal Access Token) через `Bearer`, без почты. Провайдер ходит по API того продукта, который объявлен: `/rest/api/3` у Cloud, `/rest/api/2` у Server / Data Center. Сайт, который отвечает `serverInfo.deploymentType` другого продукта, отклоняется на подключении с подсказкой, какое значение поставить.
|
|
323
339
|
|
|
324
|
-
|
|
325
|
-
| --- | --- |
|
|
326
|
-
| `identity.read` | Подключённый пользователь Atlassian и сайт, на котором он работает |
|
|
327
|
-
| `issues.read` | Поиск задач со всем словарём фильтров (включая историю изменений задачи и разрешение имени в accountId) и карточка задачи с описанием, связями и кастомными полями |
|
|
328
|
-
| `comments.read` | Комментарии задачи, включая ограниченные (с пометкой видимости) |
|
|
329
|
-
| `attachments.read` | Метаданные вложений задачи: имя, тип, размер, автор |
|
|
330
|
-
| `transitions.read` | Доступные переходы статуса и их обязательные поля |
|
|
331
|
-
| `projects.read` | Карточка проекта |
|
|
332
|
-
| `fields.read` | Схема полей сайта, включая кастомные, — она же источник id для фильтра по кастомному полю |
|
|
340
|
+
Список сайтов задаёт только оператор — пользователь выбирает сайт из списка и вставляет токен (и почту, если сайт облачный); произвольный хост ввести нельзя. Возможность появляется у пользователя, если её включил оператор (`jira.*Read`).
|
|
333
341
|
|
|
334
|
-
|
|
342
|
+
| Возможность | Что открывает |
|
|
343
|
+
| ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
|
|
344
|
+
| `identity.read` | Подключённый пользователь Atlassian и сайт, на котором он работает |
|
|
345
|
+
| `issues.read` | Поиск задач со всем словарём фильтров (включая историю изменений задачи и разрешение имени в идентификатор пользователя) и карточка задачи с описанием, связями и кастомными полями |
|
|
346
|
+
| `comments.read` | Комментарии задачи, включая ограниченные (с пометкой видимости) |
|
|
347
|
+
| `attachments.read` | Метаданные вложений задачи: имя, тип, размер, автор |
|
|
348
|
+
| `transitions.read` | Доступные переходы статуса и их обязательные поля |
|
|
349
|
+
| `projects.read` | Карточка проекта |
|
|
350
|
+
| `fields.read` | Схема полей сайта, включая кастомные, — она же источник id для фильтра по кастомному полю |
|
|
351
|
+
|
|
352
|
+
Jira, как и TeamCity, не сообщает через API, какие права выданы конкретному API-токену: токен действует от имени пользователя и наследует его права целиком, а «проверить» записью провайдер не имеет права. Поэтому сужение идёт только по деплой-флагам оператора, а права аккаунта применяет сама Jira — отказ приходит как `ProviderPermissionDenied` (задача, проект или поле закрыты схемой прав, issue security level или схемой ролей), и провайдер никогда не пробует другой credential. Единственная проверка, которую провайдер делает сам при подключении, — тип развёртывания: сайт, который отвечает `deploymentType` не тем продуктом, который объявил оператор, отклоняется с подсказкой, какое значение поставить, потому что Cloud и Server / Data Center — разные API, и молча считать их совместимыми спецификация запрещает.
|
|
335
353
|
|
|
336
354
|
Запись в surface отсутствует: создание, правка, назначение, комментарии и переходы ждут pending actions и карточки подтверждения; удаление, администрирование проектов и workflow, произвольный REST и скачивание содержимого вложений — тоже. Провайдер читает только объявленный allow-list эндпоинтов `/rest/api/3` (гейт пакета падает на любом пути вне него), а легаси-эндпоинт `/rest/api/3/search`, удалённый Atlassian, не используется: поиск идёт через `/rest/api/3/search/jql`.
|
|
337
355
|
|
|
338
|
-
|
|
356
|
+
### Сервисный токен Jira
|
|
357
|
+
|
|
358
|
+
Подключение может работать от сервисного токена развёртывания: профиль называет сайт, секрет — обычный API-токен Atlassian в Basic-паре, а граница ресурсов — `projects` (ключи проектов, сравнение без учёта регистра; числовой id засчитывается, если Jira отдала его в выдаче). Сервисному токену недоступны чтения вложений — даже список метаданий помечен чувствительным, потому что следующий естественный шаг агента — скачать файл. Фильтры JQL по имени человека в сервисном режиме отказывают целиком — это чтение корпоративного справочника, у которого нет проекта в границе, — а фильтры по accountId и `me` остаются. Задача, названная по ключу, сначала раскрывается в свой проект, и чтение с уровнем безопасности, который сервисный токен не проходит, отвечает `ResourceNotFound`, как для чужой задачи.
|
|
339
359
|
|
|
340
360
|
Адрес TeamCity задаёт оператор: сервер один на весь стенд, поэтому `teamcity.serverUrl` — обычная настройка развёртывания, а не поле формы. Пользователь вводит только токен, и токен тратится ровно по этому адресу. Рядом оператор задаёт **политику адресов**: какие адреса этот стенд готов набирать вообще (политика осталась от времён, когда адрес вводил пользователь, и закрывает переезд конфига на чужой хост).
|
|
341
361
|
|
|
@@ -344,12 +364,12 @@ teamcity:
|
|
|
344
364
|
enabled: true
|
|
345
365
|
serverUrl: https://teamcity.example.internal
|
|
346
366
|
network:
|
|
347
|
-
mode: allowlist
|
|
367
|
+
mode: allowlist # allowlist | trusted-private
|
|
348
368
|
allowedHosts:
|
|
349
369
|
- teamcity.example.internal
|
|
350
370
|
- "*.corp.example"
|
|
351
371
|
allowedCidrs:
|
|
352
|
-
- 10.20.0.0/16
|
|
372
|
+
- 10.20.0.0/16 # только для адресов, записанных цифрами
|
|
353
373
|
allowedPorts:
|
|
354
374
|
- 443
|
|
355
375
|
- 8111
|
|
@@ -373,7 +393,7 @@ teamcity:
|
|
|
373
393
|
```yaml
|
|
374
394
|
teamcity:
|
|
375
395
|
enabled: true
|
|
376
|
-
serverUrl: https://teamcity.example.internal
|
|
396
|
+
serverUrl: https://teamcity.example.internal # один адрес на весь стенд
|
|
377
397
|
network:
|
|
378
398
|
mode: allowlist
|
|
379
399
|
allowedHosts: [teamcity.example.internal]
|
|
@@ -389,19 +409,19 @@ teamcity:
|
|
|
389
409
|
investigationsRead: true
|
|
390
410
|
agentsRead: true
|
|
391
411
|
artifactsRead: true
|
|
392
|
-
maxLogLines: 1000
|
|
393
|
-
maxLogBytes: 262144
|
|
394
|
-
defaultArtifactBytes: 262144
|
|
395
|
-
maxArtifactBytes: 1048576
|
|
396
|
-
streamTimeoutMs: 30000
|
|
397
|
-
retries: 2
|
|
412
|
+
maxLogLines: 1000 # потолок строк в ответе по логу
|
|
413
|
+
maxLogBytes: 262144 # сколько лога вообще скачиваем
|
|
414
|
+
defaultArtifactBytes: 262144 # бюджет чтения артефакта по умолчанию
|
|
415
|
+
maxArtifactBytes: 1048576 # жёсткий потолок чтения артефакта
|
|
416
|
+
streamTimeoutMs: 30000 # таймаут для логов и артефактов
|
|
417
|
+
retries: 2 # повторы для 429/5xx и сетевых сбоев
|
|
398
418
|
```
|
|
399
419
|
|
|
400
420
|
Токен создаётся в TeamCity (Profile → Access Tokens), при желании с «Limit per project» и read-правами, вводится один раз в карточке и шифруется тем же конвертным хранилищем, что и остальные секреты.
|
|
401
421
|
|
|
402
422
|
## Чего в TeamCity-провайдере ещё нет
|
|
403
423
|
|
|
404
|
-
Спецификация `docs/
|
|
424
|
+
Спецификация `docs/specs/providers-teamcity.md` описывает целевую архитектуру; в этой версии реализована read-only фаза, как и у Bitrix24 с GitLab:
|
|
405
425
|
|
|
406
426
|
- **Запись** (§12.2): запуск, перезапуск, отмена сборки, комментарий и теги — вместе с ними отложены pending actions и карточка подтверждения (§24). Пока в каталоге нет ни одной операции, которая может изменить TeamCity.
|
|
407
427
|
- **Автоматический постраничный обход** (§18): сейчас один вызов — один ограниченный запрос, а `pagination.hasMore` сообщает модели, что страница обрезана. Пятистраничная агрегация потребовала бы ходить по `nextHref`, чего провайдер не делает.
|
|
@@ -422,15 +442,21 @@ teamcity:
|
|
|
422
442
|
```yaml
|
|
423
443
|
confluence:
|
|
424
444
|
enabled: true
|
|
425
|
-
allowInsecureHttp: false
|
|
445
|
+
allowInsecureHttp: false # только для dev-стенда
|
|
426
446
|
instances:
|
|
427
447
|
- id: company
|
|
428
448
|
label: Company
|
|
429
449
|
baseUrl: https://company.atlassian.net
|
|
450
|
+
deploymentType: cloud # cloud (по умолчанию) | server | data-center
|
|
430
451
|
# токен со скоупами требует шлюза Atlassian:
|
|
431
452
|
# - id: company-scoped
|
|
432
453
|
# label: Company (scoped token)
|
|
433
454
|
# baseUrl: https://api.atlassian.com/ex/confluence/<cloudId>
|
|
455
|
+
# самохостящаяся Confluence Server / Data Center (контекст — в baseUrl):
|
|
456
|
+
# - id: corp
|
|
457
|
+
# label: Corporate Wiki
|
|
458
|
+
# baseUrl: https://wiki.example.corp/confluence
|
|
459
|
+
# deploymentType: server # личный токен доступа, /rest/api
|
|
434
460
|
identityRead: true
|
|
435
461
|
spacesRead: true
|
|
436
462
|
searchRead: true
|
|
@@ -438,19 +464,19 @@ confluence:
|
|
|
438
464
|
commentsRead: true
|
|
439
465
|
attachmentsRead: true
|
|
440
466
|
versionsRead: true
|
|
441
|
-
allowedSpaces: []
|
|
442
|
-
defaultBodyChars: 20000
|
|
443
|
-
maxBodyChars: 60000
|
|
444
|
-
maxResults: 50
|
|
445
|
-
maxReplyParents: 10
|
|
446
|
-
retries: 2
|
|
467
|
+
allowedSpaces: [] # ключи пространств; пусто = все, что видит аккаунт
|
|
468
|
+
defaultBodyChars: 20000 # бюджет тела страницы по умолчанию
|
|
469
|
+
maxBodyChars: 60000 # потолок бюджета, который может попросить модель
|
|
470
|
+
maxResults: 50 # строк в ответе любого списка (потолок для limit)
|
|
471
|
+
maxReplyParents: 10 # сколько комментариев могут принести ответы
|
|
472
|
+
retries: 2 # повторы для 429/5xx и сетевых сбоев
|
|
447
473
|
```
|
|
448
474
|
|
|
449
475
|
API token выпускается в профиле Atlassian (`Manage profile → Security → API tokens`), вводится один раз в карточке и шифруется тем же конвертным хранилищем, что и остальные секреты. Если стенду нужен OAuth-аккаунт Atlassian общего вида, а не персональный токен, — это отдельная фаза.
|
|
450
476
|
|
|
451
477
|
## Чего в Confluence-провайдере ещё нет
|
|
452
478
|
|
|
453
|
-
Спецификация `docs/
|
|
479
|
+
Спецификация `docs/specs/providers-confluence.md` описывает целевую архитектуру; в этой версии реализована read-only фаза, как и у остальных провайдеров:
|
|
454
480
|
|
|
455
481
|
- **OAuth 2.0 3LO** (раздел «Authentication»): подключение идёт API token плюс почта аккаунта, поэтому нет ни общего OAuth-приложения, ни refresh-цикла, ни общего слоя `providers/atlassian` с `accessible-resources`. Выбор ресурса сводится к выбору сайта из конфига оператора.
|
|
456
482
|
- **Запись** (раздел «Write operations»): создание и правка страниц, комментарии, резолв inline-комментариев — вместе с ними отложены pending actions, карточка подтверждения и оптимистичная блокировка по версии страницы. Пока в каталоге нет ни одной операции, которая может изменить Confluence.
|
|
@@ -461,9 +487,13 @@ API token выпускается в профиле Atlassian (`Manage profile
|
|
|
461
487
|
- **Продолжение большого тела** (раздел «Response size controls»): тело режется бюджетом и помечается `truncated`, но сегментного чтения (`confluence_get_page_segment`) нет; страница, чей JSON на стороне Confluence больше `maxResponseBytes`, отвечает `ResultTooLarge`.
|
|
462
488
|
- **Кэш** (раздел «Caching») отсутствует полностью, поэтому и межпользовательской утечки через кэш быть не может; пагинация stateless, подписанных continuation-токенов нет.
|
|
463
489
|
- **Rate limiting** (раздел «Rate limiting»): лимиты по principal, ресурсу и глобальные не считаются; вместо них — ограниченные размеры ответов и повторы с backoff для 429/5xx.
|
|
464
|
-
- **Семантический индекс** (раздел «Optional semantic index»)
|
|
490
|
+
- **Семантический индекс** (раздел «Optional semantic index») и **webhooks** (раздел «Compatibility») — не подключены.
|
|
465
491
|
|
|
466
|
-
|
|
492
|
+
Confluence Server / Data Center подключён: объявите инстанс с `deploymentType: server`, и чтения пойдут по v1 API (`/rest/api`) с личным токеном доступа, а тела страниц — в storage-разметке.
|
|
493
|
+
|
|
494
|
+
### Сервисный токен Weblate
|
|
495
|
+
|
|
496
|
+
Подключение может работать от сервисного токена развёртывания: профиль называет инстанс, секрет — обычный API-токен Weblate (префикс значения роли не играет), а граница ресурсов — `projects` (слаги проектов; компонент принадлежит проекту, поэтому чтение компонента сверяет его проект). Чувствительных чтений в каталоге нет: всё, что читает провайдер, — переводческие метаданные, а `changes.list` — собственный журнал изменений Weblate, а не сырой вывод VCS. Чтение, названное по id строки, сначала раскрывается в свой проект; скриншоты вне границы и с непроверяемым проектом из выдачи выпадают, а листинг проектов собирается из allowlist с `unavailableResources` для того, что токен не видит.
|
|
467
497
|
|
|
468
498
|
Инстансы Weblate задаёт только оператор: пользователь выбирает инстанс из списка и вставляет API-токен, произвольный хост ввести нельзя. Если инстанс один, выбор не показывается; если инстансов нет, карточка честно сообщает, что подключать нечего, и формы не показывает.
|
|
469
499
|
|
|
@@ -476,7 +506,7 @@ API token выпускается в профиле Atlassian (`Manage profile
|
|
|
476
506
|
```yaml
|
|
477
507
|
weblate:
|
|
478
508
|
enabled: true
|
|
479
|
-
allowInsecureHttp: false
|
|
509
|
+
allowInsecureHttp: false # только для dev-стенда
|
|
480
510
|
instances:
|
|
481
511
|
- id: corp
|
|
482
512
|
label: Corporate Weblate
|
|
@@ -496,16 +526,16 @@ weblate:
|
|
|
496
526
|
changesRead: true
|
|
497
527
|
statisticsRead: true
|
|
498
528
|
screenshotsRead: true
|
|
499
|
-
maxTextChars: 4000
|
|
500
|
-
maxPageSize: 100
|
|
501
|
-
retries: 2
|
|
529
|
+
maxTextChars: 4000 # символов одной строки, которую видит модель
|
|
530
|
+
maxPageSize: 100 # потолок страницы; по умолчанию провайдер просит 20
|
|
531
|
+
retries: 2 # повторы для 429/5xx и сетевых сбоев
|
|
502
532
|
```
|
|
503
533
|
|
|
504
534
|
Список инстансов принимает не больше 16 записей; id — строчные латинские буквы, цифры и дефисы (до 32 символов), без повторов; подпись по умолчанию — имя хоста. Опечатка в инстансе роняет загрузку конфига, а не выбрасывает инстанс молча: пользователь иначе получил бы провайдер, к которому нельзя подключиться, и никакого объяснения. Пустой список — это состояние, а не падение: провайдер зарегистрирован и бездействует, а отказывает форма подключения.
|
|
505
535
|
|
|
506
536
|
## Чего в Weblate-провайдере ещё нет
|
|
507
537
|
|
|
508
|
-
Спецификация `docs/
|
|
538
|
+
Спецификация `docs/specs/providers-weblate.md` описывает целевую архитектуру; в этой версии реализована read-only фаза, как и у остальных провайдеров:
|
|
509
539
|
|
|
510
540
|
- **Запись** (раздел «Write operations»): предложения перевода, комментарии, правка и утверждение перевода, файлы перевода, autotranslate и операции с репозиторием — вместе с ними отложены pending actions и карточка подтверждения. Пока в каталоге нет ни одной операции, которая может изменить Weblate.
|
|
511
541
|
- **Скачивание скриншотов** (раздел «Screenshots and binary data»): сейчас только метаданные, id связанных строк и адрес картинки на настроенном инстансе; ни байты, ни лимит размера, ни проверка MIME, ни временное хранилище на пользователя не реализованы.
|
|
@@ -531,7 +561,7 @@ weblate:
|
|
|
531
561
|
```yaml
|
|
532
562
|
gitlab:
|
|
533
563
|
enabled: true
|
|
534
|
-
allowInsecureHttp: false
|
|
564
|
+
allowInsecureHttp: false # только для dev-стенда
|
|
535
565
|
instances:
|
|
536
566
|
- id: gitlab-com
|
|
537
567
|
label: GitLab.com
|
|
@@ -545,19 +575,19 @@ gitlab:
|
|
|
545
575
|
searchRead: true
|
|
546
576
|
issuesRead: true
|
|
547
577
|
mergeRequestsRead: true
|
|
548
|
-
ciMetadataRead: true
|
|
549
|
-
ciLogsRead: true
|
|
550
|
-
maxFileBytes: 131072
|
|
551
|
-
maxJobLogBytes: 262144
|
|
552
|
-
maxSearchResults: 50
|
|
553
|
-
retries: 2
|
|
578
|
+
ciMetadataRead: true # пайплайны, джобы, их статусы; прежний ciRead задаёт обе половины
|
|
579
|
+
ciLogsRead: true # содержимое лога джоба: только личный аккаунт
|
|
580
|
+
maxFileBytes: 131072 # сколько тела файла отдаём модели
|
|
581
|
+
maxJobLogBytes: 262144 # сколько лога джобы отдаём модели
|
|
582
|
+
maxSearchResults: 50 # потолок per page у поиска
|
|
583
|
+
retries: 2 # повторы для 429/5xx и сетевых сбоев
|
|
554
584
|
```
|
|
555
585
|
|
|
556
586
|
OAuth-приложение для GitLab не нужно: подключение идёт персональным токеном. Токен создаётся в GitLab (`User settings → Access tokens`) с read-scope, вводится один раз в карточке, шифруется тем же конвертным хранилищем, что и вебхук Bitrix24, и после сохранения не показывается и не копируется.
|
|
557
587
|
|
|
558
588
|
## Чего в GitLab-провайдере ещё нет
|
|
559
589
|
|
|
560
|
-
Спецификация `docs/
|
|
590
|
+
Спецификация `docs/specs/providers-gitlab.md` описывает целевую архитектуру; в этой версии сознательно реализована только read-only фаза, как и у Bitrix24:
|
|
561
591
|
|
|
562
592
|
- **OAuth Authorization Code + PKCE** (§8.1) — вместо него PAT (§8.2). Для OAuth нужны callback-маршрут на хосте, одноразовый state и refresh-цикл; это отдельная фаза.
|
|
563
593
|
- **Пользовательская граница ресурсов** (§12): в личном режиме доступ ограничен правами токена и персональной политикой возможностей, но не выбранным набором проектов/групп. Выбранный набор есть только в сервисном режиме: там границу задаёт администратор в профиле, а пользователь может её сузить, но не расширить.
|
|
@@ -576,16 +606,22 @@ OAuth-приложение для GitLab не нужно: подключение
|
|
|
576
606
|
```yaml
|
|
577
607
|
jira:
|
|
578
608
|
enabled: true
|
|
579
|
-
allowInsecureHttp: false
|
|
609
|
+
allowInsecureHttp: false # только для dev-стенда
|
|
580
610
|
sites:
|
|
581
611
|
- id: company
|
|
582
612
|
label: company.atlassian.net
|
|
583
613
|
baseUrl: https://company.atlassian.net
|
|
614
|
+
deploymentType: cloud # cloud (по умолчанию) | server | data-center
|
|
584
615
|
- id: sandbox
|
|
585
616
|
label: Sandbox
|
|
586
617
|
baseUrl: https://sandbox.atlassian.net
|
|
587
|
-
|
|
588
|
-
|
|
618
|
+
# самохостящаяся Jira Server / Data Center:
|
|
619
|
+
# - id: corp
|
|
620
|
+
# label: Jira Server
|
|
621
|
+
# baseUrl: https://jira.example.corp
|
|
622
|
+
# deploymentType: server # личный токен доступа, /rest/api/2
|
|
623
|
+
fieldAliases: # имена кастомных полей ЭТОГО сайта: алиас → customfield_ id
|
|
624
|
+
product: customfield_10010 # id берётся из jira_get_fields; в репозитории их нет
|
|
589
625
|
identityRead: true
|
|
590
626
|
issuesRead: true
|
|
591
627
|
commentsRead: true
|
|
@@ -593,25 +629,26 @@ jira:
|
|
|
593
629
|
transitionsRead: true
|
|
594
630
|
projectsRead: true
|
|
595
631
|
fieldsRead: true
|
|
596
|
-
defaultSearchLimit: 20
|
|
597
|
-
maxSearchLimit: 100
|
|
598
|
-
maxCommentLimit: 100
|
|
599
|
-
maxTextChars: 20000
|
|
600
|
-
retries: 2
|
|
632
|
+
defaultSearchLimit: 20 # строк в ответе поиска, если модель не просила
|
|
633
|
+
maxSearchLimit: 100 # потолок страницы; больше Jira не отдаёт
|
|
634
|
+
maxCommentLimit: 100 # потолок страницы комментариев
|
|
635
|
+
maxTextChars: 20000 # бюджет одного описания, комментария или rich-поля
|
|
636
|
+
retries: 2 # повторы для 429/5xx и сетевых сбоев
|
|
601
637
|
```
|
|
602
638
|
|
|
603
|
-
OAuth-приложение для Jira не нужно: подключение идёт
|
|
639
|
+
OAuth-приложение для Jira не нужно: подключение идёт токеном. Для Cloud токен создаётся в аккаунте Atlassian (`id.atlassian.com → Безопасность → API-токены`), вводится один раз в карточке и шифруется тем же конвертным хранилищем, что и остальные секреты — вместе с e-mail аккаунта, потому что Jira Cloud аутентифицирует пару `email:token`, а не токен отдельно. Для Server / Data Center токен создаётся в профиле самой Jira (`Профиль → Личные токены доступа`) и хранится один, без почты: он аутентифицируется как `Bearer`. После сохранения секрет не показывается и не копируется.
|
|
604
640
|
|
|
605
641
|
`fieldAliases` — тоже настройка развёртывания, а не знание провайдера: какие кастомные поля инстанса отвечают на «продукт», «команду» или «окружение» — это свойство конкретного сайта, поэтому в пакете нет ни одного такого id, а оператор объявляет свои имена алиасами и видит их в ответе `jira_get_fields`. Опечатка в алиасе роняет загрузку конфига, как и опечатка в списке сайтов: алиас, который молча никуда не указывает, отвечал бы «задач нет» вместо «нет такого поля». Значения алиасных полей также известны только инстансу — их читают из реальных задач (`jira_get_issue` с `include: ["custom_fields"]`), а не угадывают.
|
|
606
642
|
|
|
607
643
|
## Чего в Jira-провайдере ещё нет
|
|
608
644
|
|
|
609
|
-
Спецификация `docs/
|
|
645
|
+
Спецификация `docs/specs/providers-jira.md` описывает целевую архитектуру; в этой версии реализована read-only фаза, как и у Bitrix24, GitLab и TeamCity:
|
|
610
646
|
|
|
611
647
|
- **OAuth 2.0 3LO с ротацией refresh-токенов** (§Authentication): вместо него API-токен с Basic-аутентификацией. Для OAuth нужны callback-маршрут на хосте, одноразовый state с PKCE, per-credential lock на ротацию refresh-токена и `reauth_required` при `invalid_grant` — это отдельная фаза. Токен, отклонённый Jira (401), сейчас отвечает `CredentialRevoked`, а карточка предлагает заменить токен.
|
|
612
648
|
- **Общий слой Atlassian** (§Shared Atlassian account model): `providers/atlassian/` — общий аккаунт и ресурсы для Jira и Confluence, несколько сайтов на один аккаунт. Пока Jira самостоятельный каталог, как и остальные три провайдера, а сайт выбирается при подключении.
|
|
613
649
|
- **Привязка workspace → проект** (§Workspace binding): allowlist проектов на уровне рабочего пространства — дополнительное сужение, которого сейчас нет; доступ ограничен правами аккаунта и персональной политикой возможностей.
|
|
614
650
|
- **Raw JQL** (§JQL policy, advanced mode): модели доступны только типизированные фильтры. Отдельный JQL-инструмент потребовал бы валидации через parse-API Jira, лимитов на ширину запроса и аудита исходной и нормализованной строки.
|
|
651
|
+
- **Jira Server / Data Center**: подключён как второй продукт (см. `deploymentType` выше) — чтения идут по `/rest/api/2` с личным токеном доступа. Не подключено то, чего у v2 API нет вовсе: enhanced search с continuation-токеном (у Server / Data Center пагинация по offset, и это то, что отдаёт провайдер) и Cloud-специфичные поля ответа вроде `accountType`.
|
|
615
652
|
- **Запись** (§Write operations): `jira_prepare_*` вместе с pending actions, payload hash, сроком годности и перепроверкой прав на подтверждении. Пока в каталоге нет ни одной операции, которая может изменить Jira, и ни одного инструмента со словом `prepare`.
|
|
616
653
|
- **Скачивание вложений** (§Attachments): сейчас только метаданные. Будущий `jira_get_attachment` обязан заново проверять видимость задачи, иметь лимит байт и allowlist типов.
|
|
617
654
|
- **Поиск по истории изменений**: историю одной задачи прочитать можно (`include: ["changelog_summary"]`), а вот отфильтровать задачи «где в истории встречается 3.8» — нет. Типизированный фильтр по истории потребовал бы JQL-операторов `WAS`/`CHANGED` с их отдельной валидацией; пока такой запрос сводится к чтению истории конкретных задач. Чтение кастомных полей идёт селектором `*all`, поэтому на сайте с очень большим числом полей такой ответ может упереться в `ResultTooLarge`.
|
|
@@ -624,46 +661,46 @@ Test IT — система управления тестированием: те
|
|
|
624
661
|
и результаты. Все 22 инструмента только читают; каждый называет capability, и
|
|
625
662
|
выключенную оператором возможность агент не получает вовсе.
|
|
626
663
|
|
|
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`
|
|
650
|
-
| `testit_configurations`
|
|
664
|
+
| Tool | Что делает |
|
|
665
|
+
| -------------------------------- | ------------------------------------------------------------------- |
|
|
666
|
+
| `testit_connection_get` | К какой инсталляции подключено и видит ли токен проекты |
|
|
667
|
+
| `testit_projects` | Проекты с числом тест-кейсов, чек-листов и автотестов |
|
|
668
|
+
| `testit_project_get` | Карточка проекта: описание, счётчики, схема атрибутов |
|
|
669
|
+
| `testit_sections` | Разделы (папки) тест-библиотеки проекта |
|
|
670
|
+
| `testit_work_items` | Тест-кейсы, чек-листы и общие шаги проекта по фильтрам |
|
|
671
|
+
| `testit_work_item_get` | Тест-кейс целиком: шаги, предусловия, атрибуты, теги, вложения |
|
|
672
|
+
| `testit_work_item_history` | История изменений: кто что поменял, из чего в что |
|
|
673
|
+
| `testit_work_item_comments` | Комментарии к тест-кейсу |
|
|
674
|
+
| `testit_work_item_test_results` | История результатов тест-кейса по прогонам и конфигурациям |
|
|
675
|
+
| `testit_test_plans` | Тест-планы проекта со статусом и сроками |
|
|
676
|
+
| `testit_test_plan_get` | Карточка тест-плана |
|
|
677
|
+
| `testit_test_plan_summary` | Прогресс плана: тест-поинты, автоматизация, дефекты |
|
|
678
|
+
| `testit_test_runs` | Прогоны проекта по состояниям, датам и тест-плану |
|
|
679
|
+
| `testit_test_run_get` | Карточка прогона |
|
|
680
|
+
| `testit_test_run_results` | Что было в прогоне: тест-поинты с итогом и результатами |
|
|
681
|
+
| `testit_test_result_get` | Результат теста: шаги, длительность, сообщение, трейсы |
|
|
682
|
+
| `testit_test_result_attachments` | Метаданные вложений результата |
|
|
683
|
+
| `testit_attachment_metadata` | Метаданные вложения |
|
|
684
|
+
| `testit_attachment_text` | Текст небольшого текстового вложения (бинарные и архивы отбиваются) |
|
|
685
|
+
| `testit_auto_tests` | Автотесты проекта: класс, пространство имён, стабильность |
|
|
686
|
+
| `testit_auto_test_get` | Карточка автотеста: шаги, setup, teardown, последний результат |
|
|
687
|
+
| `testit_configurations` | Конфигурации проекта, в разрезе которых считаются результаты |
|
|
651
688
|
|
|
652
689
|
## Возможности и скопы Test IT
|
|
653
690
|
|
|
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` | Конфигурации проекта
|
|
691
|
+
| Возможность | Что открывает |
|
|
692
|
+
| --------------------- | ------------------------------------------------------------ |
|
|
693
|
+
| `projects.read` | Проекты и карточка проекта, проба подключения |
|
|
694
|
+
| `sections.read` | Разделы тест-библиотеки |
|
|
695
|
+
| `workItems.read` | Тест-кейсы, чек-листы, общие шаги |
|
|
696
|
+
| `history.read` | История изменений тест-кейса |
|
|
697
|
+
| `comments.read` | Комментарии тест-кейса |
|
|
698
|
+
| `testPlans.read` | Тест-планы, карточка и сводка |
|
|
699
|
+
| `testRuns.read` | Прогоны и карточка прогона |
|
|
700
|
+
| `testResults.read` | Результаты прогона, отдельный результат, история результатов |
|
|
701
|
+
| `autoTests.read` | Автотесты |
|
|
702
|
+
| `attachments.read` | Метаданные вложений и текст текстовых файлов |
|
|
703
|
+
| `configurations.read` | Конфигурации проекта |
|
|
667
704
|
|
|
668
705
|
Сужения по «выданным правам» здесь нет: API v2 не сообщает, какие права у
|
|
669
706
|
токена (в отличие от вебхука Bitrix24 с его scope и GitLab с
|
|
@@ -676,9 +713,11 @@ Test IT — система управления тестированием: те
|
|
|
676
713
|
единственные GET-чтения этих коллекций, а поиск (`POST /workItems/search`),
|
|
677
714
|
статистика прогона и глобальный поиск — POST-эндпоинты, которых в каталоге нет
|
|
678
715
|
по правилу «каждая операция каталога — GET». Что из-за этого недоступно и чем
|
|
679
|
-
заменено — в [
|
|
716
|
+
заменено — в [providers-testit.md](https://github.com/xarleyn/dsh-plugins/blob/main/plugins/dsh-qa-integrations/docs/specs/providers-testit.md).
|
|
680
717
|
|
|
681
|
-
|
|
718
|
+
### Сервисный токен Test IT
|
|
719
|
+
|
|
720
|
+
Подключение может работать от сервисного токена развёртывания: профиль называет инсталляцию, секрет — обычный API-токен, а граница ресурсов — `projects` (id проектов, точное сравнение — иерархии проектов у Test IT нет). Сервисному токену недоступны вложения целиком: даже метаданные не несут проект, поэтому глобальный id нечем сверить с границей — каталог отвечает отказом, а не молча; тело вложения чувствительно и в личном режиме читается только у маленьких текстовых файлов. Чтение, адресованное id (тест-кейс, план, прогон, результат), сначала раскрывается в свой проект, и чтение вне границы отказывает до обращения к собственно объекту; листинг `projects.list` собирается из allowlist, а не из того, что видит токен.
|
|
682
721
|
|
|
683
722
|
Test IT бывает облачный и self-hosted, поэтому адрес задаёт оператор стенда
|
|
684
723
|
списком инсталляций (`testit.instances`) — пользователь выбирает инсталляцию из
|
|
@@ -710,12 +749,12 @@ query и фрагмента, а хвостовой слэш снимается.
|
|
|
710
749
|
```yaml
|
|
711
750
|
testit:
|
|
712
751
|
enabled: true
|
|
713
|
-
allowInsecureHttp: false
|
|
752
|
+
allowInsecureHttp: false # лазейка для внутреннего стенда; в проде HTTPS
|
|
714
753
|
instances:
|
|
715
754
|
- id: cloud
|
|
716
755
|
label: Test IT Cloud
|
|
717
756
|
baseUrl: https://team.example.testit.software
|
|
718
|
-
projectsRead: true
|
|
757
|
+
projectsRead: true # флаги возможностей: выключенная не доходит до агента
|
|
719
758
|
sectionsRead: true
|
|
720
759
|
workItemsRead: true
|
|
721
760
|
historyRead: true
|
|
@@ -726,17 +765,17 @@ testit:
|
|
|
726
765
|
autoTestsRead: true
|
|
727
766
|
attachmentsRead: true
|
|
728
767
|
configurationsRead: true
|
|
729
|
-
defaultResults: 20
|
|
730
|
-
maxResults: 100
|
|
731
|
-
defaultAttachmentBytes: 262144
|
|
732
|
-
maxAttachmentBytes: 10485760
|
|
733
|
-
attachmentTimeoutMs: 30000
|
|
734
|
-
retries: 2
|
|
768
|
+
defaultResults: 20 # размер списка, когда модель не назвала лимит
|
|
769
|
+
maxResults: 100 # жёсткий потолок одного ответа-списка
|
|
770
|
+
defaultAttachmentBytes: 262144 # бюджет чтения вложения по умолчанию
|
|
771
|
+
maxAttachmentBytes: 10485760 # жёсткий потолок чтения вложения (10 MiB)
|
|
772
|
+
attachmentTimeoutMs: 30000 # таймаут скачивания вложения
|
|
773
|
+
retries: 2 # повторы для 429/5xx и сетевых сбоев
|
|
735
774
|
```
|
|
736
775
|
|
|
737
776
|
## Чего в Test IT-провайдере ещё нет
|
|
738
777
|
|
|
739
|
-
Спецификация `docs/
|
|
778
|
+
Спецификация `docs/specs/providers-testit.md` описывает целевую архитектуру; в
|
|
740
779
|
этой версии реализована read-only фаза, как и у остальных пяти провайдеров:
|
|
741
780
|
|
|
742
781
|
- **Поиск и статистика через POST**: `POST /workItems/search`,
|
|
@@ -765,7 +804,7 @@ testit:
|
|
|
765
804
|
|
|
766
805
|
## Сервисные токены (managed service credentials)
|
|
767
806
|
|
|
768
|
-
Развёртывание может завести один read-only сервисный токен и разрешить подключениям работать от его имени: выпустить personal access token может не каждый — у подрядчика нет своей учётной записи в корпоративном GitLab, стажёру не выдали прав на токен, — а один централизованно сменяемый аккаунт снимает с пользователей и ротацию, и вопрос «чей это был доступ». Владелец токена — развёртывание: пользователь не может ни создать профиль, ни сменить секрет, ни выбрать профиль по id. Возможность реализована у
|
|
807
|
+
Развёртывание может завести один read-only сервисный токен и разрешить подключениям работать от его имени: выпустить personal access token может не каждый — у подрядчика нет своей учётной записи в корпоративном GitLab, стажёру не выдали прав на токен, — а один централизованно сменяемый аккаунт снимает с пользователей и ротацию, и вопрос «чей это был доступ». Владелец токена — развёртывание: пользователь не может ни создать профиль, ни сменить секрет, ни выбрать профиль по id. Возможность реализована у всех семи интеграций; классификация service-safe операций у каждой своя, и чувствительные чтения каждого провайдера перечислены в его разделе.
|
|
769
808
|
|
|
770
809
|
```yaml
|
|
771
810
|
managedServiceCredentials:
|
|
@@ -774,8 +813,8 @@ managedServiceCredentials:
|
|
|
774
813
|
profiles:
|
|
775
814
|
- id: gitlab-corp-readonly
|
|
776
815
|
provider: gitlab
|
|
777
|
-
instance: corp
|
|
778
|
-
label: QA GitLab Read-only
|
|
816
|
+
instance: corp # id из gitlab.instances
|
|
817
|
+
label: QA GitLab Read-only # псевдоним, который видит пользователь
|
|
779
818
|
credential:
|
|
780
819
|
type: pat
|
|
781
820
|
secretFile: /run/secrets/qa_gitlab_service_token
|
|
@@ -786,10 +825,10 @@ managedServiceCredentials:
|
|
|
786
825
|
groups:
|
|
787
826
|
- group/platform
|
|
788
827
|
policy:
|
|
789
|
-
gitlab.issues.read: deny
|
|
828
|
+
gitlab.issues.read: deny # только сужение; "allow" отвергается при загрузке
|
|
790
829
|
- id: teamcity-readonly
|
|
791
830
|
provider: teamcity
|
|
792
|
-
instance: teamcity
|
|
831
|
+
instance: teamcity # сервер TeamCity один, id фиксирован
|
|
793
832
|
label: QA TeamCity Read-only
|
|
794
833
|
credential:
|
|
795
834
|
type: personal_access_token
|
|
@@ -799,13 +838,13 @@ managedServiceCredentials:
|
|
|
799
838
|
- PLATFORM
|
|
800
839
|
```
|
|
801
840
|
|
|
802
|
-
`enabled` по умолчанию `false`: пока развёртывание не включило срез, о сервисном токене нет ни строчки — ни чекбокса в форме подключения, ни профилей, ни нового поведения. `defaultForNewConnections` решает, с какого режима начинается новое подключение. `resources` обязателен и проверяется при загрузке: профиль без границы — это общий аккаунт, который видит всё, что видит его владелец, и ровно этого возможность не допускает. Записи `resources` — те идентификаторы, которые принимает сам
|
|
841
|
+
`enabled` по умолчанию `false`: пока развёртывание не включило срез, о сервисном токене нет ни строчки — ни чекбокса в форме подключения, ни профилей, ни нового поведения. `defaultForNewConnections` решает, с какого режима начинается новое подключение. `resources` обязателен и проверяется при загрузке: профиль без границы — это общий аккаунт, который видит всё, что видит его владелец, и ровно этого возможность не допускает. Записи `resources` — те идентификаторы, которые принимает сам провайдер, и словарь границы у каждого свой: `projects` (id проекта GitLab или полный путь, путь группы, id проекта TeamCity, Jira и Test IT, слаг проекта Weblate), `spaces` (ключи пространств Confluence) и `portals` (хост портала Bitrix24 — единственная граница, потому что Bitrix24 не дробит доступ по проектам). Секрет берётся из смонтированного файла (`secretFile`) или из переменной окружения (`secretEnv`) — ровно один из двух, в YAML он не лежит; у Bitrix24 секрет — полный URL сервисного входящего вебхука, портал брокер выводит из него сам. Опечатка в профиле роняет загрузку конфига, а не выбрасывает профиль молча: сообщение называет профиль или инстанс и говорит, что именно не так, — неизвестный провайдер, неизвестный инстанс, инстанс, занятый двумя профилями, или `resources`, не назвавший ни одного вида ресурсов.
|
|
803
842
|
|
|
804
843
|
Новое подключение начинается на сервисном токене, когда профиль для выбранного инстанса есть и `defaultForNewConnections` включён (по умолчанию так): чекбокс «Использовать сервисный токен» в форме уже отмечен, поля токена нет вовсе, а кнопка называется «Подключить сервисный токен». Снятая галочка возвращает обычную форму с personal access token. У уже существующих подключений режим не меняется: он хранится в самом подключении, поэтому обновление стенда не переводит пользователя на общий аккаунт само. В подключённой карточке режим виден строкой «Сервисный аккаунт · управляется администратором», а рядом — «Изменить доступ» и «Использовать личный аккаунт».
|
|
805
844
|
|
|
806
|
-
Сервисный режим — не «read-only вообще», а жёсткий потолок: только `read`, только обычная чувствительность и только операции, которые провайдер пометил service-safe намеренно. Запись, админ-действия, управление правами и токенами и произвольный REST недостижимы, даже если сервисный токен наверху это умеет: классификация операции — свойство каталога провайдера, а не прав токена. Чувствительные чтения остаются личными: через общий аккаунт не читаются лог CI-джоба GitLab (`ci.logs.read`), лог сборки TeamCity (`logs.read`) и текст артефакта (`artifacts.read`), а конфиденциальная задача GitLab не возвращается вовсе — прямое чтение отвечает `ResourceNotFound`, из выдачи и из поиска она выпадает, а поиск по комментариям (`scope: notes`) отказывается целиком: у комментария нет признака конфиденциальности, и проверить его родителя одним запросом нельзя. Операция, которую провайдер не классифицировал, отклоняется по умолчанию: инструмент, добавленный обновлением провайдера, недостижим через общий аккаунт, пока кто-то не классифицирует его намеренно. Администраторская `policy` может только выключить: `allow` в профиле отвергается при загрузке, потому что оператор, написавший `allow`, считает, что расширил потолок.
|
|
845
|
+
Сервисный режим — не «read-only вообще», а жёсткий потолок: только `read`, только обычная чувствительность и только операции, которые провайдер пометил service-safe намеренно. Запись, админ-действия, управление правами и токенами и произвольный REST недостижимы, даже если сервисный токен наверху это умеет: классификация операции — свойство каталога провайдера, а не прав токена. Чувствительные чтения остаются личными: через общий аккаунт не читаются лог CI-джоба GitLab (`ci.logs.read`), лог сборки TeamCity (`logs.read`) и текст артефакта (`artifacts.read`), тело вложения Test IT и Confluence, содержимое Диска Bitrix24, переписки и открытые линии Bitrix24, календарь занятости и справочник сотрудников с телефонами, а конфиденциальная задача GitLab не возвращается вовсе — прямое чтение отвечает `ResourceNotFound`, из выдачи и из поиска она выпадает, а поиск по комментариям (`scope: notes`) отказывается целиком: у комментария нет признака конфиденциальности, и проверить его родителя одним запросом нельзя. У Weblate, где нет операций уровня журналов, чувствительных чтений нет вовсе. Операция, которую провайдер не классифицировал, отклоняется по умолчанию: инструмент, добавленный обновлением провайдера, недостижим через общий аккаунт, пока кто-то не классифицирует его намеренно. Администраторская `policy` может только выключить: `allow` в профиле отвергается при загрузке, потому что оператор, написавший `allow`, считает, что расширил потолок.
|
|
807
846
|
|
|
808
|
-
Граница ресурсов нужна потому, что сервисный аккаунт видит больше, чем один пользователь. В сервисном режиме провайдер сверяет с allowlist каждый вызов: проект, названный по id или по пути, должен быть в списке или под перечисленной группой; сборка TeamCity, названная по id, сначала разрешается в свой проект;
|
|
847
|
+
Граница ресурсов нужна потому, что сервисный аккаунт видит больше, чем один пользователь. В сервисном режиме провайдер сверяет с allowlist каждый вызов: проект, названный по id или по пути, должен быть в списке или под перечисленной группой; сборка TeamCity, названная по id, сначала разрешается в свой проект; страница Confluence, названная по id, — в своё пространство; задача Jira и запись Test IT — в свой проект; компонент Weblate — в свой проект-слаг; вебхук Bitrix24 обязан отвечать на портале, названном в границе, — других идентификаторов у границы этого провайдера нет. Листинг, не называющий ресурс, отказывается, а не отвечает всей картиной, доступной общему аккаунту. Списки (`gitlab_projects_list`, `teamcity_projects`, `projects.list` Weblate, `projects.list` Test IT) собираются из allowlist, а не из того, что видит сервисный токен: ресурс, которого токен не видит, приходит в `unavailableResources`, а не исчезает молча, — это и есть ответ оператору, что граница и токен разошлись. Разворачивая группу GitLab, провайдер просит только её собственные проекты (`with_shared=false`) и дополнительно сверяет каждый вернувшийся проект с границей: чужой проект, расшаренный в группу, в выдачу не попадает. Пользователь может сузить список в карточке кнопкой «Изменить доступ», но не расширить: выбор вне администраторского списка отбрасывается и не сохраняется.
|
|
809
848
|
|
|
810
849
|
Режим — одно из двух явных значений, `personal` или `service`; `auto` не существует. Отказ в личном режиме (`403` от GitLab или TeamCity) — это отказ: его не повторяют сервисным токеном, и наоборот тоже. Если личный токен был сохранён раньше, он остаётся зашифрованным в хранилище, но не тратится, пока подключение работает на сервисном; «Использовать личный аккаунт» возвращает его, а если личного токена не сохраняли, переключение отвечает `PersonalCredentialRequired` вместо подключения без личности. Переключение в любую сторону поднимает binding revision, поэтому всё, что было выведено из прежней личности, с этого момента недействительно.
|
|
811
850
|
|
|
@@ -852,7 +891,7 @@ credentialHelp:
|
|
|
852
891
|
instructions: Откройте внутреннюю страницу токенов.
|
|
853
892
|
selfHosted: true
|
|
854
893
|
jira:
|
|
855
|
-
enabled: false
|
|
894
|
+
enabled: false # спрятать подсказку; поле секрета остаётся
|
|
856
895
|
weblate:
|
|
857
896
|
docsLabel: Наша вики
|
|
858
897
|
```
|
|
@@ -1010,9 +1049,9 @@ $keyBytes = [Security.Cryptography.RandomNumberGenerator]::GetBytes(32)
|
|
|
1010
1049
|
|
|
1011
1050
|
Для TeamCity: оператор задаёт адрес сервера (`teamcity.serverUrl`) и политику адресов, пользователь создаёт в профиле access token (по возможности с «Limit per project» и read-правами) и вставляет только его. Если адрес не задан, карточка говорит об этом и формы не показывает; если адрес не проходит политику — конфигурация стенда падает при загрузке, а не отвечает отказом пользователю. Плагин прочитает `/app/rest/server` и `/app/rest/users/current`, покажет версию сервера и подключённого пользователя, а список возможностей останется в границах, которые разрешил оператор: сам TeamCity не сообщает, какие права выданы токену.
|
|
1012
1051
|
|
|
1013
|
-
Для Jira: оператор перечисляет сайты (`jira.sites`)
|
|
1052
|
+
Для Jira: оператор перечисляет сайты (`jira.sites`) и объявляет тип каждого (`deploymentType`). Пользователь выбирает сайт (если их несколько) и вставляет то, что этот сайт принимает: API-токен Atlassian вместе с e-mail для Cloud, личный токен доступа без почты для Server / Data Center. Плагин читает `myself` по API объявленного продукта (`/rest/api/3` или `/rest/api/2`), показывает подключённого пользователя и сайт, а также проверяет, что сайт отвечает именно этим продуктом — расхождение это отказ с подсказкой, какое значение поставить, а не молчаливая несовместимость. Кастомные поля задач приходят с именами из схемы сайта, а если прав на схему нет — с идентификаторами `customfield_*`.
|
|
1014
1053
|
|
|
1015
|
-
Для Confluence: оператор задаёт сайты (`confluence.instances`) и, если нужно, список разрешённых
|
|
1054
|
+
Для Confluence: оператор задаёт сайты (`confluence.instances`) с типом каждого (`deploymentType`) и, если нужно, список разрешённых пространств. Пользователь вводит то, что принимает его сайт: API token вместе с почтой аккаунта для Cloud, личный токен доступа без почты для Server / Data Center. Если сайт один, выбор не показывается; если сайтов нет, карточка говорит об этом и формы не показывает. Плагин прочитает текущего пользователя по API объявленного продукта (`/wiki/rest/api/user/current` или `/rest/api/user/current`), покажет подключённый аккаунт, а список возможностей останется в границах, которые разрешил оператор: сам Confluence не сообщает, какие права выданы токену.
|
|
1016
1055
|
|
|
1017
1056
|
Для Test IT: оператор перечисляет инсталляции (`testit.instances`), пользователь создаёт API-токен в своём профиле Test IT, выбирает инсталляцию (если их несколько) и вставляет токен. Плагин читает `GET /api/v2/projects` — документированный первый проверочный запрос: успешный ответ доказывает и адрес, и токен, а пустой список проектов остаётся валидным результатом. Имени аккаунта карточка не показывает: API v2 не сообщает владельца токена, поэтому подключение подписано инсталляцией и числом видимых проектов, а список возможностей остаётся в границах, которые разрешил оператор.
|
|
1018
1057
|
|
|
@@ -1027,4 +1066,3 @@ pnpm --filter @yadsh/dsh-qa-integrations check
|
|
|
1027
1066
|
```
|
|
1028
1067
|
|
|
1029
1068
|
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 из секции, которую сам зарегистрировал.
|
|
1030
|
-
|