{"id":9433,"date":"2021-07-02T12:55:20","date_gmt":"2021-07-02T12:55:20","guid":{"rendered":"https:\/\/guide.itscope.com\/?post_type=kb&#038;p=9433"},"modified":"2024-02-07T17:07:31","modified_gmt":"2024-02-07T15:07:31","slug":"why-is-the-ssl-certificate-not-correctly-recognised-in-filemakers-plugin-for-api-retrievals","status":"publish","type":"kb","link":"https:\/\/guide.itscope.com\/en\/kb\/why-is-the-ssl-certificate-not-correctly-recognised-in-filemakers-plugin-for-api-retrievals\/","title":{"rendered":"Why is the SSL certificate not recognised as valid by my API client (e.g. Filemaker, cURL)?"},"content":{"rendered":"\n<p>You are using FileMaker or other clients and have problems with the SSL certificate when accessing the ITscope.com API?<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">What must be configured so that API retrievals work without errors with older systems?<\/h2>\n\n\n\n<p>On older systems or systems that have not been updated since 2021, the Let&#8217;s Encrypt root certificate may be missing or an older, expired Let&#8217;s Encrypt root may be installed. The problem is described here: <a href=\"https:\/\/letsencrypt.org\/docs\/dst-root-ca-x3-expiration-september-2021\/\" target=\"_blank\" rel=\"noreferrer noopener\">https:\/\/letsencrypt.org\/docs\/dst-root-ca-x3-expiration-september-2021\/<\/a><br>(In detail: &#8220;(1) all clients of your API must trust ISRG Root X1 (not just DST Root CA X3), and (2) if clients of your API are using OpenSSL,&nbsp;<a href=\"https:\/\/community.letsencrypt.org\/t\/openssl-client-compatibility-changes-for-let-s-encrypt-certificates\/143816\">they must use version 1.1.0 or later<\/a>. In OpenSSL 1.0.x, a quirk in certificate verification means that even clients that trust ISRG Root X1 will fail when presented with the Android-compatible certificate chain we are recommending by default.&#8221;)<\/p>\n\n\n\n<p><\/p>\n\n\n\n<p>Depending on the client used, you must therefore update the root certificates so that our server certificates are recognised as valid. Instead of the expired Let&#8217;s Encrypt &#8216;DST Root CA X3&#8217;, the newer &#8216;ISRG Root X1&#8217; must be installed.<br>Here is a thread with collected information on the update of various systems:<\/p>\n\n\n\n<p><a href=\"https:\/\/community.letsencrypt.org\/t\/help-thread-for-dst-root-ca-x3-expiration-september-2021\/149190\">https:\/\/community.letsencrypt.org\/t\/help-thread-for-dst-root-ca-x3-expiration-september-2021\/149190<\/a><\/p>\n\n\n\n<p>Here are two examples for older Debian systems:<\/p>\n\n\n\n<p><a href=\"https:\/\/blog.rac.me.uk\/2016\/05\/04\/techy-getting-curl-to-work-with-lets-encrypt-unable-to-get-local-issuer-certificate-error\/\">https:\/\/blog.rac.me.uk\/2016\/05\/04&nbsp;<\/a><br><a href=\"https:\/\/stackoverflow.com\/questions\/69408776\/how-to-force-older-debian-to-forget-about-dst-root-ca-x3-expiration-and-use-isrg\">https:\/\/stackoverflow.com\/questions\/69408776\/how-to-force-older-debian-to-forget-about-dst-root-ca-x3-expiration-and-use-isrg<\/a><\/p>\n\n\n\n<p><\/p>\n\n\n\n<h2 class=\"wp-block-heading\">What must be configured so that API retrievals with Filemaker work without errors?<\/h2>\n\n\n\n<p>The MBS plug-in for Filemaker does not come with root certificates by default (&#8220;Also you need a cacert.pem file with certificates&#8221;).<br>As a result, CURL does not find a root certificate for the Let&#8217;s Encrypt certificate from our servers and recognises our certificate as self-signed.<br>For this reason, you can download the certificate bundle from the following website and set the corresponding option in the plug-in: <a href=\"http:\/\/curl.haxx.se\/docs\/caextract.html\" target=\"_blank\" rel=\"noreferrer noopener\">http:\/\/curl.haxx.se\/docs\/caextract.html<\/a><\/p>\n\n\n\n<p>More information on the pluginn: <a href=\"http:\/\/www.mbsplugins.de\/archive\/2013-01-31\/SSL_Security_with_CURL\/monkeybreadsoftware_blog_archive\" target=\"_blank\" rel=\"noreferrer noopener\">http:\/\/www.mbsplugins.de\/archive\/2013-01-31\/SSL_Security_with_CURL\/monkeybreadsoftware_blog_archive<\/a><\/p>\n\n\n\n<p><\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Where can you find the Let\u2019s Encrypt Root-Certificate?<\/h2>\n\n\n\n<p>The root certificate is required if you want to access our services from a third-party system and your system does not yet recognise the root certificate.<br>You can download the root certificate from the Let&#8217;s Encrypt website:<br><a href=\"https:\/\/letsencrypt.org\/certificates\/#root-certificates\">https:\/\/letsencrypt.org\/certificates\/#root-certificates<\/a><\/p>\n\n\n\n<p>Under ISRG Root X1, you can download the root certificate relevant to us by clicking on the corresponding link in various formats, for example as a &#8220;.pem&#8221;, &#8220;.der&#8221; or simply as a &#8220;.txt&#8221; file.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>You are using FileMaker or other clients and have problems with the SSL certificate when accessing the ITscope.com API? What must be configured so that API retrievals work without errors &#8230;<\/p>\n","protected":false},"author":5,"featured_media":0,"comment_status":"open","ping_status":"closed","template":"","meta":{"footnotes":""},"kbtopic":[263],"kbtag":[],"class_list":["post-9433","kb","type-kb","status-publish","hentry","kbtopic-itscope-export-api-en"],"_links":{"self":[{"href":"https:\/\/guide.itscope.com\/en\/wp-json\/wp\/v2\/kb\/9433","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/guide.itscope.com\/en\/wp-json\/wp\/v2\/kb"}],"about":[{"href":"https:\/\/guide.itscope.com\/en\/wp-json\/wp\/v2\/types\/kb"}],"author":[{"embeddable":true,"href":"https:\/\/guide.itscope.com\/en\/wp-json\/wp\/v2\/users\/5"}],"replies":[{"embeddable":true,"href":"https:\/\/guide.itscope.com\/en\/wp-json\/wp\/v2\/comments?post=9433"}],"version-history":[{"count":5,"href":"https:\/\/guide.itscope.com\/en\/wp-json\/wp\/v2\/kb\/9433\/revisions"}],"predecessor-version":[{"id":15665,"href":"https:\/\/guide.itscope.com\/en\/wp-json\/wp\/v2\/kb\/9433\/revisions\/15665"}],"wp:attachment":[{"href":"https:\/\/guide.itscope.com\/en\/wp-json\/wp\/v2\/media?parent=9433"}],"wp:term":[{"taxonomy":"kbtopic","embeddable":true,"href":"https:\/\/guide.itscope.com\/en\/wp-json\/wp\/v2\/kbtopic?post=9433"},{"taxonomy":"kbtag","embeddable":true,"href":"https:\/\/guide.itscope.com\/en\/wp-json\/wp\/v2\/kbtag?post=9433"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}