Skip to main content

xSuite Interface Windows Prism 5.x – Online-Hilfe

Zertifikate

Die folgenden Eigenschaften dienen der Verwaltung von allen Zertifikaten, die vom Programm zu unterschiedlichen Zwecken benötigt werden.

Eigenschaft

Beschreibung

Certificate[].Usage*

Verwendungszweck des Zertifikats:

  • Crypt: Verschlüsselung/Entschlüsselung von Konfigurationswerten

  • Server: Serverzertifikat, wenn die Webservices aktiviert sind und über HTTPS mit einer SSL/TLS-Verschlüsselung angesprochen werden

  • Client: Client-Zertifikat für die Authentifizierung von Webservice-Benutzern

Von den Arten Crypt und Server kann jeweils maximal ein Zertifikat angegeben werden. Weitere Zertifikate werden vom Programm ignoriert.

Certificate[].Name(*)

eindeutiger, frei wählbarer Name des Zertifikats

Diese Eigenschaft ist nur relevant für Client-Zertifikate, die zur Authentifizierung gegenüber einem externen Webservice genutzt werden und z. B. in der Konfiguration des Ausgabesystems über diesen Namen referenziert werden.

Certificate[].File(*)

Certificate[].FilePassword(§)

Pfad des Zertifikats, wenn dieses in Dateiform vorliegt, und Passwort zur Entschlüsselung der Datei, wenn es sich z. B. um ein PFX-Format handelt

Wenn das Zertifikat zur Entschlüsselung von Konfigurationswerten dient (Verwendungszweck Crypt) und mit einem Passwort versehen ist, ist der Schlüssel zum Lesen dieses Passworts noch nicht bekannt. In diesem Sonderfall wird ein intern im Programm verankertes Zertifikat zur Verschlüsselung und Entschlüsselung des Passworts genutzt.

Certificate[].StoreLocation

Certificate[].StoreName

Certificate[].StoreFindType

Certificate[].StoreFindValue(*)

Eigenschaften zum Auffinden des Zertifikats, wenn sich dieses im Windows-Zertifikatsspeicher befindet

Für die einzelnen Eigenschaften sind jeweils folgende Werte nutzbar:

  • .StoreLocation:

    • LocalMachine (Standardwert)

    • CurrentUser

  • .StoreName:

    • My (Standardwert)

    • Root

    • TrustedPeople

    • TrustedPublisher

    • u.a.

  • .StoreFindType:

    • FindBySubjectName (Standardwert)

    • FindBySubjectDistinguishedName

    • FindByIssuerName

    • FindBySerialNumber

    • u.a.

Der .StoreFindType definiert das Attribut, über das das Zertifikat gesucht wird. Im .StoreFindValue ist der zugehörige Suchwert anzugeben. Wenn ein Zertifikat gemäß den Standard­vorgaben unter "Lokaler Computer\Eigene Zertifikate" über den "Subject Name" gefunden werden soll, muss nur dieser Suchwert konfiguriert werden, z. B. Certificate[].StoreFindValue: "*.xsuite.com".