HttpClient.AddCertificate(Text [, Text]) Method

Version: Available or changed with runtime version 1.0.

Adds a certificate to the HttpClient class.


 HttpClient.AddCertificate(Certificate: Text [, Password: Text])


 Type: HttpClient
An instance of the HttpClient data type.

 Type: Text
The Base64 encoded certificate.

[Optional] Password
 Type: Text
The certificate password.


The certificate must be in base 64 format.

With the AddCertificate method you set the certificates that you want to be associated to the request of the http client connection. These have the only purpose of authenticating the client.

The system caches SSL sessions as they are created and attempts to reuse a cached session for a new request, if possible. When attempting to reuse an SSL session, it uses the first certificate that was added or tries to reuse an anonymous session if no certificates have been specified.


The certificate must be use one of the supported cipher suites; otherwise, outgoing web service calls will fail with security exception. For more information, see Supported Cipher Suites.

See Also

HttpClient Data Type
Get Started with AL
Developing Extensions