{"id":5105,"date":"2017-09-05T18:20:53","date_gmt":"2017-09-05T18:20:53","guid":{"rendered":"https:\/\/alt2.minisoft.com\/support\/?p=5105"},"modified":"2021-06-08T15:13:23","modified_gmt":"2021-06-08T22:13:23","slug":"ssl-configure","status":"publish","type":"post","link":"https:\/\/minisoft.com\/support\/ssl-configure\/","title":{"rendered":"SSL Configure"},"content":{"rendered":"\n<p>Trust certificates validate your server&#8217;s connection to a remote server. These certificates typically have an annual expiration date. You might need a new trust certificate if you received one of the following errors after your trust certificate expires:<\/p>\n\n\n\n<ul><li>Error using https connectionException<\/li><li>sun.security.validator.ValidatorException: PKIX path building failed<\/li><li>sun.security.ssl.Alerts::getSSLException:192<\/li><li>Close on Error with URL: \/services\/NetSuitePort_2017_1<\/li><\/ul>\n\n\n\n<ol><li>Copy the URL you need. If you have a NetSuite certificate, you can find the URL in \/Minisoft\/eFORMz_6\/Projects\/<em>CompanyName<\/em>\/Cache. Edit the file and copy the URL, just the https and server domain part. You will paste it in a field soon.<\/li><li>In the eFORMz_6 folder, start SSLConfigureApp.exe and sign in. The default user name is <em style=\"font-size: inherit;\">minisoft<\/em><span style=\"font-size: inherit;\"> and the default password is <\/span><em style=\"font-size: inherit;\">password<\/em><span style=\"font-size: inherit;\">.<\/span><\/li><\/ol>\n\n\n\n<figure class=\"wp-block-image\"><a href=\"https:\/\/alt2.minisoft.com\/support\/wp-content\/uploads\/2016\/01\/SSL-NS1.png\" rel=\"attachment wp-att-3896\"><img decoding=\"async\" loading=\"lazy\" width=\"625\" height=\"598\" src=\"https:\/\/alt2.minisoft.com\/support\/wp-content\/uploads\/2016\/01\/SSL-NS1.png\" alt=\"SSL-NS1\" class=\"wp-image-3896\" srcset=\"https:\/\/minisoft.com\/support\/wp-content\/uploads\/2016\/01\/SSL-NS1.png 625w, https:\/\/minisoft.com\/support\/wp-content\/uploads\/2016\/01\/SSL-NS1-300x287.png 300w, https:\/\/minisoft.com\/support\/wp-content\/uploads\/2016\/01\/SSL-NS1-150x144.png 150w, https:\/\/minisoft.com\/support\/wp-content\/uploads\/2016\/01\/SSL-NS1-250x239.png 250w, https:\/\/minisoft.com\/support\/wp-content\/uploads\/2016\/01\/SSL-NS1-550x526.png 550w, https:\/\/minisoft.com\/support\/wp-content\/uploads\/2016\/01\/SSL-NS1-188x180.png 188w, https:\/\/minisoft.com\/support\/wp-content\/uploads\/2016\/01\/SSL-NS1-314x300.png 314w, https:\/\/minisoft.com\/support\/wp-content\/uploads\/2016\/01\/SSL-NS1-523x500.png 523w\" sizes=\"(max-width: 625px) 100vw, 625px\" \/><\/a><\/figure>\n\n\n\n<p>3. Click Configure SSL.<\/p>\n\n\n\n<figure class=\"wp-block-image\"><a href=\"https:\/\/alt2.minisoft.com\/support\/wp-content\/uploads\/2016\/01\/SSL-NS2.png\" rel=\"attachment wp-att-3897\"><img decoding=\"async\" loading=\"lazy\" width=\"623\" height=\"597\" src=\"https:\/\/alt2.minisoft.com\/support\/wp-content\/uploads\/2016\/01\/SSL-NS2.png\" alt=\"SSL-NS2\" class=\"wp-image-3897\" srcset=\"https:\/\/minisoft.com\/support\/wp-content\/uploads\/2016\/01\/SSL-NS2.png 623w, https:\/\/minisoft.com\/support\/wp-content\/uploads\/2016\/01\/SSL-NS2-300x287.png 300w, https:\/\/minisoft.com\/support\/wp-content\/uploads\/2016\/01\/SSL-NS2-150x144.png 150w, https:\/\/minisoft.com\/support\/wp-content\/uploads\/2016\/01\/SSL-NS2-250x240.png 250w, https:\/\/minisoft.com\/support\/wp-content\/uploads\/2016\/01\/SSL-NS2-550x527.png 550w, https:\/\/minisoft.com\/support\/wp-content\/uploads\/2016\/01\/SSL-NS2-188x180.png 188w, https:\/\/minisoft.com\/support\/wp-content\/uploads\/2016\/01\/SSL-NS2-313x300.png 313w, https:\/\/minisoft.com\/support\/wp-content\/uploads\/2016\/01\/SSL-NS2-522x500.png 522w\" sizes=\"(max-width: 623px) 100vw, 623px\" \/><\/a><\/figure>\n\n\n\n<p>4. Click Edit Trust File.<\/p>\n\n\n\n<figure class=\"wp-block-image\"><a href=\"https:\/\/alt2.minisoft.com\/support\/wp-content\/uploads\/2016\/01\/SSL-NS3.png\" rel=\"attachment wp-att-3898\"><img decoding=\"async\" loading=\"lazy\" width=\"626\" height=\"596\" src=\"https:\/\/alt2.minisoft.com\/support\/wp-content\/uploads\/2016\/01\/SSL-NS3.png\" alt=\"SSL-NS3\" class=\"wp-image-3898\" srcset=\"https:\/\/minisoft.com\/support\/wp-content\/uploads\/2016\/01\/SSL-NS3.png 626w, https:\/\/minisoft.com\/support\/wp-content\/uploads\/2016\/01\/SSL-NS3-300x286.png 300w, https:\/\/minisoft.com\/support\/wp-content\/uploads\/2016\/01\/SSL-NS3-150x143.png 150w, https:\/\/minisoft.com\/support\/wp-content\/uploads\/2016\/01\/SSL-NS3-250x238.png 250w, https:\/\/minisoft.com\/support\/wp-content\/uploads\/2016\/01\/SSL-NS3-550x524.png 550w, https:\/\/minisoft.com\/support\/wp-content\/uploads\/2016\/01\/SSL-NS3-189x180.png 189w, https:\/\/minisoft.com\/support\/wp-content\/uploads\/2016\/01\/SSL-NS3-315x300.png 315w, https:\/\/minisoft.com\/support\/wp-content\/uploads\/2016\/01\/SSL-NS3-525x500.png 525w\" sizes=\"(max-width: 626px) 100vw, 626px\" \/><\/a><\/figure>\n\n\n\n<p>5. After minisoft.truststore opens, click Trust from URL.<\/p>\n\n\n\n<figure class=\"wp-block-image\"><a href=\"https:\/\/alt2.minisoft.com\/support\/wp-content\/uploads\/2016\/01\/SSL-NS4.png\" rel=\"attachment wp-att-3899\"><img decoding=\"async\" loading=\"lazy\" width=\"625\" height=\"598\" src=\"https:\/\/alt2.minisoft.com\/support\/wp-content\/uploads\/2016\/01\/SSL-NS4.png\" alt=\"SSL-NS4\" class=\"wp-image-3899\" srcset=\"https:\/\/minisoft.com\/support\/wp-content\/uploads\/2016\/01\/SSL-NS4.png 625w, https:\/\/minisoft.com\/support\/wp-content\/uploads\/2016\/01\/SSL-NS4-300x287.png 300w, https:\/\/minisoft.com\/support\/wp-content\/uploads\/2016\/01\/SSL-NS4-150x144.png 150w, https:\/\/minisoft.com\/support\/wp-content\/uploads\/2016\/01\/SSL-NS4-250x239.png 250w, https:\/\/minisoft.com\/support\/wp-content\/uploads\/2016\/01\/SSL-NS4-550x526.png 550w, https:\/\/minisoft.com\/support\/wp-content\/uploads\/2016\/01\/SSL-NS4-188x180.png 188w, https:\/\/minisoft.com\/support\/wp-content\/uploads\/2016\/01\/SSL-NS4-314x300.png 314w, https:\/\/minisoft.com\/support\/wp-content\/uploads\/2016\/01\/SSL-NS4-523x500.png 523w\" sizes=\"(max-width: 625px) 100vw, 625px\" \/><\/a><\/figure>\n\n\n\n<p>6. Paste the URL you copied in Step 1 into the URL field. Enter a name for this entry in the Alias field. Click Trust.<\/p>\n\n\n\n<figure class=\"wp-block-image\"><a href=\"https:\/\/alt2.minisoft.com\/support\/wp-content\/uploads\/2016\/01\/SSL-NS5.png\"><img decoding=\"async\" src=\"https:\/\/alt2.minisoft.com\/support\/wp-content\/uploads\/2016\/01\/SSL-NS5.png\" alt=\"\" class=\"wp-image-5106\"\/><\/a><\/figure>\n\n\n\n<p><em><strong>Update:<\/strong> In eFORMz version 11.03.11_1825 or later, the &#8220;Skip Host Name Check&#8221; and &#8220;Skip Host Date Check&#8221; options need to be selected if you don\u2019t want the certificate to expire.<\/em><\/p>\n\n\n\n<figure class=\"wp-block-image\"><a href=\"https:\/\/minisoft.com\/support\/wp-content\/uploads\/2017\/09\/trust_host.png\"><img decoding=\"async\" loading=\"lazy\" width=\"613\" height=\"274\" src=\"https:\/\/minisoft.com\/support\/wp-content\/uploads\/2017\/09\/trust_host.png\" alt=\"\" class=\"wp-image-8855\" srcset=\"https:\/\/minisoft.com\/support\/wp-content\/uploads\/2017\/09\/trust_host.png 613w, https:\/\/minisoft.com\/support\/wp-content\/uploads\/2017\/09\/trust_host-300x134.png 300w, https:\/\/minisoft.com\/support\/wp-content\/uploads\/2017\/09\/trust_host-150x67.png 150w, https:\/\/minisoft.com\/support\/wp-content\/uploads\/2017\/09\/trust_host-250x112.png 250w, https:\/\/minisoft.com\/support\/wp-content\/uploads\/2017\/09\/trust_host-550x246.png 550w, https:\/\/minisoft.com\/support\/wp-content\/uploads\/2017\/09\/trust_host-403x180.png 403w\" sizes=\"(max-width: 613px) 100vw, 613px\" \/><\/a><\/figure>\n\n\n\n<p>7. Click Save &gt; OK &gt; Exit &gt; Yes to save your changes.<\/p>\n\n\n\n<p>8. Close all eFORMz windows and restart the eFORMz service.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Keystore<\/h2>\n\n\n\n<p>1. To edit the Key file, select Edit Key File from the SSL configuration dialog.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" loading=\"lazy\" width=\"611\" height=\"300\" src=\"https:\/\/minisoft.com\/support\/wp-content\/uploads\/2021\/06\/Keystore1.png\" alt=\"\" class=\"wp-image-9279\" srcset=\"https:\/\/minisoft.com\/support\/wp-content\/uploads\/2021\/06\/Keystore1.png 611w, https:\/\/minisoft.com\/support\/wp-content\/uploads\/2021\/06\/Keystore1-300x147.png 300w, https:\/\/minisoft.com\/support\/wp-content\/uploads\/2021\/06\/Keystore1-150x74.png 150w\" sizes=\"(max-width: 611px) 100vw, 611px\" \/><\/figure>\n\n\n\n<p>2. Select the default certificate and remove it.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><a href=\"https:\/\/minisoft.com\/support\/wp-content\/uploads\/2021\/06\/Keystore2.png\"><img decoding=\"async\" loading=\"lazy\" width=\"613\" height=\"180\" src=\"https:\/\/minisoft.com\/support\/wp-content\/uploads\/2021\/06\/Keystore2.png\" alt=\"\" class=\"wp-image-9280\" srcset=\"https:\/\/minisoft.com\/support\/wp-content\/uploads\/2021\/06\/Keystore2.png 613w, https:\/\/minisoft.com\/support\/wp-content\/uploads\/2021\/06\/Keystore2-300x88.png 300w, https:\/\/minisoft.com\/support\/wp-content\/uploads\/2021\/06\/Keystore2-150x44.png 150w\" sizes=\"(max-width: 613px) 100vw, 613px\" \/><\/a><\/figure>\n\n\n\n<figure class=\"wp-block-image size-large\"><a href=\"https:\/\/minisoft.com\/support\/wp-content\/uploads\/2021\/06\/Keystore3.png\"><img decoding=\"async\" loading=\"lazy\" width=\"613\" height=\"553\" src=\"https:\/\/minisoft.com\/support\/wp-content\/uploads\/2021\/06\/Keystore3.png\" alt=\"\" class=\"wp-image-9281\" srcset=\"https:\/\/minisoft.com\/support\/wp-content\/uploads\/2021\/06\/Keystore3.png 613w, https:\/\/minisoft.com\/support\/wp-content\/uploads\/2021\/06\/Keystore3-300x271.png 300w, https:\/\/minisoft.com\/support\/wp-content\/uploads\/2021\/06\/Keystore3-150x135.png 150w\" sizes=\"(max-width: 613px) 100vw, 613px\" \/><\/a><\/figure>\n\n\n\n<p>3. Select Import PKCS12 KeyStore and import the file. The extension will be .pfx. <\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><a href=\"https:\/\/minisoft.com\/support\/wp-content\/uploads\/2021\/06\/Keystore4.png\"><img decoding=\"async\" loading=\"lazy\" width=\"612\" height=\"170\" src=\"https:\/\/minisoft.com\/support\/wp-content\/uploads\/2021\/06\/Keystore4.png\" alt=\"\" class=\"wp-image-9283\" srcset=\"https:\/\/minisoft.com\/support\/wp-content\/uploads\/2021\/06\/Keystore4.png 612w, https:\/\/minisoft.com\/support\/wp-content\/uploads\/2021\/06\/Keystore4-300x83.png 300w, https:\/\/minisoft.com\/support\/wp-content\/uploads\/2021\/06\/Keystore4-150x42.png 150w\" sizes=\"(max-width: 612px) 100vw, 612px\" \/><\/a><\/figure>\n\n\n\n<p>4. Click Save &gt; OK &gt; Exit &gt; Yes to save your changes.<\/p>\n\n\n\n<p>5. Close all eFORMz windows and restart the eFORMz service.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Troubleshooting<\/h2>\n\n\n\n<ul><li>Validator.Exception: PKIX path building failed<\/li><\/ul>\n\n\n\n<pre class=\"wp-block-preformatted\">sun.security.validator.ValidatorException: PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target<\/pre>\n\n\n\n<p>First, check if the certificate for the URL being used in the eFORMz project is in SSLConfigureApp.exe. If the certificate is there, it might be outdated or expired. To fix this, simply remove all of the offending URL entries and re-add them so that there is only one certificate entry for each URL.<\/p>\n\n\n\n<ul><li>Close on Error loading component<\/li><\/ul>\n\n\n\n<pre class=\"wp-block-preformatted\">com.minisoft.Output.OutputGenerator::a:-1 Close on Error loading component from: https:\/\/system.na2.netsuite.com\/core\/media\/media.nl?id=3366899&amp;c=4311009&amp;h=8866345857bae03a8ac1&amp;_xt=.pdf<\/pre>\n\n\n\n<p>This error indicates that you need to add a URL to the SSL Trust Store, which in the above example, would be&nbsp;https:\/\/system.na2.netsuite.com\/core\/media. The URL to be added to the Trust Store is derived from the error message.<\/p>\n\n\n\n<p>Tags: Java keystore, Java certificate<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Trust certificates validate your server&#8217;s connection to a remote server. These certificates typically have an annual expiration date. You might need a new trust certificate if you received one of the following errors after your trust certificate expires: Error using https connectionException sun.security.validator.ValidatorException: PKIX path building failed sun.security.ssl.Alerts::getSSLException:192 Close on Error with URL: \/services\/NetSuitePort_2017_1 Copy [&hellip;]<\/p>\n","protected":false},"author":75,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[77],"tags":[669,672,236,126,670],"_links":{"self":[{"href":"https:\/\/minisoft.com\/support\/wp-json\/wp\/v2\/posts\/5105"}],"collection":[{"href":"https:\/\/minisoft.com\/support\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/minisoft.com\/support\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/minisoft.com\/support\/wp-json\/wp\/v2\/users\/75"}],"replies":[{"embeddable":true,"href":"https:\/\/minisoft.com\/support\/wp-json\/wp\/v2\/comments?post=5105"}],"version-history":[{"count":19,"href":"https:\/\/minisoft.com\/support\/wp-json\/wp\/v2\/posts\/5105\/revisions"}],"predecessor-version":[{"id":10203,"href":"https:\/\/minisoft.com\/support\/wp-json\/wp\/v2\/posts\/5105\/revisions\/10203"}],"wp:attachment":[{"href":"https:\/\/minisoft.com\/support\/wp-json\/wp\/v2\/media?parent=5105"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/minisoft.com\/support\/wp-json\/wp\/v2\/categories?post=5105"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/minisoft.com\/support\/wp-json\/wp\/v2\/tags?post=5105"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}