tibemsSSLParams_AddTrustedCert

Purpose

Add one or more trusted certificates to the TLS parameter object.

C Declaration

tibems_status tibemsSSLParams_AddTrustedCert(
    tibemsSSLParams SSLParams,
    const void* data,
    tibems_int size,
    tibems_int encoding );

tibems_status tibemsSSLParams_AddTrustedCertFile(
    tibemsSSLParams SSLParams,
    const char* filename,
    tibems_int encoding );

IBM Systems

These functions are not supported on z/OS and IBM i systems. For more information, see TLS Implementation on IBM EBCDIC Systems.

Parameters

Parameter	Description
`SSLParams`	Add the certificates to this TLS parameter object.
`data`	Use the certificate data at this location.
`size`	Length of the certificate data (in bytes).
`encoding`	Interpret the certificate data using this encoding; for values, see Certificate Encodings.
`filename`	Read the certificate data from this file.

Remarks

Trusted certificates are certificates that authenticate the server’s certificate; the certificate authority (CA) that issued the server’s certificate supplies these. TLS clients may verify them during the TLS handshake; if your program verifies host certificates (see tibemsSSLParams_SetVerifyHost), then you must register trusted certificates as well.

If the parameter object already has trusted certificates, this call adds to that set; it does not overwrite them.

Contents