tibemsSSLParams_AddTrustedCert

Function

Purpose

Add one or more trusted certificates to the SSL 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 SSL Implementation on IBM EBCDIC Systems.

Parameters

Parameter Description
SSLParams Add the certificates to this SSL 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. SSL clients may verify them during the SSL 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.