Signaturprovider

DeepSign

Provider-ID: DeepSign

v2

Ab der Version 7.3 der DocumentSign API kann der DeepSign-Client V2 verwendet werden. Dies muss in der DeepSign-Konfiguration der DocumentSign API vermerkt werden.

Für Neuinstallationen muss die Version 2 verwendet werden, siehe ClientId

Achtung: Um zu migrieren ist es nötig die DeepSign-Servicebenutzer neu zu erstellen! Trotzdem wird dringend empfohlen dieses Update durchzuführen.

Der Servicebenutzer muss im anschluss hier hinterlegt werden. Das Erstellen des Servicebenutzers wird ebenfalls hier beschrieben.

Signaturprofil

Signieren

Um mit DeepSign zu signieren, braucht es keine JSON-Konfiguration im Signaturprofil. Als JSON Konfiguration kann in jedem Fall {} verwendet werden.

Siegeln

Um mit DeepSign zu siegeln, muss eine JSON-Konfiguration im Signaturprofil hinterlegt werden. Diese muss mindestens die Information enthalten, dass gesiegelt werden soll, sowie die ID des anzuwendenden Siegels

Achtung: das Siegeln ist nur mit dem DeepSign-Client v2 möglich!

Parameter	Beschreibung	Standard
IsSeal	Muss auf "true" gesetzt werden, um zu siegeln	false
SealDisplayName	Der Anzeigename des Siegels, mit welchem gesiegelt werden soll. Existieren mehrere Siegel mit dem gleichen Anzeienamen, so muss das Property "SealId" definiert werden. Dieses muss die eindeutige ID des Siegels beinhalten
autographPosition	Definiert die Position und Grösse des visuellen Siegelfeldes (wenn weggelassen, wird das Siegel nicht sichtbar sein)
scanPredefined	false - Vordefinierte Unterschriften und Siegel im Dokument werden nicht gescannt, true - Das Dokument wird nach vordefinierten Testmusterfeldern gescannt	false
acceptSealIds	Eine Liste von erlaubten sealId's, um sicherzustellen, dass nur sealId's für den angegebenen Dienstbenutzer und die Unternehmensunterzeichner verwendet werden. Um alle Siegel zu erlauben, verwenden Sie ["*"]	["*"]

Die folgenden Parameter stehen in "autographPosition" zur Verfügung, um die Position und Grösse des visuellen Siegelfeldes zu definieren. Alternativ kann im Dokument auch ein Platzhalter definiert werden, mehr Informationen dazu in der Dokumentation von DeepSign

Parameter	Beschreibung
pageNumber	Die Seitenzahl im Dokument (z. B. 1, 2, 3 usw.)
x	Die horizontale Position des Siegelfeldes in "pts" von der unteren linken Ecke der Seite aus
y	Die vertikale Position des Siegelfeldes in "pts" von der unteren linken Ecke der Seite aus
width	Die Breite des Siegelfeldes in pts (Standardbreite ist 159.00 "pts")
height	Die Höhe des Siegelfeldes in pts (Standardhöhe ist 84.00 "pts")

Evidence (Glaux Group)

Provider-ID: Evidence

Signaturprofil

Um mit Evidence zu signieren, braucht es keine JSON-Konfiguration im Signaturprofil. Als JSON Konfiguration kann in jedem Fall {} verwendet werden.

SignLive (intarsys)

Provider-ID: SignLive

Je nach Konfiguration kann mittels SignLive ein Dokument gesiegelt oder mit einer persönlichen Signatur versehen werden.

Variante A: Dokumente können nur vom konfigurierten und angemeldeten User signiert werden. (Keine Signatureinladungen) Variante B (Braucht JSON Config): Dokumente können zum signieren an andere User versendet werden.

Signaturprofil

Im Signaturprofil können die folgenden Json-Properties gesetzt werden:

Configuration => SignLive Configuration
Args => SignLive Args
Options => SignLive Options
Variables => SignLive Variables
CreateSignPreparationViewer => Steuert ob der Viewer-Flow oder SignerFlow ausgelöst wird

Beispiel-JSON-Konfiguration für ein Signaturprofil zum Siegeln

Aufbau der im Signaturprofil referenzierten Basiskonfiguration:

{
  "SignerConfiguration": "SignerAISSeal"
}

Signaturprofil zum Siegeln (benutzerunabhängig):

{
  "Args": {
    "documentSigner": {
      "args": {
        "field": {
          "create": "true",
          "name": "signature",
          "pageRange": "${tags.meta.signature.page}",
          "position": "${tags.meta.signature.llx}*${tags.meta.signature.lly}",
          "size": "${tags.meta.signature.width}*100"
        }
      }
    },
    "documentTagDetector": {
      "args": {
        "syntax": "separated"
      },
      "factory": "de.intarsys.document.app.pdf.tags.PDFContentTagDetectorFactory"
    }
  },
  "Options": {
    "principal": {
      "claims": {
        "visibleName": "myvisibleNamefromoptions"
      },
      "name": "mandatory"
    }
  }
}

Beispiel-JSON-Konfiguration für ein Signaturprofil für die persönliche Signatur

Aufbau der im Signaturprofil referenzierten Basiskonfiguration:

{
  "CreateSignPreparationViewer": true,
  "Configuration": "klu_default"
}

Signaturprofil für die persönliche Signatur (benutzerabhängig):

{
  "Options": {
    "principal": {
      "claims": {
        "c": "ch",
        "emailaddress": "test@cmiaag.ch",
        "givenname": "Test",
        "msisdn": "+41778877889",
        "surname": "Müller",
        "visibleName": "Test Müller"
      },
      "name": "Test Müller"
    }
  }
}

SwissSign

Provider-ID: SwissSign

Für SwissSign kann der erweiterte Wizard aktiviert werden.

Skribble

Provider-ID: Skribble

Für Skribble kann der erweiterte Wizard aktiviert werden.

Signaturprofil

Im Signaturprofil kann folgendes zusätzlich eingestellt werden:

Quality

Definiert den verwendeten E-Signatur Standard. Es gibt folgende Optionen: QES, AES, AES_MINIMAL, SES, DEMO. Diese Einstellung ist optional, der Standardwert ist QES. Zur Scribble Dokumentation

{
  "quality": "AES"
}

Legislation

Definiert nach welchem Recht QES und AES_MINIMAL definiert sind. Es gibt folgende Optionen: ZERTES (Schweiz), EIDAS (EU). Diese Einstellung ist optional, der Standardwert ist ZERTES. Zur Scribble Dokumentation

{
  "legislation": "ZERTES"
}

Seal

Boolean, versiegelt oder Signiert werden soll. Diese Einstellung ist optional. Standardmässig ist dies auf false gesetzt.

{
  "Seal": true,
  "account_name": "ais_company_seal_some_department"
}

Mit Seal kann zusätzlich ein account_name mitgegeben werden, welcher beim Siegeln definiert, welches Siegel genommen wird. Es wird standardmässig der erste genommen. Diese Einstellung ist optional. Zur Scribble Dokumentation

Signatures

Liste von Signuatur-Objekten welche die Mail-Adresse von Personen enthalten, welche zur Signatur eingeladen werden sollen. Diese Einstellung ist optional.

{
  "Signatures": [
    {
      "account_email": "luca.guettinger@cmiag.ch"
    }
  ]
}

PrivaSphere

Provider-ID: PrivaSphere

Für PrivaSphere kann der erweiterte Wizard aktiviert werden.

Signaturprofil

Im Signaturprofil kann folgendes zusätzlich eingestellt werden:

SignatureType

Definiert den verwendeten E-Signatur Standard. Es gibt folgende Optionen: QES und AES_SIMPLE. Diese Einstellung ist optional, der Standardwert ist QES.

{
  "signature_type": "OES"
}

ReminderTimeInDays

Definiert nach wie vielen Tagen eine Erinnerungsemail versendet wird. Diese Einstellung ist optional. Standardmässig ist dies auf 10 gesetzt.

{
  "reminder_time_in_days": 10
}

ExpirationInDays

Definiert nach wie vielen Tagen eine SignRequest abläuft. Diese Einstellung ist optional. Standardmässig ist dies auf 30 gesetzt.

{
  "reminder_time_in_days": 30
}

Comment

Definiert einen Kommentar, welcher in der SignRequest angezeigt wird. Diese Einstellung ist optional.

{
  "comment": "Dies ist ein Kommentar"
}

Initiator

Definiert den Initiator der SignRequest. Diese Einstellung ist optional. Standardmässig ist dies der angemeldete Benutzer.

{
  "initiator": "test@cmiag.ch"
}

XiTrust

Provider-ID: XiTrust

Erweiterter Wizard

Für XiTrust kann der erweiterte Wizard aktiviert werden.

Signaturprofil

Folgende Einstellungen können im Signaturprofil gemacht werden. Es müssen alle Attribute ausser Seal und ReferenceId zwingend angegeben werden.

{
  "ProcessId": "[ProcessId]",
  "Category": "[Signaturkategorie]",
  "Description": "[Signaturauftragszusammenfassung]",
  "ReferenceId": "[ReferenceId]",
  "Seal": "[Seal]"
}

ProcessId

Die XiTrust ProcessId, mit der die Signatur erstellt werden sollte.

Description

Eine Beschreibung des Signaturauftrages

ReferenceId

Die ReferenzID, die in XiTrust Moxis angezeigt wird. Hat keine technischen Auswirkungen und muss nicht zwingend angegeben werden. Der Defaultwert ist CMI.

Seal (Siegel)

Diese Option muss aktiviert werden, damit ein Signaturauftrag mit Siegel im CMI als Schlussversion abgelegt wird. Dabei wird die normalerweise gültige Konfiguration im CMI für den Dokumentstatus nach dem Signieren übersteuert.\ Wichtig: Es reicht NICHT aus, für einen Siegel nur diese Option zu aktivieren. Es müssen auch der ProcessId und die Category korrekt konfiguriert werden. Der Defaultwert ist false.

Beispiel für ein Signaturprofil

{
  "description": "Testsignatur",
  "category":"EXTERNAL_QSIG",
  "processId": "114dbb5d-ff66-4626-9aca-9ce48ad5ca17",
  "seal": true
}