Navigation: Additional procedures > SoftExpert Capture service >

SoftExpert Capture service (HTTPS)

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

In order to take the steps below, it will be necessary:

▪To have the .pfx file of the SoftExpert certificate and its password.

▪To execute 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'

services:

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/

5.Find the extra_hosts parameter.

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

Extra-Hosts

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 following text, indicating the port that will be used for HTTPS connection, and enter the certificate password in the CERTIFICATE_PASSWORD= parameter:

CERTIFICATE_NAME=certificate.pfx

CERTIFICATE_PASSWORD=enter the password here

HTTPS_PORT=8586

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, use the netstat -lnp | grep "8586" command to check if the port is being used.

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

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

To stop the service, execute the command below:

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

To check if the secaptureservice service is up, execute the command below:

docker ps

12.After doing that, access the SoftExpert Document component Configuration General parameters (DC035) and point the service in the application by entering https://ServerIP:8586 in the Enable SE Capture service redirection Server field.

13.Then, run the connection text and save.