SDContext.SetUserCertificateWithKey

Method

Visual Basic

Overloads Public Shared Sub SetUserCertificateWithKey(
    ByVal userCertificateWithKey As String,
    ByVal password As String)
Overloads Public Shared Sub SetUserCertificateWithKey(
    ByVal userCertificateWithKeyBinaryFormat As Byte(),
    ByVal password As String)

C#

public static void SetUserCertificateWithKey(
    string userCertificateWithKey,
    string password);
public static void SetUserCertificateWithKey(
    byte[] userCertificateWithKeyBinaryFormat,
    string password);

Purpose

Remarks

When any program transport connects to a secure daemon, the daemon verifies the program’s identity using TLS protocols.

Overload

The certificate argument can be either a string in PEM text format, or a byte array in PKCS #12 binary format.

Parameter	Description
`userCertificateWithKey`	Register this user certificate with private key. The text of this certificate must be in PEM encoding.
`userCertificateWithKeyBinaryFormat`	Register this user certificate with private key. The binary data of this certificate must be in PKCS #12 encoding.
`password`	Use this password to decrypt the private key.

Important

For important information about password security, see Security Factors in TIBCO Rendezvous Administration.

CA-Signed Certificate

You can also supply a certificate signed by a certificate authority (CA). To use a CA-signed certificate, you must supply not only the certificate and private key, but also the CA’s public certificate (or a chain of such certificates). Concatenate these items in one string or binary data object. For important details, see CA-Signed Certificates in TIBCO Rendezvous Administration.

Exceptions

An exception that reports status InvalidFile can indicate either disk I/O failure, or invalid certificate data, or an incorrect password.