DataMotion (プレビュー)
DataMotion, Inc. は安全なデータ交換 API を専門としており、企業はセキュア メッセージおよびファイル交換ソリューションを既存のワークフローに統合し、開発時間を節約できます。 セキュリティ プロトコルに従うのは時間がかかることですが、DataMotion のコネクタはシームレスな一方向の暗号化メッセージングが可能になるため、ユーザーは業界の規制や企業のセキュリティ ポリシーに準拠した状態を維持できます。
このコネクタは、次の製品および地域で利用可能です。
| Service | クラス | 地域 |
|---|---|---|
| Logic Apps | 標準 | 以下を除くすべての Logic Apps 地域 : - Azure 政府の地域 - Azure 中国の地域 - 国防総省 (DoD) |
| Power Automate | プレミアム | 以下を除くすべての Power Automate 地域 : - 米国政府 (GCC) - 米国政府 (GCC High) - 21Vianet が運用する中国のクラウド - 国防総省 (DoD) |
| Power Apps | プレミアム | 以下を除くすべての Power Apps 地域 : - 米国政府 (GCC) - 米国政府 (GCC High) - 21Vianet が運用する中国のクラウド - 米国国防総省 (DoD) |
| お問い合わせ先 | |
|---|---|
| 件名 | DataMotion サポート |
| [URL] | https://datamotion.com/support-request/ |
| メール | support@datamotion.com |
| Connector Metadata | |
|---|---|
| 発行者 | DataMotion, Inc. |
| Web サイト | 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 のアカウントを作成するには、datamotion.com/portal にアクセスし、API プランのリストが表示されます。 セキュア メッセージ デリバリー プランにカーソルを合わせ、「今すぐ試す」アイコンをクリックします。
「今すぐ試す」を選択すると、「API - セキュア メッセージ デリバリー セルフサービス センター」のページが表示されます。 このセンターでは、DataMotion API をテストしたり、ドキュメントを確認したり、必要に応じてサポートに連絡したりすることができます。
画面の右上に「ログイン」ボタンがあります。 開始するには、このボタンをクリックしてください。 ボタンを選択すると、新しいポップアップが表示されます。このポップアップの一番下にある「こちらでサインアップ」を選択してください。
これらの手順が完了すると、情報提供のお願いと、パスワードを作成する項目が表示されます。 必要な情報を入力し、安全なパスワードを作成します。
利用規約を確認して同意し、[アカウントの作成]を選択してプロセスを完了します。 以上で終了です。 アカウントが作成され、API をテストする $25 の残高が自動的に作成されます。
コネクタを使ってみよう
DataMotion のセキュアな デリバリー コネクタは、自動化されたワークフローに最適です。 コネクタ自体をトリガーとして使用することはできませんが、ワークフローが点火されると、安全なメッセージを送信、追跡、撤回するために使用することができます。
セキュアなメッセージ デリバリー コネクタを使用するワークフローには、いくつかの一般的なトリガーがあります。 ユーザーはフォームから機密データを取得してから安全な方法で送信する必要がある場合があるため、フォームの送信はその一例です。 また、DocuSign コネクタを使用したフォームへの署名も一般的なトリガーとなります。 署名して渡す必要のある重要な文書は、多くの場合、ビジネス クリティカルであったり、PII、PHI、PCI を含んでいたりするため、安全に送信する必要があります。 最後に、時間的な間隔を設定することで、日、週、月単位でワークフローを起動することができます。 これは、更新された顧客アカウントリストや毎週の利益レビューなどの重要なデータを暗号化して定期的にサードパーティに送信する必要がある場合に特に役立ちます。
セキュア メッセージ デリバリー コネクタを使用するには、まず新しい Power Automate ワークフローを作成し、トリガーを選択します。 上記のような例を利用することもできますが、もっとユニークなトリガーを利用することもできます。
トリガーを選択したら、送信したい機密データを追加する必要があります。 たとえば、フォームの送信をトリガーとして選択した場合、ワークフローの最初のステップは、このフォームからデータを収集することです。 ワークフローを通じて機密データを収集した後、次のステップでは、データを安全なメッセージで送信します。 そのためには、ワークフローのステップを追加する必要があります。
これを行うには、「+ 次のステップ」を選択し、DataMotion コネクタを検索します。 これは、新規ステップセクションの上部にある検索バーに「セキュア メッセージ デリバリー」と入力することで可能です。
[+次のステップ]ボタンを選択すると、このコネクタに関連付けられているアクションのリストが表示されます。 アクションとして「セキュア メッセージ デリバリー」を選択します。
新しいウィジェットは、安全なメッセージ要求を表示します。
以下では、リクエストの各項目について説明し、記入例を示します。 適切にテストするためには、これらのフィールドをカスタマイズする必要があることに注意してください (特に 「To」 アドレス)。
Version
- V- このセクションでは、使用している DataMotion API のバージョンを確認します。 使用しているAPIのバージョンは、セルフサービスポータルの「どうすればいいか」セクションで確認できます。 「必須パラメータ」セクションの上部に、API バージョンがあります。
X-API-Secret
- API の秘密鍵を取得するには、セルフ サービス センターに戻ってログインします。 ログインすると、「アプリケーション」というタイトルの新しいタブが表示されます。 このタブを選択します。
- ここから、「アプリケーションの作成」ボタンを選択し、アプリケーションに名前を付けます。 次に、アプリケーション タイプに「その他」を選択し、説明を入力します。
- API Key セクションの中央にある「プラス」記号 (+) を選択し、ポップアップで提供された API シークレットをコピーします。 このキーを、Power Automate の X-API-シークレットテキスト ボックスに貼り付けます。
- API の秘密鍵を取得するには、セルフ サービス センターに戻ってログインします。 ログインすると、「アプリケーション」というタイトルの新しいタブが表示されます。 このタブを選択します。
X-API-Key
- API キー セクションで、提供されたキーをコピーして、Power Automate の X-API-Key セクションに貼り付けます。
送信元
- 「差出人」アドレスは、安全なメッセージの送信元のアドレスになります。 API シークレットと Key を作成したアドレスを入力してください。
目的
- 「宛先」アドレスには、メールボックスを持つ任意のアドレスを指定できます。 テストのために、宛先アドレスに使用したのと同じアドレス、またはアクセス可能な任意のアドレスを入力することができます。
Cc (省略可能)
- コピーするメールボックスを持つ追加のメールアドレスを入力してください。
Bcc (省略可能)
- ブラインド コピーしたいメールボックスを持つ追加のメールアドレスを入力してください。
件名 (省略可能)
- メールの件名を入力します。
添付 (省略可能)
- 添付ファイルを追加するには、base64 文字列、コンテンツ タイプ、ファイル名、コンテンツ ID を指定する必要があります。 この情報を自動的に収集するための追加の手順がいくつかありますが、今回のデモでは、このセクションを空白のままにすることができます。
HtmlBody (省略可能)
- このセクションでは、メッセージの本文に送信する html テキストを追加することができます。 この例では、このセクションを空白にしておくことができます。
TextBody (省略可能)
- このエリアでは、本文をプレーン テキストで記述し、送信したい機密情報を追加します。
各テキストボックスをクリックすると、「前述の手順のパラメータを挿入」と表示される場合があります。 表示されるパラメータは、フォームや Excel シート、その他の機密情報を含むドキュメントから取得した応答です。 これらのパラメータを選択することで、このデータをメールの本文に含めることができます。
構成の完了後は、「保存」を選択します。 画面上部にワークフローが保存されたことを示すメッセージが表示されます。
これで、DataMotion のセキュアなメッセージ配信 API を組み込んだワークフローが完成しました。
既知の問題と制限事項
DataMotion のセキュア メッセージ デリバリー コネクタには、既知の制限が 1 つあります。 メッセージの送信後に、このメッセージを追跡または撤回しようとすると、メッセージが見つからないというエラーメッセージが表示される場合があります。 これは、メッセージ ID がまだ更新されていないためです。 2 秒の遅延または失敗時のリトライでこの問題は解決します。
一般的なエラーと解決策
無効な API シークレット、またはキーを入力すると、401 エラーが発生します。 このエラーを解決するには、新しいキーを作成する必要があります。 DataMotion のセキュア メッセージ デリバリー ポータルに移動し、アプリケーション タブを選択します。このタブには、現在の API キーが表示されている API Key セクションがあります。 API キーの右側にあるゴミ箱アイコンを使って、現在の API キーを削除してください。
ごみ箱アイコンを選択すると、キーが削除され、ページの API キー セクションの中央にキーを追加する新しいオプションが表示されます。 DataMotion ポータルからこのキーに再度アクセスできないため、このオプションを選択し、シークレットキーを安全に保存してください。 ここから、新しい API キーを Power Automate のワークフローにコピーします。
よくあるご質問
API キーとシークレットはどこで入手できますか？
API キーやシークレットを作成するには、DataMotion セキュア メッセージ デリバリー ポータル にアクセスし、'Applications' タブを選択します。API Key セクションでは、キーを追加するためのオプションが用意されています。 DataMotion ポータルからこのキーに再度アクセスできないため、このオプションを選択し、シークレットキーを安全に保存してください。 ここから、新しい API キーを Power Automate のワークフローにコピーします。
DataMotion アカウントにサインアップするにはどうすればよいですか？
DataMotion のアカウントにサインアップするには、datamotion.com/portal にアクセスして、API プランのリストを表示します。 セキュア メッセージ デリバリー プランにカーソルを合わせ、「今すぐ試す」アイコンをクリックします。
「今すぐ試す」を選択すると、「API - セキュア メッセージ デリバリー セルフサービス センター」のページが表示されます。 このセンターでは、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 Key に関連付けられたシークレット値。 これに関する詳細は、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 Key に関連付けられたシークレット値。 これに関する詳細は、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
|
ContentType | string |
添付ファイルのメディアの種類。 |
|
|
FileName
|
FileName | string |
添付ファイルの名前。 |
|
|
ContentId
|
ContentId | string |
Content 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 Key に関連付けられたシークレット値。 これに関する詳細は、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
|
Cost | double |
トランザクションの合計コスト。 |
|
Attachments
|
Attachments | array of AttachmentMetaData |
Attachment Structure、SecurityEnvelope Structure、および添付ファイルごとの Tracking Structure を含む複合型。 |
|
ExpirationDate
|
ExpirationDate | string |
メッセージの有効期限の日付/時刻。 |
|
MessageId
|
MessageId | integer |
メッセージの Id。 |
|
MessageSize
|
MessageSize | integer |
メッセージ サイズ (バイト数)。 |
|
SecurityEnvelope
|
SecurityEnvelope | object |
メッセージ セキュリティ エンベロープ オブジェクト。 |
|
Tracking
|
Tracking | array of Tracking |
メッセージ追跡オブジェクトの一覧。 |
|
Subject
|
Subject | string |
メッセージの件名。 |
AttachmentMetaData
メッセージ添付ファイル オブジェクト。
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
AttachmentId
|
AttachmentId | integer |
添付ファイルの一意識別子。 |
|
FileName
|
FileName | string |
添付ファイル名。 |
|
ContentId
|
ContentId | object |
添付ファイル コンテンツ Id (添付ファイルがインライン画像の場合にのみ入力されます)。 |
|
ContentType
|
ContentType | string |
添付ファイルのメディアの種類。 |
|
SecurityEnvelope
|
SecurityEnvelope | object |
添付ファイルのセキュリティ エンベロープ。 |
|
Size
|
Size | Size |
添付ファイル サイズ オブジェクト。 |
|
Tracking
|
Tracking | AttachmentTracking |
添付ファイル追跡情報。 |
Tracking
メッセージ追跡情報。
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
DateOpened
|
DateOpened | string |
メッセージが開かれた日時の文字列。 注: 年 = 1900 の場合、現在のメッセージ ステータスに関連付けられた DateOpened はありません。 |
|
Email
|
string |
受信者のメール アドレス。 |
|
|
MessageStatusDescription
|
MessageStatusDescription | string |
文字列の説明として表されるステータス。 |
|
MessageStatusId
|
MessageStatusId | integer |
個々の受信者のステータスを示す数値インジケーター。 |
|
ReceiverField
|
ReceiverField | string |
この受信者がメッセージの TO、CC、または BCC のいずれであったかを示します。 |
Size
添付ファイル サイズ オブジェクト。
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
StdString
|
StdString | string |
添付ファイルのサイズを含む文字列値; |
AttachmentTracking
添付ファイル追跡情報。
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
Recipients
|
Recipients | array of Recipient |
メッセージ受信者オブジェクト。 |
|
DateOpened
|
DateOpened | string |
メッセージが開かれた日時の文字列。 注: 年 = 1900 の場合、現在のメッセージ ステータスに関連付けられた DateOpened はありません。 |
|
Email
|
string |
受信者のメール アドレス。 |
|
|
MessageStatusDescription
|
MessageStatusDescription | string |
文字列の説明として表されるステータス。 |
|
MessageStatusId
|
MessageStatusId | integer |
個々の受信者のステータスを示す数値インジケーター。 |
|
ReceiverField
|
ReceiverField | string |
この受信者がメッセージの TO、CC、または BCC のいずれであったかを示します。 |
Recipient
メッセージ受信者オブジェクト。
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
ChecksumValidated
|
ChecksumValidated | integer |
次のいずれかの値: 0 (Invalid)、1 (Valid)、または 2 (NotApplied)。 |
|
Delivered
|
Delivered | boolean |
メッセージが配信されたかどうかを示します。 |
|
DeliveredDate
|
DeliveredDate | string |
メッセージがいつ配信されたかを表す DateTime 文字列。 |
|
Downloaded
|
Downloaded | boolean |
添付ファイルがダウンロードされたかどうかを示します。 |
|
DownloadedDate
|
DownloadedDate | string |
メッセージがいつダウンロードされたかを表す DateTime 文字列。 |
|
Email
|
string |
受信者のメール アドレス。 |