tibemsSSLParams_System_SetVerifyHostName

Function

Purpose

Enable or disable the verification of the server's hostname during connection creation.

C Declaration

tibems_status tibemsSSLParams_System_SetVerifyHostName(
    tibemsSSLParams SSLParams,
    tibems_bool verify );

COBOL Call

CALL "tibemsSSLParams_System_SetVerifyHostName"
     USING BY VALUE SSLParams,
           BY VALUE verify,
           RETURNING tibems-status
END-CALL.
Note: SSLParams has usage pointer.

Parameters

Parameter Description
SSLParams Set the value in this TLS parameter object.
verify TIBEMS_TRUE enables verification.

TIBEMS_FALSE disables verification.

Remarks

tibemsSSLParams_System_SetVerifyHostName enables checking the server’s actual host name against an expected server host name. If no "expected hostname" has been established, the server's fully qualified hostname is compared with the CN in the certificate presented by the server during the initial handshake. If they are not equal, the connection fails.

This parameter is connection-specific and can be specified for each connection.

This verification action is enabled by default (unless a program explicitly disables it).

See Also

tibemsSSLParams_System_SetExpectedHostName