sslCertificates | ||||||||||
Type | property | |||||||||
Dictionary | LCS | |||||||||
Library | LiveCode Script | |||||||||
Syntax |
| |||||||||
Associations | ssl & encryption | |||||||||
Summary | Specifies a list of files and folders which are searched for SSL certificates to authenticate secure socket connections. | |||||||||
Introduced | 2.5 | |||||||||
Changes | Before version 4.5 it was necessary to set the sslCertificates property to the root certificates that HTTPS connections should be verified against. Support has now been added to locate and load the root certificates installed (and kept up to date) as part of the OS. | |||||||||
OS | mac, windows, linux | |||||||||
Platforms | desktop, server | |||||||||
Example |
| |||||||||
Values |
| |||||||||
Related | Command: encrypt Glossary: Standalone Application Settings, standalone application, property, LiveCode custom library Library: SSL & Encryption library | |||||||||
Security | network | |||||||||
Description | Use the sslCertificates to determine the SSL certificate that secure sockets should use to authenticate. When a secure socket connection needs to authenticate it will look through the sslCertificates line by line. If a line is a path to a folder, each file in that folder will be searched for SSL certificates. If a line is a file, that file will be searched for SSL certificates.
This uses the standard root certificate keychain on Mac, the standard root certificate store on Windows and uses a number of heuristics to locate this information on Linux. You can easily find out if the system-installed root certificates are being found by running the following command in the message box:
If this results in an error about verification failure then it is likely that root certificates have not been found. Please let us know (particularly on Linux) if you find this simple test fails, making sure you give us full details of your system (e.g. Linux distribution and version).
|