Варианты и сценарии использования TFSX#
Варианты использования#
1. Передача файлов без нотификаций и проверок#
2. Передача файлов с нотификациями#
3. Передача файлов с использованием done-файла#
4. Передача файлов с нотификацией виде файловой квитанции от TFSX для Отправителя#
5. Передача файлов между отдельными локациями с контролем целостности и возможностью повторной отправки#
6. Передача файлов с проверкой на вирусы#
7. Передача файлов в FTRF в режиме «ftrfv1» с custom-заголовком#
8. Получение файлов от FTRF в режиме «ftrfv1»#
9. TFSX отправляет уведомление DeliveryConfirm о доставке файлов в FTRF#
10. TFSX получает уведомление DeliveryConfirm о доставке файлов от FTRF#
11. Использование механизма Rate Limit для защиты от превышения нагрузки#
12. Передача файлов с проверкой подписи и отправкой обратных квитанций#
13. Передача файлов без нотификаций в S3 хранилище, используя FSGW#
14. Передача файлов с нотификациями из S3 хранилища, используя FSGW#
15. Передача файлов FTRF -> TFSX в зависимости от применения сервиса ОТТ#
16. Передача файлов TFSX -> FTRF в зависимости от применения сервиса ОТТ#
Сценарии использования#
1. Передача файлов без нотификаций и проверок#
1.1 Основной сценарий:
АС Отправитель (АС1) выкладывает файл на файловый ресурс TFSX в общую папку TFSX и АС1.
Компонент TFSX перекладывает файл в общую папку TFSX и АС Получатель (АС2)
Компонент TFSX удаляет файл из общей папки TFSX и АС Отправитель.
1.2 Альтернативный сценарий не предусмотрен
1.3 Исключительный сценарий не предусмотрен
2. Передача файлов с нотификациями#
2.1 Основной сценарий:
АС Отправитель (АС1) выкладывает файл на файловый ресурс TFSX в общую папку TFSX и АС1, после чего отправляет JMS-уведомление о передаче файла.
Компонент TFSX перекладывает файл в общую папку TFSX и АС Получатель (АС2).
Компонент TFSX удаляет файл из общей папки TFSX и АС Отправитель.
Компонент TFSX отправляет JMS-уведомление о передаче файла в АС Получатель.
АС Получатель принимает файл в обработку, затем удаляет его из общей папки TFSX и АС Получатель.
После передачи файла АС Получатель уведомляет компонент TFSX о получении файла, для этого отправляет JMS-квитанцию со статусом доставки файла.
TFSX пересылает JMS-квитанцию в АС Отправитель.
АС Отправитель обрабатывает JMS-квитанцию.
2.2 Альтернативный сценарий не предусмотрен.
2.3 Исключительный сценарий 1:
АС Отправитель (АС1) выкладывает файл на файловый ресурс TFSX в общую папку TFSX и АС1, после чего отправляет JMS-уведомление о передаче файла.
Сообщение о передача файла не прошло валидацию.
Публикация сообщения об ошибке.
2.4 Исключительный сценарий 2:
АС Отправитель (АС1) выкладывает файл на файловый ресурс TFSX в общую папку TFSX и АС1, после чего отправляет JMS-уведомление о передаче файла.
Компонент TFSX перекладывает файл в общую папку TFSX и АС Получатель (АС2)
Ошибка передачи файла.
Публикация сообщения об ошибке.
3. Передача файлов с использованием done-файла#
3.1 Основной сценарий:
АС Отправитель (АС1) выкладывает файл на файловый ресурс TFSX в общую папку TFSX и АС1, после чего отправляет JMS-уведомление о передаче файла.
Компонент TFSX перекладывает файл в общую папку TFSX и АС Получатель (АС2)
Компонент TFSX удаляет файл из общей папки TFSX и АС Отправитель.
После того как файл полностью выложен, TFSX публикует done-файл. После обнаружения done-файла АС Получатель уведомляет о приеме файла, для этого отправляет файл-квитанцию со статусом приема файла.
Компонент TFSX получает файл квитанцию и отправляет JMS-уведомление о передаче файл-квитанции.
АС Отправитель обрабатывает JMS-квитанцию.
3.2 Альтернативный сценарий не предусмотрен.
3.3 Исключительный сценарий 1:
АС Отправитель (АС1) выкладывает файл на файловый ресурс TFSX в общую папку TFSX и АС1, после чего отправляет JMS-уведомление о передаче файла.
Сообщение о передача файла не прошло валидацию.
Публикация сообщения об ошибке.
3.4 Исключительный сценарий 2:
АС Отправитель (АС1) выкладывает файл на файловый ресурс TFSX в общую папку TFSX и АС1, после чего отправляет JMS-уведомление о передаче файла.
Компонент TFSX перекладывает файл в общую папку TFSX и АС Получатель (АС2)
Ошибка передачи файла.
Публикация сообщения об ошибке.
4. Передача файлов с нотификацией виде файловой квитанции от TFSX для Отправителя#
4.1 Основной сценарий:
АС Отправитель (АС1) выкладывает файл на файловый ресурс TFSX в общую папку TFSX и АС1.
Компонент TFSX перекладывает файл в общую папку TFSX и АС Получатель (АС2)
Компонент TFSX удаляет файл из общей папки TFSX и АС Отправитель.
Если в процессе передачи файла произошла ошибка, то TFSX выкладывает файловую квитанцию об ошибке в отдельную общую папку TFSX и Отправителя.
После завершения транзакции по передачи файла TFSX выкладывает файловую человекочитаемую квитанцию о результате передачи в отдельную общую папку TFSX и Отправителя.
4.2 Альтернативный сценарий не предусмотрен
4.3 Исключительный сценарий 1:
АС Отправитель (АС1) выкладывает файл на файловый ресурс TFSX в общую папку TFSX и АС1, после чего отправляет JMS-уведомление о передаче файла.
Сообщение о передача файла не прошло валидацию.
Публикация сообщения об ошибке.
4.4 Исключительный сценарий 2:
АС Отправитель (АС1) выкладывает файл на файловый ресурс TFSX в общую папку TFSX и АС1, после чего отправляет JMS-уведомление о передаче файла.
Компонент TFSX перекладывает файл в общую папку TFSX и АС Получатель (АС2)
Ошибка передачи файла.
Публикация сообщения об ошибке.
5. Передача файлов между двумя локациями с контролем целостности и механизмом повторной отправки#
5.1 Основной сценарий:
АС Отправитель (АС1) выкладывает файл на файловый ресурс TFSX1 в Локации1 в общую папку TFSX1 и АС1.
Компонент TFSX1 сохраняет копию исходного файла в под-папке .camel и перекладывает файл во внешнюю папку TFSX1_OUT, после чего отправляет JMS-уведомление о передаче файла с указанием контрольной суммы.
Компонент TFSX2 в Локации2 читает JMS-уведомление о передаче файла и ожидает файл в промежуточной папке TFSX2_IN, через публикацию в этой папке done-файла.
Файл передается между Локациями 1 и 2 - из TFSX1_OUT в TFSX2_IN любым допустимым способом.
Компонент TFSX2 при появлении во внешней папке TFSX2_IN файла соответствующего ожидаемому, проверяет его контрольную сумму.
Если контрольная сумма не совпадает, компонент TFSX2 отправляет JMS-запрос о повторной отправке файла.
Компонент TFSX1 получает запрос о повторной отправке, переносит исходный файл из под-папки .camel в общую папку TFSX1 и АС1 и переходит к п.2.
Если превышено предельное количество попыток повторной передачи, компонент TFSX1 публикует JMS-уведомление об ошибке передачи файла.
Если контрольная сумма совпадает, компонент TFSX2 перекладывает файл из TFSX2_IN в общую папку TFSX2 и АС Получатель (АС2)
Компонент TFSX2 отправляет JMS-квитанцию об успешном приеме файла.
Компонент TFSX2 отправляет JMS-запрос об удалении исходного файла в Локации1.
Компонент TFSX1 получает JMS-запрос и удаляет файл из общей папки TFSX1 и АС1 и из под-папки .camel
Компонент TFSX1 отправляет JMS-уведомление об успешном завершении операции.
АС Отправитель обрабатывает JMS-квитанцию.
5.2 Альтернативный сценарий не предусмотрен.
5.3 Исключительный сценарий не предусмотрен.
6. Передача файлов с проверкой на вирусы#
6.1 Основной сценарий:
АС Отправитель (АС1) выкладывает файл на файловый ресурс TFSX в общую папку TFSX и АС1.
Компонент TFSX обращается во внешний сервис для проверки файла на вирусы.
Если файл заражен, компонент TFSX удаляет файл.
Компонент TFSX перекладывает файл в общую папку TFSX и АС Получатель (АС2)
Компонент TFSX удаляет файл из общей папки TFSX и АС Отправитель.
6.2 Альтернативный сценарий не предусмотрен.
6.3 Исключительный сценарий 1:
АС Отправитель (АС1) выкладывает файл на файловый ресурс TFSX в общую папку TFSX и АС1.
Ошибка передачи файла.
Публикация сообщения об ошибке.
7. Передача файлов в FTRF в режиме «ftrfv1» с custom-заголовком#
7.1 Основной сценарий:
АС Отправитель (АС1) выкладывает файл на файловый ресурс TFSX в общую папку TFSX и АС1.
Компонент TFSX добавляет custom-заголовок «scenario-id» содержащий информацию о маршруте.
Компонент TFSX отправляет grpc нотификации в FTRF1.
FTRF1 получает уведомление от TFSX, выгружает файлы в облачное хранилище и отправляет grpc нотификации в FTRF2.
FTRF2 получает уведомление и отправляет в АС Получатель (АС2), о том что есть файлы готовые для выгрузки
АС Получатель (АС2) отправляет нотификацию в FTRF2 для получения файлов.
7.2 Альтернативный сценарий не предусмотрен.
7.3 Исключительный сценарий 1:
АС Отправитель (АС1) выкладывает файл на файловый ресурс TFSX в общую папку TFSX и АС1.
Ошибка передачи файла.
Публикация сообщения об ошибке.
8. Получение файлов от FTRF в режиме «ftrfv1»#
8.1 Основной сценарий:
АС Отправитель (АС1) отправляет grpc нотификацию в FTRF2.
FTRF2 получает уведомление от АС1, выгружает файлы в облачное хранилище и отправляет grpc нотификации в FTRF1.
FTRF1 получает уведомление и отправляет в TFSX, о том что есть файлы готовые для выгрузки
TFSX отправляет нотификацию в FTRF1 для получения файлов.
Компонент TFSX получает файлы и выкладывает файл на файловый ресурс TFSX в общую папку TFSX и АС2.
8.2 Альтернативный сценарий не предусмотрен.
8.3 Исключительный сценарий 1:
АС Отправитель (АС1) отправляет grpc нотификацию в FTRF2.
FTRF2 получает уведомление от АС1, выгружает файлы в облачное хранилище и отправляет grpc нотификации в FTRF1.
FTRF1 получает уведомление и отправляет в TFSX, о том что есть файлы готовые для выгрузки
TFSX отправляет нотификацию в FTRF1 для получения файлов.
Ошибка передачи файла.
Публикация сообщения об ошибке.
9. TFSX отправляет уведомление DeliveryConfirm о доставке файлов в FTRF#
9.1 Основной сценарий:
АС Отправитель (АС1) после получения файлов уведомляет TFSX о доставке файлов.
Компонент TFSX отправляет grpc нотификацию DeliveryConfirm о доставке файлов в FTRF1.
FTRF1 получает уведомление от TFSX и отправляет нотификацию в FTRF2.
FTRF2 получает уведомление о доставке файлов и отправляет в АС Получатель (АС2).
9.2 Альтернативный сценарий не предусмотрен.
9.3 Исключительный сценарий 1:
АС Отправитель (АС1) после получения файлов уведомляет TFSX о доставке файлов.
Ошибка передачи файла.
Публикация сообщения об ошибке.
10. TFSX получает уведомление DeliveryConfirm о доставке файлов от FTRF#
10.1 Основной сценарий:
АС Отправитель (АС1) после получения файлов уведомляет FTRF2 о доставке файлов.
FTRF2 получает уведомление от АС1 и отправляет нотификацию в FTRF1.
FTRF1 получает уведомление от FTRF2 и отправляет нотификацию в компонент TFSX.
TFSX получает уведомление о доставке файлов и уведомляет АС Получатель (АС2).
10.2 Альтернативный сценарий не предусмотрен.
10.3 Исключительный сценарий 1:
АС Отправитель (АС1) после получения файлов уведомляет FTRF2 о доставке файлов.
FTRF2 получает уведомление от АС1 и отправляет нотификацию в FTRF1.
FTRF1 получает уведомление от FTRF2 и отправляет нотификацию в компонент TFSX.
TFSX получает уведомление о доставке файлов и уведомляет АС Получатель (АС2).
Ошибка передачи файла.
Публикация сообщения об ошибке.
11. Использование механизма Rate Limit для защиты от превышения нагрузки#
11.1 Основной сценарий:
Автоматизированная система (АС Отправитель) отправляет файл на доставку в TFSX.
TFSX при доставке файла применяет ограничения на этот процесс в соответствиями с соответствующими политиками RateLimit
В случае попадания в пределы RateLimit файл доставляется АС Получателю.
В случае превышения RateLimit файл не доставляется. Файл остается лежать в папке Отправителя.
11.2 Альтернативный сценарий не предусмотрен.
11.3 Исключительный сценарий 1:
Автоматизированная система (АС Отправитель) отправляет файл на доставку в TFSX.
Ошибка передачи файла.
Публикация сообщения об ошибке.
Передача файлов с проверкой подписи и отправкой обратных квитанций
12. Передача файлов с проверкой подписи и отправкой обратных квитанций#
12.1 Основной сценарий:
Автоматизированная система (АС Отправитель) размещает файл на общий с TFSX файловый ресурс.
Компонент TFSX получает файл.
Компонент TFSX проверяет файл по маске.
Компонент TFSX проверяет наличие подписей у файла.
Компонент TFSX определяет количество подписей у файла.
Компонент TFSX проверяет подписи у файла.
Компонент TFSX публикует файл на общий с автоматизированной системой, АС Получатель, файловый ресурс.
АС Получатель отправляет в компонент TFSX квитанцию о получении файла.
Компонент TFSX отправляет обратную квитанцию о доставке фала АС Отправителю.
12.2 Альтернативный сценарий не предусмотрен.
12.3 Исключительный сценарий 1:
Компонент TFSX проверяет файл по маске.
Файл не соответствует маске.
Отправка квитанции об ошибке.
12.4 Исключительный сценарий 2:
Компонент TFSX проверяет файл по маске.
Файл не подписан.
Отправка квитанции об ошибке.
12.5 Исключительный сценарий 3:
Компонент TFSX проверяет файл по маске.
Число подписей в файле менее 2.
Отправка квитанции об ошибке.
12.6 Исключительный сценарий 4:
Компонент TFSX проверяет файл по маске.
Подпись не зарегистрирована.
Отправка квитанции об ошибке.
Дополнительная информация#
В случае если логируется ошибка с кодом 104 - ошибка смежной системы, через 24 часа файл удаляется.
13. Передача файлов без нотификаций в S3 хранилище, используя FSGW#
13.1 Основной сценарий:
АС Отправитель (АС1) выкладывает файл на файловый ресурс TFSX в общую папку TFSX и АС1.
Компонент TFSX перекладывает файл в S3 хранилище, используя FSGW в качестве прозрачного шлюза, в бакет АС Получателя (АС2)
Компонент TFSX удаляет файл из общей папки TFSX и АС Отправитель.
13.2 Альтернативный сценарий не предусмотрен
13.3 Исключительный сценарий не предусмотрен
14. Передача файлов с нотификациями из S3 хранилища, используя FSGW#
14.1 Основной сценарий:
АС Отправитель (АС1) выкладывает файл в бакет S3 хранилища АС1, после чего отправляет JMS-уведомление о передаче файла.
Компонент TFSX перекладывает файл из S3 хранилища, используя FSGW в качестве прозрачного шлюза, в общую папку TFSX и АС Получатель (АС2).
Компонент TFSX удаляет файл из бакета АС Отправителя.
Компонент TFSX отправляет JMS-уведомление о передаче файла в АС Получатель.
АС Получатель принимает файл в обработку, затем удаляет его из общей папки TFSX и АС Получатель.
После передачи файла АС Получатель уведомляет компонент TFSX о получении файла, для этого отправляет JMS-квитанцию со статусом доставки файла.
TFSX пересылает JMS-квитанцию в АС Отправитель.
АС Отправитель обрабатывает JMS-квитанцию.
14.2 Альтернативный сценарий не предусмотрен
14.3 Исключительный сценарий
АС Отправитель (АС1) выкладывает файл в бакет S3 хранилища АС1, после чего отправляет JMS-уведомление о передаче файла.
Сообщение о передача файла не прошло валидацию.
Публикация сообщения об ошибке.
15. Передача файлов FTRF -> TFSX в зависимости от применения сервиса ОТТ#
15.1 Основной сценарий:
АС Отправитель (АС1), с помощью FTRF, выкладывает зашифрованный файл в бакет S3 хранилища АС1.
АС1, с помощью FTRF, отправляет grpc нотификацию в TFSX.
Компонент TFSX анализирует наличие настроек ОТТ и наличие tokenResult в grpc нотификации.
Компонент TFSX, при наличии ОТТ и tokenResult, извлекает симметричный ключ из encMessage.
Компонент TFSX скачивает файл из s3-хранилища и расшифровывает его симметричным ключем.
Компонент TFSX перекладывает расшифрованный файл в общую папку TFSX и АС Получатель (АС2).
TFSX отправляет JMS-квитанцию в АС1 со статусом доставки (если необходимо).
АС1 обрабатывает JMS-квитанцию.
Компонент TFSX отправляет JMS-уведомление о передаче файла в АС2.
АС2 принимает файл в обработку, затем удаляет его из общей папки TFSX и АС2.
15.2 Альтернативный сценарий:
АС Отправитель (АС1), с помощью FTRF, выкладывает зашифрованный файл в бакет S3 хранилища АС1.
АС1, с помощью FTRF, отправляет grpc нотификацию в TFSX.
Компонент TFSX анализирует наличие настроек ОТТ и наличие tokenResult в grpc нотификации.
Компонент TFSX, при отсутствии ОТТ или tokenResult, извлекает симметричный ключ в открытом виде из encMessage.
Компонент TFSX скачивает файл из s3-хранилища и расшифровывает его симметричным ключем.
Компонент TFSX перекладывает расшифрованный файл в общую папку TFSX и АС Получатель (АС2).
TFSX отправляет JMS-квитанцию в АС1 со статусом доставки (если необходимо).
АС1 обрабатывает JMS-квитанцию.
Компонент TFSX отправляет JMS-уведомление о передаче файла в АС2.
АС2 принимает файл в обработку, затем удаляет его из общей папки TFSX и АС2.
15.3 Исключительный сценарий:
АС Отправитель (АС1), с помощью FTRF, выкладывает зашифрованный файл в бакет S3 хранилища АС1.
АС1, с помощью FTRF, отправляет grpc нотификацию в TFSX.
Симметричный ключ не валидный.
Публикация сообщения об ошибке расшифровки файла.
16. Передача файлов TFSX -> FTRF в зависимости от применения сервиса ОТТ#
16.1 Основной сценарий:
АС Отправитель (АС1) выкладывает файл на файловый ресурс TFSX в общую папку TFSX и АС1, после чего отправляет JMS-уведомление о передаче файла.
Компонент TFSX читает уведомление и берет в работу файл от АС1.
Компонент TFSX генерирует симметричный ключ шифрования и шифрует им исходный файл.
Компонент TFSX перекладывает зашифрованный файл в s3-хранилище для АС Получателя (АС2).
Компонент TFSX анализирует наличие настроек ОТТ и параметра OttStrictMode в настройках сценария.
Компонент TFSX, при наличии ОТТ и OttStrictMode=true, шифрует симметричный ключ с помощью сервиса ОТТ из записывает результат в encMessage.
Компонент TFSX отправляет grpc нотификацию в FTRF, принадлежащий АС2.
Компонент TFSX удаляет файл из общей папки TFSX и АС Отправитель.
АС2, с помощью FTRF, получает grpc уведомление от TFSX, выгружает и расшифровывает файлы из s3 хранилища.
TFSX отправляет JMS-квитанцию в АС1 со статусом доставки (если необходимо).
16.2 Альтернативный сценарий:
АС Отправитель (АС1) выкладывает файл на файловый ресурс TFSX в общую папку TFSX и АС1, после чего отправляет JMS-уведомление о передаче файла.
Компонент TFSX читает уведомление и берет в работу файл от АС1.
Компонент TFSX генерирует симметричный ключ шифрования и шифрует им исходный файл.
Компонент TFSX перекладывает зашифрованный файл в s3-хранилище для АС Получателя (АС2).
Компонент TFSX анализирует наличие настроек ОТТ и параметра OttStrictMode в настройках сценария.
Компонент TFSX, при отсутствии ОТТ или OttStrictMode=false, записывает симметричный ключ в открытом виде в encMessage.
Компонент TFSX отправляет grpc нотификацию в FTRF, принадлежащий АС2.
Компонент TFSX удаляет файл из общей папки TFSX и АС Отправитель.
АС2, с помощью FTRF, получает grpc уведомление от TFSX, выгружает и расшифровывает файлы из s3 хранилища.
TFSX отправляет JMS-квитанцию в АС1 со статусом доставки (если необходимо).
16.3 Исключительный сценарий 1:
АС Отправитель (АС1) выкладывает файл на файловый ресурс TFSX в общую папку TFSX и АС1, после чего отправляет JMS-уведомление о передаче файла.
Сообщение о передача файла не прошло валидацию.
Публикация сообщения об ошибке.
16.4 Исключительный сценарий 2:
АС Отправитель (АС1) выкладывает файл на файловый ресурс TFSX в общую папку TFSX и АС1, после чего отправляет JMS-уведомление о передаче файла.
Компонент TFSX шифрует и перекладывает файл в s3 хранилище для АС Получатель (АС2).
Ошибка передачи файла.
Публикация сообщения об ошибке.