Automatisches Qualifiziertes elektronisches Siegel

Das Qualifizierte Elektronische Siegel (QeSeal) über API ist die innovative Lösung, die es juristischen Personen ermöglicht, die Authentizität und Integrität einer großen Anzahl von Dokumenten automatisch, von einem Server aus und ohne Gebühren zu garantieren. Alles in großen Mengen oder in einem einzigen Vorgang und in Sekundenschnelle.

Es handelt sich um einen vollständig flexiblen und anpassbaren Dienst, der es ermöglicht, jedes Signaturformat (CAdES, PAdES, XAdES und PKCS#1) auszuwählen, und die Prozedur kann sowohl synchron als auch asynchron in wenigen Sekunden durchgeführt werden.

Es fallen keine jährlichen Gebühren an: Es wird nur die Aktivierungsgebühr des Zertifikats und die tatsächlichen Nutzungskosten berechnet.

Das Qualifizierte Elektronische Siegel (QeSeal) ist das Äquivalent der Qualifizierten Elektronischen Unterschrift (QES), jedoch auf eine juristische Person (z.B. Unternehmen, Institution oder Organisation) ausgestellt. Dank QeSeal können Sie Ihren Daten und Dokumenten einen beweiskräftigen Wert verleihen.

In Übereinstimmung mit der eIDAS-Verordnung ist das Siegel in ganz Europa rechtlich anerkannt und gilt auch für die Überprüfung von Unternehmen auf EPREL.

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

Während des Anbringens des Siegels ist es auch möglich, das Dokument mit einem beliebigen Zeitstempel einer akkreditierten Zertifizierungsstelle zu versehen.

Vor der Nutzung des QeSeal-Dienstes über API muss das automatische qualifizierte elektronische Siegel aktiviert werden, das Sie über unseren Kundensupport erwerben können.

Auf Openapi sind automatische und massive qualifizierte elektronische Signaturen auch in Varianten mit OTP (EU-QES_otp) und ohne (EU-QES_automatic) verfügbar.

Anforderung des Qualifizierten Elektronischen Siegels (EU-QES_eseal)

POST/EU-QES_eseal

Der Endpoint POST/EU-QES_eseal ermöglicht das Hinzufügen der qualifizierten elektronischen Siegels über 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-Unterschrift für eine Remote-Datei und base64",
 "signatureType": "pades",
}

Die erforderlichen Felder für die Unterzeichnung sind:

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

Wie bereits zu Beginn erwähnt, ist der Service äußerst flexibel und ermöglicht es, über verschiedene Optionen die Validierungs- und Unterzeichnungsmodalitäten des Dokuments (synchron oder asynchron), die Unterschriftsstufe, den Hash-Algorithmus und eine eventuelle Rückrufoption zu konfigurieren.

Einige Optionen sind möglicherweise nur für spezifische Signaturformate verfügbar (z.B. Positionierung der Unterschrift in einer PDF-Datei).

Der Service ermöglicht es auch, das Dokument mit einer beliebigen Art von Zeitstempel zu versehen.

Antwort des Qualifizierten Elektronischen Siegels (EU-QES_eseal)

POST/EU-QES_eseal

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

Wenn der Unterschriftsprozess abgeschlossen ist, enthält die Antwort Daten wie Status (DONE), Optionen und 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",
     "size": "339",
     "createdAt": "2025-02-14 11:12:33.819+00:00",
     "id": "67af252164f60538280f70fb",
     "md5": "694be78a9eaa52d602bec92e211fa5dc",
     "name": "694be78a9eaa52d602bec92e211fa5dc.pdf"
}
  "signedDocument": {,
     "createdAt": "2025-02-14 11:12:34.229+00:00",
     "mimetype": "application/pdf",
     "extension": "pdf",
     "size": "50133",
     "id": "67af252264f60538280f70fe",
     "md5": "363cfdb141fe0e1a3f598e1d6377a4f5",
     "name": "67af252164f60538280f70f9.pdf"
    }
  }
}, 
"message": "Created",
"success": true,
"error": null,
}

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
}

Das automatische qualifizierte elektronische Siegel ist für diejenigen gedacht, die täglich und in großen Mengen die Gültigkeit einer großen Anzahl von Dokumenten beglaubigen müssen (z. B. Banken, Versicherungsgesellschaften, Anwaltskanzleien, öffentliche Einrichtungen). Zu den wichtigsten Vorteilen dieses Dienstes gehören Zeit- und Kosteneinsparungen, die Optimierung der Dokumentenabläufe und die Digitalisierung der Prozesse.