DataMotion (Preview)

DataMotion, Inc. se specializuje na zabezpečená rozhraní API pro výměnu dat, což společnostem umožňuje integrovat zabezpečená řešení výměny zpráv a souborů do svých stávajících pracovních postupů a ušetřit čas vývoje. Následující protokol zabezpečení může být časově náročný, ale konektor DataMotion umožňuje bezproblémové jednosměrné šifrované zasílání zpráv a pomáhá uživatelům zůstat v souladu s oborovými předpisy a zásadami zabezpečení vašeho podniku.

Tento konektor je dostupný v následujících produktech a oblastech:

Service	Class	Regions
Copilot Studio	Premium	Všechny oblasti Power Automate s výjimkou následujících:      – státní správa USA (GCC)      – státní správa USA (GCC High)      - China Cloud provozovaný společností 21Vianet      - Ministerstvo obrany USA (DoD)
Logic Apps	Standard	Všechny oblasti Logic Apps s výjimkou následujících:      – Oblasti Azure Government      – Oblasti Azure China      - Ministerstvo obrany USA (DoD)
Power Apps	Premium	Všechny oblasti Power Apps s výjimkou následujících:      – státní správa USA (GCC)      – státní správa USA (GCC High)      - China Cloud provozovaný společností 21Vianet      - Ministerstvo obrany USA (DoD)
Power Automate	Premium	Všechny oblasti Power Automate s výjimkou následujících:      – státní správa USA (GCC)      – státní správa USA (GCC High)      - China Cloud provozovaný společností 21Vianet      - Ministerstvo obrany USA (DoD)

Kontakt
Název	Podpora DataMotion
URL	https://datamotion.com/support-request/
Email	support@datamotion.com

Metadata konektoru
Vydavatel	DataMotion, Inc.
Internetová stránka	https://datamotion.com/secure-message-delivery-api/
Zásady ochrany osobních údajů	https://datamotion.com/privacy-policy/
Kategorie	Komunikace; Bezpečnost

DataMotion, Inc. je společnost API specializující se na zabezpečený přenos dat. To znamená, že pomocí našeho konektoru pro zabezpečené doručování zpráv můžete bezpečně odesílat šifrovaný text, dokumenty, obrázky, soubory a další informace libovolnému uživateli s platnou e-mailovou adresou. Díky tomuto komplexnímu šifrování můžete mít jistotu, že se obsah vašich zpráv nepřevezl do offline režimu ani nijak nezměnil, ať už při přenosu nebo ve složce Doručená pošta. Kromě bezpečného odesílání zpráv umožňuje konektor pro zabezpečené doručování zpráv sledovat a zatahovat zabezpečené zprávy. Díky integraci této funkce do pracovních postupů budou uživatelé moct bezpečně automatizovat úlohy, které mohly být před otázkou zcela mimo danou otázku, protože automatizace může ohrozit zabezpečení. Vaše organizace bude moct využít Power Automate k automatizaci celé řadu úkolů, včetně správného, zabezpečeného zpracování klinických informací, přenosu zdravotních záznamů pacientů, převodu plateb, ukládání plánů vyřazení zaměstnanců a dalších.

Požadavky

Pokud chcete využívat zabezpečený konektor pro doručování zpráv DataMotion, musíte nejprve vytvořit účet DataMotion. Máte možnost vytvořit placenou, předplatnou nebo bezplatnou 30denní zkušební verzi, kterou můžete spustit. Pokud chcete vytvořit účet, přejděte na datamotion.com/portal.

Jakmile tento krok dokončíte, automaticky obdržíte kredit 25 USD pro otestování rozhraní API. Tady můžete vybrat Platby, abyste mohli zůstatek přidat do zůstatku ve formě jednorázové nebo opakované platby. Abyste mohli pokračovat v odesílání, sledování a odvolávání zabezpečených zpráv pomocí konektoru pro doručování zabezpečených zpráv, budete potřebovat zůstatek.

Jak získat přihlašovací údaje

Pokud chcete vytvořit účet DataMotion, přejděte na datamotion.com/portal, kde se zobrazí seznam plánů rozhraní API. Najeďte myší na plán zabezpečeného doručování zpráv a klikněte na ikonu Vyzkoušet.

Po výběru možnosti Vyzkoušet se zobrazí stránka API – zabezpečené doručování zpráv Self-Service Center. Toto centrum nabízí možnost otestovat rozhraní DataMotion API, v případě potřeby si projít dokumentaci a kontaktovat podporu.

V pravém horním rohu obrazovky je tlačítko Přihlásit se. Začněte kliknutím na toto tlačítko. Po výběru tlačítka se zobrazí nové automaticky otevírané okno; v dolní části tohoto automaticky otevíraného okna vyberte zaregistrovat sem.

Po dokončení těchto kroků se zobrazí žádost o informace a oddíl k vytvoření hesla. Zadejte požadované informace a vytvořte si zabezpečené heslo.

Přečtěte si podmínky služby a odsouhlaste je a dokončete proces tak, že vyberete Vytvořit váš účet. Tam to máte! Váš účet byl vytvořen a k otestování našich rozhraní API budete mít automaticky zůstatek 25 USD.

Začínáme s naším konektorem

Zabezpečené doručování zpráv DataMotion je dokonalým doplňkem v rámci automatizovaných pracovních postupů. Samotný konektor nelze použít jako trigger, ale lze ho použít k odesílání, sledování a odvolávání zabezpečených zpráv po zahlcení pracovního postupu.

Pro pracovní postupy využívající konektor pro doručování zabezpečených zpráv existuje několik běžných triggerů. Odeslání formuláře je jedním z příkladů, protože uživatelé můžou potřebovat vyžádat citlivá data z formuláře a pak je bezpečně odeslat. Podpis formuláře pomocí konektoru DocuSign bude také běžným triggerem. Důležité dokumenty, které je potřeba podepsat a předat spolu, jsou často důležité pro firmu nebo obsahují PII, PHI nebo PCI, a proto by se měly bezpečně odesílat. Nakonec lze časový interval použít k aktivaci pracovního postupu denně, týdně nebo měsíčně. To je užitečné zejména v případě, že důležitá data, jako je aktualizovaný seznam zákaznických účtů nebo týdenní kontrola zisku, je potřeba pravidelně šifrovat a posílat třetí straně.

Pokud chcete začít používat zabezpečený konektor pro doručování zpráv, nejprve vytvořte nový pracovní postup Power Automate a vyberte trigger. Můžete použít jeden z výše uvedených příkladů nebo více jedinečných triggerů.

Po výběru triggeru budete muset přidat citlivá data, která chcete odeslat. Pokud například jako trigger zvolíte odeslání formuláře, prvním krokem pracovního postupu bude shromáždění dat z tohoto formuláře. Jakmile v pracovním postupu shromáždíte citlivá data, dalším krokem je odeslání dat přes zabezpečenou zprávu. Abyste to mohli udělat, budete muset přidat další krok pracovního postupu.

Uděláte to tak, že vyberete + Další krok a vyhledáte konektor DataMotion. Můžete to udělat tak, že do vyhledávacího panelu v horní části oddílu nového kroku zadáte "zabezpečené doručování zpráv".

Jakmile vyberete tlačítko + Další krok, zobrazí se seznam akcí přidružených k tomuto konektoru. Jako akci zvolte Odeslat zabezpečenou zprávu.

Nový widget zobrazí žádost o zabezpečenou zprávu.

Níže si projdeme jednotlivé části žádosti a zadám ukázkové položky. Nezapomeňte, že možná budete muset tato pole přizpůsobit, aby se správně testovat (zejména adresa To).

• Verze

  • V – tato část žádá o verzi rozhraní DataMotion API, které používáte. Verzi rozhraní API, které používáte, najdete v části Jak na našem samoobslužném portálu. V horní části části Povinný parametr najdete verzi rozhraní API.

• Tajný kód X-API

  • Tajný klíč rozhraní API získáte tak, že přejdete zpět do samoobslužného centra a přihlásíte se. Po přihlášení by se měla zobrazit nová karta s názvem Aplikace. Vyberte tuto kartu.
    • Tady vyberte tlačítko Vytvořit aplikaci a pojmenujte aplikaci. Potom jako typ aplikace vyberte Další a zadejte popis.
    • V centru části Klíče rozhraní API vyberte znaménko plus (+) a zkopírujte tajný klíč rozhraní API, který je uvedený v automaticky otevírané nabídce. Vložte tento klíč do textového pole X-API-Secret v Power Automate.

• Klíč X-API

  • V části Klíč rozhraní API zkopírujte zadaný klíč a vložte ho do oddílu X-API-Key v Power Automate.

• Od

  • Adresa Odesílatele bude adresa, ze které odesíláte zabezpečenou zprávu. Zadejte adresu, pomocí které jste vytvořili tajný klíč rozhraní API a klíč.

• K

  • Adresa To může být libovolná adresa s poštovní schránkou. K otestování můžete zadat stejnou adresu, ke které jste použili adresu z adresy, nebo jakoukoli adresu, ke které máte přístup.

• Kopie (volitelné)

  • Zadejte všechny další e-mailové adresy, které mají odpovídající poštovní schránku, kterou chcete zkopírovat.

• Skrytá (volitelné)

  • Zadejte libovolnou další e-mailovou adresu, která má odpovídající poštovní schránku, kterou chcete nevidomé kopírovat.

• Předmět (volitelné)

  • Zadejte předmět e-mailu.

• Přílohy (volitelné)

  • Pokud chcete přidat přílohu, budete muset zadat řetězec base64, typ obsahu, název souboru a ID obsahu. Existuje několik dalších kroků, které tyto informace shromáždí automaticky, ale pro ukázku dnes můžete tuto část ponechat prázdnou.

• HtmlBody (volitelné)

  • V této části můžete přidat text HTML, který se má odeslat v textu zprávy. V tomto příkladu můžete ponechat tento oddíl prázdný.

• TextBody (volitelné)

  • V této oblasti nakreslete text ve formátu prostého textu a přidejte citlivé informace, které chcete odeslat.

Když kliknete do jednotlivých textových polí, může se zobrazit možnost Vložit parametry z předchozího kroku. Tyto parametry, které vidíte, jsou navrhované odpovědi, které jste možná dříve stáhli z formuláře, excelového listu nebo jiného citlivého dokumentu. Tyto parametry můžete vybrat, abyste tato data zahrnuli do textu e-mailu.

Po dokončení konfigurací vyberte Uložit. V horní části obrazovky se zobrazí zpráva s potvrzením, že byl pracovní postup uložen.

Teď jste vytvořili pracovní postup, který zahrnuje rozhraní API pro zabezpečené doručování zpráv DataMotion.

Známé problémy a omezení

Konektor pro doručování zabezpečených zpráv DataMotion má jedno známé omezení. Pokud se uživatel pokusí sledovat nebo odvolat zprávu přímo po odeslání, může se zobrazit chybová zpráva s informací, že zprávu nelze najít. Důvodem je to, že ID zprávy ještě nebylo aktualizováno. Tento problém vyřeší dvousekundové zpoždění nebo opakování při selhání.

Běžné chyby a nápravné prostředky

Neplatný tajný klíč rozhraní API nebo klíč způsobí chybu 401. Pokud chcete tuto chybu vyřešit, musíte vytvořit nový klíč. Přejděte na portál pro doručování zabezpečených zpráv DataMotion a vyberte kartu Aplikace. Na této kartě uvidíte část Klíč rozhraní API s aktuálním zobrazením klíče rozhraní API. Odstraňte aktuální klíč rozhraní API s ikonou koše, která se nachází napravo od klíče.

Jakmile vyberete ikonu koše, klíč se odebere a v části Klíč rozhraní API na stránce bude dostupná nová možnost pro přidání klíče. Tuto možnost vyberte a bezpečně uložte tajný klíč (zobrazí se), protože k tomuto klíči nebudete moct znovu přistupovat z portálu DataMotion. Odtud zkopírujte nový klíč rozhraní API do pracovního postupu Power Automate.

časté otázky

Kde získám klíč rozhraní API a tajný klíč?

Pokud chcete vytvořit klíč rozhraní API nebo tajný klíč, přejděte na portál pro doručování zabezpečených zpráv DataMotion a vyberte kartu Aplikace. V části Klíč rozhraní API bude k dispozici možnost přidat klíč. možnost se zobrazí uprostřed oddílu. Tuto možnost vyberte a bezpečně uložte tajný klíč, který se zobrazí, protože k tomuto klíči nebudete moct znovu přistupovat z portálu DataMotion. Odtud zkopírujte nový klíč rozhraní API do pracovního postupu Power Automate.

Jak se zaregistruji k účtu DataMotion?

Pokud se chcete zaregistrovat k účtu DataMotion, přejděte na datamotion.com/portal, kde se zobrazí seznam plánů rozhraní API. Najeďte myší na plán zabezpečeného doručování zpráv a klikněte na ikonu Vyzkoušet.

Po výběru možnosti Vyzkoušet se zobrazí stránka ROZHRANÍ API – zabezpečené doručování zpráv Self-Service Center. Toto centrum nabízí možnost otestovat rozhraní DataMotion API, v případě potřeby si projít dokumentaci a kontaktovat podporu.

V pravém horním rohu obrazovky je tlačítko Přihlásit se. Začněte tím, že vyberete toto tlačítko. Po výběru tlačítka se zobrazí nové automaticky otevírané okno – v dolní části tohoto automaticky otevíraného okna vyberte Zaregistrovat se sem.

Po dokončení těchto kroků se zobrazí žádost o informace a oddíl k vytvoření hesla. Zadejte požadované informace a vytvořte si zabezpečené heslo.

Přečtěte si podmínky služby a odsouhlaste je a dokončete proces tak, že vyberete Vytvořit váš účet. Tam to máte! Váš účet byl vytvořen a k otestování našich rozhraní API budete mít automaticky zůstatek 25 USD.

Jak přidám svůj zůstatek?

Pokud chcete přidat zůstatek, přejděte na portál pro doručování zpráv DataMotion a pod dostupným zůstatkem vyberte Platby. Zadejte své jméno, společnost a adresu a stiskněte tlačítko Další. Tady můžete nastavit opakovanou platbu, která se automaticky vyplní; máte také možnost provést jednorázovou platbu.

Limity omezování

Name	Volání	Období obnovení
Volání rozhraní API na připojení	100	60 sekund

Akce

Odeslání zabezpečené zprávy	Odešle zprávu bezpečným způsobem, aby data nebyla poškozena.
Odvolání zabezpečené zprávy	Odvolání zabezpečené zprávy, která byla dříve odeslána.
Sledování zabezpečené zprávy	Sledujte zabezpečenou zprávu, abyste měli jistotu, že se zpráva doručí a otevře.

Odeslání zabezpečené zprávy

ID operace:

SendSecureMessageAsync

Odešle zprávu bezpečným způsobem, aby data nebyla poškozena.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
Od	From	True	string	Adresa uživatele, který zprávu odešle.
To	To		array of string	Pole příjemců zabezpečené zprávy.
Cc	Cc		array of string	Polepříjemcůch
Skrytá kopie	Bcc		array of string	Polepříjemcůch
Předmět	Subject		string	Předmět zabezpečené zprávy.
AttachmentBase64	AttachmentBase64		string	Řetězec přílohy s kódováním Base64.
Typ obsahu	ContentType		string	Typ média přílohy.
Název souboru	FileName		string	Název souboru přílohy.
ContentId	ContentId		string	ID obsahu (vyplněné pouze v případě, že je příloha vloženým obrázkem).
HtmlBody	HtmlBody		string	Text HTML e-mailové zprávy.
TextBody	TextBody		string	Text e-mailové zprávy.
v	v	True	string	Verze rozhraní API. Najdete ho tak https://developers.datamotion.com , že navštívíte a v nabídce vlevo vyberete Verze rozhraní API (BaseURL).
X-API-Key	X-API-Key	True	string	Jedinečný identifikátor použitý k identifikaci objektu klíče rozhraní API. Další informace o tom najdete na adrese https://datamotion.com/how-to-use-datamotion-with-power-automate/.
X-API-Secret	X-API-Secret	True	string	Hodnota tajného kódu svázaná s klíčem rozhraní API. Další informace o tom najdete na adrese https://datamotion.com/how-to-use-datamotion-with-power-automate/.

Návraty

Odešlete model odpovědi na zabezpečenou zprávu.

Body

SendSecureMessageResponse

Odvolání zabezpečené zprávy

ID operace:

RetractMessageAsync

Odvolání zabezpečené zprávy, která byla dříve odeslána.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
TransactionId	transactionId	True	uuid	ID zabezpečené zprávy, která se má odvolat.
v	v	True	string	Verze rozhraní API. Najdete ho tak https://developers.datamotion.com , že navštívíte a v nabídce vlevo vyberete Verze rozhraní API (BaseURL).
X-API-Key	X-API-Key	True	string	Jedinečný identifikátor použitý k identifikaci objektu klíče rozhraní API. Další informace o tom najdete na adrese https://datamotion.com/how-to-use-datamotion-with-power-automate/.
X-API-Secret	X-API-Secret	True	string	Hodnota tajného kódu svázaná s klíčem rozhraní API. Další informace o tom najdete na adrese https://datamotion.com/how-to-use-datamotion-with-power-automate/.

Sledování zabezpečené zprávy

ID operace:

TrackMessageAsync

Sledujte zabezpečenou zprávu, abyste měli jistotu, že se zpráva doručí a otevře.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
TransactionId	transactionId	True	uuid	ID zabezpečené zprávy, která se má sledovat.
v	v	True	string	Verze rozhraní API. Najdete ho tak https://developers.datamotion.com , že navštívíte a v nabídce vlevo vyberete Verze rozhraní API (BaseURL).
X-API-Key	X-API-Key	True	string	Jedinečný identifikátor použitý k identifikaci objektu klíče rozhraní API. Další informace o tom najdete na adrese https://datamotion.com/how-to-use-datamotion-with-power-automate/.
X-API-Secret	X-API-Secret	True	string	Hodnota tajného kódu svázaná s klíčem rozhraní API. Další informace o tom najdete na adrese https://datamotion.com/how-to-use-datamotion-with-power-automate/.

Návraty

Objekt sledování zpráv

Body

TrackMessageResponse

Definice

SendSecureMessageResponse

Odešlete model odpovědi na zabezpečenou zprávu.

Name	Cesta	Typ	Description
TransactionId	TransactionId	uuid	ID transakce.
NumberOfRecipients	NumberOfRecipients	integer	Celkový počet příjemců.
MessageSize	MessageSize	integer	Velikost zprávy vbajchch
Vypršení platnosti	Expiration	string	Datum a čas, kdy zpráva vyprší.
Id projektu	ProjectId	uuid	ID projektu.
ApplicationId	ApplicationId	uuid	ID aplikace

TrackMessageResponse

Objekt sledování zpráv

Name	Cesta	Typ	Description
Náklady	Cost	double	Celkové náklady na transakci.
Attachments	Attachments	array of AttachmentMetaData	Komplexní typ obsahující Attachment Structure, SecurityEnvelope Structure a Tracking Structure na přílohu.
Datum vypršení platnosti	ExpirationDate	string	Datum a čas vypršení platnosti zprávy.
MessageId	MessageId	integer	ID zprávy.
MessageSize	MessageSize	integer	Velikost zprávy v bajtech.
SecurityEnvelope	SecurityEnvelope	object	Objekt obálky zabezpečení zprávy.
Sledování	Tracking	array of Tracking	Seznam objektů sledování zpráv.
Předmět	Subject	string	Předmět zprávy.

AttachmentMetaData

Objekt přílohy zprávy

Name	Cesta	Typ	Description
AttachmentId	AttachmentId	integer	Jedinečný identifikátor přílohy.
Název souboru	FileName	string	Název souboru přílohy.
ContentId	ContentId	object	ID obsahu přílohy (vyplněné pouze v případě, že je příloha vloženým obrázkem).
Typ obsahu	ContentType	string	Typ média přílohy.
SecurityEnvelope	SecurityEnvelope	object	Obálka zabezpečení přílohy.
Velikost	Size	Size	Objekt velikosti přílohy.
Sledování	Tracking	AttachmentTracking	Informace o sledování příloh

Sledování

Informace o sledování zpráv

Name	Cesta	Typ	Description
DateOpened	DateOpened	string	Řetězec data a času při otevření zprávy. Poznámka: Pokud rok = 1900, není k aktuálnímu stavu zprávy přidružen žádný DateOpened.
Email	Email	string	E-mailová adresa příjemce.
MessageStatusDescription	MessageStatusDescription	string	Stav reprezentovaný jako popis řetězce
MessageStatusId	MessageStatusId	integer	Číselný indikátor stavu jednotlivého příjemce
ReceiverField	ReceiverField	string	Určuje, jestli byl tento příjemce příjemcem zprávy TO, CC nebo BCC.

Velikost

Objekt velikosti přílohy.

Name	Cesta	Typ	Description
StdString	StdString	string	Řetězcová hodnota, která obsahuje velikost přílohy;

AttachmentTracking

Informace o sledování příloh

Name	Cesta	Typ	Description
Příjemci	Recipients	array of Recipient	Objekt příjemce zprávy
DateOpened	DateOpened	string	Řetězec data a času při otevření zprávy. Poznámka: Pokud rok = 1900, není k aktuálnímu stavu zprávy přidružen žádný DateOpened.
Email	Email	string	E-mailová adresa příjemce.
MessageStatusDescription	MessageStatusDescription	string	Stav reprezentovaný jako popis řetězce
MessageStatusId	MessageStatusId	integer	Číselný indikátor stavu jednotlivého příjemce
ReceiverField	ReceiverField	string	Určuje, jestli byl tento příjemce příjemcem zprávy TO, CC nebo BCC.

Recipient

Objekt příjemce zprávy

Name	Cesta	Typ	Description
ChecksumValidated	ChecksumValidated	integer	Jedna z následujících hodnot: 0 (neplatné), 1 (platné) nebo 2 (NotApplied).
Doručení	Delivered	boolean	Označuje, zda byla zpráva doručena nebo ne.
Datum doručení	DeliveredDate	string	Řetězec DateTime představující, kdy byla zpráva doručena.
Stažený	Downloaded	boolean	Určuje, jestli byla příloha stažena nebo ne.
DownloadedDate	DownloadedDate	string	Řetězec DateTime představující, kdy byla příloha stažena.
Email	Email	string	E-mailová adresa příjemce.