Topics   All   MacOS (Only)   Windows (Only)   Linux (Only, Not)   iOS (Only, Not)  
Components   Crossplatform Mac & Win   Server   Client   Old   Deprecated   Guides   Examples   Videos
New in version: 9.1   9.2   9.3   9.4   9.5   10.0   10.1   10.2   10.3   10.4    Statistic  

CURL.SetOptionIssuerCertBlob

Set issuer SSL certificate from memory blob.

Component Version macOS Windows Server FileMaker Cloud FileMaker iOS SDK
CURL 10.3 Yes Yes Yes Yes Yes
MBS( "CURL.SetOptionIssuerCertBlob"; curl; Value { ; Encoding } )   More

Parameters

Parameter Description Example Flags
curl The CURL session handle. $curl
Value The blob value.
Either passed as text or passed as container value.
MyTabel::MyCert
Encoding The text encoding for value parameter when passing text.
Default is UTF-8.
"UTF8" Optional

Result

Returns OK or error.

Description

Set issuer SSL certificate from memory blob.
Pass a text or container value, which contains binary data of a CA certificate in PEM format. If the option is set, an additional check against the peer certificate is performed to verify the issuer is indeed the one associated with the certificate provided by the option. This additional check is useful in multi-level PKI where one needs to enforce that the peer certificate is from a specific branch of the tree.

This option should be used in combination with the CURL.SetOptionSSLVerifyPeer option. Otherwise, the result of the check is not considered as failure.

A specific error code (CURLE_SSL_ISSUER_ERROR) is defined with the option, which is returned if the setup of the SSL/TLS session has failed due to a mismatch with the issuer of peer certificate (CURL.SetOptionSSLVerifyPeer has to be set too for the check to fail).

This option is an alternative to OptionIssuerCert which instead expects a file name as input.

See also ISSUERCERT_BLOB option in CURL manual.

Examples

Set certificate with container field:

MBS( "CURL.SetOptionIssuerCertBlob"; $curl; Settings::IssuerCert)

See also

Blog Entries

Release notes

Created 24th June 2020, last changed 24th June 2020


CURL.SetOptionIssuerCert   -   CURL.SetOptionKRBLevel

Feedback: Report problem or ask question.




Links
MBS FileMaker blog