Automatische qualifizierte elektronische Signatur mit OTP

Die Automatische Qualifizierte Elektronische Signatur (QES) mit OTP ist die Lösung über API zur Automatisierung und Vereinfachung von Unterschriftsprozessen, in voller Übereinstimmung mit den europäischen Vorschriften.

Der Service ist flexibel und anpassbar. Insbesondere können folgende Optionen ausgewählt werden:

Es gibt keine jährlichen Gebühren: Die einzige feste Gebühr ist die Aktivierung des Zertifikats (99€). Danach werden nur die tatsächlichen Verwendungen in Rechnung gestellt.

Die Automatische Qualifizierte Elektronische Signatur-Unterschrift ist auch auf Openapi für juristische Personen verfügbar, über einen speziellen Dienst (Qualifizierter Elektronischer Siegel).

Die elektronische Signatur hat volle europäische Gültigkeit: Sie ist durch die eIDAS-Verordnung vom Recht der Europäischen Union anerkannt.

Die Lösung kann über API in Verwaltungssoftware, Software und Websites integriert werden, um die Unterzeichnung großer Mengen von Dokumenten sofort und sicher zu machen.

Bevor Sie mit der Verwendung der Qualifizierten Elektronischen Unterschrift mit OTP beginnen, müssen Sie ein Signaturzertifikat über den dedizierten Endpunkt POST /certificates/namirial-otp kaufen. Für das Identifizierungsverfahren ist die Videoerkennung im Preis inbegriffen, die vom Büro oder von zu Hause aus in Sekundenschnelle durchgeführt werden kann. Alternativ sind auch andere Identifikationsverfahren über SPID, CIE, CNS, Digitale Signatur möglich.

Nach der Aktivierung des Zertifikats ist es möglich, den spezifischen automatischen Signaturdienst zu nutzen, der über API entweder mit OTP oder ohne OTP verfügbar ist (im letzteren Fall lautet der Referenzendpunkt EU-QES_automatic).

Antrag auf qualifizierte elektronische Signatur mit OTP (EU-QES_otp)

POST/EU-QES_otp

Der Endpunkt POST/EU-QES_otp ermöglicht das Anbringen der elektronischen Unterschrift über die API.

{
 "inputDocument":[
  {
  	"sourceType": "remote",
	  "url": "https://my-domain.com/remoteResource.pdf",
  },
  {
	  "sourceType": "remote",
	  "payload": "BASE64string",
  }
],
 "certificateUsername": "[email protected]",
 "certificatePassword": "password123",
 "title": "PAdES Signature",
 "description": "PAdES-Signatur eines entfernten und base64-kodierten Dokuments",
 "signatureType": "pades",
}

Die erforderlichen Felder für die Durchführung der Signatur sind:

Wenn das Feld signatureType nicht angegeben wird, sucht das System das geeignetste Format (CAdES, PAdES, XAdES und PKCS#1) basierend auf dem mimeType der hochgeladenen Datei.

Wie oben erwähnt, ist der Service äußerst flexibel und ermöglicht - über die verschiedenen Optionen - die Konfiguration der Validierungs- und Signaturmethoden des Dokuments (synchron oder asynchron), des Signaturniveaus, des Hash-Algorithmus und eines möglichen Rückrufs.

Einige Optionen sind möglicherweise nur für bestimmte Signaturformate verfügbar (z. B. die Position der Signatur im PDF-Dokument).

Darüber hinaus ermöglicht der Service das Zeitstempeln des Dokuments mit beliebigem Zeitstempeltyp.

Antwort der Qualifizierten Elektronischen Unterschrift mit OTP (EU-QES_otp)

POST/EU-QES_otp

Der Inhalt der Antwort nach der Anfrage hängt klar vom Status der Anfrage ab und kann sein:

Im Fall eines abgeschlossenen Signaturprozesses enthält die Antwort Daten wie den Status (DONE), die Optionen und das Datum:

{
 "data":{
   "id": "67af252164f60538280f70f9",
	 "updatedAt": "2025-02-14 11:12:53.699+00:00",
   "createdAt": "2025-02-14 11:12:34.218+00:00",
   "certificateType": "EU-QES_automatic",
   "state": "DONE",
   "signatureType": "pades",
   "options": {
     "asyncDocumentsValidation": false,
     "asyncSignature": false,
     "level": "B",
     "hashAlgorithm": "SHA256",
     "encryptInAnyCase": false,
     "page": 1,
     "withSignatureField": false,
  },
    "document": {
    "title": "B",
    "description": "",
    "inputDocuments": [
     {
      "sourceType": "base64",
      "createdAt": "2025-02-14 11:12:33.819+00:00",
      "mimetype": "application/pdf",
      "extension": "pdf",
      "size": 339,
      "id": "67af252164f60538280f70fb",
      "md5": "694be78a9eaa52d602bec92e211fa5dc",
      "name": "694be78a9eaa52d602bec92e211fa5dc.pdf",
    }  
  ],
   "validatedDocument": {,
     "mimetype": "application/pdf",
     "extension": "pdf",
     "id": "67af252164f60538280f70fb",
     "url": "https://my-domain.com/validatedDocument.pdf",
   }
 }

Audit

GET /signatures/{id}/{actionType}

Am Ende des Unterschriftsprozesses kann die Detailansicht des abgeschlossenen Unterschriftsprozesses angefordert werden, einschließlich des signierten Dokuments, des validierten Dokuments oder des Audit-Trails, des Dokuments, das alle Informationen enthält, die zum erfolgreichen Abschluss der Unterschrift geführt haben. Im Falle von Streitigkeiten ermöglicht diese Datei die technische Reproduktion jedes Schrittes des Verfahrens.

Überprüfung der Signaturgültigkeit

POST /verify

Openapi ermöglicht auch die Überprüfung, ob ein Dokument ordnungsgemäß signiert wurde, wem die Signatur gehört und wie lange sie gültig ist. Der entsprechende Endpunkt in diesem Fall ist POST /verify.

BEISPIELANFRAGE

Bei der Anfrage muss das signierte Dokument hochgeladen werden.

{
  "inputDocument": "BASE64string",
  "detachedContent": "BASE64string",
  "pdfEncryptionPassword": "password123",
  "recursive": true,
  "verifyOnDate": "2025-02-14"
}

BEISPIELANTWORT

Das System gibt mehrere Informationen über das Dokument zurück. Zunächst wird angegeben, ob das Dokument korrekt signiert wurde, in welchem Format und ob die Signatur gültig ist.

Es zeigt auch:

{
  "data": {
    "checkDate": "2025-02-14 11:11:01.892+00:00",
    "verificationDate": "2025-02-14 11:11:01.892+00:00",
    "signatureFormat": "PAdES",
    "nrOfSignatures": 1,
    "overallVerified": true,
    "signatureReportList": [
      {
        "id": "0",
        "integrity": true,
        "signatureAlgorithmName": "SHA256withRSA",
        "subjectDN": "C=DE,SURNAME=MÜLLER,GIVENNAME=MAX,SERIALNUMBER=DE-MLX123456,CN=MAX MÜLLER,DNQ=AUSL2023021972028357",
        "issuerDN": "C=DE,O=Namirial S.p.A./02046570426,OU=Zertifizierungsstelle,CN=Namirial CA Qualifizierte Signatur",
        "subjectCN": "MAX MÜLLER",
        "issuerCN": "Namirial CA Qualifizierte Signatur",
        "serialNumber": "5557601230250214000",
        "signerCertificateStatus": "GÜLTIG",
        "signerCertificateNotBefore": "2025-02-14 11:11:01.892+00:00",
        "signerCertificateNotAfter": "2025-02-14 11:11:01.892+00:00",
        "signerCertificateRevocationDate": "2025-02-14 11:11:01.892+00:00",
        "issuerCertificateStatus": "GÜLTIG",
        "issuerCertificateRevocationDate": "2025-02-14 11:11:01.892+00:00",
        "trustedSignatureDate": false,
        "signatureDate": "2025-02-14 11:11:01.892+00:00",
        "issuerTrustedList": true,
        "keySize": 2048,
        "qcComplianceStatus": "GÜLTIG",
        "qcSSCDStatus": "GÜLTIG",
        "derEncodedSignerCert": "BASE64string"
      }
    ],
    "noteReportList": [
      {
        "policy": 3,
        "about": 2,
        "type": 1,
        "synopsis": "Qualifiziertes Zertifikat konform",
        "description": "Das qualifizierte Zertifikat von MAX MÜLLER entspricht der europäischen Richtlinie 1999/93/EG"
      }
    ],
    "plainDocument": "BASE64string"
  },
  "message": "Die Signatur ist gültig",
  "error": null,
  "success": true
}

Die automatische qualifizierte elektronische Signatur ist für diejenigen gedacht, die täglich und massenhaft eine große Anzahl von Dokumenten unterschreiben müssen (z. B. Verwaltungsangestellte, Ärzte, Anwaltskanzleien, öffentliche Einrichtungen). Zu den Hauptvorteilen dieser Art von Signatur gehören Zeit- und Kosteneinsparungen, die Optimierung von Dokumenten-Workflows und die Digitalisierung von Prozessen.