Signhost (Vorschau)
Signhost der Workflowsignierungsdienst von Entrust ist eine digitale Signatur- und Identifikationslösung, die alle Arten von Unternehmen mit nahtlosen und sicheren Onlinetransaktionen unterstützt.
Dieser Connector ist in den folgenden Produkten und Regionen verfügbar:
| Dienstleistung | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche: - US Government (GCC) - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Logik-Apps | Norm | Alle Logik-Apps-Regionen mit Ausnahme der folgenden Bereiche: – Azure Government-Regionen - Azure China-Regionen - US Department of Defense (DoD) |
| Power Apps | Premium | Alle Power Apps-Regionen mit Ausnahme der folgenden: - US Government (GCC) - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Power Automate | Premium | Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche: - US Government (GCC) - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Kontakt | |
|---|---|
| Name | Signhost Customer Success Team |
| URL | https://intercom.help/signhost/en/ |
| support@signhost.com |
| Connectormetadaten | |
|---|---|
| Herausgeber | Signhost |
| Webseite | https://www.signhost.com |
| Datenschutzrichtlinie | https://www.evidos.com/privacy |
| Kategorien | Inhalt und Dateien; Produktivität |
SignHost
Signhost der Workflowsignierungsdienst von Entrust ist eine digitale Signatur- und Identifikationslösung, die alle Arten von Unternehmen mit nahtlosen und sicheren Onlinetransaktionen unterstützt.
Herausgeber
Vertrauen Sie den Niederlanden B.V. an.
Voraussetzungen
Sie benötigen ein SignHost-Abonnement, um diesen Connector verwenden zu können. Sie können einen APIKey aus dem Signhost-Portal generieren.
Unterstützte Vorgänge
Abrufen von Transaktionsdetails
Gibt aktuelle Transaktionsdetails zurück. Verwenden Sie diese Aktion nicht für aktive Abrufe.
Transaktion löschen
Löschen einer Transaktion durch eine Transaktions-ID. Wenn sich eine Transaktion nicht im Endzustand befindet (z. B. vollständig signiert), wird die Transaktion abgebrochen und bereinigt. Eine abgebrochene Transaktion kann angewiesen werden, eine E-Mail-Benachrichtigung an die wartenden Signierer zu senden, dass die Transaktion abgebrochen wurde. Der Status der Transaktion wird so festgelegt, dass sie abgebrochen wird. Wenn sich eine Transaktion in einem Endzustand befindet, wird die Transaktion bereinigt. Der Status der Transaktion bleibt unverändert, aber wir bereinigen alle hochgeladenen Dokumente und vertraulichen Daten so schnell wie möglich.
PDF herunterladen
Gibt das (signierte) Dokument(n) zurück.
Downloadbestätigung
Gibt den Beleg zurück, wenn die Transaktion erfolgreich signiert wurde.
Transaktion erstellen
Erstellt eine neue Transaktion.
Datei hinzufügen
Fügen Sie der Transaktion eine Datei hinzu.
Transaktion starten
Startet eine Transaktion mit derselben {transactionId}.
Abrufen von Anmeldeinformationen
Sie können ein UserToken auf der Einstellungsseite im SignHost-Portal generieren. Stellen Sie sicher, dass Sie das Präfix "APIKey" vor Ihrem UserToken verwenden.
Bekannte Probleme und Einschränkungen
Derzeit werden nicht alle Features unterstützt. Wir freuen uns über Anfragen oder Anfragen an uns.
Bereitstellungsanweisungen
Befolgen Sie die Anweisungen unter Erstellen eines benutzerdefinierten Connectors aus einer OpenAPI-Definition.
Eine Verbindung wird erstellt
Der Connector unterstützt die folgenden Authentifizierungstypen:
| Vorgabe | Parameter zum Erstellen einer Verbindung. | Alle Regionen | Nicht teilbar |
Vorgabe
Anwendbar: Alle Regionen
Parameter zum Erstellen einer Verbindung.
Dies ist keine freigabefähige Verbindung. Wenn die Power-App für einen anderen Benutzer freigegeben wird, wird ein anderer Benutzer aufgefordert, eine neue Verbindung explizit zu erstellen.
| Name | Typ | Description | Erforderlich |
|---|---|---|---|
| Autorisierung | securestring | Geben Sie Ihren APIKey an. | Richtig |
Drosselungsgrenzwerte
| Name | Aufrufe | Verlängerungszeitraum |
|---|---|---|
| API-Aufrufe pro Verbindung | 100 | 60 Sekunden |
Aktionen
| Abrufen von Transaktionsdetails |
Gibt aktuelle Transaktionsdetails zurück. |
| Datei hinzufügen |
Fügen Sie der Transaktion eine Datei hinzu, oder überschreiben Sie eine vorhandene Datei mit derselben {fileId}. |
| Downloadbestätigung |
Gibt den Beleg zurück, wenn die Transaktion erfolgreich signiert wurde (Status=30) |
| PDF herunterladen |
Gibt das (signierte) Dokument(n) zurück. |
| Transaktion erstellen |
Erstellt eine neue Transaktion |
| Transaktion löschen |
Löschen einer Transaktion durch eine Transaktions-ID |
| Transaktion starten |
Startet eine Transaktion mit derselben {transactionId} |
Abrufen von Transaktionsdetails
Gibt aktuelle Transaktionsdetails zurück.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Transaktions-ID
|
transactionId | True | string |
ID der Transaktion |
Gibt zurück
- Body
- Transaction
Datei hinzufügen
Fügen Sie der Transaktion eine Datei hinzu, oder überschreiben Sie eine vorhandene Datei mit derselben {fileId}.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Transaktions-ID
|
transactionId | True | string |
ID einer vorhandenen -- noch nicht gestarteten - Transaktion |
|
Datei-ID
|
fileId | True | string |
Ein eindeutiger Bezeichner, der von Ihnen für die Datei bereitgestellt wird. |
|
Datei-Binärdatei
|
body | True | binary |
Dateiupload |
Downloadbestätigung
Gibt den Beleg zurück, wenn die Transaktion erfolgreich signiert wurde (Status=30)
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Transaktions-ID
|
transactionId | True | string |
ID der Beschreibung |
Gibt zurück
- Content
- binary
PDF herunterladen
Gibt das (signierte) Dokument(n) zurück.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Transaktions-ID
|
transactionId | True | string |
ID der Beschreibung |
|
Name
|
fileId | True | string |
Ein eindeutiger Bezeichner, der von Ihnen für die Datei bereitgestellt wird. |
Gibt zurück
- Content
- binary
Transaktion erstellen
Erstellt eine neue Transaktion
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Dateien
|
Files | object |
Eine Zuordnung von Dateien, die an diese Transaktion angefügt sind. |
|
|
Language
|
Language | string |
Sprache, nur de-DE, en-US, es-ES, fr-FR, it-IT, pl-PL und nl-NL sind zulässig. |
|
|
Siegel
|
Seal | boolean |
Versiegeln Sie das Dokument, bevor Sie an die Signierer senden. |
|
|
Id
|
Id | string |
Die ID des Signierers muss innerhalb einer Transaktion eindeutig sein. |
|
|
Email
|
True | string |
Die E-Mail-Adresse des Signierers |
|
|
IntroText
|
IntroText | string |
Ein Einführungstext, der dem Benutzer während des Signiervorgangs angezeigt wird. |
|
|
Typ
|
Type | True | string |
Typ des Authentifizierungsobjekts. |
|
Number
|
Number | string |
Telefonnummer: Dieses Feld ist obligatorisch, wenn die Authentifizierungsmethode PhoneNumber ausgewählt wird. |
|
|
Bsn
|
Bsn | number |
Dieses Feld ist obligatorisch, wenn die Authentifizierungsmethode BSN ausgewählt wird. |
|
|
Typ
|
Type | True | string |
Typ des Überprüfungsobjekts. |
|
SendSignRequest
|
SendSignRequest | boolean |
Senden Sie eine Signier-Einladung an den Signierer seine E-Mail-Adresse. |
|
|
SignUrl
|
SignUrl | string |
Eine eindeutige URL pro Signierer, die den Signaturfluss für den Signierer bereitstellt. |
|
|
SignRequestSubject
|
SignRequestSubject | string |
Der Betreff der Anmeldeanforderungs-E-Mail in Nur-Text. |
|
|
SignRequestMessage
|
SignRequestMessage | string |
Die Nachricht der Anmeldeanforderung in Nur-Text. |
|
|
SendSignConfirmation
|
SendSignConfirmation | boolean |
Senden Sie die Bestätigung des Zeichens an den Signierer seine E-Mail-Adresse. |
|
|
Language
|
Language | string |
Sprache, nur de-DE, en-US, es-ES, fr-FR, it-IT, pl-PL und nl-NL sind zulässig. |
|
|
ScribbleName
|
ScribbleName | string |
Der Name des Signierers, dies wird im Skizzenformular vorgefüllt. |
|
|
DaysToRemind
|
DaysToRemind | integer |
Die Anzahl der Tage vor dem Erinnern der Signierer. -1 zum Deaktivieren von Erinnerungen. |
|
|
Läuft ab
|
Expires | date-time |
Wenn der Signierer festgelegt ist, darf die Transaktion nach diesem Datum nicht mehr signiert werden. |
|
|
Reference
|
Reference | string |
Der Verweis des Signierers. |
|
|
RejectReason
|
RejectReason | string |
Der Ablehnungsgrund, der vom Signierer beim Ablehnen der Transaktion angegeben wurde. |
|
|
ReturnUrl
|
ReturnUrl | string |
Die URL, an die der Benutzer nach dem Signieren, Ablehnen oder Abbrechen umgeleitet werden soll. |
|
|
Kontext
|
Context | object |
Jedes gültige JSON-Objekt, das zurückgegeben wird. |
|
|
Id
|
Id | string | ||
|
Code
|
Code | integer |
Api-Dokumentation konsultieren |
|
|
Info
|
Info | string |
Kann zusätzliche Informationen enthalten, die zu dieser Aktivität gehören |
|
|
Erstellungsdatum und -uhrzeit
|
CreatedDateTime | date-time | ||
|
Name
|
Name | True | string |
Der Name des Empfängers. |
|
Email
|
True | string |
Die E-Mail-Adresse des Empfängers. |
|
|
Language
|
Language | string |
Sprache, nur de-DE, en-US, es-ES, fr-FR, it-IT und nl-NL zulässig. |
|
|
Betreff
|
Subject | string |
Der Betreff der Empfänger-E-Mail im Nur-Text.The subject of the receiver email in plain text. |
|
|
Nachricht
|
Message | True | string |
Die E-Mail-Nachricht gegenüber dem Empfänger im Nur-Text-Format. |
|
Reference
|
Reference | string |
Der Bezug des Empfängers. |
|
|
Kontext
|
Context | object |
Jedes gültige JSON-Objekt, das zurückgegeben wird. |
|
|
Reference
|
Reference | string |
Der Verweis auf die Transaktion. |
|
|
PostbackUrl
|
PostbackUrl | string |
Die absolute URL zum Postback der Statusaktualisierungen. |
|
|
SignRequestMode
|
SignRequestMode | integer |
Legen Sie für das Gleichzeitige Senden auf 1 fest, auf 2 für sequenzielles Senden. |
|
|
DaysToExpire
|
DaysToExpire | integer |
Die Anzahl der Tage vor Ablauf. Max. 90 Tage. |
Gibt zurück
- Body
- Transaction
Transaktion löschen
Löschen einer Transaktion durch eine Transaktions-ID
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Transaktions-ID
|
transactionId | True | string |
ID der Transaktion |
|
SendNotifications
|
SendNotifications | boolean |
Senden Sie E-Mail-Benachrichtigungen an die wartenden Signierer. |
|
|
Ursache
|
Reason | string |
Der Grund der Kündigung. |
Transaktion starten
Startet eine Transaktion mit derselben {transactionId}
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Transaktions-ID
|
transactionId | True | string |
ID einer vorhandenen -- noch nicht gestarteten - Transaktion |
Definitionen
Transaktion
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Id
|
Id | string |
Die ID der Transaktion. |
|
Dateien
|
Files | array of object | |
|
Links
|
Files.Links | array of object | |
|
Rel
|
Files.Links.Rel | string | |
|
Typ
|
Files.Links.Type | string | |
|
Link
|
Files.Links.Link | string | |
|
Anzeigename
|
Files.DisplayName | string | |
|
Language
|
Language | string |
Die Sprache, nur de-DE, en-US, es-ES, fr-FR, it-IT, pl-PL und nl-NL zulässig. |
|
Siegel
|
Seal | boolean |
Versiegeln Sie das Dokument, bevor Sie an die Signierer senden. |
|
Unterzeichner
|
Signers | array of object |
Die Signiererinformationen. |
|
Id
|
Signers.Id | string |
Die ID des Signierers muss innerhalb einer Transaktion eindeutig sein. |
|
Email
|
Signers.Email | string |
Die E-Mail-Adresse des Signierers |
|
IntroText
|
Signers.IntroText | string |
Ein Einführungstext, der dem Benutzer während des Signiervorgangs angezeigt wird. |
|
Beglaubigungen
|
Signers.Authentications | array of Authentication |
Liste der Authentifizierungen, bei denen der Signierer authentifiziert werden muss. |
|
Überprüfungen
|
Signers.Verifications | array of Verification |
Liste der Überprüfungen, mit denen der Signierer überprüfen muss. |
|
SendSignRequest
|
Signers.SendSignRequest | boolean |
Senden Sie eine Signier-Einladung an den Signierer seine E-Mail-Adresse. |
|
SignUrl
|
Signers.SignUrl | string |
Eine eindeutige URL pro Signierer, die den Signaturfluss für den Signierer bereitstellt. |
|
SignRequestSubject
|
Signers.SignRequestSubject | string |
Der Betreff der Anmeldeanforderungs-E-Mail in Nur-Text. |
|
SignRequestMessage
|
Signers.SignRequestMessage | string |
Die Nachricht der Anmeldeanforderung in Nur-Text. |
|
SendSignConfirmation
|
Signers.SendSignConfirmation | boolean |
Senden Sie die Bestätigung des Zeichens an den Signierer seine E-Mail-Adresse. |
|
Language
|
Signers.Language | string |
Nur de-DE, en-US, es-ES, fr-FR, it-IT, pl-PL und nl-NL sind zulässig. |
|
ScribbleName
|
Signers.ScribbleName | string |
Der Name des Signierers, dies wird im Skizzenformular vorgefüllt. |
|
DaysToRemind
|
Signers.DaysToRemind | integer |
Die Anzahl der Tage vor dem Erinnern der Signierer. |
|
Läuft ab
|
Signers.Expires | date-time |
Wenn der Signierer festgelegt ist, darf die Transaktion nach diesem Datum nicht mehr signiert werden. |
|
Reference
|
Signers.Reference | string |
Der Verweis des Signierers. |
|
RejectReason
|
Signers.RejectReason | string |
Der Ablehnungsgrund, der vom Signierer beim Ablehnen der Transaktion angegeben wurde. |
|
ReturnUrl
|
Signers.ReturnUrl | string |
Die URL, an die der Benutzer nach dem Signieren, Ablehnen oder Abbrechen umgeleitet werden soll. |
|
Kontext
|
Signers.Context | object |
Jedes gültige JSON-Objekt, das zurückgegeben wird. |
|
Activities
|
Signers.Activities | array of object |
Liste der an diesen Signierer angefügten Aktivitäten. |
|
Id
|
Signers.Activities.Id | string | |
|
Code
|
Signers.Activities.Code | integer |
|
|
Info
|
Signers.Activities.Info | string |
Kann zusätzliche Informationen enthalten, die zu dieser Aktivität gehören |
|
Erstellungsdatum und -uhrzeit
|
Signers.Activities.CreatedDateTime | date-time | |
|
Empfänger
|
Receivers | array of object | |
|
Name
|
Receivers.Name | string |
Der Name des Empfängers. |
|
Email
|
Receivers.Email | string |
Die E-Mail-Adresse des Empfängers. |
|
Language
|
Receivers.Language | string |
Die Sprache des Empfängers, nur de-DE, en-US, es-ES, fr-FR, it-IT und nl-NL sind zulässig. |
|
Betreff
|
Receivers.Subject | string |
Der Betreff der Empfänger-E-Mail im Nur-Text.The subject of the receiver email in plain text. |
|
Nachricht
|
Receivers.Message | string |
Die E-Mail-Nachricht gegenüber dem Empfänger im Nur-Text-Format. |
|
Reference
|
Receivers.Reference | string |
Der Bezug des Empfängers. |
|
Kontext
|
Receivers.Context | object |
Jedes gültige JSON-Objekt, das zurückgegeben wird. |
|
Reference
|
Reference | string |
Der Verweis auf die Transaktion. Beispiel: "1234" |
|
PostbackUrl
|
PostbackUrl | string |
Die absolute URL zum Postback der Statusaktualisierungen. |
|
SignRequestMode
|
SignRequestMode | integer |
Legen Sie für das Gleichzeitige Senden auf 1 fest, auf 2 für sequenzielles Senden. |
|
DaysToExpire
|
DaysToExpire | integer |
Die Anzahl der Tage vor Ablauf. Max. 90 Tage. |
|
SendEmailNotifications
|
SendEmailNotifications | boolean |
Senden sie E-Mail-Benachrichtigungen an den Absender. |
|
Der Status
|
Status | integer |
Aktueller Transaktionsstatus. |
|
CancelationReason
|
CancelationReason | string |
Der ursprüngliche Abbruchgrund, der während eines DELETE-Anrufs angegeben wurde. |
|
Kontext
|
Context | object |
Jedes gültige JSON-Objekt, das zurückgegeben wird. |
Authentifizierung
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Typ
|
Type | string |
Typ des Authentifizierungsobjekts. |
|
Number
|
Number | string |
Telefonnummer: Dieses Feld ist obligatorisch, wenn die Authentifizierungsmethode PhoneNumber ausgewählt wird. |
|
Bsn
|
Bsn | number |
Dieses Feld ist obligatorisch, wenn die Authentifizierungsmethode BSN ausgewählt wird. |
Verifizierung
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Typ
|
Type | string |
Typ des Überprüfungsobjekts. |
binär
Dies ist der grundlegende Datentyp "binary".