@yadsh/dsh-qa-integrations 0.6.0 → 0.7.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 +309 -288
- 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 +97 -129
- 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 +95 -127
- 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 +2825 -785
- package/lib/client.js.map +1 -1
- package/lib/index.js +192 -51
- 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 +85 -14
- package/lib/providers/bitrix24/config.js.map +1 -1
- package/lib/providers/bitrix24/index.js +113 -0
- package/lib/providers/bitrix24/index.js.map +1 -1
- package/lib/providers/confluence/catalog.js +51 -3
- package/lib/providers/confluence/catalog.js.map +1 -1
- package/lib/providers/confluence/index.js +293 -35
- package/lib/providers/confluence/index.js.map +1 -1
- package/lib/providers/confluence/operations.js +1 -1
- package/lib/providers/confluence/operations.js.map +1 -1
- package/lib/providers/jira/catalog.js +73 -3
- package/lib/providers/jira/catalog.js.map +1 -1
- package/lib/providers/jira/index.js +266 -12
- package/lib/providers/jira/index.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/index.js +277 -3
- package/lib/providers/testit/index.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/index.js +243 -5
- package/lib/providers/weblate/index.js.map +1 -1
- package/lib/shared/settings.js +14 -0
- package/lib/shared/settings.js.map +1 -0
- package/lib/typert.host.js +148 -56
- package/lib/typert.remote-client.d.ts +13 -11
- package/lib/typert.remote-client.js +89 -50
- package/lib/types/broker.d.ts +11 -3
- package/lib/types/client/bitrix24.d.ts +24 -2
- package/lib/types/client/confluence.d.ts +19 -3
- 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 +20 -3
- 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/index.d.ts +81 -13
- 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 +36 -1
- package/lib/types/providers/confluence/catalog.d.ts +11 -3
- package/lib/types/providers/confluence/index.d.ts +61 -7
- package/lib/types/providers/confluence/operations.d.ts +2 -0
- package/lib/types/providers/jira/catalog.d.ts +13 -0
- package/lib/types/providers/jira/index.d.ts +48 -1
- package/lib/types/providers/testit/catalog.d.ts +12 -0
- package/lib/types/providers/testit/index.d.ts +61 -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/package.json +4 -4
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,39 +121,38 @@ 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
|
|
|
@@ -152,18 +161,19 @@ CRM:
|
|
|
152
161
|
Кастомные поля фильтруются **по 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`, не больше десяти совпадений) и подставляет accountId в запрос, потому что Jira Cloud фильтрует именно по нему. Имя, которое никого не нашло, и имя, которое нашли несколько человек, — это отказ с подсказкой, а не пустая страница: «нет задач» и «фильтр не понят» — разные ответы. Ответ справочника модели не показывается, он только определяет 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,15 +217,15 @@ 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
|
|
|
@@ -225,24 +235,27 @@ Confluence, как и TeamCity, не сообщает через API, какие
|
|
|
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
|
|
|
@@ -321,21 +337,23 @@ TeamCity, в отличие от GitLab и Bitrix24, не сообщает че
|
|
|
321
337
|
|
|
322
338
|
Подключение — API-токен Atlassian и e-mail аккаунта, которому он принадлежит: Jira Cloud аутентифицирует такой токен через HTTP Basic (`email:token`). Сайты задаёт оператор в конфигурации развёртывания (`jira.sites`) — пользователь выбирает сайт из списка и вводит e-mail с токеном, произвольный хост ввести нельзя. Возможность появляется у пользователя, если её включил оператор (`jira.*Read`).
|
|
323
339
|
|
|
324
|
-
| Возможность
|
|
325
|
-
|
|
|
326
|
-
| `identity.read`
|
|
327
|
-
| `issues.read`
|
|
328
|
-
| `comments.read`
|
|
329
|
-
| `attachments.read` | Метаданные вложений задачи: имя, тип, размер, автор
|
|
330
|
-
| `transitions.read` | Доступные переходы статуса и их обязательные поля
|
|
331
|
-
| `projects.read`
|
|
332
|
-
| `fields.read`
|
|
340
|
+
| Возможность | Что открывает |
|
|
341
|
+
| ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
|
|
342
|
+
| `identity.read` | Подключённый пользователь Atlassian и сайт, на котором он работает |
|
|
343
|
+
| `issues.read` | Поиск задач со всем словарём фильтров (включая историю изменений задачи и разрешение имени в accountId) и карточка задачи с описанием, связями и кастомными полями |
|
|
344
|
+
| `comments.read` | Комментарии задачи, включая ограниченные (с пометкой видимости) |
|
|
345
|
+
| `attachments.read` | Метаданные вложений задачи: имя, тип, размер, автор |
|
|
346
|
+
| `transitions.read` | Доступные переходы статуса и их обязательные поля |
|
|
347
|
+
| `projects.read` | Карточка проекта |
|
|
348
|
+
| `fields.read` | Схема полей сайта, включая кастомные, — она же источник id для фильтра по кастомному полю |
|
|
333
349
|
|
|
334
350
|
Jira, как и TeamCity, не сообщает через API, какие права выданы конкретному API-токену: токен действует от имени пользователя и наследует его права целиком, а «проверить» записью провайдер не имеет права. Поэтому сужение идёт только по деплой-флагам оператора, а права аккаунта применяет сама Jira — отказ приходит как `ProviderPermissionDenied` (задача, проект или поле закрыты схемой прав, issue security level или схемой ролей), и провайдер никогда не пробует другой credential. Единственная проверка, которую провайдер делает сам при подключении, — тип развёртывания: сайт, который отвечает `deploymentType`, отличным от `Cloud`, отклоняется, потому что Data Center — другой API, и молча считать его совместимым спецификация запрещает.
|
|
335
351
|
|
|
336
352
|
Запись в surface отсутствует: создание, правка, назначение, комментарии и переходы ждут pending actions и карточки подтверждения; удаление, администрирование проектов и workflow, произвольный REST и скачивание содержимого вложений — тоже. Провайдер читает только объявленный allow-list эндпоинтов `/rest/api/3` (гейт пакета падает на любом пути вне него), а легаси-эндпоинт `/rest/api/3/search`, удалённый Atlassian, не используется: поиск идёт через `/rest/api/3/search/jql`.
|
|
337
353
|
|
|
338
|
-
|
|
354
|
+
### Сервисный токен Jira
|
|
355
|
+
|
|
356
|
+
Подключение может работать от сервисного токена развёртывания: профиль называет сайт, секрет — обычный API-токен Atlassian в Basic-паре, а граница ресурсов — `projects` (ключи проектов, сравнение без учёта регистра; числовой id засчитывается, если Jira отдала его в выдаче). Сервисному токену недоступны чтения вложений — даже список метаданий помечен чувствительным, потому что следующий естественный шаг агента — скачать файл. Фильтры JQL по имени человека в сервисном режиме отказывают целиком — это чтение корпоративного справочника, у которого нет проекта в границе, — а фильтры по accountId и `me` остаются. Задача, названная по ключу, сначала раскрывается в свой проект, и чтение с уровнем безопасности, который сервисный токен не проходит, отвечает `ResourceNotFound`, как для чужой задачи.
|
|
339
357
|
|
|
340
358
|
Адрес TeamCity задаёт оператор: сервер один на весь стенд, поэтому `teamcity.serverUrl` — обычная настройка развёртывания, а не поле формы. Пользователь вводит только токен, и токен тратится ровно по этому адресу. Рядом оператор задаёт **политику адресов**: какие адреса этот стенд готов набирать вообще (политика осталась от времён, когда адрес вводил пользователь, и закрывает переезд конфига на чужой хост).
|
|
341
359
|
|
|
@@ -344,12 +362,12 @@ teamcity:
|
|
|
344
362
|
enabled: true
|
|
345
363
|
serverUrl: https://teamcity.example.internal
|
|
346
364
|
network:
|
|
347
|
-
mode: allowlist
|
|
365
|
+
mode: allowlist # allowlist | trusted-private
|
|
348
366
|
allowedHosts:
|
|
349
367
|
- teamcity.example.internal
|
|
350
368
|
- "*.corp.example"
|
|
351
369
|
allowedCidrs:
|
|
352
|
-
- 10.20.0.0/16
|
|
370
|
+
- 10.20.0.0/16 # только для адресов, записанных цифрами
|
|
353
371
|
allowedPorts:
|
|
354
372
|
- 443
|
|
355
373
|
- 8111
|
|
@@ -373,7 +391,7 @@ teamcity:
|
|
|
373
391
|
```yaml
|
|
374
392
|
teamcity:
|
|
375
393
|
enabled: true
|
|
376
|
-
serverUrl: https://teamcity.example.internal
|
|
394
|
+
serverUrl: https://teamcity.example.internal # один адрес на весь стенд
|
|
377
395
|
network:
|
|
378
396
|
mode: allowlist
|
|
379
397
|
allowedHosts: [teamcity.example.internal]
|
|
@@ -389,12 +407,12 @@ teamcity:
|
|
|
389
407
|
investigationsRead: true
|
|
390
408
|
agentsRead: true
|
|
391
409
|
artifactsRead: true
|
|
392
|
-
maxLogLines: 1000
|
|
393
|
-
maxLogBytes: 262144
|
|
394
|
-
defaultArtifactBytes: 262144
|
|
395
|
-
maxArtifactBytes: 1048576
|
|
396
|
-
streamTimeoutMs: 30000
|
|
397
|
-
retries: 2
|
|
410
|
+
maxLogLines: 1000 # потолок строк в ответе по логу
|
|
411
|
+
maxLogBytes: 262144 # сколько лога вообще скачиваем
|
|
412
|
+
defaultArtifactBytes: 262144 # бюджет чтения артефакта по умолчанию
|
|
413
|
+
maxArtifactBytes: 1048576 # жёсткий потолок чтения артефакта
|
|
414
|
+
streamTimeoutMs: 30000 # таймаут для логов и артефактов
|
|
415
|
+
retries: 2 # повторы для 429/5xx и сетевых сбоев
|
|
398
416
|
```
|
|
399
417
|
|
|
400
418
|
Токен создаётся в TeamCity (Profile → Access Tokens), при желании с «Limit per project» и read-правами, вводится один раз в карточке и шифруется тем же конвертным хранилищем, что и остальные секреты.
|
|
@@ -422,7 +440,7 @@ teamcity:
|
|
|
422
440
|
```yaml
|
|
423
441
|
confluence:
|
|
424
442
|
enabled: true
|
|
425
|
-
allowInsecureHttp: false
|
|
443
|
+
allowInsecureHttp: false # только для dev-стенда
|
|
426
444
|
instances:
|
|
427
445
|
- id: company
|
|
428
446
|
label: Company
|
|
@@ -438,12 +456,12 @@ confluence:
|
|
|
438
456
|
commentsRead: true
|
|
439
457
|
attachmentsRead: true
|
|
440
458
|
versionsRead: true
|
|
441
|
-
allowedSpaces: []
|
|
442
|
-
defaultBodyChars: 20000
|
|
443
|
-
maxBodyChars: 60000
|
|
444
|
-
maxResults: 50
|
|
445
|
-
maxReplyParents: 10
|
|
446
|
-
retries: 2
|
|
459
|
+
allowedSpaces: [] # ключи пространств; пусто = все, что видит аккаунт
|
|
460
|
+
defaultBodyChars: 20000 # бюджет тела страницы по умолчанию
|
|
461
|
+
maxBodyChars: 60000 # потолок бюджета, который может попросить модель
|
|
462
|
+
maxResults: 50 # строк в ответе любого списка (потолок для limit)
|
|
463
|
+
maxReplyParents: 10 # сколько комментариев могут принести ответы
|
|
464
|
+
retries: 2 # повторы для 429/5xx и сетевых сбоев
|
|
447
465
|
```
|
|
448
466
|
|
|
449
467
|
API token выпускается в профиле Atlassian (`Manage profile → Security → API tokens`), вводится один раз в карточке и шифруется тем же конвертным хранилищем, что и остальные секреты. Если стенду нужен OAuth-аккаунт Atlassian общего вида, а не персональный токен, — это отдельная фаза.
|
|
@@ -463,7 +481,9 @@ API token выпускается в профиле Atlassian (`Manage profile
|
|
|
463
481
|
- **Rate limiting** (раздел «Rate limiting»): лимиты по principal, ресурсу и глобальные не считаются; вместо них — ограниченные размеры ответов и повторы с backoff для 429/5xx.
|
|
464
482
|
- **Семантический индекс** (раздел «Optional semantic index»), **webhooks** и **Confluence Data Center** (раздел «Compatibility») — не подключены: провайдер работает только с Confluence Cloud.
|
|
465
483
|
|
|
466
|
-
|
|
484
|
+
### Сервисный токен Weblate
|
|
485
|
+
|
|
486
|
+
Подключение может работать от сервисного токена развёртывания: профиль называет инстанс, секрет — обычный API-токен Weblate (префикс значения роли не играет), а граница ресурсов — `projects` (слаги проектов; компонент принадлежит проекту, поэтому чтение компонента сверяет его проект). Чувствительных чтений в каталоге нет: всё, что читает провайдер, — переводческие метаданные, а `changes.list` — собственный журнал изменений Weblate, а не сырой вывод VCS. Чтение, названное по id строки, сначала раскрывается в свой проект; скриншоты вне границы и с непроверяемым проектом из выдачи выпадают, а листинг проектов собирается из allowlist с `unavailableResources` для того, что токен не видит.
|
|
467
487
|
|
|
468
488
|
Инстансы Weblate задаёт только оператор: пользователь выбирает инстанс из списка и вставляет API-токен, произвольный хост ввести нельзя. Если инстанс один, выбор не показывается; если инстансов нет, карточка честно сообщает, что подключать нечего, и формы не показывает.
|
|
469
489
|
|
|
@@ -476,7 +496,7 @@ API token выпускается в профиле Atlassian (`Manage profile
|
|
|
476
496
|
```yaml
|
|
477
497
|
weblate:
|
|
478
498
|
enabled: true
|
|
479
|
-
allowInsecureHttp: false
|
|
499
|
+
allowInsecureHttp: false # только для dev-стенда
|
|
480
500
|
instances:
|
|
481
501
|
- id: corp
|
|
482
502
|
label: Corporate Weblate
|
|
@@ -496,9 +516,9 @@ weblate:
|
|
|
496
516
|
changesRead: true
|
|
497
517
|
statisticsRead: true
|
|
498
518
|
screenshotsRead: true
|
|
499
|
-
maxTextChars: 4000
|
|
500
|
-
maxPageSize: 100
|
|
501
|
-
retries: 2
|
|
519
|
+
maxTextChars: 4000 # символов одной строки, которую видит модель
|
|
520
|
+
maxPageSize: 100 # потолок страницы; по умолчанию провайдер просит 20
|
|
521
|
+
retries: 2 # повторы для 429/5xx и сетевых сбоев
|
|
502
522
|
```
|
|
503
523
|
|
|
504
524
|
Список инстансов принимает не больше 16 записей; id — строчные латинские буквы, цифры и дефисы (до 32 символов), без повторов; подпись по умолчанию — имя хоста. Опечатка в инстансе роняет загрузку конфига, а не выбрасывает инстанс молча: пользователь иначе получил бы провайдер, к которому нельзя подключиться, и никакого объяснения. Пустой список — это состояние, а не падение: провайдер зарегистрирован и бездействует, а отказывает форма подключения.
|
|
@@ -531,7 +551,7 @@ weblate:
|
|
|
531
551
|
```yaml
|
|
532
552
|
gitlab:
|
|
533
553
|
enabled: true
|
|
534
|
-
allowInsecureHttp: false
|
|
554
|
+
allowInsecureHttp: false # только для dev-стенда
|
|
535
555
|
instances:
|
|
536
556
|
- id: gitlab-com
|
|
537
557
|
label: GitLab.com
|
|
@@ -545,12 +565,12 @@ gitlab:
|
|
|
545
565
|
searchRead: true
|
|
546
566
|
issuesRead: true
|
|
547
567
|
mergeRequestsRead: true
|
|
548
|
-
ciMetadataRead: true
|
|
549
|
-
ciLogsRead: true
|
|
550
|
-
maxFileBytes: 131072
|
|
551
|
-
maxJobLogBytes: 262144
|
|
552
|
-
maxSearchResults: 50
|
|
553
|
-
retries: 2
|
|
568
|
+
ciMetadataRead: true # пайплайны, джобы, их статусы; прежний ciRead задаёт обе половины
|
|
569
|
+
ciLogsRead: true # содержимое лога джоба: только личный аккаунт
|
|
570
|
+
maxFileBytes: 131072 # сколько тела файла отдаём модели
|
|
571
|
+
maxJobLogBytes: 262144 # сколько лога джобы отдаём модели
|
|
572
|
+
maxSearchResults: 50 # потолок per page у поиска
|
|
573
|
+
retries: 2 # повторы для 429/5xx и сетевых сбоев
|
|
554
574
|
```
|
|
555
575
|
|
|
556
576
|
OAuth-приложение для GitLab не нужно: подключение идёт персональным токеном. Токен создаётся в GitLab (`User settings → Access tokens`) с read-scope, вводится один раз в карточке, шифруется тем же конвертным хранилищем, что и вебхук Bitrix24, и после сохранения не показывается и не копируется.
|
|
@@ -576,7 +596,7 @@ OAuth-приложение для GitLab не нужно: подключение
|
|
|
576
596
|
```yaml
|
|
577
597
|
jira:
|
|
578
598
|
enabled: true
|
|
579
|
-
allowInsecureHttp: false
|
|
599
|
+
allowInsecureHttp: false # только для dev-стенда
|
|
580
600
|
sites:
|
|
581
601
|
- id: company
|
|
582
602
|
label: company.atlassian.net
|
|
@@ -584,8 +604,8 @@ jira:
|
|
|
584
604
|
- id: sandbox
|
|
585
605
|
label: Sandbox
|
|
586
606
|
baseUrl: https://sandbox.atlassian.net
|
|
587
|
-
fieldAliases:
|
|
588
|
-
product: customfield_10010
|
|
607
|
+
fieldAliases: # имена кастомных полей ЭТОГО сайта: алиас → customfield_ id
|
|
608
|
+
product: customfield_10010 # id берётся из jira_get_fields; в репозитории их нет
|
|
589
609
|
identityRead: true
|
|
590
610
|
issuesRead: true
|
|
591
611
|
commentsRead: true
|
|
@@ -593,11 +613,11 @@ jira:
|
|
|
593
613
|
transitionsRead: true
|
|
594
614
|
projectsRead: true
|
|
595
615
|
fieldsRead: true
|
|
596
|
-
defaultSearchLimit: 20
|
|
597
|
-
maxSearchLimit: 100
|
|
598
|
-
maxCommentLimit: 100
|
|
599
|
-
maxTextChars: 20000
|
|
600
|
-
retries: 2
|
|
616
|
+
defaultSearchLimit: 20 # строк в ответе поиска, если модель не просила
|
|
617
|
+
maxSearchLimit: 100 # потолок страницы; больше Jira не отдаёт
|
|
618
|
+
maxCommentLimit: 100 # потолок страницы комментариев
|
|
619
|
+
maxTextChars: 20000 # бюджет одного описания, комментария или rich-поля
|
|
620
|
+
retries: 2 # повторы для 429/5xx и сетевых сбоев
|
|
601
621
|
```
|
|
602
622
|
|
|
603
623
|
OAuth-приложение для Jira не нужно: подключение идёт API-токеном. Токен создаётся в аккаунте Atlassian (`id.atlassian.com → Безопасность → API-токены`), вводится один раз в карточке и шифруется тем же конвертным хранилищем, что и остальные секреты — вместе с e-mail аккаунта, потому что Jira аутентифицирует пару `email:token`, а не токен отдельно. После сохранения ни то, ни другое не показывается и не копируется.
|
|
@@ -624,46 +644,46 @@ Test IT — система управления тестированием: те
|
|
|
624
644
|
и результаты. Все 22 инструмента только читают; каждый называет capability, и
|
|
625
645
|
выключенную оператором возможность агент не получает вовсе.
|
|
626
646
|
|
|
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`
|
|
647
|
+
| Tool | Что делает |
|
|
648
|
+
| -------------------------------- | ------------------------------------------------------------------- |
|
|
649
|
+
| `testit_connection_get` | К какой инсталляции подключено и видит ли токен проекты |
|
|
650
|
+
| `testit_projects` | Проекты с числом тест-кейсов, чек-листов и автотестов |
|
|
651
|
+
| `testit_project_get` | Карточка проекта: описание, счётчики, схема атрибутов |
|
|
652
|
+
| `testit_sections` | Разделы (папки) тест-библиотеки проекта |
|
|
653
|
+
| `testit_work_items` | Тест-кейсы, чек-листы и общие шаги проекта по фильтрам |
|
|
654
|
+
| `testit_work_item_get` | Тест-кейс целиком: шаги, предусловия, атрибуты, теги, вложения |
|
|
655
|
+
| `testit_work_item_history` | История изменений: кто что поменял, из чего в что |
|
|
656
|
+
| `testit_work_item_comments` | Комментарии к тест-кейсу |
|
|
657
|
+
| `testit_work_item_test_results` | История результатов тест-кейса по прогонам и конфигурациям |
|
|
658
|
+
| `testit_test_plans` | Тест-планы проекта со статусом и сроками |
|
|
659
|
+
| `testit_test_plan_get` | Карточка тест-плана |
|
|
660
|
+
| `testit_test_plan_summary` | Прогресс плана: тест-поинты, автоматизация, дефекты |
|
|
661
|
+
| `testit_test_runs` | Прогоны проекта по состояниям, датам и тест-плану |
|
|
662
|
+
| `testit_test_run_get` | Карточка прогона |
|
|
663
|
+
| `testit_test_run_results` | Что было в прогоне: тест-поинты с итогом и результатами |
|
|
664
|
+
| `testit_test_result_get` | Результат теста: шаги, длительность, сообщение, трейсы |
|
|
665
|
+
| `testit_test_result_attachments` | Метаданные вложений результата |
|
|
666
|
+
| `testit_attachment_metadata` | Метаданные вложения |
|
|
667
|
+
| `testit_attachment_text` | Текст небольшого текстового вложения (бинарные и архивы отбиваются) |
|
|
668
|
+
| `testit_auto_tests` | Автотесты проекта: класс, пространство имён, стабильность |
|
|
669
|
+
| `testit_auto_test_get` | Карточка автотеста: шаги, setup, teardown, последний результат |
|
|
670
|
+
| `testit_configurations` | Конфигурации проекта, в разрезе которых считаются результаты |
|
|
651
671
|
|
|
652
672
|
## Возможности и скопы Test IT
|
|
653
673
|
|
|
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` | Конфигурации проекта
|
|
674
|
+
| Возможность | Что открывает |
|
|
675
|
+
| --------------------- | ------------------------------------------------------------ |
|
|
676
|
+
| `projects.read` | Проекты и карточка проекта, проба подключения |
|
|
677
|
+
| `sections.read` | Разделы тест-библиотеки |
|
|
678
|
+
| `workItems.read` | Тест-кейсы, чек-листы, общие шаги |
|
|
679
|
+
| `history.read` | История изменений тест-кейса |
|
|
680
|
+
| `comments.read` | Комментарии тест-кейса |
|
|
681
|
+
| `testPlans.read` | Тест-планы, карточка и сводка |
|
|
682
|
+
| `testRuns.read` | Прогоны и карточка прогона |
|
|
683
|
+
| `testResults.read` | Результаты прогона, отдельный результат, история результатов |
|
|
684
|
+
| `autoTests.read` | Автотесты |
|
|
685
|
+
| `attachments.read` | Метаданные вложений и текст текстовых файлов |
|
|
686
|
+
| `configurations.read` | Конфигурации проекта |
|
|
667
687
|
|
|
668
688
|
Сужения по «выданным правам» здесь нет: API v2 не сообщает, какие права у
|
|
669
689
|
токена (в отличие от вебхука Bitrix24 с его scope и GitLab с
|
|
@@ -678,7 +698,9 @@ Test IT — система управления тестированием: те
|
|
|
678
698
|
по правилу «каждая операция каталога — GET». Что из-за этого недоступно и чем
|
|
679
699
|
заменено — в [SPEC-providers-testit.md](https://github.com/xarleyn/dsh-plugins/blob/main/plugins/dsh-qa-integrations/docs/SPEC-providers-testit.md).
|
|
680
700
|
|
|
681
|
-
|
|
701
|
+
### Сервисный токен Test IT
|
|
702
|
+
|
|
703
|
+
Подключение может работать от сервисного токена развёртывания: профиль называет инсталляцию, секрет — обычный API-токен, а граница ресурсов — `projects` (id проектов, точное сравнение — иерархии проектов у Test IT нет). Сервисному токену недоступны вложения целиком: даже метаданные не несут проект, поэтому глобальный id нечем сверить с границей — каталог отвечает отказом, а не молча; тело вложения чувствительно и в личном режиме читается только у маленьких текстовых файлов. Чтение, адресованное id (тест-кейс, план, прогон, результат), сначала раскрывается в свой проект, и чтение вне границы отказывает до обращения к собственно объекту; листинг `projects.list` собирается из allowlist, а не из того, что видит токен.
|
|
682
704
|
|
|
683
705
|
Test IT бывает облачный и self-hosted, поэтому адрес задаёт оператор стенда
|
|
684
706
|
списком инсталляций (`testit.instances`) — пользователь выбирает инсталляцию из
|
|
@@ -710,12 +732,12 @@ query и фрагмента, а хвостовой слэш снимается.
|
|
|
710
732
|
```yaml
|
|
711
733
|
testit:
|
|
712
734
|
enabled: true
|
|
713
|
-
allowInsecureHttp: false
|
|
735
|
+
allowInsecureHttp: false # лазейка для внутреннего стенда; в проде HTTPS
|
|
714
736
|
instances:
|
|
715
737
|
- id: cloud
|
|
716
738
|
label: Test IT Cloud
|
|
717
739
|
baseUrl: https://team.example.testit.software
|
|
718
|
-
projectsRead: true
|
|
740
|
+
projectsRead: true # флаги возможностей: выключенная не доходит до агента
|
|
719
741
|
sectionsRead: true
|
|
720
742
|
workItemsRead: true
|
|
721
743
|
historyRead: true
|
|
@@ -726,12 +748,12 @@ testit:
|
|
|
726
748
|
autoTestsRead: true
|
|
727
749
|
attachmentsRead: true
|
|
728
750
|
configurationsRead: true
|
|
729
|
-
defaultResults: 20
|
|
730
|
-
maxResults: 100
|
|
731
|
-
defaultAttachmentBytes: 262144
|
|
732
|
-
maxAttachmentBytes: 10485760
|
|
733
|
-
attachmentTimeoutMs: 30000
|
|
734
|
-
retries: 2
|
|
751
|
+
defaultResults: 20 # размер списка, когда модель не назвала лимит
|
|
752
|
+
maxResults: 100 # жёсткий потолок одного ответа-списка
|
|
753
|
+
defaultAttachmentBytes: 262144 # бюджет чтения вложения по умолчанию
|
|
754
|
+
maxAttachmentBytes: 10485760 # жёсткий потолок чтения вложения (10 MiB)
|
|
755
|
+
attachmentTimeoutMs: 30000 # таймаут скачивания вложения
|
|
756
|
+
retries: 2 # повторы для 429/5xx и сетевых сбоев
|
|
735
757
|
```
|
|
736
758
|
|
|
737
759
|
## Чего в Test IT-провайдере ещё нет
|
|
@@ -765,7 +787,7 @@ testit:
|
|
|
765
787
|
|
|
766
788
|
## Сервисные токены (managed service credentials)
|
|
767
789
|
|
|
768
|
-
Развёртывание может завести один read-only сервисный токен и разрешить подключениям работать от его имени: выпустить personal access token может не каждый — у подрядчика нет своей учётной записи в корпоративном GitLab, стажёру не выдали прав на токен, — а один централизованно сменяемый аккаунт снимает с пользователей и ротацию, и вопрос «чей это был доступ». Владелец токена — развёртывание: пользователь не может ни создать профиль, ни сменить секрет, ни выбрать профиль по id. Возможность реализована у
|
|
790
|
+
Развёртывание может завести один read-only сервисный токен и разрешить подключениям работать от его имени: выпустить personal access token может не каждый — у подрядчика нет своей учётной записи в корпоративном GitLab, стажёру не выдали прав на токен, — а один централизованно сменяемый аккаунт снимает с пользователей и ротацию, и вопрос «чей это был доступ». Владелец токена — развёртывание: пользователь не может ни создать профиль, ни сменить секрет, ни выбрать профиль по id. Возможность реализована у всех семи интеграций; классификация service-safe операций у каждой своя, и чувствительные чтения каждого провайдера перечислены в его разделе.
|
|
769
791
|
|
|
770
792
|
```yaml
|
|
771
793
|
managedServiceCredentials:
|
|
@@ -774,8 +796,8 @@ managedServiceCredentials:
|
|
|
774
796
|
profiles:
|
|
775
797
|
- id: gitlab-corp-readonly
|
|
776
798
|
provider: gitlab
|
|
777
|
-
instance: corp
|
|
778
|
-
label: QA GitLab Read-only
|
|
799
|
+
instance: corp # id из gitlab.instances
|
|
800
|
+
label: QA GitLab Read-only # псевдоним, который видит пользователь
|
|
779
801
|
credential:
|
|
780
802
|
type: pat
|
|
781
803
|
secretFile: /run/secrets/qa_gitlab_service_token
|
|
@@ -786,10 +808,10 @@ managedServiceCredentials:
|
|
|
786
808
|
groups:
|
|
787
809
|
- group/platform
|
|
788
810
|
policy:
|
|
789
|
-
gitlab.issues.read: deny
|
|
811
|
+
gitlab.issues.read: deny # только сужение; "allow" отвергается при загрузке
|
|
790
812
|
- id: teamcity-readonly
|
|
791
813
|
provider: teamcity
|
|
792
|
-
instance: teamcity
|
|
814
|
+
instance: teamcity # сервер TeamCity один, id фиксирован
|
|
793
815
|
label: QA TeamCity Read-only
|
|
794
816
|
credential:
|
|
795
817
|
type: personal_access_token
|
|
@@ -799,13 +821,13 @@ managedServiceCredentials:
|
|
|
799
821
|
- PLATFORM
|
|
800
822
|
```
|
|
801
823
|
|
|
802
|
-
`enabled` по умолчанию `false`: пока развёртывание не включило срез, о сервисном токене нет ни строчки — ни чекбокса в форме подключения, ни профилей, ни нового поведения. `defaultForNewConnections` решает, с какого режима начинается новое подключение. `resources` обязателен и проверяется при загрузке: профиль без границы — это общий аккаунт, который видит всё, что видит его владелец, и ровно этого возможность не допускает. Записи `resources` — те идентификаторы, которые принимает сам
|
|
824
|
+
`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
825
|
|
|
804
826
|
Новое подключение начинается на сервисном токене, когда профиль для выбранного инстанса есть и `defaultForNewConnections` включён (по умолчанию так): чекбокс «Использовать сервисный токен» в форме уже отмечен, поля токена нет вовсе, а кнопка называется «Подключить сервисный токен». Снятая галочка возвращает обычную форму с personal access token. У уже существующих подключений режим не меняется: он хранится в самом подключении, поэтому обновление стенда не переводит пользователя на общий аккаунт само. В подключённой карточке режим виден строкой «Сервисный аккаунт · управляется администратором», а рядом — «Изменить доступ» и «Использовать личный аккаунт».
|
|
805
827
|
|
|
806
|
-
Сервисный режим — не «read-only вообще», а жёсткий потолок: только `read`, только обычная чувствительность и только операции, которые провайдер пометил service-safe намеренно. Запись, админ-действия, управление правами и токенами и произвольный REST недостижимы, даже если сервисный токен наверху это умеет: классификация операции — свойство каталога провайдера, а не прав токена. Чувствительные чтения остаются личными: через общий аккаунт не читаются лог CI-джоба GitLab (`ci.logs.read`), лог сборки TeamCity (`logs.read`) и текст артефакта (`artifacts.read`), а конфиденциальная задача GitLab не возвращается вовсе — прямое чтение отвечает `ResourceNotFound`, из выдачи и из поиска она выпадает, а поиск по комментариям (`scope: notes`) отказывается целиком: у комментария нет признака конфиденциальности, и проверить его родителя одним запросом нельзя. Операция, которую провайдер не классифицировал, отклоняется по умолчанию: инструмент, добавленный обновлением провайдера, недостижим через общий аккаунт, пока кто-то не классифицирует его намеренно. Администраторская `policy` может только выключить: `allow` в профиле отвергается при загрузке, потому что оператор, написавший `allow`, считает, что расширил потолок.
|
|
828
|
+
Сервисный режим — не «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
829
|
|
|
808
|
-
Граница ресурсов нужна потому, что сервисный аккаунт видит больше, чем один пользователь. В сервисном режиме провайдер сверяет с allowlist каждый вызов: проект, названный по id или по пути, должен быть в списке или под перечисленной группой; сборка TeamCity, названная по id, сначала разрешается в свой проект;
|
|
830
|
+
Граница ресурсов нужна потому, что сервисный аккаунт видит больше, чем один пользователь. В сервисном режиме провайдер сверяет с 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
831
|
|
|
810
832
|
Режим — одно из двух явных значений, `personal` или `service`; `auto` не существует. Отказ в личном режиме (`403` от GitLab или TeamCity) — это отказ: его не повторяют сервисным токеном, и наоборот тоже. Если личный токен был сохранён раньше, он остаётся зашифрованным в хранилище, но не тратится, пока подключение работает на сервисном; «Использовать личный аккаунт» возвращает его, а если личного токена не сохраняли, переключение отвечает `PersonalCredentialRequired` вместо подключения без личности. Переключение в любую сторону поднимает binding revision, поэтому всё, что было выведено из прежней личности, с этого момента недействительно.
|
|
811
833
|
|
|
@@ -852,7 +874,7 @@ credentialHelp:
|
|
|
852
874
|
instructions: Откройте внутреннюю страницу токенов.
|
|
853
875
|
selfHosted: true
|
|
854
876
|
jira:
|
|
855
|
-
enabled: false
|
|
877
|
+
enabled: false # спрятать подсказку; поле секрета остаётся
|
|
856
878
|
weblate:
|
|
857
879
|
docsLabel: Наша вики
|
|
858
880
|
```
|
|
@@ -1027,4 +1049,3 @@ pnpm --filter @yadsh/dsh-qa-integrations check
|
|
|
1027
1049
|
```
|
|
1028
1050
|
|
|
1029
1051
|
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
|
-
|