Update the Cobra N-Tier Server to Use HTTPS

Follow this procedure to update the Cobra n-tier server to use HTTPS.

To update the Cobra n-tier server:

1. Navigate to the Cobra installation directory and locate the following files:
   • <Cobra installation directory>\Cobra.WinUI.exe.config
   • <Cobra installation directory>\Cobra.Api.exe.config
   • <Cobra installation directory>\Server\ServerService.exe.config
   • <Cobra installation directory>\Workstation\Cobra.WinUI.exe.config

   Note: Perform steps 2 to 4 in each of the files.
2. Locate the <services> node in the file and update the address attributes on both <service> nodes to use “https” and the correct HTTPS port.

   
   <services>
    <service name="PersistenceService" behaviorConfiguration="Behavior1"> 
    <endpoint address="https://MAK123456:8113/PersistenceService" binding="customBinding"bindingConfiguration="compressedBinaryBinding" contract="IdeaBlade.Persistence.Wcf.IWcfPersistenceService">
   <identity><servicePrincipalName value="Local Network"></servicePrincipalName></identity> 
    </endpoint> 
    </service>
   <service name="IdeaBlade.Persistence.Wcf.WcfPersistenceServer" behaviorConfiguration="Behavior1"> 
   <endpoint address="https://MAK123456:8113/PersistenceServer" binding="customBinding" bindingConfiguration="compressedBinaryBinding" contract="IdeaBlade.Persistence.Wcf.IWcfPersistenceServer">
   <identity><servicePrincipalName value="Local Network"></servicePrincipalName></identity> 
     </endpoint>
    </service> 
   </services>
   

3. Depending on your binding preference, perform one of the following actions:
   • If you are using customBinding, locate the <customBinding> node in the file and update the <httpTransport> node to <httpsTransport>.

     
     <customBinding>
     <binding name="compressedBinaryBinding" closeTimeout="10:01:00" openTimeout="10:01:00" receiveTimeout="10:01:00" sendTimeout="10:01:00" 
     		<gzipMessageEncoding>
         <readerQuotas maxDepth="2147483647" maxNameTableCharCount="2147483647" maxBytesPerRead="2147483647"maxArrayLength="2147483647"maxStringContentLength="2147483647"/>
       </gzipMessageEncoding>
      <httpsTransport maxReceivedMessageSize="2147483647" />
     </binding>
     </customBinding>
     

   • If you are using wsHttpBinding, locate the <security mode="Message"> node under the <wsHttpBinding> node in each file and update it to <securityMode="TransportWithMessageCredential">.
4. Save the file.
5. Navigate to the Cobra installation directory and locate the following files:
   • <Cobra installation directory>\IdeaBlade.ibconfig
   • <Cobra installation directory>\Server\IdeaBlade.ibconfig

   Note: Perform steps 6 and 7 in each of the files.
6. Locate the <remoteBaseUrl> and <serverPort> nodes, and update the <remoteBaseUrl> node value to use 'https' and the <serverPort> node value to the correct HTTPS port.

   
   <remoting>
     <remotePersistenceEnabled>true</remotePersistenceEnabled>
     <communicationsTechnology>Wcf</communicationsTechnology>
     <remoteBaseURL>https://MAK123456</remoteBaseURL>
     <serverPort>8113</serverPort>
     <serviceName>PersistenceService</serviceName>
     <serverDetectTimeoutMilliseconds>-1</serverDetectTimeoutMilliseconds>
     <proxyPort>0</proxyPort>
   </remoting>

7. Save the file.
8. Restart the Cobra n-tier service (IdeaBlade PersistenceServer Service).
   If the service fails to start, verify that you have made the correct changes to the files in the Server subfolder of the Cobra installation directory.
9. Launch the Cobra application on the server to verify that it is configured correctly.