다음을 통해 공유


DataMotion(미리 보기)

DataMotion, Inc.는 보안 데이터 교환 API를 전문으로 하며, 이를 통해 회사는 보안 메시지 및 파일 교환 솔루션을 기존 워크플로에 통합하고 개발 시간을 절약할 수 있습니다. 보안 프로토콜을 따르는 것은 시간이 오래 걸릴 수 있지만 DataMotion의 커넥터를 사용하면 원활하고 단방향 암호화된 메시징을 사용할 수 있으므로 사용자가 업계 규정 및 기업의 보안 정책을 계속 준수할 수 있습니다.

이 커넥터는 다음 제품 및 지역에서 사용할 수 있습니다.

서비스 클래스 Regions
Copilot Studio Premium 다음을 제외한 모든 Power Automate 지역 :
     - 미국 정부(GCC)
     - 미국 정부(GCC High)
     - 21Vianet에서 운영하는 중국 클라우드
     - 미국 국방부(DoD)
논리 앱 스탠다드 다음을 제외한 모든 Logic Apps 지역 :
     - Azure Government 지역
     - Azure 중국 지역
     - 미국 국방부(DoD)
Power Apps Premium 다음을 제외한 모든 Power Apps 지역 :
     - 미국 정부(GCC)
     - 미국 정부(GCC High)
     - 21Vianet에서 운영하는 중국 클라우드
     - 미국 국방부(DoD)
Power Automate Premium 다음을 제외한 모든 Power Automate 지역 :
     - 미국 정부(GCC)
     - 미국 정부(GCC High)
     - 21Vianet에서 운영하는 중국 클라우드
     - 미국 국방부(DoD)
연락처
이름 DataMotion 지원
URL https://datamotion.com/support-request/
전자 메일 support@datamotion.com
커넥터 메타데이터
게시자 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 이동합니다.

이 단계를 완료하면 API를 테스트하기 위해 $25 크레딧을 자동으로 받게 됩니다. 여기에서 '결제'를 선택하여 일회성 또는 되풀이 결제의 형태로 잔액에 계속 추가할 수 있습니다. 보안 메시지 배달 커넥터를 사용하여 보안 메시지를 계속 보내고, 추적하고, 취소하려면 균형이 필요합니다.

자격 증명을 가져오는 방법

DataMotion 계정을 만들려면 datamotion.com/portal 이동하여 API 계획 목록이 표시됩니다. '보안 메시지 배달' 계획을 마우스로 가리키고 '지금 시도' 아이콘을 클릭합니다.

'지금 시도'를 선택하면 'API – 보안 메시지 배달 Self-Service 센터' 페이지가 표시됩니다. 이 센터에서는 DataMotion API를 테스트하고, 설명서를 검토하고, 필요한 경우 지원에 문의하는 옵션을 제공합니다.

화면의 오른쪽 위 모서리에는 '로그인' 단추가 있습니다. 시작하려면 이 단추를 클릭합니다. 단추가 선택되면 새 팝업이 표시됩니다. 이 팝업의 맨 아래에서 '여기 등록'을 선택합니다.

이러한 단계를 완료하면 정보 요청 및 암호 만들기 섹션이 표시됩니다. 필요한 정보를 입력하고 보안 암호를 만듭니다.

서비스 약관을 검토하고 동의한 후 '계정 만들기'를 선택하여 프로세스를 완료합니다. 거기 당신은 그것을 가지고! 계정이 생성되었으며 API를 테스트하기 위해 $25 잔액이 자동으로 생성됩니다.

커넥터 시작

DataMotion의 보안 메시지 배달은 자동화된 워크플로 내에서 완벽하게 추가됩니다. 커넥터 자체는 트리거로 사용할 수 없지만 워크플로가 점화되면 보안 메시지를 보내고 추적하고 철회하는 데 사용할 수 있습니다.

보안 메시지 배달 커넥터를 활용하는 워크플로에 대한 몇 가지 일반적인 트리거가 있습니다. 양식 제출은 사용자가 양식에서 중요한 데이터를 끌어온 다음 안전한 방식으로 전송해야 할 수 있기 때문에 한 가지 예입니다. DocuSign 커넥터를 사용하여 양식에 서명하는 것도 일반적인 트리거입니다. 서명하고 전달해야 하는 중요한 문서는 종종 중요 비즈니스용이거나 PII, PHI 또는 PCI를 포함하므로 안전하게 전송되어야 합니다. 마지막으로, 시간 제한 간격을 사용하여 매일, 매주 또는 매월 워크플로를 트리거할 수 있습니다. 이는 업데이트된 고객 계정 목록 또는 주간 수익 검토와 같은 중요한 데이터를 정기적으로 암호화하고 타사에 보내야 하는 경우에 특히 유용합니다.

보안 메시지 배달 커넥터를 시작하려면 먼저 새 Power Automate 워크플로를 만들고 트리거를 선택합니다. 위의 예제 중 하나 또는 더 고유한 트리거를 활용할 수 있습니다.

트리거가 선택되면 보내려는 중요한 데이터를 추가해야 합니다. 예를 들어 양식 제출을 트리거로 선택하는 경우 워크플로의 첫 번째 단계는 이 양식에서 데이터를 수집하는 것입니다. 워크플로를 통해 중요한 데이터를 수집한 후 다음 단계는 보안 메시지를 통해 데이터를 보내는 것입니다. 이렇게 하려면 추가 워크플로 단계를 추가해야 합니다.

이렇게 하려면 '+ 다음 단계'를 선택하고 DataMotion 커넥터를 검색합니다. 새 단계 섹션의 맨 위에 있는 검색 창에 '보안 메시지 배달'을 입력하여 이 작업을 수행할 수 있습니다.

'+ 다음 단계' 단추를 선택하면 이 커넥터와 연결된 작업 목록이 표시됩니다. 작업으로 '보안 메시지 보내기'를 선택합니다.

새 위젯은 보안 메시지 요청을 표시합니다.

아래에서는 요청의 각 섹션을 살펴보고 예제 항목을 제공합니다. 제대로 테스트하기 위해 이러한 필드를 사용자 지정해야 할 수도 있습니다(특히 'To' 주소!).

  • 버전

    • V – 이 섹션에서는 사용 중인 DataMotion API의 버전을 요청합니다. 셀프 서비스 포털의 'How Do I' 섹션에서 사용 중인 API의 버전을 찾을 수 있습니다. '필수 매개 변수' 섹션의 맨 위에서 API 버전을 찾을 수 있습니다.
  • X-API-Secret

    • API 비밀 키를 가져오려면 셀프 서비스 센터로 다시 이동하여 로그인합니다. 로그인하면 '애플리케이션'이라는 새 탭이 표시됩니다. 이 탭을 선택합니다.
      • 여기에서 '애플리케이션 만들기' 단추를 선택하고 애플리케이션에 이름을 지정합니다. 그런 다음, 애플리케이션 유형에 대해 '기타'를 선택하고 설명을 제공합니다.
      • API 키 섹션의 가운데에 있는 '더하기' 기호(+)를 선택하고 팝업에 제공된 API 비밀을 복사합니다. Power Automate의 XAPI-Secret 텍스트 상자에 이 키를 붙여넣습니다.
  • X-API-Key

    • API 키 섹션에서 제공된 키를 복사하여 Power Automate의 X-API-Key 섹션에 붙여넣습니다.
  • 보낸 사람

    • '보낸 사람의 주소'는 보안 메시지를 보내는 주소입니다. API 비밀 및 키를 만든 주소를 입력합니다.
  • 받는 사람

    • 'To' 주소는 사서함이 있는 모든 주소일 수 있습니다. 테스트하려면 원본 주소 또는 액세스 권한이 있는 주소에 사용한 것과 동일한 주소를 입력할 수 있습니다.
  • 참조(선택 사항)

    • 복사하려는 해당 사서함이 있는 추가 전자 메일 주소를 입력합니다.
  • 숨은 참조(선택 사항)

    • 블라인드 복사본을 만들려는 해당 사서함이 있는 추가 전자 메일 주소를 입력합니다.
  • 제목(선택 사항)

    • 이메일의 제목을 입력합니다.
  • 첨부 파일(선택 사항)

    • 첨부 파일을 추가하려면 base64 문자열, 콘텐츠 형식, 파일 이름 및 콘텐츠 ID를 제공해야 합니다. 이 정보를 자동으로 수집하는 몇 가지 추가 단계가 있지만, 현재 데모에서는 이 섹션을 비워 둘 수 있습니다.
  • HtmlBody(선택 사항)

    • 이 섹션에서는 메시지 본문에 보낼 html 텍스트를 추가할 수 있습니다. 이 예제에서는 이 섹션을 비워 둘 수 있습니다.
  • TextBody(선택 사항)

    • 이 영역에서는 본문을 일반 텍스트로 간략하게 설명하고 보내려는 중요한 정보를 추가합니다.

각 텍스트 상자를 클릭하면 '이전 단계의 매개 변수 삽입'이 표시 될 수 있습니다. 제안된 이러한 매개 변수는 이전에 폼, Excel 시트 또는 다른 중요한 문서에서 가져온 응답입니다. 이러한 매개 변수를 선택하여 이 데이터를 전자 메일 본문에 포함할 수 있습니다.

구성을 완료한 후 '저장'을 선택합니다. 워크플로가 화면 맨 위에 저장되었음을 확인하는 메시지가 표시됩니다.

이제 DataMotion 보안 메시지 배달 API를 통합하는 워크플로를 만들었습니다.

알려진 문제 및 제한 사항

DataMotion의 보안 메시지 배달 커넥터에는 알려진 제한 사항이 하나 있습니다. 사용자가 메시지를 보낸 후 직접 추적하거나 철회하려고 하면 메시지를 찾을 수 없음을 나타내는 오류 메시지가 나타날 수 있습니다. 메시지 ID가 아직 업데이트되지 않았기 때문입니다. 실패 시 2초 지연 또는 다시 시도하면 이 문제가 해결됩니다.

일반적인 오류 및 해결

잘못된 API 비밀 또는 키로 인해 401 오류가 발생합니다. 이 오류를 해결하려면 새 키를 만들어야 합니다. DataMotion 보안 메시지 배달 포털 로 이동하고 애플리케이션 탭을 선택합니다. 이 탭에는 현재 API 키가 표시된 API 키 섹션이 표시됩니다. 키 오른쪽에 휴지통 아이콘이 있는 현재 API 키를 삭제합니다.

휴지통 아이콘이 선택되면 키가 제거되고 페이지의 API 키 섹션 중간에 키를 추가하는 새 옵션을 사용할 수 있습니다. DataMotion 포털에서 이 키에 다시 액세스할 수 없으므로 이 옵션을 선택하고 표시될 비밀 키를 안전하게 저장합니다. 여기에서 새 API 키를 Power Automate 워크플로에 복사합니다.

자주 묻는 질문(FAQ)

API 키와 비밀은 어디서 얻을 수 있나요?

API 키 또는 비밀을 만들려면 DataMotion 보안 메시지 배달 포털 로 이동하여 '애플리케이션' 탭을 선택합니다. 'API 키' 섹션에서 키를 추가하는 옵션을 사용할 수 있습니다. 섹션 중간에 옵션이 표시됩니다. DataMotion 포털에서 이 키에 다시 액세스할 수 없으므로 이 옵션을 선택하고 표시될 비밀 키를 안전하게 저장합니다. 여기에서 새 API 키를 Power Automate 워크플로에 복사합니다.

DataMotion 계정에 등록하려면 어떻게 해야 하나요?

DataMotion 계정에 등록하려면 datamotion.com/portal 이동하여 API 계획 목록이 표시됩니다. '보안 메시지 배달' 계획을 마우스로 가리키고 '지금 시도' 아이콘을 클릭합니다.

'시도'를 선택하면 'API – 보안 메시지 배달 Self-Service 센터' 페이지가 표시됩니다. 이 센터에서는 DataMotion API를 테스트하고, 설명서를 검토하고, 필요한 경우 지원에 문의하는 옵션을 제공합니다.

화면의 오른쪽 위 모서리에는 '로그인' 단추가 있습니다. 시작하려면 이 단추를 선택합니다. 단추가 선택되면 새 팝업이 표시됩니다. 이 팝업의 맨 아래에서 '여기 등록'을 선택합니다.

이러한 단계를 완료하면 정보 요청 및 암호 만들기 섹션이 표시됩니다. 필요한 정보를 입력하고 보안 암호를 만듭니다.

서비스 약관을 검토하고 동의한 후 '계정 만들기'를 선택하여 프로세스를 완료합니다. 거기 당신은 그것을 가지고! 계정이 생성되었으며 API를 테스트하기 위해 $25 잔액이 자동으로 생성됩니다.

잔액에 추가하려면 어떻게 해야 하나요?

잔액을 추가하려면 DataMotion 보안 메시지 배달 포털 로 이동하여 사용 가능한 잔액으로 '결제'를 선택합니다. 이름, 회사 및 주소를 입력하고 '다음'을 누릅니다. 여기에서 자동으로 리필되는 되풀이 결제를 설정할 수 있습니다. 일회성 결제를 할 수도 있습니다.

제한 한도

Name 호출 갱신 기간
연결당 API 호출 100 60초

동작

보안 메시지 보내기

데이터가 손상되지 않도록 안전한 방식으로 메시지를 보냅니다.

보안 메시지 철회

이전에 보낸 보안 메시지를 철회합니다.

보안 메시지 추적

보안 메시지를 추적하여 메시지가 배달되고 열리는지 확인합니다.

보안 메시지 보내기

데이터가 손상되지 않도록 안전한 방식으로 메시지를 보냅니다.

매개 변수

Name 필수 형식 Description
부터
From True string

메시지를 보낼 사용자의 주소입니다.

에게
To array of string

보안 메시지의 받는 사람 배열입니다.

Cc
Cc array of string

수신자의 배열로, 보안 메시지에 복사된 탄소입니다.

숨은 참조(비공개 수신자)
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의 버전입니다. 왼쪽 메뉴에서 'API 버전(BaseURL)'을 https://developers.datamotion.com 방문하여 찾을 수 있습니다.

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/.

반환

보안 메시지 응답 모델을 보냅니다.

보안 메시지 철회

이전에 보낸 보안 메시지를 철회합니다.

매개 변수

Name 필수 형식 Description
TransactionId
transactionId True uuid

철회할 보안 메시지의 ID입니다.

v
v True string

API의 버전입니다. 왼쪽 메뉴에서 'API 버전(BaseURL)'을 https://developers.datamotion.com 방문하여 찾을 수 있습니다.

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/.

보안 메시지 추적

보안 메시지를 추적하여 메시지가 배달되고 열리는지 확인합니다.

매개 변수

Name 필수 형식 Description
TransactionId
transactionId True uuid

추적할 보안 메시지의 ID입니다.

v
v True string

API의 버전입니다. 왼쪽 메뉴에서 'API 버전(BaseURL)'을 https://developers.datamotion.com 방문하여 찾을 수 있습니다.

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

보안 메시지 응답 모델을 보냅니다.

Name 경로 형식 Description
TransactionId
TransactionId uuid

트랜잭션의 ID입니다.

NumberOfRecipients
NumberOfRecipients integer

받는 사람의 총 수입니다.

MessageSize
MessageSize integer

메시지의 크기(바이트)입니다.

Expiration
Expiration string

메시지가 만료되는 날짜 시간입니다.

ProjectId
ProjectId uuid

프로젝트의 ID입니다.

ApplicationId
ApplicationId uuid

애플리케이션의 ID

TrackMessageResponse

메시지 추적 개체입니다.

Name 경로 형식 Description
비용
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

메시지 첨부 파일 개체입니다.

Name 경로 형식 Description
AttachmentId
AttachmentId integer

첨부 파일 고유 식별자입니다.

파일명
FileName string

첨부 파일 이름입니다.

ContentId
ContentId object

첨부 파일 콘텐츠 ID(첨부 파일이 인라인 이미지인 경우에만 채워집니다).

콘텐츠 유형
ContentType string

첨부 파일의 미디어 형식입니다.

SecurityEnvelope
SecurityEnvelope object

첨부 파일 보안 봉투.

Size
Size Size

첨부 파일 크기 개체입니다.

추적
Tracking AttachmentTracking

첨부 파일 추적 정보입니다.

추적

메시지 추적 정보입니다.

Name 경로 형식 Description
DateOpened
DateOpened string

메시지를 연 날짜/시간 문자열입니다. 참고: year = 1900이면 현재 메시지 상태와 연결된 DateOpened이 없습니다.

전자 메일
Email string

받는 사람의 전자 메일 주소입니다.

MessageStatusDescription
MessageStatusDescription string

문자열 설명으로 표시되는 상태입니다.

MessageStatusId
MessageStatusId integer

개별 받는 사람의 상태에 대한 숫자 표시기입니다.

ReceiverField
ReceiverField string

이 받는 사람이 메시지의 TO, CC 또는 BCC인지 여부를 나타냅니다.

Size

첨부 파일 크기 개체입니다.

Name 경로 형식 Description
StdString
StdString string

첨부 파일의 크기를 포함하는 문자열 값입니다.

AttachmentTracking

첨부 파일 추적 정보입니다.

Name 경로 형식 Description
받는 사람
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

메시지 받는 사람 개체입니다.

Name 경로 형식 Description
ChecksumValidated
ChecksumValidated integer

0(유효하지 않음), 1(유효함) 또는 2(NotApplied) 값 중 하나입니다.

배송 완료
Delivered boolean

메시지가 배달되었는지 여부를 나타냅니다.

DeliveredDate
DeliveredDate string

메시지가 배달된 시기를 나타내는 DateTime 문자열입니다.

다운로드
Downloaded boolean

첨부 파일이 다운로드되었는지 여부를 나타냅니다.

DownloadedDate
DownloadedDate string

첨부 파일이 다운로드된 시기를 나타내는 DateTime 문자열입니다.

전자 메일
Email string

받는 사람의 전자 메일 주소입니다.