Настройка коннектора Slack

Настройте коннектор Slack, чтобы подключить Workflows к рабочему пространству Slack. С этим соединением ваша команда сможет получать автоматические уведомления, обрабатывать запросы на одобрение и реагировать на инциденты, не покидая Slack.

Предварительные требования

Доступ к рабочему пространству Slack.
Разрешения на создание и установку приложения в рабочем пространстве Slack.

Настройка коннектора Slack

1. Добавьте новый шаблон хоста во внешних запросах

Внешние запросы включают исходящие сетевые подключения из вашей среды Ключ-АСТРОМ к внешним сервисам. Они позволяют управлять доступом к публичным конечным точкам из AppEngine с помощью функций приложений и функций в Дашбордах, Блокнотах и Автоматизациях.

Перейдите в Настройки > Общие > Внешние запросы. Выберите Новый шаблон хоста. Добавьте доменные имена. Выберите Добавить. Таким образом можно детально управлять веб-сервисами, к которым могут подключаться ваши функции.

2. Предоставьте разрешения Workflows

Workflows требуют определённых разрешений для выполнения действий от вашего имени. Другие разрешения требуются для действий, входящих в состав коннектора Slack. Чтобы точно настроить разрешения, предоставленные Workflows:

Перейдите в Workflows и выберите Настройки > Настройки авторизации.
Выберите следующие разрешения в дополнение к общему разрешению Workflows.
- app-settings:objects:read
- app-settings:objects:write
- state:app-states:read
- state:app-states:write
- state:app-states:delete
- state:user-app-states:read
- state:user-app-states:write
- state:user-app-states:delete

Подробнее об общих разрешениях пользователей Workflows см. в разделе Управление разрешениями Workflow.

3. В Slack: создайте приложение

Чтобы действия коннектора Slack могли взаимодействовать с вашим рабочим пространством Slack, сначала нужно создать приложение для Ключ-АСТРОМ в Slack и авторизовать его подключение.

1. Перейдите на Slack API и выберите Create an App. 2. В окне Create an app выберите From an app manifest. 3. В окне Pick a workspace to develop your app выберите рабочее пространство Slack, к которому хотите подключиться, и выберите Next. 4. В окне Enter app manifest below вставьте манифест JSON, приведённый ниже, на вкладку JSON. Замените name и display_name на значения по вашему выбору, например Astromkey. 5. Выберите Install to Workspace и подтвердите разрешения. 6. Теперь приложение должно быть доступно в рабочем пространстве Slack.

Манифест Slack со всеми необходимыми разрешениями

{
  "_metadata": {
    "major_version": 2,
    "minor_version": 1
  },
  "display_information": {
    "name": ""
  },
  "features": {
    "bot_user": {
      "display_name": "",
      "always_online": false
    }
  },
  "oauth_config": {
    "scopes": {
      "bot": [
        "channels:join",
        "channels:read",
        "groups:read",
        "chat:write",
        "chat:write.public",
        "files:read",
        "files:write",
        "reactions:read",
        "reactions:write",
        "users:read.email"
      ]
    }
  },
  "settings": {
    "org_deploy_enabled": false,
    "socket_mode_enabled": false,
    "token_rotation_enabled": false
  }
}

Если вам нужно только отправлять простые текстовые или Markdown-сообщения в каналы и не требуются вложения файлов, emoji-реакции или одобрения Workflow, можно использовать меньший набор разрешений, чтобы уменьшить риск раскрытия токена и упростить одобрение администратором рабочего пространства. Минимальный манифест для базовых уведомлений

{
  "_metadata": {
    "major_version": 2,
    "minor_version": 1
  },
  "display_information": {
    "name": ""
  },
  "features": {
    "bot_user": {
      "display_name": "",
      "always_online": false
    }
  },
  "oauth_config": {
    "scopes": {
      "bot": [
        "channels:read",
        "groups:read",
        "chat:write"
      ]
    }
  },
  "settings": {
    "org_deploy_enabled": false,
    "socket_mode_enabled": false,
    "token_rotation_enabled": false
  }
}

4. В Ключ-АСТРОМ: авторизуйте подключение к Slack

Ваш коннектор Slack для Ключ-АСТРОМ требует токен OAuth для авторизации отправки сообщений в Slack.

1. Перейдите на Slack API, выберите Your Apps в правом верхнем углу и выберите приложение, которое вы создали. 2. Перейдите в Features > OAuth & Permissions. Если вы администратор рабочего пространства, вы сможете скопировать токен OAuth для вашего рабочего пространства. В противном случае вам нужно будет запросить установку. После того как администратор включит ваше приложение, вы также получите доступ к токену OAuth. 3. Скопируйте токен OAuth. 4. Вернитесь в Ключ-АСТРОМ, перейдите в Настройки и выберите Соединения > Slack. 5. Выберите Соединение, задайте имя вашему соединению Slack и вставьте токен OAuth в Bot token. 6. Выберите Создать. Ваше соединение Slack теперь отображается в обзоре соединений.

5. Включите внешние одобрения (необязательно)

Когда Signing Secret не настроен или Разрешить внешние одобрения отключено, действие «Запрос на одобрение» отправляет ссылку на одобрение через сообщение Slack. Чтобы полностью использовать действие «Запрос на одобрение» из коннектора Slack:

1. Отредактируйте соединение, выбрав > Редактировать. 2. Включите переключатель Принимать внешние одобрения. 3. Перейдите на Slack API, выберите Your Apps в правом верхнем углу и выберите приложение, которое вы создали. 4. Скопируйте Signing Secret. 5. Вставьте Signing Secret в поле Signing Secret. 6. Выберите Создать. 7. Скопируйте Webhook URL. 8. Вернитесь к приложению на странице Slack API. 9. Перейдите в Features > Interactivity & Shortcuts. 10. Включите интерактивность для приложения. 11. Вставьте Webhook URL в поле Request URL. 12. Вернитесь в Ключ-АСТРОМ и выберите Сохранить, чтобы сохранить соединение. 13. Перейдите в Настройки > Общие > Запросы на одобрение Workflow и выберите Разрешить внешних одобряющих.

Необходимые разрешения Slack-бота

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

Вариант использования	Необходимые области действия
Отправка сообщений в каналы	`chat:write`, `channels:read`, `groups:read`, опционально `chat:write.public`
Автоматическое присоединение к публичным каналам, если бот ещё не участник	`channels:join`
Загрузка вложений файлов с сообщениями	`files:write`, `files:read`
Добавление emoji-реакций к сообщениям	`reactions:write`
Отправка запросов на одобрение в каналы	`chat:write`, `channels:read`, `groups:read`, опционально `chat:write.public`

После добавления или изменения областей действия на странице Slack API в разделе OAuth & Permissions переустановите приложение, чтобы перегенерировать токен бота с обновлёнными областями действия. Затем обновите токен в Ключ-АСТРОМ в разделе Настройки > Соединения > Коннекторы > Slack.

Аноним

Поиск

Настройка коннектора Slack

Пространства имён

Ещё

Действия на странице

Содержание

Настройка коннектора Slack

Предварительные требования