Provides API access to replace the default WWW certificate
/api/v1/system/www/cert/get
Gets the current WWW TLS certificate
Address
/api/v1/system/www/cert/get
Verb
GET
Privilege
ADMIN only
Notes
By default a self signed fmadio certificate is installed.
Arguments
Parameter | Description |
|---|---|
PublicKey=true | Returns the public key |
PrivateKey=true | Returns the private key |
Example
Example to fetch the current public default key
fmadio@fmadio100v2-228U:~$ curl -u fmadio:***** -k https://192.168.2.175/api/v1/system/www/cert/get?PublicKey=true
-----BEGIN CERTIFICATE-----
MIID8jCCAtqgAwIBAgIUCxyi5ZZLOKkFRMLjtQCOBTtBbPswDQYJKoZIhvcNAQEL
BQAwgYExCzAJBgNVBAYTAlNHMRIwEAYDVQQIDAlTaW5nYXBvcmUxEjAQBgNVBAcM
CVNpbmdhcG9yZTEZMBcGA1UECgwQZm1hZCBlbmdpbmVlcmluZzEPMA0GA1UEAwwG
Zm1hZGlvMR4wHAYJKoZIhvcNAQkBFg9zdXBwb3J0QGZtYWQuaW8wHhcNMjMwNTE5
MDY0MjMwWhcNMjgwNTE3MDY0MjMwWjCBgTELMAkGA1UEBhMCU0cxEjAQBgNVBAgM
CVNpbmdhcG9yZTESMBAGA1UEBwwJU2luZ2Fwb3JlMRkwFwYDVQQKDBBmbWFkIGVu
Z2luZWVyaW5nMQ8wDQYDVQQDDAZmbWFkaW8xHjAcBgkqhkiG9w0BCQEWD3N1cHBv
cnRAZm1hZC5pbzCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAJNuB0G9
tQfzX9ZTmpKJGBQrgjn3uNzfuIalTrL9tyPdjB4i8tb10aDvwird3r7hYM8yK8Du
Pp05rfp24lLadQkpLGqOeWFel9W8OSKNJ8MSVTPyMqnCu0uw9m849yZOZndnRX9b
Ydo07wD4D+dlqwx+rkOnBWKJ3VkQKzSIqDRn/LS74LpZpbuAFta1jA3+iUhKnpCh
lIu3HAyAY8g4a4LBDPi2uQ4enbGcfs3j4b39d0em/JoNobyfSU1gFxEeuHJzdzve
c35RmEEEA4JROJE7NdF43BzVEPDcIgV+pglwOKOg+YKATPuEQ+KBPQBRk8jAF4Rd
XkCg6sFWpfqD6hcCAwEAAaNgMF4wHQYDVR0OBBYEFMQxrrBpv153z7kGl7mWurcE
iNTTMB8GA1UdIwQYMBaAFMQxrrBpv153z7kGl7mWurcEiNTTMAwGA1UdEwQFMAMB
Af8wDgYDVR0PAQH/BAQDAgPoMA0GCSqGSIb3DQEBCwUAA4IBAQASdyqBocta8On+
RE1AYP6xYBXCni922qkuO7NxOAQXK2O4sJ2zXKkeA1n1+1oJmzSjf7hnCv/BAxfI
z/e3xxMbnZB3IVoZOd3WrlIqRo0yJTrUucx+urUL7rDkohOcuSI9lRdJZvaq0Sri
0nt/Rem/cmDIQ0YL098Dxysz1Y4rnBuAnvJ4ZXDOVJwbufi0BtStlxDwbBj72ZpT
S7fBFUd2yvht1uJCIOa6VuqlZoAoKiLeYiOSl8c5MfIWTo8dT5sCazCrQn7JbxQ6
3caQuQ8TFmMyJ3oHtQrjdtlnoQbxAh3VPDqXZgbKCi7SsiWgUybNo4la1J1hka5u
AW8NTxTL
-----END CERTIFICATE-----
fmadio@fmadio100v2-228U:~$
/api/v1/system/www/cert/put
Sets a custom WWW TLS certificate
Address
/api/v1/system/www/cert/put
Verb
POST
Privilege
ADMIN only
Notes
The new TLS certificate is not active untill /api/v1/system/www/restart has been called.
Arguments
Parameter | Description |
|---|---|
PublicKey=true | Writes the public key |
PrivateKey=true | Writes the private key |
Example
Example to POST a new TLS Public key
fmadio@fmadio100v2-228U:/mnt/store0/etc$ curl -s -X POST -u fmadio:**** "http://192.168.2.175/api/v1/system/www/cert/put?PublicKey=true" -H "Content-Type: multipart/form-data" -F "data=@./fmadio_cert.pem" | jq
{
"Status": true
}
fmadio@fmadio100v2-228U:/mnt/store0/etc$
/api/v1/system/www/restart
Restarts the WWW process with a new configuration
Address
/api/v1/system/www/restart
Verb
GET
Privilege
ADMIN only
Notes
As this restarts the WWW processes it will not return any value
Arguments
Parameter | Description |
|---|---|
Example
Example to Restat the WWW process
It may take up to 60sec for the restart process to complete
fmadio@fmadio100v2-228U:/mnt/store0/etc$ curl -u fmadio:***** -k https://192.168.2.175/api/v1/system/www/restart
curl: (52) Empty reply from server
fmadio@fmadio100v2-228U:/mnt/store0/etc$