A 64 bit operating system is required to install the Accredo Web Service.
Download the SetupSaturnWebService.exe or SetupMercuryWebService.exe installer from the Accredo Website downloads section.
Run the installer and install into the same directory as the Accredo Server.
The web service installer will automatically open the necessary ports in the Windows firewall: 6569 and 6570 for SSL.
These ports can be changed using the AccredoWebConfig64.exe tool that is installed with the Web Service.
In this guide, demo.accredo.co.nz is used to represent the domain you will have set up for use with the Web Service.
Accredo Web Service Configuration Tool
The Web Service Configuration tool allows you to configure the initial settings for the service to run i.e service ports, reverse proxy settings. From here you can also Stop/Start and Pause/Resume the service.
Run the AccredoWebConfig64.exe tool in the installation directory. This will request Administrator rights.
In the Web Service Initial Configuration window, select the Service, either AccredoSaturnWeb or AccredoMercuryWeb.
Service Control tab
Add the System Path. This is the path of your Accredo System installation.
Service Root: A URL segment parameter that allows the differentiation of multiple services running on a single server. Defaults to Mercury or Saturn.
The buttons here allow you to stop/start or pause/resume as well as delete the service from the Windows Registry.
Service Configuration Section
Allow Basic Auth: Allow the use of Basic Authentication for the service for use with applications that do not support Oauth 2.0.
Ports: Set the ports for SSL and Non-SSL access to the service.
Trusted IPs: Set When using Non-SSL, you will need to whitelist the IP address of any client accessing the service.
Reverse Proxy: On the Configuration tab you can add your reverse proxy details if your proxy is not forwarding through host headers. Host is the local IP address of the server the Web Service is installed on, Alias is your domain which is being forwarded from the reverse proxy.
Click Update and then on the Service Control tab click Start.
Accredo Application Configuration
Open Accredo Saturn or Accredo Mercury. Click Cancel on the Company List, as you need all companies closed.
Go to File > Web Service > Settings.
Click Edit.
Ensure Use SSL is Selected.
In the Host field, type demo.accredo.co.nz.
Set the Machine name to the name of the server.
Click Save.
Click Test Connection. A green icon will be shown beside the ports that connect successfully.
Go to File > System > Settings.
Click Edit.
Make sure that Single Sign On is enabled.
Set the Web Sessions to 1 or greater.
Click Save.
The Web Service Login form appears. Enter user details, then click OK. The ACCREDO user password must be changed from its default to be used here. Otherwise create a new user with full permissions for the Web Service.
