DataMotion (предварительная версия)

DataMotion, Inc. специализируется на api безопасного обмена данными, позволяя компаниям интегрировать безопасные решения обмена сообщениями и файлами в существующие рабочие процессы и сэкономить время разработки. Следующие протоколы безопасности могут занять много времени, но соединитель DataMotion обеспечивает простой, односторонний зашифрованный обмен сообщениями, помогая пользователям оставаться в соответствии с отраслевыми правилами и политиками безопасности вашего предприятия.

Этот соединитель доступен в следующих продуктах и регионах:

Услуга	Class	Регионы
Copilot Studio	Премия	Все регионы Power Automate , кроме следующих:      - Правительство США (GCC)      - Правительство США (GCC High)      — Облако Китая, управляемое 21Vianet      - Министерство обороны США (DoD)
Логические приложения	Стандарт	Все регионы Logic Apps , кроме следующих:      — Регионы Azure для государственных организаций      — Регионы Azure Для Китая      - Министерство обороны США (DoD)
Power Apps	Премия	Все регионы Power Apps , кроме следующих:      - Правительство США (GCC)      - Правительство США (GCC High)      — Облако Китая, управляемое 21Vianet      - Министерство обороны США (DoD)
Power Automate	Премия	Все регионы Power Automate , кроме следующих:      - Правительство США (GCC)      - Правительство США (GCC High)      — Облако Китая, управляемое 21Vianet      - Министерство обороны США (DoD)

Контакт
Имя	Поддержка DataMotion
URL	https://datamotion.com/support-request/
Адрес электронной почты	support@datamotion.com

Метаданные соединителя
Publisher	DataMotion, Inc.
Веб-сайт	https://datamotion.com/secure-message-delivery-api/
Политика конфиденциальности	https://datamotion.com/privacy-policy/
Категории	Коммуникация; Безопасность

DataMotion, Inc. — это компания API, специализирующаяся на безопасной передаче данных. Это означает, что вы можете использовать соединитель безопасной доставки сообщений для безопасной отправки зашифрованного текста, документов, изображений, файлов и других пользователей с допустимым адресом электронной почты. С помощью сквозного шифрования вы можете убедиться, что содержимое сообщений не было снято в автономном режиме или изменено каким-либо образом, независимо от того, находится ли во время передачи или в папке "Входящие". Помимо безопасной отправки сообщений, соединитель безопасной доставки сообщений позволяет отслеживать и отбирать безопасные сообщения. Интегрируя эту функцию в рабочие процессы, пользователи смогут безопасно автоматизировать задачи, которые, возможно, полностью не были поставлены под сомнение, так как автоматизация может поставить под угрозу безопасность. Ваша организация сможет использовать Power Automate для автоматизации нескольких задач, включая правильную, безопасную обработку клинической информации, передачу записей о работоспособности пациентов, передачу заглушки оплаты, хранение планов выхода на пенсию сотрудников и многое другое.

Предпосылки

Чтобы использовать соединитель безопасной доставки сообщений DataMotion, сначала необходимо создать учетную запись DataMotion. Вы можете создать платную, подписку или бесплатную 30-дневную пробную версию. Чтобы создать учетную запись, перейдите к datamotion.com/portal.

После завершения этого шага вы автоматически получите кредит в размере 25 долл. США для тестирования API. Здесь вы можете выбрать "Платежи", чтобы продолжить добавлять баланс в виде одноразового или повторяющегося платежа. Вам потребуется баланс для продолжения отправки, отслеживания и извлечения защищенных сообщений с помощью соединителя безопасной доставки сообщений.

Получение учетных данных

Чтобы создать учетную запись DataMotion, перейдите к datamotion.com/portal где отобразится список планов API. Наведите указатель мыши на план безопасной доставки сообщений и щелкните значок "Попробовать сейчас".

После выбора "Попробовать сейчас" отобразится страница "API — безопасная доставка сообщений Self-Service Центр". Этот центр предоставляет возможность протестировать API DataMotion, просмотреть документацию и обратиться в службу поддержки при необходимости.

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

После выполнения этих действий появится запрос на получение сведений и раздел для создания пароля. Введите необходимые сведения и создайте безопасный пароль.

Просмотрите и примите условия обслуживания, а затем завершите процесс, нажав кнопку "Создать учетную запись". Там у тебя есть! Ваша учетная запись создана, и вы автоматически будете иметь баланс $25 для тестирования наших API.

Начало работы с нашим соединителем

Безопасная доставка сообщений DataMotion — это идеальное дополнение в автоматизированных рабочих процессах. Сам соединитель нельзя использовать в качестве триггера, но его можно использовать для отправки, отслеживания и извлечения безопасных сообщений после того, как рабочий процесс воспламенится.

Существует несколько распространенных триггеров для рабочих процессов, использующих соединитель безопасной доставки сообщений. Отправка формы является одним из примеров, так как пользователям может потребоваться извлечь конфиденциальные данные из формы, а затем отправить его вместе с безопасным способом. Подписывание формы с помощью соединителя DocuSign также будет общим триггером. Важные документы, которые должны быть подписаны и переданы вместе, часто критически важны для бизнеса, или содержат PII, PHI или PCI и поэтому должны быть отправлены безопасно. Наконец, интервал времени можно использовать для активации рабочего процесса на ежедневной, еженедельной или ежемесячной основе. Это особенно полезно, если важные данные, такие как обновленный список учетных записей клиента или еженедельный обзор прибыли, должны быть зашифрованы и отправлены третьим лицам на регулярной основе.

Чтобы приступить к работе с соединителем безопасной доставки сообщений, сначала создайте рабочий процесс Power Automate и выберите триггер. Вы можете использовать один из приведенных выше примеров или более уникальный триггер.

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

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

После выбора кнопки "+ Следующий шаг" появится список действий, связанных с этим соединителем. Выберите "Отправить безопасное сообщение" в качестве действия.

Новое мини-приложение отобразит запрос на безопасное сообщение.

Ниже мы рассмотрим каждый раздел запроса и укажите примеры записей. Имейте в виду, что эти поля необходимо настроить для правильного тестирования (особенно адрес "To"!).

• Версия

  • V— этот раздел запрашивает версию используемого API DataMotion. Вы можете найти версию API, которую вы используете, в разделе "How Do I" портала самообслуживания. В верхней части раздела "Обязательный параметр" можно найти версию API.

• X-API-Secret

  • Чтобы получить секретный ключ API, вернитесь в центр самообслуживания и войдите в систему. После входа новая вкладка должна появиться под названием "Приложения". Выберите эту вкладку.
    • В этом разделе нажмите кнопку "Создать приложение" и присвойте приложению имя. Затем выберите "Другой" для типа приложения и укажите описание.
    • Выберите знак "плюс" (+) в центре раздела "Ключи API" и скопируйте секрет API, предоставленный во всплывающем окну. Вставьте этот ключ в текстовое поле X-API-Secret в Power Automate.

• Ключ X-API

  • В разделе "Ключ API" скопируйте указанный ключ и вставьте его в раздел X-API-Key в Power Automate.

• От

  • Адрес from будет адресом, из который отправляется безопасное сообщение. Введите адрес, с помощью которого вы создали секрет и ключ API.

• Кому

  • Адрес "To" может быть любым адресом с почтовым ящиком. Чтобы проверить, можно ввести тот же адрес, к который вы использовали для адреса или любого адреса, к которым у вас есть доступ.

• Копия (необязательно)

  • Введите любой дополнительный адрес электронной почты с соответствующим почтовым ящиком, скопированным.

• Bcc (необязательно)

  • Введите любой дополнительный адрес электронной почты с соответствующим почтовым ящиком, который вы хотите слепить копию.

• Тема (необязательно)

  • Введите тему электронного сообщения.

• Вложения (необязательно)

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

• HtmlBody (необязательно)

  • В этом разделе можно добавить html-текст для отправки в текст сообщения. В этом примере можно сохранить этот раздел пустым.

• TextBody (необязательно)

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

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

Завершив настройку, нажмите кнопку "Сохранить". Появится сообщение о том, что рабочий процесс сохранен в верхней части экрана.

Теперь вы создали рабочий процесс, который включает API безопасной доставки сообщений DataMotion!

Известные проблемы и ограничения

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

Распространенные ошибки и средства устранения неполадок

Недопустимый секрет или ключ API приведет к ошибке 401. Чтобы устранить эту ошибку, необходимо создать новый ключ. Перейдите на портал доставки безопасных сообщений DataMotion и перейдите на вкладку "Приложения". На этой вкладке вы увидите раздел "Ключ API" с текущим отображением ключа API. Удалите текущий ключ API с значком корзины, расположенным справа от ключа.

После выбора значка корзины ключ будет удален, а новый параметр для добавления ключа будет доступен в середине раздела ключа API страницы. Выберите этот параметр и безопасно сохраните секретный ключ (который будет отображаться), так как вы не сможете снова получить доступ к этому ключу на портале DataMotion. Скопируйте новый ключ API в рабочий процесс Power Automate.

Часто задаваемые вопросы

Где получить ключ и секрет API?

Чтобы создать ключ или секрет API, перейдите на портал доставки безопасных сообщений DataMotion и перейдите на вкладку "Приложения". В разделе "Ключ API" будет доступен параметр добавления ключа; Вы увидите параметр в середине раздела. Выберите этот параметр и безопасно сохраните отображаемый секретный ключ, так как вы не сможете получить доступ к этому ключу на портале DataMotion. Скопируйте новый ключ API в рабочий процесс Power Automate.

Как зарегистрироваться для учетной записи DataMotion?

Чтобы зарегистрироваться для учетной записи DataMotion, перейдите к datamotion.com/portal где отобразится список планов API. Наведите указатель мыши на план безопасной доставки сообщений и щелкните значок "Попробовать сейчас".

После выбора "Попробовать" отобразится страница "API — безопасная доставка сообщений Self-Service Центр". Этот центр предоставляет возможность протестировать API DataMotion, просмотреть документацию и обратиться в службу поддержки при необходимости.

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

После выполнения этих действий появится запрос на получение сведений и раздел для создания пароля. Введите необходимые сведения и создайте безопасный пароль.

Просмотрите и примите условия обслуживания, а затем завершите процесс, нажав кнопку "Создать учетную запись". Там у тебя есть! Ваша учетная запись создана, и вы автоматически будете иметь баланс $25 для тестирования наших API.

Как добавить в баланс?

Чтобы добавить баланс, перейдите на портал доставки безопасных сообщений DataMotion и выберите "Платежи" в соответствии с доступным балансом. Укажите имя, компанию и адрес, а затем нажмите кнопку "Далее". Здесь можно настроить повторяющийся платеж, который будет автоматически заполняться; Вы также можете сделать одноразовый платеж.

Ограничения регулирования

Имя	Вызовы	Период обновления
Вызовы API для каждого подключения	100	60 секунд

Действия

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

Извлечение безопасного сообщения

Идентификатор операции:

RetractMessageAsync

Вычитает безопасное сообщение, которое было отправлено ранее.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
TransactionId	transactionId	True	uuid	Идентификатор безопасного сообщения, которое необходимо отозвать.
v	v	True	string	Версия API. Это можно найти, перейдя к разделу https://developers.datamotion.com "Версии API (BaseURL)" в меню слева.
X-API-Key	X-API-Key	True	string	Уникальный идентификатор, используемый для идентификации объекта ключа API. Чтобы узнать больше об этом, посетите сайт https://datamotion.com/how-to-use-datamotion-with-power-automate/.
X-API-Secret	X-API-Secret	True	string	Значение секрета, связанное с ключом API. Чтобы узнать больше об этом, посетите сайт https://datamotion.com/how-to-use-datamotion-with-power-automate/.

Отправка безопасного сообщения

Идентификатор операции:

SendSecureMessageAsync

Отправляет сообщение в безопасном режиме, гарантируя, что данные не повреждены.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
От	From	True	string	Адрес пользователя, который отправит сообщение.
Кому	To		array of string	Массив получателей безопасного сообщения.
Копия (Cc)	Cc		array of string	Массив получателей, углерод, скопированный в защищенном сообщении.
Bcc	Bcc		array of string	Массив получателей, слепый углерод, скопированный в безопасном сообщении.
Тема	Subject		string	Тема безопасного сообщения.
AttachmentBase64	AttachmentBase64		string	Строка в кодировке Base64 вложения.
ContentType	ContentType		string	Тип носителя вложения.
Имя файла	FileName		string	Имя файла вложения.
ContentId	ContentId		string	Идентификатор содержимого (заполняется только в том случае, если вложение является встроенным изображением).
HtmlBody	HtmlBody		string	Html-текст сообщения электронной почты.
TextBody	TextBody		string	Текст сообщения электронной почты.
v	v	True	string	Версия API. Это можно найти, перейдя к разделу https://developers.datamotion.com "Версии API (BaseURL)" в меню слева.
X-API-Key	X-API-Key	True	string	Уникальный идентификатор, используемый для идентификации объекта ключа API. Чтобы узнать больше об этом, посетите сайт https://datamotion.com/how-to-use-datamotion-with-power-automate/.
X-API-Secret	X-API-Secret	True	string	Значение секрета, связанное с ключом API. Чтобы узнать больше об этом, посетите сайт https://datamotion.com/how-to-use-datamotion-with-power-automate/.

Возвращаемое значение

Отправка модели ответа на безопасное сообщение.

Тело

SendSecureMessageResponse

Отслеживание безопасного сообщения

Идентификатор операции:

TrackMessageAsync

Отслеживайте безопасное сообщение, чтобы убедиться, что сообщение доставлено и открыто.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
TransactionId	transactionId	True	uuid	Идентификатор защищенного сообщения для отслеживания.
v	v	True	string	Версия API. Это можно найти, перейдя к разделу https://developers.datamotion.com "Версии API (BaseURL)" в меню слева.
X-API-Key	X-API-Key	True	string	Уникальный идентификатор, используемый для идентификации объекта ключа API. Чтобы узнать больше об этом, посетите сайт https://datamotion.com/how-to-use-datamotion-with-power-automate/.
X-API-Secret	X-API-Secret	True	string	Значение секрета, связанное с ключом API. Чтобы узнать больше об этом, посетите сайт https://datamotion.com/how-to-use-datamotion-with-power-automate/.

Возвращаемое значение

Объект отслеживания сообщений.

Тело

TrackMessageResponse

Определения

SendSecureMessageResponse

Отправка модели ответа на безопасное сообщение.

Имя	Путь	Тип	Описание
TransactionId	TransactionId	uuid	Идентификатор транзакции.
NumberOfRecipients	NumberOfRecipients	integer	Общее число получателей.
MessageSize	MessageSize	integer	Размер сообщения в байтах.
Expiration	Expiration	string	Дата истечения срока действия сообщения.
ProjectId	ProjectId	uuid	Идентификатор проекта.
ApplicationId	ApplicationId	uuid	Идентификатор приложения

TrackMessageResponse

Объект отслеживания сообщений.

Имя	Путь	Тип	Описание
Себестоимость	Cost	double	Общая стоимость транзакции.
Attachments	Attachments	array of AttachmentMetaData	Сложный тип, содержащий структуру вложений, структуру SecurityEnvelope и структуру отслеживания для каждого вложения.
ExpirationDate	ExpirationDate	string	Дата и время истечения срока действия сообщения.
MessageId	MessageId	integer	Идентификатор сообщения.
MessageSize	MessageSize	integer	Размер сообщения в байтах.
SecurityEnvelope	SecurityEnvelope	object	Объект конверта безопасности сообщения.
Отслеживание	Tracking	array of Tracking	Список объектов отслеживания сообщений.
Тема	Subject	string	Тема сообщения.

AttachmentMetaData

Объект вложения сообщения.

Имя	Путь	Тип	Описание
AttachmentId	AttachmentId	integer	Уникальный идентификатор вложения.
Имя файла	FileName	string	Имя файла вложения.
ContentId	ContentId	object	Идентификатор содержимого вложения (заполняется только в том случае, если вложение является встроенным изображением).
ContentType	ContentType	string	Тип носителя вложения.
SecurityEnvelope	SecurityEnvelope	object	Конверт безопасности вложений.
Size	Size	Size	Объект размера вложения.
Отслеживание	Tracking	AttachmentTracking	Сведения об отслеживании вложений.

Отслеживание

Сведения об отслеживании сообщений.

Имя	Путь	Тип	Описание
DateOpened	DateOpened	string	Строка даты и времени открытия сообщения. Примечание. Если год = 1900, датаopened не связана с текущим состоянием сообщения.
Адрес электронной почты	Email	string	Адрес электронной почты получателя.
MessageStatusDescription	MessageStatusDescription	string	Состояние, представленное как строковое описание.
MessageStatusId	MessageStatusId	integer	Числовым индикатором состояния отдельного получателя.
ReceiverField	ReceiverField	string	Указывает, был ли получатель сообщением TO, CC или BCC.

Size

Объект размера вложения.

Имя	Путь	Тип	Описание
StdString	StdString	string	Строковое значение, содержащее размер вложения;

ВложениеTracking

Сведения об отслеживании вложений.

Имя	Путь	Тип	Описание
Получатели	Recipients	array of Recipient	Объект получателя сообщения.
DateOpened	DateOpened	string	Строка даты и времени открытия сообщения. Примечание. Если год = 1900, датаopened не связана с текущим состоянием сообщения.
Адрес электронной почты	Email	string	Адрес электронной почты получателя.
MessageStatusDescription	MessageStatusDescription	string	Состояние, представленное как строковое описание.
MessageStatusId	MessageStatusId	integer	Числовым индикатором состояния отдельного получателя.
ReceiverField	ReceiverField	string	Указывает, был ли получатель сообщением TO, CC или BCC.

Recipient

Объект получателя сообщения.

Имя	Путь	Тип	Описание
Контрольная суммаValidated	ChecksumValidated	integer	Одно из следующих значений: 0 (недопустимо), 1 (допустимо) или 2 (NotApplied).
Доставлено	Delivered	boolean	Указывает, было ли доставлено сообщение.
ДоставитьDate	DeliveredDate	string	Строка DateTime, представляющая при доставке сообщения.
Загрузить	Downloaded	boolean	Указывает, загружено ли вложение.
СкачанныйDate	DownloadedDate	string	Строка DateTime, представляющая при скачивании вложения.
Адрес электронной почты	Email	string	Адрес электронной почты получателя.