# Dokumente auf elektronische Signatur überprüfen

**URL:** <https://ecm.community/t/dokumente-auf-elektronische-signatur-ueberpruefen/638>\
**Category:** Python/ecmind\_blue\_client\
**Tags:** howto, coding\
**Created:** [5. November 2024 um 10:27 UTC](https://ecm.community/t/dokumente-auf-elektronische-signatur-ueberpruefen/638 "2024-11-05T10:27:27Z")\
**Posts on this page:** 11\
**Page:** 1

<div class="post-metadata">

**Author:** ![Globisch](https://ecm.community/letter_avatar_proxy/v4/letter/g/848f3c/32.png) [@Globisch](https://ecm.community/u/Globisch)\
**Post date:** [5. November 2024 um 10:27 UTC](https://ecm.community/t/dokumente-auf-elektronische-signatur-ueberpruefen/638/1 "2024-11-05T10:27:27Z")

</div>

Hey,  
hat von euch schon einmal jemand über die API/DMS/OSREST ein Dokument auf das Vorhandensein einer elektronischen Signatur überprüft und hat eventuell einen Best Practice ?

Mein aktueller Ansatz wäre über einen Jobcall auf „std.GetDocumentDigest“ mit dem Parameter [CheckSignature] zu gehen.

 ![image](https://ecm.community/uploads/default/original/1X/430ac7ddeaa3f805f45060832e918f1859e44978.png)

---

<div class="post-metadata">

**Author:** ![rk](https://ecm.community/user_avatar/ecm.community/rk/32/679_2.png) [@rk](https://ecm.community/u/rk)\
**Post date:** [5. November 2024 um 10:33 UTC](https://ecm.community/t/dokumente-auf-elektronische-signatur-ueberpruefen/638/2 "2024-11-05T10:33:32Z")

</div>

Hoi @Globisch, geht es Dir um Signaturen mit dem Signaturmodul oder „nur“ um die internen Gratissignaturen von enaio® mit den Schlüsseln, welche OS bei der Lizenzerstellung mit erzeugt?

---

<div class="post-metadata">

**Author:** ![Globisch](https://ecm.community/letter_avatar_proxy/v4/letter/g/848f3c/32.png) [@Globisch](https://ecm.community/u/Globisch)\
**Post date:** [5. November 2024 um 11:37 UTC](https://ecm.community/t/dokumente-auf-elektronische-signatur-ueberpruefen/638/3 "2024-11-05T11:37:46Z")

</div>

Moin, @rk.  
Es handelt sich um eine Signatur von Governikus also nicht die enaio eigene.

---

<div class="post-metadata">

**Author:** ![rk](https://ecm.community/user_avatar/ecm.community/rk/32/679_2.png) [@rk](https://ecm.community/u/rk)\
**Post date:** [6. November 2024 um 05:04 UTC](https://ecm.community/t/dokumente-auf-elektronische-signatur-ueberpruefen/638/4 "2024-11-06T05:04:45Z")

</div>

Hallo, das ist eine interessante Frage, ich selbst habe keinen Kunden, der dies aktiv einsetzt. Wenn Du dort auf einer Datei `std.GetDocumentDigest` aufrufst, hätte ich bisher immer gedacht, dass Du nur das Feedback zum enaio-Hash und der eingebauten enaio-Signatur bekommst. Aber eventuell ist Dein Gesprür richtig und die Governikus-Signatur wird von diesem Call beachtet.

Da der enaio-RichClient die mit Governikus signierten Dokumente, soweit ich weiss, mit einem eigenen Icon in Trefferlisten kennzeichnet, scheint dieser zu wissen, welche Dokumente signiert sind:

Ohne ein System zu haben, an dem ich das ausprobieren kann, ist mein Gefühl, dass die einfachste Art zu prüfen, ob Dokumente eine Signatur haben ein `DMS.GetResultList` inklusive des Systemfelds `OBJECT_SIGNSTATE` zu machen. Dieses scheint mir der richtige Ort für diese Art auskunft zu sein. Dies wäre dann z. B. mit Python und `ecmind_blue_client`/`lol_query(...)` möglich.

---

<div class="post-metadata">

**Author:** ![Globisch](https://ecm.community/letter_avatar_proxy/v4/letter/g/848f3c/32.png) [@Globisch](https://ecm.community/u/Globisch)\
**Post date:** [8. November 2024 um 07:45 UTC](https://ecm.community/t/dokumente-auf-elektronische-signatur-ueberpruefen/638/5 "2024-11-08T07:45:15Z")

</div>

Hey @rk,

ich werde deinen und meinen Ansatz kommende Woche bei dem Kunden testen und dir Feedback geben.  
Danke für das Brainstorming! 🙂

---

<div class="post-metadata">

**Author:** ![Globisch](https://ecm.community/letter_avatar_proxy/v4/letter/g/848f3c/32.png) [@Globisch](https://ecm.community/u/Globisch)\
**Post date:** [11. November 2024 um 12:18 UTC](https://ecm.community/t/dokumente-auf-elektronische-signatur-ueberpruefen/638/6 "2024-11-11T12:18:24Z")

</div>

Also,

die `std.GetDocumentDigest` scheint die elektronische Signatur nicht zu erfassen.

```auto
configuration = CustomConfiguration("config.json")
client = Client(configuration.server, "Signature_Flag", configuration.user, configuration.password)
job = Job("std.GetDocumentDigest")

dwObjectID = Param("dwObjectID", ParamTypes.INTEGER, 1275)
job.append(dwObjectID)
dwObjectType = Param("dwObjectType",ParamTypes.INTEGER, 262197)
job.append(dwObjectType)
checkSignature = Param("CheckSignature", ParamTypes.BOOLEAN, True)
job.append(checkSignature)

response = client.execute(job)
print(response.values)

```

**Ergebnis:**  
Es werden beide Dokumente ohne Signatur erkannt. Dokument zwei besitzt jedoch eine.

‚4D9ED417492047ADE7E648E17D04C2607F872E3F4D430A4BCD301056FC16A3B2‘}  
{‚Signature‘: 1, ‚TableDigest‘: ‚2C11231782E222B628367E3861BCE2012D94B623911DFD060C110529FD594418‘}

---

<div class="post-metadata">

**Author:** ![rk](https://ecm.community/user_avatar/ecm.community/rk/32/679_2.png) [@rk](https://ecm.community/u/rk)\
**Post date:** [12. November 2024 um 04:27 UTC](https://ecm.community/t/dokumente-auf-elektronische-signatur-ueberpruefen/638/7 "2024-11-12T04:27:33Z")

</div>

Hallo @Globisch, das ist schade. Hast Du noch die Möglichkeit, auf diesem System `DMS.GetResultList` zu testen, ob diese mit `OBJECT_SIGNSTATE` als `QueryResultField` mehr verrät?

---

<div class="post-metadata">

**Author:** ![Globisch](https://ecm.community/letter_avatar_proxy/v4/letter/g/848f3c/32.png) [@Globisch](https://ecm.community/u/Globisch)\
**Post date:** [12. November 2024 um 14:07 UTC](https://ecm.community/t/dokumente-auf-elektronische-signatur-ueberpruefen/638/8 "2024-11-12T14:07:04Z")

</div>

hey,  
@rk werde ich die Tage machen und hier ein Feedback dazu geben.

---

<div class="post-metadata">

**Author:** ![Globisch](https://ecm.community/letter_avatar_proxy/v4/letter/g/848f3c/32.png) [@Globisch](https://ecm.community/u/Globisch)\
**Post date:** [15. November 2024 um 10:26 UTC](https://ecm.community/t/dokumente-auf-elektronische-signatur-ueberpruefen/638/9 "2024-11-15T10:26:14Z")

</div>

Hey @rk,

ich habe jetzt auch noch einmal mit `dms.GetResultList` und dem Feld `OBJECT_SIGNSTATE` getestet. Leider bleibt das Systemfeld trotz der Unterschrift durch Governikus auch hier leer.

Wenn dir nichts mehr einfällt, würde ich mich mal an OSB wenden, ob es eine andere Möglichkeit gibt.

Das untenstehende XML enthält die Signatur, die auch in Adobe sichtbar ist.

Der Kunde hat mir das Dokument zur Verfügung gestellt, damit ich unabhängig testen kann.

 ![Screenshot](https://ecm.community/uploads/default/original/1X/794fc8866fc12995d39105c5c2342d32e3e292be.png)

```auto
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>\r\n<DMSContent format="LOL" output_language="0" version="10.10.773.22129" timest amp="2024-11-15T10:38:41" user="DEV-ADMIN" station="OSVK-EXT-REST" instance="Signature_Flag">
	<Archive name="Verwaltungsakte" id="22" osguid="CB9F8B4285814F2696B25C176237B494">
		<ObjectType name="Dokument" id="262197" maintype="4" cotype="53" osguid="0AFFA84B143C45C4BC54ABC75CE84187" internal_name="Dokument" type="DOCUMENT" modul="MULTIDOC" table="object106">
			<Rowset>
				<Columns>
					<Column object="Dokument" type="DOCUMENT" name="signstate" internal_name="OBJECT_SIGNSTATE" system="1" datatype="INTEGER" dbname="signstate" ostype="9" osguid="1906" size="10">OBJECT_SIGNSTATE</Column>
					<Column object="Dokument" type="DOCUMENT" name="Titel" internal_name="OSTPL_DOCTITLE" datatype="TEXT" dbname="feld4" ostype="X" osguid="3DF2F366296242A5BB582E6118EB0E34" size="250">Titel</Column>
				</Columns>
				<Rows>
					<Row id="1275">
						<Value/>
						<Value>Signatur</Value>
					</Row>
				</Rows>
			</Rowset>
			<Statistics startpos="0" pagesize="-1" total_hits="1"/>
		</ObjectType>
	</Archive>
	<Messages/>
</DMSContent>

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>\r\n<DMSContent format="LOL" output_language="0" version="10.10.773.22129" timest amp="2024-11-15T11:13:41" user="DEV-ADMIN" station="OSVK-EXT-REST" instance="Signature_Flag">
	<Archive name="Verwaltungsakte" id="22" osguid="CB9F8B4285814F2696B25C176237B494">
		<ObjectType name="Dokument" id="262197" maintype="4" cotype="53" osguid="0AFFA84B143C45C4BC54ABC75CE84187" internal_name="Dokument" type="DOCUMENT" modul="MULTIDOC" table="object106">
			<Rowset>
				<Columns>
					<Column object="Dokument" type="DOCUMENT" name="signstate" internal_name="OBJECT_SIGNSTATE" system="1" datatype="INTEGER" dbname="signstate" ostype="9" osguid="1906" size="10">OBJECT_SIGNSTATE</Column>
					<Column object="Dokument" type="DOCUMENT" name="Titel" internal_name="OSTPL_DOCTITLE" datatype="TEXT" dbname="feld4" ostype="X" osguid="3DF2F366296242A5BB582E6118EB0E34" size="250">Titel</Column>
				</Columns>
				<Rows>
					<Row id="1276">
						<Value/>
						<Value>40 Umlauf02 Sonstiges - - - Baubeschreibung_2022_12_12_PDFA.pdf - Nein - Nein -</Value>
					</Row>
				</Rows>
			</Rowset>
			<Statistics startpos="0" pagesize="-1" total_h its="1"/>
		</ObjectType>
	</Archive>
	<Messages/>
</DMSContent>

```

```auto
dms_query = ET.Element("DMSQuery")
archive = ET.SubElement(dms_query, "Archive", internal_name=folder)
object_type = ET.SubElement(archive, "ObjectType", internal_name=document, type="DOCUMENT")
fields = ET.SubElement(object_type, "Fields", field_schema="DEF")
ET.SubElement(fields, "Field", internal_name="OBJECT_SIGNSTATE", system='1')
ET.SubElement(fields, "Field", internal_name="OSTPL_DOCTITLE")
conditions = ET.SubElement(object_type, "Conditions")
condition_object = ET.SubElement(conditions, "ConditionObject", internal_name=document, Type="DOCUMENT")
field_condition = ET.SubElement(condition_object, "FieldCondition", internal_name="OBJECT_ID", system="1", operator="=")
ET.SubElement(field_condition, "Value").text = osid

xml_byte = ET.tostring(dms_query, encoding="utf-8")
xml_string = xml_byte.decode("utf-8")
job = Job(
    jobname="dms.GetResultList",
    XML=xml_string,
    FLAGS=0,
    ENCODING="utf-8",
)
response = client.execute(job)
print(response)

```

---

<div class="post-metadata">

**Author:** ![rk](https://ecm.community/user_avatar/ecm.community/rk/32/679_2.png) [@rk](https://ecm.community/u/rk)\
**Post date:** [18. November 2024 um 03:33 UTC](https://ecm.community/t/dokumente-auf-elektronische-signatur-ueberpruefen/638/10 "2024-11-18T03:33:49Z")

</div>

> [@Globisch](#):
>
> Der Kunde hat mir das Dokument zur Verfügung gestellt, damit ich unabhängig testen kann.

Hoi @Globisch, ach, vielleicht habe ich Dich die ganze Zeit missverstanden. Handelt es sich nicht um eine externe Signatur (=separate Datei, etwas, was das DMS verwaltet), sondern hast Du PDFs, welche intern signiert sind (=PDF hat eine selbsttragende Signatur)?

Ich glaube nicht, dass der Rendition Service von enaio das prüft und es gibt meines Wissens nach auch keine separate Queue dafür (anders als etwa `Pagecount`).

Deshalb müsstest Du hier vermutlich den Dokumenttyp mit einem Auswahlfeld `[zur Prüfung, unsigniert, signiert, Fehler]` ausstatten, bei `StoreInWork` auf `zur Prüfung` stellen und mit einem regelmässigen Job PDFs suchen, welche auf `zur Prüfung` stehen und beispielsweise mit der `has_signature`-Methode der `borb`-Bibliothek (siehe [python - Check if a pdf is signed or not - Stack Overflow](https://stackoverflow.com/a/74521043)) durcharbeiten. Oder natürlich eine vergleichbare Logik.

---

<div class="post-metadata">

**Author:** ![Globisch](https://ecm.community/letter_avatar_proxy/v4/letter/g/848f3c/32.png) [@Globisch](https://ecm.community/u/Globisch)\
**Post date:** [18. November 2024 um 07:23 UTC](https://ecm.community/t/dokumente-auf-elektronische-signatur-ueberpruefen/638/11 "2024-11-18T07:23:51Z")

</div>

Moin @rk,

es geht um ein PDF, das seine Signatur durch Governikus/Unterschriftenpad erhalten hat. Eine OS-Niederlassung hat hier einen Client zum Signieren entwickelt, der in enaio integriert ist, aber möglicherweise nicht bedacht, dass die Signatur später auch wieder gesucht oder anderweitig ermittelt werden muss.  
Aus meiner Sicht hätte man dies bereits direkt über den Client lösen können.

Dass ich die Signaturen selbst ermitteln könnte, hatte ich schon als Plan B vorgesehen, und dazu wurde auch bereits eine Diskussion mit OSB geführt. Wenn man im Hinterkopf hat das der Signaturclient diese Info eigentlich schon mitgeben könnte, empfinde ich diesen Ansatz als recht aufwändig.

Ich werde mich nochmals mit OSB abstimmen, um zu klären, ob die Lösung künftig dahingehend angepasst werden kann. Vermutlich wird es jedoch zunächst auf den genannten Workaround hinauslaufen.

> Das konkrete Szenario ist, dass der Kunde mehrere Millionen Dokumente besitzt und diese mit dem PDF-Dispatcher und Foxit zu PDF/A konvertieren soll. Die PDFs mit Signatur sollen jedoch ausgeklammert werden, da Foxit die Signaturen möglicherweise ungültig machen könnte.