Signhost(미리 보기)
Entrust의 워크플로 서명 서비스 Signhost는 모든 유형의 비즈니스에 원활하고 안전한 온라인 트랜잭션을 제공하는 디지털 서명 및 식별 솔루션입니다.
이 커넥터는 다음 제품 및 지역에서 사용할 수 있습니다.
| 서비스 | 클래스 | 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) |
| 연락처 | |
|---|---|
| 이름 | Signhost 고객 성공 팀 |
| URL | https://intercom.help/signhost/en/ |
| 전자 메일 | support@signhost.com |
| 커넥터 메타데이터 | |
|---|---|
| 게시자 | Signhost |
| 웹 사이트 | https://www.signhost.com |
| 개인 정보 보호 정책 | https://www.evidos.com/privacy |
| 카테고리 | 콘텐츠 및 파일; 생산력 |
SignHost
Entrust의 워크플로 서명 서비스 Signhost는 모든 유형의 비즈니스에 원활하고 안전한 온라인 트랜잭션을 제공하는 디지털 서명 및 식별 솔루션입니다.
게시자
Entrust 네덜란드 B.V.
필수 조건
이 커넥터를 사용하려면 SignHost 구독이 필요합니다. Signhost 포털에서 APIKey를 생성할 수 있습니다.
지원되는 작업
트랜잭션 세부 정보 가져오기
현재 트랜잭션 세부 정보를 반환합니다. 활성 폴링에는 이 작업을 사용하지 마세요.
트랜잭션 삭제
트랜잭션 ID로 트랜잭션을 삭제합니다. 트랜잭션이 최종 상태가 아닌 경우(예: 완전히 서명됨) 트랜잭션이 취소되고 정리됩니다. 취소된 트랜잭션은 대기 중인 서명자에게 트랜잭션이 취소되었다는 전자 메일 알림을 보내도록 할 수 있습니다. 트랜잭션 상태가 취소됨으로 설정됩니다. 트랜잭션이 최종 상태이면 트랜잭션이 정리됩니다. 트랜잭션 상태는 동일하게 유지되지만 업로드된 문서와 중요한 데이터는 가능한 한 빨리 정리합니다.
PDF 다운로드
서명된 문서를 반환합니다.
다운로드 영수증
트랜잭션이 성공적으로 서명되면 영수증을 반환합니다.
트랜잭션 만들기
새 트랜잭션을 만듭니다.
파일 추가
트랜잭션에 파일을 추가합니다.
트랜잭션 시작
동일한 {transactionId}를 사용하여 트랜잭션을 시작합니다.
자격 증명 가져오기
SignHost 포털의 설정 페이지에서 사용자 토큰을 생성할 수 있습니다. 사용자 토큰 앞에 'APIKey' 접두사를 사용해야 합니다.
알려진 문제 및 제한 사항
현재 모든 기능이 지원되지는 않습니다. 모든 요청 또는 문의를 통해 연락해 주시면 환영합니다.
배포 지침
OpenAPI 정의에서 사용자 지정 커넥터 만들기의 지침을 따르세요.
연결을 만드는 중
커넥터는 다음 인증 유형을 지원합니다.
| 기본값 | 연결을 만들기 위한 매개 변수입니다. | 모든 지역 | 공유할 수 없음 |
기본값
적용 가능: 모든 지역
연결을 만들기 위한 매개 변수입니다.
공유 가능한 연결이 아닙니다. 전원 앱이 다른 사용자와 공유되면 다른 사용자에게 새 연결을 명시적으로 만들라는 메시지가 표시됩니다.
| 이름 | 유형 | Description | 필수 |
|---|---|---|---|
| Authorization | 시큐어스트링 (보안 문자열) | APIKey를 제공합니다. | 진실 |
제한 한도
| Name | 호출 | 갱신 기간 |
|---|---|---|
| 연결당 API 호출 | 100 | 60초 |
동작
| pdf 다운로드 |
서명된 문서를 반환합니다. |
| 다운로드 영수증 |
트랜잭션이 성공적으로 서명되면 영수증을 반환합니다(Status=30). |
| 트랜잭션 만들기 |
새 트랜잭션을 만듭니다. |
| 트랜잭션 삭제 |
트랜잭션 ID로 트랜잭션 삭제 |
| 트랜잭션 세부 정보 가져오기 |
현재 트랜잭션 세부 정보를 반환합니다. |
| 트랜잭션 시작 |
동일한 {transactionId}를 사용하여 트랜잭션을 시작합니다. |
| 파일 추가 |
트랜잭션에 파일을 추가하거나 동일한 {fileId}를 사용하여 기존 파일을 덮어씁 수 있습니다. |
pdf 다운로드
서명된 문서를 반환합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
트랜잭션 ID
|
transactionId | True | string |
설명의 ID |
|
이름
|
fileId | True | string |
파일에 대해 사용자가 제공한 고유 식별자입니다. |
반환
- Content
- binary
다운로드 영수증
트랜잭션이 성공적으로 서명되면 영수증을 반환합니다(Status=30).
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
트랜잭션 ID
|
transactionId | True | string |
설명의 ID |
반환
- Content
- binary
트랜잭션 만들기
새 트랜잭션을 만듭니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
Files
|
Files | object |
이 트랜잭션에 연결된 파일의 맵입니다. |
|
|
Language
|
Language | string |
언어는 de-DE, en-US, es-ES, fr-FR, it-IT, pl-PL 및 nl-NL 허용됩니다. |
|
|
도장
|
Seal | boolean |
서명자에게 보내기 전에 문서를 봉인합니다. |
|
|
아이디
|
Id | string |
서명자의 ID는 트랜잭션 내에서 고유해야 합니다. |
|
|
전자 메일
|
True | string |
서명자의 전자 메일 주소 |
|
|
IntroText
|
IntroText | string |
서명 프로세스 중에 사용자에게 표시할 소개 텍스트입니다. |
|
|
유형
|
Type | True | string |
인증 개체의 형식입니다. |
|
Number
|
Number | string |
전화 번호: 인증 방법 PhoneNumber를 선택한 경우 이 필드는 필수입니다. |
|
|
Bsn
|
Bsn | number |
인증 방법 BSN을 선택하는 경우 이 필드는 필수입니다. |
|
|
유형
|
Type | True | string |
확인 개체의 형식입니다. |
|
SendSignRequest
|
SendSignRequest | boolean |
서명자에게 자신의 전자 메일 주소로 서명 초대를 보냅니다. |
|
|
SignUrl
|
SignUrl | string |
서명자에 대한 서명 흐름을 제공하는 서명자당 고유한 URL입니다. |
|
|
SignRequestSubject
|
SignRequestSubject | string |
일반 텍스트로 된 서명 요청 전자 메일의 제목입니다. |
|
|
SignRequestMessage
|
SignRequestMessage | string |
일반 텍스트로 된 서명 요청의 메시지입니다. |
|
|
SendSignConfirmation
|
SendSignConfirmation | boolean |
서명자에게 자신의 전자 메일 주소로 서명 확인을 보냅니다. |
|
|
Language
|
Language | string |
언어는 de-DE, en-US, es-ES, fr-FR, it-IT, pl-PL 및 nl-NL 허용됩니다. |
|
|
ScribbleName
|
ScribbleName | string |
서명자의 이름입니다. 이 이름은 낙서 형식으로 미리 채워집니다. |
|
|
DaysToRemind
|
DaysToRemind | integer |
서명자를 상기시키기 전의 일 수입니다. 미리 알림을 사용하지 않도록 설정하려면 -1입니다. |
|
|
만료
|
Expires | date-time |
설정할 때 서명자는 더 이상 이 날짜 이후에 트랜잭션에 서명할 수 없습니다. |
|
|
Reference
|
Reference | string |
서명자의 참조입니다. |
|
|
RejectReason
|
RejectReason | string |
트랜잭션이 거부되었을 때 서명자가 제공한 거부 이유입니다. |
|
|
ReturnUrl
|
ReturnUrl | string |
서명, 거부 또는 취소 후 사용자를 리디렉션할 URL입니다. |
|
|
컨텍스트
|
Context | object |
반환할 유효한 json 개체입니다. |
|
|
아이디
|
Id | string | ||
|
코드
|
Code | integer |
API 설명서 참조 |
|
|
Info
|
Info | string |
이 활동에 속하는 추가 정보가 포함될 수 있음 |
|
|
생성일시
|
CreatedDateTime | date-time | ||
|
이름
|
Name | True | string |
받는 사람의 이름입니다. |
|
전자 메일
|
True | string |
받는 사람의 전자 메일 주소입니다. |
|
|
Language
|
Language | string |
언어, de-DE, en-US, es-ES, fr-FR, it-IT 및 nl-NL 허용됩니다. |
|
|
주제
|
Subject | string |
일반 텍스트로 된 수신자 전자 메일의 제목입니다. |
|
|
Message
|
Message | True | string |
일반 텍스트로 받는 사람의 전자 메일 메시지입니다. |
|
Reference
|
Reference | string |
수신기의 참조입니다. |
|
|
컨텍스트
|
Context | object |
반환할 유효한 json 개체입니다. |
|
|
Reference
|
Reference | string |
트랜잭션의 참조입니다. |
|
|
PostbackUrl
|
PostbackUrl | string |
상태 업데이트를 포스트백할 절대 URL입니다. |
|
|
SignRequestMode
|
SignRequestMode | integer |
한 번에 보내는 경우 1로 설정하고 순차적으로 2로 설정합니다. |
|
|
DaysToExpire
|
DaysToExpire | integer |
만료 전의 일 수입니다. 최대 90일 |
반환
트랜잭션 삭제
트랜잭션 ID로 트랜잭션 삭제
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
트랜잭션 ID
|
transactionId | True | string |
트랜잭션의 ID |
|
SendNotifications
|
SendNotifications | boolean |
대기 중인 서명자에게 전자 메일 알림을 보냅니다. |
|
|
이유
|
Reason | string |
취소 이유입니다. |
트랜잭션 세부 정보 가져오기
현재 트랜잭션 세부 정보를 반환합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
트랜잭션 ID
|
transactionId | True | string |
트랜잭션의 ID |
반환
트랜잭션 시작
동일한 {transactionId}를 사용하여 트랜잭션을 시작합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
트랜잭션 ID
|
transactionId | True | string |
아직 시작되지 않은 기존 트랜잭션의 ID |
파일 추가
트랜잭션에 파일을 추가하거나 동일한 {fileId}를 사용하여 기존 파일을 덮어씁 수 있습니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
트랜잭션 ID
|
transactionId | True | string |
아직 시작되지 않은 기존 트랜잭션의 ID |
|
파일 ID
|
fileId | True | string |
파일에 대해 사용자가 제공한 고유 식별자입니다. |
|
파일 이진 파일
|
body | True | binary |
파일 업로드 |
정의
트랜잭션
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
아이디
|
Id | string |
트랜잭션의 ID입니다. |
|
Files
|
Files | array of object | |
|
Links
|
Files.Links | array of object | |
|
Rel (Rel)
|
Files.Links.Rel | string | |
|
유형
|
Files.Links.Type | string | |
|
Link
|
Files.Links.Link | string | |
|
디스플레이 이름
|
Files.DisplayName | string | |
|
Language
|
Language | string |
언어는 de-DE, en-US, es-ES, fr-FR, it-IT, pl-PL 및 nl-NL 허용됩니다. |
|
도장
|
Seal | boolean |
서명자에게 보내기 전에 문서를 봉인합니다. |
|
서명자
|
Signers | array of object |
서명자 정보입니다. |
|
아이디
|
Signers.Id | string |
서명자의 ID는 트랜잭션 내에서 고유해야 합니다. |
|
전자 메일
|
Signers.Email | string |
서명자의 전자 메일 주소 |
|
IntroText
|
Signers.IntroText | string |
서명 프로세스 중에 사용자에게 표시할 소개 텍스트입니다. |
|
인증
|
Signers.Authentications | array of Authentication |
서명자가 인증해야 하는 인증 목록입니다. |
|
확인
|
Signers.Verifications | array of Verification |
서명자가 확인해야 하는 확인 목록입니다. |
|
SendSignRequest
|
Signers.SendSignRequest | boolean |
서명자에게 자신의 전자 메일 주소로 서명 초대를 보냅니다. |
|
SignUrl
|
Signers.SignUrl | string |
서명자에 대한 서명 흐름을 제공하는 서명자당 고유한 URL입니다. |
|
SignRequestSubject
|
Signers.SignRequestSubject | string |
일반 텍스트로 된 서명 요청 전자 메일의 제목입니다. |
|
SignRequestMessage
|
Signers.SignRequestMessage | string |
일반 텍스트로 된 서명 요청의 메시지입니다. |
|
SendSignConfirmation
|
Signers.SendSignConfirmation | boolean |
서명자에게 자신의 전자 메일 주소로 서명 확인을 보냅니다. |
|
Language
|
Signers.Language | string |
de-DE, en-US, es-ES, fr-FR, it-IT, pl-PL 및 nl-NL 허용됩니다. |
|
ScribbleName
|
Signers.ScribbleName | string |
서명자의 이름입니다. 이 이름은 낙서 형식으로 미리 채워집니다. |
|
DaysToRemind
|
Signers.DaysToRemind | integer |
서명자를 상기시키기 전의 일 수입니다. |
|
만료
|
Signers.Expires | date-time |
설정할 때 서명자는 더 이상 이 날짜 이후에 트랜잭션에 서명할 수 없습니다. |
|
Reference
|
Signers.Reference | string |
서명자의 참조입니다. |
|
RejectReason
|
Signers.RejectReason | string |
트랜잭션이 거부되었을 때 서명자가 제공한 거부 이유입니다. |
|
ReturnUrl
|
Signers.ReturnUrl | string |
서명, 거부 또는 취소 후 사용자를 리디렉션할 URL입니다. |
|
컨텍스트
|
Signers.Context | object |
반환할 유효한 json 개체입니다. |
|
Activities
|
Signers.Activities | array of object |
이 서명자에 연결된 활동 목록입니다. |
|
아이디
|
Signers.Activities.Id | string | |
|
코드
|
Signers.Activities.Code | integer |
|
|
Info
|
Signers.Activities.Info | string |
이 활동에 속하는 추가 정보가 포함될 수 있음 |
|
생성일시
|
Signers.Activities.CreatedDateTime | date-time | |
|
수신기
|
Receivers | array of object | |
|
이름
|
Receivers.Name | string |
받는 사람의 이름입니다. |
|
전자 메일
|
Receivers.Email | string |
받는 사람의 전자 메일 주소입니다. |
|
Language
|
Receivers.Language | string |
수신기의 언어는 de-DE, en-US, es-ES, fr-FR, it-IT 및 nl-NL 허용됩니다. |
|
주제
|
Receivers.Subject | string |
일반 텍스트로 된 수신자 전자 메일의 제목입니다. |
|
Message
|
Receivers.Message | string |
일반 텍스트로 받는 사람의 전자 메일 메시지입니다. |
|
Reference
|
Receivers.Reference | string |
수신기의 참조입니다. |
|
컨텍스트
|
Receivers.Context | object |
반환할 유효한 json 개체입니다. |
|
Reference
|
Reference | string |
트랜잭션의 참조입니다. 예: "1234" |
|
PostbackUrl
|
PostbackUrl | string |
상태 업데이트를 포스트백할 절대 URL입니다. |
|
SignRequestMode
|
SignRequestMode | integer |
한 번에 보내는 경우 1로 설정하고 순차적으로 2로 설정합니다. |
|
DaysToExpire
|
DaysToExpire | integer |
만료 전의 일 수입니다. 최대 90일 |
|
SendEmailNotifications
|
SendEmailNotifications | boolean |
보낸 사람에게 전자 메일 알림을 보냅니다. |
|
상태
|
Status | integer |
현재 트랜잭션 상태입니다. |
|
CancelationReason
|
CancelationReason | string |
DELETE 호출 중에 지정된 원래 취소 이유입니다. |
|
컨텍스트
|
Context | object |
반환할 유효한 json 개체입니다. |
Authentication
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
유형
|
Type | string |
인증 개체의 형식입니다. |
|
Number
|
Number | string |
전화 번호: 인증 방법 PhoneNumber를 선택한 경우 이 필드는 필수입니다. |
|
Bsn
|
Bsn | number |
인증 방법 BSN을 선택하는 경우 이 필드는 필수입니다. |
확인
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
유형
|
Type | string |
확인 개체의 형식입니다. |
이진법
기본 데이터 형식 'binary'입니다.