X509 Server Cert

<< Click to Display Table of Contents >>

Navigation:  Managing Syncplify.me Server! > REST API > Admin API > Utility Functions >

X509 Server Cert

Manages/creates/gets information about X.509 certificates.

 

Request

Method

URL

POST

/smserver-default/sms.X509ServerCert

RAW

POST /smserver-default/sms.X509ServerCert HTTP/1.1

Cache-Control: no-cache

Connection: Keep-Alive

Pragma: no-cache

Content-Type: application/json; charset=UTF-8

Accept: */*

Authorization: Bearer XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX

 

[

       {   "Command": "info",

           "cert" : "MIIJQQIBAzCCCPsGCSqGSIb3DQEHAaCCCOwEggjoMIII5DCABgkqhkiG9w0BBwGg\r\ngASCBTYwggUyMIIFLgYLKoZIhvcNAQwKAQKgggUGMIIFAjAcBgoqhkiG9w0BDAED\r\nMA4ECD7jCLNqkH/SAgIIAASCBOA/sjkyBl01qvZMEJvGzOgbOkjIKIZWggNzvVZL\r\n8fDdKk9c/TDBl5hPcQGq+K9gvTFx5DQAoQO5BCCSbY5IhCsUP0NdlC2fctnlgPJp\r\n1+W4iuf4lKIiEujbQsSZ5TBxG9Y7HObZQyUxHw/hdetiruV3bfGuMDeUmbl2LbO+\r\nao4/EEHHll1WT42T+uzogAaiCStGWNKSgbe1p2fMqpgB4HwsjrMIM6N7AjKVtSpU\r\nsFR+kOOtg0GNvvjvlre3SlDbX2SE9/LM4HQQUSHKNRCAlpBbimqGqWFVJjV6J8OX\r\nfqHYJZzrGjlE6Sfoj2XmLMCqrXp9fR8QQ5e+dOksAHxHXSgS6AscFLFTE1Vp11+Y\r\n5wi2Cl8n+K1rLiD9NJ7fvl3L35400x1iUNPLrKocn6D3w0J49ROTGCO7TienOAsB\r\nlQZhrNtoFWTI8fqZ+6Gy2tYO+mq8ViVP27B85UIX8bY8DDxkR/trpYkPc/S41TUU\r\n1Iby5o9gpdd1txZI62rkCHrzYRuDmMTGBFsEoGmt0uoTbDP2OVmTbRb/w6Ar2PYV\r\n9axRdurws7o1KRFW6oNtABiOo42F9W96Ipgo/qTBY0jdEeMXmAEnLjVmY+uRtT0m\r\njOdVTN/gWFWSGNn6mi+eJ59Kl1yFruekaRGNQy072GdlxodqB8oSwjv4xD/0r29r\r\nnexQhqXliBk88t9TTpzTmvHFkG6KQ8PtSozem2YgfTdePCYnwJ63s4xY4r4AAAAA\r\nAAAAAAAAMD0wITAJBgUrDgMCGgUABBSSAMhsd1f1I+EjcLPRPlHgHgtNdQQU+akW\r\nwFL46j8059gsN2YIJDCnsYwCAggA",

           "password" : ""

       }

]

Explained

"Command": "info",

 

Used to retrieve meta-information about an X.509 certificate.

 

Response

Method

URL

RAW

Accept-Encoding: synlz,gzip

Content-Type: application/json; charset=UTF-8

 

 

{"result":[

{

       "Cert" : "MIIJQQIBAzCCCPsGCSqGSIb3DQEHAaCCCOwEggjoMIII5DCABgkqhkiG9w0BBwGg\r\ngASCBTYwggUyMIIFLgYLKoZIhvcNAQwKAQKgggUGMIIFAjAcBgoqhkiG9w0BDAED\r\nMA4ECD7jCLNqkH/SAgIIAASCBOA/sjkyBl01qvZMEJvGzOgbOkjIKIZWggNzvVZL\r\n8fDdKk9c/TDBl5hPcQGq+K9gvTFx5DQAoQO5BCCSbY5IhCsUP0NdlC2fctnlgPJp\r\n1+W4iuf4lKIiEujbQsSZ5TBxG9Y7HObZQyUxHw/hdetiruV3bfGuMDeUmbl2LbO+\r\nao4/EEHHll1WT42T+uzogAaiCStGWNKSgbe1p2fMqpgB4HwsjrMIM6N7AjKVtSpU\r\nsFR+kOOtg0GNvvjvlre3SlDbX2SE9/LM4HQQUSHKNRCAlpBbimqGqWFVJjV6J8OX\r\nfqHYJZzrGjlE6Sfoj2XmLMCqrXp9fR8QQ5e+dOksAHxHXSgS6AscFLFTE1Vp11+Y\r\n5wi2Cl8n+K1rLiD9NJ7fvl3L35400x1iUNPLrKocn6D3w0J49ROTGCO7TienOAsB\r\nlQZhrNtoFWTI8fqZ+6Gy2tYO+mq8ViVP27B85UIX8bY8DDxkR/trpYkPc/S41TUU\r\n1Iby5o9gpdd1txZI62rkCHrzYRuDmMTGBFsEoGmt0uoTbDP2OVmTbRb/w6Ar2PYV\r\n9axRdurws7o1KRFW6oNtABiOo42F9W96Ipgo/qTBY0jdEeMXmAEnLjVmY+uRtT0m\r\njOdVTN/gWFWSGNn6mi+eJ59Kl1yFruekaRGNQy072GdlxodqB8oSwjv4xD/0r29r\r\nnexQhqXliBk88t9TTpzTmvHFkG6KQ8PtSozem2YgfTdePCYnwJ63s4xY4r4AAAAA\r\nAAAAAAAAMD0wITAJBgUrDgMCGgUABBSSAMhsd1f1I+EjcLPRPlHgHgtNdQQU+akW\r\nwFL46j8059gsN2YIJDCnsYwCAggA",

       "Fingerprint" : "f707c5520d44991d7d3610c5768471a2b4e5fbc2",

       "KeyLength" : "2048"

   }

],"id":772674711}

Explained

Returns the same certificate that was sent, plus:

Fingerprint: a unique fingerprint of the certificate

KeyLength: the length of the Key (already as a string)

 

 

OR

 

Request

Method

URL

POST

/smserver-default/sms.X509ServerCert

RAW

POST /smserver-default/sms.X509ServerCert HTTP/1.1

Cache-Control: no-cache

Connection: Keep-Alive

Pragma: no-cache

Content-Type: application/json; charset=UTF-8

Accept: */*

Authorization: Bearer XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX

 

[

{

           "command" : "generate",

           "ABits" : 2048,

           "ACountry" : "USA",

           "AState" : "NY",

           "ALoc" : "NY",

           "AOrg" : "Myself",

           "AOrgUnit" : "MYou",

           "ACommon" : "CommonName",

           "AEmail" : "common@name.com"

       }

]

Explained

"Command": "generate"

 

Creates a brand new and self-signed X.509 digital certificate.

 

Response

Method

URL

RAW

Accept-Encoding: synlz,gzip

Content-Type: application/json; charset=UTF-8

 

 

{"result":[

{

       "Result" : 1,

       "x509" : "MIIJQQIBAzCCCPsGCSqGSIb3DQEHAaCCCOwEggjoMIII5DCABgkqhkiG9w0BBwGg\r\ngASCBTYwggUyMIIFLgYLKoZIhvcNAQwKAQKgggUGMIIFAjAcBgoqhkiG9w0BDAED\r\nMA4ECD7jCLNqkH/SAgIIAASCBOA/sjkyBl01qvZMEJvGzOgbOkjIKIZWggNzvVZL\r\n8fDdKk9c/TDBl5hPcQGq+K9gvTFx5DQAoQO5BCCSbY5IhCsUP0NdlC2fctnlgPJp\r\n1+W4iuf4lKIiEujbQsSZ5TBxG9Y7HObZQyUxHw/hdetiruV3bfGuMDeUmbl2LbO+\r\nao4/EEHHll1WT42T+uzogAaiCStGWNKSgbe1p2fMqpgB4HwsjrMIM6N7AjKVtSpU\r\nsFR+kOOtg0GNvvjvlre3SlDbX2SE9/LM4HQQUSHKNRCAlpBbimqGqWFVJjV6J8OX\r\nfqHYJZzrGjlE6Sfoj2XmLMCqrXp9fR8QQ5e+dOksAHxHXSgS6AscFLFTE1Vp11+Y\r\n5wi2Cl8n+K1rLiD9NJ7fvl3L35400x1iUNPLrKocn6D3w0J49ROTGCO7TienOAsB\r\nlQZhrNtoFWTI8fqZ+6Gy2tYO+mq8ViVP27B85UIX8bY8DDxkR/trpYkPc/S41TUU\r\n1Iby5o9gpdd1txZI62rkCHrzYRuDmMTGBFsEoGmt0uoTbDP2OVmTbRb/w6Ar2PYV\r\n9axRdurws7o1KRFW6oNtABiOo42F9W96Ipgo/qTBY0jdEeMXmAEnLjVmY+uRtT0m\r\njOdVTN/gWFWSGNn6mi+eJ59Kl1yFruekaRGNQy072GdlxodqB8oSwjv4xD/0r29r\r\nnexQhqXliBk88t9TTpzTmvHFkG6KQ8PtSozem2YgfTdePCYnwJ63s4xY4r4AAAAA\r\nAAAAAAAAMD0wITAJBgUrDgMCGgUABBSSAMhsd1f1I+EjcLPRPlHgHgtNdQQU+akW\r\nwFL46j8059gsN2YIJDCnsYwCAggA"

   }

],"id":772674711}

Explained

Returns the generated X.509 digital certificate (note: it's self-signed).