DataMotion (プレビュー)
DataMotion, Inc. は、セキュリティで保護されたデータ交換 API を専門としており、企業は、セキュリティで保護されたメッセージとファイル交換ソリューションを既存のワークフローに統合し、開発時間を節約できます。 次のセキュリティ プロトコルは時間がかかる場合がありますが、DataMotion のコネクタを使用すると、シームレスな一方向の暗号化メッセージングが可能になり、ユーザーは業界の規制や企業のセキュリティ ポリシーに準拠し続けることができます。
このコネクタは、次の製品とリージョンで使用できます。
| サービス | クラス | リージョン |
|---|---|---|
| コピロット スタジオ | Premium | 次を除くすべての Power Automate リージョン : - 米国政府 (GCC) - 米国政府 (GCC High) - 21Vianet が運営する China Cloud - 米国国防総省 (DoD) |
| ロジック アプリ | Standard | 次を除くすべての Logic Apps リージョン : - Azure Government リージョン - Azure China リージョン - 米国国防総省 (DoD) |
| Power Apps | Premium | 次を除くすべての Power Apps リージョン : - 米国政府 (GCC) - 米国政府 (GCC High) - 21Vianet が運営する China Cloud - 米国国防総省 (DoD) |
| Power Automate | Premium | 次を除くすべての Power Automate リージョン : - 米国政府 (GCC) - 米国政府 (GCC High) - 21Vianet が運営する China Cloud - 米国国防総省 (DoD) |
| お問い合わせ | |
|---|---|
| 名前 | DataMotion のサポート |
| URL | https://datamotion.com/support-request/ |
| support@datamotion.com |
| コネクタ メタデータ | |
|---|---|
| Publisher | DataMotion, Inc. |
| Website | https://datamotion.com/secure-message-delivery-api/ |
| プライバシー ポリシー | https://datamotion.com/privacy-policy/ |
| カテゴリ | 通信;安全 |
DataMotion, Inc. は、セキュリティで保護されたデータ転送に特化した API 企業です。 つまり、セキュリティで保護されたメッセージ配信コネクタを使用して、暗号化されたテキスト、ドキュメント、画像、ファイルなどを、有効な電子メール アドレスを持つ任意のユーザーに安全に送信できます。 このエンドツーエンドの暗号化を使用すると、転送中でも受信トレイでも、メッセージのコンテンツがオフラインにされたり、変更されたりしていないことを確認できます。 セキュリティで保護されたメッセージ配信コネクタでは、メッセージを安全に送信するだけでなく、セキュリティで保護されたメッセージを追跡および取り消すことができます。 この機能をワークフローに統合することで、自動化によってセキュリティが危険にさらされる可能性があるため、ユーザーは以前は問題から完全に外れたタスクを安全に自動化できます。 組織は Power Automate を活用して、臨床情報の適切で安全な処理、患者の健康記録の転送、支払いスタブの転送、従業員の退職計画の保存など、無数のタスクを自動化できます。
[前提条件]
DataMotion のセキュリティで保護されたメッセージ配信コネクタを利用するには、まず DataMotion アカウントを作成する必要があります。 有料アカウント、サブスクリプション ベースのアカウント、または無料の 30 日間試用版を作成して開始することもできます。 アカウントを作成するには、datamotion.com/portal に移動します。
この手順を完了すると、API をテストするための 25 ドルのクレジットが自動的に受け取られます。 ここから、[支払い] を選択すると、引き続き 1 回限りの支払いまたは定期的な支払いの形式で残高に追加できます。 セキュリティで保護されたメッセージ配信コネクタを使用してセキュリティで保護されたメッセージの送信、追跡、取り消しを続行するには、バランスが必要です。
資格情報を取得する方法
DataMotion アカウントを作成するには、api プランの一覧が表示される datamotion.com/portal に移動します。 [セキュリティで保護されたメッセージ配信] プランにカーソルを合わせ、[今すぐ試す] アイコンをクリックします。
[今すぐ試す] を選択すると、[API – セキュリティで保護されたメッセージ配信 Self-Service センター] ページが表示されます。 このセンターには、DataMotion API のテスト、ドキュメントの確認、必要に応じてサポートへの問い合わせのオプションが用意されています。
画面の右上隅に[ログイン]ボタンがあります。 開始するには、このボタンをクリックします。 ボタンが選択されると、新しいポップアップが表示されます。このポップアップの下部にある [ここでサインアップ] を選択します。
これらの手順を完了すると、情報の要求とパスワードを作成するためのセクションが表示されます。 必要な情報を入力し、セキュリティで保護されたパスワードを作成します。
サービス条件を確認して同意し、[アカウントの作成] を選択してプロセスを完了します。 そこにそれを持っています! アカウントが作成され、API をテストするために 25 ドルの残高が自動的に得られます。
コネクタの概要
DataMotion のセキュリティで保護されたメッセージ配信は、自動化されたワークフロー内での完全な追加です。 コネクタ自体をトリガーとして使用することはできませんが、ワークフローが起動されたら、セキュリティで保護されたメッセージの送信、追跡、取り消しに使用できます。
セキュリティで保護されたメッセージ配信コネクタを使用するワークフローには、いくつかの一般的なトリガーがあります。 フォームの送信は、ユーザーがフォームから機密データをプルし、安全な方法で送信する必要がある場合があるため、1 つの例です。 DocuSign コネクタを使用してフォームに署名することも、一般的なトリガーになります。 署名して渡す必要がある重要なドキュメントは、多くの場合、ビジネスクリティカルであるか、PII、PHI、PCI が含まれているため、安全に送信する必要があります。 最後に、時間指定された間隔を使用して、毎日、毎週、または毎月の間隔でワークフローをトリガーできます。 これは、更新された顧客アカウントリストや毎週の利益レビューなどの重要なデータを暗号化し、定期的にサードパーティに送信する必要がある場合に特に便利です。
セキュリティで保護されたメッセージ配信コネクタの使用を開始するには、まず新しい Power Automate ワークフローを作成し、トリガーを選択します。 上記のいずれかの例、またはより一意のトリガーを利用できます。
トリガーが選択されたら、送信する機密データを追加する必要があります。 たとえば、フォーム送信をトリガーとして選択した場合、ワークフローの最初の手順は、このフォームからデータを収集することです。 ワークフローを通じて機密データを収集したら、次の手順は、セキュリティで保護されたメッセージを介してデータを送信することです。 これを行うには、追加のワークフロー ステップを追加する必要があります。
これを行うには、[+ 次のステップ] を選択し、DataMotion コネクタを検索します。 これを行うには、新しいステップ セクションの上部にある検索バーに「セキュリティで保護されたメッセージ配信」と入力します。
[+ 次のステップ] ボタンを選択すると、このコネクタに関連付けられているアクションの一覧が表示されます。 アクションとして [セキュリティで保護されたメッセージの送信] を選択します。
新しいウィジェットに、セキュリティで保護されたメッセージ要求が表示されます。
以下では、要求の各セクションについて説明し、エントリの例を示します。 これらのフィールドをカスタマイズして適切にテストする必要がある場合があることに注意してください (特に [宛先] アドレス)。
バージョン
- V – このセクションでは、使用している DataMotion API のバージョンを確認します。 使用している API のバージョンは、セルフサービス ポータルの [操作方法] セクションで確認できます。 [必須パラメーター] セクションの上部には、API のバージョンがあります。
X-API-Secret
- API 秘密鍵を取得するには、 セルフサービス センター に戻ってサインインします。 サインインすると、"アプリケーション" というタイトルの新しいタブが表示されます。 このタブを選択します。
- ここから、[アプリケーションの作成] ボタンを選択し、アプリケーションに名前を付けます。 次に、[アプリケーションの種類] で [その他] を選択し、説明を入力します。
- [API キー] セクションの中央にある "プラス" 記号 (+) を選択し、ポップアップに表示されている API シークレットをコピーします。 このキーを Power Automate の [X-API-Secret] テキスト ボックスに貼り付けます。
- API 秘密鍵を取得するには、 セルフサービス センター に戻ってサインインします。 サインインすると、"アプリケーション" というタイトルの新しいタブが表示されます。 このタブを選択します。
X-API-Key
- [API キー] セクションで、指定されたキーをコピーし、Power Automate の [X-API-Key] セクションに貼り付けます。
差出人
- "From" アドレスは、セキュリティで保護されたメッセージの送信元のアドレスになります。 API シークレットとキーを作成したアドレスを入力します。
宛先
- [宛先] アドレスには、メールボックスを含む任意のアドレスを指定できます。 テストするには、from アドレスまたはアクセス権を持つ任意のアドレスに使用したのと同じアドレスを入力できます。
Cc (省略可能)
- コピーする対応するメールボックスがある追加のメール アドレスを入力します。
Bcc (省略可能)
- ブラインド コピーする対応するメールボックスがある追加のメール アドレスを入力します。
件名 (省略可能)
- メールの件名を入力します。
添付ファイル (省略可能)
- 添付ファイルを追加するには、base64 文字列、コンテンツ タイプ、ファイル名、およびコンテンツ ID を指定する必要があります。 この情報を自動的に収集する追加の手順がいくつかありますが、現在のデモでは、このセクションを空白のままにしておくことができます。
HtmlBody (省略可能)
- このセクションでは、メッセージの本文で送信する HTML テキストを追加できます。 この例では、このセクションを空白のままにすることができます。
TextBody (省略可能)
- この領域では、本文をプレーン テキストで囲み、送信する機密情報を追加します。
各テキスト ボックスをクリックすると、'前の手順のパラメーターの挿入' が表示されることがあります。 表示されるこれらのパラメーターは、フォーム、Excel シート、または別の機密ドキュメントから以前に取得した可能性のある応答です。 これらのパラメーターを選択して、このデータを電子メールの本文に含めることができます。
構成を完了したら、[保存] を選択します。 ワークフローが保存されたことを確認するメッセージが画面の上部に表示されます。
これで、DataMotion のセキュリティで保護されたメッセージ配信 API を組み込んだワークフローが作成されました。
既知の問題と制限事項
DataMotion のセキュリティで保護されたメッセージ配信コネクタには、既知の制限事項が 1 つあります。 ユーザーがメッセージを送信した直後に追跡または取り消そうとすると、メッセージが見つからなかったことを示すエラー メッセージが表示されることがあります。 これは、メッセージ ID がまだ更新されていないためです。 失敗時に 2 秒の遅延または再試行を行うと、この問題が解決されます。
一般的なエラーと解決方法
API シークレットまたはキーが無効な場合、401 エラーが発生します。 このエラーを解決するには、新しいキーを作成する必要があります。 DataMotion セキュリティで保護されたメッセージ配信ポータル に移動し、[アプリケーション] タブを選択します。このタブには、現在の API キーが表示された API キー セクションが表示されます。 キーの右側にあるごみ箱アイコンを使用して、現在の API キーを削除します。
ごみ箱アイコンが選択されると、キーが削除され、キーを追加するための新しいオプションがページの API キー セクションの中央で使用できるようになります。 DataMotion ポータルからこのキーに再度アクセスできなくなるので、このオプションを選択し、秘密キー (表示される) を安全に保存します。 ここから、新しい API キーを Power Automate ワークフローにコピーします。
FAQ
API キーとシークレットはどこで入手できますか?
API キーまたはシークレットを作成するには、DataMotion のセキュリティで保護されたメッセージ配信ポータル に移動し、[アプリケーション] タブを選択します。[API キー] セクションでは、キーを追加するオプションを使用できます。セクションの中央にオプションが表示されます。 DataMotion ポータルからこのキーに再度アクセスできなくなるので、このオプションを選択し、表示される秘密キーを安全に保存します。 ここから、新しい API キーを Power Automate ワークフローにコピーします。
DataMotion アカウントにサインアップするにはどうすればよいですか?
DataMotion アカウントにサインアップするには、api プランの一覧が表示される datamotion.com/portal に移動します。 [セキュリティで保護されたメッセージ配信] プランにカーソルを合わせ、[今すぐ試す] アイコンをクリックします。
[試してみる] を選択すると、[API - セキュリティで保護されたメッセージ配信 Self-Service センター] ページが表示されます。 このセンターには、DataMotion API のテスト、ドキュメントの確認、必要に応じてサポートへの問い合わせのオプションが用意されています。
画面の右上隅に[ログイン]ボタンがあります。 開始するには、このボタンを選択します。 ボタンが選択されると、新しいポップアップが表示されます。このポップアップの下部にある [ここでサインアップ] を選択します。
これらの手順を完了すると、情報の要求とパスワードを作成するためのセクションが表示されます。 必要な情報を入力し、セキュリティで保護されたパスワードを作成します。
サービス条件を確認して同意し、[アカウントの作成] を選択してプロセスを完了します。 そこにそれを持っています! アカウントが作成され、API をテストするために 25 ドルの残高が自動的に得られます。
残高に追加する方法
残高に追加するには、DataMotion のセキュリティで保護されたメッセージ配信ポータル に移動し、使用可能な残高の下にある [支払い] を選択します。 名前、会社、住所を入力し、[次へ] をクリックします。 ここから、自動的に補充される定期的な支払いを設定できます。また、1 回限りの支払いを行うオプションもあります。
調整制限
| 名前 | 呼び出し | 更新期間 |
|---|---|---|
| 接続ごとの API 呼び出し | 100 | 60 秒 |
アクション
| セキュリティで保護されたメッセージを取り消す |
以前に送信されたセキュリティで保護されたメッセージを取り消します。 |
| セキュリティで保護されたメッセージを追跡する |
セキュリティで保護されたメッセージを追跡して、メッセージが配信されて開かれていることを確認します。 |
| セキュリティで保護されたメッセージを送信する |
データが破損しないように、セキュリティで保護された方法でメッセージを送信します。 |
セキュリティで保護されたメッセージを取り消す
以前に送信されたセキュリティで保護されたメッセージを取り消します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
TransactionId
|
transactionId | True | uuid |
取り消すセキュリティで保護されたメッセージの ID。 |
|
v
|
v | True | string |
API のバージョン。 これは、 https://developers.datamotion.com にアクセスし、左側のメニューから [API バージョン (BaseURL)]を選択することで確認できます。 |
|
X-API-Key
|
X-API-Key | True | string |
API Key オブジェクトを識別するために使用される一意の識別子。 詳細については、 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/を参照してください。 |
セキュリティで保護されたメッセージを追跡する
セキュリティで保護されたメッセージを追跡して、メッセージが配信されて開かれていることを確認します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
TransactionId
|
transactionId | True | uuid |
追跡するセキュリティで保護されたメッセージの ID。 |
|
v
|
v | True | string |
API のバージョン。 これは、 https://developers.datamotion.com にアクセスし、左側のメニューから [API バージョン (BaseURL)]を選択することで確認できます。 |
|
X-API-Key
|
X-API-Key | True | string |
API Key オブジェクトを識別するために使用される一意の識別子。 詳細については、 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/を参照してください。 |
戻り値
メッセージ追跡オブジェクト。
- Body
- TrackMessageResponse
セキュリティで保護されたメッセージを送信する
データが破損しないように、セキュリティで保護された方法でメッセージを送信します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
より
|
From | True | string |
メッセージを送信するユーザーのアドレス。 |
|
移行先
|
To | array of string |
セキュリティで保護されたメッセージの受信者の配列。 |
|
|
[Cc]
|
Cc | array of string |
セキュリティで保護されたメッセージにコピーされた受信者の配列。 |
|
|
Bcc
|
Bcc | array of string |
受信者の配列。セキュリティで保護されたメッセージにコピーされたブラインド カーボン。 |
|
|
サブジェクト
|
Subject | string |
セキュリティで保護されたメッセージの件名。 |
|
|
AttachmentBase64
|
AttachmentBase64 | string |
添付ファイルの Base64 でエンコードされた文字列。 |
|
|
コンテンツタイプ
|
ContentType | string |
添付ファイルのメディアの種類。 |
|
|
ファイル名
|
FileName | string |
添付ファイルの名前。 |
|
|
ContentId
|
ContentId | string |
コンテンツ ID (添付ファイルがインライン イメージの場合にのみ設定されます)。 |
|
|
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 Key オブジェクトを識別するために使用される一意の識別子。 詳細については、 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
セキュリティで保護されたメッセージ応答モデルを送信します。
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
TransactionId
|
TransactionId | uuid |
トランザクションの ID。 |
|
NumberOfRecipients
|
NumberOfRecipients | integer |
受信者の合計数。 |
|
MessageSize
|
MessageSize | integer |
メッセージのサイズ (バイト単位)。 |
|
Expiration
|
Expiration | string |
メッセージの有効期限が切れる日時。 |
|
ProjectId
|
ProjectId | uuid |
プロジェクトの ID。 |
|
ApplicationId
|
ApplicationId | uuid |
アプリケーションの ID |
TrackMessageResponse
メッセージ追跡オブジェクト。
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
費用
|
Cost | double |
トランザクションの合計コスト。 |
|
Attachments
|
Attachments | array of AttachmentMetaData |
添付ファイル構造、SecurityEnvelope 構造体、および添付ファイルごとの追跡構造を含む複合型。 |
|
ExpirationDate
|
ExpirationDate | string |
メッセージの有効期限の日付/時刻。 |
|
MessageId
|
MessageId | integer |
メッセージの ID。 |
|
MessageSize
|
MessageSize | integer |
メッセージ サイズ (バイト単位)。 |
|
SecurityEnvelope
|
SecurityEnvelope | object |
メッセージ セキュリティ エンベロープ オブジェクト。 |
|
トラッキング
|
Tracking | array of Tracking |
メッセージ追跡オブジェクトの一覧。 |
|
サブジェクト
|
Subject | string |
メッセージの件名。 |
AttachmentMetaData
メッセージ添付ファイル オブジェクト。
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
AttachmentId
|
AttachmentId | integer |
添付ファイルの一意識別子。 |
|
ファイル名
|
FileName | string |
添付ファイル名。 |
|
ContentId
|
ContentId | object |
添付ファイルのコンテンツ ID (添付ファイルがインライン イメージの場合にのみ設定されます)。 |
|
コンテンツタイプ
|
ContentType | string |
添付ファイルのメディアの種類。 |
|
SecurityEnvelope
|
SecurityEnvelope | object |
添付ファイルのセキュリティ エンベロープ。 |
|
サイズ
|
Size | Size |
添付ファイル サイズ オブジェクト。 |
|
トラッキング
|
Tracking | AttachmentTracking |
添付ファイルの追跡情報。 |
トラッキング
メッセージ追跡情報。
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
DateOpened
|
DateOpened | string |
メッセージが開かれた日時の文字列。 注: year = 1900 の場合、現在のメッセージの状態に関連付けられた DateOpened はありません。 |
|
Email
|
string |
受信者のメール アドレス。 |
|
|
MessageStatusDescription
|
MessageStatusDescription | string |
文字列の説明として表される状態。 |
|
MessageStatusId
|
MessageStatusId | integer |
個々の受信者の状態を示す数値インジケーター。 |
|
ReceiverField
|
ReceiverField | string |
この受信者がメッセージの TO、CC、または BCC のいずれであるかを示します。 |
サイズ
添付ファイル サイズ オブジェクト。
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
StdString
|
StdString | string |
添付ファイルのサイズを含む文字列値。 |
AttachmentTracking
添付ファイルの追跡情報。
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
受取人
|
Recipients | array of Recipient |
メッセージ受信者オブジェクト。 |
|
DateOpened
|
DateOpened | string |
メッセージが開かれた日時の文字列。 注: year = 1900 の場合、現在のメッセージの状態に関連付けられた DateOpened はありません。 |
|
Email
|
string |
受信者のメール アドレス。 |
|
|
MessageStatusDescription
|
MessageStatusDescription | string |
文字列の説明として表される状態。 |
|
MessageStatusId
|
MessageStatusId | integer |
個々の受信者の状態を示す数値インジケーター。 |
|
ReceiverField
|
ReceiverField | string |
この受信者がメッセージの TO、CC、または BCC のいずれであるかを示します。 |
Recipient
メッセージ受信者オブジェクト。
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
ChecksumValidated
|
ChecksumValidated | integer |
次のいずれかの値: 0 (無効)、1 (有効)、または 2 (NotApplied)。 |
|
配信済み
|
Delivered | boolean |
メッセージが配信されたかどうかを示します。 |
|
DeliveredDate
|
DeliveredDate | string |
メッセージが配信された日時を表す DateTime 文字列。 |
|
ダウンロード
|
Downloaded | boolean |
添付ファイルがダウンロードされたかどうかを示します。 |
|
DownloadedDate
|
DownloadedDate | string |
添付ファイルがダウンロードされた日時を表す DateTime 文字列。 |
|
Email
|
string |
受信者のメール アドレス。 |