SoftExpert Capture service (HTTPS)

This topic will show how to configure the SoftExpert Capture service with HTTPS protocol on port 8586.

danger

In order to take the steps below, you must:

• Have the .pfx SE certificate file and its password.
• Run the commands below as root.

1. Create the secaptureservice directory:

mkdir /usr/local/se/secaptureservice

2. Access the secaptureservice directory:

cd /usr/local/se/secaptureservice

3. Create the docker-compose.yml file inside the secaptureservice directory:

vim docker-compose.yml

4. Paste the following text:

version: '3.7'

secaptureservice:
  container_name: secaptureservice
  image: softexpert/secaptureservice:latest
  extra_hosts:
    - <SEAccessURL>:ServerIP
  environment:
   - ASPNETCORE_URLS=https://+:443;
   - ASPNETCORE_Kestrel__Certificates__Default__Password=${CERTIFICATE_PASSWORD}
   - ASPNETCORE_Kestrel__Certificates__Default__Path=/https/${CERTIFICATE_NAME}
  ports:
   - "${HTTPS_PORT}:443"
  volumes:
   - ./cert:/https:ro
   - ./log:/app/log/
deploy:
   resources:
     limits:
       memory: 4G

5. Locate the extra_hosts parameter.

6. Insert the SoftExpert access URL and the local IP of the application server, as shown in the image below:

7. Create the cert directory:

mkdir /usr/local/se/secaptureservice/cert

8. Paste the .pfx certificate file to the /usr/local/se/secaptureservice/cert directory and save it with the name certificate.pfx.

9. Create the capture.env file inside the secaptureservice directory:

vim capture.env

10. Insert the text below, indicating the port that will be used for HTTPS connection, and enter the certificate password in the CERTIFICATE_PASSWORD= parameter:

CERTIFICATE
CERTIFICATE_PASSWORD=enter password here
HTTPS_PORT=8586

caution

By default, the port used for HTTPS connection is 8586, but it is possible to set a different port if the default one is already being used. In this case, run the netstat -lnp | grep "8586" command to check whether the port is being used.

11. Start the SoftExpert Capture service using the command below:

cd /usr/local/se/sepdfconverter/ ; docker-compose --env-file capture.env --compatibility up -d

To stop the service, execute the command below:

cd /usr/local/se/secaptureservice/ ; docker-compose --env-file capture.env down

To check whether the secaptureservice service is up, run the command below:

docker ps

12. Once this is done, access the SoftExpert Document component > Configuration > General parameters (DC035) and point the service in the application by entering https://serverIP:8586 in the Enable SoftExpert Capture service redirection -> Server field.

13. Then, run the connection test and save.