Grid eXchange Fabric Documentation

  Fix This Page

UpdateDeviceSslCertification

Description

Request to download a new SSL certificate from the certificate server. The device will be given the domain name and URL where the certificate is located.

Message definitions

message UpdateDeviceSslCertificationRequest {
    required string certificateDomain = 1; // [(nanopb).max_size = 100]; // The domain name of the certificate Server.
    required string certificateUrl = 2; // [(nanopb).max_size = 255];    // The relative path of the certificate.
}

message UpdateDeviceSslCertificationResponse {
    required Status status = 1;
}

Datatypes

enum Status {
    OK = 0;
    FAILURE = 1; // general failure
    REJECTED = 2; // request received in wrong state
}

Example

Soap requests and responses sent to and from platform:


   
      SoapUI
      Kevin
      LianderNetManagement
   
   
      
         
         device-01
         
            cert-server
            /certs/new-cert.pem
         
      
   



   
   
      
         
            LianderNetManagement|||device-01|||20160305115500062
            device-01
         
      
   



   
      SoapUI
      Kevin
      LianderNetManagement
   
   
      
         
            
            LianderNetManagement|||device-01|||20160305115500062
            
            device-01
         
      
   



   
   
      
         OK
      
   

OSLP messages:

updateDeviceSslCertificationRequest {
  certificateDomain: "cert-server"
  certificateUrl: "/certs/new-cert.pem"
}

updateDeviceSslCertificationResponse {
  status: OK
}