You can view the available certificates from the truststore and import existing certificates to the Application Services server trusted list.

Get Certificates

Retrieves all of the existing certificates from the truststore.

The system administrator can access this API.

HTTP Method

GET

URI Syntax

https://ApplicationServicesServerIP:8443/darwin/api/2.0/certificate

You must type the URI syntax because the copy and paste operation removes formatting from the text.

Example URI syntax:

https://ApplicationServicesServerIP:8443/darwin/api/2.0/certificate

Response

{
   "errors":false,
   "messageList":[
   ],
   "count":0,
   "results":[
      {
         "id":"1",
         "lockVersion":0,
         "name":"appd.test1",
         "description":"appd test1 host",
         "lastUpdated":1379543429798,
         "lastUpdateUser":"admin",
         "created":1379543429798,
         "createUser":"admin",
         "alias":"appd.test1",
         "type":"Certificate",
       "thumbprint":"AF:8B:67:62:A1:E5:28:22:81:61:A9:5D:5C:55:9E:E2:66:27:8F:75:D7:9E:83:01:89:A5:03:50:6A:BD:6B:4C"
      },
      {
         "id":"2",
         "lockVersion":0,
         "name":"appd.test2",
         "description":"appd test2 host",
         "lastUpdated":1379543839084,
         "lastUpdateUser":"admin",
         "created":1379543839084,
         "createUser":"admin",
         "alias":"appd.test2",
         "type":"Certificate",
         "thumbprint":"AF:8B:67:62:A1:E5:28:22:81:61:A9:5D:5C:55:9E:E2:66:27:8F:75:D7:9E:83:01:89:A5:03:50:6A:BD:6B:4C"
      }
   ]
}

Get Certificate Details

Retrieves the existing certificates from the truststore based on the provided ID.

The system administrator can access this API.

HTTP Method

GET

URI Syntax

https://ApplicationServicesServerIP:8443/darwin/api/2.0/certificate/CertificateID

You must type the URI syntax because the copy and paste operation removes formatting from the text.

Example URI syntax:

https://ApplicationServicesServerIP:8443/darwin/api/2.0/certificate/1

Response

{
   "errors":false,
   "messageList":[
    ],
   "result":{
         "id":"1",
         "lockVersion":0,
         "name":"appd.test1",
         "description":"appd test1 host",
         "lastUpdated":1379543429798,
         "lastUpdateUser":"admin",
         "created":1379543429798,
         "createUser":"admin",
         "alias":"appd.test1",
         "type":"Certificate",
       "thumbprint":"AF:8B:67:62:A1:E5:28:22:81:61:A9:5D:5C:55:9E:E2:66:27:8F:75:D7:9E:83:01:89:A5:03:50:6A:BD:6B:4C"
      }
}

Import Certificate

Imports a certificate to the Application Services server trusted list.

The system administrator can access this API.

HTTP Method

POST

URI Syntax

https://ApplicationServicesServerIP:8443/darwin/api/2.0/certificate-importer

You must type the URI syntax because the copy and paste operation removes formatting from the text.

Example URI syntax:

https://ApplicationServicesServerIP:8443/darwin/api/2.0/certificate-importer

Request

Table 1. Description for Response Messages

Request Message

Description

alias

Represents the unique or domain name.

type

Represents the supported type. The supported type is Certificate.

sslTrusts

Represents the encoded certificate value .

{
   "alias":"test_env",
   "type":"Certificate",
   "ssltrust":"MIIDajCCAlKgAwIBAgIGATTE5hINMA0GCSqGSIb3DQEBBQUAMFIxIDAeBgNVBAMMF0FwcGxpY2F0aW9uIERpcmVjdG9yIENBMR0wGwYDVQQLDBRBcHBsaWNhdGlvbiBEaXJlY3RvcjEPMA0GA1UECgwGVk13YXJlMB4XDTEyMDEwOTIzNTUzOVoXDTMyMDEwNDIzNTUzOVowVjEkMCIGA1UEAwwbQXBwbGljYXRpb24gRGlyZWN0b3IgU2VydmVyMR0wGwYDVQQLDBRBcHBsaWNhdGlvbiBEaXJlY3RvcjEPMA0GA1UECgwGVk13YXJlMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAywgAi4MptZRhJSz1bCtSqJLzbxRr1ySPCF7TBM3kWDgG4xyneIcL9oiq4zG2gdyMJkeDEzzCi4akC+Ix2AVimBPyG811fAY9KLQ+NVuzUJzFT6nNonQ4WfoJO9joC1R2whKXSleylp5pRPaLhnukkuYxlFUJfywD1Xcq3JB7BQie7gbTeyub1+9/mmBFBc3JBIcTKb/mDliZBBz/vXq27uLJ6neyX22vIfNX7DflW8huTf7/Enl1bAXcsodUZwZkqGlYVmWiMG/5s4X0y/m+ZS6mBrazUCGd+nt3HvWvovrntwpy1toDcylbMIktgiMZcCJbQTwq38v/KMZMZNz4zwIDAQABo0IwQDAdBgNVHQ4EFgQU7kDFZwPiBlCMEcWChhyqWtJ9+XgwHwYDVR0jBBgwFoAUWHOnlItMd6lG6DB+qDvK4drY4kEwDQYJKoZIhvcNAQEFBQADggEBACH2IzNAzmSbhdOCQ4p9/1ekDwaMf8/+gswd4TBhx5kCFtXgeYJd9aRyT4xwTfZzBHYa/sONoiPwJFPd2QmstkCAI4vDCynr28rIYz7LTwx2+OJ9uF7PNNK/P3j5Ex2z8QIEVgRSdnIx2RZIqD7QTfaxH8+fo4C2QY2ivtUcGSHHeg7eKYI/SHTpf+omQM79kwUX5LUtreM5+9T4mXjz2bsaupnrBwOPkyLnJYuURJlrN0yFHCR0gpHjHdSgOs9LGkGyust2kIoZymeuMFAWVnXd4STcpKG06CnsReMjiLHrvj7mxoCspP+5B0VrjOKz7Q9oJxDqBR6yVng5iLXobao="
}

Response

{
   "errors":false,
   "messageList":[
 
   ],
   "result":{
      "id":"29",
      "lockVersion":0,
      "name":"test-env",
      "description":"test-env",
      "lastUpdated":1379701731051,
      "lastUpdateUser":"admin",
      "created":1379701731051,
      "createUser":"admin",
      "alias":"test-env",
      "type":"Certificate",
      "thumbprint":"98:23:95:64:54:9C:94:58:6A:C5:68:11:9B:60:83:F9:4E:C1:A6:A1:DE:19:CB:DB:34:79:B5:51:74:45:4E:1A"
   }
}

Delete Certificate Details

Removes the existing certificate from the truststore based on the provided ID.

The system administrator can access this API.

HTTP Method

DELETE

URI Syntax

https://ApplicationServicesServerIP:8443/darwin/api/2.0/certificate/CertificateID

You must type the URI syntax because the copy and paste operation removes formatting from the text.

Example URI syntax:

https://ApplicationServicesServerIP:8443/darwin/api/2.0/certificate/1

Response

{
   "errors":false,
   "messageList":[
      {
         "messageType":"INFO",
         "message":"Successfully deleted CertificateStoreEntry.",
         "messageKey":"delete.msg",
         "property":null
      }
   ]
}