Synchra.24
menu_bookDocumentación
Практические материалы по запуску и развитию

Здесь собраны инструкции по запуску, разработке внутренних сценариев и встраиванию собственных инструментов в рабочий контур компании.

folderAutomatización

Variables secretas y seguridad

Cómo almacenar tokens y contraseñas, sustituir secretos en URL y encabezados y conectar servicios externos de forma segura.

La traducción no está disponible. Se muestra el original.

Секретные переменные позволяют хранить токены, API-ключи и пароли отдельно от конфигурации. Одну переменную можно переиспользовать в нескольких автоматизациях компании.

Создание переменной

На экране Администратор → Автоматизации нажмите Секретные переменные, затем Добавить переменную.

Укажите:

Поле Требования
Имя От 2 до 64 символов. Начинается с латинской буквы; далее допустимы латинские буквы, цифры и _. Для удобства используйте заглавные буквы.
Значение Токен, API-ключ, пароль или другое закрытое значение. Не может быть пустым.

Примеры понятных имён:

ONE_C_API_TOKEN
CRM_CLIENT_SECRET
WAREHOUSE_API_KEY

После сохранения значение не показывается в интерфейсе. Его можно заменить через редактирование переменной, но нельзя прочитать обратно. В базе значение хранится в зашифрованном виде и отдельно для каждой компании.

Использование в конфигурации

Синтаксис ссылки:

${secrets.NAME}

Секрет можно подставить в URL и значения HTTP-заголовков.

Bearer-токен

headers:
  Authorization: "Bearer ${secrets.CRM_TOKEN}"

API-ключ

headers:
  X-API-Key: "${secrets.WAREHOUSE_API_KEY}"

Параметр URL

url: "https://api.example.com/export?token=${secrets.EXPORT_TOKEN}"

Если API использует Basic Authentication, заранее сохраните подготовленное значение авторизации и подставьте его в заголовок:

headers:
  Authorization: "Basic ${secrets.ONE_C_BASIC_AUTH}"

Где подстановка не работает

Секреты подставляются только:

  • в url источников и назначений;
  • в значения headers источников и назначений.

Они не подставляются в body, не передаются в input или context обработчика и недоступны из JavaScript. Если внешняя система требует токен внутри тела запроса, по возможности настройте передачу через заголовок. Не копируйте закрытое значение непосредственно в YAML, JSON или код.

Замена и удаление

Чтобы заменить токен без правки автоматизаций:

  1. Откройте Секретные переменные.
  2. Нажмите редактирование у нужного имени.
  3. Введите новое значение и сохраните.
  4. Выполните проверочный запуск связанных автоматизаций.

Все конфигурации, использующие это имя, начнут получать новое значение.

Перед удалением переменной найдите все ссылки ${secrets.NAME} в автоматизациях. После удаления запуск завершится ошибкой secret NAME is not configured.

Защита данных в результатах запуска

При формировании превью и логов система заменяет известные значения секретов на ***. Это дополнительная защита, но она не отменяет безопасную работу с данными:

  • не выводите токены и пароли через console.log;
  • не помещайте секреты в ответ источника или результат обработчика;
  • не используйте один токен для разных внешних систем;
  • выдавайте токену только необходимые права;
  • регулярно меняйте значения и отзывайте старые токены.

Сетевые ограничения

Автоматизации выполняются на сервере Synchra24. Для URL действуют следующие правила:

  • адрес должен быть абсолютным и начинаться с https:// или http://;
  • используйте HTTPS для передачи любых рабочих данных;
  • нельзя обращаться к локальным, служебным и закрытым сетевым адресам;
  • перенаправления проверяются и ограничены; внешняя система должна возвращать прямой безопасный адрес.

Если 1С или другая система доступна только во внутренней сети, потребуется безопасно опубликованный HTTPS endpoint или отдельный интеграционный шлюз. Не открывайте базу или административный интерфейс системы напрямую в интернет.

Минимальные права

Для каждого подключения создавайте отдельную техническую учётную запись:

  • источнику выдавайте только чтение нужных данных;
  • назначению — только запись в нужный метод или раздел;
  • ограничивайте доступ по IP, если внешняя система это поддерживает;
  • фиксируйте владельца и срок действия токена;
  • удаляйте переменную после отключения интеграции.

Для доступа к разделу автоматизаций у компании должна быть включена лицензионная возможность API-интеграция, а у пользователя — соответствующее право администратора.

Доступ к артефактам из сервисов

Чтение и запись существующих артефактов через сервис выполняются от текущего пользователя и компании с прежней проверкой лицензии API и права admin_edit_provider_integrations. Ключ сервиса не заменяет пользовательские права. Сервис не получает Bearer-токен или токен компании. В автоматизацию загружаются только явно подключённые имена и артефакты-источники, до 5 МиБ суммарно. Артефакты могут попасть в предпросмотр и логи: не храните в них секреты. Квоты и ограничения записи.

Безопасный перенос ZIP-шаблона

ZIP-шаблон не включает значения секретных переменных из хранилища, данные артефактов или историю запусков. Ссылки на них остаются в конфигурации; после импорта настройте ресурсы целевой компании. Содержимое YAML/JavaScript не очищается автоматически: не передавайте архив, если в исходниках прописаны реальные ключи или персональные данные. Импорт не выполняет сетевые запросы или обработчик и принудительно создаёт выключенную автоматизацию. Доступ проверяется по лицензии API и admin_edit_provider_integrations; ключи и флаги установленной записи в манифесте запрещены. Проверки архива и ограничения.

Общий бот MAX

Подключение общего бота выполняется через Автоматизации → Чаты MAX. Токен хранится на стороне платформы и не включается в пакет расширения или секретные переменные клиентов. Не отправляйте продавцу собственные ключи. Один ID чата не подтверждает право на отправку: нужно ввести одноразовый код, который бот прислал в этот чат. Подключения разных компаний проверяются отдельно.

Все участники чата увидят отправленные уведомления, поэтому выбирайте получателей с подходящим доступом. Названия инцидентов и другие данные, которые вы включили в сообщение, могут содержать чувствительную информацию. Кнопка-ссылка не заменяет права доступа в Synchra24. Бот обрабатывает команду /chatid для определения ID; обычные сообщения, переданные MAX во входящих обновлениях, сразу отбрасываются и не сохраняются. Удаление бота отзывает связь с чатом. Удаление подключения в Synchra24 останавливает будущую отправку через это имя, но не удаляет уже отправленные сообщения. Подключение и ограничения MAX.