Skip to main content

xSuite Interface Windows Prism 5.x – Online Help

Certificates

The following properties are used to manage all certificates that are required by the program for various purposes.

Property

Description

Certificate[].Usage*

Intended use of the certificate:

  • Crypt: Encryption/decryption of configuration values

  • Server: Server certificate if web services are enabled and accessed via HTTPS with SSL/TLS encryption

  • Client: client certificate for authentication of web service users

A maximum of one certificate of each of the types Crypt and Server can be specified. Further certificates are ignored by the program.

Certificate[].Name(*)

Unique, freely selectable name of the certificate

This property only applies to client certificates, which are identified by this name in the same way as a user name when configuring web service permissions.

Certificate[].File(*)

Certificate[].FilePassword(§)

Path of the certificate, if it is in file format, and password for decrypting the file, if it is in PFX or another such format

If the certificate is used to decrypt configuration values ( Crypt purpose) and is provided with a password, the key for reading this password is not yet known. In this special case, a certificate stored internally in the program is used to encrypt and decrypt the password.

Certificate[].StoreLocation

Certificate[].StoreName

Certificate[].StoreFindType

Certificate[].StoreFindValue(*)

Properties for locating the certificate if it is in the Windows certificate store

The following values can be used for the individual properties:

  • .StoreLocation:

    • LocalMachine (default value)

    • CurrentUser

  • .StoreName:

    • My (default value)

    • Root

    • TrustedPeople

    • TrustedPublisher

    • Etc.

  • .StoreFindType:

    • FindBySubjectName (default value)

    • FindBySubjectDistinguishedName

    • FindByIssuerName

    • FindBySerialNumber

    • Etc.

The .StoreFindType defines the attribute used to search for the certificate. Specify the associated search value in the .StoreFindValue. If a certificate is to be found via the "Subject Name" according to the default settings under "Local Computer\Own Certificates," only configure this search value (e.g., Certificate[].StoreFindValue: "*.xsuite.com").

In this section: