Setting up Web Access

There are some features of 12d Synergy which need access to the Web, such as Publishing files over the net, using Web File Drops, and accessing the 12d Synergy Web App. For these to function, the following configurations have to be made by your 12d Synergy Administrator in the 12d Synergy Administration application.

1.1. How to Configure Web Access

1. In the 12d Synergy Administration application, click the System Settings tab.
2. Click the Web Access tab.
   
   
   
3. Select the Enable 12d Synergy Web Server check box.

   If this check box is disabled then you will not be able to configure access to the Web App, publishing, or Web file drops.

4. Enter the address of your external server in the External server address: check box.
5. Enter your external port address in your External Port box.
6. Select the Use HTTPs for secure transfer check box if you are using secure transfer. For more details on setting up HTTPs refer to section 1.5 How to Configure HTTPs.
7. Click the Save button.

1.2. Configuring the Web App

1. In the 12d Synergy Administration application, click the System Settings tab.
2. Click the Web Access tab.
3. Select the Allow 12d Synergy Website check box.
   
   
   

   Ensure that the Enable 12d Synergy Web Server check box is enabled for you to be able to configure access to the Web App.

4. In the Web Access tab, click the Advanced tab.
   
   
   
5. Select one of the following options from the Collaborators can be created by list.
   • System Admin - This option will allow only the System Administrator to create a collaborator using the 12d Synergy Administration application. 
   • System Admin or Job Admin - This option will allow both, the System Administrator and Job Administrator to create a collaborator using the 12d Synergy Administration and Client applications respectively.  
6. Click the Save button.
7. Open any of the supported browsers and type the Web App address provided by your 12d Synergy Administrator in the address bar and press the Enter key.

The login page is displayed.

1.3. How to Configure Publishing

1. In the 12d Synergy Administration application, click the System Settings tab.
2. Click the Web Access tab.
3. Ensure that you have configured access to the Web using How to Configure Web Access.
4. Click the File Publishing tab.
   
   
   
5. Select the Allow Publishing check box.
6. Enter a URL base for any publishing request in the Relative Server Path box.
   The final URL will be displayed in the Path base box.
7. Enter a location on the server or a network drive via a UNC path where all the zipped published files will be saved in the Absolute package path (on server) box.
8. In the Download page templates box, you can do any of the following:
   • From the list in the Download page templates box, select the method of publishing files for which you want to set a download page template.
   • Add a new template you might use as a download page while publishing files using the button. It gets displayed in the Download page templates box.
   • Select a template from the Download page templates box that you want to use as the default download page while publishing files and click the Set Default button. The word DEFAULT is displayed against the selected template.
   • Select a template to edit the format of the template using the  button.
9. Select the Enable “show download page” by default check box to always show a download page while downloading published files. 
10. Click the Save button.

1.4. How to Configure Web File Drops

1. In the 12d Synergy Administration application, click the System Settings tab.
2. Click the Web Access tab.
3. Ensure that you have configured access to the Web using How to Configure Web Access.
4. Click the File Drops tab.
   
   
   
5. Select the Allow file uploads check box.
6. Enter a URL base for any web drop requests in the Relative Server Path box.
   The final URL will be displayed in the Path base box.
7. In the Download page templates box, you can do any of the following:
   • From the list in the Download page templates box, select the method of publishing files for which you want to set a download page template.
   • Add a new template you might use as a download page while publishing files using the button. It gets displayed in the Download page templates box.
   • Select a template from the Download page templates box that you want to use as the default download page while publishing files and click the Set Default button. The word DEFAULT is displayed against the selected template.
   • Select a template to edit the format of the template using the  button.
8. Click the Save button.

1.5. How to Configure HTTPs

To configure HTTPs, you will need to register the certificate with 12d Synergy. You can do this using the 12d Synergy Administration application > System Settings tab >Web Access tab > HTTPS Setup tab. 

Whether we help you procure the certificate, you self-sign, or you bring your certificate, the thumbprint of the certificate is needed. This is a unique identifier required by MS Windows for setting up your certificate. You can reuse the same certificate that is set in the SSL Certificates tab.

For more information on certificates, please see Managing Certificates.

1.5.1. How to Preserve Old HTTP links

If you have previously used HTTP links and want to preserve them after turning on HTTPs, you should set up an HTTP Redirect using the following steps:

1. Identify a new, unique port for HTTPs.
2. Setup HTTPs using the new port.
3. Select the Use HTTP Redirect checkbox. 
4. Set the HTTP Redirect port to the port number you were using previously.

1.5.2. How to Register your HTTPs Certificate Manually

The service account that runs 12d Synergy must have admin permissions to set up HTTPs. If the service account does not have admin permissions, you will need to register your HTTPs certificate manually using the following steps.

1. Open Windows Command Prompt as an Administrator.
2. Run the following command, substituting the appropriate values for your certificate thumbprint and the HTTPs Port.
   netsh http add sslcert ipport=0.0.0.0:PORT_NUMBER certhash=CERTIFICATE_THUMBPRINT appid={f2010563-a376-4202-baec-6cd269839269}
   You can view the certificate thumbprint in your certificate store for Windows.
   
   For more information on how to get the thumbprint, please see Use an existing Certificate.
3. In the 12d Synergy Administration application, click the System Settings tab > Custom Settings tab.
4. Add a new setting - SkipHTTPSCertificateRegistration and set its value to 1.
   This will stop 12d Synergy from automatically registering the certificate for you.
   
   
   
5. Click the Save button.
6. Restart the 12d Synergy Server service by doing the following:
   1. Click the Window Start button > Run prompt > type services.msc. Alternatively  press the Windows+R key simultaneously and then type services.msc.
      The Services window is displayed. 
   2. Right-click the 12d Synergy Server service and select the Restart option.
      

The 12d Synergy Server service is restarted.