Зашифрованные и дополнительные данные#

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

Перед началом#

• Подготовьте аккаунты, для которых нужно экспортировать, импортировать, редактировать или удалять данные.
• Если вы планируете импорт, убедитесь, что файл сохранен в формате .xlsx.
• Для массового импорта подготовьте AccountID для каждого аккаунта, чтобы Afina могла автоматически сопоставить строки с профилями.
• Для работы с зашифрованными данными сессия Afina должна быть разблокирована мастер-паролем. Без разблокированной сессии система не сможет расшифровать локальное хранилище для выполнения сценариев или работы через API.

Разница между типами данных#

Дополнительные данные — это обычные текстовые переменные в формате ключ → значение. Их удобно использовать для общих параметров автоматизации, а сами данные хранятся в открытом виде и видны через API.

Зашифрованные данные также работают в формате ключ → значение, но предназначены для чувствительной информации. Они хранятся в зашифрованном виде, не возвращаются через API как открытый текст и расшифровываются локально в RPA executor непосредственно перед выполнением нужного шага сценария.

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

Использование через API и сценарии#

Через API можно создавать, обновлять и удалять как дополнительные данные, так и зашифрованные данные. Для этого Afina использует параметр, который определяет тип переменной: обычная она или зашифрованная.

Разница заключается в видимости значений:

• Дополнительные данные видны через API в открытом виде, поэтому их не стоит использовать для паролей, seed-фраз, приватных ключей или 2FA-секретов.
• Зашифрованные данные можно записать или обновить через API, но их расшифрованный текст не возвращается через API, MCP-агента или чат с агентом.
• В RPA-скриптах и JS-модулях оба типа данных вызываются одинаково — через синтаксис ${key}. Для зашифрованных данных Afina подставляет значение локально в момент выполнения.

Экспорт данных#

1. Перейдите в раздел Аккаунты.
2. Выберите нужные профили с помощью чекбоксов.
3. Нажмите иконку ⋮ на верхней панели.
4. Выберите пункт Скачать дополнительные данные (Excel) или Скачать зашифрованные данные (Excel).

На скриншоте показан раздел Аккаунты с выбранными профилями и открытым меню иконки ⋮, в котором доступны пункты Скачать дополнительные данные (Excel) и Скачать зашифрованные данные (Excel).

5. В системном окне укажите папку для сохранения.
6. Подтвердите действие в системном окне.

На скриншоте ниже показано системное окно сохранения файла, в котором нужно выбрать папку и подтвердить экспорт.

После экспорта Afina создаст XLSX-файл с обязательными колонками AccountName и AccountID, а также со столбцами ваших ключей и значений.

Экспортированный XLSX-файл можно использовать как ориентир для дальнейшего импорта, если вам нужно массово обновить существующие данные или подготовить новый файл по тому же принципу.

Формат шаблона#

Шаблон для импорта имеет формат XLSX. В нем колонки — это названия ключей, а строки — значения для конкретных аккаунтов.

В файле должны быть:

• AccountID для сопоставления строки с конкретным аккаунтом.
• AccountName как служебная колонка для удобной идентификации аккаунта.
• Отдельные колонки с названиями ваших ключей.

Не переименовывайте и не удаляйте служебные колонки AccountID и AccountName. Если изменить базовую структуру шаблона или загрузить файл в другом формате, импорт может быть заблокирован ошибкой.

Каждая строка в шаблоне соответствует одному аккаунту. В ячейках этой строки нужно указать значения для тех ключей, которые вы хотите добавить или обновить.

Самый надежный способ подготовить файл — сначала нажать Скачать шаблон в разделе Доп. данные или Зашифрованные данные, а если нужно сверить структуру уже существующих данных аккаунтов — сначала выполнить экспорт из раздела Аккаунты.

На скриншоте ниже показан пример шаблона XLSX с колонкой AccountID, колонкой AccountName и отдельными колонками ключей.

Импорт данных#

Для импорта можно использовать один из двух вариантов: скачать готовый шаблон в разделе Доп. данные или Зашифрованные данные либо взять XLSX-файл, который вы ранее экспортировали из раздела Аккаунты, и заполнить или обновить его.

1. Перейдите в раздел Автоматизация.
2. Откройте раздел Доп. данные или Зашифрованные данные.
3. Нажмите кнопку Скачать шаблон.
4. Заполните файл .xlsx: используйте колонки как названия ключей.
5. Заполните строки значениями для конкретных аккаунтов по их AccountID.
6. Перетащите готовый .xlsx файл в область загрузки файла или выберите его через проводник.
7. Проверьте данные в таблице превью, которую откроет Afina.
8. Если строка не привязалась автоматически, выберите аккаунт вручную в столбце «Название аккаунта».
9. Нажмите Сохранить данные.

На скриншоте показан раздел Автоматизация с открытым разделом Доп. данные или Зашифрованные данные, кнопкой Скачать шаблон и областью загрузки файла .xlsx.

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

Если вы импортируете зашифрованные данные, Afina автоматически защитит их при записи в базу. В пользовательской документации для этого процесса указан алгоритм AES-256-CBC.

Что происходит при совпадении данных#

Если вы импортируете файл, в котором для определенного аккаунта уже существует такой же ключ, Afina заменит старое значение новым из файла. Это означает, что при совпадении ключей действует логика замены в пользу нового значения.

Если в файле есть новые ключи, которых раньше не было для аккаунта, Afina добавит их как новые пары ключ → значение.

Если в файле нет определенных ключей, которые уже существуют в аккаунте, Afina не удалит их автоматически. Импорт работает как объединение новых и старых данных: новые ключи добавляются, а совпадающие ключи перезаписываются значениями из файла.

Если вы хотите обновить только часть данных, оставьте в файле только те ключи и значения, которые нужно добавить или заменить. Для удаления используйте ручное или массовое удаление в интерфейсе Afina.

Добавление, редактирование и удаление данных#

1. Перейдите в раздел Аккаунты.
2. Нажмите ⋮ рядом с названием профиля.
3. Выберите Дополнительные данные или Зашифрованные данные.
4. Нажмите Добавить ещё ключ, если нужно вручную добавить новую пару ключ → значение для одного аккаунта.
5. Заполните ключ и значение в новой строке.
6. Измените существующие значения или скройте их иконкой глаза.
7. Нажмите ✖️ в строке ключа, если нужно удалить отдельную запись.
8. Выберите аккаунты чекбоксами, откройте меню ⋮ на верхней панели и выберите Удалить дополнительные данные или Удалить зашифрованные данные, если нужно массовое удаление.

Массовое удаление стирает именно дополнительные или зашифрованные данные выбранных аккаунтов. Профили, cookies и открытые вкладки при этом не удаляются.

На скриншоте показано меню ⋮ рядом с профилем, в котором можно открыть Дополнительные данные или Зашифрованные данные для конкретного аккаунта.

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

Отдельный скриншот ниже показывает массовое удаление через верхнюю панель в разделе Аккаунты.

Важные правила формата#

• Название ключей должно содержать только латинские буквы A-Z и a-z, цифры 0-9 и знак подчеркивания _.
• Не используйте пробелы или специальные символы в названиях ключей.
• Пустые ключи или значения не сохраняются.
• Не дублируйте названия столбцов с ключами в одном XLSX-файле. Официальная документация не описывает отдельную логику для дублированных ключей, поэтому лучше держать одну колонку для одного ключа.

Результат#

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