Installation with an SSL certificate

Learn how to connect to Xopero ONE Management Service (XMS) admin panel via encrypted HTTPS protocol.

Kestrel configuration

Remember that once you modify the XMS settings you must switch the agent's communication protocol to HTTPS for the Xopero ONE Backup&Recovery service to work correctly.

You can find more information about Kestrel configuration here.

1

Open appsettings.json file located in Xopero ONE Management Service installation directory.

2

Find commented_out_Kestrel line.

Default commented_out_Kestrel line:

"commented_out_Kestrel": {
"Endpoints": {
"Http": {
"Url": "http://*:5000"
}
}

3

Modify the following code lines— erase commented_out_ prefix and add the HTTPS configuration as follows:

Modified commented_out_Kestrel section:

"Kestrel": {
"Endpoints": {
"Http": {
"Url": "http://*:5000"
},
"Https": {
"Url": "https://*:5001",
"Certificate":{
"Path": "<.pfx file path>",
"Password": "<certificate password>"
}}}}}

Path: path to the .pfx file*

Password: certificate password

*IMPORTANT! Remember to use double slash— if you're keeping the certificate in C:\cert.pfx directory, the path should be entered as C:\\cert.pfx instead.

---

Agent configuration

Modifying the IP address or the protocol (http, https) of the Management Service will change the active agent's status to offline. It will reconnect once you switch the agent's protocol to HTTPS.

1

Go to your Xopero ONE Agent installation directory and open config.json file.

Default location of the config.json file is:

1. For Windows: C:\Program Files\Xopero ONE Backup&Recovery Agent

2. For Linux: /opt/XoperoONEBackupAgent/

2

Change the ServiceUrl value from HTTP to HTTPS.

You can edit config.json with a simple text editor (i.e., Notepad, Notepad++).

Example of config.json file opened in Notepad++.

3

Once the value is changed, the agent will come back online.